@sema-agent/core 7.59.0 → 7.61.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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,5 +1,6 @@
1
1
  export const AUTO_MODE_DEFAULT_TIMEOUT_MS = 180_000;
2
2
  export const AUTO_MODE_CLASSIFIER_MAX_RETRIES = 4;
3
+ export const AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT = 3;
3
4
  export const AUTO_MODE_RECORDED_ABSENT_TIMEOUT_MS = 15_000;
4
5
  export const AUTO_MODE_DEFAULT_WINDOW_MAX_ENTRIES = 40;
5
6
  export const AUTO_MODE_DEFAULT_WINDOW_MAX_CHARS = 2_000;
@@ -67,7 +67,8 @@ export type AutoModeRebuildResult = {
67
67
  * overrides / settings-deny rules / session context, plus the engine's cross-session lane rule when
68
68
  * the recipe says the arming leg spliced it), the transcript-window bounds and the round-trip
69
69
  * timeout — i.e. every input the ancestor's own `createAutoModeDecider` call had except the model leg.
70
- * A decider carries no state between rounds, so there is no ancestor state to reproduce or to withhold.
70
+ * The rebuilt decider is one rung, which never retires (the rate-limit memory only a rung with another behind it keeps), so it
71
+ * carries no state between rounds and there is no ancestor state to reproduce or to withhold.
71
72
  *
72
73
  * NOT reproduced: this build's PROMPT ASSETS are its own. The recipe records the deployment's
73
74
  * overrides, so the assembled prompt is checked against the digest the arming recorded — a fleet running
@@ -59,6 +59,12 @@ export declare function isAutoModeTimeoutMs(v: unknown): v is number;
59
59
  * refusal carrying `config.auto_mode_timeout_invalid`. There is no OFF spelling: the budget bounds how long a
60
60
  * permission gate waits, and a gate with no bound is not a setting this knob offers. */
61
61
  export declare function autoModeTimeoutMsOf(v: unknown): number;
62
+ /** Read the retirement knob (`RunnerDeps.autoMode.rateLimitBreakAfter` / `AutoModeDeciderOptions.rateLimitBreakAfter`):
63
+ * absent ⇒ {@link AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}; a safe integer of at least 1 ⇒ itself; ANYTHING ELSE
64
+ * (`0`, a negative, a fraction, NaN, ±Infinity, a string, an object) ⇒ a loud refusal carrying
65
+ * `config.auto_mode_rate_limit_break_invalid` — never clamped, never read as the default. There is no OFF
66
+ * spelling: a deployment that wants the seat asked for longer states a larger count. */
67
+ export declare function autoModeRateLimitBreakAfterOf(v: unknown): number;
62
68
  /** The classifier's verdict over one pending `ask`. Every arm may carry the classification's model
63
69
  * attribution ({@link AutoModeClassifierRound}), present iff the decider was wired with a candidate ladder. */
64
70
  export type AutoModeVerdict = ({
@@ -136,6 +142,15 @@ export declare const AUTO_MODE_ROUND_NOT_ASKED_CODE = "auto_mode.round_not_asked
136
142
  export declare function autoModeRoundNotAsked(reason: unknown): Error & {
137
143
  code: string;
138
144
  };
145
+ /**
146
+ * The word for "this rung's dispatch ended on the provider's RATE LIMIT" — an HTTP 429 that outlived the brain's own
147
+ * backoff ladder. A classify hook throws an error carrying this `code` (the same carrier as
148
+ * {@link AUTO_MODE_ROUND_NOT_ASKED_CODE}: a `code` on the thrown error, so any hook — including one this package never
149
+ * constructed — can raise it without importing a constructor). The decider reads it for one thing, the rung's
150
+ * RETIREMENT count (see the header's RATE-LIMIT RETIREMENT); the rung's verdict is the `unavailable` / `error` every
151
+ * leg failure already is.
152
+ */
153
+ export declare const AUTO_MODE_RUNG_RATE_LIMITED_CODE = "auto_mode.rung_rate_limited";
139
154
  /**
140
155
  * Why a rung did not settle the classification, or `undefined` when it SETTLED it and the ladder stops — the
141
156
  * ONE predicate behind the advance (there is no `if (fallback)` arm anywhere).
@@ -276,6 +291,13 @@ export interface AutoModeDeciderOptions<T = void> {
276
291
  * (`config.auto_mode_timeout_invalid`, {@link autoModeTimeoutMsOf}) — never clamped, never read as the
277
292
  * default, and there is no OFF: a permission gate always has a bound. */
278
293
  timeoutMs?: number;
294
+ /** How many CONSECUTIVE classifications must end on one rung's rate limit ({@link AUTO_MODE_RUNG_RATE_LIMITED_CODE})
295
+ * before that rung is not asked again for the rest of this decider's life — see the header's RATE-LIMIT
296
+ * RETIREMENT. Omitted ⇒ {@link AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}. A present value that is not a whole number
297
+ * of at least 1 is REFUSED at construction (`config.auto_mode_rate_limit_break_invalid`,
298
+ * {@link autoModeRateLimitBreakAfterOf}) — never clamped, never read as the default. Inert on a one-rung ladder:
299
+ * only a rung with a rung behind it retires. */
300
+ rateLimitBreakAfter?: number;
279
301
  /**
280
302
  * Fired once per `decide` call with the verdict the gate is about to act on and the wall time it waited
281
303
  * (`ms`, integer ≥ 0; a timed-out classification reads the deadline, one that walked two rungs the whole
@@ -302,6 +324,17 @@ export interface AutoModeClassified {
302
324
  /** The classification's model attribution, present exactly when the decider was wired with a candidate ladder
303
325
  * ({@link AutoModeClassifierRound}) — the same object the verdict carries. */
304
326
  classifier?: AutoModeClassifierRound;
327
+ /** One entry per rung this classification RETIRED — the classification whose rate-limited dispatch was a rung's
328
+ * `rateLimitBreakAfter`-th in a row, so each retired rung is reported on exactly one classification: which rung stopped
329
+ * being asked (`rung`, its model `model`), the model the walk reaches after it (`to`) and the count that tripped it
330
+ * (`consecutive`; always the configured bound). ABSENT on every other classification, including those that walk
331
+ * behind an already-retired rung. */
332
+ rateLimitBreaks?: readonly {
333
+ readonly rung: number;
334
+ readonly model: string;
335
+ readonly to: string;
336
+ readonly consecutive: number;
337
+ }[];
305
338
  }
306
339
  export interface AutoModeDecider {
307
340
  /** Never rejects. Any internal failure surfaces as `unavailable`/`parse_error` (fail-closed). */
@@ -311,9 +344,10 @@ export interface AutoModeDecider {
311
344
  * host implements by hand. */
312
345
  readonly timeoutMs?: number;
313
346
  }
314
- /** The per-run decider: timeout + fail-closed error mapping, nothing carried between rounds. One instance per
315
- * run (it binds the run's model leg and assembled prompt); a round that failed says nothing about the next,
316
- * which asks the model again. */
347
+ /** The per-run decider: timeout + fail-closed error mapping, and nothing carried between rounds but the rate-limit
348
+ * retirement of a rung that has another behind it. One instance per run (it binds the run's model leg and assembled
349
+ * prompt); a round that failed says nothing about the next, which asks the model again — a rung that was
350
+ * rate-limited `rateLimitBreakAfter` times in a row is the one exception. */
317
351
  export declare function createAutoModeDecider<T = void>(opts: AutoModeDeciderOptions<T>): AutoModeDecider;
318
352
  /** The deployment's bounds for the denial limit (`RunnerDeps.autoMode.denialLimit`). Every member
319
353
  * optional; an omitted member takes its CC default. A present member with a bad value is REFUSED
@@ -445,13 +479,14 @@ export interface AutoModeDenialTracker {
445
479
  };
446
480
  }
447
481
  export declare function autoModeDenialLimitOf(v: unknown): Required<AutoModeDenialLimitOptions>;
448
- /** The deployment face's three value knobs, read by their one readers — every leg's prepare runs it while
482
+ /** The deployment face's four value knobs, read by their one readers — every leg's prepare runs it while
449
483
  * `RunnerDeps.autoMode` is present, whatever mode the leg starts in, so a bad knob refuses the run before a steer or a
450
484
  * parent's live ceiling can reach an arming that would have refused it. */
451
485
  export declare function screenAutoModeKnobs(face: {
452
486
  readonly timeoutMs?: unknown;
453
487
  readonly classifierFallback?: unknown;
454
488
  readonly denialLimit?: unknown;
489
+ readonly rateLimitBreakAfter?: unknown;
455
490
  }): void;
456
491
  /** Build the per-run tracker over {@link autoModeDenialLimitOf}'s bounds (a bad knob refuses there). */
457
492
  export declare function createAutoModeDenialTracker(opts?: AutoModeDenialLimitOptions): AutoModeDenialTracker;
@@ -1,7 +1,9 @@
1
- import { AUTO_MODE_DEFAULT_TIMEOUT_MS, AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS, AUTO_MODE_DENIAL_LIMIT_DEFAULTS } from "./auto-mode-defaults.js";
1
+ import { AUTO_MODE_DEFAULT_TIMEOUT_MS, AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS, AUTO_MODE_DENIAL_LIMIT_DEFAULTS, AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT } from "./auto-mode-defaults.js";
2
+ import { withStatusSeat } from "../brain/status-sink.js";
2
3
  import { thrownIs } from "./thrown-value.js";
3
4
  import { describeRejectedValue } from "./tool-search-setting.js";
4
5
  import { isPlainRecord } from "./mods/kernel/receive.js";
6
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
5
7
  export const AUTO_MODE_UNAVAILABLE_CAUSES = Object.freeze(["error", "timeout"]);
6
8
  const AUTO_MODE_UNAVAILABLE_CAUSE_SET = new Set(AUTO_MODE_UNAVAILABLE_CAUSES);
7
9
  export function isAutoModeUnavailableCause(v) {
@@ -46,6 +48,16 @@ export function autoModeTimeoutMsOf(v) {
46
48
  e.code = "config.auto_mode_timeout_invalid";
47
49
  throw e;
48
50
  }
51
+ export function autoModeRateLimitBreakAfterOf(v) {
52
+ if (v === undefined)
53
+ return AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT;
54
+ if (typeof v === "number" && Number.isSafeInteger(v) && v >= 1)
55
+ return v;
56
+ const e = new Error(`RunnerDeps.autoMode.rateLimitBreakAfter must be a whole number of classifications, at least 1 ` +
57
+ `(got ${describeRejectedValue(v)}) — omit it for the default ${AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT}`);
58
+ e.code = "config.auto_mode_rate_limit_break_invalid";
59
+ throw e;
60
+ }
49
61
  export const AUTO_MODE_ROUND_NOT_ASKED_CODE = "auto_mode.round_not_asked";
50
62
  export function autoModeRoundNotAsked(reason) {
51
63
  let detail;
@@ -61,8 +73,15 @@ export function autoModeRoundNotAsked(reason) {
61
73
  return e;
62
74
  }
63
75
  function isAutoModeRoundNotAsked(e) {
76
+ return thrownCarriesCode(e, AUTO_MODE_ROUND_NOT_ASKED_CODE);
77
+ }
78
+ export const AUTO_MODE_RUNG_RATE_LIMITED_CODE = "auto_mode.rung_rate_limited";
79
+ function isAutoModeRungRateLimited(e) {
80
+ return thrownCarriesCode(e, AUTO_MODE_RUNG_RATE_LIMITED_CODE);
81
+ }
82
+ function thrownCarriesCode(e, code) {
64
83
  try {
65
- return typeof e === "object" && e !== null && e.code === AUTO_MODE_ROUND_NOT_ASKED_CODE;
84
+ return typeof e === "object" && e !== null && e.code === code;
66
85
  }
67
86
  catch {
68
87
  return false;
@@ -184,9 +203,12 @@ export function createAutoModeDecider(opts) {
184
203
  throw new Error(`AutoModeDeciderOptions.candidates[${bad}] must be a non-empty model id (got ${JSON.stringify(opts.candidates[bad])})`);
185
204
  }
186
205
  const ladder = opts.candidates ?? [undefined];
206
+ const rateLimitBreakAfter = autoModeRateLimitBreakAfterOf(opts.rateLimitBreakAfter);
207
+ const rateLimitStreak = new Map();
208
+ const retired = new Set();
187
209
  const decide = async (input, signal) => {
188
210
  const startedAt = performance.now();
189
- const round = {};
211
+ const round = { rateLimitBreaks: [] };
190
212
  const verdict = await decideUnreported(input, round, signal);
191
213
  if (opts.onClassified !== undefined) {
192
214
  try {
@@ -197,6 +219,7 @@ export function createAutoModeDecider(opts) {
197
219
  ...(verdict.kind === "unavailable" ? { cause: verdict.cause } : {}),
198
220
  ...(round.notAsked !== undefined ? { notAsked: round.notAsked } : {}),
199
221
  ...(verdict.classifier !== undefined ? { classifier: verdict.classifier } : {}),
222
+ ...(round.rateLimitBreaks.length > 0 ? { rateLimitBreaks: round.rateLimitBreaks } : {}),
200
223
  });
201
224
  }
202
225
  catch {
@@ -211,8 +234,14 @@ export function createAutoModeDecider(opts) {
211
234
  let i = 0;
212
235
  const assembled = await assembleRound(input, round, signal);
213
236
  for (; round.notAsked === undefined && i < ladder.length; i++) {
237
+ if (i < ladder.length - 1 && retired.has(i)) {
238
+ causes.push("error");
239
+ continue;
240
+ }
214
241
  const name = ladder[i];
215
- verdict = await askRung(input, signal, name !== undefined ? { index: i, model: name } : undefined, round, assembled);
242
+ const asked = await askRung(input, signal, name !== undefined ? { index: i, model: name } : undefined, round, assembled);
243
+ verdict = asked.verdict;
244
+ noteRungOutcome(i, asked.rateLimited, signal, round);
216
245
  const cause = rungDidNotRule(verdict);
217
246
  if (cause === undefined)
218
247
  break;
@@ -250,20 +279,41 @@ export function createAutoModeDecider(opts) {
250
279
  }
251
280
  async function askRung(input, signal, rung, round, assembled) {
252
281
  try {
253
- return parseAutoModeResponse(await withDeadline(timeoutMs, signal, (inner) => opts.classify(input, inner, rung, assembled)));
282
+ return { verdict: parseAutoModeResponse(await withDeadline(timeoutMs, signal, (inner) => opts.classify(input, inner, rung, assembled), inClassifierLane)), rateLimited: false };
254
283
  }
255
284
  catch (e) {
256
285
  if (isAutoModeRoundNotAsked(e)) {
257
286
  round.notAsked = "failed";
258
- return { kind: "unavailable", cause: "error" };
287
+ return { verdict: { kind: "unavailable", cause: "error" }, rateLimited: false };
259
288
  }
260
289
  if (signal?.aborted)
261
- return { kind: "unavailable", cause: "error" };
262
- return { kind: "unavailable", cause: isAutoModeTimeout(e) ? "timeout" : "error" };
290
+ return { verdict: { kind: "unavailable", cause: "error" }, rateLimited: false };
291
+ return { verdict: { kind: "unavailable", cause: isAutoModeTimeout(e) ? "timeout" : "error" }, rateLimited: isAutoModeRungRateLimited(e) };
292
+ }
293
+ }
294
+ function noteRungOutcome(rungIndex, rateLimited, signal, round) {
295
+ if (signal?.aborted)
296
+ return;
297
+ if (!rateLimited) {
298
+ rateLimitStreak.delete(rungIndex);
299
+ return;
263
300
  }
301
+ const streak = (rateLimitStreak.get(rungIndex) ?? 0) + 1;
302
+ rateLimitStreak.set(rungIndex, streak);
303
+ if (streak < rateLimitBreakAfter || retired.has(rungIndex))
304
+ return;
305
+ let next = rungIndex + 1;
306
+ while (next < ladder.length - 1 && retired.has(next))
307
+ next++;
308
+ const model = ladder[rungIndex];
309
+ const to = ladder[next];
310
+ if (model === undefined || to === undefined)
311
+ return;
312
+ retired.add(rungIndex);
313
+ round.rateLimitBreaks.push({ rung: rungIndex, model, to, consecutive: streak });
264
314
  }
265
315
  }
266
- async function withDeadline(capMs, signal, call) {
316
+ async function withDeadline(capMs, signal, call, scope = (f) => f()) {
267
317
  if (signal?.aborted === true)
268
318
  throw new Error("the classification was cancelled before it was dispatched");
269
319
  let timer;
@@ -279,19 +329,19 @@ async function withDeadline(capMs, signal, call) {
279
329
  end();
280
330
  };
281
331
  onOuterAbort = () => {
282
- inner.abort();
332
+ scope(() => inner.abort());
283
333
  settle(() => reject(new Error("the classification was cancelled")));
284
334
  };
285
335
  signal?.addEventListener("abort", onOuterAbort, { once: true });
286
336
  timer = setTimeout(() => {
287
337
  settle(() => {
288
- inner.abort();
338
+ scope(() => inner.abort());
289
339
  reject(new AutoModeTimeout());
290
340
  });
291
341
  }, capMs);
292
342
  let pending;
293
343
  try {
294
- pending = call(inner.signal);
344
+ pending = scope(() => call(inner.signal));
295
345
  }
296
346
  catch (e) {
297
347
  settle(() => reject(e));
@@ -307,6 +357,7 @@ async function withDeadline(capMs, signal, call) {
307
357
  signal.removeEventListener("abort", onOuterAbort);
308
358
  }
309
359
  }
360
+ const inClassifierLane = (f) => withStatusSeat("classifier", f);
310
361
  class AutoModeTimeout extends Error {
311
362
  constructor() {
312
363
  super("auto-mode classify timeout");
@@ -332,7 +383,7 @@ export function unarmedWindow(fallback) {
332
383
  function countsOf(fallback) {
333
384
  return { consecutive: fallback.consecutive, total: fallback.total, limit: fallback.limit };
334
385
  }
335
- const DENIAL_LIMIT_MEMBERS = new Set(["maxConsecutive", "maxTotal", "autoDenyAfterMs"]);
386
+ const DENIAL_LIMIT_KEYS = optionKeys()({ maxConsecutive: 0, maxTotal: 0, autoDenyAfterMs: 0 });
336
387
  export function autoModeDenialLimitOf(v) {
337
388
  const refuse = (what) => {
338
389
  const e = new Error(`RunnerDeps.autoMode.denialLimit${what}`);
@@ -343,10 +394,7 @@ export function autoModeDenialLimitOf(v) {
343
394
  return { ...AUTO_MODE_DENIAL_LIMIT_DEFAULTS, autoDenyAfterMs: AUTO_MODE_DENIAL_AUTO_DENY_DEFAULT_MS };
344
395
  if (typeof v !== "object" || v === null || Array.isArray(v))
345
396
  return refuse(` must be a record of bounds (got ${describeRejectedValue(v)}) — omit it for the defaults`);
346
- const opts = v;
347
- const stray = Object.keys(opts).find((k) => !DENIAL_LIMIT_MEMBERS.has(k));
348
- if (stray !== undefined)
349
- return refuse(` has no member ${JSON.stringify(stray)} — its members are maxConsecutive, maxTotal and autoDenyAfterMs`);
397
+ const opts = receiveMembers(v, { subject: "RunnerDeps.autoMode.denialLimit", unit: "member", moment: "when the knob is read" }, DENIAL_LIMIT_KEYS, (_, [stray]) => refuse(` has no member ${JSON.stringify(String(stray))} — its members are maxConsecutive, maxTotal and autoDenyAfterMs`));
350
398
  const bound = (name, dflt) => {
351
399
  const b = opts[name];
352
400
  if (b === undefined)
@@ -365,6 +413,7 @@ export function screenAutoModeKnobs(face) {
365
413
  autoModeTimeoutMsOf(face.timeoutMs);
366
414
  autoModeClassifierFallbackOf(face.classifierFallback);
367
415
  autoModeDenialLimitOf(face.denialLimit);
416
+ autoModeRateLimitBreakAfterOf(face.rateLimitBreakAfter);
368
417
  }
369
418
  export function createAutoModeDenialTracker(opts) {
370
419
  const { maxConsecutive, maxTotal, autoDenyAfterMs } = autoModeDenialLimitOf(opts);
@@ -1,4 +1,5 @@
1
1
  import type { SubagentEditedFile, SubagentStep } from "../agents/subagent-steps.js";
2
+ import type { SubagentTranscriptTier } from "./wiring-manifest.js";
2
3
  /** Terminal/live usage rollup persisted on the row (mirror of the task_notification/BCE fields). */
3
4
  export interface BackgroundAgentUsage {
4
5
  totalTokens?: number;
@@ -84,7 +85,7 @@ export interface BackgroundAgentRecord {
84
85
  stoppedBy?: string;
85
86
  /** The cross-channel completion correlation id
86
87
  * (task-registry `SemaTaskHandle.completionId` mirror). Written alongside `status`/`settledAt` at
87
- * the same durable terminal write that lands them, so a cross-restart fallback read (`TaskOutput`
88
+ * the same durable terminal write that lands them, so a cross-restart fallback read (a host poll
88
89
  * after the writing process is gone) REPLAYS this exact value — there is no second mint point here,
89
90
  * this field only ever receives what the in-memory handle already minted before the write. */
90
91
  completionId?: string;
@@ -187,7 +188,15 @@ export interface BackgroundAgentRecord {
187
188
  export declare const REVIVED_ROW_CLEARED_FIELDS: readonly ["settledAt", "stoppedBy", "completionId", "finalOutput", "finalOutputFull", "error", "errorCode", "errorRetryable", "errorKind", "errorRetryAfterMs", "resultIsPartial", "summary", "recentSteps", "editedFiles", "usage"];
188
189
  /** Erase {@link REVIVED_ROW_CLEARED_FIELDS} from a record a revival is about to write back. */
189
190
  export declare function clearRevivedRowTerminalPayload(record: BackgroundAgentRecord): void;
190
- export declare function announceTranscriptIntegrityGapOnce(handle: string, scope: string | undefined, sink: ((handle: string, scope: string | undefined) => void) | undefined): void;
191
+ /**
192
+ * Whether a deployment's subagent transcript tier DECLARES that a finished agent's transcript outlives the process — the one tier a vanished
193
+ * transcript contradicts. `full` makes that promise; `rows` keeps the agent's record but says transcripts follow the session store's fate (a
194
+ * transcript gone from a process-local store is what that tier means), and `none` has no row to bind one. The tier is the wiring manifest's
195
+ * own word (`WiringManifest.fleet.subagentTranscripts`, derived by `resolveSubagentTranscriptTier`); every site that meets a gone transcript
196
+ * hands the tier its mount derived to {@link announceTranscriptIntegrityGapOnce}, which asks this predicate — the one place it is asked.
197
+ */
198
+ export declare const declaresTranscriptDurability: (tier: SubagentTranscriptTier) => boolean;
199
+ export declare function announceTranscriptIntegrityGapOnce(handle: string, scope: string | undefined, sink: ((handle: string, scope: string | undefined) => void) | undefined, tier: SubagentTranscriptTier): void;
191
200
  /** Content-free projection for list reads (design/151 HIGH-1: `summary`/`finalOutput`/`recentSteps`
192
201
  * and friends NEVER ride a list — content is get-by-handle only, behind the full predicate). */
193
202
  export interface BackgroundAgentRowSummary {
@@ -302,10 +311,12 @@ export interface BackgroundAgentReapOptions {
302
311
  * Must be a finite, non-negative number of milliseconds. */
303
312
  staleRunningMaxAgeMs?: number;
304
313
  }
305
- /** knob-hygiene #98 — refuse a malformed reap policy before any row is touched. Delegates to the one
306
- * shared validator ({@link assertRetentionPolicy}) both bundled stores and the sibling mailbox /
307
- * workflow-run / roster retention seams run through, so no implementation can drift from another. */
308
- export declare function assertBackgroundAgentReapOptions(opts: BackgroundAgentReapOptions | undefined): void;
314
+ /** The retention knobs a background-agent `reap` takes (and the durable-agent joint reap beside it). */
315
+ export declare const BACKGROUND_AGENT_REAP_KNOBS: readonly ["maxAgeMs", "keep", "staleRunningMaxAgeMs"];
316
+ /** knob-hygiene #98 — read a reap policy once and refuse a malformed one before any row is touched. Delegates to the one
317
+ * shared reading ({@link receiveRetentionPolicy}) both bundled stores and the sibling mailbox / workflow-run retention
318
+ * seams run through, so no implementation can drift from another; the sweep deletes by the copy this returns. */
319
+ export declare function receiveBackgroundAgentReapOptions(opts: BackgroundAgentReapOptions | undefined): Readonly<BackgroundAgentReapOptions>;
309
320
  export interface BackgroundAgentStore {
310
321
  put(record: BackgroundAgentRecord): Promise<void>;
311
322
  get(handle: string, scope: string): Promise<BackgroundAgentRecord | null>;
@@ -1,5 +1,5 @@
1
1
  import { uuidv7 } from "../internal/harness.js";
2
- import { assertRetentionPolicy } from "./retention-policy.js";
2
+ import { receiveRetentionPolicy } from "./retention-policy.js";
3
3
  export const REVIVED_ROW_CLEARED_FIELDS = Object.freeze([
4
4
  "settledAt",
5
5
  "stoppedBy",
@@ -21,9 +21,10 @@ export function clearRevivedRowTerminalPayload(record) {
21
21
  for (const field of REVIVED_ROW_CLEARED_FIELDS)
22
22
  delete record[field];
23
23
  }
24
+ export const declaresTranscriptDurability = (tier) => tier === "full";
24
25
  const transcriptIntegrityAnnounced = new Set();
25
- export function announceTranscriptIntegrityGapOnce(handle, scope, sink) {
26
- if (sink === undefined)
26
+ export function announceTranscriptIntegrityGapOnce(handle, scope, sink, tier) {
27
+ if (sink === undefined || !declaresTranscriptDurability(tier))
27
28
  return;
28
29
  const key = `${scope ?? ""}\u0000${handle}`;
29
30
  if (transcriptIntegrityAnnounced.has(key))
@@ -58,8 +59,9 @@ export function canAccessAgentRecord(record, access) {
58
59
  return false;
59
60
  }
60
61
  export const STALE_RUNNING_REAP_ATTRIBUTION = "the host process was interrupted while this agent was running — its in-process state was lost. Check its worktree / output file for partial work before assuming the task landed (stale running row reaped).";
61
- export function assertBackgroundAgentReapOptions(opts) {
62
- assertRetentionPolicy("BackgroundAgentStore.reap", opts);
62
+ export const BACKGROUND_AGENT_REAP_KNOBS = Object.freeze(["maxAgeMs", "keep", "staleRunningMaxAgeMs"]);
63
+ export function receiveBackgroundAgentReapOptions(opts) {
64
+ return receiveRetentionPolicy("BackgroundAgentStore.reap", opts, BACKGROUND_AGENT_REAP_KNOBS);
63
65
  }
64
66
  export async function reconcileParkedAgents(stores, scope, now, opts) {
65
67
  const out = { failed: 0, rolledBack: 0 };
@@ -274,15 +276,15 @@ export class InMemoryBackgroundAgentStore {
274
276
  return [...new Set([...this.rows.values()].map((r) => r.scope))].sort();
275
277
  }
276
278
  async reap(scope, now, opts) {
277
- assertBackgroundAgentReapOptions(opts);
278
- if (!opts || (opts.maxAgeMs === undefined && opts.keep === undefined && opts.staleRunningMaxAgeMs === undefined))
279
+ const policy = receiveBackgroundAgentReapOptions(opts);
280
+ if (policy.maxAgeMs === undefined && policy.keep === undefined && policy.staleRunningMaxAgeMs === undefined)
279
281
  return 0;
280
282
  const flippedKeys = new Set();
281
- if (opts.staleRunningMaxAgeMs !== undefined) {
283
+ if (policy.staleRunningMaxAgeMs !== undefined) {
282
284
  for (const [k, r] of this.rows) {
283
285
  if (r.scope !== scope || r.status !== "running")
284
286
  continue;
285
- if (now - r.updatedAt <= opts.staleRunningMaxAgeMs)
287
+ if (now - r.updatedAt <= policy.staleRunningMaxAgeMs)
286
288
  continue;
287
289
  const flipped = structuredClone(r);
288
290
  flipped.status = "failed";
@@ -300,14 +302,14 @@ export class InMemoryBackgroundAgentStore {
300
302
  .filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
301
303
  .sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
302
304
  const doomed = new Set();
303
- if (opts.maxAgeMs !== undefined) {
305
+ if (policy.maxAgeMs !== undefined) {
304
306
  for (const [k, r] of terminal) {
305
- if ((r.settledAt ?? r.spawnedAt) < now - opts.maxAgeMs)
307
+ if ((r.settledAt ?? r.spawnedAt) < now - policy.maxAgeMs)
306
308
  doomed.add(k);
307
309
  }
308
310
  }
309
- if (opts.keep !== undefined) {
310
- for (const [k] of terminal.slice(Math.max(0, opts.keep)))
311
+ if (policy.keep !== undefined) {
312
+ for (const [k] of terminal.slice(Math.max(0, policy.keep)))
311
313
  doomed.add(k);
312
314
  }
313
315
  for (const k of doomed)
@@ -73,7 +73,7 @@ export interface BackgroundPoll {
73
73
  * 不支持的 env(StubExecutionEnv / SSH / ADB)= 不实现(或 `supported:false`),三个后台工具自动不挂(INERT)。
74
74
  */
75
75
  export interface BackgroundShellCapability {
76
- /** 显式声明能力(像 `RemoteExecutionEnv.capabilities` 一样不猜)。per-env / per-adapter。 */
76
+ /** 显式声明能力(像 `ExecutionEnv.capabilities` 一样不猜)。per-env / per-adapter。 */
77
77
  readonly backgroundCapabilities: {
78
78
  /** 是否真支持后台 spawn;`false` → 三工具不挂(design/103 §3.8)。 */
79
79
  readonly supported: boolean;
@@ -167,6 +167,17 @@ export declare function envDeclaresRetain(env: ExecutionEnv): boolean;
167
167
  * 单谓词足够:remote-env 刻意拆 `isRemoteExecutionEnv`(结构)/`isSuspendable`(语义)是因为 isolation/suspendable 两轴
168
168
  * 彼此独立;这里 `supported` 是唯一语义轴,合进一个谓词不会丢信息。
169
169
  */
170
+ /**
171
+ * THE output file of a background command (a `run_in_background` / detached Bash, a Monitor watch): created empty in the
172
+ * env's temp dir and canonicalized BEFORE it is advertised — the receipt, the completion notification, the registry row
173
+ * and the key Read's root-fence exemption compares (`TaskRegistry.isBackgroundOutputFile`) must be the same string, and
174
+ * the OS temp dir sits behind a symlink on some platforms. The registry watcher appends every polled increment (stdout
175
+ * and stderr) to it. `undefined` = the file could not be created (the row then has no file, and its completion frame
176
+ * says so); a canonicalize failure keeps the raw path (the file still mirrors — only the exemption may miss). No engine
177
+ * deleter: the model may Read the file well after the task ends; reclamation is the temp-dir policy's job, and only the
178
+ * exemption dies early, with the row.
179
+ */
180
+ export declare function createBackgroundOutputFile(env: ExecutionEnv, prefix: "bash-task-" | "monitor-task-"): Promise<string | undefined>;
170
181
  export declare function hasBackgroundShell(env: ExecutionEnv): env is ExecutionEnv & BackgroundShellCapability;
171
182
  /**
172
183
  * The ONE way core runs an env-level background sweep.
@@ -15,6 +15,18 @@ export function envDeclaresRetain(env) {
15
15
  const caps = env.backgroundCapabilities;
16
16
  return typeof caps === "object" && caps !== null && caps.retainBackgroundProcesses === true;
17
17
  }
18
+ export async function createBackgroundOutputFile(env, prefix) {
19
+ try {
20
+ const tf = await env.createTempFile({ prefix, suffix: ".output" });
21
+ if (!tf.ok)
22
+ return undefined;
23
+ const canon = await env.canonicalPath(tf.value);
24
+ return canon.ok ? canon.value : tf.value;
25
+ }
26
+ catch {
27
+ return undefined;
28
+ }
29
+ }
18
30
  export function hasBackgroundShell(env) {
19
31
  const e = env;
20
32
  return (typeof e.spawnBackground === "function" &&
@@ -6,7 +6,7 @@ import { type StoreFidelity, type Checkpoint, type CheckpointFeature, type Check
6
6
  * had carried beside the one its word now names, and the members added after the table, each a capability a reader
7
7
  * must have. Downstream reads them for display only (`CheckpointError.detail.requires`).
8
8
  */
9
- export declare const REQUIREMENT_WORDS: readonly ["resource", "binding", "token", "orgAdmission", "f012", "realApproval", "face", "requirements_digest", "org_admission_inherited", "org_write_grant", "org_governed", "delegation_provenance", "skill_grants", "skill_card_binding", "hands_coordinates", "hands_home", "path_rule_anchors", "path_rule_installations", "permission_mode", "plan_mode_restore", "persisted_rule_mandate", "deployment_authored", "call_names", "write_face", "denial_limit_fallback", "leg_scope", "tool_ceiling", "tool_lists_judged", "own_tool_lists", "approval_targets", "approval_target_reads", "cross_boundary", "mount_site", "skill_scopes", "run_origin", "tool_declaration"];
9
+ export declare const REQUIREMENT_WORDS: readonly ["resource", "binding", "token", "orgAdmission", "f012", "realApproval", "face", "requirements_digest", "org_admission_inherited", "org_write_grant", "org_governed", "delegation_provenance", "skill_grants", "skill_card_binding", "hands_coordinates", "hands_home", "path_rule_anchors", "path_rule_installations", "permission_mode", "plan_mode_restore", "persisted_rule_mandate", "deployment_authored", "call_names", "write_face", "denial_limit_fallback", "leg_scope", "tool_ceiling", "tool_lists_judged", "own_tool_lists", "approval_targets", "approval_target_reads", "cross_boundary", "mount_site", "skill_scopes", "run_origin", "tool_declaration", "composition_leg", "row_task_id", "held_rows", "source_session"];
10
10
  export type RequirementWord = (typeof REQUIREMENT_WORDS)[number];
11
11
  /** Runtime twin of {@link RequirementWord}. */
12
12
  export declare function isRequirementWord(word: unknown): word is RequirementWord;
@@ -212,9 +212,15 @@ export declare const CHECKPOINT_STATE_REQUIREMENTS: {
212
212
  readonly isDelegatedChild: {
213
213
  readonly digest: "decision-read";
214
214
  };
215
+ readonly rowTaskId: {
216
+ readonly word: "row_task_id";
217
+ };
215
218
  readonly placementRootSessionId: {
216
219
  readonly digest: "decision-read";
217
220
  };
221
+ readonly compositionLeg: {
222
+ readonly word: "composition_leg";
223
+ };
218
224
  readonly externalContentTarget: {
219
225
  readonly digest: "decision-read";
220
226
  };
@@ -293,6 +299,9 @@ export declare const PENDING_ACTION_REQUIREMENTS: {
293
299
  readonly classes: {
294
300
  readonly digest: "decision-read";
295
301
  };
302
+ readonly askReasons: {
303
+ readonly ignorable: "shown, never decided (card, listing, transcript or reported count): every read of the name renders, carries transcript or counts";
304
+ };
296
305
  readonly boundInputHash: {
297
306
  readonly digest: "decision-read";
298
307
  };
@@ -480,6 +489,9 @@ export declare const CHECKPOINT_REQUIREMENTS: {
480
489
  readonly leafId: {
481
490
  readonly digest: "decision-read";
482
491
  };
492
+ readonly heldRows: {
493
+ readonly word: "held_rows";
494
+ };
483
495
  readonly state: {
484
496
  readonly members: {
485
497
  readonly activeTools: {
@@ -591,9 +603,15 @@ export declare const CHECKPOINT_REQUIREMENTS: {
591
603
  readonly isDelegatedChild: {
592
604
  readonly digest: "decision-read";
593
605
  };
606
+ readonly rowTaskId: {
607
+ readonly word: "row_task_id";
608
+ };
594
609
  readonly placementRootSessionId: {
595
610
  readonly digest: "decision-read";
596
611
  };
612
+ readonly compositionLeg: {
613
+ readonly word: "composition_leg";
614
+ };
597
615
  readonly externalContentTarget: {
598
616
  readonly digest: "decision-read";
599
617
  };
@@ -669,8 +687,8 @@ export declare const CHECKPOINT_REQUIREMENTS: {
669
687
  readonly rev: {
670
688
  readonly mutable: "store state-machine member; integrity = CAS contract + kit, see #1580";
671
689
  };
672
- readonly sourceTaskId: {
673
- readonly digest: "decision-read";
690
+ readonly sourceSessionId: {
691
+ readonly word: "source_session";
674
692
  };
675
693
  readonly principal: {
676
694
  readonly digest: "decision-read";
@@ -817,6 +835,9 @@ export declare const CHECKPOINT_REQUIREMENTS: {
817
835
  readonly classes: {
818
836
  readonly digest: "decision-read";
819
837
  };
838
+ readonly askReasons: {
839
+ readonly ignorable: "shown, never decided (card, listing, transcript or reported count): every read of the name renders, carries transcript or counts";
840
+ };
820
841
  readonly boundInputHash: {
821
842
  readonly digest: "decision-read";
822
843
  };
@@ -38,6 +38,10 @@ export const REQUIREMENT_WORDS = Object.freeze([
38
38
  "skill_scopes",
39
39
  "run_origin",
40
40
  "tool_declaration",
41
+ "composition_leg",
42
+ "row_task_id",
43
+ "held_rows",
44
+ "source_session",
41
45
  ]);
42
46
  export function isRequirementWord(word) {
43
47
  return typeof word === "string" && REQUIREMENT_WORDS.includes(word);
@@ -94,7 +98,9 @@ export const CHECKPOINT_STATE_REQUIREMENTS = {
94
98
  gitAnnouncement: SHOWN,
95
99
  delegationProvenance: { word: "delegation_provenance" },
96
100
  isDelegatedChild: DECISION_READ,
101
+ rowTaskId: { word: "row_task_id" },
97
102
  placementRootSessionId: DECISION_READ,
103
+ compositionLeg: { word: "composition_leg" },
98
104
  externalContentTarget: DECISION_READ,
99
105
  legScope: { word: "leg_scope" },
100
106
  runOrigin: { word: "run_origin" },
@@ -123,6 +129,7 @@ export const PENDING_ACTION_REQUIREMENTS = {
123
129
  origin: DECISION_READ,
124
130
  askClass: DECISION_READ,
125
131
  classes: DECISION_READ,
132
+ askReasons: SHOWN,
126
133
  boundInputHash: DECISION_READ,
127
134
  boundGrantDigest: { word: "skill_card_binding" },
128
135
  boundGrants: SHOWN,
@@ -165,6 +172,7 @@ export const CHECKPOINT_REQUIREMENTS = {
165
172
  scope: DECISION_READ,
166
173
  sessionId: DECISION_READ,
167
174
  leafId: DECISION_READ,
175
+ heldRows: { word: "held_rows" },
168
176
  state: { members: CHECKPOINT_STATE_REQUIREMENTS },
169
177
  resourceLedger: { members: RESOURCE_LEDGER_REQUIREMENTS },
170
178
  deadline: DECISION_READ,
@@ -176,7 +184,7 @@ export const CHECKPOINT_REQUIREMENTS = {
176
184
  resolvedOutcome: STATE_MACHINE,
177
185
  reopenReason: STATE_MACHINE,
178
186
  rev: STATE_MACHINE,
179
- sourceTaskId: DECISION_READ,
187
+ sourceSessionId: { word: "source_session" },
180
188
  principal: DECISION_READ,
181
189
  durableApproval: DECISION_READ,
182
190
  executionOutcome: STATE_MACHINE,