evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -20,6 +20,7 @@ import { parse as parseToml } from 'smol-toml';
20
20
  import { readRuntimeEnvironmentVariable } from '../config/runtime-env.js';
21
21
  import { providerModelEnabled, resolveProviderServiceForBaseagent, resolveProviderService } from '../config/providers.js';
22
22
  import { errorQuestionRule } from '../utils/error-utils.js';
23
+ import { getBaseagentPluginDescriptor } from './baseagent-plugin-descriptor.js';
23
24
  /** Resolve the installed Codex CLI entrypoint, including npm shims on Windows. */
24
25
  export function resolveCodexCliPath() {
25
26
  return resolveProbePath('codex');
@@ -57,6 +58,12 @@ export async function execCodexCli(args, options) {
57
58
  child.stdin?.end();
58
59
  });
59
60
  }
61
+ /** 内置 baseagent canonical 名称集合;外部插件不得与这些名称冲突。 */
62
+ export const BUILTIN_BASEAGENT_NAMES = new Set(['claude', 'codex', 'gemini', 'ecagent']);
63
+ /** Implementations still registered directly by the Host; Gemini uses the directory protocol. */
64
+ export const HARDCODED_BASEAGENT_NAMES = new Set(['claude', 'codex', 'ecagent']);
65
+ /** 外部插件名称集合(由插件加载器动态填充) */
66
+ const EXTERNAL_BASEAGENT_NAMES = new Set();
60
67
  const BASEAGENT_ALIASES = {
61
68
  claude: { canonical: 'claude', displayName: 'Claude Code' },
62
69
  cc: { canonical: 'claude', displayName: 'Claude Code' },
@@ -73,7 +80,6 @@ const BASEAGENT_ALIASES = {
73
80
  ecagent: { canonical: 'ecagent', displayName: 'ecagent' },
74
81
  'ec-agent': { canonical: 'ecagent', displayName: 'ecagent' },
75
82
  };
76
- const SUPPORTED_BASEAGENTS = new Set(['claude', 'codex', 'gemini', 'ecagent']);
77
83
  export const DEFAULT_CLAUDE_MODEL = 'sonnet';
78
84
  export const DEFAULT_CODEX_MODEL = 'gpt-6.1-terra';
79
85
  export const DEFAULT_GEMINI_MODEL = 'gemini-2.5-flash';
@@ -83,7 +89,54 @@ export function normalizeBaseagent(input) {
83
89
  }
84
90
  export function isSupportedBaseagent(input) {
85
91
  const key = String(input || '').trim().toLowerCase();
86
- return SUPPORTED_BASEAGENTS.has(key);
92
+ return BUILTIN_BASEAGENT_NAMES.has(key) || EXTERNAL_BASEAGENT_NAMES.has(key);
93
+ }
94
+ export function listSupportedBaseagents() {
95
+ return [...new Set([...BUILTIN_BASEAGENT_NAMES, ...EXTERNAL_BASEAGENT_NAMES])];
96
+ }
97
+ export function reservedBaseagentAliases() {
98
+ return new Set(Object.entries(BASEAGENT_ALIASES)
99
+ .filter(([, value]) => HARDCODED_BASEAGENT_NAMES.has(value.canonical)).map(([alias]) => alias));
100
+ }
101
+ /**
102
+ * 注册外部 baseagent 插件的别名,供 normalizeBaseagent() 和 isSupportedBaseagent() 使用。
103
+ * 由插件加载器在加载外部插件时调用;内置插件不经过此路径。
104
+ *
105
+ * @param canonicalName - 插件的 canonical name(如 'myagent')
106
+ * @param displayName - 对外展示名(如 'My Agent')
107
+ * @param aliases - 应归一到 canonicalName 的所有别名(含 canonicalName 本身)
108
+ */
109
+ export function registerExternalBaseagentAliases(canonicalName, displayName, aliases) {
110
+ if (HARDCODED_BASEAGENT_NAMES.has(canonicalName)) {
111
+ throw new Error(`registerExternalBaseagentAliases: '${canonicalName}' conflicts with a built-in baseagent name`);
112
+ }
113
+ const keys = [...new Set([canonicalName, ...aliases].map(alias => alias.trim().toLowerCase().replace(/_/g, '-')))];
114
+ for (const key of keys) {
115
+ const owner = Object.hasOwn(BASEAGENT_ALIASES, key) ? BASEAGENT_ALIASES[key] : undefined;
116
+ if (!key || key === '__proto__' || key === 'constructor' || key === 'prototype'
117
+ || (owner && owner.canonical !== canonicalName)) {
118
+ throw new Error(`Baseagent alias '${key}' is invalid or already owned by '${owner?.canonical}'`);
119
+ }
120
+ }
121
+ const previous = new Map(keys.map(key => [key,
122
+ Object.hasOwn(BASEAGENT_ALIASES, key) ? BASEAGENT_ALIASES[key] : undefined]));
123
+ const wasKnown = EXTERNAL_BASEAGENT_NAMES.has(canonicalName);
124
+ const normalized = { canonical: canonicalName, displayName };
125
+ for (const key of keys)
126
+ BASEAGENT_ALIASES[key] = normalized;
127
+ EXTERNAL_BASEAGENT_NAMES.add(canonicalName);
128
+ return () => {
129
+ for (const [key, oldValue] of previous) {
130
+ if (BASEAGENT_ALIASES[key] !== normalized)
131
+ continue;
132
+ if (oldValue)
133
+ BASEAGENT_ALIASES[key] = oldValue;
134
+ else
135
+ delete BASEAGENT_ALIASES[key];
136
+ }
137
+ if (!wasKnown)
138
+ EXTERNAL_BASEAGENT_NAMES.delete(canonicalName);
139
+ };
87
140
  }
88
141
  // Runtime prefill only: never write discovered defaults into Agent/defaults files.
89
142
  // Connection and model overrides are part of the key, so a changed Provider cannot
@@ -194,6 +247,19 @@ export function resolveLegacyBaseagentModelSelection(baseagent, options = {}) {
194
247
  }
195
248
  /** Resolve runtime model/effort without persisting fallback values. */
196
249
  export function resolveBaseagentModelSelection(baseagent, configured, options = {}) {
250
+ const identity = normalizeBaseagent(baseagent).canonical;
251
+ if (!BUILTIN_BASEAGENT_NAMES.has(identity)) {
252
+ const descriptor = getBaseagentPluginDescriptor(identity);
253
+ if (!descriptor)
254
+ return undefined;
255
+ const configuredModel = nonEmptyString(configured?.model);
256
+ const model = configuredModel ?? descriptor.defaultModel;
257
+ if (!model)
258
+ return undefined;
259
+ const effort = nonEmptyString(configured?.effort);
260
+ return { model, modelSource: configuredModel ? 'configured' : 'runner',
261
+ ...(effort ? { effort, effortSource: 'configured' } : {}) };
262
+ }
197
263
  const local = resolveLocalBaseagentModelSelection(baseagent, options);
198
264
  if (!local)
199
265
  return undefined;
@@ -0,0 +1,389 @@
1
+ /**
2
+ * `ccagent` 内置网关 agent 的注册、Owner 跟随与名片发布。
3
+ *
4
+ * ## 它是什么
5
+ *
6
+ * 用户显式启用后初始化的网关 agent,唯一职责是**把 Evol App 的消息搬运到
7
+ * 本机某个 Claude Code 终端会话**,并把那个会话的输出回传。它不跑模型:
8
+ * 消息在 `message-bridge` 里就被分流到 `router.ts`,不进 baseagent。
9
+ *
10
+ * ## 为什么记在 daemon.json
11
+ *
12
+ * 它是 daemon 能力的一部分——一台机器一个、跟随 daemon 的 owner 与生命周期。
13
+ * `agents/defaults.json` 是 agent 的默认模板,放在那里语义不符。
14
+ *
15
+ * ## Owner 跟随
16
+ *
17
+ * daemon 有自己的协议 owner(来自名片 `ownership.statement`,缓存在内存)。
18
+ * ccagent 跟随同一个 owner。这里**只发起绑定**,不强行让流程成功:
19
+ * 绑定需要 owner 侧确认,那是前端已有流程的事。evolcore 侧只负责提交请求。
20
+ *
21
+ * ## 绝不读写配置文件里的 owner 字段
22
+ *
23
+ * `AgentConfig.owner` / `DaemonConfig.owner` 是历史兼容字段,已废弃。
24
+ * owner 的唯一事实源是名片与归属协议共识。
25
+ */
26
+ import fs from 'node:fs';
27
+ import path from 'node:path';
28
+ import { createHash } from 'node:crypto';
29
+ import { DEFAULT_AID_DOMAIN, normalizeAidDomain } from '../../aun/aid/domain.js';
30
+ import { agentDir, agentMdPath, resolvePaths } from '../../paths.js';
31
+ import { atomicWriteJson } from '../../utils/atomic-write.js';
32
+ import { getProtocolOwners, ownerResolver, refreshOwnershipForAuthorization } from '../../core/ownership/owner-resolver.js';
33
+ import { loadDaemonConfig, saveDaemonConfig } from '../../config-store.js';
34
+ import { currentVersion } from '../../config/schema-registry.js';
35
+ import { logger } from '../../utils/logger.js';
36
+ import { currentContactBinding } from '../../core/message/contact-admission.js';
37
+ /**
38
+ * 兼容旧版已注册的默认 AID;新身份使用本机稳定后缀。
39
+ *
40
+ * 首段必须 4-64 个字符(fastaun 的 `RegisterFlow.validateAidName` 硬约束),
41
+ * 所以不能用 `cc` 这种两字母前缀。
42
+ */
43
+ const DEFAULT_CC_AGENT_AID = 'ccagent.agentid.cn';
44
+ const AID_PREFIX = 'ccagent';
45
+ /**
46
+ * 名片文案。
47
+ *
48
+ * 用第一人称写:名片是 agent 以自己的身份说话,不是第三方在介绍它。
49
+ *
50
+ * frontmatter 的 `description` 有 100 字符硬上限(`AGENT_DESCRIPTION_MAX_LENGTH`),
51
+ * 所以只放一句摘要;完整说明写进正文,跟 `brief.agentid.cn` 等既有 agent 一致。
52
+ */
53
+ const CC_AGENT_NAME = 'Claude Code 网关';
54
+ const CC_AGENT_DESCRIPTION = '我是这台机器的 Claude Code 入口:发消息给我,我会投递到本机的 Claude Code 会话并带回输出。';
55
+ /** 名片正文,说明用途、权限来源与边界。 */
56
+ const CC_AGENT_BODY = `# Claude Code 网关
57
+
58
+ 我是运行在这台机器上的 Claude Code 网关,是这台电脑的 Claude Code 入口。
59
+
60
+ ## 我能做什么
61
+
62
+ 你在这里发消息,我会把它投递到这台机器上**正在运行的 Claude Code 会话**,
63
+ 再把那边的输出带回来给你。所以:
64
+
65
+ - 让我读写代码、运行命令、查看日志、排查构建——都可以;
66
+ - 用的是那个终端本身的权限和上下文,不是另一套环境;
67
+ - 那个终端里积累的对话历史,我看得到,也接着用。
68
+
69
+ ## 边界
70
+
71
+ - **我不做推理。** 我只负责转发,回复来自那个 Claude Code 会话。
72
+ - **换一个话题,就是换一个 Claude Code 会话。** 没有打开的会话我可以帮你拉起来。
73
+ - 会话关掉之后上下文还在,重新打开能接上原来的对话。`;
74
+ /** 读取已配置的 ccagent AID。 */
75
+ export function getCcAgentAid() {
76
+ const aid = loadDaemonConfig().ccAgent?.aid;
77
+ return typeof aid === 'string' && aid.trim() ? aid.trim() : undefined;
78
+ }
79
+ /** 配置文件路径。 */
80
+ function ccAgentConfigPath(aid) {
81
+ return path.join(agentDir(aid), 'config.json');
82
+ }
83
+ /** AID 身份文件是否齐全(私钥 + 证书)。 */
84
+ function hasIdentity(aid) {
85
+ const root = resolvePaths().root;
86
+ return [
87
+ path.join(root, 'AIDs', aid, 'private', 'key.json'),
88
+ path.join(root, 'AIDs', aid, 'public', 'cert.pem'),
89
+ ].every(file => fs.existsSync(file));
90
+ }
91
+ /** 三件套齐全:AID 身份 + agent 配置 + 名片。 */
92
+ export function isCcAgentReady(aid) {
93
+ try {
94
+ return hasIdentity(aid)
95
+ && fs.existsSync(ccAgentConfigPath(aid))
96
+ && fs.existsSync(agentMdPath(aid));
97
+ }
98
+ catch {
99
+ return false;
100
+ }
101
+ }
102
+ /**
103
+ * 挑选 ccagent 要用的 AID。
104
+ *
105
+ * 先复用旧版默认 AID 的完整身份,再按宿主身份和配置域生成稳定候选名。
106
+ * 候选名已有完整本地身份时复用,存在不完整目录时尝试下一个序号。
107
+ */
108
+ function pickCcAgentAid() {
109
+ const root = resolvePaths().root;
110
+ if (hasIdentity(DEFAULT_CC_AGENT_AID))
111
+ return DEFAULT_CC_AGENT_AID;
112
+ const cfg = loadDaemonConfig();
113
+ const domain = normalizeAidDomain(cfg.aun?.defaultAidDomain ?? DEFAULT_AID_DOMAIN, 'ccAgent domain');
114
+ const suffix = createHash('sha256').update(cfg.aid ?? root).digest('hex').slice(0, 10);
115
+ for (let i = 0; i <= 99; i += 1) {
116
+ const next = `${AID_PREFIX}-${suffix}${i ? '-' + i : ''}.${domain}`;
117
+ if (hasIdentity(next))
118
+ return next;
119
+ if (!fs.existsSync(path.join(root, 'AIDs', next)))
120
+ return next;
121
+ }
122
+ throw new Error('无法为本机 Claude 网关分配未占用的本地身份');
123
+ }
124
+ /** ccagent 的最小 agent 配置。刻意不含 owner 字段,也不配 baseagent(不跑模型)。 */
125
+ function buildCcAgentConfig(aid) {
126
+ return {
127
+ // 跟随当前 schema 版本,避免模板写死后与 kits/schemas 脱节(曾因写死 v19 触发必填字段告警)
128
+ $schema_version: currentVersion('agent-config'),
129
+ aid,
130
+ enabled: true,
131
+ lifecycle: 'active',
132
+ channels: [],
133
+ projects: { defaultPath: path.join(agentDir(aid), 'workspace') },
134
+ access: {
135
+ // 只接受关系内联系人;白名单由 owner 通过 contact 流程加
136
+ allowInternalContacts: true,
137
+ allowExternalContacts: false,
138
+ allowAllContacts: false,
139
+ allowedAids: [],
140
+ deniedAids: [],
141
+ },
142
+ chatmode: { private: 'interactive', group: 'proactive', nothuman: 'proactive' },
143
+ bootstrapWelcome: false,
144
+ };
145
+ }
146
+ /**
147
+ * 第一步:确保 AID 身份与 agent 配置存在。幂等。
148
+ */
149
+ async function ensureIdentity(aid) {
150
+ if (!hasIdentity(aid)) {
151
+ const { aidCreateIdentityOnly } = await import('../../aun/aid/identity.js');
152
+ let client;
153
+ try {
154
+ const result = await aidCreateIdentityOnly(aid, { type: 'agent' });
155
+ client = result.client;
156
+ logger.info(`[ccagent] AID 就绪:${aid}(${result.alreadyExisted ? '已存在' : '新注册'})`);
157
+ }
158
+ finally {
159
+ try {
160
+ await client?.close?.();
161
+ }
162
+ catch { /* 关闭失败不影响已注册身份 */ }
163
+ }
164
+ }
165
+ if (!fs.existsSync(ccAgentConfigPath(aid))) {
166
+ fs.mkdirSync(agentDir(aid), { recursive: true });
167
+ atomicWriteJson(ccAgentConfigPath(aid), buildCcAgentConfig(aid));
168
+ logger.info(`[ccagent] 配置已写入:${ccAgentConfigPath(aid)}`);
169
+ }
170
+ }
171
+ /**
172
+ * 第二步:跟随 daemon 的协议 owner 发起绑定。
173
+ *
174
+ * **只发起,不保证成功**:绑定需要 owner 侧确认,走的是已有的前端流程。
175
+ * 这里能做的三件事是:
176
+ *
177
+ * 1. 读 daemon 的协议 owner(不接受配置兜底);
178
+ * 2. 调绑定接口提交请求;
179
+ * 3. 把结果如实记进日志——成功、已绑定、还是需要用户在 App 里确认。
180
+ */
181
+ async function followDaemonOwner(aid) {
182
+ const owners = await resolveDaemonProtocolOwners();
183
+ if (owners.length === 0) {
184
+ logger.info('[ccagent] daemon 尚未确定协议 owner,跳过绑定;下次启动或收到消息时再试');
185
+ return false;
186
+ }
187
+ const ownerAid = owners[0];
188
+ try {
189
+ const { bindAgentCreationOwner } = await import('../../core/agent-runtime.js');
190
+ await bindAgentCreationOwner(aid, ownerAid);
191
+ await refreshOwnershipForAuthorization(aid, { force: true, allowTransient: false, source: 'claude-gateway-init' });
192
+ logger.info(`[ccagent] 已向 ${ownerAid} 发起 Owner 绑定`);
193
+ return currentContactBinding(aid)?.owner_aid === ownerAid;
194
+ }
195
+ catch (error) {
196
+ const code = error.code;
197
+ if (code === 'OWNER_ALREADY_BOUND') {
198
+ logger.debug('[ccagent] 已绑定到其他 Owner,保持不变');
199
+ return currentContactBinding(aid)?.owner_aid === ownerAid;
200
+ }
201
+ // 绑定是异步的,需要 owner 侧确认;失败不阻塞启动
202
+ logger.warn(`[ccagent] Owner 绑定未完成(${code ?? 'unknown'}):${error.message}`);
203
+ return false;
204
+ }
205
+ }
206
+ /**
207
+ * 第三步:生成并发布名片。
208
+ *
209
+ * 名片必须说清楚"这是什么、能干什么",因为 Evol App 的联系人列表里只有它。
210
+ * 本地草稿总写;网络发布需要身份可认证,失败只告警——下次启动重试。
211
+ */
212
+ async function publishCard(aid) {
213
+ const { buildInitialAgentMd } = await import('../../aun/aid/agentmd.js');
214
+ const frontmatter = buildInitialAgentMd({
215
+ aid,
216
+ name: CC_AGENT_NAME,
217
+ description: CC_AGENT_DESCRIPTION,
218
+ type: 'agent',
219
+ tags: ['evolcore', 'ccagent', 'claude-code'],
220
+ // 不给 owner:ownership 由归属协议写入,这里只写可读的档案草稿
221
+ });
222
+ // buildInitialAgentMd 只产 frontmatter,正文要自己接上
223
+ const content = `${frontmatter.trimEnd()}\n\n${CC_AGENT_BODY}`;
224
+ try {
225
+ fs.mkdirSync(path.dirname(agentMdPath(aid)), { recursive: true });
226
+ fs.writeFileSync(agentMdPath(aid), content, 'utf-8');
227
+ }
228
+ catch (error) {
229
+ logger.warn(`[ccagent] 名片草稿写入失败:${error.message}`);
230
+ return false;
231
+ }
232
+ // 网络发布:非 human agent 必须先有 owner,否则服务端拒收。
233
+ const owners = await resolveDaemonProtocolOwners();
234
+ if (owners.length === 0) {
235
+ logger.info('[ccagent] 名片草稿已写入本地;owner 未就绪,暂不发布到网络');
236
+ return false;
237
+ }
238
+ try {
239
+ const { agentmdPutInitializationProfile } = await import('../../aun/aid/agentmd.js');
240
+ await agentmdPutInitializationProfile(content, { aid, ownerAid: owners[0] });
241
+ logger.info(`[ccagent] 名片已发布(owner ${owners[0]})`);
242
+ return true;
243
+ }
244
+ catch (error) {
245
+ logger.warn(`[ccagent] 名片发布失败,下次启动重试:${error.message}`);
246
+ return false;
247
+ }
248
+ }
249
+ /** 读写 daemon.json 里的 ccagent 段。 */
250
+ function readCcAgentState() {
251
+ const cc = loadDaemonConfig().ccAgent;
252
+ return { aid: cc?.aid, status: cc?.status, lastError: cc?.lastError };
253
+ }
254
+ /**
255
+ * 把进度写回 daemon.json。
256
+ *
257
+ * **AID 一旦注册成功就立即落盘**,不再等到流程结束——否则进程中途退出时,
258
+ * 已注册的公开身份就丢了线索,下次启动会白白再注册一个。
259
+ */
260
+ function saveCcAgentState(patch) {
261
+ try {
262
+ const cfg = loadDaemonConfig();
263
+ const merged = {
264
+ enabled: cfg.ccAgent?.enabled === true,
265
+ ...(cfg.ccAgent?.aid ? { aid: cfg.ccAgent.aid } : {}),
266
+ ...(cfg.ccAgent?.status ? { status: cfg.ccAgent.status } : {}),
267
+ ...(cfg.ccAgent?.lastError ? { lastError: cfg.ccAgent.lastError } : {}),
268
+ ...patch,
269
+ };
270
+ // lastError 传空串表示清空
271
+ if (patch.lastError === '')
272
+ delete merged.lastError;
273
+ saveDaemonConfig({ ...cfg, ccAgent: merged });
274
+ }
275
+ catch (error) {
276
+ logger.warn(`[ccagent] 写 daemon.json 失败:${error.message}`);
277
+ throw error;
278
+ }
279
+ }
280
+ /** 记录当前阶段失败原因,但不推进 status。 */
281
+ function markPending(status, reason) {
282
+ saveCcAgentState({ status, lastError: reason.slice(0, 300) });
283
+ }
284
+ /**
285
+ * 启动入口:确保 ccagent 完整可用,可断点续跑。
286
+ *
287
+ * ## 为什么每次都要从头核查
288
+ *
289
+ * `status !== 'ready'` 时**不能假设前面的步骤仍然成立**——用户可能删了
290
+ * 名片文件、换了 owner、或者 AID 目录被清掉。所以每次续跑都从头核查:
291
+ *
292
+ * 1. AID 身份(私钥 + 证书)——缺就注册
293
+ * 2. agent 配置——缺就写
294
+ * 3. owner 绑定——没达成共识就重新发起
295
+ * 4. 名片——本地缺失就生成,未发布就发布
296
+ *
297
+ * 每完成一步就把 status 往前推一格,失败则记录原因并停在该格。
298
+ * 全程幂等,失败不阻塞 daemon 启动。
299
+ *
300
+ * @returns 生效的 AID;身份都没拿到返回 undefined
301
+ */
302
+ export async function ensureCcAgent() {
303
+ if (loadDaemonConfig().ccAgent?.enabled !== true)
304
+ return undefined;
305
+ const state = readCcAgentState();
306
+ // Even an existing identity must revalidate current ownership before being ready.
307
+ // 1. 确定 AID
308
+ const aid = state.aid ?? pickCcAgentAidSafely();
309
+ if (!aid)
310
+ return undefined;
311
+ if (!state.aid) {
312
+ // 先落盘 AID 与状态,再做任何网络操作
313
+ saveCcAgentState({ aid, status: 'registering', lastError: '' });
314
+ }
315
+ // 2. AID 身份 + agent 配置(从头核查,不信任 status)
316
+ try {
317
+ await ensureIdentity(aid);
318
+ }
319
+ catch (error) {
320
+ markPending('registering', `identity: ${error.message}`);
321
+ logger.warn(`[ccagent] AID 身份未就绪:${error.message}`);
322
+ return undefined;
323
+ }
324
+ // 3. owner 绑定
325
+ try {
326
+ if (!await followDaemonOwner(aid)) {
327
+ markPending('owner_pending', 'Owner consensus is not yet confirmed');
328
+ return undefined;
329
+ }
330
+ }
331
+ catch (error) {
332
+ markPending('owner_pending', `owner: ${error.message}`);
333
+ return undefined;
334
+ }
335
+ if ((await resolveDaemonProtocolOwners()).length === 0) {
336
+ markPending('owner_pending', 'daemon 尚未确定协议 owner');
337
+ return undefined;
338
+ }
339
+ // 4. 名片:本地 + 网络发布
340
+ try {
341
+ const published = await publishCard(aid);
342
+ if (!published) {
343
+ markPending('card_pending', '名片未发布到网络');
344
+ return undefined;
345
+ }
346
+ }
347
+ catch (error) {
348
+ markPending('card_pending', `card: ${error.message}`);
349
+ return undefined;
350
+ }
351
+ saveCcAgentState({ aid, status: 'ready', lastError: '' });
352
+ logger.info(`[ccagent] 就绪:${aid}`);
353
+ return aid;
354
+ }
355
+ /** pickCcAgentAid 的容错包装:分配失败只告警。 */
356
+ function pickCcAgentAidSafely() {
357
+ try {
358
+ return pickCcAgentAid();
359
+ }
360
+ catch (error) {
361
+ logger.warn(`[ccagent] ${error.message}`);
362
+ return undefined;
363
+ }
364
+ }
365
+ /**
366
+ * 取 daemon 的协议 owner。
367
+ *
368
+ * - 只认归属协议:`getProtocolOwners()` 要求 `view.consensusStatus === 'consensus'`,
369
+ * 不回落配置,因此不存在「配置文件里写个 owner 就被采纳」的路径。
370
+ * - 视图尚未恢复时 `refresh()` 一次;有新鲜缓存则命中缓存,不发网络请求。
371
+ */
372
+ export async function resolveDaemonProtocolOwners() {
373
+ const daemonAid = ownerResolver.getDaemonAid();
374
+ if (!daemonAid)
375
+ return [];
376
+ const direct = getProtocolOwners(daemonAid);
377
+ if (direct.length > 0)
378
+ return direct;
379
+ try {
380
+ const view = await ownerResolver.refresh(daemonAid, { maxAgeMs: 30 * 60_000 });
381
+ if (view.consensusStatus !== 'consensus' || !view.ownerAid)
382
+ return [];
383
+ return getProtocolOwners(daemonAid);
384
+ }
385
+ catch (error) {
386
+ logger.debug('[ccagent] 解析 daemon owner 失败:', error.message);
387
+ return [];
388
+ }
389
+ }
@@ -0,0 +1,96 @@
1
+ /**
2
+ * 话题 ↔ Claude Code 会话的绑定存储。
3
+ *
4
+ * 一个话题(threadId)绑定一个 Claude Code sessionId。选 sessionId 而不是 pid
5
+ * 或 cwd,是因为 `claude --resume <sessionId>` 已经确认可以接续上下文,
6
+ * 会话进程关掉后能原样拉回来。
7
+ *
8
+ * ## 为什么是 daemon 级而不是 agent 级
9
+ *
10
+ * ccagent 是 daemon 的能力(AID 记在 `daemon.json`),不是普通 agent。
11
+ * 绑定表也跟着放 daemon 级:`<root>/data/ccagent/topics.json`。
12
+ * 放在 `agents/<aid>/` 下会有个隐患——改 `ccAgent.aid` 后旧绑定留在旧目录里,
13
+ * 新 AID 读不到,等于静默丢绑定。
14
+ *
15
+ * 写入一律走原子写,避免半边文件导致整个话题表作废。
16
+ */
17
+ import fs from 'node:fs';
18
+ import path from 'node:path';
19
+ import { atomicWriteJson } from '../../utils/atomic-write.js';
20
+ import { resolvePaths } from '../../paths.js';
21
+ import { logger } from '../../utils/logger.js';
22
+ const FILE_VERSION = 1;
23
+ /**
24
+ * 绑定表路径(daemon 级,与 ccagent 的 AID 无关)。
25
+ *
26
+ * `<root>/data/ccagent/topics.json`
27
+ */
28
+ export function bindingFilePath() {
29
+ return path.join(resolvePaths().dataDir, 'ccagent', 'topics.json');
30
+ }
31
+ function readBindingFile() {
32
+ const file = bindingFilePath();
33
+ try {
34
+ const raw = JSON.parse(fs.readFileSync(file, 'utf-8'));
35
+ if (raw.version !== FILE_VERSION || !raw.topics || typeof raw.topics !== 'object') {
36
+ return { version: FILE_VERSION, topics: {} };
37
+ }
38
+ return { version: FILE_VERSION, topics: raw.topics };
39
+ }
40
+ catch {
41
+ // 文件不存在或损坏都当作空表;损坏时保留原文件不动,下次写入会覆盖
42
+ return { version: FILE_VERSION, topics: {} };
43
+ }
44
+ }
45
+ function writeBindingFile(data) {
46
+ const file = bindingFilePath();
47
+ try {
48
+ fs.mkdirSync(path.dirname(file), { recursive: true });
49
+ atomicWriteJson(file, data);
50
+ }
51
+ catch (error) {
52
+ logger.warn('[claude-gateway] 绑定表写入失败:', error.message);
53
+ throw error;
54
+ }
55
+ }
56
+ /** 读取某个话题的绑定。 */
57
+ export function getBinding(threadId) {
58
+ return readBindingFile().topics[threadId];
59
+ }
60
+ /** 写入/覆盖某个话题的绑定。 */
61
+ export function setBinding(threadId, binding) {
62
+ const data = readBindingFile();
63
+ const record = { ...binding, boundAt: Date.now() };
64
+ data.topics[threadId] = record;
65
+ writeBindingFile(data);
66
+ return record;
67
+ }
68
+ /** 解除绑定。返回是否真的删除了一条。 */
69
+ export function removeBinding(threadId) {
70
+ const data = readBindingFile();
71
+ if (!data.topics[threadId])
72
+ return false;
73
+ delete data.topics[threadId];
74
+ writeBindingFile(data);
75
+ return true;
76
+ }
77
+ /** 列出全部绑定,按绑定时间倒序。 */
78
+ export function listBindings() {
79
+ const data = readBindingFile();
80
+ return Object.entries(data.topics)
81
+ .map(([threadId, binding]) => ({ threadId, binding }))
82
+ .sort((a, b) => b.binding.boundAt - a.binding.boundAt);
83
+ }
84
+ /**
85
+ * 找出已经占用某个 sessionId 的话题。
86
+ *
87
+ * 用于防止两个话题绑到同一个 Claude Code 会话上——那样输出会串。
88
+ */
89
+ export function findThreadBySession(sessionId) {
90
+ const data = readBindingFile();
91
+ for (const [threadId, binding] of Object.entries(data.topics)) {
92
+ if (binding.sessionId === sessionId)
93
+ return threadId;
94
+ }
95
+ return undefined;
96
+ }