evolcore 0.0.40 → 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 +45 -1
- package/bin/codex-managed-hook.mjs +11 -0
- package/bin/ec-safe-output.js +11 -1
- package/dist/agents/claude-runner.js +21 -106
- package/dist/agents/codex-runner.js +451 -231
- package/dist/agents/ecagent-runner.js +30 -11
- package/dist/agents/gemini-runner.js +26 -6
- package/dist/agents/runner-types.js +11 -3
- package/dist/aun/ability-device-routing.js +26 -0
- package/dist/aun/aid/client.js +1 -1
- package/dist/aun/group/identity.js +8 -0
- package/dist/aun/msg/managed-operation.js +4 -4
- package/dist/aun/msg/p2p.js +27 -7
- package/dist/aun/storage/download.js +30 -0
- package/dist/aun/storage/index.js +14 -6
- package/dist/channels/aun.js +33 -4
- package/dist/channels/daemon.js +24 -4
- package/dist/cli/agent-command.js +2 -0
- package/dist/cli/agent-create.js +98 -19
- package/dist/cli/agent.js +10 -3
- package/dist/cli/aun-commands.js +82 -22
- package/dist/cli/daemon-commands.js +19 -10
- package/dist/cli/index.js +1 -1
- package/dist/cli/restart-monitor.js +17 -0
- package/dist/cli/session-command.js +128 -13
- package/dist/cli/stats.js +60 -4
- package/dist/cli/trigger-command.js +2 -2
- package/dist/config/access-policy.js +2 -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/core/agent-application-service.js +11 -1
- package/dist/core/agent-ipc-registration.js +4 -0
- package/dist/core/auth/agent-delegation.js +80 -5
- package/dist/core/auth/authorization-audit.js +20 -3
- package/dist/core/auth/operation-catalog.js +8 -0
- package/dist/core/command/agent-control.js +91 -12
- package/dist/core/command/command-handler.js +57 -46
- package/dist/core/command/connect-menu.js +23 -2
- package/dist/core/command/menu-catalog.js +1 -0
- package/dist/core/command/menu-handler.js +38 -101
- package/dist/core/command/menu-protocol.js +9 -2
- package/dist/core/command/role-menu.js +7 -6
- package/dist/core/command/slash-gate.js +13 -10
- package/dist/core/command/slash-handler.js +34 -98
- package/dist/core/event-catalog.js +15 -0
- package/dist/core/ipc-registration.js +18 -1
- package/dist/core/memory/consolidation-trigger.js +1 -1
- package/dist/core/message/aun-ipc-sender.js +26 -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 +40 -6
- package/dist/core/message/message-log.js +55 -0
- package/dist/core/message/message-queue.js +5 -5
- package/dist/core/message/response-engine.js +310 -136
- package/dist/core/model/model-catalog.js +7 -6
- package/dist/core/ownership/owner-resolver.js +2 -2
- package/dist/core/permission/ec-command-parser.js +110 -5
- package/dist/core/permission/tool-policy.js +28 -7
- package/dist/core/session/session-capsule.js +197 -0
- package/dist/core/session/session-manager.js +148 -14
- package/dist/core/session/session-mapper.js +2 -0
- package/dist/index.js +3 -3
- package/dist/ipc.js +22 -8
- package/dist/stats/budget.js +1 -1
- package/dist/stats/db.js +15 -0
- package/dist/stats/index.js +2 -2
- package/dist/stats/price-resolver.js +304 -5
- package/dist/stats/query.js +82 -3
- package/dist/stats/writer.js +38 -5
- package/dist/trigger/feedback.js +18 -7
- package/dist/trigger/manager.js +20 -3
- package/dist/trigger/parser.js +6 -3
- package/dist/trigger/patch.js +1 -1
- package/dist/trigger/system-definitions.js +43 -7
- package/dist/trigger/validation.js +13 -5
- package/dist/utils/error-utils.js +14 -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/kits/docs/INDEX.md +1 -1
- package/kits/docs/aun/ABILITY_CALLING.md +20 -2
- package/kits/docs/evolcore/INDEX.md +2 -1
- package/kits/docs/evolcore/agent-create.md +3 -2
- package/kits/docs/evolcore/agent.md +1 -1
- package/kits/docs/evolcore/config.md +1 -1
- package/kits/docs/evolcore/event.md +1 -0
- package/kits/docs/evolcore/fs.md +5 -0
- package/kits/docs/evolcore/menu-protocol.md +32 -0
- package/kits/docs/evolcore/msg.md +17 -1
- package/kits/docs/evolcore/session.md +14 -0
- package/kits/schemas/agent-config.schema.13.json +15 -0
- package/kits/skills/aid-ability/SKILL.md +35 -6
- package/kits/templates/session-capsule/recovery.md +5 -0
- package/kits/templates/session-capsule/renew.md +5 -0
- package/kits/templates/system-fragments/bootstrap.md +6 -6
- package/kits/templates/system-fragments/channel.md +1 -1
- package/package.json +3 -3
- package/dist/stats/billing.js +0 -215
|
@@ -34,7 +34,7 @@ export function seedUpgradeCheckTrigger(manager, owner) {
|
|
|
34
34
|
script: {
|
|
35
35
|
path: scriptName,
|
|
36
36
|
runtime: 'node',
|
|
37
|
-
timeoutMs: 60_000,
|
|
37
|
+
timeoutMs: 6 * 60_000,
|
|
38
38
|
},
|
|
39
39
|
permissionMode: 'bypass',
|
|
40
40
|
onError: 'fail',
|
|
@@ -47,7 +47,7 @@ export function seedUpgradeCheckTrigger(manager, owner) {
|
|
|
47
47
|
concurrency: 'forbid',
|
|
48
48
|
missedPolicy: 'run_once',
|
|
49
49
|
retry: {
|
|
50
|
-
maxAttempts:
|
|
50
|
+
maxAttempts: 1,
|
|
51
51
|
backoffMs: 30_000,
|
|
52
52
|
},
|
|
53
53
|
},
|
|
@@ -58,15 +58,51 @@ export function seedUpgradeCheckTrigger(manager, owner) {
|
|
|
58
58
|
const packageRoot = getPackageRoot();
|
|
59
59
|
fs.writeFileSync(scriptPath, `#!/usr/bin/env node
|
|
60
60
|
const { pathToFileURL } = require('node:url');
|
|
61
|
-
const
|
|
61
|
+
const { randomUUID } = require('node:crypto');
|
|
62
|
+
const packageRoot = ${JSON.stringify(packageRoot)};
|
|
63
|
+
const load = file => import(pathToFileURL(require('node:path').join(packageRoot, 'dist', file)).href);
|
|
62
64
|
async function main() {
|
|
63
|
-
const
|
|
64
|
-
|
|
65
|
-
|
|
65
|
+
const [versions, npm, config, upgrades, product] = await Promise.all([
|
|
66
|
+
load('utils/package-version-info.js'), load('utils/npm-ops.js'), load('config-store.js'),
|
|
67
|
+
load('utils/upgrade-jobs.js'), load('product.js'),
|
|
68
|
+
]);
|
|
69
|
+
const selection = await npm.resolveUpgradeRegistry();
|
|
70
|
+
const results = await versions.refreshManagedPackageVersions(undefined, { source: 'daily-check', selection });
|
|
71
|
+
const checkedAt = new Date().toISOString();
|
|
72
|
+
// Query stable separately so it never replaces the latest/test cache.
|
|
73
|
+
const linked = npm.isLinkedInstall();
|
|
74
|
+
const stable = linked ? null : await npm.queryPackageVersion(product.MAIN_PACKAGE_NAME, selection, undefined, 'stable');
|
|
75
|
+
let upgrade;
|
|
76
|
+
if (stable && config.loadDaemonConfig().upgrade?.autoOnStart !== false) {
|
|
77
|
+
const currentVersion = npm.getLocalVersion();
|
|
78
|
+
if (npm.comparePackageVersions(currentVersion, stable.version) < 0) {
|
|
79
|
+
const target = {
|
|
80
|
+
packageName: product.MAIN_PACKAGE_NAME, currentVersion, currentVersionObservedAt: checkedAt,
|
|
81
|
+
latestVersion: stable.version, checkedAt, registry: stable.registry, distTag: 'stable',
|
|
82
|
+
npmConfig: stable.npmConfig, lastAttemptStatus: 'ok', lastAttemptAt: checkedAt,
|
|
83
|
+
};
|
|
84
|
+
const started = await upgrades.startUpgradeJob(randomUUID(), '__upgrade-check', { stableTarget: target });
|
|
85
|
+
upgrade = started.job;
|
|
86
|
+
// Wait for the watchdog handoff before the script exits. The watchdog
|
|
87
|
+
// allows the result to be recorded before it shuts down the daemon.
|
|
88
|
+
while (['accepted', 'running'].includes(upgrade.status)) {
|
|
89
|
+
await new Promise(resolve => setTimeout(resolve, 100));
|
|
90
|
+
upgrade = upgrades.readUpgradeJob(upgrade.jobId);
|
|
91
|
+
if (!upgrade) throw new Error('Stable upgrade job disappeared');
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const failed = results.some(result => result.status === 'unavailable') || (!linked && !stable)
|
|
96
|
+
|| (upgrade && ['failed', 'timeout'].includes(upgrade.status));
|
|
66
97
|
process.stdout.write(JSON.stringify({
|
|
67
98
|
outcome: failed ? 'error' : 'success',
|
|
68
|
-
text:
|
|
99
|
+
text: [
|
|
100
|
+
...results.map(result => result.packageName + ': ' + result.status),
|
|
101
|
+
product.MAIN_PACKAGE_NAME + '@stable: ' + (stable?.version || (linked ? 'skipped (development install)' : 'unavailable')),
|
|
102
|
+
...(upgrade ? ['stable upgrade: ' + upgrade.status + ' (' + upgrade.jobId + ')'] : []),
|
|
103
|
+
].join('; '),
|
|
69
104
|
files: [],
|
|
105
|
+
meta: { stableVersion: stable?.version || null, ...(upgrade ? { upgradeJobId: upgrade.jobId } : {}) },
|
|
70
106
|
}));
|
|
71
107
|
}
|
|
72
108
|
main().catch(() => {
|
|
@@ -252,7 +252,9 @@ function normalizeV3Phase2(raw, opts) {
|
|
|
252
252
|
source: normalizeSource(raw.source),
|
|
253
253
|
execution: normalizeExecution(raw.execution, { id }),
|
|
254
254
|
feedback: normalizeFeedback(raw.feedback, agentAid),
|
|
255
|
-
reliability: normalizeReliability(raw.reliability
|
|
255
|
+
reliability: normalizeReliability(raw.reliability, {
|
|
256
|
+
allowLegacyZeroRetryAttempts: opts.allowLegacyZeroRetryAttempts === true,
|
|
257
|
+
}),
|
|
256
258
|
limits: normalizeLimits(raw.limits),
|
|
257
259
|
};
|
|
258
260
|
// T10: labels 字典原样保留,只做类型校验(如果存在必须是 Record<string, string>)
|
|
@@ -650,9 +652,9 @@ function inferSessionKind(threadId, rawSession, label) {
|
|
|
650
652
|
}
|
|
651
653
|
return inferred;
|
|
652
654
|
}
|
|
653
|
-
function normalizeReliability(value) {
|
|
655
|
+
function normalizeReliability(value, opts = {}) {
|
|
654
656
|
if (value === undefined) {
|
|
655
|
-
return { concurrency: 'forbid', missedPolicy: 'run_once', retry: { maxAttempts:
|
|
657
|
+
return { concurrency: 'forbid', missedPolicy: 'run_once', retry: { maxAttempts: 1, backoffMs: 30_000 } };
|
|
656
658
|
}
|
|
657
659
|
if (!isObject(value))
|
|
658
660
|
throw new Error('reliability must be an object');
|
|
@@ -666,10 +668,16 @@ function normalizeReliability(value) {
|
|
|
666
668
|
throw new Error('reliability.missedPolicy is invalid');
|
|
667
669
|
}
|
|
668
670
|
const retryRaw = isObject(raw.retry) ? raw.retry : {};
|
|
669
|
-
|
|
671
|
+
let maxAttempts = optionalNumber(retryRaw.maxAttempts) ?? 1;
|
|
670
672
|
const backoffMs = optionalNumber(retryRaw.backoffMs) ?? 30_000;
|
|
671
673
|
if (!Number.isInteger(maxAttempts) || maxAttempts < 0 || maxAttempts > 20) {
|
|
672
|
-
throw new Error('reliability.retry.maxAttempts must be an integer between
|
|
674
|
+
throw new Error('reliability.retry.maxAttempts must be an integer between 1 and 20');
|
|
675
|
+
}
|
|
676
|
+
if (maxAttempts === 0) {
|
|
677
|
+
if (!opts.allowLegacyZeroRetryAttempts) {
|
|
678
|
+
throw new Error('reliability.retry.maxAttempts must be at least 1');
|
|
679
|
+
}
|
|
680
|
+
maxAttempts = 1;
|
|
673
681
|
}
|
|
674
682
|
if (!Number.isFinite(backoffMs) || backoffMs < 0) {
|
|
675
683
|
throw new Error('reliability.retry.backoffMs must be a non-negative number');
|
|
@@ -91,8 +91,13 @@ export var ErrorType;
|
|
|
91
91
|
ErrorType["CODEX_SANDBOX_USER_NAMESPACE_UNAVAILABLE"] = "codex_sandbox_userns_unavailable";
|
|
92
92
|
ErrorType["CLAUDE_STARTUP_ARGUMENTS_TOO_LONG"] = "claude_startup_arguments_too_long";
|
|
93
93
|
ErrorType["CLAUDE_CODE_STARTUP_FAILED"] = "claude_code_startup_failed";
|
|
94
|
+
ErrorType["POLICY_REJECTED"] = "policy_rejected";
|
|
94
95
|
ErrorType["UNKNOWN"] = "unknown";
|
|
95
96
|
})(ErrorType || (ErrorType = {}));
|
|
97
|
+
const POLICY_REJECTION_PATTERN = /invalid prompt[\s\S]{0,240}flagged as potentially violating our usage policy|prompt was flagged as potentially violating our usage policy/i;
|
|
98
|
+
export function isPolicyRejectedError(error) {
|
|
99
|
+
return POLICY_REJECTION_PATTERN.test(getErrorRawText(error) ?? '');
|
|
100
|
+
}
|
|
96
101
|
export function getErrorRawText(error, seen = new Set()) {
|
|
97
102
|
if (typeof error === 'string') {
|
|
98
103
|
return error.trim() ? error : undefined;
|
|
@@ -235,6 +240,7 @@ const NON_INFRA_SUBTYPES = new Set([
|
|
|
235
240
|
'end_turn',
|
|
236
241
|
'max_turns',
|
|
237
242
|
'permission_denied',
|
|
243
|
+
'policy_rejected',
|
|
238
244
|
'stop',
|
|
239
245
|
]);
|
|
240
246
|
const NON_INFRA_TERMINAL_REASONS = new Set([
|
|
@@ -461,6 +467,8 @@ export function classifyError(error) {
|
|
|
461
467
|
// The broad dictionary rule for "stream" must not hide a provider budget limit.
|
|
462
468
|
if (isOutputTokenLimitError(error))
|
|
463
469
|
return ErrorType.MAX_OUTPUT_TOKENS;
|
|
470
|
+
if (isPolicyRejectedError(error))
|
|
471
|
+
return ErrorType.POLICY_REJECTED;
|
|
464
472
|
if (error?.code === 'TOPIC_BACKEND_UNAVAILABLE') {
|
|
465
473
|
return ErrorType.SESSION_UNAVAILABLE;
|
|
466
474
|
}
|
|
@@ -522,6 +530,8 @@ export function isRetryableError(error) {
|
|
|
522
530
|
// Replaying the same request does not increase its output budget.
|
|
523
531
|
if (isOutputTokenLimitError(error))
|
|
524
532
|
return false;
|
|
533
|
+
if (isPolicyRejectedError(error))
|
|
534
|
+
return false;
|
|
525
535
|
const msg = error?.message || String(error);
|
|
526
536
|
const lower = msg.toLowerCase();
|
|
527
537
|
if (lower.includes('invalid jsonl session file') || lower.includes('invalid session file'))
|
|
@@ -575,6 +585,10 @@ export function getErrorMessage(error, terminalReason, includeEmoji = true) {
|
|
|
575
585
|
return `${prefix}模型响应达到输出上限(max_output_tokens),本轮未完成。`
|
|
576
586
|
+ '请降低推理强度或提高模型服务的输出预算,然后在原会话发送“继续,先核对已完成操作,只完成剩余工作”;无需重发原任务。';
|
|
577
587
|
}
|
|
588
|
+
if (isPolicyRejectedError(error)) {
|
|
589
|
+
const prefix = includeEmoji ? '⚠️ ' : '';
|
|
590
|
+
return `${prefix}上游安全策略拒绝处理本次请求,本轮未完成。请改写请求或新开话题后重试;不会自动重放原请求。`;
|
|
591
|
+
}
|
|
578
592
|
if (isClaudeStartupArgumentsTooLong(error)) {
|
|
579
593
|
const prefix = includeEmoji ? '⚠️ ' : '';
|
|
580
594
|
return `${prefix}当前 Claude 启动参数过长,任务未执行`;
|
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');
|
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
|
自己取当前时间。时限按下方“时限估算”确定。
|
|
@@ -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`(默认关闭)。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner
|
|
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
|
|
|
@@ -242,7 +242,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
|
|
|
242
242
|
`role` 由角色分配服务维护;`permissionMode` 仅在角色策略中维护
|
|
243
243
|
- **兼容字段**:`enable_rich_content` 仍可读取旧值,但已废弃且不再产生运行时效果
|
|
244
244
|
- **群规则策略**:`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset;DaemonOwner 不继承群或 relation 写权限,其他角色可读取当前 relation 的有效值
|
|
245
|
-
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner
|
|
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 使用独立的持久授权链。
|
|
246
246
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
247
247
|
- **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
|
|
248
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 接口。
|
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
> 状态:[done]
|
|
2
|
+
> 创建:2026-10-27
|
|
3
|
+
|
|
1
4
|
# Menu Protocol 规范
|
|
2
5
|
|
|
3
6
|
Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协议**,与 AUN SDK 本身无关。任何能发送 AUN 消息的客户端,只要按照本文约定的 payload 格式发送,都可以与 EvolCore daemon 交互。对应实现:`src/core/command/menu-protocol.ts`、`src/aun/menu/`。
|
|
@@ -166,6 +169,35 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
166
169
|
| `cli` | `exec` | — | 执行任意 `ec` CLI 命令(`args.argv` 是完整 argv 数组) |
|
|
167
170
|
| `file` | `search` | `file.search` | 当前项目内递归搜索文件,仅目标 Agent AID 入口 |
|
|
168
171
|
|
|
172
|
+
### Agent 初始化
|
|
173
|
+
|
|
174
|
+
主机 Agent 初始化通过 `menu.action`、`name="agent"`、`action="initialize"` 调用。参数可平铺在
|
|
175
|
+
`args` 中,也可放入 `args.plan`;`aid` 必须与计划中的 AID 一致。`project` 可省略或为空,Core 会按普通
|
|
176
|
+
Agent 创建规则解析主机默认项目;显式项目路径优先。可选的 `model` 必须存在于主机当前 baseagent 的可见模型
|
|
177
|
+
目录;指定非 `auto` 的 `effort` 时必须同时指定 `model`,且强度必须在当前模型目录支持的范围内。
|
|
178
|
+
`effort="auto"` 不写入强度覆盖。远程调用沿用现有控制面权限校验。
|
|
179
|
+
|
|
180
|
+
失败后用同一 action 和 `{ aid, resume: true }` 恢复已保存计划。恢复不接受新计划字段,只使用原操作主体、AID
|
|
181
|
+
和持久化计划;其他主体无法接管。
|
|
182
|
+
|
|
183
|
+
相同请求重复调用只返回原操作状态,不自动恢复;省略项目路径时会复用原计划路径,避免生成另一个目录。
|
|
184
|
+
计划变化返回 `INITIALIZE_PLAN_CONFLICT`,恢复主体不匹配返回 `INITIALIZE_OWNER_MISMATCH`;模型不可见或
|
|
185
|
+
effort 不受支持返回 `INVALID_ARGUMENT`,目录查询或网关鉴权失败返回 `MODEL_UNAVAILABLE`。
|
|
186
|
+
|
|
187
|
+
初始化状态通过 `menu.query`、`name="agent"`、`args.aid` 查询。响应包含:
|
|
188
|
+
|
|
189
|
+
- `initialization.status`、`initialization.phase`、`initialization.complete`、`initialization.code`、`initialization.error`
|
|
190
|
+
- 顶层 `lifecycle`
|
|
191
|
+
- 顶层 `usable`,表示已完成、active 且当前运行时可用;它独立于生命周期,断开连接时可为 `false`
|
|
192
|
+
|
|
193
|
+
`initialization.status` 为 `in_progress` / `failed` / `complete` / `cancelled`;没有错误时 `code` 和 `error`
|
|
194
|
+
固定为 `null`。初始化记录损坏时仍返回 `status="failed"`、`phase="unknown"`、
|
|
195
|
+
`code="INITIALIZE_STATE_INVALID"`、`complete=false` 和 `retryable=false`。
|
|
196
|
+
|
|
197
|
+
客户端只在 `initialization.complete == true` 且 `lifecycle == "active"` 时认定初始化成功。`usable` 用于显示当前
|
|
198
|
+
运行可用性,不改变初始化完成判定。主机 process Menu Catalog 通过 `menu.list` 的 `view="catalog"` 和
|
|
199
|
+
`context.kind="process"` 返回 `agent.initialize` action 声明,供客户端发现入口;实际调用仍使用 `menu.action`。
|
|
200
|
+
|
|
169
201
|
### 项目文件搜索:`file/search`
|
|
170
202
|
|
|
171
203
|
搜索请求必须发送到当前目标 Agent AID,不支持 Host/control 或 `rootId` 数据根。项目由当前可信话题会话解析,
|
|
@@ -37,6 +37,9 @@ ec msg send <from> <to> --link <url> [--title '<title>'] [--description '<desc>'
|
|
|
37
37
|
# 自定义 payload(JSON)
|
|
38
38
|
ec msg send <from> <to> --payload '<json>'
|
|
39
39
|
|
|
40
|
+
# 从 UTF-8 文件读取自定义 payload(避免 Windows Shell 破坏 JSON 引号)
|
|
41
|
+
ec msg send <from> <to> --payload-file <path>
|
|
42
|
+
|
|
40
43
|
# 发送自定义 payload 并等待关联结果
|
|
41
44
|
ec msg send <from> <to> --payload '<json>' --return required --timeout 60s --format json
|
|
42
45
|
|
|
@@ -44,7 +47,8 @@ ec msg send <from> <to> --payload '<json>' --return required --timeout 60s --for
|
|
|
44
47
|
ec msg send <from> <to> --payload '<json>' --return none
|
|
45
48
|
```
|
|
46
49
|
|
|
47
|
-
`--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON
|
|
50
|
+
`--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊 `msg send`,不能同时提供位置文本。
|
|
51
|
+
Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
|
|
48
52
|
最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
|
|
49
53
|
在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
|
|
50
54
|
双引号前加一个反斜杠,例如 `--payload '{\"type\":\"query\"}'`。反斜杠只用于命令行参数传递,
|
|
@@ -63,8 +67,14 @@ ec msg send <from> <to> --payload '<json>' --return none
|
|
|
63
67
|
- `--transcript <text>` — 语音转写(仅 `--as voice`)
|
|
64
68
|
- `--return none|required` — 是否建立通用请求/响应关联;`required` 会等待结果,默认不要求结果
|
|
65
69
|
- `--timeout <duration>` — `--return required` 的本地等待时间及 AUN volatile TTL,如 `30s`、`60s`、`2m`;未指定时默认 60 秒,最大 3600 秒
|
|
70
|
+
- `--device-id <id>` — 将私聊消息定向到指定 Provider 设备;业务 Ability `role=call` 必须使用从该 Provider 能力索引或 `protocol/discover` 结果中取得的设备 ID
|
|
66
71
|
- `--format json` — 输出结构化发送回执和响应
|
|
67
72
|
|
|
73
|
+
业务 Ability 调用必须指定能力发布设备,避免 Provider 的多台登录设备同时处理同一调用。设备 ID 是
|
|
74
|
+
`message.send` 的传输路由参数,不属于 Ability payload;不要猜测它,也不要把它写入 JSON。
|
|
75
|
+
`protocol/discover` 用于发现设备,可以不带 `--device-id`;之后从匹配能力的 `devices` 字段中选择目标设备。
|
|
76
|
+
缺少目标设备的业务调用会以 `ABILITY_DEVICE_REQUIRED` 在发送前失败。`--device-id` 只适用于私聊发送。
|
|
77
|
+
|
|
68
78
|
未指定 `--content-type` 时,附件 MIME 由 SDK 按实际字节识别、后缀回退,附件描述沿用上传后的类型。
|
|
69
79
|
`--as` 控制消息展示类型,与 MIME 独立。
|
|
70
80
|
|
|
@@ -119,6 +129,12 @@ Ability payload 已有 `call_id` 时,EvolCore 使用它作为通用 transport
|
|
|
119
129
|
ec msg request get <self-aid> <request-id> --format json
|
|
120
130
|
```
|
|
121
131
|
|
|
132
|
+
发送结果的 `request_diagnostics` 给出目标设备、传输状态、是否收到业务 ACK 和未完成原因。查询记录中对应字段为 `targetDeviceId`、`responseDeviceId`、`ackMessageId`、`lastIgnoredResponse`、`ignoredResponseCount`(尚未发生的事件字段可以缺省)。`response_device_mismatch` 表示回包来自其他设备;`response_device_id_missing` 表示回包缺少认证设备来源,均不会被当成目标设备的执行结果。`provider_ack_without_final_result` 表示仅收到业务受理 ACK,`no_final_response_before_deadline` 表示等待窗口内没有最终回包;后者不能单独证明设备离线或确认窗未弹出。
|
|
133
|
+
|
|
134
|
+
`--return required` 在 daemon 内通过入站事件唤醒等待,不需要同时反复执行 `request get`。超时后先查一次诊断;确需继续只读跟进时逐步拉长查询间隔(例如 5、15、30、60 秒),设置次数上限,信息不变则停止本轮查询并报告未确认状态。不要以重发申请代替状态查询。
|
|
135
|
+
|
|
136
|
+
`ec_command_not_canonical` 是命令执行前的审批解析拒绝。保持一次工具调用内只有一条完整的 `ec` 命令,避免命令替换、管道或与文件写入拼接;复杂 JSON 改走 `--payload-file`。不要因此修改身份或绕过托管授权。
|
|
137
|
+
|
|
122
138
|
查询必须由原始托管会话提供有效的 sessionId 和 delegationToken,且本端、关系、来源话题与请求登记上下文一致;跨话题目标仍须通过既有目标授权。知道 request ID 不代表有权查询,独立终端及缺少来源授权的旧记录不返回请求详情。查询是只读操作,不会重新发送消息,可以稍后重复查询。`--return none` 不建立请求记录,
|
|
123
139
|
不能使用此命令查询其结果。发送命令在顶层返回 `request_id` / `request_state` / `response`;
|
|
124
140
|
查询命令返回 `{ ok, request }`,状态和响应分别位于 `request.state` / `request.responsePayload`。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# ec session
|
|
2
|
+
|
|
3
|
+
`ec session` 查询本机 EC 会话快照与底层会话恢复胶囊。托管任务通过当前任务凭据限制到本 Agent;owner/admin 可查看该 Agent,会话角色只能查看当前关系。
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
ec session find <sessionId>
|
|
7
|
+
ec session source <sessionId>
|
|
8
|
+
ec session capsule list <sessionId>
|
|
9
|
+
ec session capsule show <capsuleId>
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
`source` 返回直接来源 EC Session ID;根会话没有来源。`capsule list` 查看 `session-renew`、`topic-renew`、`backend-recovery` 的生命周期与底层 ID,`show` 额外输出交接摘要正文。胶囊状态由 `created`、`bound`、`consumed` 追加记录推导,不维护独立状态字段。
|
|
13
|
+
|
|
14
|
+
上述命令支持 `--format json`。`messages.jsonl` 里首条被新 backend 接收的普通输入包含 `capsuleId`,可用它查询对应摘要;`/renew` 命令本身不关联该胶囊。
|
|
@@ -147,6 +147,21 @@
|
|
|
147
147
|
],
|
|
148
148
|
"description": "私聊和群聊准入策略:开放、仅联系人或仅 Owner。"
|
|
149
149
|
},
|
|
150
|
+
"allowExternalContacts": {
|
|
151
|
+
"type": "boolean",
|
|
152
|
+
"default": true,
|
|
153
|
+
"description": "是否允许非 Owner 按 policyMode 联系 Agent;关闭时仅 Owner 和 allowedAids 可进入普通会话。仅 Owner 可修改。"
|
|
154
|
+
},
|
|
155
|
+
"allowedAids": {
|
|
156
|
+
"type": "array",
|
|
157
|
+
"items": {
|
|
158
|
+
"type": "string",
|
|
159
|
+
"pattern": "^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?){2,}$"
|
|
160
|
+
},
|
|
161
|
+
"uniqueItems": true,
|
|
162
|
+
"default": [],
|
|
163
|
+
"description": "仅 Owner 可维护的指定 AID 准入名单;可绕过非 Owner 开关和 policyMode,但不绕过私聊黑名单,不授予角色权限。"
|
|
164
|
+
},
|
|
150
165
|
"requestLimit": {
|
|
151
166
|
"type": "object",
|
|
152
167
|
"additionalProperties": false,
|