@sema-agent/core 7.60.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 (482) hide show
  1. package/CHANGELOG.md +605 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +61 -10
  6. package/dist/agents/cascade.js +60 -20
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -47,20 +47,25 @@ import type { ToolCallLike } from "../tool-registry.js";
47
47
  import type { FrameSettlement } from "../frame-settlement.js";
48
48
  import { type ApprovedCallScreen } from "./call-hook-stations.js";
49
49
  /**
50
- * The parent-thread human-rejection boundary — judged ONCE here, from the pass's own record (CC parity:
51
- * the reference CLI's reject path aborts exactly when there is no feedback and the run is not a
52
- * subagent; a rejection WITH the decider's note, and every delegated child — forks included — keep the
53
- * continue / adapt-or-report posture): the final block IS a person's refusal (`deniedBy: ask_resolution`
54
- * and a `human_refused` settlement — not a later fold layer's deny that merely followed a human
55
- * interaction), the refusal carried NO note (`settlement.note` absent — a fact composed at the refusal,
56
- * never re-derived from message text), and the run is not a delegated child (the raw trusted delegation
57
- * facet — the same fact that selects the refusal text's posture, so the boundary and the words the model
58
- * was told always agree). Policy/hook/classifier denies and window/abort settlements never satisfy it.
59
- *
60
- * Returns the loop directive that settles every never-started same-batch sibling: honest
61
- * known-not-executed wording plus the machine mark (`error`/`code` twin — the wire errorCode lift
62
- * reads `details.code`; `details.error` is the in-band mark result consumers grep) naming the
63
- * rejected call. `undefined` = no boundary (the block stands alone, current behavior).
50
+ * The parent-thread human-rejection boundary — THE judgment behind every halt on a person's "no", read off the one
51
+ * record a decide mints (a live gate pass's, a parked tool approval's, a plan pause's), never off message text. CC
52
+ * parity: the reference's reject handler (one handler for a tool call's card and the plan card) aborts the turn
53
+ * exactly when there is no feedback, no attached content and the run is not a subagent; a rejection WITH the decider's
54
+ * note, and every delegated child — forks included — keep the continue / adapt-or-report posture. True iff the record
55
+ * IS a person's refusal (`deniedBy: ask_resolution` and a `human_refused` settlement — not a later fold layer's deny
56
+ * that merely followed a human interaction), the refusal carried NO note (`settlement.note` absent — a fact composed
57
+ * at the refusal, never re-derived from message text), and the leg is not a delegated child (the raw trusted
58
+ * delegation facet — the same fact that selects the refusal text's posture, so the boundary and the words the model
59
+ * was told always agree). Policy/hook/classifier denies and window/abort settlements never satisfy it. A leg it
60
+ * answers true for ends its turn awaiting the user: the live batch through {@link maybeHumanRejectionHalt}'s
61
+ * directive, a resumed leg by recording the decision and requesting nothing more.
62
+ */
63
+ export declare function isBareHumanRefusal(gate: GateOutcome | undefined, isDelegatedChild: boolean): boolean;
64
+ /**
65
+ * The loop directive a bare refusal of a CALL ({@link isBareHumanRefusal}) hands the batch it halts: it settles every
66
+ * never-started same-batch sibling with honest known-not-executed wording plus the machine mark (`error`/`code` twin —
67
+ * the wire errorCode lift reads `details.code`; `details.error` is the in-band mark result consumers grep) naming the
68
+ * rejected call. `undefined` = no boundary (the block stands alone).
64
69
  */
65
70
  export declare function maybeHumanRejectionHalt(input: {
66
71
  gate: GateOutcome | undefined;
@@ -29,11 +29,13 @@ function screenGateResult(result) {
29
29
  }
30
30
  return defects.length > 0 ? { defects } : { gate, defects };
31
31
  }
32
+ export function isBareHumanRefusal(gate, isDelegatedChild) {
33
+ const d = gate?.disposition;
34
+ const s = gate?.settlement;
35
+ return d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined && !isDelegatedChild;
36
+ }
32
37
  export function maybeHumanRejectionHalt(input) {
33
- const d = input.gate?.disposition;
34
- const s = input.gate?.settlement;
35
- const bare = d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined;
36
- if (!bare || input.isDelegatedChild)
38
+ if (!isBareHumanRefusal(input.gate, input.isDelegatedChild))
37
39
  return undefined;
38
40
  return {
39
41
  reason: `This tool call was NOT executed: the user rejected the "${input.toolName}" tool call in the same ` +
@@ -210,7 +210,7 @@ export interface PrepareHandsReadFaceResult {
210
210
  /** owned — the wsSnapshot path rebaser (identity when no snapshot / same root); the G4 worktree
211
211
  * seed applies it to the snapshot's worktree paths. */
212
212
  rebaseWsPath: (p: string) => string;
213
- /** owned — real shell + write hands + background-capable env: gates the driver's TaskOutput/
213
+ /** owned — real shell + write hands + background-capable env: gates the driver's
214
214
  * TaskStop/Monitor/SendMessage mounts (P11) and the Monitor arm of the shellGate fold here. */
215
215
  backgroundTaskToolsActive: boolean;
216
216
  /** owned — this run's READ STATIONS as the one gate input (`ToolGateInput.shellReadCheck`): the shell's (ONE judgment of
@@ -222,9 +222,9 @@ export interface PrepareHandsReadFaceResult {
222
222
  /** owned — the same station's pre-spawn ADMISSION, published for the P11 face that spawns a shell command
223
223
  * and mounts LATER than the band (`Monitor`): the SAME function the band's shell faces got. ⇔ a real shell. */
224
224
  shellReadAdmission: ShellReadAdmission | undefined;
225
- /** owned — the byte floor's seat over the run's read-deny table (read-floor.ts), for the same LATER face (`Monitor`): the
226
- * table the band's shell faces carry to the environment on every start. ⇔ a real shell. */
227
- shellReadFloor: ReadFloorSeat | undefined;
225
+ /** owned — the byte floor's seat over the run's read-deny tables (read-floor.ts): every start the run makes reads its floor
226
+ * through it, at the start — a call's own pinned table, else the run's base table. ⇔ the run compiled tables (hands). */
227
+ runReadFloor: ReadFloorSeat | undefined;
228
228
  /** owned — the same station's landings of a judged call (`ShellReadStation.landings`): the park binds them, the resumed leg's execution station compares. ⇔ a real shell. */
229
229
  shellReadLandings: ShellReadLandings | undefined;
230
230
  /** owned — the file read station's admission (`FileReadStation.admitted`) the band's read tools got, for the read tools mounted later (LSP). */
@@ -287,7 +287,7 @@ export interface PrepareHandsReadFaceResult {
287
287
  * mounts (Monitor, the worktree pair — the SAME Set identity, mutated at those mount sites).
288
288
  * Consumed by the O9a external-content-target fold: these are the tools whose RESULTS are the
289
289
  * target's bytes, so membership must be what actually mounted on the env — never a static table
290
- * (the wake/resume reconciliation table lists TaskOutput/TaskStop, which are orchestration, and
290
+ * (the wake/resume reconciliation table lists TaskStop, which is orchestration, and
291
291
  * misses Monitor/worktree, which are hands — both directions wrong for this consumer). Empty on
292
292
  * a hands-less leg (nothing mounts on the env; the driver's env mounts are hands-gated too). */
293
293
  envHandToolNames: Set<string>;
@@ -87,7 +87,7 @@ export function resolveHandsLessReadFace(input) {
87
87
  shellReadCheck: undefined,
88
88
  shellReadStationArmed: false,
89
89
  shellReadAdmission: undefined,
90
- shellReadFloor: undefined,
90
+ runReadFloor: undefined,
91
91
  shellReadLandings: undefined,
92
92
  readAdmission: undefined,
93
93
  resolvedReadFace: undefined,
@@ -124,7 +124,7 @@ export async function prepareHandsMount(input) {
124
124
  let rebaseWsPath = (p) => p;
125
125
  let backgroundTaskToolsActive = false;
126
126
  let shellReadStation;
127
- let shellReadFloor;
127
+ let runReadFloor;
128
128
  let shellReadTools = new Set();
129
129
  let fileReadStation;
130
130
  let resolvedReadFace;
@@ -224,6 +224,7 @@ export async function prepareHandsMount(input) {
224
224
  };
225
225
  const tables = (pathTables = await input.personRows.attachTables(judgedRunTables));
226
226
  readDenyMatcher = tables.readDeny;
227
+ runReadFloor = readFloorSeat(tables.readDeny);
227
228
  readRoots = readRootsOver({ own: () => [...additionalRootsCanonical, ...additionalReadRootsCanonical], tables, ready: input.personRows.tablesReady, store: () => artifactStoreRef.current,
228
229
  onHeld: (entry, store) => emitTrace(deps.tracer, () => ({ kind: "config.additional_directory_skipped", version: 1, taskId: hostTaskId, entry, field: "persistedReadRule", reason: `admits_artifact_store: the local artifact store ${store} lies inside it or it inside the store — the Artifact tool's ledger and stored files stay outside every root the file tools reach`, ts: Date.now() })) });
229
230
  readDenyBuiltinTiersActive = activeReadDenyBuiltinTiers(readDenyBuiltinCfg);
@@ -322,7 +323,6 @@ export async function prepareHandsMount(input) {
322
323
  return { roots: [rootCanonical, ...readRoots.forCall(toolCallId)()], cwd: rootCanonical, ...denySeat, ...writeDenySeat, ...(input.personRows.unreadFor(toolCallId) ? { unreadPartitions: true } : {}), alsoInside: spoolFence };
323
324
  };
324
325
  shellReadTools = new Set(shellFaceHere);
325
- shellReadFloor = readFloorSeat(tables.readDeny);
326
326
  shellReadStation = createShellReadStation({
327
327
  env: executionEnv,
328
328
  tools: shellReadTools,
@@ -427,7 +427,7 @@ export async function prepareHandsMount(input) {
427
427
  shellReadCheck: onPinnedRead(input.personRows, [...(shellReadStation !== undefined ? [{ check: shellReadStation.check, tools: shellReadTools }] : []), ...(fileReadStation !== undefined ? [fileReadStation] : [])]),
428
428
  shellReadStationArmed: shellReadStation !== undefined,
429
429
  shellReadAdmission: shellReadStation?.admit,
430
- shellReadFloor,
430
+ runReadFloor,
431
431
  shellReadLandings: shellReadStation?.landings,
432
432
  readAdmission: fileReadStation?.admitted,
433
433
  resolvedReadFace,
@@ -44,6 +44,7 @@ import type { OwnOrgAdmissionVerdict } from "../memory-admission.js";
44
44
  import type { DelegationContentSafety } from "../memory-engine/delegation-provenance.js";
45
45
  import type { SessionPermissionRules } from "../session-policy-store.js";
46
46
  import type { SessionStore } from "../session.js";
47
+ import { type PlacementTarget } from "../remote-env.js";
47
48
  import { type OnAsk, type ToolPolicy } from "../tool-policy.js";
48
49
  import type { PathRuleBases } from "../permission-rule-model.js";
49
50
  import type { PermissionMode, RunnerDeps, RuntimeCaps, ShellGateDoctrine, TaskEvent, TaskSpec, ToolExecuteContext, ToolSpec } from "../types.js";
@@ -91,6 +92,9 @@ export interface PrepareInheritedGateInput {
91
92
  hostTaskId: string;
92
93
  /** borrowed-readonly — the SETTLED task root (`ctx.parentCwd`). */
93
94
  taskRootFinal: string;
95
+ /** borrowed-readonly — the target this leg's env reported as its workspace settled (`ctx.placementTarget`: the fence of
96
+ * every agent the delegation tools spawn or wake from this leg); absent when it reported none. */
97
+ ownTarget: PlacementTarget | undefined;
94
98
  /** borrowed-readonly — the run's resolved env: the full-shell predicate's kind test and the hook-env identity value. */
95
99
  executionEnv: ExecutionEnv;
96
100
  /** borrowed-readonly — the per-task owned env when a factory minted one (the hook-env identity predicate reads presence). */
@@ -177,6 +181,8 @@ export interface PrepareInheritedGateInput {
177
181
  agentForkDenial: () => ReturnType<typeof forkGovernanceDenial>;
178
182
  /** borrowed-readonly — LATE-BOUND: the leg's agent stations (ctx `agentStations`; bound once the leg's identity is known). */
179
183
  agentStations: () => import("../mods/agent-stations.js").AgentStations | undefined;
184
+ /** borrowed-readonly — LATE-BOUND: the leg's `session.send` station (ctx `sendStation`; bound once the leg's identity is known). */
185
+ sendStation: () => import("../mods/session-send.js").SendStation | undefined;
180
186
  /** borrowed-readonly — LATE-BOUND: the observers grant (ctx `observersAllowed`, present only when explicitly granted). */
181
187
  observersActive: () => boolean;
182
188
  /** borrowed-readonly — LATE-BOUND: the hands mount's resolved read face (undefined until/unless hands mount). */
@@ -188,10 +188,12 @@ export function prepareInheritedGate(input) {
188
188
  const autoModeDecider = input.autoModeDecider();
189
189
  const centerAdoption = input.centerAdoption();
190
190
  const agentStations = input.agentStations();
191
+ const sendStation = input.sendStation();
191
192
  return {
192
193
  ...ctx,
193
194
  delegationEntryCaps: delegationEntryCapsResolved,
194
195
  ...(agentStations !== undefined ? { agentStations } : {}),
196
+ ...(sendStation !== undefined ? { sendStation } : {}),
195
197
  reportUsage,
196
198
  model: harnessRef.current?.getModel(),
197
199
  modelRef: harnessRef.current?.getModelRef(),
@@ -226,6 +228,7 @@ export function prepareInheritedGate(input) {
226
228
  },
227
229
  getApiKeyAndHeaders: spec.getApiKeyAndHeaders,
228
230
  parentCwd: taskRootFinal,
231
+ ...(input.ownTarget !== undefined ? { placementTarget: input.ownTarget } : {}),
229
232
  ...(input.hostFloor !== undefined ? { hostFloor: input.hostFloor } : {}),
230
233
  ...(fileHistoryEnabled ? { fileHistoryLineage: { scope: historyScope, root: historyRoot, fs: historyFs } } : {}),
231
234
  reminderMark,
@@ -17,6 +17,7 @@ import { type LspListedWithholding, type LspReadFace } from "../lsp.js";
17
17
  import type { LspDiagnosticsRegistry } from "../lsp-diagnostics.js";
18
18
  import type { RunnerDeps, TaskSpec } from "../types.js";
19
19
  import { RosterBuilder } from "../tool-roster.js";
20
+ import type { ReadFloorSeat } from "../../tools/fs/read-floor.js";
20
21
  export interface PrepareLspInput {
21
22
  /** borrowed-readonly — the REBOUND spec. Read: `lspManager` (the per-task manager, outranks the deployment's),
22
23
  * `lspDiagnostics` (the lane's opt-out), `handsReadOnly` (a read-only run has no lane). Never mutated. */
@@ -26,6 +27,8 @@ export interface PrepareLspInput {
26
27
  /** borrowed-readonly — the run's resolved env: the tool's in-env server and git-ignore filter, and the
27
28
  * session lookup the nudge performs. */
28
29
  executionEnv: ExecutionEnv;
30
+ /** borrowed-readonly — the run's byte-floor seat (read-floor.ts): the git-ignore filter's starts carry the run's base table. */
31
+ readFloor: ReadFloorSeat;
29
32
  /** borrowed-readonly — the SETTLED task root: the tool's git-ignore root. */
30
33
  taskRootFinal: string;
31
34
  /** borrowed-readonly — the leg's read face (the hands phase's root, read roots, deny table, containment face, tracked
@@ -2,10 +2,10 @@ import { createLspTool, gitCheckIgnoreFilter, lspBaseOf, lspListedWithheld, lspR
2
2
  import { pathToUri } from "../lsp-protocol.js";
3
3
  import { RosterBuilder } from "../tool-roster.js";
4
4
  export function prepareLsp(input) {
5
- const { spec, deps, executionEnv, taskRootFinal, readFace, sessionId, roster, envHandToolNames } = input;
5
+ const { spec, deps, executionEnv, readFloor, taskRootFinal, readFace, sessionId, roster, envHandToolNames } = input;
6
6
  const lspManager = spec.lspManager ?? deps.lspManager;
7
7
  if (lspManager && readFace) {
8
- roster.mount(createLspTool(lspManager, { isPathIgnored: gitCheckIgnoreFilter(executionEnv, taskRootFinal), env: executionEnv, readFace }), { source: "builtin", mountedBy: "hands" });
8
+ roster.mount(createLspTool(lspManager, { isPathIgnored: gitCheckIgnoreFilter(executionEnv, taskRootFinal, () => readFloor(undefined)), env: executionEnv, readFace }), { source: "builtin", mountedBy: "hands" });
9
9
  envHandToolNames.add("LSP");
10
10
  }
11
11
  const lspDiagnostics = spec.lspDiagnostics !== false && lspManager?.diagnostics !== undefined && readFace !== undefined && spec.handsReadOnly !== true
@@ -25,7 +25,7 @@ import { type OnQuestion } from "../ask-question.js";
25
25
  import { type CheckpointStore } from "../checkpoint-store.js";
26
26
  import { type GrantBindingOf } from "../skill-grant-binding.js";
27
27
  import type { SessionStore } from "../session.js";
28
- import { type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
28
+ import { type AskSourceIdentity, type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
29
29
  import { type ToolResultStore } from "../tool-result-store.js";
30
30
  import type { RunnerDeps, RuntimeCaps, ShellGateDoctrine, TaskSpec } from "../types.js";
31
31
  import type { CwdRef } from "../../tools/fs/fs-shared.js";
@@ -51,8 +51,11 @@ export interface PrepareParkAskInput {
51
51
  /** borrowed-readonly — the deployment's error face, as a Pick over the SAME `deps` object (receiver preserved for
52
52
  * `deps.onError?.()`): the park refusals' disclosure, the pin failure. */
53
53
  deps: Pick<RunnerDeps, "onError">;
54
- /** borrowed-readonly — the acquired session id (the question's `sourceTaskId`, the row's session and source, every tag). */
54
+ /** borrowed-readonly — the acquired session id (the row's session, every tag). */
55
55
  sessionId: string;
56
+ /** borrowed-readonly — the leg's one ask source (minted once by the driver): the routed question's source members and the
57
+ * approval row's `sourceSessionId`. */
58
+ askSource: AskSourceIdentity;
56
59
  /** borrowed-readonly — the leg's checkpoint store, or undefined (then `suspendAsk` is absent — the park predicate's store
57
60
  * term). Read: the declared fidelity; the saga writes to it. */
58
61
  checkpointStore: CheckpointStore | undefined;
@@ -2,7 +2,7 @@ import { callTargetReadingOf } from "../effective-path-target.js";
2
2
  import { approvalTargetsOf } from "../approval-object.js";
3
3
  import { uuidv7 } from "../../engine/session/uuid.js";
4
4
  import { Value } from "typebox/value";
5
- import { classifyQuestionOutcome, isEngineQuestionFace, validateAskQuestions } from "../ask-question.js";
5
+ import { classifyQuestionOutcome, isEngineQuestionFace, questionSourceOf, validateAskQuestions } from "../ask-question.js";
6
6
  import { hasBackgroundShell, sweepBackgroundShells, sweepRunBoundaryBackgroundShells } from "../background-shell.js";
7
7
  import { boundInputHashOf, exactBoundInputHashOf } from "../canonical-json.js";
8
8
  import { buildRiskDescriptor, debitLedger, encodeAtFidelity, mintCheckpointId, mintCheckpointToken, resolveDeclaredFidelity, } from "../checkpoint-store.js";
@@ -30,7 +30,7 @@ const wordlessDemand = (toolName) => {
30
30
  throw new Error(`a real-approval demand for "${toolName}" reached the park with no origin word — the origin stamp precedes every park`);
31
31
  };
32
32
  export function prepareParkAsk(input) {
33
- const { askLane, saga, spec, deps, sessionId, checkpointStore, checkpointScope, toolRosterDeltas, parkLaneArmed, contentAskRoutable, liveQuestionFace, mountedQuestionTool, contentAskBindings, lateStrandedAnswers, discloseStrandedAnswers, onAsk, runtimeCaps, inheritedUnavailableAsks, basePolicyForResumeEdit, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, shellReadLandings, advertisedWritableDirs, exemptRoots, offloadStore, suspendTargetGap, session, sessions, suspendChainBase, maxSuspends, remoteEnvFailures, shellGatedTools, irreversibilityTier, toolMarkSources, effectiveShellGate, durableApproval, priorLedger, liveSpendRef, resourceTotal, ruleOffersOf, grantBindingOf, now, humanReviewRef, abortController, harness, pausedRef } = input;
33
+ const { askLane, saga, spec, deps, sessionId, askSource, checkpointStore, checkpointScope, toolRosterDeltas, parkLaneArmed, contentAskRoutable, liveQuestionFace, mountedQuestionTool, contentAskBindings, lateStrandedAnswers, discloseStrandedAnswers, onAsk, runtimeCaps, inheritedUnavailableAsks, basePolicyForResumeEdit, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, shellReadLandings, advertisedWritableDirs, exemptRoots, offloadStore, suspendTargetGap, session, sessions, suspendChainBase, maxSuspends, remoteEnvFailures, shellGatedTools, irreversibilityTier, toolMarkSources, effectiveShellGate, durableApproval, priorLedger, liveSpendRef, resourceTotal, ruleOffersOf, grantBindingOf, now, humanReviewRef, abortController, harness, pausedRef } = input;
34
34
  if (askLane === undefined || saga === undefined)
35
35
  return { parkAsk: undefined };
36
36
  const { composedCallSignal, approvalPreviewOf } = askLane;
@@ -70,8 +70,7 @@ export function prepareParkAsk(input) {
70
70
  const facePromise = (async () => liveQuestionFace({
71
71
  toolCallId: req.toolCallId,
72
72
  questions: presented,
73
- ...(spec.principal !== undefined ? { principal: spec.principal } : {}),
74
- sourceTaskId: sessionId,
73
+ ...questionSourceOf(askSource),
75
74
  boundInputHash: boundInputHashOf(retained),
76
75
  deliveryId,
77
76
  }, contentAskSignal))();
@@ -341,7 +340,7 @@ export function prepareParkAsk(input) {
341
340
  : undefined,
342
341
  suspendCount: suspendChainBase() + 1,
343
342
  resourceLedger: approvalLedger,
344
- sourceTaskId: sessionId,
343
+ sourceSessionId: askSource.sourceSessionId,
345
344
  ...(spec.principal ? { principal: spec.principal } : {}),
346
345
  ...(durableApproval !== undefined ? { durableApproval: { ...durableApproval } } : {}),
347
346
  };
@@ -26,7 +26,7 @@ import type { AutoModeDecider } from "../auto-mode.js";
26
26
  import { type InheritedInstallation, type LegModBus, type ModChainLink } from "../mods/stations.js";
27
27
  import type { LockedPreflight } from "../locked-config.js";
28
28
  import { type SessionPermissionRules } from "../session-policy-store.js";
29
- import { type OnAsk, type ToolPolicy } from "../tool-policy.js";
29
+ import { type AskSourceIdentity, type OnAsk, type ToolPolicy } from "../tool-policy.js";
30
30
  import type { PathRuleBases } from "../permission-rule-model.js";
31
31
  import type { HeadLeads } from "../path-rule-binding.js";
32
32
  import type { RunnerDeps, RuntimeCaps, TaskSpec, ToolEffect } from "../types.js";
@@ -36,7 +36,7 @@ import { type SkillGrantLane, type SkillGrantSource, type SkillGrantTable } from
36
36
  import { type GrantBindingOf } from "../skill-grant-binding.js";
37
37
  import type { ToolSelector } from "../tool-face.js";
38
38
  import { type AllowEntryLane, type AllowEntryTable } from "../allow-entry.js";
39
- import type { InheritedGate, IrreversibilityTier, PrepareResume, RunInternals, StopForDenialLimit } from "./contracts.js";
39
+ import type { InheritedGate, IrreversibilityTier, PrepareResume, StopForDenialLimit } from "./contracts.js";
40
40
  import { type Arbitration } from "../ask-origin.js";
41
41
  import { type ModeGateSeats, type PermissionModeController } from "../mode-policy.js";
42
42
  import { type InheritedAskGrant } from "./inherited-ask-grants.js";
@@ -47,22 +47,19 @@ export interface PreparePolicyChainInput {
47
47
  /** borrowed-readonly — the deployment's host floor as the config doors compiled it: the leading narrowing layer when declared. */
48
48
  hostFloor: HostFloor | undefined;
49
49
  /** borrowed-readonly — the REBOUND spec. Read: `sessionId` / `principal` (the session-rule read and the lanes' identity),
50
- * `durableApproval` / `checkpointStore` (the mandate-park facility test and the sandbox arming's park prerequisites), `taskId` (the late-ask observer's detail),
50
+ * `durableApproval` / `checkpointStore` (the mandate-park facility test and the sandbox arming's park prerequisites),
51
51
  * `tools` (the names the caller mounted, for the name audit), `classifyAllShell` (every allow member's auto strip). Never mutated. */
52
- spec: Pick<TaskSpec, "sessionId" | "principal" | "durableApproval" | "taskId" | "checkpointStore" | "tools" | "excludeAllTools" | "classifyAllShell">;
52
+ spec: Pick<TaskSpec, "sessionId" | "principal" | "durableApproval" | "checkpointStore" | "tools" | "excludeAllTools" | "classifyAllShell">;
53
53
  /** borrowed-readonly — the deployment seats: `sessionPolicyStore` (the rule reads),
54
54
  * `permissionRuleStore` / `localOwnerRules` (the lanes and the offer factory), `onError` / `onNotice` (the advisories,
55
55
  * the refusal disclosures, the late-ask observer), `tracer` (the admission and rule-store frames), `checkpointStore` (the park facility). Receiver preserved;
56
56
  * the advisory dedupe is KEYED on this object's identity. */
57
57
  deps: Pick<RunnerDeps, "sessionPolicyStore" | "permissionRuleStore" | "localOwnerRules" | "onError" | "onNotice" | "tracer" | "checkpointStore" | "a2a">;
58
- /** borrowed-readonly — the trusted spawn-side channel: `parentTaskId` (the from-subagent bit), `explicitAgentName` /
59
- * `agentName` (the source agent name) — the ask source identity's local, trusted facts. */
60
- internals: Pick<RunInternals, "parentTaskId" | "explicitAgentName" | "agentName"> | undefined;
61
- /** borrowed-readonly — the acquired session id (every operator line's attribution; the ask source's task id). */
58
+ /** borrowed-readonly — the acquired session id (the config-phase error tags and the earlier-grammar notice's session). */
62
59
  sessionId: string;
63
60
  /** borrowed-readonly — the run's invocation id (the late-ask observer's detail). */
64
61
  runId: string;
65
- /** borrowed-readonly — the per-task identity (the trace frames' taskId; the rule-store disclosure). */
62
+ /** borrowed-readonly — the per-task identity (the trace frames' taskId; the rule-store disclosure; the late-ask observer's detail). */
66
63
  hostTaskId: string;
67
64
  /** borrowed-readonly — the FINAL task root (path rules resolve against it; the lanes' and the offers' root). */
68
65
  taskRootFinal: string;
@@ -171,10 +168,8 @@ export interface PreparePolicyChainInput {
171
168
  /** borrowed-readonly — the leg's live roster seat; the mode write gate reads `current` per call. */ toolRosterDeltas: NonNullable<ModeGateSeats["roster"]>;
172
169
  /** borrowed-readonly — the run's ONE typed stop for a denial-limit bound (the fallback settlements call it). */
173
170
  stopForDenialLimit: StopForDenialLimit;
174
- /** borrowed-readonly — the effective delegation facts; only `isDelegatedChild` (the ask source identity). */
175
- delegation: {
176
- isDelegatedChild: boolean;
177
- };
171
+ /** borrowed-readonly — the leg's one ask source ({@link import("../leg-identity.js").mintAskSourceIdentity}): every ask mint here spreads it. */
172
+ askSource: AskSourceIdentity;
178
173
  /** borrowed-readonly — the run's abort controller; only `signal` (the default call signal of every closure here). */
179
174
  abortController: Pick<AbortController, "signal">;
180
175
  /** borrowed-readonly — the injectable wall-clock (the inherited arms' human-wait timing). */
@@ -223,14 +218,6 @@ export interface PreparePolicyChainResult {
223
218
  /** borrowed-mutable — the grant record. Writers: the inherited arms here (record a clean allow at a live approver);
224
219
  * the gate station (consume on reuse, sweep at settlement). */
225
220
  inheritedAskGrants: Map<string, InheritedAskGrant>;
226
- /** owned — the SINGLE AskRequest source-identity factory every resolveAsk construction site spreads. */
227
- askSourceIdentity: () => {
228
- principal?: string;
229
- sourceTaskId?: string;
230
- fromSubagent?: true;
231
- sourceAgentName?: string;
232
- isDelegatedChild?: true;
233
- };
234
221
  /** owned — the engine-judged risk axes for an ask, from the same resolved sources the safety tightens use. */
235
222
  riskAxesOf: (call: Pick<ToolCallLike, "toolName" | "face">) => {
236
223
  riskAxes?: {
@@ -250,6 +237,8 @@ export interface PreparePolicyChainResult {
250
237
  ruleLaneFacts: import("./memory-consolidation-write-judge.js").ConsolidationWriteJudgeLeg["lanes"];
251
238
  /** owned — the org permission-rule lane (`Prepared.permissionRuleOrg`), or undefined. */
252
239
  permissionRuleOrgLane: PermissionRuleLanes["org"];
240
+ /** owned — the two lanes' whole-tool readings over one read (the tool table's view), or undefined. */
241
+ storedRuleWholeToolRefusals: PermissionRuleLanes["wholeToolRefusals"];
253
242
  /** owned — whether the sandbox-admission mode armed (declared isolation with its park prerequisites). */
254
243
  sandboxAdmissionArmed: boolean;
255
244
  /** owned — the NOT-CONTAINED classification: a call the declared sandbox does not contain. */
@@ -21,10 +21,10 @@ import { SKILL_TOOL_NAME } from "./synthetic-tools.js";
21
21
  import { delegationPoolReading, policyNameRefusal, POLICY_NAME_REFUSAL_CODE } from "./sub-agent-deny-lists.js";
22
22
  import { valveLeaves } from "../../agents/tool-filter.js";
23
23
  import { autoStrippedRule, cardDisclosureOf, classifiesAllShell, rootFacingToolNames } from "../allow-entry.js";
24
- import { arbitrateByMode, askClassMembersOf, askFaceOf, askMandateMember } from "../ask-origin.js";
24
+ import { arbitrateByMode, askClassMembersOf, askFaceOf, askMandateMember, INHERITED_STATION_FACTS } from "../ask-origin.js";
25
25
  import { createModeGatePolicy, mountedToolDeclaresReadOnly } from "../mode-policy.js";
26
26
  const ancestorFacts = (ask) => ({ ...(ask ?? {}), ancestorResolved: true });
27
- 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";
28
28
  import { settleReadRootGrant } from "./read-root-grant.js";
29
29
  import { frozenApproverRoute } from "../wiring-manifest.js";
30
30
  import { askGrantShapeOf } from "./inherited-ask-grants.js";
@@ -34,7 +34,7 @@ import { policyThrowLine, reportPolicyThrow } from "./policy-throw.js";
34
34
  import { heldBy, heldValues, seatOf, wireOf } from "../tool-name-readings.js";
35
35
  import { hostFloorPolicy } from "../host-floor.js";
36
36
  export async function preparePolicyChain(input) {
37
- 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;
38
38
  const ancestorArbitrations = new Map();
39
39
  const arbitrateInherited = (ask, toolCallId, judged) => {
40
40
  const verdict = arbitrateByMode(permissionMode.current, judged.classification, { origin: judged.origin, ...askMandateMember(ancestorFacts(judged.ask.action === "ask" ? judged.ask : undefined)) });
@@ -287,15 +287,6 @@ export async function preparePolicyChain(input) {
287
287
  return decision;
288
288
  })
289
289
  : policy;
290
- const askSourceIdentity = () => ({
291
- principal: spec.principal,
292
- sourceTaskId: sessionId,
293
- ...(internals?.parentTaskId !== undefined ? { fromSubagent: true } : {}),
294
- ...((internals?.explicitAgentName ?? internals?.agentName) !== undefined
295
- ? { sourceAgentName: internals?.explicitAgentName ?? internals?.agentName }
296
- : {}),
297
- ...(delegation.isDelegatedChild ? { isDelegatedChild: true } : {}),
298
- });
299
290
  const seatMarksOf = (call) => {
300
291
  const tierSeat = seatOf("report.riskAxes", irreversibilityTier, call);
301
292
  return {
@@ -345,7 +336,7 @@ export async function preparePolicyChain(input) {
345
336
  onDisclosure: (message) => emitTrace(deps.tracer, () => ({ kind: "permission.rule_store_unreadable", version: 1, taskId: hostTaskId, message, ts: Date.now() })),
346
337
  stripsAllow: (rule, req) => autoStrippedRule(rule, req, permissionMode.current, listFacts.classifyAllShell),
347
338
  };
348
- 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 });
349
340
  const ruleOffersOf = createRuleOffersOf({
350
341
  laneArmed: permissionRuleLane !== undefined,
351
342
  principal: spec.principal,
@@ -415,7 +406,7 @@ export async function preparePolicyChain(input) {
415
406
  args: editArgs,
416
407
  ...ruleOffersOf(creq, editArgs, ancestorFacts(j.ask)),
417
408
  ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
418
- ...askSourceIdentity(),
409
+ ...askSource,
419
410
  ...riskAxesOf(creq),
420
411
  ...approvalCardMemberOf(creq),
421
412
  ...grantBindingOf(creq, editArgs),
@@ -423,8 +414,8 @@ export async function preparePolicyChain(input) {
423
414
  ...askMandateMember(ancestorFacts(j.ask)),
424
415
  ...inheritedAskCarry(j, isLiveApproverSeat(onAskOf), ancestorTracker),
425
416
  ruleEvidence: inheritedAskEvidence,
426
- }, 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));
427
- 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 });
428
419
  settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: ancestorTracker, resolved: rr, headless: headlessDenyAtRecheck, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
429
420
  if (rr.action !== "allow")
430
421
  return rr;
@@ -471,7 +462,7 @@ export async function preparePolicyChain(input) {
471
462
  args: presentedArgs,
472
463
  ...ruleOffersOf(creq, presentedArgs, ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
473
464
  ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
474
- ...askSourceIdentity(),
465
+ ...askSource,
475
466
  ...riskAxesOf(creq),
476
467
  ...approvalCardMemberOf(creq),
477
468
  ...grantBindingOf(creq, presentedArgs),
@@ -479,12 +470,12 @@ export async function preparePolicyChain(input) {
479
470
  ...askMandateMember(ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
480
471
  ...inheritedAskCarry(j, isLiveApproverSeat(pc.onAsk), pc.autoMode?.denialTracking),
481
472
  ruleEvidence: inheritedAskEvidence,
482
- }, 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));
483
- 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 });
484
475
  const askWaitMs = Math.max(0, now() - askT0);
485
476
  if (resolved.action === "deny" && resolved.approverUnavailable === true) {
486
477
  if (markInheritedUnavailable(creq.toolCallId))
487
- return settledAs(settled.ask);
478
+ return settledAs(floatedInheritedAsk(settled, creq));
488
479
  return settledAs(markerChannelFullDeny(creq));
489
480
  }
490
481
  settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: pc.autoMode?.denialTracking, resolved, headless: headlessDenyAtFold, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
@@ -554,7 +545,7 @@ export async function preparePolicyChain(input) {
554
545
  args: presentedArgs,
555
546
  ...ruleOffersOf(creq, presentedArgs, ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
556
547
  ...cardDisclosureOf(j.ask, inheritedAskFallbackMessage(creq.toolName)),
557
- ...askSourceIdentity(),
548
+ ...askSource,
558
549
  ...riskAxesOf(creq),
559
550
  ...approvalCardMemberOf(creq),
560
551
  ...grantBindingOf(creq, presentedArgs),
@@ -562,12 +553,12 @@ export async function preparePolicyChain(input) {
562
553
  ...askMandateMember(ancestorFacts(j.ask.action === "ask" ? j.ask : undefined)),
563
554
  ...inheritedAskCarry(j, isLiveApproverSeat(pc.onAsk), pc.autoMode?.denialTracking),
564
555
  ruleEvidence: inheritedAskEvidence,
565
- }, 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));
566
- void settleReadRootGrant(resolved.readRootGrant, undefined, { toolName: creq.toolName, toolCallId: creq.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice });
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 });
567
558
  const askWaitMs = Math.max(0, now() - askT0);
568
559
  if (resolved.action === "deny" && resolved.approverUnavailable === true) {
569
560
  if (markInheritedUnavailable(creq.toolCallId))
570
- return settled.ask;
561
+ return floatedInheritedAsk(settled, creq);
571
562
  return markerChannelFullDeny(creq);
572
563
  }
573
564
  settleDenialLimitFallback({ fallback: settled.fallback, mintedHere: settled.mintedHere, tracker: pc.autoMode?.denialTracking, resolved, headless: headlessDenyAtFold, stop: stopForDenialLimit, toolName: creq.toolName, toolCallId: creq.toolCallId });
@@ -668,7 +659,7 @@ export async function preparePolicyChain(input) {
668
659
  return decision;
669
660
  })
670
661
  : foldedPolicy;
671
- return { basePolicyForResumeEdit, denyNarrowingPolicy, skillGrantLane, allowEntryLanes, policyLayers, effectivePolicy, inheritedUnavailableAsks, inheritedAskGrants, askSourceIdentity, riskAxesOf, ruleOffersOf, grantBindingOf, permissionRuleLane, ruleLaneFacts, permissionRuleOrgLane, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, foldAskClasses, ancestorSandboxAdmissions, ancestorArbitrations, inheritedInstallations: installationsOnLeg };
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 };
672
663
  }
673
664
  const advisedPolicyNames = new WeakMap();
674
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;
@@ -31,7 +31,8 @@ import type { MaterializedMcp } from "../mcp.js";
31
31
  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
- import type { ReadFloor, SessionTreeEntry } from "../../internal/harness-types.js";
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,9 +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;
102
- /** borrowed-readonly — the byte floor of the run's base read-deny table (`undefined` when the table holds no row): both
103
- * probes' output reaches the model, so their starts carry it as every relaying start does. */
104
- readFloor: ReadFloor | undefined;
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;
105
106
  /** borrowed-readonly — the FINAL task root: the env `cwd` fact and the git lane's root. */
106
107
  taskRootFinal: string;
107
108
  /** borrowed-readonly — the canonical extra working roots (copied into the env facts). */
@@ -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, ...(readFloor !== undefined ? { readFloor } : {}) });
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,7 +130,7 @@ export async function preparePromptInputs(input) {
129
130
  envFacts,
130
131
  handsEnabled,
131
132
  taskRoot: taskRootFinal,
132
- readFloor,
133
+ readFloor: () => readFloor(undefined),
133
134
  onDegrade: (reason) => deps.onError?.(new Error(`env git snapshot degraded — ${reason}`), { phase: "degraded", sessionId, classification: "env-git-snapshot" }),
134
135
  });
135
136
  return { featureFlags, sugar, mcpInstructionsBlock, envFacts, tzValid, userTz, dateAnchor, gitStatusRef };
@@ -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