evolcore 0.0.50 → 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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,834 @@
1
+ /**
2
+ * Codex SessionFileAdapter
3
+ *
4
+ * Reads Codex thread data from ~/.codex/state_*.sqlite (read-only)
5
+ * and Codex rollout JSONL files for detailed session info.
6
+ *
7
+ * `node:sqlite` 是 Node 22.5+ 的实验性内置模块。低版本 Node 上懒加载会失败,
8
+ * adapter 自动降级到只读 rollout JSONL —— `checkExists/getFileInfo/readFirstMessage/
9
+ * readLastUserMessage` 仍可工作;`scanCliSessions/listSdkSessions` 因依赖 DB 索引
10
+ * 会返回空数组。
11
+ */
12
+ import { createRequire } from 'module';
13
+ import { createHash, randomUUID } from 'node:crypto';
14
+ import { isDeepStrictEqual } from 'node:util';
15
+ import { withFileLock } from '../../utils/atomic-write.js';
16
+ import { buildCliSessionPreview, isEvolcoreRoutedMessage, sanitizeSessionTitle, } from '../../core/session/session-title.js';
17
+ import { logger } from '../../utils/logger.js';
18
+ import path from 'path';
19
+ import fs from 'fs';
20
+ import os from 'os';
21
+ import { visitSessionHistory, visitSessionHistoryLines } from '../../core/session/session-fs-store.js';
22
+ const requireFromHere = createRequire(import.meta.url);
23
+ const repairHash = (bytes) => createHash('sha256').update(bytes).digest('hex');
24
+ function syncRepairDirectory(directory) {
25
+ if (process.platform === 'win32')
26
+ return;
27
+ const fd = fs.openSync(directory, 'r');
28
+ try {
29
+ fs.fsyncSync(fd);
30
+ }
31
+ finally {
32
+ fs.closeSync(fd);
33
+ }
34
+ }
35
+ function writeRepairSnapshot(file, content) {
36
+ const fd = fs.openSync(file, 'wx', 0o600);
37
+ try {
38
+ fs.writeFileSync(fd, content);
39
+ fs.fsyncSync(fd);
40
+ }
41
+ finally {
42
+ fs.closeSync(fd);
43
+ }
44
+ syncRepairDirectory(path.dirname(file));
45
+ }
46
+ function codexMetadata(bytes, threadId) {
47
+ const end = bytes.indexOf(10);
48
+ const line = bytes.subarray(0, end < 0 ? bytes.length : end).toString('utf8');
49
+ const event = JSON.parse(line);
50
+ if (event.type !== 'session_meta' || !(event.payload?.id || event.payload?.session_id)
51
+ || [event.payload.id, event.payload.session_id].some(id => id !== undefined && id !== threadId)
52
+ || typeof event.payload.model_provider !== 'string' || !event.payload.model_provider) {
53
+ throw new Error('Codex Provider repair rejected: session metadata does not match the bound thread');
54
+ }
55
+ return { line, end: end < 0 ? bytes.length : end, provider: event.payload.model_provider };
56
+ }
57
+ function rewriteCodexProvider(bytes, threadId, provider) {
58
+ const header = codexMetadata(bytes, threadId);
59
+ const property = /("model_provider"\s*:\s*)"(?:\\.|[^"\\])*"/g;
60
+ const matches = [...header.line.matchAll(property)];
61
+ if (matches.length !== 1)
62
+ throw new Error('Codex Provider repair rejected: ambiguous Provider metadata');
63
+ const line = header.line.replace(property, (_value, prefix) => prefix + JSON.stringify(provider));
64
+ const expected = JSON.parse(header.line);
65
+ expected.payload.model_provider = provider;
66
+ if (!isDeepStrictEqual(JSON.parse(line), expected))
67
+ throw new Error('Codex Provider repair changed unrelated metadata');
68
+ return Buffer.concat([Buffer.from(line), bytes.subarray(header.end)]);
69
+ }
70
+ function readCodexProviderHeader(file, threadId) {
71
+ const fd = fs.openSync(file, 'r');
72
+ try {
73
+ const chunks = [];
74
+ let length = 0;
75
+ while (length < 1024 * 1024) {
76
+ const chunk = Buffer.alloc(16 * 1024);
77
+ const read = fs.readSync(fd, chunk, 0, chunk.length, null);
78
+ if (!read)
79
+ return codexMetadata(Buffer.concat(chunks), threadId).provider;
80
+ const end = chunk.subarray(0, read).indexOf(10);
81
+ chunks.push(chunk.subarray(0, end < 0 ? read : end + 1));
82
+ if (end >= 0)
83
+ return codexMetadata(Buffer.concat(chunks), threadId).provider;
84
+ length += read;
85
+ }
86
+ throw new Error('Codex Provider repair rejected: oversized session metadata');
87
+ }
88
+ finally {
89
+ fs.closeSync(fd);
90
+ }
91
+ }
92
+ function assertRepairFile(file, root) {
93
+ const relative = path.relative(root, fs.realpathSync(file));
94
+ const stat = fs.lstatSync(file);
95
+ if (!relative || relative === '..' || relative.startsWith('..' + path.sep) || path.isAbsolute(relative)
96
+ || !stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1) {
97
+ throw new Error('Codex Provider repair rejected: unsafe storage path');
98
+ }
99
+ }
100
+ /**
101
+ * Change only the Provider of an existing Codex thread. Rollout bytes after the
102
+ * header and the EC/backend IDs are preserved. The durable intent plus before
103
+ * snapshot recover a crash between the filesystem rename and SQLite commit.
104
+ * This is called only by the runner for an authoritative EC thread binding.
105
+ */
106
+ export async function repairCodexSessionProvider(options) {
107
+ const { threadId, provider } = options;
108
+ if (!/^evolcore_registry_[a-f0-9]{20}$/.test(provider)) {
109
+ throw new Error('Codex Provider repair requires a resolved registry Provider');
110
+ }
111
+ const home = fs.realpathSync(options.codexHome);
112
+ const rollout = path.resolve(options.sessionFile);
113
+ const sessions = ['sessions', 'archived_sessions'].find(name => {
114
+ const relative = path.relative(path.join(home, name), rollout);
115
+ return relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative);
116
+ });
117
+ if (!sessions || !path.basename(rollout).endsWith(threadId + '.jsonl')) {
118
+ throw new Error('Codex Provider repair rejected: rollout is outside Codex session storage');
119
+ }
120
+ assertRepairFile(rollout, fs.realpathSync(path.join(home, sessions)));
121
+ const databaseName = fs.readdirSync(home).filter(name => /^state_\d+\.sqlite$/.test(name))
122
+ .sort((a, b) => Number(b.match(/\d+/)[0]) - Number(a.match(/\d+/)[0]))[0];
123
+ if (!databaseName)
124
+ throw new Error('Codex Provider repair requires a supported thread index');
125
+ const database = path.join(home, databaseName);
126
+ assertRepairFile(database, home);
127
+ const { DatabaseSync } = requireFromHere('node:sqlite');
128
+ const directory = rollout + '.provider-repair';
129
+ const journalFile = path.join(directory, 'intent.json');
130
+ const assertIndexedRolloutPath = (indexedPath) => {
131
+ const context = `thread=${threadId}, database=${JSON.stringify(database)},`
132
+ + ` index=${JSON.stringify(indexedPath)}, rollout=${JSON.stringify(rollout)}`;
133
+ let indexedRealPath;
134
+ let rolloutRealPath;
135
+ try {
136
+ // Windows Codex stores verbatim paths (\\?\) in SQLite. Resolve both
137
+ // through the filesystem instead of comparing their textual spelling.
138
+ indexedRealPath = fs.realpathSync.native(indexedPath);
139
+ rolloutRealPath = fs.realpathSync.native(rollout);
140
+ }
141
+ catch (cause) {
142
+ throw new Error(`Codex thread index rollout path cannot be resolved (${context}): `
143
+ + (cause instanceof Error ? cause.message : String(cause)), { cause });
144
+ }
145
+ if (indexedRealPath !== rolloutRealPath) {
146
+ throw new Error(`Codex thread index rollout path mismatch (${context})`);
147
+ }
148
+ };
149
+ const readIndex = () => {
150
+ const db = new DatabaseSync(database, { readOnly: true });
151
+ try {
152
+ const row = db.prepare('SELECT model_provider, rollout_path FROM threads WHERE id = ?').get(threadId);
153
+ if (!row)
154
+ throw new Error(`Codex thread index row is missing (thread=${threadId})`);
155
+ if (typeof row.model_provider !== 'string' || typeof row.rollout_path !== 'string') {
156
+ throw new Error(`Codex thread index fields are invalid (thread=${threadId})`);
157
+ }
158
+ assertIndexedRolloutPath(row.rollout_path);
159
+ return row;
160
+ }
161
+ finally {
162
+ db.close();
163
+ }
164
+ };
165
+ if (!fs.existsSync(journalFile) && readCodexProviderHeader(rollout, threadId) === provider
166
+ && readIndex().model_provider === provider)
167
+ return false;
168
+ fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
169
+ if (fs.lstatSync(directory).isSymbolicLink()
170
+ || fs.realpathSync(directory) !== path.join(path.dirname(fs.realpathSync(rollout)), path.basename(directory))) {
171
+ throw new Error('Codex Provider repair rejected: unsafe backup directory');
172
+ }
173
+ return withFileLock(path.join(directory, 'operation.lock'), async () => {
174
+ const before = fs.readFileSync(rollout);
175
+ const index = readIndex();
176
+ const header = codexMetadata(before, threadId);
177
+ if (!fs.existsSync(journalFile) && header.provider === provider && index.model_provider === provider)
178
+ return false;
179
+ await options.releaseThread();
180
+ assertRepairFile(rollout, fs.realpathSync(path.join(home, sessions)));
181
+ if (repairHash(fs.readFileSync(rollout)) !== repairHash(before)
182
+ || !isDeepStrictEqual(readIndex(), index))
183
+ throw new Error('Codex session changed while preparing Provider repair');
184
+ const apply = (intent) => {
185
+ const backupRoot = path.join(directory, path.basename(path.dirname(intent.backup)));
186
+ if (intent.version !== 1 || intent.threadId !== threadId || intent.database !== database
187
+ || intent.rollout !== rollout || typeof intent.indexedPath !== 'string'
188
+ || intent.backup !== path.join(backupRoot, 'before.snapshot')
189
+ || intent.next !== path.join(backupRoot, 'after.snapshot')
190
+ || !/^evolcore_registry_[a-f0-9]{20}$/.test(intent.provider)) {
191
+ throw new Error('Invalid Codex Provider repair journal');
192
+ }
193
+ assertIndexedRolloutPath(intent.indexedPath);
194
+ assertRepairFile(intent.backup, directory);
195
+ const original = fs.readFileSync(intent.backup);
196
+ const replacement = rewriteCodexProvider(original, threadId, intent.provider);
197
+ if (repairHash(original) !== intent.beforeHash || repairHash(replacement) !== intent.afterHash) {
198
+ throw new Error('Codex Provider repair snapshot failed integrity verification');
199
+ }
200
+ const db = new DatabaseSync(database);
201
+ let transaction = false;
202
+ let replaced = false;
203
+ try {
204
+ db.exec('PRAGMA busy_timeout = 3000');
205
+ db.exec('BEGIN IMMEDIATE');
206
+ transaction = true;
207
+ const row = db.prepare('SELECT model_provider, rollout_path FROM threads WHERE id = ?').get(threadId);
208
+ const currentHash = repairHash(fs.readFileSync(rollout));
209
+ if (!row || row.rollout_path !== intent.indexedPath
210
+ || ![intent.previousProvider, intent.provider].includes(row.model_provider)
211
+ || ![intent.beforeHash, intent.afterHash].includes(currentHash)) {
212
+ throw new Error('Codex Provider repair conflicts with newer session data');
213
+ }
214
+ if (currentHash !== intent.afterHash) {
215
+ if (fs.existsSync(intent.next)) {
216
+ assertRepairFile(intent.next, directory);
217
+ if (repairHash(fs.readFileSync(intent.next)) !== intent.afterHash)
218
+ throw new Error('Invalid repair snapshot');
219
+ }
220
+ else
221
+ writeRepairSnapshot(intent.next, replacement);
222
+ fs.chmodSync(intent.next, fs.statSync(rollout).mode & 0o777);
223
+ fs.renameSync(intent.next, rollout);
224
+ replaced = true;
225
+ syncRepairDirectory(path.dirname(rollout));
226
+ }
227
+ if (row.model_provider !== intent.provider) {
228
+ const changed = db.prepare('UPDATE threads SET model_provider = ? WHERE id = ? AND model_provider = ?')
229
+ .run(intent.provider, threadId, intent.previousProvider);
230
+ if (changed.changes !== 1)
231
+ throw new Error('Codex Provider repair index update conflicted');
232
+ }
233
+ db.exec('COMMIT');
234
+ transaction = false;
235
+ }
236
+ catch (error) {
237
+ if (transaction)
238
+ db.exec('ROLLBACK');
239
+ if (replaced && repairHash(fs.readFileSync(rollout)) === intent.afterHash) {
240
+ const rollback = path.join(backupRoot, 'rollback-' + randomUUID() + '.snapshot');
241
+ writeRepairSnapshot(rollback, original);
242
+ fs.chmodSync(rollback, fs.statSync(rollout).mode & 0o777);
243
+ fs.renameSync(rollback, rollout);
244
+ syncRepairDirectory(path.dirname(rollout));
245
+ }
246
+ throw error;
247
+ }
248
+ finally {
249
+ db.close();
250
+ }
251
+ fs.unlinkSync(journalFile);
252
+ syncRepairDirectory(directory);
253
+ };
254
+ if (fs.existsSync(journalFile)) {
255
+ assertRepairFile(journalFile, directory);
256
+ apply(JSON.parse(fs.readFileSync(journalFile, 'utf8')));
257
+ }
258
+ const bytes = fs.readFileSync(rollout);
259
+ const current = readIndex();
260
+ const rolloutProvider = codexMetadata(bytes, threadId).provider;
261
+ if (rolloutProvider !== provider || current.model_provider !== provider) {
262
+ // Codex 0.164 can resume with a new Provider by updating only the index.
263
+ // Allow its stale header to catch up when the index already names our
264
+ // resolved Provider; unrelated disagreements still fail closed.
265
+ if (rolloutProvider !== current.model_provider && current.model_provider !== provider) {
266
+ throw new Error('Codex Provider repair rejected: rollout and index disagree'
267
+ + ` (thread=${threadId}, rollout=${JSON.stringify(rolloutProvider)},`
268
+ + ` index=${JSON.stringify(current.model_provider)}, target=${JSON.stringify(provider)})`);
269
+ }
270
+ const backupRoot = path.join(directory, randomUUID());
271
+ fs.mkdirSync(backupRoot, { mode: 0o700 });
272
+ const replacement = rewriteCodexProvider(bytes, threadId, provider);
273
+ const intent = {
274
+ version: 1, threadId, database, rollout, indexedPath: current.rollout_path,
275
+ previousProvider: current.model_provider, provider,
276
+ beforeHash: repairHash(bytes), afterHash: repairHash(replacement),
277
+ backup: path.join(backupRoot, 'before.snapshot'), next: path.join(backupRoot, 'after.snapshot'),
278
+ };
279
+ writeRepairSnapshot(intent.backup, bytes);
280
+ writeRepairSnapshot(intent.next, replacement);
281
+ writeRepairSnapshot(journalFile, JSON.stringify(intent));
282
+ apply(intent);
283
+ }
284
+ logger.info(`[SessionFileHealth] Codex Provider repaired: thread=${threadId} provider=${provider}`);
285
+ return true;
286
+ });
287
+ }
288
+ let sqliteModule; // undefined = not tried, null = unavailable
289
+ export const sanitizeCodexThreadTitle = sanitizeSessionTitle;
290
+ const CODEX_INTERACTIVE_SOURCES = new Set(['cli', 'vscode']);
291
+ function loadSqlite() {
292
+ if (sqliteModule !== undefined)
293
+ return sqliteModule;
294
+ try {
295
+ sqliteModule = requireFromHere('node:sqlite');
296
+ }
297
+ catch (e) {
298
+ logger.warn(`[CodexAdapter] node:sqlite unavailable (Node < 22.5?): ${e?.message || e}. Codex session listing falls back to rollout JSONL.`);
299
+ sqliteModule = null;
300
+ }
301
+ return sqliteModule;
302
+ }
303
+ export class CodexSessionFileAdapter {
304
+ codexHome;
305
+ baseagent = 'codex';
306
+ db = null;
307
+ dbInitialized = false;
308
+ rolloutPathCache = new Map();
309
+ rolloutFilesScan;
310
+ constructor(codexHome = path.join(os.homedir(), '.codex')) {
311
+ this.codexHome = codexHome;
312
+ }
313
+ /**
314
+ * 动态发现最新的 state_*.sqlite 文件
315
+ * Codex 使用 sqlx 迁移,DB 文件名含版本号(state_5, state_6, ...)
316
+ */
317
+ resolveStateDbPath() {
318
+ const codexHome = this.codexHome;
319
+ if (!fs.existsSync(codexHome))
320
+ return null;
321
+ try {
322
+ const files = fs.readdirSync(codexHome)
323
+ .filter(f => /^state_\d+\.sqlite$/.test(f))
324
+ .sort((a, b) => {
325
+ const va = parseInt(a.match(/state_(\d+)/)?.[1] || '0');
326
+ const vb = parseInt(b.match(/state_(\d+)/)?.[1] || '0');
327
+ return vb - va;
328
+ });
329
+ return files.length > 0 ? path.join(codexHome, files[0]) : null;
330
+ }
331
+ catch {
332
+ return null;
333
+ }
334
+ }
335
+ getDb() {
336
+ if (this.dbInitialized)
337
+ return this.db;
338
+ this.dbInitialized = true;
339
+ const sqlite = loadSqlite();
340
+ if (!sqlite)
341
+ return null;
342
+ const dbPath = this.resolveStateDbPath();
343
+ if (!dbPath)
344
+ return null;
345
+ try {
346
+ this.db = new sqlite.DatabaseSync(dbPath, { readOnly: true });
347
+ logger.debug(`[CodexAdapter] Opened state DB: ${dbPath}`);
348
+ }
349
+ catch (error) {
350
+ logger.warn(`[CodexAdapter] Failed to open state DB: ${dbPath}`, error);
351
+ this.db = null;
352
+ }
353
+ return this.db;
354
+ }
355
+ checkExists(projectPath, agentSessionId) {
356
+ // 1. 优先查 state_*.sqlite(覆盖 CLI 创建的线程)
357
+ const db = this.getDb();
358
+ if (db) {
359
+ try {
360
+ const row = db.prepare('SELECT 1 FROM threads WHERE id = ? AND archived = 0').get(agentSessionId);
361
+ if (row)
362
+ return true;
363
+ }
364
+ catch (error) {
365
+ logger.warn(`[CodexAdapter] checkExists DB query failed:`, error);
366
+ }
367
+ }
368
+ // 2. Fallback: 扫 ~/.codex/sessions/ 下的 rollout JSONL
369
+ // SDK 创建的 thread 不写 state_*.sqlite,但会持久化到 sessions 目录
370
+ return !!this.findRolloutFile(agentSessionId);
371
+ }
372
+ /**
373
+ * A row in state_*.sqlite is created before the first turn is necessarily
374
+ * recoverable. Require the rollout to contain both its own session metadata
375
+ * and the exact turn_context before EvolCore publishes a new binding.
376
+ */
377
+ async checkTurnPersisted(_projectPath, agentSessionId, turnId, _agentAid) {
378
+ const normalizedSessionId = agentSessionId.trim();
379
+ const normalizedTurnId = turnId.trim();
380
+ if (!normalizedSessionId || !normalizedTurnId)
381
+ return false;
382
+ let preferred;
383
+ const db = this.getDb();
384
+ if (db) {
385
+ try {
386
+ const row = db.prepare('SELECT rollout_path FROM threads WHERE id = ? AND archived = 0').get(normalizedSessionId);
387
+ preferred = row?.rollout_path;
388
+ }
389
+ catch (error) {
390
+ logger.warn('[CodexAdapter] checkTurnPersisted DB query failed:', error);
391
+ }
392
+ }
393
+ const rolloutPath = await this.findRolloutFileAsync(normalizedSessionId, preferred);
394
+ if (!rolloutPath)
395
+ return false;
396
+ try {
397
+ let hasMatchingSession = false;
398
+ let hasMatchingTurn = false;
399
+ await this.visitRolloutEvents(rolloutPath, event => {
400
+ try {
401
+ if (event?.type === 'session_meta') {
402
+ const persistedSessionId = event.payload?.session_id ?? event.payload?.id;
403
+ const version = event.payload?.version ?? event.payload?.cli_version;
404
+ const hasVersion = version !== undefined && version !== null && String(version).trim().length > 0;
405
+ if (persistedSessionId === normalizedSessionId && hasVersion)
406
+ hasMatchingSession = true;
407
+ }
408
+ else if (event?.type === 'turn_context' && event.payload?.turn_id === normalizedTurnId) {
409
+ hasMatchingTurn = true;
410
+ }
411
+ }
412
+ catch {
413
+ // Ignore unusable metadata, as with malformed JSONL records.
414
+ }
415
+ if (hasMatchingSession && hasMatchingTurn)
416
+ return false;
417
+ });
418
+ return hasMatchingSession && hasMatchingTurn;
419
+ }
420
+ catch {
421
+ return false;
422
+ }
423
+ }
424
+ /** Visit a bounded UTF-8 JSONL snapshot; false stops after sufficient evidence. */
425
+ async visitRolloutEvents(file, visit) {
426
+ await visitSessionHistoryLines(file, line => {
427
+ let event;
428
+ try {
429
+ event = JSON.parse(line);
430
+ }
431
+ catch {
432
+ return;
433
+ }
434
+ return visit(event);
435
+ });
436
+ }
437
+ /**
438
+ * 在 ~/.codex/sessions/ 下递归查找含 agentSessionId 的 rollout JSONL 文件
439
+ */
440
+ findRolloutFile(agentSessionId) {
441
+ const cached = this.rolloutPathCache.get(agentSessionId);
442
+ if (cached && fs.existsSync(cached))
443
+ return cached;
444
+ this.rolloutPathCache.delete(agentSessionId);
445
+ const sessionsDir = path.join(this.codexHome, 'sessions');
446
+ if (!fs.existsSync(sessionsDir))
447
+ return null;
448
+ try {
449
+ const search = (dir) => {
450
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
451
+ if (entry.isDirectory()) {
452
+ const found = search(path.join(dir, entry.name));
453
+ if (found)
454
+ return found;
455
+ }
456
+ else if (entry.name.endsWith('.jsonl') && entry.name.includes(agentSessionId)) {
457
+ const rolloutPath = path.join(dir, entry.name);
458
+ this.rolloutPathCache.set(agentSessionId, rolloutPath);
459
+ return rolloutPath;
460
+ }
461
+ }
462
+ return null;
463
+ };
464
+ return search(sessionsDir);
465
+ }
466
+ catch {
467
+ return null;
468
+ }
469
+ }
470
+ getFileInfo(projectPath, agentSessionId) {
471
+ // 1. 优先查 state DB
472
+ const db = this.getDb();
473
+ if (db) {
474
+ try {
475
+ const row = db.prepare('SELECT title, first_user_message, rollout_path FROM threads WHERE id = ?').get(agentSessionId);
476
+ if (row) {
477
+ const rolloutPath = this.resolveRolloutPath(row.rollout_path, agentSessionId);
478
+ const preview = this.buildThreadPreview(row.first_user_message, rolloutPath, row.title, false, 80);
479
+ return {
480
+ turns: this.countTurnsFromRollout(rolloutPath),
481
+ title: preview.title || undefined,
482
+ };
483
+ }
484
+ }
485
+ catch (error) {
486
+ logger.warn(`[CodexAdapter] getFileInfo DB query failed:`, error);
487
+ }
488
+ }
489
+ // 2. Fallback: 从 sessions 目录查找 rollout 文件
490
+ const rolloutPath = this.findRolloutFile(agentSessionId);
491
+ if (rolloutPath) {
492
+ return { turns: this.countTurnsFromRollout(rolloutPath) };
493
+ }
494
+ return { turns: 0 };
495
+ }
496
+ async getFileInfoAsync(_projectPath, agentSessionId) {
497
+ let row;
498
+ let initial;
499
+ const previewOptions = { includeSyntheticFallback: false, maxLength: 80 };
500
+ const db = this.getDb();
501
+ if (db) {
502
+ try {
503
+ const candidate = db.prepare('SELECT title, first_user_message, rollout_path FROM threads WHERE id = ?').get(agentSessionId);
504
+ if (candidate) {
505
+ initial = buildCliSessionPreview([candidate.first_user_message], 'codex', {
506
+ ...previewOptions, explicitTitle: candidate.title,
507
+ });
508
+ row = candidate;
509
+ }
510
+ }
511
+ catch (error) {
512
+ logger.warn('[CodexAdapter] getFileInfo DB query failed:', error);
513
+ }
514
+ }
515
+ const rollout = await this.findRolloutFileAsync(agentSessionId, row?.rollout_path);
516
+ let turns = 0;
517
+ let preview = initial;
518
+ if (rollout) {
519
+ try {
520
+ await this.visitRolloutEvents(rollout, event => {
521
+ if (event?.type === 'turn_context')
522
+ turns++;
523
+ if (preview && !preview.hasReal && event?.type === 'event_msg'
524
+ && event.payload?.type === 'user_message' && event.payload.message) {
525
+ try {
526
+ preview = buildCliSessionPreview([String(event.payload.message)], 'codex', {
527
+ ...previewOptions, explicitTitle: row.title,
528
+ });
529
+ }
530
+ catch { /* Skip unusable user messages, as in the synchronous reader. */ }
531
+ }
532
+ });
533
+ }
534
+ catch {
535
+ turns = 0;
536
+ preview = initial;
537
+ }
538
+ }
539
+ return row ? { turns, title: preview?.title || undefined } : { turns };
540
+ }
541
+ readFirstMessage(projectPath, agentSessionId) {
542
+ // 1. 优先查 state DB
543
+ const db = this.getDb();
544
+ if (db) {
545
+ try {
546
+ const row = db.prepare('SELECT first_user_message, rollout_path FROM threads WHERE id = ?').get(agentSessionId);
547
+ if (row) {
548
+ const rolloutPath = this.resolveRolloutPath(row.rollout_path, agentSessionId);
549
+ return this.buildThreadPreview(row.first_user_message, rolloutPath).title;
550
+ }
551
+ }
552
+ catch (error) {
553
+ logger.warn(`[CodexAdapter] readFirstMessage DB query failed:`, error);
554
+ }
555
+ }
556
+ // 2. Fallback: 从 rollout JSONL 读取第一条 user_message
557
+ const rolloutPath = this.findRolloutFile(agentSessionId);
558
+ if (!rolloutPath)
559
+ return null;
560
+ return this.readUserMessageFromRollout(rolloutPath, 'first');
561
+ }
562
+ async findRolloutFileAsync(agentSessionId, preferred) {
563
+ for (const candidate of [preferred, this.rolloutPathCache.get(agentSessionId)]) {
564
+ if (typeof candidate !== 'string' || !candidate)
565
+ continue;
566
+ try {
567
+ await fs.promises.access(candidate);
568
+ return candidate;
569
+ }
570
+ catch { /* Rescan moved rollouts. */ }
571
+ }
572
+ this.rolloutPathCache.delete(agentSessionId);
573
+ const scan = async (dir) => {
574
+ const files = [];
575
+ let entries;
576
+ try {
577
+ entries = await fs.promises.readdir(dir, { withFileTypes: true });
578
+ }
579
+ catch {
580
+ return files;
581
+ }
582
+ for (const entry of entries) {
583
+ const file = path.join(dir, entry.name);
584
+ if (entry.isDirectory())
585
+ files.push(...await scan(file));
586
+ else if (entry.name.endsWith('.jsonl')) {
587
+ files.push(file);
588
+ const id = /([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})\.jsonl$/i.exec(entry.name)?.[1];
589
+ if (id && !this.rolloutPathCache.has(id))
590
+ this.rolloutPathCache.set(id, file);
591
+ }
592
+ }
593
+ return files;
594
+ };
595
+ // Concurrent topic reads share discovery. Misses are never cached across scans.
596
+ const pending = this.rolloutFilesScan ??= scan(path.join(this.codexHome, 'sessions'));
597
+ try {
598
+ const file = (await pending).find(file => path.basename(file).includes(agentSessionId)) ?? null;
599
+ if (file)
600
+ this.rolloutPathCache.set(agentSessionId, file);
601
+ return file;
602
+ }
603
+ finally {
604
+ if (this.rolloutFilesScan === pending)
605
+ this.rolloutFilesScan = undefined;
606
+ }
607
+ }
608
+ async readMenuSummary(_projectPath, agentSessionId) {
609
+ let row;
610
+ try {
611
+ row = this.getDb()?.prepare('SELECT first_user_message, rollout_path FROM threads WHERE id = ?').get(agentSessionId);
612
+ }
613
+ catch (error) {
614
+ logger.warn('[CodexAdapter] menu summary DB query failed:', error);
615
+ }
616
+ const rollout = await this.findRolloutFileAsync(agentSessionId, row?.rollout_path);
617
+ let turns = 0;
618
+ let rolloutRead = false;
619
+ const messages = [];
620
+ if (rollout) {
621
+ try {
622
+ await visitSessionHistory(rollout, event => {
623
+ if (event?.type === 'turn_context')
624
+ turns++;
625
+ if (event?.type === 'event_msg' && event.payload?.type === 'user_message' && event.payload.message) {
626
+ messages.push(String(event.payload.message));
627
+ }
628
+ });
629
+ rolloutRead = true;
630
+ }
631
+ catch {
632
+ turns = 0;
633
+ messages.length = 0;
634
+ }
635
+ }
636
+ const initial = buildCliSessionPreview([row?.first_user_message], 'codex');
637
+ return { turns, firstMessage: row && (initial.hasReal || !rollout || !rolloutRead)
638
+ ? initial.title : buildCliSessionPreview(messages, 'codex').title };
639
+ }
640
+ readLastUserMessage(projectPath, agentSessionId) {
641
+ // 1. 优先查 state DB 获取 rollout_path
642
+ const db = this.getDb();
643
+ let rolloutPath = null;
644
+ if (db) {
645
+ try {
646
+ const row = db.prepare('SELECT rollout_path FROM threads WHERE id = ?').get(agentSessionId);
647
+ if (row?.rollout_path && fs.existsSync(row.rollout_path)) {
648
+ rolloutPath = row.rollout_path;
649
+ }
650
+ }
651
+ catch (error) {
652
+ logger.warn(`[CodexAdapter] readLastUserMessage DB query failed:`, error);
653
+ }
654
+ }
655
+ // 2. Fallback: 从 sessions 目录查找 rollout 文件
656
+ if (!rolloutPath) {
657
+ rolloutPath = this.findRolloutFile(agentSessionId);
658
+ }
659
+ if (!rolloutPath)
660
+ return null;
661
+ return this.readUserMessageFromRollout(rolloutPath, 'last');
662
+ }
663
+ async readLastUserMessageAsync(_projectPath, agentSessionId) {
664
+ let preferred;
665
+ try {
666
+ preferred = this.getDb()?.prepare('SELECT rollout_path FROM threads WHERE id = ?').get(agentSessionId)?.rollout_path;
667
+ }
668
+ catch (error) {
669
+ logger.warn('[CodexAdapter] readLastUserMessage DB query failed:', error);
670
+ }
671
+ const rollout = await this.findRolloutFileAsync(agentSessionId, preferred);
672
+ if (!rollout)
673
+ return null;
674
+ const messages = [];
675
+ try {
676
+ await this.visitRolloutEvents(rollout, event => {
677
+ try {
678
+ if (event?.type === 'event_msg' && event.payload?.type === 'user_message' && event.payload.message) {
679
+ messages.push(String(event.payload.message));
680
+ }
681
+ }
682
+ catch { /* Skip unusable user messages, as in the synchronous reader. */ }
683
+ });
684
+ }
685
+ catch {
686
+ return null;
687
+ }
688
+ return buildCliSessionPreview(messages.reverse(), 'codex').title;
689
+ }
690
+ scanCliSessions(projectPath, limit = 10) {
691
+ const db = this.getDb();
692
+ if (!db)
693
+ return [];
694
+ try {
695
+ const rows = db.prepare('SELECT id, updated_at, source, title, first_user_message, rollout_path FROM threads WHERE cwd = ? AND archived = 0 ORDER BY updated_at DESC').all(projectPath);
696
+ const sessions = [];
697
+ for (const row of rows) {
698
+ if (!CODEX_INTERACTIVE_SOURCES.has(row.source))
699
+ continue;
700
+ // 排除 EvolCore 自身驱动 codex 产生的会话(首条 user 消息带路由前缀)。
701
+ // codex 无 entrypoint 字段,EvolCore 会话与真人 vscode 会话同为 source=vscode,
702
+ // 只能靠路由前缀区分——等同 Claude adapter 用 entrypoint 排除 sdk-ts。
703
+ if (isEvolcoreRoutedMessage(row.first_user_message))
704
+ continue;
705
+ const rolloutPath = this.resolveRolloutPath(row.rollout_path, row.id);
706
+ const preview = this.buildThreadPreview(row.first_user_message, rolloutPath, row.title, false, 80);
707
+ if (!preview.hasReal)
708
+ continue;
709
+ const timestamp = Number(row.updated_at) || 0;
710
+ sessions.push({
711
+ uuid: row.id,
712
+ mtime: timestamp < 1_000_000_000_000 ? timestamp * 1000 : timestamp,
713
+ title: preview.title || undefined,
714
+ });
715
+ if (sessions.length >= limit)
716
+ break;
717
+ }
718
+ return sessions;
719
+ }
720
+ catch (error) {
721
+ logger.warn(`[CodexAdapter] scanCliSessions failed:`, error);
722
+ return [];
723
+ }
724
+ }
725
+ async listSdkSessions(projectPath) {
726
+ const db = this.getDb();
727
+ if (!db)
728
+ return [];
729
+ try {
730
+ const rows = db.prepare('SELECT id, title FROM threads WHERE cwd = ? AND archived = 0 ORDER BY updated_at DESC').all(projectPath);
731
+ return rows.map(r => ({
732
+ sessionId: r.id,
733
+ title: sanitizeCodexThreadTitle(r.title),
734
+ }));
735
+ }
736
+ catch (error) {
737
+ logger.warn(`[CodexAdapter] listSdkSessions failed:`, error);
738
+ return [];
739
+ }
740
+ }
741
+ close() {
742
+ if (this.db) {
743
+ try {
744
+ this.db.close();
745
+ }
746
+ catch { /* ignore close errors */ }
747
+ this.db = null;
748
+ }
749
+ this.dbInitialized = false;
750
+ this.rolloutPathCache.clear();
751
+ }
752
+ /** Locate an already bound rollout without requiring a CLI SQLite index row. */
753
+ findSessionFile(agentSessionId) {
754
+ return this.findRolloutFile(agentSessionId);
755
+ }
756
+ /**
757
+ * 从 rollout JSONL 读取第一条或最后一条 user_message
758
+ */
759
+ readUserMessageFromRollout(rolloutPath, which) {
760
+ const messages = this.readRolloutUserMessages(rolloutPath);
761
+ if (!messages)
762
+ return null;
763
+ const orderedMessages = which === 'first' ? messages : [...messages].reverse();
764
+ return buildCliSessionPreview(orderedMessages, 'codex').title;
765
+ }
766
+ resolveRolloutPath(rolloutPath, agentSessionId) {
767
+ if (typeof rolloutPath === 'string' && rolloutPath && fs.existsSync(rolloutPath)) {
768
+ return rolloutPath;
769
+ }
770
+ return this.findRolloutFile(agentSessionId);
771
+ }
772
+ buildThreadPreview(firstUserMessage, rolloutPath, explicitTitle, includeSyntheticFallback = true, maxLength = 50) {
773
+ const initial = buildCliSessionPreview([firstUserMessage], 'codex', {
774
+ explicitTitle,
775
+ includeSyntheticFallback,
776
+ maxLength,
777
+ });
778
+ if (initial.hasReal || !rolloutPath)
779
+ return initial;
780
+ const rolloutMessages = this.readRolloutUserMessages(rolloutPath);
781
+ if (!rolloutMessages)
782
+ return initial;
783
+ return buildCliSessionPreview(rolloutMessages, 'codex', {
784
+ explicitTitle,
785
+ includeSyntheticFallback,
786
+ maxLength,
787
+ });
788
+ }
789
+ readRolloutUserMessages(rolloutPath) {
790
+ try {
791
+ const content = fs.readFileSync(rolloutPath, 'utf-8');
792
+ const lines = content.split('\n').filter(l => l.trim());
793
+ const messages = [];
794
+ for (const line of lines) {
795
+ try {
796
+ const event = JSON.parse(line);
797
+ if (event.type === 'event_msg' && event.payload?.type === 'user_message' && event.payload.message) {
798
+ messages.push(String(event.payload.message));
799
+ }
800
+ }
801
+ catch { /* skip malformed line */ }
802
+ }
803
+ return messages;
804
+ }
805
+ catch {
806
+ return null;
807
+ }
808
+ }
809
+ /**
810
+ * 从 rollout JSONL 文件计算轮数(数 turn_context 行)
811
+ */
812
+ countTurnsFromRollout(rolloutPath) {
813
+ if (!rolloutPath || !fs.existsSync(rolloutPath))
814
+ return 0;
815
+ try {
816
+ const content = fs.readFileSync(rolloutPath, 'utf-8');
817
+ const lines = content.split('\n').filter(l => l.trim());
818
+ let turns = 0;
819
+ for (const line of lines) {
820
+ try {
821
+ const event = JSON.parse(line);
822
+ if (event.type === 'turn_context') {
823
+ turns++;
824
+ }
825
+ }
826
+ catch { /* skip malformed line */ }
827
+ }
828
+ return turns;
829
+ }
830
+ catch {
831
+ return 0;
832
+ }
833
+ }
834
+ }