@sema-agent/core 7.66.0 → 7.67.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 (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,6 +1,7 @@
1
1
  import { closeSync, existsSync, fstatSync, openSync, readdirSync, rmSync, utimesSync } from "node:fs";
2
2
  import { join } from "node:path";
3
- import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, leafIdAfterEntry, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, replayLossText, resolveLeafId, rowExpectationMissed, sessionLogMarkOf, sessionRowMatches, uuidv7, validateEntriesForImport, } from "../../internal/harness.js";
3
+ import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, leafIdAfterEntry, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, replayLossText, resolveLeafId, rowExpectationMissed, sessionHeadOf, sessionLogMarkOf, heldRowCells, heldRowMatches, readSessionRepoRowCells, uuidv7, validateEntriesForImport, } from "../../internal/harness.js";
4
+ import { readUnreadableDeleteId, rowUnreadableNow } from "../../core/session.js";
4
5
  import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, firstJsonlRecord, lastJsonlRecord, readJsonlRecords, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
5
6
  import { guardCorruptSink } from "./corrupt-read-sink.js";
6
7
  import { assertAdoptionBootGate } from "./adoption/marker.js";
@@ -72,14 +73,16 @@ class FileSessionStorage extends BaseSessionStorage {
72
73
  this.recordEntry(entry);
73
74
  }
74
75
  }
75
- const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
76
+ const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, rowCells: 0 });
76
77
  export class FileSessionRepo {
77
78
  dir;
78
79
  tmpDir;
79
80
  onCorruptRead;
80
81
  joined = new Map();
82
+ rowCells;
81
83
  constructor(root, options) {
82
84
  const opts = receiveOptions(options, "FileSessionRepo", FILE_SESSION_REPO_OPTION_KEYS);
85
+ this.rowCells = readSessionRepoRowCells("FileSessionRepo options", opts.rowCells);
83
86
  assertAdoptionBootGate(root, "FileSessionRepo");
84
87
  this.dir = join(root, "sessions");
85
88
  this.tmpDir = join(root, "tmp");
@@ -132,7 +135,7 @@ export class FileSessionRepo {
132
135
  metaLineOf(id, first, skipped = () => "") {
133
136
  if (first === undefined || first.kind !== "meta")
134
137
  throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
135
- const { placement: raw, ...cells } = first;
138
+ const { placement: raw, ...cells } = heldRowCells(this.rowCells, first);
136
139
  const placement = readPlacementCell(raw, id);
137
140
  return { ...cells, ...(placement !== undefined ? { placement } : {}) };
138
141
  }
@@ -142,7 +145,7 @@ export class FileSessionRepo {
142
145
  headNow(sessionId) {
143
146
  return this.atRow(sessionId, (fd, size, meta) => {
144
147
  const last = lastJsonlRecord(fd, size, (r) => r.kind === "entry", SESSION_LINE_JUDGE);
145
- return { owner: meta.owner ?? null, incarnation: meta.incarnation, leafId: last === undefined ? null : leafIdAfterEntry(last.entry) };
148
+ return sessionHeadOf(meta, last === undefined ? null : leafIdAfterEntry(last.entry));
146
149
  });
147
150
  }
148
151
  async readRow(sessionId) {
@@ -159,7 +162,7 @@ export class FileSessionRepo {
159
162
  throw err;
160
163
  }
161
164
  const { meta, entries } = read;
162
- return { metadata: meta, head: { owner: meta.owner ?? null, incarnation: meta.incarnation, leafId: resolveLeafId(entries) }, entries };
165
+ return { metadata: meta, head: sessionHeadOf(meta, resolveLeafId(entries)), entries };
163
166
  }
164
167
  rowOf(sessionId) {
165
168
  const path = this.pathFor(sessionId);
@@ -239,7 +242,7 @@ export class FileSessionRepo {
239
242
  if (!existsSync(path)) {
240
243
  const owner = ownerCell(options.owner);
241
244
  const placement = placementCellToWrite(options.placement, id, Date.now());
242
- const meta = { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...incarnationCell(undefined), ...owner };
245
+ const meta = heldRowCells(this.rowCells, { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...incarnationCell(undefined), ...owner });
243
246
  try {
244
247
  writeThenLink(path, `${JSON.stringify({ kind: "meta", ...meta })}\n`);
245
248
  }
@@ -326,14 +329,24 @@ export class FileSessionRepo {
326
329
  return this.atFirstRecord(sessionId, (_fd, _size, first) => this.metaLineOf(sessionId, first).placement);
327
330
  }
328
331
  async delete(metadata, expect) {
329
- if (expect !== undefined && !sessionRowMatches(expect, this.headNow(metadata.id), () => sessionLogMarkOf(this.read(metadata.id).entries)))
332
+ if (expect !== undefined && !heldRowMatches(this.rowCells, expect, this.headNow(metadata.id), () => sessionLogMarkOf(this.read(metadata.id).entries)))
330
333
  throw rowExpectationMissed(metadata.id, "delete");
331
- evictSharedSessionStorage(canonicalStoreKey(this.pathFor(metadata.id)));
334
+ this.removeRow(metadata.id);
335
+ }
336
+ async deleteUnreadable(sessionId) {
337
+ const id = readUnreadableDeleteId("SessionRepo.deleteUnreadable", sessionId);
338
+ if (!rowUnreadableNow(() => this.headNow(id)))
339
+ return false;
340
+ this.removeRow(id);
341
+ return true;
342
+ }
343
+ removeRow(id) {
344
+ evictSharedSessionStorage(canonicalStoreKey(this.pathFor(id)));
332
345
  try {
333
- rmSync(this.pathFor(metadata.id), { force: true });
346
+ rmSync(this.pathFor(id), { force: true });
334
347
  }
335
348
  catch (err) {
336
- throw new SessionError("storage", `session ${metadata.id} could not be deleted: ${thrownText(err)}`, err instanceof Error ? err : undefined);
349
+ throw new SessionError("storage", `session ${id} could not be deleted: ${thrownText(err)}`, err instanceof Error ? err : undefined);
337
350
  }
338
351
  }
339
352
  async fork(sourceMetadata, options = {}) {
@@ -344,7 +357,7 @@ export class FileSessionRepo {
344
357
  const createdAt = new Date().toISOString();
345
358
  const path = this.pathFor(id);
346
359
  const placement = placementCellToWrite(options.placement, id, Date.now());
347
- const meta = { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...forkRowCells(await source.getMetadata(), options.owner) };
360
+ const meta = heldRowCells(this.rowCells, { id, createdAt, ...(placement !== undefined ? { placement } : {}), ...forkRowCells(await source.getMetadata(), options.owner) });
348
361
  const lines = [JSON.stringify({ kind: "meta", ...meta })];
349
362
  for (const entry of forked) {
350
363
  lines.push(JSON.stringify({ kind: "entry", entry }));
@@ -359,15 +372,15 @@ export class FileSessionRepo {
359
372
  async importEntries(sessionId, owner, entries, options) {
360
373
  const validated = validateEntriesForImport(entries, options);
361
374
  const prior = this.rowNow(sessionId);
362
- if (!sessionRowMatches(options?.expect, prior?.metadata, () => sessionLogMarkOf(prior.entries)))
375
+ if (!heldRowMatches(this.rowCells, options?.expect, prior?.metadata, () => sessionLogMarkOf(prior.entries)))
363
376
  throw rowExpectationMissed(sessionId, "import");
364
- const meta = importRowCells(sessionId, owner, prior?.metadata, new Date().toISOString());
377
+ const meta = heldRowCells(this.rowCells, importRowCells(sessionId, owner, prior?.metadata, new Date().toISOString()));
365
378
  evictSharedSessionStorage(canonicalStoreKey(this.pathFor(sessionId)));
366
379
  const lines = [JSON.stringify({ kind: "meta", ...meta })];
367
380
  for (const entry of validated) {
368
381
  lines.push(JSON.stringify({ kind: "entry", entry }));
369
382
  }
370
383
  atomicWriteFile(this.tmpDir, this.pathFor(sessionId), `${lines.join("\n")}\n`);
371
- return { owner: meta.owner ?? null, incarnation: meta.incarnation, leafId: resolveLeafId(validated) };
384
+ return sessionHeadOf(meta, resolveLeafId(validated));
372
385
  }
373
386
  }
@@ -1,6 +1,6 @@
1
1
  import { join, resolve } from "node:path";
2
2
  import { readFileSync } from "node:fs";
3
- import { assertJsonMetadata, normalizeTaskShape } from "../../tools/task-list.js";
3
+ import { admitTaskListItem, listStoredTaskListEntry, readStoredTaskListItem } from "../../tools/task-list.js";
4
4
  import { canonicalStoreKey, atomicWriteFile, ensureDir } from "./fs-atomic.js";
5
5
  import { assertAdoptionBootGate } from "./adoption/marker.js";
6
6
  import { guardCorruptSink } from "./corrupt-read-sink.js";
@@ -54,18 +54,25 @@ export function createFileTaskListStore(root, opts) {
54
54
  return run;
55
55
  };
56
56
  const locked = lockedOn;
57
+ const entryOf = (doc, id) => {
58
+ if (!Object.prototype.hasOwnProperty.call(doc.tasks, id))
59
+ return undefined;
60
+ return snap(readStoredTaskListItem(doc.tasks[id], id, discloseEntry));
61
+ };
62
+ const discloseEntry = (reason) => disclose?.({ kind: "file", path, reason });
63
+ const listOf = (doc) => Object.entries(doc.tasks).map(([id, t]) => {
64
+ const entry = listStoredTaskListEntry(t, id, discloseEntry);
65
+ return "rowVerdict" in entry ? entry : snap(entry);
66
+ });
67
+ const write = (id, item) => {
68
+ const admitted = admitTaskListItem(item, id);
69
+ const doc = load();
70
+ doc.tasks[id] = snap(admitted);
71
+ save(doc);
72
+ };
57
73
  const raw = {
58
- get: (id) => {
59
- const t = load().tasks[id];
60
- return t ? snap(t) : undefined;
61
- },
62
- set: (id, item) => {
63
- if (item.metadata)
64
- assertJsonMetadata(item.metadata);
65
- const doc = load();
66
- doc.tasks[id] = snap(normalizeTaskShape(item));
67
- save(doc);
68
- },
74
+ get: (id) => entryOf(load(), id),
75
+ set: (id, item) => write(id, item),
69
76
  delete: (id) => {
70
77
  const doc = load();
71
78
  if (!(id in doc.tasks))
@@ -74,7 +81,7 @@ export function createFileTaskListStore(root, opts) {
74
81
  save(doc);
75
82
  return true;
76
83
  },
77
- list: () => Object.values(load().tasks).map(snap),
84
+ list: () => listOf(load()),
78
85
  allocateId: () => {
79
86
  const doc = load();
80
87
  const id = String(doc.nextId);
@@ -85,17 +92,8 @@ export function createFileTaskListStore(root, opts) {
85
92
  };
86
93
  const snap = (t) => structuredClone(t);
87
94
  return {
88
- get: (id) => locked(() => {
89
- const t = load().tasks[id];
90
- return t ? snap(t) : undefined;
91
- }),
92
- set: (id, item) => locked(() => {
93
- if (item.metadata)
94
- assertJsonMetadata(item.metadata);
95
- const doc = load();
96
- doc.tasks[id] = snap(normalizeTaskShape(item));
97
- save(doc);
98
- }),
95
+ get: (id) => locked(() => entryOf(load(), id)),
96
+ set: (id, item) => locked(() => write(id, item)),
99
97
  delete: (id) => locked(() => {
100
98
  const doc = load();
101
99
  if (!(id in doc.tasks))
@@ -104,7 +102,7 @@ export function createFileTaskListStore(root, opts) {
104
102
  save(doc);
105
103
  return true;
106
104
  }),
107
- list: () => locked(() => Object.values(load().tasks).map(snap)),
105
+ list: () => locked(() => listOf(load())),
108
106
  allocateId: () => locked(() => {
109
107
  const doc = load();
110
108
  const id = String(doc.nextId);
@@ -1,8 +1,9 @@
1
1
  import { type RetentionDeclaration } from "../../core/retention.js";
2
- import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
2
+ import type { ToolResultBytes, ToolResultDeletionReport, ToolResultEntryKind, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
3
3
  import { type CorruptReadInfo } from "./corrupt-read-sink.js";
4
4
  /**
5
- * design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE file per ref.
5
+ * design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE content file per ref — `<stem>.txt` for text,
6
+ * `<stem>.bin` for the byte arm ({@link FileToolResultStore.putBytes}), never both — beside one owner record.
6
7
  *
7
8
  * `ref = tr_<sessionId>~<toolCallId>` (engine-minted, already globally unique; the separator is the
8
9
  * backlog #119 injective form). `put` is an `O_CREAT|O_EXCL` create → on `EEXIST` it no-ops
@@ -48,11 +49,21 @@ export declare class FileToolResultStore implements ToolResultStore {
48
49
  /** The directory a ref's files live in, and their shared stem. See {@link encodeRefFilename} for why
49
50
  * a FOLDED name gets its own directory instead of sharing one with identity names. */
50
51
  private locate;
52
+ /** The content file of `ref`'s entry of `kind` — one name per kind in {@link CONTENT_SUFFIX}, beside one owner record. */
51
53
  private pathFor;
54
+ /** The cross-kind half of the write-once election: a ref whose stem already holds the OTHER kind's content file refuses this
55
+ * write, typed, before anything is linked — one stem, one content file. Under the data root's single writer the check and
56
+ * the link that follows are adjacent synchronous steps. */
57
+ private refuseOtherKind;
52
58
  /** #119 — the provenance sidecar's path. Same directory and stem as {@link pathFor}, so the pair is
53
59
  * found by one encoding step and a ref that cannot be encoded has no sidecar either. */
54
60
  private ownerPathFor;
55
61
  put(ref: string, content: string, provenance?: ToolResultProvenance): void;
62
+ /** The byte arm's write (interface: {@link ToolResultStore.putBytes}): the same election as {@link put}, the content file
63
+ * `<stem>.bin`, the media type in the owner record. */
64
+ putBytes(ref: string, bytes: Uint8Array, provenance: ToolResultProvenance, mediaType?: string): void;
65
+ /** The one write-once election both kinds run: refuse the other kind, link the content file, then publish the owner record. */
66
+ private publish;
56
67
  /** #119 — the recorded owner, or `undefined` for an unknown ref AND for a stored-but-unowned one.
57
68
  * Lenient by design on the READ face (see {@link readOwnerFile}). */
58
69
  ownerOf(ref: string): ToolResultProvenance | undefined;
@@ -71,6 +82,10 @@ export declare class FileToolResultStore implements ToolResultStore {
71
82
  offset?: number;
72
83
  limit?: number;
73
84
  }): ToolResultSlice | undefined;
85
+ /** The byte arm's read (interface: {@link ToolResultStore.bytesOf}): the `.bin` file's size, the media type its owner record
86
+ * carries, and its bytes when asked. `undefined` for a ref holding no bytes — and, as on {@link get}'s face, for a ref no write
87
+ * could store. */
88
+ bytesOf(ref: string): ToolResultBytes | undefined;
74
89
  /**
75
90
  * Erase every entry owned by `sessionId` (interface: {@link ToolResultStore.deleteBySession}). Without
76
91
  * it a session deletion leaves this store's files on disk for the lifetime of the data root.
@@ -83,7 +98,9 @@ export declare class FileToolResultStore implements ToolResultStore {
83
98
  * stamped one, is ignored — it narrows the same session.
84
99
  *
85
100
  * Both namespaces are swept: identity-named files in the store dir (refs a caller minted inside the
86
- * filename charset, and everything written before the injective mint) and {@link FOLDED_SUBDIR}.
101
+ * filename charset, and everything written before the injective mint) and {@link FOLDED_SUBDIR}; in each, only the names
102
+ * this store writes ({@link entryPartOf}) — a text or a byte entry is removed alike, and a staging file is never touched here
103
+ * (it has no owner; the age sweeps remove a dead write's).
87
104
  *
88
105
  * Removal order is CONTENT then SIDECAR, and it is load-bearing. Interrupted after the content unlink,
89
106
  * the next sweep still finds the sidecar, matches the same session and converges; interrupted after a
@@ -114,10 +131,12 @@ export declare class FileToolResultStore implements ToolResultStore {
114
131
  /**
115
132
  * Age out the entries stored more than `maxAgeMs` before `now` (interface: {@link ToolResultStore.reap}). An entry's
116
133
  * age is its content file's modification time: the write-once publication sets it and nothing rewrites the file.
117
- * Both namespaces are swept, and only names this store writes are judged. Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
134
+ * Both namespaces are swept, and only names this store writes are judged ({@link entryPartOf}): text and byte entries alike.
135
+ * Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
118
136
  * record whose content is already gone — the leftover of an interrupted pass, or of a session sweep — is removed
119
- * once it is past the cutoff too, and is not counted (it was not an entry). Synchronous: under the data root's single
120
- * writer nothing interleaves with it.
137
+ * once it is past the cutoff too, and is not counted (it was not an entry); so is a staging file a write left behind when
138
+ * its process died between opening it and linking it (a live write's staging file is as new as the write). Synchronous: under
139
+ * the data root's single writer nothing interleaves with it.
121
140
  */
122
141
  reap(now: number, opts?: {
123
142
  maxAgeMs?: number;
@@ -127,7 +146,8 @@ export declare class FileToolResultStore implements ToolResultStore {
127
146
  * content file with no owner record beside it. A present owner record keeps its entry whether it reads or not, and age is the
128
147
  * content file's modification time, as {@link reap} reads it — so a `put` caught between its content and its owner record (its
129
148
  * content is as new as the write) is never past a cutoff in the past. The owner record is looked for again just before the
130
- * unlink, so one that landed after the listing still keeps its entry. Both namespaces; names this store writes only.
149
+ * unlink, so one that landed after the listing still keeps its entry. Both namespaces; names this store writes only
150
+ * ({@link entryPartOf}), text and byte entries alike; a dead write's staging file past the cutoff goes too, uncounted, as in {@link reap}.
131
151
  */
132
152
  deleteUnattributable(cutoffMs: number): number;
133
153
  /**
@@ -149,3 +169,21 @@ export declare class FileToolResultStore implements ToolResultStore {
149
169
  * that ref's own location is this file, else — for an identity-named entry — the stem itself. */
150
170
  private refOfEntry;
151
171
  }
172
+ /** One file of this store's, as {@link entryPartOf} reads its name. */
173
+ export type ToolResultEntryPart = {
174
+ readonly stem: string;
175
+ readonly part: "content";
176
+ readonly kind: ToolResultEntryKind;
177
+ } | {
178
+ readonly stem: string;
179
+ readonly part: "owner";
180
+ } | {
181
+ readonly stem: string;
182
+ readonly part: "staging";
183
+ };
184
+ /**
185
+ * THE one reading of "is this file one of this store's, and which part of which entry": every sweep and the write's path
186
+ * composition read names through this table and nothing else. A name it answers `undefined` for is not an entry, whatever its
187
+ * suffix — no sweep deletes it and no count includes it (`folded` = the {@link FOLDED_SUBDIR} namespace, whose stems are digests).
188
+ */
189
+ export declare function entryPartOf(name: string, folded: boolean): ToolResultEntryPart | undefined;
@@ -32,19 +32,34 @@ export class FileToolResultStore {
32
32
  stem: sanitizePathComponent(encoded.stem),
33
33
  };
34
34
  }
35
- pathFor(ref) {
35
+ pathFor(ref, kind = "text") {
36
36
  const { dir, stem } = this.locate(ref);
37
- return join(dir, `${stem}${CONTENT_SUFFIX}`);
37
+ return join(dir, `${stem}${CONTENT_SUFFIX[kind]}`);
38
+ }
39
+ refuseOtherKind(ref, incoming, provenance) {
40
+ const other = incoming === "text" ? "bytes" : "text";
41
+ if (modifiedAt(this.pathFor(ref, other)) === undefined)
42
+ return;
43
+ throw new ToolResultRefConflictError(ref, this.readOwnerFile(ref, { loud: false }), provenance, { stored: other, incoming });
38
44
  }
39
45
  ownerPathFor(ref) {
40
46
  const { dir, stem } = this.locate(ref);
41
47
  return join(dir, `${stem}${OWNER_SUFFIX}`);
42
48
  }
43
49
  put(ref, content, provenance) {
50
+ this.publish(ref, "text", content, provenance, undefined);
51
+ }
52
+ putBytes(ref, bytes, provenance, mediaType) {
53
+ if (!(bytes instanceof Uint8Array))
54
+ throw new TypeError(`FileToolResultStore.putBytes: bytes must be a Uint8Array (got ${typeof bytes})`);
55
+ this.publish(ref, "bytes", bytes, provenance, typeof mediaType === "string" ? mediaType : undefined);
56
+ }
57
+ publish(ref, kind, content, provenance, mediaType) {
44
58
  assertSafeToolResultRef(ref);
59
+ this.refuseOtherKind(ref, kind, provenance);
45
60
  let won;
46
61
  try {
47
- writeThenLink(this.pathFor(ref), content);
62
+ writeThenLink(this.pathFor(ref, kind), content);
48
63
  won = true;
49
64
  }
50
65
  catch (err) {
@@ -60,11 +75,11 @@ export class FileToolResultStore {
60
75
  if (provenance === undefined)
61
76
  return;
62
77
  try {
63
- this.writeOwnerFile(ref, provenance);
78
+ this.writeOwnerFile(ref, provenance, mediaType);
64
79
  }
65
80
  catch (err) {
66
81
  if (err instanceof ToolResultRefConflictError)
67
- unlinkIfAbsentOk(this.pathFor(ref));
82
+ unlinkIfAbsentOk(this.pathFor(ref, kind));
68
83
  throw err;
69
84
  }
70
85
  }
@@ -103,9 +118,9 @@ export class FileToolResultStore {
103
118
  this.disclose(ownerPath, "not-an-object: owner sidecar is present but is not an owner record — read as unowned");
104
119
  return undefined;
105
120
  }
106
- writeOwnerFile(ref, provenance) {
121
+ writeOwnerFile(ref, provenance, mediaType) {
107
122
  try {
108
- writeThenLink(this.ownerPathFor(ref), JSON.stringify({ ...normalizeToolResultProvenance(provenance), ref }));
123
+ writeThenLink(this.ownerPathFor(ref), JSON.stringify({ ...normalizeToolResultProvenance(provenance), ref, ...(mediaType !== undefined ? { mediaType } : {}) }));
109
124
  }
110
125
  catch (err) {
111
126
  if (err.code !== "EEXIST")
@@ -132,6 +147,27 @@ export class FileToolResultStore {
132
147
  const content = limit != null ? full.slice(offset, offset + limit) : full.slice(offset);
133
148
  return { content, offset, totalChars: full.length };
134
149
  }
150
+ bytesOf(ref) {
151
+ let path;
152
+ try {
153
+ path = this.pathFor(ref, "bytes");
154
+ }
155
+ catch {
156
+ return undefined;
157
+ }
158
+ let size;
159
+ try {
160
+ size = statSync(path).size;
161
+ }
162
+ catch (err) {
163
+ if (err.code === "ENOENT")
164
+ return undefined;
165
+ throw err;
166
+ }
167
+ const record = readOwnerFileAt(this.ownerPathFor(ref));
168
+ const mediaType = typeof record === "string" ? undefined : record.mediaType;
169
+ return { byteLength: size, ...(mediaType !== undefined ? { mediaType } : {}), bytes: () => new Uint8Array(readFileSync(path)) };
170
+ }
135
171
  deleteBySession(sessionId) {
136
172
  let deleted = 0;
137
173
  let unattributable = 0;
@@ -145,9 +181,11 @@ export class FileToolResultStore {
145
181
  continue;
146
182
  throw err;
147
183
  }
184
+ const folded = dir !== this.dir;
148
185
  const listed = new Set(names);
149
186
  for (const name of names) {
150
- if (!name.endsWith(OWNER_SUFFIX))
187
+ const part = entryPartOf(name, folded);
188
+ if (part?.part !== "owner")
151
189
  continue;
152
190
  const owner = readOwnerAt(join(dir, name));
153
191
  if (owner === "gone")
@@ -158,28 +196,28 @@ export class FileToolResultStore {
158
196
  }
159
197
  if (owner.sessionId !== sessionId)
160
198
  continue;
161
- const stem = name.slice(0, -OWNER_SUFFIX.length);
199
+ const { stem } = part;
162
200
  const sidecarPath = join(dir, name);
163
- const contentPath = join(dir, `${stem}${CONTENT_SUFFIX}`);
164
- unlinkIfAbsentOk(contentPath);
201
+ unlinkContentOf(dir, stem);
165
202
  unlinkIfAbsentOk(sidecarPath);
166
203
  const republished = readOwnerAt(sidecarPath);
167
204
  if (republished === "gone") {
168
- unlinkIfAbsentOk(contentPath);
205
+ unlinkContentOf(dir, stem);
169
206
  }
170
207
  else if (republished === "damaged") {
171
208
  unattributable++;
172
209
  }
173
210
  else if (republished.sessionId === sessionId) {
174
- unlinkIfAbsentOk(contentPath);
211
+ unlinkContentOf(dir, stem);
175
212
  unlinkIfAbsentOk(sidecarPath);
176
213
  }
177
214
  deleted++;
178
215
  }
179
216
  for (const name of names) {
180
- if (!name.endsWith(CONTENT_SUFFIX))
217
+ const part = entryPartOf(name, folded);
218
+ if (part?.part !== "content")
181
219
  continue;
182
- if (listed.has(`${name.slice(0, -CONTENT_SUFFIX.length)}${OWNER_SUFFIX}`))
220
+ if (listed.has(`${part.stem}${OWNER_SUFFIX}`))
183
221
  continue;
184
222
  unattributable++;
185
223
  }
@@ -203,21 +241,18 @@ export class FileToolResultStore {
203
241
  }
204
242
  const listed = new Set(names);
205
243
  for (const name of names) {
206
- const content = name.endsWith(CONTENT_SUFFIX);
207
- if (!content && !name.endsWith(OWNER_SUFFIX))
244
+ const part = entryPartOf(name, folded);
245
+ if (part === undefined)
208
246
  continue;
209
- const stem = name.slice(0, -(content ? CONTENT_SUFFIX : OWNER_SUFFIX).length);
210
- if (!isEncodedStem(stem, folded))
211
- continue;
212
- if (!content && listed.has(`${stem}${CONTENT_SUFFIX}`))
247
+ if (part.part === "owner" && hasContentListed(listed, part.stem))
213
248
  continue;
214
249
  const path = join(dir, name);
215
250
  const modified = modifiedAt(path);
216
251
  if (modified === undefined || modified >= cutoff)
217
252
  continue;
218
253
  unlinkIfAbsentOk(path);
219
- if (content) {
220
- unlinkIfAbsentOk(join(dir, `${stem}${OWNER_SUFFIX}`));
254
+ if (part.part === "content") {
255
+ unlinkIfAbsentOk(join(dir, `${part.stem}${OWNER_SUFFIX}`));
221
256
  removed++;
222
257
  }
223
258
  }
@@ -241,16 +276,20 @@ export class FileToolResultStore {
241
276
  }
242
277
  const listed = new Set(names);
243
278
  for (const name of names) {
244
- if (!name.endsWith(CONTENT_SUFFIX))
279
+ const part = entryPartOf(name, folded);
280
+ if (part === undefined || part.part === "owner")
245
281
  continue;
246
- const stem = name.slice(0, -CONTENT_SUFFIX.length);
247
- if (!isEncodedStem(stem, folded) || listed.has(`${stem}${OWNER_SUFFIX}`))
282
+ if (part.part === "content" && listed.has(`${part.stem}${OWNER_SUFFIX}`))
248
283
  continue;
249
284
  const path = join(dir, name);
250
285
  const modified = modifiedAt(path);
251
286
  if (modified === undefined || modified >= cutoffMs)
252
287
  continue;
253
- if (readOwnerAt(join(dir, `${stem}${OWNER_SUFFIX}`)) !== "gone")
288
+ if (part.part === "staging") {
289
+ unlinkIfAbsentOk(path);
290
+ continue;
291
+ }
292
+ if (readOwnerAt(join(dir, `${part.stem}${OWNER_SUFFIX}`)) !== "gone")
254
293
  continue;
255
294
  unlinkIfAbsentOk(path);
256
295
  removed++;
@@ -272,9 +311,11 @@ export class FileToolResultStore {
272
311
  continue;
273
312
  throw err;
274
313
  }
314
+ const folded = dir !== this.dir;
275
315
  const listed = new Set(names);
276
316
  for (const name of names) {
277
- if (!name.endsWith(OWNER_SUFFIX))
317
+ const part = entryPartOf(name, folded);
318
+ if (part?.part !== "owner")
278
319
  continue;
279
320
  const owner = readOwnerFileAt(join(dir, name));
280
321
  if (owner === "gone")
@@ -285,17 +326,15 @@ export class FileToolResultStore {
285
326
  }
286
327
  if (owner.provenance.sessionId !== sessionId)
287
328
  continue;
288
- const stem = name.slice(0, -OWNER_SUFFIX.length);
289
- const ref = this.refOfEntry(dir, stem, owner.ref);
329
+ const ref = this.refOfEntry(dir, part.stem, owner.ref);
290
330
  if (ref === undefined)
291
331
  unaddressable++;
292
332
  else
293
333
  entries.push({ ref, provenance: owner.provenance });
294
334
  }
295
335
  for (const name of names) {
296
- if (!name.endsWith(CONTENT_SUFFIX))
297
- continue;
298
- if (listed.has(`${name.slice(0, -CONTENT_SUFFIX.length)}${OWNER_SUFFIX}`))
336
+ const part = entryPartOf(name, folded);
337
+ if (part?.part !== "content" || listed.has(`${part.stem}${OWNER_SUFFIX}`))
299
338
  continue;
300
339
  unattributable++;
301
340
  }
@@ -317,8 +356,32 @@ export class FileToolResultStore {
317
356
  return dir === this.dir && lies(stem) ? stem : undefined;
318
357
  }
319
358
  }
320
- const CONTENT_SUFFIX = ".txt";
359
+ const CONTENT_SUFFIX = { text: ".txt", bytes: ".bin" };
360
+ const CONTENT_KINDS = Object.keys(CONTENT_SUFFIX);
321
361
  const OWNER_SUFFIX = ".owner.json";
362
+ const STAGING_NAME = /^(.+)\.\d+\.[0-9a-f]{12}\.tmp$/;
363
+ export function entryPartOf(name, folded) {
364
+ const staged = STAGING_NAME.exec(name);
365
+ const published = staged !== null ? staged[1] : name;
366
+ const read = (() => {
367
+ if (published.endsWith(OWNER_SUFFIX))
368
+ return { stem: published.slice(0, -OWNER_SUFFIX.length) };
369
+ const kind = CONTENT_KINDS.find((k) => published.endsWith(CONTENT_SUFFIX[k]));
370
+ return kind === undefined ? undefined : { stem: published.slice(0, -CONTENT_SUFFIX[kind].length), kind };
371
+ })();
372
+ if (read === undefined || !isEncodedStem(read.stem, folded))
373
+ return undefined;
374
+ if (staged !== null)
375
+ return { stem: read.stem, part: "staging" };
376
+ return read.kind !== undefined ? { stem: read.stem, part: "content", kind: read.kind } : { stem: read.stem, part: "owner" };
377
+ }
378
+ function hasContentListed(listed, stem) {
379
+ return CONTENT_KINDS.some((k) => listed.has(`${stem}${CONTENT_SUFFIX[k]}`));
380
+ }
381
+ function unlinkContentOf(dir, stem) {
382
+ for (const k of CONTENT_KINDS)
383
+ unlinkIfAbsentOk(join(dir, `${stem}${CONTENT_SUFFIX[k]}`));
384
+ }
322
385
  function parseOwnerRecord(raw) {
323
386
  return parseOwnerFile(raw)?.provenance;
324
387
  }
@@ -332,10 +395,10 @@ function parseOwnerFile(raw) {
332
395
  }
333
396
  })();
334
397
  if (typeof parsed === "object" && parsed !== null) {
335
- const { sessionId, taskId, ref } = parsed;
398
+ const { sessionId, taskId, ref, mediaType } = parsed;
336
399
  if (typeof sessionId === "string" && (taskId === undefined || typeof taskId === "string")) {
337
400
  const provenance = taskId === undefined ? { sessionId } : { sessionId, taskId };
338
- return typeof ref === "string" ? { provenance, ref } : { provenance };
401
+ return { provenance, ...(typeof ref === "string" ? { ref } : {}), ...(typeof mediaType === "string" ? { mediaType } : {}) };
339
402
  }
340
403
  }
341
404
  return undefined;
@@ -16,6 +16,7 @@ export declare class FileWorkflowRunStore implements WorkflowRunStore {
16
16
  private readonly ledger;
17
17
  /** RB-145: this instance's own close latch — the refcount belongs to the DIRECTORY, not to callers. */
18
18
  private closed;
19
+ private readonly disclose;
19
20
  private get runs();
20
21
  constructor(root: string, options?: FileWorkflowRunStoreOptions);
21
22
  /** Serialize an op behind any in-flight op on the same id (the in-process per-id async mutex). */