@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
@@ -2,13 +2,14 @@ import { compactionKindOf } from "../task-notification.js";
2
2
  import { planRejectionClears } from "../context-edit.js";
3
3
  import { rosterToolName } from "../tool-roster.js";
4
4
  import { landStaleResultClears } from "./prepare-context-lane.js";
5
- import { compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
5
+ import { compactionFailureCause, compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
6
6
  import { emitTrace } from "../trace.js";
7
7
  import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
8
8
  import { rebaseCadenceWindows } from "./turn-attachments.js";
9
- import { buildWorkingFileAttachments, centerAdoptionOption, contextInstructionFilesOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
9
+ import { buildWorkingFileAttachments, centerAdoptionOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
10
10
  import { compactionEnabled } from "../context-settings.js";
11
11
  import { compactionRestateOptions } from "./compaction-restate.js";
12
+ import { instructionEchoTo } from "./nested-memory-lane.js";
12
13
  import { COMPACTION_FREED_EPSILON, COMPACTION_REGROWTH_FACTOR, MAX_CONSECUTIVE_COMPACTION_FAILURES } from "./compaction-knobs.js";
13
14
  import { compactionHookOptions, recordCompactionReuse, seamCCompactionOptions } from "./compaction-seams.js";
14
15
  import { asThrownError } from "../thrown-value.js";
@@ -46,10 +47,9 @@ export function runRecoveryLanes(input) {
46
47
  ...(prepared.activeTools.size > 0 ? { activeTools: [...prepared.activeTools] } : {}),
47
48
  onInputTruncated: emitInputTruncated(rs.telemetry.tracer, rs.telemetry.taskId),
48
49
  workingFileAttachments: buildWorkingFileAttachments(spec, prepared),
49
- ...contextInstructionFilesOption(prepared),
50
50
  ...(prepared.onCompactionApplied ? { onApplied: prepared.onCompactionApplied } : {}),
51
51
  ...seamCCompactionOptions(runner, prepared),
52
- ...compactionRestateOptions(prepared),
52
+ ...compactionRestateOptions(prepared, instructionEchoTo(queue, ident, rs.attach)),
53
53
  ...windowSafetyOptions(prepared.harness.getModel()),
54
54
  ...compactionHookOptions(runner, prepared, "forced", passSignal),
55
55
  onStarted: passReport.onStarted,
@@ -68,7 +68,7 @@ export function runRecoveryLanes(input) {
68
68
  const pdDur = comp.durationMs;
69
69
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.phase_timings", version: 1, taskId: rs.telemetry.taskId, ...pd, durationMs: pdDur, ts: Date.now() }));
70
70
  }
71
- prepared.cacheBreakDetector?.notifyCompaction();
71
+ prepared.turnSnapshot?.declare({ cause: "compaction" });
72
72
  if (rs.attach.attachState !== undefined) {
73
73
  rs.attach.attachState.postCompactPending = true;
74
74
  rebaseCadenceWindows(rs.attach.attachState, rs.counters.cadenceTurns);
@@ -103,7 +103,8 @@ export function runRecoveryLanes(input) {
103
103
  }
104
104
  compactionBreaker.failures += 1;
105
105
  runner.deps.onError?.(asThrownError(err), { phase: "compaction", sessionId: prepared.sessionId });
106
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "forced", reason: compactionFailureReason(err), ...passReport.end, ...ident() });
106
+ const cause = compactionFailureCause(err);
107
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "forced", reason: compactionFailureReason(err), ...(cause !== undefined ? { cause } : {}), ...passReport.end, ...ident() });
107
108
  return false;
108
109
  }
109
110
  };
@@ -143,6 +144,7 @@ export function runRecoveryLanes(input) {
143
144
  landStaleResultClears({
144
145
  ledger: prepared.microCompact.ledger,
145
146
  cleared: plan.cleared,
147
+ seat: prepared.turnSnapshot,
146
148
  ...(prepared.readFileState !== undefined ? { readFileState: prepared.readFileState } : {}),
147
149
  });
148
150
  emitTrace(rs.telemetry.tracer, () => ({
@@ -4,6 +4,7 @@ import type { PushQueue } from "../push-queue.js";
4
4
  import type { SessionStore } from "../session.js";
5
5
  import { type CompactOutcome, type DelegationLifecycleEvent, type OwedUserInputAccount, type TaskEvent, type TaskResult, type TaskSpec } from "../types.js";
6
6
  import { type Stats } from "./assemble-result.js";
7
+ import type { MessageDisplay } from "../mods/message-display.js";
7
8
  import type { EndOfTaskCompaction, InstallingPhaseResult, ManualCompactRef, Prepared, ResumeRun, RunInternals, RunnerDepsSeat, RunState, SuspendReap, TaskIdRef } from "./contracts.js";
8
9
  export interface RunSettleAndTeardownInput {
9
10
  /** borrowed-readonly — the task spec: the hooks slot, the suggestion opt-in, the retain / forward flags, the task id. */
@@ -86,6 +87,9 @@ export interface RunSettleAndTeardownInput {
86
87
  runner: RunnerDepsSeat;
87
88
  /** borrowed-readonly — the session store: the resumed-terminal leg unpins the checkpoint's session through it. */
88
89
  sessions: SessionStore;
90
+ /** borrowed-readonly — the leg's display (a top-level leg's): waited on before anything settles — its windows are shown (or
91
+ * past their deadline) ahead of the result, the `done` frame and the close — and read for what it showed of the answer. */
92
+ display: MessageDisplay | undefined;
89
93
  }
90
94
  /** Nothing comes back: the result is published through `setResult`, the queue is closed, the teardown legs ran. */
91
95
  export interface RunSettleAndTeardownResult extends InstallingPhaseResult {
@@ -15,20 +15,27 @@ import { defaultTaskRegistry } from "../task-registry.js";
15
15
  import { emitTrace } from "../trace.js";
16
16
  import { deliverEngineNotice, parentLegIds, settleOwedUserInput } from "../types.js";
17
17
  import { assembleResult } from "./assemble-result.js";
18
- import { discloseUnconsumedHalt } from "./halt-attribution.js";
18
+ import { discloseUnconsumedEndings } from "./halt-attribution.js";
19
19
  import { forwardSafely } from "./forward-sink.js";
20
20
  import { TIMER_LATENESS_REPORT_MS } from "./clock-and-limits.js";
21
21
  import { resumeDecisionWasNegative } from "./decide-continuation.js";
22
22
  import { drainForwardedFramesBeforeDone, forwardsSubagentEvents } from "./prepare-run-refs.js";
23
23
  import { generatePromptSuggestions } from "./prompt-suggestions.js";
24
- import { settleTeardownLeg } from "./teardown-bounded.js";
24
+ import { TeardownLegTimeoutError, raceTeardownLeg, settleTeardownLeg, teardownLegBudget } from "./teardown-bounded.js";
25
25
  import { owedDateAnchor } from "./conversation-segment.js";
26
26
  import { autoRunConsolidationFromRecommendation, autoRunOnRecommendationEffective, scopeHasUnconsumedRecommendation } from "./memory-consolidation-driver.js";
27
27
  import { amendTerminal, terminalProjection } from "./terminal-projection.js";
28
28
  import { mintCompactedEvent } from "../auto-compaction.js";
29
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
30
+ import { cacheHitExclusionsOf, cacheHitOperandsOf, mainCacheLaneComplete } from "./cache-hit-account.js";
31
+ import { humanReviewSnapshot } from "./park-commit.js";
32
+ import { projectRequestCopies } from "../request-copy-projection.js";
29
33
  export async function runSettleAndTeardown(input) {
30
- const { spec, queue, prepared, resume, internals, rs, stats, ident, loopLatch, timeout, ownCommittedTailRef, emitDelegationLifecycle, taskIdRef, manualCompactRef, drainManualCompact, final, threw, abortedLive, userInterruptedLive, answerSettled, strandedHumanAnswers, reasoningResolution, comp, compactionBreaker, owedUserInput, setResult, onSuggestions, onSuspend, runner, sessions } = input;
34
+ const { spec, queue, prepared, resume, internals, rs, stats, ident, loopLatch, timeout, ownCommittedTailRef, emitDelegationLifecycle, taskIdRef, manualCompactRef, drainManualCompact, final, threw, abortedLive, userInterruptedLive, answerSettled, strandedHumanAnswers, reasoningResolution, comp, compactionBreaker, owedUserInput, setResult, onSuggestions, onSuspend, runner, sessions, display } = input;
31
35
  try {
36
+ const shown = display?.settled();
37
+ if (shown !== undefined)
38
+ await shown;
32
39
  if (comp?.compacted) {
33
40
  queue.push(mintCompactedEvent(comp, "auto", ident()));
34
41
  if (comp.phaseDurations !== undefined && comp.durationMs !== undefined) {
@@ -36,7 +43,7 @@ export async function runSettleAndTeardown(input) {
36
43
  const pdDur = comp.durationMs;
37
44
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.phase_timings", version: 1, taskId: rs.telemetry.taskId, ...pd, durationMs: pdDur, ts: Date.now() }));
38
45
  }
39
- prepared.cacheBreakDetector?.notifyCompaction();
46
+ prepared.turnSnapshot?.declare({ cause: "compaction" });
40
47
  }
41
48
  if (prepared.nestedStats.tasks > 0) {
42
49
  stats.nested = {
@@ -46,20 +53,24 @@ export async function runSettleAndTeardown(input) {
46
53
  ...(prepared.nestedStats.anyUnpriced ? {} : { costMicroUsd: prepared.nestedStats.costMicroUsd }),
47
54
  };
48
55
  }
49
- if (stats.totalInputTokens > 0) {
50
- const rawHit = stats.cachedTokens / stats.totalInputTokens;
56
+ const cacheExcludes = cacheHitExclusionsOf(stats.cacheLanes);
57
+ if (cacheExcludes.length > 0)
58
+ stats.cacheHitRateExcludes = cacheExcludes;
59
+ const cacheOperands = cacheHitOperandsOf(stats, cacheExcludes);
60
+ if (cacheOperands.totalInputTokens > 0) {
61
+ const rawHit = cacheOperands.cachedTokens / cacheOperands.totalInputTokens;
51
62
  if (stats.cachedTokens > stats.totalInputTokens) {
52
63
  runner.deps.onError?.(new Error(`prompt-cache: usage/api mismatch — cachedTokens (${stats.cachedTokens}) > totalInputTokens (${stats.totalInputTokens}); the cache family is likely wrong. Does model.api match the brain serving it? Override with model.params.promptCacheFamily = "input-includes-cached" | "input-excludes-cached".`), { phase: "prompt-cache", sessionId: prepared.sessionId });
53
64
  }
54
65
  stats.cacheHitRate = Math.min(1, rawHit);
55
- if (!rs.telemetry.cacheBreakReported && stats.turns >= 2 && stats.totalInputTokens >= 8000 && stats.cacheHitRate < 0.15) {
56
- const cacheWritten = stats.cacheWriteTokens + stats.cacheWriteTokensLong;
66
+ if (!rs.telemetry.cacheBreakReported && mainCacheLaneComplete(stats.cacheLanes) && stats.turns >= 2 && cacheOperands.totalInputTokens >= 8000 && stats.cacheHitRate < 0.15) {
67
+ const cacheWritten = stats.cacheWriteTokens;
57
68
  const cause = rs.degrade.degraded
58
69
  ? `a mid-task model switch (${rs.degrade.degraded.from} → ${rs.degrade.degraded.to}, degradation) reset the prefix cache — this is the likely cause`
59
70
  : cacheWritten > 0
60
71
  ? `this task reported ${cacheWritten} cache-write tokens across its calls (compaction and the classifier's included) but served almost none back as reads — consistent with a prompt prefix that CHANGES between turns (client-side: volatile content up front, or per-turn tool churn/reorder) and, less often, with server-side eviction. Keep volatile content (memory/timestamps/ids) out of the prefix and the tool list stable in membership AND order`
61
72
  : `no call in this task reported any cache-write tokens — and this API family may not report them at all (an openai-shaped usage row carries cached READS only), so the write side is no evidence here; check that the prompt prefix (system prompt + tool list, membership AND order) is byte-stable across turns and that this route caches this model`;
62
- runner.deps.onError?.(new Error(`prompt-cache: low prefix-cache hit rate ${(stats.cacheHitRate * 100).toFixed(0)}% over ${stats.turns} turns (${stats.totalInputTokens} prompt tokens) — ${cause}. See design/09.`), { phase: "prompt-cache", sessionId: prepared.sessionId });
73
+ runner.deps.onError?.(new Error(`prompt-cache: low prefix-cache hit rate ${(stats.cacheHitRate * 100).toFixed(0)}% over ${stats.turns} turns (${cacheOperands.totalInputTokens} prompt tokens${cacheExcludes.length > 0 ? `; the ${cacheExcludes.map((e) => e.lane).join(" / ")} calls are left out — they did not report the cache counts` : ""}) — ${cause}. See design/09.`), { phase: "prompt-cache", sessionId: prepared.sessionId });
63
74
  }
64
75
  }
65
76
  if (prepared.resourceLedger &&
@@ -68,13 +79,7 @@ export async function runSettleAndTeardown(input) {
68
79
  stats.tokens += prepared.resourceLedger.spentTokens;
69
80
  stats.turns += prepared.resourceLedger.spentTurns;
70
81
  }
71
- if (prepared.humanReviewRef.count > 0) {
72
- stats.humanReview = {
73
- count: prepared.humanReviewRef.count,
74
- totalWaitMs: prepared.humanReviewRef.totalWaitMs,
75
- gates: [...prepared.humanReviewRef.gates],
76
- };
77
- }
82
+ stats.humanReview = humanReviewSnapshot(prepared.humanReviewRef);
78
83
  const reminderDisclosuresActive = Object.keys(prepared.reminderDisclosureCounts).length > 0;
79
84
  if (rs.counters.finalVerifyInjections > 0 || rs.attach.attachmentsInjected > 0 || rs.counters.repetitionCuts > 0 || rs.counters.repetitionSpared > 0 || rs.counters.approachNoticesSent > 0 || reminderDisclosuresActive) {
80
85
  stats.mechanisms = {
@@ -87,6 +92,8 @@ export async function runSettleAndTeardown(input) {
87
92
  ...(reminderDisclosuresActive ? { reminderDisclosures: { ...prepared.reminderDisclosureCounts } } : {}),
88
93
  };
89
94
  }
95
+ const answerEntryIds = prepared.harness.answerEntryIdsOf(final);
96
+ const displayed = display?.displayedOf(answerEntryIds);
90
97
  const result = assembleResult(prepared, final, stats, {
91
98
  threw,
92
99
  runId: prepared.runId,
@@ -96,7 +103,9 @@ export async function runSettleAndTeardown(input) {
96
103
  editedFiles: prepared.editedFilesSnapshot(),
97
104
  haltedOnUserRejection: prepared.batchHaltRef.current !== undefined,
98
105
  haltConsumption: prepared.harness.haltConsumption(),
99
- answerEntryIds: prepared.harness.answerEntryIdsOf(final),
106
+ answerEntryIds,
107
+ intake: taskIdRef?.intake,
108
+ ...(displayed !== undefined ? { displayed } : {}),
100
109
  strandedHumanAnswers,
101
110
  remoteEnvFailures: prepared.remoteEnvFailures,
102
111
  effectiveReadFace: prepared.effectiveReadFace,
@@ -116,7 +125,7 @@ export async function runSettleAndTeardown(input) {
116
125
  blockedReason: prepared.blockedRef.reason,
117
126
  blockedDetail: prepared.blockedRef.detail,
118
127
  conflict: prepared.conflictRef.hit,
119
- gitCoreOverBudget: prepared.gitStatusRef.terminalCode === "irreducible_core_over_budget",
128
+ coreOverBudget: prepared.requestCoreRef.terminalCode === "irreducible_core_over_budget",
120
129
  outputInvalid: rs.degrade.outputInvalid,
121
130
  loopTerminal: prepared.loopTerminalRef.reason,
122
131
  suspendLoop: prepared.suspendLoopRef.hit,
@@ -131,11 +140,11 @@ export async function runSettleAndTeardown(input) {
131
140
  sessionId: prepared.sessionId,
132
141
  runId: rs.telemetry.runId,
133
142
  ...legNoticeTaskId(prepared),
134
- origin: userInterruptedLive ? "interrupt" : timeout.fired ? "walltime" : rs.limits.turnsExceeded ? "turns" : "signal",
143
+ origin: userInterruptedLive ? "interrupt" : timeout.fired ? "walltime" : rs.limits.turnsExceeded ? "turns" : rs.limits.budgetHit !== undefined ? "budget" : "signal",
135
144
  },
136
145
  });
137
146
  }
138
- discloseUnconsumedHalt({ accepted: loopLatch.userHalted, consumption: prepared.harness.haltConsumption(), onNotice: runner.deps.onNotice, sessionId: prepared.sessionId, runId: rs.telemetry.runId, taskId: prepared.taskId });
147
+ discloseUnconsumedEndings({ accepted: loopLatch.userHalted, consumption: prepared.harness.haltConsumption(), onNotice: runner.deps.onNotice, sessionId: prepared.sessionId, runId: rs.telemetry.runId, taskId: prepared.taskId });
139
148
  let rowReturned = false;
140
149
  if (resume !== undefined &&
141
150
  resume.pendingActionStarted !== true &&
@@ -143,7 +152,7 @@ export async function runSettleAndTeardown(input) {
143
152
  result.terminal.kind !== "paused" &&
144
153
  !(resumeDecisionWasNegative(resume) && resume.decisionDelivered === true)) {
145
154
  const reopenReason = reopenReasonOf(resumeStartupCauseOf(result.terminal.kind === "failed" ? result.terminal.code : undefined));
146
- const row = await compensateUnstarted(resume.reopenUnstarted, reopenReason);
155
+ const row = await compensateUnstarted(resume.reopenUnstarted, reopenReason, resume.claimedRowPending);
147
156
  rowReturned = row.kind === "reopened";
148
157
  amendTerminal(result, rowReturned ? "resume.reopened_unstarted" : "resume.reopen_failed_unstarted", row.kind, (m) => `${m ?? "the resume leg did not complete"} — ${unstartedRowSentence(row)}`);
149
158
  }
@@ -194,7 +203,7 @@ export async function runSettleAndTeardown(input) {
194
203
  taskIdRef.delegationTerminalOwed = undefined;
195
204
  if (rs.turn.completed !== undefined)
196
205
  await raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, undefined);
197
- const ending = raiseSessionEnd(prepared.modBus, prepared.hookIdentity, { reason: terminalFace.status, sessionId: prepared.sessionId });
206
+ const ending = raiseSessionEnd(prepared, prepared.hookIdentity, { reason: terminalFace.status, sessionId: prepared.sessionId });
198
207
  if (ending !== undefined)
199
208
  await ending;
200
209
  if (rs.degrade.degraded)
@@ -248,6 +257,8 @@ export async function runSettleAndTeardown(input) {
248
257
  ...(rs.counters.walltimeSyncBackstopFired ? { walltimeSyncBackstop: true } : {}),
249
258
  ts: Date.now(),
250
259
  }));
260
+ if (prepared.pausedRef.current !== undefined)
261
+ await yieldParkedLegBackground(prepared, runner);
251
262
  setResult(result);
252
263
  if (emitsChildRowFrames(prepared.hookIdentity) && result.terminal.kind !== "paused") {
253
264
  const terminalTick = {
@@ -282,7 +293,9 @@ export async function runSettleAndTeardown(input) {
282
293
  }
283
294
  finally {
284
295
  settleOwedUserInput(owedUserInput, !prepared.suspendProgressRef.executedApproved, { taskId: prepared.taskId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
285
- const writeDateAnchor = owedDateAnchor(prepared.session, prepared.dateChange, rs.attach.dateState);
296
+ const dateSeat = prepared.dateChange;
297
+ const dateState = rs.attach.dateState;
298
+ const writeDateAnchor = owedDateAnchor(prepared.session, prepared.prefixAnchor?.read ?? dateSeat?.anchor, dateSeat !== undefined && dateState !== undefined ? { legDate: dateSeat.legDate, announcedDate: dateState.announcedDate } : undefined, prepared.prefixAnchor?.head());
286
299
  if (writeDateAnchor !== undefined)
287
300
  await settleTeardownLeg(writeDateAnchor, "date anchor (settle leg)", (e) => runner.deps.onError?.(e, { phase: "degraded", sessionId: prepared.sessionId }));
288
301
  if (prepared.crossBoundary !== undefined)
@@ -322,6 +335,44 @@ export async function runSettleAndTeardown(input) {
322
335
  }
323
336
  return {};
324
337
  }
338
+ async function yieldParkedLegBackground(prepared, runner) {
339
+ const report = defaultTaskRegistry.yieldBackground(prepared.registryAccess, { skipSessionScoped: true, stopUnyieldable: "parent" });
340
+ if (report.yielding.length === 0 && report.notYieldable.length === 0)
341
+ return;
342
+ const disclose = (message) => {
343
+ try {
344
+ runner.deps.onError?.(new Error(message), { phase: "config", sessionId: prepared.sessionId });
345
+ }
346
+ catch {
347
+ }
348
+ };
349
+ if (report.notYieldable.length > 0) {
350
+ disclose(`this leg durably parked and stopped ${report.notYieldable.length} background agent(s) it owns that cannot yield: ` +
351
+ `${report.notYieldable.map((u) => `${u.id} (${u.reason})`).join(", ")} — they were not parked and do not continue with it.`);
352
+ }
353
+ const budgetMs = teardownLegBudget();
354
+ const drained = await raceTeardownLeg(() => report.drained(), "parked leg's background agents").catch((e) => {
355
+ if (e instanceof TeardownLegTimeoutError)
356
+ return undefined;
357
+ throw e;
358
+ });
359
+ if (drained !== undefined) {
360
+ if (drained.unpersisted.length > 0)
361
+ disclose(`the rows of ${drained.unpersisted.length} background agent(s) this parked leg yielded were not written (${drained.unpersisted.join(", ")}): the store refused the write; it is retried, and until it lands those rows read their previous state.`);
362
+ return;
363
+ }
364
+ const running = new Set(defaultTaskRegistry.liveTasks(prepared.registryAccess).filter((t) => t.status === "running").map((t) => t.task_id));
365
+ defaultTaskRegistry.abortBackgroundAgentsForOwner(prepared.registryAccess, { skipSessionScoped: true });
366
+ const unparked = report.yielding.filter((id) => running.has(id));
367
+ const unstopped = report.notYieldable.map((u) => u.id).filter((id) => running.has(id));
368
+ const named = [
369
+ unparked.length > 0 ? `${unparked.length} asked to park that had not (${unparked.join(", ")}) — now stopped as by their parent: they did not park with this leg and do not continue with it` : "",
370
+ unstopped.length > 0 ? `${unstopped.length} stopped whose current step has not answered the stop (${unstopped.join(", ")})` : "",
371
+ ].filter((s) => s !== "");
372
+ disclose(named.length > 0
373
+ ? `this leg durably parked and waited ${budgetMs}ms for the background agents it owns; it publishes its result without waiting for ${named.join("; and ")}. Each one's row settles when its current step returns — stopped, unless that step had already finished its run.`
374
+ : `this leg durably parked and waited ${budgetMs}ms for the rows of the background agents it owns to be written (${[...report.yielding, ...report.notYieldable.map((u) => u.id)].join(", ")}); it publishes its result without that confirmation: a row whose write has not landed reads its previous state until it does, and a resume of this leg before then does not continue that agent.`);
375
+ }
325
376
  const SUGGESTIONS_DEFAULT_COUNT = 3;
326
377
  const SUGGESTIONS_MAX_COUNT = 8;
327
378
  const SUGGESTIONS_TIMEOUT_MS = 30_000;
@@ -362,7 +413,7 @@ async function suggestNextPrompts(spec, prepared, result, runner) {
362
413
  }
363
414
  }
364
415
  if (!sameRouteIdentity(model, prepared.model)) {
365
- const verdict = await adjudicateDerivedRoute({ brain: runner.deps.brain, model, getApiKeyAndHeaders: spec.getApiKeyAndHeaders });
416
+ const verdict = await adjudicateDerivedRoute({ brain: modelLaneBrainOf(runner.deps), model, getApiKeyAndHeaders: spec.getApiKeyAndHeaders });
366
417
  if (verdict !== undefined && !verdict.ok) {
367
418
  deliverEngineNotice(runner.deps.onNotice, fallbackToPrimaryNotice({ seat: "prompt-suggestions", from: model.id, to: prepared.model.id, verdict, sessionId: prepared.sessionId, runId: prepared.runId }));
368
419
  model = prepared.model;
@@ -371,8 +422,8 @@ async function suggestNextPrompts(spec, prepared, result, runner) {
371
422
  }
372
423
  const pricing = runner.deps.pricing?.[model.id] ?? modelCostToPricing(model.cost);
373
424
  const ctx = await prepared.session.buildContext();
374
- const transcript = ctx.messages.filter((m) => !isSyntheticApiErrorMessage(m)).slice(-SUGGESTIONS_TRANSCRIPT_MESSAGES);
375
- const out = await generatePromptSuggestions({ brain: runner.deps.brain, model, pricing, thinking, getApiKeyAndHeaders: spec.getApiKeyAndHeaders, signal: ac.signal }, transcript, count);
425
+ const transcript = projectRequestCopies(ctx.messages.filter((m) => !isSyntheticApiErrorMessage(m)).slice(-SUGGESTIONS_TRANSCRIPT_MESSAGES));
426
+ const out = await generatePromptSuggestions({ brain: modelLaneBrainOf(runner.deps), model, pricing, thinking, getApiKeyAndHeaders: spec.getApiKeyAndHeaders, signal: ac.signal }, transcript, count);
376
427
  if (out.tokens > 0 || out.costMicroUsd > 0) {
377
428
  result.stats.suggestions = { tokens: out.tokens, costMicroUsd: out.costMicroUsd };
378
429
  if (result.stats.costBreakdown) {
@@ -1,7 +1,11 @@
1
1
  import { openSystemReminder } from "../reminder-mint.js";
2
2
  import { formatHookFeedback } from "../hooks.js";
3
- import { classicEventBase, dispatchClassic, legEventsOf, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
3
+ import { deliverEngineNotice } from "../engine-notice.js";
4
+ import { inlineUntrusted } from "../untrusted-text.js";
5
+ import { classicEventBase, dispatchClassic, legEventsOf, stringMembersAnswer } from "../mods/stations.js";
6
+ import { STOP_ANSWER_MEMBERS, mergeStopAnswers, readStopAnswer, stopAnswerDecides } from "../mods/stop-answers.js";
4
7
  import { steeringPreview } from "./steering-preview.js";
8
+ import { taskAxisCrossed } from "./clock-and-limits.js";
5
9
  import { asThrownError } from "../thrown-value.js";
6
10
  const STOP_HOOK_BLOCK_CAP = 8;
7
11
  export function runStopAndFinalVerify(input) {
@@ -28,7 +32,7 @@ export function runStopAndFinalVerify(input) {
28
32
  const owed = spec.oneShot === true ? deliveryObligations : undefined;
29
33
  if (stopArmed || finalVerificationOn || owed !== undefined) {
30
34
  let consecutiveBlocks = 0;
31
- const ending = () => prepared.abortController.signal.aborted || prepared.pausedRef.current !== undefined || prepared.batchHaltRef.current !== undefined;
35
+ const ending = () => prepared.abortController.signal.aborted || prepared.pausedRef.current !== undefined || prepared.batchHaltRef.current !== undefined || taskAxisCrossed(rs.limits, walltimeMonotonicDeadline);
32
36
  prepared.harness.setStopGate(async () => {
33
37
  if (ending())
34
38
  return [];
@@ -113,23 +117,29 @@ export function runStopAndFinalVerify(input) {
113
117
  }
114
118
  if (!stopArmed)
115
119
  return [];
116
- const outcome = await dispatchClassic(prepared.modBus, stopEvent, {
120
+ const e = {
117
121
  ...classicEventBase(prepared.hookIdentity, prepared.permissionMode.observed),
118
122
  stopHookActive: consecutiveBlocks > 0,
119
123
  consecutiveBlocks,
120
124
  getBranch: () => prepared.session.getBranch(),
121
125
  backgroundTasks: () => prepared.listBackgroundTasks(),
122
- }, { signal: prepared.abortController.signal, checkAnswer: stringMembersAnswer(stopEvent, ["block", "additionalContext"]) }).catch((err) => {
123
- runner.deps.onError?.(asThrownError(err), { phase: "hook", sessionId: prepared.sessionId });
124
- return undefined;
125
- });
126
- if (outcome?.kind !== "answered") {
126
+ };
127
+ const task = await seatPass("task", e);
128
+ if (task === "aborted")
129
+ return [];
130
+ const deployment = await seatPass("deployment", e);
131
+ if (deployment === "aborted" || prepared.abortController.signal.aborted)
132
+ return [];
133
+ const deploymentDecides = deployment !== undefined && stopAnswerDecides(deployment.answer);
134
+ const result = mergeStopAnswers(deployment?.answer, deploymentDecides ? undefined : task?.answer);
135
+ if (result.end !== undefined) {
136
+ const by = deploymentDecides ? deployment : task;
137
+ announceStopEnded(deploymentDecides ? "deployment" : "task", by?.answeredBy, result.end);
127
138
  consecutiveBlocks = 0;
128
139
  return [];
129
140
  }
130
- const result = stringMembersOf(outcome.answer, ["block", "additionalContext"]);
131
141
  const messages = [];
132
- if (result?.additionalContext) {
142
+ if (result.additionalContext) {
133
143
  messages.push({
134
144
  role: "user",
135
145
  engineMinted: true,
@@ -137,7 +147,7 @@ export function runStopAndFinalVerify(input) {
137
147
  timestamp: Date.now(),
138
148
  });
139
149
  }
140
- if (messages.length === 0 && !result?.block) {
150
+ if (messages.length === 0 && !result.block) {
141
151
  consecutiveBlocks = 0;
142
152
  return messages;
143
153
  }
@@ -149,7 +159,7 @@ export function runStopAndFinalVerify(input) {
149
159
  `Check ctx.stopHookActive in the hook and return success while it's true.`), { phase: "hook", sessionId: prepared.sessionId });
150
160
  return [];
151
161
  }
152
- if (result?.block) {
162
+ if (result.block) {
153
163
  messages.push({
154
164
  role: "user",
155
165
  engineMinted: true,
@@ -159,6 +169,30 @@ export function runStopAndFinalVerify(input) {
159
169
  }
160
170
  return messages;
161
171
  }
172
+ async function seatPass(seat, e) {
173
+ const outcome = await dispatchClassic(prepared.modBus, stopEvent, e, {
174
+ signal: prepared.abortController.signal,
175
+ checkAnswer: stringMembersAnswer(stopEvent, STOP_ANSWER_MEMBERS),
176
+ participant: (p) => p.seat === seat,
177
+ }).catch((err) => {
178
+ runner.deps.onError?.(asThrownError(err), { phase: "hook", sessionId: prepared.sessionId });
179
+ return undefined;
180
+ });
181
+ if (outcome === undefined || outcome.kind === "failed")
182
+ return undefined;
183
+ if (outcome.kind === "aborted")
184
+ return "aborted";
185
+ return { answer: readStopAnswer(outcome.answer), answeredBy: outcome.answeredBy };
186
+ }
187
+ function announceStopEnded(seat, registration, reason) {
188
+ const said = reason.trim().length > 0 ? inlineUntrusted(reason) : undefined;
189
+ const who = registration !== undefined ? `extension "${registration}"` : "an extension";
190
+ deliverEngineNotice(runner.deps.onNotice, {
191
+ code: "mods.stop_ended",
192
+ message: `${who} on the ${seat} seat answered end on ${stopEvent}: the run is not pushed back to continue from this stop point${said !== undefined ? ` — ${said}` : ""}`,
193
+ detail: { event: stopEvent, ...(registration !== undefined ? { registration } : {}), seat, ...(said !== undefined ? { reason: said } : {}), ...prepared.legNotice.route.address, runId: prepared.runId },
194
+ }, prepared.legNotice.admission);
195
+ }
162
196
  }
163
197
  return {};
164
198
  }
@@ -6,6 +6,7 @@ import { emitTrace } from "../trace.js";
6
6
  import { resolveMaxTurns } from "./clock-and-limits.js";
7
7
  import { resolveOutputRetries } from "./synthetic-tools.js";
8
8
  import { cacheFamilyOf } from "./usage-accounting.js";
9
+ import { createModelFallbackSeat } from "./model-fallback-seat.js";
9
10
  import { asThrownError } from "../thrown-value.js";
10
11
  export function runTelemetryAndBudgetSeats(input) {
11
12
  const { spec, prepared, resume, stats, taskIdRef, entryTracer, modelCatalog, runSourceTaskId, rs, runner, sessions } = input;
@@ -35,6 +36,7 @@ export function runTelemetryAndBudgetSeats(input) {
35
36
  if (resume !== undefined && resume.outcome.gate === "plan_review" && resume.outcome.decision === "reject") {
36
37
  void prepared.permissionMode.steer("plan");
37
38
  }
39
+ rs.telemetry.requestedModel = prepared.model;
38
40
  rs.telemetry.cacheFamily = cacheFamilyOf(prepared.model);
39
41
  rs.telemetry.pricing = runner.deps.pricing?.[prepared.model.id] ?? modelCostToPricing(prepared.model.cost);
40
42
  rs.telemetry.pricingConfigured = isModelPriced(prepared.model, runner.deps.pricing);
@@ -84,39 +86,21 @@ export function runTelemetryAndBudgetSeats(input) {
84
86
  if (malformedPricingField(p) !== undefined)
85
87
  rs.telemetry.unpricedSpend = true;
86
88
  };
87
- rs.degrade.recordDegraded = (info, toModel) => {
89
+ rs.degrade.priceOf = (model) => {
90
+ if (model === rs.telemetry.requestedModel)
91
+ return { pricing: rs.telemetry.pricing, pricingConfigured: rs.telemetry.pricingConfigured, cacheFamily: rs.telemetry.cacheFamily };
92
+ const pricing = runner.deps.pricing?.[model.id] ?? modelCostToPricing(model.cost);
93
+ noteUnevaluablePriceTable(pricing);
94
+ return { pricing, pricingConfigured: isModelPriced(model, runner.deps.pricing), cacheFamily: cacheFamilyOf(model) };
95
+ };
96
+ rs.degrade.fallbackSeat = createModelFallbackSeat(runner.deps.onNotice, { sessionId: prepared.sessionId, runId: prepared.runId });
97
+ rs.degrade.recordDegraded = (info) => {
88
98
  if (rs.degrade.degraded !== undefined)
89
99
  return;
90
- let m = toModel;
91
- if (!m) {
92
- try {
93
- m = resolveModel(info.to, modelCatalog);
94
- }
95
- catch {
96
- m = undefined;
97
- }
98
- }
99
- if (m) {
100
- rs.telemetry.pricing = runner.deps.pricing?.[m.id] ?? modelCostToPricing(m.cost);
101
- rs.telemetry.pricingConfigured = isModelPriced(m, runner.deps.pricing);
102
- noteUnevaluablePriceTable(rs.telemetry.pricing);
103
- rs.telemetry.cacheFamily = cacheFamilyOf(m);
104
- }
105
- else {
106
- if (runner.deps.pricing?.[info.to]) {
107
- rs.telemetry.pricing = runner.deps.pricing[info.to];
108
- rs.telemetry.pricingConfigured = true;
109
- noteUnevaluablePriceTable(rs.telemetry.pricing);
110
- }
111
- else {
112
- rs.telemetry.pricingConfigured = false;
113
- }
114
- rs.telemetry.cacheFamily = "input-excludes-cached";
115
- }
116
100
  rs.degrade.degraded = info;
117
101
  emitTrace(rs.telemetry.tracer, () => ({ kind: "task.degraded", version: 1, taskId: rs.telemetry.taskId, from: info.from, to: info.to, reason: info.reason, atTurn: info.atTurn, ts: Date.now() }));
118
102
  try {
119
- runner.deps.onError?.(new Error(`degraded to a cheaper model: ${info.from} → ${info.to} (${info.reason}) at turn ${info.atTurn}`), { phase: "degraded", sessionId: prepared.sessionId });
103
+ runner.deps.onError?.(new Error(`switched models: ${info.from} → ${info.to} (${info.reason}) at turn ${info.atTurn}`), { phase: "degraded", sessionId: prepared.sessionId });
120
104
  }
121
105
  catch {
122
106
  }
@@ -161,6 +145,7 @@ export function runTelemetryAndBudgetSeats(input) {
161
145
  return undefined;
162
146
  };
163
147
  rs.turn.turnUsageMissing = false;
148
+ rs.turn.turnCacheMarks = {};
164
149
  rs.counters.repetitionCuts = 0;
165
150
  rs.counters.repetitionSpared = 0;
166
151
  rs.counters.repetitionEvents = [];
@@ -21,7 +21,7 @@ import type { SessionStore } from "../session.js";
21
21
  import type { PushQueue } from "../push-queue.js";
22
22
  import { type Brain, type HeldUserInputs, type OwedUserInputAccount, type TaskEvent, type TaskSpec } from "../types.js";
23
23
  import { type Stats } from "./assemble-result.js";
24
- import type { EndOfTaskCompaction, Prepared, RunnerDepsSeat, RunState } from "./contracts.js";
24
+ import type { EmitCommitted, EndOfTaskCompaction, Prepared, RunnerDepsSeat, RunState } from "./contracts.js";
25
25
  import type { CallerStopGate } from "./caller-stop-gate.js";
26
26
  export interface RunTerminalAdoptionInput<R> {
27
27
  /** borrowed-readonly — the task spec: the task id the account's notices name; `finish`'s first argument (the end-of-task pass below). */
@@ -42,7 +42,7 @@ export interface RunTerminalAdoptionInput<R> {
42
42
  sourceTaskId?: string;
43
43
  };
44
44
  /** borrowed-readonly — the `message_committed` mint (the reconcile's appended toolResults, the marker). */
45
- emitCommitted: (entryId: string, role: "user" | "assistant" | "toolResult", toolCallId?: string) => void;
45
+ emitCommitted: EmitCommitted;
46
46
  /** borrowed-readonly — the observed tool-start ids the reconcile splits orphans by (EMPTIED by the reconcile's commit). */
47
47
  startedToolCallIds: Set<string>;
48
48
  /** borrowed-readonly — the label map the synthetic `tool_end` frames carry. */
@@ -1,18 +1,20 @@
1
- import { compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, maybeCompact } from "../auto-compaction.js";
1
+ import { compactionFailureCause, compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, maybeCompact } from "../auto-compaction.js";
2
2
  import { eventDefaultOn } from "../../prompt-assembly/event-registry.js";
3
3
  import { appendInterruptionMarker, reconcileInterruptedSession } from "../session-reconcile.js";
4
4
  import { emitTrace } from "../trace.js";
5
5
  import { parkedInputIdsOf } from "../types.js";
6
6
  import { answerSettled } from "./assemble-result.js";
7
7
  import { errorCodeOf } from "./terminal-account.js";
8
- import { awaitChargeWithSlowDisclosure, discloseUnevaluableWindow } from "./clock-and-limits.js";
9
- import { buildWorkingFileAttachments, centerAdoptionOption, contextInstructionFilesOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
8
+ import { awaitChargeWithSlowDisclosure, discloseUnevaluableWindow, discloseWindowBelowOverhead } from "./clock-and-limits.js";
9
+ import { buildWorkingFileAttachments, centerAdoptionOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
10
10
  import { compactionHookOptions, recordCompactionReuse, seamCCompactionOptions } from "./compaction-seams.js";
11
11
  import { compactionRestateOptions } from "./compaction-restate.js";
12
+ import { instructionEchoTo } from "./nested-memory-lane.js";
12
13
  import { MAX_CONSECUTIVE_COMPACTION_FAILURES } from "./compaction-knobs.js";
13
14
  import { emitSettled, reconciledEnd } from "./tool-end-body.js";
14
15
  import { isApprovalWordsFrame } from "./approval-feedback.js";
15
16
  import { asThrownError } from "../thrown-value.js";
17
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
16
18
  export async function runTerminalAdoption(input) {
17
19
  const { spec, queue, prepared, rs, stats, ident, emitCommitted, startedToolCallIds, toolLabels, timeout, compactionBrain, compactionBreaker, windowSafetyOptions, undrainedUserAtEnd, userInputLostAtEnd, final, abortedLive, userInterruptedLive, callerStop, runner, sessions, next } = input;
18
20
  let { threw } = input;
@@ -77,7 +79,7 @@ export async function runTerminalAdoption(input) {
77
79
  if (interrupted && userInterruptedLive && reconcileComplete && !settled) {
78
80
  try {
79
81
  const entryId = await appendInterruptionMarker(prepared.session, { toolUseInFlight: orphansClosed > 0, admitRows: prepared.admitRows });
80
- emitCommitted(entryId, "user");
82
+ emitCommitted(entryId, "user", undefined, { origin: "interruption_marker" });
81
83
  }
82
84
  catch (markerErr) {
83
85
  runner.deps.onError?.(asThrownError(markerErr), {
@@ -146,7 +148,8 @@ export async function runTerminalAdoption(input) {
146
148
  brain: compactionBrain,
147
149
  windowSafety: windowSafetyOptions(prepared.harness.getModel()),
148
150
  passReport: compactionPassReport(queue, ident),
149
- onCompactionOutcome: (outcome, reason, end) => queue.push({ type: "compaction_outcome", outcome, trigger: "auto", reason, ...end, ...ident() }),
151
+ instructionEcho: instructionEchoTo(queue, ident, rs.attach),
152
+ onCompactionOutcome: (outcome, reason, end, cause) => queue.push({ type: "compaction_outcome", outcome, trigger: "auto", reason, ...(cause !== undefined ? { cause } : {}), ...end, ...ident() }),
150
153
  }, runner, sessions);
151
154
  return await next({ threw, comp, answerSettled: settled, owedUserInput });
152
155
  }
@@ -163,7 +166,7 @@ async function finish(spec, prepared, opts, runner, sessions) {
163
166
  ...legContextOverlayOption(prepared, runner),
164
167
  compactionModel: prepared.compModel,
165
168
  ...forkContextOption(prepared, false),
166
- brain: opts?.brain ?? runner.deps.brain,
169
+ brain: opts?.brain ?? modelLaneBrainOf(runner.deps),
167
170
  getApiKeyAndHeaders: spec.getApiKeyAndHeaders,
168
171
  thinking: prepared.thinking,
169
172
  settings: legCompactionSettings(spec, legContextOverlayOption(prepared, runner).contextOverlay, "autoCompact"),
@@ -176,16 +179,18 @@ async function finish(spec, prepared, opts, runner, sessions) {
176
179
  onInputTruncated: emitInputTruncated(opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, prepared.taskId),
177
180
  ...(opts?.windowSafety ?? {}),
178
181
  workingFileAttachments: buildWorkingFileAttachments(spec, prepared),
179
- ...contextInstructionFilesOption(prepared),
180
182
  ...(prepared.onCompactionApplied ? { onApplied: prepared.onCompactionApplied } : {}),
181
183
  ...seamCCompactionOptions(runner, prepared),
182
- ...compactionRestateOptions(prepared),
184
+ ...compactionRestateOptions(prepared, opts.instructionEcho),
183
185
  ...compactionHookOptions(runner, prepared, "auto", opts.callerStop.signal), onStarted: opts.passReport.onStarted,
184
186
  }, maybeCompact);
185
187
  recordCompactionReuse(runner, prepared, finishComp);
186
188
  if (finishComp.unevaluableWindow) {
187
189
  discloseUnevaluableWindow(finishComp.unevaluableWindow, prepared, opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, prepared.taskId, runner.deps.onError);
188
190
  }
191
+ if (finishComp.windowBelowOverhead) {
192
+ discloseWindowBelowOverhead(finishComp.windowBelowOverhead, prepared, runner.deps.onError, (reason) => opts?.onCompactionOutcome?.("disabled", reason, {}));
193
+ }
189
194
  comp = finishComp;
190
195
  }
191
196
  catch (err) {
@@ -209,7 +214,7 @@ async function finish(spec, prepared, opts, runner, sessions) {
209
214
  reason: failReason,
210
215
  ts: Date.now(),
211
216
  }));
212
- opts?.onCompactionOutcome?.("failed", failReason, opts.passReport.end);
217
+ opts?.onCompactionOutcome?.("failed", failReason, opts.passReport.end, compactionFailureCause(err));
213
218
  runner.deps.onError?.(err, { phase: "compaction", sessionId: prepared.sessionId });
214
219
  }
215
220
  }
@@ -47,14 +47,10 @@ export function runToolMountFacts(input) {
47
47
  ts: rs.telemetry.taskStart,
48
48
  };
49
49
  });
50
- if (prepared.turnSnapshot !== undefined) {
51
- prepared.turnSnapshot.onChange = (snap) => emitTrace(rs.telemetry.tracer, () => ({
52
- kind: "prompt.snapshot_changed",
53
- version: 1,
54
- taskId: rs.telemetry.taskId,
55
- snapshot: { cacheIdentity: snap.cacheIdentity, elements: { ...snap.elements } },
56
- ts: Date.now(),
57
- }));
58
- }
50
+ const snapshotChanged = (snap, change) => emitTrace(rs.telemetry.tracer, () => ({ kind: "prompt.snapshot_changed", version: 1, taskId: rs.telemetry.taskId, snapshot: { cacheIdentity: snap.cacheIdentity, elements: { ...snap.elements } }, ...change, ts: Date.now() }));
51
+ if (prepared.turnSnapshot?.legStart !== undefined)
52
+ snapshotChanged(prepared.turnSnapshot, prepared.turnSnapshot.legStart);
53
+ if (prepared.turnSnapshot !== undefined)
54
+ prepared.turnSnapshot.onChange = snapshotChanged;
59
55
  return { todoToolMounted, taskToolsMounted, writeFamilyOf, toolStartAt, startedToolCallIds };
60
56
  }
@@ -1,5 +1,5 @@
1
- import type { Model } from "../../internal/llm.js";
2
- import type { Stats } from "./assemble-result.js";
1
+ import type { AssistantMessage, Model } from "../../internal/llm.js";
2
+ import { type Stats } from "./assemble-result.js";
3
3
  import type { Prepared, RunState, TurnBoundaryDeps } from "./contracts.js";
4
4
  /**
5
5
  * What the driver hands the turn-boundary lane, once per leg. The four seats are the four positional
@@ -30,6 +30,7 @@ export interface RunTurnBoundaryResult {
30
30
  (event: {
31
31
  model: Model;
32
32
  continues: boolean;
33
+ message?: AssistantMessage;
33
34
  }): Promise<undefined>;
34
35
  }
35
36
  export declare function createTurnBoundary(input: RunTurnBoundaryInput): RunTurnBoundaryResult;