evolcore 0.0.46 → 0.0.48

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 (237) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/bin/ec-build.mjs +86 -0
  3. package/dist/agent-template/jobs.js +12 -4
  4. package/dist/agent-template/runtime.js +139 -39
  5. package/dist/agent-template/service.js +66 -13
  6. package/dist/agents/baseagent.js +60 -20
  7. package/dist/agents/claude-runner.js +43 -18
  8. package/dist/agents/codex/app-server-client.js +32 -23
  9. package/dist/agents/codex-runner.js +31 -16
  10. package/dist/agents/ecagent-runner.js +7 -4
  11. package/dist/agents/gemini-runner.js +5 -2
  12. package/dist/agents/runner-types.js +5 -21
  13. package/dist/aun/aid/agentmd.js +5 -1
  14. package/dist/aun/group/fs-download.js +1 -1
  15. package/dist/aun/service-proxy.js +4 -2
  16. package/dist/build-identity.json +1 -0
  17. package/dist/channels/aun.js +100 -32
  18. package/dist/channels/daemon.js +10 -26
  19. package/dist/cli/aun-commands.js +86 -51
  20. package/dist/cli/code-stats.js +19 -8
  21. package/dist/cli/command-log.js +1 -1
  22. package/dist/cli/daemon-commands.js +65 -76
  23. package/dist/cli/daemon-lifecycle-client.js +17 -3
  24. package/dist/cli/directory.js +7 -1
  25. package/dist/cli/ecmsg-gateway.js +5 -2
  26. package/dist/cli/index.js +2 -8
  27. package/dist/cli/init-channel.js +6 -8
  28. package/dist/cli/init.js +74 -46
  29. package/dist/cli/invoke-command.js +1 -1
  30. package/dist/cli/provider-command.js +74 -13
  31. package/dist/cli/restart-monitor.js +104 -28
  32. package/dist/cli/role.js +61 -17
  33. package/dist/cli/stats.js +3 -3
  34. package/dist/cli/task-context.js +83 -15
  35. package/dist/cli/thread-command.js +16 -51
  36. package/dist/cli/upgrade-command.js +4 -2
  37. package/dist/config/boot-log.js +3 -9
  38. package/dist/config/builtin-roles.js +5 -7
  39. package/dist/config/config-manager.js +31 -23
  40. package/dist/config/daemon-services.js +30 -3
  41. package/dist/config/gateway-config.js +2 -2
  42. package/dist/config/invoke-ipc-service.js +6 -4
  43. package/dist/config/peer-bind-code.js +3 -4
  44. package/dist/config/peer-book-store.js +59 -218
  45. package/dist/config/peer-book.js +26 -27
  46. package/dist/config/peer-role-resolver.js +16 -1
  47. package/dist/config/provider-identity-migration.js +161 -6
  48. package/dist/config/provider-ipc-service.js +56 -11
  49. package/dist/config/provider-menu-request.js +24 -5
  50. package/dist/config/provider-templates.js +127 -0
  51. package/dist/config/providers-config.js +59 -8
  52. package/dist/config/providers-management.js +467 -49
  53. package/dist/config/role-command-service.js +248 -1
  54. package/dist/config/schema-migration.js +228 -20
  55. package/dist/config/schema-registry.js +6 -2
  56. package/dist/core/agent-application-service.js +6 -1
  57. package/dist/core/agent-runtime.js +10 -5
  58. package/dist/core/auth/agent-delegation.js +10 -4
  59. package/dist/core/auth/auth-gateway.js +2 -1
  60. package/dist/core/auth/delegation-authorization.js +3 -0
  61. package/dist/core/auth/delegation-diagnostics.js +56 -15
  62. package/dist/core/auth/operation-authorizer.js +26 -1
  63. package/dist/core/auth/operation-catalog.js +28 -64
  64. package/dist/core/capability/providers/codex-capability-provider.js +7 -8
  65. package/dist/core/channel-loader.js +18 -0
  66. package/dist/core/command/agent-control.js +32 -0
  67. package/dist/core/command/command-handler.js +81 -85
  68. package/dist/core/command/menu-catalog.js +1 -0
  69. package/dist/core/command/menu-handler.js +65 -153
  70. package/dist/core/command/menu-protocol.js +7 -1
  71. package/dist/core/command/provider-menu.js +13 -3
  72. package/dist/core/command/role-menu.js +47 -23
  73. package/dist/core/command/slash-handler.js +30 -49
  74. package/dist/core/command/team-workspace-items.js +81 -12
  75. package/dist/core/command/team-workspace-team.js +9 -71
  76. package/dist/core/command/topic-slash.js +9 -30
  77. package/dist/core/daemon-bootstrap.js +19 -10
  78. package/dist/core/daemon-control.js +8 -10
  79. package/dist/core/daemon-lifecycle.js +50 -40
  80. package/dist/core/evolagent-registry.js +22 -3
  81. package/dist/core/file-integrity/store.js +2 -0
  82. package/dist/core/handoff/runtime.js +37 -1
  83. package/dist/core/host-snapshot.js +9 -4
  84. package/dist/core/inference/text-inference.js +3 -1
  85. package/dist/core/initialization/service.js +31 -8
  86. package/dist/core/interaction-router.js +3 -0
  87. package/dist/core/invoke/executors/text.js +72 -19
  88. package/dist/core/ipc-registration.js +6 -4
  89. package/dist/core/memory/consolidation.js +6 -6
  90. package/dist/core/message/aun-ipc-sender.js +165 -55
  91. package/dist/core/message/im-renderer.js +1 -1
  92. package/dist/core/message/message-bridge.js +51 -334
  93. package/dist/core/message/message-log.js +5 -0
  94. package/dist/core/message/message-queue.js +22 -0
  95. package/dist/core/message/message-utils.js +8 -0
  96. package/dist/core/message/response-engine.js +429 -116
  97. package/dist/core/message/send-routing.js +5 -1
  98. package/dist/core/model/catalog-service.js +31 -11
  99. package/dist/core/model/model-capabilities.js +22 -4
  100. package/dist/core/model/model-catalog.js +1 -0
  101. package/dist/core/ownership/owner-resolver.js +355 -60
  102. package/dist/core/permission/protected-paths.js +6 -6
  103. package/dist/core/relation/peer-identity.js +28 -2
  104. package/dist/core/relation/same-owner-proof.js +81 -111
  105. package/dist/core/session/adapters/claude-session-file-adapter.js +1 -1
  106. package/dist/core/session/adapters/codex-session-file-adapter.js +96 -15
  107. package/dist/core/session/session-file-health.js +49 -14
  108. package/dist/core/session/session-fs-store.js +91 -35
  109. package/dist/core/session/session-manager.js +68 -24
  110. package/dist/core/session/session-mapper.js +14 -34
  111. package/dist/core/session/session-transcript.js +5 -1
  112. package/dist/core/task/task-activity-store.js +84 -0
  113. package/dist/core/task/task-image-resources.js +1 -1
  114. package/dist/core/task/task-recovery-service.js +12 -0
  115. package/dist/core/thread/command-parser.js +7 -12
  116. package/dist/core/thread/thread-context-storage.js +3 -2
  117. package/dist/core/thread/thread-operation.js +2 -13
  118. package/dist/core/thread/thread-service.js +15 -46
  119. package/dist/directory/owner-directory-admission.js +1 -1
  120. package/dist/directory/owner-directory-cache.js +45 -28
  121. package/dist/directory/owner-directory-markdown.js +13 -1
  122. package/dist/directory/owner-directory-query-operation.js +29 -3
  123. package/dist/directory/owner-directory-remarks.js +11 -3
  124. package/dist/eck/message-renderer.js +84 -24
  125. package/dist/ecweb/basic-settings-service.js +3 -1
  126. package/dist/ecweb/message-context-service.js +1 -1
  127. package/dist/ecweb/pairing.js +4 -3
  128. package/dist/ecweb/providers-service.js +26 -1
  129. package/dist/ecweb/runtime/lifecycle.js +82 -23
  130. package/dist/ecweb/runtime/proxy-access.js +74 -0
  131. package/dist/ecweb/runtime/supervisor.js +6 -17
  132. package/dist/event-center/registry.js +13 -2
  133. package/dist/event-center/runtime.js +103 -11
  134. package/dist/event-center/script-runner.js +5 -5
  135. package/dist/index.js +129 -93
  136. package/dist/ipc.js +15 -3
  137. package/dist/outputs/events.js +62 -0
  138. package/dist/outputs/protocol.js +102 -0
  139. package/dist/outputs/service.js +279 -0
  140. package/dist/paths.js +3 -0
  141. package/dist/proxy/manager.js +43 -13
  142. package/dist/services/index.js +89 -4
  143. package/dist/services/ipc-operation.js +4 -15
  144. package/dist/services/pack-manager.js +12 -1
  145. package/dist/services/router.js +21 -6
  146. package/dist/services/script-runner.js +5 -4
  147. package/dist/services/validation.js +1 -1
  148. package/dist/stats/budget.js +1 -1
  149. package/dist/stats/db.js +19 -0
  150. package/dist/stats/index.js +1 -1
  151. package/dist/stats/{price-resolver.js → model-resolver.js} +305 -24
  152. package/dist/stats/normalizer.js +2 -0
  153. package/dist/stats/query.js +35 -27
  154. package/dist/stats/role-budget.js +5 -2
  155. package/dist/stats/writer.js +10 -6
  156. package/dist/trigger/audit.js +7 -0
  157. package/dist/trigger/authorization.js +105 -11
  158. package/dist/trigger/feedback.js +10 -0
  159. package/dist/trigger/history.js +37 -11
  160. package/dist/trigger/ipc-service.js +12 -1
  161. package/dist/trigger/manager.js +1 -0
  162. package/dist/trigger/scheduler.js +11 -5
  163. package/dist/trigger/script-executor.js +2 -1
  164. package/dist/trigger/script-sandbox.js +9 -3
  165. package/dist/trigger/state.js +7 -0
  166. package/dist/trigger/validation.js +22 -0
  167. package/dist/utils/aid-bind.js +155 -18
  168. package/dist/utils/atomic-write.js +3 -3
  169. package/dist/utils/cross-platform.js +97 -31
  170. package/dist/utils/error-dict.json +94 -4
  171. package/dist/utils/error-utils.js +40 -4
  172. package/dist/utils/evolcore-version.js +36 -65
  173. package/dist/utils/instance-registry.js +61 -0
  174. package/dist/utils/msg-diag.js +1 -0
  175. package/dist/utils/process-introspect.js +158 -8
  176. package/dist/utils/process-tree.js +50 -2
  177. package/dist/utils/upgrade-jobs.js +4 -4
  178. package/dist/utils/windows-shell-trust.js +2 -0
  179. package/dist/workbench/protocol.js +80 -0
  180. package/dist/workbench/service.js +359 -0
  181. package/ecagent/dist/types.d.ts +6 -2
  182. package/kits/docs/context-assembly.md +1 -1
  183. package/kits/docs/evolcore/INDEX.md +2 -2
  184. package/kits/docs/evolcore/aid.md +3 -1
  185. package/kits/docs/evolcore/config.md +12 -0
  186. package/kits/docs/evolcore/directory.md +22 -3
  187. package/kits/docs/evolcore/ecweb-lifecycle.md +15 -0
  188. package/kits/docs/evolcore/model.md +10 -0
  189. package/kits/docs/evolcore/peer.md +19 -65
  190. package/kits/docs/evolcore/provider.md +133 -5
  191. package/kits/docs/evolcore/role.md +80 -0
  192. package/kits/docs/evolcore/services.md +6 -6
  193. package/kits/docs/evolcore/team-workspace.md +1 -1
  194. package/kits/docs/evolcore/thread-chain.md +14 -15
  195. package/kits/docs/evolcore/tool-authorization.md +5 -0
  196. package/kits/docs/evolcore/trigger.md +10 -0
  197. package/kits/eck_message_manifest.json +12 -0
  198. package/kits/provider-templates.json +1213 -0
  199. package/kits/rules/04-relation.md +3 -3
  200. package/kits/schemas/_meta.json +14 -2
  201. package/kits/schemas/contact-book.schema.4.json +52 -0
  202. package/kits/schemas/providers.schema.3.json +200 -0
  203. package/kits/skills/.switches.json +4 -0
  204. package/kits/skills/ability/references/calling.md +1 -1
  205. package/kits/skills/ec-group/SKILL.md +2 -2
  206. package/kits/skills/ec-identity/SKILL.md +19 -72
  207. package/kits/skills/ec-provider/SKILL.md +221 -0
  208. package/kits/skills/ec-provider/scripts/check-model.mjs +80 -0
  209. package/kits/skills/ec-trigger/SKILL.md +1 -1
  210. package/kits/skills/thread-ops/SKILL.md +34 -21
  211. package/kits/templates/message-fragments/group-batch-item.md +1 -1
  212. package/kits/templates/message-fragments/group-batch.md +1 -1
  213. package/kits/templates/message-fragments/inject-default.md +1 -1
  214. package/kits/templates/message-fragments/interrupt-insert.md +1 -0
  215. package/kits/templates/message-fragments/item-group.md +1 -1
  216. package/kits/templates/message-fragments/item-private.md +1 -1
  217. package/kits/templates/message-fragments/thread-context.md +1 -1
  218. package/kits/templates/message-fragments/trigger-session.md +1 -1
  219. package/kits/templates/message-fragments/trigger-thread-check.md +1 -1
  220. package/kits/templates/roles/admin.json +2 -19
  221. package/kits/templates/roles/member.json +0 -3
  222. package/kits/templates/system-fragments/baseagent.md +6 -0
  223. package/kits/templates/system-fragments/commands.md +3 -3
  224. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  225. package/kits/templates/system-fragments/relation.md +1 -1
  226. package/kits/templates/system-fragments/thread.md +6 -5
  227. package/package.json +6 -4
  228. package/scripts/agent-template/inspect.mjs +4 -1
  229. package/scripts/agent-template/shared/common.mjs +2 -3
  230. package/scripts/agent-template/shared/template-contract.mjs +2 -1
  231. package/scripts/agent-template/shared/template-package.mjs +9 -2
  232. package/scripts/agent-template/shared/template-runtime.mjs +20 -5
  233. package/scripts/agent-template/team-pack.mjs +6 -3
  234. package/dist/cli/peer.js +0 -127
  235. package/dist/config/peer-operation-service.js +0 -132
  236. package/dist/config/peer-request-service.js +0 -532
  237. package/dist/core/command/connect-menu.js +0 -624
@@ -0,0 +1,359 @@
1
+ import crypto from 'node:crypto';
2
+ import { DataRootError } from '../core/command/team-workspace-store.js';
3
+ import { TaskActivityStore, onTaskActivityMutation, taskActivityTitle } from '../core/task/task-activity-store.js';
4
+ import { authorizeOutput, currentOutputOwner } from '../outputs/service.js';
5
+ import { WORKBENCH_EVENT, WORKBENCH_MODULES, isWorkbenchType } from './protocol.js';
6
+ let runtimeProvider;
7
+ const runtimeListeners = new Set();
8
+ let changePublisher;
9
+ let notificationsAvailable = () => false;
10
+ export function setWorkbenchRuntimeProvider(provider) {
11
+ runtimeProvider = provider;
12
+ for (const listener of runtimeListeners)
13
+ listener();
14
+ }
15
+ export function notifyWorkbenchRuntimeChanged(aid) {
16
+ for (const listener of runtimeListeners)
17
+ listener(aid);
18
+ }
19
+ export function setWorkbenchChangePublisher(publisher, available = () => false) {
20
+ changePublisher = publisher;
21
+ notificationsAvailable = available;
22
+ }
23
+ const terminal = new Set(['completed', 'interrupted', 'error', 'timeout']);
24
+ const hash = (value) => crypto.createHash('sha256').update(JSON.stringify(value)).digest('hex').slice(0, 24);
25
+ const safeThread = (value) => typeof value === 'string' && value.length <= 512 && Buffer.byteLength(value) <= 512 ? value : undefined;
26
+ const title = (id) => `任务 ${id.replace(/^task-/, '').slice(-8)}`;
27
+ const historyId = (taskId, state) => {
28
+ const id = `${taskId}:${state}`;
29
+ return id.length <= 256 ? id : hash([taskId, state]);
30
+ };
31
+ const visible = (meta, owner) => meta.channel === 'aun' && meta.chatType === 'private' && meta.peerId === owner
32
+ && (meta.channelId === undefined || meta.channelId === owner);
33
+ /** Bounded in-memory projection; a single startup rebuild and committed mutations, no polling. */
34
+ export class WorkbenchService {
35
+ aid;
36
+ options;
37
+ records = new Map();
38
+ touchedDuringBuild = new Set();
39
+ off = [];
40
+ ready;
41
+ building = true;
42
+ truncated = false;
43
+ unavailable = false;
44
+ closed = false;
45
+ owner;
46
+ generation;
47
+ epoch = crypto.randomBytes(12).toString('hex');
48
+ seq = 0;
49
+ revision = hash([]);
50
+ signatures = new Map();
51
+ baselineReady = false;
52
+ log = [];
53
+ cache = new Map();
54
+ flights = new Map();
55
+ pending;
56
+ constructor(aid, options = {}) {
57
+ this.aid = aid;
58
+ this.options = options;
59
+ if (options.offline) {
60
+ this.building = false;
61
+ this.unavailable = true;
62
+ this.ready = Promise.resolve();
63
+ return;
64
+ }
65
+ this.off.push(onTaskActivityMutation(mutation => {
66
+ if (this.closed || mutation.selfAid !== aid)
67
+ return;
68
+ if (this.building)
69
+ this.touchedDuringBuild.add(mutation.taskId);
70
+ if (mutation.meta)
71
+ this.records.set(mutation.taskId, mutation.meta);
72
+ else
73
+ this.records.delete(mutation.taskId);
74
+ this.boundRecords();
75
+ this.scheduleCommit();
76
+ }));
77
+ const runtimeListener = (changedAid) => { if (!changedAid || changedAid === aid)
78
+ this.scheduleCommit(); };
79
+ runtimeListeners.add(runtimeListener);
80
+ this.off.push(() => { runtimeListeners.delete(runtimeListener); });
81
+ this.ready = this.rebuild();
82
+ }
83
+ async rebuild() {
84
+ try {
85
+ const loaded = await (this.options.listMeta?.() ?? new TaskActivityStore(this.aid).listMeta());
86
+ if (this.closed)
87
+ return;
88
+ for (const meta of loaded.items)
89
+ if (!this.touchedDuringBuild.has(meta.taskId))
90
+ this.records.set(meta.taskId, meta);
91
+ this.truncated = loaded.truncated;
92
+ this.boundRecords();
93
+ }
94
+ catch {
95
+ this.unavailable = true;
96
+ }
97
+ finally {
98
+ this.building = false;
99
+ this.touchedDuringBuild.clear();
100
+ if (!this.closed)
101
+ this.commit();
102
+ }
103
+ }
104
+ boundRecords() {
105
+ if (this.records.size <= 2048)
106
+ return;
107
+ const keep = [...this.records.values()].sort((a, b) => b.updatedAt - a.updatedAt).slice(0, 2048);
108
+ this.records.clear();
109
+ for (const meta of keep)
110
+ this.records.set(meta.taskId, meta);
111
+ this.truncated = true;
112
+ }
113
+ scheduleCommit() {
114
+ if (this.pending || this.closed)
115
+ return;
116
+ // Coalesce a burst of committed activity writes into one invalidation.
117
+ this.pending = setImmediate(() => { this.pending = undefined; this.commit(); });
118
+ this.pending.unref();
119
+ }
120
+ view(now = Date.now()) {
121
+ const owner = this.owner ?? '';
122
+ const runtime = this.options.runtime?.() ?? runtimeProvider?.(this.aid);
123
+ const allActive = (runtime?.tasks ?? []).filter(task => Number.isSafeInteger(task.startedAt) && task.startedAt <= now
124
+ && /^task-[A-Za-z0-9._:-]{1,251}$/.test(task.taskId));
125
+ const active = allActive.filter(task => visible(task, owner));
126
+ const activeIds = new Set(active.map(task => task.taskId));
127
+ const metas = [...this.records.values()].filter(meta => meta.selfAid === this.aid && visible(meta, owner)
128
+ && meta.channelId === owner && /^task-[A-Za-z0-9._:-]{1,251}$/.test(meta.taskId)
129
+ && meta.createdAt <= now && meta.updatedAt <= now);
130
+ const tasks = metas.map(meta => {
131
+ const state = terminal.has(meta.taskStatus) ? meta.taskStatus : 'unknown';
132
+ return { id: meta.taskId, title: taskActivityTitle(meta.title) ?? title(meta.taskId), state, startedAt: meta.createdAt,
133
+ updatedAt: meta.updatedAt, ...(terminal.has(state) ? { completedAt: meta.updatedAt } : {}),
134
+ detailAvailable: true, ...(safeThread(meta.threadId) ? { threadId: meta.threadId } : {}) };
135
+ });
136
+ const current = active.map(task => {
137
+ const meta = this.records.get(task.taskId);
138
+ return { id: task.taskId, title: taskActivityTitle(task.title) ?? taskActivityTitle(meta?.title) ?? title(task.taskId), state: task.state, startedAt: task.startedAt,
139
+ updatedAt: meta?.updatedAt ?? task.startedAt, detailAvailable: !!meta && visible(meta, owner),
140
+ ...(safeThread(task.threadId) ? { threadId: task.threadId } : {}) };
141
+ }).sort((a, b) => b.startedAt - a.startedAt || a.id.localeCompare(b.id));
142
+ const recent = tasks.filter(task => !activeIds.has(task.id)).sort((a, b) => b.updatedAt - a.updatedAt || a.id.localeCompare(b.id));
143
+ const history = [];
144
+ for (const task of tasks) {
145
+ history.push({ id: historyId(task.id, 'started'), taskId: task.id, title: task.title, state: 'starting', at: task.startedAt,
146
+ detailAvailable: true, ...(task.threadId ? { threadId: task.threadId } : {}) });
147
+ if (terminal.has(task.state) || !activeIds.has(task.id))
148
+ history.push({
149
+ id: historyId(task.id, task.state), taskId: task.id, title: task.title, state: task.state, at: task.updatedAt,
150
+ detailAvailable: true, ...(task.threadId ? { threadId: task.threadId } : {}),
151
+ });
152
+ }
153
+ history.sort((a, b) => b.at - a.at || b.id.localeCompare(a.id));
154
+ const availability = this.building ? 'building' : this.unavailable ? 'unavailable' : 'ready';
155
+ return { runtime: { availability: runtime ? 'ready' : 'unsupported', coverage: 'complete', status: runtime?.status ?? 'unknown',
156
+ workState: runtime ? allActive.length ? 'working' : 'idle' : 'unknown', activeTaskCount: allActive.length },
157
+ current, recent, history, availability, coverage: this.truncated ? 'partial' : 'retained' };
158
+ }
159
+ commit() {
160
+ if (!this.owner || this.closed)
161
+ return;
162
+ const view = this.view();
163
+ const values = [view.runtime, view.current, [view.availability, view.coverage, view.recent],
164
+ [view.availability, view.coverage, view.history]];
165
+ if (!this.baselineReady) {
166
+ for (const [index, name] of WORKBENCH_MODULES.entries())
167
+ this.signatures.set(name, hash(values[index]));
168
+ this.revision = hash([...this.signatures]);
169
+ this.baselineReady = true;
170
+ return;
171
+ }
172
+ const changed = WORKBENCH_MODULES.filter((name, index) => this.signatures.get(name) !== hash(values[index]));
173
+ if (!changed.length)
174
+ return;
175
+ for (const [index, name] of WORKBENCH_MODULES.entries())
176
+ this.signatures.set(name, hash(values[index]));
177
+ this.revision = hash([...this.signatures]);
178
+ this.seq++;
179
+ this.log.push({ seq: this.seq, modules: changed });
180
+ if (this.log.length > 64)
181
+ this.log.shift();
182
+ const data = { sourceAid: this.aid, revision: this.revision, cursor: `${this.epoch}.${this.seq}`,
183
+ event: WORKBENCH_EVENT, changedModules: changed };
184
+ this.options.notify?.(data);
185
+ changePublisher?.(this.aid, data);
186
+ }
187
+ async authorize(message) {
188
+ if (this.closed)
189
+ throw new DataRootError('WORKBENCH_UNAVAILABLE', 'Workbench service is closed');
190
+ if (!message.encrypted)
191
+ throw new DataRootError('ENCRYPTION_REQUIRED', 'Workbench queries require encryption');
192
+ try {
193
+ return await (this.options.authorize ?? authorizeOutput)(this.aid, message.fromAid);
194
+ }
195
+ catch {
196
+ throw new DataRootError('WORKBENCH_FORBIDDEN', 'Current protocol Owner authorization is required');
197
+ }
198
+ }
199
+ async handle(message) {
200
+ if (!isWorkbenchType(message.type))
201
+ throw new DataRootError('UNKNOWN_TYPE', 'Unknown Workbench query');
202
+ const generation = await this.authorize(message);
203
+ const ensure = () => {
204
+ if (this.closed || !(this.options.current ?? currentOutputOwner)(this.aid, message.fromAid, generation)) {
205
+ this.cache.clear();
206
+ throw new DataRootError('WORKBENCH_FORBIDDEN', 'Workbench authorization changed');
207
+ }
208
+ };
209
+ ensure();
210
+ if (this.generation !== generation || this.owner !== message.fromAid) {
211
+ this.owner = message.fromAid;
212
+ this.generation = generation;
213
+ this.epoch = crypto.randomBytes(12).toString('hex');
214
+ this.seq = 0;
215
+ this.log = [];
216
+ this.signatures.clear();
217
+ this.baselineReady = false;
218
+ this.cache.clear();
219
+ }
220
+ const raw = message.payload.data;
221
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw))
222
+ throw new DataRootError('INVALID_ARGUMENT', 'data must be an object');
223
+ const data = raw;
224
+ const action = message.type.split('.').at(-1);
225
+ const allowed = { snapshot: ['protocolVersion', 'limit', 'waitForIndex'],
226
+ history: ['protocolVersion', 'from', 'to', 'limit', 'pageCursor'], changes: ['protocolVersion', 'cursor'] };
227
+ if (data.protocolVersion !== 1 || Object.keys(data).some(key => !allowed[action].includes(key))
228
+ || data.waitForIndex !== undefined && typeof data.waitForIndex !== 'boolean'
229
+ || data.limit !== undefined && (!Number.isSafeInteger(data.limit) || Number(data.limit) < 1 || Number(data.limit) > (action === 'snapshot' ? 12 : 20))
230
+ || ['from', 'to'].some(key => data[key] !== undefined && (!Number.isSafeInteger(data[key]) || Number(data[key]) < 0))
231
+ || data.pageCursor !== undefined && (typeof data.pageCursor !== 'string' || data.pageCursor.length > 512)
232
+ || action === 'changes' && (typeof data.cursor !== 'string' || data.cursor.length > 128)) {
233
+ throw new DataRootError('INVALID_ARGUMENT', 'Unsupported Workbench query parameters');
234
+ }
235
+ const fingerprint = JSON.stringify([message.type, data]);
236
+ const key = `${generation}:${message.fromAid}:${message.requestId}`;
237
+ const cached = this.cache.get(key);
238
+ if (cached && cached.until > Date.now()) {
239
+ if (cached.fingerprint !== fingerprint)
240
+ throw new DataRootError('REQUEST_ID_CONFLICT', 'request_id was reused');
241
+ return cached.result;
242
+ }
243
+ const flight = this.flights.get(key);
244
+ if (flight && flight.fingerprint !== fingerprint)
245
+ throw new DataRootError('REQUEST_ID_CONFLICT', 'request_id was reused');
246
+ if (!flight && this.flights.size >= 3)
247
+ throw new DataRootError('RATE_LIMITED', 'Workbench query concurrency exceeded');
248
+ const result = flight?.result ?? this.query(action, data);
249
+ if (!flight)
250
+ this.flights.set(key, { fingerprint, result });
251
+ try {
252
+ const value = await result;
253
+ ensure();
254
+ this.cache.set(key, { until: Date.now() + 30_000, fingerprint, result: value });
255
+ while (this.cache.size > 32)
256
+ this.cache.delete(this.cache.keys().next().value);
257
+ return value;
258
+ }
259
+ finally {
260
+ this.flights.delete(key);
261
+ }
262
+ }
263
+ async query(action, data) {
264
+ // Without a notification path the first response must be usable by itself.
265
+ if (data.waitForIndex === true || action === 'history'
266
+ || !(this.options.notifications?.() ?? notificationsAvailable(this.aid)))
267
+ await this.ready;
268
+ this.commit();
269
+ const now = Date.now();
270
+ const base = { protocol: 'evol.workbench', protocolVersion: 1, sourceAid: this.aid, generatedAt: now,
271
+ revision: this.revision, cursor: `${this.epoch}.${this.seq}`,
272
+ notifications: (this.options.notifications?.() ?? notificationsAvailable(this.aid)) ? { busAid: this.aid, event: WORKBENCH_EVENT } : null };
273
+ if (action === 'changes') {
274
+ const match = /^([a-f0-9]{24})\.(\d+)$/.exec(String(data.cursor));
275
+ const seq = match ? Number(match[2]) : -1;
276
+ const reset = !match || match[1] !== this.epoch || !Number.isSafeInteger(seq)
277
+ || seq > this.seq || seq < (this.log[0]?.seq ?? 1) - 1;
278
+ return { ...base, reset, changedModules: reset ? [...WORKBENCH_MODULES]
279
+ : [...new Set(this.log.filter(row => row.seq > seq).flatMap(row => row.modules))] };
280
+ }
281
+ const view = this.view(now);
282
+ const limit = Number(data.limit ?? (action === 'snapshot' ? 12 : 20));
283
+ let from = Number(data.from ?? 0);
284
+ let to = Math.min(Number(data.to ?? now), now);
285
+ let requestedTo = data.to === undefined ? null : Number(data.to);
286
+ let offset = 0;
287
+ if (data.pageCursor !== undefined) {
288
+ try {
289
+ const cursor = JSON.parse(Buffer.from(String(data.pageCursor), 'base64url').toString());
290
+ if (cursor.epoch !== this.epoch || cursor.revision !== this.revision
291
+ || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset > 4096
292
+ || !Number.isSafeInteger(cursor.from) || !Number.isSafeInteger(cursor.to) || cursor.from < 0 || cursor.to > now
293
+ || cursor.requestedTo !== null && (!Number.isSafeInteger(cursor.requestedTo) || cursor.requestedTo < 0)
294
+ || Object.keys(cursor).some(key => !['epoch', 'revision', 'offset', 'from', 'to', 'requestedTo'].includes(key))
295
+ || data.from !== undefined && data.from !== cursor.from
296
+ || data.to !== undefined && data.to !== (cursor.requestedTo ?? cursor.to))
297
+ throw new Error();
298
+ from = cursor.from;
299
+ to = cursor.to;
300
+ requestedTo = cursor.requestedTo;
301
+ offset = cursor.offset;
302
+ }
303
+ catch {
304
+ throw new DataRootError('INDEX_CHANGED', 'Restart Workbench history pagination');
305
+ }
306
+ }
307
+ if (from > to)
308
+ throw new DataRootError('INVALID_ARGUMENT', 'History from must not exceed the current or past to boundary');
309
+ const history = view.history.filter(item => item.at >= from && item.at <= to);
310
+ const historyLimit = action === 'snapshot' ? 20 : limit;
311
+ const items = history.slice(offset, offset + historyLimit);
312
+ const nextHistoryCursor = () => offset + items.length < history.length ? Buffer.from(JSON.stringify({
313
+ epoch: this.epoch, revision: this.revision, offset: offset + items.length, from, to, requestedTo,
314
+ })).toString('base64url') : null;
315
+ const taskModule = (items, availability, coverage) => ({
316
+ availability, coverage, items: items.slice(0, action === 'snapshot' ? limit : 12),
317
+ truncated: items.length > (action === 'snapshot' ? limit : 12),
318
+ });
319
+ const nextCursor = nextHistoryCursor();
320
+ const response = { ...base, modules: { runtime: view.runtime,
321
+ currentTasks: taskModule(view.current, view.runtime.availability, view.current.length > 12 ? 'partial' : 'complete'),
322
+ recentExecutions: taskModule(view.recent, view.availability, view.coverage),
323
+ history: { availability: view.availability, coverage: view.coverage, items, nextCursor, from, to,
324
+ oldestRetainedAt: view.history.at(-1)?.at ?? null, truncated: this.truncated || nextCursor !== null },
325
+ } };
326
+ // Leave room for the Services envelope and AUN framing. Limits alone do not
327
+ // bound UTF-8 payload size when labels, IDs and navigation hints are long.
328
+ const overBudget = () => Buffer.byteLength(JSON.stringify(response), 'utf8') > 46 * 1024;
329
+ while (overBudget() && items.length > 1)
330
+ items.pop();
331
+ const modules = response.modules;
332
+ if (items.length < Math.min(historyLimit, history.length - offset))
333
+ modules.history.coverage = 'partial';
334
+ modules.history.nextCursor = nextHistoryCursor();
335
+ modules.history.truncated ||= modules.history.nextCursor !== null;
336
+ for (const module of [modules.recentExecutions, modules.currentTasks]) {
337
+ while (overBudget() && module.items.length > 0) {
338
+ module.items.pop();
339
+ module.truncated = true;
340
+ module.coverage = 'partial';
341
+ }
342
+ }
343
+ if (overBudget())
344
+ throw new DataRootError('RESPONSE_TOO_LARGE', 'Workbench entry exceeds the response budget');
345
+ return response;
346
+ }
347
+ close() {
348
+ if (this.closed)
349
+ return;
350
+ this.closed = true;
351
+ if (this.pending)
352
+ clearImmediate(this.pending);
353
+ for (const off of this.off)
354
+ off();
355
+ this.cache.clear();
356
+ this.records.clear();
357
+ this.log = [];
358
+ }
359
+ }
@@ -324,8 +324,12 @@ export interface AgentToolResult<T> {
324
324
  * the tool promise settles are ignored.
325
325
  */
326
326
  export type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;
327
- /** Tool definition used by the agent runtime. */
328
- export interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {
327
+ /**
328
+ * Tool definition used by the agent runtime.
329
+ * The schema is exposed and consumed by callbacks. Explicit invariance avoids
330
+ * recursively inferring variance through TypeBox's Static during comparisons.
331
+ */
332
+ export interface AgentTool<in out TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {
329
333
  /** Human-readable label for UI display. */
330
334
  label: string;
331
335
  /**
@@ -49,7 +49,7 @@ evolcore 收到消息 → 构造一份 **vars**(运行时变量,见下)→
49
49
  渲染时按 `session.sessionType`(缺省 `'main'`)依次查:`sessionManifests` 覆盖 → 内置映射 → `eck_manifest.json`(`resolveSessionManifest`)。bootstrapping 阶段固定用 `eck_manifest.json`。
50
50
  **每个 manifest 文件各自两级合并**(`$KITS/<file>` + `$ECK/<file>`),互不干扰。
51
51
 
52
- `chatMode` 只支持 interactive/proactive,均复用按生命周期、sessionType 和 sessionManifests 选择的 system/message manifest 与基础 vars。派生变量 `activePush` 仅在 proactive 时为 true,工具门禁变量也按 proactive 注入。PA 身份不改变 Agent 可见的模式、manifest 或 vars;仅在 active AUN 人类 Owner 私聊主会话及话题中,将 PA 的 proactive 过程 activity 经 message.send 可靠投递,任务成功提交后的自动最终正文为 custom/agent_final。其他 proactive 场景使用 thought.put,群聊固定 proactive。默认逐条消息信封显示本轮可信 chatType/chatMode,并携带发送者身份、`与发言人` 角色、消息 ID 与来源话题;两种模式均不展示明文/密文标签;原始 encrypted 变量及发送加密语义不变。
52
+ `chatMode` 只支持 interactive/proactive,均复用按生命周期、sessionType 和 sessionManifests 选择的 system/message manifest 与基础 vars。派生变量 `activePush` 仅在 proactive 时为 true,工具门禁变量也按 proactive 注入。PA 身份不改变 Agent 可见的模式、manifest 或 vars;仅在 active AUN 人类 Owner 私聊主会话及话题中,将 PA 的 proactive 过程 activity 经 message.send 可靠投递,任务成功提交后的自动最终正文为 custom/agent_final。其他 proactive 场景使用 thought.put,群聊固定 proactive。默认逐条消息信封显示本轮可信 chatType/chatMode,并携带发送者身份、`关系角色` 角色、消息 ID 与来源话题;两种模式均不展示明文/密文标签;原始 encrypted 变量及发送加密语义不变。
53
53
 
54
54
  ## section 字段
55
55
 
@@ -48,7 +48,6 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
48
48
  | `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
49
49
  | `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
50
50
  | `ec agent` | EvolAgent 生命周期、主机信息与模板 | 创建/启停/热重载/改配置/查主机信息/打包模板/安装模板 | 管理操作按目标与角色鉴权;template 要求双 Owner | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
51
- | `ec peer` | 对端身份与本地拉黑 | 查已登记对端、拉黑/解除拉黑 | 拉黑为 Agent 自身行为;添加联系人与审批归 Owner | `peer.md` |
52
51
  | `ec directory` | Owner 名录查询、入录申请与本地备注 | 联系人/通讯录/名录/找人的 AID/申请添加联系人/这个人是谁/内外联系人/拉黑名单/记备注 | 查询需 Owner 名录授权;申请通过 `request` 发给本端 Owner | `directory.md` |
53
52
  | `ec rpc` | 底层 AUN RPC(逃生通道) | 直接调协议方法 | 仅宿主终端;托管会话仅可查看帮助 | `rpc.md` |
54
53
  | `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/远程 daemon 操作/daemon 日志/监控/原始配置/跨主机 | 运维主机或具备 `ec.menu.request` 权限的托管 Agent | `menu-client.md` |
@@ -76,10 +75,11 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
76
75
  | 命令集 | 用途 | 触发词 | 文档 |
77
76
  |--------|------|--------|------|
78
77
  | `ec ability` | 按 AID 管理、开发和打包能力插件;管理走 daemon,dev/schema 可离线 | 能力插件/开发插件/ability/上架/下架/插件打包/插件诊断 | `ability.md` |
79
- | `ec provider` | 宿主 Provider 注册表 CRUD 与单项 JSON 导入(宿主 DaemonOwner 控制入口或 trusted fullaccess 托管任务) | Provider/服务商/供应商/导入服务商/注册表 | `provider.md` |
78
+ | `ec provider` | 宿主 Provider 模板、注册表 CRUD 与单项 JSON 导入(宿主 DaemonOwner 控制入口或 trusted fullaccess 托管任务) | Provider/服务商/供应商/内置模板/套餐/导入服务商/注册表 | `provider.md` |
80
79
  | `ec model` | 模型与推理强度管理(按作用域持久化) | 切模型/列模型/当前模型/模型详情/改强度/诊断网关 | `model.md` |
81
80
  | `ec response` | 响应模式管理(按作用域持久化) | 切换响应模式/列响应模式/看当前模式/改响应配置 | `response.md` |
82
81
  | `ec config` | 配置体系底层入口(读写/快照/回滚) | 看配置/改配置/查字段/查schema/校验/快照/回滚/历史/启动记录 | `config.md` |
82
+ | `ec role` | Owner 查询/设置角色用量配额,关系角色提升申请与审批 | 角色配额/角色限额/关闭限额/恢复继承/取消配额/usageLimits/申请角色/审批角色 | `role.md` |
83
83
  | `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
84
84
  | `ec trigger` | 定时与事件触发器管理(创建用 `create`,`set` 为兼容别名) | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
85
85
  | `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
@@ -139,7 +139,9 @@ Owner 目录同步在连接可用时建立单条核验和暂态故障退避链
139
139
 
140
140
  Ownership 任务事件、修改本地 Owner 配置、相关名片或 Owner 关系材料变更只失效缓存,不主动发起复核。连接首次就绪、断线恢复和缓存到期均不触发提前刷新;下次实际消息、查询或授权需要 Owner 时才等待核验。相同任务事件和连接通知去重,无关对端、普通文件变更不触发失效。远端 Owner 的 Storage 事件只在本机确实收到时生效,不能假定事件完整覆盖远端变化。Owner 绑定提交前及修改 Owner 的授权仍要求显式核验成功。
141
141
 
142
- 处于 `created`、`ownerpending` 或 `bootstrapping` 生命周期的普通 Agent 在 AUN 连接就绪后,优先取根级 `config.json.owner`,缺失时兼容旧 `owners` 数组的首个非空 AID;沿用首个配置 Owner 的选择规则,不向数组内所有 AID 发送邀约。没有绑定目标、生命周期无效或已经 `active` 时静默跳过,不因遗留配置重新绑定。存在绑定目标且新鲜协议状态为 `unbound`、`released` 或 `single_sided` 时,每个 Agent 对同一 Owner 在本进程内最多自动提交一次绑定邀约。已有协议共识时不提交,也不自动转让 Owner。提交前记录 INFO 日志 `Submitting configured Owner binding invitation`,包含主体、目标 Owner 和协议状态;提交结果与失败继续记录 `EC_OWNERSHIP` 的 `bind.result` / `bind.failed`。等待确认、提交失败或回执不明均不定时重发,断线重连和渠道重建也不会再次提交;需要重发时显式执行绑定命令。自动尝试记录只保存在内存,不持久化;进程重启后重新检查并允许再自动提交一次。
142
+ 普通 Agent 在 AUN 连接就绪后,优先取根级 `config.json.owner`,缺失时兼容旧 `owners` 数组的首个非空 AID;沿用首个配置 Owner 的选择规则,不向数组内所有 AID 发送邀约。`created`、`ownerpending`、`bootstrapping` 和保留旧绑定目标的 `active` Agent 均参与检查;没有目标或生命周期无效时静默跳过。存在绑定目标且新鲜协议状态为 `unbound`、`released` 或 `single_sided` 时,每个 Agent 对同一 Owner 在本进程内最多进入一次 SDK 绑定变更。已有协议共识时不提交,也不自动转让 Owner。准备期间预留并发占位,实际进入 SDK 变更前才消耗次数并记录 INFO 日志 `Submitting configured Owner binding invitation`;目标身份核验、最终共识查询或连接校验失败且尚未进入 SDK 时释放占位,可在后续连接就绪时重新检查,不安排定时重试。进入 SDK 后的失败或回执不明继续保留次数,断线重连和渠道重建不重发。提交结果与失败沿用 `EC_OWNERSHIP` 的 `bind.result` / `bind.failed`。自动尝试记录仅在内存中,进程重启后可重新检查;新版一次性初始化另按持久提交记录恢复,已提交或结果不明时只核验共识,不重复发送。
143
+
144
+ App 的 `type: bind.request` 是扫码请求适配入口,先核验加密信封、扫码令牌、固定主体和请求指纹,再与 CLI 一样调用 `OwnerResolver.bind`,由 SDK 发送标准 `type: aun.ownership.sdk.v1` 协议邀约。普通 daemon 与 bootstrap 控制通道使用同一个适配器,不再一律返回 `OWNERSHIP_APP_DEFERRED`。同一扫码会话的并发与重放请求复用原结果,SDK 变更后的未知回执不重发;`bind.response.success` 只表示受理,只有实时共识确认目标 Owner、sub 和 `lock=locked` 才返回 `bound`。控制通道的 `pureIdentity` 不拦截 SDK 协议邀约,仍不参与普通 Agent 的配置补绑。
143
145
 
144
146
  普通 Agent 的创建、手动绑定、启动补绑定和转让,在提交关系修改前实时读取目标 Owner 的远端已验签名片,要求名片 AID 匹配且 `type: human`;非 human 返回 `INVALID_OWNER`,无法读取、未验签、类型缺失或名片不匹配返回 `OWNER_IDENTITY_UNAVAILABLE`。接受绑定或转让邀约也执行此限制;当前进程没有请求投影时,先从历史消息定位原请求的目标用于类型预检,原请求真实性及固定参与方仍由 SDK 在提交时核验。拒绝邀约不受目标类型限制。该限制面向普通 Agent,不把 daemon Control AID 的身份规则改成 Agent 规则,也不追溯修改已有协议关系。
145
147
 
@@ -25,6 +25,8 @@ ec config set role <role-id> --self <aid> --peer <peer-aid>
25
25
  ec config unset role --self <aid> --peer <peer-aid>
26
26
 
27
27
  `role` 不走通用配置写入;设置/撤销仍执行角色目标校验、权限检查、revision CAS、原子写入和审计。
28
+ 角色用量配额 `usageLimits` 使用 `ec role quota show|set|disable <role-id>`,见 [role.md](role.md)。
29
+ 不要用 `access.requestLimit` 代替角色用量配额,它控制消息准入频率。
28
30
 
29
31
  # 查看某一层文件原始内容(不合并,凭证显示 ${VAR} 不展开)
30
32
  ec config show [--self <aid>] [--peer <X>] [--default] [--process]
@@ -271,6 +273,16 @@ ec config unset groupRules.mode \
271
273
 
272
274
  ## 权限控制
273
275
 
276
+ **Ownership 证据缓存**:Owner 授权与同 Owner Agent 判断共用按 AID 的权威证据,正常有效期均为
277
+ 30 分钟。同 Owner 判断比较双方已验证的 Owner 与主体类型,不依赖联系人名录完整性。
278
+ 同一 AID 的并发查询共享一次请求;不同 AID 的证据刷新共用四个并发名额。临时失败共享
279
+ 5 秒起、最多 60 秒的退避;显式强制刷新不受成功缓存或失败退避限制。
280
+
281
+ daemon 把成功共识保存到 `$EVOLCORE_HOME/data/ownership-cache.json` 并登记完整性台账。
282
+ 重启只加载已登记、未篡改且原验证时间仍在 30 分钟内的记录;读取和重启不续期。
283
+ Owner/名片变更使相关内存与落盘证据失效,过期、时钟异常或已观察到的名片摘要变化会重新核验。
284
+ 临时网络故障的旧证据回退沿用调用入口现有策略,强制核验不接受该回退。
285
+
274
286
  **指定关系读取**:Menu CLI 和托管 `config get` 中,实际 owner/admin 可显式使用
275
287
  `--self <当前 Agent> --peer <目标关系>` 读取当前 Agent 的其他关系配置。admin 的命令授权、
276
288
  字段白名单和 `currentRelationOnly` 等限制继续生效;member/visitor 仍只允许当前关系。
@@ -17,6 +17,8 @@ ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--
17
17
  ec directory info <contact-aid|名字> [--limit <n>] [--format json]
18
18
  ec directory refresh [--format json]
19
19
  ec directory blocked [--format json]
20
+ ec directory block <target-aid> [--format json]
21
+ ec directory unblock <target-aid> [--format json]
20
22
  ec directory request <target-aid> [--note <申请说明>] [--format json]
21
23
  ```
22
24
 
@@ -27,7 +29,7 @@ ec directory request <target-aid> [--note <申请说明>] [--format json]
27
29
  所属 Agent,否则报 `SCOPE_MISMATCH`。
28
30
 
29
31
  > 托管 runner 不注入 `EVOLCORE_SELF_AID`,所以以前在托管会话里省略 `--self` 会直接
30
- > 报 `--self <agent-aid> is required`。现在与 `ec peer` / `ec role` 一致,由 daemon
32
+ > 报 `--self <agent-aid> is required`。现在与 `ec role` 一致,由 daemon
31
33
  > 用委托凭据补齐。
32
34
 
33
35
  ## 申请加入 Owner 名录
@@ -144,7 +146,8 @@ Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agen
144
146
  同一主体两边都被拉黑时 `source` 为 `owner,local`。名录里有这个人时补 `name` 与 `internal`,
145
147
  不在名录里也会列出(`inDirectory: false`)——被拉黑的人不一定还在名录里。
146
148
 
147
- > 本地拉黑用 `ec peer block/unblock`(见 `peer.md`),`ec directory blocked` 只做查看。
149
+ > 本地拉黑用 `ec directory block <aid>`,解除用 `ec directory unblock <aid>`。
150
+ > 写入仍落在本 Agent 的 `peers.json`,不修改 Owner 名录;`ec directory blocked` 合并查看两个来源。
148
151
 
149
152
  ## 归属核验(ownership_status)
150
153
 
@@ -177,10 +180,18 @@ human 等非 agent 类型:内部联系人 = owner_aid == owner.aid
177
180
  `<agent>/directory/remarks/<aid>.md`,改完调 `ec directory refresh` 让 `directory.md` 重算。
178
181
  不需要 CLI 也不经过 daemon——备注只落在自己的 agent 目录里,没有跨目录写入的需求。
179
182
 
183
+ `<agent>` 是**写者自己**的 agent 数据根目录,即 `$EVOLCORE_HOME/agents/<自己的 AID>/`:
184
+
180
185
  ```
181
- <agent>/directory/remarks/<aid>.md
186
+ $EVOLCORE_HOME/agents/<自己的 AID>/directory/remarks/<联系人 AID>.md
182
187
  ```
183
188
 
189
+ 所以 `<联系人 AID>` 是**要备注的那个人**,`<自己的 AID>` 是**写备注的 agent 自己**,
190
+ 两者不是一回事——写错了目标目录就是往别人的名录里塞文件,权限也不允许。
191
+
192
+ 这个文件路径每轮都会出现在注入内容里(`directory.md` 的「名录工具」一节带真实绝对路径),
193
+ 不需要背。
194
+
184
195
  ```markdown
185
196
  ---
186
197
  aid: <contact-aid>
@@ -288,7 +299,15 @@ PA Team 里,该组为空、不渲染;Owner 手动把某人移出团队清单
288
299
  | 操作 | 授权目录项 | 说明 |
289
300
  |---|---|---|
290
301
  | `list` / `info` / `refresh` / `blocked`(含旧名 `find` / `show`) | `ec.directory.query` | 只读 |
302
+ | `block` / `unblock` | `ec.directory.block` | 仅修改当前 Agent 的本地黑名单;按 Agent Owner + bypass 授权 |
291
303
  | `request` | `ec.directory.request` | 向当前 Agent 的 Owner 发送加密申请;按 Agent Owner + bypass 授权 |
292
304
 
293
305
  托管会话里 CLI 不直接读盘,携带 task delegation token 调 daemon `directory.op`;
294
306
  缺 token、token 伪造或跨会话时失败关闭。显式 `--self` 必须等于当前任务所属 Agent。
307
+
308
+ ## 本 Agent 的黑名单
309
+
310
+ 使用 ec directory block <aid> 和 ec directory unblock <aid> 管理 peers.json 的本地拉黑。
311
+ 首次拉黑可以创建记录和文件,不要求目标先在本地登记;解除不存在的拉黑不创建文件。
312
+ ec directory blocked 合并展示本地和 Owner 名录黑名单;本地 unblock 不改变 Owner 发布的黑名单。
313
+ ec peer 和 Connect Menu 已退役,联系人列表统一使用 directory list/info。
@@ -4,6 +4,21 @@
4
4
 
5
5
  宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils/`;独立 Web 服务自身代码留在 `ecweb/src/`。
6
6
 
7
+ 新建 ECWeb 代理默认使用 `visibility: public`,初始化与设置页面保持一致。显式配置的 `private`、`aun-auth` 以及关闭设置均保留;迁移旧版配置时继续保留原有访问策略。此字段用于 AUN 代理注册,ECWeb 的配对与 token 鉴权独立生效。
8
+
9
+ ## 默认启动与首次身份准备
10
+
11
+ `ec-web` 是 EvolCore 的安装依赖。`ec start` 默认由 daemon 启动并守护 ECWeb,不要求先完成初始化、创建 Agent 或填写 daemon AID。默认端口为 `42705`。`services` 缺失、为空或没有 `ecweb` 条目时,均使用内置默认服务;读取和展示不会将默认值写入 `daemon.json`。
12
+
13
+ - 没有 daemon AID:本地 ECWeb 和 IPC 可用;页面提示“主机身份待准备”,不发布 AUN 代理。
14
+ - 已有 daemon AID:默认发布 ECWeb 代理,使用 `source: instance`、`serviceType: http`、`visibility: public`,不等待 Owner 绑定或 Agent 初始化完成。控制通道、端点或网关尚未就绪时继续等待,不能视为外网已验证。
15
+ - `services[name=ecweb].enabled: false`:保持关闭,不启动本地服务、不发布代理。
16
+ - `services[name=ecweb].proxy.enabled: false`:保留本地服务,关闭代理。端口、运行模式与访问策略等显式值继续保留。
17
+
18
+ 宿主运行 `ec init --web` 时,先检查 EvolCore 自带的 ECWeb 依赖;已有依赖时不重复全局安装。若 daemon 正在运行但没有激活配置中的 AID,命令准备并保存身份后,通过现有 restart-monitor 重启,等待 IPC 返回该 AID,再输出 Web 初始化入口。此次身份激活不顺带升级包。失败或超时保留已生成身份,稍后重试不会重新生成;重启中的旧进程不能用新配置冒充已激活身份。
19
+
20
+ 普通初始化和非交互式初始化同样使用上述运行时默认值;`--ecweb` 保留为安装检查的兼容选项,不覆盖显式关闭设置。ECWeb 是内置服务,管理入口可以关闭或撤销代理;移除条目会恢复默认,因此不支持 `ec proxy remove ecweb`。
21
+
7
22
  ## 重启顺序
8
23
 
9
24
  托管 ECWeb 的重启由 `restart-monitor` 协调:
@@ -13,6 +13,16 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
13
13
 
14
14
  `ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
15
15
 
16
+ ## 自动压缩
17
+
18
+ 任务开始前的主动压缩依据当前有效 Provider 和模型目录接口返回的 `context_window`,
19
+ 不按模型名称、本地参数表或上一轮模型的窗口推测。阈值为
20
+ `min(550000, context_window - min(10000, floor(context_window * 0.05)))`。
21
+ 同一连接最近成功的目录缓存可继续使用;接口未声明有效窗口、只有模型后缀或目录不可用时,
22
+ 跳过主动压缩。手动 `/compact` 和基座自身的默认压缩仍可使用。
23
+ Claude 的 `--autocompact` 参数与返回给界面的压缩刻度使用同一份目录窗口计算;
24
+ 没有接口窗口时不下发 EvolCore 估算的阈值。该逻辑修改需要宿主重新加载源码后生效。
25
+
16
26
  ## 命令
17
27
 
18
28
  ```bash