@namzu/sdk 38.2.1 → 39.0.0

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 (493) hide show
  1. package/CHANGELOG.md +700 -0
  2. package/dist/advisory/executor.d.ts +10 -1
  3. package/dist/advisory/executor.d.ts.map +1 -1
  4. package/dist/advisory/executor.js +5 -26
  5. package/dist/advisory/executor.js.map +1 -1
  6. package/dist/advisory/history.d.ts +9 -0
  7. package/dist/advisory/history.d.ts.map +1 -0
  8. package/dist/advisory/history.js +120 -0
  9. package/dist/advisory/history.js.map +1 -0
  10. package/dist/advisory/index.d.ts +1 -1
  11. package/dist/advisory/index.d.ts.map +1 -1
  12. package/dist/advisory/index.js.map +1 -1
  13. package/dist/agents/ReactiveAgent.d.ts.map +1 -1
  14. package/dist/agents/ReactiveAgent.js +3 -0
  15. package/dist/agents/ReactiveAgent.js.map +1 -1
  16. package/dist/agents/runAgent.d.ts +10 -0
  17. package/dist/agents/runAgent.d.ts.map +1 -1
  18. package/dist/agents/runAgent.js +3 -0
  19. package/dist/agents/runAgent.js.map +1 -1
  20. package/dist/compaction/manual.d.ts +6 -0
  21. package/dist/compaction/manual.d.ts.map +1 -1
  22. package/dist/compaction/manual.js +21 -2
  23. package/dist/compaction/manual.js.map +1 -1
  24. package/dist/compaction/summary.d.ts.map +1 -1
  25. package/dist/compaction/summary.js +4 -1
  26. package/dist/compaction/summary.js.map +1 -1
  27. package/dist/config/runtime.js +2 -2
  28. package/dist/config/runtime.js.map +1 -1
  29. package/dist/contracts/schemas.js +1 -1
  30. package/dist/contracts/schemas.js.map +1 -1
  31. package/dist/eval/harness-protection.d.ts +18 -0
  32. package/dist/eval/harness-protection.d.ts.map +1 -0
  33. package/dist/eval/harness-protection.js +58 -0
  34. package/dist/eval/harness-protection.js.map +1 -0
  35. package/dist/eval/harness-verification.d.ts +6 -1
  36. package/dist/eval/harness-verification.d.ts.map +1 -1
  37. package/dist/eval/harness-verification.js +19 -2
  38. package/dist/eval/harness-verification.js.map +1 -1
  39. package/dist/eval/index.d.ts +1 -0
  40. package/dist/eval/index.d.ts.map +1 -1
  41. package/dist/eval/index.js.map +1 -1
  42. package/dist/manager/resident/activity.d.ts +50 -0
  43. package/dist/manager/resident/activity.d.ts.map +1 -0
  44. package/dist/manager/resident/activity.js +125 -0
  45. package/dist/manager/resident/activity.js.map +1 -0
  46. package/dist/manager/resident/agenda.d.ts +13 -1
  47. package/dist/manager/resident/agenda.d.ts.map +1 -1
  48. package/dist/manager/resident/agenda.js +40 -5
  49. package/dist/manager/resident/agenda.js.map +1 -1
  50. package/dist/manager/resident/consumption.d.ts +104 -0
  51. package/dist/manager/resident/consumption.d.ts.map +1 -0
  52. package/dist/manager/resident/consumption.js +233 -0
  53. package/dist/manager/resident/consumption.js.map +1 -0
  54. package/dist/manager/resident/evidence-recall.d.ts +24 -0
  55. package/dist/manager/resident/evidence-recall.d.ts.map +1 -0
  56. package/dist/manager/resident/evidence-recall.js +295 -0
  57. package/dist/manager/resident/evidence-recall.js.map +1 -0
  58. package/dist/manager/resident/history-disk.d.ts +10 -0
  59. package/dist/manager/resident/history-disk.d.ts.map +1 -0
  60. package/dist/manager/resident/history-disk.js +50 -0
  61. package/dist/manager/resident/history-disk.js.map +1 -0
  62. package/dist/manager/resident/history.d.ts +79 -0
  63. package/dist/manager/resident/history.d.ts.map +1 -0
  64. package/dist/manager/resident/history.js +203 -0
  65. package/dist/manager/resident/history.js.map +1 -0
  66. package/dist/manager/resident/initiative.d.ts.map +1 -1
  67. package/dist/manager/resident/initiative.js +11 -3
  68. package/dist/manager/resident/initiative.js.map +1 -1
  69. package/dist/manager/resident/learning-cycle.d.ts +131 -0
  70. package/dist/manager/resident/learning-cycle.d.ts.map +1 -0
  71. package/dist/manager/resident/learning-cycle.js +306 -0
  72. package/dist/manager/resident/learning-cycle.js.map +1 -0
  73. package/dist/manager/resident/learning-observation.d.ts +80 -0
  74. package/dist/manager/resident/learning-observation.d.ts.map +1 -0
  75. package/dist/manager/resident/learning-observation.js +22 -0
  76. package/dist/manager/resident/learning-observation.js.map +1 -0
  77. package/dist/manager/resident/learning-store.d.ts +106 -0
  78. package/dist/manager/resident/learning-store.d.ts.map +1 -0
  79. package/dist/manager/resident/learning-store.js +598 -0
  80. package/dist/manager/resident/learning-store.js.map +1 -0
  81. package/dist/manager/resident/learning.d.ts +246 -3
  82. package/dist/manager/resident/learning.d.ts.map +1 -1
  83. package/dist/manager/resident/learning.js +96 -6
  84. package/dist/manager/resident/learning.js.map +1 -1
  85. package/dist/manager/resident/outbox.d.ts +4 -4
  86. package/dist/manager/resident/store.d.ts +37 -4
  87. package/dist/manager/resident/store.d.ts.map +1 -1
  88. package/dist/manager/resident/store.js +27 -3
  89. package/dist/manager/resident/store.js.map +1 -1
  90. package/dist/manager/resident/tool-evidence.d.ts +71 -0
  91. package/dist/manager/resident/tool-evidence.d.ts.map +1 -0
  92. package/dist/manager/resident/tool-evidence.js +285 -0
  93. package/dist/manager/resident/tool-evidence.js.map +1 -0
  94. package/dist/manager/run/persistence.d.ts.map +1 -1
  95. package/dist/manager/run/persistence.js +6 -0
  96. package/dist/manager/run/persistence.js.map +1 -1
  97. package/dist/plugin/loader.d.ts.map +1 -1
  98. package/dist/plugin/loader.js +5 -3
  99. package/dist/plugin/loader.js.map +1 -1
  100. package/dist/prompt/coding-agent-doctrine.d.ts +1 -1
  101. package/dist/prompt/coding-agent-doctrine.d.ts.map +1 -1
  102. package/dist/prompt/coding-agent-doctrine.js +2 -0
  103. package/dist/prompt/coding-agent-doctrine.js.map +1 -1
  104. package/dist/prompt/index.d.ts +2 -0
  105. package/dist/prompt/index.d.ts.map +1 -1
  106. package/dist/prompt/index.js +1 -0
  107. package/dist/prompt/index.js.map +1 -1
  108. package/dist/prompt/resident-learning.d.ts +19 -0
  109. package/dist/prompt/resident-learning.d.ts.map +1 -0
  110. package/dist/prompt/resident-learning.js +125 -0
  111. package/dist/prompt/resident-learning.js.map +1 -0
  112. package/dist/prompt/resident-step.d.ts +8 -1
  113. package/dist/prompt/resident-step.d.ts.map +1 -1
  114. package/dist/prompt/resident-step.js +65 -4
  115. package/dist/prompt/resident-step.js.map +1 -1
  116. package/dist/provider/collect-chat-completion.d.ts +2 -1
  117. package/dist/provider/collect-chat-completion.d.ts.map +1 -1
  118. package/dist/provider/collect-chat-completion.js +7 -6
  119. package/dist/provider/collect-chat-completion.js.map +1 -1
  120. package/dist/provider/fallback.d.ts.map +1 -1
  121. package/dist/provider/fallback.js +2 -1
  122. package/dist/provider/fallback.js.map +1 -1
  123. package/dist/provider/stream-text.d.ts +16 -0
  124. package/dist/provider/stream-text.d.ts.map +1 -0
  125. package/dist/provider/stream-text.js +51 -0
  126. package/dist/provider/stream-text.js.map +1 -0
  127. package/dist/public-runtime.d.ts +13 -3
  128. package/dist/public-runtime.d.ts.map +1 -1
  129. package/dist/public-runtime.js +12 -3
  130. package/dist/public-runtime.js.map +1 -1
  131. package/dist/public-tools.d.ts +2 -0
  132. package/dist/public-tools.d.ts.map +1 -1
  133. package/dist/public-tools.js +2 -0
  134. package/dist/public-tools.js.map +1 -1
  135. package/dist/public-types.d.ts +15 -3
  136. package/dist/public-types.d.ts.map +1 -1
  137. package/dist/run/LimitChecker.js +3 -3
  138. package/dist/run/LimitChecker.js.map +1 -1
  139. package/dist/run/evidence-query.d.ts +41 -0
  140. package/dist/run/evidence-query.d.ts.map +1 -0
  141. package/dist/run/evidence-query.js +270 -0
  142. package/dist/run/evidence-query.js.map +1 -0
  143. package/dist/run/evidence-recall.d.ts +99 -0
  144. package/dist/run/evidence-recall.d.ts.map +1 -0
  145. package/dist/run/evidence-recall.js +633 -0
  146. package/dist/run/evidence-recall.js.map +1 -0
  147. package/dist/run/index.d.ts +2 -0
  148. package/dist/run/index.d.ts.map +1 -1
  149. package/dist/run/index.js +1 -0
  150. package/dist/run/index.js.map +1 -1
  151. package/dist/run/json-claim-verifier.d.ts +83 -0
  152. package/dist/run/json-claim-verifier.d.ts.map +1 -0
  153. package/dist/run/json-claim-verifier.js +200 -0
  154. package/dist/run/json-claim-verifier.js.map +1 -0
  155. package/dist/run/preparation-context-error.d.ts +10 -0
  156. package/dist/run/preparation-context-error.d.ts.map +1 -0
  157. package/dist/run/preparation-context-error.js +15 -0
  158. package/dist/run/preparation-context-error.js.map +1 -0
  159. package/dist/run-query/index.d.ts +3 -1
  160. package/dist/run-query/index.d.ts.map +1 -1
  161. package/dist/runtime/query/callback-inference.d.ts +8 -0
  162. package/dist/runtime/query/callback-inference.d.ts.map +1 -0
  163. package/dist/runtime/query/callback-inference.js +89 -0
  164. package/dist/runtime/query/callback-inference.js.map +1 -0
  165. package/dist/runtime/query/checkpoint.d.ts +4 -0
  166. package/dist/runtime/query/checkpoint.d.ts.map +1 -1
  167. package/dist/runtime/query/checkpoint.js +13 -0
  168. package/dist/runtime/query/checkpoint.js.map +1 -1
  169. package/dist/runtime/query/events.d.ts +1 -0
  170. package/dist/runtime/query/events.d.ts.map +1 -1
  171. package/dist/runtime/query/events.js +18 -0
  172. package/dist/runtime/query/events.js.map +1 -1
  173. package/dist/runtime/query/executor.d.ts +7 -1
  174. package/dist/runtime/query/executor.d.ts.map +1 -1
  175. package/dist/runtime/query/executor.js +38 -7
  176. package/dist/runtime/query/executor.js.map +1 -1
  177. package/dist/runtime/query/file-evidence-context.d.ts +5 -0
  178. package/dist/runtime/query/file-evidence-context.d.ts.map +1 -0
  179. package/dist/runtime/query/file-evidence-context.js +64 -0
  180. package/dist/runtime/query/file-evidence-context.js.map +1 -0
  181. package/dist/runtime/query/guard.d.ts.map +1 -1
  182. package/dist/runtime/query/guard.js +4 -0
  183. package/dist/runtime/query/guard.js.map +1 -1
  184. package/dist/runtime/query/index.d.ts +10 -1
  185. package/dist/runtime/query/index.d.ts.map +1 -1
  186. package/dist/runtime/query/index.js +39 -24
  187. package/dist/runtime/query/index.js.map +1 -1
  188. package/dist/runtime/query/iteration/index.d.ts +9 -31
  189. package/dist/runtime/query/iteration/index.d.ts.map +1 -1
  190. package/dist/runtime/query/iteration/index.js +231 -93
  191. package/dist/runtime/query/iteration/index.js.map +1 -1
  192. package/dist/runtime/query/iteration/phases/advisory.d.ts +2 -1
  193. package/dist/runtime/query/iteration/phases/advisory.d.ts.map +1 -1
  194. package/dist/runtime/query/iteration/phases/advisory.js +2 -1
  195. package/dist/runtime/query/iteration/phases/advisory.js.map +1 -1
  196. package/dist/runtime/query/iteration/phases/context.d.ts +2 -1
  197. package/dist/runtime/query/iteration/phases/context.d.ts.map +1 -1
  198. package/dist/runtime/query/iteration/phases/context.js.map +1 -1
  199. package/dist/runtime/query/iteration/phases/tool-review.d.ts.map +1 -1
  200. package/dist/runtime/query/iteration/phases/tool-review.js +3 -0
  201. package/dist/runtime/query/iteration/phases/tool-review.js.map +1 -1
  202. package/dist/runtime/query/iteration/provider-rejected-image.d.ts +2 -1
  203. package/dist/runtime/query/iteration/provider-rejected-image.d.ts.map +1 -1
  204. package/dist/runtime/query/iteration/provider-rejected-image.js +5 -2
  205. package/dist/runtime/query/iteration/provider-rejected-image.js.map +1 -1
  206. package/dist/runtime/query/iteration/stream-turn.d.ts +4 -1
  207. package/dist/runtime/query/iteration/stream-turn.d.ts.map +1 -1
  208. package/dist/runtime/query/iteration/stream-turn.js +22 -8
  209. package/dist/runtime/query/iteration/stream-turn.js.map +1 -1
  210. package/dist/runtime/query/resume-pending.d.ts +18 -33
  211. package/dist/runtime/query/resume-pending.d.ts.map +1 -1
  212. package/dist/runtime/query/resume-pending.js +59 -42
  213. package/dist/runtime/query/resume-pending.js.map +1 -1
  214. package/dist/runtime/query/review-policy.d.ts +4 -4
  215. package/dist/runtime/query/review-policy.d.ts.map +1 -1
  216. package/dist/runtime/query/review-policy.js +10 -9
  217. package/dist/runtime/query/review-policy.js.map +1 -1
  218. package/dist/runtime/query/sandbox-lifecycle.d.ts.map +1 -1
  219. package/dist/runtime/query/sandbox-lifecycle.js +4 -0
  220. package/dist/runtime/query/sandbox-lifecycle.js.map +1 -1
  221. package/dist/runtime/query/tool-output-budget.d.ts +10 -6
  222. package/dist/runtime/query/tool-output-budget.d.ts.map +1 -1
  223. package/dist/runtime/query/tool-output-budget.js +54 -12
  224. package/dist/runtime/query/tool-output-budget.js.map +1 -1
  225. package/dist/runtime/query/tooling.d.ts +3 -1
  226. package/dist/runtime/query/tooling.d.ts.map +1 -1
  227. package/dist/runtime/query/tooling.js +4 -0
  228. package/dist/runtime/query/tooling.js.map +1 -1
  229. package/dist/scheduler/completion-inbox.d.ts +3 -0
  230. package/dist/scheduler/completion-inbox.d.ts.map +1 -1
  231. package/dist/scheduler/completion-inbox.js +28 -0
  232. package/dist/scheduler/completion-inbox.js.map +1 -1
  233. package/dist/store/evidence/compaction-archive.d.ts +109 -0
  234. package/dist/store/evidence/compaction-archive.d.ts.map +1 -0
  235. package/dist/store/evidence/compaction-archive.js +125 -0
  236. package/dist/store/evidence/compaction-archive.js.map +1 -0
  237. package/dist/store/evidence/compaction-provenance.d.ts +7 -0
  238. package/dist/store/evidence/compaction-provenance.d.ts.map +1 -0
  239. package/dist/store/evidence/compaction-provenance.js +49 -0
  240. package/dist/store/evidence/compaction-provenance.js.map +1 -0
  241. package/dist/store/evidence/compaction-text.d.ts +16 -0
  242. package/dist/store/evidence/compaction-text.d.ts.map +1 -0
  243. package/dist/store/evidence/compaction-text.js +51 -0
  244. package/dist/store/evidence/compaction-text.js.map +1 -0
  245. package/dist/store/evidence/disk.d.ts +11 -0
  246. package/dist/store/evidence/disk.d.ts.map +1 -0
  247. package/dist/store/evidence/disk.js +367 -0
  248. package/dist/store/evidence/disk.js.map +1 -0
  249. package/dist/store/evidence/format.d.ts +25 -0
  250. package/dist/store/evidence/format.d.ts.map +1 -0
  251. package/dist/store/evidence/format.js +115 -0
  252. package/dist/store/evidence/format.js.map +1 -0
  253. package/dist/store/evidence/index-page.d.ts +208 -0
  254. package/dist/store/evidence/index-page.d.ts.map +1 -0
  255. package/dist/store/evidence/index-page.js +262 -0
  256. package/dist/store/evidence/index-page.js.map +1 -0
  257. package/dist/store/evidence/io.d.ts +24 -0
  258. package/dist/store/evidence/io.d.ts.map +1 -0
  259. package/dist/store/evidence/io.js +69 -0
  260. package/dist/store/evidence/io.js.map +1 -0
  261. package/dist/store/evidence/linked.d.ts +9 -0
  262. package/dist/store/evidence/linked.d.ts.map +1 -0
  263. package/dist/store/evidence/linked.js +314 -0
  264. package/dist/store/evidence/linked.js.map +1 -0
  265. package/dist/store/evidence/passages.d.ts +15 -0
  266. package/dist/store/evidence/passages.d.ts.map +1 -0
  267. package/dist/store/evidence/passages.js +72 -0
  268. package/dist/store/evidence/passages.js.map +1 -0
  269. package/dist/store/evidence/record-chain.d.ts +42 -0
  270. package/dist/store/evidence/record-chain.d.ts.map +1 -0
  271. package/dist/store/evidence/record-chain.js +111 -0
  272. package/dist/store/evidence/record-chain.js.map +1 -0
  273. package/dist/store/evidence/search-input.d.ts +21 -0
  274. package/dist/store/evidence/search-input.d.ts.map +1 -0
  275. package/dist/store/evidence/search-input.js +44 -0
  276. package/dist/store/evidence/search-input.js.map +1 -0
  277. package/dist/store/evidence/selection.d.ts +9 -0
  278. package/dist/store/evidence/selection.d.ts.map +1 -0
  279. package/dist/store/evidence/selection.js +17 -0
  280. package/dist/store/evidence/selection.js.map +1 -0
  281. package/dist/store/evidence/source-kind.d.ts +11 -0
  282. package/dist/store/evidence/source-kind.d.ts.map +1 -0
  283. package/dist/store/evidence/source-kind.js +26 -0
  284. package/dist/store/evidence/source-kind.js.map +1 -0
  285. package/dist/store/evidence/source-text.d.ts +51 -0
  286. package/dist/store/evidence/source-text.d.ts.map +1 -0
  287. package/dist/store/evidence/source-text.js +213 -0
  288. package/dist/store/evidence/source-text.js.map +1 -0
  289. package/dist/store/evidence/types.d.ts +162 -0
  290. package/dist/store/evidence/types.d.ts.map +1 -0
  291. package/dist/store/evidence/types.js +2 -0
  292. package/dist/store/evidence/types.js.map +1 -0
  293. package/dist/store/memory/disk.d.ts +2 -0
  294. package/dist/store/memory/disk.d.ts.map +1 -1
  295. package/dist/store/memory/disk.js +2 -1
  296. package/dist/store/memory/disk.js.map +1 -1
  297. package/dist/store/run/disk.d.ts +10 -0
  298. package/dist/store/run/disk.d.ts.map +1 -1
  299. package/dist/store/run/disk.js +87 -7
  300. package/dist/store/run/disk.js.map +1 -1
  301. package/dist/store/run/memory.d.ts +1 -0
  302. package/dist/store/run/memory.d.ts.map +1 -1
  303. package/dist/store/run/memory.js +10 -0
  304. package/dist/store/run/memory.js.map +1 -1
  305. package/dist/store/run/tool-executions.d.ts +13 -0
  306. package/dist/store/run/tool-executions.d.ts.map +1 -0
  307. package/dist/store/run/tool-executions.js +99 -0
  308. package/dist/store/run/tool-executions.js.map +1 -0
  309. package/dist/store/session/index.d.ts +2 -0
  310. package/dist/store/session/index.d.ts.map +1 -1
  311. package/dist/store/session/index.js +1 -0
  312. package/dist/store/session/index.js.map +1 -1
  313. package/dist/store/session/sqlite.d.ts +57 -0
  314. package/dist/store/session/sqlite.d.ts.map +1 -0
  315. package/dist/store/session/sqlite.js +430 -0
  316. package/dist/store/session/sqlite.js.map +1 -0
  317. package/dist/tools/builtins/job.d.ts.map +1 -1
  318. package/dist/tools/builtins/job.js +4 -5
  319. package/dist/tools/builtins/job.js.map +1 -1
  320. package/dist/tools/builtins/write-file.js +2 -2
  321. package/dist/tools/builtins/write-file.js.map +1 -1
  322. package/dist/tools/defineTool.d.ts +2 -1
  323. package/dist/tools/defineTool.d.ts.map +1 -1
  324. package/dist/tools/defineTool.js +1 -1
  325. package/dist/tools/defineTool.js.map +1 -1
  326. package/dist/tools/file-read-tracker.d.ts.map +1 -1
  327. package/dist/tools/file-read-tracker.js +12 -3
  328. package/dist/tools/file-read-tracker.js.map +1 -1
  329. package/dist/tools/resident-history.d.ts +10 -0
  330. package/dist/tools/resident-history.d.ts.map +1 -0
  331. package/dist/tools/resident-history.js +80 -0
  332. package/dist/tools/resident-history.js.map +1 -0
  333. package/dist/tools/resident-tool-evidence.d.ts +5 -0
  334. package/dist/tools/resident-tool-evidence.d.ts.map +1 -0
  335. package/dist/tools/resident-tool-evidence.js +57 -0
  336. package/dist/tools/resident-tool-evidence.js.map +1 -0
  337. package/dist/types/advisory/config.d.ts +7 -0
  338. package/dist/types/advisory/config.d.ts.map +1 -1
  339. package/dist/types/agent/reactive.d.ts +1 -0
  340. package/dist/types/agent/reactive.d.ts.map +1 -1
  341. package/dist/types/authorization/index.d.ts +9 -9
  342. package/dist/types/authorization/index.d.ts.map +1 -1
  343. package/dist/types/authorization/index.js +1 -1
  344. package/dist/types/authorization/index.js.map +1 -1
  345. package/dist/types/hitl/index.d.ts +4 -0
  346. package/dist/types/hitl/index.d.ts.map +1 -1
  347. package/dist/types/hitl/index.js.map +1 -1
  348. package/dist/types/message/index.d.ts +16 -2
  349. package/dist/types/message/index.d.ts.map +1 -1
  350. package/dist/types/message/index.js +8 -1
  351. package/dist/types/message/index.js.map +1 -1
  352. package/dist/types/provider/chat.d.ts +2 -0
  353. package/dist/types/provider/chat.d.ts.map +1 -1
  354. package/dist/types/provider/stream.d.ts +4 -0
  355. package/dist/types/provider/stream.d.ts.map +1 -1
  356. package/dist/types/run/answer-review.d.ts +34 -3
  357. package/dist/types/run/answer-review.d.ts.map +1 -1
  358. package/dist/types/run/config.d.ts +3 -0
  359. package/dist/types/run/config.d.ts.map +1 -1
  360. package/dist/types/run/entity.d.ts +7 -0
  361. package/dist/types/run/entity.d.ts.map +1 -1
  362. package/dist/types/run/events.d.ts +31 -8
  363. package/dist/types/run/events.d.ts.map +1 -1
  364. package/dist/types/run/events.js.map +1 -1
  365. package/dist/types/run/prepare-step.d.ts +53 -8
  366. package/dist/types/run/prepare-step.d.ts.map +1 -1
  367. package/dist/types/run/store.d.ts +29 -4
  368. package/dist/types/run/store.d.ts.map +1 -1
  369. package/dist/types/run/store.js +0 -28
  370. package/dist/types/run/store.js.map +1 -1
  371. package/dist/types/tool/index.d.ts +15 -1
  372. package/dist/types/tool/index.d.ts.map +1 -1
  373. package/dist/types/tool/index.js.map +1 -1
  374. package/dist/utils/await-with-abort.d.ts +8 -0
  375. package/dist/utils/await-with-abort.d.ts.map +1 -0
  376. package/dist/utils/await-with-abort.js +28 -0
  377. package/dist/utils/await-with-abort.js.map +1 -0
  378. package/dist/utils/evidence-time.d.ts +3 -0
  379. package/dist/utils/evidence-time.d.ts.map +1 -0
  380. package/dist/utils/evidence-time.js +10 -0
  381. package/dist/utils/evidence-time.js.map +1 -0
  382. package/dist/utils/evidence-tokens.d.ts +13 -0
  383. package/dist/utils/evidence-tokens.d.ts.map +1 -0
  384. package/dist/utils/evidence-tokens.js +29 -0
  385. package/dist/utils/evidence-tokens.js.map +1 -0
  386. package/package.json +1 -1
  387. package/src/advisory/executor.ts +15 -30
  388. package/src/advisory/history.ts +126 -0
  389. package/src/advisory/index.ts +5 -1
  390. package/src/agents/ReactiveAgent.ts +3 -0
  391. package/src/agents/runAgent.ts +14 -1
  392. package/src/compaction/manual.ts +30 -2
  393. package/src/compaction/summary.ts +4 -1
  394. package/src/config/runtime.ts +2 -2
  395. package/src/contracts/schemas.ts +1 -1
  396. package/src/eval/harness-protection.ts +79 -0
  397. package/src/eval/harness-verification.ts +31 -1
  398. package/src/eval/index.ts +1 -0
  399. package/src/manager/resident/activity.ts +187 -0
  400. package/src/manager/resident/agenda.ts +59 -5
  401. package/src/manager/resident/consumption.ts +311 -0
  402. package/src/manager/resident/evidence-recall.ts +363 -0
  403. package/src/manager/resident/history-disk.ts +63 -0
  404. package/src/manager/resident/history.ts +312 -0
  405. package/src/manager/resident/initiative.ts +13 -3
  406. package/src/manager/resident/learning-cycle.ts +499 -0
  407. package/src/manager/resident/learning-observation.ts +39 -0
  408. package/src/manager/resident/learning-store.ts +813 -0
  409. package/src/manager/resident/learning.ts +132 -8
  410. package/src/manager/resident/store.ts +31 -3
  411. package/src/manager/resident/tool-evidence.ts +412 -0
  412. package/src/manager/run/persistence.ts +6 -0
  413. package/src/plugin/loader.ts +8 -3
  414. package/src/prompt/coding-agent-doctrine.ts +2 -0
  415. package/src/prompt/index.ts +2 -0
  416. package/src/prompt/resident-learning.ts +143 -0
  417. package/src/prompt/resident-step.ts +83 -3
  418. package/src/provider/collect-chat-completion.ts +7 -6
  419. package/src/provider/fallback.ts +2 -1
  420. package/src/provider/stream-text.ts +56 -0
  421. package/src/public-runtime.ts +30 -0
  422. package/src/public-tools.ts +3 -0
  423. package/src/public-types.ts +98 -0
  424. package/src/run/LimitChecker.ts +3 -3
  425. package/src/run/evidence-query.ts +333 -0
  426. package/src/run/evidence-recall.ts +854 -0
  427. package/src/run/index.ts +11 -0
  428. package/src/run/json-claim-verifier.ts +298 -0
  429. package/src/run/preparation-context-error.ts +16 -0
  430. package/src/run-query/index.ts +1 -1
  431. package/src/runtime/query/callback-inference.ts +94 -0
  432. package/src/runtime/query/checkpoint.ts +14 -0
  433. package/src/runtime/query/events.ts +22 -0
  434. package/src/runtime/query/executor.ts +51 -9
  435. package/src/runtime/query/file-evidence-context.ts +65 -0
  436. package/src/runtime/query/guard.ts +2 -0
  437. package/src/runtime/query/index.ts +49 -25
  438. package/src/runtime/query/iteration/index.ts +269 -86
  439. package/src/runtime/query/iteration/phases/advisory.ts +3 -0
  440. package/src/runtime/query/iteration/phases/context.ts +2 -0
  441. package/src/runtime/query/iteration/phases/tool-review.ts +3 -0
  442. package/src/runtime/query/iteration/provider-rejected-image.ts +6 -1
  443. package/src/runtime/query/iteration/stream-turn.ts +35 -8
  444. package/src/runtime/query/resume-pending.ts +65 -40
  445. package/src/runtime/query/review-policy.ts +13 -9
  446. package/src/runtime/query/sandbox-lifecycle.ts +3 -0
  447. package/src/runtime/query/tool-output-budget.ts +65 -13
  448. package/src/runtime/query/tooling.ts +7 -1
  449. package/src/scheduler/completion-inbox.ts +26 -0
  450. package/src/store/evidence/compaction-archive.ts +139 -0
  451. package/src/store/evidence/compaction-provenance.ts +52 -0
  452. package/src/store/evidence/compaction-text.ts +61 -0
  453. package/src/store/evidence/disk.ts +461 -0
  454. package/src/store/evidence/format.ts +126 -0
  455. package/src/store/evidence/index-page.ts +292 -0
  456. package/src/store/evidence/io.ts +95 -0
  457. package/src/store/evidence/linked.ts +365 -0
  458. package/src/store/evidence/passages.ts +88 -0
  459. package/src/store/evidence/record-chain.ts +108 -0
  460. package/src/store/evidence/search-input.ts +62 -0
  461. package/src/store/evidence/selection.ts +25 -0
  462. package/src/store/evidence/source-kind.ts +36 -0
  463. package/src/store/evidence/source-text.ts +285 -0
  464. package/src/store/evidence/types.ts +177 -0
  465. package/src/store/memory/disk.ts +4 -1
  466. package/src/store/run/disk.ts +110 -8
  467. package/src/store/run/memory.ts +10 -0
  468. package/src/store/run/tool-executions.ts +112 -0
  469. package/src/store/session/index.ts +2 -0
  470. package/src/store/session/sqlite.ts +584 -0
  471. package/src/tools/builtins/job.ts +4 -5
  472. package/src/tools/builtins/write-file.ts +2 -2
  473. package/src/tools/defineTool.ts +4 -2
  474. package/src/tools/file-read-tracker.ts +8 -2
  475. package/src/tools/resident-history.ts +86 -0
  476. package/src/tools/resident-tool-evidence.ts +68 -0
  477. package/src/types/advisory/config.ts +7 -0
  478. package/src/types/agent/reactive.ts +1 -0
  479. package/src/types/authorization/index.ts +2 -2
  480. package/src/types/hitl/index.ts +4 -0
  481. package/src/types/message/index.ts +20 -0
  482. package/src/types/provider/chat.ts +2 -0
  483. package/src/types/provider/stream.ts +4 -0
  484. package/src/types/run/answer-review.ts +34 -3
  485. package/src/types/run/config.ts +3 -0
  486. package/src/types/run/entity.ts +7 -0
  487. package/src/types/run/events.ts +31 -8
  488. package/src/types/run/prepare-step.ts +59 -8
  489. package/src/types/run/store.ts +35 -4
  490. package/src/types/tool/index.ts +19 -1
  491. package/src/utils/await-with-abort.ts +26 -0
  492. package/src/utils/evidence-time.ts +9 -0
  493. package/src/utils/evidence-tokens.ts +32 -0
@@ -0,0 +1,208 @@
1
+ import type { FileHandle } from 'node:fs/promises';
2
+ import { z } from 'zod';
3
+ import type { CompactedToolMetadata } from './compaction-provenance.js';
4
+ import { type EvidenceBudget } from './io.js';
5
+ export declare const entrySchema: z.ZodObject<{
6
+ offset: z.ZodNumber;
7
+ length: z.ZodNumber;
8
+ sha256: z.ZodString;
9
+ seq: z.ZodNumber;
10
+ source: z.ZodEnum<["tool_completed", "message_completed", "compaction_shed:system", "compaction_shed:summary", "compaction_shed:user", "compaction_shed:assistant", "compaction_shed:tool"]>;
11
+ part: z.ZodDefault<z.ZodNumber>;
12
+ toolName: z.ZodOptional<z.ZodString>;
13
+ toolUseId: z.ZodOptional<z.ZodString>;
14
+ isError: z.ZodOptional<z.ZodBoolean>;
15
+ truncated: z.ZodBoolean;
16
+ spill: z.ZodOptional<z.ZodString>;
17
+ filter: z.ZodString;
18
+ tokenFilter: z.ZodOptional<z.ZodString>;
19
+ }, "strip", z.ZodTypeAny, {
20
+ length: number;
21
+ filter: string;
22
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
23
+ seq: number;
24
+ part: number;
25
+ sha256: string;
26
+ truncated: boolean;
27
+ offset: number;
28
+ isError?: boolean | undefined;
29
+ toolName?: string | undefined;
30
+ tokenFilter?: string | undefined;
31
+ toolUseId?: string | undefined;
32
+ spill?: string | undefined;
33
+ }, {
34
+ length: number;
35
+ filter: string;
36
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
37
+ seq: number;
38
+ sha256: string;
39
+ truncated: boolean;
40
+ offset: number;
41
+ isError?: boolean | undefined;
42
+ part?: number | undefined;
43
+ toolName?: string | undefined;
44
+ tokenFilter?: string | undefined;
45
+ toolUseId?: string | undefined;
46
+ spill?: string | undefined;
47
+ }>;
48
+ export type IndexEntry = z.infer<typeof entrySchema>;
49
+ export declare const positionSchema: z.ZodObject<{
50
+ offset: z.ZodNumber;
51
+ seq: z.ZodNumber;
52
+ textIndex: z.ZodDefault<z.ZodNumber>;
53
+ }, "strip", z.ZodTypeAny, {
54
+ seq: number;
55
+ offset: number;
56
+ textIndex: number;
57
+ }, {
58
+ seq: number;
59
+ offset: number;
60
+ textIndex?: number | undefined;
61
+ }>;
62
+ export type IndexPosition = z.infer<typeof positionSchema>;
63
+ declare const pageSchema: z.ZodObject<{
64
+ start: z.ZodObject<{
65
+ offset: z.ZodNumber;
66
+ seq: z.ZodNumber;
67
+ textIndex: z.ZodDefault<z.ZodNumber>;
68
+ }, "strip", z.ZodTypeAny, {
69
+ seq: number;
70
+ offset: number;
71
+ textIndex: number;
72
+ }, {
73
+ seq: number;
74
+ offset: number;
75
+ textIndex?: number | undefined;
76
+ }>;
77
+ entries: z.ZodArray<z.ZodObject<{
78
+ offset: z.ZodNumber;
79
+ length: z.ZodNumber;
80
+ sha256: z.ZodString;
81
+ seq: z.ZodNumber;
82
+ source: z.ZodEnum<["tool_completed", "message_completed", "compaction_shed:system", "compaction_shed:summary", "compaction_shed:user", "compaction_shed:assistant", "compaction_shed:tool"]>;
83
+ part: z.ZodDefault<z.ZodNumber>;
84
+ toolName: z.ZodOptional<z.ZodString>;
85
+ toolUseId: z.ZodOptional<z.ZodString>;
86
+ isError: z.ZodOptional<z.ZodBoolean>;
87
+ truncated: z.ZodBoolean;
88
+ spill: z.ZodOptional<z.ZodString>;
89
+ filter: z.ZodString;
90
+ tokenFilter: z.ZodOptional<z.ZodString>;
91
+ }, "strip", z.ZodTypeAny, {
92
+ length: number;
93
+ filter: string;
94
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
95
+ seq: number;
96
+ part: number;
97
+ sha256: string;
98
+ truncated: boolean;
99
+ offset: number;
100
+ isError?: boolean | undefined;
101
+ toolName?: string | undefined;
102
+ tokenFilter?: string | undefined;
103
+ toolUseId?: string | undefined;
104
+ spill?: string | undefined;
105
+ }, {
106
+ length: number;
107
+ filter: string;
108
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
109
+ seq: number;
110
+ sha256: string;
111
+ truncated: boolean;
112
+ offset: number;
113
+ isError?: boolean | undefined;
114
+ part?: number | undefined;
115
+ toolName?: string | undefined;
116
+ tokenFilter?: string | undefined;
117
+ toolUseId?: string | undefined;
118
+ spill?: string | undefined;
119
+ }>, "many">;
120
+ next: z.ZodNullable<z.ZodObject<{
121
+ offset: z.ZodNumber;
122
+ seq: z.ZodNumber;
123
+ textIndex: z.ZodDefault<z.ZodNumber>;
124
+ }, "strip", z.ZodTypeAny, {
125
+ seq: number;
126
+ offset: number;
127
+ textIndex: number;
128
+ }, {
129
+ seq: number;
130
+ offset: number;
131
+ textIndex?: number | undefined;
132
+ }>>;
133
+ records: z.ZodNumber;
134
+ }, "strip", z.ZodTypeAny, {
135
+ entries: {
136
+ length: number;
137
+ filter: string;
138
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
139
+ seq: number;
140
+ part: number;
141
+ sha256: string;
142
+ truncated: boolean;
143
+ offset: number;
144
+ isError?: boolean | undefined;
145
+ toolName?: string | undefined;
146
+ tokenFilter?: string | undefined;
147
+ toolUseId?: string | undefined;
148
+ spill?: string | undefined;
149
+ }[];
150
+ start: {
151
+ seq: number;
152
+ offset: number;
153
+ textIndex: number;
154
+ };
155
+ next: {
156
+ seq: number;
157
+ offset: number;
158
+ textIndex: number;
159
+ } | null;
160
+ records: number;
161
+ }, {
162
+ entries: {
163
+ length: number;
164
+ filter: string;
165
+ source: "tool_completed" | "message_completed" | "compaction_shed:system" | "compaction_shed:summary" | "compaction_shed:user" | "compaction_shed:assistant" | "compaction_shed:tool";
166
+ seq: number;
167
+ sha256: string;
168
+ truncated: boolean;
169
+ offset: number;
170
+ isError?: boolean | undefined;
171
+ part?: number | undefined;
172
+ toolName?: string | undefined;
173
+ tokenFilter?: string | undefined;
174
+ toolUseId?: string | undefined;
175
+ spill?: string | undefined;
176
+ }[];
177
+ start: {
178
+ seq: number;
179
+ offset: number;
180
+ textIndex?: number | undefined;
181
+ };
182
+ next: {
183
+ seq: number;
184
+ offset: number;
185
+ textIndex?: number | undefined;
186
+ } | null;
187
+ records: number;
188
+ }>;
189
+ export type IndexPage = z.infer<typeof pageSchema>;
190
+ export interface EvidenceSeal {
191
+ pack(value: unknown): string;
192
+ unpack(value: string): unknown;
193
+ dir: string;
194
+ }
195
+ export declare function evidenceSeal(root: string, scopeKey: string, sourceKey: string, budget: EvidenceBudget): Promise<EvidenceSeal>;
196
+ export declare function toolEntry(event: Record<string, unknown>, offset: number, bytes: Buffer): IndexEntry | null;
197
+ /** Validate all textual parts before publishing any part of a record. */
198
+ export declare function eventTexts(event: Record<string, unknown>): ({
199
+ source: string;
200
+ text: string;
201
+ } & CompactedToolMetadata)[];
202
+ /** Each cache page indexes at most 64 records, 64 textual parts and 4 MiB of input. */
203
+ export declare function indexPage(handle: FileHandle, size: number, runId: string, start: IndexPosition, seal: EvidenceSeal, sourceKey: string, budget: EvidenceBudget): Promise<{
204
+ page: IndexPage;
205
+ cacheHit: boolean;
206
+ }>;
207
+ export {};
208
+ //# sourceMappingURL=index-page.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-page.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/index-page.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAGvE,OAAO,EACN,KAAK,cAAc,EAOnB,MAAM,SAAS,CAAA;AAGhB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBtB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AACpD,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC1D,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKd,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAElD,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;CACX;AAED,wBAAsB,YAAY,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,YAAY,CAAC,CAoDvB;AAED,wBAAgB,SAAS,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACX,UAAU,GAAG,IAAI,CA0BnB;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAAC,EAAE,CAsB9D;AAED,uFAAuF;AACvF,wBAAsB,SAAS,CAC9B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAiGjD"}
@@ -0,0 +1,262 @@
1
+ import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
2
+ import { link, mkdir, rename, unlink, writeFile } from 'node:fs/promises';
3
+ import { dirname, join } from 'node:path';
4
+ import { z } from 'zod';
5
+ import { compactionArchiveSchema } from './compaction-archive.js';
6
+ import { compactedTexts } from './compaction-text.js';
7
+ import { digest, textFilter, tokenFilter } from './format.js';
8
+ import { EvidencePageLimit, RECORD_BYTES, decode, noLinks, readBytes, readSmall, } from './io.js';
9
+ const integer = z.number().int().nonnegative().safe();
10
+ export const entrySchema = z.object({
11
+ offset: integer,
12
+ length: integer.max(RECORD_BYTES),
13
+ sha256: z.string().regex(/^[a-f0-9]{64}$/),
14
+ seq: integer,
15
+ source: z.enum([
16
+ 'tool_completed',
17
+ 'message_completed',
18
+ 'compaction_shed:system',
19
+ 'compaction_shed:summary',
20
+ 'compaction_shed:user',
21
+ 'compaction_shed:assistant',
22
+ 'compaction_shed:tool',
23
+ ]),
24
+ part: integer.default(0),
25
+ toolName: z.string().max(1024).optional(),
26
+ toolUseId: z.string().max(1024).optional(),
27
+ isError: z.boolean().optional(),
28
+ truncated: z.boolean(),
29
+ spill: z
30
+ .string()
31
+ .regex(/^[a-f0-9]{64}$/)
32
+ .optional(),
33
+ filter: z.string().max(1400),
34
+ tokenFilter: z.string().max(1400).optional(),
35
+ });
36
+ export const positionSchema = z.object({
37
+ offset: integer,
38
+ seq: integer,
39
+ textIndex: integer.default(0),
40
+ });
41
+ const pageSchema = z.object({
42
+ start: positionSchema,
43
+ entries: z.array(entrySchema).max(64),
44
+ next: positionSchema.nullable(),
45
+ records: integer.max(64),
46
+ });
47
+ export async function evidenceSeal(root, scopeKey, sourceKey, budget) {
48
+ try {
49
+ await noLinks(root);
50
+ }
51
+ catch (error) {
52
+ if (error.code !== 'ENOENT')
53
+ throw error;
54
+ await noLinks(dirname(root));
55
+ try {
56
+ await mkdir(root, { mode: 0o700 });
57
+ }
58
+ catch (error) {
59
+ if (error.code !== 'EEXIST')
60
+ throw error;
61
+ }
62
+ await noLinks(root);
63
+ }
64
+ const dir = join(root, scopeKey);
65
+ await mkdir(dir, { mode: 0o700, recursive: true });
66
+ await noLinks(dir);
67
+ const keyPath = join(dir, 'key');
68
+ let key;
69
+ try {
70
+ key = await readSmall(keyPath, budget, 32);
71
+ }
72
+ catch (error) {
73
+ if (error.code !== 'ENOENT')
74
+ throw error;
75
+ const candidate = `${keyPath}.${randomBytes(8).toString('hex')}.tmp`;
76
+ await writeFile(candidate, randomBytes(32), { flag: 'wx', mode: 0o600 });
77
+ try {
78
+ try {
79
+ await link(candidate, keyPath);
80
+ }
81
+ catch (error) {
82
+ if (error.code !== 'EEXIST')
83
+ throw error;
84
+ }
85
+ }
86
+ finally {
87
+ await unlink(candidate);
88
+ }
89
+ key = await readSmall(keyPath, budget, 32);
90
+ }
91
+ if (key.length !== 32)
92
+ throw new Error('Incomplete evidence index key.');
93
+ const mac = (value) => createHmac('sha256', key).update(`${sourceKey}\n${value}`).digest();
94
+ return {
95
+ dir,
96
+ pack(value) {
97
+ const body = Buffer.from(JSON.stringify(value)).toString('base64url');
98
+ return `${body}.${mac(body).toString('base64url')}`;
99
+ },
100
+ unpack(value) {
101
+ const [body, signature, extra] = value.split('.');
102
+ if (!body || !signature || extra)
103
+ throw new Error('Invalid evidence address.');
104
+ const actual = Buffer.from(signature, 'base64url');
105
+ if (actual.length !== 32 || !timingSafeEqual(actual, mac(body)))
106
+ throw new Error('Evidence address belongs to a different scope or changed source.');
107
+ return JSON.parse(decode(Buffer.from(body, 'base64url')));
108
+ },
109
+ };
110
+ }
111
+ export function toolEntry(event, offset, bytes) {
112
+ if (event.type !== 'tool_completed')
113
+ return null;
114
+ if (typeof event.result !== 'string' ||
115
+ typeof event.isError !== 'boolean' ||
116
+ typeof event.toolName !== 'string' ||
117
+ typeof event.toolUseId !== 'string')
118
+ throw new Error('Malformed tool evidence.');
119
+ return entrySchema.parse({
120
+ offset,
121
+ length: bytes.length,
122
+ sha256: digest(bytes),
123
+ seq: event.seq,
124
+ source: 'tool_completed',
125
+ part: 0,
126
+ toolName: event.toolName,
127
+ toolUseId: event.toolUseId,
128
+ isError: event.isError,
129
+ truncated: event.outputTruncated === true,
130
+ ...(typeof event.outputSpillIntegrity === 'string'
131
+ ? { spill: event.outputSpillIntegrity }
132
+ : {}),
133
+ filter: textFilter(event.result),
134
+ tokenFilter: tokenFilter(event.result),
135
+ });
136
+ }
137
+ /** Validate all textual parts before publishing any part of a record. */
138
+ export function eventTexts(event) {
139
+ if (event.type === 'compaction_archive') {
140
+ return compactionArchiveSchema.parse(event).archive.parts.map((part) => ({
141
+ source: `compaction_shed:${part.role === 'system' && part.summary ? 'summary' : part.role}`,
142
+ text: '',
143
+ ...(part.role === 'tool' ? { toolName: part.toolName, isError: part.isError } : {}),
144
+ }));
145
+ }
146
+ if (event.type === 'tool_completed') {
147
+ if (typeof event.result !== 'string')
148
+ throw new Error('Invalid tool text.');
149
+ return [{ source: 'tool_completed', text: event.result }];
150
+ }
151
+ if (event.type === 'message_completed') {
152
+ if (event.content === undefined)
153
+ return [];
154
+ if (typeof event.content !== 'string')
155
+ throw new Error('Invalid message text.');
156
+ return [{ source: 'message_completed', text: event.content }];
157
+ }
158
+ if (event.type !== 'compaction_shed')
159
+ return [];
160
+ return compactedTexts(event.messages).map(({ role, summary, ...part }) => ({
161
+ source: `compaction_shed:${summary ? 'summary' : role}`,
162
+ ...part,
163
+ }));
164
+ }
165
+ /** Each cache page indexes at most 64 records, 64 textual parts and 4 MiB of input. */
166
+ export async function indexPage(handle, size, runId, start, seal, sourceKey, budget) {
167
+ const path = join(seal.dir, `${digest(`${sourceKey}:${start.offset}:${start.seq}:${start.textIndex}:summary-provenance-v1:${process.version}:${process.versions.v8}:${process.versions.unicode}`)}.page`);
168
+ try {
169
+ const cached = await readSmall(path, budget, 512 * 1024);
170
+ const page = pageSchema.parse(seal.unpack(decode(cached)));
171
+ if (page.start.offset !== start.offset ||
172
+ page.start.seq !== start.seq ||
173
+ page.start.textIndex !== start.textIndex)
174
+ throw new Error('Index page position mismatch.');
175
+ return { page, cacheHit: true };
176
+ }
177
+ catch (error) {
178
+ budget.signal?.throwIfAborted();
179
+ if (error instanceof EvidencePageLimit)
180
+ throw error;
181
+ // The cache is disposable. A missing, damaged or incompatible page is rebuilt.
182
+ }
183
+ let offset = start.offset;
184
+ let seq = start.seq;
185
+ let textIndex = start.textIndex;
186
+ let records = 0;
187
+ let buffered = Buffer.alloc(0);
188
+ let readOffset = offset;
189
+ const entries = [];
190
+ while (offset < size && records < 64 && entries.length < 64) {
191
+ budget.signal?.throwIfAborted();
192
+ let newline = buffered.indexOf(10);
193
+ while (newline < 0) {
194
+ if (buffered.length >= RECORD_BYTES || readOffset >= size)
195
+ throw new Error('Oversized or torn transcript record; history is incomplete.');
196
+ const count = Math.min(65_536, size - readOffset, RECORD_BYTES - buffered.length);
197
+ if (readOffset - start.offset + count > RECORD_BYTES && records > 0)
198
+ break;
199
+ buffered = Buffer.concat([buffered, await readBytes(handle, readOffset, count, budget)]);
200
+ readOffset += count;
201
+ newline = buffered.indexOf(10);
202
+ }
203
+ if (newline < 0)
204
+ break;
205
+ const raw = buffered.subarray(0, newline + 1);
206
+ const event = JSON.parse(decode(raw));
207
+ if (event.runId !== runId ||
208
+ event.seq !== seq + 1 ||
209
+ typeof event.type !== 'string' ||
210
+ (offset === 0 && event.type !== 'run_started'))
211
+ throw new Error('Transcript identity or event sequence is invalid.');
212
+ const parts = eventTexts(event);
213
+ const archive = event.type === 'compaction_archive' ? compactionArchiveSchema.parse(event) : undefined;
214
+ if (textIndex > parts.length)
215
+ throw new Error('Invalid textual part position.');
216
+ const hash = digest(raw);
217
+ const tool = toolEntry(event, offset, raw);
218
+ records++;
219
+ while (textIndex < parts.length && entries.length < 64) {
220
+ const part = parts[textIndex];
221
+ if (!part)
222
+ throw new Error('Invalid textual part.');
223
+ const archivedPart = archive?.archive.parts[textIndex];
224
+ if (archive && !archivedPart)
225
+ throw new Error('Missing archived text part.');
226
+ entries.push(tool ??
227
+ entrySchema.parse({
228
+ offset,
229
+ length: raw.length,
230
+ sha256: hash,
231
+ seq: event.seq,
232
+ source: part.source,
233
+ toolName: part.toolName,
234
+ isError: part.isError,
235
+ part: textIndex,
236
+ truncated: false,
237
+ ...(archivedPart ? { spill: archivedPart.manifest } : {}),
238
+ filter: textFilter(part.text),
239
+ tokenFilter: archivedPart ? undefined : tokenFilter(part.text),
240
+ }));
241
+ textIndex++;
242
+ }
243
+ if (textIndex < parts.length)
244
+ break;
245
+ textIndex = 0;
246
+ offset += raw.length;
247
+ seq++;
248
+ buffered = buffered.subarray(raw.length);
249
+ }
250
+ const page = {
251
+ start,
252
+ entries,
253
+ records,
254
+ next: offset < size ? { offset, seq, textIndex } : null,
255
+ };
256
+ const temp = `${path}.${randomBytes(8).toString('hex')}.tmp`;
257
+ budget.signal?.throwIfAborted();
258
+ await writeFile(temp, seal.pack(page), { flag: 'wx', mode: 0o600 });
259
+ await rename(temp, path);
260
+ return { page, cacheHit: false };
261
+ }
262
+ //# sourceMappingURL=index-page.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-page.js","sourceRoot":"","sources":["../../../src/store/evidence/index-page.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import type { FileHandle } from 'node:fs/promises';
2
+ export declare const PAGE_BYTES: number;
3
+ export declare const RECORD_BYTES: number;
4
+ export declare class EvidencePageLimit extends Error {
5
+ }
6
+ export interface EvidenceBudget {
7
+ bytes: number;
8
+ limit?: number;
9
+ signal?: AbortSignal;
10
+ }
11
+ export declare function stamp(stat: {
12
+ dev: number;
13
+ ino: number;
14
+ size: number;
15
+ mtimeMs: number;
16
+ ctimeMs: number;
17
+ }): string;
18
+ export declare function noLinks(path: string): Promise<void>;
19
+ export declare function openEvidence(path: string): Promise<FileHandle>;
20
+ export declare function readBytes(handle: FileHandle, offset: number, length: number, budget: EvidenceBudget): Promise<Buffer>;
21
+ export declare function readSmall(path: string, budget: EvidenceBudget, limit?: number): Promise<Buffer>;
22
+ export declare function decode(bytes: Uint8Array): string;
23
+ export declare function utf8Page(bytes: Buffer, limit: number): Buffer;
24
+ //# sourceMappingURL=io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,eAAO,MAAM,UAAU,QAAkB,CAAA;AACzC,eAAO,MAAM,YAAY,QAAkB,CAAA;AAC3C,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CACf,GAAG,MAAM,CAET;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQpE;AAED,wBAAsB,SAAS,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,KAAK,SAAe,GAClB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D"}
@@ -0,0 +1,69 @@
1
+ import { constants } from 'node:fs';
2
+ import { lstat, open } from 'node:fs/promises';
3
+ import { join, parse, resolve, sep } from 'node:path';
4
+ export const PAGE_BYTES = 8 * 1024 * 1024;
5
+ export const RECORD_BYTES = 4 * 1024 * 1024;
6
+ export class EvidencePageLimit extends Error {
7
+ }
8
+ export function stamp(stat) {
9
+ return [stat.dev, stat.ino, stat.size, stat.mtimeMs, stat.ctimeMs].join(':');
10
+ }
11
+ export async function noLinks(path) {
12
+ const absolute = resolve(path);
13
+ let current = parse(absolute).root;
14
+ for (const part of absolute.slice(current.length).split(sep).filter(Boolean)) {
15
+ current = join(current, part);
16
+ if ((await lstat(current)).isSymbolicLink())
17
+ throw new Error('Evidence symlinks are refused.');
18
+ }
19
+ }
20
+ export async function openEvidence(path) {
21
+ await noLinks(path);
22
+ const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
23
+ if (!(await handle.stat()).isFile()) {
24
+ await handle.close();
25
+ throw new Error('Evidence must be a regular file.');
26
+ }
27
+ return handle;
28
+ }
29
+ export async function readBytes(handle, offset, length, budget) {
30
+ budget.signal?.throwIfAborted();
31
+ if (budget.bytes + length > (budget.limit ?? PAGE_BYTES))
32
+ throw new EvidencePageLimit();
33
+ const bytes = Buffer.alloc(length);
34
+ let received = 0;
35
+ while (received < length) {
36
+ budget.signal?.throwIfAborted();
37
+ const { bytesRead } = await handle.read(bytes, received, Math.min(65_536, length - received), offset + received);
38
+ budget.bytes += bytesRead;
39
+ if (!bytesRead)
40
+ throw new Error('Evidence shortened while reading.');
41
+ received += bytesRead;
42
+ }
43
+ return bytes;
44
+ }
45
+ export async function readSmall(path, budget, limit = RECORD_BYTES) {
46
+ const handle = await openEvidence(path);
47
+ try {
48
+ const before = await handle.stat();
49
+ if (before.size > limit)
50
+ throw new Error('Evidence record exceeds its read limit.');
51
+ const bytes = await readBytes(handle, 0, before.size, budget);
52
+ if (stamp(before) !== stamp(await handle.stat()))
53
+ throw new Error('Evidence changed during read.');
54
+ return bytes;
55
+ }
56
+ finally {
57
+ await handle.close();
58
+ }
59
+ }
60
+ export function decode(bytes) {
61
+ return new TextDecoder('utf8', { fatal: true, ignoreBOM: true }).decode(bytes);
62
+ }
63
+ export function utf8Page(bytes, limit) {
64
+ let end = Math.min(bytes.length, limit);
65
+ while (end > 0 && end < bytes.length && ((bytes[end] ?? 0) & 0xc0) === 0x80)
66
+ end--;
67
+ return bytes.subarray(0, end);
68
+ }
69
+ //# sourceMappingURL=io.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/store/evidence/io.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { type RecordPointer } from './record-chain.js';
2
+ import type { DiskRunEvidenceOptions, RunTextEvidenceSource } from './types.js';
3
+ /** Internal: only the durable writer can supply this anchor. Never accept it from a tool input. */
4
+ export declare function createLinkedRunTextEvidenceSource(options: DiskRunEvidenceOptions, anchor: {
5
+ tip: RecordPointer;
6
+ identity: string;
7
+ epoch: string;
8
+ }): RunTextEvidenceSource;
9
+ //# sourceMappingURL=linked.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/linked.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,aAAa,EAA2C,MAAM,mBAAmB,CAAA;AAQ/F,OAAO,KAAK,EACX,sBAAsB,EAItB,qBAAqB,EACrB,MAAM,YAAY,CAAA;AAiCnB,mGAAmG;AACnG,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7D,qBAAqB,CAySvB"}