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.
Files changed (226) hide show
  1. package/CHANGELOG.md +94 -1
  2. package/bin/codex-managed-hook.mjs +11 -0
  3. package/bin/ec-safe-output.js +11 -1
  4. package/dist/agents/baseagent-availability.js +1 -1
  5. package/dist/agents/baseagent.js +20 -43
  6. package/dist/agents/claude-runner.js +197 -197
  7. package/dist/agents/codex-runner.js +535 -259
  8. package/dist/agents/ecagent-runner.js +31 -12
  9. package/dist/agents/gemini-runner.js +27 -7
  10. package/dist/agents/runner-types.js +11 -3
  11. package/dist/aun/ability-device-routing.js +26 -0
  12. package/dist/aun/aid/client.js +1 -1
  13. package/dist/aun/group/fs-download.js +39 -0
  14. package/dist/aun/group/identity.js +36 -13
  15. package/dist/aun/group/operations.js +5 -0
  16. package/dist/aun/msg/managed-operation.js +72 -11
  17. package/dist/aun/msg/p2p.js +32 -7
  18. package/dist/aun/service-proxy.js +36 -12
  19. package/dist/aun/storage/download.js +30 -0
  20. package/dist/aun/storage/index.js +14 -6
  21. package/dist/channels/aun.js +367 -24
  22. package/dist/channels/daemon.js +39 -5
  23. package/dist/cli/agent-command.js +2 -0
  24. package/dist/cli/agent-create.js +98 -19
  25. package/dist/cli/agent.js +10 -3
  26. package/dist/cli/aun-commands.js +85 -41
  27. package/dist/cli/daemon-commands.js +678 -688
  28. package/dist/cli/fs-command.js +64 -2
  29. package/dist/cli/index.js +48 -4
  30. package/dist/cli/managed-command-guard.js +4 -0
  31. package/dist/cli/model.js +40 -40
  32. package/dist/cli/proxy-command.js +92 -0
  33. package/dist/cli/restart-monitor.js +17 -0
  34. package/dist/cli/role.js +85 -0
  35. package/dist/cli/session-command.js +128 -13
  36. package/dist/cli/stats.js +60 -4
  37. package/dist/cli/trigger-command.js +2 -2
  38. package/dist/config/access-policy.js +8 -1
  39. package/dist/config/boot-log.js +38 -1
  40. package/dist/config/config-field-policy.js +5 -32
  41. package/dist/config/config-manager.js +46 -39
  42. package/dist/config/config-operation-service.js +8 -11
  43. package/dist/config/contact-book-store.js +47 -21
  44. package/dist/config/contact-book.js +18 -12
  45. package/dist/config/contact-operation-service.js +3 -4
  46. package/dist/config/contact-request-service.js +11 -0
  47. package/dist/config/daemon-services.js +11 -0
  48. package/dist/config/gateway-config.js +89 -595
  49. package/dist/config/peer-role-resolver.js +15 -11
  50. package/dist/config/providers-config.js +12 -7
  51. package/dist/config/providers-import.js +3 -21
  52. package/dist/config/resolved-config-op.js +3 -0
  53. package/dist/config/role-command-service.js +166 -0
  54. package/dist/config/role-request-service.js +193 -0
  55. package/dist/config/schema-migration.js +686 -25
  56. package/dist/config-store.js +79 -3
  57. package/dist/contracts/ecweb-instance.js +41 -0
  58. package/dist/contracts/ecweb-service-protocol.js +3 -1
  59. package/dist/core/agent-application-service.js +11 -1
  60. package/dist/core/agent-ipc-registration.js +4 -0
  61. package/dist/core/agent-runtime.js +1 -1
  62. package/dist/core/auth/agent-delegation.js +82 -6
  63. package/dist/core/auth/auth-gateway.js +1 -1
  64. package/dist/core/auth/authorization-audit.js +37 -9
  65. package/dist/core/auth/delegation-authorization.js +3 -1
  66. package/dist/core/auth/operation-authorizer.js +15 -0
  67. package/dist/core/auth/operation-catalog.js +39 -6
  68. package/dist/core/command/agent-control.js +94 -19
  69. package/dist/core/command/agent-storage-menu.js +5 -3
  70. package/dist/core/command/cli-intent-parser.js +2 -1
  71. package/dist/core/command/command-handler.js +105 -145
  72. package/dist/core/command/connect-menu.js +31 -2
  73. package/dist/core/command/data-root-resolver.js +5 -4
  74. package/dist/core/command/memory-slash.js +16 -8
  75. package/dist/core/command/menu-catalog.js +6 -6
  76. package/dist/core/command/menu-handler.js +87 -163
  77. package/dist/core/command/menu-protocol.js +9 -2
  78. package/dist/core/command/role-menu.js +148 -30
  79. package/dist/core/command/slash-gate.js +13 -10
  80. package/dist/core/command/slash-handler.js +157 -352
  81. package/dist/core/daemon-control.js +8 -14
  82. package/dist/core/event-catalog.js +15 -0
  83. package/dist/core/evolagent-registry.js +4 -4
  84. package/dist/core/evolagent.js +2 -2
  85. package/dist/core/inference/text-inference.js +31 -40
  86. package/dist/core/ipc-registration.js +24 -3
  87. package/dist/core/memory/consolidation-context.js +51 -5
  88. package/dist/core/memory/consolidation-ops-records.js +1 -1
  89. package/dist/core/memory/consolidation-trigger.js +190 -190
  90. package/dist/core/memory/consolidation.js +316 -29
  91. package/dist/core/memory/forget-log.js +96 -0
  92. package/dist/core/memory/index-manager.js +27 -5
  93. package/dist/core/memory/memory-admin.js +45 -5
  94. package/dist/core/memory/memory-writer.js +163 -18
  95. package/dist/core/memory/relation-idle-monitor.js +119 -58
  96. package/dist/core/memory/relation-sweep.js +44 -39
  97. package/dist/core/message/aun-ipc-sender.js +34 -7
  98. package/dist/core/message/aun-request-registry.js +97 -3
  99. package/dist/core/message/im-renderer.js +11 -4
  100. package/dist/core/message/message-admission.js +97 -8
  101. package/dist/core/message/message-bridge.js +71 -24
  102. package/dist/core/message/message-log.js +55 -0
  103. package/dist/core/message/message-queue.js +5 -5
  104. package/dist/core/message/response-engine.js +387 -144
  105. package/dist/core/model/catalog-service.js +4 -2
  106. package/dist/core/model/config-scope.js +24 -64
  107. package/dist/core/model/field-scope.js +1 -1
  108. package/dist/core/model/model-catalog.js +37 -47
  109. package/dist/core/model/model-diagnostics.js +4 -3
  110. package/dist/core/model/model-fallback.js +10 -7
  111. package/dist/core/model/model-permission.js +3 -2
  112. package/dist/core/ownership/owner-resolver.js +25 -23
  113. package/dist/core/permission/ec-command-parser.js +138 -5
  114. package/dist/core/permission/sandbox-runtime.js +18 -1
  115. package/dist/core/permission/tool-policy.js +42 -10
  116. package/dist/core/relation/peer-identity.js +64 -1
  117. package/dist/core/role/runtime-policy.js +72 -13
  118. package/dist/core/session/session-capsule.js +197 -0
  119. package/dist/core/session/session-idle-monitor.js +1 -1
  120. package/dist/core/session/session-manager.js +168 -14
  121. package/dist/core/session/session-mapper.js +2 -0
  122. package/dist/core/session/session-renew.js +3 -3
  123. package/dist/core/skill/index-generator.js +15 -5
  124. package/dist/core/system-session/memory.js +6 -1
  125. package/dist/core/thread/thread-service.js +19 -6
  126. package/dist/directory/owner-directory-admission.js +95 -0
  127. package/dist/directory/owner-directory-authorization.js +309 -0
  128. package/dist/directory/owner-directory-cache.js +635 -0
  129. package/dist/eck/kit-renderer.js +2 -2
  130. package/dist/ecweb/basic-settings-service.js +33 -40
  131. package/dist/ecweb/message-context-service.js +110 -0
  132. package/dist/index.js +79 -17
  133. package/dist/ipc.js +189 -17
  134. package/dist/paths.js +4 -0
  135. package/dist/proxy/command.js +122 -0
  136. package/dist/proxy/ipc-service.js +68 -0
  137. package/dist/proxy/manager.js +485 -0
  138. package/dist/proxy/service-supervisor.js +603 -0
  139. package/dist/response-system/engines/v1/proactive-flow.js +16 -6
  140. package/dist/stats/budget.js +1 -1
  141. package/dist/stats/db.js +15 -0
  142. package/dist/stats/index.js +2 -2
  143. package/dist/stats/price-resolver.js +304 -5
  144. package/dist/stats/query.js +82 -3
  145. package/dist/stats/writer.js +38 -5
  146. package/dist/trigger/feedback.js +18 -7
  147. package/dist/trigger/manager.js +20 -3
  148. package/dist/trigger/parser.js +6 -3
  149. package/dist/trigger/patch.js +1 -1
  150. package/dist/trigger/system-definitions.js +43 -7
  151. package/dist/trigger/validation.js +13 -5
  152. package/dist/utils/cross-platform.js +14 -0
  153. package/dist/utils/ecweb-supervisor.js +258 -83
  154. package/dist/utils/error-utils.js +16 -2
  155. package/dist/utils/logger.js +24 -5
  156. package/dist/utils/npm-ops.js +2 -1
  157. package/dist/utils/package-version-info.js +5 -3
  158. package/dist/utils/upgrade-jobs.js +45 -5
  159. package/kits/docs/INDEX.md +1 -1
  160. package/kits/docs/aun/ABILITY_CALLING.md +20 -2
  161. package/kits/docs/channels/aun.md +9 -0
  162. package/kits/docs/evolcore/INDEX.md +2 -1
  163. package/kits/docs/evolcore/agent-create.md +3 -2
  164. package/kits/docs/evolcore/agent.md +1 -1
  165. package/kits/docs/evolcore/config.md +18 -7
  166. package/kits/docs/evolcore/contact.md +3 -0
  167. package/kits/docs/evolcore/event.md +1 -0
  168. package/kits/docs/evolcore/fs.md +16 -0
  169. package/kits/docs/evolcore/memory-architecture.md +2 -2
  170. package/kits/docs/evolcore/memory-consolidation.md +32 -8
  171. package/kits/docs/evolcore/memory.md +1 -1
  172. package/kits/docs/evolcore/menu-protocol.md +36 -0
  173. package/kits/docs/evolcore/model.md +23 -20
  174. package/kits/docs/evolcore/msg.md +21 -8
  175. package/kits/docs/evolcore/session.md +14 -0
  176. package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
  177. package/kits/schemas/_meta.json +37 -4
  178. package/kits/schemas/agent-config.schema.13.json +23 -3
  179. package/kits/schemas/agent-config.schema.16.json +891 -0
  180. package/kits/schemas/daemon.schema.9.json +366 -0
  181. package/kits/schemas/defaults.schema.5.json +406 -127
  182. package/kits/schemas/relation-config.schema.11.json +260 -0
  183. package/kits/schemas/role-config.schema.1.json +7 -7
  184. package/kits/skills/.switches.json +3 -7
  185. package/kits/skills/aid-ability/SKILL.md +35 -6
  186. package/kits/skills/ec-service-proxy/SKILL.md +118 -0
  187. package/kits/skills/ec-trigger/SKILL.md +13 -5
  188. package/kits/skills/personal-assistant/SKILL.md +176 -0
  189. package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
  190. package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
  191. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
  192. package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
  193. package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
  194. package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
  195. package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
  196. package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
  197. package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
  198. package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
  199. package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
  200. package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
  201. package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
  202. package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
  203. package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
  204. package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
  205. package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
  206. package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
  207. package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
  208. package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
  209. package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
  210. package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
  211. package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
  212. package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
  213. package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
  214. package/kits/templates/memory-consolidation/forget.md +19 -6
  215. package/kits/templates/memory-consolidation/notes.md +1 -1
  216. package/kits/templates/memory-consolidation/profile.md +2 -2
  217. package/kits/templates/memory-consolidation/promote.md +20 -3
  218. package/kits/templates/roles/member.json +8 -1
  219. package/kits/templates/session-capsule/recovery.md +5 -0
  220. package/kits/templates/session-capsule/renew.md +5 -0
  221. package/kits/templates/system-fragments/baseagent.md +2 -2
  222. package/kits/templates/system-fragments/bootstrap.md +6 -6
  223. package/kits/templates/system-fragments/channel.md +1 -1
  224. package/kits/templates/system-fragments/memory.md +4 -4
  225. package/package.json +7 -3
  226. 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 沙箱无法创建 user namespace(${CODEX_SANDBOX_USER_NAMESPACE_DISABLED_BY_APPARMOR}),当前操作未执行;请让宿主为该 EvolCore/Codex 服务配置受限的 AppArmor 允许规则,或使用等价隔离后端。不要关闭沙箱或自动降级为全权限,并运行 ec diagnose 获取探针结果`;
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 沙箱无法创建 user namespace(${CODEX_SANDBOX_USER_NAMESPACE_UNAVAILABLE}),当前操作未执行;请检查内核/AppArmor/容器策略并运行 ec diagnose。不会关闭沙箱或自动降级为全权限`;
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 启动参数过长,任务未执行`;
@@ -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 { normalizePermissionMode } from '../core/permission/mode.js';
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
- ? normalizePermissionMode(rawPermissionMode).mode
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 = new Date();
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({ ts: localTimestamp(), ...normalizeStructuredLog(data) }));
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
@@ -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
- export const VERSION_INFO_PACKAGES = [MAIN_PACKAGE_NAME, WEB_PACKAGE_NAME, '@agentunion/fastaun'];
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 distTag = options.distTag ?? resolveUpgradeDistTag();
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
- export async function startUpgradeJob(requestId, scope) {
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(resolveUpgradeDistTag()), jobId: `job_${crypto.randomUUID()}`, requestId, requestKey, scopeKey,
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
- const results = await refreshManagedPackageVersions(VERSION_INFO_PACKAGES, { distTag: job.distTag, source: 'menu-update', signal: controller.signal, includeUninstalled: true });
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');
@@ -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 能力发现、原始 JSON 调用、ACK/等待、超时和 request 查询 |
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` | 私聊收发消息与请求响应等待 | 回复/发消息/拉取/撤回/查在线/请求等待/结果查询/request_id/call_id | 有对端(peerId) | `msg.md` |
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
- - 文件不存在时创建;已有文件只新增或幂等更新 `## Bootstrap 交接` 段落,**保留其它段落**(尤其是 Owner 已设定的人格内容)。
101
- - 写这一段用文件工具直接编辑 `persona.md`(Owner 会话中该文件可写);不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
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。`/fa`、`/fa on`、`/fa off`(`/fullaccess` 为别名)只管理当前私聊 EC 会话:主会话写 Agent 级开关,话题会话写自身 session metadata;群聊不支持。实际运行时逐次复核双 Owner、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。
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` 已纳入 defaults → agent → relation 覆盖链,默认 `true`。
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 true --self bot.agentid.pub
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。`/fa`、`/fa on`、`/fa off`(`/fullaccess` 为别名)只管理当前私聊 EC 会话;主会话写 Agent 配置,话题会话写 session metadata,群聊拒绝。每次 Runner 执行仍复核双 Owner、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。
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 / models.allowed
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
@@ -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
- | 关系空闲 / 兜底 | 自动,**主路径**。一个关系空闲 `idleHours`(默认 1 小时)或最早未整理入站满 `maxUnconsolidatedHours`(默认 8 小时),对该关系依次跑 notes → generalize → promote → profile → forget;**不反馈** |
31
- | 定时检查 | 自动。只管 agent 层 / owner 层 forget,外加 pending 堆积兜底(转成该关系的整理链);**不反馈** |
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、定稿重建索引、反馈)。