@sema-agent/core 7.66.1 → 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 (899) hide show
  1. package/CHANGELOG.md +3483 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -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 +6 -5
  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.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,10 +1,3 @@
1
- /**
2
- * The durable-suspend checkpoint ROW-IDENTITY vocabulary — the default isolation scope, the ONE derivation of a row's
3
- * scope, and the ONE reading of the placement fields' empty string — moved whole out of the orchestrator so the
4
- * park-lane phases (the suspend stamp), the driver (the leg's scope, derived once and handed to every mint lane; the
5
- * restore fold) and runtask (the resume rung) reach DOWN for the same names. Pure: a constant, two string functions, the
6
- * composition-leg record's reading (with its entry's closed set) and comparison, and the row id's restore.
7
- */
8
1
  import type { CompositionLeg, RunInternals } from "./contracts.js";
9
2
  /** The multi-tenant scope used when a durable suspend fires for an IRREVERSIBLE tool in an
10
3
  * unattended deployment that did NOT opt into `durableApproval` (so there is no caller-supplied scope). The
@@ -27,21 +20,52 @@ export declare const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
27
20
  * realistic source — is the absence of an isolation key wearing its clothes. Kept as a literal `""` it would be
28
21
  * one bucket for every tenant that hit it: `listByScope("")` reads all their pending approvals (with each
29
22
  * summary's `toolInput` preview) and `reap("")` / `resolve(token, "")` act across all of them.
23
+ *
24
+ * The last identity rung is the task's ISOLATION SCOPE ({@link isolationScopeOf}: its `isolationScope`, else its principal): a parked
25
+ * row is working state of one scope of a person's work, so two scopes of one person never share a bucket. A task that sets an
26
+ * isolation scope may only declare a `durableApproval.scope` equal to it (the config door), so the rung above it cannot split them.
27
+ * A `durableApproval` that is there names its scope ({@link declaredCheckpointScope}: the task door refuses one that does not), so the
28
+ * second rung is a value a task declared, never an omission this ladder fills in.
30
29
  */
31
30
  export declare function checkpointScopeOf(spec: {
32
31
  durableApproval?: {
33
32
  scope?: string;
34
33
  };
35
34
  principal?: string;
35
+ isolationScope?: string;
36
36
  }, seat?: string): string;
37
+ /** What an opt-in names: its scope, or why it names none — a clause for a refusal sentence. */
38
+ export type DeclaredScopeReading = {
39
+ readonly kind: "scope";
40
+ readonly scope: string;
41
+ } | {
42
+ readonly kind: "none";
43
+ readonly fault: string;
44
+ };
45
+ /**
46
+ * The ONE reading of "this opt-in names its scope": a `durableApproval` — the task's own, or the record a parked row keeps of it — names
47
+ * the scope its approvals are filed under as the plain-data record's own `scope` member, a string that is a NAME: the engine's one name
48
+ * rule (`principalNameOf`, the rule `TaskSpec.isolationScope` is judged by), so the key every durable approval is filed under is one a
49
+ * principal could have — visible content, no control, separator or format character — and `isolationScopeOf`'s fall-through never
50
+ * reads it as another quantity. The opt-in is read as data ({@link DECLARED_SCOPE_DATA}): nothing of the host's runs in the look.
51
+ * Answers the scope, or why there is none (not an object, not plain data, no such member, a non-string, not a name). The task door
52
+ * (`assertDurableApprovalDeclaresScope`) refuses an opt-in this reads no scope in, and the revival of a delegated child from its row
53
+ * (`subagent.ts`) re-derives the opt-in only from a record this reads a scope in, through {@link declaredCheckpointScope} — so the two
54
+ * read "an opt-in without a scope" the same way: it is not one. A row filed by a host before the door judged the name (or one a store
55
+ * hands back as something other than data) reads, on revival, as no opt-in (the conservative side: a second plain ask headless-denies
56
+ * instead of parking again).
57
+ */
58
+ export declare function readDeclaredCheckpointScope(declared: unknown): DeclaredScopeReading;
59
+ /** The scope an opt-in names ({@link readDeclaredCheckpointScope}), or `undefined` when it names none. */
60
+ export declare function declaredCheckpointScope(declared: unknown): string | undefined;
37
61
  /**
38
62
  * The ONE spelling of the placement fields' empty-string discipline: `""` is absence
39
63
  * wearing clothes (the resume entry's principal-rung posture), and every placement read that must
40
64
  * treat it so — the resume rung's two sides (runtask), the restore fold's seed and the suspend
41
65
  * stamp — goes through THIS helper, so three sites cannot drift into three readings. Deliberately
42
66
  * NOT applied to the live `internals.placementRoot`/`rootSessionId` reads of the RESOLUTION fold:
43
- * an empty supplied claim there is an assembly error the execution-env phase's `mintPlacementRootSessionId` refuses
44
- * loudly on the factory path, and normalizing it away would silently repair what should be loud.
67
+ * an empty supplied claim there is an assembly error `readRootOccupant` refuses the run for, on every path, and normalizing it
68
+ * away would silently repair what should be loud.
45
69
  */
46
70
  export declare function placementValueOrAbsent(value: string | undefined): string | undefined;
47
71
  /**
@@ -1,6 +1,32 @@
1
+ import { types } from "node:util";
2
+ import { isolationScopeOf } from "../isolation-scope.js";
3
+ import { describeFault, isPlainRecord, receive } from "../mods/kernel/receive.js";
4
+ import { principalNameFault, principalNameOf } from "../principal-name.js";
1
5
  export const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
2
6
  export function checkpointScopeOf(spec, seat) {
3
- return seat || spec.durableApproval?.scope || spec.principal || DEFAULT_IRREVERSIBLE_SCOPE;
7
+ return seat || spec.durableApproval?.scope || isolationScopeOf(spec) || DEFAULT_IRREVERSIBLE_SCOPE;
8
+ }
9
+ const DECLARED_SCOPE_DATA = Object.freeze({ accessors: "refuse", depth: 1, others: "refuse", isProxy: (v) => types.isProxy(v) });
10
+ export function readDeclaredCheckpointScope(declared) {
11
+ if (typeof declared !== "object" || declared === null)
12
+ return { kind: "none", fault: declared === null ? "null, not an object" : `a ${typeof declared}, not an object` };
13
+ const data = receive(declared, DECLARED_SCOPE_DATA);
14
+ if (!data.ok)
15
+ return { kind: "none", fault: `not plain data — ${describeFault(data.fault)}` };
16
+ const record = data.value;
17
+ if (!isPlainRecord(record))
18
+ return { kind: "none", fault: "a list, not a record" };
19
+ if (!Object.hasOwn(record, "scope"))
20
+ return { kind: "none", fault: "no `scope` member" };
21
+ const scope = record.scope;
22
+ if (typeof scope !== "string")
23
+ return { kind: "none", fault: `a \`scope\` that is ${scope === null ? "null" : typeof scope}` };
24
+ const name = principalNameOf(scope);
25
+ return name !== undefined ? { kind: "scope", scope: name } : { kind: "none", fault: `a \`scope\` that is ${principalNameFault(scope)}` };
26
+ }
27
+ export function declaredCheckpointScope(declared) {
28
+ const reading = readDeclaredCheckpointScope(declared);
29
+ return reading.kind === "scope" ? reading.scope : undefined;
4
30
  }
5
31
  export function placementValueOrAbsent(value) {
6
32
  return value || undefined;
@@ -140,8 +140,8 @@ export declare function announceClassifierRoleDefaulted(args: {
140
140
  * The `classifier.unavailable` notice — a classification that could not RULE (the classifier leg failed, its per-level
141
141
  * budget ran out, or it replied with no verdict — `parse_error`; the code name predates that third cause) and where the
142
142
  * call went, read off the station's ONE route word (`ApprovalRoute`): `live_approver` = on to the live approver now,
143
- * `durable_park` = on to the durable park (the notice is minted at the fork: it states the route, never whether the park
144
- * then commits) — both are `disposition: "asked"` (the handed-on ask carries
143
+ * `policy_seat` = on to the deployment's approval policy now, `durable_park` = on to the durable park (the notice is minted
144
+ * at the fork: it states the route, never whether the park then commits) — all three are `disposition: "asked"` (the handed-on ask carries
145
145
  * `requiresRealApproval` and `classifierNoRuling`, so no automatic lane answers it), `none` = `"denied"`, refused — no
146
146
  * approver and no park facility (a reply with no verdict is then also counted on the denial limit). The sentence names the
147
147
  * route; the detail carries its projection (`disposition`), and the route itself is the run's published seat word
@@ -1,5 +1,6 @@
1
1
  import { sameRouteIdentity } from "../../brain/route-adjudicator.js";
2
2
  import { lowestReasoningSeat } from "../../brain/reasoning-request.js";
3
+ import { offSpelling } from "../../brain/reasoning.js";
3
4
  import { AUTO_MODE_CLASSIFIER_CONTRACT_BROKEN_AFTER, AUTO_MODE_CLASSIFIER_LOW_REASONING_BUDGET_TOKENS, AUTO_MODE_CLASSIFIER_MAX_TOKENS, AUTO_MODE_CLASSIFIER_THINK_BUDGET_TOKENS } from "../auto-mode-defaults.js";
4
5
  import { AUTO_MODE_RUNG_RATE_LIMITED_CODE, autoModeClassifierFallbackOf, parseAutoModeResponse } from "../auto-mode.js";
5
6
  import { classifierUnavailableDispositionOf } from "../classifier-unavailable-arm.js";
@@ -85,20 +86,26 @@ function tierBelowMain(deps, main) {
85
86
  }
86
87
  return { model: main, defaulted: "main_only" };
87
88
  }
89
+ const OFF_SPELLING_REMEDY = Object.freeze({
90
+ "compat.thinkingFormat": "Name a `classifier` role, or declare the model's thinking format (`compat.thinkingFormat`) so the seat can spell off.",
91
+ "thinkingLevelMap.off": "Name a `classifier` role, or declare the value this endpoint takes for off (`thinkingLevelMap.off`) so the seat can spell off.",
92
+ none: "No declaration on this model spells off; name a `classifier` role whose model's thinking can be turned off.",
93
+ });
88
94
  export function announceClassifierRoleDefaulted(args) {
89
95
  const { seat } = args;
90
96
  if (seat.defaulted === undefined)
91
97
  return;
92
- const spelled = lowestReasoningSeat(seat.model) === "off";
98
+ const off = offSpelling(seat.model);
93
99
  deliverEngineNotice(args.onNotice, {
94
100
  code: "classifier.role_defaulted",
95
101
  message: `no classifier role names a model — "${seat.model.id}" classifies this run (${seat.defaulted}); ` +
96
- (spelled ? "its wire can turn thinking off for the verdict. " : "its wire cannot turn thinking off, so each classification carries a thinking allowance. ") +
97
- "Name a `classifier` role, or declare the model's thinking format (`compat.thinkingFormat`) so the seat can spell off.",
102
+ (off.spelled
103
+ ? "its wire can turn thinking off for the verdict. Name a `classifier` role to classify on another model."
104
+ : `its wire cannot turn thinking off, so each classification carries a thinking allowance. ${OFF_SPELLING_REMEDY[off.missing]}`),
98
105
  detail: {
99
106
  model: seat.model.id,
100
107
  reason: seat.defaulted,
101
- thinkingOffSpelled: spelled,
108
+ thinkingOffSpelled: off.spelled,
102
109
  ...(args.sessionId !== undefined ? { sessionId: args.sessionId } : {}),
103
110
  ...(args.runId !== undefined ? { runId: args.runId } : {}),
104
111
  },
@@ -115,11 +122,13 @@ export function classifierUnavailableNotice(args) {
115
122
  const seatOwner = args.station === "ancestor" ? "that layer's" : "this run's";
116
123
  const next = args.route === "live_approver"
117
124
  ? `so the call was handed on to ${seatOwner} live approver rather than refused by the classifier.`
118
- : args.route === "durable_park"
119
- ? `so the call was handed on to ${seatOwner} durable approval park, for a person to answer later, rather than refused by the classifier.`
120
- : (args.station === "ancestor" ? "and that layer has no live approver" : "and this run has no approver and no park facility") +
121
- ", so the call was refused and did not run." +
122
- (args.cause === "timeout" ? " A deployment on a slow gateway raises the budget." : "");
125
+ : args.route === "policy_seat"
126
+ ? `so the call was handed on to ${seatOwner} approval policy rather than refused by the classifier.`
127
+ : args.route === "durable_park"
128
+ ? `so the call was handed on to ${seatOwner} durable approval park, for a person to answer later, rather than refused by the classifier.`
129
+ : (args.station === "ancestor" ? "and that layer has no live approver" : "and this run has no approver and no park facility") +
130
+ ", so the call was refused and did not run." +
131
+ (args.cause === "timeout" ? " A deployment on a slow gateway raises the budget." : "");
123
132
  return {
124
133
  code: "classifier.unavailable",
125
134
  message: `auto mode could not judge "${args.toolName}": ${why}, ${next}`,
@@ -14,9 +14,10 @@
14
14
  * wears a family prefix.
15
15
  */
16
16
  import { type AgentHarness } from "../../internal/harness.js";
17
+ import { type WindowBelowOverhead } from "../auto-compaction.js";
17
18
  import type { PlatformLimitReason } from "../checkpoint-store.js";
18
19
  import type { TaskSpec } from "../types.js";
19
- import type { Prepared } from "./contracts.js";
20
+ import type { Prepared, RunState } from "./contracts.js";
20
21
  /**
21
22
  * The LIMIT-APPROACH frames, the successor to the retired deadline-nudge family. Two facts
22
23
  * make them a different mechanism, not a rename:
@@ -28,10 +29,12 @@ import type { Prepared } from "./contracts.js";
28
29
  * `limit_approach_converge` / `limit_approach_deliver`.
29
30
  */
30
31
  export declare const LIMIT_APPROACH_DEFAULT_THRESHOLDS: readonly [number, number];
32
+ /** The shortest declared turn cap the turn axis takes part in: below it the run is over before converging means anything. */
33
+ export declare const LIMIT_APPROACH_MIN_TURNS = 4;
31
34
  /** The output-token figure the pre-call worst-case assumes when the model declares no cap of its own.
32
35
  * Shared by the $ and token arms so the two gates cannot disagree about the same hypothetical call. */
33
36
  export declare const DEFAULT_PRECALL_OUTPUT_TOKENS = 4096;
34
- /** The two frame bodies, indexed by how many have already been sent (0 → converge, 1 → deliver now). */
37
+ /** The two sentence bodies, indexed by the threshold crossed (0 → converge, 1 → deliver now). */
35
38
  export declare function limitApproachFrames(index: 0 | 1, axis: string, percent: number, mark: string | undefined): string;
36
39
  /**
37
40
  * Resolve the effective turn cap. `undefined` = no turn cap; `0` (explicit) = unbounded.
@@ -44,6 +47,10 @@ export declare function limitApproachFrames(index: 0 | 1, axis: string, percent:
44
47
  export declare function resolveMaxTurns(limits?: {
45
48
  maxTurns?: number;
46
49
  }): number | undefined;
50
+ /** Is a TASK axis crossed — the turn cap or a token / cost ceiling (flagged at turn end), or the walltime window passed on the
51
+ * monotonic clock? The one reading the boundary's resource-slice park and the stop gate's "is the run ending" share: past a
52
+ * crossed axis a run parks only while it owes a request, and no hook or verification may manufacture another one. */
53
+ export declare function taskAxisCrossed(limits: Pick<RunState["limits"], "turnsExceeded" | "budgetHit">, walltimeMonotonicDeadline: number | undefined): boolean;
47
54
  /**
48
55
  * How long past the environment's suspend deadline the turn-boundary lane will keep waiting for the
49
56
  * usage ledger's READ.
@@ -92,9 +99,9 @@ export declare function raceUntilDeadline<T>(p: Promise<T>, deadline: number): P
92
99
  * Carried on `rs.limits.platformTerminal` and adopted as the run's `threw`, so the caller reads the cause
93
100
  * on `TaskResult.errorCode` (`errorCodeOf` lifts `.code`) instead of the anonymous error an abort produces.
94
101
  * `retryAfterMs` rides the error object because a wait hint has no `TaskResult` seat — a host reads it from
95
- * the `RunnerDeps.onError` sink this is also delivered to.
102
+ * the `RunnerDeps.onError` sink this is also delivered to. A yield (`preempt`) has none: its fallback is to keep running.
96
103
  */
97
- export declare function platformLimitTerminal(reason: PlatformLimitReason, retryAfterMs: number | undefined, moment?: "entry" | "turn_boundary" | "resume"): Error & {
104
+ export declare function platformLimitTerminal(reason: Exclude<PlatformLimitReason, "preempt">, retryAfterMs: number | undefined, moment?: "entry" | "turn_boundary" | "resume"): Error & {
98
105
  code: string;
99
106
  retryAfterMs?: number;
100
107
  };
@@ -107,6 +114,10 @@ export declare function discloseUnevaluableWindow(u: {
107
114
  phase: "config";
108
115
  sessionId: string;
109
116
  }) => void) | undefined): void;
117
+ export declare function discloseWindowBelowOverhead(w: WindowBelowOverhead, prepared: Prepared, onError: ((err: unknown, context: {
118
+ phase: "config";
119
+ sessionId: string;
120
+ }) => void) | undefined, emit: (reason: string) => void): void;
110
121
  /** 1.296 件2a — report the hard-abort timer's lateness on `task.end` only above this bar: sub-5s
111
122
  * jitter is ordinary scheduling noise (GC pauses, sync work) and would only add trace lint. */
112
123
  export declare const TIMER_LATENESS_REPORT_MS = 5000;
@@ -1,7 +1,9 @@
1
1
  import {} from "../../internal/harness.js";
2
+ import { windowBelowOverheadReason } from "../auto-compaction.js";
2
3
  import { openSystemReminder } from "../reminder-mint.js";
3
4
  import { emitTrace } from "../trace.js";
4
5
  export const LIMIT_APPROACH_DEFAULT_THRESHOLDS = [0.8, 0.95];
6
+ export const LIMIT_APPROACH_MIN_TURNS = 4;
5
7
  export const DEFAULT_PRECALL_OUTPUT_TOKENS = 4096;
6
8
  export function limitApproachFrames(index, axis, percent, mark) {
7
9
  return index === 0
@@ -15,6 +17,9 @@ export function limitApproachFrames(index, axis, percent, mark) {
15
17
  export function resolveMaxTurns(limits) {
16
18
  return limits?.maxTurns;
17
19
  }
20
+ export function taskAxisCrossed(limits, walltimeMonotonicDeadline) {
21
+ return limits.turnsExceeded || limits.budgetHit !== undefined || (walltimeMonotonicDeadline !== undefined && performance.now() >= walltimeMonotonicDeadline);
22
+ }
18
23
  export const ENV_DUE_GOVERNANCE_READ_BUDGET_MS = 5_000;
19
24
  const MAX_TIMER_DELAY_MS = 2_147_483_647;
20
25
  const DEADLINE_TICK = Symbol("deadline-tick");
@@ -78,7 +83,20 @@ export function discloseUnevaluableWindow(u, prepared, tracer, taskId, onError)
78
83
  : `it declares no context window at all (\`autoCompactTokens\` / \`contextTokens\` / \`contextWindow\` are all absent) — declare one to restore the threshold`;
79
84
  try {
80
85
  onError?.(new Error(`auto-compaction cannot run for model${modelClause}: ${cause}. Until then there is no threshold to compare against, so the ` +
81
- `context will grow until the provider refuses the request. The conversation is already about ${u.estTokens} estimated tokens.`), { phase: "config", sessionId: prepared.sessionId });
86
+ `context will grow until the provider refuses the request, and Read's \`allow_large\` cannot raise a read either. The conversation is already about ${u.estTokens} estimated tokens.`), { phase: "config", sessionId: prepared.sessionId });
87
+ }
88
+ catch {
89
+ }
90
+ }
91
+ const disclosedWindowBelowOverhead = new WeakSet();
92
+ export function discloseWindowBelowOverhead(w, prepared, onError, emit) {
93
+ if (disclosedWindowBelowOverhead.has(prepared))
94
+ return;
95
+ disclosedWindowBelowOverhead.add(prepared);
96
+ const reason = windowBelowOverheadReason(w);
97
+ emit(reason);
98
+ try {
99
+ onError?.(new Error(`compaction cannot help — ${reason}`), { phase: "config", sessionId: prepared.sessionId });
82
100
  }
83
101
  catch {
84
102
  }
@@ -1,5 +1,6 @@
1
- import { convertToLlm, uuidv7 } from "../../internal/harness.js";
2
- import { compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
1
+ import { convertToLlm, leafIdAfterEntry, uuidv7 } from "../../internal/harness.js";
2
+ import { resolveCheckpointStore } from "../checkpoint-store.js";
3
+ import { compactionFailureCause, compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
3
4
  import { compactionSeatsDefect, contextOverlayFor } from "../context-settings.js";
4
5
  import { RETIRED_COMPACTION_SEAT_KEYS } from "../retired-keys.js";
5
6
  import { createRowSeat, promptCountOf } from "../mods/session-append.js";
@@ -10,33 +11,63 @@ import { resolveTaskModel } from "../roles.js";
10
11
  import { StoredSession } from "../session.js";
11
12
  import { emitTrace } from "../trace.js";
12
13
  import { egressThrownText } from "../untrusted-egress.js";
14
+ import { readElements, readMember } from "../thrown-value.js";
15
+ import { inlineUntrusted } from "../untrusted-text.js";
13
16
  import { emitInputTruncated, legCompactionSettings } from "./compaction-call-options.js";
14
17
  import { compactionHookOptions, summaryProviderOptions } from "./compaction-seams.js";
15
18
  import { compactionSummaryFallback, compactionSummaryIsDerived } from "./derived-route-fallback.js";
16
19
  import { resolveCompactionModel } from "./prepare-config-doors.js";
17
20
  import { compactionActivationSnapshot } from "./prepare-tool-disclosure-mount.js";
18
21
  import { derivedLegBrain, sideCallBookOf } from "./side-call-account.js";
19
- import { acquireExistingSession, claimIdleSession, readPlainRequest, shownValue } from "./session-verb-doors.js";
22
+ import { createModelFallbackSeat } from "./model-fallback-seat.js";
23
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
24
+ import { projectRequestCopies } from "../request-copy-projection.js";
25
+ import { acquireExistingSession, claimIdleSession, readOccupantExpectation, readPlainRequest, shownValue } from "./session-verb-doors.js";
20
26
  const VERB = "Runner.compactSession";
21
- const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "signal"]);
27
+ const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "checkpointStore", "signal", "expect"]);
22
28
  const SETTINGS_KEYS = new Set(["manualCompact", "reserveTokens", "keepRecentTokens", "instructions", "clampTolerance", ...Object.keys(RETIRED_COMPACTION_SEAT_KEYS)]);
23
29
  export async function compactIdleSession(seats, request) {
24
30
  const req = screenCompactSessionRequest(request);
25
31
  const { deps } = seats;
26
32
  const resolved = resolveTaskModel({ model: req.model }, deps);
27
33
  const named = resolveCompactionModel(req.compactionModel !== undefined ? { compactionModel: req.compactionModel } : {}, deps, "compactSession.compactionModel");
34
+ const store = resolveCheckpointStore(req.checkpointStore !== undefined ? { checkpointStore: req.checkpointStore } : {}, deps);
28
35
  if (req.signal?.aborted === true)
29
36
  return { outcome: "mooted", events: [] };
30
37
  const release = await claimIdleSession(seats, req.sessionId, () => sessionBusyRefusal(req.sessionId));
38
+ let legMods;
31
39
  try {
32
- const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted");
33
- const legMods = await admitLegMods({ spec: {}, deps, sessionId: req.sessionId });
34
- return await compactOnSession(req, deps, new StoredSession(acquired.session.getStorage()), resolved, named, legMods);
40
+ const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted", req.expect);
41
+ await refuseParkedSession(store, req.sessionId, req.checkpointStore !== undefined ? "the request's" : "the deployment's");
42
+ legMods = await admitLegMods({ spec: {}, deps, sessionId: req.sessionId });
43
+ return await compactOnSession(req, deps, new StoredSession(pinnedToLeaf(acquired.session.getStorage())), resolved, named, legMods);
35
44
  }
36
45
  finally {
46
+ legMods?.end();
37
47
  release();
38
48
  }
39
49
  }
50
+ function pinnedToLeaf(storage) {
51
+ let pinned;
52
+ return new Proxy(storage, {
53
+ get(target, prop, receiver) {
54
+ if (prop === "getLeafId")
55
+ return () => (pinned ??= target.getLeafId());
56
+ if (prop === "appendEntry")
57
+ return async (entry, opts) => {
58
+ await target.appendEntry(entry, opts);
59
+ pinned = Promise.resolve(leafIdAfterEntry(entry));
60
+ };
61
+ if (prop === "setLeafId")
62
+ return async (leafId, opts) => {
63
+ await target.setLeafId(leafId, opts);
64
+ pinned = Promise.resolve(leafId);
65
+ };
66
+ const value = Reflect.get(target, prop, receiver);
67
+ return typeof value === "function" ? value.bind(target) : value;
68
+ },
69
+ });
70
+ }
40
71
  async function compactOnSession(req, deps, session, resolved, named, legMods) {
41
72
  const { sessionId } = req;
42
73
  const events = [];
@@ -44,7 +75,8 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
44
75
  const passReport = compactionPassReport({ push: (e) => events.push(e) }, ident);
45
76
  const stats = { turns: 0, tokens: 0, toolCalls: 0, promptTokens: 0, totalInputTokens: 0, cachedTokens: 0, cacheWriteTokens: 0, cacheWriteTokensLong: 0, outputTokens: 0, costMicroUsd: 0 };
46
77
  const telemetry = { unpricedSpend: false, tracer: deps.tracer, taskId: sessionId };
47
- const accountBook = sideCallBookOf(stats, { telemetry, pricing: () => deps.pricing, noteUnevaluablePriceTable: (p) => void (malformedPricingField(p) !== undefined && (telemetry.unpricedSpend = true)), catalog: deps.models });
78
+ const fallbackSeat = createModelFallbackSeat(deps.onNotice, { sessionId });
79
+ const accountBook = sideCallBookOf(stats, { telemetry, pricing: () => deps.pricing, noteUnevaluablePriceTable: (p) => void (malformedPricingField(p) !== undefined && (telemetry.unpricedSpend = true)), noteFallback: (lane, requested, reading) => fallbackSeat.observe(lane, requested, reading) });
48
80
  let calls = 0;
49
81
  const book = (lane, model, reply) => {
50
82
  calls += 1;
@@ -71,9 +103,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
71
103
  });
72
104
  const trace = deps.tracer;
73
105
  try {
74
- const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: deps.brain, getApiKeyAndHeaders: req.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId }) : named;
106
+ const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: modelLaneBrainOf(deps), getApiKeyAndHeaders: req.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId }) : named;
75
107
  const branch = await session.getBranch();
76
- const contextMessages = convertToLlm((await session.buildContext()).messages);
108
+ const contextMessages = projectRequestCopies(convertToLlm((await session.buildContext()).messages));
77
109
  bindSessionFacade(legMods, { deps, req, model: resolved.model, messages: contextMessages, book, turns: async () => promptCountOf(await session.getBranch()) });
78
110
  const rowSeat = createRowSeat();
79
111
  rowSeat.bind({ bus: legMods.bus, identity: undefined, report: legMods.report });
@@ -88,7 +120,7 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
88
120
  model: resolved.model,
89
121
  ...(overlay !== undefined ? { contextOverlay: overlay } : {}),
90
122
  ...(compactionModel !== undefined ? { compactionModel } : {}),
91
- brain: derivedLegBrain(() => deps.brain, "compaction", book),
123
+ brain: derivedLegBrain(() => modelLaneBrainOf(deps), "compaction", book),
92
124
  ...(req.getApiKeyAndHeaders !== undefined ? { getApiKeyAndHeaders: req.getApiKeyAndHeaders } : {}),
93
125
  ...(thinking !== undefined ? { thinking } : {}),
94
126
  settings: legCompactionSettings(req.compaction !== undefined ? { compaction: req.compaction } : {}, overlay, "manualCompact"),
@@ -124,8 +156,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
124
156
  }
125
157
  deps.onError?.(asError(err), { phase: "compaction", sessionId });
126
158
  const reason = compactionFailureReason(err);
159
+ const cause = compactionFailureCause(err);
127
160
  emitTrace(trace, () => ({ kind: "compaction.failed", version: 1, taskId: sessionId, trigger: "manual", reason, ts: Date.now() }));
128
- events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...passReport.end, ...ident() });
161
+ events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...(cause !== undefined ? { cause } : {}), ...passReport.end, ...ident() });
129
162
  return answer("failed");
130
163
  }
131
164
  }
@@ -146,6 +179,7 @@ function bindSessionFacade(legMods, input) {
146
179
  agentSessions: undefined,
147
180
  turns: input.turns,
148
181
  measure: {},
182
+ turnAbort: {},
149
183
  activeTools: new Set(),
150
184
  agentListing: undefined,
151
185
  book: (answeredBy, reply) => input.book("mod", answeredBy, reply),
@@ -162,6 +196,7 @@ function bindSessionFacade(legMods, input) {
162
196
  root: () => unavailable("session.root"),
163
197
  tools: () => unavailable("tool.list"),
164
198
  agents: () => unavailable("agent.list"),
199
+ turnAbort: () => unavailable("turn.abort"),
165
200
  });
166
201
  }
167
202
  function asError(err) {
@@ -169,11 +204,11 @@ function asError(err) {
169
204
  }
170
205
  function screenCompactSessionRequest(request) {
171
206
  const bad = (what) => {
172
- const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, signal? }.`);
207
+ const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, checkpointStore?, signal?, expect? }.`);
173
208
  e.code = "compact.invalid_request";
174
209
  throw e;
175
210
  };
176
- const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, signal } = readPlainRequest(request, REQUEST_KEYS, bad);
211
+ const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, checkpointStore, signal, expect } = readPlainRequest(request, REQUEST_KEYS, bad);
177
212
  if (typeof sessionId !== "string" || sessionId === "")
178
213
  return bad(`sessionId must be a non-empty string, got ${shownValue(sessionId)}`);
179
214
  if (model === undefined)
@@ -191,7 +226,9 @@ function screenCompactSessionRequest(request) {
191
226
  compaction: compaction === undefined ? undefined : screenSettings(compaction, bad),
192
227
  compactionModel: compactionModel,
193
228
  getApiKeyAndHeaders: getApiKeyAndHeaders,
229
+ checkpointStore: checkpointStore,
194
230
  signal,
231
+ expect: readOccupantExpectation(expect, bad),
195
232
  };
196
233
  }
197
234
  function screenSettings(raw, bad) {
@@ -214,6 +251,39 @@ function screenSettings(raw, bad) {
214
251
  ...(clampTolerance !== undefined ? { clampTolerance: clampTolerance } : {}),
215
252
  };
216
253
  }
254
+ async function refuseParkedSession(store, sessionId, whose) {
255
+ if (store === undefined)
256
+ return;
257
+ const parked = (why, cause) => {
258
+ const e = new Error(`${VERB}: ${why} — a parked session's resume rewinds its branch to the checkpoint's leaf, where a summary written now would not be read, so nothing was compacted; decide the checkpoint (resume it) or expire it, then compact`, cause !== undefined ? { cause } : undefined);
259
+ e.code = "compact.session_parked";
260
+ throw e;
261
+ };
262
+ if (typeof store.listBySession !== "function")
263
+ return parked(`${whose} checkpoint store has no listBySession, so it cannot say whether session "${sessionId}" is parked at a checkpoint`);
264
+ let answer;
265
+ try {
266
+ answer = await store.listBySession({ sessionId, status: "pending", limit: 1 });
267
+ }
268
+ catch (err) {
269
+ return parked(`${whose} checkpoint store could not say whether session "${sessionId}" is parked at a checkpoint (listBySession failed: ${egressThrownText("same-principal", err)})`, err);
270
+ }
271
+ const unanswered = (what) => parked(`${whose} checkpoint store answered ${what}, so it cannot say whether session "${sessionId}" is parked at a checkpoint`, new Error(`listBySession answered ${what}`));
272
+ const rows = readElements(readMember(answer, "rows"));
273
+ if (rows === undefined)
274
+ return unanswered("without a list of rows");
275
+ if (rows.length === 0)
276
+ return;
277
+ const row = rows[0];
278
+ const kind = readMember(row, "kind");
279
+ const checkpoint = kind === "row" ? readMember(row, "checkpoint") : undefined;
280
+ const token = kind === "row" ? readMember(checkpoint, "token") : kind === "unreadable" ? readMember(row, "token") : undefined;
281
+ if (typeof token !== "string" || token === "")
282
+ return unanswered("a first row that is no checkpoint row with a token");
283
+ const id = readMember(checkpoint, "checkpointId");
284
+ const named = typeof id === "string" && id.trim() !== "" ? `checkpoint "${inlineUntrusted(id, 64)}"` : "a checkpoint";
285
+ return parked(`session "${sessionId}" is parked at ${named}, which is pending`);
286
+ }
217
287
  function sessionBusyRefusal(sessionId) {
218
288
  const e = new Error(`${VERB}: a task is running or queued on session "${sessionId}" in this Runner, or a write one of its tasks issued has not settled — compacting it now would rewrite the transcript under that work, so nothing was compacted; a running task takes the request through its own stream (TaskStream.compact), otherwise retry once it has ended and its writes have settled`);
219
289
  e.code = "compact.session_busy";
@@ -32,35 +32,6 @@ import { type CompactionSettings } from "../../internal/harness.js";
32
32
  * task has no hands (no `compactionRestore` ⇒ nothing can be re-read).
33
33
  */
34
34
  export declare function buildWorkingFileAttachments(spec: TaskSpec, prepared: Prepared): MaybeCompactOptions["workingFileAttachments"];
35
- /**
36
- * `MaybeCompactOptions.contextInstructionFiles`: the deployment's instruction-file content (the CLAUDE.md
37
- * family) delivered to the SUMMARIZER, assembled once here and spread on all three lanes — the compaction
38
- * boundary is where the summary REPLACES the transcript that carried those instructions.
39
- *
40
- * Contract:
41
- * - Bytes = `Prepared.projectInstructionContent`, the RAW loader text captured under the same non-blank
42
- * predicate that composes the project layer. Not the assembled `memoryBlock` (model-authored in-band
43
- * bytes would gain an instructing envelope), not the COMPOSED project block (`contextInstructionFilesSection`
44
- * neutralizes the whole authority family, `user_memory`/`scope` included), not `instructionSources`
45
- * (path + hash only). Raw text in, one fence at the mint.
46
- * - Provenance: REPOSITORY-CONTROLLED text delivered through a host callback — delivery is not authorship;
47
- * the mint's neutralization stops tag breakout, not a sentence asking for an omission. Two no-code exits
48
- * for a deployment that does not want it: do not wire the loader, or return vouched content. A separate
49
- * deployment-vouched summarization-instructions seat is an open design candidate, not built here.
50
- * - Both summary forms, no per-form split: fork eligibility is decided per pass inside maybeCompact, and the
51
- * form NOT covered by a `compModel`-gated split is exactly the fork that degrades mid-pass to the
52
- * independent form; the section rides the APPENDED instruction message, never the cached prefix.
53
- * - No new size knob: the bound is `fitContextInstructionFilesSection` (independent form only). Its three
54
- * known limits are accepted knowingly: a token-dense payload can pass a chars-domain fit and still overflow;
55
- * an unknown `contextWindow` leaves the section unbounded; the FORK form cannot fit and degrades ONCE. When
56
- * a limit bites the boundary FAILS (the section is a fixed request part the retry loop cannot drop) — the
57
- * task loses that compaction rather than sending a shorter one; making the section participate in the
58
- * retry loop is a library-face contract change, tracked there.
59
- * - Cost: instruction-file content + exactly 716 chars of framing on every summarization request, both
60
- * forms, once per pass (pinned in the REF-A2 suite). Deployments that never wired the loader pay nothing:
61
- * the key is ABSENT, so their requests are byte-identical to the pre-wiring shape.
62
- */
63
- export declare function contextInstructionFilesOption(prepared: Prepared): Partial<Pick<MaybeCompactOptions, "contextInstructionFiles">>;
64
35
  /**
65
36
  * The CC-form fork seam, assembled identically on all three lanes (REF-A2): the
66
37
  * summary request forks the main lane's latest real request (recorded by prepare-task's provider
@@ -164,5 +135,7 @@ export declare function legContextOverlayOption(prepared: Prepared, runner: Runn
164
135
  * for the boundary's own pass, the recovery pass and the end-of-task summary, `manualCompact` for a requested one —
165
136
  * keeps "who decides whether this pass runs" a single expression ({@link compactionEnabled}: the request authored the
166
137
  * seat > the deployment declared it > on). The two seats themselves do not ride the settings: the pass reads its gate.
138
+ * The reserve follows the same law ({@link compactionReserve}: the request's value > the overlay's for the leg's model > the
139
+ * engine default), and the disclosures that estimate the threshold read it through this function too.
167
140
  */
168
141
  export declare function legCompactionSettings(spec: Pick<TaskSpec, "compaction">, overlay: ContextWindowOverlay | undefined, seat: CompactionSeat): CompactionSettings;
@@ -1,6 +1,6 @@
1
1
  import { emitTrace } from "../trace.js";
2
2
  import { buildToolResultRef, OFFLOAD_TOOL_NAME, PERSISTED_OUTPUT_PREFIX, toolResultContentSegment, toolResultProvenanceOf, } from "../tool-result-store.js";
3
- import { compactionEnabled, contextOverlayFor } from "../context-settings.js";
3
+ import { compactionEnabled, compactionReserve, contextOverlayFor } from "../context-settings.js";
4
4
  import { DEFAULT_COMPACTION_SETTINGS } from "../../internal/harness.js";
5
5
  export function buildWorkingFileAttachments(spec, prepared) {
6
6
  if (spec.compaction?.attachWorkingFiles === false || !prepared.compactionRestore)
@@ -9,16 +9,9 @@ export function buildWorkingFileAttachments(spec, prepared) {
9
9
  ...prepared.compactionRestore,
10
10
  ...(prepared.recentlyReadFiles ? { recentlyReadFiles: prepared.recentlyReadFiles } : {}),
11
11
  ...(prepared.normalizeAttachmentPath ? { normalizePath: prepared.normalizeAttachmentPath } : {}),
12
- ...(prepared.isDedupStubResult ? { isDedupStubResult: prepared.isDedupStubResult } : {}),
13
- ...(prepared.instructionSources
14
- ? { instructionSourcePaths: prepared.instructionSources.filter((s) => s.contentHash !== null).map((s) => s.path) }
15
- : {}),
16
12
  ...(typeof spec.compaction?.attachWorkingFiles === "object" ? spec.compaction.attachWorkingFiles : undefined),
17
13
  };
18
14
  }
19
- export function contextInstructionFilesOption(prepared) {
20
- return prepared.projectInstructionContent !== undefined ? { contextInstructionFiles: prepared.projectInstructionContent } : {};
21
- }
22
15
  export function forkContextOption(prepared, disable) {
23
16
  return disable ? {} : { forkContext: prepared.lastBrainContext };
24
17
  }
@@ -123,5 +116,5 @@ export function legContextOverlayOption(prepared, runner) {
123
116
  }
124
117
  export function legCompactionSettings(spec, overlay, seat) {
125
118
  const { autoCompact: _auto, manualCompact: _manual, ...members } = spec.compaction ?? {};
126
- return { ...DEFAULT_COMPACTION_SETTINGS, ...members, enabled: compactionEnabled(seat, spec.compaction, overlay) };
119
+ return { ...DEFAULT_COMPACTION_SETTINGS, ...members, reserveTokens: compactionReserve(members.reserveTokens, overlay) ?? DEFAULT_COMPACTION_SETTINGS.reserveTokens, enabled: compactionEnabled(seat, spec.compaction, overlay) };
127
120
  }
@@ -1,6 +1,7 @@
1
1
  import type { MaybeCompactOptions } from "../auto-compaction.js";
2
2
  import { type PostureFacts } from "../auto-mode-directive.js";
3
3
  import type { Prepared } from "./contracts.js";
4
+ import { type InstructionEcho } from "./nested-memory-lane.js";
4
5
  /**
5
6
  * The facts the posture composition reads, as the leg IS now: the live effective mode and ask answer, the plan-exit
6
7
  * tool's presence on the minted roster, the minted delegation identity, and the session plan file the run admitted. The one place a leg's facts are assembled —
@@ -42,6 +43,13 @@ export declare function mintOutputStyleReminder(prepared: Pick<Prepared, "output
42
43
  /** Is a frame of this source already on its way to the next request (a pending receipt)? The one reading, for every
43
44
  * collector that could state it again: the boundary bundle, the direct-write style lane and the posture writer. */
44
45
  export declare function frameCarried(ledger: Prepared["frameReceipts"], source: Prepared["frameReceipts"]["pending"][number]["source"]): boolean;
46
+ /**
47
+ * Settle the receipts a landed message carries, in receipt order. A step that must read the session first (a changed-files notice's
48
+ * announcement) returns a promise: the steps behind it wait for it, and the one promise is handed back to the `message_end` handler
49
+ * (the harness awaits its listeners), so every announcement lands before the next listener reads the event. `undefined` when every
50
+ * step was synchronous.
51
+ */
52
+ export declare function settleFrameReceipts(settled: ReadonlyArray<Prepared["frameReceipts"]["pending"][number]>, entryId: string): Promise<void> | undefined;
45
53
  /**
46
54
  * The turn boundary's direct writes, for a boundary a request can follow: the owed posture, and the output style when
47
55
  * the turn's tool results do not go back as the next request (`turnOwesRequest` false) and queued input already
@@ -59,5 +67,13 @@ export declare function appendBoundaryFrames(prepared: Pick<Prepared, "approvalP
59
67
  * and never fails the landed compaction.
60
68
  */
61
69
  export declare function planFileRestateOption(prepared: Prepared): Pick<MaybeCompactOptions, "planFileRestate">;
62
- /** Every post-compaction restatement the turn boundary registers, at one spread site. */
63
- export declare function compactionRestateOptions(prepared: Prepared): Pick<MaybeCompactOptions, "gitRestate" | "postureRestate" | "planFileRestate" | "advisorRestate">;
70
+ /** The instruction files' compaction arm (`restateInstructionFiles`): a leg with the instruction-file lane writes what the
71
+ * compacted context owes — the task root's members first — before any reader of the new baseline. It keeps the posture's
72
+ * halt rule (a person's bare rejection halted the batch: nothing the engine says enters the transcript ahead of that
73
+ * person's next words; the next load owes the files again). */
74
+ export declare function instructionsRestateOption(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "instructionsRestate">;
75
+ /** Every post-compaction restatement the three compaction routes register, at one spread site, and the frames those
76
+ * restatements post again (`restatedFrames`: the floor the trigger's "window below overhead" judgment reads beside the
77
+ * prefix — the request core's engine frames, the one set the guard trim holds); `echo` is the run's echo of a restated
78
+ * instruction frame. */
79
+ export declare function compactionRestateOptions(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "gitRestate" | "instructionsRestate" | "postureRestate" | "planFileRestate" | "advisorRestate" | "languageRestate" | "restatedFrames">;