@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
@@ -4,7 +4,8 @@ import { policyAskClassOf } from "../ask-class.js";
4
4
  import { ASK_USER_QUESTION_TOOL_NAME, isEngineQuestionFace } from "../ask-question.js";
5
5
  import { classifierUnavailableSeat } from "./classifier-ladder.js";
6
6
  import { resolveCheckpointStore } from "../checkpoint-store.js";
7
- import { chainJudges, inheritedToolChecks, screeningInstallationsOf, standsInFor } from "../mods/stations.js";
7
+ import { chainJudges, inheritedInstallations, standsInFor } from "../mods/stations.js";
8
+ import { createHookEnvCapabilities } from "../hooks.js";
8
9
  import { isCoveringRuleName, ruleNameCovers } from "../namespaced-rule-name.js";
9
10
  import { isIsolated } from "../remote-env.js";
10
11
  import { deliverEngineNotice } from "../engine-notice.js";
@@ -20,10 +21,10 @@ import { SKILL_TOOL_NAME } from "./synthetic-tools.js";
20
21
  import { delegationPoolReading, policyNameRefusal, POLICY_NAME_REFUSAL_CODE } from "./sub-agent-deny-lists.js";
21
22
  import { valveLeaves } from "../../agents/tool-filter.js";
22
23
  import { autoStrippedRule, cardDisclosureOf, classifiesAllShell, rootFacingToolNames } from "../allow-entry.js";
23
- import { arbitrateByMode, askClassMembersOf, askFaceOf, askMandateMember } from "../ask-origin.js";
24
+ import { arbitrateByMode, askClassMembersOf, askFaceOf, askMandateMember, INHERITED_STATION_FACTS } from "../ask-origin.js";
24
25
  import { createModeGatePolicy, mountedToolDeclaresReadOnly } from "../mode-policy.js";
25
26
  const ancestorFacts = (ask) => ({ ...(ask ?? {}), ancestorResolved: true });
26
- import { headlessDenyAtFold, headlessDenyAtRecheck, INHERITED_STATION_FACTS, inheritedAskCarry, inheritedAskFallbackMessage, judgeInheritedClassifier, lateAskSettlementObserver, resolveInheritedAsk, settleDenialLimitFallback } from "./denial-limit-arms.js";
27
+ import { floatedInheritedAsk, headlessDenyAtFold, headlessDenyAtRecheck, inheritedAskCarry, inheritedAskFallbackMessage, judgeInheritedClassifier, lateAskSettlementObserver, resolveInheritedAsk, settleDenialLimitFallback } from "./denial-limit-arms.js";
27
28
  import { settleReadRootGrant } from "./read-root-grant.js";
28
29
  import { frozenApproverRoute } from "../wiring-manifest.js";
29
30
  import { askGrantShapeOf } from "./inherited-ask-grants.js";
@@ -33,7 +34,7 @@ import { policyThrowLine, reportPolicyThrow } from "./policy-throw.js";
33
34
  import { heldBy, heldValues, seatOf, wireOf } from "../tool-name-readings.js";
34
35
  import { hostFloorPolicy } from "../host-floor.js";
35
36
  export async function preparePolicyChain(input) {
36
- const { spec, deps, internals, sessionId, runId, hostTaskId, taskRootFinal, additionalRootsCanonical, writeLocation, executionEnv, lockedPreflight, pathRuleAnchors, headLeads, tools, harnessTools, selector, toolEffects, egressTools, irreversibilityTier, axisExplicitNegatives, shellGatedTools, toolMarkSources, envHandToolNames, handsCwdRef, readDenyMatcher, personRows, questionToolMounted, runtimeCaps, inheritedAncestorRules, ancestorSessionRulesRef, inheritedParentConstraints, seedInheritedGate, skillGrants, skillSpecs, allowedToolTables, frozenOnAsk, hookEnvSource, notifyOwnHookCrash, modBus, ownModChain, autoModeDecider, readFace, permissionMode, toolRosterDeltas, stopForDenialLimit, delegation, abortController, now, ownSessionRulesRef, hostFloor } = input;
37
+ const { spec, deps, sessionId, runId, hostTaskId, taskRootFinal, additionalRootsCanonical, writeLocation, executionEnv, lockedPreflight, pathRuleAnchors, headLeads, tools, harnessTools, selector, toolEffects, egressTools, irreversibilityTier, axisExplicitNegatives, shellGatedTools, toolMarkSources, envHandToolNames, handsCwdRef, readDenyMatcher, personRows, questionToolMounted, runtimeCaps, inheritedAncestorRules, ancestorSessionRulesRef, inheritedParentConstraints, seedInheritedGate, skillGrants, skillSpecs, allowedToolTables, frozenOnAsk, hookEnvSource, notifyOwnHookCrash, modBus, ownModChain, autoModeDecider, readFace, permissionMode, toolRosterDeltas, stopForDenialLimit, askSource, abortController, now, ownSessionRulesRef, hostFloor } = input;
37
38
  const ancestorArbitrations = new Map();
38
39
  const arbitrateInherited = (ask, toolCallId, judged) => {
39
40
  const verdict = arbitrateByMode(permissionMode.current, judged.classification, { origin: judged.origin, ...askMandateMember(ancestorFacts(judged.ask.action === "ask" ? judged.ask : undefined)) });
@@ -62,6 +63,14 @@ export async function preparePolicyChain(input) {
62
63
  const verdict = judgeRuleToolName(n, known, kind);
63
64
  const twin = verdict.kind === "current" && layer !== "ancestor_session_rules" ? nearMissSpellingOf(n, rootFacing) : undefined;
64
65
  const stale = verdict.kind !== "current" ? verdict : twin !== undefined ? { kind: "case_twin", twin, carrier: known.has(twin) || callerNames.has(twin) ? "run" : pool.names.has(twin) ? "pool" : "catalog" } : undefined;
66
+ if (stale?.kind === "retired" && kind === "allow") {
67
+ unmatched.add(`"${n}" (allow — a retired tool name: ${stale.guidance})`);
68
+ continue;
69
+ }
70
+ if (stale?.kind === "unmintable_segment" && stale.ambiguous === true && kind === "allow") {
71
+ unmatched.add(`"${n}" (allow — ${stale.guidance}${stale.currentName !== undefined ? ` Write "${stale.currentName}".` : ""})`);
72
+ continue;
73
+ }
65
74
  if (stale !== undefined) {
66
75
  const entry = `tool policy ${kind}-list entry "${n}"`;
67
76
  let message;
@@ -278,15 +287,6 @@ export async function preparePolicyChain(input) {
278
287
  return decision;
279
288
  })
280
289
  : policy;
281
- const askSourceIdentity = () => ({
282
- principal: spec.principal,
283
- sourceTaskId: sessionId,
284
- ...(internals?.parentTaskId !== undefined ? { fromSubagent: true } : {}),
285
- ...((internals?.explicitAgentName ?? internals?.agentName) !== undefined
286
- ? { sourceAgentName: internals?.explicitAgentName ?? internals?.agentName }
287
- : {}),
288
- ...(delegation.isDelegatedChild ? { isDelegatedChild: true } : {}),
289
- });
290
290
  const seatMarksOf = (call) => {
291
291
  const tierSeat = seatOf("report.riskAxes", irreversibilityTier, call);
292
292
  return {
@@ -336,7 +336,7 @@ export async function preparePolicyChain(input) {
336
336
  onDisclosure: (message) => emitTrace(deps.tracer, () => ({ kind: "permission.rule_store_unreadable", version: 1, taskId: hostTaskId, message, ts: Date.now() })),
337
337
  stripsAllow: (rule, req) => autoStrippedRule(rule, req, permissionMode.current, listFacts.classifyAllShell),
338
338
  };
339
- const { personal: permissionRuleLane, org: permissionRuleOrgLane } = createPermissionRuleLanes({ provider: deps.permissionRuleStore, localOwnerDeclared: deps.localOwnerRules === true, principal: spec.principal, ...ruleLaneFacts, rows: personRows });
339
+ const { personal: permissionRuleLane, org: permissionRuleOrgLane, wholeToolRefusals: storedRuleWholeToolRefusals } = createPermissionRuleLanes({ provider: deps.permissionRuleStore, localOwnerDeclared: deps.localOwnerRules === true, principal: spec.principal, ...ruleLaneFacts, rows: personRows });
340
340
  const ruleOffersOf = createRuleOffersOf({
341
341
  laneArmed: permissionRuleLane !== undefined,
342
342
  principal: spec.principal,
@@ -406,7 +406,7 @@ export async function preparePolicyChain(input) {
406
406
  args: editArgs,
407
407
  ...ruleOffersOf(creq, editArgs, ancestorFacts(j.ask)),
408
408
  ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
409
- ...askSourceIdentity(),
409
+ ...askSource,
410
410
  ...riskAxesOf(creq),
411
411
  ...approvalCardMemberOf(creq),
412
412
  ...grantBindingOf(creq, editArgs),
@@ -414,8 +414,8 @@ export async function preparePolicyChain(input) {
414
414
  ...askMandateMember(ancestorFacts(j.ask)),
415
415
  ...inheritedAskCarry(j, isLiveApproverSeat(onAskOf), ancestorTracker),
416
416
  ruleEvidence: inheritedAskEvidence,
417
- }, onAskOf, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice, onError: deps.onError })), ancestorTracker, creq, inheritedStationFacts(creq));
418
- void settleReadRootGrant(rr.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice });
417
+ }, onAskOf, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError })), ancestorTracker, creq, inheritedStationFacts(creq));
418
+ void settleReadRootGrant(rr.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice });
419
419
  settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: ancestorTracker, resolved: rr, headless: headlessDenyAtRecheck, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
420
420
  if (rr.action !== "allow")
421
421
  return rr;
@@ -448,7 +448,7 @@ export async function preparePolicyChain(input) {
448
448
  if (judged.kind === "deny")
449
449
  return settledAs(judged.result);
450
450
  const { ask: inheritedAsk, fallback } = judged;
451
- if (fallback === undefined && sandboxAdmissionArmed && policyAskClassOf(pc.policy) === "sandbox_local" && !sandboxBoundaryCapable(creq) && judged.classification.row.sandboxAdmission) {
451
+ if (fallback === undefined && sandboxAdmissionArmed && pc.policy !== undefined && policyAskClassOf(pc.policy) === "sandbox_local" && !sandboxBoundaryCapable(creq) && judged.classification.row.sandboxAdmission) {
452
452
  recordAncestorSandboxAdmission(creq.toolCallId, creq.toolName);
453
453
  return settledAs(decision.updatedInput !== undefined ? { action: "allow", updatedInput: decision.updatedInput, decisionReason: "sandbox" } : { action: "allow", decisionReason: "sandbox" });
454
454
  }
@@ -462,7 +462,7 @@ export async function preparePolicyChain(input) {
462
462
  args: presentedArgs,
463
463
  ...ruleOffersOf(creq, presentedArgs, ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
464
464
  ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
465
- ...askSourceIdentity(),
465
+ ...askSource,
466
466
  ...riskAxesOf(creq),
467
467
  ...approvalCardMemberOf(creq),
468
468
  ...grantBindingOf(creq, presentedArgs),
@@ -470,12 +470,12 @@ export async function preparePolicyChain(input) {
470
470
  ...askMandateMember(ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
471
471
  ...inheritedAskCarry(j, isLiveApproverSeat(pc.onAsk), pc.autoMode?.denialTracking),
472
472
  ruleEvidence: inheritedAskEvidence,
473
- }, pc.onAsk, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice, onError: deps.onError })), pc.autoMode?.denialTracking, creq, inheritedStationFacts(creq));
474
- void settleReadRootGrant(resolved.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice });
473
+ }, pc.onAsk, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError })), pc.autoMode?.denialTracking, creq, inheritedStationFacts(creq));
474
+ void settleReadRootGrant(resolved.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice });
475
475
  const askWaitMs = Math.max(0, now() - askT0);
476
476
  if (resolved.action === "deny" && resolved.approverUnavailable === true) {
477
477
  if (markInheritedUnavailable(creq.toolCallId))
478
- return settledAs(settled.ask);
478
+ return settledAs(floatedInheritedAsk(settled, creq));
479
479
  return settledAs(markerChannelFullDeny(creq));
480
480
  }
481
481
  settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: pc.autoMode?.denialTracking, resolved, headless: headlessDenyAtFold, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
@@ -484,119 +484,122 @@ export async function preparePolicyChain(input) {
484
484
  return { kind: "approved", resolved, askWaitMs, classes: askClassMembersOf(judged.classification).classes };
485
485
  };
486
486
  const legStandsIn = (pc) => standsInFor(pc, { chain: ownModChain, onAsk: frozenOnAsk, hookEnv: hookEnvSource, decider: autoModeDecider() }, ownChainJudges);
487
- const parentConstraintWrappers = (inheritedParentConstraints ?? []).map((pc) => legStandsIn(pc)
488
- ? { check: () => ({ action: "allow" }) }
489
- : policy !== undefined && pc.policy === policy
490
- ? {
491
- check: async function arbitrate(creq, csignal) {
492
- const recorded = sharedFirstDecision.get(creq.toolCallId);
493
- const first = recorded?.decision;
494
- const stale = recorded !== undefined && !sameBytes(creq, recorded.decision.updatedInput !== undefined ? recorded.decision.updatedInput : recorded.judged, creq.args);
495
- if (recorded !== undefined)
496
- noteArbitration(creq.toolCallId, arbitrate, stale);
497
- if (stale)
498
- return { action: "allow" };
499
- if (first === undefined) {
500
- return {
501
- action: "deny",
502
- message: `inherited parent policy could not be arbitrated for "${creq.toolName}" ` +
503
- `(shared-instance first decision unavailable); denied fail-closed`,
504
- };
505
- }
506
- if (first.action === "deny")
507
- return first;
508
- if (first.action === "allow")
509
- return { action: "allow" };
510
- if (isDelegatedQuestion(creq)) {
511
- if (pc.contentMandate !== true || markInheritedUnavailable(creq.toolCallId))
487
+ const parentConstraintWrappers = (inheritedParentConstraints ?? []).flatMap((pc) => {
488
+ const ancestorPolicy = pc.policy;
489
+ if (ancestorPolicy === undefined)
490
+ return [];
491
+ return [
492
+ policy !== undefined && ancestorPolicy === policy
493
+ ? {
494
+ check: async function arbitrate(creq, csignal) {
495
+ const recorded = sharedFirstDecision.get(creq.toolCallId);
496
+ const first = recorded?.decision;
497
+ const stale = recorded !== undefined && !sameBytes(creq, recorded.decision.updatedInput !== undefined ? recorded.decision.updatedInput : recorded.judged, creq.args);
498
+ if (recorded !== undefined)
499
+ noteArbitration(creq.toolCallId, arbitrate, stale);
500
+ if (stale)
501
+ return { action: "allow" };
502
+ if (first === undefined) {
503
+ return {
504
+ action: "deny",
505
+ message: `inherited parent policy could not be arbitrated for "${creq.toolName}" ` +
506
+ `(shared-instance first decision unavailable); denied fail-closed`,
507
+ };
508
+ }
509
+ if (first.action === "deny")
512
510
  return first;
511
+ if (first.action === "allow")
512
+ return { action: "allow" };
513
+ if (isDelegatedQuestion(creq)) {
514
+ if (pc.contentMandate !== true || markInheritedUnavailable(creq.toolCallId))
515
+ return first;
516
+ return {
517
+ action: "deny",
518
+ message: `inherited parent policy requires durable handling of the question raised for "${creq.toolName}" and the marker channel is at capacity — ` +
519
+ `denied fail-closed (tighten-only)`,
520
+ };
521
+ }
522
+ if (pc.durableMandate === true) {
523
+ if (mandatedCallFloats(creq.toolCallId))
524
+ return first;
525
+ return mandateUnreconstructibleDeny(creq);
526
+ }
527
+ const judged = await judgeInheritedClassifier({ liveMode: () => permissionMode.current, autoMode: pc.autoMode, ask: first, req: creq, signal: csignal ?? abortController.signal, subject: "this call", facts: inheritedStationFacts(creq), unavailableSeat: classifierUnavailableSeat({ station: "ancestor", ...(pc.autoMode?.decider.timeoutMs !== undefined ? { budgetMs: pc.autoMode.decider.timeoutMs } : {}), route: frozenApproverRoute(pc.onAsk), onNotice: deps.onNotice, sessionId, runId }) });
528
+ if (judged.kind === "allow")
529
+ return judged.result;
530
+ if (judged.kind === "deny")
531
+ return judged.result;
532
+ const { ask: inheritedAsk, fallback } = judged;
533
+ if (fallback === undefined && sandboxAdmissionArmed && policyAskClassOf(ancestorPolicy) === "sandbox_local" && !sandboxBoundaryCapable(creq) && judged.classification.row.sandboxAdmission) {
534
+ recordAncestorSandboxAdmission(creq.toolCallId, creq.toolName);
535
+ return { action: "allow", decisionReason: "sandbox" };
536
+ }
537
+ const arbitrated = arbitrateInherited(inheritedAsk, creq.toolCallId, judged);
538
+ if (arbitrated !== undefined)
539
+ return arbitrated;
540
+ const presentedArgs = creq.args;
541
+ const askT0 = now();
542
+ const { resolved, judged: settled } = await resolveInheritedAsk(judged, (j) => resolveAsk({
543
+ toolName: creq.toolName,
544
+ toolCallId: creq.toolCallId,
545
+ args: presentedArgs,
546
+ ...ruleOffersOf(creq, presentedArgs, ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
547
+ ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
548
+ ...askSource,
549
+ ...riskAxesOf(creq),
550
+ ...approvalCardMemberOf(creq),
551
+ ...grantBindingOf(creq, presentedArgs),
552
+ ...(j.ask.action === "ask" && j.ask.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
553
+ ...askMandateMember(ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
554
+ ...inheritedAskCarry(j, isLiveApproverSeat(pc.onAsk), pc.autoMode?.denialTracking),
555
+ ruleEvidence: inheritedAskEvidence,
556
+ }, pc.onAsk, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError })), pc.autoMode?.denialTracking, creq, inheritedStationFacts(creq));
557
+ void settleReadRootGrant(resolved.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice });
558
+ const askWaitMs = Math.max(0, now() - askT0);
559
+ if (resolved.action === "deny" && resolved.approverUnavailable === true) {
560
+ if (markInheritedUnavailable(creq.toolCallId))
561
+ return floatedInheritedAsk(settled, creq);
562
+ return markerChannelFullDeny(creq);
563
+ }
564
+ settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: pc.autoMode?.denialTracking, resolved, headless: headlessDenyAtFold, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
565
+ if (resolved.action !== "allow")
566
+ return resolved;
567
+ if (resolved.updatedInput !== undefined) {
568
+ return recheckApprovedEdit(ancestorPolicy, pc.onAsk, creq, resolved.updatedInput, resolved, csignal, pc.autoMode);
569
+ }
570
+ recordInheritedAskGrant(creq.toolCallId, pc.onAsk, resolved.presentedInput, askWaitMs, resolved, askClassMembersOf(settled.classification).classes);
571
+ return { action: "allow", decisionReason: "mode" };
572
+ },
573
+ }
574
+ : wrapToolPolicy(ancestorPolicy, async (creq, csignal) => {
575
+ let decision;
576
+ try {
577
+ decision = refuseOutOfContractDecision(await ancestorPolicy.check(creq, csignal ?? abortController.signal), { call: creq });
578
+ }
579
+ catch (err) {
580
+ reportPolicyThrow(notifyOwnHookCrash, "an inherited parent policy", creq, err, csignal ?? abortController.signal);
513
581
  return {
514
582
  action: "deny",
515
- message: `inherited parent policy requires durable handling of the question raised for "${creq.toolName}" and the marker channel is at capacity — ` +
516
- `denied fail-closed (tighten-only)`,
583
+ message: `inherited parent policy errored for "${creq.toolName}": ${policyThrowLine(err)}`,
517
584
  };
518
585
  }
519
- if (pc.durableMandate === true) {
520
- if (mandatedCallFloats(creq.toolCallId))
521
- return first;
522
- return mandateUnreconstructibleDeny(creq);
523
- }
524
- const judged = await judgeInheritedClassifier({ liveMode: () => permissionMode.current, autoMode: pc.autoMode, ask: first, req: creq, signal: csignal ?? abortController.signal, subject: "this call", facts: inheritedStationFacts(creq), unavailableSeat: classifierUnavailableSeat({ station: "ancestor", ...(pc.autoMode?.decider.timeoutMs !== undefined ? { budgetMs: pc.autoMode.decider.timeoutMs } : {}), route: frozenApproverRoute(pc.onAsk), onNotice: deps.onNotice, sessionId, runId }) });
525
- if (judged.kind === "allow")
526
- return judged.result;
527
- if (judged.kind === "deny")
528
- return judged.result;
529
- const { ask: inheritedAsk, fallback } = judged;
530
- if (fallback === undefined && sandboxAdmissionArmed && policyAskClassOf(pc.policy) === "sandbox_local" && !sandboxBoundaryCapable(creq) && judged.classification.row.sandboxAdmission) {
531
- recordAncestorSandboxAdmission(creq.toolCallId, creq.toolName);
532
- return { action: "allow", decisionReason: "sandbox" };
533
- }
534
- const arbitrated = arbitrateInherited(inheritedAsk, creq.toolCallId, judged);
535
- if (arbitrated !== undefined)
536
- return arbitrated;
537
- const presentedArgs = creq.args;
538
- const askT0 = now();
539
- const { resolved, judged: settled } = await resolveInheritedAsk(judged, (j) => resolveAsk({
540
- toolName: creq.toolName,
541
- toolCallId: creq.toolCallId,
542
- args: presentedArgs,
543
- ...ruleOffersOf(creq, presentedArgs, ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
544
- ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
545
- ...askSourceIdentity(),
546
- ...riskAxesOf(creq),
547
- ...approvalCardMemberOf(creq),
548
- ...grantBindingOf(creq, presentedArgs),
549
- ...(j.ask.action === "ask" && j.ask.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
550
- ...askMandateMember(ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
551
- ...inheritedAskCarry(j, isLiveApproverSeat(pc.onAsk), pc.autoMode?.denialTracking),
552
- ruleEvidence: inheritedAskEvidence,
553
- }, pc.onAsk, csignal ?? abortController.signal, lateAskSettlementObserver({ toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice, onError: deps.onError })), pc.autoMode?.denialTracking, creq, inheritedStationFacts(creq));
554
- void settleReadRootGrant(resolved.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice });
555
- const askWaitMs = Math.max(0, now() - askT0);
556
- if (resolved.action === "deny" && resolved.approverUnavailable === true) {
557
- if (markInheritedUnavailable(creq.toolCallId))
558
- return settled.ask;
559
- return markerChannelFullDeny(creq);
560
- }
561
- settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: pc.autoMode?.denialTracking, resolved, headless: headlessDenyAtFold, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
562
- if (resolved.action !== "allow")
563
- return resolved;
586
+ if (decision.action !== "ask")
587
+ return decision;
588
+ const settled = await settleInstallationAsk(pc, decision, creq, csignal);
589
+ if (settled.kind === "settled")
590
+ return settled.result;
591
+ const { resolved } = settled;
564
592
  if (resolved.updatedInput !== undefined) {
565
- return recheckApprovedEdit(pc.policy, pc.onAsk, creq, resolved.updatedInput, resolved, csignal, pc.autoMode);
593
+ return recheckApprovedEdit(ancestorPolicy, pc.onAsk, creq, resolved.updatedInput, resolved, csignal, pc.autoMode);
566
594
  }
567
- recordInheritedAskGrant(creq.toolCallId, pc.onAsk, resolved.presentedInput, askWaitMs, resolved, askClassMembersOf(settled.classification).classes);
568
- return { action: "allow", decisionReason: "mode" };
569
- },
570
- }
571
- : wrapToolPolicy(pc.policy, async (creq, csignal) => {
572
- let decision;
573
- try {
574
- decision = refuseOutOfContractDecision(await pc.policy.check(creq, csignal ?? abortController.signal), { call: creq });
575
- }
576
- catch (err) {
577
- reportPolicyThrow(notifyOwnHookCrash, "an inherited parent policy", creq, err, csignal ?? abortController.signal);
578
- return {
579
- action: "deny",
580
- message: `inherited parent policy errored for "${creq.toolName}": ${policyThrowLine(err)}`,
581
- };
582
- }
583
- if (decision.action !== "ask")
584
- return decision;
585
- const settled = await settleInstallationAsk(pc, decision, creq, csignal);
586
- if (settled.kind === "settled")
587
- return settled.result;
588
- const { resolved } = settled;
589
- if (resolved.updatedInput !== undefined) {
590
- return recheckApprovedEdit(pc.policy, pc.onAsk, creq, resolved.updatedInput, resolved, csignal, pc.autoMode);
591
- }
592
- if (screeningInstallationsOf([pc]).length === 0) {
593
595
  recordInheritedAskGrant(creq.toolCallId, pc.onAsk, resolved.presentedInput, settled.askWaitMs, resolved, settled.classes);
594
- }
595
- if (decision.updatedInput === undefined)
596
- return resolved;
597
- return { ...resolved, updatedInput: decision.updatedInput };
598
- }));
599
- const installationToolChecks = inheritedToolChecks(inheritedParentConstraints ?? [], legStandsIn, (pc) => async (ask, creq, csignal) => {
596
+ if (decision.updatedInput === undefined)
597
+ return resolved;
598
+ return { ...resolved, updatedInput: decision.updatedInput };
599
+ }),
600
+ ];
601
+ });
602
+ const installationsOnLeg = inheritedInstallations(inheritedParentConstraints ?? [], legStandsIn, (pc) => (typeof pc.hookEnv === "object" && pc.hookEnv !== null ? createHookEnvCapabilities(pc.hookEnv) : undefined), (pc) => async (ask, creq, csignal) => {
600
603
  const settled = await settleInstallationAsk(pc, ask, creq, csignal);
601
604
  return settled.kind === "settled" ? settled.result : settled.resolved;
602
605
  });
@@ -656,7 +659,7 @@ export async function preparePolicyChain(input) {
656
659
  return decision;
657
660
  })
658
661
  : foldedPolicy;
659
- return { basePolicyForResumeEdit, denyNarrowingPolicy, skillGrantLane, allowEntryLanes, policyLayers, effectivePolicy, inheritedUnavailableAsks, inheritedAskGrants, askSourceIdentity, riskAxesOf, ruleOffersOf, grantBindingOf, permissionRuleLane, ruleLaneFacts, permissionRuleOrgLane, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, foldAskClasses, ancestorSandboxAdmissions, ancestorArbitrations, inheritedToolChecks: installationToolChecks };
662
+ return { basePolicyForResumeEdit, denyNarrowingPolicy, skillGrantLane, allowEntryLanes, policyLayers, effectivePolicy, inheritedUnavailableAsks, inheritedAskGrants, riskAxesOf, ruleOffersOf, grantBindingOf, permissionRuleLane, ruleLaneFacts, permissionRuleOrgLane, storedRuleWholeToolRefusals, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, foldAskClasses, ancestorSandboxAdmissions, ancestorArbitrations, inheritedInstallations: installationsOnLeg };
660
663
  }
661
664
  const advisedPolicyNames = new WeakMap();
662
665
  const ADVISED_KEYS_CAP = 64;
@@ -21,7 +21,7 @@ export interface PrepareProjectContextInput {
21
21
  * own). `undefined` on a standalone prepare. */
22
22
  internals: Pick<RunInternals, "agentName" | "inheritedSkillGrants" | "inheritedAllowedTools"> | undefined;
23
23
  /** borrowed-readonly — the request's `allowedTools`, screened and snapshotted at the config door (before the first await). */
24
- allowedTools: readonly string[] | undefined;
24
+ allowedTools: readonly import("../allow-entry.js").AllowListEntry[] | undefined;
25
25
  /** borrowed-mutable — the request's and the deployment's allow-entry tables (identity is the contract: the gate's lanes and
26
26
  * the delegation capture alias these objects). Seeded here, once; nothing writes them after this phase. */
27
27
  allowedToolTables: {
@@ -35,7 +35,7 @@ export interface PrepareProjectContextInput {
35
35
  sessionId: string;
36
36
  /** borrowed-readonly — the run's id (`Prepared.runId`): the seam ctx's `runId`. */
37
37
  runId: string;
38
- /** borrowed-readonly — `spec.taskId ?? sessionId`: the shared-memory tools' trusted task identity. */
38
+ /** borrowed-readonly — the leg's minted task id (`legTaskIdOf`): the shared-memory tools' trusted task identity. */
39
39
  hostTaskId: string;
40
40
  /** borrowed-readonly — the FINAL task root (post-restore): the seam's `cwd`. */
41
41
  taskRootFinal: string;
@@ -48,9 +48,9 @@ export async function prepareProjectContext(input) {
48
48
  catch {
49
49
  }
50
50
  }
51
- let loaded = null;
51
+ let loaded;
52
52
  try {
53
- loaded = await Promise.resolve(loadProjectMemory.call(deps, {
53
+ const answered = await Promise.resolve(loadProjectMemory.call(deps, {
54
54
  cwd: taskRootFinal,
55
55
  handsEnabled,
56
56
  isSubagent: delegation.isNonForkChild,
@@ -59,13 +59,16 @@ export async function prepareProjectContext(input) {
59
59
  runId,
60
60
  phase: projectMemoryPhase,
61
61
  }));
62
+ if (answered === null || typeof answered !== "object")
63
+ throw new Error(`RunnerDeps.loadProjectMemory answered ${answered === null ? "null" : typeof answered} — the answer is a ProjectMemoryLoad object ({ content: string | null, … }); answer { content: null } for no project layer. Not read: this leg runs with no project layer.`);
64
+ loaded = answered;
62
65
  }
63
66
  catch (err) {
64
67
  deps.onError?.(asThrownError(err), { phase: "config", sessionId });
65
68
  }
66
- const projectMem = loaded !== null && typeof loaded === "object" ? loaded.content : loaded;
67
- const seededFiles = loaded !== null && typeof loaded === "object" ? loaded.seededFiles : undefined;
68
- const declaredSources = loaded !== null && typeof loaded === "object" ? loaded.instructionSources : undefined;
69
+ const projectMem = loaded?.content;
70
+ const seededFiles = loaded?.seededFiles;
71
+ const declaredSources = loaded?.instructionSources;
69
72
  if (declaredSources !== undefined && declaredSources.length > 0)
70
73
  instructionSources = declaredSources;
71
74
  if (seededFiles?.length && seedContextFiles) {
@@ -32,6 +32,7 @@ import type { RosterBuilder } from "../tool-roster.js";
32
32
  import type { ResolvedRole } from "../roles.js";
33
33
  import type { RunnerDeps, TaskSpec } from "../types.js";
34
34
  import type { SessionTreeEntry } from "../../internal/harness-types.js";
35
+ import type { ReadFloorSeat } from "../../tools/fs/read-floor.js";
35
36
  import type { DateAnchorRead, PrepareResume, PromptFeatureFlags, RunInternals, ToolFaceSnapshot } from "./contracts.js";
36
37
  import type { AdvertisedWritableDirs } from "./advertised-writable-dirs.js";
37
38
  import { type GitStatusLaneRef } from "./git-status-frame.js";
@@ -99,6 +100,9 @@ export interface PreparePromptInputsInput {
99
100
  resume: PrepareResume | undefined;
100
101
  /** borrowed-readonly — whether a real execution env is mounted (the hands facts + both probes). */
101
102
  handsEnabled: boolean;
103
+ /** borrowed-readonly — the run's byte-floor seat (read-floor.ts): both probes are the run's own starts and carry the run's
104
+ * base table, read as each starts (no floor when the table holds no row). */
105
+ readFloor: ReadFloorSeat;
102
106
  /** borrowed-readonly — the FINAL task root: the env `cwd` fact and the git lane's root. */
103
107
  taskRootFinal: string;
104
108
  /** borrowed-readonly — the canonical extra working roots (copied into the env facts). */
@@ -10,7 +10,7 @@ import { cwdAlignmentProbe, cwdMisalignmentMessage, readCwdAlignment } from "./c
10
10
  const ULTRA_REASONING_TIERS = new Set(["xhigh", "max"]);
11
11
  import { compactionEnabled } from "../context-settings.js";
12
12
  export async function preparePromptInputs(input) {
13
- const { spec, deps, failClosedReason, lockedPreflight, selfOrchestrationActive, executionEnv, reminderMark, resolvedReadFace, resolvedWriteFace, toolFaceSnapshot, internals, thinking, ownedEnv, delegation, resolvedRole, mcp, model, externalContentTargetActive, resume, handsEnabled, taskRootFinal, additionalRootsCanonical, additionalReadRootsCanonical, sessionId, session, advertisedWritableDirs } = input;
13
+ const { spec, deps, failClosedReason, lockedPreflight, selfOrchestrationActive, executionEnv, reminderMark, resolvedReadFace, resolvedWriteFace, toolFaceSnapshot, internals, thinking, ownedEnv, delegation, resolvedRole, mcp, model, externalContentTargetActive, resume, handsEnabled, readFloor, taskRootFinal, additionalRootsCanonical, additionalReadRootsCanonical, sessionId, session, advertisedWritableDirs } = input;
14
14
  const promptPolicyEnabled = Boolean(lockedPreflight.toolPolicy);
15
15
  const promptHooksEnabled = input.modBus.hasHandlers("classic.PreToolUse") || input.modBus.hasHandlers("classic.PostToolUse");
16
16
  if (failClosedReason) {
@@ -84,7 +84,8 @@ export async function preparePromptInputs(input) {
84
84
  envFacts.additionalReadDirectories = [...additionalReadRootsCanonical];
85
85
  }
86
86
  try {
87
- const probe = await executionEnv.exec('uname -s; uname -r; (git rev-parse --is-inside-work-tree 2>/dev/null || echo false); (git symbolic-ref --short -q HEAD 2>/dev/null || echo "HEAD (detached)"); (git rev-parse --show-toplevel 2>/dev/null || echo); (test -n "$(git status --porcelain 2>/dev/null | head -1)" && echo dirty || echo clean); (s=$(ps -p $$ -o comm= 2>/dev/null); s=${s##*/}; echo "${s#-}"); (test "$(git rev-parse --git-dir 2>/dev/null)" != "$(git rev-parse --git-common-dir 2>/dev/null)" && echo linked || echo main); ' + cwdAlignmentProbe(taskRootFinal), { cwd: envFacts.cwd, timeout: 10 });
87
+ const probeFloor = readFloor(undefined);
88
+ const probe = await executionEnv.exec('uname -s; uname -r; (git rev-parse --is-inside-work-tree 2>/dev/null || echo false); (git symbolic-ref --short -q HEAD 2>/dev/null || echo "HEAD (detached)"); (git rev-parse --show-toplevel 2>/dev/null || echo); (test -n "$(git status --porcelain 2>/dev/null | head -1)" && echo dirty || echo clean); (s=$(ps -p $$ -o comm= 2>/dev/null); s=${s##*/}; echo "${s#-}"); (test "$(git rev-parse --git-dir 2>/dev/null)" != "$(git rev-parse --git-common-dir 2>/dev/null)" && echo linked || echo main); ' + cwdAlignmentProbe(taskRootFinal), { cwd: envFacts.cwd, timeout: 10, ...(probeFloor !== undefined ? { readFloor: probeFloor } : {}) });
88
89
  if (probe.ok && probe.value.exitCode === 0) {
89
90
  const lines = probe.value.stdout.split("\n");
90
91
  if (lines.length >= 6) {
@@ -129,6 +130,7 @@ export async function preparePromptInputs(input) {
129
130
  envFacts,
130
131
  handsEnabled,
131
132
  taskRoot: taskRootFinal,
133
+ readFloor: () => readFloor(undefined),
132
134
  onDegrade: (reason) => deps.onError?.(new Error(`env git snapshot degraded — ${reason}`), { phase: "degraded", sessionId, classification: "env-git-snapshot" }),
133
135
  });
134
136
  return { featureFlags, sugar, mcpInstructionsBlock, envFacts, tzValid, userTz, dateAnchor, gitStatusRef };
@@ -28,7 +28,7 @@ import { type MaterializedMcp, type McpDroppedTool, type McpReconnectResult } fr
28
28
  import { type MaterializedA2a } from "../a2a.js";
29
29
  import type { LockedPreflight } from "../locked-config.js";
30
30
  import type { RunnerDeps, TaskSpec, ToolEffect } from "../types.js";
31
- import type { AnnounceOnceSink, IrreversibilityTier, Prepared, RollbackStack, ToolFaceSnapshot } from "./contracts.js";
31
+ import type { AnnounceOnceSink, IrreversibilityTier, Prepared, RollbackStack, RunInternals, ToolFaceSnapshot } from "./contracts.js";
32
32
  import { RosterBuilder, type ToolRosterDeltaSeat } from "../tool-roster.js";
33
33
  import type { LegModBus } from "../mods/stations.js";
34
34
  export interface PrepareProtocolToolsInput {
@@ -43,9 +43,9 @@ export interface PrepareProtocolToolsInput {
43
43
  * reading, and the first-dial gate), `signal` (the host's abort, which stops an MCP dial). */
44
44
  spec: Pick<TaskSpec, "principal" | "tools" | "excludeAllTools" | "signal">;
45
45
  /** borrowed-readonly — the deployment seats the materializers and their operator faces read: `onElicit`
46
- * and `mcpImageResizer` ride into the MCP intake; `onError` takes the A2A warnings (no ledger — a peer is
46
+ * and `imageProcessor` ride into the MCP intake; `onError` takes the A2A warnings (no ledger — a peer is
47
47
  * re-read every prepare); `mcpRevocations` + `onNotice` make the revocation wiring; `peerSeat` answers what each MCP / A2A request carries. */
48
- deps: Pick<RunnerDeps, "onElicit" | "mcpImageResizer" | "onError" | "mcpRevocations" | "onNotice" | "peerSeat">;
48
+ deps: Pick<RunnerDeps, "onElicit" | "imageProcessor" | "onError" | "mcpRevocations" | "onNotice" | "peerSeat">;
49
49
  /** borrowed-readonly — the leg's mods bus: its `prompt.section` station disposes of each server's instructions at the dial. */
50
50
  modBus: LegModBus;
51
51
  /** borrowed-readonly — the run tree's MCP connection pool (the leg leases its connections from it) and whether THIS leg created it
@@ -54,6 +54,8 @@ export interface PrepareProtocolToolsInput {
54
54
  pool: import("../mcp-connection-pool.js").McpConnectionPool;
55
55
  owned: boolean;
56
56
  };
57
+ /** borrowed-readonly — the leg's host seats (`RunInternals.mcpHostSeats`): a host-transport server dials through its seat. */
58
+ mcpHostSeats?: RunInternals["mcpHostSeats"];
57
59
  /** borrowed-readonly — the leg's reminder mark (the MCP intake's disclosure bounding reads it). */
58
60
  reminderMark: string;
59
61
  /** borrowed-mutable — the reminder-disclosure counters: the MCP intake's bounding writes them here, and
@@ -14,6 +14,9 @@ import { mintNamespacePrefix } from "../protocol-naming.js";
14
14
  import { applyMcpToolFaces } from "./tool-face-overlay.js";
15
15
  import { sectionDisposerOf } from "../prompt-section-seat.js";
16
16
  import { thrownText } from "../thrown-value.js";
17
+ import { inlineUntrusted } from "../untrusted-text.js";
18
+ import { transportKindOf } from "../mcp-server-spec.js";
19
+ import { credentialEchoNotice } from "../credential-echo.js";
17
20
  export async function prepareProtocolTools(input) {
18
21
  const { lockedPreflight, hostFloor, spec, deps, mcpPool, reminderMark, reminderDisclosureCounts, runId, sessionId, onceLedger, roster, rosterSeat, remoteToolOffload, toolFaceSnapshot, toolEffects, axisExplicitNegatives, irreversibilityTier, irreversibleTools, egressTools, toolMarkSources, abortController, rollback } = input;
19
22
  const markedBy = (name, source) => {
@@ -31,13 +34,17 @@ export async function prepareProtocolTools(input) {
31
34
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
32
35
  const resourcesReached = resourceFacesLeft(leaves);
33
36
  const mcp = lockedPreflight.mcp?.length
34
- ? await materializeLegMcpTools(input.mcpRequestMeta, lockedPreflight.mcp, spec.principal, deps.onElicit, deps.mcpImageResizer, { reminderMark, counts: reminderDisclosureCounts }, mcpRevocationWiring(deps, runId), mcpPool === undefined ? undefined : { pool: mcpPool.pool, ownsPool: mcpPool.owned }, sectionDisposerOf(input.modBus, abortController.signal), (entry) => resourcesReached || serverReached(mintNamespacePrefix(MCP_NAMESPACE, entry.name)), AbortSignal.any([abortController.signal, ...(spec.signal !== undefined ? [spec.signal] : [])]), hostFloor, deps.peerSeat, mcpAuthorizationNotice(deps, sessionId, runId, spec.principal))
37
+ ? await materializeLegMcpTools(input.mcpRequestMeta, lockedPreflight.mcp, spec.principal, deps.onElicit, deps.imageProcessor, { reminderMark, counts: reminderDisclosureCounts }, mcpRevocationWiring(deps, runId), mcpPool === undefined ? undefined : { pool: mcpPool.pool, ownsPool: mcpPool.owned }, sectionDisposerOf(input.modBus, abortController.signal), (entry) => resourcesReached || serverReached(mintNamespacePrefix(MCP_NAMESPACE, entry.name)), AbortSignal.any([abortController.signal, ...(spec.signal !== undefined ? [spec.signal] : [])]), hostFloor, deps.peerSeat, mcpAuthorizationNotice(deps, sessionId, runId, spec.principal), input.mcpHostSeats, credentialEchoNotice(deps.onNotice, sessionId, runId, "mcp"))
35
38
  :
36
39
  { tools: [], toolAxes: [], warnings: [], serverInstructions: [], instructionsDelta: { pendingAdds: [], pendingRemovals: [] }, droppedTools: [], statuses: [], refresh: async () => [], reconnect: async (server) => ({ server, prefix: mintNamespacePrefix(MCP_NAMESPACE, server), outcome: "not_declared", reason: "this task declared no MCP servers", toolCount: 0, added: [], removed: [] }), dispose: async () => { } };
37
40
  if (lockedPreflight.mcp?.length)
38
41
  rollback.push(function mcpDispose() { return mcp.dispose(); });
39
42
  for (const w of mcp.warnings)
40
43
  onceLedger.onError(w, { phase: "mcp", sessionId });
44
+ for (const name of input.mcpHostSeats?.keys() ?? []) {
45
+ if (lockedPreflight.mcp?.some((s) => s.name === name && transportKindOf(s) === "host") !== true)
46
+ onceLedger.onError(Object.assign(new Error(`mcp: this leg holds a host seat named "${inlineUntrusted(name, 120)}" and declares no MCP server of that name with a host-supplied transport — nothing is mounted through it`), { code: "config.mcp_host_seat_undeclared" }), { phase: "mcp", sessionId });
47
+ }
41
48
  for (const d of mcp.droppedTools) {
42
49
  onceLedger.onError(new Error(`MCP tool dropped at intake — ${d.tool} (server "${d.server}"): ${d.reason}`), { phase: "mcp", sessionId });
43
50
  }
@@ -168,7 +175,7 @@ export async function prepareProtocolTools(input) {
168
175
  foldProtocolAxes(mcp.toolAxes, "MCP");
169
176
  const a2aDeclared = lockedPreflight.a2a;
170
177
  const a2a = a2aDeclared
171
- ? await materializeA2aTools(a2aDeclared, spec.principal, abortController.signal, hostFloor, deps.peerSeat)
178
+ ? await materializeA2aTools(a2aDeclared, spec.principal, abortController.signal, hostFloor, deps.peerSeat, credentialEchoNotice(deps.onNotice, sessionId, runId, "a2a"))
172
179
  : { tools: [], toolAxes: [], warnings: [], statuses: [], refresh: async () => [], dispose: async () => { } };
173
180
  if (a2aDeclared)
174
181
  rollback.push(function a2aDispose() { return a2a.dispose(); });
@@ -19,6 +19,7 @@
19
19
  import type { AgentTool } from "../../internal/harness.js";
20
20
  import { type OnQuestion } from "../ask-question.js";
21
21
  import type { CheckpointStore } from "../checkpoint-store.js";
22
+ import { type AskSourceIdentity } from "../tool-policy.js";
22
23
  import type { RunnerDeps, RuntimeCaps, TaskSpec } from "../types.js";
23
24
  import type { PrepareResume, ToolFaceSnapshot } from "./contracts.js";
24
25
  import { type ContentAskBinding } from "./content-ask-bindings.js";
@@ -29,9 +30,10 @@ export interface PrepareQuestionFaceInput {
29
30
  * the mount predicate and the live-face derivation both read this one value. */
30
31
  frozenOnQuestion: OnQuestion | undefined;
31
32
  /** borrowed-readonly — the REBOUND spec. Read: `durableApproval` (the durable face's opt-in), `interactiveTools`
32
- * (the override), `principal` (the tool's source identity), `interactiveQuestionFallback` (restores the
33
- * continuation under a resolved posture). Never mutated. */
34
- spec: Pick<TaskSpec, "durableApproval" | "interactiveTools" | "principal" | "interactiveQuestionFallback" | "excludeAllTools">;
33
+ * (the override), `interactiveQuestionFallback` (restores the continuation under a resolved posture). Never mutated. */
34
+ spec: Pick<TaskSpec, "durableApproval" | "interactiveTools" | "interactiveQuestionFallback" | "excludeAllTools">;
35
+ /** borrowed-readonly — the leg's one ask source (minted once by the driver): the mounted tool's source members. */
36
+ askSource: AskSourceIdentity;
35
37
  /** borrowed-readonly — the frozen tool face; its selector with the spec's `excludeAllTools` is the valve's reading: the tool mounts only if the valve leaves it. */
36
38
  toolFaceSnapshot: Pick<ToolFaceSnapshot, "selector">;
37
39
  /** borrowed-readonly — the deployment seat `onError` (the stranded-answer and synthetic-continuation operator
@@ -48,7 +50,7 @@ export interface PrepareQuestionFaceInput {
48
50
  /** borrowed-readonly — the durable-resume carrier; only the redeemed content-ask call id and its questions
49
51
  * hash are read (the one call an operator's approval was spent on). */
50
52
  resume: Pick<PrepareResume, "redeemedContentAskCallId" | "redeemedContentAskQuestionsHash"> | undefined;
51
- /** borrowed-readonly — the acquired session id (the tool's source task id; operator-line context). */
53
+ /** borrowed-readonly — the acquired session id (operator-line context). */
52
54
  sessionId: string;
53
55
  /** borrowed-mutable — the run's roster builder (identity is the contract). Writer here: ONE mount (the question
54
56
  * tool) when the mount predicate holds; `contentAskRoutable` reads `includes` per call against the LIVE
@@ -6,7 +6,7 @@ import { CONTENT_ASK_BINDING_CAP } from "./content-ask-bindings.js";
6
6
  import { RosterBuilder } from "../tool-roster.js";
7
7
  export { CONTENT_ASK_BINDING_CAP } from "./content-ask-bindings.js";
8
8
  export function prepareQuestionFace(input) {
9
- const { frozenOnQuestion, spec, deps, checkpointStore, runtimeCaps, resolvedInteractionPosture, resume, sessionId, roster, toolFaceSnapshot, inheritedUnavailableAsks } = input;
9
+ const { frozenOnQuestion, spec, askSource, deps, checkpointStore, runtimeCaps, resolvedInteractionPosture, resume, sessionId, roster, toolFaceSnapshot, inheritedUnavailableAsks } = input;
10
10
  const tools = roster.tools;
11
11
  const onQuestion = frozenOnQuestion;
12
12
  const liveQuestionFace = isLiveQuestionFace(onQuestion) ? onQuestion : undefined;
@@ -63,7 +63,7 @@ export function prepareQuestionFace(input) {
63
63
  let mountedQuestionTool;
64
64
  if (questionToolMounted)
65
65
  roster.mount((mountedQuestionTool =
66
- createAskUserQuestionTool(mountedQuestionFace, { principal: spec.principal, sourceTaskId: sessionId }, {
66
+ createAskUserQuestionTool(mountedQuestionFace, askSource, {
67
67
  ...(resume?.redeemedContentAskCallId !== undefined
68
68
  ? {
69
69
  redeemedApprovalCallId: resume.redeemedContentAskCallId,
@@ -25,6 +25,7 @@ import type { ReviewRequest } from "../present-plan-tool.js";
25
25
  import type { PermissionModeController } from "../mode-policy.js";
26
26
  import { type EditedFilesLedger } from "./edited-files-ledger.js";
27
27
  import { type ToolOccurrenceTable } from "./tool-occurrence.js";
28
+ import type { ReadFloorSeat } from "../../tools/fs/read-floor.js";
28
29
  export interface PrepareRunRefsInput {
29
30
  /** borrowed-readonly — the REBOUND spec. Read: `forwardSubagentEvents` (widens the forwarding filter),
30
31
  * `retainSubagentSessions` (the ledger opt-in and its config), `handsReadOnly` (a read-only run mints no
@@ -40,6 +41,8 @@ export interface PrepareRunRefsInput {
40
41
  executionEnv: ExecutionEnv;
41
42
  /** borrowed-readonly — the SETTLED task root (`taskRootFinal`): the worktree helper's base repo root. */
42
43
  taskRootFinal: string;
44
+ /** borrowed-readonly — the run's byte-floor seat (read-floor.ts), read at each start: the worktree helper's git carries the run's base table. */
45
+ readFloor: ReadFloorSeat;
43
46
  }
44
47
  export interface PrepareRunRefsResult {
45
48
  /** owned — the ledger's writer (`FileEditedHook`): handed to the hands/read-face phase as its post-write