@vybestack/llxprt-code-core 0.11.0 → 0.12.0-nightly.260910.2aac6841e

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 (417) hide show
  1. package/dist/index.d.ts +1 -1
  2. package/dist/index.js +1 -1
  3. package/dist/index.js.map +1 -1
  4. package/dist/prompt-config/defaults/default-prompts.json +3 -3
  5. package/dist/src/config/agentClientLifecycle.d.ts +4 -3
  6. package/dist/src/config/agentClientLifecycle.js +27 -14
  7. package/dist/src/config/agentClientLifecycle.js.map +1 -1
  8. package/dist/src/config/config.d.ts +2 -5
  9. package/dist/src/config/config.js +10 -23
  10. package/dist/src/config/config.js.map +1 -1
  11. package/dist/src/config/configBase.d.ts +5 -1
  12. package/dist/src/config/configBase.js +27 -6
  13. package/dist/src/config/configBase.js.map +1 -1
  14. package/dist/src/config/configBaseCore.d.ts +26 -8
  15. package/dist/src/config/configBaseCore.js +30 -26
  16. package/dist/src/config/configBaseCore.js.map +1 -1
  17. package/dist/src/config/configMcpRuntime.d.ts +16 -0
  18. package/dist/src/config/configMcpRuntime.js +31 -0
  19. package/dist/src/config/configMcpRuntime.js.map +1 -0
  20. package/dist/src/config/configMediaDefaults.d.ts +10 -0
  21. package/dist/src/config/configMediaDefaults.js +17 -0
  22. package/dist/src/config/configMediaDefaults.js.map +1 -0
  23. package/dist/src/config/configTestHarness.d.ts +4 -0
  24. package/dist/src/config/configTypes.d.ts +4 -54
  25. package/dist/src/config/configTypes.js +6 -82
  26. package/dist/src/config/configTypes.js.map +1 -1
  27. package/dist/src/config/index.d.ts +1 -2
  28. package/dist/src/config/index.js +1 -2
  29. package/dist/src/config/index.js.map +1 -1
  30. package/dist/src/config/models.d.ts +0 -4
  31. package/dist/src/config/models.js +0 -4
  32. package/dist/src/config/models.js.map +1 -1
  33. package/dist/src/config/toolRegistryFactory.d.ts +2 -2
  34. package/dist/src/core/clientContract.d.ts +4 -6
  35. package/dist/src/core/compression/transcriptPathNotice.d.ts +22 -0
  36. package/dist/src/core/compression/transcriptPathNotice.js +29 -0
  37. package/dist/src/core/compression/transcriptPathNotice.js.map +1 -0
  38. package/dist/src/core/contentGenerator.d.ts +2 -5
  39. package/dist/src/core/contentGenerator.js +10 -24
  40. package/dist/src/core/contentGenerator.js.map +1 -1
  41. package/dist/src/core/logger.d.ts +66 -0
  42. package/dist/src/core/logger.js +345 -30
  43. package/dist/src/core/logger.js.map +1 -1
  44. package/dist/src/core/prompts.d.ts +0 -1
  45. package/dist/src/core/prompts.js +5 -79
  46. package/dist/src/core/prompts.js.map +1 -1
  47. package/dist/src/core/turn.d.ts +3 -3
  48. package/dist/src/hooks/hookTranslator.js +5 -4
  49. package/dist/src/hooks/hookTranslator.js.map +1 -1
  50. package/dist/src/index.d.ts +8 -6
  51. package/dist/src/index.js +8 -6
  52. package/dist/src/index.js.map +1 -1
  53. package/dist/src/llm-types/index.d.ts +1 -1
  54. package/dist/src/llm-types/modelEnvelope.d.ts +2 -1
  55. package/dist/src/llm-types/modelEnvelope.js +17 -1
  56. package/dist/src/llm-types/modelEnvelope.js.map +1 -1
  57. package/dist/src/models/schema.d.ts +40 -40
  58. package/dist/src/policy/policies/read-only.toml +0 -5
  59. package/dist/src/prompt-config/TemplateEngine.js +0 -3
  60. package/dist/src/prompt-config/TemplateEngine.js.map +1 -1
  61. package/dist/src/prompt-config/defaults/providers/gemini/core.md +0 -2
  62. package/dist/src/prompt-config/defaults/providers/gemini/models/gemini-2.5-flash/core.md +0 -2
  63. package/dist/src/prompt-config/defaults/providers/gemini/models/gemini-2.5-flash/gemini-2-5-flash/core.md +0 -2
  64. package/dist/src/prompt-config/prompt-loader.d.ts +1 -1
  65. package/dist/src/prompt-config/prompt-loader.js +4 -4
  66. package/dist/src/prompt-config/prompt-loader.js.map +1 -1
  67. package/dist/src/prompt-config/types.d.ts +0 -1
  68. package/dist/src/recording/CheckpointService.d.ts +4 -0
  69. package/dist/src/recording/CheckpointService.js +67 -46
  70. package/dist/src/recording/CheckpointService.js.map +1 -1
  71. package/dist/src/recording/HistoryMutationService.d.ts +1 -1
  72. package/dist/src/recording/HistoryMutationService.js +27 -4
  73. package/dist/src/recording/HistoryMutationService.js.map +1 -1
  74. package/dist/src/recording/RecordingIntegration.d.ts +36 -2
  75. package/dist/src/recording/RecordingIntegration.js +224 -7
  76. package/dist/src/recording/RecordingIntegration.js.map +1 -1
  77. package/dist/src/recording/ReplayEngine.d.ts +8 -10
  78. package/dist/src/recording/ReplayEngine.js +161 -95
  79. package/dist/src/recording/ReplayEngine.js.map +1 -1
  80. package/dist/src/recording/SessionDiscovery.d.ts +4 -2
  81. package/dist/src/recording/SessionDiscovery.js +13 -5
  82. package/dist/src/recording/SessionDiscovery.js.map +1 -1
  83. package/dist/src/recording/SessionRecordingService.d.ts +23 -3
  84. package/dist/src/recording/SessionRecordingService.js +209 -51
  85. package/dist/src/recording/SessionRecordingService.js.map +1 -1
  86. package/dist/src/recording/SessionTransitionService.d.ts +7 -0
  87. package/dist/src/recording/SessionTransitionService.js +66 -13
  88. package/dist/src/recording/SessionTransitionService.js.map +1 -1
  89. package/dist/src/recording/index.d.ts +1 -0
  90. package/dist/src/recording/index.js +1 -0
  91. package/dist/src/recording/index.js.map +1 -1
  92. package/dist/src/recording/janitor/cleanupTypes.d.ts +3 -0
  93. package/dist/src/recording/janitor/cleanupTypes.js.map +1 -1
  94. package/dist/src/recording/janitor/mediaReclamation.d.ts +23 -0
  95. package/dist/src/recording/janitor/mediaReclamation.js +195 -0
  96. package/dist/src/recording/janitor/mediaReclamation.js.map +1 -0
  97. package/dist/src/recording/janitor/sessionJanitor.js +47 -1
  98. package/dist/src/recording/janitor/sessionJanitor.js.map +1 -1
  99. package/dist/src/recording/janitor/sessionScanner.d.ts +12 -9
  100. package/dist/src/recording/janitor/sessionScanner.js +248 -193
  101. package/dist/src/recording/janitor/sessionScanner.js.map +1 -1
  102. package/dist/src/recording/replay-test-helpers.d.ts +10 -1
  103. package/dist/src/recording/replay-test-helpers.js +24 -2
  104. package/dist/src/recording/replay-test-helpers.js.map +1 -1
  105. package/dist/src/recording/replayCheckpointMetadata.d.ts +28 -0
  106. package/dist/src/recording/replayCheckpointMetadata.js +96 -0
  107. package/dist/src/recording/replayCheckpointMetadata.js.map +1 -0
  108. package/dist/src/recording/replayErrorFormatting.d.ts +6 -0
  109. package/dist/src/recording/replayErrorFormatting.js +38 -0
  110. package/dist/src/recording/replayErrorFormatting.js.map +1 -0
  111. package/dist/src/recording/resumeSession.d.ts +3 -0
  112. package/dist/src/recording/resumeSession.js +7 -1
  113. package/dist/src/recording/resumeSession.js.map +1 -1
  114. package/dist/src/recording/semanticMediaPurgeReplayValidation.d.ts +14 -0
  115. package/dist/src/recording/semanticMediaPurgeReplayValidation.js +24 -0
  116. package/dist/src/recording/semanticMediaPurgeReplayValidation.js.map +1 -0
  117. package/dist/src/recording/session-media-package-blobs.d.ts +8 -0
  118. package/dist/src/recording/session-media-package-blobs.js +72 -0
  119. package/dist/src/recording/session-media-package-blobs.js.map +1 -0
  120. package/dist/src/recording/session-media-package-import.d.ts +26 -0
  121. package/dist/src/recording/session-media-package-import.js +124 -0
  122. package/dist/src/recording/session-media-package-import.js.map +1 -0
  123. package/dist/src/recording/session-media-package-state.d.ts +19 -0
  124. package/dist/src/recording/session-media-package-state.js +56 -0
  125. package/dist/src/recording/session-media-package-state.js.map +1 -0
  126. package/dist/src/recording/session-media-package-validation.d.ts +59 -0
  127. package/dist/src/recording/session-media-package-validation.js +286 -0
  128. package/dist/src/recording/session-media-package-validation.js.map +1 -0
  129. package/dist/src/recording/session-media-package-writer.d.ts +18 -0
  130. package/dist/src/recording/session-media-package-writer.js +70 -0
  131. package/dist/src/recording/session-media-package-writer.js.map +1 -0
  132. package/dist/src/recording/session-media-package.d.ts +27 -0
  133. package/dist/src/recording/session-media-package.js +366 -0
  134. package/dist/src/recording/session-media-package.js.map +1 -0
  135. package/dist/src/recording/types.d.ts +34 -2
  136. package/dist/src/recording/types.js.map +1 -1
  137. package/dist/src/runtime/AgentRuntimeContext.d.ts +22 -5
  138. package/dist/src/runtime/AgentRuntimeLoader.d.ts +6 -0
  139. package/dist/src/runtime/AgentRuntimeLoader.js +25 -6
  140. package/dist/src/runtime/AgentRuntimeLoader.js.map +1 -1
  141. package/dist/src/runtime/contracts/PromptEstimation.d.ts +1 -0
  142. package/dist/src/runtime/contracts/PromptEstimation.js.map +1 -1
  143. package/dist/src/runtime/contracts/RuntimeProvider.d.ts +3 -2
  144. package/dist/src/runtime/contracts/RuntimeProviderManager.d.ts +0 -2
  145. package/dist/src/runtime/createAgentRuntimeContext.js +28 -1
  146. package/dist/src/runtime/createAgentRuntimeContext.js.map +1 -1
  147. package/dist/src/runtime/providerRuntimeContext.d.ts +12 -0
  148. package/dist/src/runtime/providerRuntimeContext.js +3 -0
  149. package/dist/src/runtime/providerRuntimeContext.js.map +1 -1
  150. package/dist/src/runtime/runtimeAdapters.js +2 -2
  151. package/dist/src/runtime/runtimeAdapters.js.map +1 -1
  152. package/dist/src/services/history/ContentConverters.d.ts +11 -7
  153. package/dist/src/services/history/ContentConverters.js +11 -7
  154. package/dist/src/services/history/ContentConverters.js.map +1 -1
  155. package/dist/src/services/history/HistoryService.d.ts +18 -180
  156. package/dist/src/services/history/HistoryService.js +53 -523
  157. package/dist/src/services/history/HistoryService.js.map +1 -1
  158. package/dist/src/services/history/HistoryServiceCore.d.ts +278 -0
  159. package/dist/src/services/history/HistoryServiceCore.js +727 -0
  160. package/dist/src/services/history/HistoryServiceCore.js.map +1 -0
  161. package/dist/src/services/history/IContent.d.ts +118 -16
  162. package/dist/src/services/history/IContent.js +284 -4
  163. package/dist/src/services/history/IContent.js.map +1 -1
  164. package/dist/src/services/history/contentSize.js +22 -2
  165. package/dist/src/services/history/contentSize.js.map +1 -1
  166. package/dist/src/services/history/historyChronology.d.ts +7 -0
  167. package/dist/src/services/history/historyChronology.js +35 -3
  168. package/dist/src/services/history/historyChronology.js.map +1 -1
  169. package/dist/src/services/history/historyCloneUtils.d.ts +5 -4
  170. package/dist/src/services/history/historyCloneUtils.js +23 -16
  171. package/dist/src/services/history/historyCloneUtils.js.map +1 -1
  172. package/dist/src/services/history/historyCompressionQueue.d.ts +33 -0
  173. package/dist/src/services/history/historyCompressionQueue.js +81 -0
  174. package/dist/src/services/history/historyCompressionQueue.js.map +1 -0
  175. package/dist/src/services/history/historyEventTypes.d.ts +3 -0
  176. package/dist/src/services/history/historyMutationFailure.d.ts +15 -0
  177. package/dist/src/services/history/historyMutationFailure.js +22 -0
  178. package/dist/src/services/history/historyMutationFailure.js.map +1 -1
  179. package/dist/src/services/history/historyProviderPipeline.d.ts +1 -1
  180. package/dist/src/services/history/historyProviderPipeline.js +15 -5
  181. package/dist/src/services/history/historyProviderPipeline.js.map +1 -1
  182. package/dist/src/services/history/historyTokenEstimation.js +10 -6
  183. package/dist/src/services/history/historyTokenEstimation.js.map +1 -1
  184. package/dist/src/services/history/historyToolNormalization.d.ts +2 -0
  185. package/dist/src/services/history/historyToolNormalization.js +26 -9
  186. package/dist/src/services/history/historyToolNormalization.js.map +1 -1
  187. package/dist/src/services/history/provider-file-binding.d.ts +11 -0
  188. package/dist/src/services/history/provider-file-binding.js +70 -0
  189. package/dist/src/services/history/provider-file-binding.js.map +1 -0
  190. package/dist/src/services/history/semantic-media-purge.d.ts +66 -0
  191. package/dist/src/services/history/semantic-media-purge.js +404 -0
  192. package/dist/src/services/history/semantic-media-purge.js.map +1 -0
  193. package/dist/src/storage/SessionPersistenceService.d.ts +53 -2
  194. package/dist/src/storage/SessionPersistenceService.js +435 -23
  195. package/dist/src/storage/SessionPersistenceService.js.map +1 -1
  196. package/dist/src/storage/history-media-ownership.d.ts +38 -0
  197. package/dist/src/storage/history-media-ownership.js +136 -0
  198. package/dist/src/storage/history-media-ownership.js.map +1 -0
  199. package/dist/src/storage/local-media-store-child.d.ts +6 -0
  200. package/dist/src/storage/local-media-store-child.js +140 -0
  201. package/dist/src/storage/local-media-store-child.js.map +1 -0
  202. package/dist/src/storage/local-media-store-files.d.ts +44 -0
  203. package/dist/src/storage/local-media-store-files.js +460 -0
  204. package/dist/src/storage/local-media-store-files.js.map +1 -0
  205. package/dist/src/storage/local-media-store-lock-recovery.d.ts +15 -0
  206. package/dist/src/storage/local-media-store-lock-recovery.js +112 -0
  207. package/dist/src/storage/local-media-store-lock-recovery.js.map +1 -0
  208. package/dist/src/storage/local-media-store-persistence.d.ts +48 -0
  209. package/dist/src/storage/local-media-store-persistence.js +443 -0
  210. package/dist/src/storage/local-media-store-persistence.js.map +1 -0
  211. package/dist/src/storage/local-media-store-quota.d.ts +6 -0
  212. package/dist/src/storage/local-media-store-quota.js +66 -0
  213. package/dist/src/storage/local-media-store-quota.js.map +1 -0
  214. package/dist/src/storage/local-media-store-reservations.d.ts +55 -0
  215. package/dist/src/storage/local-media-store-reservations.js +377 -0
  216. package/dist/src/storage/local-media-store-reservations.js.map +1 -0
  217. package/dist/src/storage/local-media-store-types.d.ts +110 -0
  218. package/dist/src/storage/local-media-store-types.js +35 -0
  219. package/dist/src/storage/local-media-store-types.js.map +1 -0
  220. package/dist/src/storage/local-media-store-validation.d.ts +34 -0
  221. package/dist/src/storage/local-media-store-validation.js +449 -0
  222. package/dist/src/storage/local-media-store-validation.js.map +1 -0
  223. package/dist/src/storage/local-media-store.d.ts +47 -0
  224. package/dist/src/storage/local-media-store.js +353 -0
  225. package/dist/src/storage/local-media-store.js.map +1 -0
  226. package/dist/src/storage/media-admission-service.d.ts +49 -0
  227. package/dist/src/storage/media-admission-service.js +333 -0
  228. package/dist/src/storage/media-admission-service.js.map +1 -0
  229. package/dist/src/storage/media-lifecycle-metrics.d.ts +75 -0
  230. package/dist/src/storage/media-lifecycle-metrics.js +105 -0
  231. package/dist/src/storage/media-lifecycle-metrics.js.map +1 -0
  232. package/dist/src/storage/media-reference-lifecycle.d.ts +16 -0
  233. package/dist/src/storage/media-reference-lifecycle.js +84 -0
  234. package/dist/src/storage/media-reference-lifecycle.js.map +1 -0
  235. package/dist/src/storage/request-media-resolver.d.ts +67 -0
  236. package/dist/src/storage/request-media-resolver.js +325 -0
  237. package/dist/src/storage/request-media-resolver.js.map +1 -0
  238. package/dist/src/storage/session-media-service-factories.d.ts +19 -0
  239. package/dist/src/storage/session-media-service-factories.js +34 -0
  240. package/dist/src/storage/session-media-service-factories.js.map +1 -0
  241. package/dist/src/storage/session-persistence-helpers.d.ts +10 -0
  242. package/dist/src/storage/session-persistence-helpers.js +46 -0
  243. package/dist/src/storage/session-persistence-helpers.js.map +1 -0
  244. package/dist/src/test-utils/config.d.ts +2 -0
  245. package/dist/src/test-utils/config.js +5 -5
  246. package/dist/src/test-utils/config.js.map +1 -1
  247. package/dist/src/test-utils/runtime.d.ts +2 -0
  248. package/dist/src/test-utils/runtime.js +1 -2
  249. package/dist/src/test-utils/runtime.js.map +1 -1
  250. package/dist/src/tools-adapters/CoreShellToolHostAdapter.js +1 -9
  251. package/dist/src/tools-adapters/CoreShellToolHostAdapter.js.map +1 -1
  252. package/dist/src/tools-adapters/CoreSkillServiceAdapter.d.ts +0 -2
  253. package/dist/src/tools-adapters/CoreSkillServiceAdapter.js +0 -17
  254. package/dist/src/tools-adapters/CoreSkillServiceAdapter.js.map +1 -1
  255. package/dist/src/tools-adapters/CoreToolHostAdapter.d.ts +0 -21
  256. package/dist/src/tools-adapters/CoreToolHostAdapter.js +0 -8
  257. package/dist/src/tools-adapters/CoreToolHostAdapter.js.map +1 -1
  258. package/dist/src/utils/environmentContext.d.ts +8 -9
  259. package/dist/src/utils/environmentContext.js +11 -22
  260. package/dist/src/utils/environmentContext.js.map +1 -1
  261. package/dist/src/utils/errorParsing.d.ts +1 -2
  262. package/dist/src/utils/errorParsing.js +22 -41
  263. package/dist/src/utils/errorParsing.js.map +1 -1
  264. package/dist/src/utils/generateContentResponseUtilities.js +12 -0
  265. package/dist/src/utils/generateContentResponseUtilities.js.map +1 -1
  266. package/dist/src/utils/summarizer.d.ts +1 -2
  267. package/dist/src/utils/summarizer.js +6 -5
  268. package/dist/src/utils/summarizer.js.map +1 -1
  269. package/dist/src/utils/tool-utils.js +7 -1
  270. package/dist/src/utils/tool-utils.js.map +1 -1
  271. package/index.ts +0 -4
  272. package/package.json +38 -30
  273. package/src/config/agentClientLifecycle.ts +53 -22
  274. package/src/config/config.ts +11 -26
  275. package/src/config/configBase.ts +46 -7
  276. package/src/config/configBaseCore.ts +38 -36
  277. package/src/config/configMcpRuntime.ts +46 -0
  278. package/src/config/configMediaDefaults.ts +19 -0
  279. package/src/config/configTypes.ts +13 -53
  280. package/src/config/index.ts +1 -4
  281. package/src/config/models.ts +0 -6
  282. package/src/config/toolRegistryFactory.ts +2 -2
  283. package/src/core/clientContract.ts +4 -6
  284. package/src/core/compression/transcriptPathNotice.ts +31 -0
  285. package/src/core/contentGenerator.ts +15 -39
  286. package/src/core/logger.ts +370 -39
  287. package/src/core/prompts.ts +4 -114
  288. package/src/core/turn.ts +3 -3
  289. package/src/hooks/hookTranslator.ts +6 -4
  290. package/src/index.ts +7 -7
  291. package/src/llm-types/index.ts +5 -0
  292. package/src/llm-types/modelEnvelope.ts +26 -2
  293. package/src/policy/policies/read-only.toml +0 -5
  294. package/src/prompt-config/TemplateEngine.ts +0 -3
  295. package/src/prompt-config/defaults/providers/gemini/core.md +0 -2
  296. package/src/prompt-config/defaults/providers/gemini/models/gemini-2.5-flash/core.md +0 -2
  297. package/src/prompt-config/defaults/providers/gemini/models/gemini-2.5-flash/gemini-2-5-flash/core.md +0 -2
  298. package/src/prompt-config/prompt-loader.ts +7 -8
  299. package/src/prompt-config/types.ts +0 -1
  300. package/src/recording/CheckpointService.ts +110 -45
  301. package/src/recording/HistoryMutationService.ts +28 -3
  302. package/src/recording/RecordingIntegration.ts +258 -11
  303. package/src/recording/ReplayEngine.ts +220 -110
  304. package/src/recording/SessionDiscovery.ts +30 -4
  305. package/src/recording/SessionRecordingService.ts +253 -55
  306. package/src/recording/SessionTransitionService.ts +75 -12
  307. package/src/recording/index.ts +7 -0
  308. package/src/recording/janitor/cleanupTypes.ts +4 -0
  309. package/src/recording/janitor/mediaReclamation.ts +295 -0
  310. package/src/recording/janitor/sessionJanitor.ts +54 -1
  311. package/src/recording/janitor/sessionScanner.ts +319 -227
  312. package/src/recording/replay-test-helpers.ts +33 -2
  313. package/src/recording/replayCheckpointMetadata.ts +115 -0
  314. package/src/recording/replayErrorFormatting.ts +43 -0
  315. package/src/recording/resumeSession.ts +10 -0
  316. package/src/recording/semanticMediaPurgeReplayValidation.ts +35 -0
  317. package/src/recording/session-media-package-blobs.ts +116 -0
  318. package/src/recording/session-media-package-import.ts +189 -0
  319. package/src/recording/session-media-package-state.ts +120 -0
  320. package/src/recording/session-media-package-validation.ts +400 -0
  321. package/src/recording/session-media-package-writer.ts +117 -0
  322. package/src/recording/session-media-package.ts +692 -0
  323. package/src/recording/types.ts +37 -2
  324. package/src/runtime/AgentRuntimeContext.ts +28 -5
  325. package/src/runtime/AgentRuntimeLoader.ts +32 -7
  326. package/src/runtime/contracts/PromptEstimation.ts +1 -0
  327. package/src/runtime/contracts/RuntimeProvider.ts +3 -8
  328. package/src/runtime/contracts/RuntimeProviderManager.ts +0 -2
  329. package/src/runtime/createAgentRuntimeContext.ts +43 -1
  330. package/src/runtime/providerRuntimeContext.ts +22 -0
  331. package/src/runtime/runtimeAdapters.ts +2 -2
  332. package/src/services/history/ContentConverters.ts +11 -7
  333. package/src/services/history/HistoryService.ts +71 -696
  334. package/src/services/history/HistoryServiceCore.ts +1055 -0
  335. package/src/services/history/IContent.ts +460 -20
  336. package/src/services/history/contentSize.ts +22 -2
  337. package/src/services/history/historyChronology.ts +53 -3
  338. package/src/services/history/historyCloneUtils.ts +26 -22
  339. package/src/services/history/historyCompressionQueue.ts +102 -0
  340. package/src/services/history/historyEventTypes.ts +9 -0
  341. package/src/services/history/historyMutationFailure.ts +33 -0
  342. package/src/services/history/historyProviderPipeline.ts +19 -5
  343. package/src/services/history/historyTokenEstimation.ts +9 -5
  344. package/src/services/history/historyToolNormalization.ts +43 -11
  345. package/src/services/history/provider-file-binding.ts +115 -0
  346. package/src/services/history/semantic-media-purge.ts +593 -0
  347. package/src/storage/SessionPersistenceService.ts +667 -30
  348. package/src/storage/history-media-ownership.ts +185 -0
  349. package/src/storage/local-media-store-child.ts +163 -0
  350. package/src/storage/local-media-store-files.ts +643 -0
  351. package/src/storage/local-media-store-lock-recovery.ts +159 -0
  352. package/src/storage/local-media-store-persistence.ts +737 -0
  353. package/src/storage/local-media-store-quota.ts +111 -0
  354. package/src/storage/local-media-store-reservations.ts +485 -0
  355. package/src/storage/local-media-store-types.ts +161 -0
  356. package/src/storage/local-media-store-validation.ts +643 -0
  357. package/src/storage/local-media-store.ts +696 -0
  358. package/src/storage/media-admission-service.ts +512 -0
  359. package/src/storage/media-lifecycle-metrics.ts +228 -0
  360. package/src/storage/media-reference-lifecycle.ts +164 -0
  361. package/src/storage/request-media-resolver.ts +491 -0
  362. package/src/storage/session-media-service-factories.ts +48 -0
  363. package/src/storage/session-persistence-helpers.ts +85 -0
  364. package/src/test-utils/config.ts +7 -5
  365. package/src/test-utils/runtime.ts +3 -2
  366. package/src/tools-adapters/CoreShellToolHostAdapter.ts +1 -11
  367. package/src/tools-adapters/CoreSkillServiceAdapter.ts +0 -23
  368. package/src/tools-adapters/CoreToolHostAdapter.ts +0 -36
  369. package/src/utils/environmentContext.ts +11 -30
  370. package/src/utils/errorParsing.ts +19 -69
  371. package/src/utils/generateContentResponseUtilities.ts +28 -1
  372. package/src/utils/summarizer.ts +8 -10
  373. package/src/utils/tool-utils.ts +7 -1
  374. package/dist/src/code_assist/codeAssist.d.ts +0 -19
  375. package/dist/src/code_assist/codeAssist.js +0 -41
  376. package/dist/src/code_assist/codeAssist.js.map +0 -1
  377. package/dist/src/code_assist/contentGeneratorAdapters.d.ts +0 -49
  378. package/dist/src/code_assist/contentGeneratorAdapters.js +0 -197
  379. package/dist/src/code_assist/contentGeneratorAdapters.js.map +0 -1
  380. package/dist/src/code_assist/converter.d.ts +0 -74
  381. package/dist/src/code_assist/converter.js +0 -158
  382. package/dist/src/code_assist/converter.js.map +0 -1
  383. package/dist/src/code_assist/googleGenAIWrapper.d.ts +0 -27
  384. package/dist/src/code_assist/googleGenAIWrapper.js +0 -46
  385. package/dist/src/code_assist/googleGenAIWrapper.js.map +0 -1
  386. package/dist/src/code_assist/oauth-credential-storage.d.ts +0 -30
  387. package/dist/src/code_assist/oauth-credential-storage.js +0 -135
  388. package/dist/src/code_assist/oauth-credential-storage.js.map +0 -1
  389. package/dist/src/code_assist/server.d.ts +0 -44
  390. package/dist/src/code_assist/server.js +0 -154
  391. package/dist/src/code_assist/server.js.map +0 -1
  392. package/dist/src/code_assist/setup.d.ts +0 -20
  393. package/dist/src/code_assist/setup.js +0 -126
  394. package/dist/src/code_assist/setup.js.map +0 -1
  395. package/dist/src/code_assist/types.d.ts +0 -161
  396. package/dist/src/code_assist/types.js +0 -46
  397. package/dist/src/code_assist/types.js.map +0 -1
  398. package/dist/src/utils/getFolderStructure.d.ts +0 -31
  399. package/dist/src/utils/getFolderStructure.js +0 -240
  400. package/dist/src/utils/getFolderStructure.js.map +0 -1
  401. package/dist/src/utils/installationManager.d.ts +0 -16
  402. package/dist/src/utils/installationManager.js +0 -51
  403. package/dist/src/utils/installationManager.js.map +0 -1
  404. package/dist/src/utils/llm-edit-fixer.d.ts +0 -25
  405. package/dist/src/utils/llm-edit-fixer.js +0 -120
  406. package/dist/src/utils/llm-edit-fixer.js.map +0 -1
  407. package/src/code_assist/codeAssist.ts +0 -59
  408. package/src/code_assist/contentGeneratorAdapters.ts +0 -275
  409. package/src/code_assist/converter.ts +0 -288
  410. package/src/code_assist/googleGenAIWrapper.ts +0 -90
  411. package/src/code_assist/oauth-credential-storage.ts +0 -171
  412. package/src/code_assist/server.ts +0 -263
  413. package/src/code_assist/setup.ts +0 -189
  414. package/src/code_assist/types.ts +0 -201
  415. package/src/utils/getFolderStructure.ts +0 -382
  416. package/src/utils/installationManager.ts +0 -59
  417. package/src/utils/llm-edit-fixer.ts +0 -157
@@ -5,9 +5,11 @@
5
5
  */
6
6
 
7
7
  import { z } from 'zod';
8
- import { DEFAULT_GEMINI_FLASH_MODEL } from '../config/models.js';
9
8
  import { getResponseText } from '../utils/partUtils.js';
10
9
 
10
+ // Interim literal; hook-v2 (subissue B of #2614) deletes this fallback with the versioned wire.
11
+ const HOOK_FALLBACK_MODEL = 'gemini-2.5-flash';
12
+
11
13
  /**
12
14
  * Structural shapes matching the portions of the @google/genai SDK types used
13
15
  * by the hook translator's internal plumbing. Defined locally so core does
@@ -335,8 +337,8 @@ export class HookTranslatorGenAIv1 extends HookTranslator {
335
337
  return {
336
338
  model:
337
339
  sdkRequest.model === ''
338
- ? DEFAULT_GEMINI_FLASH_MODEL
339
- : (sdkRequest.model ?? DEFAULT_GEMINI_FLASH_MODEL),
340
+ ? HOOK_FALLBACK_MODEL
341
+ : (sdkRequest.model ?? HOOK_FALLBACK_MODEL),
340
342
  messages,
341
343
  config: {
342
344
  temperature: config?.temperature,
@@ -420,7 +422,7 @@ export class HookTranslatorGenAIv1 extends HookTranslator {
420
422
  typeof hookRequest.model === 'string' ? hookRequest.model : undefined;
421
423
  const result: HookGenerateContentParameters = {
422
424
  ...baseRequest,
423
- model: hookModel ?? baseRequest?.model ?? DEFAULT_GEMINI_FLASH_MODEL,
425
+ model: hookModel ?? baseRequest?.model ?? HOOK_FALLBACK_MODEL,
424
426
  contents,
425
427
  };
426
428
 
package/src/index.ts CHANGED
@@ -110,10 +110,7 @@ export {
110
110
  hasInteractiveSubagentScheduler,
111
111
  } from './core/subagentTypes.js';
112
112
  export { buildContinuationDirective } from './core/compression/continuationDirective.js';
113
-
114
- export * from './code_assist/codeAssist.js';
115
- export * from './code_assist/server.js';
116
- export * from './code_assist/types.js';
113
+ export { buildTranscriptPathNotice } from './core/compression/transcriptPathNotice.js';
117
114
 
118
115
  // Export utilities
119
116
  export * from './utils/paths.js';
@@ -125,7 +122,6 @@ export * from './utils/checkpointUtils.js';
125
122
  export * from './utils/output-format.js';
126
123
  export * from './utils/exitCodes.js';
127
124
  export * from './utils/refusalNotice.js';
128
- export * from './utils/getFolderStructure.js';
129
125
  export * from './utils/memoryDiscovery.js';
130
126
  export * from './utils/gitIgnoreParser.js';
131
127
  export * from './utils/gitUtils.js';
@@ -169,7 +165,6 @@ export {
169
165
  export * from './utils/browser-profile-discovery.js';
170
166
  export * from './utils/errorParsing.js';
171
167
  export * from './utils/ignorePatterns.js';
172
- export { INITIAL_HISTORY_LENGTH } from './utils/environmentContext.js';
173
168
  export * from './utils/partUtils.js';
174
169
  export * from './utils/ide-trust.js';
175
170
  export * from './utils/thoughtUtils.js';
@@ -251,6 +246,11 @@ export {
251
246
  getProviderKeyStorage,
252
247
  resetProviderKeyStorage,
253
248
  } from './storage/provider-key-storage.js';
249
+ export * from './storage/local-media-store.js';
250
+ export * from './storage/SessionPersistenceService.js';
251
+ export * from './storage/media-admission-service.js';
252
+ export * from './storage/request-media-resolver.js';
253
+ export * from './storage/media-lifecycle-metrics.js';
254
254
 
255
255
  // Export services
256
256
  export * from './services/fileDiscoveryService.js';
@@ -505,7 +505,6 @@ export {
505
505
  MCPOAuthProvider,
506
506
  MCPOAuthTokenStorage,
507
507
  BaseTokenStore,
508
- FileTokenStore,
509
508
  OAuthUtils,
510
509
  getMcpServerOAuthStatus,
511
510
  } from '@vybestack/llxprt-code-mcp';
@@ -528,6 +527,7 @@ export * from './telemetry/uiTelemetry.js';
528
527
  export { sessionId } from './utils/session.js';
529
528
  // Export content interfaces
530
529
  export * from './services/history/IContent.js';
530
+ export * from './services/history/semantic-media-purge.js';
531
531
  export { ContentConverters } from './services/history/ContentConverters.js';
532
532
  // Chronology trace shape (#1721) is part of the public surface so consumers
533
533
  // (e.g. the CLI /dumpcontext command) can type the trace without deep-importing.
@@ -65,6 +65,11 @@ export type {
65
65
  ToolCallBlock,
66
66
  ToolResponseBlock,
67
67
  MediaBlock,
68
+ InlineMediaBlock,
69
+ MediaReferenceBlock,
70
+ MediaDimensions,
71
+ MediaSemanticMetadata,
72
+ MediaSemanticMetadataValue,
68
73
  ThinkingBlock,
69
74
  CodeBlock,
70
75
  } from '../services/history/IContent.js';
@@ -22,7 +22,11 @@
22
22
  * @pseudocode lines 10-52
23
23
  */
24
24
 
25
- import type { IContent, UsageStats } from '../services/history/IContent.js';
25
+ import type {
26
+ IContent,
27
+ SemanticMediaPurgeCacheWriteEvidence,
28
+ UsageStats,
29
+ } from '../services/history/IContent.js';
26
30
  import type { ToolCallRequest } from './toolCall.js';
27
31
  import type { CanonicalFinishReason } from './finishReasons.js';
28
32
  import {
@@ -60,6 +64,7 @@ export interface ModelOutput {
60
64
  responseId?: string;
61
65
  hookRestrictions?: HookRestrictions;
62
66
  providerMetadata?: Record<string, unknown>;
67
+ semanticMediaPurgeCacheWriteEvidence?: SemanticMediaPurgeCacheWriteEvidence;
63
68
  /**
64
69
  * Neutral automatic-function-calling history — a sequence of IContent
65
70
  * turns produced by automatic tool invocation during a single generation.
@@ -160,6 +165,14 @@ export function accumulateModelStreamChunk(
160
165
  };
161
166
  }
162
167
 
168
+ const semanticMediaPurgeCacheWriteEvidence =
169
+ chunk.semanticMediaPurgeCacheWriteEvidence ??
170
+ acc.semanticMediaPurgeCacheWriteEvidence;
171
+ if (semanticMediaPurgeCacheWriteEvidence !== undefined) {
172
+ result.semanticMediaPurgeCacheWriteEvidence =
173
+ semanticMediaPurgeCacheWriteEvidence;
174
+ }
175
+
163
176
  // afcHistory: last-write-wins (chunk overrides acc when present). Carried
164
177
  // as neutral IContent[] (REQ-001.4).
165
178
  const afcHistory = chunk.afcHistory ?? acc.afcHistory;
@@ -233,7 +246,7 @@ export function toModelStreamChunk(icontent: IContent): ModelStreamChunk {
233
246
  // content.metadata.providerMetadata so it never leaks to agents. This is
234
247
  // done immutably — the original icontent is never mutated.
235
248
  const providerMeta = meta?.providerMetadata;
236
- const content: IContent =
249
+ let content: IContent =
237
250
  providerMeta !== undefined &&
238
251
  'automaticFunctionCallingHistory' in providerMeta
239
252
  ? {
@@ -246,8 +259,19 @@ export function toModelStreamChunk(icontent: IContent): ModelStreamChunk {
246
259
  },
247
260
  }
248
261
  : icontent;
262
+ const semanticMediaPurgeCacheWriteEvidence =
263
+ meta?.semanticMediaPurgeCacheWriteEvidence;
264
+ if (semanticMediaPurgeCacheWriteEvidence !== undefined) {
265
+ const metadata = { ...content.metadata };
266
+ delete metadata.semanticMediaPurgeCacheWriteEvidence;
267
+ content = { ...content, metadata };
268
+ }
249
269
 
250
270
  const result: ModelStreamChunk = { content };
271
+ if (semanticMediaPurgeCacheWriteEvidence !== undefined) {
272
+ result.semanticMediaPurgeCacheWriteEvidence =
273
+ semanticMediaPurgeCacheWriteEvidence;
274
+ }
251
275
 
252
276
  const raw = meta?.stopReason ?? meta?.finishReason;
253
277
  if (raw !== undefined) {
@@ -55,11 +55,6 @@ toolName = "read_line_range"
55
55
  decision = "allow"
56
56
  priority = 50
57
57
 
58
- [[rule]]
59
- toolName = "SubagentInvocation"
60
- decision = "allow"
61
- priority = 50
62
-
63
58
  [[rule]]
64
59
  toolName = "exa_web_search"
65
60
  decision = "allow"
@@ -227,9 +227,6 @@ export class TemplateEngine {
227
227
  if (env.workingDirectory) {
228
228
  variables['WORKING_DIRECTORY'] = env.workingDirectory;
229
229
  }
230
- if (env.folderStructure) {
231
- variables['FOLDER_STRUCTURE'] = env.folderStructure;
232
- }
233
230
 
234
231
  if (env.sandboxType) {
235
232
  variables['SANDBOX_TYPE'] = env.sandboxType;
@@ -12,8 +12,6 @@ You are LLxprt Code running on {{PLATFORM}} with {{MODEL}} via {{PROVIDER}}.
12
12
  - Sandbox type: {{SANDBOX_TYPE}}
13
13
  - IDE companion available: {{HAS_IDE}}
14
14
 
15
- {{FOLDER_STRUCTURE}}
16
-
17
15
  You are {{INTERACTION_MODE_LABEL}} CLI agent specializing in software engineering tasks. Your primary goal is to help users safely and efficiently, adhering strictly to the following instructions and utilizing your available tools.
18
16
 
19
17
  # Core Mandates
@@ -12,8 +12,6 @@ You are LLxprt Code running on {{PLATFORM}} with {{MODEL}} via {{PROVIDER}}.
12
12
  - Sandbox type: {{SANDBOX_TYPE}}
13
13
  - IDE companion available: {{HAS_IDE}}
14
14
 
15
- {{FOLDER_STRUCTURE}}
16
-
17
15
  You are {{INTERACTION_MODE_LABEL}} CLI agent specializing in software engineering tasks. Your primary goal is to help users safely and efficiently, adhering strictly to the following instructions and utilizing your available tools.
18
16
 
19
17
  # Core Mandates
@@ -12,8 +12,6 @@ You are LLxprt Code running on {{PLATFORM}} with {{MODEL}} via {{PROVIDER}}.
12
12
  - Sandbox type: {{SANDBOX_TYPE}}
13
13
  - IDE companion available: {{HAS_IDE}}
14
14
 
15
- {{FOLDER_STRUCTURE}}
16
-
17
15
  You are an interactive CLI agent specializing in software engineering tasks. Your primary goal is to help users safely and efficiently, adhering strictly to the following instructions and utilizing your available tools.
18
16
 
19
17
  # Core Mandates
@@ -294,17 +294,16 @@ export class PromptLoader {
294
294
  * Load multiple files and return a map of path to content
295
295
  */
296
296
  async loadAllFiles(
297
- baseDir: string,
298
- fileList: string[],
297
+ baseDir: string | null | undefined,
298
+ fileList: string[] | null | undefined,
299
299
  shouldCompress: boolean,
300
300
  ): Promise<Map<string, string>> {
301
301
  // Step 1: Validate inputs
302
- if (
303
- (baseDir as unknown) == null ||
304
- baseDir === '' ||
305
- (fileList as unknown) == null ||
306
- fileList.length === 0
307
- ) {
302
+ if (baseDir === null || baseDir === undefined || baseDir === '') {
303
+ return new Map();
304
+ }
305
+
306
+ if (fileList === null || fileList === undefined || fileList.length === 0) {
308
307
  return new Map();
309
308
  }
310
309
 
@@ -27,7 +27,6 @@ export interface PromptEnvironment {
27
27
  workspaceRoot?: string;
28
28
  workspaceDirectories?: string[];
29
29
  workingDirectory?: string;
30
- folderStructure?: string;
31
30
  interactionMode?: 'interactive' | 'non-interactive' | 'subagent';
32
31
  }
33
32
 
@@ -24,6 +24,7 @@ import {
24
24
  type LockHandle,
25
25
  } from './SessionLockManager.js';
26
26
  import { type SessionRecordingService } from './SessionRecordingService.js';
27
+ import type { LocalMediaStore } from '../storage/local-media-store.js';
27
28
  import {
28
29
  type CheckpointMetadataView,
29
30
  type ContinueTarget,
@@ -47,6 +48,15 @@ type NamedOperation =
47
48
 
48
49
  type NamedOperationAction<T> = (name: string) => Promise<T>;
49
50
 
51
+ interface ClosedCheckpointRename {
52
+ readonly filePath: string;
53
+ readonly projectHash: string;
54
+ readonly chatsDir: string;
55
+ readonly checkpointId: string;
56
+ readonly name: string;
57
+ readonly sessionIds: readonly string[];
58
+ }
59
+
50
60
  type FileSnapshot = {
51
61
  readonly filePath: string;
52
62
  readonly content: Buffer;
@@ -126,8 +136,9 @@ async function appendEvent(
126
136
  projectHash: string,
127
137
  type: SessionRecordLine['type'],
128
138
  payload: unknown,
139
+ mediaStore: LocalMediaStore | undefined,
129
140
  ): Promise<void> {
130
- const replay = await replaySession(filePath, projectHash);
141
+ const replay = await replaySession(filePath, projectHash, { mediaStore });
131
142
  if (!replay.ok) throw new Error(replay.error);
132
143
  if (replay.sequenceCorrupt) {
133
144
  throw new Error('Cannot append metadata to a sequence-corrupt recording');
@@ -143,12 +154,18 @@ async function appendEvent(
143
154
  }
144
155
 
145
156
  export class CheckpointService {
157
+ constructor(private readonly mediaStore?: LocalMediaStore) {}
158
+
146
159
  async listCheckpoints(
147
160
  filePath: string,
148
161
  projectHash: string,
149
162
  ): Promise<readonly CheckpointMetadataView[]> {
150
- const result = await replaySession(filePath, projectHash);
151
- if (!result.ok) return [];
163
+ const result = await replaySession(filePath, projectHash, {
164
+ mediaStore: this.mediaStore,
165
+ });
166
+ if (!result.ok) {
167
+ throw new Error(`Cannot list checkpoints: ${result.error}`);
168
+ }
152
169
  return (result.checkpoints ?? []).filter(
153
170
  (checkpoint) => !checkpoint.deleted,
154
171
  );
@@ -158,7 +175,9 @@ export class CheckpointService {
158
175
  filePath: string,
159
176
  projectHash: string,
160
177
  ): Promise<readonly CheckpointMetadataView[]> {
161
- const result = await replaySession(filePath, projectHash);
178
+ const result = await replaySession(filePath, projectHash, {
179
+ mediaStore: this.mediaStore,
180
+ });
162
181
  if (!result.ok) {
163
182
  throw new Error(`Cannot verify checkpoint blockers: ${result.error}`);
164
183
  }
@@ -233,14 +252,75 @@ export class CheckpointService {
233
252
  const lock = await this.acquireLock(chatsDir, sourceSessionId);
234
253
  try {
235
254
  await this.requireLiveCheckpoint(filePath, projectHash, checkpointId);
236
- await appendEvent(filePath, projectHash, 'checkpoint_deleted', {
237
- checkpointId,
238
- });
255
+ await appendEvent(
256
+ filePath,
257
+ projectHash,
258
+ 'checkpoint_deleted',
259
+ { checkpointId },
260
+ this.mediaStore,
261
+ );
239
262
  } finally {
240
263
  await lock.release().catch(() => undefined);
241
264
  }
242
265
  }
243
266
 
267
+ private async renameCheckpointUnderSessionLocks(
268
+ input: ClosedCheckpointRename,
269
+ ): Promise<void> {
270
+ const operation: NamedOperation = {
271
+ kind: 'rename',
272
+ checkpointId: input.checkpointId,
273
+ name: input.name,
274
+ };
275
+ const locks = await this.acquireSessionLocks(
276
+ input.chatsDir,
277
+ input.sessionIds,
278
+ );
279
+ try {
280
+ const refreshedCollisions = (
281
+ await SessionDiscovery.listContinueTargets(
282
+ input.chatsDir,
283
+ input.projectHash,
284
+ this.mediaStore,
285
+ )
286
+ ).filter(
287
+ (target) =>
288
+ targetName(target) === input.name &&
289
+ !isSameReference(target, operation),
290
+ );
291
+ const lockedIds = new Set(input.sessionIds);
292
+ if (
293
+ refreshedCollisions.some(
294
+ (target) => !lockedIds.has(targetSessionId(target)),
295
+ )
296
+ ) {
297
+ throw new Error(`Name '${input.name}' changed while acquiring locks`);
298
+ }
299
+ await this.requireLiveCheckpoint(
300
+ input.filePath,
301
+ input.projectHash,
302
+ input.checkpointId,
303
+ );
304
+ const snapshots = await captureFiles(refreshedCollisions);
305
+ await runWithFileRollback(snapshots, async () => {
306
+ for (const collision of refreshedCollisions) {
307
+ await this.tombstoneClosedCollision(collision, input.projectHash);
308
+ }
309
+ await appendEvent(
310
+ input.filePath,
311
+ input.projectHash,
312
+ 'checkpoint_renamed',
313
+ { checkpointId: input.checkpointId, name: input.name },
314
+ this.mediaStore,
315
+ );
316
+ });
317
+ } finally {
318
+ for (const lock of [...locks].reverse()) {
319
+ await lock.release().catch(() => undefined);
320
+ }
321
+ }
322
+ }
323
+
244
324
  async renameCheckpointClosed(
245
325
  filePath: string,
246
326
  projectHash: string,
@@ -259,6 +339,7 @@ export class CheckpointService {
259
339
  const targets = await SessionDiscovery.listContinueTargets(
260
340
  chatsDir,
261
341
  projectHash,
342
+ this.mediaStore,
262
343
  );
263
344
  const reservedIdentity = targets.find((target) =>
264
345
  target.kind === 'session'
@@ -283,39 +364,14 @@ export class CheckpointService {
283
364
  const sessionIds = [
284
365
  ...new Set([sourceSessionId, ...collisions.map(targetSessionId)]),
285
366
  ].sort((left, right) => left.localeCompare(right));
286
- const locks = await this.acquireSessionLocks(chatsDir, sessionIds);
287
- try {
288
- const refreshedCollisions = (
289
- await SessionDiscovery.listContinueTargets(chatsDir, projectHash)
290
- ).filter(
291
- (target) =>
292
- targetName(target) === trimmed &&
293
- !isSameReference(target, operation),
294
- );
295
- const lockedIds = new Set(sessionIds);
296
- if (
297
- refreshedCollisions.some(
298
- (target) => !lockedIds.has(targetSessionId(target)),
299
- )
300
- ) {
301
- throw new Error(`Name '${trimmed}' changed while acquiring locks`);
302
- }
303
- await this.requireLiveCheckpoint(filePath, projectHash, checkpointId);
304
- const snapshots = await captureFiles(refreshedCollisions);
305
- await runWithFileRollback(snapshots, async () => {
306
- for (const collision of refreshedCollisions) {
307
- await this.tombstoneClosedCollision(collision, projectHash);
308
- }
309
- await appendEvent(filePath, projectHash, 'checkpoint_renamed', {
310
- checkpointId,
311
- name: trimmed,
312
- });
313
- });
314
- } finally {
315
- for (const lock of [...locks].reverse()) {
316
- await lock.release().catch(() => undefined);
317
- }
318
- }
367
+ await this.renameCheckpointUnderSessionLocks({
368
+ filePath,
369
+ projectHash,
370
+ chatsDir,
371
+ checkpointId,
372
+ name: trimmed,
373
+ sessionIds,
374
+ });
319
375
  } finally {
320
376
  await namespaceLock.release().catch(() => undefined);
321
377
  }
@@ -337,6 +393,7 @@ export class CheckpointService {
337
393
  const targets = await SessionDiscovery.listContinueTargets(
338
394
  chatsDir,
339
395
  projectHash,
396
+ this.mediaStore,
340
397
  );
341
398
  const collision = targets.find(
342
399
  (target) =>
@@ -350,7 +407,9 @@ export class CheckpointService {
350
407
  }
351
408
  const lock = await this.acquireLock(chatsDir, sourceSessionId);
352
409
  try {
353
- const replay = await replaySession(filePath, projectHash);
410
+ const replay = await replaySession(filePath, projectHash, {
411
+ mediaStore: this.mediaStore,
412
+ });
354
413
  if (!replay.ok) throw new Error(replay.error);
355
414
  if (replay.sequenceCorrupt) {
356
415
  throw new Error(
@@ -399,6 +458,7 @@ export class CheckpointService {
399
458
  const targets = await SessionDiscovery.listContinueTargets(
400
459
  chatsDir,
401
460
  projectHash,
461
+ this.mediaStore,
402
462
  );
403
463
  const reservedIdentity = targets.find((target) =>
404
464
  target.kind === 'session'
@@ -479,6 +539,7 @@ export class CheckpointService {
479
539
  projectHash,
480
540
  'checkpoint_deleted',
481
541
  { checkpointId: collision.checkpointId },
542
+ this.mediaStore,
482
543
  );
483
544
  return;
484
545
  }
@@ -486,9 +547,8 @@ export class CheckpointService {
486
547
  collision.session.filePath,
487
548
  projectHash,
488
549
  'session_named',
489
- {
490
- name: null,
491
- },
550
+ { name: null },
551
+ this.mediaStore,
492
552
  );
493
553
  }
494
554
 
@@ -525,6 +585,7 @@ export class CheckpointService {
525
585
  const refreshed = await SessionDiscovery.listContinueTargets(
526
586
  chatsDir,
527
587
  projectHash,
588
+ this.mediaStore,
528
589
  );
529
590
  const collisions = refreshed.filter(
530
591
  (target) =>
@@ -561,6 +622,7 @@ export class CheckpointService {
561
622
  projectHash,
562
623
  'checkpoint_deleted',
563
624
  { checkpointId: collision.checkpointId },
625
+ this.mediaStore,
564
626
  );
565
627
  return;
566
628
  }
@@ -581,6 +643,7 @@ export class CheckpointService {
581
643
  projectHash,
582
644
  'session_named',
583
645
  { name: null },
646
+ this.mediaStore,
584
647
  );
585
648
  }
586
649
 
@@ -615,7 +678,9 @@ export class CheckpointService {
615
678
  projectHash: string,
616
679
  checkpointId: string,
617
680
  ): Promise<CheckpointMetadataView> {
618
- const result = await replaySession(filePath, projectHash);
681
+ const result = await replaySession(filePath, projectHash, {
682
+ mediaStore: this.mediaStore,
683
+ });
619
684
  if (!result.ok) throw new Error(result.error);
620
685
  const checkpoint = result.checkpoints?.find(
621
686
  (candidate) => candidate.checkpointId === checkpointId,
@@ -109,6 +109,27 @@ function computeRestoreCut(
109
109
  };
110
110
  }
111
111
 
112
+ /**
113
+ * Resolve the chronology identity of the cut point so replay can reproduce the
114
+ * cut without depending on live and journalled history having the same length.
115
+ *
116
+ * The cut point is the first removed item. The journal is append-only, so an
117
+ * item present in live history when the cut was computed is also present in the
118
+ * replayed history and can be found there by its marker.
119
+ *
120
+ * Returns `undefined` when the item carries no usable marker, in which case the
121
+ * rewind is recorded as a bare count exactly as it always has been.
122
+ *
123
+ * @issue #2934
124
+ */
125
+ function resolveCutSeq(cutItem: IContent | undefined): number | undefined {
126
+ const seq = cutItem?.metadata?.chronology?.seq;
127
+ if (typeof seq !== 'number' || !Number.isSafeInteger(seq) || seq < 0) {
128
+ return undefined;
129
+ }
130
+ return seq;
131
+ }
132
+
112
133
  /**
113
134
  * Service for durable history mutations that persist rewind semantics.
114
135
  */
@@ -122,9 +143,12 @@ export class HistoryMutationService {
122
143
  async clear(
123
144
  history: readonly IContent[],
124
145
  recording: SessionRecordingService,
146
+ beforeCommit?: (remainingHistory: readonly IContent[]) => Promise<void>,
125
147
  ): Promise<HistoryMutationResult | HistoryMutationError> {
126
148
  const { cutIndex, removed } = computeClearCut(history);
127
- return this.applyMutation(history.slice(0, cutIndex), removed, recording);
149
+ const remaining = history.slice(0, cutIndex);
150
+ await beforeCommit?.(remaining);
151
+ return this.applyMutation(remaining, removed, recording);
128
152
  }
129
153
 
130
154
  /**
@@ -170,8 +194,9 @@ export class HistoryMutationService {
170
194
  return { ok: false, error: 'Recording is not active' };
171
195
  }
172
196
 
173
- // 2. Durably append the rewind event.
174
- recording.recordRewind(removed.length);
197
+ // 2. Durably append the rewind event, identifying the cut point by
198
+ // chronology so replay does not depend on offsets (#2934).
199
+ recording.recordRewind(removed.length, resolveCutSeq(removed[0]));
175
200
 
176
201
  // 3. Flush the rewind.
177
202
  await recording.flush();