@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,643 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Vybestack LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import { createHash, randomUUID } from 'node:crypto';
8
+ import { constants } from 'node:fs';
9
+ import {
10
+ chmod,
11
+ link,
12
+ lstat,
13
+ mkdir,
14
+ open,
15
+ readFile,
16
+ rename,
17
+ unlink,
18
+ utimes,
19
+ } from 'node:fs/promises';
20
+ import { dirname, join } from 'node:path';
21
+ import type { LocalMediaStoreFileOperations } from './local-media-store-types.js';
22
+ import {
23
+ MediaObjectCorruptError,
24
+ MediaObjectMissingError,
25
+ MediaStoreError,
26
+ } from './local-media-store-types.js';
27
+ import {
28
+ digestFor,
29
+ hasErrnoCode,
30
+ validateContentId,
31
+ wrapError,
32
+ } from './local-media-store-validation.js';
33
+
34
+ const DIRECTORY_MODE = 0o700;
35
+ const FILE_MODE = 0o600;
36
+ const COPY_BUFFER_BYTES = 64 * 1024;
37
+
38
+ interface FileCopyResult {
39
+ readonly digest: string;
40
+ readonly byteLength: number;
41
+ }
42
+
43
+ export class LocalMediaStoreFiles {
44
+ readonly rootDirectory: string;
45
+ readonly objectDirectory: string;
46
+ readonly temporaryDirectory: string;
47
+ readonly reservationDirectory: string;
48
+ readonly instanceDirectory: string;
49
+ readonly lockDirectory: string;
50
+ readonly lockPath: string;
51
+ private readonly fileOperations: LocalMediaStoreFileOperations;
52
+
53
+ constructor(
54
+ rootDirectory: string,
55
+ fileOperations: LocalMediaStoreFileOperations | undefined,
56
+ ) {
57
+ this.rootDirectory = rootDirectory;
58
+ this.objectDirectory = join(rootDirectory, 'objects', 'sha256');
59
+ this.temporaryDirectory = join(rootDirectory, 'temporary');
60
+ this.reservationDirectory = join(rootDirectory, 'references', 'sha256');
61
+ this.instanceDirectory = join(rootDirectory, 'instances');
62
+ this.lockDirectory = join(rootDirectory, 'locks');
63
+ this.lockPath = join(this.lockDirectory, 'store.lock');
64
+ this.fileOperations = fileOperations ?? { link, rename };
65
+ }
66
+
67
+ async ensureDirectories(contentId: string | undefined): Promise<void> {
68
+ const directories = [
69
+ this.rootDirectory,
70
+ join(this.rootDirectory, 'objects'),
71
+ this.objectDirectory,
72
+ this.temporaryDirectory,
73
+ join(this.rootDirectory, 'references'),
74
+ this.reservationDirectory,
75
+ this.instanceDirectory,
76
+ this.lockDirectory,
77
+ ];
78
+ for (const directory of directories) {
79
+ await this.ensureDirectory(
80
+ directory,
81
+ contentId,
82
+ 'initialize directories',
83
+ );
84
+ }
85
+ }
86
+
87
+ async ensureDirectory(
88
+ path: string,
89
+ contentId: string | undefined,
90
+ operation: string,
91
+ ): Promise<void> {
92
+ try {
93
+ if (path === this.rootDirectory) {
94
+ await this.ensureRootDirectory(path);
95
+ } else {
96
+ await this.createDirectory(path);
97
+ }
98
+ const metadata = await lstat(path);
99
+ if (metadata.isSymbolicLink()) {
100
+ throw new Error('Managed media directory must not be a symbolic link');
101
+ }
102
+ if (!metadata.isDirectory()) {
103
+ throw new Error('Managed media path is not a directory');
104
+ }
105
+ if (process.platform !== 'win32') {
106
+ await chmod(path, DIRECTORY_MODE);
107
+ const restored = await lstat(path);
108
+ if (
109
+ restored.isSymbolicLink() ||
110
+ !restored.isDirectory() ||
111
+ (restored.mode & 0o777) !== DIRECTORY_MODE
112
+ ) {
113
+ throw new Error(
114
+ 'Managed media directory permissions were not restored',
115
+ );
116
+ }
117
+ }
118
+ } catch (error) {
119
+ throw wrapError(operation, contentId, error);
120
+ }
121
+ }
122
+
123
+ private async createDirectory(path: string): Promise<void> {
124
+ try {
125
+ await mkdir(path, { mode: DIRECTORY_MODE });
126
+ } catch (error) {
127
+ if (!hasErrnoCode(error, 'EEXIST')) throw error;
128
+ }
129
+ }
130
+
131
+ private async ensureRootDirectory(path: string): Promise<void> {
132
+ try {
133
+ const existing = await lstat(path);
134
+ if (existing.isSymbolicLink()) {
135
+ throw new Error('Managed media root must not be a symbolic link');
136
+ }
137
+ return;
138
+ } catch (error) {
139
+ if (!hasErrnoCode(error, 'ENOENT')) throw error;
140
+ }
141
+ await mkdir(path, { recursive: true, mode: DIRECTORY_MODE });
142
+ }
143
+
144
+ async inspectReclamationCandidate(path: string): Promise<void> {
145
+ await this.fileOperations.inspectReclamationCandidate?.(path);
146
+ }
147
+
148
+ async syncDirectory(path: string): Promise<void> {
149
+ if (this.fileOperations.syncDirectory !== undefined) {
150
+ await this.fileOperations.syncDirectory(path);
151
+ return;
152
+ }
153
+ if (process.platform === 'win32') return;
154
+ let handle: Awaited<ReturnType<typeof open>> | undefined;
155
+ let failure: unknown;
156
+ try {
157
+ handle = await open(path, 'r');
158
+ await handle.sync();
159
+ } catch (error) {
160
+ failure = error;
161
+ }
162
+ if (handle !== undefined) {
163
+ try {
164
+ await handle.close();
165
+ } catch (closeError) {
166
+ failure =
167
+ failure === undefined
168
+ ? closeError
169
+ : new AggregateError([failure, closeError]);
170
+ }
171
+ }
172
+ if (failure !== undefined) {
173
+ throw wrapError('sync directory', undefined, failure);
174
+ }
175
+ }
176
+
177
+ objectPath(contentId: string): string {
178
+ validateContentId(contentId, 'derive object path');
179
+ return join(this.objectDirectory, digestFor(contentId));
180
+ }
181
+
182
+ async readRegularFile(
183
+ path: string,
184
+ contentId: string,
185
+ operation: string,
186
+ ): Promise<Buffer> {
187
+ let objectStat: Awaited<ReturnType<typeof lstat>>;
188
+ try {
189
+ objectStat = await lstat(path);
190
+ } catch (error) {
191
+ if (hasErrnoCode(error, 'ENOENT')) {
192
+ throw new MediaObjectMissingError(operation, contentId, error);
193
+ }
194
+ throw wrapError(`${operation} metadata`, contentId, error);
195
+ }
196
+ if (!objectStat.isFile()) {
197
+ throw new MediaObjectCorruptError(
198
+ operation,
199
+ contentId,
200
+ new Error('Stored object is not a regular file'),
201
+ );
202
+ }
203
+ try {
204
+ return await readFile(path);
205
+ } catch (error) {
206
+ if (hasErrnoCode(error, 'ENOENT')) {
207
+ throw new MediaObjectMissingError(operation, contentId, error);
208
+ }
209
+ throw wrapError(`${operation} bytes`, contentId, error);
210
+ }
211
+ }
212
+
213
+ instancePath(instanceId: string): string {
214
+ return join(this.instanceDirectory, instanceId);
215
+ }
216
+
217
+ async publishObjectBytes(
218
+ bytes: Uint8Array,
219
+ contentId: string,
220
+ operation: string,
221
+ ): Promise<string | undefined> {
222
+ const path = this.objectPath(contentId);
223
+ const created = await this.publishBytes(bytes, path, contentId, operation);
224
+ return created ? path : undefined;
225
+ }
226
+
227
+ async publishInstanceBytes(
228
+ bytes: Uint8Array,
229
+ instanceId: string,
230
+ contentId: string,
231
+ ): Promise<void> {
232
+ const destinationPath = this.instancePath(instanceId);
233
+ const created = await this.publishBytes(
234
+ bytes,
235
+ destinationPath,
236
+ contentId,
237
+ 'publish instance lease',
238
+ );
239
+ if (!created) {
240
+ throw new MediaStoreError(
241
+ 'publish instance lease',
242
+ contentId,
243
+ new Error('Instance lease identity already exists'),
244
+ );
245
+ }
246
+ }
247
+
248
+ async publishObjectFile(
249
+ sourcePath: string,
250
+ contentId: string,
251
+ expectedByteLength: number,
252
+ operation: string,
253
+ ): Promise<string | undefined> {
254
+ const destinationPath = this.objectPath(contentId);
255
+ const temporaryPath = this.temporaryPath(contentId);
256
+ let destinationCreated = false;
257
+ let failure: unknown;
258
+ try {
259
+ const verified = await this.copyAndHashRegularFile(
260
+ sourcePath,
261
+ temporaryPath,
262
+ );
263
+ if (
264
+ verified.byteLength !== expectedByteLength ||
265
+ `sha256:${verified.digest}` !== contentId
266
+ ) {
267
+ throw new Error('Source media object changed during publication');
268
+ }
269
+ destinationCreated = await this.linkDestination(
270
+ temporaryPath,
271
+ destinationPath,
272
+ contentId,
273
+ operation,
274
+ );
275
+ if (destinationCreated) {
276
+ const publishedAt = new Date();
277
+ await utimes(destinationPath, publishedAt, publishedAt);
278
+ }
279
+ await this.restoreFileMode(destinationPath, contentId, operation);
280
+ await this.syncDirectory(dirname(destinationPath));
281
+ } catch (error) {
282
+ failure = error;
283
+ }
284
+ const cleanupFailure = await this.cleanupTemporaryFile(
285
+ undefined,
286
+ temporaryPath,
287
+ destinationPath,
288
+ destinationCreated,
289
+ failure,
290
+ );
291
+ this.throwPublishFailure(failure, cleanupFailure, operation, contentId);
292
+ return destinationCreated ? destinationPath : undefined;
293
+ }
294
+
295
+ private async copyAndHashRegularFile(
296
+ sourcePath: string,
297
+ temporaryPath: string,
298
+ ): Promise<FileCopyResult> {
299
+ const source = await open(
300
+ sourcePath,
301
+ constants.O_RDONLY | constants.O_NOFOLLOW,
302
+ );
303
+ let destination: Awaited<ReturnType<typeof open>> | undefined;
304
+ let failure: unknown;
305
+ const hash = createHash('sha256');
306
+ let byteLength = 0;
307
+ try {
308
+ const sourceMetadata = await source.stat();
309
+ if (!sourceMetadata.isFile()) {
310
+ throw new Error('Source media object is not a regular file');
311
+ }
312
+ destination = await open(temporaryPath, 'wx', FILE_MODE);
313
+ const buffer = Buffer.allocUnsafe(COPY_BUFFER_BYTES);
314
+ let reading = true;
315
+ while (reading) {
316
+ const { bytesRead } = await source.read(
317
+ buffer,
318
+ 0,
319
+ buffer.byteLength,
320
+ null,
321
+ );
322
+ reading = bytesRead !== 0;
323
+ if (reading) {
324
+ hash.update(buffer.subarray(0, bytesRead));
325
+ await this.writeComplete(destination, buffer.subarray(0, bytesRead));
326
+ byteLength += bytesRead;
327
+ }
328
+ }
329
+ await destination.sync();
330
+ } catch (error) {
331
+ failure = error;
332
+ }
333
+ const closeFailures = await this.closeHandles([destination, source]);
334
+ if (failure !== undefined || closeFailures.length > 0) {
335
+ if (closeFailures.length === 0) throw failure;
336
+ const failures =
337
+ failure === undefined ? closeFailures : [failure, ...closeFailures];
338
+ throw new AggregateError(failures);
339
+ }
340
+ return { digest: hash.digest('hex'), byteLength };
341
+ }
342
+
343
+ private async writeComplete(
344
+ handle: Awaited<ReturnType<typeof open>>,
345
+ bytes: Uint8Array,
346
+ ): Promise<void> {
347
+ let offset = 0;
348
+ while (offset < bytes.byteLength) {
349
+ const { bytesWritten } = await handle.write(
350
+ bytes,
351
+ offset,
352
+ bytes.byteLength - offset,
353
+ );
354
+ if (bytesWritten === 0) {
355
+ throw new Error('Temporary media write made no progress');
356
+ }
357
+ offset += bytesWritten;
358
+ }
359
+ }
360
+
361
+ private async closeHandles(
362
+ handles: ReadonlyArray<Awaited<ReturnType<typeof open>> | undefined>,
363
+ ): Promise<unknown[]> {
364
+ const failures: unknown[] = [];
365
+ for (const handle of handles) {
366
+ if (handle === undefined) continue;
367
+ try {
368
+ await handle.close();
369
+ } catch (error) {
370
+ failures.push(error);
371
+ }
372
+ }
373
+ return failures;
374
+ }
375
+
376
+ async replacePublishedBytes(
377
+ bytes: Uint8Array,
378
+ destinationPath: string,
379
+ contentId: string,
380
+ operation: string,
381
+ ): Promise<void> {
382
+ const directory = dirname(destinationPath);
383
+ const temporaryPath = join(directory, `.${randomUUID()}.replacement`);
384
+ let handle: Awaited<ReturnType<typeof open>> | undefined;
385
+ let failure: unknown;
386
+ try {
387
+ handle = await open(temporaryPath, 'wx', FILE_MODE);
388
+ await handle.writeFile(bytes);
389
+ await handle.sync();
390
+ await handle.close();
391
+ handle = undefined;
392
+ await (this.fileOperations.rename ?? rename)(
393
+ temporaryPath,
394
+ destinationPath,
395
+ );
396
+ await this.restoreFileMode(destinationPath, contentId, operation);
397
+ await this.syncDirectory(directory);
398
+ } catch (error) {
399
+ failure = error;
400
+ }
401
+ const cleanupFailure = await this.cleanupReplacement(handle, temporaryPath);
402
+ this.throwPublishFailure(failure, cleanupFailure, operation, contentId);
403
+ }
404
+
405
+ private async cleanupReplacement(
406
+ handle: Awaited<ReturnType<typeof open>> | undefined,
407
+ temporaryPath: string,
408
+ ): Promise<unknown> {
409
+ const failures: unknown[] = [];
410
+ if (handle !== undefined) {
411
+ try {
412
+ await handle.close();
413
+ } catch (error) {
414
+ failures.push(error);
415
+ }
416
+ }
417
+ try {
418
+ await unlink(temporaryPath);
419
+ } catch (error) {
420
+ if (!hasErrnoCode(error, 'ENOENT')) failures.push(error);
421
+ }
422
+ if (failures.length === 0) return undefined;
423
+ return failures.length === 1 ? failures[0] : new AggregateError(failures);
424
+ }
425
+
426
+ async rollbackPublishedPaths(paths: readonly string[]): Promise<unknown[]> {
427
+ const cleanupErrors: unknown[] = [];
428
+ for (const path of paths) {
429
+ const cleanupError = await this.removePublishedPath(path);
430
+ if (cleanupError !== undefined) cleanupErrors.push(cleanupError);
431
+ }
432
+ return cleanupErrors;
433
+ }
434
+
435
+ private temporaryPath(contentId: string): string {
436
+ return join(
437
+ this.temporaryDirectory,
438
+ `${digestFor(contentId)}.${randomUUID()}.tmp`,
439
+ );
440
+ }
441
+
442
+ private async publishBytes(
443
+ bytes: Uint8Array,
444
+ destinationPath: string,
445
+ contentId: string,
446
+ operation: string,
447
+ ): Promise<boolean> {
448
+ const temporaryPath = this.temporaryPath(contentId);
449
+ let handle: Awaited<ReturnType<typeof open>> | undefined;
450
+ let failure: unknown;
451
+ let destinationCreated = false;
452
+ try {
453
+ handle = await open(temporaryPath, 'wx', FILE_MODE);
454
+ await handle.writeFile(bytes);
455
+ await handle.sync();
456
+ await handle.close();
457
+ handle = undefined;
458
+ destinationCreated = await this.linkDestination(
459
+ temporaryPath,
460
+ destinationPath,
461
+ contentId,
462
+ operation,
463
+ );
464
+ if (destinationCreated) {
465
+ const publishedAt = new Date();
466
+ await utimes(destinationPath, publishedAt, publishedAt);
467
+ }
468
+ await this.restoreFileMode(destinationPath, contentId, operation);
469
+ await this.syncDirectory(dirname(destinationPath));
470
+ } catch (error) {
471
+ failure = error;
472
+ }
473
+ const cleanupFailure = await this.cleanupTemporaryFile(
474
+ handle,
475
+ temporaryPath,
476
+ destinationPath,
477
+ destinationCreated,
478
+ failure,
479
+ );
480
+ this.throwPublishFailure(failure, cleanupFailure, operation, contentId);
481
+ return destinationCreated;
482
+ }
483
+
484
+ private async linkDestination(
485
+ temporaryPath: string,
486
+ destinationPath: string,
487
+ contentId: string,
488
+ operation: string,
489
+ ): Promise<boolean> {
490
+ try {
491
+ await this.fileOperations.link(temporaryPath, destinationPath);
492
+ return true;
493
+ } catch (error) {
494
+ if (!hasErrnoCode(error, 'EEXIST')) {
495
+ const rollbackFailure = await this.rollbackLinkedDestination(
496
+ temporaryPath,
497
+ destinationPath,
498
+ );
499
+ if (rollbackFailure !== undefined) {
500
+ throw new AggregateError([error, rollbackFailure]);
501
+ }
502
+ throw error;
503
+ }
504
+ await this.verifyRegularPath(destinationPath, contentId, operation);
505
+ return false;
506
+ }
507
+ }
508
+
509
+ private async rollbackLinkedDestination(
510
+ temporaryPath: string,
511
+ destinationPath: string,
512
+ ): Promise<unknown | undefined> {
513
+ try {
514
+ const [temporary, destination] = await Promise.all([
515
+ lstat(temporaryPath),
516
+ lstat(destinationPath),
517
+ ]);
518
+ if (
519
+ temporary.dev === destination.dev &&
520
+ temporary.ino === destination.ino
521
+ ) {
522
+ await unlink(destinationPath);
523
+ }
524
+ return undefined;
525
+ } catch (error) {
526
+ return hasErrnoCode(error, 'ENOENT') ? undefined : error;
527
+ }
528
+ }
529
+
530
+ private async verifyRegularPath(
531
+ path: string,
532
+ contentId: string,
533
+ operation: string,
534
+ ): Promise<void> {
535
+ try {
536
+ const metadata = await lstat(path);
537
+ if (metadata.isSymbolicLink()) {
538
+ throw new MediaObjectCorruptError(
539
+ operation,
540
+ contentId,
541
+ new Error(
542
+ 'Media publication destination must not be a symbolic link',
543
+ ),
544
+ );
545
+ }
546
+ if (!metadata.isFile()) {
547
+ throw new MediaObjectCorruptError(
548
+ operation,
549
+ contentId,
550
+ new Error('Media publication destination is not a regular file'),
551
+ );
552
+ }
553
+ } catch (error) {
554
+ throw wrapError(operation, contentId, error);
555
+ }
556
+ }
557
+
558
+ private async cleanupTemporaryFile(
559
+ handle: Awaited<ReturnType<typeof open>> | undefined,
560
+ temporaryPath: string,
561
+ destinationPath: string,
562
+ destinationCreated: boolean,
563
+ failure: unknown,
564
+ ): Promise<unknown> {
565
+ const failures: unknown[] = [];
566
+ if (handle !== undefined) {
567
+ try {
568
+ await handle.close();
569
+ } catch (error) {
570
+ failures.push(error);
571
+ }
572
+ }
573
+ try {
574
+ await unlink(temporaryPath);
575
+ } catch (error) {
576
+ if (!hasErrnoCode(error, 'ENOENT')) failures.push(error);
577
+ }
578
+ if (failure !== undefined && destinationCreated) {
579
+ try {
580
+ await unlink(destinationPath);
581
+ await this.syncDirectory(dirname(destinationPath));
582
+ } catch (error) {
583
+ if (!hasErrnoCode(error, 'ENOENT')) failures.push(error);
584
+ }
585
+ }
586
+ if (failures.length === 0) return undefined;
587
+ return failures.length === 1 ? failures[0] : new AggregateError(failures);
588
+ }
589
+
590
+ private throwPublishFailure(
591
+ failure: unknown,
592
+ cleanupFailure: unknown,
593
+ operation: string,
594
+ contentId: string,
595
+ ): void {
596
+ if (failure !== undefined && cleanupFailure !== undefined) {
597
+ throw new MediaStoreError(
598
+ `${operation} and cleanup temporary file`,
599
+ contentId,
600
+ new AggregateError([failure, cleanupFailure]),
601
+ );
602
+ }
603
+ if (cleanupFailure !== undefined) {
604
+ throw new MediaStoreError(
605
+ `cleanup temporary file after ${operation}`,
606
+ contentId,
607
+ cleanupFailure,
608
+ );
609
+ }
610
+ if (failure !== undefined) throw wrapError(operation, contentId, failure);
611
+ }
612
+
613
+ private async removePublishedPath(path: string): Promise<unknown> {
614
+ try {
615
+ await unlink(path);
616
+ return undefined;
617
+ } catch (error) {
618
+ return hasErrnoCode(error, 'ENOENT') ? undefined : error;
619
+ }
620
+ }
621
+
622
+ private async restoreFileMode(
623
+ path: string,
624
+ contentId: string,
625
+ operation: string,
626
+ ): Promise<void> {
627
+ await this.verifyRegularPath(path, contentId, operation);
628
+ if (process.platform === 'win32') return;
629
+ try {
630
+ await chmod(path, FILE_MODE);
631
+ const metadata = await lstat(path);
632
+ if (
633
+ metadata.isSymbolicLink() ||
634
+ !metadata.isFile() ||
635
+ (metadata.mode & 0o777) !== FILE_MODE
636
+ ) {
637
+ throw new Error('Media object permissions were not restored');
638
+ }
639
+ } catch (error) {
640
+ throw wrapError(operation, contentId, error);
641
+ }
642
+ }
643
+ }