@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -46,6 +46,10 @@ export declare const DEFAULT_UNATTENDED_APPROVAL_TTL_MS: number;
46
46
  * field must never widen the bound, and
47
47
  * killing an in-flight task over it would cost more than it saves. `undefined` (the deliberate
48
48
  * "unbounded, D-D terminalAt is the backstop" choice) is preserved as-is and is NOT what this rejects.
49
+ *
50
+ * A TASK that declares a malformed `durableApproval.ttlMs` / `resourceSuspend.ttlMs` never gets here: the task door refuses it before any
51
+ * side effect (`assertFiniteNonNegativeWhenPresent`). What reaches this function is a ttl a record carried from before the door judged it,
52
+ * and `0`, which the door admits and this reads as the default.
49
53
  */
50
54
  export declare function sanitizedTtlMs(ttlMs: number | undefined): number | undefined;
51
55
  /**
@@ -68,6 +72,9 @@ export declare function sanitizedTtlMs(ttlMs: number | undefined): number | unde
68
72
  *
69
73
  */
70
74
  export declare function gatedCallIdOf(p: Pick<Prepared, "pausedRef">): string | undefined;
75
+ /** The human-review ledger as every parked row carries it (`Checkpoint.humanReview`): a copy of the leg's accumulator,
76
+ * independent of the live one, `count: 0` when no gate of the chain so far waited on a person. Every mint writes it. */
77
+ export declare function humanReviewSnapshot(ref: Prepared["humanReviewRef"]): Prepared["humanReviewRef"];
71
78
  /**
72
79
  * The abort-classification marker for the loop's short-circuit "Operation aborted" family: when a gate
73
80
  * committed a durable park this run (`pausedRef.current`, whatever the pause's kind), the contaminated
@@ -10,6 +10,9 @@ export function sanitizedTtlMs(ttlMs) {
10
10
  export function gatedCallIdOf(p) {
11
11
  return p.pausedRef.current?.gatedCallId;
12
12
  }
13
+ export function humanReviewSnapshot(ref) {
14
+ return { count: ref.count, totalWaitMs: ref.totalWaitMs, gates: [...ref.gates] };
15
+ }
13
16
  export function parkContaminationMarker(refs) {
14
17
  if (refs.pausedRef.current === undefined)
15
18
  return undefined;
@@ -2,8 +2,9 @@
2
2
  * PrepareTask's ADVISOR phase: whether this leg mounts the `advisor` tool, and what it owes the model about it. In order —
3
3
  * the deployment switch (`RunnerDeps.advisorTool: "disabled"` ignores the spec's advisor model unread); the static verdict
4
4
  * (`advisorAttachVerdict`, the one answer a host's advisor query reads too); then the mount chain — the reserved name, the
5
- * leg's tool selector (its valve's own predicate, asked of the tool's name), the conversation's hold (the transcript), the
6
- * advisor route (the shared derived-seat pre-flight, posture `detach`) — and the mount. Its answer is the manifest fact,
5
+ * advisor's mount row read as if the route attaches (the model and the valve), the conversation's hold (the transcript), the
6
+ * advisor route (the shared derived-seat pre-flight, posture `detach`, the row's live fact) — and the mount the row judges.
7
+ * Its answer is the manifest fact,
7
8
  * the person's notice for a reason they are told (root legs only, once per conversation per pair), and the leg's
8
9
  * instruction seat (what the model is owed, against what it was told in the conversation's current segment).
9
10
  *
@@ -14,7 +15,6 @@
14
15
  import type { SessionTreeEntry } from "../../internal/harness-types.js";
15
16
  import type { Model } from "../../internal/llm.js";
16
17
  import type { CompactionForkContext } from "../auto-compaction.js";
17
- import type { ToolSelector } from "../tool-face.js";
18
18
  import type { RosterBuilder } from "../tool-roster.js";
19
19
  import { type RunnerDeps, type TaskSpec } from "../types.js";
20
20
  import type { WiringAdvisorFact } from "../wiring-manifest.js";
@@ -22,18 +22,16 @@ import { type AdvisorInstructionSeat } from "./advisor-instructions.js";
22
22
  import { type AnnounceOnceLedger } from "./announce-once-ledger.js";
23
23
  import type { Prepared } from "./contracts.js";
24
24
  export interface PrepareAdvisorInput {
25
- /** borrowed-readonly — the REBOUND spec: the advisor model, the caller's tools (the reserved name), the whole-face switch, the auth hook. */
26
- spec: Pick<TaskSpec, "advisorModel" | "tools" | "excludeAllTools" | "getApiKeyAndHeaders">;
25
+ /** borrowed-readonly — the REBOUND spec: the advisor model, the caller's tools (the reserved name), the auth hook. */
26
+ spec: Pick<TaskSpec, "advisorModel" | "tools" | "getApiKeyAndHeaders">;
27
27
  /** borrowed-readonly — the deployment switch as the value door screened it. */
28
28
  advisorTool: "disabled" | undefined;
29
29
  /** borrowed-readonly — the catalog and tiers the verdict reads, the brain the advisor lane books, the notice sink. */
30
- deps: Pick<RunnerDeps, "models" | "tiers" | "brain" | "onNotice">;
30
+ deps: Pick<RunnerDeps, "models" | "tiers" | "brain" | "modelFallback" | "cacheRetention" | "onNotice">;
31
31
  /** borrowed-readonly — the leg's resolved main model. */
32
32
  model: Model;
33
- /** borrowed-mutable — the mount array (the advisor tool is mounted on it). */
33
+ /** borrowed-mutable — the mount array (the advisor tool is mounted on it) and its mount ledger (the advisor row). */
34
34
  roster: RosterBuilder;
35
- /** borrowed-readonly — the leg's frozen tool selector (the valve's predicate). */
36
- selector: ToolSelector;
37
35
  /** borrowed-readonly — the acquired session: its branch (the hold, the segment). */
38
36
  session: {
39
37
  getBranch(): Promise<ReadonlyArray<SessionTreeEntry>>;
@@ -1,4 +1,3 @@
1
- import { valveLeaves } from "../../agents/tool-filter.js";
2
1
  import { ADVISOR_TOOL_NAME, advisorAttachVerdict, advisorHoldOf, advisorNotAttachedNotice, advisorReasonTold } from "../advisor-verdict.js";
3
2
  import { deliverEngineNotice } from "../types.js";
4
3
  import { advisorInstructionFrame } from "./advisor-instructions.js";
@@ -8,6 +7,7 @@ import { conversationSegmentOf } from "./conversation-segment.js";
8
7
  import { derivedRouteFallsBack } from "./derived-route-fallback.js";
9
8
  import { derivedLegBrain } from "./side-call-account.js";
10
9
  import { withBrainCallGuardrail } from "../../brain/timeout.js";
10
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
11
11
  export async function prepareAdvisor(input) {
12
12
  const { spec, deps, model, onceLedger, sessionId, runId } = input;
13
13
  const told = onceLedger.arms().advisor;
@@ -16,6 +16,7 @@ export async function prepareAdvisor(input) {
16
16
  const requested = spec.advisorModel === undefined || input.advisorTool === "disabled" ? undefined : typeof spec.advisorModel === "string" ? spec.advisorModel : spec.advisorModel.id;
17
17
  const fact = (f) => ({ ...(requested !== undefined ? { requested } : {}), main: model.id, ...f });
18
18
  const notAttached = (reason, extra = {}) => {
19
+ input.roster.mounts.know({ "advisor.route": false });
19
20
  if (input.rootLeg && requested !== undefined && advisorReasonTold(reason)) {
20
21
  onceLedger.oncePerSession(announceDigest("advisor.not_attached", `${reason}\n${requested}\n${model.id}`), () => deliverEngineNotice(deps.onNotice, advisorNotAttachedNotice({ reason, advisorModel: requested, mainModel: model.id, sessionId, ...(runId !== undefined ? { runId } : {}) })));
21
22
  }
@@ -30,17 +31,22 @@ export async function prepareAdvisor(input) {
30
31
  e.code = "config.reserved_tool_name";
31
32
  throw e;
32
33
  }
33
- if (!valveLeaves(spec, input.selector)({ name: ADVISOR_TOOL_NAME }))
34
+ if (!input.roster.mounts.holdsIf("advisor", { "advisor.route": true }))
34
35
  return fact({ state: "not_attached", reason: "excluded" });
35
36
  const entries = await readBranch();
36
37
  if (entries === undefined)
37
38
  return notAttached("hold_unknown");
38
39
  const held = advisorHoldOf(entries);
39
- if (held !== undefined)
40
+ if (held !== undefined) {
41
+ input.roster.mounts.know({ "advisor.route": false });
40
42
  return fact({ state: "held", model: advisor.id, hold: held });
41
- const route = await derivedRouteFallsBack({ seat: "advisor", derived: advisor, primary: model, brain: deps.brain, getApiKeyAndHeaders: spec.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId, ...(runId !== undefined ? { runId } : {}), onBrokenPairing: "detach" });
43
+ }
44
+ const route = await derivedRouteFallsBack({ seat: "advisor", derived: advisor, primary: model, brain: modelLaneBrainOf(deps), getApiKeyAndHeaders: spec.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId, ...(runId !== undefined ? { runId } : {}), onBrokenPairing: "detach" });
42
45
  if (route.action === "detach")
43
46
  return notAttached("route_refused", { routeCode: route.cause });
47
+ input.roster.mounts.know({ "advisor.route": true });
48
+ if (!input.roster.mounts.judge("advisor"))
49
+ return fact({ state: "not_attached", reason: "excluded" });
44
50
  input.roster.mount(createAdvisorTool(advisorSeat(input, advisor)), { source: "builtin", mountedBy: "optional" });
45
51
  mounted = true;
46
52
  return fact({ state: "on", model: advisor.id });
@@ -68,7 +74,7 @@ function advisorSeat(input, model) {
68
74
  const guarded = (b) => (ms === undefined ? b : { ...b, stream: withBrainCallGuardrail((m, c, o) => b.stream(m, c, o), ms, {}) });
69
75
  return {
70
76
  model,
71
- brain: derivedLegBrain(() => guarded(input.deps.brain), "advisor", book),
77
+ brain: derivedLegBrain(() => guarded(modelLaneBrainOf(input.deps)), "advisor", book),
72
78
  lastSentRequest: input.lastSentRequest,
73
79
  readBranch: () => input.session.getBranch(),
74
80
  getApiKeyAndHeaders: input.spec.getApiKeyAndHeaders,
@@ -14,7 +14,7 @@
14
14
  */
15
15
  import type { PermissionModeController } from "../mode-policy.js";
16
16
  import type { ExecutionEnv } from "../../internal/harness.js";
17
- import type { OnAsk } from "../tool-policy.js";
17
+ import { type OnAsk } from "../tool-policy.js";
18
18
  import { type ArtifactPlane } from "../artifact-host.js";
19
19
  import { RosterBuilder } from "../tool-roster.js";
20
20
  import type { AgentTool, RunnerDeps } from "../types.js";
@@ -1,3 +1,4 @@
1
+ import { wrapApprover } from "../tool-policy.js";
1
2
  import { readArtifactHostCapabilities } from "../artifact-host.js";
2
3
  import { ARTIFACT_TOOL_NAME } from "../tool-catalog-entries.js";
3
4
  import { deliverEngineNotice } from "../engine-notice.js";
@@ -14,6 +15,7 @@ export function prepareArtifact(input) {
14
15
  if (host === undefined)
15
16
  return { artifactPlane: undefined };
16
17
  const refuse = (problem) => {
18
+ roster.mounts.know({ "artifact.verdict": false });
17
19
  deliverEngineNotice(deps.onNotice, {
18
20
  code: "config.artifact_host_invalid",
19
21
  message: `RunnerDeps.artifactHost is wired but unusable, so no Artifact tool is mounted for this task: ${problem}`,
@@ -60,9 +62,12 @@ export function prepareArtifact(input) {
60
62
  return { ok: false, reason: "too_large", size: r.value.byteLength, limit: maxBytes, judgedOn: "bytes" };
61
63
  return { ok: true, key: rk.key, bytes: r.value };
62
64
  };
63
- const onAsk = typeof approver === "function" ? (req, signal) => toolOccurrences.whileAwaitingUser(req.toolCallId, () => approver(req, signal)) : approver;
65
+ const onAsk = wrapApprover(approver, (inner) => (req, signal) => toolOccurrences.whileAwaitingUser(req.toolCallId, () => inner(req, signal)));
64
66
  const artifactSpec = createArtifactTool({ host, capabilities: verdict.capabilities, runId, taskId, sessionId, ...(agentName !== undefined ? { agentName } : {}), readLocalFile, ...(onAsk !== undefined ? { onAsk } : {}), permissionMode: () => permissionMode.current, ...(deps.onNotice !== undefined ? { onNotice: deps.onNotice } : {}) });
65
- roster.mount(firstPartyOffload(defineTool(artifactSpec)), { source: "builtin", mountedBy: "optional" });
66
- envHandToolNames.add(ARTIFACT_TOOL_NAME);
67
+ roster.mounts.know({ "artifact.verdict": true });
68
+ if (roster.mounts.judge("artifact")) {
69
+ roster.mount(firstPartyOffload(defineTool(artifactSpec)), { source: "builtin", mountedBy: "optional" });
70
+ envHandToolNames.add(ARTIFACT_TOOL_NAME);
71
+ }
67
72
  return { artifactPlane: verdict.capabilities.plane };
68
73
  }
@@ -4,12 +4,16 @@ import type { AdvertisedWritableDirs } from "./advertised-writable-dirs.js";
4
4
  import type { AutoModeDenialTracker } from "../auto-mode.js";
5
5
  import { type LegModBus } from "../mods/stations.js";
6
6
  import { type AskSourceIdentity, type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
7
+ import { type DeferredAsk, type MarkerChannel } from "./deferred-ask.js";
7
8
  import type { RunnerDeps } from "../types.js";
8
9
  import type { CwdRef } from "../../tools/fs/fs-shared.js";
9
10
  import type { AskLane, Prepared } from "./contracts.js";
11
+ import { type ToolRosterDeltaSeat } from "../tool-roster.js";
12
+ import { type ExistingTargetSeat } from "../existing-target.js";
10
13
  import { type GrantBindingOf } from "../skill-grant-binding.js";
11
14
  import { consumeInheritedAskGrant } from "./inherited-ask-grants.js";
12
15
  import { type GrantReadRoot } from "./read-root-grant.js";
16
+ import type { ApprovalWordsSeat } from "../approval-words.js";
13
17
  import type { createRuleOffersOf } from "./permission-rule-lanes.js";
14
18
  export interface PrepareAskLaneInput {
15
19
  /** borrowed-readonly — the wiring-manifest phase's ONE activation predicate; false ⇒ this phase builds nothing and
@@ -41,9 +45,12 @@ export interface PrepareAskLaneInput {
41
45
  /** borrowed-readonly — the shared mount roster; read at RUN time by the approval-preview projection (the dispatcher's
42
46
  * resolution over whatever the roster holds when the ask is minted). Never mutated here. */
43
47
  tools: readonly AgentTool[];
44
- /** borrowed-mutable — the inherited-unavailable marker set. Writer here: `resolveAskBound` consumes (`delete`) a
45
- * marked call at its fail-closed intercept; the policy-chain phase records, the gate station sweeps. */
46
- inheritedUnavailableAsks: Set<string>;
48
+ /** borrowed-mutable — the inherited-unavailable marker channel ({@link MarkerChannel}). Writer here: `resolveAskBound` consumes
49
+ * (`delete`) a marked call at its fail-closed intercept, its refusal reading each mark's binding against the bytes in front of
50
+ * it; the policy-chain phase records, the gate station sweeps. */
51
+ inheritedUnavailableAsks: MarkerChannel;
52
+ /** borrowed-mutable — the deferred questions ({@link DeferredAsk}). Writer here: `resolveAskBound`, on an `"unavailable"` answer. */
53
+ deferredAskIdentities: Map<string, DeferredAsk>;
47
54
  /** borrowed-mutable — the duplicate-frame ask-grant record. Writer here: the grant-reuse consume half
48
55
  * (`consumeInheritedAskGrant`); the policy-chain phase records, the gate station sweeps. */
49
56
  inheritedAskGrants: Parameters<typeof consumeInheritedAskGrant>[0];
@@ -90,6 +97,17 @@ export interface PrepareAskLaneInput {
90
97
  notifyOwnHookCrash: (err: unknown) => void;
91
98
  /** borrowed-readonly — the hands phase's in-flight read-root widening (an approver's accepted `readRootGrant`), or undefined (hands-less). */
92
99
  grantReadRoot: GrantReadRoot | undefined;
100
+ /** borrowed-readonly — the leg's carrier for the approving person's written words ({@link ApprovalWordsSeat}); every ask this lane puts to
101
+ * the run's approver is resolved with it, so an answer's `feedback` reaches the model (the lane that has none refuses it). */
102
+ approvalWords: ApprovalWordsSeat;
103
+ /** borrowed-readonly — the leg's live roster seat; `current` is read per ask (the row that decides whether the card carries
104
+ * the target's current state, {@link existingTargetCovers}). The same seat the park and inherited legs read. */
105
+ toolRosterDeltas: Pick<ToolRosterDeltaSeat, "current">;
106
+ /** borrowed-readonly — the run's card-target source, filled once the run's served-read judge exists; `current` is read
107
+ * per ask. Empty (hands-less) ⇒ a card in scope says `withheld` / `unavailable`. */
108
+ existingTargetSeat: ExistingTargetSeat;
109
+ /** borrowed-readonly — the driver's refusal fact `forcedGateNotResumable`: `resolveAskBound` refuses every ask unconsulted. */
110
+ forcedGateNotResumable: boolean;
93
111
  }
94
112
  export interface PrepareAskLaneResult {
95
113
  /** owned — the lane, or undefined exactly when `gateMachineryActive` is false (then the suspend saga, the boundary
@@ -1,15 +1,20 @@
1
- import { cardDisclosureOf } from "../allow-entry.js";
1
+ import { askFallbackMessage, cardDisclosureOf } from "../allow-entry.js";
2
+ import { APPROVAL_DISPLAY_MAX_CHARS, sanitizeApprovalDisplay } from "../approval-display.js";
2
3
  import { primaryActivityArg } from "../arg-summary.js";
3
4
  import { classicEventBase, observeClassic } from "../mods/stations.js";
4
- import { advertisedWritableRootsSeat, exemptRootsSeat, attest, attestationOf, isLiveApproverSeat, resolveAskFor } from "../tool-policy.js";
5
+ import { callFactsSeat, attest, attestationOf, isAnsweringSeat, resolveAskFor } from "../tool-policy.js";
5
6
  import { exactBoundInputHashOf } from "../canonical-json.js";
7
+ import { mintCheckpointId } from "../checkpoint-store.js";
8
+ import { deferredAskOf, markBinds, movedClause } from "./deferred-ask.js";
6
9
  import { composeCallSignal, raceSettlementAgainstSignal } from "./abort-race.js";
7
10
  import { failedJudgmentDeny, policyCheckAbortedDeny } from "./policy-throw.js";
8
11
  import { askMandateMember } from "../ask-origin.js";
9
12
  import { approvalCardMemberOf, survivorsByName } from "../tool-roster.js";
13
+ import { cardTargetFor, readsCardTarget } from "../existing-target.js";
10
14
  import { toolNameIndex } from "../../internal/llm.js";
11
15
  import { requestGrantBinding } from "../skill-grant-binding.js";
12
- import { gateAskCarry, lateAskSettlementObserver } from "./denial-limit-arms.js";
16
+ import { gateAskCarry, gateAskClassPair, lateAskSettlementObserver } from "./denial-limit-arms.js";
17
+ import { approverDefectAnnouncer } from "./approver-defect-announcer.js";
13
18
  import { consumeInheritedAskGrant } from "./inherited-ask-grants.js";
14
19
  import { requesterOf } from "../mods/extension-call.js";
15
20
  import { settleReadRootGrant } from "./read-root-grant.js";
@@ -18,22 +23,6 @@ function createDenyObserverNotifier(bus, signal) {
18
23
  return undefined;
19
24
  return (payload) => observeClassic(bus, "classic.PermissionDenied", { ...payload, ...classicEventBase(payload.identity, payload.permissionMode) }, signal);
20
25
  }
21
- const sanitizePreview = (node, depth = 0) => {
22
- if (depth > 6)
23
- return undefined;
24
- if (typeof node === "string") {
25
- return node.replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, "\u2400");
26
- }
27
- if (node === null || typeof node !== "object")
28
- return node;
29
- if (Array.isArray(node))
30
- return node.map((v) => sanitizePreview(v, depth + 1));
31
- const out = {};
32
- for (const [k, v] of Object.entries(node)) {
33
- out[sanitizePreview(k, depth + 1)] = sanitizePreview(v, depth + 1);
34
- }
35
- return out;
36
- };
37
26
  function resolveApprovalPreview(tools, toolName, args) {
38
27
  const t = toolNameIndex([...survivorsByName(tools).values()])(toolName);
39
28
  if (t?.approvalPreview === undefined)
@@ -45,24 +34,24 @@ function resolveApprovalPreview(tools, toolName, args) {
45
34
  const bytes = JSON.stringify(raw);
46
35
  if (bytes === undefined)
47
36
  return { withheld: "unavailable" };
48
- if (bytes.length > 16_384) {
37
+ if (bytes.length > APPROVAL_DISPLAY_MAX_CHARS) {
49
38
  return { preview: { truncated: true, note: `approval preview exceeded 16KiB (${bytes.length} chars serialized)` }, withheld: "oversize" };
50
39
  }
51
- return { preview: sanitizePreview(raw) };
40
+ return { preview: sanitizeApprovalDisplay(raw) };
52
41
  }
53
42
  catch {
54
43
  return { withheld: "unavailable" };
55
44
  }
56
45
  }
57
46
  export function prepareAskLane(input) {
58
- const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf, askSource, riskAxesOf, autoModeDenialTracking, hostTaskId, deps, sessionId, runId, grantReadRoot, modBus, notifyOwnHookCrash } = input;
47
+ const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, deferredAskIdentities, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf, askSource, riskAxesOf, autoModeDenialTracking, hostTaskId, deps, sessionId, runId, grantReadRoot, approvalWords, modBus, notifyOwnHookCrash, toolRosterDeltas, existingTargetSeat, forcedGateNotResumable } = input;
59
48
  if (!gateMachineryActive)
60
49
  return { askLane: undefined };
61
50
  const composedCallSignal = (callSignal) => composeCallSignal(abortController.signal, callSignal);
62
51
  const adjudicate = effectivePolicy
63
52
  ? async (req, callSignal) => {
64
53
  const signal = composedCallSignal(callSignal);
65
- const stampedReq = () => ({ ...req, budget: budgetSnapshot, ...(handsCwdRef !== undefined ? { cwd: handsCwdRef.current } : {}), ...(handsRoot !== undefined ? { root: handsRoot } : {}), ...advertisedWritableRootsSeat(advertisedWritableDirs), ...exemptRootsSeat(exemptRoots), ...requestGrantBinding(grantBindingOf, req, req.args) });
54
+ const stampedReq = () => ({ ...req, ...callFactsSeat({ budget: budgetSnapshot, cwd: handsCwdRef?.current, root: handsRoot, advertisedWritableDirs, exemptRoots }), ...requestGrantBinding(grantBindingOf, req, req.args) });
66
55
  const judged = (async () => {
67
56
  const withReading = stampCallTarget?.(stampedReq(), signal);
68
57
  return withReading === undefined ? effectivePolicy.check(stampedReq(), signal) : effectivePolicy.check(await withReading, signal);
@@ -77,11 +66,13 @@ export function prepareAskLane(input) {
77
66
  : undefined;
78
67
  const approvalPreviewOf = (toolName, args) => resolveApprovalPreview(tools, toolName, args);
79
68
  const resolveAskBound = async (decision, req, callSignal) => {
80
- if (inheritedUnavailableAsks.delete(req.toolCallId)) {
69
+ const marks = inheritedUnavailableAsks.get(req.toolCallId);
70
+ if (marks !== undefined && inheritedUnavailableAsks.delete(req.toolCallId)) {
71
+ const moved = [...marks.values()].some((m) => !markBinds(m, req, req.args));
81
72
  const intercepted = {
82
73
  action: "deny",
83
74
  message: `approval for "${req.toolName}" requires an ancestor task's approval that cannot be resolved here ` +
84
- `(no live approver reachable, or a durable-park mandate applies), and no durable approval park is ` +
75
+ `(no live approver reachable, or a durable-park mandate applies)${moved ? ` — ${movedClause(req.toolName)} —` : ","} and no durable approval park is ` +
85
76
  `available — denied fail-closed (the inherited constraint stands).`,
86
77
  decisionReason: "mode",
87
78
  approverUnavailable: true,
@@ -91,37 +82,50 @@ export function prepareAskLane(input) {
91
82
  ? attest(intercepted, req, { settlement, ...(decision.origin !== undefined ? { origin: decision.origin } : {}), ...(decision.classes !== undefined ? { classes: decision.classes } : {}), inputDigest: exactBoundInputHashOf(req.toolName, req.args) })
92
83
  : attest(intercepted, req, { settlement, inputDigest: exactBoundInputHashOf(req.toolName, req.args) });
93
84
  }
85
+ if (forcedGateNotResumable) {
86
+ const message = `approval for "${req.toolName}" is mandated to wait durably for this principal (forceDurableGate), and this delegated leg cannot be resumed — its parent forwarded it no durable approval — so it was refused without asking anyone (fail-closed). Ask from the parent leg itself, or delegate the work as a background agent on a lane that can park.`;
87
+ const members = { settlement: { kind: "no_approver", who: { party: "none" }, when: now() }, unresolvableCause: "mandate_unreconstructible", inputDigest: exactBoundInputHashOf(req.toolName, req.args) };
88
+ const asked = decision.action === "ask" ? { ...(decision.origin !== undefined ? { origin: decision.origin } : {}), ...(decision.classes !== undefined ? { classes: decision.classes } : {}) } : {};
89
+ return attest({ action: "deny", message, decisionReason: "mode" }, req, { ...members, ...asked });
90
+ }
94
91
  const grantReuse = consumeInheritedAskGrant(inheritedAskGrants, onAsk, humanReviewRef, decision, req);
95
92
  if (grantReuse !== undefined)
96
93
  return grantReuse;
94
+ const existingTarget = await cardTargetFor(existingTargetSeat, toolRosterDeltas.current, req, req.args, readsCardTarget(onAsk, decision.action === "ask" ? gateAskClassPair(decision).classes : undefined), composedCallSignal(callSignal));
97
95
  const t0 = now();
96
+ const checkpointId = mintCheckpointId();
98
97
  const resolved = await resolveAskFor({
99
98
  toolName: req.toolName,
100
99
  toolCallId: req.toolCallId,
100
+ checkpointId,
101
101
  args: req.args,
102
102
  ...(() => {
103
103
  const p = approvalPreviewOf(req.toolName, req.args);
104
104
  return { ...(p.preview !== undefined ? { preview: p.preview } : {}), ...(p.withheld !== undefined ? { previewWithheld: p.withheld } : {}) };
105
105
  })(),
106
+ ...existingTarget,
106
107
  ...ruleOffersOf(req, req.args, decision.action === "ask" ? decision : undefined),
107
108
  ...grantBindingOf(req, req.args),
108
- ...cardDisclosureOf(decision, `approval required for "${req.toolName}"`),
109
+ ...cardDisclosureOf(decision, askFallbackMessage(req.toolName)),
109
110
  ...askSource,
110
111
  ...riskAxesOf(req),
111
112
  ...approvalCardMemberOf(req),
112
113
  ...requesterOf(modBus, req.toolCallId),
113
114
  ...(decision.action === "ask" && decision.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
114
115
  ...(decision.action === "ask" ? askMandateMember(decision) : {}),
115
- ...(decision.action === "ask" ? gateAskCarry(decision, isLiveApproverSeat(onAsk), autoModeDenialTracking.current) : {}),
116
+ ...(decision.action === "ask" ? gateAskCarry(decision, isAnsweringSeat(onAsk), autoModeDenialTracking.current) : {}),
116
117
  ...(decision.action === "ask" && decision.probeReason !== undefined ? { probeReason: decision.probeReason } : {}),
117
118
  ...(decision.action === "ask" && decision.probeCause !== undefined ? { probeCause: decision.probeCause } : {}),
118
119
  ...(decision.action === "ask" && decision.probeReadRootCandidate !== undefined ? { readRootCandidate: decision.probeReadRootCandidate } : {}),
119
120
  ...(decision.action === "ask" && decision.ruleEvidence !== undefined ? { ruleEvidence: decision.ruleEvidence } : {}),
120
- }, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError }), decision);
121
+ }, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError }), decision, approverDefectAnnouncer({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice }), approvalWords);
121
122
  const waitMs = Math.max(0, now() - t0);
122
123
  const granting = settleReadRootGrant(resolved.readRootGrant, grantReadRoot, { toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, signal: composedCallSignal(callSignal) });
123
124
  if (granting !== undefined)
124
125
  await granting;
126
+ const deferred = deferredAskOf(resolved, req, checkpointId);
127
+ if (deferred !== undefined)
128
+ deferredAskIdentities.set(req.toolCallId, deferred);
125
129
  if (resolved.approverUnavailable !== true && attestationOf(resolved, req)?.settlement?.kind !== "task_aborted") {
126
130
  humanReviewRef.count += 1;
127
131
  humanReviewRef.totalWaitMs += waitMs;
@@ -27,9 +27,9 @@ export interface PrepareBoundaryParksInput {
27
27
  * absent). Called at park time; never rebuilt here. */
28
28
  saga: SuspendSaga | undefined;
29
29
  /** borrowed-readonly — the REBOUND spec. Read: `resourceSuspend` (the slice scope/ttl/maxSlices), `retainBackgroundProcesses`
30
- * (the park-only sweep gate), `durableApproval` (the review pause's ttl), `principal` (the rows' identity record).
30
+ * (the park-only sweep gate), `durableApproval` (the review pause's ttl), `principal` / `isolationScope` (the rows' identity and partition records).
31
31
  * Never mutated. */
32
- spec: Pick<TaskSpec, "resourceSuspend" | "retainBackgroundProcesses" | "durableApproval" | "principal">;
32
+ spec: Pick<TaskSpec, "resourceSuspend" | "retainBackgroundProcesses" | "durableApproval" | "principal" | "isolationScope">;
33
33
  /** borrowed-readonly — the leg's checkpoint store, or undefined (then the review lane is absent and the resource mint
34
34
  * answers false). */
35
35
  checkpointStore: CheckpointStore | undefined;
@@ -1,27 +1,28 @@
1
1
  import { hasBackgroundShell, sweepBackgroundShells, sweepRunBoundaryBackgroundShells } from "../background-shell.js";
2
2
  import { debitLedger, mintCheckpointId, mintCheckpointToken, } from "../checkpoint-store.js";
3
3
  import { defaultTaskRegistry } from "../task-registry.js";
4
- import { DEFAULT_RESOURCE_TTL_MS, publishCommittedSuspend, sanitizedTtlMs, USAGE_WINDOW_REAP_MARGIN_MS } from "./park-commit.js";
4
+ import { DEFAULT_RESOURCE_TTL_MS, humanReviewSnapshot, publishCommittedSuspend, sanitizedTtlMs, USAGE_WINDOW_REAP_MARGIN_MS } from "./park-commit.js";
5
5
  import { remoteEnvFailureNote } from "./remote-env-retry.js";
6
+ import { isolationScopeRecordOf } from "../isolation-scope.js";
6
7
  export function prepareBoundaryParks(input) {
7
8
  const { saga, spec, checkpointStore, checkpointScope, abortController, harness, session, sessions, sessionId, askSource, deps, priorLedger, maxSlices, maxSuspends, resourceTotal, priorSuspendCount, suspendChainBase, humanReviewRef, liveSpendRef, now, pausedRef, remoteEnvFailures, resourceSuspendEligible, durableSuspendInfraReady, suspendTargetGap } = input;
8
9
  if (saga === undefined)
9
10
  return { suspendForResource: undefined, suspendForPlatformLimit: undefined, suspendForReview: undefined };
10
- const { inFlightSpendMicroUsd, serializeCheckpointState, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle } = saga;
11
+ const { inFlightSpendMicroUsd, serializeCheckpointState, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle, syncChildBlock } = saga;
11
12
  const mintResourceSuspend = async (reason, sliceSpend, hint) => {
12
13
  const rs = spec.resourceSuspend;
13
14
  if (!checkpointStore)
14
- return false;
15
+ return { tag: "not_written", reason: "no CheckpointStore is wired" };
15
16
  const scope = rs?.scope ?? checkpointScope;
16
17
  if (abortController.signal.aborted)
17
- return false;
18
+ return { tag: "not_written", reason: "the run is being cancelled" };
18
19
  if (suspendLoopCapHit(priorLedger?.sliceCount ?? 0, maxSlices, " (resource slice limit)"))
19
- return false;
20
+ return { tag: "fatal", reason: "the resource slice limit (resourceSuspend.maxSlices) is reached" };
20
21
  const leafId = await session.getLeafId();
21
22
  if (!leafId)
22
- return false;
23
+ return { tag: "not_written", reason: "the session has no committed leaf to resume from" };
23
24
  if (abortController.signal.aborted)
24
- return false;
25
+ return { tag: "not_written", reason: "the run is being cancelled" };
25
26
  let remoteHandle;
26
27
  if (suspendableEnv !== undefined) {
27
28
  if (hasBackgroundShell(suspendableEnv))
@@ -30,7 +31,7 @@ export function prepareBoundaryParks(input) {
30
31
  if (!snap.ok) {
31
32
  remoteEnvFailures.push(remoteEnvFailureNote("suspendVM", snap.error, 1));
32
33
  deps.onError?.(new Error(`resource suspendVM failed (${snap.error.code}): ${snap.error.message}`, { cause: snap.error }), { phase: "config", sessionId });
33
- return false;
34
+ return { tag: "not_written", reason: `the execution environment refused to suspend (${snap.error.code})` };
34
35
  }
35
36
  remoteHandle = { ...suspendableEnv.workspaceHandle(), snapshotId: snap.value };
36
37
  }
@@ -46,6 +47,7 @@ export function prepareBoundaryParks(input) {
46
47
  const cp = {
47
48
  token,
48
49
  checkpointId: mintCheckpointId(),
50
+ ...syncChildBlock,
49
51
  scope,
50
52
  sessionId,
51
53
  leafId,
@@ -56,15 +58,17 @@ export function prepareBoundaryParks(input) {
56
58
  createdAt: mintedAt,
57
59
  deadline: mintedAt + Math.max(sanitizedTtlMs(rs?.ttlMs) ?? DEFAULT_RESOURCE_TTL_MS, hint !== undefined ? hint.resumeAfterMs + USAGE_WINDOW_REAP_MARGIN_MS : 0),
58
60
  suspendCount: priorSuspendCount,
59
- humanReview: humanReviewRef.count > 0
60
- ? { count: humanReviewRef.count, totalWaitMs: humanReviewRef.totalWaitMs, gates: [...humanReviewRef.gates] }
61
- : undefined,
61
+ humanReview: humanReviewSnapshot(humanReviewRef),
62
62
  resourceLedger: resourceLedgerOut,
63
63
  ...(spec.durableApproval !== undefined ? { durableApproval: { ...spec.durableApproval } } : {}),
64
64
  ...(spec.principal ? { principal: spec.principal } : {}),
65
+ ...isolationScopeRecordOf(spec),
65
66
  };
66
- if ((await commitSuspendSaga(token, cp, suspendableEnv, remoteHandle)).tag !== "committed")
67
- return false;
67
+ const saga = await commitSuspendSaga(token, cp, suspendableEnv, remoteHandle);
68
+ if (saga.tag === "unknown" || saga.tag === "compensation_failed")
69
+ return { tag: "fatal", reason: saga.reason };
70
+ if (saga.tag !== "committed")
71
+ return { tag: "not_written", reason: saga.tag === "absent" && saga.reason !== undefined ? saga.reason : "the checkpoint was not written" };
68
72
  publishCommittedSuspend({ pausedRef }, token, gate, scope, remoteHandle, cp.checkpointId, cp.pendingAction);
69
73
  try {
70
74
  await sessions.pin?.(sessionId);
@@ -73,7 +77,7 @@ export function prepareBoundaryParks(input) {
73
77
  deps.onError?.(pinErr, { phase: "config", sessionId });
74
78
  }
75
79
  harness.requestStopAfterTurn();
76
- return true;
80
+ return { tag: "committed" };
77
81
  };
78
82
  const suspendForResource = resourceSuspendEligible ? mintResourceSuspend : undefined;
79
83
  const suspendForPlatformLimit = durableSuspendInfraReady ? mintResourceSuspend : undefined;
@@ -129,6 +133,7 @@ export function prepareBoundaryParks(input) {
129
133
  const cp = {
130
134
  token,
131
135
  checkpointId: mintCheckpointId(),
136
+ ...syncChildBlock,
132
137
  scope,
133
138
  sessionId,
134
139
  leafId,
@@ -140,12 +145,11 @@ export function prepareBoundaryParks(input) {
140
145
  suspendedAt: now(),
141
146
  deadline: mintedAt + (sanitizedTtlMs(spec.durableApproval?.ttlMs) ?? DEFAULT_RESOURCE_TTL_MS),
142
147
  suspendCount: suspendChainBase() + 1,
143
- humanReview: humanReviewRef.count > 0
144
- ? { count: humanReviewRef.count, totalWaitMs: humanReviewRef.totalWaitMs, gates: [...humanReviewRef.gates] }
145
- : undefined,
148
+ humanReview: humanReviewSnapshot(humanReviewRef),
146
149
  resourceLedger: reviewLedger,
147
150
  sourceSessionId: askSource.sourceSessionId,
148
151
  ...(spec.principal ? { principal: spec.principal } : {}),
152
+ ...isolationScopeRecordOf(spec),
149
153
  ...(spec.durableApproval !== undefined ? { durableApproval: { ...spec.durableApproval } } : {}),
150
154
  };
151
155
  if ((await commitSuspendSaga(token, cp, suspendableEnv, remoteHandle)).tag !== "committed")
@@ -37,6 +37,7 @@ import type { AssertAllKeysHandled } from "../ask-origin.js";
37
37
  import { type ChildClampSource } from "../child-clamp-seats.js";
38
38
  import type { InheritedGate, Prepared, RunInternals, RunnerSelfSeat, ToolFaceSnapshot } from "./contracts.js";
39
39
  import { type BlockedRef } from "./synthetic-tools.js";
40
+ import type { ToolMountFacts } from "../tool-mount-facts.js";
40
41
  import { RosterBuilder } from "../tool-roster.js";
41
42
  import type { ParentSpecSeat } from "../parent-spec-seat.js";
42
43
  import { type RosterSpec } from "./caller-roster.js";
@@ -57,7 +58,7 @@ export interface PrepareCapsAndWorkflowInput {
57
58
  /** borrowed-readonly — the trusted spawn-side channel; the Workflow mount forwards `rootSessionId`, `placementRoot`,
58
59
  * `onTaskNotification`, `workflowDepth`, the capture-floor getter reads `memoryCaptureAncestors`, and the arming reads
59
60
  * the chain's auto-mode face (`inheritedGate.autoModeFace`). */
60
- internals: Pick<RunInternals, "rootSessionId" | "rootSessionIncarnation" | "placementRoot" | "onTaskNotification" | "workflowDepth" | "memoryCaptureAncestors" | "workflowParkedResume" | "holder" | "questionFaceStripped" | "inheritedGate"> | undefined;
61
+ internals: Pick<RunInternals, "rootSessionId" | "rootSessionIncarnation" | "rootSessionScope" | "placementRoot" | "onTaskNotification" | "workflowDepth" | "memoryCaptureAncestors" | "workflowParkedResume" | "holder" | "questionFaceStripped" | "inheritedGate"> | undefined;
61
62
  /** borrowed-readonly — the tree's cross-boundary token (inherited or minted), which the Workflow mount hands to its children. */ crossBoundaryTree: import("../cross-boundary-taint.js").CrossBoundaryTreeToken;
62
63
  /** borrowed-readonly — the tree's owner seat, which the Workflow mount hands to its children (by reference). */ delegationOwner: import("./delegation-owner.js").DelegationOwnerSeat;
63
64
  /** borrowed-readonly — the acquired session; the classifier leg rebuilds its transcript window from `buildContext`. */
@@ -115,7 +116,12 @@ export interface PrepareCapsAndWorkflowInput {
115
116
  taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
116
117
  /** borrowed-readonly — the plan-review primitive the ExitPlanMode tool calls. */
117
118
  requestReview: (opts?: import("../present-plan-tool.js").ReviewRequest) => void;
119
+ /** borrowed-readonly — the run's one "no suspend target" fact for its per-task env (`suspendTargetGapOf`; absent: it has a target, or has none to name): ExitPlanMode answers from it that the run is not pausing. */
120
+ suspendTargetGap: string | undefined;
118
121
  /** borrowed-readonly — the declared session plan file as ExitPlanMode's FILE arm reads it (absent ⇒ the parameter arm). */ planFileSource?: PlanFileSource;
122
+ /** borrowed-readonly — the leg's mount facts as the driver read them once (the task's word, the seats, the environment,
123
+ * the leg's shape): stated on the roster's ledger the moment the roster opens, before any mount site asks. */
124
+ mountFacts: ToolMountFacts;
119
125
  /** borrowed-readonly — the plan-mode primitive the EnterPlanMode tool calls: a steer of the leg's mode seat into `plan`. */
120
126
  enterPlanMode: () => Promise<void>;
121
127
  /** borrowed-readonly — the leg's live permission-mode seat: the arming's first arm is `declared === "auto"`, and the
@@ -137,7 +143,9 @@ export interface PrepareCapsAndWorkflowInput {
137
143
  /** borrowed-readonly — the peer lane's mount verdict (the classifier's cross-session rule fills only while mounted). */
138
144
  peerLaneActive: boolean;
139
145
  /** borrowed-readonly — the leg's effective delegation fact (`effectiveDelegationFacts`): the classifier window shows its user lane as the launching agent's. */
140
- delegated: boolean;
146
+ delegated: boolean; /** borrowed-readonly — the leg's checkpoint scope (a forced root's synthesized opt-in's). */
147
+ checkpointScope: string; /** borrowed-readonly — the driver's one leg fact (`approvalParkNotResumableOf`): with the scope, the EFFECTIVE opt-in the workflow mount forwards. */
148
+ approvalParkNotResumable: boolean;
141
149
  /** borrowed-mutable — `Prepared.sideCallBookRef`: written by the run body (never here); the classifier books each of its replies through it. */
142
150
  sideCallBookRef: Prepared["sideCallBookRef"];
143
151
  /** borrowed-readonly — whether the BUILT-IN SendMessage is on this face (the lane rule's second term). */