@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -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
  /**
@@ -74,11 +77,38 @@ export declare const WORKSPACE_HANDLE_MEMBERS: ReadonlyArray<keyof WorkspaceHand
74
77
  * structured-clone step to fail on an exotic value. Each member is read the way the engine's own handle comparison reads it.
75
78
  *
76
79
  * ONE copy per live handle: a second call for the same object answers the copy the first call made (the members are read
77
- * once), so every place the engine hands a checkpointed handle to the outside — the resume preflight's facts, the env
78
- * factory's {@link ExecutionEnvFactoryContext.resumeWorkspace}, the restore's {@link VmLifecycleOptions.priorHandle} —
79
- * delivers the same object, not three renderings of one fact.
80
+ * once), so every place the engine hands a checkpointed handle to the outside — the resume preflight's facts and the
81
+ * restore's {@link VmLifecycleOptions.priorHandle} — delivers the same object, not two renderings of one fact; the env
82
+ * factory's {@link ExecutionEnvFactoryContext.placementTarget} is the row's target ({@link placementTargetOf}).
80
83
  */
81
84
  export declare function frozenHandleCopy(handle: WorkspaceHandle): Readonly<WorkspaceHandle>;
85
+ /**
86
+ * Which target a leg's environment is on: the backend (`provider`) and, when the target states one, the physical device
87
+ * (`deviceId`) — the two members of a {@link WorkspaceHandle} that NAME a target, and nothing that reconnects to or restores
88
+ * one (a sandbox id, a reconnect token, a snapshot id). The value of {@link ExecutionEnvFactoryContext.placementTarget}.
89
+ */
90
+ export type PlacementTarget = Readonly<{
91
+ provider: string;
92
+ deviceId?: string;
93
+ }>;
94
+ /** The target `handle` names NOW: its `provider` and `deviceId` read as strings at this call (never through
95
+ * {@link frozenHandleCopy}'s per-object copy — an env may answer one handle object and update it in place, and a receipt
96
+ * must see what the env reports at the moment it is read), frozen; `undefined` when it names no provider (an empty
97
+ * string names none). */
98
+ export declare function placementTargetOf(handle: WorkspaceHandle): PlacementTarget | undefined;
99
+ /**
100
+ * The target an environment reports for itself, read ONCE per leg — at the point the leg's workspace settles: its
101
+ * `workspaceHandle()`'s {@link placementTargetOf}. `undefined` when there is nothing to read: the environment is not a
102
+ * remote one, or its handle cannot answer yet (a lazy-connect adapter before its first connection throws). That leg has
103
+ * no target of its own, so what it spawns carries no fence.
104
+ */
105
+ export declare function reportedPlacementTarget(env: ExecutionEnv | undefined): PlacementTarget | undefined;
106
+ /**
107
+ * The ONE receipt every fenced leg is checked with: the target its environment reported honors `fence` when the fence names
108
+ * no device, or the report names that same device. A report that could not be read (`undefined`) names none, so it honors
109
+ * no device. `provider` is no part of it: only a durable resume leg also requires the checkpointed backend.
110
+ */
111
+ export declare function placementHonored(fence: PlacementTarget | undefined, report: PlacementTarget | undefined): boolean;
82
112
  /**
83
113
  * A reference to a secret injected at {@link RemoteExecutionEnv.connect}/{@link RemoteExecutionEnv.postResumeInit}
84
114
  * time (design/48 §5 gap 7) — never baked into the image. The control plane resolves {@link ref} to a value out of
@@ -129,8 +159,9 @@ export interface VmLifecycleOptions {
129
159
  * as the legacy current-config behavior).
130
160
  *
131
161
  * A frozen copy holding exactly the declared members ({@link WORKSPACE_HANDLE_MEMBERS}) the checkpoint row carries
132
- * as strings — the SAME object the env factory's {@link ExecutionEnvFactoryContext.resumeWorkspace} was, for the
133
- * same row — not the stored row's own object: writing to it throws, and a decoration on the stored handle is absent.
162
+ * as strings ({@link frozenHandleCopy}: the SAME object the resume preflight's facts carry, for the same row) — not
163
+ * the stored row's own object: writing to it throws, and a decoration on the stored handle is absent. The restore
164
+ * facts live here only; the env factory was told the row's target alone ({@link ExecutionEnvFactoryContext.placementTarget}).
134
165
  */
135
166
  priorHandle?: Readonly<WorkspaceHandle>;
136
167
  }
@@ -226,7 +257,7 @@ export type RemoteExecutionErrorCode =
226
257
  | "liveness_no_output"
227
258
  /**
228
259
  * 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.
260
+ * non-suspendable SSH/ADB env. Permanent for this env; check its declaration ({@link declaredSuspend}) first.
230
261
  */
231
262
  | "unsupported"
232
263
  /**
@@ -319,67 +350,13 @@ export declare class RemoteExecutionError extends Error {
319
350
  */
320
351
  export interface RemoteExecutionEnv extends ExecutionEnv {
321
352
  /**
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.
353
+ * Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds.
354
+ *
355
+ * The engine reads it once per leg, when the leg's workspace settles, to learn which target the leg is on
356
+ * ({@link reportedPlacementTarget}) — the fence every agent the leg spawns or wakes is minted under. A target-bound
357
+ * adapter (one whose handle states `deviceId`) answers it from construction on, before any connection; an adapter
358
+ * that cannot answer yet (it throws) gives its leg no target, and that leg's agents carry no fence.
330
359
  */
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
- /** Identity of the connected workspace (design/48 §5 gap 1). Synchronous: it is data the env already holds. */
383
360
  workspaceHandle(): WorkspaceHandle;
384
361
  /** Provision/attach the remote workspace and inject secrets. Returns the resulting {@link WorkspaceHandle}. */
385
362
  connect(config?: RemoteConnectConfig): Promise<{
@@ -507,7 +484,11 @@ export interface ExecutionEnvFactoryContext {
507
484
  * factory MUST refuse loudly too (loud-bad-value posture), never default around.
508
485
  */
509
486
  placementRootSessionId: string;
510
- /** Caller-supplied task id, when set on the `TaskSpec`. */
487
+ /**
488
+ * Caller-supplied task id: present only on a leg whose caller set `TaskSpec.taskId`. A child spec the engine builds (a
489
+ * delegated agent of any kind, a revival) never carries one — such a leg's task id IS its session id — so a factory
490
+ * MUST NOT identify a descendant by this key; the tree is {@link placementRootSessionId}, the leg {@link sessionId}.
491
+ */
511
492
  taskId?: string;
512
493
  /**
513
494
  * design/97 CORE-6 — per-task ISOLATION request threaded from the workflow's `ctx.agent({ isolation })` via
@@ -535,28 +516,37 @@ export interface ExecutionEnvFactoryContext {
535
516
  */
536
517
  parentCwd?: string;
537
518
  /**
538
- * design/380 O1 delivery fence — the workspace a DURABLE RESUME leg is rebuilding: a frozen copy of the
539
- * {@link WorkspaceHandle} the checkpoint row recorded at suspend, holding exactly the members a handle declares
540
- * ({@link WORKSPACE_HANDLE_MEMBERS}) that the row carries as strings. Present ONLY on that leg — the key is
541
- * absent (not an `undefined` value) on every fresh run, and on a resume whose row recorded no workspace
542
- * handle. Mutating the copy reaches nothing the engine reads.
519
+ * The placement FENCE — this context's one answer to "on which target must THIS leg's env be minted". Every leg
520
+ * learns its own target once, when its workspace settles (what its env reports, {@link reportedPlacementTarget});
521
+ * that one value is the fence of every leg it hands work to:
522
+ * · an agent it spawns (a delegated child of any kind, a workflow agent) or wakes (a retained or revived agent: the
523
+ * WAKING leg's target, never one remembered from the spawn);
524
+ * · a later leg of the same piece of work — a cascade rung after the first, a verification gate's verifier and fix
525
+ * legs — carries the FIRST leg's target;
526
+ * · a durable resume leg carries its checkpoint row's target, member by member over the one its waking leg hands it
527
+ * (a member the row states wins; a row recorded without `deviceId` takes the waking leg's).
528
+ * The key is ABSENT (not an `undefined` value) on a top-level first leg its host gave no fence
529
+ * (`RunInternals.placementTarget`), and on a leg whose spawning leg has no target of its own (its env is not remote,
530
+ * or could not answer `workspaceHandle()` when its workspace settled). A frozen value; mutating it reaches nothing.
543
531
  *
544
- * A factory bound to a target (the device lane) **MUST** mint the env on the device
545
- * `resumeWorkspace.deviceId` names and, when it cannot (offline, busy, the placement moved to another
546
- * device), **THROW** a typed refusal. It **MUST NOT** connect some other device and leave the engine to
547
- * notice, and it **MUST NOT** look the current binding up afresh from {@link placementRootSessionId} for
548
- * this leg. A row recorded without `deviceId` (a non-device lane, or a row older than the field) states no
549
- * device to honor; the factory then follows its ordinary routing.
532
+ * A factory bound to a target (the device lane) **MUST** mint the env on the device `placementTarget.deviceId` names
533
+ * and, when it cannot (offline, busy, the placement moved to another device), **THROW** a typed refusal. It **MUST
534
+ * NOT** connect some other device and leave the engine to notice, and it **MUST NOT** choose the target by the
535
+ * current binding of {@link placementRootSessionId}: it may read that binding only to find that it differs from the
536
+ * fence, and then refuse. A fence without `deviceId` states no device to honor; the factory then follows its
537
+ * ordinary routing.
550
538
  *
551
- * The minted env's `workspaceHandle()` **MUST** report the device its connection actually reached; it is
552
- * never copied from `resumeWorkspace`. The engine's comparison of that report against the row (`provider`
553
- * equal; `deviceId` equal whenever the row carries one) stays as the receipt check and TRUSTS the report: a
554
- * factory that connected elsewhere and reports so is refused (`resume.env_failed`), only after the wrong
555
- * connection was made, but one that echoes the fence while connecting elsewhere defeats its own protection
556
- * and passes. The fence moves no refusal earlier than it was: it runs after the claim, so what a deployment
557
- * can still catch BEFORE the claim is `RunnerDeps.resumePreflight` alone.
539
+ * The minted env's `workspaceHandle()` **MUST** report the device its connection actually reached; it is never
540
+ * copied from the fence. The engine checks every fenced leg with one receipt ({@link placementHonored}: the report
541
+ * names the fence's `deviceId` whenever the fence carries one, and a report that cannot be read names none): a leg
542
+ * restoring a checkpointed workspace that fails it is refused `resume.env_failed` (that restore also requires the
543
+ * checkpointed `provider`), any other leg `config.placement_not_honored`, before it runs. The receipt TRUSTS the report: a factory that connected elsewhere and
544
+ * reports so is refused, only after the wrong connection was made, but one that echoes the fence while connecting
545
+ * elsewhere defeats its own protection and passes. On a resume leg the fence moves no refusal earlier than it was:
546
+ * it runs after the claim, so what a deployment can still catch BEFORE the claim is `RunnerDeps.resumePreflight`
547
+ * alone.
558
548
  */
559
- resumeWorkspace?: Readonly<WorkspaceHandle>;
549
+ placementTarget?: PlacementTarget;
560
550
  }
561
551
  /**
562
552
  * A **trusted control-plane** factory that mints a per-task {@link ExecutionEnv} (design/48 §5 answers core
@@ -571,7 +561,10 @@ export interface ExecutionEnvFactoryContext {
571
561
  export type ExecutionEnvFactory = (ctx: ExecutionEnvFactoryContext) => ExecutionEnv | Promise<ExecutionEnv>;
572
562
  /** True when `env` exposes a lifecycle {@link RemoteExecutionEnv.destroy} the Runner should call on task end. */
573
563
  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). */
564
+ /** Structural check that `env` implements the remote seam (lifecycle + streaming surface), answering only whether
565
+ * those methods can be called — never a capability. The block conjunct keeps an adapter that carries no capability
566
+ * block at all (a JS adapter the compiler never saw) off the remote paths, as before the block moved to the base; it
567
+ * is read off the block's one receipt ({@link capabilityReceiptOf}), never off the adapter again. */
575
568
  export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteExecutionEnv;
576
569
  /**
577
570
  * The RESTORE half of the suspend contract — the methods the RESUME leg calls after a `suspendVM`
@@ -585,17 +578,94 @@ export declare function isRemoteExecutionEnv(env: ExecutionEnv): env is RemoteEx
585
578
  * the resume leg — a different process, hours later — with a bare `env.resumeVM is not a function`.
586
579
  */
587
580
  export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("resumeVM" | "postResumeInit")[];
581
+ /**
582
+ * The capability readers (#2891). Every key of {@link ExecutionEnvCapabilities} is read through exactly one of the
583
+ * functions below, on every environment — a local one declares the block as a remote one does, so no reader asks the
584
+ * remote INTERFACE first and none gives a non-remote environment a fixed answer.
585
+ *
586
+ * Each reader takes only the boolean the adapter declared, off the block's one receipt ({@link capabilityReceiptOf}):
587
+ * the adapter's block is read once and every reader reads that frozen copy. A value that is absent, not a boolean, or
588
+ * cannot be received (a throwing getter, a Proxy) is no declaration, and the reader answers that key's SAFE side, one
589
+ * row per key in {@link UNDECLARED_CAPABILITY_READING}. The readers never throw and never announce: the admission
590
+ * census does, once per run per finding (`config.execution_env_capability_invalid`).
591
+ */
592
+ export declare const UNDECLARED_CAPABILITY_READING: {
593
+ readonly isolation: {
594
+ readonly reads: false;
595
+ 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";
596
+ };
597
+ readonly suspendable: {
598
+ readonly reads: "undeclared";
599
+ 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";
600
+ };
601
+ readonly sharesProcessTable: {
602
+ readonly reads: "undeclared";
603
+ 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)";
604
+ };
605
+ readonly canonicalPathAuthoritative: {
606
+ readonly reads: true;
607
+ 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";
608
+ };
609
+ readonly hostLocalPaths: {
610
+ readonly reads: "undeclared";
611
+ 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)";
612
+ };
613
+ readonly externalContentTarget: {
614
+ readonly reads: "undeclared";
615
+ 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)";
616
+ };
617
+ readonly io: {
618
+ readonly reads: "undeclared";
619
+ 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";
620
+ };
621
+ readonly keepsReadFloor: {
622
+ readonly reads: false;
623
+ 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`";
624
+ };
625
+ };
626
+ /** The keys of {@link ExecutionEnvCapabilities}, in declaration order — the census walks exactly these. */
627
+ export declare const CAPABILITY_KEYS: ReadonlyArray<keyof ExecutionEnvCapabilities>;
628
+ /** One finding of a block's receipt: a key of the block not declared as a boolean (`expected: "boolean"`), the block itself
629
+ * when it is not an object or cannot be received (`key: "capabilities"`, `expected: "object"`), or a member the block carries
630
+ * that is no capability (`expected: "absent"`: a misspelled or retired key, whose value no reader takes). */
631
+ export interface CapabilityBlockFinding {
632
+ readonly key: string;
633
+ /** The type the member carries (`"undefined"` where it is absent), or `"unreadable"` where it could not be received. */
634
+ readonly valueType: string;
635
+ readonly expected: "boolean" | "object" | "absent";
636
+ }
637
+ /** What the engine holds of an environment's capability block: the booleans it declares (the eight keys only, frozen), whether the block is
638
+ * an object at all (the remote predicate's block conjunct), and the receipt's findings, in key order and then member order. */
639
+ export interface CapabilityReceipt {
640
+ readonly declared: Readonly<Partial<Record<keyof ExecutionEnvCapabilities, boolean>>>;
641
+ readonly blockIsObject: boolean;
642
+ readonly findings: readonly CapabilityBlockFinding[];
643
+ }
644
+ /**
645
+ * The ONE receipt of an environment's capability block: read off the adapter once per environment object — at its first read,
646
+ * which for a run's environment is the run's admission census — and held frozen; every reader, the census and the remote
647
+ * predicate read this receipt and never the adapter again, so what the census announced is what every reader acts on, and a
648
+ * block the host changes afterwards changes nothing the engine reads. A value that is not an object (a JS caller's `null`) has
649
+ * no block and is not remembered. Total: it never throws.
650
+ */
651
+ export declare function capabilityReceiptOf(env: Pick<ExecutionEnv, "capabilities">): CapabilityReceipt;
652
+ /**
653
+ * What this environment declares about snapshots, in three states: `true` (it can be snapshot and restored), `false`
654
+ * (it cannot — and, on a remote environment, its workspace is externally durable, the park-only degrade's premise), or
655
+ * `"undeclared"` (absent, not a boolean, unreadable). The snapshot reader ({@link isSuspendable}) takes only `true`, the
656
+ * suspend paths' park-only lane only `false`; an undeclared environment is in neither, so a run on it cannot suspend
657
+ * durably.
658
+ */
659
+ export declare function declaredSuspend(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
588
660
  /**
589
661
  * Can this env be durably suspended/snapshotted (design/61 §9 A)? Use this — NOT the structural
590
662
  * {@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.
663
+ * `capabilities.suspendable: false` but still has the method, which returns `"unsupported"`). An environment
664
+ * without the remote interface has no `suspendVM` to call, whatever it declares.
593
665
  *
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.
666
+ * A composite type guard (declaration AND interface AND restore surface) so a `suspendVM` call site narrowed by THIS
667
+ * predicate gets the {@link RemoteExecutionEnv} type without a cast — `true` always implies the structural check too.
668
+ * The declaration is read through {@link declaredSuspend}: only the boolean `true` counts.
599
669
  *
600
670
  * It also requires the RESTORE surface ({@link missingRestoreSurface}). A suspend is only durable
601
671
  * if something can undo it; an adapter that offers `suspendVM` but no `resumeVM` used to pass this guard,
@@ -605,25 +675,23 @@ export declare function missingRestoreSurface(env: ExecutionEnv): readonly ("res
605
675
  *
606
676
  * ⚠️ A capability-DECLARING but restore-incomplete adapter must NOT be re-routed to the durable-park-only
607
677
  * 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.
678
+ * (see `ExecutionEnvCapabilities.suspendable`), which a snapshot backend does not have. Call
679
+ * sites split the two cases on the DECLARED `capabilities.suspendable` flag ({@link declaredSuspend}), not on this predicate alone.
610
680
  */
611
681
  export declare function isSuspendable(env: ExecutionEnv): env is RemoteExecutionEnv;
612
682
  /**
613
683
  * 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
684
+ * for an in-process env (the host process is not isolated: `NodeExecutionEnv` and `StubExecutionEnv` declare
685
+ * `false`). The orchestrator tightens autonomy + the design/37 policy gate when this is `false` (zero-trust on an
686
+ * un-isolated target). Isolation must be explicitly declared, never assumed, and that is why the flag is read
617
687
  * STRICTLY: every consumer of a `true` here RELAXES something (autonomy, a policy tier, a containment
618
688
  * leg that the sandbox is then answerable for), so a value that is not the boolean `true` — absent,
619
689
  * 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).
690
+ * on the checking side. This is the reading every consumer of the containment question comes through.
623
691
  * What no caller may do is infer isolation from the remote INTERFACE — implementing the seam is not
624
692
  * declaring containment, and a host-lane adapter drives the operator's own machine through it.
625
693
  */
626
- export declare function isIsolated(env: ExecutionEnv): boolean;
694
+ export declare function isIsolated(env: Pick<ExecutionEnv, "capabilities">): boolean;
627
695
  /**
628
696
  * Is CONTAINMENT this env's own job rather than the engine's — i.e. may a containment leg stop at the
629
697
  * written spelling and leave the rest to the target? True exactly for a DECLARED isolated sandbox: the
@@ -649,24 +717,52 @@ export declare function boundaryIsTheSandbox(env: ExecutionEnv): boolean;
649
717
  * a question and the second is an absence, and reading both as the absence is what leaves a containment
650
718
  * leg silently open on an RPC-backed lane.
651
719
  *
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.
720
+ * So the adapter says which it is. Only a declared boolean is a declaration, and the undeclared reading is the
721
+ * refusing one (`true`): an environment that does not say whether its silence is a failure has its silence read as
722
+ * one, and is announced at its admission point — this reader does not validate. `NodeExecutionEnv` declares `true`,
723
+ * which moves nothing on the local lane: its resolver answers `/`, so the arm this gates has no case to fire on.
658
724
  */
659
- export declare function canonicalPathIsAuthoritative(env: ExecutionEnv): boolean;
725
+ export declare function canonicalPathIsAuthoritative(env: Pick<ExecutionEnv, "capabilities">): boolean;
660
726
  /**
661
727
  * 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
728
+ * ({@link ExecutionEnvCapabilities.sharesProcessTable}):
729
+ * · `"this"` — a table that holds this process: an env that declares `true` (`NodeExecutionEnv`, whose commands are
730
+ * this process's children; a host lane);
731
+ * · `"other"` — an env that declares `false`;
732
+ * · `"undeclared"` — an env whose declaration is absent, not a boolean, or cannot be read (a throwing
669
733
  * getter or Proxy trap). There is no default to fold it to, so the caller refuses what it cannot answer.
670
734
  * Total: it never throws. It does not announce — the admission census does, once per run.
671
735
  */
672
- export declare function processTableOf(env: ExecutionEnv): "this" | "other" | "undeclared";
736
+ export declare function processTableOf(env: Pick<ExecutionEnv, "capabilities">): "this" | "other" | "undeclared";
737
+ /**
738
+ * Where the paths this environment names land ({@link ExecutionEnvCapabilities.hostLocalPaths}), in three states: `true`
739
+ * (the host's own files), `false` (somewhere the host does not mount at the same paths), `"undeclared"` — which each
740
+ * consumer reads on ITS safe side: {@link pathsAreHostLocal} takes only `true`; the worktree child's exemption takes only
741
+ * `false`. Total: it never throws.
742
+ */
743
+ export declare function declaredHostLocalPaths(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
744
+ /**
745
+ * Is a path this environment names the same file on the engine host's filesystem? Only a declared `true` says so — the
746
+ * engine never presents a path it cannot vouch for as a host path. Total: it never throws.
747
+ */
748
+ export declare function pathsAreHostLocal(env: Pick<ExecutionEnv, "capabilities">): boolean;
749
+ /**
750
+ * Does content this environment produces come from outside the deployment's trust boundary
751
+ * ({@link ExecutionEnvCapabilities.externalContentTarget})? Three states: `true`, `false`, or `"undeclared"` (absent, not a
752
+ * boolean, unreadable) — which each consumer reads on ITS safe side: the content fold as outside (`!== false`), the
753
+ * cross-boundary lane as both the target and off it (the union of the two rows' obligations). Total: it never throws.
754
+ */
755
+ export declare function targetIsExternal(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
756
+ /**
757
+ * Do this environment's filesystem and shell faces reach a target ({@link ExecutionEnvCapabilities.io})? Three states:
758
+ * `true`, `false` (the placeholder every operation of which refuses, `StubExecutionEnv`), or `"undeclared"` — which each
759
+ * consumer reads on ITS safe side: a shell face mounts only on `true`; the project marker is read through the environment
760
+ * unless it is `false` (a host-side read would pass the environment's own read limits). Total: it never throws.
761
+ */
762
+ export declare function performsIo(env: Pick<ExecutionEnv, "capabilities">): boolean | "undeclared";
763
+ /**
764
+ * Does this environment keep the byte floor a command start carries, or refuse a start whose whole table it cannot
765
+ * keep ({@link ExecutionEnvCapabilities.keepsReadFloor})? Only a declared `true` says so; undeclared ⇒ `false`. The
766
+ * judgment that reads it is taken once per run, where the run's read-deny table is compiled. Total: it never throws.
767
+ */
768
+ export declare function keepsReadFloor(env: Pick<ExecutionEnv, "capabilities">): boolean;