@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
@@ -0,0 +1,696 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Vybestack LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import { isMediaReferenceBlock } from '../services/history/IContent.js';
8
+ import type {
9
+ MediaReferenceBlock,
10
+ MediaSemanticMetadata,
11
+ MediaStoredObject,
12
+ } from '../services/history/IContent.js';
13
+ import { LocalMediaStorePersistence } from './local-media-store-persistence.js';
14
+ import {
15
+ MediaObjectCorruptError,
16
+ MediaObjectHashMismatchError,
17
+ MediaStoreError,
18
+ type LocalMediaStoreOptions,
19
+ type MediaAdmissionInput,
20
+ type MediaKnownAdmissionInput,
21
+ type MediaReclamationResult,
22
+ type MediaStoredObjectAdmission,
23
+ type MediaStoredObjectFileAdmission,
24
+ type PreparedAdmission,
25
+ type PublishedMediaObjectPath,
26
+ type StagedMediaObjectAdmission,
27
+ } from './local-media-store-types.js';
28
+ import {
29
+ buildIdentityReference,
30
+ buildReference,
31
+ buildStoredObject,
32
+ contentIdFor,
33
+ isPositiveSafeInteger,
34
+ prepareAdmission,
35
+ uniqueStoredObjects,
36
+ validateContentId,
37
+ validatedProviderFileIds,
38
+ validatedSemanticMetadata,
39
+ validateStoredObjectMetadata,
40
+ } from './local-media-store-validation.js';
41
+
42
+ export {
43
+ MediaObjectCorruptError,
44
+ MediaObjectHashMismatchError,
45
+ MediaObjectMissingError,
46
+ MediaStoreError,
47
+ } from './local-media-store-types.js';
48
+ export type {
49
+ LocalMediaStoreFileOperations,
50
+ LocalMediaStoreOptions,
51
+ MediaAdmissionInput,
52
+ MediaKnownAdmissionInput,
53
+ MediaObjectAdmissionInput,
54
+ MediaReclamationResult,
55
+ MediaStoredObjectAdmission,
56
+ MediaStoredObjectFileAdmission,
57
+ MediaTransformationInput,
58
+ } from './local-media-store-types.js';
59
+
60
+ interface StoredObjectWithBytes {
61
+ readonly object: MediaStoredObject;
62
+ readonly bytes: Uint8Array;
63
+ }
64
+
65
+ interface StoredObjectWithFile {
66
+ readonly object: MediaStoredObject;
67
+ readonly sourcePath: string;
68
+ }
69
+
70
+ function storedObjectMetadataMatches(
71
+ left: MediaStoredObject,
72
+ right: MediaStoredObject,
73
+ ): boolean {
74
+ return (
75
+ left.mimeType === right.mimeType &&
76
+ left.byteLength === right.byteLength &&
77
+ left.dimensions?.width === right.dimensions?.width &&
78
+ left.dimensions?.height === right.dimensions?.height
79
+ );
80
+ }
81
+
82
+ export class LocalMediaStore {
83
+ readonly rootDirectory: string;
84
+ readonly quotaBytes: number;
85
+ private readonly persistence: LocalMediaStorePersistence;
86
+
87
+ constructor(options: LocalMediaStoreOptions) {
88
+ this.persistence = new LocalMediaStorePersistence(options);
89
+ this.rootDirectory = this.persistence.rootDirectory;
90
+ this.quotaBytes = this.persistence.quotaBytes;
91
+ }
92
+
93
+ async close(): Promise<void> {
94
+ await this.persistence.close();
95
+ }
96
+
97
+ async admit(input: MediaAdmissionInput): Promise<MediaReferenceBlock> {
98
+ const selectedBytes = new Uint8Array(input.bytes);
99
+ const originalBytes =
100
+ input.original === undefined
101
+ ? selectedBytes
102
+ : new Uint8Array(input.original.bytes);
103
+ return this.persistence.runExclusive(
104
+ 'admit object',
105
+ undefined,
106
+ async () => {
107
+ const prepared = prepareAdmission(input, selectedBytes, originalBytes);
108
+ await this.admitPreparedUnlocked(prepared);
109
+ return buildReference(prepared);
110
+ },
111
+ );
112
+ }
113
+
114
+ async preflightObjects(objects: readonly MediaStoredObject[]): Promise<void> {
115
+ await this.persistence.runExclusive(
116
+ 'preflight object batch',
117
+ undefined,
118
+ async () => {
119
+ const unique = uniqueStoredObjects(objects);
120
+ const additionalBytes = await this.measureMissingObjects(unique);
121
+ if (!Number.isSafeInteger(additionalBytes)) {
122
+ throw new MediaStoreError(
123
+ 'preflight object batch',
124
+ undefined,
125
+ new Error('Object batch byte length exceeds safe integer range'),
126
+ );
127
+ }
128
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
129
+ this.persistence.enforceQuota(storedBytes, additionalBytes, 'batch');
130
+ },
131
+ );
132
+ }
133
+
134
+ async admitObjects(
135
+ admissions: readonly MediaStoredObjectAdmission[],
136
+ ): Promise<void> {
137
+ await this.admitObjectsTransaction(admissions, () => Promise.resolve());
138
+ }
139
+
140
+ async stageObjects(
141
+ admissions: readonly MediaStoredObjectAdmission[],
142
+ ): Promise<StagedMediaObjectAdmission> {
143
+ const copied = admissions.map((admission) => ({
144
+ object: admission.object,
145
+ bytes: new Uint8Array(admission.bytes),
146
+ }));
147
+ const published = await this.persistence.runExclusive(
148
+ 'stage object batch',
149
+ undefined,
150
+ () => this.stageObjectBatchUnlocked(copied),
151
+ );
152
+ let pending = true;
153
+ return {
154
+ createdContentIds: published.map((entry) => entry.contentId),
155
+ commit(): void {
156
+ pending = false;
157
+ },
158
+ rollback: async (): Promise<void> => {
159
+ if (!pending) return;
160
+ await this.persistence.rollbackStagedObjects(published);
161
+ pending = false;
162
+ },
163
+ };
164
+ }
165
+
166
+ async stageObjectFiles(
167
+ admissions: readonly MediaStoredObjectFileAdmission[],
168
+ ): Promise<StagedMediaObjectAdmission> {
169
+ const published = await this.persistence.runExclusive(
170
+ 'stage object file batch',
171
+ undefined,
172
+ () => this.stageObjectFileBatchUnlocked(admissions),
173
+ );
174
+ let pending = true;
175
+ return {
176
+ createdContentIds: published.map((entry) => entry.contentId),
177
+ commit(): void {
178
+ pending = false;
179
+ },
180
+ rollback: async (): Promise<void> => {
181
+ if (!pending) return;
182
+ await this.persistence.rollbackStagedObjects(published);
183
+ pending = false;
184
+ },
185
+ };
186
+ }
187
+
188
+ async admitObjectsTransaction<T>(
189
+ admissions: readonly MediaStoredObjectAdmission[],
190
+ publish: () => Promise<T>,
191
+ ): Promise<T> {
192
+ const copied = admissions.map((admission) => ({
193
+ object: admission.object,
194
+ bytes: new Uint8Array(admission.bytes),
195
+ }));
196
+ return this.persistence.runExclusive('admit object batch', undefined, () =>
197
+ this.admitObjectBatchUnlocked(copied, publish),
198
+ );
199
+ }
200
+
201
+ async preflightKnown(
202
+ contentId: string,
203
+ knownByteLength: number,
204
+ ): Promise<void> {
205
+ validateContentId(contentId, 'preflight known object');
206
+ this.validateKnownByteLength(knownByteLength, contentId);
207
+ await this.persistence.runExclusive(
208
+ 'preflight known object',
209
+ contentId,
210
+ async () => {
211
+ if (await this.persistence.objectExistsUnlocked(contentId)) return;
212
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
213
+ this.persistence.enforceQuota(storedBytes, knownByteLength, contentId);
214
+ },
215
+ );
216
+ }
217
+
218
+ async admitKnown(
219
+ input: MediaKnownAdmissionInput,
220
+ readBytes: () => Promise<Uint8Array>,
221
+ ): Promise<MediaReferenceBlock> {
222
+ validateContentId(input.contentId, 'admit known object');
223
+ this.validateKnownByteLength(input.knownByteLength, input.contentId);
224
+ const metadata = buildStoredObject(
225
+ input.contentId,
226
+ input.mimeType,
227
+ input.knownByteLength,
228
+ input.dimensions,
229
+ );
230
+ const semanticMetadata = validatedSemanticMetadata(
231
+ input.semanticMetadata,
232
+ input.contentId,
233
+ );
234
+ const providerFileIds = validatedProviderFileIds(
235
+ input.providerFileIds,
236
+ input.contentId,
237
+ );
238
+ const existing = await this.persistence.runExclusive(
239
+ 'preflight known object admission',
240
+ input.contentId,
241
+ async () => {
242
+ if (await this.persistence.objectExistsUnlocked(input.contentId)) {
243
+ await this.persistence.readObjectVerifiedUnlocked(
244
+ metadata,
245
+ 'admit deduplicated object',
246
+ );
247
+ return buildIdentityReference(
248
+ metadata,
249
+ semanticMetadata,
250
+ providerFileIds,
251
+ );
252
+ }
253
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
254
+ this.persistence.enforceQuota(
255
+ storedBytes,
256
+ input.knownByteLength,
257
+ input.contentId,
258
+ );
259
+ return undefined;
260
+ },
261
+ );
262
+ if (existing !== undefined) return existing;
263
+ const bytes = new Uint8Array(await readBytes());
264
+ if (
265
+ bytes.byteLength !== input.knownByteLength ||
266
+ contentIdFor(bytes) !== input.contentId
267
+ ) {
268
+ throw new MediaStoreError(
269
+ 'validate known object source',
270
+ input.contentId,
271
+ new Error('Known object source changed after preflight'),
272
+ );
273
+ }
274
+ return this.persistence.runExclusive(
275
+ 'admit known object',
276
+ input.contentId,
277
+ () =>
278
+ this.admitKnownSnapshotUnlocked(
279
+ input,
280
+ metadata,
281
+ semanticMetadata,
282
+ providerFileIds,
283
+ bytes,
284
+ ),
285
+ );
286
+ }
287
+
288
+ async readObjectVerified(reference: MediaStoredObject): Promise<Uint8Array> {
289
+ return this.persistence.readObjectVerified(reference);
290
+ }
291
+
292
+ async readVerified(reference: MediaReferenceBlock): Promise<Uint8Array> {
293
+ if (!isMediaReferenceBlock(reference)) {
294
+ throw new MediaObjectCorruptError(
295
+ 'read verified',
296
+ undefined,
297
+ new Error('Malformed media reference'),
298
+ );
299
+ }
300
+ return this.readObjectVerified(reference.selectedObject);
301
+ }
302
+
303
+ async getStoredByteLength(): Promise<number> {
304
+ return this.persistence.getStoredByteLength();
305
+ }
306
+
307
+ async reserve(
308
+ reference: MediaReferenceBlock,
309
+ ownerId: string,
310
+ ): Promise<void> {
311
+ await this.reserveAndReadVerified(reference, ownerId);
312
+ }
313
+
314
+ async reserveAndReadVerified(
315
+ reference: MediaReferenceBlock,
316
+ ownerId: string,
317
+ ): Promise<Uint8Array> {
318
+ return this.persistence.reserveAndReadVerified(reference, ownerId);
319
+ }
320
+
321
+ async release(contentId: string, ownerId: string): Promise<void> {
322
+ await this.persistence.release(contentId, ownerId);
323
+ }
324
+
325
+ async hasReservations(contentId: string): Promise<boolean> {
326
+ return this.persistence.hasReservations(contentId);
327
+ }
328
+
329
+ async reclaimUnreferenced(
330
+ protectedContentIds: ReadonlySet<string>,
331
+ staleTemporaryBefore: number,
332
+ ): Promise<MediaReclamationResult> {
333
+ return this.persistence.reclaimUnreferenced(
334
+ protectedContentIds,
335
+ staleTemporaryBefore,
336
+ );
337
+ }
338
+
339
+ private async measureMissingObjects(
340
+ objects: ReadonlyMap<string, MediaStoredObject>,
341
+ ): Promise<number> {
342
+ let additionalBytes = 0;
343
+ for (const object of objects.values()) {
344
+ if (!(await this.persistence.objectExistsUnlocked(object.contentId))) {
345
+ additionalBytes += object.byteLength;
346
+ }
347
+ }
348
+ return additionalBytes;
349
+ }
350
+
351
+ private async stageObjectFileBatchUnlocked(
352
+ admissions: readonly StoredObjectWithFile[],
353
+ ): Promise<readonly PublishedMediaObjectPath[]> {
354
+ const byContentId = new Map<string, StoredObjectWithFile>();
355
+ for (const admission of admissions) {
356
+ validateStoredObjectMetadata(admission.object, 'stage object file batch');
357
+ const existing = byContentId.get(admission.object.contentId);
358
+ if (
359
+ existing !== undefined &&
360
+ !storedObjectMetadataMatches(existing.object, admission.object)
361
+ ) {
362
+ throw new MediaStoreError(
363
+ 'stage object file batch',
364
+ admission.object.contentId,
365
+ new Error('Conflicting stored object metadata'),
366
+ );
367
+ }
368
+ byContentId.set(admission.object.contentId, admission);
369
+ }
370
+ const missing: StoredObjectWithFile[] = [];
371
+ for (const admission of byContentId.values()) {
372
+ if (
373
+ await this.persistence.objectExistsUnlocked(admission.object.contentId)
374
+ ) {
375
+ await this.persistence.readObjectVerifiedUnlocked(
376
+ admission.object,
377
+ 'stage deduplicated object file batch',
378
+ );
379
+ } else {
380
+ missing.push(admission);
381
+ }
382
+ }
383
+ const additionalBytes = missing.reduce(
384
+ (total, admission) => total + admission.object.byteLength,
385
+ 0,
386
+ );
387
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
388
+ this.persistence.enforceQuota(storedBytes, additionalBytes, 'batch');
389
+ const published: PublishedMediaObjectPath[] = [];
390
+ try {
391
+ for (const admission of missing) {
392
+ const path = await this.persistence.publishObjectFile(
393
+ admission.sourcePath,
394
+ admission.object.contentId,
395
+ admission.object.byteLength,
396
+ 'stage object file batch',
397
+ );
398
+ if (path !== undefined) {
399
+ published.push({ contentId: admission.object.contentId, path });
400
+ }
401
+ }
402
+ return published;
403
+ } catch (error) {
404
+ return this.throwAfterRollback(
405
+ error,
406
+ published.map((entry) => entry.path),
407
+ 'stage object file batch and rollback',
408
+ undefined,
409
+ );
410
+ }
411
+ }
412
+
413
+ private async stageObjectBatchUnlocked(
414
+ admissions: readonly StoredObjectWithBytes[],
415
+ ): Promise<readonly PublishedMediaObjectPath[]> {
416
+ const byContentId = this.prepareObjectAdmissions(admissions);
417
+ const missing = await this.findMissingAdmissions(byContentId);
418
+ const additionalBytes = missing.reduce(
419
+ (total, admission) => total + admission.object.byteLength,
420
+ 0,
421
+ );
422
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
423
+ this.persistence.enforceQuota(storedBytes, additionalBytes, 'batch');
424
+ const published: PublishedMediaObjectPath[] = [];
425
+ try {
426
+ for (const admission of missing) {
427
+ const path = await this.persistence.publishObjectBytes(
428
+ admission.bytes,
429
+ admission.object.contentId,
430
+ 'stage object batch',
431
+ );
432
+ if (path !== undefined) {
433
+ published.push({ contentId: admission.object.contentId, path });
434
+ }
435
+ }
436
+ await this.verifyAdmissions(missing, 'verify staged object batch');
437
+ return published;
438
+ } catch (error) {
439
+ return this.throwAfterRollback(
440
+ error,
441
+ published.map((entry) => entry.path),
442
+ 'stage object batch and rollback',
443
+ undefined,
444
+ );
445
+ }
446
+ }
447
+
448
+ private async admitObjectBatchUnlocked<T>(
449
+ admissions: readonly StoredObjectWithBytes[],
450
+ publish: () => Promise<T>,
451
+ ): Promise<T> {
452
+ const byContentId = this.prepareObjectAdmissions(admissions);
453
+ const missing = await this.findMissingAdmissions(byContentId);
454
+ const additionalBytes = missing.reduce(
455
+ (total, admission) => total + admission.object.byteLength,
456
+ 0,
457
+ );
458
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
459
+ this.persistence.enforceQuota(storedBytes, additionalBytes, 'batch');
460
+ const published: string[] = [];
461
+ try {
462
+ await this.publishAdmissions(missing, published, 'commit object batch');
463
+ await this.verifyAdmissions(missing, 'verify admitted object batch');
464
+ return await publish();
465
+ } catch (error) {
466
+ return this.throwAfterRollback(
467
+ error,
468
+ published,
469
+ 'admit object batch and rollback',
470
+ undefined,
471
+ );
472
+ }
473
+ }
474
+
475
+ private prepareObjectAdmissions(
476
+ admissions: readonly StoredObjectWithBytes[],
477
+ ): ReadonlyMap<string, StoredObjectWithBytes> {
478
+ const byContentId = new Map<string, StoredObjectWithBytes>();
479
+ for (const admission of admissions) {
480
+ validateStoredObjectMetadata(admission.object, 'admit object batch');
481
+ if (
482
+ admission.bytes.byteLength !== admission.object.byteLength ||
483
+ contentIdFor(admission.bytes) !== admission.object.contentId
484
+ ) {
485
+ throw new MediaObjectHashMismatchError(
486
+ 'admit object batch',
487
+ admission.object.contentId,
488
+ );
489
+ }
490
+ this.validateCompatibleAdmission(byContentId, admission);
491
+ byContentId.set(admission.object.contentId, admission);
492
+ }
493
+ return byContentId;
494
+ }
495
+
496
+ private validateCompatibleAdmission(
497
+ admissions: ReadonlyMap<string, StoredObjectWithBytes>,
498
+ admission: StoredObjectWithBytes,
499
+ ): void {
500
+ const existing = admissions.get(admission.object.contentId);
501
+ if (existing === undefined) return;
502
+ if (storedObjectMetadataMatches(existing.object, admission.object)) return;
503
+ throw new MediaStoreError(
504
+ 'admit object batch',
505
+ admission.object.contentId,
506
+ new Error('Conflicting stored object metadata'),
507
+ );
508
+ }
509
+
510
+ private async findMissingAdmissions(
511
+ admissions: ReadonlyMap<string, StoredObjectWithBytes>,
512
+ ): Promise<readonly StoredObjectWithBytes[]> {
513
+ const missing: StoredObjectWithBytes[] = [];
514
+ for (const admission of admissions.values()) {
515
+ if (
516
+ await this.persistence.objectExistsUnlocked(admission.object.contentId)
517
+ ) {
518
+ await this.persistence.readObjectVerifiedUnlocked(
519
+ admission.object,
520
+ 'admit deduplicated object batch',
521
+ );
522
+ } else {
523
+ missing.push(admission);
524
+ }
525
+ }
526
+ return missing;
527
+ }
528
+
529
+ private async publishAdmissions(
530
+ admissions: Iterable<StoredObjectWithBytes>,
531
+ published: string[],
532
+ operation: string,
533
+ ): Promise<void> {
534
+ for (const admission of admissions) {
535
+ const path = await this.persistence.publishObjectBytes(
536
+ admission.bytes,
537
+ admission.object.contentId,
538
+ operation,
539
+ );
540
+ if (path !== undefined) published.push(path);
541
+ }
542
+ }
543
+
544
+ private async verifyAdmissions(
545
+ admissions: Iterable<StoredObjectWithBytes>,
546
+ operation: string,
547
+ ): Promise<void> {
548
+ for (const admission of admissions) {
549
+ await this.persistence.readObjectVerifiedUnlocked(
550
+ admission.object,
551
+ operation,
552
+ );
553
+ }
554
+ }
555
+
556
+ private async throwAfterRollback(
557
+ error: unknown,
558
+ published: readonly string[],
559
+ operation: string,
560
+ contentId: string | undefined,
561
+ ): Promise<never> {
562
+ const cleanupErrors =
563
+ await this.persistence.rollbackPublishedPaths(published);
564
+ if (cleanupErrors.length > 0) {
565
+ throw new MediaStoreError(
566
+ operation,
567
+ contentId,
568
+ new AggregateError([error, ...cleanupErrors]),
569
+ );
570
+ }
571
+ throw error;
572
+ }
573
+
574
+ private validateKnownByteLength(
575
+ knownByteLength: number,
576
+ contentId: string,
577
+ ): void {
578
+ if (!isPositiveSafeInteger(knownByteLength)) {
579
+ throw new MediaStoreError(
580
+ 'validate known byte length',
581
+ contentId,
582
+ new Error('Known byte length must be a positive safe integer'),
583
+ );
584
+ }
585
+ }
586
+
587
+ private async admitKnownSnapshotUnlocked(
588
+ input: MediaKnownAdmissionInput,
589
+ metadata: MediaStoredObject,
590
+ semanticMetadata: MediaSemanticMetadata,
591
+ providerFileIds: Readonly<Record<string, string>> | undefined,
592
+ bytes: Uint8Array,
593
+ ): Promise<MediaReferenceBlock> {
594
+ if (await this.persistence.objectExistsUnlocked(input.contentId)) {
595
+ await this.persistence.readObjectVerifiedUnlocked(
596
+ metadata,
597
+ 'admit deduplicated object',
598
+ );
599
+ return buildIdentityReference(
600
+ metadata,
601
+ semanticMetadata,
602
+ providerFileIds,
603
+ );
604
+ }
605
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
606
+ this.persistence.enforceQuota(
607
+ storedBytes,
608
+ input.knownByteLength,
609
+ input.contentId,
610
+ );
611
+ const published = await this.persistence.publishObjectBytes(
612
+ bytes,
613
+ input.contentId,
614
+ 'commit object',
615
+ );
616
+ try {
617
+ await this.persistence.readObjectVerifiedUnlocked(
618
+ metadata,
619
+ 'verify admitted object',
620
+ );
621
+ return buildIdentityReference(
622
+ metadata,
623
+ semanticMetadata,
624
+ providerFileIds,
625
+ );
626
+ } catch (error) {
627
+ return this.throwAfterRollback(
628
+ error,
629
+ published === undefined ? [] : [published],
630
+ 'admit known object and rollback',
631
+ input.contentId,
632
+ );
633
+ }
634
+ }
635
+
636
+ private async admitPreparedUnlocked(
637
+ prepared: PreparedAdmission,
638
+ ): Promise<void> {
639
+ const objects = new Map<string, StoredObjectWithBytes>();
640
+ objects.set(prepared.original.contentId, {
641
+ object: prepared.original,
642
+ bytes: prepared.originalBytes,
643
+ });
644
+ objects.set(prepared.selected.contentId, {
645
+ object: prepared.selected,
646
+ bytes: prepared.selectedBytes,
647
+ });
648
+ const missing = await this.findMissingPreparedObjects(objects);
649
+ const additionalBytes = missing.reduce(
650
+ (total, entry) => total + entry.object.byteLength,
651
+ 0,
652
+ );
653
+ const storedBytes = await this.persistence.measureStoredBytesUnlocked();
654
+ this.persistence.enforceQuota(
655
+ storedBytes,
656
+ additionalBytes,
657
+ prepared.selected.contentId,
658
+ );
659
+ await this.publishAndVerifyPrepared(prepared, missing);
660
+ }
661
+
662
+ private async findMissingPreparedObjects(
663
+ objects: ReadonlyMap<string, StoredObjectWithBytes>,
664
+ ): Promise<readonly StoredObjectWithBytes[]> {
665
+ const missing: StoredObjectWithBytes[] = [];
666
+ for (const entry of objects.values()) {
667
+ if (await this.persistence.objectExistsUnlocked(entry.object.contentId)) {
668
+ await this.persistence.readObjectVerifiedUnlocked(
669
+ entry.object,
670
+ 'admit deduplicated object',
671
+ );
672
+ } else {
673
+ missing.push(entry);
674
+ }
675
+ }
676
+ return missing;
677
+ }
678
+
679
+ private async publishAndVerifyPrepared(
680
+ prepared: PreparedAdmission,
681
+ missing: readonly StoredObjectWithBytes[],
682
+ ): Promise<void> {
683
+ const published: string[] = [];
684
+ try {
685
+ await this.publishAdmissions(missing, published, 'commit object');
686
+ await this.verifyAdmissions(missing, 'verify admitted object');
687
+ } catch (error) {
688
+ await this.throwAfterRollback(
689
+ error,
690
+ published,
691
+ 'admit objects and rollback',
692
+ prepared.selected.contentId,
693
+ );
694
+ }
695
+ }
696
+ }