@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,111 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Vybestack LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import type { Dirent } from 'node:fs';
8
+ import { lstat, opendir } from 'node:fs/promises';
9
+ import { join } from 'node:path';
10
+ import { MediaStoreError } from './local-media-store-types.js';
11
+ import {
12
+ CONTENT_ID_PREFIX,
13
+ DIGEST_PATTERN,
14
+ wrapError,
15
+ } from './local-media-store-validation.js';
16
+
17
+ function validateQuotaEntry(entry: Dirent<string>): void {
18
+ if (!DIGEST_PATTERN.test(entry.name) || !entry.isFile()) {
19
+ throw new MediaStoreError(
20
+ 'measure spool quota',
21
+ entry.name,
22
+ new Error('Unexpected object-store entry'),
23
+ );
24
+ }
25
+ }
26
+
27
+ async function readQuotaEntriesWithinBound(
28
+ objectDirectory: string,
29
+ maxEntries: number,
30
+ ): Promise<ReadonlyArray<Dirent<string>>> {
31
+ const entries: Array<Dirent<string>> = [];
32
+ try {
33
+ const directory = await opendir(objectDirectory);
34
+ for await (const entry of directory) {
35
+ if (entries.length === maxEntries) {
36
+ throw new MediaStoreError(
37
+ 'establish quota state within bound',
38
+ undefined,
39
+ new Error(`Object count exceeds quota scan bound ${maxEntries}`),
40
+ );
41
+ }
42
+ validateQuotaEntry(entry);
43
+ entries.push(entry);
44
+ }
45
+ } catch (error) {
46
+ if (error instanceof MediaStoreError) throw error;
47
+ throw wrapError('measure spool quota', undefined, error);
48
+ }
49
+ return entries;
50
+ }
51
+
52
+ async function measureStoredBytes(
53
+ objectDirectory: string,
54
+ maxEntries: number,
55
+ ): Promise<number> {
56
+ const entries = await readQuotaEntriesWithinBound(
57
+ objectDirectory,
58
+ maxEntries,
59
+ );
60
+ const sizes = await Promise.all(
61
+ entries.map(async (entry) => {
62
+ try {
63
+ return (await lstat(join(objectDirectory, entry.name))).size;
64
+ } catch (error) {
65
+ throw wrapError(
66
+ 'measure spool quota',
67
+ `${CONTENT_ID_PREFIX}${entry.name}`,
68
+ error,
69
+ );
70
+ }
71
+ }),
72
+ );
73
+ const total = sizes.reduce((sum, size) => sum + size, 0);
74
+ if (!Number.isSafeInteger(total)) {
75
+ throw new MediaStoreError(
76
+ 'measure spool quota',
77
+ undefined,
78
+ new Error('Stored byte usage exceeds safe integer range'),
79
+ );
80
+ }
81
+ return total;
82
+ }
83
+
84
+ export async function measureStoredBytesWithinBound(
85
+ objectDirectory: string,
86
+ maxEntries: number,
87
+ timeoutMs: number,
88
+ ): Promise<number> {
89
+ let timeout: ReturnType<typeof setTimeout> | undefined;
90
+ const deadline = new Promise<never>((_resolve, reject) => {
91
+ timeout = setTimeout(
92
+ () =>
93
+ reject(
94
+ new MediaStoreError(
95
+ 'establish quota state within bound',
96
+ undefined,
97
+ new Error(`Quota scan exceeded ${timeoutMs}ms`),
98
+ ),
99
+ ),
100
+ timeoutMs,
101
+ );
102
+ });
103
+ try {
104
+ return await Promise.race([
105
+ measureStoredBytes(objectDirectory, maxEntries),
106
+ deadline,
107
+ ]);
108
+ } finally {
109
+ if (timeout !== undefined) clearTimeout(timeout);
110
+ }
111
+ }
@@ -0,0 +1,485 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Vybestack LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+
7
+ import type { Dirent } from 'node:fs';
8
+ import { createHash, randomUUID } from 'node:crypto';
9
+ import { lstat, readFile, readdir, unlink, utimes } from 'node:fs/promises';
10
+ import { join } from 'node:path';
11
+ import type { LocalMediaStoreFiles } from './local-media-store-files.js';
12
+ import {
13
+ MediaStoreError,
14
+ type ReservationRecord,
15
+ } from './local-media-store-types.js';
16
+ import {
17
+ CONTENT_ID_PREFIX,
18
+ DIGEST_PATTERN,
19
+ digestFor,
20
+ hasErrnoCode,
21
+ parseReservationRecord,
22
+ wrapError,
23
+ } from './local-media-store-validation.js';
24
+
25
+ export interface InstanceLeaseRecord {
26
+ readonly version: 1;
27
+ readonly instanceId: string;
28
+ readonly token: string;
29
+ readonly createdAt: number;
30
+ }
31
+
32
+ interface ReclamationCandidate {
33
+ readonly contentId: string;
34
+ readonly path: string;
35
+ readonly device: number;
36
+ readonly inode: number;
37
+ }
38
+
39
+ export function parseInstanceLeaseRecord(
40
+ value: unknown,
41
+ ): InstanceLeaseRecord | undefined {
42
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
43
+ return undefined;
44
+ }
45
+ const version = Reflect.get(value, 'version');
46
+ const instanceId = Reflect.get(value, 'instanceId');
47
+ const token = Reflect.get(value, 'token');
48
+ const createdAt = Reflect.get(value, 'createdAt');
49
+ if (version !== 1) return undefined;
50
+ const validIdentity =
51
+ typeof instanceId === 'string' &&
52
+ instanceId.length > 0 &&
53
+ typeof token === 'string' &&
54
+ token.length > 0;
55
+ const validCreationTime =
56
+ typeof createdAt === 'number' &&
57
+ Number.isSafeInteger(createdAt) &&
58
+ createdAt >= 0;
59
+ if (!validIdentity || !validCreationTime) return undefined;
60
+ return { version, instanceId, token, createdAt };
61
+ }
62
+
63
+ export abstract class LocalMediaStoreReservations {
64
+ protected abstract readonly files: LocalMediaStoreFiles;
65
+ protected abstract readonly reservationLeaseMs: number;
66
+ protected readonly instanceId = randomUUID();
67
+ private readonly instanceLeaseToken = randomUUID();
68
+ private readonly instanceLeaseContentId = `sha256:${createHash('sha256')
69
+ .update(this.instanceId)
70
+ .digest('hex')}`;
71
+ private instanceLeaseTimer: ReturnType<typeof setInterval> | undefined;
72
+ private instanceLeaseRefresh: Promise<void> = Promise.resolve();
73
+ private instanceLeaseFailure: unknown;
74
+ private closed = false;
75
+
76
+ protected assertOpen(operation: string, contentId: string | undefined): void {
77
+ if (!this.closed) return;
78
+ throw new MediaStoreError(
79
+ operation,
80
+ contentId,
81
+ new Error('Local media store is closed'),
82
+ );
83
+ }
84
+
85
+ protected assertInstanceLeaseHealthy(contentId: string | undefined): void {
86
+ if (this.instanceLeaseFailure === undefined) return;
87
+ throw wrapError(
88
+ 'refresh media owner lease',
89
+ contentId,
90
+ this.instanceLeaseFailure,
91
+ );
92
+ }
93
+
94
+ async close(): Promise<void> {
95
+ if (this.closed) return;
96
+ this.closed = true;
97
+ const timer = this.instanceLeaseTimer;
98
+ this.instanceLeaseTimer = undefined;
99
+ if (timer === undefined) return;
100
+ clearInterval(timer);
101
+
102
+ const failures: unknown[] = [];
103
+ try {
104
+ await this.instanceLeaseRefresh;
105
+ } catch (error: unknown) {
106
+ failures.push(error);
107
+ }
108
+ try {
109
+ await this.removeInstanceLease();
110
+ } catch (error: unknown) {
111
+ failures.push(error);
112
+ }
113
+ if (failures.length === 1) {
114
+ throw wrapError('close media store', undefined, failures[0]);
115
+ }
116
+ if (failures.length > 1) {
117
+ throw new AggregateError(failures, 'Failed to close media store');
118
+ }
119
+ }
120
+
121
+ private async removeInstanceLease(): Promise<void> {
122
+ const path = this.files.instancePath(this.instanceId);
123
+ const parsed: unknown = JSON.parse(await readFile(path, 'utf8'));
124
+ const lease = parseInstanceLeaseRecord(parsed);
125
+ if (
126
+ lease?.instanceId !== this.instanceId ||
127
+ lease.token !== this.instanceLeaseToken
128
+ ) {
129
+ throw new Error('Media owner lease identity changed before close');
130
+ }
131
+ await unlink(path);
132
+ await this.files.syncDirectory(this.files.instanceDirectory);
133
+ }
134
+
135
+ protected async ensureInstanceLeaseUnlocked(): Promise<void> {
136
+ if (this.instanceLeaseTimer !== undefined) return;
137
+ const record: InstanceLeaseRecord = {
138
+ version: 1,
139
+ instanceId: this.instanceId,
140
+ token: this.instanceLeaseToken,
141
+ createdAt: Date.now(),
142
+ };
143
+ await this.files.publishInstanceBytes(
144
+ Buffer.from(JSON.stringify(record), 'utf8'),
145
+ this.instanceId,
146
+ this.instanceLeaseContentId,
147
+ );
148
+ const intervalMs = Math.max(1, Math.floor(this.reservationLeaseMs / 3));
149
+ this.instanceLeaseTimer = setInterval(() => {
150
+ if (this.instanceLeaseFailure !== undefined) return;
151
+ this.instanceLeaseRefresh = this.instanceLeaseRefresh.then(
152
+ () => this.refreshInstanceLease(),
153
+ () => this.refreshInstanceLease(),
154
+ );
155
+ void this.instanceLeaseRefresh.catch((error: unknown) => {
156
+ this.instanceLeaseFailure = error;
157
+ });
158
+ }, intervalMs);
159
+ this.instanceLeaseTimer.unref();
160
+ }
161
+
162
+ private async refreshInstanceLease(): Promise<void> {
163
+ const path = this.files.instancePath(this.instanceId);
164
+ try {
165
+ const before = await lstat(path);
166
+ const parsed: unknown = JSON.parse(await readFile(path, 'utf8'));
167
+ const current = parseInstanceLeaseRecord(parsed);
168
+ if (
169
+ current?.instanceId !== this.instanceId ||
170
+ current.token !== this.instanceLeaseToken
171
+ ) {
172
+ throw new Error('Media owner lease identity changed');
173
+ }
174
+ const now = new Date();
175
+ await utimes(path, now, now);
176
+ const after = await lstat(path);
177
+ if (before.dev !== after.dev || before.ino !== after.ino) {
178
+ throw new Error('Media owner lease file changed during heartbeat');
179
+ }
180
+ } catch (error) {
181
+ throw wrapError('refresh media owner lease', undefined, error);
182
+ }
183
+ }
184
+
185
+ protected async instanceLeaseIsFresh(instanceId: string): Promise<boolean> {
186
+ const path = this.files.instancePath(instanceId);
187
+ try {
188
+ const metadata = await lstat(path);
189
+ if (!metadata.isFile()) {
190
+ throw new Error('Media owner lease is not a regular file');
191
+ }
192
+ const parsed: unknown = JSON.parse(await readFile(path, 'utf8'));
193
+ const record = parseInstanceLeaseRecord(parsed);
194
+ if (record?.instanceId !== instanceId) {
195
+ throw new Error(
196
+ 'Media owner lease is malformed or has changed identity',
197
+ );
198
+ }
199
+ return Date.now() - metadata.mtimeMs < this.reservationLeaseMs;
200
+ } catch (error) {
201
+ if (hasErrnoCode(error, 'ENOENT')) return false;
202
+ throw wrapError('inspect media owner lease', undefined, error);
203
+ }
204
+ }
205
+
206
+ protected async readReservationIfPresent(
207
+ contentId: string,
208
+ ownerDigest: string,
209
+ ): Promise<ReservationRecord | undefined> {
210
+ try {
211
+ const parsed: unknown = JSON.parse(
212
+ await readFile(this.reservationPath(contentId, ownerDigest), 'utf8'),
213
+ );
214
+ const validated = parseReservationRecord(parsed);
215
+ if (validated === undefined || validated.ownerDigest !== ownerDigest) {
216
+ await this.removeReservation(contentId, ownerDigest);
217
+ return undefined;
218
+ }
219
+ return validated;
220
+ } catch (error) {
221
+ if (hasErrnoCode(error, 'ENOENT')) return undefined;
222
+ if (error instanceof SyntaxError) {
223
+ await this.removeReservation(contentId, ownerDigest);
224
+ return undefined;
225
+ }
226
+ throw wrapError('reserve reference', contentId, error);
227
+ }
228
+ }
229
+
230
+ protected async removeReservation(
231
+ contentId: string,
232
+ ownerDigest: string,
233
+ ): Promise<void> {
234
+ try {
235
+ await unlink(this.reservationPath(contentId, ownerDigest));
236
+ } catch (error) {
237
+ if (!hasErrnoCode(error, 'ENOENT')) {
238
+ throw wrapError('release reference', contentId, error);
239
+ }
240
+ }
241
+ }
242
+
243
+ protected async scanReclamationCandidates(
244
+ protectedContentIds: ReadonlySet<string>,
245
+ createdBefore: number,
246
+ ): Promise<readonly ReclamationCandidate[]> {
247
+ const candidates: ReclamationCandidate[] = [];
248
+ for (const entry of await this.readObjectDirectoryUnlocked(
249
+ 'reclaim media',
250
+ )) {
251
+ const candidate = await this.scanReclamationCandidate(
252
+ entry,
253
+ protectedContentIds,
254
+ createdBefore,
255
+ );
256
+ if (candidate !== undefined) candidates.push(candidate);
257
+ }
258
+ return candidates;
259
+ }
260
+
261
+ private async scanReclamationCandidate(
262
+ entry: Dirent<string>,
263
+ protectedContentIds: ReadonlySet<string>,
264
+ createdBefore: number,
265
+ ): Promise<ReclamationCandidate | undefined> {
266
+ this.validateObjectDirectoryEntry(entry, 'reclaim media');
267
+ const contentId = `${CONTENT_ID_PREFIX}${entry.name}`;
268
+ if (protectedContentIds.has(contentId)) return undefined;
269
+ const path = join(this.files.objectDirectory, entry.name);
270
+ await this.files.inspectReclamationCandidate(path);
271
+ let metadata: Awaited<ReturnType<typeof lstat>>;
272
+ try {
273
+ metadata = await lstat(path);
274
+ } catch (error) {
275
+ if (hasErrnoCode(error, 'ENOENT')) return undefined;
276
+ throw wrapError('scan reclaimable media object', contentId, error);
277
+ }
278
+ if (metadata.ctimeMs >= createdBefore) return undefined;
279
+ return {
280
+ contentId,
281
+ path,
282
+ device: metadata.dev,
283
+ inode: metadata.ino,
284
+ };
285
+ }
286
+
287
+ protected async reclaimObjectUnlocked(
288
+ candidate: ReclamationCandidate,
289
+ protectedContentIds: ReadonlySet<string>,
290
+ createdBefore: number,
291
+ ): Promise<boolean> {
292
+ let metadata: Awaited<ReturnType<typeof lstat>>;
293
+ try {
294
+ metadata = await lstat(candidate.path);
295
+ } catch (error) {
296
+ if (hasErrnoCode(error, 'ENOENT')) return false;
297
+ throw wrapError('revalidate media object', candidate.contentId, error);
298
+ }
299
+ const identityChanged =
300
+ !metadata.isFile() ||
301
+ metadata.dev !== candidate.device ||
302
+ metadata.ino !== candidate.inode;
303
+ if (identityChanged) return false;
304
+ const noLongerEligible =
305
+ metadata.ctimeMs >= createdBefore ||
306
+ protectedContentIds.has(candidate.contentId);
307
+ if (noLongerEligible) return false;
308
+ if (await this.hasReservationsUnlocked(candidate.contentId)) return false;
309
+ try {
310
+ await unlink(candidate.path);
311
+ await this.files.syncDirectory(this.files.objectDirectory);
312
+ return true;
313
+ } catch (error) {
314
+ if (hasErrnoCode(error, 'ENOENT')) return false;
315
+ throw wrapError('reclaim media object', candidate.contentId, error);
316
+ }
317
+ }
318
+
319
+ protected validateObjectDirectoryEntry(
320
+ entry: Dirent<string>,
321
+ operation: string,
322
+ ): void {
323
+ if (!DIGEST_PATTERN.test(entry.name) || !entry.isFile()) {
324
+ throw new MediaStoreError(
325
+ operation,
326
+ entry.name,
327
+ new Error('Unexpected object-store entry'),
328
+ );
329
+ }
330
+ }
331
+
332
+ protected async readObjectDirectoryUnlocked(
333
+ operation: string,
334
+ ): Promise<Array<Dirent<string>>> {
335
+ try {
336
+ return await readdir(this.files.objectDirectory, { withFileTypes: true });
337
+ } catch (error) {
338
+ throw wrapError(operation, undefined, error);
339
+ }
340
+ }
341
+
342
+ protected async prepareReservationPath(
343
+ contentId: string,
344
+ ownerDigest: string,
345
+ ): Promise<string> {
346
+ const ownerDirectory = join(
347
+ this.files.reservationDirectory,
348
+ digestFor(contentId),
349
+ );
350
+ await this.files.ensureDirectory(
351
+ ownerDirectory,
352
+ contentId,
353
+ 'reserve reference',
354
+ );
355
+ return join(ownerDirectory, ownerDigest);
356
+ }
357
+
358
+ protected reservationPath(contentId: string, ownerDigest: string): string {
359
+ return join(
360
+ this.files.reservationDirectory,
361
+ digestFor(contentId),
362
+ ownerDigest,
363
+ );
364
+ }
365
+
366
+ protected async hasReservationsUnlocked(contentId: string): Promise<boolean> {
367
+ const directory = join(
368
+ this.files.reservationDirectory,
369
+ digestFor(contentId),
370
+ );
371
+ const entries = await this.readReservationDirectory(directory, contentId);
372
+ for (const entry of entries) {
373
+ const record = await this.readReservationEntry(
374
+ directory,
375
+ entry,
376
+ contentId,
377
+ );
378
+ if (record === undefined) continue;
379
+ if (await this.instanceLeaseIsFresh(record.instanceId)) return true;
380
+ await this.removeStaleReservation(join(directory, entry.name), contentId);
381
+ }
382
+ return false;
383
+ }
384
+
385
+ protected async readReservationDirectory(
386
+ directory: string,
387
+ contentId: string,
388
+ ): Promise<Array<Dirent<string>>> {
389
+ try {
390
+ return await readdir(directory, { withFileTypes: true });
391
+ } catch (error) {
392
+ if (hasErrnoCode(error, 'ENOENT')) return [];
393
+ throw wrapError('inspect references', contentId, error);
394
+ }
395
+ }
396
+
397
+ protected async readReservationEntry(
398
+ directory: string,
399
+ entry: Dirent<string>,
400
+ contentId: string,
401
+ ): Promise<ReservationRecord | undefined> {
402
+ if (!entry.isFile()) return undefined;
403
+ const path = join(directory, entry.name);
404
+ if (!DIGEST_PATTERN.test(entry.name)) {
405
+ await this.removeStaleReservation(path, contentId);
406
+ return undefined;
407
+ }
408
+ try {
409
+ const parsed: unknown = JSON.parse(await readFile(path, 'utf8'));
410
+ const record = parseReservationRecord(parsed);
411
+ if (
412
+ record === undefined ||
413
+ record.ownerDigest !== entry.name ||
414
+ !record.relatedContentIds.includes(contentId)
415
+ ) {
416
+ await this.removeStaleReservation(path, contentId);
417
+ return undefined;
418
+ }
419
+ return record;
420
+ } catch (error) {
421
+ if (hasErrnoCode(error, 'ENOENT')) return undefined;
422
+ if (error instanceof SyntaxError) {
423
+ await this.removeStaleReservation(path, contentId);
424
+ return undefined;
425
+ }
426
+ throw wrapError('inspect references', contentId, error);
427
+ }
428
+ }
429
+
430
+ protected async removeStaleReservation(
431
+ path: string,
432
+ contentId: string,
433
+ ): Promise<void> {
434
+ try {
435
+ await unlink(path);
436
+ } catch (error) {
437
+ if (!hasErrnoCode(error, 'ENOENT')) {
438
+ throw wrapError('recover stale reference', contentId, error);
439
+ }
440
+ }
441
+ }
442
+
443
+ protected async reclaimTemporaryFilesUnlocked(
444
+ staleTemporaryBefore: number,
445
+ ): Promise<number> {
446
+ let entries: Array<Dirent<string>>;
447
+ try {
448
+ entries = await readdir(this.files.temporaryDirectory, {
449
+ withFileTypes: true,
450
+ });
451
+ } catch (error) {
452
+ throw wrapError('scan temporary media', undefined, error);
453
+ }
454
+ let removed = 0;
455
+ for (const entry of entries) {
456
+ if (await this.reclaimTemporaryEntry(entry, staleTemporaryBefore)) {
457
+ removed++;
458
+ }
459
+ }
460
+ return removed;
461
+ }
462
+
463
+ protected async reclaimTemporaryEntry(
464
+ entry: Dirent<string>,
465
+ staleTemporaryBefore: number,
466
+ ): Promise<boolean> {
467
+ if (!entry.isFile()) return false;
468
+ const path = join(this.files.temporaryDirectory, entry.name);
469
+ let metadata: Awaited<ReturnType<typeof lstat>>;
470
+ try {
471
+ metadata = await lstat(path);
472
+ } catch (error) {
473
+ if (hasErrnoCode(error, 'ENOENT')) return false;
474
+ throw wrapError('inspect temporary media', undefined, error);
475
+ }
476
+ if (metadata.mtimeMs >= staleTemporaryBefore) return false;
477
+ try {
478
+ await unlink(path);
479
+ return true;
480
+ } catch (error) {
481
+ if (hasErrnoCode(error, 'ENOENT')) return false;
482
+ throw wrapError('reclaim temporary media', undefined, error);
483
+ }
484
+ }
485
+ }