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
@@ -11,8 +11,8 @@
11
11
  */
12
12
  import fs from 'fs';
13
13
  import path from 'path';
14
- import { resolveRoot } from '../../paths.js';
15
- import { logger } from '../../utils/logger.js';
14
+ import { resolveRoot } from '../../../paths.js';
15
+ import { logger } from '../../../utils/logger.js';
16
16
  // ── 登记表工具 ──────────────────────────────────────────────────────────────
17
17
  function cleanupDir() {
18
18
  return path.join(resolveRoot(), 'data', 'session-cleanup');
@@ -1,5 +1,5 @@
1
1
  /**
2
- * background-session/types.ts — 独立后台会话的接口定义
2
+ * session/background/types.ts — 独立后台会话的接口定义
3
3
  *
4
4
  * 独立后台会话(bg-session)是由 daemon 内部逻辑主动拉起的 AI 会话,
5
5
  * 不属于用户交互,也不挂在 trigger 调度系统下。
@@ -1,11 +1,5 @@
1
1
  import fsPromises from 'fs/promises';
2
- import fs from 'node:fs';
3
- import { createHash, randomUUID } from 'node:crypto';
4
- import { createRequire } from 'node:module';
5
- import { isDeepStrictEqual } from 'node:util';
6
- import path from 'path';
7
2
  import { logger } from '../../utils/logger.js';
8
- import { withFileLock } from '../../utils/atomic-write.js';
9
3
  import { visitSessionHistoryLines } from './session-fs-store.js';
10
4
  /**
11
5
  * 检查会话文件健康度(接收完整文件路径)
@@ -55,269 +49,5 @@ export async function backupSessionFile(sessionFile) {
55
49
  logger.info(`[SessionFileHealth] Backup created: ${backupPath}`);
56
50
  return backupPath;
57
51
  }
58
- const requireFromHere = createRequire(import.meta.url);
59
- const repairHash = (bytes) => createHash('sha256').update(bytes).digest('hex');
60
- function syncRepairDirectory(directory) {
61
- if (process.platform === 'win32')
62
- return;
63
- const fd = fs.openSync(directory, 'r');
64
- try {
65
- fs.fsyncSync(fd);
66
- }
67
- finally {
68
- fs.closeSync(fd);
69
- }
70
- }
71
- function writeRepairSnapshot(file, content) {
72
- const fd = fs.openSync(file, 'wx', 0o600);
73
- try {
74
- fs.writeFileSync(fd, content);
75
- fs.fsyncSync(fd);
76
- }
77
- finally {
78
- fs.closeSync(fd);
79
- }
80
- syncRepairDirectory(path.dirname(file));
81
- }
82
- function codexMetadata(bytes, threadId) {
83
- const end = bytes.indexOf(10);
84
- const line = bytes.subarray(0, end < 0 ? bytes.length : end).toString('utf8');
85
- const event = JSON.parse(line);
86
- if (event.type !== 'session_meta' || !(event.payload?.id || event.payload?.session_id)
87
- || [event.payload.id, event.payload.session_id].some(id => id !== undefined && id !== threadId)
88
- || typeof event.payload.model_provider !== 'string' || !event.payload.model_provider) {
89
- throw new Error('Codex Provider repair rejected: session metadata does not match the bound thread');
90
- }
91
- return { line, end: end < 0 ? bytes.length : end, provider: event.payload.model_provider };
92
- }
93
- function rewriteCodexProvider(bytes, threadId, provider) {
94
- const header = codexMetadata(bytes, threadId);
95
- const property = /("model_provider"\s*:\s*)"(?:\\.|[^"\\])*"/g;
96
- const matches = [...header.line.matchAll(property)];
97
- if (matches.length !== 1)
98
- throw new Error('Codex Provider repair rejected: ambiguous Provider metadata');
99
- const line = header.line.replace(property, (_value, prefix) => prefix + JSON.stringify(provider));
100
- const expected = JSON.parse(header.line);
101
- expected.payload.model_provider = provider;
102
- if (!isDeepStrictEqual(JSON.parse(line), expected))
103
- throw new Error('Codex Provider repair changed unrelated metadata');
104
- return Buffer.concat([Buffer.from(line), bytes.subarray(header.end)]);
105
- }
106
- function readCodexProviderHeader(file, threadId) {
107
- const fd = fs.openSync(file, 'r');
108
- try {
109
- const chunks = [];
110
- let length = 0;
111
- while (length < 1024 * 1024) {
112
- const chunk = Buffer.alloc(16 * 1024);
113
- const read = fs.readSync(fd, chunk, 0, chunk.length, null);
114
- if (!read)
115
- return codexMetadata(Buffer.concat(chunks), threadId).provider;
116
- const end = chunk.subarray(0, read).indexOf(10);
117
- chunks.push(chunk.subarray(0, end < 0 ? read : end + 1));
118
- if (end >= 0)
119
- return codexMetadata(Buffer.concat(chunks), threadId).provider;
120
- length += read;
121
- }
122
- throw new Error('Codex Provider repair rejected: oversized session metadata');
123
- }
124
- finally {
125
- fs.closeSync(fd);
126
- }
127
- }
128
- function assertRepairFile(file, root) {
129
- const relative = path.relative(root, fs.realpathSync(file));
130
- const stat = fs.lstatSync(file);
131
- if (!relative || relative === '..' || relative.startsWith('..' + path.sep) || path.isAbsolute(relative)
132
- || !stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1) {
133
- throw new Error('Codex Provider repair rejected: unsafe storage path');
134
- }
135
- }
136
- /**
137
- * Change only the Provider of an existing Codex thread. Rollout bytes after the
138
- * header and the EC/backend IDs are preserved. The durable intent plus before
139
- * snapshot recover a crash between the filesystem rename and SQLite commit.
140
- * This is called only by the runner for an authoritative EC thread binding.
141
- */
142
- export async function repairCodexSessionProvider(options) {
143
- const { threadId, provider } = options;
144
- if (!/^evolcore_registry_[a-f0-9]{20}$/.test(provider)) {
145
- throw new Error('Codex Provider repair requires a resolved registry Provider');
146
- }
147
- const home = fs.realpathSync(options.codexHome);
148
- const rollout = path.resolve(options.sessionFile);
149
- const sessions = ['sessions', 'archived_sessions'].find(name => {
150
- const relative = path.relative(path.join(home, name), rollout);
151
- return relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative);
152
- });
153
- if (!sessions || !path.basename(rollout).endsWith(threadId + '.jsonl')) {
154
- throw new Error('Codex Provider repair rejected: rollout is outside Codex session storage');
155
- }
156
- assertRepairFile(rollout, fs.realpathSync(path.join(home, sessions)));
157
- const databaseName = fs.readdirSync(home).filter(name => /^state_\d+\.sqlite$/.test(name))
158
- .sort((a, b) => Number(b.match(/\d+/)[0]) - Number(a.match(/\d+/)[0]))[0];
159
- if (!databaseName)
160
- throw new Error('Codex Provider repair requires a supported thread index');
161
- const database = path.join(home, databaseName);
162
- assertRepairFile(database, home);
163
- const { DatabaseSync } = requireFromHere('node:sqlite');
164
- const directory = rollout + '.provider-repair';
165
- const journalFile = path.join(directory, 'intent.json');
166
- const assertIndexedRolloutPath = (indexedPath) => {
167
- const context = `thread=${threadId}, database=${JSON.stringify(database)},`
168
- + ` index=${JSON.stringify(indexedPath)}, rollout=${JSON.stringify(rollout)}`;
169
- let indexedRealPath;
170
- let rolloutRealPath;
171
- try {
172
- // Windows Codex stores verbatim paths (\\?\) in SQLite. Resolve both
173
- // through the filesystem instead of comparing their textual spelling.
174
- indexedRealPath = fs.realpathSync.native(indexedPath);
175
- rolloutRealPath = fs.realpathSync.native(rollout);
176
- }
177
- catch (cause) {
178
- throw new Error(`Codex thread index rollout path cannot be resolved (${context}): `
179
- + (cause instanceof Error ? cause.message : String(cause)), { cause });
180
- }
181
- if (indexedRealPath !== rolloutRealPath) {
182
- throw new Error(`Codex thread index rollout path mismatch (${context})`);
183
- }
184
- };
185
- const readIndex = () => {
186
- const db = new DatabaseSync(database, { readOnly: true });
187
- try {
188
- const row = db.prepare('SELECT model_provider, rollout_path FROM threads WHERE id = ?').get(threadId);
189
- if (!row)
190
- throw new Error(`Codex thread index row is missing (thread=${threadId})`);
191
- if (typeof row.model_provider !== 'string' || typeof row.rollout_path !== 'string') {
192
- throw new Error(`Codex thread index fields are invalid (thread=${threadId})`);
193
- }
194
- assertIndexedRolloutPath(row.rollout_path);
195
- return row;
196
- }
197
- finally {
198
- db.close();
199
- }
200
- };
201
- if (!fs.existsSync(journalFile) && readCodexProviderHeader(rollout, threadId) === provider
202
- && readIndex().model_provider === provider)
203
- return false;
204
- fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
205
- if (fs.lstatSync(directory).isSymbolicLink()
206
- || fs.realpathSync(directory) !== path.join(path.dirname(fs.realpathSync(rollout)), path.basename(directory))) {
207
- throw new Error('Codex Provider repair rejected: unsafe backup directory');
208
- }
209
- return withFileLock(path.join(directory, 'operation.lock'), async () => {
210
- const before = fs.readFileSync(rollout);
211
- const index = readIndex();
212
- const header = codexMetadata(before, threadId);
213
- if (!fs.existsSync(journalFile) && header.provider === provider && index.model_provider === provider)
214
- return false;
215
- await options.releaseThread();
216
- assertRepairFile(rollout, fs.realpathSync(path.join(home, sessions)));
217
- if (repairHash(fs.readFileSync(rollout)) !== repairHash(before)
218
- || !isDeepStrictEqual(readIndex(), index))
219
- throw new Error('Codex session changed while preparing Provider repair');
220
- const apply = (intent) => {
221
- const backupRoot = path.join(directory, path.basename(path.dirname(intent.backup)));
222
- if (intent.version !== 1 || intent.threadId !== threadId || intent.database !== database
223
- || intent.rollout !== rollout || typeof intent.indexedPath !== 'string'
224
- || intent.backup !== path.join(backupRoot, 'before.snapshot')
225
- || intent.next !== path.join(backupRoot, 'after.snapshot')
226
- || !/^evolcore_registry_[a-f0-9]{20}$/.test(intent.provider)) {
227
- throw new Error('Invalid Codex Provider repair journal');
228
- }
229
- assertIndexedRolloutPath(intent.indexedPath);
230
- assertRepairFile(intent.backup, directory);
231
- const original = fs.readFileSync(intent.backup);
232
- const replacement = rewriteCodexProvider(original, threadId, intent.provider);
233
- if (repairHash(original) !== intent.beforeHash || repairHash(replacement) !== intent.afterHash) {
234
- throw new Error('Codex Provider repair snapshot failed integrity verification');
235
- }
236
- const db = new DatabaseSync(database);
237
- let transaction = false;
238
- let replaced = false;
239
- try {
240
- db.exec('PRAGMA busy_timeout = 3000');
241
- db.exec('BEGIN IMMEDIATE');
242
- transaction = true;
243
- const row = db.prepare('SELECT model_provider, rollout_path FROM threads WHERE id = ?').get(threadId);
244
- const currentHash = repairHash(fs.readFileSync(rollout));
245
- if (!row || row.rollout_path !== intent.indexedPath
246
- || ![intent.previousProvider, intent.provider].includes(row.model_provider)
247
- || ![intent.beforeHash, intent.afterHash].includes(currentHash)) {
248
- throw new Error('Codex Provider repair conflicts with newer session data');
249
- }
250
- if (currentHash !== intent.afterHash) {
251
- if (fs.existsSync(intent.next)) {
252
- assertRepairFile(intent.next, directory);
253
- if (repairHash(fs.readFileSync(intent.next)) !== intent.afterHash)
254
- throw new Error('Invalid repair snapshot');
255
- }
256
- else
257
- writeRepairSnapshot(intent.next, replacement);
258
- fs.chmodSync(intent.next, fs.statSync(rollout).mode & 0o777);
259
- fs.renameSync(intent.next, rollout);
260
- replaced = true;
261
- syncRepairDirectory(path.dirname(rollout));
262
- }
263
- if (row.model_provider !== intent.provider) {
264
- const changed = db.prepare('UPDATE threads SET model_provider = ? WHERE id = ? AND model_provider = ?')
265
- .run(intent.provider, threadId, intent.previousProvider);
266
- if (changed.changes !== 1)
267
- throw new Error('Codex Provider repair index update conflicted');
268
- }
269
- db.exec('COMMIT');
270
- transaction = false;
271
- }
272
- catch (error) {
273
- if (transaction)
274
- db.exec('ROLLBACK');
275
- if (replaced && repairHash(fs.readFileSync(rollout)) === intent.afterHash) {
276
- const rollback = path.join(backupRoot, 'rollback-' + randomUUID() + '.snapshot');
277
- writeRepairSnapshot(rollback, original);
278
- fs.chmodSync(rollback, fs.statSync(rollout).mode & 0o777);
279
- fs.renameSync(rollback, rollout);
280
- syncRepairDirectory(path.dirname(rollout));
281
- }
282
- throw error;
283
- }
284
- finally {
285
- db.close();
286
- }
287
- fs.unlinkSync(journalFile);
288
- syncRepairDirectory(directory);
289
- };
290
- if (fs.existsSync(journalFile)) {
291
- assertRepairFile(journalFile, directory);
292
- apply(JSON.parse(fs.readFileSync(journalFile, 'utf8')));
293
- }
294
- const bytes = fs.readFileSync(rollout);
295
- const current = readIndex();
296
- const rolloutProvider = codexMetadata(bytes, threadId).provider;
297
- if (rolloutProvider !== provider || current.model_provider !== provider) {
298
- // Codex 0.164 can resume with a new Provider by updating only the index.
299
- // Allow its stale header to catch up when the index already names our
300
- // resolved Provider; unrelated disagreements still fail closed.
301
- if (rolloutProvider !== current.model_provider && current.model_provider !== provider) {
302
- throw new Error('Codex Provider repair rejected: rollout and index disagree'
303
- + ` (thread=${threadId}, rollout=${JSON.stringify(rolloutProvider)},`
304
- + ` index=${JSON.stringify(current.model_provider)}, target=${JSON.stringify(provider)})`);
305
- }
306
- const backupRoot = path.join(directory, randomUUID());
307
- fs.mkdirSync(backupRoot, { mode: 0o700 });
308
- const replacement = rewriteCodexProvider(bytes, threadId, provider);
309
- const intent = {
310
- version: 1, threadId, database, rollout, indexedPath: current.rollout_path,
311
- previousProvider: current.model_provider, provider,
312
- beforeHash: repairHash(bytes), afterHash: repairHash(replacement),
313
- backup: path.join(backupRoot, 'before.snapshot'), next: path.join(backupRoot, 'after.snapshot'),
314
- };
315
- writeRepairSnapshot(intent.backup, bytes);
316
- writeRepairSnapshot(intent.next, replacement);
317
- writeRepairSnapshot(journalFile, JSON.stringify(intent));
318
- apply(intent);
319
- }
320
- logger.info(`[SessionFileHealth] Codex Provider repaired: thread=${threadId} provider=${provider}`);
321
- return true;
322
- });
323
- }
52
+ // Compatibility for callers of the previous session repair import path.
53
+ export { repairCodexSessionProvider } from '../../agents/codex/session-file-adapter.js';
@@ -3,7 +3,7 @@ import path from 'path';
3
3
  import { ConfigTarget, mutateConfig, read as readConfig } from '../../config/config-manager.js';
4
4
  import { formatPeerKey } from '../relation/peer-identity.js';
5
5
  import { isMainSession, isTopicSession, sessionTopicThreadId } from '../thread/topic-id.js';
6
- import { isSystemControlChannel } from '../system-channels.js';
6
+ import { isSystemControlChannel } from '../channel/system-channels.js';
7
7
  import { logger } from '../../utils/logger.js';
8
8
  import { atomicWriteJson } from './session-fs-store.js';
9
9
  import { createRootCausation } from '../causation/context.js';
@@ -7,9 +7,11 @@ import { readRunnerEventSummary } from './runner-event-summary.js';
7
7
  import { isInternalInjectedUserMessage, isToolResultMessage } from './session-transcript.js';
8
8
  import { chatDirPath, generateSessionId, formatTimestamp, atomicWriteJson, atomicWriteText, appendJsonl, appendJsonlDurable, fsyncJsonlFile, readJsonFile, readLastJsonlLine, readLastJsonlLineStrict, readAllJsonlLines, scanChatDirs, scanMetaFiles, ensureChatDir, readThreadIndex, writeThreadIndex, compactJsonlTail, SESSION_META_COMPACT_POLICY, readLastJsonlLineAsync, } from './session-fs-store.js';
9
9
  import { sessionToFile, fileToSession, formatSessionKey, DEFAULT_THREAD_ID, normalizeTopicStatus, } from './session-mapper.js';
10
- import { tryParseChannelKey } from '../channel-loader.js';
10
+ import { tryParseChannelKey } from '../channel/channel-loader.js';
11
11
  import { isMainSession, isMainSessionThreadId, isTopicSession, isTopicThreadId, mainTopicPeer, safeFormatMainTopicId, sessionLocalTopicId, sessionTopicThreadId, } from '../thread/topic-id.js';
12
- import { isSystemControlChannel } from '../system-channels.js';
12
+ import { isSystemControlChannel } from '../channel/system-channels.js';
13
+ import { sameThreadPeer } from '../thread/topic-id.js';
14
+ import { sanitizeIndexEntry } from '../thread/types.js';
13
15
  import path from 'path';
14
16
  import fs from 'fs';
15
17
  import os from 'os';
@@ -288,8 +290,17 @@ export class SessionManager {
288
290
  this.identityResolver = resolver;
289
291
  }
290
292
  registerFileAdapter(adapter) {
293
+ const previous = this.fileAdapters.get(adapter.baseagent);
291
294
  this.fileAdapters.set(adapter.baseagent, adapter);
292
295
  logger.debug(`[SessionManager] Registered file adapter: ${adapter.baseagent}`);
296
+ return () => {
297
+ if (this.fileAdapters.get(adapter.baseagent) !== adapter)
298
+ return;
299
+ if (previous)
300
+ this.fileAdapters.set(adapter.baseagent, previous);
301
+ else
302
+ this.fileAdapters.delete(adapter.baseagent);
303
+ };
293
304
  }
294
305
  setCapsuleTranscriptReader(reader) {
295
306
  this.capsuleTranscriptReader = reader;
@@ -1719,6 +1730,10 @@ export class SessionManager {
1719
1730
  ? normalizeBackendSessionId(existing.agentSessionId)
1720
1731
  : this.validateSessionFile(existing);
1721
1732
  let mutated = false;
1733
+ if (!existing.projectPath?.trim() && defaultProjectPath.trim()) {
1734
+ existing.projectPath = path.resolve(defaultProjectPath);
1735
+ mutated = true;
1736
+ }
1722
1737
  if (metadata) {
1723
1738
  const creatorPeerId = existing.metadata?.peerId;
1724
1739
  existing.metadata = { ...(existing.metadata || {}), ...topicMetadata };
@@ -1833,24 +1848,29 @@ export class SessionManager {
1833
1848
  try {
1834
1849
  const indexPath = agentThreadIndexPath(input.selfAid);
1835
1850
  const raw = readJsonFile(indexPath);
1836
- const index = raw && Array.isArray(raw.threads) ? raw : { version: 1, threads: [] };
1851
+ // 新索引按当前 schema 版本写(2:条目已归一)。读到旧版本时由
1852
+ // ThreadService.readIndex 负责迁移,这里只保证新建时不是旧版本。
1853
+ const index = raw && Array.isArray(raw.threads) ? raw : { version: 2, threads: [] };
1837
1854
  const existing = index.threads.find((t) => t.threadId === input.threadId
1838
- && String(t.peer ?? '').toLowerCase() === input.peer.toLowerCase());
1855
+ && (t.channelType ?? 'aun') === input.channelType && sameThreadPeer(t.peer, input.peer, input.channelType));
1839
1856
  if (existing) {
1840
1857
  existing.sessionId = existing.sessionId || input.sessionId;
1841
1858
  return;
1842
1859
  }
1843
- index.threads.push({
1860
+ const candidate = sanitizeIndexEntry({
1844
1861
  threadId: input.threadId,
1845
1862
  sessionId: input.sessionId,
1846
1863
  peer: input.peer,
1847
1864
  channelType: input.channelType,
1848
1865
  peerKind: input.peerKind,
1849
1866
  name: input.name || '话题会话',
1850
- topicStatus: input.topicStatus,
1867
+ topicStatus: normalizeTopicStatus(input.topicStatus),
1851
1868
  createdAt: input.now,
1852
1869
  lastActiveAt: input.now,
1853
1870
  });
1871
+ if (!candidate.ok)
1872
+ return;
1873
+ index.threads.push(candidate.entry);
1854
1874
  ensureDir(path.dirname(indexPath));
1855
1875
  atomicWriteJson(indexPath, index);
1856
1876
  }
@@ -2085,6 +2105,18 @@ export class SessionManager {
2085
2105
  return undefined;
2086
2106
  return this.readMetaLatest(found.metaPath);
2087
2107
  }
2108
+ async ensureSessionProjectPath(sessionId, fallbackProjectPath) {
2109
+ if (typeof fallbackProjectPath !== 'string' || !fallbackProjectPath.trim())
2110
+ return undefined;
2111
+ const session = await this.getSessionById(sessionId);
2112
+ if (!session)
2113
+ return undefined;
2114
+ if (session.projectPath?.trim())
2115
+ return path.resolve(session.projectPath);
2116
+ session.projectPath = path.resolve(fallbackProjectPath);
2117
+ this.persistSession(session, 'none');
2118
+ return session.projectPath;
2119
+ }
2088
2120
  async getActiveSession(channel, channelId) {
2089
2121
  return this.readActive(channel, channelId);
2090
2122
  }
@@ -2230,14 +2262,21 @@ export class SessionManager {
2230
2262
  * 入站的 `closed → active` 回退只经过这里),因此由本方法兜底同步索引,
2231
2263
  * 否则列表会一直显示旧状态直到 `rebuild-index`。
2232
2264
  */
2233
- async setTopicStatus(sessionId, status) {
2265
+ async setTopicStatus(sessionId, status, updatedAt) {
2234
2266
  const normalized = normalizeTopicStatus(status);
2235
2267
  const loaded = this.loadSessionForUpdate(sessionId);
2236
2268
  if (!loaded || !isTopicSession(loaded.current))
2237
2269
  return false;
2270
+ // 版本号:调用方(`ThreadService.statusThread`)会传入与索引同一次写入的版本,
2271
+ // 让两侧版本一致;只经过本方法的路径(菜单 action、入站回退)自己生成一个。
2272
+ const previous = Number(loaded.current.metadata?.topicStatusUpdatedAt ?? 0);
2273
+ if (updatedAt !== undefined && (!Number.isSafeInteger(updatedAt) || updatedAt <= previous))
2274
+ return false;
2275
+ const version = updatedAt ?? Math.max(Date.now(), previous + 1);
2238
2276
  loaded.current.topicStatus = normalized;
2277
+ loaded.current.metadata = { ...(loaded.current.metadata ?? {}), topicStatusUpdatedAt: version };
2239
2278
  this.persistSession(loaded.current, 'sync', { topicMutation: true });
2240
- this.syncTopicStatusToAgentIndex(loaded.current, normalized);
2279
+ this.syncTopicStatusToAgentIndex(loaded.current, normalized, version);
2241
2280
  return true;
2242
2281
  }
2243
2282
  /**
@@ -2247,7 +2286,7 @@ export class SessionManager {
2247
2286
  * 那里会补 name / peerKind / createdAt 等字段;这里若凭空插入条目,会得到一条
2248
2287
  * 缺字段的残条目。找不到条目(索引尚未建立)时静默跳过,等 rebuild-index 补齐。
2249
2288
  */
2250
- syncTopicStatusToAgentIndex(session, status) {
2289
+ syncTopicStatusToAgentIndex(session, status, updatedAt) {
2251
2290
  const selfAid = session.selfAID;
2252
2291
  const threadId = sessionTopicThreadId(session);
2253
2292
  // 与 upsertAgentThreadIndex 同口径:主会话、daemon 内部会话不是真实话题。
@@ -2266,11 +2305,25 @@ export class SessionManager {
2266
2305
  if (!raw || !Array.isArray(raw.threads))
2267
2306
  return;
2268
2307
  const entry = raw.threads.find((t) => t.threadId === threadId
2269
- && String(t.peer ?? '').toLowerCase() === peer.toLowerCase());
2270
- if (!entry || entry.topicStatus === status)
2308
+ && (t.channelType ?? 'aun') === (session.channelType ?? 'aun')
2309
+ && sameThreadPeer(t.peer, peer, session.channelType ?? 'aun'));
2310
+ if (!entry)
2311
+ return;
2312
+ // 版本闸门:索引里已有更新的状态时不许回写。没有这道闸,一份持有旧 Session
2313
+ // 对象的调用方(跨 await、或菜单侧并发的入站回退)会把刚归档的话题改回 active。
2314
+ const incoming = Number(updatedAt ?? 0) || Date.now();
2315
+ const existing = Number(entry.topicStatusUpdatedAt ?? 0);
2316
+ if (existing >= incoming)
2317
+ return;
2318
+ if (entry.topicStatus === status && existing === incoming)
2271
2319
  return;
2320
+ const checked = sanitizeIndexEntry({ ...entry, topicStatus: status });
2321
+ if (!checked.ok)
2322
+ return;
2323
+ Object.assign(entry, checked.entry);
2272
2324
  entry.topicStatus = status;
2273
- entry.lastActiveAt = Date.now();
2325
+ entry.topicStatusUpdatedAt = incoming;
2326
+ entry.lastActiveAt = Math.max(Number(entry.lastActiveAt ?? 0), incoming);
2274
2327
  atomicWriteJson(indexPath, raw);
2275
2328
  }
2276
2329
  catch (error) {
@@ -2710,6 +2763,17 @@ export class SessionManager {
2710
2763
  }
2711
2764
  return sessionIds;
2712
2765
  }
2766
+ findBoundSessionByAgentSessionId(agentSessionId, baseagent, selfAid) {
2767
+ const matches = [];
2768
+ for (const { dirPath } of scanChatDirs(this.sessionsDir)) {
2769
+ for (const session of this.findAllSessionsInChat(dirPath, true)) {
2770
+ if (session.selfAID !== selfAid || session.baseagent !== baseagent || session.agentSessionId !== agentSessionId)
2771
+ continue;
2772
+ matches.push(session);
2773
+ }
2774
+ }
2775
+ return matches.sort((a, b) => b.updatedAt - a.updatedAt)[0];
2776
+ }
2713
2777
  checkSessionFileExists(projectPath, agentSessionId, baseagent, agentAid) {
2714
2778
  const adapter = this.getFileAdapter(baseagent);
2715
2779
  if (!adapter)
@@ -16,6 +16,22 @@ export function normalizeTopicStatus(value) {
16
16
  return 'active';
17
17
  throw new Error('topicStatus 必须是 active、closed 或 archived');
18
18
  }
19
+ /**
20
+ * 读取侧口径:不认识的旧值一律读作 `active`,不抛错。
21
+ *
22
+ * 与 `normalizeTopicStatus` 的区别只在未知值:那个用于**写入**(用户输入要拒绝),
23
+ * 这个用于**读取**(历史数据要能读出来)。索引与 session 文件里都存着旧版本的
24
+ * `pending` / `in_progress` / `completed`,直接比较原始值会把"同一个状态"判成
25
+ * stale,或者在 `--status active` 过滤里漏掉这些条目。
26
+ */
27
+ export function readTopicStatusLenient(value) {
28
+ try {
29
+ return normalizeTopicStatus(value);
30
+ }
31
+ catch {
32
+ return 'active';
33
+ }
34
+ }
19
35
  /** Resolve the public archived query flag while keeping omitted values backward compatible. */
20
36
  export function resolveTopicArchiveFilter(value) {
21
37
  if (value === undefined || value === false)