@downcity/agent 1.1.237 → 1.1.258

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 (578) hide show
  1. package/README.md +21 -20
  2. package/bin/agent/{local/Agent.d.ts → Agent.d.ts} +37 -27
  3. package/bin/agent/Agent.d.ts.map +1 -0
  4. package/bin/agent/Agent.js +211 -0
  5. package/bin/agent/Agent.js.map +1 -0
  6. package/bin/agent/AgentContext.d.ts +64 -0
  7. package/bin/agent/AgentContext.d.ts.map +1 -0
  8. package/bin/agent/AgentContext.js +53 -0
  9. package/bin/agent/AgentContext.js.map +1 -0
  10. package/bin/agent/{local/AgentInstructions.d.ts → AgentInstructions.d.ts} +1 -6
  11. package/bin/agent/AgentInstructions.d.ts.map +1 -0
  12. package/bin/agent/{local/AgentInstructions.js → AgentInstructions.js} +1 -10
  13. package/bin/agent/AgentInstructions.js.map +1 -0
  14. package/bin/{model/CityModelAdapter.d.ts → agent/AgentModel.d.ts} +3 -3
  15. package/bin/agent/AgentModel.d.ts.map +1 -0
  16. package/bin/{model/CityModelAdapter.js → agent/AgentModel.js} +11 -4
  17. package/bin/agent/AgentModel.js.map +1 -0
  18. package/bin/agent/{local/services/AgentSessions.d.ts → AgentSessions.d.ts} +30 -40
  19. package/bin/agent/AgentSessions.d.ts.map +1 -0
  20. package/bin/agent/{local/services/AgentSessions.js → AgentSessions.js} +62 -79
  21. package/bin/agent/AgentSessions.js.map +1 -0
  22. package/bin/agent/AgentState.d.ts +64 -0
  23. package/bin/agent/AgentState.d.ts.map +1 -0
  24. package/bin/agent/AgentState.js +118 -0
  25. package/bin/agent/AgentState.js.map +1 -0
  26. package/bin/config/Paths.d.ts +0 -43
  27. package/bin/config/Paths.d.ts.map +1 -1
  28. package/bin/config/Paths.js +0 -79
  29. package/bin/config/Paths.js.map +1 -1
  30. package/bin/config/ProjectSetup.d.ts.map +1 -0
  31. package/bin/{agent/local → config}/ProjectSetup.js +1 -1
  32. package/bin/config/ProjectSetup.js.map +1 -0
  33. package/bin/executor/Executor.d.ts +20 -86
  34. package/bin/executor/Executor.d.ts.map +1 -1
  35. package/bin/executor/Executor.js +109 -260
  36. package/bin/executor/Executor.js.map +1 -1
  37. package/bin/executor/composer/system/default/DefaultSessionSystemComposer.d.ts +1 -1
  38. package/bin/executor/composer/system/default/DefaultSessionSystemComposer.d.ts.map +1 -1
  39. package/bin/executor/composer/system/default/SystemDomain.d.ts +1 -1
  40. package/bin/executor/composer/system/default/SystemDomain.d.ts.map +1 -1
  41. package/bin/executor/composer/system/default/SystemDomain.js +4 -1
  42. package/bin/executor/composer/system/default/SystemDomain.js.map +1 -1
  43. package/bin/executor/composer/system/default/assets/core.prompt.d.ts +1 -1
  44. package/bin/executor/composer/system/default/assets/core.prompt.d.ts.map +1 -1
  45. package/bin/executor/composer/system/default/assets/core.prompt.js +1 -1
  46. package/bin/executor/composer/system/default/assets/core.prompt.js.map +1 -1
  47. package/bin/executor/core-engine/CoreEngineRunner.d.ts +7 -13
  48. package/bin/executor/core-engine/CoreEngineRunner.d.ts.map +1 -1
  49. package/bin/executor/core-engine/CoreEngineRunner.js +81 -34
  50. package/bin/executor/core-engine/CoreEngineRunner.js.map +1 -1
  51. package/bin/executor/services/ExecutorRecoveryPolicy.d.ts +6 -12
  52. package/bin/executor/services/ExecutorRecoveryPolicy.d.ts.map +1 -1
  53. package/bin/executor/services/ExecutorRecoveryPolicy.js +20 -6
  54. package/bin/executor/services/ExecutorRecoveryPolicy.js.map +1 -1
  55. package/bin/executor/tools/file/ReadImageToolBridge.d.ts +21 -0
  56. package/bin/executor/tools/file/ReadImageToolBridge.d.ts.map +1 -0
  57. package/bin/executor/tools/file/ReadImageToolBridge.js +69 -0
  58. package/bin/executor/tools/file/ReadImageToolBridge.js.map +1 -0
  59. package/bin/executor/tools/plugin/PluginToolBridge.d.ts.map +1 -1
  60. package/bin/executor/tools/plugin/PluginToolBridge.js +6 -5
  61. package/bin/executor/tools/plugin/PluginToolBridge.js.map +1 -1
  62. package/bin/executor/tools/plugin/PluginToolDefinition.d.ts.map +1 -1
  63. package/bin/executor/tools/plugin/PluginToolDefinition.js +15 -2
  64. package/bin/executor/tools/plugin/PluginToolDefinition.js.map +1 -1
  65. package/bin/executor/types/SessionHistoryMeta.d.ts +0 -2
  66. package/bin/executor/types/SessionHistoryMeta.d.ts.map +1 -1
  67. package/bin/index.d.ts +17 -21
  68. package/bin/index.d.ts.map +1 -1
  69. package/bin/index.js +9 -11
  70. package/bin/index.js.map +1 -1
  71. package/bin/plugin/core/ActionScheduleExecutor.d.ts +1 -1
  72. package/bin/plugin/core/ActionScheduleExecutor.d.ts.map +1 -1
  73. package/bin/plugin/core/ActionScheduleRuntime.d.ts +1 -1
  74. package/bin/plugin/core/ActionScheduleRuntime.d.ts.map +1 -1
  75. package/bin/plugin/core/BasePlugin.d.ts +4 -3
  76. package/bin/plugin/core/BasePlugin.d.ts.map +1 -1
  77. package/bin/plugin/core/BasePlugin.js.map +1 -1
  78. package/bin/plugin/core/HookRegistry.d.ts +5 -8
  79. package/bin/plugin/core/HookRegistry.d.ts.map +1 -1
  80. package/bin/plugin/core/HookRegistry.js +12 -12
  81. package/bin/plugin/core/HookRegistry.js.map +1 -1
  82. package/bin/plugin/core/PluginActionFactory.d.ts +6 -3
  83. package/bin/plugin/core/PluginActionFactory.d.ts.map +1 -1
  84. package/bin/plugin/core/PluginActionFactory.js.map +1 -1
  85. package/bin/plugin/core/PluginActionRunner.d.ts +1 -1
  86. package/bin/plugin/core/PluginActionRunner.d.ts.map +1 -1
  87. package/bin/plugin/core/PluginCatalog.d.ts +1 -1
  88. package/bin/plugin/core/PluginCatalog.d.ts.map +1 -1
  89. package/bin/plugin/core/PluginHttpRoutes.d.ts +1 -1
  90. package/bin/plugin/core/PluginHttpRoutes.d.ts.map +1 -1
  91. package/bin/plugin/core/PluginLocalExecution.d.ts +4 -5
  92. package/bin/plugin/core/PluginLocalExecution.d.ts.map +1 -1
  93. package/bin/plugin/core/PluginLocalExecution.js +4 -12
  94. package/bin/plugin/core/PluginLocalExecution.js.map +1 -1
  95. package/bin/plugin/core/PluginRegistry.d.ts +16 -12
  96. package/bin/plugin/core/PluginRegistry.d.ts.map +1 -1
  97. package/bin/plugin/core/PluginRegistry.js +43 -22
  98. package/bin/plugin/core/PluginRegistry.js.map +1 -1
  99. package/bin/plugin/core/PluginStateController.d.ts +1 -1
  100. package/bin/plugin/core/PluginStateController.d.ts.map +1 -1
  101. package/bin/{agent/remote → remote}/RemoteAgent.d.ts +4 -4
  102. package/bin/remote/RemoteAgent.d.ts.map +1 -0
  103. package/bin/{agent/remote → remote}/RemoteAgent.js +3 -3
  104. package/bin/remote/RemoteAgent.js.map +1 -0
  105. package/bin/{agent/remote → remote}/RemoteSession.d.ts +9 -11
  106. package/bin/remote/RemoteSession.d.ts.map +1 -0
  107. package/bin/{agent/remote → remote}/RemoteSession.js +3 -33
  108. package/bin/remote/RemoteSession.js.map +1 -0
  109. package/bin/{agent/remote → remote}/RemoteTransport.d.ts +7 -9
  110. package/bin/remote/RemoteTransport.d.ts.map +1 -0
  111. package/bin/remote/RemoteTransport.js.map +1 -0
  112. package/bin/{agent/remote → remote}/TransportFactory.d.ts +1 -1
  113. package/bin/remote/TransportFactory.d.ts.map +1 -0
  114. package/bin/{agent/remote → remote}/TransportFactory.js +2 -2
  115. package/bin/remote/TransportFactory.js.map +1 -0
  116. package/bin/{agent/remote → remote}/transports/HttpRemoteAgentTransport.d.ts +8 -9
  117. package/bin/remote/transports/HttpRemoteAgentTransport.d.ts.map +1 -0
  118. package/bin/{agent/remote → remote}/transports/HttpRemoteAgentTransport.js +0 -13
  119. package/bin/remote/transports/HttpRemoteAgentTransport.js.map +1 -0
  120. package/bin/{rpc/Client.d.ts → remote/transports/RpcClient.d.ts} +15 -22
  121. package/bin/remote/transports/RpcClient.d.ts.map +1 -0
  122. package/bin/{rpc/Client.js → remote/transports/RpcClient.js} +2 -13
  123. package/bin/remote/transports/RpcClient.js.map +1 -0
  124. package/bin/{agent/remote → remote}/transports/RpcRemoteAgentTransport.d.ts +8 -9
  125. package/bin/remote/transports/RpcRemoteAgentTransport.d.ts.map +1 -0
  126. package/bin/{agent/remote → remote}/transports/RpcRemoteAgentTransport.js +1 -4
  127. package/bin/remote/transports/RpcRemoteAgentTransport.js.map +1 -0
  128. package/bin/session/DefaultSessionComposer.d.ts +18 -0
  129. package/bin/session/DefaultSessionComposer.d.ts.map +1 -0
  130. package/bin/session/DefaultSessionComposer.js +62 -0
  131. package/bin/session/DefaultSessionComposer.js.map +1 -0
  132. package/bin/session/Session.d.ts +44 -33
  133. package/bin/session/Session.d.ts.map +1 -1
  134. package/bin/session/Session.js +440 -274
  135. package/bin/session/Session.js.map +1 -1
  136. package/bin/session/SessionMessages.d.ts +117 -0
  137. package/bin/session/SessionMessages.d.ts.map +1 -0
  138. package/bin/session/{recorder/SessionRecorder.js → SessionMessages.js} +194 -284
  139. package/bin/session/SessionMessages.js.map +1 -0
  140. package/bin/session/SessionQueue.d.ts +34 -0
  141. package/bin/session/SessionQueue.d.ts.map +1 -0
  142. package/bin/session/SessionQueue.js +60 -0
  143. package/bin/session/SessionQueue.js.map +1 -0
  144. package/bin/session/SessionState.d.ts +70 -0
  145. package/bin/session/SessionState.d.ts.map +1 -0
  146. package/bin/session/SessionState.js +267 -0
  147. package/bin/session/SessionState.js.map +1 -0
  148. package/bin/session/SessionSystem.d.ts +15 -0
  149. package/bin/session/SessionSystem.d.ts.map +1 -0
  150. package/bin/session/SessionSystem.js +95 -0
  151. package/bin/session/SessionSystem.js.map +1 -0
  152. package/bin/session/SessionTurn.d.ts +84 -0
  153. package/bin/session/SessionTurn.d.ts.map +1 -0
  154. package/bin/session/SessionTurn.js +588 -0
  155. package/bin/session/SessionTurn.js.map +1 -0
  156. package/bin/session/approval/SessionApprovalBroker.d.ts +48 -0
  157. package/bin/session/approval/SessionApprovalBroker.d.ts.map +1 -0
  158. package/bin/session/approval/SessionApprovalBroker.js +126 -0
  159. package/bin/session/approval/SessionApprovalBroker.js.map +1 -0
  160. package/bin/session/browse/Browse.d.ts.map +1 -1
  161. package/bin/session/browse/Browse.js +1 -4
  162. package/bin/session/browse/Browse.js.map +1 -1
  163. package/bin/session/{recorder → messages}/JsonlSessionMessageStore.d.ts.map +1 -1
  164. package/bin/session/{recorder → messages}/JsonlSessionMessageStore.js.map +1 -1
  165. package/bin/session/messages/SessionAssistantMessageWriter.d.ts +62 -0
  166. package/bin/session/messages/SessionAssistantMessageWriter.d.ts.map +1 -0
  167. package/bin/session/messages/SessionAssistantMessageWriter.js +287 -0
  168. package/bin/session/messages/SessionAssistantMessageWriter.js.map +1 -0
  169. package/bin/session/messages/SessionJsonValue.d.ts +10 -0
  170. package/bin/session/messages/SessionJsonValue.d.ts.map +1 -0
  171. package/bin/session/messages/SessionJsonValue.js +23 -0
  172. package/bin/session/messages/SessionJsonValue.js.map +1 -0
  173. package/bin/session/{recorder → messages}/SessionMessageCodec.d.ts +4 -1
  174. package/bin/session/messages/SessionMessageCodec.d.ts.map +1 -0
  175. package/bin/session/{recorder → messages}/SessionMessageCodec.js +33 -19
  176. package/bin/session/messages/SessionMessageCodec.js.map +1 -0
  177. package/bin/session/messages/SessionMessageCompaction.d.ts +22 -0
  178. package/bin/session/messages/SessionMessageCompaction.d.ts.map +1 -0
  179. package/bin/session/{recorder/SessionRecorderCompaction.js → messages/SessionMessageCompaction.js} +19 -51
  180. package/bin/session/messages/SessionMessageCompaction.js.map +1 -0
  181. package/bin/session/runtime/SessionEventHub.d.ts +1 -8
  182. package/bin/session/runtime/SessionEventHub.d.ts.map +1 -1
  183. package/bin/session/runtime/SessionEventHub.js +1 -6
  184. package/bin/session/runtime/SessionEventHub.js.map +1 -1
  185. package/bin/session/storage/Metadata.d.ts +23 -5
  186. package/bin/session/storage/Metadata.d.ts.map +1 -1
  187. package/bin/session/storage/Metadata.js +32 -29
  188. package/bin/session/storage/Metadata.js.map +1 -1
  189. package/bin/session/storage/RuntimeSessionPort.d.ts +5 -10
  190. package/bin/session/storage/RuntimeSessionPort.d.ts.map +1 -1
  191. package/bin/session/storage/RuntimeSessionPort.js +2 -4
  192. package/bin/session/storage/RuntimeSessionPort.js.map +1 -1
  193. package/bin/types/agent/AgentOptions.d.ts +6 -35
  194. package/bin/types/agent/AgentOptions.d.ts.map +1 -1
  195. package/bin/types/agent/AgentState.d.ts +28 -0
  196. package/bin/types/agent/AgentState.d.ts.map +1 -0
  197. package/bin/types/agent/AgentState.js +9 -0
  198. package/bin/types/agent/AgentState.js.map +1 -0
  199. package/bin/types/agent/SessionActor.d.ts +0 -2
  200. package/bin/types/agent/SessionActor.d.ts.map +1 -1
  201. package/bin/types/agent/SessionTypes.d.ts +5 -18
  202. package/bin/types/agent/SessionTypes.d.ts.map +1 -1
  203. package/bin/types/executor/SessionRunContext.d.ts +8 -2
  204. package/bin/types/executor/SessionRunContext.d.ts.map +1 -1
  205. package/bin/types/executor/SessionRunContext.js +1 -1
  206. package/bin/types/executor/SessionToolExecutionContext.d.ts +20 -0
  207. package/bin/types/executor/SessionToolExecutionContext.d.ts.map +1 -0
  208. package/bin/types/executor/SessionToolExecutionContext.js +10 -0
  209. package/bin/types/executor/SessionToolExecutionContext.js.map +1 -0
  210. package/bin/types/plugin/PluginAction.d.ts +10 -1
  211. package/bin/types/plugin/PluginAction.d.ts.map +1 -1
  212. package/bin/types/plugin/PluginCommand.d.ts +3 -11
  213. package/bin/types/plugin/PluginCommand.d.ts.map +1 -1
  214. package/bin/types/plugin/PluginConfig.d.ts +12 -0
  215. package/bin/types/plugin/PluginConfig.d.ts.map +1 -0
  216. package/bin/types/plugin/PluginConfig.js +5 -0
  217. package/bin/types/plugin/PluginConfig.js.map +1 -0
  218. package/bin/types/plugin/PluginDefinition.d.ts +10 -3
  219. package/bin/types/plugin/PluginDefinition.d.ts.map +1 -1
  220. package/bin/types/plugin/PluginHttp.d.ts +1 -1
  221. package/bin/types/plugin/PluginHttp.d.ts.map +1 -1
  222. package/bin/types/plugin/PluginRunContext.d.ts +26 -0
  223. package/bin/types/plugin/PluginRunContext.d.ts.map +1 -0
  224. package/bin/types/plugin/PluginRunContext.js +10 -0
  225. package/bin/types/plugin/PluginRunContext.js.map +1 -0
  226. package/bin/types/plugin/PluginRuntime.d.ts +9 -3
  227. package/bin/types/plugin/PluginRuntime.d.ts.map +1 -1
  228. package/bin/types/plugin/PluginToolRuntime.d.ts +11 -0
  229. package/bin/types/plugin/PluginToolRuntime.d.ts.map +1 -1
  230. package/bin/types/rpc/RpcProtocol.d.ts +1 -13
  231. package/bin/types/rpc/RpcProtocol.d.ts.map +1 -1
  232. package/bin/types/session/SessionApproval.d.ts +4 -38
  233. package/bin/types/session/SessionApproval.d.ts.map +1 -1
  234. package/bin/types/session/SessionApprovalBroker.d.ts +17 -0
  235. package/bin/types/session/SessionApprovalBroker.d.ts.map +1 -0
  236. package/bin/types/session/SessionApprovalBroker.js +7 -0
  237. package/bin/types/session/SessionApprovalBroker.js.map +1 -0
  238. package/bin/types/session/SessionComposer.d.ts +99 -0
  239. package/bin/types/session/SessionComposer.d.ts.map +1 -0
  240. package/bin/types/session/SessionComposer.js +8 -0
  241. package/bin/types/session/SessionComposer.js.map +1 -0
  242. package/bin/types/session/SessionLocalState.d.ts +6 -6
  243. package/bin/types/session/SessionLocalState.d.ts.map +1 -1
  244. package/bin/types/session/SessionLocalState.js +1 -1
  245. package/bin/types/session/SessionMessage.d.ts +3 -2
  246. package/bin/types/session/SessionMessage.d.ts.map +1 -1
  247. package/bin/types/session/SessionMessages.d.ts +115 -0
  248. package/bin/types/session/SessionMessages.d.ts.map +1 -0
  249. package/bin/types/session/SessionMessages.js +7 -0
  250. package/bin/types/session/SessionMessages.js.map +1 -0
  251. package/bin/types/session/SessionMutation.d.ts +1 -10
  252. package/bin/types/session/SessionMutation.d.ts.map +1 -1
  253. package/bin/types/session/SessionMutation.js.map +1 -1
  254. package/bin/types/session/SessionOptions.d.ts +8 -23
  255. package/bin/types/session/SessionOptions.d.ts.map +1 -1
  256. package/bin/types/session/SessionPort.d.ts +72 -0
  257. package/bin/types/session/SessionPort.d.ts.map +1 -0
  258. package/bin/types/session/SessionPort.js +9 -0
  259. package/bin/types/session/SessionPort.js.map +1 -0
  260. package/bin/types/session/SessionQueue.d.ts +104 -0
  261. package/bin/types/session/SessionQueue.d.ts.map +1 -0
  262. package/bin/types/session/SessionQueue.js +7 -0
  263. package/bin/types/session/SessionQueue.js.map +1 -0
  264. package/bin/types/session/SessionState.d.ts +43 -0
  265. package/bin/types/session/SessionState.d.ts.map +1 -0
  266. package/bin/types/session/SessionState.js +7 -0
  267. package/bin/types/session/SessionState.js.map +1 -0
  268. package/bin/types/session/SessionSystem.d.ts +26 -0
  269. package/bin/types/session/SessionSystem.d.ts.map +1 -0
  270. package/bin/types/session/SessionSystem.js +7 -0
  271. package/bin/types/session/SessionSystem.js.map +1 -0
  272. package/bin/types/session/SessionTool.d.ts +23 -0
  273. package/bin/types/session/SessionTool.d.ts.map +1 -0
  274. package/bin/types/session/SessionTool.js +7 -0
  275. package/bin/types/session/SessionTool.js.map +1 -0
  276. package/bin/types/session/SessionTurn.d.ts +52 -0
  277. package/bin/types/session/SessionTurn.d.ts.map +1 -0
  278. package/bin/types/session/SessionTurn.js +7 -0
  279. package/bin/types/session/SessionTurn.js.map +1 -0
  280. package/package.json +3 -3
  281. package/scripts/agent-env.test.mjs +4 -18
  282. package/scripts/agent-ready.test.mjs +33 -2
  283. package/scripts/agent-session-maintenance.test.mjs +52 -0
  284. package/scripts/city-model-tool-loop.test.mjs +3 -4
  285. package/scripts/core-engine-context-compaction.test.mjs +5 -22
  286. package/scripts/image-plugin-job.test.mjs +4 -6
  287. package/scripts/plugin-tool-bridge.test.mjs +44 -36
  288. package/scripts/read-image-tool-bridge.test.mjs +71 -0
  289. package/scripts/remote-session-reconnect.test.mjs +1 -34
  290. package/scripts/session-compaction-prompts.test.mjs +1 -49
  291. package/scripts/session-composer.test.mjs +163 -0
  292. package/scripts/session-config-turn-boundary.test.mjs +2 -5
  293. package/scripts/session-list-title.test.mjs +3 -2
  294. package/scripts/session-messages-error.test.mjs +57 -0
  295. package/scripts/{session-recorder.test.mjs → session-messages.test.mjs} +131 -90
  296. package/scripts/session-queue.test.mjs +64 -0
  297. package/scripts/session-shell-approval.test.mjs +171 -0
  298. package/scripts/session-system-blocks.test.mjs +10 -10
  299. package/scripts/session-title-event.test.mjs +1 -0
  300. package/src/agent/Agent.ts +241 -0
  301. package/src/agent/AgentContext.ts +92 -0
  302. package/src/agent/{local/AgentInstructions.ts → AgentInstructions.ts} +0 -11
  303. package/src/{model/CityModelAdapter.ts → agent/AgentModel.ts} +10 -3
  304. package/src/agent/{local/services/AgentSessions.ts → AgentSessions.ts} +81 -110
  305. package/src/agent/AgentState.ts +151 -0
  306. package/src/config/Paths.ts +0 -91
  307. package/src/executor/Executor.ts +180 -386
  308. package/src/executor/README.md +29 -89
  309. package/src/executor/composer/system/default/DefaultSessionSystemComposer.ts +1 -1
  310. package/src/executor/composer/system/default/SystemDomain.ts +4 -2
  311. package/src/executor/composer/system/default/assets/core.prompt.ts +1 -1
  312. package/src/executor/composer/system/default/assets/core.prompt.ts.txt +15 -2
  313. package/src/executor/core-engine/CoreEngineRunner.ts +95 -54
  314. package/src/executor/services/ExecutorRecoveryPolicy.ts +24 -19
  315. package/src/executor/tools/file/ReadImageToolBridge.ts +79 -0
  316. package/src/executor/tools/plugin/PluginToolBridge.ts +6 -8
  317. package/src/executor/tools/plugin/PluginToolDefinition.ts +23 -3
  318. package/src/executor/types/SessionHistoryMeta.ts +0 -2
  319. package/src/index.ts +34 -53
  320. package/src/plugin/core/ActionScheduleExecutor.ts +1 -1
  321. package/src/plugin/core/ActionScheduleRuntime.ts +1 -1
  322. package/src/plugin/core/BasePlugin.ts +7 -3
  323. package/src/plugin/core/HookRegistry.ts +15 -18
  324. package/src/plugin/core/PluginActionFactory.ts +9 -3
  325. package/src/plugin/core/PluginActionRunner.ts +1 -1
  326. package/src/plugin/core/PluginCatalog.ts +1 -1
  327. package/src/plugin/core/PluginHttpRoutes.ts +1 -1
  328. package/src/plugin/core/PluginLocalExecution.ts +11 -24
  329. package/src/plugin/core/PluginRegistry.ts +55 -32
  330. package/src/plugin/core/PluginStateController.ts +1 -1
  331. package/src/{agent/remote → remote}/RemoteAgent.ts +4 -4
  332. package/src/{agent/remote → remote}/RemoteSession.ts +2 -35
  333. package/src/{agent/remote → remote}/RemoteTransport.ts +0 -3
  334. package/src/{agent/remote → remote}/TransportFactory.ts +3 -3
  335. package/src/{agent/remote → remote}/transports/HttpRemoteAgentTransport.ts +1 -23
  336. package/src/{rpc/Client.ts → remote/transports/RpcClient.ts} +1 -19
  337. package/src/{agent/remote → remote}/transports/RpcRemoteAgentTransport.ts +2 -10
  338. package/src/session/DefaultSessionComposer.ts +79 -0
  339. package/src/session/Session.ts +496 -332
  340. package/src/session/{recorder/SessionRecorder.ts → SessionMessages.ts} +254 -428
  341. package/src/session/SessionQueue.ts +86 -0
  342. package/src/session/SessionState.ts +322 -0
  343. package/src/session/SessionSystem.ts +117 -0
  344. package/src/session/SessionTurn.ts +684 -0
  345. package/src/session/approval/SessionApprovalBroker.ts +164 -0
  346. package/src/session/browse/Browse.ts +1 -4
  347. package/src/session/messages/SessionAssistantMessageWriter.ts +345 -0
  348. package/src/session/messages/SessionJsonValue.ts +25 -0
  349. package/src/session/{recorder → messages}/SessionMessageCodec.ts +38 -20
  350. package/src/session/{recorder/SessionRecorderCompaction.ts → messages/SessionMessageCompaction.ts} +30 -69
  351. package/src/session/runtime/SessionEventHub.ts +1 -14
  352. package/src/session/storage/Metadata.ts +60 -34
  353. package/src/session/storage/RuntimeSessionPort.ts +7 -14
  354. package/src/types/agent/AgentOptions.ts +6 -38
  355. package/src/types/agent/AgentState.ts +33 -0
  356. package/src/types/agent/SessionActor.ts +0 -3
  357. package/src/types/agent/SessionTypes.ts +5 -18
  358. package/src/types/executor/SessionRunContext.ts +10 -2
  359. package/src/types/executor/SessionToolExecutionContext.ts +21 -0
  360. package/src/types/plugin/PluginAction.ts +10 -1
  361. package/src/types/plugin/PluginCommand.ts +3 -14
  362. package/src/types/plugin/PluginConfig.ts +13 -0
  363. package/src/types/plugin/PluginDefinition.ts +13 -6
  364. package/src/types/plugin/PluginHttp.ts +1 -1
  365. package/src/types/plugin/PluginRunContext.ts +31 -0
  366. package/src/types/plugin/PluginRuntime.ts +13 -6
  367. package/src/types/plugin/PluginToolRuntime.ts +13 -1
  368. package/src/types/rpc/RpcProtocol.ts +0 -14
  369. package/src/types/session/SessionApproval.ts +4 -43
  370. package/src/types/session/SessionApprovalBroker.ts +18 -0
  371. package/src/types/session/SessionComposer.ts +114 -0
  372. package/src/types/session/SessionLocalState.ts +6 -6
  373. package/src/types/session/SessionMessage.ts +3 -2
  374. package/src/types/session/SessionMessages.ts +127 -0
  375. package/src/types/session/SessionMutation.ts +0 -11
  376. package/src/types/session/SessionOptions.ts +8 -40
  377. package/src/types/session/SessionPort.ts +97 -0
  378. package/src/types/session/SessionQueue.ts +122 -0
  379. package/src/types/session/SessionState.ts +47 -0
  380. package/src/types/session/SessionSystem.ts +27 -0
  381. package/src/types/session/SessionTool.ts +25 -0
  382. package/src/types/session/SessionTurn.ts +56 -0
  383. package/tsconfig.tsbuildinfo +1 -1
  384. package/bin/agent/local/Agent.d.ts.map +0 -1
  385. package/bin/agent/local/Agent.js +0 -216
  386. package/bin/agent/local/Agent.js.map +0 -1
  387. package/bin/agent/local/AgentInstructions.d.ts.map +0 -1
  388. package/bin/agent/local/AgentInstructions.js.map +0 -1
  389. package/bin/agent/local/AgentPluginFactory.d.ts +0 -26
  390. package/bin/agent/local/AgentPluginFactory.d.ts.map +0 -1
  391. package/bin/agent/local/AgentPluginFactory.js +0 -33
  392. package/bin/agent/local/AgentPluginFactory.js.map +0 -1
  393. package/bin/agent/local/AgentRuntimeAssembly.d.ts +0 -10
  394. package/bin/agent/local/AgentRuntimeAssembly.d.ts.map +0 -1
  395. package/bin/agent/local/AgentRuntimeAssembly.js +0 -43
  396. package/bin/agent/local/AgentRuntimeAssembly.js.map +0 -1
  397. package/bin/agent/local/ProjectSetup.d.ts.map +0 -1
  398. package/bin/agent/local/ProjectSetup.js.map +0 -1
  399. package/bin/agent/local/services/AgentAssemblyService.d.ts +0 -105
  400. package/bin/agent/local/services/AgentAssemblyService.d.ts.map +0 -1
  401. package/bin/agent/local/services/AgentAssemblyService.js +0 -184
  402. package/bin/agent/local/services/AgentAssemblyService.js.map +0 -1
  403. package/bin/agent/local/services/AgentBackgroundService.d.ts +0 -55
  404. package/bin/agent/local/services/AgentBackgroundService.d.ts.map +0 -1
  405. package/bin/agent/local/services/AgentBackgroundService.js +0 -85
  406. package/bin/agent/local/services/AgentBackgroundService.js.map +0 -1
  407. package/bin/agent/local/services/AgentSessions.d.ts.map +0 -1
  408. package/bin/agent/local/services/AgentSessions.js.map +0 -1
  409. package/bin/agent/remote/RemoteAgent.d.ts.map +0 -1
  410. package/bin/agent/remote/RemoteAgent.js.map +0 -1
  411. package/bin/agent/remote/RemoteSession.d.ts.map +0 -1
  412. package/bin/agent/remote/RemoteSession.js.map +0 -1
  413. package/bin/agent/remote/RemoteTransport.d.ts.map +0 -1
  414. package/bin/agent/remote/RemoteTransport.js.map +0 -1
  415. package/bin/agent/remote/TransportFactory.d.ts.map +0 -1
  416. package/bin/agent/remote/TransportFactory.js.map +0 -1
  417. package/bin/agent/remote/transports/HttpRemoteAgentTransport.d.ts.map +0 -1
  418. package/bin/agent/remote/transports/HttpRemoteAgentTransport.js.map +0 -1
  419. package/bin/agent/remote/transports/RpcRemoteAgentTransport.d.ts.map +0 -1
  420. package/bin/agent/remote/transports/RpcRemoteAgentTransport.js.map +0 -1
  421. package/bin/executor/SessionRunScope.d.ts +0 -68
  422. package/bin/executor/SessionRunScope.d.ts.map +0 -1
  423. package/bin/executor/SessionRunScope.js +0 -96
  424. package/bin/executor/SessionRunScope.js.map +0 -1
  425. package/bin/executor/composer/compaction/SessionCompactionComposer.d.ts +0 -74
  426. package/bin/executor/composer/compaction/SessionCompactionComposer.d.ts.map +0 -1
  427. package/bin/executor/composer/compaction/SessionCompactionComposer.js +0 -9
  428. package/bin/executor/composer/compaction/SessionCompactionComposer.js.map +0 -1
  429. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.d.ts +0 -27
  430. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.d.ts.map +0 -1
  431. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js +0 -39
  432. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js.map +0 -1
  433. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.d.ts +0 -44
  434. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.d.ts.map +0 -1
  435. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js +0 -218
  436. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js.map +0 -1
  437. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.d.ts +0 -27
  438. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.d.ts.map +0 -1
  439. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js +0 -181
  440. package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js.map +0 -1
  441. package/bin/executor/composer/context/LocalSessionContextComposer.d.ts +0 -50
  442. package/bin/executor/composer/context/LocalSessionContextComposer.d.ts.map +0 -1
  443. package/bin/executor/composer/context/LocalSessionContextComposer.js +0 -108
  444. package/bin/executor/composer/context/LocalSessionContextComposer.js.map +0 -1
  445. package/bin/executor/composer/context/SessionContextComposer.d.ts +0 -67
  446. package/bin/executor/composer/context/SessionContextComposer.d.ts.map +0 -1
  447. package/bin/executor/composer/context/SessionContextComposer.js +0 -9
  448. package/bin/executor/composer/context/SessionContextComposer.js.map +0 -1
  449. package/bin/executor/composer/history/SessionHistoryComposer.d.ts +0 -54
  450. package/bin/executor/composer/history/SessionHistoryComposer.d.ts.map +0 -1
  451. package/bin/executor/composer/history/SessionHistoryComposer.js +0 -10
  452. package/bin/executor/composer/history/SessionHistoryComposer.js.map +0 -1
  453. package/bin/executor/composer/history/SessionHistoryWriter.d.ts +0 -46
  454. package/bin/executor/composer/history/SessionHistoryWriter.d.ts.map +0 -1
  455. package/bin/executor/composer/history/SessionHistoryWriter.js +0 -65
  456. package/bin/executor/composer/history/SessionHistoryWriter.js.map +0 -1
  457. package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts +0 -35
  458. package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts.map +0 -1
  459. package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.js +0 -105
  460. package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.js.map +0 -1
  461. package/bin/executor/messages/AssistantResultPersistence.d.ts +0 -66
  462. package/bin/executor/messages/AssistantResultPersistence.d.ts.map +0 -1
  463. package/bin/executor/messages/AssistantResultPersistence.js +0 -44
  464. package/bin/executor/messages/AssistantResultPersistence.js.map +0 -1
  465. package/bin/executor/services/ExecutorInflightService.d.ts +0 -34
  466. package/bin/executor/services/ExecutorInflightService.d.ts.map +0 -1
  467. package/bin/executor/services/ExecutorInflightService.js +0 -73
  468. package/bin/executor/services/ExecutorInflightService.js.map +0 -1
  469. package/bin/executor/store/history/SessionHistoryStore.d.ts +0 -140
  470. package/bin/executor/store/history/SessionHistoryStore.d.ts.map +0 -1
  471. package/bin/executor/store/history/SessionHistoryStore.js +0 -10
  472. package/bin/executor/store/history/SessionHistoryStore.js.map +0 -1
  473. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts +0 -116
  474. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts.map +0 -1
  475. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js +0 -709
  476. package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.js.map +0 -1
  477. package/bin/executor/types/SessionHistoryPaths.d.ts +0 -34
  478. package/bin/executor/types/SessionHistoryPaths.d.ts.map +0 -1
  479. package/bin/executor/types/SessionHistoryPaths.js +0 -2
  480. package/bin/executor/types/SessionHistoryPaths.js.map +0 -1
  481. package/bin/model/CityModelAdapter.d.ts.map +0 -1
  482. package/bin/model/CityModelAdapter.js.map +0 -1
  483. package/bin/rpc/Client.d.ts.map +0 -1
  484. package/bin/rpc/Client.js.map +0 -1
  485. package/bin/session/SessionSystemBuilder.d.ts +0 -107
  486. package/bin/session/SessionSystemBuilder.d.ts.map +0 -1
  487. package/bin/session/SessionSystemBuilder.js +0 -148
  488. package/bin/session/SessionSystemBuilder.js.map +0 -1
  489. package/bin/session/recorder/SessionMessageCodec.d.ts.map +0 -1
  490. package/bin/session/recorder/SessionMessageCodec.js.map +0 -1
  491. package/bin/session/recorder/SessionRecorder.d.ts +0 -217
  492. package/bin/session/recorder/SessionRecorder.d.ts.map +0 -1
  493. package/bin/session/recorder/SessionRecorder.js.map +0 -1
  494. package/bin/session/recorder/SessionRecorderCompaction.d.ts +0 -18
  495. package/bin/session/recorder/SessionRecorderCompaction.d.ts.map +0 -1
  496. package/bin/session/recorder/SessionRecorderCompaction.js.map +0 -1
  497. package/bin/session/recorder/SessionRecorderHistoryStore.d.ts +0 -66
  498. package/bin/session/recorder/SessionRecorderHistoryStore.d.ts.map +0 -1
  499. package/bin/session/recorder/SessionRecorderHistoryStore.js +0 -190
  500. package/bin/session/recorder/SessionRecorderHistoryStore.js.map +0 -1
  501. package/bin/session/runtime/SessionPromptRuntime.d.ts +0 -112
  502. package/bin/session/runtime/SessionPromptRuntime.d.ts.map +0 -1
  503. package/bin/session/runtime/SessionPromptRuntime.js +0 -357
  504. package/bin/session/runtime/SessionPromptRuntime.js.map +0 -1
  505. package/bin/session/services/SessionStateService.d.ts +0 -187
  506. package/bin/session/services/SessionStateService.d.ts.map +0 -1
  507. package/bin/session/services/SessionStateService.js +0 -467
  508. package/bin/session/services/SessionStateService.js.map +0 -1
  509. package/bin/session/services/SessionTurnService.d.ts +0 -90
  510. package/bin/session/services/SessionTurnService.d.ts.map +0 -1
  511. package/bin/session/services/SessionTurnService.js +0 -293
  512. package/bin/session/services/SessionTurnService.js.map +0 -1
  513. package/bin/session/services/SessionViewService.d.ts +0 -114
  514. package/bin/session/services/SessionViewService.d.ts.map +0 -1
  515. package/bin/session/services/SessionViewService.js +0 -204
  516. package/bin/session/services/SessionViewService.js.map +0 -1
  517. package/bin/session/storage/Persistence.d.ts +0 -73
  518. package/bin/session/storage/Persistence.d.ts.map +0 -1
  519. package/bin/session/storage/Persistence.js +0 -63
  520. package/bin/session/storage/Persistence.js.map +0 -1
  521. package/bin/types/agent/AgentRuntimeAssembly.d.ts +0 -72
  522. package/bin/types/agent/AgentRuntimeAssembly.d.ts.map +0 -1
  523. package/bin/types/agent/AgentRuntimeAssembly.js +0 -10
  524. package/bin/types/agent/AgentRuntimeAssembly.js.map +0 -1
  525. package/bin/types/runtime/agent/AgentContext.d.ts +0 -306
  526. package/bin/types/runtime/agent/AgentContext.d.ts.map +0 -1
  527. package/bin/types/runtime/agent/AgentContext.js +0 -128
  528. package/bin/types/runtime/agent/AgentContext.js.map +0 -1
  529. package/bin/types/session/SessionComposerOptions.d.ts +0 -90
  530. package/bin/types/session/SessionComposerOptions.d.ts.map +0 -1
  531. package/bin/types/session/SessionComposerOptions.js +0 -10
  532. package/bin/types/session/SessionComposerOptions.js.map +0 -1
  533. package/bin/types/session/SessionQueueCommand.d.ts +0 -68
  534. package/bin/types/session/SessionQueueCommand.d.ts.map +0 -1
  535. package/bin/types/session/SessionQueueCommand.js +0 -10
  536. package/bin/types/session/SessionQueueCommand.js.map +0 -1
  537. package/scripts/session-action-message.test.mjs +0 -410
  538. package/scripts/session-compaction-context-window.test.mjs +0 -96
  539. package/scripts/session-history-inflight.test.mjs +0 -146
  540. package/scripts/session-history-writer-error.test.mjs +0 -57
  541. package/scripts/session-prompt-runtime.test.mjs +0 -390
  542. package/src/agent/local/Agent.ts +0 -250
  543. package/src/agent/local/AgentPluginFactory.ts +0 -51
  544. package/src/agent/local/AgentRuntimeAssembly.ts +0 -65
  545. package/src/agent/local/services/AgentAssemblyService.ts +0 -307
  546. package/src/agent/local/services/AgentBackgroundService.ts +0 -115
  547. package/src/executor/SessionRunScope.ts +0 -122
  548. package/src/executor/composer/compaction/SessionCompactionComposer.ts +0 -84
  549. package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts +0 -51
  550. package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts +0 -294
  551. package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.ts +0 -197
  552. package/src/executor/composer/context/LocalSessionContextComposer.ts +0 -175
  553. package/src/executor/composer/context/SessionContextComposer.ts +0 -83
  554. package/src/executor/composer/history/SessionHistoryComposer.ts +0 -62
  555. package/src/executor/composer/history/SessionHistoryWriter.ts +0 -100
  556. package/src/executor/composer/history/jsonl/JsonlSessionHistoryComposer.ts +0 -133
  557. package/src/executor/messages/AssistantResultPersistence.ts +0 -106
  558. package/src/executor/services/ExecutorInflightService.ts +0 -95
  559. package/src/executor/store/history/SessionHistoryStore.ts +0 -172
  560. package/src/executor/store/history/jsonl/JsonlSessionHistoryStore.ts +0 -879
  561. package/src/executor/types/SessionHistoryPaths.ts +0 -38
  562. package/src/session/SessionSystemBuilder.ts +0 -262
  563. package/src/session/recorder/SessionRecorderHistoryStore.ts +0 -256
  564. package/src/session/runtime/SessionPromptRuntime.ts +0 -518
  565. package/src/session/services/SessionStateService.ts +0 -628
  566. package/src/session/services/SessionTurnService.ts +0 -368
  567. package/src/session/services/SessionViewService.ts +0 -335
  568. package/src/session/storage/Persistence.ts +0 -137
  569. package/src/types/agent/AgentRuntimeAssembly.ts +0 -74
  570. package/src/types/runtime/agent/AgentContext.ts +0 -387
  571. package/src/types/session/SessionComposerOptions.ts +0 -107
  572. package/src/types/session/SessionQueueCommand.ts +0 -78
  573. /package/bin/{agent/local → config}/ProjectSetup.d.ts +0 -0
  574. /package/bin/{agent/remote → remote}/RemoteTransport.js +0 -0
  575. /package/bin/session/{recorder → messages}/JsonlSessionMessageStore.d.ts +0 -0
  576. /package/bin/session/{recorder → messages}/JsonlSessionMessageStore.js +0 -0
  577. /package/src/{agent/local → config}/ProjectSetup.ts +0 -0
  578. /package/src/session/{recorder → messages}/JsonlSessionMessageStore.ts +0 -0
@@ -1,709 +0,0 @@
1
- /**
2
- * JsonlSessionHistoryStore:基于 JSONL 的 session records 事实源。
3
- *
4
- * 关键点(中文)
5
- * - 负责 `.downcity/.../messages/messages.jsonl`、`meta.json`、archive 与文件锁。
6
- * - append 与 compact 共用同一把文件锁,避免并发覆盖。
7
- * - 不负责为模型组装 messages;组装逻辑放在 `JsonlSessionHistoryComposer`。
8
- */
9
- import fs from "fs-extra";
10
- import { open as openFile, readFile as readFileNative, stat as statNative, } from "node:fs/promises";
11
- import path from "node:path";
12
- import { generateId } from "../../../../utils/Id.js";
13
- import { getLogger } from "../../../../utils/logger/Logger.js";
14
- import { compactSessionMessagesIfNeeded } from "../../../composer/compaction/jsonl/JsonlSessionCompactionExecutor.js";
15
- import { is_session_action_record, is_session_message_record, to_session_action_record, } from "../../../../executor/types/SessionRecords.js";
16
- import { resolve_session_message_preview } from "../../../../session/preview/SessionMessagePreview.js";
17
- function getDowncityDirPath(rootPath) {
18
- return path.join(rootPath, ".downcity");
19
- }
20
- function getDowncityAgentsRootDirPath(rootPath) {
21
- return path.join(getDowncityDirPath(rootPath), "agents");
22
- }
23
- function getDowncitySessionRootDirPath(rootPath, agentId) {
24
- return path.join(getDowncityAgentsRootDirPath(rootPath), encodeURIComponent(agentId), "sessions");
25
- }
26
- function getDowncitySessionDirPath(rootPath, agentId, sessionId) {
27
- return path.join(getDowncitySessionRootDirPath(rootPath, agentId), encodeURIComponent(sessionId));
28
- }
29
- function getDowncitySessionMessagesDirPath(rootPath, agentId, sessionId) {
30
- return path.join(getDowncitySessionDirPath(rootPath, agentId, sessionId), "messages");
31
- }
32
- /**
33
- * JSONL Session history store。
34
- */
35
- export class JsonlSessionHistoryStore {
36
- sessionId;
37
- rootPath;
38
- agentId;
39
- overrideSessionDirPath;
40
- overrideMessagesDirPath;
41
- overrideMessagesFilePath;
42
- overrideMetaFilePath;
43
- overrideArchiveDirPath;
44
- overrideInflightFilePath;
45
- constructor(options) {
46
- const rootPath = String(options.rootPath || "").trim();
47
- if (!rootPath) {
48
- throw new Error("JsonlSessionHistoryStore requires a non-empty rootPath");
49
- }
50
- const sessionId = String(options.sessionId || "").trim();
51
- if (!sessionId) {
52
- throw new Error("JsonlSessionHistoryStore requires a non-empty sessionId");
53
- }
54
- this.rootPath = rootPath;
55
- this.sessionId = sessionId;
56
- this.agentId = this.readOptionalPath(options.agentId);
57
- this.overrideSessionDirPath = this.readOptionalPath(options.paths?.sessionDirPath);
58
- this.overrideMessagesDirPath = this.readOptionalPath(options.paths?.messagesDirPath);
59
- this.overrideMessagesFilePath = this.readOptionalPath(options.paths?.messagesFilePath);
60
- this.overrideMetaFilePath = this.readOptionalPath(options.paths?.metaFilePath);
61
- this.overrideArchiveDirPath = this.readOptionalPath(options.paths?.archiveDirPath);
62
- this.overrideInflightFilePath = this.readOptionalPath(options.paths?.inflightFilePath);
63
- }
64
- readOptionalPath(value) {
65
- const out = String(value || "").trim();
66
- return out || undefined;
67
- }
68
- getMessagesDirPath() {
69
- if (this.overrideMessagesDirPath)
70
- return this.overrideMessagesDirPath;
71
- if (this.overrideSessionDirPath) {
72
- return path.join(this.overrideSessionDirPath, "messages");
73
- }
74
- if (!this.agentId) {
75
- throw new Error("JsonlSessionHistoryStore requires agentId when default session paths are used");
76
- }
77
- return getDowncitySessionMessagesDirPath(this.rootPath, this.agentId, this.sessionId);
78
- }
79
- getMessagesFilePath() {
80
- if (this.overrideMessagesFilePath)
81
- return this.overrideMessagesFilePath;
82
- if (this.overrideMessagesDirPath) {
83
- return path.join(this.overrideMessagesDirPath, "messages.jsonl");
84
- }
85
- return path.join(this.getMessagesDirPath(), "messages.jsonl");
86
- }
87
- getMetaFilePath() {
88
- if (this.overrideMetaFilePath)
89
- return this.overrideMetaFilePath;
90
- if (this.overrideMessagesDirPath) {
91
- return path.join(this.overrideMessagesDirPath, "meta.json");
92
- }
93
- return path.join(this.getMessagesDirPath(), "meta.json");
94
- }
95
- getArchiveDirPath() {
96
- if (this.overrideArchiveDirPath)
97
- return this.overrideArchiveDirPath;
98
- if (this.overrideMessagesDirPath) {
99
- return path.join(this.overrideMessagesDirPath, "archive");
100
- }
101
- return path.join(this.getMessagesDirPath(), "archive");
102
- }
103
- getInflightFilePath() {
104
- if (this.overrideInflightFilePath)
105
- return this.overrideInflightFilePath;
106
- if (this.overrideMessagesDirPath) {
107
- return path.join(this.overrideMessagesDirPath, "assistant_message.json");
108
- }
109
- return path.join(this.getMessagesDirPath(), "assistant_message.json");
110
- }
111
- getLockFilePath() {
112
- return path.join(this.getMessagesDirPath(), ".session.lock");
113
- }
114
- async ensureLayout() {
115
- // 关键点(中文):以 messages 目录为最小落盘单元,统一保证 messages/meta/archive 可写。
116
- await fs.ensureDir(this.getMessagesDirPath());
117
- await fs.ensureDir(this.getArchiveDirPath());
118
- await fs.ensureFile(this.getMessagesFilePath());
119
- }
120
- normalizeText(input) {
121
- const value = typeof input === "string" ? input.trim() : "";
122
- return value || undefined;
123
- }
124
- normalizePersistedMessage(input) {
125
- if (!input || typeof input !== "object")
126
- return null;
127
- if (input.type === "action") {
128
- return this.normalize_action_record(input);
129
- }
130
- const candidate = input;
131
- const role = String(candidate.role || "");
132
- if (role !== "user" && role !== "assistant") {
133
- return null;
134
- }
135
- if (!Array.isArray(candidate.parts))
136
- return null;
137
- return input;
138
- }
139
- normalize_action_record(input) {
140
- if (!input || typeof input !== "object")
141
- return null;
142
- const candidate = input;
143
- const id = String(candidate.id || "").trim();
144
- const title = String(candidate.title || "").trim();
145
- const state = String(candidate.state || "").trim();
146
- if (!id || !title)
147
- return null;
148
- if (state !== "running" && state !== "completed" && state !== "failed") {
149
- return null;
150
- }
151
- const metadata_input = candidate.metadata && typeof candidate.metadata === "object"
152
- ? candidate.metadata
153
- : {};
154
- const metadata_candidate = metadata_input;
155
- const session_id = String(metadata_candidate.sessionId || "").trim() || this.sessionId;
156
- const description = String(candidate.description || "").trim();
157
- return {
158
- type: "action",
159
- id,
160
- title,
161
- ...(description ? { description } : {}),
162
- state,
163
- metadata: {
164
- v: 1,
165
- ts: typeof metadata_candidate.ts === "number"
166
- ? metadata_candidate.ts
167
- : Date.now(),
168
- sessionId: session_id,
169
- ...(metadata_candidate.turnId ? { turnId: metadata_candidate.turnId } : {}),
170
- },
171
- };
172
- }
173
- hasStructuredAssistantParts(message) {
174
- if (!is_session_message_record(message) ||
175
- message.role !== "assistant" ||
176
- !Array.isArray(message.parts)) {
177
- return false;
178
- }
179
- return message.parts.some((part) => {
180
- if (!part || typeof part !== "object")
181
- return false;
182
- const type = typeof part.type === "string" ? part.type.trim() : "";
183
- return Boolean(type) && type !== "text";
184
- });
185
- }
186
- mergeInflightWithFinal(inflight, finalMessage) {
187
- if (!is_session_message_record(finalMessage))
188
- return inflight;
189
- if (!is_session_message_record(inflight))
190
- return finalMessage;
191
- const final_parts = Array.isArray(finalMessage.parts)
192
- ? finalMessage.parts.filter((part) => part && typeof part === "object")
193
- : [];
194
- if (this.hasStructuredAssistantParts(finalMessage)) {
195
- return finalMessage;
196
- }
197
- if (final_parts.length === 0)
198
- return inflight;
199
- const inflight_parts = Array.isArray(inflight.parts)
200
- ? inflight.parts
201
- : [];
202
- const last_inflight_part = inflight_parts.length > 0 ? inflight_parts[inflight_parts.length - 1] : undefined;
203
- const last_inflight_text = last_inflight_part &&
204
- typeof last_inflight_part === "object" &&
205
- last_inflight_part.type === "text" &&
206
- typeof last_inflight_part.text === "string"
207
- ? last_inflight_part.text.trim()
208
- : "";
209
- const append_parts = final_parts.filter((part, index) => {
210
- if (index > 0)
211
- return true;
212
- if (!part || typeof part !== "object" || part.type !== "text")
213
- return true;
214
- const next_text = typeof part.text === "string" ? part.text.trim() : "";
215
- if (!next_text)
216
- return false;
217
- return next_text !== last_inflight_text;
218
- });
219
- return {
220
- ...inflight,
221
- id: finalMessage.id,
222
- metadata: {
223
- ...(inflight.metadata || {
224
- v: 1,
225
- ts: Date.now(),
226
- sessionId: this.sessionId,
227
- }),
228
- ...(finalMessage.metadata || {}),
229
- },
230
- parts: [...inflight_parts, ...append_parts],
231
- };
232
- }
233
- async readMetaUnsafe() {
234
- const file = this.getMetaFilePath();
235
- try {
236
- const raw = (await fs.readJson(file));
237
- if (!raw || typeof raw !== "object")
238
- throw new Error("invalid_meta");
239
- return {
240
- v: 1,
241
- sessionId: this.sessionId,
242
- ...(typeof raw.agentId === "string" && raw.agentId.trim()
243
- ? { agentId: raw.agentId.trim() }
244
- : {}),
245
- ...(typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt)
246
- ? { createdAt: raw.createdAt }
247
- : {}),
248
- ...(this.normalizeText(raw.timezone)
249
- ? { timezone: this.normalizeText(raw.timezone) }
250
- : {}),
251
- updatedAt: typeof raw.updatedAt === "number" ? raw.updatedAt : 0,
252
- ...(this.normalizeText(raw.title)
253
- ? { title: this.normalizeText(raw.title) }
254
- : {}),
255
- ...(this.normalizeText(raw.modelLabel)
256
- ? { modelLabel: this.normalizeText(raw.modelLabel) }
257
- : {}),
258
- ...(typeof raw.messageCount === "number" &&
259
- Number.isInteger(raw.messageCount) &&
260
- raw.messageCount >= 0
261
- ? { messageCount: raw.messageCount }
262
- : {}),
263
- ...(this.normalizeText(raw.previewText)
264
- ? { previewText: this.normalizeText(raw.previewText) }
265
- : {}),
266
- ...(typeof raw.historyBytes === "number" &&
267
- Number.isInteger(raw.historyBytes) &&
268
- raw.historyBytes >= 0
269
- ? { historyBytes: raw.historyBytes }
270
- : {}),
271
- };
272
- }
273
- catch {
274
- return {
275
- v: 1,
276
- sessionId: this.sessionId,
277
- createdAt: Date.now(),
278
- updatedAt: 0,
279
- };
280
- }
281
- }
282
- async writeMetaUnsafe(next) {
283
- const normalized = {
284
- v: 1,
285
- sessionId: this.sessionId,
286
- ...(typeof next.agentId === "string" && next.agentId.trim()
287
- ? { agentId: next.agentId.trim() }
288
- : {}),
289
- ...(typeof next.createdAt === "number" && Number.isFinite(next.createdAt)
290
- ? { createdAt: next.createdAt }
291
- : {}),
292
- ...(this.normalizeText(next.timezone)
293
- ? { timezone: this.normalizeText(next.timezone) }
294
- : {}),
295
- updatedAt: typeof next.updatedAt === "number" ? next.updatedAt : Date.now(),
296
- ...(this.normalizeText(next.title)
297
- ? { title: this.normalizeText(next.title) }
298
- : {}),
299
- ...(this.normalizeText(next.modelLabel)
300
- ? { modelLabel: this.normalizeText(next.modelLabel) }
301
- : {}),
302
- ...(typeof next.messageCount === "number" &&
303
- Number.isInteger(next.messageCount) &&
304
- next.messageCount >= 0
305
- ? { messageCount: next.messageCount }
306
- : {}),
307
- ...(this.normalizeText(next.previewText)
308
- ? { previewText: this.normalizeText(next.previewText) }
309
- : {}),
310
- ...(typeof next.historyBytes === "number" &&
311
- Number.isInteger(next.historyBytes) &&
312
- next.historyBytes >= 0
313
- ? { historyBytes: next.historyBytes }
314
- : {}),
315
- };
316
- await fs.writeJson(this.getMetaFilePath(), normalized, { spaces: 2 });
317
- }
318
- async read_inflight_unsafe() {
319
- const file = this.getInflightFilePath();
320
- try {
321
- const raw = await fs.readJson(file);
322
- return this.normalizePersistedMessage(raw);
323
- }
324
- catch {
325
- return null;
326
- }
327
- }
328
- async write_inflight_unsafe(message) {
329
- const normalized = this.normalizePersistedMessage(message);
330
- if (!is_session_message_record(normalized) ||
331
- normalized.role !== "assistant") {
332
- throw new Error("inflight assistant must be an assistant UIMessage");
333
- }
334
- const file = this.getInflightFilePath();
335
- const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
336
- await fs.ensureDir(path.dirname(file));
337
- await fs.writeJson(temp, normalized, { spaces: 2 });
338
- await fs.move(temp, file, { overwrite: true });
339
- }
340
- async removeInflightUnsafe() {
341
- await fs.remove(this.getInflightFilePath());
342
- }
343
- async appendMessageUnsafe(message) {
344
- await fs.appendFile(this.getMessagesFilePath(), JSON.stringify(message) + "\n", "utf8");
345
- }
346
- async get_history_bytes_unsafe() {
347
- try {
348
- const file_stat = await statNative(this.getMessagesFilePath());
349
- return file_stat.size;
350
- }
351
- catch {
352
- return 0;
353
- }
354
- }
355
- async read_persisted_records_unsafe() {
356
- const raw = await fs.readFile(this.getMessagesFilePath(), "utf8").catch(() => "");
357
- const records = [];
358
- for (const line of raw.split("\n").filter(Boolean)) {
359
- try {
360
- const record = this.normalizePersistedMessage(JSON.parse(line));
361
- if (record)
362
- records.push(record);
363
- }
364
- catch {
365
- // 关键点(中文):摘要重建跳过损坏行,与正式历史读取语义保持一致。
366
- }
367
- }
368
- return records;
369
- }
370
- async write_history_summary_unsafe(records) {
371
- const current = await this.readMetaUnsafe();
372
- const last_record = records[records.length - 1];
373
- const preview_text = last_record
374
- ? resolve_session_message_preview(last_record).slice(0, 180).trim()
375
- : "";
376
- const { previewText: _previous_preview, ...metadata_without_preview } = current;
377
- void _previous_preview;
378
- await this.writeMetaUnsafe({
379
- ...metadata_without_preview,
380
- updatedAt: Date.now(),
381
- messageCount: records.length,
382
- historyBytes: await this.get_history_bytes_unsafe(),
383
- ...(preview_text ? { previewText: preview_text } : {}),
384
- });
385
- }
386
- async update_history_summary_after_append_unsafe(input) {
387
- if (input.appended_records.length === 0)
388
- return;
389
- const current = await this.readMetaUnsafe();
390
- const previous_message_count = current.messageCount;
391
- if (current.historyBytes !== input.previous_history_bytes ||
392
- typeof previous_message_count !== "number") {
393
- await this.write_history_summary_unsafe(await this.read_persisted_records_unsafe());
394
- return;
395
- }
396
- const last_record = input.appended_records[input.appended_records.length - 1];
397
- const preview_text = resolve_session_message_preview(last_record)
398
- .slice(0, 180)
399
- .trim();
400
- const { previewText: _previous_preview, ...metadata_without_preview } = current;
401
- void _previous_preview;
402
- await this.writeMetaUnsafe({
403
- ...metadata_without_preview,
404
- updatedAt: Date.now(),
405
- messageCount: previous_message_count + input.appended_records.length,
406
- historyBytes: await this.get_history_bytes_unsafe(),
407
- ...(preview_text ? { previewText: preview_text } : {}),
408
- });
409
- }
410
- async rewriteMessagesUnsafe(messages) {
411
- const file = this.getMessagesFilePath();
412
- const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
413
- const payload = messages.length > 0
414
- ? messages.map((message) => JSON.stringify(message)).join("\n") + "\n"
415
- : "";
416
- await fs.writeFile(temp, payload, "utf8");
417
- await fs.move(temp, file, { overwrite: true });
418
- }
419
- async upsert_action_record_unsafe(message) {
420
- const file = this.getMessagesFilePath();
421
- const raw = await fs.readFile(file, "utf8").catch(() => "");
422
- const messages = [];
423
- let replaced = false;
424
- for (const line of raw.split("\n").filter(Boolean)) {
425
- try {
426
- const current = this.normalizePersistedMessage(JSON.parse(line));
427
- if (!current)
428
- continue;
429
- if (is_session_action_record(current) && current.id === message.id) {
430
- messages.push(message);
431
- replaced = true;
432
- continue;
433
- }
434
- messages.push(current);
435
- }
436
- catch {
437
- // 关键点(中文):重写 action 时顺手跳过损坏行,避免坏 JSON 阻断状态更新。
438
- }
439
- }
440
- if (!replaced)
441
- messages.push(message);
442
- await this.rewriteMessagesUnsafe(messages);
443
- return messages;
444
- }
445
- async withWriteLock(fn) {
446
- await this.ensureLayout();
447
- const lockPath = this.getLockFilePath();
448
- const token = `${process.pid}:${Date.now()}:${generateId()}`;
449
- const logger = getLogger(this.rootPath, "info");
450
- // 关键点(中文):append 与 compact 共用同一把文件锁,防止 rewrite 覆盖 append。
451
- const staleMs = 30_000;
452
- const start = Date.now();
453
- while (true) {
454
- try {
455
- const fh = await openFile(lockPath, "wx");
456
- await fh.writeFile(token, "utf8");
457
- await fh.close();
458
- break;
459
- }
460
- catch (error) {
461
- const err = error;
462
- if (err.code !== "EEXIST")
463
- throw err;
464
- try {
465
- const stat = await statNative(lockPath);
466
- const age = Date.now() - stat.mtimeMs;
467
- if (age > staleMs) {
468
- await fs.remove(lockPath);
469
- await logger.log("warn", "Removed stale session lock", {
470
- sessionId: this.sessionId,
471
- lockPath,
472
- ageMs: age,
473
- });
474
- continue;
475
- }
476
- }
477
- catch {
478
- // ignore
479
- }
480
- if (Date.now() - start > staleMs * 2) {
481
- throw new Error(`Context lock timeout: ${lockPath}`);
482
- }
483
- await new Promise((resolve) => setTimeout(resolve, 60));
484
- }
485
- }
486
- try {
487
- return await fn();
488
- }
489
- finally {
490
- try {
491
- const current = await readFileNative(lockPath, "utf8");
492
- if (String(current || "").trim() === token) {
493
- await fs.remove(lockPath);
494
- }
495
- }
496
- catch {
497
- // ignore
498
- }
499
- }
500
- }
501
- normalizeSystem(system) {
502
- if (!Array.isArray(system))
503
- return [];
504
- return system.filter((item) => item && typeof item === "object");
505
- }
506
- async compact(input) {
507
- return await compactSessionMessagesIfNeeded({
508
- rootPath: this.rootPath,
509
- sessionId: this.sessionId,
510
- withWriteLock: (fn) => this.withWriteLock(fn),
511
- loadAll: () => this.list_records(),
512
- createSummaryMessage: ({ text, archiveId, sourceRange }) => ({
513
- id: `a:${this.sessionId}:${generateId()}`,
514
- role: "assistant",
515
- metadata: {
516
- v: 1,
517
- ts: Date.now(),
518
- sessionId: this.sessionId,
519
- source: "compact",
520
- kind: "summary",
521
- ...(archiveId ? { archiveId } : {}),
522
- ...(sourceRange ? { sourceRange } : {}),
523
- },
524
- parts: [{ type: "text", text: String(text ?? "") }],
525
- }),
526
- getArchiveDirPath: () => this.getArchiveDirPath(),
527
- getMessagesFilePath: () => this.getMessagesFilePath(),
528
- writeHistorySummaryUnsafe: (records) => this.write_history_summary_unsafe(records),
529
- }, {
530
- model: input.model,
531
- system: this.normalizeSystem(input.system),
532
- archiveOnCompact: false,
533
- force: input.force,
534
- ...(input.onAction ? { onAction: input.onAction } : {}),
535
- });
536
- }
537
- async write_record(message) {
538
- await this.withWriteLock(async () => {
539
- const normalized = this.normalizePersistedMessage(message);
540
- if (!normalized)
541
- return;
542
- if (is_session_action_record(normalized)) {
543
- const records = await this.upsert_action_record_unsafe(normalized);
544
- await this.write_history_summary_unsafe(records);
545
- return;
546
- }
547
- const previous_history_bytes = await this.get_history_bytes_unsafe();
548
- const appended_records = [];
549
- // 关键点(中文):若上一次 assistant 在运行中中断,新的 user 到来前先把残留快照收口到正式历史,
550
- // 避免 `list_records()` 时旧 inflight 跑到新 user 后面,打乱时序。
551
- if (is_session_message_record(normalized) && normalized.role === "user") {
552
- const current_inflight = await this.read_inflight_unsafe();
553
- if (current_inflight) {
554
- await this.appendMessageUnsafe(current_inflight);
555
- appended_records.push(current_inflight);
556
- await this.removeInflightUnsafe();
557
- }
558
- }
559
- await this.appendMessageUnsafe(normalized);
560
- appended_records.push(normalized);
561
- await this.update_history_summary_after_append_unsafe({
562
- previous_history_bytes,
563
- appended_records,
564
- });
565
- });
566
- }
567
- /**
568
- * 批量追加消息。
569
- *
570
- * 关键点(中文)
571
- * - 一次锁、一次 IO,适合 fork 等需要拷贝整段历史的场景。
572
- * - 不处理 inflight,调用方需自行确保历史已经收口。
573
- */
574
- async write_records(messages) {
575
- if (!Array.isArray(messages) || messages.length === 0)
576
- return;
577
- const normalized_list = messages
578
- .map((message) => this.normalizePersistedMessage(message))
579
- .filter((message) => message !== null);
580
- if (normalized_list.length === 0)
581
- return;
582
- const payload = normalized_list
583
- .map((message) => `${JSON.stringify(message)}\n`)
584
- .join("");
585
- await this.withWriteLock(async () => {
586
- const previous_history_bytes = await this.get_history_bytes_unsafe();
587
- await fs.appendFile(this.getMessagesFilePath(), payload, "utf8");
588
- await this.update_history_summary_after_append_unsafe({
589
- previous_history_bytes,
590
- appended_records: normalized_list,
591
- });
592
- });
593
- }
594
- async read_inflight() {
595
- await this.ensureLayout();
596
- return this.read_inflight_unsafe();
597
- }
598
- async write_inflight(message) {
599
- await this.withWriteLock(async () => {
600
- await this.write_inflight_unsafe(message);
601
- });
602
- }
603
- async finalize_inflight(message) {
604
- await this.withWriteLock(async () => {
605
- const previous_history_bytes = await this.get_history_bytes_unsafe();
606
- const current_inflight = await this.read_inflight_unsafe();
607
- const normalized_message = this.normalizePersistedMessage(message);
608
- const final_message = current_inflight && normalized_message
609
- ? this.mergeInflightWithFinal(current_inflight, normalized_message)
610
- : normalized_message || current_inflight;
611
- if (final_message) {
612
- await this.appendMessageUnsafe(final_message);
613
- }
614
- if (current_inflight) {
615
- await this.removeInflightUnsafe();
616
- }
617
- if (final_message) {
618
- await this.update_history_summary_after_append_unsafe({
619
- previous_history_bytes,
620
- appended_records: [final_message],
621
- });
622
- }
623
- });
624
- }
625
- async list_records() {
626
- await this.ensureLayout();
627
- const file = this.getMessagesFilePath();
628
- const raw = await fs.readFile(file, "utf8");
629
- const lines = raw.split("\n").filter(Boolean);
630
- const out = [];
631
- for (const line of lines) {
632
- try {
633
- const obj = this.normalizePersistedMessage(JSON.parse(line));
634
- if (!obj)
635
- continue;
636
- out.push(obj);
637
- }
638
- catch {
639
- // ignore invalid lines
640
- }
641
- }
642
- const current_inflight = await this.read_inflight_unsafe();
643
- if (current_inflight) {
644
- out.push(current_inflight);
645
- }
646
- return out;
647
- }
648
- async slice_records(start, end) {
649
- const msgs = await this.list_records();
650
- const startIndex = Math.max(0, Math.floor(start));
651
- const endIndex = Math.max(startIndex, Math.floor(end));
652
- return msgs.slice(startIndex, endIndex);
653
- }
654
- async record_count() {
655
- const msgs = await this.list_records();
656
- return msgs.length;
657
- }
658
- async meta() {
659
- await this.ensureLayout();
660
- const metadata = await this.readMetaUnsafe();
661
- return (metadata && typeof metadata === "object" ? { ...metadata } : {});
662
- }
663
- userText(input) {
664
- const { ts, ...metadata } = input.metadata;
665
- const md = {
666
- v: 1,
667
- ts: typeof ts === "number" ? ts : Date.now(),
668
- ...metadata,
669
- source: "ingress",
670
- kind: "normal",
671
- };
672
- const id = input.id || `u:${this.sessionId}:${generateId()}`;
673
- return {
674
- id,
675
- role: "user",
676
- metadata: md,
677
- parts: [{ type: "text", text: String(input.text ?? "") }],
678
- };
679
- }
680
- assistantText(input) {
681
- const { ts, ...metadata } = input.metadata;
682
- const md = {
683
- v: 1,
684
- ts: typeof ts === "number" ? ts : Date.now(),
685
- ...metadata,
686
- source: input.source || "egress",
687
- kind: input.kind || "normal",
688
- };
689
- const id = input.id || `a:${this.sessionId}:${generateId()}`;
690
- return {
691
- id,
692
- role: "assistant",
693
- metadata: md,
694
- parts: [{ type: "text", text: String(input.text ?? "") }],
695
- };
696
- }
697
- action(input) {
698
- const { ts, ...metadata } = input.metadata;
699
- const message = to_session_action_record(input.id ? { ...input.action, id: input.id } : input.action, metadata.sessionId || this.sessionId);
700
- return {
701
- ...message,
702
- metadata: {
703
- ...message.metadata,
704
- ts: typeof ts === "number" ? ts : message.metadata.ts,
705
- },
706
- };
707
- }
708
- }
709
- //# sourceMappingURL=JsonlSessionHistoryStore.js.map