evolcore 0.0.47 → 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.
- package/CHANGELOG.md +56 -1
- package/bin/ec-build.mjs +86 -0
- package/dist/agent-template/jobs.js +12 -4
- package/dist/agent-template/runtime.js +139 -39
- package/dist/agent-template/service.js +66 -13
- package/dist/agents/baseagent.js +60 -20
- package/dist/agents/claude-runner.js +34 -17
- package/dist/agents/codex-runner.js +31 -16
- package/dist/agents/ecagent-runner.js +7 -4
- package/dist/agents/gemini-runner.js +5 -2
- package/dist/agents/runner-types.js +5 -21
- package/dist/aun/aid/agentmd.js +5 -1
- package/dist/aun/service-proxy.js +4 -2
- package/dist/build-identity.json +1 -0
- package/dist/channels/aun.js +81 -24
- package/dist/channels/daemon.js +9 -25
- package/dist/cli/aun-commands.js +86 -51
- package/dist/cli/code-stats.js +19 -8
- package/dist/cli/command-log.js +1 -1
- package/dist/cli/daemon-commands.js +44 -43
- package/dist/cli/directory.js +7 -1
- package/dist/cli/ecmsg-gateway.js +5 -2
- package/dist/cli/index.js +2 -8
- package/dist/cli/init-channel.js +4 -6
- package/dist/cli/init.js +72 -50
- package/dist/cli/invoke-command.js +1 -1
- package/dist/cli/provider-command.js +74 -13
- package/dist/cli/role.js +61 -17
- package/dist/cli/stats.js +3 -3
- package/dist/cli/thread-command.js +16 -51
- package/dist/config/boot-log.js +3 -9
- package/dist/config/builtin-roles.js +5 -7
- package/dist/config/config-manager.js +2 -6
- package/dist/config/daemon-services.js +30 -3
- package/dist/config/gateway-config.js +2 -2
- package/dist/config/invoke-ipc-service.js +6 -4
- package/dist/config/peer-bind-code.js +3 -4
- package/dist/config/peer-book-store.js +62 -229
- package/dist/config/peer-book.js +26 -27
- package/dist/config/peer-role-resolver.js +16 -1
- package/dist/config/provider-identity-migration.js +4 -1
- package/dist/config/provider-ipc-service.js +56 -11
- package/dist/config/provider-menu-request.js +24 -5
- package/dist/config/provider-templates.js +127 -0
- package/dist/config/providers-config.js +59 -8
- package/dist/config/providers-management.js +467 -49
- package/dist/config/role-command-service.js +248 -1
- package/dist/config/schema-migration.js +105 -4
- package/dist/core/agent-application-service.js +6 -1
- package/dist/core/agent-runtime.js +4 -0
- package/dist/core/auth/agent-delegation.js +2 -1
- package/dist/core/auth/auth-gateway.js +2 -1
- package/dist/core/auth/delegation-authorization.js +3 -0
- package/dist/core/auth/operation-authorizer.js +25 -0
- package/dist/core/auth/operation-catalog.js +28 -64
- package/dist/core/capability/providers/codex-capability-provider.js +7 -8
- package/dist/core/channel-loader.js +18 -0
- package/dist/core/command/agent-control.js +32 -0
- package/dist/core/command/command-handler.js +81 -85
- package/dist/core/command/menu-catalog.js +1 -0
- package/dist/core/command/menu-handler.js +61 -149
- package/dist/core/command/menu-protocol.js +7 -1
- package/dist/core/command/provider-menu.js +13 -3
- package/dist/core/command/role-menu.js +47 -23
- package/dist/core/command/slash-handler.js +26 -43
- package/dist/core/command/team-workspace-items.js +81 -12
- package/dist/core/command/team-workspace-team.js +9 -71
- package/dist/core/command/topic-slash.js +9 -30
- package/dist/core/daemon-bootstrap.js +8 -1
- package/dist/core/daemon-control.js +7 -7
- package/dist/core/evolagent-registry.js +14 -1
- package/dist/core/file-integrity/store.js +2 -0
- package/dist/core/handoff/runtime.js +37 -1
- package/dist/core/inference/text-inference.js +3 -1
- package/dist/core/initialization/service.js +11 -6
- package/dist/core/interaction-router.js +3 -0
- package/dist/core/invoke/executors/text.js +72 -19
- package/dist/core/ipc-registration.js +2 -1
- package/dist/core/message/aun-ipc-sender.js +165 -55
- package/dist/core/message/im-renderer.js +1 -1
- package/dist/core/message/message-bridge.js +51 -334
- package/dist/core/message/message-log.js +5 -0
- package/dist/core/message/message-queue.js +22 -0
- package/dist/core/message/message-utils.js +8 -0
- package/dist/core/message/response-engine.js +429 -116
- package/dist/core/message/send-routing.js +5 -1
- package/dist/core/model/catalog-service.js +31 -11
- package/dist/core/model/model-capabilities.js +22 -4
- package/dist/core/model/model-catalog.js +1 -0
- package/dist/core/ownership/owner-resolver.js +328 -50
- package/dist/core/permission/protected-paths.js +6 -6
- package/dist/core/relation/peer-identity.js +23 -1
- package/dist/core/relation/same-owner-proof.js +81 -112
- package/dist/core/session/adapters/codex-session-file-adapter.js +96 -15
- package/dist/core/session/session-file-health.js +13 -7
- package/dist/core/session/session-fs-store.js +91 -35
- package/dist/core/session/session-manager.js +68 -24
- package/dist/core/session/session-mapper.js +14 -34
- package/dist/core/session/session-transcript.js +5 -1
- package/dist/core/task/task-activity-store.js +84 -0
- package/dist/core/task/task-recovery-service.js +12 -0
- package/dist/core/thread/command-parser.js +7 -12
- package/dist/core/thread/thread-context-storage.js +3 -2
- package/dist/core/thread/thread-operation.js +2 -13
- package/dist/core/thread/thread-service.js +15 -46
- package/dist/directory/owner-directory-admission.js +1 -1
- package/dist/directory/owner-directory-cache.js +45 -28
- package/dist/directory/owner-directory-markdown.js +13 -1
- package/dist/directory/owner-directory-query-operation.js +29 -3
- package/dist/directory/owner-directory-remarks.js +11 -3
- package/dist/eck/message-renderer.js +84 -24
- package/dist/ecweb/basic-settings-service.js +3 -1
- package/dist/ecweb/message-context-service.js +1 -1
- package/dist/ecweb/pairing.js +4 -3
- package/dist/ecweb/providers-service.js +26 -1
- package/dist/ecweb/runtime/lifecycle.js +18 -8
- package/dist/ecweb/runtime/proxy-access.js +74 -0
- package/dist/ecweb/runtime/supervisor.js +4 -2
- package/dist/event-center/registry.js +13 -2
- package/dist/event-center/runtime.js +103 -11
- package/dist/event-center/script-runner.js +5 -5
- package/dist/index.js +92 -59
- package/dist/ipc.js +13 -2
- package/dist/outputs/events.js +62 -0
- package/dist/outputs/protocol.js +102 -0
- package/dist/outputs/service.js +279 -0
- package/dist/paths.js +3 -0
- package/dist/proxy/manager.js +43 -13
- package/dist/services/index.js +89 -4
- package/dist/services/ipc-operation.js +4 -15
- package/dist/services/pack-manager.js +12 -1
- package/dist/services/router.js +21 -6
- package/dist/services/script-runner.js +5 -4
- package/dist/services/validation.js +1 -1
- package/dist/stats/budget.js +1 -1
- package/dist/stats/db.js +19 -0
- package/dist/stats/index.js +1 -1
- package/dist/stats/{price-resolver.js → model-resolver.js} +305 -24
- package/dist/stats/normalizer.js +2 -0
- package/dist/stats/query.js +35 -27
- package/dist/stats/role-budget.js +5 -2
- package/dist/stats/writer.js +10 -6
- package/dist/trigger/audit.js +7 -0
- package/dist/trigger/authorization.js +105 -11
- package/dist/trigger/feedback.js +10 -0
- package/dist/trigger/history.js +37 -11
- package/dist/trigger/ipc-service.js +12 -1
- package/dist/trigger/manager.js +1 -0
- package/dist/trigger/scheduler.js +7 -5
- package/dist/trigger/script-executor.js +2 -1
- package/dist/trigger/script-sandbox.js +9 -3
- package/dist/trigger/validation.js +22 -0
- package/dist/utils/cross-platform.js +73 -26
- package/dist/utils/error-dict.json +94 -4
- package/dist/utils/error-utils.js +27 -4
- package/dist/utils/evolcore-version.js +36 -65
- package/dist/utils/msg-diag.js +1 -0
- package/dist/utils/process-introspect.js +12 -7
- package/dist/utils/process-tree.js +50 -2
- package/dist/utils/windows-shell-trust.js +2 -0
- package/dist/workbench/protocol.js +80 -0
- package/dist/workbench/service.js +359 -0
- package/ecagent/dist/types.d.ts +6 -2
- package/kits/docs/context-assembly.md +1 -1
- package/kits/docs/evolcore/INDEX.md +2 -2
- package/kits/docs/evolcore/config.md +12 -0
- package/kits/docs/evolcore/directory.md +22 -3
- package/kits/docs/evolcore/ecweb-lifecycle.md +15 -0
- package/kits/docs/evolcore/model.md +10 -0
- package/kits/docs/evolcore/peer.md +19 -65
- package/kits/docs/evolcore/provider.md +123 -3
- package/kits/docs/evolcore/role.md +80 -0
- package/kits/docs/evolcore/services.md +6 -6
- package/kits/docs/evolcore/team-workspace.md +1 -1
- package/kits/docs/evolcore/thread-chain.md +14 -15
- package/kits/docs/evolcore/tool-authorization.md +5 -0
- package/kits/docs/evolcore/trigger.md +10 -0
- package/kits/eck_message_manifest.json +12 -0
- package/kits/provider-templates.json +1213 -0
- package/kits/rules/04-relation.md +3 -3
- package/kits/schemas/_meta.json +14 -2
- package/kits/schemas/contact-book.schema.4.json +52 -0
- package/kits/schemas/providers.schema.3.json +200 -0
- package/kits/skills/.switches.json +4 -0
- package/kits/skills/ability/references/calling.md +1 -1
- package/kits/skills/ec-group/SKILL.md +2 -2
- package/kits/skills/ec-identity/SKILL.md +19 -72
- package/kits/skills/ec-provider/SKILL.md +221 -0
- package/kits/skills/ec-provider/scripts/check-model.mjs +80 -0
- package/kits/skills/ec-trigger/SKILL.md +1 -1
- package/kits/skills/thread-ops/SKILL.md +34 -21
- package/kits/templates/message-fragments/group-batch-item.md +1 -1
- package/kits/templates/message-fragments/group-batch.md +1 -1
- package/kits/templates/message-fragments/inject-default.md +1 -1
- package/kits/templates/message-fragments/interrupt-insert.md +1 -0
- package/kits/templates/message-fragments/item-group.md +1 -1
- package/kits/templates/message-fragments/item-private.md +1 -1
- package/kits/templates/message-fragments/thread-context.md +1 -1
- package/kits/templates/message-fragments/trigger-session.md +1 -1
- package/kits/templates/message-fragments/trigger-thread-check.md +1 -1
- package/kits/templates/roles/admin.json +2 -19
- package/kits/templates/roles/member.json +0 -3
- package/kits/templates/system-fragments/baseagent.md +6 -0
- package/kits/templates/system-fragments/commands.md +3 -3
- package/kits/templates/system-fragments/managed-runtime.md +1 -1
- package/kits/templates/system-fragments/relation.md +1 -1
- package/kits/templates/system-fragments/thread.md +6 -5
- package/package.json +6 -4
- package/scripts/agent-template/inspect.mjs +4 -1
- package/scripts/agent-template/shared/common.mjs +2 -3
- package/scripts/agent-template/shared/template-contract.mjs +2 -1
- package/scripts/agent-template/shared/template-package.mjs +9 -2
- package/scripts/agent-template/shared/template-runtime.mjs +20 -5
- package/scripts/agent-template/team-pack.mjs +6 -3
- package/dist/cli/peer.js +0 -127
- package/dist/config/peer-operation-service.js +0 -132
- package/dist/config/peer-request-service.js +0 -532
- 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
|
+
}
|
package/ecagent/dist/types.d.ts
CHANGED
|
@@ -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
|
-
/**
|
|
328
|
-
|
|
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
|
|
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
|
|
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` |
|
|
@@ -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
|
|
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
|
|
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
|
-
|
|
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
|
|
@@ -1,74 +1,28 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 对端绑定与本地黑名单
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
peers.json 是各 Agent 按需创建的本地状态文件,只保存跨渠道账号到 AID 的身份映射和本 Agent 的黑名单。
|
|
4
|
+
它不保存联系人资格、显示名、角色或申请状态,也不参与团队成员资格校验。
|
|
4
5
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
Agent 侧可以通过 `ec directory request <target-aid> --self <agent-aid> [--note <申请说明>]`
|
|
8
|
-
向本端 Owner 申请添加目标(见 `directory.md`);添加和审批仍由 Owner 在 Evol App 中完成。
|
|
6
|
+
文件不存在表示没有本地绑定和拉黑记录。安装、创建 Agent、Owner 共识变化、配置写入、查询都不创建它。
|
|
7
|
+
首次成功绑定或实际拉黑时才创建。Owner 不自动添加,admin 角色只保存在关系配置中。
|
|
9
8
|
|
|
10
|
-
|
|
11
|
-
前者是本 Agent 自己的身份映射表。
|
|
12
|
-
|
|
13
|
-
## 命令
|
|
9
|
+
ec peer 和 Connect Menu 已退役。联系人查询使用 ec directory list/info;黑名单使用:
|
|
14
10
|
|
|
15
11
|
```bash
|
|
16
|
-
ec
|
|
17
|
-
ec
|
|
18
|
-
ec
|
|
19
|
-
ec peer list --all [--self <agent-aid>]
|
|
12
|
+
ec directory blocked
|
|
13
|
+
ec directory block <aid>
|
|
14
|
+
ec directory unblock <aid>
|
|
20
15
|
```
|
|
21
16
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
## 约束
|
|
26
|
-
|
|
27
|
-
- `<aid>` 和 `--self` 必须是合法 AID。
|
|
28
|
-
- 拉黑针对 canonical AID,因此会拒绝它在 AUN 以及所有已绑定外部渠道中的私聊入站。
|
|
29
|
-
- `block/unblock` 只接受已经存在于 `peers.json` 的对端;不存在时返回 `NOT_FOUND`。
|
|
30
|
-
想让某个从未交互过的 AID 出现在这里,需要先有一次真实交互。
|
|
31
|
-
- Agent owner 不能被拉黑。
|
|
32
|
-
- `list --blocked` 只列出已拉黑的对端;`list --all` 列出全部已登记对端。指定 `--self` 时返回该 Agent 的
|
|
33
|
-
`peerRevision`,本机省略 `--self` 时按 Agent 聚合。
|
|
34
|
-
- 删除角色关系或撤销 Owner 后,既有身份映射与拉黑状态仍保留。
|
|
35
|
-
|
|
36
|
-
## 权限边界
|
|
37
|
-
|
|
38
|
-
直接从本机终端运行时,这是本地管理命令。
|
|
39
|
-
|
|
40
|
-
从 Agent 活动任务执行时,CLI 不直接写文件,而是携带当前 session delegation token 调用 daemon `peer.op`:
|
|
41
|
-
|
|
42
|
-
| 操作 | owner | admin | 普通角色 |
|
|
43
|
-
|---|---:|---:|---:|
|
|
44
|
-
| `list --blocked/--all` | 允许 | 允许 | 拒绝 |
|
|
45
|
-
| `block` / `unblock` | 允许 | 拒绝 | 拒绝 |
|
|
46
|
-
|
|
47
|
-
缺少、伪造、撤销或跨会话 delegation token 时失败关闭。托管调用省略 `--self` 时使用 delegation 中的当前 Agent;
|
|
48
|
-
显式 `--self` 必须等于当前任务所属 Agent。
|
|
49
|
-
|
|
50
|
-
角色管理使用 Role Menu relation assignment;admin 的授予和撤销必须由 owner 执行。
|
|
51
|
-
|
|
52
|
-
## JSON 输出
|
|
53
|
-
|
|
54
|
-
拉黑成功:
|
|
55
|
-
|
|
56
|
-
```json
|
|
57
|
-
{
|
|
58
|
-
"ok": true,
|
|
59
|
-
"operation": "set-blocked",
|
|
60
|
-
"selfAid": "bot.agentid.pub",
|
|
61
|
-
"primaryId": "peer.agentid.pub",
|
|
62
|
-
"blocked": true,
|
|
63
|
-
"changed": true,
|
|
64
|
-
"peerRevision": "..."
|
|
65
|
-
}
|
|
66
|
-
```
|
|
17
|
+
block 可以针对尚无本地记录的 AID;unblock 不会解除 Owner 名录发布的黑名单。Owner 不可被本地拉黑。
|
|
18
|
+
托管命令通过 daemon 验证当前任务和目标 Agent 权限。
|
|
67
19
|
|
|
68
|
-
|
|
20
|
+
渠道身份绑定支持 Owner、admin、member 及其他已准入联系人,不要求 peers 中已有记录。
|
|
21
|
+
在已认证的 AUN 私聊发送 /bind feishu main 取得绑定码,再由对应飞书账号私聊机器人提交 /bind <绑定码>。
|
|
22
|
+
系统在签发和消费绑定码时检查资格,写入按完整渠道实例隔离的 aliases;相同账号不能同时映射到多个 AID。
|
|
23
|
+
映射仅证明身份,准入和角色仍由 Owner 名录、Ownership 共识及关系配置决定。
|
|
24
|
+
Owner 转让不删除旧 AID 的已验证身份映射,旧 Owner 的权限按新共识重算。
|
|
69
25
|
|
|
70
|
-
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
- 对 `ai`、`bot`、`agent`、`service` 类型的私聊对端,可限频返回 `[rejection] Not accepting messages from you.`。
|
|
74
|
-
- 入站正文中的 `[rejection]` 没有协议控制语义。发送者未被本 Agent 拉黑时,该文本正常进入响应式会话。
|
|
26
|
+
存储版本为 contact-book v4,沿用 contacts 字典,仅支持 aliases 和 status: blocked。
|
|
27
|
+
旧数据在启动时备份并迁移:保留绑定、拉黑,移除显示名、管理身份及旧申请状态;没有文件时不补建。
|
|
28
|
+
显示名称来自名录和 directory/remarks 中的本地备注。
|