evolcore 0.0.49 → 0.0.51

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 (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. 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
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,103 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { validateAIDFormat } from '@agentunion/fastaun';
3
+ import { toAttachmentMarkedPath } from '../paths.js';
4
+ import { formatAttachmentMarker, saveRelationAttachment } from '../utils/media-cache.js';
5
+ import { formatPeerKey } from '../core/relation/peer-identity.js';
6
+ import { templateError } from './types.js';
7
+ export const TEMPLATE_SHARE_TYPE = 'agent.template.share';
8
+ const MAX_SHARE_BYTES = 64 * 1024;
9
+ function record(value) {
10
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
11
+ }
12
+ function invalid() {
13
+ // Do not include untrusted card contents or download credentials in errors.
14
+ throw templateError('INVALID_TEMPLATE_SHARE', 'Invalid or unsupported Agent template share');
15
+ }
16
+ function string(value, max) {
17
+ return typeof value === 'string' && value.trim().length > 0 && value.length <= max;
18
+ }
19
+ function aid(value) {
20
+ try {
21
+ return typeof value === 'string' && validateAIDFormat(value) === value;
22
+ }
23
+ catch {
24
+ return false;
25
+ }
26
+ }
27
+ /** Validate only the supported share envelope; retain extension fields verbatim. */
28
+ export function parseTemplateShare(payload, recipientAid) {
29
+ if (!record(payload) || payload.type !== TEMPLATE_SHARE_TYPE
30
+ || ![1, 2].includes(payload.schema_version))
31
+ invalid();
32
+ let bytes;
33
+ try {
34
+ bytes = JSON.stringify(payload);
35
+ }
36
+ catch {
37
+ invalid();
38
+ }
39
+ if (Buffer.byteLength(bytes, 'utf8') > MAX_SHARE_BYTES)
40
+ invalid();
41
+ const template = payload.template;
42
+ const location = payload.location;
43
+ if (!string(payload.share_id, 256) || !record(template) || !record(location)
44
+ || !aid(location.aid) || !string(location.path, 4096)
45
+ || /[\u0000-\u001f]/.test(location.path)
46
+ || !string(template.id, 256) || !string(template.name, 512) || !string(template.version, 128)
47
+ || typeof template.digest !== 'string' || !/^sha256:[a-f0-9]{64}$/i.test(template.digest)
48
+ || !Number.isSafeInteger(template.size) || template.size < 1
49
+ || template.description !== undefined && typeof template.description !== 'string')
50
+ invalid();
51
+ if (payload.expires_at !== undefined && (!Number.isSafeInteger(payload.expires_at)
52
+ || payload.expires_at < 0 || payload.expires_at > 8_640_000_000_000))
53
+ invalid();
54
+ if (payload.recipient_download !== undefined) {
55
+ const download = payload.recipient_download;
56
+ if (!record(download) || !aid(download.aid) || download.aid !== recipientAid
57
+ || !string(download.shareId, 256))
58
+ invalid();
59
+ }
60
+ return JSON.parse(bytes);
61
+ }
62
+ function display(value) {
63
+ const line = value.replace(/[\r\n\u0000-\u001f]/g, ' ');
64
+ return JSON.stringify(line.length > 1024 ? line.slice(0, 1024) + '…' : line);
65
+ }
66
+ /** Sender identity is taken from the authenticated transport, not publisher. */
67
+ export function templateShareText(share, senderAid) {
68
+ const expires = share.expires_at === undefined ? '未提供'
69
+ : share.expires_at === 0 ? '永久' : new Date(share.expires_at * 1000).toISOString();
70
+ return [
71
+ '[Agent 模板分享]',
72
+ `发送方:${senderAid}`,
73
+ `模板:${display(share.template.name)} (${display(share.template.id)})`,
74
+ `版本:${display(share.template.version)}`,
75
+ ...(share.template.description ? [`描述:${display(share.template.description)}`] : []),
76
+ `SHA-256:${share.template.digest}`,
77
+ `大小:${share.template.size} 字节`,
78
+ `有效期:${expires}`,
79
+ `分享标识:${display(share.share_id)}`,
80
+ ].join('\n');
81
+ }
82
+ /** Archive the original card using the same read-only attachment path as files. */
83
+ export function saveTemplateShare(share, input) {
84
+ const filename = `template-share-${createHash('sha256').update(input.messageId).digest('hex')}.json`;
85
+ const saved = saveRelationAttachment(Buffer.from(JSON.stringify({
86
+ schemaVersion: 1,
87
+ messageId: input.messageId,
88
+ senderAid: input.senderAid,
89
+ recipientAid: input.selfAid,
90
+ receivedAt: input.receivedAt,
91
+ payload: share,
92
+ }, null, 2) + '\n'), input.selfAid, formatPeerKey('aun', input.senderAid), 'application/json', {
93
+ filename, allowAnyExtension: true, direction: 'in',
94
+ });
95
+ const text = templateShareText(share, input.senderAid);
96
+ return {
97
+ finalText: text + '\n\n分享信息(完整卡片 JSON):\n'
98
+ + formatAttachmentMarker('文件', filename, saved.filePath, saved.storage),
99
+ logText: text + '\n\n分享信息(完整卡片 JSON):\n'
100
+ + formatAttachmentMarker('文件', filename, toAttachmentMarkedPath(input.selfAid, saved.filePath), saved.storage),
101
+ images: [],
102
+ };
103
+ }
@@ -34,6 +34,31 @@ export async function runTemplateTool(command, options, control = {}) {
34
34
  resolve(output);
35
35
  });
36
36
  const abort = () => { child.kill('SIGKILL'); };
37
+ let pending = '';
38
+ child.stdout?.on('data', chunk => {
39
+ pending += chunk.toString();
40
+ let newline;
41
+ while ((newline = pending.indexOf('\n')) >= 0) {
42
+ const line = pending.slice(0, newline);
43
+ pending = pending.slice(newline + 1);
44
+ let event;
45
+ try {
46
+ event = JSON.parse(line);
47
+ }
48
+ catch {
49
+ continue;
50
+ }
51
+ if (event?.type !== 'progress' || typeof event.phase !== 'string' || !/^[a-z_]{1,64}$/.test(event.phase))
52
+ continue;
53
+ try {
54
+ control.onProgress?.(event.phase);
55
+ }
56
+ catch (error) {
57
+ child.kill('SIGKILL');
58
+ reject(error);
59
+ }
60
+ }
61
+ });
37
62
  control.signal?.addEventListener('abort', abort, { once: true });
38
63
  try {
39
64
  if (child.pid)
@@ -1,8 +1,16 @@
1
- export const TEMPLATE_ACTIONS = ['inspect', 'build', 'push', 'pull', 'preview', 'deploy',
2
- 'status', 'resume', 'cancel', 'capabilities'];
1
+ export const TEMPLATE_ACTIONS = ['inspect', 'collect', 'pack', 'push', 'list', 'detail', 'publish', 'download', 'pull', 'preview', 'deploy',
2
+ 'status', 'resume', 'cancel', 'capabilities',
3
+ 'update-status', 'check-update', 'upgrade'];
3
4
  export function templateJobAids(job) {
4
5
  return Object.values(job.members).flatMap(member => member.aid ? [member.aid] : []);
5
6
  }
6
7
  export function templateError(code, message, details) {
7
8
  return Object.assign(new Error(message), { code, ...(details === undefined ? {} : { details }) });
8
9
  }
10
+ export const TEMPLATE_PULL_OWNER_GUIDANCE = '请通知当前 Agent 的 Owner 模板操作受权限限制,并汇报模板来源、已完成步骤和待办;由 Owner 在与其 Agent 的私聊中提出所需操作(如下载或安装),由该会话按目标主机的 DaemonOwner 身份核验后继续。若该 Owner 不是目标主机的 DaemonOwner,需由目标主机的 DaemonOwner 发起。收到分享不授予下载或安装权限,不要在原 Agent-Agent 会话中重复重试。';
11
+ export function templateOwnerRequiredError(action, message = 'Current verified DaemonOwner required', details = {}) {
12
+ return templateError('NOT_ALLOWED', message + (action ? TEMPLATE_PULL_OWNER_GUIDANCE : ''), {
13
+ ...details, reasonCode: 'DAEMON_OWNER_REQUIRED',
14
+ ...(action ? { nextStep: TEMPLATE_PULL_OWNER_GUIDANCE } : {}),
15
+ });
16
+ }
@@ -0,0 +1,94 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createRequire } from 'node:module';
4
+ import { commandExists, commandExistsAsync, probeCli, probeCliSync } from '../../utils/cross-platform.js';
5
+ /**
6
+ * Claude 的检测判据就是执行判据:会话只会在 Windows 上跑内置的、与 SDK 锁定版本
7
+ * 配套的 claude.exe。PATH 里的全局 claude 执行层从不使用,因此不能作为可用判据——
8
+ * 那个假阳性正是「检测说可用、会话全失败」持续 21 小时没被发现的成因。
9
+ */
10
+ function claudeExecutable() {
11
+ if (process.platform === 'win32')
12
+ return resolveBundledClaudeExecutable();
13
+ // 非 Windows 平台由 SDK 自己解析平台包,此处沿用命令探测。
14
+ return commandExists('claude') ? 'claude' : undefined;
15
+ }
16
+ export function probeClaudeAvailability() {
17
+ const executable = claudeExecutable();
18
+ return { available: !!executable, version: executable ? probeBundledClaudeVersion() : undefined,
19
+ reason: executable ? undefined : '未找到 Claude CLI / SDK 平台可执行文件' };
20
+ }
21
+ export async function probeClaudeAvailabilityAsync() {
22
+ const available = process.platform === 'win32' ? !!resolveBundledClaudeExecutable() : await commandExistsAsync('claude');
23
+ return { available, version: available ? await probeBundledClaudeVersionAsync() : undefined,
24
+ reason: available ? undefined : '未找到 Claude CLI / SDK 平台可执行文件' };
25
+ }
26
+ const resolveModule = createRequire(import.meta.url);
27
+ /**
28
+ * Resolve the platform package explicitly instead of relying on the SDK's
29
+ * internal optional-dependency lookup. The latter is sensitive to the module
30
+ * installation/loader context and can report a missing binary even when the
31
+ * package is present in the same node_modules tree.
32
+ */
33
+ export function resolveBundledClaudeExecutable() {
34
+ if (process.platform !== 'win32')
35
+ return undefined;
36
+ const nativePackage = process.arch === 'arm64'
37
+ ? '@anthropic-ai/claude-agent-sdk-win32-arm64'
38
+ : process.arch === 'x64'
39
+ ? '@anthropic-ai/claude-agent-sdk-win32-x64'
40
+ : undefined;
41
+ if (!nativePackage)
42
+ return undefined;
43
+ const binarySpecifier = `${nativePackage}/claude.exe`;
44
+ try {
45
+ const executable = resolveModule.resolve(binarySpecifier);
46
+ if (fs.existsSync(executable))
47
+ return executable;
48
+ }
49
+ catch {
50
+ // Fall through to a direct sibling lookup for package layouts where the
51
+ // optional package does not expose its binary through exports.
52
+ }
53
+ try {
54
+ const sdkEntry = resolveModule.resolve('@anthropic-ai/claude-agent-sdk');
55
+ const executable = path.resolve(path.dirname(sdkEntry), '..', '@anthropic-ai', nativePackage.slice('@anthropic-ai/'.length), 'claude.exe');
56
+ return fs.existsSync(executable) ? executable : undefined;
57
+ }
58
+ catch {
59
+ return undefined;
60
+ }
61
+ }
62
+ /**
63
+ * 探测内置 claude.exe 的版本。检测层与执行层共用同一份二进制,所以这里探到的
64
+ * 版本就是会话真正会跑的那个版本,可与 SDK 锁定的 claudeCodeVersion 对照。
65
+ */
66
+ export function probeBundledClaudeVersion() {
67
+ const executable = resolveBundledClaudeExecutable();
68
+ if (!executable)
69
+ return undefined;
70
+ try {
71
+ const raw = probeCliSync('bundled-claude', ['--version'], {
72
+ executable, validateOutput: output => /^\d+\.\d+\.\d+\b/.test(output.trim()),
73
+ });
74
+ return raw.trim().split(/\s+/)[0] || undefined;
75
+ }
76
+ catch {
77
+ return undefined;
78
+ }
79
+ }
80
+ /** Shares the installation-aware probe cache and in-flight request with other readers. */
81
+ export async function probeBundledClaudeVersionAsync() {
82
+ const executable = resolveBundledClaudeExecutable();
83
+ if (!executable)
84
+ return undefined;
85
+ try {
86
+ const raw = await probeCli('bundled-claude', ['--version'], {
87
+ executable, validateOutput: output => /^\d+\.\d+\.\d+\b/.test(output.trim()),
88
+ });
89
+ return raw.trim().split(/\s+/)[0] || undefined;
90
+ }
91
+ catch {
92
+ return undefined;
93
+ }
94
+ }
@@ -0,0 +1,154 @@
1
+ import fs from 'fs';
2
+ import os from 'os';
3
+ import path from 'path';
4
+ import { execFileSync } from 'child_process';
5
+ import { discoverSkillDirectories } from '../../core/capability/skill-discovery.js';
6
+ function readJson(file) {
7
+ try {
8
+ if (!fs.existsSync(file))
9
+ return null;
10
+ return JSON.parse(fs.readFileSync(file, 'utf-8'));
11
+ }
12
+ catch {
13
+ return null;
14
+ }
15
+ }
16
+ function describeMcpSpec(spec) {
17
+ const command = typeof spec?.command === 'string' ? spec.command : undefined;
18
+ if (command)
19
+ return `stdio: ${path.basename(command)}`;
20
+ const rawUrl = typeof spec?.url === 'string' ? spec.url : typeof spec?.serverUrl === 'string' ? spec.serverUrl : undefined;
21
+ if (!rawUrl)
22
+ return undefined;
23
+ try {
24
+ const url = new URL(rawUrl);
25
+ return `remote: ${url.origin}${url.pathname}`;
26
+ }
27
+ catch {
28
+ return 'remote';
29
+ }
30
+ }
31
+ function discoverSkills(projectPath) {
32
+ const roots = [
33
+ { dir: path.join(projectPath, '.claude', 'skills'), source: 'project' },
34
+ { dir: path.join(os.homedir(), '.claude', 'skills'), source: 'user' },
35
+ ];
36
+ const seen = new Set();
37
+ const items = [];
38
+ for (const root of roots) {
39
+ for (const skill of discoverSkillDirectories(root.dir)) {
40
+ const { id } = skill;
41
+ if (seen.has(id))
42
+ continue;
43
+ seen.add(id);
44
+ items.push({
45
+ id,
46
+ label: id,
47
+ desc: skill.description,
48
+ source: root.source,
49
+ });
50
+ }
51
+ }
52
+ return items;
53
+ }
54
+ function readMcpServers(projectPath) {
55
+ const candidates = [
56
+ { file: path.join(projectPath, '.mcp.json'), source: 'project' },
57
+ { file: path.join(projectPath, '.claude', 'mcp.json'), source: 'project' },
58
+ { file: path.join(os.homedir(), '.claude', 'mcp.json'), source: 'user' },
59
+ ];
60
+ const seen = new Set();
61
+ const items = [];
62
+ for (const candidate of candidates) {
63
+ const config = readJson(candidate.file);
64
+ const servers = config?.mcpServers;
65
+ if (!servers || typeof servers !== 'object')
66
+ continue;
67
+ for (const [name, spec] of Object.entries(servers)) {
68
+ if (seen.has(name))
69
+ continue;
70
+ seen.add(name);
71
+ items.push({
72
+ id: name,
73
+ label: name,
74
+ desc: describeMcpSpec(spec),
75
+ source: candidate.source,
76
+ status: 'configured',
77
+ runtimeEnabled: true,
78
+ data: spec && typeof spec === 'object' && !Array.isArray(spec) ? { ...spec } : undefined,
79
+ });
80
+ }
81
+ }
82
+ return items;
83
+ }
84
+ function discoverPlugins(projectPath) {
85
+ const settingsFiles = [
86
+ { file: path.join(projectPath, '.claude', 'settings.json'), source: 'project' },
87
+ { file: path.join(projectPath, '.claude', 'settings.local.json'), source: 'project' },
88
+ { file: path.join(os.homedir(), '.claude', 'settings.json'), source: 'user' },
89
+ ];
90
+ const seen = new Set();
91
+ const items = [];
92
+ for (const candidate of settingsFiles) {
93
+ const settings = readJson(candidate.file);
94
+ const plugins = settings?.enabledPlugins;
95
+ if (!plugins || typeof plugins !== 'object')
96
+ continue;
97
+ for (const [id, enabled] of Object.entries(plugins)) {
98
+ if (seen.has(id))
99
+ continue;
100
+ seen.add(id);
101
+ items.push({
102
+ id,
103
+ label: id,
104
+ source: candidate.source,
105
+ status: enabled === false ? 'disabled' : 'configured',
106
+ runtimeEnabled: enabled !== false,
107
+ });
108
+ }
109
+ }
110
+ return items;
111
+ }
112
+ async function discoverPluginsFromCli() {
113
+ try {
114
+ const output = execFileSync('claude', ['plugin', 'list', '--json'], {
115
+ encoding: 'utf-8',
116
+ timeout: 3000,
117
+ stdio: ['ignore', 'pipe', 'pipe'],
118
+ windowsHide: process.platform === 'win32',
119
+ });
120
+ const parsed = JSON.parse(output);
121
+ const list = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.installed) ? parsed.installed : [];
122
+ return list.map((entry) => {
123
+ const id = String(entry.id ?? entry.name ?? entry.pluginId ?? '').trim();
124
+ return id ? {
125
+ id,
126
+ label: String(entry.name ?? entry.label ?? id),
127
+ desc: typeof entry.description === 'string' ? entry.description : undefined,
128
+ source: 'plugin',
129
+ status: entry.enabled === false ? 'disabled' : 'installed',
130
+ runtimeEnabled: entry.enabled !== false,
131
+ } : null;
132
+ }).filter(Boolean);
133
+ }
134
+ catch {
135
+ return [];
136
+ }
137
+ }
138
+ export class ClaudeCapabilityProvider {
139
+ baseagent = 'claude';
140
+ getSupport(type) {
141
+ void type;
142
+ return { mode: 'inherit', canUpdate: true };
143
+ }
144
+ async discover(ctx, type) {
145
+ if (type === 'skill')
146
+ return discoverSkills(ctx.projectPath);
147
+ if (type === 'mcp')
148
+ return readMcpServers(ctx.projectPath);
149
+ const fromSettings = discoverPlugins(ctx.projectPath);
150
+ if (fromSettings.length > 0)
151
+ return fromSettings;
152
+ return await discoverPluginsFromCli();
153
+ }
154
+ }
@@ -0,0 +1,145 @@
1
+ /** Claude deployment metadata; the existing Host runner loads on first use. */
2
+ import { loadSchema } from '../../config/schema-registry.js';
3
+ import { probeClaudeAvailability } from './availability.js';
4
+ import { lazyAgentPlugin } from '../../core/baseagent/baseagent-plugin-descriptor.js';
5
+ import { ClaudeSessionFileAdapter } from './session-file-adapter.js';
6
+ import { ClaudeCapabilityProvider } from './capability-provider.js';
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import os from 'os';
10
+ import { readRuntimeEnvironmentVariable } from '../../config/runtime-env.js';
11
+ import { resolveProviderService } from '../../config/providers.js';
12
+ import { directInferencePair, directInferenceValue, nonEmptyString, normalizeRequestMetadata, normalizeStringMap, NativeConnectionIncompleteError, } from '../../core/baseagent/baseagent-config-shared.js';
13
+ export default {
14
+ kind: 'baseagent', apiVersion: 1, version: '1.0.0', hostApi: '^1.0.0', executionContract: 'host-runner-1',
15
+ name: 'claude', displayName: 'Claude Code', aliases: ['cc', 'claude-code', 'claude code', 'claudecode'],
16
+ configSchema: loadSchema('agent-config').raw.properties.baseagents.properties.claude,
17
+ probe: probeClaudeAvailability,
18
+ environments: ['linux', 'darwin', 'win32'].map(os => ({ os, probedWith: { cli: 'Existing Host adapter; live platform acceptance remains separate', at: '2026-11-18T00:00:00Z' } })),
19
+ declaredCapabilities: ['B12', 'C04', 'C07', 'C10', 'C11', 'C12', 'C25', 'C26', 'X01', 'X02', 'X03', 'X07'].map(id => ({
20
+ id, level: id.startsWith('X') && id !== 'X07' ? 'X' : 'C', implementation: 'adapted', availability: 'available', verification: 'verified',
21
+ ...(id === 'C12' ? { notes: 'Per-run maxOutputTokens (1..64000) through the CLI CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable. temperature, topP, stop and unknown parameters explicitly rejected; SDK/model limits still apply.' } : {}),
22
+ })),
23
+ createRunner: () => lazyAgentPlugin('claude', async () => new (await import('./runner.js')).ClaudeAgentPlugin()),
24
+ createSessionAdapter: () => new ClaudeSessionFileAdapter(),
25
+ createCapabilityProvider: () => new ClaudeCapabilityProvider(),
26
+ };
27
+ export const DEFAULT_CLAUDE_MODEL = 'sonnet';
28
+ /** Claude Code accepts both names; AUTH_TOKEN is kept first for compatibility. */
29
+ function resolveAnthropicApiKey(...values) {
30
+ return directInferenceValue(...values);
31
+ }
32
+ function loadClaudeSettings() {
33
+ try {
34
+ const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
35
+ if (fs.existsSync(settingsPath)) {
36
+ return JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
37
+ }
38
+ }
39
+ catch { }
40
+ return {};
41
+ }
42
+ export function resolveClaudeLegacyModelSelection(options = {}) {
43
+ const home = options.home ? path.resolve(options.home) : os.homedir();
44
+ const file = path.join(home, '.claude', 'settings.json');
45
+ let settings;
46
+ try {
47
+ const value = JSON.parse(fs.readFileSync(file, 'utf8'));
48
+ if (value && typeof value === 'object' && !Array.isArray(value))
49
+ settings = value;
50
+ }
51
+ catch {
52
+ // A missing or unreadable settings file leaves the historical default intact.
53
+ }
54
+ const model = nonEmptyString(settings?.model);
55
+ const effort = nonEmptyString(settings?.effortLevel);
56
+ return { model: model ?? DEFAULT_CLAUDE_MODEL,
57
+ ...(model ? { modelPath: file } : {}),
58
+ ...(effort ? { effort, effortPath: file } : {}) };
59
+ }
60
+ /**
61
+ * Resolve a complete credential/endpoint pair for direct Anthropic HTTP calls.
62
+ * A pair must come from one source so partial configuration cannot be mixed
63
+ * across Agent config, the process environment, and Claude Code settings.
64
+ */
65
+ export function resolveAnthropicDirectConfig(override, runtime) {
66
+ if (override?.provider !== undefined) {
67
+ const provider = resolveProviderService(override.provider, 'claude');
68
+ if (!provider.apiKey)
69
+ throw new Error(`Provider ${provider.providerId} has no API key`);
70
+ return { ...provider, apiKey: provider.apiKey };
71
+ }
72
+ const explicit = directInferencePair(override?.apiKey, override?.baseUrl);
73
+ if (explicit) {
74
+ return {
75
+ ...explicit,
76
+ ...normalizeRequestMetadata(override),
77
+ };
78
+ }
79
+ const environment = directInferencePair(directInferenceValue(readRuntimeEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', runtime?.agentAid, runtime?.projectPath).value, readRuntimeEnvironmentVariable('ANTHROPIC_API_KEY', runtime?.agentAid, runtime?.projectPath).value), readRuntimeEnvironmentVariable('ANTHROPIC_BASE_URL', runtime?.agentAid, runtime?.projectPath).value);
80
+ if (environment) {
81
+ return {
82
+ ...environment,
83
+ ...normalizeRequestMetadata(override),
84
+ };
85
+ }
86
+ const settings = loadClaudeSettings();
87
+ const settingsResolved = directInferencePair(directInferenceValue(settings.env?.ANTHROPIC_AUTH_TOKEN, settings.env?.ANTHROPIC_API_KEY), settings.env?.ANTHROPIC_BASE_URL);
88
+ return settingsResolved
89
+ ? {
90
+ ...settingsResolved,
91
+ ...normalizeRequestMetadata(override),
92
+ }
93
+ : undefined;
94
+ }
95
+ export function resolveAnthropicConfig(config, override, runtime) {
96
+ const settings = loadClaudeSettings();
97
+ const providerId = override?.provider ?? config.agents?.claude?.provider;
98
+ if (providerId !== undefined) {
99
+ const provider = resolveProviderService(providerId, 'claude');
100
+ if (!provider.apiKey)
101
+ throw new Error(`Provider ${providerId} has no API key`);
102
+ return {
103
+ apiKey: provider.apiKey,
104
+ baseUrl: provider.baseUrl,
105
+ providerId,
106
+ headers: provider.headers,
107
+ queryParams: provider.queryParams,
108
+ model: override?.model || config.agents?.claude?.model || settings.model || DEFAULT_CLAUDE_MODEL,
109
+ effort: override?.effort || config.agents?.claude?.effort || settings.effortLevel || undefined,
110
+ pathToClaudeCodeExecutable: override?.pathToClaudeCodeExecutable || config.agents?.claude?.pathToClaudeCodeExecutable,
111
+ };
112
+ }
113
+ const isPlaceholder = (v) => !v || v.includes('your-') || v.includes('placeholder');
114
+ const resolveGatewayReference = (value) => {
115
+ const name = value?.match(/^\$\{(ANTHROPIC_BASE_URL|ANTHROPIC_AUTH_TOKEN|ANTHROPIC_API_KEY)\}$/u)?.[1];
116
+ return name ? readRuntimeEnvironmentVariable(name, runtime?.agentAid, runtime?.projectPath).value : value;
117
+ };
118
+ const overrideApiKey = resolveGatewayReference(override?.apiKey);
119
+ const runtimeAuthToken = readRuntimeEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', runtime?.agentAid, runtime?.projectPath).value;
120
+ const runtimeApiKey = readRuntimeEnvironmentVariable('ANTHROPIC_API_KEY', runtime?.agentAid, runtime?.projectPath).value;
121
+ const apiKey = resolveAnthropicApiKey(isPlaceholder(overrideApiKey) ? undefined : overrideApiKey, undefined, runtimeAuthToken, runtimeApiKey, settings.env?.ANTHROPIC_AUTH_TOKEN, settings.env?.ANTHROPIC_API_KEY);
122
+ const isPlaceholderUrl = (v) => !v || v.includes('api.anthropic.com');
123
+ const overrideBaseUrlValue = resolveGatewayReference(override?.baseUrl);
124
+ const overrideBaseUrl = isPlaceholderUrl(overrideBaseUrlValue) ? undefined : overrideBaseUrlValue;
125
+ const runtimeBaseUrl = readRuntimeEnvironmentVariable('ANTHROPIC_BASE_URL', runtime?.agentAid, runtime?.projectPath).value;
126
+ const baseUrl = overrideBaseUrl
127
+ || runtimeBaseUrl
128
+ || settings.env?.ANTHROPIC_BASE_URL;
129
+ const headers = normalizeStringMap(override?.headers, 'headers');
130
+ const queryParams = normalizeStringMap(override?.queryParams, 'queryParams');
131
+ if (!apiKey)
132
+ throw new NativeConnectionIncompleteError('No API key found for Claude. Select a Provider via baseagents.claude.provider, or set env ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY.', { baseUrl, headers, queryParams });
133
+ const model = override?.model
134
+ || config.agents?.claude?.model
135
+ || settings.model
136
+ || DEFAULT_CLAUDE_MODEL;
137
+ const effort = override?.effort
138
+ || config.agents?.claude?.effort
139
+ || settings.effortLevel
140
+ || undefined;
141
+ const pickExec = (v) => (!v || v.includes('your-') || v.includes('placeholder')) ? undefined : v;
142
+ const pathToClaudeCodeExecutable = pickExec(override?.pathToClaudeCodeExecutable)
143
+ || pickExec(config.agents?.claude?.pathToClaudeCodeExecutable);
144
+ return { apiKey, baseUrl, headers, queryParams, model, effort, pathToClaudeCodeExecutable };
145
+ }