evolcore 0.0.47 → 0.0.49

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 (266) hide show
  1. package/CHANGELOG.md +90 -1
  2. package/bin/ec-build.mjs +86 -0
  3. package/dist/agent-template/jobs.js +12 -4
  4. package/dist/agent-template/runtime.js +143 -40
  5. package/dist/agent-template/service.js +66 -13
  6. package/dist/agents/baseagent.js +60 -20
  7. package/dist/agents/claude-runner.js +34 -17
  8. package/dist/agents/codex-runner.js +36 -17
  9. package/dist/agents/ecagent-runner.js +7 -4
  10. package/dist/agents/gemini-runner.js +5 -2
  11. package/dist/agents/runner-types.js +5 -21
  12. package/dist/aun/aid/agentmd.js +5 -1
  13. package/dist/aun/msg/p2p.js +2 -1
  14. package/dist/aun/service-proxy.js +4 -2
  15. package/dist/build-identity.json +1 -0
  16. package/dist/channels/aun.js +722 -295
  17. package/dist/channels/daemon.js +9 -25
  18. package/dist/cli/aun-commands.js +86 -51
  19. package/dist/cli/code-stats.js +19 -8
  20. package/dist/cli/command-log.js +1 -1
  21. package/dist/cli/daemon-commands.js +44 -43
  22. package/dist/cli/directory.js +13 -2
  23. package/dist/cli/ecmsg-gateway.js +5 -2
  24. package/dist/cli/index.js +9 -9
  25. package/dist/cli/init-channel.js +4 -6
  26. package/dist/cli/init.js +72 -50
  27. package/dist/cli/invoke-command.js +1 -1
  28. package/dist/cli/managed-command-guard.js +2 -0
  29. package/dist/cli/model.js +20 -5
  30. package/dist/cli/provider-command.js +74 -13
  31. package/dist/cli/quota.js +89 -0
  32. package/dist/cli/role.js +62 -17
  33. package/dist/cli/services-command.js +1 -0
  34. package/dist/cli/stats.js +3 -3
  35. package/dist/cli/team-workspace-command.js +56 -2
  36. package/dist/cli/thread-command.js +16 -51
  37. package/dist/config/boot-log.js +3 -9
  38. package/dist/config/builtin-roles.js +5 -7
  39. package/dist/config/config-field-policy.js +71 -1
  40. package/dist/config/config-manager.js +13 -7
  41. package/dist/config/daemon-services.js +30 -3
  42. package/dist/config/gateway-config.js +2 -2
  43. package/dist/config/invoke-ipc-service.js +6 -4
  44. package/dist/config/peer-bind-code.js +3 -4
  45. package/dist/config/peer-book-store.js +62 -229
  46. package/dist/config/peer-book.js +26 -27
  47. package/dist/config/peer-role-resolver.js +16 -1
  48. package/dist/config/provider-identity-migration.js +4 -1
  49. package/dist/config/provider-ipc-service.js +56 -11
  50. package/dist/config/provider-menu-request.js +24 -5
  51. package/dist/config/provider-templates.js +127 -0
  52. package/dist/config/providers-config.js +67 -12
  53. package/dist/config/providers-management.js +477 -51
  54. package/dist/config/resolved-config-op.js +3 -2
  55. package/dist/config/role-command-service.js +248 -1
  56. package/dist/config/schema-migration.js +105 -4
  57. package/dist/core/agent-application-service.js +6 -1
  58. package/dist/core/agent-runtime.js +4 -0
  59. package/dist/core/auth/agent-delegation.js +2 -1
  60. package/dist/core/auth/auth-gateway.js +2 -1
  61. package/dist/core/auth/delegation-authorization.js +36 -26
  62. package/dist/core/auth/operation-authorizer.js +25 -0
  63. package/dist/core/auth/operation-catalog.js +37 -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/cli-intent-parser.js +13 -0
  68. package/dist/core/command/command-handler.js +126 -87
  69. package/dist/core/command/menu-catalog.js +1 -0
  70. package/dist/core/command/menu-handler.js +67 -150
  71. package/dist/core/command/menu-protocol.js +31 -1
  72. package/dist/core/command/provider-menu.js +13 -3
  73. package/dist/core/command/remote-shell.js +565 -0
  74. package/dist/core/command/role-menu.js +47 -23
  75. package/dist/core/command/slash-handler.js +26 -43
  76. package/dist/core/command/team-workspace-items.js +81 -12
  77. package/dist/core/command/team-workspace-team.js +9 -71
  78. package/dist/core/command/topic-slash.js +9 -30
  79. package/dist/core/daemon-bootstrap.js +8 -1
  80. package/dist/core/daemon-control.js +64 -8
  81. package/dist/core/daemon-lifecycle.js +16 -2
  82. package/dist/core/evolagent-registry.js +20 -3
  83. package/dist/core/file-integrity/store.js +2 -0
  84. package/dist/core/handoff/runtime.js +37 -1
  85. package/dist/core/inference/text-inference.js +3 -1
  86. package/dist/core/initialization/service.js +11 -6
  87. package/dist/core/interaction-router.js +3 -0
  88. package/dist/core/invoke/executors/text.js +72 -19
  89. package/dist/core/ipc-registration.js +3 -1
  90. package/dist/core/message/aun-ipc-sender.js +279 -107
  91. package/dist/core/message/contact-admission.js +91 -6
  92. package/dist/core/message/contact-pending-inbound.js +113 -0
  93. package/dist/core/message/contact-thread-approval.js +212 -0
  94. package/dist/core/message/im-renderer.js +41 -2
  95. package/dist/core/message/message-admission.js +5 -39
  96. package/dist/core/message/message-bridge.js +140 -370
  97. package/dist/core/message/message-log.js +29 -0
  98. package/dist/core/message/message-queue.js +119 -15
  99. package/dist/core/message/message-utils.js +8 -0
  100. package/dist/core/message/response-engine.js +580 -134
  101. package/dist/core/message/send-routing.js +5 -1
  102. package/dist/core/model/catalog-service.js +31 -11
  103. package/dist/core/model/config-scope.js +6 -14
  104. package/dist/core/model/model-capabilities.js +22 -4
  105. package/dist/core/model/model-catalog.js +1 -0
  106. package/dist/core/model/model-diagnostics.js +19 -0
  107. package/dist/core/model/model-fallback.js +13 -2
  108. package/dist/core/ownership/owner-resolver.js +328 -50
  109. package/dist/core/pack-auth.js +3 -0
  110. package/dist/core/pack-install.js +1 -1
  111. package/dist/core/permission/ec-command-parser.js +106 -19
  112. package/dist/core/permission/protected-paths.js +6 -6
  113. package/dist/core/permission/services-path-acl.js +451 -0
  114. package/dist/core/permission/tool-policy.js +5 -1
  115. package/dist/core/relation/peer-identity.js +36 -1
  116. package/dist/core/relation/same-owner-proof.js +81 -112
  117. package/dist/core/session/adapters/codex-session-file-adapter.js +96 -15
  118. package/dist/core/session/session-file-health.js +13 -7
  119. package/dist/core/session/session-fs-store.js +91 -35
  120. package/dist/core/session/session-manager.js +68 -24
  121. package/dist/core/session/session-mapper.js +14 -34
  122. package/dist/core/session/session-transcript.js +5 -1
  123. package/dist/core/task/task-activity-store.js +84 -0
  124. package/dist/core/task/task-recovery-service.js +13 -0
  125. package/dist/core/thread/command-parser.js +7 -12
  126. package/dist/core/thread/thread-context-storage.js +3 -2
  127. package/dist/core/thread/thread-operation.js +2 -13
  128. package/dist/core/thread/thread-service.js +15 -46
  129. package/dist/core/thread/topic-id.js +15 -0
  130. package/dist/directory/owner-directory-admission.js +12 -9
  131. package/dist/directory/owner-directory-cache.js +64 -28
  132. package/dist/directory/owner-directory-markdown.js +14 -2
  133. package/dist/directory/owner-directory-policy.js +5 -30
  134. package/dist/directory/owner-directory-query-operation.js +29 -3
  135. package/dist/directory/owner-directory-remarks.js +11 -3
  136. package/dist/directory/owner-directory-request-operation.js +5 -2
  137. package/dist/eck/kit-renderer.js +1 -1
  138. package/dist/eck/message-renderer.js +112 -29
  139. package/dist/ecweb/basic-settings-service.js +3 -1
  140. package/dist/ecweb/message-context-service.js +1 -1
  141. package/dist/ecweb/pairing.js +4 -3
  142. package/dist/ecweb/providers-service.js +26 -1
  143. package/dist/ecweb/runtime/lifecycle.js +18 -8
  144. package/dist/ecweb/runtime/proxy-access.js +74 -0
  145. package/dist/ecweb/runtime/supervisor.js +36 -6
  146. package/dist/event-center/center-config.js +9 -5
  147. package/dist/event-center/dispatcher.js +10 -1
  148. package/dist/event-center/ipc-operation.js +19 -0
  149. package/dist/event-center/registry.js +29 -3
  150. package/dist/event-center/runtime.js +106 -11
  151. package/dist/event-center/script-runner.js +5 -5
  152. package/dist/index.js +96 -59
  153. package/dist/ipc.js +38 -3
  154. package/dist/outputs/authorization.js +16 -0
  155. package/dist/outputs/cards.js +336 -0
  156. package/dist/outputs/events.js +63 -0
  157. package/dist/outputs/protocol.js +103 -0
  158. package/dist/outputs/service.js +266 -0
  159. package/dist/paths.js +3 -0
  160. package/dist/proxy/manager.js +43 -13
  161. package/dist/services/index.js +114 -5
  162. package/dist/services/ipc-operation.js +88 -15
  163. package/dist/services/pack-manager.js +13 -1
  164. package/dist/services/router.js +21 -6
  165. package/dist/services/script-runner.js +5 -4
  166. package/dist/services/service-payload.js +13 -7
  167. package/dist/services/validation.js +1 -1
  168. package/dist/stats/budget.js +2 -2
  169. package/dist/stats/db.js +19 -0
  170. package/dist/stats/index.js +1 -1
  171. package/dist/stats/{price-resolver.js → model-resolver.js} +304 -23
  172. package/dist/stats/normalizer.js +2 -0
  173. package/dist/stats/query.js +35 -27
  174. package/dist/stats/quota-query.js +95 -0
  175. package/dist/stats/role-budget.js +5 -2
  176. package/dist/stats/writer.js +10 -6
  177. package/dist/trigger/audit.js +7 -0
  178. package/dist/trigger/authorization.js +105 -11
  179. package/dist/trigger/feedback.js +10 -0
  180. package/dist/trigger/history.js +37 -11
  181. package/dist/trigger/ipc-service.js +12 -1
  182. package/dist/trigger/manager.js +1 -0
  183. package/dist/trigger/scheduler.js +7 -5
  184. package/dist/trigger/script-executor.js +2 -1
  185. package/dist/trigger/script-sandbox.js +21 -3
  186. package/dist/trigger/validation.js +22 -0
  187. package/dist/utils/atomic-write.js +22 -8
  188. package/dist/utils/cross-platform.js +73 -26
  189. package/dist/utils/error-dict.json +94 -4
  190. package/dist/utils/error-utils.js +27 -4
  191. package/dist/utils/evolcore-version.js +36 -65
  192. package/dist/utils/host-info.js +100 -1
  193. package/dist/utils/msg-diag.js +1 -0
  194. package/dist/utils/npm-ops.js +43 -8
  195. package/dist/utils/process-introspect.js +12 -7
  196. package/dist/utils/process-tree.js +50 -2
  197. package/dist/utils/windows-shell-trust.js +2 -0
  198. package/dist/workbench/protocol.js +80 -0
  199. package/dist/workbench/service.js +359 -0
  200. package/ecagent/dist/types.d.ts +6 -2
  201. package/kits/docs/context-assembly.md +1 -1
  202. package/kits/docs/evolcore/INDEX.md +4 -2
  203. package/kits/docs/evolcore/aid.md +25 -0
  204. package/kits/docs/evolcore/config.md +16 -1
  205. package/kits/docs/evolcore/directory.md +30 -12
  206. package/kits/docs/evolcore/ecweb-lifecycle.md +15 -0
  207. package/kits/docs/evolcore/model.md +10 -0
  208. package/kits/docs/evolcore/msg.md +9 -0
  209. package/kits/docs/evolcore/peer.md +19 -65
  210. package/kits/docs/evolcore/provider.md +124 -4
  211. package/kits/docs/evolcore/quota.md +54 -0
  212. package/kits/docs/evolcore/role.md +83 -0
  213. package/kits/docs/evolcore/services.md +6 -6
  214. package/kits/docs/evolcore/stats.md +2 -0
  215. package/kits/docs/evolcore/team-workspace.md +1 -1
  216. package/kits/docs/evolcore/thread-chain.md +14 -15
  217. package/kits/docs/evolcore/tool-authorization.md +5 -0
  218. package/kits/docs/evolcore/trigger.md +12 -0
  219. package/kits/eck_message_manifest.json +12 -0
  220. package/kits/provider-templates.json +1213 -0
  221. package/kits/rules/04-relation.md +3 -3
  222. package/kits/schemas/_meta.json +14 -2
  223. package/kits/schemas/agent-config.schema.20.json +24 -0
  224. package/kits/schemas/contact-book.schema.4.json +52 -0
  225. package/kits/schemas/providers.schema.3.json +200 -0
  226. package/kits/skills/.switches.json +8 -0
  227. package/kits/skills/ability/references/calling.md +1 -1
  228. package/kits/skills/agent-output-cards/SKILL.md +57 -0
  229. package/kits/skills/ec-group/SKILL.md +2 -2
  230. package/kits/skills/ec-identity/SKILL.md +19 -72
  231. package/kits/skills/ec-provider/SKILL.md +270 -0
  232. package/kits/skills/ec-provider/scripts/check-model.mjs +80 -0
  233. package/kits/skills/ec-trigger/SKILL.md +1 -1
  234. package/kits/skills/thread-ops/SKILL.md +34 -21
  235. package/kits/templates/message-fragments/group-batch-item.md +1 -1
  236. package/kits/templates/message-fragments/group-batch.md +1 -1
  237. package/kits/templates/message-fragments/inject-default.md +1 -1
  238. package/kits/templates/message-fragments/interrupt-insert.md +1 -0
  239. package/kits/templates/message-fragments/item-group.md +1 -1
  240. package/kits/templates/message-fragments/item-private.md +1 -1
  241. package/kits/templates/message-fragments/thread-context.md +1 -1
  242. package/kits/templates/message-fragments/trigger-session.md +1 -1
  243. package/kits/templates/message-fragments/trigger-thread-check.md +1 -1
  244. package/kits/templates/roles/admin.json +2 -19
  245. package/kits/templates/roles/member.json +0 -3
  246. package/kits/templates/roles/visitor.json +1 -0
  247. package/kits/templates/system-fragments/baseagent.md +6 -0
  248. package/kits/templates/system-fragments/commands.md +4 -3
  249. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  250. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  251. package/kits/templates/system-fragments/relation.md +1 -1
  252. package/kits/templates/system-fragments/thread.md +7 -5
  253. package/kits/templates/system-fragments/venue.md +11 -0
  254. package/package.json +6 -4
  255. package/scripts/agent-template/inspect.mjs +50 -11
  256. package/scripts/agent-template/shared/common.mjs +11 -6
  257. package/scripts/agent-template/shared/team-schema.json +6 -4
  258. package/scripts/agent-template/shared/template-contract.mjs +62 -11
  259. package/scripts/agent-template/shared/template-package.mjs +189 -21
  260. package/scripts/agent-template/shared/template-runtime.mjs +54 -6
  261. package/scripts/agent-template/shared/template.mjs +2 -2
  262. package/scripts/agent-template/team-pack.mjs +52 -14
  263. package/dist/cli/peer.js +0 -127
  264. package/dist/config/peer-operation-service.js +0 -132
  265. package/dist/config/peer-request-service.js +0 -532
  266. 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/authorization.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,11 +75,13 @@ 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
+ | `ec quota` | 查询 Agent 与对端的生效限额、已用及剩余(status) | 自身限额/对端限额/剩余额度/是否超限 | `quota.md` |
84
85
  | `ec trigger` | 定时与事件触发器管理(创建用 `create`,`set` 为兼容别名) | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
85
86
  | `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
86
87
  | `ec events` | AUN 事件中心:注册/发布/订阅事件,事件到达跑脚本 | 事件中心/注册事件/发布事件/订阅事件/事件包/pack.json/events-config.json/scripts/AUN 事件 | `event-center.md` |
@@ -105,6 +106,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
105
106
  | [`tool-authorization.md`](tool-authorization.md) | 工具执行、人工审批与 EC 授权图解;trusted fullaccess 与 DaemonOwner 对照;Owner 凭证及模型审批预留 | 工具审批/授权流程/权限图解/Owner+bypass/fullaccess/DaemonOwner/决策模型审批 |
106
107
  | `menu-protocol.md` | Menu Protocol 规范(消息类型 / protected_headers / name→operation 映射 / 鉴权机制) | menu 消息格式/为什么被拒/服务端怎么读 menu/auth_method/凭证怎么带/Evol App 怎么调 daemon |
107
108
  | `menu-exec-schema-commands.md` | 通过 `menu.action name=cli action=exec` 取配置 schema 的命令手册 | 配置 schema 版本/schema 内容/远程取 schema |
109
+ | [`aid.md`](aid.md#daemonowner-远程单命令) | DaemonOwner 在 Control AID 的 E2EE 私聊以 /exec on 进入终端后直接发命令,/stop 取消,/exec off 退出,进出使用 notice;最长 30 分钟、空闲 6 分钟 | 虚拟SSH/remote-shell/daemon执行命令/exec on/exec stop/终端状态 |
108
110
  | `ec-capabilities.md` | EC Skill 系统机制概要(三级目录、开关覆盖链、渐进式披露、编写规范、权限) | 技能系统怎么工作/技能放在哪里/SKILL.md 怎么写/技能为什么没生效/description 怎么写 |
109
111
  | `$KITS_DOCS/aun/ABILITY_CALLING.md` | AUN Ability 的发现、原始 payload、请求关联与结果查询 | 能力调用/Ability/protocol/discover/ability_path/request_id/call_id/超时查询 |
110
112
 
@@ -246,3 +246,28 @@ ec aid delete <aid>
246
246
  - `--aun-path <path>` — 指定 AUN keystore 根;未传时可由 `AUN_HOME` 提供
247
247
  - `aid delete --orphan|--no-cert|--unrecoverable` 默认 dry-run,`--yes` 才执行删除
248
248
  - `--help` / `-h` — 各子命令均支持
249
+
250
+ ## DaemonOwner 远程单命令
251
+
252
+ 在 daemon Control AID 与其当前协议 Owner AID 的 **E2EE 私聊**中发送文本即可使用,无需客户端新增页面或手动填写 token、窗口 ID。
253
+
254
+ Owner 发送未加密的 /exec 时,daemon 会核验协议身份及发送设备,以加密消息回复 `E2EE_REQUIRED` 并提示开启端到端加密;该请求不执行,也不改变窗口状态。
255
+
256
+ | 指令 | 作用 |
257
+ |---|---|
258
+ | `/exec on` | 进入终端操作状态,以 notice 提示;最长 30 分钟,空闲 6 分钟自动退出 |
259
+ | `uname -a` | 进入后直接发送单条命令,返回 stdout、stderr 和退出码 |
260
+ | `/exec off` | 退出终端操作状态,以 notice 提示,并取消正在执行和排队的命令 |
261
+ | `/exec` | 查看窗口、剩余时间和当前执行状态;不自动进入终端、不续期 |
262
+ | `/stop` 或 `/exec stop` | 取消正在执行和排队的命令,保留终端操作状态 |
263
+ | `/exec uname -a` | 兼容带前缀执行单条命令 |
264
+
265
+ 进入 notice 送达后,当前 Owner、设备和话题的原始 text 按命令处理;其他设备或话题需各自开启。退出后普通文字恢复 daemon 原有处理。直接发送的 on/off/status/stop 是程序名,控制指令保留斜杠;/stop 仅在 daemon 控制会话中作为取消别名,未开启时返回已关闭。
266
+
267
+ 同一终端的命令按顺序执行;重复 /exec on 和 /exec 不续期,也不重复提示进入。空闲从上条实际命令完成计时,运行中仍受 30 分钟绝对期限约束。手动关闭、空闲及到期退出发送 notice;断线或 Owner 失效时立即关闭,无法投递的状态 notice 不排队到重连后重放。daemon 重启后需重新 on,开启状态不写入配置。
268
+
269
+ 只接收原始 text。引用、合并消息、群消息和普通 Agent AID 不提供此入口;Agent Owner、fullaccess、Menu token 和诊断 remote_access_token 都不能替代 daemon 当前协议 Owner 身份。
270
+
271
+ 按 daemon 运行账号的系统权限执行单个程序,不提供交互 stdin、PTY 或跨命令保留的 cd/环境变量状态。使用程序自身的目录选项或绝对路径;不支持 `&&`、管道、重定向、后台符及 shell 展开,EvolCore 既有危险命令命中后直接拒绝。Windows 的 shell 内建命令及不能直接启动的 .cmd/.bat 会报告启动错误。
272
+
273
+ stdout/stderr 各最多捕获 8 MiB,越限终止并报告 OUTPUT_LIMIT;长结果按 UTF-8 分片,附原消息 ID 和序号,最后返回退出状态。同一消息的重发不会重复执行;跨 daemon 重启不保证执行去重,重启后窗口默认关闭。
@@ -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]
@@ -181,7 +183,10 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
181
183
 
182
184
  - `provider` 指 `~/.evolcore/providers.json` 里的服务商 id。网关连接信息(`baseUrl`、`apiKey`、
183
185
  `headers`、`queryParams`)只存在于 providers.json,Agent 级不再承载,也不做 `${VAR}` 展开。
184
- - `fallback` 降级链每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
186
+ - `fallback` 降级链最多 3 项,每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
187
+ Agent 级用 `ec config set baseagents.<baseagent>.fallback '<JSON 数组>' --self <aid>` 写入,空数组表示清除;
188
+ defaults 级仍只允许手工编辑 `agents/defaults.json`。写入成功不代表一定降级:候选模型不在目录、
189
+ 不在角色允许范围、或 `effort` 不在该模型声明的强度列表里都会被过滤,`ec model check` 会打印被打回的条目。
185
190
  - relation 层不承载 `baseagents`、`active_baseagent`、`model`、`models` 或 `Services`;这些字段在关系层会被剥离。
186
191
  - `Services.<用途>`(如 `Services.decision`)也在 defaults 提供全局默认,Agent 可逐字段覆盖。
187
192
  - Agent 和 defaults 均未设置模型时,Claude/Codex 回落到本机 CLI 配置;再缺省时使用 runner 的内置默认模型。推理强度按同一层级逐字段回落。
@@ -271,6 +276,16 @@ ec config unset groupRules.mode \
271
276
 
272
277
  ## 权限控制
273
278
 
279
+ **Ownership 证据缓存**:Owner 授权与同 Owner Agent 判断共用按 AID 的权威证据,正常有效期均为
280
+ 30 分钟。同 Owner 判断比较双方已验证的 Owner 与主体类型,不依赖联系人名录完整性。
281
+ 同一 AID 的并发查询共享一次请求;不同 AID 的证据刷新共用四个并发名额。临时失败共享
282
+ 5 秒起、最多 60 秒的退避;显式强制刷新不受成功缓存或失败退避限制。
283
+
284
+ daemon 把成功共识保存到 `$EVOLCORE_HOME/data/ownership-cache.json` 并登记完整性台账。
285
+ 重启只加载已登记、未篡改且原验证时间仍在 30 分钟内的记录;读取和重启不续期。
286
+ Owner/名片变更使相关内存与落盘证据失效,过期、时钟异常或已观察到的名片摘要变化会重新核验。
287
+ 临时网络故障的旧证据回退沿用调用入口现有策略,强制核验不接受该回退。
288
+
274
289
  **指定关系读取**:Menu CLI 和托管 `config get` 中,实际 owner/admin 可显式使用
275
290
  `--self <当前 Agent> --peer <目标关系>` 读取当前 Agent 的其他关系配置。admin 的命令授权、
276
291
  字段白名单和 `currentRelationOnly` 等限制继续生效;member/visitor 仍只允许当前关系。
@@ -6,7 +6,7 @@
6
6
  触发词:联系人/通讯录/名录/找人的 AID/这个人是谁/内外联系人/拉黑名单/记备注。
7
7
 
8
8
  它不是联系人管理入口:谁能联系这个 Agent、名录里有哪些人,由 Owner 在 Evol App 里决定,
9
- Agent 侧可以查询或向 Owner 发送入录申请,不能直接增删名录条目。
9
+ Agent 侧可以查询或向目标发送好友邀请,不能直接增删 Owner 名录条目。普通消息出站不需要先入录。
10
10
 
11
11
  ## 命令面
12
12
 
@@ -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,25 +29,24 @@ 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 名录
34
36
 
35
- 当发送因目标不在本端 Owner 名录中被拒绝时,执行:
37
+ 需要显式申请与目标建立联系人关系时,执行:
36
38
 
37
39
  ```bash
38
40
  ec directory request evolapplwj.agentid.cn --note "三藏希望了解项目接下来的工作重点"
39
41
  ```
40
42
 
41
- `request` 自动确定本端 Agent 与其 Owner,向 Owner 发送一条**加密加好友申请**(app-v1
42
- `friend.invite.v1`),列明本端 Agent、目标 AID 和申请说明(最多 500 字符)。Owner 需要在
43
- Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agent 访问对应的联系人范围。
44
- 申请不会给目标发送消息,也不会修改本地名录、准入开关或自动重发原消息。
43
+ `request` 自动确定本端 Agent,向目标 AID 发送加密 `friend.invite.v1`,申请说明最多 500 字符。
44
+ 目标根据其准入策略决定,或转交它的 Owner 审批。邀请不修改本地名录或自动重发此前的出站消息。
45
45
 
46
46
  成功返回 `action: request`、`targetAid`、`status: sent` 和 `message_id`,
47
- 仅表示申请消息已发送,**不表示 Owner 已同意或目标已入录**。Owner 处理后执行
48
- `ec directory refresh`,同步名录后再重试原发送命令。
47
+ 仅表示邀请已发送,不表示审批完成。普通消息出站可直接发送。
48
+ 本端收到未准入的纯文本时,Core 收存原文并向自己的 Owner 申请;永久许可在名录成功应用后、
49
+ 临时许可在落盘后自动恢复原消息,保留原发件人和话题。待收有效期 3 天,旧版只有摘要的隔离记录不能补恢复。
49
50
 
50
51
  ## list — 列举与关键词过滤
51
52
 
@@ -144,7 +145,8 @@ Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agen
144
145
  同一主体两边都被拉黑时 `source` 为 `owner,local`。名录里有这个人时补 `name` 与 `internal`,
145
146
  不在名录里也会列出(`inDirectory: false`)——被拉黑的人不一定还在名录里。
146
147
 
147
- > 本地拉黑用 `ec peer block/unblock`(见 `peer.md`),`ec directory blocked` 只做查看。
148
+ > 本地拉黑用 `ec directory block <aid>`,解除用 `ec directory unblock <aid>`。
149
+ > 写入仍落在本 Agent 的 `peers.json`,不修改 Owner 名录;`ec directory blocked` 合并查看两个来源。
148
150
 
149
151
  ## 归属核验(ownership_status)
150
152
 
@@ -177,10 +179,18 @@ human 等非 agent 类型:内部联系人 = owner_aid == owner.aid
177
179
  `<agent>/directory/remarks/<aid>.md`,改完调 `ec directory refresh` 让 `directory.md` 重算。
178
180
  不需要 CLI 也不经过 daemon——备注只落在自己的 agent 目录里,没有跨目录写入的需求。
179
181
 
182
+ `<agent>` 是**写者自己**的 agent 数据根目录,即 `$EVOLCORE_HOME/agents/<自己的 AID>/`:
183
+
180
184
  ```
181
- <agent>/directory/remarks/<aid>.md
185
+ $EVOLCORE_HOME/agents/<自己的 AID>/directory/remarks/<联系人 AID>.md
182
186
  ```
183
187
 
188
+ 所以 `<联系人 AID>` 是**要备注的那个人**,`<自己的 AID>` 是**写备注的 agent 自己**,
189
+ 两者不是一回事——写错了目标目录就是往别人的名录里塞文件,权限也不允许。
190
+
191
+ 这个文件路径每轮都会出现在注入内容里(`directory.md` 的「名录工具」一节带真实绝对路径),
192
+ 不需要背。
193
+
184
194
  ```markdown
185
195
  ---
186
196
  aid: <contact-aid>
@@ -288,7 +298,15 @@ PA Team 里,该组为空、不渲染;Owner 手动把某人移出团队清单
288
298
  | 操作 | 授权目录项 | 说明 |
289
299
  |---|---|---|
290
300
  | `list` / `info` / `refresh` / `blocked`(含旧名 `find` / `show`) | `ec.directory.query` | 只读 |
291
- | `request` | `ec.directory.request` | 向当前 Agent 的 Owner 发送加密申请;按 Agent Owner + bypass 授权 |
301
+ | `block` / `unblock` | `ec.directory.block` | 仅修改当前 Agent 的本地黑名单;按 Agent Owner + bypass 授权 |
302
+ | `request` | `ec.directory.request` | 向目标发送加密好友邀请;按 Agent Owner + bypass 授权 |
292
303
 
293
304
  托管会话里 CLI 不直接读盘,携带 task delegation token 调 daemon `directory.op`;
294
305
  缺 token、token 伪造或跨会话时失败关闭。显式 `--self` 必须等于当前任务所属 Agent。
306
+
307
+ ## 本 Agent 的黑名单
308
+
309
+ 使用 ec directory block <aid> 和 ec directory unblock <aid> 管理 peers.json 的本地拉黑。
310
+ 首次拉黑可以创建记录和文件,不要求目标先在本地登记;解除不存在的拉黑不创建文件。
311
+ ec directory blocked 合并展示本地和 Owner 名录黑名单;本地 unblock 不改变 Owner 发布的黑名单。
312
+ 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