@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,13 +1,13 @@
1
- import type { ExecutionEnv } from "../../internal/harness-types.js";
1
+ import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
2
2
  import type { AssistantMessage, Message, Model, Usage } from "../../internal/llm.js";
3
3
  import type { CwdRef } from "../../tools/fs/fs-shared.js";
4
4
  import { type PermissionResult, type ToolCallRequest } from "../tool-policy.js";
5
- import type { ClassicEventBase, HookInvocationIdentity, PermissionDeniedPayload, SubagentStartResult, UserPromptSubmitEvent } from "../hooks.js";
5
+ import type { ClassicEventBase, HookEnvCapabilities, HookInvocationIdentity, PermissionDeniedPayload, SubagentStartResult, UserPromptSubmitEvent } from "../hooks.js";
6
6
  import type { ClassicEventMap, ClassicEventName } from "./classic-events.js";
7
7
  import type { PermissionMode } from "../ask-origin.js";
8
8
  import type { RunnerDeps } from "../runner-deps.js";
9
9
  import type { TaskSpec } from "../task-spec.js";
10
- import { type ModAnswerCheck, type ModAnswerRanks, type ModBus, type ModCallEntry, type ModMountedHandler, type ModDispatchOutcome, type ModEventPayload, type ModRegistration } from "./kernel/index.js";
10
+ import { type ModAnswerCheck, type ModAnswerRanks, type ModBus, type ModCallEntry, type ModEventName, type ModMountedHandler, type ModDispatchOutcome, type ModEventPayload, type ModRegistration } from "./kernel/index.js";
11
11
  import { type SourcedOverlay } from "../../prompt-assembly/overlay.js";
12
12
  import type { BandId } from "../../prompt-assembly/catalog/schema.js";
13
13
  import type { ModParticipant } from "./kernel/dispatch.js";
@@ -24,28 +24,30 @@ export declare const ENGINE_CORE_ANSWER: Readonly<Record<string, never>>;
24
24
  export declare function engineCore(): Readonly<Record<string, never>>;
25
25
  /** The leg's bus seat, as the stations read it. */
26
26
  export type LegModBus = Pick<ModBus, "hasHandlers" | "dispatch">;
27
- /**
28
- * The id a delegated leg's events carry as `agentId` (the leg's task id — the key its `task_progress` frames
29
- * and its parent's fleet row use). A top-level leg carries none.
30
- */
31
- export declare function agentIdOf(identity: HookInvocationIdentity | undefined): string | undefined;
27
+ /** Does a seat raise `event` — bound, and a handler hangs on it? Every station entry reads this first, synchronously. */
28
+ export declare function seatHears<B extends {
29
+ readonly bus: Pick<ModBus, "hasHandlers">;
30
+ }>(binding: B | undefined, event: ModEventName): binding is B;
31
+ /** The `detail` member of a notice a leg raises about itself: the leg's own task id, read from its prepare's one mint ({@link legTaskIdOf}), never from the host's declaration. */
32
+ export declare function legNoticeTaskId(leg: {
33
+ readonly taskId: string;
34
+ }): {
35
+ readonly taskId: string;
36
+ };
32
37
  export interface LegEvents {
33
- /** The person's-prompt screen its objective passes — present when a person wrote the objective. */
34
- readonly screen?: "classic.UserPromptSubmit";
35
38
  /** The event it opens on — present on a delegated leg. */
36
39
  readonly start?: "classic.SubagentStart";
37
40
  /** The event it raises when it would otherwise end. */
38
41
  readonly stop: "classic.Stop" | "classic.SubagentStop";
39
42
  }
40
43
  /**
41
- * Both ends of a leg. The delegation fact alone picks the lifecycle (a child resumed from its checkpoint keeps it): a
42
- * delegated leg opens on `classic.SubagentStart` and ends on `classic.SubagentStop`, any other on nothing and
43
- * `classic.Stop`. Who wrote the objective picks the screen: a top-level leg's objective is a person's prompt, and so is
44
- * a delegated leg's that carries an operator's words (`operatorObjective`, the trusted resume fact) — both pass
45
- * `classic.UserPromptSubmit`; any other delegated objective is its delegator's (a parent model, a workflow script, a
46
- * peer) and is judged at the delegator's gate. Not the leg kind: a resumed leg's kind reads `"resume"` whoever it runs as.
44
+ * Both ends of a leg, from the delegation fact alone (a child resumed from its checkpoint keeps it): a delegated leg opens on
45
+ * `classic.SubagentStart` and ends on `classic.SubagentStop`, any other opens on nothing and ends on `classic.Stop`. Not the leg
46
+ * kind (a resumed leg's kind reads `"resume"` whoever it runs as), and not who wrote the objective: whether an input passes
47
+ * `classic.UserPromptSubmit` is the input's own fact, its author (`countsAsOperator`, input-author.ts) — a delegator's words are
48
+ * judged at the delegator's gate (`classic.PreToolUse` on the delegating call), an operator's resume of a child is screened.
47
49
  */
48
- export declare function legEventsOf(identity: Pick<HookInvocationIdentity, "isDelegatedChild"> | undefined, operatorObjective?: boolean): LegEvents;
50
+ export declare function legEventsOf(identity: Pick<HookInvocationIdentity, "isDelegatedChild"> | undefined): LegEvents;
49
51
  /**
50
52
  * The args as a judging handler receives them: the gate pass's own immutable value ({@link ownArgs} — the value itself when
51
53
  * the gate already took it, which is every call the gate raises an event over), so the bytes a handler judges are the bytes
@@ -77,31 +79,25 @@ export declare function sameModChain(a: readonly ModChainLink[], b: readonly Mod
77
79
  * screening constraint, and what a child's own gate stands in for when it mounted the same.
78
80
  */
79
81
  export declare function chainJudges(bus: LegModBus): boolean;
80
- /** Give a minted screening `policy` its installation — own, fixed and not enumerable, the object held in a closure no clone can re-point, so a copy or a wrapper of the policy carries none. Written only by the constraint mint (`createPreToolUseConstraintPolicy`). */
81
- export declare function withInstallation<P extends object>(policy: P, bus: LegModBus): P;
82
- /** The installation an inherited entry carries (its policy's own member, read off the descriptor: no getter or trap runs, and a
83
- * member minted on another object is not this one's), or `undefined` when the mint did not make the entry's policy. */
84
- export declare function installationOf(pc: {
85
- readonly policy: object;
86
- }): LegModBus | undefined;
87
82
  /** How an inherited installation's question is settled: under the context its installation froze (its approver, its durable
88
- * mandates, its classifier — the settlement its `classic.PreToolUse` ask takes in the fold), never at this leg's approver. An
89
- * allow carrying `updatedInput` is a person's approval of an edit; an ask is one the settlement floated (the call is marked for
90
- * the park). */
83
+ * mandates, its classifier), never at this leg's approver — whichever event raised it (`classic.PreToolUse` at the gate's phase
84
+ * 1, `tool.check` at its verdict read). An allow carrying `updatedInput` is a person's approval of an edit; an ask is one the
85
+ * settlement floated (the call is marked for the park). */
91
86
  export type InstallationAskSettlement = (ask: Extract<PermissionResult, {
92
87
  action: "ask";
93
88
  }>, call: ToolCallRequest, signal: AbortSignal | undefined) => Promise<PermissionResult>;
94
- /** An inherited installation as a leg's gate raises `tool.check` on it: the bus that mounted that chain, which of its handlers
95
- * judge here, and how its question is settled. */
96
- export interface InheritedToolCheck {
89
+ /** An inherited installation as a leg's gate raises its judging events on it (`classic.PreToolUse` at phase 1, `tool.check` at the
90
+ * verdict read): the bus that mounted that chain, which of its handlers judge here, the capability face of the environment it was
91
+ * installed against (the `env` of its `classic.PreToolUse` e), and how its question is settled. */
92
+ export interface InheritedInstallation {
97
93
  readonly bus: LegModBus;
98
94
  readonly judges: (p: ModParticipant) => boolean;
95
+ readonly env?: HookEnvCapabilities;
99
96
  readonly settle: InstallationAskSettlement;
100
97
  }
101
- /** An inherited chain entry as its installation identity reads it: the policy (whose mint names the bus, whose admission names
102
- * the chain), the approver it froze, its two durable mandates, the environment it was installed against, its classifier. */
98
+ /** An inherited chain entry as its installation identity reads it (the installation is absent on a caller-policy entry). */
103
99
  export interface InstallationEntry {
104
- readonly policy: object;
100
+ readonly installation?: LegModBus;
105
101
  readonly onAsk?: unknown;
106
102
  readonly durableMandate?: boolean;
107
103
  readonly contentMandate?: boolean;
@@ -121,52 +117,43 @@ export interface LegInstallation {
121
117
  readonly decider: unknown;
122
118
  }
123
119
  /**
124
- * Whether an inherited entry IS a leg's installation — the ONE installation identity. The chain is read off the entry's own
125
- * bus ({@link installationOf}, as that bus's admission recorded it), never off a list the entry carries: an entry
126
- * whose policy the mint did not make, or whose bus no engine admission mounted, is no leg's installation. The rest is the
127
- * context its questions are settled in: the same approver ({@link askApproverIdentity}), the same two durable mandates, the
128
- * same environment, the same classifier instance. Readers: chain assembly (a leg already on the chain is not appended again)
129
- * and {@link standsInFor} (the fold's pass-through and the `tool.check` raise).
120
+ * Whether an inherited entry IS a leg's installation — the ONE installation identity: the chain is read off the entry's own
121
+ * installation; a caller-policy entry, or one whose bus no engine admission mounted, is no leg's installation. The rest is
122
+ * the context its questions are settled in ({@link askApproverIdentity}, the two durable mandates, the environment, the classifier).
130
123
  */
131
124
  export declare function sameInstallation(pc: InstallationEntry, leg: LegInstallation): boolean;
132
125
  /**
133
126
  * Whether a leg's own gate stands in for an inherited entry: the leg's chain judges, and the entry is the leg's installation
134
127
  * settled with no durable mandate — its phase 1 then judges the call with the same chain, and its questions go to the same
135
- * approver under no mandate, so the entry adds nothing on either judging event. The fold's pass-through for the entry's
136
- * `classic.PreToolUse` and the skip of its `tool.check` raise are this one test (an entry it does not hold for is judged under
137
- * its own context on both: a second judgment, never a lost one).
128
+ * approver under no mandate, so the entry adds nothing on either judging event. Whether the gate raises the entry's
129
+ * `classic.PreToolUse` and `tool.check` is this one test (an entry it does not hold for is judged under its own context on both:
130
+ * a second judgment, never a lost one).
138
131
  */
139
132
  export declare function standsInFor(pc: InstallationEntry, leg: Omit<LegInstallation, "durableMandate" | "contentMandate">, legChainJudges: boolean): boolean;
140
- /** An inherited screening installation as the carrier check reads it: the bus its policy was minted over (absent when the mint
141
- * did not make the policy) and the chain the entry declares (its `mods`; absent when it declares none). The declaration is read
142
- * for one thing — a guard the leg cannot raise ({@link unraisableGuardsOf}); identity is read off the bus ({@link sameInstallation}). */
143
- export interface ScreeningInstallation {
144
- readonly bus: LegModBus | undefined;
145
- readonly chain: readonly ModChainLink[] | undefined;
146
- }
147
- /** The screening installations among a chain's entries, in the chain's order: every entry whose policy the mint made or that
148
- * declares a chain. */
149
- export declare function screeningInstallationsOf(entries: ReadonlyArray<{
150
- readonly policy: object;
151
- readonly mods?: readonly ModChainLink[];
152
- }>): readonly ScreeningInstallation[];
153
- /** Why an inherited chain cannot hold its guards, or `undefined`: an entry that names a judging `tool.check` handler beside a
154
- * policy the mint did not make has no bus to raise that guard on. Read where the chain enters a leg — before a resume's claim
155
- * and at the leg's prepare — so it is refused, never run without the guard. */
156
- export declare function unraisableGuardsOf(installations: readonly ScreeningInstallation[]): string | undefined;
157
133
  /**
158
- * The inherited installations a leg's gate raises `tool.check` on after its own bus — the rule's one home. Every entry whose
159
- * policy the mint made is one installation, raised whole in the chain's order (the order its `classic.PreToolUse` folds in),
160
- * except one the leg's own gate stands in for (`standsIn` — the fold's pass-through test, {@link standsInFor}). Raised whole
161
- * because a handler's answer depends on the chain it sits in (an outer handler may answer without calling `next`, or rule on
162
- * what an inner one answered), so a registration the leg also mounts in a chain of its own judges again inside the ancestor's
163
- * chain, as the PreToolUse constraint judges it (a second judgment, never a lost one). Each carries its entry's settlement of a
164
- * question (`settleOf`): an installation's `ask` goes where its PreToolUse ask goes. Observe handlers never take part (a
165
- * constraint carries no observer). An entry that cannot raise its guard is refused (`config.mods_invalid`, {@link unraisableGuardsOf}).
134
+ * Why an inherited chain cannot be held, or `undefined`. Every entry is ONE of two kinds — a caller policy (`policy`, folded into
135
+ * the leg's restriction chain) or a screening installation (`installation`, the bus an engine admission mounted: a leg's own, or
136
+ * {@link admitModChain}'s, whose judging events the leg's gate raises). An entry naming both, or neither, or an installation no
137
+ * engine admission mounted has no way to judge the leg's calls. Read where the chain enters a leg — before a resume's claim and
138
+ * at the leg's prepare — so it is refused, never run without the judgment.
166
139
  */
167
- export declare function inheritedToolChecks<E extends InstallationEntry & {
168
- readonly mods?: readonly ModChainLink[];
169
- }>(entries: readonly E[], standsIn: (pc: E) => boolean, settleOf: (pc: E) => InstallationAskSettlement): readonly InheritedToolCheck[];
140
+ export declare function chainEntryFault(entries: ReadonlyArray<{
141
+ readonly policy?: object;
142
+ readonly installation?: object;
143
+ }>): string | undefined;
144
+ /**
145
+ * The inherited installations a leg's gate judges its calls on after its own bus — the rule's one home, read by both judging
146
+ * events (`classic.PreToolUse` at phase 1, `tool.check` at the verdict read). Every screening entry is one installation, raised
147
+ * whole in the chain's order, except one the leg's own gate stands in for (`standsIn`, {@link standsInFor}). Raised whole because
148
+ * a handler's answer depends on the chain it sits in (an outer handler may answer without calling `next`, or rule on what an
149
+ * inner one answered), so a registration the leg also mounts in a chain of its own judges again inside the ancestor's chain (a
150
+ * second judgment, never a lost one). Each carries the environment face its installation was installed against (`envOf`) and
151
+ * its entry's settlement of a question (`settleOf`): an installation's `ask`, on either event, goes to the regime it froze.
152
+ * Observe handlers never take part. A chain with a malformed entry is refused (`config.mods_invalid`, {@link chainEntryFault}).
153
+ */
154
+ export declare function inheritedInstallations<E extends InstallationEntry & {
155
+ readonly policy?: object;
156
+ }>(entries: readonly E[], standsIn: (pc: E) => boolean, envOf: (pc: E) => HookEnvCapabilities | undefined, settleOf: (pc: E) => InstallationAskSettlement): readonly InheritedInstallation[];
170
157
  /** The members every classic `e` of a leg carries: the identity envelope, the delegated leg's `agentId`, the leg's observed mode. */
171
158
  export declare function classicEventBase(identity: HookInvocationIdentity | undefined, permissionMode?: PermissionMode): ClassicEventBase;
172
159
  /**
@@ -185,6 +172,7 @@ export declare function dispatchClassic<K extends ClassicEventName>(bus: LegModB
185
172
  readonly signal?: AbortSignal;
186
173
  readonly checkAnswer?: ModAnswerCheck;
187
174
  readonly ranks?: ModAnswerRanks;
175
+ readonly participant?: (p: ModParticipant) => boolean;
188
176
  }): Promise<ModDispatchOutcome | undefined>;
189
177
  /** The answer form of a classic event whose answer is an object of optional string members (`block`, `additionalContext`, …). */
190
178
  export declare function stringMembersAnswer(event: string, members: readonly string[]): (answer: unknown) => string | undefined;
@@ -192,10 +180,16 @@ export declare function stringMembersAnswer(event: string, members: readonly str
192
180
  export declare function stringMembersOf<M extends string>(answer: unknown, members: readonly M[]): {
193
181
  [K in M]?: string;
194
182
  };
195
- /** The clause a fail-closed station puts in its sentence for the handler that failed it: `crashed (extension "x" threw boom)`. */
183
+ /** The clause a fail-closed station puts in its sentence for the handler that failed it: `crashed (extension "x" threw boom)`
184
+ * — what it did, who it is and the bus's reason. */
196
185
  export declare function failedHandlerClause(f: Extract<ModDispatchOutcome, {
197
186
  kind: "failed";
198
187
  }>): string;
188
+ /** The clause without the bus's reason, `crashed (extension "x")`: for a sentence in place of a result the handler saw (its
189
+ * reason may quote that result; the reason is said on the report sink). */
190
+ export declare function failedHandlerName(f: Extract<ModDispatchOutcome, {
191
+ kind: "failed";
192
+ }>): string;
199
193
  /**
200
194
  * The PermissionDenied station: the leg's `classic.PermissionDenied` handlers, then a host's own raw observer (a host
201
195
  * driving the tool gate itself) as one more observe handler of the same event on a bus of its own — so every observer
@@ -310,6 +304,14 @@ export interface LegFacadeSeats {
310
304
  agents(): readonly string[];
311
305
  /** `$.tool.call`'s host entry (`createToolCallEntry`, `tool-call.ts`). */
312
306
  readonly toolCall: ModCallEntry;
307
+ /** `$.agent.spawn`'s host entry (`createAgentSpawnEntry`, `agent-stations.ts`). */
308
+ readonly agentSpawn: ModCallEntry;
309
+ /** `$.session.append`'s host entry (`createSessionAppendEntry`, `session-append.ts`). */
310
+ readonly sessionAppend: ModCallEntry;
311
+ /** `$.session.send`'s host entry (`createSessionSendEntry`, `session-send.ts`). */
312
+ readonly sessionSend: ModCallEntry;
313
+ /** `$.session.compact`'s host entry (`createSessionCompactEntry`, `session-compact.ts`). */
314
+ readonly sessionCompact: ModCallEntry;
313
315
  }
314
316
  /** The leg's admitted bus, its chain identity (the one its admission recorded, {@link chainOfBus}) and the binding of the
315
317
  * facade its `$` reaches. `bus` is the leg bus every station raises on ({@link legBusOf}: an extension's own call's
@@ -323,6 +325,8 @@ export interface LegMods {
323
325
  readonly chain: readonly ModChainLink[];
324
326
  /** The leg's skill scopes (`SkillSpec.mods`): the grant table opens one on each activation, the park freezes them. */
325
327
  readonly skillScopes: SkillScopes;
328
+ /** The leg's report sink (handler failures; a station's own disclosures). */
329
+ readonly report: (err: Error) => void;
326
330
  /** Bind the engine facade once the leg is prepared. Until then a `$` call throws, naming the method. */
327
331
  bindFacade(seats: LegFacadeSeats): void;
328
332
  }
@@ -348,6 +352,8 @@ export interface LegFacadeInput {
348
352
  readonly sessionId: string;
349
353
  readonly model: Model;
350
354
  readonly executionEnv: Pick<ExecutionEnv, "exec">;
355
+ /** The run's byte-floor seat: a mod's `$.process.run` is the run's own start and carries the run's base table. */
356
+ readonly readFloor: (toolCallId: string | undefined) => ReadFloor | undefined;
351
357
  readonly taskRoot: string;
352
358
  readonly cwdRef: CwdRef | undefined;
353
359
  /** The leg's latest model request as recorded at the provider seam (the session's messages as the model last saw them). */
@@ -369,15 +375,23 @@ export interface LegFacadeInput {
369
375
  }) => void;
370
376
  /** `$.tool.call`'s host entry, over the leg's harness and occurrence table. */
371
377
  readonly toolCall: ModCallEntry;
378
+ /** `$.agent.spawn`'s host entry, over the leg's harness and its delegation tool. */
379
+ readonly agentSpawn: ModCallEntry;
380
+ /** `$.session.append`'s host entry, over the leg's admission seat and harness. */
381
+ readonly sessionAppend: ModCallEntry;
382
+ /** `$.session.send`'s host entry, over the leg's `$.tool.call` entry and its SendMessage. */
383
+ readonly sessionSend: ModCallEntry;
384
+ /** `$.session.compact`'s host entry, over the leg's compaction station. */
385
+ readonly sessionCompact: ModCallEntry;
372
386
  }
373
387
  /** The engine facade's seats over a prepared leg — each one a seat the leg already has (no new capability). */
374
388
  export declare function legFacadeSeats(input: LegFacadeInput): LegFacadeSeats;
375
389
  /**
376
390
  * A chain admitted outside any leg — what a host rebuilds to re-supply an inherited screening entry on a fresh Runner
377
- * (a cross-process resume hands back `createPreToolUseConstraintPolicy(chain, env)` over the same registrations). The
378
- * same admission a leg runs (both seats, `plugin.register`); no leg exists, so its `$` facade is never bound and a `$`
379
- * call throws. Handler failures go to `onError` (absent ⇒ unreported). Its chain identity is recorded as a leg's is
380
- * ({@link chainOfBus}), so an entry minted over it is read by what it mounted — whatever list the entry carries.
391
+ * (a cross-process resume hands back `{ installation: await admitModChain(…), hookEnv, …regime }` over the same
392
+ * registrations). The same admission a leg runs (both seats, `plugin.register`); no leg exists, so its `$` facade is never
393
+ * bound and a `$` call throws. Handler failures go to `onError` (absent ⇒ unreported). Its chain identity is recorded as a
394
+ * leg's is ({@link chainOfBus}), so an entry carrying it is read by what it mounted.
381
395
  */
382
396
  export declare function admitModChain(seats: {
383
397
  readonly deployment?: readonly ModRegistration<EngineDollar>[];
@@ -2,10 +2,10 @@ import { types } from "node:util";
2
2
  import { resolveModel } from "../roles.js";
3
3
  import { brainToRuntime } from "../runtime.js";
4
4
  import { deliverEngineNotice } from "../engine-notice.js";
5
- import { inlineUntrusted } from "../untrusted-text.js";
6
5
  import { extensionWords } from "../untrusted-egress.js";
7
6
  import { askApproverIdentity, describeThrown, ownArgs } from "../tool-policy.js";
8
- import { admitMods, expandModPattern } from "./kernel/index.js";
7
+ import { agentIdOf } from "../leg-identity.js";
8
+ import { admitMods } from "./kernel/index.js";
9
9
  import { legBusOf } from "./extension-call.js";
10
10
  import { validateOverlay } from "../../prompt-assembly/overlay.js";
11
11
  import { modsInvalid } from "./kernel/registration.js";
@@ -17,16 +17,16 @@ export const ENGINE_CORE_ANSWER = Object.freeze({});
17
17
  export function engineCore() {
18
18
  return ENGINE_CORE_ANSWER;
19
19
  }
20
- export function agentIdOf(identity) {
21
- return identity?.isDelegatedChild === true ? identity.taskId : undefined;
20
+ export function seatHears(binding, event) {
21
+ return binding !== undefined && binding.bus.hasHandlers(event);
22
22
  }
23
- const PERSON_LEG = Object.freeze({ screen: "classic.UserPromptSubmit", stop: "classic.Stop" });
23
+ export function legNoticeTaskId(leg) {
24
+ return { taskId: leg.taskId };
25
+ }
26
+ const TOP_LEVEL_LEG = Object.freeze({ stop: "classic.Stop" });
24
27
  const DELEGATED_LEG = Object.freeze({ start: "classic.SubagentStart", stop: "classic.SubagentStop" });
25
- const OPERATOR_RESUMED_LEG = Object.freeze({ screen: "classic.UserPromptSubmit", start: "classic.SubagentStart", stop: "classic.SubagentStop" });
26
- export function legEventsOf(identity, operatorObjective = false) {
27
- if (identity?.isDelegatedChild !== true)
28
- return PERSON_LEG;
29
- return operatorObjective ? OPERATOR_RESUMED_LEG : DELEGATED_LEG;
28
+ export function legEventsOf(identity) {
29
+ return identity?.isDelegatedChild === true ? DELEGATED_LEG : TOP_LEVEL_LEG;
30
30
  }
31
31
  export function judgedInputOf(args) {
32
32
  const owned = ownArgs(args);
@@ -74,19 +74,8 @@ const judgesCall = (p) => !p.observe;
74
74
  export function chainJudges(bus) {
75
75
  return bus.hasHandlers("classic.PreToolUse", judgesCall) || bus.hasHandlers("tool.check", judgesCall);
76
76
  }
77
- const INSTALLATION = Symbol("installation");
78
- export function withInstallation(policy, bus) {
79
- return Object.defineProperty(policy, INSTALLATION, { value: Object.freeze({ bus, mintedAs: (o) => o === policy }) });
80
- }
81
- export function installationOf(pc) {
82
- const p = pc.policy;
83
- if (p === null || p === undefined || types.isProxy(p))
84
- return undefined;
85
- const minted = Object.getOwnPropertyDescriptor(p, INSTALLATION)?.value;
86
- return minted !== undefined && minted.mintedAs(p) ? minted.bus : undefined;
87
- }
88
77
  export function sameInstallation(pc, leg) {
89
- const bus = installationOf(pc);
78
+ const bus = pc.installation;
90
79
  const chain = bus !== undefined ? chainOfBus(bus) : undefined;
91
80
  return (chain !== undefined &&
92
81
  sameModChain(chain, leg.chain) &&
@@ -99,33 +88,31 @@ export function sameInstallation(pc, leg) {
99
88
  export function standsInFor(pc, leg, legChainJudges) {
100
89
  return legChainJudges && sameInstallation(pc, { ...leg, durableMandate: false, contentMandate: false });
101
90
  }
102
- const judgesToolCheck = (h) => {
103
- const selected = expandModPattern(h.pattern);
104
- return !h.observe && "names" in selected && selected.names.includes("tool.check");
105
- };
106
- export function screeningInstallationsOf(entries) {
107
- return entries.flatMap((pc) => {
108
- const bus = installationOf(pc);
109
- return bus !== undefined || pc.mods !== undefined ? [{ bus, chain: pc.mods }] : [];
110
- });
111
- }
112
- export function unraisableGuardsOf(installations) {
113
- const guards = installations.flatMap((i) => (i.bus !== undefined ? [] : (i.chain ?? []).filter((l) => l.handlers.some(judgesToolCheck)).map((l) => `"${inlineUntrusted(l.registration.name, 80)}"`)));
114
- return guards.length === 0 ? undefined : `an inherited screening entry names the tool.check guard of ${guards.join(", ")}, but its policy is not one createPreToolUseConstraintPolicy minted, so the guard has no chain to judge this leg's calls on — hand the minted policy back as it is`;
91
+ export function chainEntryFault(entries) {
92
+ for (const [i, pc] of entries.entries()) {
93
+ const policy = pc.policy !== undefined;
94
+ const installation = pc.installation;
95
+ if (policy === (installation !== undefined))
96
+ return `inherited chain entry ${i} carries ${policy ? "both a policy and an installation" : "neither a policy nor an installation"} — an entry is either a caller policy or a screening installation`;
97
+ if (installation !== undefined && chainOfBus(installation) === undefined)
98
+ return `inherited chain entry ${i}'s installation is not a chain an engine admission mounted — rebuild it with admitModChain over the same registrations`;
99
+ }
100
+ return undefined;
115
101
  }
116
102
  const judges = (p) => judgesCall(p);
117
- export function inheritedToolChecks(entries, standsIn, settleOf) {
118
- const unraisable = unraisableGuardsOf(screeningInstallationsOf(entries));
119
- if (unraisable !== undefined)
120
- throw modsInvalid(unraisable);
121
- const checks = [];
103
+ export function inheritedInstallations(entries, standsIn, envOf, settleOf) {
104
+ const fault = chainEntryFault(entries);
105
+ if (fault !== undefined)
106
+ throw modsInvalid(fault);
107
+ const installations = [];
122
108
  for (const pc of entries) {
123
- const bus = installationOf(pc);
124
- if (bus === undefined || standsIn(pc) || !bus.hasHandlers("tool.check", judges))
109
+ const bus = pc.installation;
110
+ if (bus === undefined || standsIn(pc) || !chainJudges(bus))
125
111
  continue;
126
- checks.push(Object.freeze({ bus, judges, settle: settleOf(pc) }));
112
+ const env = envOf(pc);
113
+ installations.push(Object.freeze({ bus, judges, ...(env !== undefined ? { env } : {}), settle: settleOf(pc) }));
127
114
  }
128
- return Object.freeze(checks);
115
+ return Object.freeze(installations);
129
116
  }
130
117
  export function classicEventBase(identity, permissionMode) {
131
118
  const agentId = agentIdOf(identity);
@@ -145,11 +132,12 @@ export async function observeClassic(bus, event, e, signal) {
145
132
  }
146
133
  }
147
134
  export async function dispatchClassic(bus, event, e, options) {
148
- if (!bus.hasHandlers(event))
135
+ if (!bus.hasHandlers(event, options.participant))
149
136
  return undefined;
150
137
  const check = options.checkAnswer;
151
138
  return await bus.dispatch(event, e, {
152
139
  bottom: engineCore,
140
+ ...(options.participant !== undefined ? { participant: options.participant } : {}),
153
141
  ...(options.signal !== undefined ? { signal: options.signal } : {}),
154
142
  ...(check !== undefined ? { checkAnswer: (a, ce, by, below, run) => (a === ENGINE_CORE_ANSWER ? undefined : check(a, ce, by, below, run)) } : {}),
155
143
  ...(options.ranks !== undefined ? { ranks: options.ranks } : {}),
@@ -181,13 +169,16 @@ export function stringMembersOf(answer, members) {
181
169
  return out;
182
170
  }
183
171
  const FAILURE_CLAUSE = Object.freeze({
184
- threw: (who, why) => `crashed (extension "${who}" ${why})`,
185
- timeout: (who, why) => `did not answer (extension "${who}" ${why})`,
186
- violation: (who, why) => `gave an answer the station cannot take (extension "${who}" ${why})`,
187
- reentry: (who, why) => `was skipped on re-entry and its .catch did not answer (extension "${who}" ${why})`,
172
+ threw: (who, tail) => `crashed (extension "${who}"${tail})`,
173
+ timeout: (who, tail) => `did not answer (extension "${who}"${tail})`,
174
+ violation: (who, tail) => `gave an answer the station cannot take (extension "${who}"${tail})`,
175
+ reentry: (who, tail) => `was skipped on re-entry and its .catch did not answer (extension "${who}"${tail})`,
188
176
  });
189
177
  export function failedHandlerClause(f) {
190
- return FAILURE_CLAUSE[f.cause](extensionWords(f.registration, 80), extensionWords(f.reason, 200));
178
+ return FAILURE_CLAUSE[f.cause](extensionWords(f.registration, 80), ` ${extensionWords(f.reason, 200)}`);
179
+ }
180
+ export function failedHandlerName(f) {
181
+ return FAILURE_CLAUSE[f.cause](extensionWords(f.registration, 80), "");
191
182
  }
192
183
  export async function observePermissionDenied(input) {
193
184
  const { payload, hostObserver } = input;
@@ -403,7 +394,13 @@ function lateView() {
403
394
  };
404
395
  return {
405
396
  view,
406
- entries: { "tool.call": (args, ctx) => need("tool.call").toolCall(args, ctx) },
397
+ entries: {
398
+ "tool.call": (args, ctx) => need("tool.call").toolCall(args, ctx),
399
+ "agent.spawn": (args, ctx) => need("agent.spawn").agentSpawn(args, ctx),
400
+ "session.append": (args, ctx) => need("session.append").sessionAppend(args, ctx),
401
+ "session.send": (args, ctx) => need("session.send").sessionSend(args, ctx),
402
+ "session.compact": (args, ctx) => need("session.compact").sessionCompact(args, ctx),
403
+ },
407
404
  bind: (s) => {
408
405
  seats = s;
409
406
  },
@@ -426,7 +423,7 @@ export async function admitLegMods(input) {
426
423
  const chain = recordAdmittedChain(bus, seats);
427
424
  if (standing !== bus)
428
425
  ADMITTED_CHAINS.set(standing, chain);
429
- return { bus, standing, chain, skillScopes, bindFacade: late.bind };
426
+ return { bus, standing, chain, skillScopes, report, bindFacade: late.bind };
430
427
  }
431
428
  function replyText(reply) {
432
429
  return reply.content.flatMap((c) => (c.type === "text" ? [c.text] : [])).join("");
@@ -436,7 +433,10 @@ export function legFacadeSeats(input) {
436
433
  const answeredBy = new Map();
437
434
  const byUsage = new WeakMap();
438
435
  return {
439
- exec: (command, options) => input.executionEnv.exec(command, options),
436
+ exec: (command, options) => {
437
+ const readFloor = input.readFloor(undefined);
438
+ return input.executionEnv.exec(command, { ...options, ...(readFloor !== undefined ? { readFloor } : {}) });
439
+ },
440
440
  complete: async (request, signal) => {
441
441
  const model = request.model !== undefined ? resolveModel(request.model, input.deps.models) : input.model;
442
442
  answeredBy.set(model.id, model);
@@ -465,6 +465,10 @@ export function legFacadeSeats(input) {
465
465
  tools: () => [...input.activeTools],
466
466
  agents: () => (input.agentListing?.entries ?? []).map((e) => e.name),
467
467
  toolCall: input.toolCall,
468
+ agentSpawn: input.agentSpawn,
469
+ sessionAppend: input.sessionAppend,
470
+ sessionSend: input.sessionSend,
471
+ sessionCompact: input.sessionCompact,
468
472
  };
469
473
  }
470
474
  export async function admitModChain(seats, onError) {
@@ -1,20 +1,22 @@
1
1
  /**
2
2
  * The `tool.call` station: raised on the leg's bus between the gate letting a call go and the tool's body, for every
3
3
  * execution of a call (the live loop's lanes through the loop's execution seat, the resumed leg's approved call through
4
- * the same function). The chain's bottom is the tool's body; the event's failure column is `refuse_until_run`, so a
5
- * handler's failure refuses the call while the body has not started and, once it has, the body's real result stands.
4
+ * the same function). The chain's bottom is the tool's body; the event's failure column is `refuse`, so a handler's
5
+ * failure refuses the call while the body has not started and, once it has, WITHHOLDS the body's result: the call ran (its
6
+ * record is a call the gate let go, with no `notExecuted`), and the model is told a hook that checks the result could not
7
+ * hand back its answer instead of the result.
6
8
  *
7
9
  * `e = { tool, tool_use_id, agentId?, input }` (all four pinned — what the gate judged is what runs; a rewrite belongs to
8
10
  * `classic.PreToolUse`) plus the identity envelope; a handler may hand on `requestMeta` too (a record of strings an MCP call carries
9
11
  * as `_meta["sema/requestMeta"]`, judged where it is handed on — `mcp-call-meta.ts`). A handler answers:
10
12
  * - `next(e)` — the body runs; what came up is `{ result: { content, isError } }`, a frozen view of the real result;
11
13
  * - `{ deny: <reason> }` — refused before the body: the call is not executed and the record says an extension refused it
12
- * (a deny once the body has started stands in place of a call that ran: a violation, the real result stands);
14
+ * (a deny once the body has started cannot stand in place of a call that ran: a violation, and the result is withheld);
13
15
  * - `{ result }` — an extension's own result in place of the body (a string, or a list of text blocks), taken only when
14
16
  * both facts hold: the gate let this call go without anyone being asked about it (its latest gate record is an allow
15
17
  * with no settlement, release or clearance — a person's or a rule's yes is a yes to running the tool), and the body
16
18
  * has not started (the kernel's own record). Either missing, the answer is a violation: before the body the call is
17
- * refused, after it the real result stands. A taken result is the call's result; the record says the body never ran
19
+ * refused, after it the result is withheld. A taken result is the call's result; the record says the body never ran
18
20
  * and names the extension (`tool_end.notExecuted`, `tool_end.answeredBy`).
19
21
  * Context for the model is added at `classic.PostToolUse`, not here. Whatever an extension answered in place of the body,
20
22
  * the call's post-execution stations stay silent, as for a call the gate blocked.
@@ -31,6 +33,7 @@ import type { HookInvocationIdentity } from "../hooks.js";
31
33
  import type { ToolOccurrenceTable } from "../runner/tool-occurrence.js";
32
34
  import { type McpRequestMetaSeat } from "../mcp-call-meta.js";
33
35
  import { type LegModBus } from "./stations.js";
36
+ import { type FrameSettlement } from "../frame-settlement.js";
34
37
  import type { ModBus, ModCallEntry } from "./kernel/index.js";
35
38
  /** One execution as the station sees it: the call, the tool that runs (its mounted name), the arguments the gate let go. */
36
39
  export interface ToolCallExecution {
@@ -50,6 +53,9 @@ export interface ToolCallStationInput {
50
53
  readonly reminderMark?: string;
51
54
  /** The leg's request-meta seat: what the chain handed on as `requestMeta` stands under the call's id while its body runs. */
52
55
  readonly requestMeta: Pick<McpRequestMetaSeat, "hold">;
56
+ /** The leg's settlement seam: a result this station withholds settles the frames it carried as withheld by the host side
57
+ * (`settleWithheldResult`), so none is owed again through another lane. Absent ⇒ no frame rides a call of this station. */
58
+ readonly frameSettlement?: FrameSettlement;
53
59
  }
54
60
  /** The station over the leg's bus, or undefined when no handler hangs on `tool.call` (nothing is raised; the body runs). */
55
61
  export declare function createToolCallStation(input: ToolCallStationInput): ToolCallStation | undefined;
@@ -81,3 +87,5 @@ export declare function extensionCallOverlap(input: {
81
87
  readonly args: unknown;
82
88
  readonly batchSafe: (toolName: string, args: unknown) => boolean;
83
89
  }): string | undefined;
90
+ /** A call result's text, as a host entry answers a refusal with it (`{ deny: <the text> }`). */
91
+ export declare const resultText: (content: unknown) => string;