evolcore 0.0.39 → 0.0.41-test.0
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 +93 -0
- package/README.md +31 -20
- package/bin/codex-managed-hook.mjs +11 -0
- package/bin/ec-safe-output.js +25 -3
- package/dist/agents/baseagent-availability.js +1 -0
- package/dist/agents/claude-runner.js +53 -152
- package/dist/agents/codex-runner.js +485 -241
- package/dist/agents/ecagent-runner.js +48 -18
- package/dist/agents/gemini-runner.js +27 -8
- package/dist/agents/runner-types.js +39 -9
- package/dist/aun/ability-device-routing.js +26 -0
- package/dist/aun/aid/client.js +1 -1
- package/dist/aun/aid/control-aid.js +23 -98
- package/dist/aun/aid/ownership-operation.js +1 -3
- package/dist/aun/group/identity.js +8 -0
- package/dist/aun/group/invite-service.js +6 -0
- package/dist/aun/msg/managed-operation.js +4 -4
- package/dist/aun/msg/p2p.js +28 -12
- package/dist/aun/storage/download.js +30 -0
- package/dist/aun/storage/index.js +14 -6
- package/dist/channels/aun.js +99 -52
- package/dist/channels/daemon.js +24 -4
- package/dist/channels/dingtalk.js +8 -2
- package/dist/channels/feishu.js +6 -1
- package/dist/channels/wecom.js +7 -3
- package/dist/cli/agent-command.js +2 -0
- package/dist/cli/agent-create.js +121 -23
- package/dist/cli/agent.js +10 -3
- package/dist/cli/aid-bind-command.js +4 -1
- package/dist/cli/aun-commands.js +82 -22
- package/dist/cli/daemon-commands.js +260 -26
- package/dist/cli/index.js +25 -13
- package/dist/cli/memory-command.js +33 -14
- package/dist/cli/restart-monitor.js +52 -13
- package/dist/cli/session-command.js +128 -13
- package/dist/cli/stats.js +60 -4
- package/dist/cli/task-context.js +1 -0
- package/dist/cli/trigger-command.js +2 -2
- package/dist/config/access-policy.js +2 -0
- package/dist/config/config-field-policy.js +1 -0
- package/dist/config/config-operation-service.js +17 -6
- package/dist/config/gateway-config.js +1 -1
- package/dist/config/peer-role-resolver.js +10 -8
- package/dist/contracts/ecweb-service-protocol.js +44 -0
- package/dist/core/agent-application-service.js +11 -1
- package/dist/core/agent-ipc-registration.js +4 -0
- package/dist/core/agent-runtime.js +6 -0
- package/dist/core/auth/agent-delegation.js +87 -9
- package/dist/core/auth/auth-gateway.js +3 -1
- package/dist/core/auth/authorization-audit.js +25 -4
- package/dist/core/auth/debug-context.js +5 -1
- package/dist/core/auth/operation-catalog.js +24 -0
- package/dist/core/command/agent-control.js +91 -12
- package/dist/core/command/command-handler.js +64 -47
- package/dist/core/command/connect-menu.js +23 -2
- package/dist/core/command/menu-catalog.js +49 -12
- package/dist/core/command/menu-handler.js +110 -105
- package/dist/core/command/menu-protocol.js +29 -3
- package/dist/core/command/role-menu.js +7 -6
- package/dist/core/command/slash-gate.js +22 -5
- package/dist/core/command/slash-handler.js +121 -102
- package/dist/core/event-catalog.js +17 -0
- package/dist/core/interaction-router.js +2 -1
- package/dist/core/ipc-registration.js +44 -8
- package/dist/core/memory/batch-meta.js +2 -0
- package/dist/core/memory/consolidation-context.js +42 -51
- package/dist/core/memory/consolidation-ops-records.js +39 -7
- package/dist/core/memory/consolidation-trigger.js +72 -65
- package/dist/core/memory/consolidation.js +226 -20
- package/dist/core/memory/memory-writer.js +160 -34
- package/dist/core/memory/relation-idle-monitor.js +287 -0
- package/dist/core/memory/relation-sweep.js +206 -0
- package/dist/core/message/aun-ipc-sender.js +31 -5
- package/dist/core/message/aun-request-registry.js +97 -3
- package/dist/core/message/im-renderer.js +4 -0
- package/dist/core/message/message-admission.js +8 -4
- package/dist/core/message/message-bridge.js +96 -53
- package/dist/core/message/message-log.js +72 -0
- package/dist/core/message/message-queue.js +11 -5
- package/dist/core/message/outbound.js +70 -0
- package/dist/core/message/peer-mode.js +7 -2
- package/dist/core/message/response-engine.js +633 -191
- package/dist/core/model/model-catalog.js +7 -6
- package/dist/core/ownership/owner-resolver.js +384 -178
- package/dist/core/permission/ec-command-parser.js +129 -8
- package/dist/core/permission/tool-policy.js +35 -14
- package/dist/core/role/runtime-policy.js +64 -0
- package/dist/core/session/session-capsule.js +197 -0
- package/dist/core/session/session-manager.js +172 -18
- package/dist/core/session/session-mapper.js +2 -0
- package/dist/core/system-session/memory.js +3 -18
- package/dist/ecweb/basic-settings-service.js +709 -0
- package/dist/ecweb/providers-service.js +172 -0
- package/dist/index.js +95 -7
- package/dist/ipc.js +100 -19
- package/dist/stats/budget.js +1 -1
- package/dist/stats/db.js +48 -0
- package/dist/stats/index.js +3 -3
- package/dist/stats/price-resolver.js +304 -5
- package/dist/stats/query.js +328 -3
- package/dist/stats/writer.js +79 -6
- package/dist/trigger/application-service.js +12 -0
- package/dist/trigger/authorization.js +2 -2
- package/dist/trigger/feedback.js +18 -7
- package/dist/trigger/history.js +36 -0
- package/dist/trigger/manager.js +20 -3
- package/dist/trigger/parser.js +6 -3
- package/dist/trigger/patch.js +1 -1
- package/dist/trigger/scheduler.js +3 -0
- package/dist/trigger/system-definitions.js +43 -7
- package/dist/trigger/validation.js +13 -5
- package/dist/utils/ecweb-supervisor.js +31 -10
- package/dist/utils/error-utils.js +22 -4
- package/dist/utils/evolcore-version.js +3 -2
- package/dist/utils/host-info.js +52 -0
- package/dist/utils/npm-ops.js +2 -1
- package/dist/utils/package-version-info.js +1 -1
- package/dist/utils/upgrade-jobs.js +45 -5
- package/ecagent/dist/harness/agent-harness.js +4 -1
- package/kits/docs/INDEX.md +1 -1
- package/kits/docs/aun/ABILITY_CALLING.md +20 -2
- package/kits/docs/evolcore/INDEX.md +3 -2
- package/kits/docs/evolcore/agent-create.md +3 -2
- package/kits/docs/evolcore/agent.md +1 -1
- package/kits/docs/evolcore/aid.md +29 -12
- package/kits/docs/evolcore/config.md +9 -7
- package/kits/docs/evolcore/event.md +1 -0
- package/kits/docs/evolcore/fs.md +5 -0
- package/kits/docs/evolcore/memory-architecture.md +3 -4
- package/kits/docs/evolcore/memory-consolidation.md +28 -7
- package/kits/docs/evolcore/memory-tags.md +1 -1
- package/kits/docs/evolcore/memory.md +1 -1
- package/kits/docs/evolcore/menu-client.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +38 -0
- package/kits/docs/evolcore/msg.md +18 -2
- package/kits/docs/evolcore/session.md +14 -0
- package/kits/eck_manifest.json +3 -3
- package/kits/rules/04-relation.md +3 -2
- package/kits/schemas/agent-config.schema.13.json +20 -1
- package/kits/skills/aid-ability/SKILL.md +35 -6
- package/kits/templates/memory-consolidation/generalize.md +32 -4
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/promote.md +10 -2
- package/kits/templates/session-capsule/recovery.md +5 -0
- package/kits/templates/session-capsule/renew.md +5 -0
- package/kits/templates/system-fragments/baseagent.md +5 -0
- package/kits/templates/system-fragments/bootstrap.md +6 -6
- package/kits/templates/system-fragments/channel.md +1 -1
- package/kits/templates/system-fragments/memory.md +12 -3
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/{rules/07-memory-and-thread.md → templates/system-fragments/thread.md} +17 -80
- package/package.json +3 -3
- package/dist/stats/billing.js +0 -215
|
@@ -176,6 +176,7 @@ export function reportEvolcoreStartup(entryUrl, report) {
|
|
|
176
176
|
const diskDistDir = path.join(packageRoot, 'dist');
|
|
177
177
|
const runtimeIsDist = path.resolve(path.dirname(runtimeEntry)) === path.resolve(diskDistDir);
|
|
178
178
|
const runtimeBuildIdentity = readBuildIdentity(runtimeIsDist ? path.dirname(runtimeEntry) : diskDistDir, readInstalledEvolcoreVersion());
|
|
179
|
+
const diskDistId = runtimeBuildIdentity.id;
|
|
179
180
|
if (!runtimeIsDist)
|
|
180
181
|
runtimeBuildIdentity.id = null;
|
|
181
182
|
const isLinked = fs.existsSync(path.join(packageRoot, '.git'));
|
|
@@ -216,9 +217,9 @@ export function reportEvolcoreStartup(entryUrl, report) {
|
|
|
216
217
|
console.error(`[EvolCore] 包路径: ${packageRoot}`);
|
|
217
218
|
console.error(`[EvolCore] 代码时间: ${latestMtime ? formatTime(latestMtime) : '?'}`);
|
|
218
219
|
console.error('[EvolCore] ✓ Version info printed');
|
|
219
|
-
const diskBuildId =
|
|
220
|
+
const diskBuildId = diskDistId;
|
|
220
221
|
console.error(`[EvolCore] 运行 build ID: ${runtimeIsDist ? (runtimeBuildIdentity.id ?? '?') : 'source'}`);
|
|
221
222
|
console.error(`[EvolCore] 磁盘 dist build ID: ${diskBuildId ?? '?'}`);
|
|
222
223
|
report(`[Build] runtimeMode=${runtimeIsDist ? 'dist' : 'source'} runtimeBuildId=${runtimeBuildIdentity.id ?? 'source'} diskDistBuildId=${diskBuildId ?? 'unknown'} match=${runtimeIsDist && runtimeBuildIdentity.id !== null && runtimeBuildIdentity.id === diskBuildId}`);
|
|
223
|
-
return { runtimeIsDist, runtimeBuildIdentity, diskDistDir };
|
|
224
|
+
return { runtimeIsDist, runtimeBuildIdentity, diskDistDir, diskDistId };
|
|
224
225
|
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import os from 'node:os';
|
|
3
|
+
import { readSystemMemoryUsage } from './system-memory.js';
|
|
4
|
+
function readOsRelease() {
|
|
5
|
+
if (process.platform !== 'linux')
|
|
6
|
+
return { id: null, version: null };
|
|
7
|
+
try {
|
|
8
|
+
const values = new Map();
|
|
9
|
+
for (const line of fs.readFileSync('/etc/os-release', 'utf8').split(/\r?\n/u)) {
|
|
10
|
+
const match = line.match(/^([A-Z0-9_]+)=(.*)$/u);
|
|
11
|
+
if (!match)
|
|
12
|
+
continue;
|
|
13
|
+
values.set(match[1], match[2].replace(/^"|"$/gu, ''));
|
|
14
|
+
}
|
|
15
|
+
return { id: values.get('ID') || null, version: values.get('VERSION_ID') || null };
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
return { id: null, version: null };
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
function networkType() {
|
|
22
|
+
try {
|
|
23
|
+
const names = Object.entries(os.networkInterfaces())
|
|
24
|
+
.filter(([, addresses]) => (addresses ?? []).some(address => !address.internal))
|
|
25
|
+
.map(([name]) => name.toLowerCase());
|
|
26
|
+
if (names.some(name => /(?:wwan|rmnet|pdp|cell|usb.*modem)/u.test(name)))
|
|
27
|
+
return 'cellular';
|
|
28
|
+
if (names.some(name => /(?:^wl|wlan|wifi|wireless)/u.test(name)))
|
|
29
|
+
return 'wlan';
|
|
30
|
+
if (names.some(name => /(?:^eth|^en[opsx]|^eno|^ens|^lan)/u.test(name)))
|
|
31
|
+
return 'lan';
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
// Network classification is best effort and must never fail status.
|
|
35
|
+
}
|
|
36
|
+
return 'unknown';
|
|
37
|
+
}
|
|
38
|
+
export function readHostInfo(evolcoreVersion) {
|
|
39
|
+
const release = readOsRelease();
|
|
40
|
+
return {
|
|
41
|
+
hostname: os.hostname(),
|
|
42
|
+
node: { version: process.version },
|
|
43
|
+
evolcore: { version: evolcoreVersion ?? null },
|
|
44
|
+
os: { platform: process.platform, distributionId: release.id, version: release.version },
|
|
45
|
+
hardware: {
|
|
46
|
+
architecture: process.arch,
|
|
47
|
+
cpuCount: os.cpus().length,
|
|
48
|
+
memoryTotalBytes: readSystemMemoryUsage().memTotal,
|
|
49
|
+
},
|
|
50
|
+
network: { type: networkType() },
|
|
51
|
+
};
|
|
52
|
+
}
|
package/dist/utils/npm-ops.js
CHANGED
|
@@ -343,6 +343,7 @@ export function resolveGlobalPkg(pkgName) {
|
|
|
343
343
|
? [
|
|
344
344
|
...(isLinkedInstall() ? [path.join(getPackageRoot(), 'ecweb', 'package.json')] : []),
|
|
345
345
|
path.join(globalRoot, MAIN_PACKAGE_NAME, 'node_modules', ...pkgName.split('/'), 'package.json'),
|
|
346
|
+
path.join(globalRoot, ...pkgName.split('/'), 'package.json'),
|
|
346
347
|
]
|
|
347
348
|
: [path.join(globalRoot, ...pkgName.split('/'), 'package.json')];
|
|
348
349
|
for (const pkgPath of packagePaths) {
|
|
@@ -436,7 +437,7 @@ export async function preparePackageCache(target, registry, options = {}) {
|
|
|
436
437
|
/** Query an already selected source, retaining npm proxy/CA/auth behavior. */
|
|
437
438
|
export async function queryPackageVersion(pkg, selection, signal, distTag = 'latest') {
|
|
438
439
|
const registry = normalizeVersionRegistry(selection.registry);
|
|
439
|
-
if (!registry || !['latest', 'test'].includes(distTag))
|
|
440
|
+
if (!registry || !['latest', 'test', 'stable'].includes(distTag))
|
|
440
441
|
return null;
|
|
441
442
|
const version = selection.useNpmCli
|
|
442
443
|
? await checkLatestVersionViaNpm(pkg, 10000, signal, registry, distTag)
|
|
@@ -33,7 +33,7 @@ export function readPackageVersionInfo() {
|
|
|
33
33
|
for (const [key, value] of Object.entries(raw.snapshots)) {
|
|
34
34
|
const entry = value;
|
|
35
35
|
if (entry && allowed(entry.packageName) && entry.registry && normalizeVersionRegistry(entry.registry) === entry.registry
|
|
36
|
-
&& ['latest', 'test'].includes(entry.distTag ?? 'latest')
|
|
36
|
+
&& ['latest', 'test', 'stable'].includes(entry.distTag ?? 'latest')
|
|
37
37
|
&& key === snapshotKey(entry.packageName, entry.registry, entry.distTag ?? 'latest')
|
|
38
38
|
&& (entry.currentVersion === null || isPackageVersion(entry.currentVersion))
|
|
39
39
|
&& (entry.latestVersion == null || isPackageVersion(entry.latestVersion)))
|
|
@@ -5,11 +5,12 @@ import { daemonControlDir, getPackageRoot, resolvePaths } from '../paths.js';
|
|
|
5
5
|
import { MAIN_PACKAGE_NAME, RESTART_REQUEST_ID_ENV, RUNTIME_HOME_ENV, SESSION_ID_ENV } from '../product.js';
|
|
6
6
|
import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
|
|
7
7
|
import { atomicWriteJson, withFileLock } from './atomic-write.js';
|
|
8
|
-
import { isLinkedInstall, preparePackageCache } from './npm-ops.js';
|
|
8
|
+
import { comparePackageVersions, isLinkedInstall, preparePackageCache } from './npm-ops.js';
|
|
9
9
|
import { isProcessRunning, launchMonitorAndConfirm, resolveCliEntry } from './cross-platform.js';
|
|
10
10
|
import { scanInstances } from './instance-registry.js';
|
|
11
11
|
import { createRestartRequest, readRestartRequest, removeRestartRequest, shouldSuppressRealRestart, updateRestartRequest } from './restart-safety.js';
|
|
12
|
-
import { refreshManagedPackageVersions, resolveUpgradeDistTag, VERSION_INFO_PACKAGES } from './package-version-info.js';
|
|
12
|
+
import { isPackageVersionInfoFresh, refreshManagedPackageVersions, resolveUpgradeDistTag, resolveVersionInfoPackage, VERSION_INFO_PACKAGES } from './package-version-info.js';
|
|
13
|
+
import { loadDaemonConfig } from '../config-store.js';
|
|
13
14
|
const directory = () => path.join(resolvePaths().dataDir, 'upgrade-jobs');
|
|
14
15
|
const jobPath = (jobId) => {
|
|
15
16
|
if (!/^job_[a-f0-9-]{36}$/.test(jobId))
|
|
@@ -166,7 +167,21 @@ function jobs() {
|
|
|
166
167
|
return [];
|
|
167
168
|
}
|
|
168
169
|
}
|
|
169
|
-
|
|
170
|
+
function assertStableUpgradeEnabled() {
|
|
171
|
+
if (loadDaemonConfig().upgrade?.autoOnStart === false) {
|
|
172
|
+
throw Object.assign(new Error('Automatic stable upgrades disabled by autoOnStart'), { code: 'AUTO_UPGRADE_DISABLED' });
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
export async function startUpgradeJob(requestId, scope, options = {}) {
|
|
176
|
+
const stableTarget = options.stableTarget;
|
|
177
|
+
if (stableTarget) {
|
|
178
|
+
assertStableUpgradeEnabled();
|
|
179
|
+
if (stableTarget.packageName !== MAIN_PACKAGE_NAME || stableTarget.distTag !== 'stable'
|
|
180
|
+
|| stableTarget.lastAttemptStatus !== 'ok'
|
|
181
|
+
|| !isPackageVersionInfoFresh(stableTarget, Date.now(), undefined, stableTarget.registry, 'stable')) {
|
|
182
|
+
throw new Error('Invalid stable upgrade target');
|
|
183
|
+
}
|
|
184
|
+
}
|
|
170
185
|
fs.mkdirSync(directory(), { recursive: true });
|
|
171
186
|
return withFileLock(path.join(directory(), 'active.lock'), async () => {
|
|
172
187
|
const existing = jobs();
|
|
@@ -192,7 +207,9 @@ export async function startUpgradeJob(requestId, scope) {
|
|
|
192
207
|
throw Object.assign(new Error('A restart transaction is still running'), { code: 'CONFLICT' });
|
|
193
208
|
const now = Date.now();
|
|
194
209
|
const job = {
|
|
195
|
-
...blankCheck(
|
|
210
|
+
...blankCheck(stableTarget ? 'stable' : resolveUpgradeDistTag()),
|
|
211
|
+
...(stableTarget ? { target: stableTarget, npmConfig: stableTarget.npmConfig } : {}),
|
|
212
|
+
jobId: `job_${crypto.randomUUID()}`, requestId, requestKey, scopeKey,
|
|
196
213
|
status: 'accepted', phase: 'upgrade-check', seq: 0, createdAt: now, updatedAt: now,
|
|
197
214
|
deadline: now + 5 * 60_000, ownerPid: process.pid, released: false, events: [],
|
|
198
215
|
};
|
|
@@ -212,7 +229,28 @@ async function runUpgradeJob(job) {
|
|
|
212
229
|
let handedOff = false;
|
|
213
230
|
try {
|
|
214
231
|
updateUpgradeJob(job.jobId, { status: 'running' }, '正在检查版本');
|
|
215
|
-
|
|
232
|
+
let results;
|
|
233
|
+
if (job.distTag === 'stable') {
|
|
234
|
+
assertStableUpgradeEnabled();
|
|
235
|
+
const target = job.target;
|
|
236
|
+
const current = resolveVersionInfoPackage(MAIN_PACKAGE_NAME);
|
|
237
|
+
if (!target || !current || !isPackageVersionInfoFresh(target, Date.now(), undefined, target.registry, 'stable')) {
|
|
238
|
+
throw new Error('Stable upgrade target is missing or expired');
|
|
239
|
+
}
|
|
240
|
+
// The scheduled check pins its target. Do not resolve latest/test (or a
|
|
241
|
+
// moved stable tag) again and accidentally install a different version.
|
|
242
|
+
results = [{
|
|
243
|
+
packageName: MAIN_PACKAGE_NAME, status: 'ok', source: 'refresh',
|
|
244
|
+
entry: { ...target, currentVersion: current.version, currentVersionObservedAt: new Date().toISOString() },
|
|
245
|
+
hasUpdate: comparePackageVersions(current.version, target.latestVersion) < 0,
|
|
246
|
+
npmConfig: job.npmConfig,
|
|
247
|
+
}];
|
|
248
|
+
}
|
|
249
|
+
else {
|
|
250
|
+
results = await refreshManagedPackageVersions(VERSION_INFO_PACKAGES, {
|
|
251
|
+
distTag: job.distTag, source: 'menu-update', signal: controller.signal, includeUninstalled: true,
|
|
252
|
+
});
|
|
253
|
+
}
|
|
216
254
|
const check = structuredUpgradeCheck(results, job.distTag);
|
|
217
255
|
updateUpgradeJob(job.jobId, check, '版本检查完成');
|
|
218
256
|
if (controller.signal.aborted)
|
|
@@ -245,6 +283,8 @@ async function runUpgradeJob(job) {
|
|
|
245
283
|
heartbeat = undefined;
|
|
246
284
|
if (controller.signal.aborted)
|
|
247
285
|
throw new Error('Update timed out');
|
|
286
|
+
if (job.distTag === 'stable')
|
|
287
|
+
assertStableUpgradeEnabled();
|
|
248
288
|
if (shouldSuppressRealRestart())
|
|
249
289
|
throw new Error('Real restart is disabled in this test runtime');
|
|
250
290
|
const pending = path.join(daemonControlDir(), 'restart-pending.json');
|
|
@@ -415,7 +415,10 @@ export class AgentHarness {
|
|
|
415
415
|
// Persist the same multimodal message that was sent to the provider.
|
|
416
416
|
// Provider rollouts (Claude/Codex) retain image bytes in their own
|
|
417
417
|
// session files, so ecagent must do the same for resumable context.
|
|
418
|
-
|
|
418
|
+
const shouldPersist = event.message.role !== "assistant" ||
|
|
419
|
+
(event.message.stopReason !== "error" && event.message.stopReason !== "aborted");
|
|
420
|
+
if (shouldPersist)
|
|
421
|
+
await this.session.appendMessage(event.message);
|
|
419
422
|
await this.emitAny(event, signal);
|
|
420
423
|
return;
|
|
421
424
|
}
|
package/kits/docs/INDEX.md
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
| 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
|
|
19
19
|
| SDK 文档指引 | `aun/SDK.md` | AUN SDK 文档位置(`$AUN_SDK_DOCS`)、结构与常用入口;四语言版本共用同一份协议文档 |
|
|
20
20
|
| 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
|
|
21
|
-
| Ability 调用 | `aun/ABILITY_CALLING.md` | AID
|
|
21
|
+
| Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、JSON 文件调用、设备状态收集、ACK/等待与超时诊断 |
|
|
22
22
|
|
|
23
23
|
EvolCore 能力插件体系的实施设计位于源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md`。该设计尚未实现,不是当前可用的 Ability 插件命令手册。
|
|
24
24
|
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
# AUN Ability 调用
|
|
2
2
|
|
|
3
3
|
本文是 EvolCore 当前实现下的通用 AID Ability Caller 规程。它描述能力发现、原始 JSON
|
|
4
|
-
传输和请求结果查询,不定义任何具体 Provider
|
|
4
|
+
传输和请求结果查询,不定义任何具体 Provider 的能力。Caller 从 Provider 发布的索引或在线发现
|
|
5
|
+
结果中选择能力设备,再通过 AUN 传输层定向;EvolCore 不替 Caller 选择设备,也不提供 runtime 或 slot 寻址。
|
|
5
6
|
|
|
6
7
|
## 边界
|
|
7
8
|
|
|
@@ -19,7 +20,7 @@ EvolCore 不负责:
|
|
|
19
20
|
- 读取或解释某个 Provider 的具体能力清单;
|
|
20
21
|
- 判断 `ability_path` 是否存在;
|
|
21
22
|
- 执行相机、联系人、授权确认或其它能力;
|
|
22
|
-
- 选择设备、runtime 或 slot;
|
|
23
|
+
- 替 Caller 选择设备、runtime 或 slot;
|
|
23
24
|
- 修改 `operation_id` 或业务 payload;
|
|
24
25
|
- 把 Provider 的自然语言说明安装成本地系统指令。
|
|
25
26
|
|
|
@@ -80,6 +81,10 @@ Agent 可以用该说明理解 Provider 特有的调用流程,但它仍是远
|
|
|
80
81
|
## 原始 payload
|
|
81
82
|
|
|
82
83
|
`ec msg send --payload` 直接透传 JSON,不为 Ability 添加 `text`、`chatmode` 或其它聊天字段。
|
|
84
|
+
Windows 或复杂 JSON 优先使用 `--payload-file`:通过文件工具把原始 UTF-8 JSON 写入当前会话
|
|
85
|
+
`$TMPDIR`,再单独执行发送。PowerShell 路径用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 用
|
|
86
|
+
`"$TMPDIR/obs_payload.json"`;文件内容不加 Shell 转义。该选项与 `--payload` 及位置文本互斥,
|
|
87
|
+
设备选择、加密和请求等待规则相同,详见 `../evolcore/msg.md`。
|
|
83
88
|
在当前 Windows PowerShell 托管环境中,`ec.cmd` 的 `--payload` 使用单引号包裹,并在 JSON 内每个
|
|
84
89
|
双引号前加反斜杠,例如:
|
|
85
90
|
|
|
@@ -87,6 +92,19 @@ Agent 可以用该说明理解 Provider 特有的调用流程,但它仍是远
|
|
|
87
92
|
ec.cmd msg send <self-aid> <provider-aid> --payload '{\"type\":\"ability\",\"role\":\"call\",\"call_id\":\"<call-id>\",\"operation_id\":\"<operation-id>\",\"ability_path\":\"<path>\",\"definition_id\":\"<definition-id>\",\"params\":{},\"ttl\":<ttl-seconds>,\"async\":false}' --encrypt --return required --timeout <ttl-seconds>s --format json
|
|
88
93
|
```
|
|
89
94
|
|
|
95
|
+
`device/status` 且 `params.action=read` 是 AID 级在线设备状态查询,命令不要带 `--device-id`,
|
|
96
|
+
payload/params 也不指定设备。各支持并已发布该能力的在线设备按本机授权分别返回状态;
|
|
97
|
+
调用方在 `--timeout` 窗口内按认证来源设备汇总,再根据状态选择目标设备调用其他能力。
|
|
98
|
+
多设备结果在发送返回的 `responses` 或 `ec msg request get` 返回的 `request.responses` 中,
|
|
99
|
+
每项含 `responseDeviceId`、`responsePayload`、`responseMessageId`、`receivedAt`。
|
|
100
|
+
`completed` 仅表示本次收集窗口结束且收到了结果,须逐项校验业务成功;零回包为 `pending`,
|
|
101
|
+
不表示所有设备离线。不能首条返回即认为全部返回,也不能把拒绝或未发布当成状态成功。
|
|
102
|
+
|
|
103
|
+
其他业务 Ability 调用命令还必须带 `--device-id <provider-device-id>`。该值必须来自同一 Provider
|
|
104
|
+
能力索引中匹配能力的 `devices` 字段,或 `protocol/discover` 的结果;不得猜测。它作为
|
|
105
|
+
`message.send.device_id` 传输参数路由,不进入 Ability JSON。`protocol/discover` 是设备发现请求,
|
|
106
|
+
可以不带此参数。定向请求只接受所选 Provider 设备发来的关联结果;其它设备的回包不会完成请求。
|
|
107
|
+
|
|
90
108
|
先替换所有占位符,字段按契约填写。`sent_at` 可以省略:`type=ability`、`role=call` 的原始
|
|
91
109
|
payload 没有 `sent_at` 时,EvolCore 在实际发送前自动补当前 Unix 毫秒时间戳,Caller 不需要
|
|
92
110
|
自己取当前时间。时限按下方“时限估算”确定。
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
|------|------|--------|
|
|
23
23
|
| `ec --version` / `-v` / `-V` | 查看版本号 | 版本 |
|
|
24
24
|
| `ec restart` | 重启目标 daemon(承载当前托管会话的实例受生命周期保护) | 重启 |
|
|
25
|
-
| `ec status` |
|
|
25
|
+
| `ec status [--format json]` | 查看运行状态、Agent、队列、渠道连接;JSON 快照 | 状态/查看状态 |
|
|
26
26
|
| `ec logs` | 查看日志(`--level` `--module` `--raw` `--no-color`) | 日志/查看日志 |
|
|
27
27
|
| `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
|
|
28
28
|
|
|
@@ -32,7 +32,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
|
|
|
32
32
|
|
|
33
33
|
| 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
|
|
34
34
|
|--------|------|--------|----------|------|
|
|
35
|
-
| `ec msg` |
|
|
35
|
+
| `ec msg` | 私聊收发消息、JSON 文件发送与请求诊断 | 回复/发消息/拉取/撤回/查在线/payload-file/请求等待/结果查询/request_id/call_id | 有对端(peerId) | `msg.md` |
|
|
36
36
|
| `ec thread` | 话题管理与话题链 | 话题/thread/跨会话/委托/话题链/ThreadOrigin/summary/删除话题 | 有对端(私聊或群聊) | `thread-chain.md` |
|
|
37
37
|
| `ec group` | 群聊收发与群管理 | 群发/建群/本地群历史/邀请/踢人/退群/群成员/角色/封禁/屏蔽/成员状态/规则/@提及模式/协作 | AUN 群;可从私聊发起协作 | `group.md`;协作流程用 `ec-group-collaboration` 技能 |
|
|
38
38
|
| `/invites` / `ec group invites` | 收到群邀请、Owner 卡片审核与恢复 | 入群邀请/接受邀请/拒绝邀请/审核卡片/待处理邀请 | 当前 Agent Owner 的 AUN 私聊 | `group.md` |
|
|
@@ -61,6 +61,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
|
|
|
61
61
|
| 命令集 | 用途 | 触发词 | 文档 |
|
|
62
62
|
|--------|------|--------|------|
|
|
63
63
|
| `ec ctl` | 当前会话工具 | 主动发消息/文件、重命名、队列、项目路径、会话状态 | `ctl.md` |
|
|
64
|
+
| `ec session` | EC 会话与恢复胶囊查询 | `source`、`capsule list/show`、会话定位 | `session.md` |
|
|
64
65
|
| `ec memory` | 记忆写入与整理 | 记住/记一下/mark it/这很重要/保存/记忆/memory/整理记忆 | `memory.md` |
|
|
65
66
|
|
|
66
67
|
## 本地工具类(不连 AUN,操作本地配置)
|
|
@@ -81,6 +81,7 @@ active
|
|
|
81
81
|
|
|
82
82
|
Bootstrap 完成前,可在基础信息引导中一并提示 Owner 补充 persona,支持直接文本或 `.md`/`.txt` 文件。
|
|
83
83
|
明确且无歧义的原文直接用 `ec agent persona --text '<完整内容>'` 或 `ec agent persona --file '<路径>'` 保存;
|
|
84
|
+
读取 persona 内容或判断文件是否存在只用 `ec agent persona show`,不要调用 base agent 的文件读取或搜索工具探测 `personal/persona.md`;命令显示不存在时按空文件处理。
|
|
84
85
|
只有 Agent 自行建议或实质改写的设定才需要确认。persona 与头像都可选,未提供不等待、不追加询问轮次、不影响 `ready`,激活后仍可完善。
|
|
85
86
|
|
|
86
87
|
Bootstrap 完成前,新 Agent 不处理普通任务,也不执行与本流程无关的工具或命令。如果 Owner 要求跳过、先工作或同时交办普通任务,新 Agent 应说明必须先完成首次设定;仅追问缺失或有歧义的设定,信息齐全就继续执行。
|
|
@@ -97,8 +98,8 @@ Bootstrap 完成前,新 Agent 不处理普通任务,也不执行与本流程
|
|
|
97
98
|
- 忠实整理 Owner 已明确提供或已认可的职责、协作边界、重要约束和激活后待继续事项,不新增推断或约定;此内部交接不要求 Owner 审稿,确有职责歧义才澄清设定本身。待继续事项标注“未执行”,不启动任务或设置自动触发。
|
|
98
99
|
- 没有额外约束或待继续事项时省略相应条目,仍保存已明确的职责,不为补齐摘要增加追问。
|
|
99
100
|
- 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断;此文件会进入后续私聊和群聊上下文,不写 Owner 的私密信息。
|
|
100
|
-
-
|
|
101
|
-
-
|
|
101
|
+
- 写入前用 `ec agent persona show` 获取现有正文;命令显示文件不存在时直接按空文件创建。已有文件只新增或幂等更新 `## Bootstrap 交接` 段落,**保留其它段落**(尤其是 Owner 已设定的人格内容)。
|
|
102
|
+
- 文件工具只用于已确认内容后的交接段编辑或创建,不用于读取或探测 `persona.md`;不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
|
|
102
103
|
- 交接摘要保存失败时不得执行 `ready`;不要把摘要整理变成名片确认后的另一轮确认。
|
|
103
104
|
|
|
104
105
|
## 4. Agent 自主准备正式欢迎文案并发布名片
|
|
@@ -105,7 +105,7 @@ ec agent delete <aid> [--purge]
|
|
|
105
105
|
- `ec agent welcome --text <text>` 用于保存 Bootstrap 中 Agent 自主准备的完整正式文案,不要求 Owner 起草、审稿或确认;命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`,不接受自定义路径。`welcome show` 读取该文件。
|
|
106
106
|
- welcome 托管写入要求当前 Agent 私聊 Owner;admin 仅可读。模板上限 4 KiB,渲染上限 8 KiB;变量为 `agentName`、`agentDescription`、`agentAid`、`agentTags`、`agentTagsText`、`ownerName`、`ownerAid`、`channel`,支持标签循环和真值条件。写入保留原始文本,投递不附加额外文案。
|
|
107
107
|
- `agent show <target-aid>` 与 `agent get <target-aid> <key>` 的跨 Agent 读取对 owner/admin 开放,但普通 Agent 角色只获得安全摘要;敏感配置值和物理路径仅对 DaemonOwner 返回原值。跨 Agent 写入、启停、删除和 reload 仍遵循各自的目标与 DaemonOwner 权限边界。
|
|
108
|
-
- Agent 配置可包含 `fullaccess.enabled
|
|
108
|
+
- Agent 配置可包含 `fullaccess.enabled`(默认关闭)。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中 `/fa` 查询、`/fa on|off` 管理当前 EC 会话:主会话写 Agent 级开关,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。
|
|
109
109
|
|
|
110
110
|
## 创建 Agent
|
|
111
111
|
|
|
@@ -31,18 +31,18 @@ ec aid avatar <当前 self AID> (--file <path> | --url <https-url>) [--format js
|
|
|
31
31
|
## 控制 AID 的非交互注册邀约
|
|
32
32
|
|
|
33
33
|
`ec init --non-interactive --owner <aid> --format json` 首先按普通 host 类型注册控制 AID,
|
|
34
|
-
完成主机名片和配置落盘后,通过独立
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
34
|
+
完成主机名片和配置落盘后,通过独立 `ownership-UUID` slot 的短连接调用 SDK `bindOwneraid` 发起邀约。
|
|
35
|
+
该注册调用不等待人工审批、不启动 daemon,也不把目标写入 `daemon.json.owner/owners`。
|
|
36
|
+
SDK 不持久化 Ownership task/WAL;`OwnershipTaskResult` 只是本次调用结果。
|
|
37
|
+
提交后应以当前 NS 状态和 `checkOwnershipConsensus` 为准,不依赖重启后恢复相同 operation ID。
|
|
38
38
|
|
|
39
39
|
`bindingStatus` 为 `submitted` 仅表示 SDK 已确认邀约 `message.send` 回执;它不代表 Owner 已审批。
|
|
40
40
|
|
|
41
|
-
`already_bound`
|
|
42
|
-
|
|
41
|
+
`already_bound` 必须经过当前共识核验。旧版本留下的注册意图只用于识别原注册目标,
|
|
42
|
+
不再代表一个可恢复的 Ownership task;新调用按 SDK 当前远端关系重新判断。
|
|
43
43
|
提交超时返回 `unknown`,错误结果中的 `initialized: true` 表示配置和控制身份仍然保留;
|
|
44
44
|
部署方应解析结果并按恢复策略启动 daemon,不能仅用 `init && start` 处理部分成功。
|
|
45
|
-
|
|
45
|
+
不同目标与已有注册意图冲突,`--force` 不覆盖协议 Owner。
|
|
46
46
|
实现与验证说明见 `docs/init-control-aid-owner-registration.md`。
|
|
47
47
|
|
|
48
48
|
## 收到绑定邀约后确认或拒绝
|
|
@@ -60,15 +60,30 @@ ec aid bind reject <operationId> --subject <接收方本地AID> --reason '用户
|
|
|
60
60
|
待确认绑定任务,包括 `operation_id`、`sub_aid`、`owner_aid`、`requester_aid`、本端 `local_role` 和关系版本。
|
|
61
61
|
本端既可以是拟任 Owner,也可以是接受 Owner 绑定的 sub;转移、解绑及未验证请求不通过该入口审批。
|
|
62
62
|
|
|
63
|
-
CLI
|
|
63
|
+
CLI 优先经 daemon 已有的 SDK 客户端调用 `acceptOwnershipRequest` / `rejectOwnershipRequest`;
|
|
64
|
+
宿主 CLI 指定的本地 AID 没有已连接的 daemon client 时,daemon 会加载该 AID 的本地身份,
|
|
65
|
+
用独立短连接完成操作后关闭。托管 Agent 仍只能操作当前已挂载的 self AID。
|
|
64
66
|
请求的真实性、当前关系、固定参与方和决定一致性由 SDK 在执行时复核。未处理的邀约保持待审批。
|
|
65
|
-
|
|
67
|
+
`requests` 是当前进程的内存投影,不是持久任务库。SDK 可在决定时从正常消息历史重新取回并验证原始请求;
|
|
68
|
+
如果原始认证请求已不可用,SDK 会返回 `operation_not_found`,需要重新发起邀约。
|
|
66
69
|
|
|
67
|
-
审批回执的 `decisionTask`
|
|
68
|
-
|
|
70
|
+
审批回执的 `decisionTask` 是这次调用结果,不是后台任务;`pending` / `completed` 仅描述 SDK 本次动作。
|
|
71
|
+
`decisionConsensus` 是 SDK 对邀约 sub 的独立新鲜查询,只有它显示目标 owner、sub、版本和 `locked` 匹配时才表示关系已成立。
|
|
72
|
+
接受回执本身不授予权限,Owner 权限仍由 `checkOwnershipConsensus` 返回的当前 owner、sub、关系版本和 `locked` 状态确定。
|
|
73
|
+
只有 SDK 事件会更新当前进程的请求投影。
|
|
69
74
|
托管会话审批需要当前 Agent Owner 或 daemon Owner,以及 `request` / `bypass` 任务;admin 仅可查询。
|
|
70
75
|
选择另一个本地 AID 需要 daemon Owner。Fullaccess 执行不额外授予协议绑定或审批权限。
|
|
71
76
|
|
|
77
|
+
## 本地双身份绑定
|
|
78
|
+
|
|
79
|
+
执行 `ec aid bind <ownerAid> --subject <subAid>` 时,如果本机同时有两份身份的有效私钥、证书,
|
|
80
|
+
且两个身份都是不同的普通 `agent` 并已有可验证的 `agent.md`,EvolCore 调用 SDK 原生
|
|
81
|
+
`ownerClient.bindLocalSubaid(subClient)`。SDK 自行创建两个身份专属的短连接,完成本人文件发布和 NS 验收后关闭连接;
|
|
82
|
+
不发送 P2P 邀约,也不要求人工确认。EvolCore 再次调用 `checkOwnershipConsensus` 核对目标 Owner、sub、关系版本和锁。
|
|
83
|
+
|
|
84
|
+
缺少任一身份材料、身份类型不符或不是普通 agent 时,普通在线 sub 回退到 `bindOwneraid` 邀约流程;
|
|
85
|
+
人类 Owner 仍须通过 `accept` / `reject` 明确决定。SDK 返回的 `completed` 不单独证明关系已成立。
|
|
86
|
+
|
|
72
87
|
## Ownership 共识缓存
|
|
73
88
|
|
|
74
89
|
Agent 的首个配置 Owner 可在该 Agent 的 AUN 私聊中发送纯 `/bind`,由 Agent
|
|
@@ -79,9 +94,11 @@ Ownership 共识不再每 15 秒轮询。普通消息、控制消息、查询和
|
|
|
79
94
|
|
|
80
95
|
Ownership 任务事件、修改本地 Owner 配置、相关名片或 Owner 关系材料变更立即失效缓存并触发一次复核;连接首次就绪或断线后恢复也复核一次。相同任务事件和连接通知去重,无关对端、普通文件变更不触发。远端 Owner 的 Storage 事件只在本机确实收到时生效,不能假定事件完整覆盖远端变化。Owner 绑定提交前及修改 Owner 的授权不复用缓存;其它敏感操作接受最长 5 分钟的协议状态陈旧窗口。
|
|
81
96
|
|
|
97
|
+
普通 Agent 任务遇到网络、Gateway 或客户端短暂中断时,可在最近一次成功共识后的 5 分钟内沿用已验证 Owner;系统会限频重试刷新。5 分钟窗口按处理刷新失败时的缓存年龄判断。明确返回 `invalid`、`unbound`、`released`、`single_sided`、关系不匹配或锁状态不匹配时立即拒绝,不使用暂态 fallback。Ownership bind、accept/reject、transfer、release、绑定状态查询及 Owner 配置变更始终要求当前刷新成功。
|
|
98
|
+
|
|
82
99
|
SDK 临时断线只更新连接状态,不清除已核验且仍在有效期内的共识缓存;普通读取仍按 30 分钟、敏感授权仍按 5 分钟窗口使用,断线不会延长有效期。断线前尚未完成的查询结果丢弃;缓存到期后若仍无法复核,不继续授权。客户端解绑或替换仍立即失效缓存。
|
|
83
100
|
|
|
84
|
-
同一 subject
|
|
101
|
+
同一 subject 的并发刷新复用进行中的请求;事件发生前启动的旧查询不能覆盖事件后的结果。暂态失败且缓存仍在 5 分钟窗口内时,普通授权可沿用该共识;窗口过期后仍无法刷新则拒绝。连接可用时刷新失败会限频后台复查,最短间隔 60 秒;断线恢复和所有权事件仍会立即触发复查。本地配置 Owner 和已认证 ECWeb 等独立授权来源不受此缓存替代。单次请求超时仍为 8 秒,不是 5 分钟或 30 分钟。
|
|
85
102
|
|
|
86
103
|
关系快照与授权状态分离:`relation` 保留进程内最后一次确认的关系(Owner、核验时间、关系版本或已解除/未绑定状态),缓存过期、断线、事件失效或复核失败不会删除它。授权缓存仅在上述有效期和失效规则内可用,历史关系快照不用于补足已失效的授权。确认转移后替换 Owner,确认解除或未绑定后清除当前关系中的 Owner;仅凭超时、验签失败或单边声明不推断关系已经解除。历史快照不落盘,进程启动后重新确认。
|
|
87
104
|
|
|
@@ -166,12 +166,14 @@ ec config set baseagents.codex.enableRequestUserInput false \
|
|
|
166
166
|
--self bot.agentid.pub --peer aun#alice.agentid.pub
|
|
167
167
|
```
|
|
168
168
|
|
|
169
|
-
该字段不是权限审批或 `request_user_input_async`
|
|
170
|
-
`
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
169
|
+
该字段不是权限审批或 `request_user_input_async` 的关闭开关。`agentMessage.questions`
|
|
170
|
+
事件会映射为可回答卡片;问题默认 `blocking=true`,模型必须等用户主动选择或输入后才继续
|
|
171
|
+
当前 turn。模型可显式设置 `blocking=false` 发送后台问题;这种问题不影响当前 turn。
|
|
172
|
+
模型还可设置 `recommendedOption` 展示建议项,但建议不会产生用户答案。阻塞问题不设超时,
|
|
173
|
+
卡片投递失败、取消或会话终止都不会自动选择选项。回答通过 Codex 原生 question-reply
|
|
174
|
+
envelope 提交:活动 turn 使用 `turn/steer`,已结束则通过持久队列恢复同一 Session 和 Codex thread。
|
|
175
|
+
问题重启后恢复未回答卡片;会话绑定或授权变化后拒绝旧卡片回答。提交结果不明时不自动重发,
|
|
176
|
+
避免重复回答。
|
|
175
177
|
|
|
176
178
|
支持卡片的客户端沿用 `action_card` / `action_card_reply`,自由输入沿用 `compose`。
|
|
177
179
|
命令入口为 `/ask <问题ID> <回答>`;只有一个待回答问题时也可 `/ask <选项编号或回答>`。
|
|
@@ -240,7 +242,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
|
|
|
240
242
|
`role` 由角色分配服务维护;`permissionMode` 仅在角色策略中维护
|
|
241
243
|
- **兼容字段**:`enable_rich_content` 仍可读取旧值,但已废弃且不再产生运行时效果
|
|
242
244
|
- **群规则策略**:`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset;DaemonOwner 不继承群或 relation 写权限,其他角色可读取当前 relation 的有效值
|
|
243
|
-
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled`
|
|
245
|
+
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。
|
|
244
246
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
245
247
|
- **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
|
|
246
248
|
- Agent 托管环境写仅人字段被拒
|
|
@@ -82,6 +82,7 @@
|
|
|
82
82
|
| `session:forked` | `{ sessionId, sourceSessionId, name? }` |
|
|
83
83
|
| `session:rewind` | `{ sessionId, turnNum, mode }` |
|
|
84
84
|
| `session:imported` | `{ sessionId, agentSessionId, projectPath }` |
|
|
85
|
+
| `session:backend-recovery` | `{ sessionId, agentAid?, baseagent, sourceAgentSessionId?, agentSessionId, capsuleId, timestamp }` |
|
|
85
86
|
| `session:idle` | `{ sessionId, agentAid, channel, channelName?, channelId, chatType?, threadId?, peerId?, encrypted?, idleMs, lastEndedAt, timestamp }` |
|
|
86
87
|
|
|
87
88
|
### message
|
package/kits/docs/evolcore/fs.md
CHANGED
|
@@ -115,6 +115,11 @@ ec fs cat <current-peer-aid>:/ability/index.json
|
|
|
115
115
|
需要更大文件时使用 `ec fs cp` 下载,不将大文件直接塞入会话上下文。
|
|
116
116
|
它适合 Ability 的 L1/L3 契约读取;不满足这些条件时使用 `ec storage download` 回退。
|
|
117
117
|
|
|
118
|
+
托管 `ec fs` 对非 self 目标先读取并验证远端 `agent.md`,再按 `type` 选择 personal 或 group 后端:只有
|
|
119
|
+
`type: group` 使用 group fs,而且普通托管任务只能访问当前 AUN 群;其它类型使用 personal storage,
|
|
120
|
+
当前 Agent 自己的空间按身份直接路由到 personal storage;除此之外,托管任务仅允许在 AUN 私聊中对当前对端执行 `cat`。其它 personal AID
|
|
121
|
+
会因关系范围不匹配而拒绝;缺少、无效或验签失败的 `agent.md` 也会拒绝,不会回退成 group。
|
|
122
|
+
|
|
118
123
|
## 能力边界
|
|
119
124
|
|
|
120
125
|
- `ln -s` 只在 personal storage 创建软链;group fs facade 暂无 symlink 接口。
|
|
@@ -27,12 +27,11 @@ relation 是所有记忆的唯一出生地,agent 级和 owner 级都由它升
|
|
|
27
27
|
|------|------|
|
|
28
28
|
| 上下文压缩前 | 自动。反馈回压缩时的会话和话题 |
|
|
29
29
|
| renew / 新会话创建时 | 自动。反馈回发起时的会话和话题 |
|
|
30
|
-
|
|
|
30
|
+
| 关系空闲 / 兜底 | 自动,**主路径**。一个关系空闲 `idleHours`(默认 1 小时)或最早未整理入站满 `maxUnconsolidatedHours`(默认 8 小时),对该关系依次跑 notes → generalize → promote → profile → forget;**不反馈** |
|
|
31
|
+
| 定时检查 | 自动。只管 agent 层 / owner 层 forget,外加 pending 堆积兜底(转成该关系的整理链);**不反馈** |
|
|
31
32
|
| 手动 | `ec memory consolidate [--mode ...]`。反馈回当前会话的当前话题 |
|
|
32
33
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
触发方分两层:**定时检查**由 trigger 的 `script` 模式承担,只做候选判断,不管理生命周期;**手动 / compact / renew / `/new`** 直接调用 `launchConsolidation()`。
|
|
34
|
+
**整理一律以关系为单位**,一个会话只处理一个关系;群聊按群算一个关系。所有触发路径都收口到统一入口 `launchConsolidation()`,它负责完整生命周期:启动前把 `pending/` 移入 `processing/` 加锁、序列化上下文、直接创建整理会话、会话结束后收尾(归档 note、写 checkpoint、定稿重建索引、反馈)。
|
|
36
35
|
|
|
37
36
|
**并发与排队**:同一 agent 同时只能有一个整理会话;全局最多 5 个 agent 并发。超出的请求排队,前一个结束后自动启动下一个。
|
|
38
37
|
|
|
@@ -35,11 +35,12 @@
|
|
|
35
35
|
|
|
36
36
|
**它是唯一能产生正式记忆的地方。** 主会话只能写 note(原料),正式记忆的增删改全部由整理会话完成。
|
|
37
37
|
|
|
38
|
-
**统一入口 `launchConsolidation()
|
|
38
|
+
**统一入口 `launchConsolidation()`**:所有触发路径——关系整理链、手动调用、定时检查、上下文压缩、renew / `/new`——都收口到这一个函数。它负责整理的完整生命周期:启动前把 `pending/` 加锁移入 `processing/`,序列化上下文文件,**直接创建整理会话**,会话结束后通过 `onConsolidationComplete` 处理收尾(归位、checkpoint、定稿索引、反馈)。
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
40
|
+
**整理一律以关系为单位**,一个会话只处理一个关系。触发方:
|
|
41
|
+
- **关系整理链**(主路径):每个关系一个计时器。最后一条入站后空闲 `idleHours`(默认 1 小时),或最早一条未整理入站满 `maxUnconsolidatedHours`(默认 8 小时),对该关系依次跑 notes → generalize → promote(仅 owner 关系)→ profile → forget,每步收尾后再判定下一步,没有候选就跳过。触发来源 `relation-idle`,**不反馈**。只计真实入站(含群里未被 @ 的消息;owner 插话不算)。
|
|
42
|
+
- **定时检查**:evolcore trigger 的 `script` 模式每小时执行,只管不属于任何关系的部分——agent 层、owner 层的 forget;外加兜底,pending 堆积超过 `backlogHours` 的关系转成该关系的整理链。
|
|
43
|
+
- **手动 / compact / renew / `/new`**:直接对当前关系调用 `launchConsolidation()`。
|
|
43
44
|
|
|
44
45
|
**并发与排队**:同一 agent 同时只能有一个整理会话在跑;全局最多 5 个 agent 并发。超出的请求排队,前一个结束后自动启动下一个。
|
|
45
46
|
|
|
@@ -69,13 +70,27 @@
|
|
|
69
70
|
|
|
70
71
|
```bash
|
|
71
72
|
ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话描述' \
|
|
72
|
-
--tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>']
|
|
73
|
+
--tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] \
|
|
74
|
+
[--reason '<为什么>'] [--generalized-from '<路径>'] [--promoted-from '<路径>'] '<正文>'
|
|
73
75
|
```
|
|
74
76
|
|
|
75
77
|
- 程序负责写入 `consolidated/`、登记完整性台账、重建索引。
|
|
76
78
|
- `--replaces` 指定的旧文件会被自动归档——**合并、纠正内容、升格作用域都走这条路径**,一次调用完成,不会出现「新的写了、旧的没归档」的重复记忆。
|
|
77
79
|
- **目标 slug 已存在且未在 `--replaces` 里列出 → 拒绝**,报错回传已有文件路径。这是防止漏用 `--replaces` 导致静默覆盖的闸门。
|
|
78
80
|
- **正文上限 10KB**,超出报 `MEMORY_TOO_LARGE`。这不是技术限制,而是记忆的性质决定的:一条记忆应当是**一句话能说清的结论**。内容确实那么多时,拆成多条分别 `create`,或把细节留在归档文件里、记忆只记结论。
|
|
81
|
+
- `--reason` 写进批次目录的 `ops.jsonl` 操作流水,不进记忆正文。结论属于记忆,判断依据属于过程记录。
|
|
82
|
+
|
|
83
|
+
### 跨层路径
|
|
84
|
+
|
|
85
|
+
generalize / promote 的产出在 agent / owner 层,候选(源文件)在本关系。候选清单里的路径形如 `<peerKey>/consolidated/xxx.md`,直接照抄即可:
|
|
86
|
+
|
|
87
|
+
| 写法 | 解析到 |
|
|
88
|
+
|---|---|
|
|
89
|
+
| `slug` / `<slug>.md` | 本作用域 `consolidated/` |
|
|
90
|
+
| `consolidated/xxx.md` | 本作用域 `consolidated/` |
|
|
91
|
+
| `<peerKey>/consolidated/xxx.md` | 本次会话所属关系的 `consolidated/`(peerKey 必须是本次会话所属关系) |
|
|
92
|
+
|
|
93
|
+
带前缀的形态是在产出层操作本关系源文件的方式。不带前缀的 `consolidated/xxx.md` 一律指本次产出所在层——两者不会混淆。归档**跟随源文件所在层**:关系级记忆进关系自己的 `archive/consolidated/`,所以 `ec memory restore` 能按作用域捞回来。
|
|
79
94
|
|
|
80
95
|
### update — 只改标签
|
|
81
96
|
|
|
@@ -84,6 +99,8 @@ ec memory update <路径> --tags '<tag1>,<tag2>' # 整体替换标签
|
|
|
84
99
|
ec memory update <路径> --touch # 刷新 mtime 与 updatedAt,用于续期
|
|
85
100
|
```
|
|
86
101
|
|
|
102
|
+
`--reason '<为什么>'` 同样可加,进 ops 流水。
|
|
103
|
+
|
|
87
104
|
**update 不能改正文。** 内容一变,描述和关键词都得跟着变,那就应该 create 一条新的。它剩下的场景都是正文不变、只有状态变的:
|
|
88
105
|
|
|
89
106
|
| 场景 | 改法 |
|
|
@@ -97,11 +114,13 @@ ec memory update <路径> --touch # 刷新 mtime 与 updatedAt
|
|
|
97
114
|
### archive — 归档
|
|
98
115
|
|
|
99
116
|
```bash
|
|
100
|
-
ec memory archive <路径...>
|
|
117
|
+
ec memory archive <路径...> [--reason '<为什么>']
|
|
101
118
|
```
|
|
102
119
|
|
|
103
120
|
**没有删除,只有归档。** 文件移入 `archive/`,可人工回捞。用于:合并后多出来的旧文件、已经过时的记忆。
|
|
104
121
|
|
|
122
|
+
归档落点跟随**源文件所在层**:关系级记忆进 `relations/<peerKey>/memory/archive/consolidated/`,agent 级进 `personal/memory/archive/consolidated/`。这样 `ec memory restore` 按作用域就能找到它。
|
|
123
|
+
|
|
105
124
|
---
|
|
106
125
|
|
|
107
126
|
## 四、权限校验
|
|
@@ -120,6 +139,8 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
120
139
|
|
|
121
140
|
**其他写入限制**:
|
|
122
141
|
|
|
142
|
+
- **整理一律以关系为单位:带前缀的路径里 peerKey 必须是本次会话所属关系**,所有模式都一样。整理会话的可读根只含当前关系的 `consolidated/`,允许写别的关系等于对读不到的目录做归档,绕过 grants 边界。没有所属关系的会话(owner 层 / agent 层 forget)不接受带前缀的路径。
|
|
143
|
+
- 唯一的例外是群聊 notes 的 `--peer`:按发言人把记忆写进发言人自己的关系。被写入的关系在群的整理链结束后会各补一轮整理。
|
|
123
144
|
- `profile` 标签的记忆,一个关系只能有一条。重新生成必须用 `--replaces` 指定旧的那条。
|
|
124
145
|
- `to-promote` 只能打在对端是 owner 的关系上。群聊关系额外检查发言人身份,owner 本人说的话可以打。
|
|
125
146
|
- 全局总开关是 `memory.enableRelation`。它关闭时,五种模式和手动调用全部拒绝。
|
|
@@ -135,7 +156,7 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
135
156
|
**`notes` 模式**的输入是:
|
|
136
157
|
|
|
137
158
|
- `pending/` 里的全部 note
|
|
138
|
-
-
|
|
159
|
+
- 会话历史(整理会话带了该关系的路由时生成话题快照:`compress` / `session-new` / `manual`,以及关系整理链 `relation-idle`;没有路由的补漏整理没有会话历史,只能凭 note 本身判断)
|
|
139
160
|
- 现有的 `MEMORY.md` 索引(查重用)
|
|
140
161
|
|
|
141
162
|
**`launchConsolidation()` 在拉起整理会话之前会把 `pending/` 整体 rename 到 `processing/`**,相当于加锁声明认领。整理过程中主会话新写的 note 落在 `pending/`,不会被这次整理误伤,也不会被误删。
|
|
@@ -60,6 +60,6 @@ tags: [important, long-term, rule, verified]
|
|
|
60
60
|
**清标的两种方式**:
|
|
61
61
|
|
|
62
62
|
- 升级成功 —— 源文件被 `--replaces` 归档,标签随文件一起消失。
|
|
63
|
-
- 评估后认为不该升级 —— 用 `update`
|
|
63
|
+
- 评估后认为不该升级 —— 用 `update` 去掉标签,否则该关系下次整理还会扫到它。
|
|
64
64
|
|
|
65
65
|
**限制**:`to-promote` 只能打在对端是 owner 的关系上。其他对端打这个标签会被拒绝——否则它会永远挂在磁盘上没人处理。群聊关系下额外检查发言人身份,owner 本人说的话可以打。
|
|
@@ -73,7 +73,7 @@ ec memory consolidate [--mode <notes|generalize|promote|profile|forget>]
|
|
|
73
73
|
| `generalize` | 关系级 → agent 级 | 对端说「不管跟谁聊你都要记得这个」 |
|
|
74
74
|
| `promote` | 关系级 → owner 级 | owner 说「让我所有 Agent 都记住这个」 |
|
|
75
75
|
| `profile` | 生成/重建当前对端画像 | owner 说「重新生成一下画像」 |
|
|
76
|
-
| `forget` | 评估超期记忆续期或归档 |
|
|
76
|
+
| `forget` | 评估超期记忆续期或归档 | 一般不手动:关系层由关系整理链发起,agent / owner 层由定时检查发起 |
|
|
77
77
|
|
|
78
78
|
**命令是异步的**:`launchConsolidation()` 在拿到整理会话的 base agent 会话 ID 后命令即退出,不等整理会话完成。输出示例:
|
|
79
79
|
|
|
@@ -23,7 +23,7 @@ ec menu-client request <from-aid> <daemon-aid> \
|
|
|
23
23
|
|
|
24
24
|
## 鉴权入口
|
|
25
25
|
|
|
26
|
-
- 默认授权是远端 `daemon.json.
|
|
26
|
+
- 默认授权是远端 `daemon.json.owner` 对发送 AID 的校验。
|
|
27
27
|
- `--remote-token <token>` 使用 daemon 签发的远程访问 token,权限与 daemon-owner 一致。CLI 审计日志不会记录 token 明文。
|
|
28
28
|
- `--ecweb-token <token>` 是 `--remote-token` 的兼容别名。
|
|
29
29
|
- `system/paircode` 例外:仅接受加密的 daemon-owner 请求,已有 remote token 不能换取新配对码。
|