@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -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 +71 -12
  6. package/dist/agents/cascade.js +61 -21
  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-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -135,12 +135,51 @@ export declare function isSettlementParty(v: unknown): v is SettlementParty;
135
135
  export declare const HOST_DECIDERS: readonly ["person", "sla_timeout", "policy"];
136
136
  export type HostDecider = (typeof HOST_DECIDERS)[number];
137
137
  export declare const isHostDecider: (word: unknown) => word is HostDecider;
138
+ /**
139
+ * WHICH MACHINE SEAT answered when the deployment's policy decided an ask — the closed set of the `decidedVia` member
140
+ * (`AskOutcome.decidedVia` on the synchronous leg, `hostDecision.decidedVia` on a durable decide; one word set, one
141
+ * name, both faces). It refines the policy decider and nothing else: a person, an elapsed window and the host's SLA
142
+ * sweep are not machines that answered, so the member beside any other decider word is refused, never ignored.
143
+ * - `policy` — the deployment's own policy answered (an unattended lane answering by class, a headless lane whose
144
+ * seat can show nobody a prompt). ABSENT reads the same: an unrevised host is unchanged.
145
+ * - `permission_request_hook` — a PermissionRequest hook answered the ask on the deployment's behalf (the
146
+ * reference's `decisionReason.type: "hook"` with `hookName: "PermissionRequest"`, `iPt` (cli309.js:288208) /
147
+ * `runHooks` (cli309.js:295883)). A hook's refusal is not "this run has no approval channel": something DID answer,
148
+ * and the model reads that the hook declined, with the hook's own words.
149
+ * The record is unchanged by it (`policy_allowed` / `policy_refused`, `who.party: "policy"`): the member decides which
150
+ * sentence the model reads ({@link import("./tool-policy.js").policyRefusalMessage}), not which party the record names.
151
+ */
152
+ export declare const DECIDED_VIA: readonly ["policy", "permission_request_hook"];
153
+ export type DecidedVia = (typeof DECIDED_VIA)[number];
154
+ export declare const isDecidedVia: (word: unknown) => word is DecidedVia;
155
+ /** The model-facing NAME of each machine seat a policy decision can come from ({@link policyDeciderOf}). */
156
+ declare const POLICY_DECIDER_NAMES: Readonly<{
157
+ readonly policy: "this deployment's own policy";
158
+ readonly permission_request_hook: "a PermissionRequest hook";
159
+ }>;
160
+ /** The fence over the name table: `never` while every seat word has a name. */
161
+ export type PolicyDeciderNamesCoverEverySeat = AssertAllKeysHandled<Exclude<DecidedVia, keyof typeof POLICY_DECIDER_NAMES>>;
162
+ /**
163
+ * THE reading of `decidedVia` — the one place its absence folds ("absent ⇒ the deployment's own policy") and the one
164
+ * place each seat is NAMED to the model. Every sentence that names who REFUSED a tool approval for the policy reads it:
165
+ * the refusal composer ({@link import("./tool-policy.js").policyRefusalMessage}, all three legs) and the durable
166
+ * resume's continuation reminder, so the tool result and the reminder about the same refusal can never name two
167
+ * different deciders. A sentence about a policy's ALLOW that a later check refuses names the party alone ("not a
168
+ * person"), and so does a plan pause's reminder.
169
+ */
170
+ export declare function policyDeciderOf(decidedVia: DecidedVia | undefined): {
171
+ readonly seat: DecidedVia;
172
+ readonly name: string;
173
+ };
138
174
  /** The host's DECISION FACTS on a durable decide — who ended the wait, and the attribution the approval channel
139
175
  * reported for that party. ONE shape for every decide that records its decider (a tool approval's and a plan
140
- * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one. */
176
+ * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
177
+ * `decidedVia` — which machine seat answered for a `"policy"` decider ({@link DECIDED_VIA}); legal only beside
178
+ * `decidedBy: "policy"`, absent ⇒ the deployment's policy. */
141
179
  export interface HostDecisionFacts {
142
180
  decidedBy: HostDecider;
143
181
  approver?: string;
182
+ decidedVia?: DecidedVia;
144
183
  }
145
184
  /** The DECIDER arms of {@link Settlement} — a person's and the deployment policy's, the two parties that
146
185
  * answer an ask either way. Named so a site that both composes one and quotes its note can read the seat
@@ -28,6 +28,16 @@ export function isSettlementParty(v) {
28
28
  }
29
29
  export const HOST_DECIDERS = Object.freeze(["person", "sla_timeout", "policy"]);
30
30
  export const isHostDecider = (word) => HOST_DECIDERS.some((w) => w === word);
31
+ export const DECIDED_VIA = Object.freeze(["policy", "permission_request_hook"]);
32
+ export const isDecidedVia = (word) => DECIDED_VIA.some((w) => w === word);
33
+ const POLICY_DECIDER_NAMES = Object.freeze({
34
+ policy: "this deployment's own policy",
35
+ permission_request_hook: "a PermissionRequest hook",
36
+ });
37
+ export function policyDeciderOf(decidedVia) {
38
+ const seat = decidedVia ?? "policy";
39
+ return { seat, name: POLICY_DECIDER_NAMES[seat] };
40
+ }
31
41
  export function decidersNote(text) {
32
42
  return text === "" ? undefined : text;
33
43
  }
@@ -1,4 +1,4 @@
1
- import type { ExecutionEnv } from "../internal/harness-types.js";
1
+ import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
2
2
  /** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
3
3
  * `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
4
4
  * location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
@@ -31,6 +31,10 @@ export interface AddWorktreeOptions {
31
31
  rootEnvAt: (worktreeDir: string) => ExecutionEnv | Promise<ExecutionEnv>;
32
32
  /** Base commit/ref for the worktree (default `HEAD` at creation time). */
33
33
  commit?: string;
34
+ /** The byte floor (`ExecutionEnvExecOptions.readFloor`) of every start the mint and the tree's removal make, read as each
35
+ * start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
36
+ * step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
37
+ readFloor?: () => ReadFloor | undefined;
34
38
  }
35
39
  /**
36
40
  * Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
@@ -46,7 +50,7 @@ export interface AddWorktreeOptions {
46
50
  export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
47
51
  readonly name: string;
48
52
  readonly baseSha: string;
49
- }): Promise<{
53
+ }, readFloor?: () => ReadFloor | undefined): Promise<{
50
54
  ok: true;
51
55
  branchDeleted?: string;
52
56
  branchKept?: string;
@@ -85,7 +89,7 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
85
89
  * on a claim it could not have checked. Same fail-loud treatment {@link removeManagedWorktree} already got
86
90
  * Report the outcome, let the caller decide what to say. Never throws (a throwing env
87
91
  * lands on the same `{ok:false}`), so a caller that ignores the value behaves exactly as before. */
88
- export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string): Promise<{
92
+ export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string, readFloor?: ReadFloor): Promise<{
89
93
  ok: true;
90
94
  } | {
91
95
  ok: false;
@@ -55,12 +55,13 @@ async function symlinkedLevel(env, repoRoot, worktreeDir) {
55
55
  }
56
56
  return undefined;
57
57
  }
58
- export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch) {
58
+ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor) {
59
+ const readFloorNow = () => { const f = readFloor?.(); return f !== undefined ? { readFloor: f } : {}; };
59
60
  let detail = "";
60
61
  let removed = false;
61
62
  for (let attempt = 0; attempt < 2 && !removed; attempt++) {
62
63
  try {
63
- const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot });
64
+ const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
64
65
  if (r.ok && r.value.exitCode === 0)
65
66
  removed = true;
66
67
  else
@@ -77,10 +78,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
77
78
  if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(branch.baseSha) || /^0+$/.test(branch.baseSha))
78
79
  return { ok: true, branchKept: `${branch.name} (its base commit is not a usable witness)` };
79
80
  try {
80
- const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot });
81
+ const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot, ...readFloorNow() });
81
82
  if (del.ok && del.value.exitCode === 0)
82
83
  return { ok: true, branchDeleted: branch.name };
83
- const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot });
84
+ const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot, ...readFloorNow() });
84
85
  if (tip.ok && tip.value.exitCode !== 0)
85
86
  return { ok: true };
86
87
  if (tip.ok && tip.value.stdout.trim() !== branch.baseSha)
@@ -101,20 +102,22 @@ export async function addWorktree(baseEnv, opts) {
101
102
  const symlinked = await symlinkedLevel(baseEnv, opts.repoRoot, worktreeDir);
102
103
  if (symlinked !== undefined)
103
104
  throw new Error(symlinked);
105
+ const readFloorNow = () => { const readFloor = opts.readFloor?.(); return readFloor !== undefined ? { readFloor } : {}; };
104
106
  const add = await baseEnv.exec(`git worktree add --no-track -b ${shq(branch)} ${shq(worktreeDir)} ${shq(opts.commit ?? "HEAD")}`, {
105
107
  cwd: opts.repoRoot,
108
+ ...readFloorNow(),
106
109
  });
107
110
  if (!add.ok || add.value.exitCode !== 0) {
108
111
  const detail = add.ok ? add.value.stderr || add.value.stdout : thrownText(add.error);
109
112
  throw new Error(`git worktree add failed: ${detail}`);
110
113
  }
111
114
  const excludeLine = shq(`/${WORKTREE_PARENT}/`);
112
- await baseEnv
113
- .exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
114
- `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot })
115
+ await Promise.resolve()
116
+ .then(() => baseEnv.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
117
+ `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot, ...readFloorNow() }))
115
118
  .catch(() => undefined);
116
- const baseSha = await baseEnv
117
- .exec("git rev-parse HEAD", { cwd: worktreeDir })
119
+ const baseSha = await Promise.resolve()
120
+ .then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
118
121
  .then((r) => (r.ok && r.value.exitCode === 0 && r.value.stdout.trim() !== "" ? r.value.stdout.trim() : undefined))
119
122
  .catch(() => undefined);
120
123
  const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
@@ -123,7 +126,7 @@ export async function addWorktree(baseEnv, opts) {
123
126
  inner = await opts.rootEnvAt(worktreeDir);
124
127
  }
125
128
  catch (err) {
126
- await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
129
+ await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
127
130
  throw err;
128
131
  }
129
132
  const innerDestroy = inner.destroy;
@@ -134,7 +137,7 @@ export async function addWorktree(baseEnv, opts) {
134
137
  await innerDestroy.call(inner);
135
138
  }
136
139
  finally {
137
- const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
140
+ const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
138
141
  if (!removed.ok) {
139
142
  throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
140
143
  `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
@@ -143,9 +146,9 @@ export async function addWorktree(baseEnv, opts) {
143
146
  };
144
147
  return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
145
148
  }
146
- export async function pruneWorktrees(baseEnv, repoRoot) {
149
+ export async function pruneWorktrees(baseEnv, repoRoot, readFloor) {
147
150
  try {
148
- const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot });
151
+ const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
149
152
  if (r.ok && r.value.exitCode === 0)
150
153
  return { ok: true };
151
154
  return {
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
145
145
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
146
  * so the catalog is not written a second time here and the two cannot drift.
147
147
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.image_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
148
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
149
149
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
150
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
151
  * sink is a supported shape, and narrowing that field would break it. */
@@ -175,7 +175,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
175
175
  readonly "classifier.denial_limit": "user";
176
176
  readonly "classifier.unavailable": "user";
177
177
  readonly "classifier.fallback": "operator";
178
- readonly "classifier.seat_rate_limited": "operator";
178
+ readonly "classifier.seat_rate_limited": "user";
179
179
  readonly "classifier.role_defaulted": "operator";
180
180
  readonly "classifier.contract_broken": "operator";
181
181
  readonly "task.turn_interrupted": "user";
@@ -222,6 +222,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
222
222
  readonly "config.path_view_unresolved": "operator";
223
223
  readonly "config.execution_env_capability_invalid": "operator";
224
224
  readonly "config.read_deny_floor_unkept": "operator";
225
+ readonly "config.read_floor_confinement_unavailable": "operator";
225
226
  readonly "config.tool_card_undeclared": "operator";
226
227
  readonly "config.tool_face_undeclared": "operator";
227
228
  readonly "config.tool_face_invalid": "operator";
@@ -262,12 +263,16 @@ declare const NOTICE_AUDIENCE_TABLE: {
262
263
  readonly "model.capability_downgraded": "user";
263
264
  readonly "model.role_defaulted": "operator";
264
265
  readonly "context.tool_turn_repaired": "operator";
265
- readonly "context.image_removed": "user";
266
+ readonly "context.media_removed": "user";
267
+ readonly "context.tool_schema_removed": "user";
266
268
  readonly "skills.listing_truncated": "operator";
267
269
  readonly "agents.listing_truncated": "operator";
268
270
  readonly "tool_result.offload_put_failed": "operator";
269
271
  readonly "tool_result.media_refused": "operator";
270
272
  readonly "config.image_processor_unavailable": "operator";
273
+ readonly "fs.staging_file_left": "operator";
274
+ readonly "fs.staging_file_swept": "operator";
275
+ readonly "session.lineage_rerooted": "user";
271
276
  readonly "config.forward_sink_failed": "operator";
272
277
  readonly "instructions.source_changed": "user";
273
278
  readonly "session.records_skipped": "user";
@@ -318,6 +323,7 @@ declare const NOTICE_MINTER_TABLE: {
318
323
  readonly "config.path_view_unresolved": "engine";
319
324
  readonly "config.execution_env_capability_invalid": "engine";
320
325
  readonly "config.read_deny_floor_unkept": "engine";
326
+ readonly "config.read_floor_confinement_unavailable": "engine";
321
327
  readonly "config.tool_card_undeclared": "engine";
322
328
  readonly "config.tool_face_undeclared": "engine";
323
329
  readonly "config.tool_face_invalid": "engine";
@@ -386,7 +392,8 @@ declare const NOTICE_MINTER_TABLE: {
386
392
  readonly "model.capability_downgraded": "engine";
387
393
  readonly "model.role_defaulted": "engine";
388
394
  readonly "context.tool_turn_repaired": "engine";
389
- readonly "context.image_removed": "engine";
395
+ readonly "context.media_removed": "engine";
396
+ readonly "context.tool_schema_removed": "engine";
390
397
  readonly "task.user_steer_undrained": "engine";
391
398
  readonly "task.user_followup_undrained": "engine";
392
399
  readonly "steering.parked_input_blocked": "engine";
@@ -404,6 +411,9 @@ declare const NOTICE_MINTER_TABLE: {
404
411
  readonly "tool_result.offload_put_failed": "engine";
405
412
  readonly "tool_result.media_refused": "engine";
406
413
  readonly "config.image_processor_unavailable": "engine";
414
+ readonly "fs.staging_file_left": "engine";
415
+ readonly "fs.staging_file_swept": "engine";
416
+ readonly "session.lineage_rerooted": "engine";
407
417
  readonly "instructions.source_changed": "server";
408
418
  readonly "session.records_skipped": "server";
409
419
  readonly "memory.layer_locked_legacy": "server";
@@ -143,6 +143,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
143
143
  "config.path_view_unresolved",
144
144
  "config.execution_env_capability_invalid",
145
145
  "config.read_deny_floor_unkept",
146
+ "config.read_floor_confinement_unavailable",
146
147
  "config.tool_card_undeclared",
147
148
  "config.tool_face_undeclared",
148
149
  "config.tool_face_invalid",
@@ -211,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
211
212
  "model.capability_downgraded",
212
213
  "model.role_defaulted",
213
214
  "context.tool_turn_repaired",
214
- "context.image_removed",
215
+ "context.media_removed",
216
+ "context.tool_schema_removed",
215
217
  "task.user_steer_undrained",
216
218
  "task.user_followup_undrained",
217
219
  "steering.parked_input_blocked",
@@ -229,6 +231,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
229
231
  "tool_result.offload_put_failed",
230
232
  "tool_result.media_refused",
231
233
  "config.image_processor_unavailable",
234
+ "fs.staging_file_left",
235
+ "fs.staging_file_swept",
236
+ "session.lineage_rerooted",
232
237
  "instructions.source_changed",
233
238
  "session.records_skipped",
234
239
  "memory.layer_locked_legacy",
@@ -247,7 +252,7 @@ const NOTICE_AUDIENCE_TABLE = {
247
252
  "classifier.denial_limit": "user",
248
253
  "classifier.unavailable": "user",
249
254
  "classifier.fallback": "operator",
250
- "classifier.seat_rate_limited": "operator",
255
+ "classifier.seat_rate_limited": "user",
251
256
  "classifier.role_defaulted": "operator",
252
257
  "classifier.contract_broken": "operator",
253
258
  "task.turn_interrupted": "user",
@@ -294,6 +299,7 @@ const NOTICE_AUDIENCE_TABLE = {
294
299
  "config.path_view_unresolved": "operator",
295
300
  "config.execution_env_capability_invalid": "operator",
296
301
  "config.read_deny_floor_unkept": "operator",
302
+ "config.read_floor_confinement_unavailable": "operator",
297
303
  "config.tool_card_undeclared": "operator",
298
304
  "config.tool_face_undeclared": "operator",
299
305
  "config.tool_face_invalid": "operator",
@@ -334,12 +340,16 @@ const NOTICE_AUDIENCE_TABLE = {
334
340
  "model.capability_downgraded": "user",
335
341
  "model.role_defaulted": "operator",
336
342
  "context.tool_turn_repaired": "operator",
337
- "context.image_removed": "user",
343
+ "context.media_removed": "user",
344
+ "context.tool_schema_removed": "user",
338
345
  "skills.listing_truncated": "operator",
339
346
  "agents.listing_truncated": "operator",
340
347
  "tool_result.offload_put_failed": "operator",
341
348
  "tool_result.media_refused": "operator",
342
349
  "config.image_processor_unavailable": "operator",
350
+ "fs.staging_file_left": "operator",
351
+ "fs.staging_file_swept": "operator",
352
+ "session.lineage_rerooted": "user",
343
353
  "config.forward_sink_failed": "operator",
344
354
  "instructions.source_changed": "user",
345
355
  "session.records_skipped": "user",
@@ -371,6 +381,7 @@ const NOTICE_MINTER_TABLE = {
371
381
  "config.path_view_unresolved": "engine",
372
382
  "config.execution_env_capability_invalid": "engine",
373
383
  "config.read_deny_floor_unkept": "engine",
384
+ "config.read_floor_confinement_unavailable": "engine",
374
385
  "config.tool_card_undeclared": "engine",
375
386
  "config.tool_face_undeclared": "engine",
376
387
  "config.tool_face_invalid": "engine",
@@ -439,7 +450,8 @@ const NOTICE_MINTER_TABLE = {
439
450
  "model.capability_downgraded": "engine",
440
451
  "model.role_defaulted": "engine",
441
452
  "context.tool_turn_repaired": "engine",
442
- "context.image_removed": "engine",
453
+ "context.media_removed": "engine",
454
+ "context.tool_schema_removed": "engine",
443
455
  "task.user_steer_undrained": "engine",
444
456
  "task.user_followup_undrained": "engine",
445
457
  "steering.parked_input_blocked": "engine",
@@ -457,6 +469,9 @@ const NOTICE_MINTER_TABLE = {
457
469
  "tool_result.offload_put_failed": "engine",
458
470
  "tool_result.media_refused": "engine",
459
471
  "config.image_processor_unavailable": "engine",
472
+ "fs.staging_file_left": "engine",
473
+ "fs.staging_file_swept": "engine",
474
+ "session.lineage_rerooted": "engine",
460
475
  "instructions.source_changed": "server",
461
476
  "session.records_skipped": "server",
462
477
  "memory.layer_locked_legacy": "server",
@@ -205,6 +205,19 @@ export interface StopFailureEvent extends ClassicEventBase {
205
205
  /** Turns completed when the failure ended the run. */
206
206
  readonly turns: number;
207
207
  }
208
+ /** `classic.SessionStart`'s `e` — raised once per leg, in the bottom of `session.start` (the leg is prepared, its first model
209
+ * request not yet made). Observe-only. */
210
+ export interface SessionStartEvent extends ClassicEventBase {
211
+ /** The leg's tracked working directory. */
212
+ readonly cwd: string;
213
+ readonly sessionId: string;
214
+ }
215
+ /** `classic.SessionEnd`'s `e` — raised once per leg, in the bottom of `session.end` (its terminal settled). Observe-only. */
216
+ export interface SessionEndEvent extends ClassicEventBase {
217
+ /** The terminal status word. */
218
+ readonly reason: string;
219
+ readonly sessionId: string;
220
+ }
208
221
  /** `classic.PreCompact`'s `e` — before each compaction, after the trigger gate and a valid cut point. Answer:
209
222
  * {@link PreCompactResult} (`block` honored on "auto" / "manual" only). */
210
223
  export interface PreCompactEvent extends ClassicEventBase {
@@ -450,8 +463,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
450
463
  export interface HookInvocationIdentity {
451
464
  /** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
452
465
  readonly sessionId: string;
453
- /** The run's unified task id (`spec.taskId ?? sessionId` — the value TaskEvent's `sourceTaskId`
454
- * and `task_progress` frames key on). Equal to {@link sessionId} when no task id was declared. */
466
+ /** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
467
+ * sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
455
468
  readonly taskId: string;
456
469
  /** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
457
470
  * derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
@@ -549,6 +562,10 @@ export interface HookToolOutput {
549
562
  */
550
563
  export type PreToolUseResult = PermissionResult & {
551
564
  additionalContext?: string;
565
+ /** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
566
+ * `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
567
+ * decision receipt refuses it (an engine fail-closed deny). */
568
+ questionCause?: import("./ask-origin.js").HookQuestionCause;
552
569
  };
553
570
  /** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
554
571
  export interface PostToolUseResult {
@@ -1384,11 +1401,14 @@ export interface AskCarry {
1384
1401
  readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
1385
1402
  /** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
1386
1403
  readonly authoredBy?: "deployment";
1404
+ /** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
1405
+ * same value the synchronous card carries. */
1406
+ readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
1387
1407
  }
1388
1408
  /** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
1389
1409
  * the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
1390
- * number), the origin word only when it is a member of the closed set, and the class pair only when it is
1391
- * well-formed, as a fresh copy (the carry is typed, but the row is the boundary a host reads back through —
1410
+ * number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
1411
+ * well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
1392
1412
  * the same screen the summary applies to the word). */
1393
1413
  export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1394
1414
  denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
@@ -1396,6 +1416,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1396
1416
  origin?: import("./ask-origin.js").AskOrigin;
1397
1417
  askClass?: import("./ask-origin.js").AskClass;
1398
1418
  classes?: readonly import("./ask-origin.js").AskClass[];
1419
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
1399
1420
  };
1400
1421
  /**
1401
1422
  * The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant
@@ -1,13 +1,13 @@
1
1
  import { argsAsTheToolReads, stampArgsReading } from "./effective-path-target.js";
2
2
  import { extensionAuthors, noteRewrite, readRejudge, rewriteChasedSentence, screeningAuthorship } from "./rewrite-rejudge.js";
3
- import { decisionText, describeThrown, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
3
+ import { decisionText, describeThrown, extensionQuestionText, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
4
4
  import { createSettlementLedger, engineFailClosedExit, hookDenyExit, settledScreen, settledScreenExit, takeInheritedScreen, unownedArgsExit } from "./runner/gate-exit.js";
5
5
  import { composeCallSignal } from "./runner/abort-race.js";
6
6
  import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, failedHandlerClause, judgedInputOf, observePermissionDenied } from "./mods/stations.js";
7
7
  import { runGateFold } from "./gate-fold.js";
8
8
  import { runGateLanes } from "./gate-lanes.js";
9
9
  export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
10
- import { isAskOrigin, screenAskClassMembers } from "./ask-origin.js";
10
+ import { hookAskReasonOf, isAskOrigin, receiveAskReasons, screenAskClassMembers } from "./ask-origin.js";
11
11
  import { isAutoModeFallbackCause } from "./auto-mode.js";
12
12
  import { inlineUntrusted } from "./untrusted-text.js";
13
13
  export { formatHookFeedback } from "./reminder-mint.js";
@@ -111,6 +111,11 @@ function preToolUseRefusedReason(subject, failed) {
111
111
  : "";
112
112
  return `a PreToolUse hook ${failedHandlerClause(failed)} while screening ${subject}; the call was NOT executed (fail-closed).${tail}`;
113
113
  }
114
+ function hookAskOf(r, answeredBy, toolName) {
115
+ const { questionCause, ...ask } = r;
116
+ const entry = hookAskReasonOf(answeredBy, questionCause ?? "asked", decisionText(ask));
117
+ return { ...ask, ...(answeredBy !== undefined ? { message: extensionQuestionText(toolName, entry) } : {}), askReasons: Object.freeze([entry]) };
118
+ }
114
119
  export function createPreToolUseScreening(input, readSettled = (decision) => ({ decision })) {
115
120
  const own = input.modBus !== undefined && input.modBus.hasHandlers("classic.PreToolUse") ? input.modBus : undefined;
116
121
  const inherited = (input.inheritedInstallations ?? []).filter((i) => i.bus.hasHandlers("classic.PreToolUse", i.judges));
@@ -143,7 +148,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
143
148
  if (outcome.kind === "failed")
144
149
  return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
145
150
  const r = screenPreToolUseResult(outcome.answer);
146
- const answer = r === null || r === false ? undefined : r;
151
+ const answer = r === null || r === false || r === undefined ? undefined : r.action === "ask" ? hookAskOf(r, outcome.answeredBy, toolName) : r;
147
152
  const rewrittenBy = authorship.of(outcome.answer);
148
153
  return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), rewrittenBy: answer?.updatedInput === undefined ? [] : rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] };
149
154
  };
@@ -214,7 +219,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
214
219
  allowedBy.set(i, r.answeredBy);
215
220
  if (verdict?.action !== "ask")
216
221
  return undefined;
217
- const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}) };
222
+ const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}), ...(verdict.askReasons !== undefined ? { askReasons: verdict.askReasons } : {}) };
218
223
  const call = Object.freeze({ toolName, toolCallId, args: bytes, ...(as.face !== undefined ? { face: as.face } : {}) });
219
224
  const settled = readSettled(await seat.installation.settle(ask, call, signal));
220
225
  if (settled.decision.action === "deny")
@@ -241,11 +246,13 @@ export function askCarryRowMembers(carry) {
241
246
  const origin = carry.origin;
242
247
  const why = carry.classifierNoRuling;
243
248
  const classed = screenAskClassMembers(carry.askClass, carry.classes);
249
+ const askReasons = receiveAskReasons(carry.askReasons);
244
250
  return {
245
251
  ...(carry.denialLimitFallback !== undefined ? { denialLimitFallback: { ...carry.denialLimitFallback } } : {}),
246
252
  ...(isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {}),
247
253
  ...(isAskOrigin(origin) ? { origin } : {}),
248
254
  ...(classed !== undefined ? classed : {}),
255
+ ...(askReasons !== undefined ? { askReasons } : {}),
249
256
  };
250
257
  }
251
258
  export async function runToolGate(input) {
@@ -2,7 +2,7 @@ import { isIP } from "node:net";
2
2
  import { HOST_UNREADABLE_SENTENCE, callHostTargetOf, hostOfUrl, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
3
3
  import { inlineUntrusted } from "./untrusted-text.js";
4
4
  import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
5
- import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
5
+ import { DECLARATION_RECEIPT_MODE, optionKeys, refuseStrayMembers } from "./own-property-receipt.js";
6
6
  function isPrivateV4(ip) {
7
7
  const o = ip.split(".").map(Number);
8
8
  if (o.length !== 4 || o.some((n) => !Number.isInteger(n) || n < 0 || n > 255))
@@ -48,7 +48,7 @@ export function isPrivateHost(host) {
48
48
  return /^fe[89ab]/.test(h) || /^f[cd]/.test(h) || /^fe[c-f]/.test(h);
49
49
  }
50
50
  export const HOST_FLOOR_INVALID_CODE = "config.host_floor_invalid";
51
- const FLOOR_MEMBERS = ["deny", "only"];
51
+ const FLOOR_KEYS = optionKeys()({ deny: 0, only: 0 });
52
52
  function floorInvalid(what) {
53
53
  return Object.assign(new Error(`RunnerDeps.hostFloor ${what} — a host floor that does not read is refused whole, never half-armed (an entry is a host pattern: \`example.com\` or \`*.example.com\`).`), { code: HOST_FLOOR_INVALID_CODE });
54
54
  }
@@ -95,9 +95,7 @@ export function compileHostFloor(declared) {
95
95
  return undefined;
96
96
  if (!isPlainRecord(value))
97
97
  throw floorInvalid(`must be a record { deny?, only? } (got ${value === null ? "null" : Array.isArray(value) ? "a list" : typeof value})`);
98
- const unknownMember = Object.keys(value).find((k) => !FLOOR_MEMBERS.includes(k));
99
- if (unknownMember !== undefined)
100
- throw floorInvalid(`has a member "${inlineUntrusted(unknownMember, 60)}" — its members are \`deny\` and \`only\``);
98
+ refuseStrayMembers(value, { subject: "RunnerDeps.hostFloor", unit: "member", moment: "when the floor is compiled" }, FLOOR_KEYS, (_, [stray]) => floorInvalid(`has a member "${inlineUntrusted(String(stray), 60)}" — its members are \`deny\` and \`only\``));
101
99
  const deny = readEntries(value.deny, "deny") ?? [];
102
100
  const only = readEntries(value.only, "only");
103
101
  for (const o of only ?? []) {
@@ -77,4 +77,5 @@ export declare function buildAppliedHumanInputEvent(input: {
77
77
  actor?: ActorAssertion | undefined;
78
78
  principal?: string | undefined;
79
79
  runOrigin?: HumanInputEvent["runOrigin"];
80
+ rewrittenBy?: readonly string[] | undefined;
80
81
  }): HumanInputEvent;
@@ -33,6 +33,7 @@ const HANDLED_HUMAN_INPUT_KEYS = {
33
33
  entryId: "forwarded",
34
34
  attachments: "forwarded",
35
35
  runOrigin: "forwarded",
36
+ rewrittenBy: "forwarded",
36
37
  };
37
38
  export function buildHumanInputEvent(input) {
38
39
  void HANDLED_HUMAN_INPUT_KEYS;
@@ -49,6 +50,7 @@ export function buildHumanInputEvent(input) {
49
50
  ...(input.entryId !== undefined ? { entryId: input.entryId } : {}),
50
51
  ...(input.attachments !== undefined && input.attachments.length > 0 ? { attachments: input.attachments.map((a) => ({ ...a })) } : {}),
51
52
  ...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
53
+ ...(input.rewrittenBy !== undefined ? { rewrittenBy: Object.freeze([...input.rewrittenBy]) } : {}),
52
54
  };
53
55
  }
54
56
  export function buildAppliedHumanInputEvent(input) {
@@ -62,5 +64,6 @@ export function buildAppliedHumanInputEvent(input) {
62
64
  ...(input.actor?.issuer !== undefined ? { issuer: input.actor.issuer } : {}),
63
65
  ...(input.principal !== undefined ? { principal: input.principal } : {}),
64
66
  ...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
67
+ ...(input.rewrittenBy !== undefined ? { rewrittenBy: input.rewrittenBy } : {}),
65
68
  });
66
69
  }