evolcore 0.0.40 → 0.0.41-test.1
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 +94 -1
- package/bin/codex-managed-hook.mjs +11 -0
- package/bin/ec-safe-output.js +11 -1
- package/dist/agents/baseagent-availability.js +1 -1
- package/dist/agents/baseagent.js +20 -43
- package/dist/agents/claude-runner.js +197 -197
- package/dist/agents/codex-runner.js +535 -259
- package/dist/agents/ecagent-runner.js +31 -12
- package/dist/agents/gemini-runner.js +27 -7
- 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/fs-download.js +39 -0
- package/dist/aun/group/identity.js +36 -13
- package/dist/aun/group/operations.js +5 -0
- package/dist/aun/msg/managed-operation.js +72 -11
- package/dist/aun/msg/p2p.js +32 -7
- package/dist/aun/service-proxy.js +36 -12
- package/dist/aun/storage/download.js +30 -0
- package/dist/aun/storage/index.js +14 -6
- package/dist/channels/aun.js +367 -24
- package/dist/channels/daemon.js +39 -5
- 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 +85 -41
- package/dist/cli/daemon-commands.js +678 -688
- package/dist/cli/fs-command.js +64 -2
- package/dist/cli/index.js +48 -4
- package/dist/cli/managed-command-guard.js +4 -0
- package/dist/cli/model.js +40 -40
- package/dist/cli/proxy-command.js +92 -0
- package/dist/cli/restart-monitor.js +17 -0
- package/dist/cli/role.js +85 -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 +8 -1
- package/dist/config/boot-log.js +38 -1
- package/dist/config/config-field-policy.js +5 -32
- package/dist/config/config-manager.js +46 -39
- package/dist/config/config-operation-service.js +8 -11
- package/dist/config/contact-book-store.js +47 -21
- package/dist/config/contact-book.js +18 -12
- package/dist/config/contact-operation-service.js +3 -4
- package/dist/config/contact-request-service.js +11 -0
- package/dist/config/daemon-services.js +11 -0
- package/dist/config/gateway-config.js +89 -595
- package/dist/config/peer-role-resolver.js +15 -11
- package/dist/config/providers-config.js +12 -7
- package/dist/config/providers-import.js +3 -21
- package/dist/config/resolved-config-op.js +3 -0
- package/dist/config/role-command-service.js +166 -0
- package/dist/config/role-request-service.js +193 -0
- package/dist/config/schema-migration.js +686 -25
- package/dist/config-store.js +79 -3
- package/dist/contracts/ecweb-instance.js +41 -0
- package/dist/contracts/ecweb-service-protocol.js +3 -1
- package/dist/core/agent-application-service.js +11 -1
- package/dist/core/agent-ipc-registration.js +4 -0
- package/dist/core/agent-runtime.js +1 -1
- package/dist/core/auth/agent-delegation.js +82 -6
- package/dist/core/auth/auth-gateway.js +1 -1
- package/dist/core/auth/authorization-audit.js +37 -9
- package/dist/core/auth/delegation-authorization.js +3 -1
- package/dist/core/auth/operation-authorizer.js +15 -0
- package/dist/core/auth/operation-catalog.js +39 -6
- package/dist/core/command/agent-control.js +94 -19
- package/dist/core/command/agent-storage-menu.js +5 -3
- package/dist/core/command/cli-intent-parser.js +2 -1
- package/dist/core/command/command-handler.js +105 -145
- package/dist/core/command/connect-menu.js +31 -2
- package/dist/core/command/data-root-resolver.js +5 -4
- package/dist/core/command/memory-slash.js +16 -8
- package/dist/core/command/menu-catalog.js +6 -6
- package/dist/core/command/menu-handler.js +87 -163
- package/dist/core/command/menu-protocol.js +9 -2
- package/dist/core/command/role-menu.js +148 -30
- package/dist/core/command/slash-gate.js +13 -10
- package/dist/core/command/slash-handler.js +157 -352
- package/dist/core/daemon-control.js +8 -14
- package/dist/core/event-catalog.js +15 -0
- package/dist/core/evolagent-registry.js +4 -4
- package/dist/core/evolagent.js +2 -2
- package/dist/core/inference/text-inference.js +31 -40
- package/dist/core/ipc-registration.js +24 -3
- package/dist/core/memory/consolidation-context.js +51 -5
- package/dist/core/memory/consolidation-ops-records.js +1 -1
- package/dist/core/memory/consolidation-trigger.js +190 -190
- package/dist/core/memory/consolidation.js +316 -29
- package/dist/core/memory/forget-log.js +96 -0
- package/dist/core/memory/index-manager.js +27 -5
- package/dist/core/memory/memory-admin.js +45 -5
- package/dist/core/memory/memory-writer.js +163 -18
- package/dist/core/memory/relation-idle-monitor.js +119 -58
- package/dist/core/memory/relation-sweep.js +44 -39
- package/dist/core/message/aun-ipc-sender.js +34 -7
- package/dist/core/message/aun-request-registry.js +97 -3
- package/dist/core/message/im-renderer.js +11 -4
- package/dist/core/message/message-admission.js +97 -8
- package/dist/core/message/message-bridge.js +71 -24
- 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 +387 -144
- package/dist/core/model/catalog-service.js +4 -2
- package/dist/core/model/config-scope.js +24 -64
- package/dist/core/model/field-scope.js +1 -1
- package/dist/core/model/model-catalog.js +37 -47
- package/dist/core/model/model-diagnostics.js +4 -3
- package/dist/core/model/model-fallback.js +10 -7
- package/dist/core/model/model-permission.js +3 -2
- package/dist/core/ownership/owner-resolver.js +25 -23
- package/dist/core/permission/ec-command-parser.js +138 -5
- package/dist/core/permission/sandbox-runtime.js +18 -1
- package/dist/core/permission/tool-policy.js +42 -10
- package/dist/core/relation/peer-identity.js +64 -1
- package/dist/core/role/runtime-policy.js +72 -13
- package/dist/core/session/session-capsule.js +197 -0
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +168 -14
- package/dist/core/session/session-mapper.js +2 -0
- package/dist/core/session/session-renew.js +3 -3
- package/dist/core/skill/index-generator.js +15 -5
- package/dist/core/system-session/memory.js +6 -1
- package/dist/core/thread/thread-service.js +19 -6
- package/dist/directory/owner-directory-admission.js +95 -0
- package/dist/directory/owner-directory-authorization.js +309 -0
- package/dist/directory/owner-directory-cache.js +635 -0
- package/dist/eck/kit-renderer.js +2 -2
- package/dist/ecweb/basic-settings-service.js +33 -40
- package/dist/ecweb/message-context-service.js +110 -0
- package/dist/index.js +79 -17
- package/dist/ipc.js +189 -17
- package/dist/paths.js +4 -0
- package/dist/proxy/command.js +122 -0
- package/dist/proxy/ipc-service.js +68 -0
- package/dist/proxy/manager.js +485 -0
- package/dist/proxy/service-supervisor.js +603 -0
- package/dist/response-system/engines/v1/proactive-flow.js +16 -6
- 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/cross-platform.js +14 -0
- package/dist/utils/ecweb-supervisor.js +258 -83
- package/dist/utils/error-utils.js +16 -2
- package/dist/utils/logger.js +24 -5
- package/dist/utils/npm-ops.js +2 -1
- package/dist/utils/package-version-info.js +5 -3
- 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/channels/aun.md +9 -0
- 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 +18 -7
- package/kits/docs/evolcore/contact.md +3 -0
- package/kits/docs/evolcore/event.md +1 -0
- package/kits/docs/evolcore/fs.md +16 -0
- package/kits/docs/evolcore/memory-architecture.md +2 -2
- package/kits/docs/evolcore/memory-consolidation.md +32 -8
- package/kits/docs/evolcore/memory.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +36 -0
- package/kits/docs/evolcore/model.md +23 -20
- package/kits/docs/evolcore/msg.md +21 -8
- package/kits/docs/evolcore/session.md +14 -0
- package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
- package/kits/schemas/_meta.json +37 -4
- package/kits/schemas/agent-config.schema.13.json +23 -3
- package/kits/schemas/agent-config.schema.16.json +891 -0
- package/kits/schemas/daemon.schema.9.json +366 -0
- package/kits/schemas/defaults.schema.5.json +406 -127
- package/kits/schemas/relation-config.schema.11.json +260 -0
- package/kits/schemas/role-config.schema.1.json +7 -7
- package/kits/skills/.switches.json +3 -7
- package/kits/skills/aid-ability/SKILL.md +35 -6
- package/kits/skills/ec-service-proxy/SKILL.md +118 -0
- package/kits/skills/ec-trigger/SKILL.md +13 -5
- package/kits/skills/personal-assistant/SKILL.md +176 -0
- package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
- package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
- package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
- package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
- package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
- package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
- package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
- package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
- package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
- package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
- package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
- package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
- package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
- package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
- package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
- package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
- package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
- package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
- package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
- package/kits/templates/memory-consolidation/forget.md +19 -6
- package/kits/templates/memory-consolidation/notes.md +1 -1
- package/kits/templates/memory-consolidation/profile.md +2 -2
- package/kits/templates/memory-consolidation/promote.md +20 -3
- package/kits/templates/roles/member.json +8 -1
- 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 +2 -2
- 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 +4 -4
- package/package.json +7 -3
- package/dist/stats/billing.js +0 -215
|
@@ -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'))
|
|
@@ -555,11 +565,11 @@ function sandboxInitializationErrorMessage(error, prefix) {
|
|
|
555
565
|
|| /codex_sandbox_userns_disabled_by_apparmor/i.test(String(error?.message ?? ''))
|
|
556
566
|
|| (isCodexSandboxUserNamespaceFailure({ message: error?.message, stderr })
|
|
557
567
|
&& /apparmor_restrict_unprivileged_userns\s*=\s*1|apparmor/i.test([error?.message ?? '', ...stderr].join('\n')))) {
|
|
558
|
-
return `${prefix}Codex Linux
|
|
568
|
+
return `${prefix}Codex Linux 内层沙箱无法创建 user namespace(${CODEX_SANDBOX_USER_NAMESPACE_DISABLED_BY_APPARMOR});已尝试保留 EvolCore 外层隔离重试,但重试仍未成功。请让宿主为该 EvolCore/Codex 服务配置受限的 AppArmor 允许规则,或运行 ec diagnose 获取探针结果`;
|
|
559
569
|
}
|
|
560
570
|
if (error?.code === CODEX_SANDBOX_USER_NAMESPACE_UNAVAILABLE
|
|
561
571
|
|| isCodexSandboxUserNamespaceFailure({ message: error?.message, stderr })) {
|
|
562
|
-
return `${prefix}Codex Linux
|
|
572
|
+
return `${prefix}Codex Linux 内层沙箱无法创建 user namespace(${CODEX_SANDBOX_USER_NAMESPACE_UNAVAILABLE});已尝试保留 EvolCore 外层隔离重试,但重试仍未成功。请检查内核/AppArmor/容器策略并运行 ec diagnose`;
|
|
563
573
|
}
|
|
564
574
|
if (diagnostic) {
|
|
565
575
|
const target = /mkdir parents for/i.test(diagnostic) ? '挂载目标的父目录' : '挂载目标';
|
|
@@ -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/logger.js
CHANGED
|
@@ -2,7 +2,7 @@ import fs from 'fs';
|
|
|
2
2
|
import { resolvePaths } from '../paths.js';
|
|
3
3
|
import { LogWriter } from './log-writer.js';
|
|
4
4
|
import { normalizeToolErrorClassification } from '../core/permission/tool-error-code.js';
|
|
5
|
-
import {
|
|
5
|
+
import { normalizeExecutionPermissionMode } from '../core/permission/mode.js';
|
|
6
6
|
import { buildToolLifecycleEventKey, normalizeToolCorrelation } from '../core/audit/event-key.js';
|
|
7
7
|
let currentLevel = process.env.LOG_LEVEL || 'INFO';
|
|
8
8
|
const LEVELS = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
|
|
@@ -116,7 +116,7 @@ export function normalizeStructuredLog(data) {
|
|
|
116
116
|
// `unknown` marker for records that genuinely arrived without context.
|
|
117
117
|
const permissionMode = typeof rawPermissionMode === 'string'
|
|
118
118
|
&& rawPermissionMode !== 'unknown'
|
|
119
|
-
?
|
|
119
|
+
? normalizeExecutionPermissionMode(rawPermissionMode)
|
|
120
120
|
: rawPermissionMode;
|
|
121
121
|
const toolName = data.toolName ?? data.tool ?? data.name ?? nested?.toolName ?? nested?.name;
|
|
122
122
|
const isError = data.isError ?? data.is_error ?? (data.ok === false ? true : undefined)
|
|
@@ -197,13 +197,32 @@ export function normalizeStructuredLog(data) {
|
|
|
197
197
|
...(missingContextFields.length > 0 ? { contextMissing: missingContextFields } : {}),
|
|
198
198
|
};
|
|
199
199
|
}
|
|
200
|
-
export function localTimestamp() {
|
|
201
|
-
const d =
|
|
200
|
+
export function localTimestamp(at = new Date()) {
|
|
201
|
+
const d = at;
|
|
202
202
|
const pad = (n) => String(n).padStart(2, '0');
|
|
203
203
|
const offset = -d.getTimezoneOffset();
|
|
204
204
|
const zone = `${offset >= 0 ? '+' : '-'}${pad(Math.floor(Math.abs(offset) / 60))}:${pad(Math.abs(offset) % 60)}`;
|
|
205
205
|
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${String(d.getMilliseconds()).padStart(3, '0')}${zone}`;
|
|
206
206
|
}
|
|
207
|
+
/**
|
|
208
|
+
* Give event logs one canonical record time. `ts` and `timestamp` are both
|
|
209
|
+
* the log write time; `eventTimestamp` preserves the producer's business
|
|
210
|
+
* timestamp when it was supplied, and `loggedAt` provides the numeric form.
|
|
211
|
+
*/
|
|
212
|
+
export function normalizeEventLog(data, loggedAt = Date.now()) {
|
|
213
|
+
const normalized = normalizeStructuredLog(data);
|
|
214
|
+
const eventTimestamp = typeof normalized?.timestamp === 'number'
|
|
215
|
+
&& Number.isFinite(normalized.timestamp)
|
|
216
|
+
? normalized.timestamp
|
|
217
|
+
: undefined;
|
|
218
|
+
return {
|
|
219
|
+
...normalized,
|
|
220
|
+
timestamp: loggedAt,
|
|
221
|
+
ts: localTimestamp(new Date(loggedAt)),
|
|
222
|
+
loggedAt,
|
|
223
|
+
...(eventTimestamp !== undefined ? { eventTimestamp } : {}),
|
|
224
|
+
};
|
|
225
|
+
}
|
|
207
226
|
function log(level, ...args) {
|
|
208
227
|
if (!shouldLog(level))
|
|
209
228
|
return;
|
|
@@ -238,7 +257,7 @@ export const logger = {
|
|
|
238
257
|
const writer = getWriters().event;
|
|
239
258
|
if (!writer)
|
|
240
259
|
return;
|
|
241
|
-
writer.write(JSON.stringify(
|
|
260
|
+
writer.write(JSON.stringify(normalizeEventLog(data)));
|
|
242
261
|
},
|
|
243
262
|
menu: (data) => {
|
|
244
263
|
// Menu has a deliberately compact domain schema. Do not expand it with
|
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)
|
|
@@ -8,7 +8,8 @@ import { atomicReplaceJson, withFileLock } from './atomic-write.js';
|
|
|
8
8
|
import { loadDaemonConfig } from '../config-store.js';
|
|
9
9
|
export const VERSION_INFO_TTL_MS = 24 * 60 * 60 * 1000;
|
|
10
10
|
export const VERSION_INFO_SCHEMA_VERSION = 2;
|
|
11
|
-
|
|
11
|
+
const FASTAUN_PACKAGE_NAME = '@agentunion/fastaun';
|
|
12
|
+
export const VERSION_INFO_PACKAGES = [MAIN_PACKAGE_NAME, WEB_PACKAGE_NAME, FASTAUN_PACKAGE_NAME];
|
|
12
13
|
export const AUTO_UPGRADE_PACKAGES = [MAIN_PACKAGE_NAME];
|
|
13
14
|
export function resolveUpgradeDistTag() {
|
|
14
15
|
return loadDaemonConfig().upgrade?.testPackages === true ? 'test' : 'latest';
|
|
@@ -33,7 +34,7 @@ export function readPackageVersionInfo() {
|
|
|
33
34
|
for (const [key, value] of Object.entries(raw.snapshots)) {
|
|
34
35
|
const entry = value;
|
|
35
36
|
if (entry && allowed(entry.packageName) && entry.registry && normalizeVersionRegistry(entry.registry) === entry.registry
|
|
36
|
-
&& ['latest', 'test'].includes(entry.distTag ?? 'latest')
|
|
37
|
+
&& ['latest', 'test', 'stable'].includes(entry.distTag ?? 'latest')
|
|
37
38
|
&& key === snapshotKey(entry.packageName, entry.registry, entry.distTag ?? 'latest')
|
|
38
39
|
&& (entry.currentVersion === null || isPackageVersion(entry.currentVersion))
|
|
39
40
|
&& (entry.latestVersion == null || isPackageVersion(entry.latestVersion)))
|
|
@@ -157,7 +158,8 @@ async function checkPackage(name, force, options) {
|
|
|
157
158
|
throw new Error('Unmanaged package');
|
|
158
159
|
const now = options.now ?? Date.now();
|
|
159
160
|
const at = new Date(now).toISOString();
|
|
160
|
-
const
|
|
161
|
+
const requestedDistTag = options.distTag ?? resolveUpgradeDistTag();
|
|
162
|
+
const distTag = name === FASTAUN_PACKAGE_NAME ? 'latest' : requestedDistTag;
|
|
161
163
|
const selection = options.selection ?? (isLinkedInstall() && !options.includeUninstalled
|
|
162
164
|
? linkedInstallSelection
|
|
163
165
|
: await resolveUpgradeRegistry(options.signal));
|
|
@@ -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
|
自己取当前时间。时限按下方“时限估算”确定。
|
|
@@ -63,6 +63,15 @@ AUN keystore seed 由 EvolCore 使用固定应用值管理,不再提供配置
|
|
|
63
63
|
- **群 @ 处理策略**:`mention_mode=disabled|mention-only` 是群级配置,只决定哪些群消息进入 Agent LLM 上下文,不影响 AUN 协议层投递;被过滤消息仍应本地存档。
|
|
64
64
|
- **身份体系**:对端以 AID 标识,关系层 peerKey 形如 `aun#alice.aid.pub`。
|
|
65
65
|
|
|
66
|
+
### 对端类型判定
|
|
67
|
+
|
|
68
|
+
群与个人 AID 使用相同语法;数字、`g-`、`group.` 前缀都不证明主体类型。
|
|
69
|
+
核心代码统一使用 `resolveAunTargetKind`,由可信会话路由、relation `targetKind`、同 AID 验签通过的
|
|
70
|
+
名片类型提供证据。结果为 `private` / `group` / `unknown`,同时保留来源及缺失、冲突等原因。
|
|
71
|
+
关系层 `readAunPeerKind` 只读取本地证据;`resolveAunPeerKind` 在缺少证据时拉取并验签名片。
|
|
72
|
+
缺少或冲突的类型证据不能用于新增联系人或授予权限。迁移缺少类型证据且不涉及旧角色时会保留为 dormant 联系人;
|
|
73
|
+
角色迁移或冲突类型缺少证据时会停止。任何情况下都不会按 AID 外形删除条目。
|
|
74
|
+
|
|
66
75
|
### 私聊最终回复标题
|
|
67
76
|
|
|
68
77
|
AUN 私聊中,`result.text` 的 `isFinal=true` 会在 `payload.text` 正文前添加 `✅ 最终回复:`。AUN 文本客户端按正文展示,标题随 outbox 上下文持久化,断线恢复发送时仍保留。群聊、中间文本、命令回执及错误消息不自动添加该标题。
|
|
@@ -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`(默认关闭),作为全局开关;开启后对符合条件的私聊直接生效,局部 `/fa on|off` 不改变全局授权。Menu 写入全局开关要求请求者同时是目标 Agent Owner 与 daemon Owner。关闭全局开关时,私聊 `/fa on|off` 管理当前作用域:主会话写 relation 配置并跨 EC session/backend 续接保留,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。
|
|
109
109
|
|
|
110
110
|
## 创建 Agent
|
|
111
111
|
|
|
@@ -152,18 +152,29 @@ defaults → agent/config → relation/config
|
|
|
152
152
|
|
|
153
153
|
ConfigManager 只合并上述物理层并返回物理来源。角色策略不进入配置合并链:`permissionMode` 和 `baseagents.*.model` 由消费方按当前角色单独应用。
|
|
154
154
|
|
|
155
|
+
### 模型默认与 Agent 覆盖
|
|
156
|
+
|
|
157
|
+
模型选择(`model`、`provider`、`effort`、`fallback`)在 `agents/defaults.json` 提供全局默认,
|
|
158
|
+
也可在 `agents/<aid>/config.json` 的 `baseagents.<baseagent>` 逐字段覆盖,按上面的覆盖链生效:
|
|
159
|
+
|
|
160
|
+
- `provider` 指 `~/.evolcore/providers.json` 里的服务商 id。网关连接信息(`baseUrl`、`apiKey`、
|
|
161
|
+
`headers`、`queryParams`)只存在于 providers.json,Agent 级不再承载,也不做 `${VAR}` 展开。
|
|
162
|
+
- `fallback` 降级链每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
|
|
163
|
+
- relation 层不承载 `baseagents`、`active_baseagent`、`model`、`models` 或 `Services`;这些字段在关系层会被剥离。
|
|
164
|
+
- `Services.<用途>`(如 `Services.decision`)也在 defaults 提供全局默认,Agent 可逐字段覆盖。
|
|
165
|
+
- Agent 级未设置模型时,若 defaults 也未设置,该 Agent 才没有模型可用。
|
|
166
|
+
- 只有当前 Agent 的 owner / admin(或 DaemonOwner)可以写模型参数。
|
|
167
|
+
|
|
155
168
|
### Codex 用户提问
|
|
156
169
|
|
|
157
|
-
`baseagents.codex.enableRequestUserInput`
|
|
170
|
+
`baseagents.codex.enableRequestUserInput` 走 defaults → agent 覆盖,默认 `true`;relation 层不承载 `baseagents`。
|
|
158
171
|
它控制 Codex **Default 模式的阻塞式 `request_user_input`**,对应 App Server 的
|
|
159
172
|
`item/tool/requestUserInput` 请求和 `default_mode_request_user_input` feature。
|
|
160
173
|
新 turn 会把有效值写入原 Codex thread 的配置;不需要另建线程。
|
|
161
174
|
|
|
162
175
|
```bash
|
|
163
176
|
ec config get baseagents.codex.enableRequestUserInput --self bot.agentid.pub
|
|
164
|
-
ec config set baseagents.codex.enableRequestUserInput
|
|
165
|
-
ec config set baseagents.codex.enableRequestUserInput false \
|
|
166
|
-
--self bot.agentid.pub --peer aun#alice.agentid.pub
|
|
177
|
+
ec config set baseagents.codex.enableRequestUserInput false --self bot.agentid.pub
|
|
167
178
|
```
|
|
168
179
|
|
|
169
180
|
该字段不是权限审批或 `request_user_input_async` 的关闭开关。`agentMessage.questions`
|
|
@@ -237,14 +248,14 @@ peerKey 会规范化;读取不存在的关系仍按已有规则回落到上级
|
|
|
237
248
|
Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会把权限错误降级为兼容缺项。
|
|
238
249
|
|
|
239
250
|
**写权限**(API 层判定):
|
|
240
|
-
- **通用可写字段**:active_baseagent / baseagents / chatmode / show_activities / flush_delay / debounce / render
|
|
251
|
+
- **通用可写字段**:active_baseagent / baseagents / chatmode / show_activities / flush_delay / debounce / render(`active_baseagent`、`baseagents` 只在 Agent 级可写,见“模型参数只在 Agent 级”)
|
|
241
252
|
- **角色专用入口**:`roles/index.json` 与 `roles/{roleId}.json` 由角色服务维护;relation 的
|
|
242
253
|
`role` 由角色分配服务维护;`permissionMode` 仅在角色策略中维护
|
|
243
254
|
- **兼容字段**:`enable_rich_content` 仍可读取旧值,但已废弃且不再产生运行时效果
|
|
244
255
|
- **群规则策略**:`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset;DaemonOwner 不继承群或 relation 写权限,其他角色可读取当前 relation 的有效值
|
|
245
|
-
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner
|
|
256
|
+
- **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
257
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
247
|
-
- **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun
|
|
258
|
+
- **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun
|
|
248
259
|
- Agent 托管环境写仅人字段被拒
|
|
249
260
|
|
|
250
261
|
**操作权限**:
|
|
@@ -22,6 +22,9 @@ ec contact block-request <aid> --request-id <id> [--self <agent-aid>]
|
|
|
22
22
|
## 约束
|
|
23
23
|
|
|
24
24
|
- `<aid>` 和 `--self` 必须是合法 AID。
|
|
25
|
+
- 新增或恢复 active 联系人前,必须确认对端为 `private`:依据明确的关系类型或验签名片;缺少证据时先查验名片,
|
|
26
|
+
未验证、未知、群类型或证据冲突都会拒绝。数字开头的 AID 适用相同规则。
|
|
27
|
+
- 删除角色关系或撤销 Owner 后,既有联系人元数据和拉黑状态仍保留;缺少类型证据的旧条目不能据此授予权限。
|
|
25
28
|
- Agent 托管会话中的 `add` 只能针对当前 AUN 私聊对端;它创建/更新 `pending`,并向本 Agent Owner 发送审核卡片。
|
|
26
29
|
- `add` 复用 `/request` 的联系人申请额度、过期和请求版本校验;已有 `pending`/`declined` 条目会重新走申请流程。
|
|
27
30
|
- Owner 在审核卡片点击“通过”后才变为 active;`blocked` 必须先执行 `unblock`。
|
|
@@ -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
|
@@ -51,6 +51,7 @@ ec fs umount <AID>:<path> # 卸载挂载点
|
|
|
51
51
|
- `--content-type <mime>`:上传时指定 MIME
|
|
52
52
|
- `--public`:上传后公开可读(personal storage)
|
|
53
53
|
- `--max-bytes <n>`:`cat` 单次读取预算,默认及最高 128 KiB(131072 字节);托管和非托管一致,超限报 `FS_CAT_TOO_LARGE`,不返回截断正文
|
|
54
|
+
- `--authoritative`:仅用于个人空间 `cat`。经当前认证连接完整读取 `storage.get_object`,逐对象核验身份、路径、版本、大小、Base64 和 SHA-256;不走普通下载票据,不与 `--token` 混用
|
|
54
55
|
- `--head-bytes <n>`:`cat` 二进制头部字节数,默认 256
|
|
55
56
|
- `--visibility public|private`:`chmod` 可见性
|
|
56
57
|
- `--allow-roles <roles>`:`chmod` 角色约束,写法固定为单引号包住、逗号分隔,如 `--allow-roles 'owner,admin'`
|
|
@@ -110,11 +111,26 @@ ec fs cat <current-peer-aid>:/ability/index.json
|
|
|
110
111
|
|
|
111
112
|
这个跨 AID 入口仅限 `cat`、仅限当前私聊关系,不允许 `ls/stat/find`、写操作或切换到其他对端;
|
|
112
113
|
后端 public/ACL 鉴权仍是最终依据。`cat` 单次读取最多 128 KiB,可用 `--max-bytes` 调低预算。
|
|
114
|
+
|
|
115
|
+
已取得名录持续访问授权时可直接读取固定入口,不用每次先查询能力状态或申请权限:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
ec fs cat <current-peer-aid>:/data/directories/v1/contacts/manifest.json --authoritative --max-bytes 24576
|
|
119
|
+
ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authoritative --max-bytes 24576
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
后续索引和页面沿清单引用读取,仍使用 `--authoritative`。明确未授权、过期、撤销或需要扩大范围时,
|
|
123
|
+
向同一数据所有者的 `directory/access` 申请;网络超时只重试读取。该选项继续受当前托管身份、对端与路径边界约束,不能用于群空间。
|
|
113
124
|
个人存储内联读取携带预算加一字节的探测范围;HTTP 下载逐块计数,超限立即中止,
|
|
114
125
|
单次 HTTP 读取最多等待 30 秒。文件大小元数据不能替代实际读取校验;非文本内容只返回有界摘要。
|
|
115
126
|
需要更大文件时使用 `ec fs cp` 下载,不将大文件直接塞入会话上下文。
|
|
116
127
|
它适合 Ability 的 L1/L3 契约读取;不满足这些条件时使用 `ec storage download` 回退。
|
|
117
128
|
|
|
129
|
+
托管 `ec fs` 对非 self 目标先读取并验证远端 `agent.md`,再按 `type` 选择 personal 或 group 后端:只有
|
|
130
|
+
`type: group` 使用 group fs,而且普通托管任务只能访问当前 AUN 群;其它类型使用 personal storage,
|
|
131
|
+
当前 Agent 自己的空间按身份直接路由到 personal storage;除此之外,托管任务仅允许在 AUN 私聊中对当前对端执行 `cat`。其它 personal AID
|
|
132
|
+
会因关系范围不匹配而拒绝;缺少、无效或验签失败的 `agent.md` 也会拒绝,不会回退成 group。
|
|
133
|
+
|
|
118
134
|
## 能力边界
|
|
119
135
|
|
|
120
136
|
- `ln -s` 只在 personal storage 创建软链;group fs facade 暂无 symlink 接口。
|
|
@@ -27,8 +27,8 @@ relation 是所有记忆的唯一出生地,agent 级和 owner 级都由它升
|
|
|
27
27
|
|------|------|
|
|
28
28
|
| 上下文压缩前 | 自动。反馈回压缩时的会话和话题 |
|
|
29
29
|
| renew / 新会话创建时 | 自动。反馈回发起时的会话和话题 |
|
|
30
|
-
| 关系空闲 / 兜底 |
|
|
31
|
-
| 定时检查 |
|
|
30
|
+
| 关系空闲 / 兜底 | 自动,**主路径**,管内容驱动的 notes → generalize → promote。一个关系最后一次活动(入站、写 note)后空闲 `idleHours`(默认 1 小时),跑候选攒够 `minBatchItems`(默认 3)条的步骤;最早一次未整理活动满 `maxUnconsolidatedHours`(默认 8 小时),有 1 条候选就跑;**不反馈** |
|
|
31
|
+
| 定时检查 | 自动,每小时,管时间驱动的整理:逐关系检查画像到期(profile)与关系层超期(forget),外加 agent 层 / owner 层 forget;**不反馈** |
|
|
32
32
|
| 手动 | `ec memory consolidate [--mode ...]`。反馈回当前会话的当前话题 |
|
|
33
33
|
|
|
34
34
|
**整理一律以关系为单位**,一个会话只处理一个关系;群聊按群算一个关系。所有触发路径都收口到统一入口 `launchConsolidation()`,它负责完整生命周期:启动前把 `pending/` 移入 `processing/` 加锁、序列化上下文、直接创建整理会话、会话结束后收尾(归档 note、写 checkpoint、定稿重建索引、反馈)。
|