@sema-agent/core 7.58.0 → 7.60.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 (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  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 +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -23,6 +23,16 @@ export interface PlanFileSource {
23
23
  readonly shown: string;
24
24
  readonly read: (signal?: AbortSignal) => Promise<import("./runner/advertised-writable-dirs.js").PlanFileReading>;
25
25
  }
26
+ /**
27
+ * What the engine's plan-pause request primitive takes: the requester's own `reason`, and `requestedByCallId` — the id of
28
+ * the call that asks, which the ENGINE binds from that call's own context (the first-party tool passes its ctx's
29
+ * `toolCallId`; a caller tool's `ctx.requestReview` is wrapped per call), never a tool-supplied argument. Parked on the
30
+ * `plan_review` row as provenance: which call presented the plan awaiting a decision.
31
+ */
32
+ export interface ReviewRequest {
33
+ reason?: string;
34
+ requestedByCallId?: string;
35
+ }
26
36
  /**
27
37
  * design/80 D-B — the first-party `present_plan` tool (CC `ExitPlanMode` parity). A THIN composition over the
28
38
  * general `ctx.requestReview()` primitive: the model calls it with a plan; the tool returns the plan as its
@@ -31,6 +41,4 @@ export interface PlanFileSource {
31
41
  * NO side effect (`effect:"read"`); the actual pause/mint is the engine's, gated on a wired `checkpointStore`.
32
42
  * `requestReview` is the prepare-task closure (the same primitive `ctx.requestReview` exposes to caller tools).
33
43
  */
34
- export declare function createPresentPlanTool(requestReview: (opts?: {
35
- reason?: string;
36
- }) => void, planFile?: PlanFileSource): ToolSpec;
44
+ export declare function createPresentPlanTool(requestReview: (opts?: ReviewRequest) => void, planFile?: PlanFileSource): ToolSpec;
@@ -114,9 +114,9 @@ export function createPresentPlanTool(requestReview, planFile) {
114
114
  description: "Your full proposed plan, in markdown. The human reviewer approves / edits / rejects it before you act.",
115
115
  }),
116
116
  }),
117
- execute: async (args) => {
117
+ execute: async (args, ctx) => {
118
118
  const { plan } = args;
119
- requestReview({ reason: "ExitPlanMode" });
119
+ requestReview({ reason: "ExitPlanMode", ...(typeof ctx?.toolCallId === "string" && ctx.toolCallId !== "" ? { requestedByCallId: ctx.toolCallId } : {}) });
120
120
  return {
121
121
  content: `Plan presented for human review:\n\n${delimitUntrusted("plan", plan)}\n\n` +
122
122
  "(The run is pausing for approval — you will continue once the plan is approved, edited, or rejected.)",
@@ -7,8 +7,8 @@
7
7
  * transport writes itself (an MCP request's session, protocol version, content type, accept and resume headers) is the
8
8
  * protocol's: neither a seat's answer nor the principal header owns it. The hosted-connector assertion header
9
9
  * ({@link MCP_ASSERTION_HEADER}) is the seat's to answer and never the principal header's name. A header the credential
10
- * vocabulary reads as a credential is one the engine holds from the moment it resolves it: no child spawned on this host
11
- * inherits a variable whose value equals it (`holdOwnCredentialValues`, src/core/secret-env.ts).
10
+ * vocabulary reads as a credential is one the engine holds from the moment the seat answers it, before the answer is judged
11
+ * (the carrier's one intake, src/core/peer-seat.ts): no child spawned on this host inherits a variable whose value equals it.
12
12
  *
13
13
  * A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
14
14
  * peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
@@ -54,6 +54,8 @@ export declare function resolveProtocolHttpHeaders(protocol: ProtocolId, t: Prot
54
54
  /** The engine's default request headers under the declared ones: a declared name, in any case, owns that header
55
55
  * (the default of the same name is not sent beside it). */
56
56
  export declare function underDeclaredHeaders(defaults: Readonly<Record<string, string>>, declared: Record<string, string> | undefined): Record<string, string>;
57
+ /** A header value as the transport sends it: the HTTP whitespace at its two edges is not part of the value (WHATWG `Headers`). */
58
+ export declare const httpTrimmed: (value: string) => string;
57
59
  /**
58
60
  * A peer's error text with what the peer was SENT taken out of it. Both kinds of removal are found on the ORIGINAL text (so no marker is
59
61
  * rescanned and no replacement can disturb what another one reads) and the ranges they take are merged, one marker per merged range: every
@@ -69,6 +71,16 @@ export declare function underDeclaredHeaders(defaults: Readonly<Record<string, s
69
71
  * whole marker with it, so the pass over its own output answers the same text.
70
72
  */
71
73
  export declare function scrubRequestEcho(text: string, declared: readonly string[]): string;
74
+ /**
75
+ * A remote's own account of itself read without the credentials its connection's requests carried — THE one eraser of what a successful
76
+ * dial or listing hands the engine (an MCP server's `serverInfo`, instructions and tool listing; an A2A peer's card). The needle is
77
+ * `credentials` (the connection's credential values, `PeerCarrier.credentials`): every occurrence of one, in any spelling the
78
+ * request-echo derivation gives it ({@link requestEchoSpellings}) and in any letter case, becomes the redaction mark in place, the way
79
+ * {@link scrubRequestEcho} takes a declared value out of a failure's words. Nothing else is taken — no Cookie member, no vocabulary
80
+ * guess: the rest of the text is the remote's own account, and only the needle is the engine's to withhold. A text with no needle in it
81
+ * is returned as it was (the same string). The function is a fixed point.
82
+ */
83
+ export declare function eraseSentCredentials(text: string, credentials: readonly string[]): string;
72
84
  /**
73
85
  * THE one form a remote endpoint's words take when the engine carries them in its own words — an MCP server's failure, a model
74
86
  * provider's error body, frame or transport failure, a memory distiller seat's failure: what the request was declared with
@@ -1,4 +1,4 @@
1
- import { authSchemeCredentials, credentialHeaderValues, holdOwnCredentialValues } from "./secret-env.js";
1
+ import { authSchemeCredentials } from "./secret-env.js";
2
2
  import { egressText } from "./untrusted-egress.js";
3
3
  import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
4
4
  import { inlineUntrusted } from "./untrusted-text.js";
@@ -30,7 +30,6 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
30
30
  const principalHeader = t.principalHeader;
31
31
  const answered = t.headers;
32
32
  const own = { ...(answered !== undefined ? { headers: { ...answered } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) };
33
- holdOwnCredentialValues(credentialHeaderValues(own.headers));
34
33
  const collision = headerOwnershipCollision(own, protocol);
35
34
  if (collision !== undefined) {
36
35
  const problem = collision.engineOwned
@@ -49,7 +48,7 @@ export function underDeclaredHeaders(defaults, declared) {
49
48
  const owned = new Set(Object.keys(declared ?? {}).map((k) => k.toLowerCase()));
50
49
  return { ...Object.fromEntries(Object.entries(defaults).filter(([k]) => !owned.has(k.toLowerCase()))), ...declared };
51
50
  }
52
- const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
51
+ export const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
53
52
  function percentEncoded(value) {
54
53
  try {
55
54
  return encodeURIComponent(value);
@@ -105,7 +104,14 @@ function structuredEnd(text, at) {
105
104
  return text.length;
106
105
  }
107
106
  export function scrubRequestEcho(text, declared) {
108
- const removed = requestEchoRanges(text, declared);
107
+ return markedOver(text, requestEchoRanges(text, declared));
108
+ }
109
+ export function eraseSentCredentials(text, credentials) {
110
+ if (credentials.length === 0 || text === "")
111
+ return text;
112
+ return markedOver(text, needleRanges(text, credentials, []));
113
+ }
114
+ function markedOver(text, removed) {
109
115
  if (removed.length === 0)
110
116
  return text;
111
117
  removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
@@ -122,13 +128,16 @@ export function scrubRequestEcho(text, declared) {
122
128
  return out + text.slice(kept);
123
129
  }
124
130
  function requestEchoRanges(text, declared) {
131
+ const members = cookieMembers(text);
132
+ return [...members.map(([, from, end]) => [from, end]), ...needleRanges(text, declared, members)];
133
+ }
134
+ function needleRanges(text, values, members) {
125
135
  const forms = new Set();
126
- for (const value of declared)
136
+ for (const value of values)
127
137
  for (const spelling of requestEchoSpellings(value))
128
138
  forms.add(spelling);
129
139
  forms.delete("");
130
- const members = cookieMembers(text);
131
- const removed = members.map(([, from, end]) => [from, end]);
140
+ const removed = [];
132
141
  const markers = redactionMarkerSpans(text);
133
142
  for (const hit of valueHits(text, [...forms])) {
134
143
  if (members.some(([name, from]) => hit[0] >= name && hit[1] <= from))
@@ -12,8 +12,8 @@ import { type ReadDenyEntry } from "../tools/fs/index.js";
12
12
  * into meaningless one-character entries with zero refusal. Garbage must refuse loudly at the door,
13
13
  * never be consumed letter by letter. */
14
14
  export declare function assertStringArraySeat(value: unknown, seat: string, entryLaw: "strings" | "compiler-owned"): void;
15
- /** The three DEPLOYMENT read-deny seats. */
16
- export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"];
15
+ /** The four DEPLOYMENT read-deny seats: the table's three, and whether the deployment requires the byte floor kept. */
16
+ export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"];
17
17
  export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number];
18
18
  /**
19
19
  * The copy a read-deny seat keeps of its declared value — the one copy law of both doors that admit one (`new Runner`
@@ -24,7 +24,9 @@ export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number]
24
24
  export declare function copyReadDenySeat(value: unknown): unknown;
25
25
  /**
26
26
  * Screen one deployment read-deny seat's value with the laws a prepare applies to it (the array door and the
27
- * one compiler's entry law for the additions; the built-in table's tier / row-name law for the other two) and
28
- * return a copy; `undefined` stays `undefined` (no declaration).
27
+ * one compiler's entry law for the additions; the built-in table's tier / row-name law for the next two; a boolean
28
+ * for the floor requirement) and return a copy; `undefined` stays `undefined` (no declaration — for the requirement,
29
+ * the documented reading "not required", under which an unkept floor is still announced).
29
30
  */
30
- export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | undefined;
31
+ export declare function screenReadDenySeat(seat: "readDenyFloorRequired", value: unknown): boolean | undefined;
32
+ export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | boolean | undefined;
@@ -1,4 +1,5 @@
1
1
  import { compileReadDeny, readDenyBuiltinConfigOf } from "../tools/fs/index.js";
2
+ import { screenReadDenyFloorRequired } from "../tools/fs/read-floor.js";
2
3
  export function assertStringArraySeat(value, seat, entryLaw) {
3
4
  if (value === undefined)
4
5
  return;
@@ -18,7 +19,7 @@ export function assertStringArraySeat(value, seat, entryLaw) {
18
19
  }
19
20
  }
20
21
  }
21
- export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"]);
22
+ export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"]);
22
23
  export function copyReadDenySeat(value) {
23
24
  if (!Array.isArray(value))
24
25
  return value;
@@ -27,6 +28,8 @@ export function copyReadDenySeat(value) {
27
28
  export function screenReadDenySeat(seat, value) {
28
29
  if (value === undefined)
29
30
  return undefined;
31
+ if (seat === "readDenyFloorRequired")
32
+ return screenReadDenyFloorRequired(value, `RunnerDeps.${seat}`);
30
33
  if (seat === "readDenyPatterns") {
31
34
  assertStringArraySeat(value, `RunnerDeps.${seat}`, "compiler-owned");
32
35
  const entries = copyReadDenySeat(value);
@@ -1,12 +1,13 @@
1
1
  /** The marks, by what they stand for. `whole` is the bare mark (a span removed whole — a credential value, a floor, a
2
2
  * depth cut); the others name the shape that was withheld: `credentials` a URL's userinfo, `url` a whole URL, `path` an
3
- * absolute filesystem path. A mark the engine writes is exactly one of these four. */
4
- export declare const REDACTION_MARKS: {
3
+ * absolute filesystem path. A mark the engine writes is exactly one of these four. Frozen: the table is exported to hosts, and every
4
+ * pass reads it at call time, so a write by a reader would change what the engine writes. */
5
+ export declare const REDACTION_MARKS: Readonly<{
5
6
  readonly whole: "[redacted]";
6
7
  readonly credentials: "[redacted-credentials]";
7
8
  readonly url: "[redacted-url]";
8
9
  readonly path: "[redacted-path]";
9
- };
10
+ }>;
10
11
  /** The bare mark — what a host compares against to tell that the engine withheld a value. */
11
12
  export declare const REDACTION_MARK: "[redacted]";
12
13
  /** Where the marks sit in `s`, one [start, end) span at a time, leftmost first. Lazy: a reader that stops early (a display cut stops
@@ -1,9 +1,9 @@
1
- export const REDACTION_MARKS = {
1
+ export const REDACTION_MARKS = Object.freeze({
2
2
  whole: "[redacted]",
3
3
  credentials: "[redacted-credentials]",
4
4
  url: "[redacted-url]",
5
5
  path: "[redacted-path]",
6
- };
6
+ });
7
7
  export const REDACTION_MARK = REDACTION_MARKS.whole;
8
8
  const escapeLiteral = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
9
9
  const REDACTION_MARKER_RE = new RegExp(Object.values(REDACTION_MARKS).map(escapeLiteral).join("|"), "g");
@@ -9,9 +9,12 @@
9
9
  * exactly like `CheckpointStore` (design/45). Core owns the seam shape; service owns the backend.
10
10
  *
11
11
  * Design rulings folded in (design/48 §10/§11 DeepSeek council):
12
- * - **#1 [blocker] interface extension, not capability probing**: `RemoteExecutionEnv extends ExecutionEnv`.
13
- * The base {@link ExecutionEnv} is UNCHANGED — `NodeExecutionEnv`/`StubExecutionEnv` need zero edits, and a
14
- * consumer that only needs buffered fs/shell keeps accepting the base type.
12
+ * - **#1 [blocker] interface extension, not capability probing**: `RemoteExecutionEnv extends ExecutionEnv` with
13
+ * the lifecycle and streaming METHODS a remote workspace has; a consumer that only needs buffered fs/shell keeps
14
+ * accepting the base type. What an environment can DO is not part of this extension: it is the base type's own
15
+ * required block ({@link ExecutionEnvCapabilities}, #2891), declared by every environment, local or remote, and
16
+ * read through the readers at the end of this file. The interface answers only whether the remote methods can be
17
+ * called ({@link isRemoteExecutionEnv}); it never answers a capability.
15
18
  * - **#3 [major] do not overload `exec`**: `exec()` stays buffered; streaming is a NEW {@link execStream}.
16
19
  * - **#4 [major] suspend × in-flight exec must not hang**: see {@link suspendVM}.
17
20
  * - **#8 [major] post-resume consistency**: see {@link postResumeInit}.
@@ -25,7 +28,7 @@
25
28
  * mapping; tier *classification* (the static table + Tier1-safe allow-list + fail-closed routing) — all are
26
29
  * service/design-45 implementation-time concerns. Core only declares the seam those will plug into.
27
30
  */
28
- import type { ExecutionEnv } from "../internal/harness-types.js";
31
+ import type { ExecutionEnv, ExecutionEnvCapabilities } from "../internal/harness-types.js";
29
32
  /** Snapshot identifier returned by {@link RemoteExecutionEnv.suspendVM}; opaque to core, resolved by the provider. */
30
33
  export type SnapshotId = string;
31
34
  /**
@@ -226,7 +229,7 @@ export type RemoteExecutionErrorCode =
226
229
  | "liveness_no_output"
227
230
  /**
228
231
  * The op is not supported by this adapter's capabilities (design/61 §9 A) — e.g. `suspendVM`/`resumeVM` on a
229
- * non-suspendable SSH/ADB env. Permanent for this env; check {@link RemoteExecutionEnv.capabilities} first.
232
+ * non-suspendable SSH/ADB env. Permanent for this env; check its declaration ({@link declaredSuspend}) first.
230
233
  */
231
234
  | "unsupported"
232
235
  /**
@@ -318,67 +321,6 @@ export declare class RemoteExecutionError extends Error {
318
321
  * idempotency; the adapter MUST NOT blind-retry.
319
322
  */
320
323
  export interface RemoteExecutionEnv extends ExecutionEnv {
321
- /**
322
- * What this adapter can actually do (design/61 §9 A, council). The seam was built for E2B (a full
323
- * `{isolation:true, suspendable:true}` adapter); **partial-capability** adapters (SSH/ADB: `{false, false}`
324
- * — a real machine/device, not snapshotable and not isolated) declare it here. **Required + explicit** so
325
- * the orchestrator never has to guess: there is no safe default (assuming isolation when there is none is a
326
- * security hole; assuming suspendable crashes on `suspendVM`). Use {@link isSuspendable}/{@link isIsolated}/{@link processTableOf}
327
- * rather than the structural {@link isRemoteExecutionEnv} (method presence ≠ semantics — a stub `suspendVM`
328
- * that returns `"unsupported"` still satisfies the structural check). Extensible: add fields as new
329
- * partial-capability classes appear.
330
- */
331
- readonly capabilities: {
332
- /** True iff actions are contained (E2B microVM); false for a real target (SSH host / ADB device). The
333
- * orchestrator tightens autonomy + the design/37 policy gate when this is false (design/53 zero-trust). */
334
- isolation: boolean;
335
- /** True iff the env can be snapshot/`suspendVM`'d (E2B); false for SSH/ADB (durable suspend N/A).
336
- *
337
- * ⚠️ LOAD-BEARING INVARIANT (opus review 1.257.2): `suspendable:false` on a remote env also asserts
338
- * the workspace is EXTERNALLY DURABLE — it persists on the target across the env object's lifetime
339
- * (true for SSH hosts / ADB devices). The durable-park-only suspend degrade rests
340
- * on this: it skips `suspendVM` and trusts the factory to reconnect to the SAME workspace on resume.
341
- * An adapter for a non-suspendable EPHEMERAL backend (e.g. a snapshot-less container torn down with
342
- * the transport) must NOT be modeled as `suspendable:false` remote — it would silently take the
343
- * park-only branch and resume onto a fresh empty workspace. Model such a backend as a per-task env
344
- * without durable suspend instead (the human gate refuses it), or extend capabilities with an
345
- * explicit workspace-durability flag before building one. */
346
- suspendable: boolean;
347
- /** True iff this adapter's {@link FileSystem.canonicalPath} is the AUTHORITY on where a path lands —
348
- * it answers for the very filesystem the commands run on, and a failure to answer is a failure of
349
- * the resolver rather than a namespace it cannot see into. Optional, and absent is not a
350
- * declaration: an adapter that says nothing keeps the lexical verdict for a chain its resolver answers
351
- * `not_supported` (no file face); a resolver that FAILS (any other non-answer) is a failure either way —
352
- * the read station records it and the command is unanswered. Declaring it says that even an
353
- * unanswerable chain is a question, not an absence — and the read
354
- * boundary's execute-time recheck then refuses rather than passing the written spelling through.
355
- * Read STRICTLY through {@link canonicalPathIsAuthoritative}, like every other capability whose
356
- * `true` changes what a containment leg does; a wrong-SHAPE value reads absent and is announced. */
357
- canonicalPathAuthoritative?: boolean;
358
- /** True iff the commands this env runs are processes on a table that holds THIS process — the table the
359
- * engine itself and the processes above it are on, so a kill the model writes there can reach them.
360
- * `true` for an adapter that spawns the commands as this process's own descendants (a host lane), and
361
- * for one whose commands run in a PID namespace that contains this process's (the host of the container
362
- * the engine runs in); `false` only for one whose commands run where this process is not: another
363
- * machine (SSH host, device, cloud sandbox) or a PID namespace this process is not in (a sandbox
364
- * container, a pod). Not {@link isolation}: a non-isolated SSH host is a real machine and still another
365
- * table. The self-preservation guard of the Bash tool asks its question exactly when this is `true`
366
- * (and for every env that is not remote at all), and does not ask where it is `false`.
367
- *
368
- * What a `true` buys is the guard's question exactly as a NodeExecutionEnv gets it, limits included: on this
369
- * process's own table, of the platform's `pgrep`, with the kill's words as written, from this process's own
370
- * working directory. It is put as for this process's descendants, so for commands on the same table that
371
- * are not (SSH to `localhost`) BSD's `pgrep` leaves its OWN caller's ancestors out where the real kill would
372
- * not, and from an enclosing namespace the question sees only this process's namespace, not the ancestors
373
- * above it.
374
- *
375
- * REQUIRED, with no default: either reading of an absent value is wrong somewhere (assuming `true`
376
- * refuses an ordinary `pkill` in a sandbox because a word matched this engine here; assuming `false`
377
- * lets a host lane's `pkill` end the session that issued it). So an absent or non-boolean value is
378
- * announced once per run at the env's admission point and the guard refuses every pattern kill that needs the question on
379
- * that env (`pkill -P $$` runs), naming this declaration, until the adapter states it. Read through {@link processTableOf}. */
380
- sharesProcessTable: boolean;
381
- };
382
324
  /** Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds. */
383
325
  workspaceHandle(): WorkspaceHandle;
384
326
  /** Provision/attach the remote workspace and inject secrets. Returns the resulting {@link WorkspaceHandle}. */
@@ -571,7 +513,10 @@ export interface ExecutionEnvFactoryContext {
571
513
  export type ExecutionEnvFactory = (ctx: ExecutionEnvFactoryContext) => ExecutionEnv | Promise<ExecutionEnv>;
572
514
  /** True when `env` exposes a lifecycle {@link RemoteExecutionEnv.destroy} the Runner should call on task end. */
573
515
  export declare function hasDestroy(env: ExecutionEnv): env is ExecutionEnv & Pick<RemoteExecutionEnv, "destroy">;
574
- /** Structural check that `env` implements the remote seam (lifecycle + streaming surface + declared capabilities). */
516
+ /** Structural check that `env` implements the remote seam (lifecycle + streaming surface), answering only whether
517
+ * those methods can be called — never a capability. The block conjunct keeps an adapter that carries no capability
518
+ * block at all (a JS adapter the compiler never saw) off the remote paths, as before the block moved to the base; it
519
+ * is read off the block's one receipt ({@link capabilityReceiptOf}), never off the adapter again. */
575
520
  export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteExecutionEnv;
576
521
  /**
577
522
  * The RESTORE half of the suspend contract — the methods the RESUME leg calls after a `suspendVM`
@@ -585,17 +530,94 @@ export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteEx
585
530
  * the resume leg — a different process, hours later — with a bare `env.resumeVM is not a function`.
586
531
  */
587
532
  export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("resumeVM" | "postResumeInit")[];
533
+ /**
534
+ * The capability readers (#2891). Every key of {@link ExecutionEnvCapabilities} is read through exactly one of the
535
+ * functions below, on every environment — a local one declares the block as a remote one does, so no reader asks the
536
+ * remote INTERFACE first and none gives a non-remote environment a fixed answer.
537
+ *
538
+ * Each reader takes only the boolean the adapter declared, off the block's one receipt ({@link capabilityReceiptOf}):
539
+ * the adapter's block is read once and every reader reads that frozen copy. A value that is absent, not a boolean, or
540
+ * cannot be received (a throwing getter, a Proxy) is no declaration, and the reader answers that key's SAFE side, one
541
+ * row per key in {@link UNDECLARED_CAPABILITY_READING}. The readers never throw and never announce: the admission
542
+ * census does, once per run per finding (`config.execution_env_capability_invalid`).
543
+ */
544
+ export declare const UNDECLARED_CAPABILITY_READING: {
545
+ readonly isolation: {
546
+ readonly reads: false;
547
+ readonly so: "no reader treats the environment as a sandbox: autonomy, the policy tiers and the read boundary's containment legs stay on their checking side";
548
+ };
549
+ readonly suspendable: {
550
+ readonly reads: "undeclared";
551
+ readonly so: "the snapshot reader takes only a declared `true` and the park-only lane only a declared `false`, so the environment is neither snapshot nor parked, and a run on it cannot suspend durably";
552
+ };
553
+ readonly sharesProcessTable: {
554
+ readonly reads: "undeclared";
555
+ readonly so: "whether the commands it runs are processes on this engine's own process table has no default, so the Bash tool refuses every pattern kill that needs the question (`pkill`, `killall`, a `kill` fed by `pgrep`; `pkill -P $$`, the shell's own children, runs) on this environment — declare `true` when its commands run on a table that holds the engine (a host lane, or a PID namespace that contains the engine's), `false` only when they run where the engine is not (another machine, a PID namespace that does not contain it)";
556
+ };
557
+ readonly canonicalPathAuthoritative: {
558
+ readonly reads: true;
559
+ readonly so: "its resolver's silence is read as a failure, so a command chain it cannot answer at all is refused at the read boundary's execute-time recheck instead of passing on its written spelling";
560
+ };
561
+ readonly hostLocalPaths: {
562
+ readonly reads: "undeclared";
563
+ readonly so: "the engine does not treat a path this environment names as the host's own file, and a worktree child on it is refused (its tree can be neither compared nor exempted)";
564
+ };
565
+ readonly externalContentTarget: {
566
+ readonly reads: "undeclared";
567
+ readonly so: "what it produces is treated as content from outside the deployment's trust boundary (the memory session mark), and a call that reaches it owes what reaching the target and what leaving it both owe (the cross-boundary taint)";
568
+ };
569
+ readonly io: {
570
+ readonly reads: "undeclared";
571
+ readonly so: "no shell face mounts on it, and what it names is still read through it (the project marker), never past its own read limits";
572
+ };
573
+ readonly keepsReadFloor: {
574
+ readonly reads: false;
575
+ readonly so: "it is read as not keeping the byte floor, so a run whose read-deny table is non-empty is announced as such (`config.read_deny_floor_unkept`), or refused at prepare when the deployment sets `readDenyFloorRequired`";
576
+ };
577
+ };
578
+ /** The keys of {@link ExecutionEnvCapabilities}, in declaration order — the census walks exactly these. */
579
+ export declare const CAPABILITY_KEYS: ReadonlyArray<keyof ExecutionEnvCapabilities>;
580
+ /** One finding of a block's receipt: a key of the block not declared as a boolean (`expected: "boolean"`), the block itself
581
+ * when it is not an object or cannot be received (`key: "capabilities"`, `expected: "object"`), or a member the block carries
582
+ * that is no capability (`expected: "absent"`: a misspelled or retired key, whose value no reader takes). */
583
+ export interface CapabilityBlockFinding {
584
+ readonly key: string;
585
+ /** The type the member carries (`"undefined"` where it is absent), or `"unreadable"` where it could not be received. */
586
+ readonly valueType: string;
587
+ readonly expected: "boolean" | "object" | "absent";
588
+ }
589
+ /** What the engine holds of an environment's capability block: the booleans it declares (the eight keys only, frozen), whether the block is
590
+ * an object at all (the remote predicate's block conjunct), and the receipt's findings, in key order and then member order. */
591
+ export interface CapabilityReceipt {
592
+ readonly declared: Readonly<Partial<Record<keyof ExecutionEnvCapabilities, boolean>>>;
593
+ readonly blockIsObject: boolean;
594
+ readonly findings: readonly CapabilityBlockFinding[];
595
+ }
596
+ /**
597
+ * The ONE receipt of an environment's capability block: read off the adapter once per environment object — at its first read,
598
+ * which for a run's environment is the run's admission census — and held frozen; every reader, the census and the remote
599
+ * predicate read this receipt and never the adapter again, so what the census announced is what every reader acts on, and a
600
+ * block the host changes afterwards changes nothing the engine reads. A value that is not an object (a JS caller's `null`) has
601
+ * no block and is not remembered. Total: it never throws.
602
+ */
603
+ export declare function capabilityReceiptOf(env: Pick<ExecutionEnv, "capabilities">): CapabilityReceipt;
604
+ /**
605
+ * What this environment declares about snapshots, in three states: `true` (it can be snapshot and restored), `false`
606
+ * (it cannot — and, on a remote environment, its workspace is externally durable, the park-only degrade's premise), or
607
+ * `"undeclared"` (absent, not a boolean, unreadable). The snapshot reader ({@link isSuspendable}) takes only `true`, the
608
+ * suspend paths' park-only lane only `false`; an undeclared environment is in neither, so a run on it cannot suspend
609
+ * durably.
610
+ */
611
+ export declare function declaredSuspend(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
588
612
  /**
589
613
  * Can this env be durably suspended/snapshotted (design/61 §9 A)? Use this — NOT the structural
590
614
  * {@link isRemoteExecutionEnv} — before calling `suspendVM` (a non-suspendable SSH/ADB env declares
591
- * `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`). Non-remote
592
- * (in-process) envs are not suspendable.
615
+ * `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`). An environment
616
+ * without the remote interface has no `suspendVM` to call, whatever it declares.
593
617
  *
594
- * A composite type guard (structural AND capability) so a `suspendVM` call site narrowed by THIS predicate
595
- * gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
596
- * The capability is read STRICTLY, like the containment ones: a non-boolean reads as NOT suspendable and
597
- * the census announces it. This took anything truthy, so `suspendable: "false"` was snapshotted — the one
598
- * key of the three whose malformed reading fell on the unsafe side.
618
+ * A composite type guard (declaration AND interface AND restore surface) so a `suspendVM` call site narrowed by THIS
619
+ * predicate gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
620
+ * The declaration is read through {@link declaredSuspend}: only the boolean `true` counts.
599
621
  *
600
622
  * It also requires the RESTORE surface ({@link missingRestoreSurface}). A suspend is only durable
601
623
  * if something can undo it; an adapter that offers `suspendVM` but no `resumeVM` used to pass this guard,
@@ -605,25 +627,23 @@ export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("res
605
627
  *
606
628
  * ⚠️ A capability-DECLARING but restore-incomplete adapter must NOT be re-routed to the durable-park-only
607
629
  * degrade by this predicate returning false — park-only rests on the workspace being externally durable
608
- * (see {@link RemoteExecutionEnv.capabilities}.suspendable), which a snapshot backend does not have. Call
609
- * sites split the two cases on the DECLARED `capabilities.suspendable` flag, not on this predicate alone.
630
+ * (see `ExecutionEnvCapabilities.suspendable`), which a snapshot backend does not have. Call
631
+ * sites split the two cases on the DECLARED `capabilities.suspendable` flag ({@link declaredSuspend}), not on this predicate alone.
610
632
  */
611
633
  export declare function isSuspendable(env: ExecutionEnv): env is RemoteExecutionEnv;
612
634
  /**
613
635
  * Is this env an isolated sandbox (design/61 §9 A, design/53)? `false` for a real SSH host / ADB device AND
614
- * for any in-process env (the host process is not isolated). The orchestrator tightens autonomy + the
615
- * design/37 policy gate when this is `false` (zero-trust on an un-isolated target). The safe default is
616
- * `false` — isolation must be explicitly declared, never assumed, and that is why the flag is read
636
+ * for an in-process env (the host process is not isolated: `NodeExecutionEnv` and `StubExecutionEnv` declare
637
+ * `false`). The orchestrator tightens autonomy + the design/37 policy gate when this is `false` (zero-trust on an
638
+ * un-isolated target). Isolation must be explicitly declared, never assumed, and that is why the flag is read
617
639
  * STRICTLY: every consumer of a `true` here RELAXES something (autonomy, a policy tier, a containment
618
640
  * leg that the sandbox is then answerable for), so a value that is not the boolean `true` — absent,
619
641
  * a string, a truthy object from a JS adapter the compiler never saw — is not a declaration and lands
620
- * on the checking side. This is the reading every consumer of the containment question comes through,
621
- * and the only one that also NARROWS; a caller already holding a `RemoteExecutionEnv` may spell the
622
- * same strict `!== true` test itself (the worktree-isolation refusal in the runner's prepare does).
642
+ * on the checking side. This is the reading every consumer of the containment question comes through.
623
643
  * What no caller may do is infer isolation from the remote INTERFACE — implementing the seam is not
624
644
  * declaring containment, and a host-lane adapter drives the operator's own machine through it.
625
645
  */
626
- export declare function isIsolated(env: ExecutionEnv): boolean;
646
+ export declare function isIsolated(env: Pick<ExecutionEnv, "capabilities">): boolean;
627
647
  /**
628
648
  * Is CONTAINMENT this env's own job rather than the engine's — i.e. may a containment leg stop at the
629
649
  * written spelling and leave the rest to the target? True exactly for a DECLARED isolated sandbox: the
@@ -649,24 +669,52 @@ export declare function boundaryIsTheSandbox(env: ExecutionEnv): boolean;
649
669
  * a question and the second is an absence, and reading both as the absence is what leaves a containment
650
670
  * leg silently open on an RPC-backed lane.
651
671
  *
652
- * So the adapter says which it is, and says it the way {@link isIsolated} is said — strictly, because a
653
- * `true` here makes a containment leg REFUSE where it used to pass. ABSENT is the reading every adapter
654
- * has had, so no existing env moves; a PRESENT non-boolean reads absent HERE too but is announced at the
655
- * env's admission point, once per key — this reader does not validate. A non-remote env keeps the same
656
- * reading, which is why the local lane is unchanged: its resolver answers `/`, so the arm this gates
657
- * has no case to fire on.
672
+ * So the adapter says which it is. Only a declared boolean is a declaration, and the undeclared reading is the
673
+ * refusing one (`true`): an environment that does not say whether its silence is a failure has its silence read as
674
+ * one, and is announced at its admission point — this reader does not validate. `NodeExecutionEnv` declares `true`,
675
+ * which moves nothing on the local lane: its resolver answers `/`, so the arm this gates has no case to fire on.
658
676
  */
659
- export declare function canonicalPathIsAuthoritative(env: ExecutionEnv): boolean;
677
+ export declare function canonicalPathIsAuthoritative(env: Pick<ExecutionEnv, "capabilities">): boolean;
660
678
  /**
661
679
  * Which process table this env's commands run on, as its adapter declares it
662
- * ({@link RemoteExecutionEnv.capabilities}.sharesProcessTable):
663
- * · `"this"` — a table that holds this process: a remote env that declares `true`, and every env that is not
664
- * remote. The second is the base contract's in-process env (its commands are this process's children); an
665
- * adapter that runs commands elsewhere without the remote seam has no block to declare in and is read the
666
- * same way, which errs toward asking (a refusal of a kill that could not have reached this process);
667
- * · `"other"` — a remote env that declares `false`;
668
- * · `"undeclared"` — a remote env whose declaration is absent, not a boolean, or cannot be read (a throwing
680
+ * ({@link ExecutionEnvCapabilities.sharesProcessTable}):
681
+ * · `"this"` — a table that holds this process: an env that declares `true` (`NodeExecutionEnv`, whose commands are
682
+ * this process's children; a host lane);
683
+ * · `"other"` — an env that declares `false`;
684
+ * · `"undeclared"` — an env whose declaration is absent, not a boolean, or cannot be read (a throwing
669
685
  * getter or Proxy trap). There is no default to fold it to, so the caller refuses what it cannot answer.
670
686
  * Total: it never throws. It does not announce — the admission census does, once per run.
671
687
  */
672
- export declare function processTableOf(env: ExecutionEnv): "this" | "other" | "undeclared";
688
+ export declare function processTableOf(env: Pick<ExecutionEnv, "capabilities">): "this" | "other" | "undeclared";
689
+ /**
690
+ * Where the paths this environment names land ({@link ExecutionEnvCapabilities.hostLocalPaths}), in three states: `true`
691
+ * (the host's own files), `false` (somewhere the host does not mount at the same paths), `"undeclared"` — which each
692
+ * consumer reads on ITS safe side: {@link pathsAreHostLocal} takes only `true`; the worktree child's exemption takes only
693
+ * `false`. Total: it never throws.
694
+ */
695
+ export declare function declaredHostLocalPaths(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
696
+ /**
697
+ * Is a path this environment names the same file on the engine host's filesystem? Only a declared `true` says so — the
698
+ * engine never presents a path it cannot vouch for as a host path. Total: it never throws.
699
+ */
700
+ export declare function pathsAreHostLocal(env: Pick<ExecutionEnv, "capabilities">): boolean;
701
+ /**
702
+ * Does content this environment produces come from outside the deployment's trust boundary
703
+ * ({@link ExecutionEnvCapabilities.externalContentTarget})? Three states: `true`, `false`, or `"undeclared"` (absent, not a
704
+ * boolean, unreadable) — which each consumer reads on ITS safe side: the content fold as outside (`!== false`), the
705
+ * cross-boundary lane as both the target and off it (the union of the two rows' obligations). Total: it never throws.
706
+ */
707
+ export declare function targetIsExternal(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
708
+ /**
709
+ * Do this environment's filesystem and shell faces reach a target ({@link ExecutionEnvCapabilities.io})? Three states:
710
+ * `true`, `false` (the placeholder every operation of which refuses, `StubExecutionEnv`), or `"undeclared"` — which each
711
+ * consumer reads on ITS safe side: a shell face mounts only on `true`; the project marker is read through the environment
712
+ * unless it is `false` (a host-side read would pass the environment's own read limits). Total: it never throws.
713
+ */
714
+ export declare function performsIo(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
715
+ /**
716
+ * Does this environment keep the byte floor a command start carries, or refuse a start whose whole table it cannot
717
+ * keep ({@link ExecutionEnvCapabilities.keepsReadFloor})? Only a declared `true` says so; undeclared ⇒ `false`. The
718
+ * judgment that reads it is taken once per run, where the run's read-deny table is compiled. Total: it never throws.
719
+ */
720
+ export declare function keepsReadFloor(env: Pick<ExecutionEnv, "capabilities">): boolean;