@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
@@ -7,8 +7,9 @@ import { readHandedRequestMeta } from "../mcp-call-meta.js";
7
7
  import { ENGINE_ORIGIN } from "./kernel/index.js";
8
8
  import { isPlainRecord } from "./kernel/receive.js";
9
9
  import { NEXT_IN_FLIGHT } from "./kernel/site-rules.js";
10
- import { classicEventBase, failedHandlerClause, judgedInputOf } from "./stations.js";
10
+ import { classicEventBase, failedHandlerClause, failedHandlerName, judgedInputOf } from "./stations.js";
11
11
  import { runExtensionCall } from "./extension-call.js";
12
+ import { settleWithheldResult } from "../frame-settlement.js";
12
13
  import { randomUUID } from "node:crypto";
13
14
  const FORM = "tool.call takes next(e), { deny: <reason> } or { result } (a string, or a list of text blocks)";
14
15
  const denyOf = (a) => isPlainRecord(a) && Object.keys(a).length === 1 && typeof a["deny"] === "string" && a["deny"] !== "" ? a["deny"] : undefined;
@@ -49,13 +50,18 @@ const RANKS = Object.freeze({ of: (a) => (denyOf(a) !== undefined ? 1 : 0), top:
49
50
  export function createToolCallStation(input) {
50
51
  if (!input.bus.hasHandlers("tool.call"))
51
52
  return undefined;
52
- const refusal = (call, by, text) => {
53
- if (input.occurrences.get(call.toolCallId) !== undefined) {
54
- input.occurrences.refuse(call.toolCallId, "hook", by);
55
- input.occurrences.answeredInPlace(call.toolCallId, by);
53
+ const stationAnswer = (call, by, text) => {
54
+ const content = [{ type: "text", text: formatHookFeedback(text, input.reminderMark) }];
55
+ if (by !== undefined) {
56
+ if (input.occurrences.get(call.toolCallId) !== undefined) {
57
+ input.occurrences.refuse(call.toolCallId, "hook", by);
58
+ input.occurrences.answeredInPlace(call.toolCallId, by);
59
+ }
60
+ input.blockedToolCalls.add(call.toolCallId);
56
61
  }
57
- input.blockedToolCalls.add(call.toolCallId);
58
- return { content: [{ type: "text", text: formatHookFeedback(text, input.reminderMark) }], details: {}, isError: true };
62
+ else if (input.frameSettlement !== undefined)
63
+ settleWithheldResult(input.frameSettlement, call.toolCallId, content);
64
+ return { content, details: {}, isError: true };
59
65
  };
60
66
  return async (call, run, signal) => {
61
67
  const e = { ...classicEventBase(input.identity), tool: call.toolName, tool_use_id: call.toolCallId, input: judgedInputOf(call.args) };
@@ -83,7 +89,7 @@ export function createToolCallStation(input) {
83
89
  if (!denied && substituteOf(a) === undefined)
84
90
  return FORM;
85
91
  if (ran.bottomStarted)
86
- return `a ${denied ? "deny" : "result"} after the tool started (once the tool runs, only its own outcome stands)`;
92
+ return `a ${denied ? "deny" : "result"} after the tool started (once the tool runs, nothing answers in its place)`;
87
93
  if (denied)
88
94
  return below.some((b) => denyOf(b) === undefined) ? "a deny while its next(e) still runs or after it was answered (deny in place of next)" : undefined;
89
95
  if (below.includes(NEXT_IN_FLIGHT))
@@ -97,7 +103,7 @@ export function createToolCallStation(input) {
97
103
  catch (err) {
98
104
  if (body !== undefined)
99
105
  return body;
100
- return refusal(call, ENGINE_ORIGIN.plugin, `the tool.call station could not be raised (${describeThrown(err)}); this call to "${extensionWords(call.toolName, 80)}" was NOT executed (fail-closed)`);
106
+ return stationAnswer(call, ENGINE_ORIGIN.plugin, `the tool.call station could not be raised (${describeThrown(err)}); this call to "${extensionWords(call.toolName, 80)}" was NOT executed (fail-closed)`);
101
107
  }
102
108
  if (outcome.kind === "aborted") {
103
109
  if (body !== undefined)
@@ -105,7 +111,17 @@ export function createToolCallStation(input) {
105
111
  return { content: [{ type: "text", text: "Operation aborted" }], details: {}, isError: true };
106
112
  }
107
113
  if (outcome.kind === "failed") {
108
- return refusal(call, outcome.registration, `a tool.call extension ${failedHandlerClause(outcome)} before this call to "${extensionWords(call.toolName, 80)}" ran; the call was NOT executed (fail-closed)`);
114
+ if (outcome.bottomStarted === true && body !== undefined) {
115
+ try {
116
+ await body;
117
+ }
118
+ catch {
119
+ return body;
120
+ }
121
+ }
122
+ if (outcome.bottomStarted === true)
123
+ return stationAnswer(call, undefined, `a tool.call extension ${failedHandlerName(outcome)} after this call to "${extensionWords(call.toolName, 80)}" ran: a hook that checks this result could not hand back its answer, so the result is withheld — the call ran (fail-closed)`);
124
+ return stationAnswer(call, outcome.registration, `a tool.call extension ${failedHandlerClause(outcome)} before this call to "${extensionWords(call.toolName, 80)}" ran; the call was NOT executed (fail-closed)`);
109
125
  }
110
126
  const answer = outcome.answer;
111
127
  const ran = typeof answer === "object" && answer !== null ? bodies.get(answer) : undefined;
@@ -114,10 +130,10 @@ export function createToolCallStation(input) {
114
130
  const by = outcome.answeredBy ?? ENGINE_ORIGIN.plugin;
115
131
  const reason = denyOf(answer);
116
132
  if (reason !== undefined)
117
- return refusal(call, by, `extension "${extensionWords(by, 80)}" refused this call to "${extensionWords(call.toolName, 80)}" before it ran: ${extensionWords(reason, 300)}`);
133
+ return stationAnswer(call, by, `extension "${extensionWords(by, 80)}" refused this call to "${extensionWords(call.toolName, 80)}" before it ran: ${extensionWords(reason, 300)}`);
118
134
  const content = substituteOf(answer);
119
135
  if (content === undefined)
120
- return refusal(call, by, `extension "${extensionWords(by, 80)}" answered this call in a form tool.call does not take; the call was NOT executed (fail-closed)`);
136
+ return stationAnswer(call, by, `extension "${extensionWords(by, 80)}" answered this call in a form tool.call does not take; the call was NOT executed (fail-closed)`);
121
137
  if (input.occurrences.get(call.toolCallId) !== undefined)
122
138
  input.occurrences.answeredInPlace(call.toolCallId, by);
123
139
  input.blockedToolCalls.add(call.toolCallId);
@@ -127,7 +143,7 @@ export function createToolCallStation(input) {
127
143
  const AGENT_DOOR = "runs the Agent tool: that is $.agent.spawn";
128
144
  const OTHER_DOOR = new Map([
129
145
  [toolFace("ask-user-question").contract.contractId, "runs the AskUserQuestion tool, which puts a question to the person: an extension's call does not ask the person"],
130
- [toolFace("workflow").contract.contractId, "runs the Workflow tool, whose agents run outside the at-once bound on spawns: $.agent.spawn is the door"],
146
+ [toolFace("workflow").contract.contractId, "runs the Workflow tool, whose agents run outside the tree's bound on agents running at once (RunnerDeps.delegationEntryCaps.maxConcurrent): $.agent.spawn is the door"],
131
147
  ]);
132
148
  export function createToolCallEntry(input) {
133
149
  return async (args, ctx) => {
@@ -136,7 +152,7 @@ export function createToolCallEntry(input) {
136
152
  if (typeof tool !== "string" || tool === "")
137
153
  throw new TypeError(`${by}: $.tool.call takes the event's input: { tool, ...args }`);
138
154
  const toolCallId = `ext-${randomUUID()}`;
139
- return runExtensionCall(input.bus, toolCallId, ctx, async (call) => {
155
+ return runExtensionCall(input.bus, toolCallId, "tool.call", ctx, async (call) => {
140
156
  const finalized = await input.harness.callTool({ type: "toolCall", id: toolCallId, name: tool, arguments: { ...callInput } }, ctx.signal, (t) => {
141
157
  const contractId = input.faceOf(t.name)?.contractId;
142
158
  const door = declaredDelegationNameOf(input.specOf(t.name)) !== undefined ? AGENT_DOOR : contractId !== undefined ? OTHER_DOOR.get(contractId) : undefined;
@@ -144,7 +160,7 @@ export function createToolCallEntry(input) {
144
160
  throw new TypeError(`${by}: $.tool.call(${extensionWords(t.name, 80)}) ${door}`);
145
161
  });
146
162
  if (call.denied)
147
- return Object.freeze({ deny: textOf(finalized.result.content) });
163
+ return Object.freeze({ deny: resultText(finalized.result.content) });
148
164
  return viewOf({ ...finalized.result, isError: finalized.isError });
149
165
  });
150
166
  };
@@ -158,4 +174,4 @@ export function extensionCallOverlap(input) {
158
174
  const exclusive = others.find((o) => o.life === "released" && !input.batchSafe(o.wireName ?? o.spelledName, o.finalInput ?? o.args));
159
175
  return exclusive === undefined ? undefined : `${name}: an extension's call cannot run beside "${extensionWords(exclusive.wireName ?? exclusive.spelledName, 80)}", which has the run to itself`;
160
176
  }
161
- const textOf = (content) => (Array.isArray(content) ? content.map((b) => (isPlainRecord(b) && b["type"] === "text" && typeof b["text"] === "string" ? b["text"] : "")).join("") : "");
177
+ export const resultText = (content) => (Array.isArray(content) ? content.map((b) => (isPlainRecord(b) && b["type"] === "text" && typeof b["text"] === "string" ? b["text"] : "")).join("") : "");
@@ -10,6 +10,7 @@
10
10
  import type { McpServerSpec } from "./mcp-server-spec.js";
11
11
  import type { ToolContentOrigin } from "./tool-spec.js";
12
12
  import type { McpConnectionPool } from "./mcp-connection-pool.js";
13
+ import type { McpHostSeat } from "./mcp-host-seat.js";
13
14
  import type { McpInstructionsEntry } from "./prompt-section-seat.js";
14
15
  /** The two names a server's `allowTools` carries to let the cross-server resource readers reach its resources (a server whose allowlist omits one is left out of that reader). */
15
16
  export declare const MCP_RESOURCE_LIST_ALLOW = "list_resources";
@@ -18,6 +19,7 @@ export declare const MCP_RESOURCE_READ_ALLOW = "read_resource";
18
19
  export declare const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
19
20
  export declare const READ_MCP_RESOURCE = "ReadMcpResourceTool";
20
21
  export declare const READ_MCP_RESOURCE_DIR = "ReadMcpResourceDirTool";
22
+ export declare const MCP_RESOURCE_FACES: readonly string[];
21
23
  /** Does the valve (`leaves`: its one predicate) leave at least one of the cross-server resource tools? While it does, a connected server may contribute to them whatever it lists. */
22
24
  export declare function resourceFacesLeft(leaves: (tool: {
23
25
  readonly name: string;
@@ -76,6 +78,8 @@ export interface MountedMcp {
76
78
  readonly aggregate: ReadonlyArray<string>;
77
79
  /** The run tree's connection pool: a child that inherits the mount leases its connections from it. */
78
80
  readonly pool?: McpConnectionPool;
81
+ /** The run's host seats by declaration name: a child declared a host-transport server (inherited or its definition's own) is handed that server's seat. */
82
+ readonly hostSeats?: ReadonlyMap<string, McpHostSeat>;
79
83
  }
80
84
  /** A roster entry as far as this reading goes. */
81
85
  interface RosterEntry {
@@ -101,6 +105,7 @@ export declare function mountedMcpOf(input: {
101
105
  readonly roster: ReadonlyArray<RosterEntry>;
102
106
  readonly aggregateNames: ReadonlySet<string>;
103
107
  readonly pool?: McpConnectionPool;
108
+ readonly hostSeats?: ReadonlyMap<string, McpHostSeat>;
104
109
  }): MountedMcp;
105
110
  /**
106
111
  * The MCP tools of a mount as pool rows (name and the server's declared content class) — what the memory content-origin face adds to
@@ -5,7 +5,7 @@ export const MCP_RESOURCE_READ_ALLOW = "read_resource";
5
5
  export const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
6
6
  export const READ_MCP_RESOURCE = "ReadMcpResourceTool";
7
7
  export const READ_MCP_RESOURCE_DIR = "ReadMcpResourceDirTool";
8
- const MCP_RESOURCE_FACES = [LIST_MCP_RESOURCES, READ_MCP_RESOURCE, READ_MCP_RESOURCE_DIR];
8
+ export const MCP_RESOURCE_FACES = Object.freeze([LIST_MCP_RESOURCES, READ_MCP_RESOURCE, READ_MCP_RESOURCE_DIR]);
9
9
  export function resourceFacesLeft(leaves) {
10
10
  return MCP_RESOURCE_FACES.some((name) => leaves({ name }));
11
11
  }
@@ -78,7 +78,7 @@ export function mountedMcpOf(input) {
78
78
  return { server, tools };
79
79
  });
80
80
  const aggregate = input.roster.filter((t) => input.aggregateNames.has(t.name)).map((t) => t.name);
81
- return { servers, aggregate, ...(input.pool !== undefined ? { pool: input.pool } : {}) };
81
+ return { servers, aggregate, ...(input.pool !== undefined ? { pool: input.pool } : {}), ...(input.hostSeats !== undefined ? { hostSeats: input.hostSeats } : {}) };
82
82
  }
83
83
  export function mountedMcpPoolRows(mounted) {
84
84
  return [
@@ -30,6 +30,12 @@ export declare function wildcardMatch(pattern: string, value: string): boolean;
30
30
  * that is no behavior word (an array index handed by `filter`, say) is refused loudly, never read as either list.
31
31
  */
32
32
  export declare function isCoveringRuleName(name: string, behavior: RuleBehavior): boolean;
33
+ /**
34
+ * The part of {@link isCoveringRuleName} that is a fact about the NAME alone: the name reaches a SET of tool names whatever list it
35
+ * is written in (a `*` it reads, or a bare protocol peer). A stored rule names ONE tool, so its grammar asks only this — a tool name
36
+ * that a restricting list also reads as another server's spelling ({@link peerReadingsOf}) is still one tool's name there.
37
+ */
38
+ export declare function namesASetOfTools(name: string, behavior: RuleBehavior): boolean;
33
39
  /**
34
40
  * Does a covering rule name ({@link isCoveringRuleName}) cover `toolName`? A name with a `*` is a glob over the WHOLE name
35
41
  * ({@link wildcardMatch} — the reference's `p` matcher): `mcp__srv__get_*` reaches `mcp__srv__get_issue`, `mcp__*` every MCP tool,
@@ -46,4 +52,4 @@ export declare function ruleNameCovers(ruleName: string, toolName: string): bool
46
52
  * minted under the peer is then matched by the glob up to its last `*`, which takes the rest; a glob that does not end in `*` leaves
47
53
  * a tool name it does not match. The one reading of a name against a peer that the tool-name lists take.
48
54
  */
49
- export declare function ruleNameReachIntoPeer(ruleName: string, ns: ProtocolNamespace, peer: string): "all" | "some" | "none";
55
+ export declare function ruleNameReachIntoPeer(ruleName: string, ns: ProtocolNamespace, peer: string, readsOtherServers?: boolean): "all" | "some" | "none";
@@ -1,4 +1,4 @@
1
- import { grantWildcardRefusalOf, readsNameGlob, splitNamespacedName } from "./tool-name-aliases.js";
1
+ import { grantWildcardRefusalOf, peerReadingsOf, readsNameGlob, splitNamespacedName } from "./tool-name-aliases.js";
2
2
  export function wildcardMatch(pattern, value) {
3
3
  const first = pattern.indexOf("*");
4
4
  if (first < 0)
@@ -28,6 +28,9 @@ function namespacedPeerOf(name) {
28
28
  return split === undefined || split.peer === "" ? undefined : split;
29
29
  }
30
30
  export function isCoveringRuleName(name, behavior) {
31
+ return namesASetOfTools(name, behavior) || (readsNameGlob(behavior) && peerReadingsOf(name).length > 0);
32
+ }
33
+ export function namesASetOfTools(name, behavior) {
31
34
  if (behavior !== "deny" && behavior !== "ask" && behavior !== "allow") {
32
35
  throw new TypeError(`isCoveringRuleName: the list's behavior must be "deny", "ask" or "allow" (got ${typeof behavior === "string" ? JSON.stringify(behavior) : typeof behavior}) — a "*" in a name reads one way on a list that restricts and another on one that grants`);
33
36
  }
@@ -39,19 +42,27 @@ export function isCoveringRuleName(name, behavior) {
39
42
  export function ruleNameCovers(ruleName, toolName) {
40
43
  if (ruleName.includes("*"))
41
44
  return wildcardMatch(ruleName, toolName);
45
+ const readings = peerReadingsOf(ruleName);
46
+ if (readings.length > 0) {
47
+ const target = namespacedPeerOf(toolName);
48
+ return target !== undefined && readings.some((r) => r.ns.id === target.ns.id && r.peer === target.peer && (r.tool === undefined || r.tool === target.tool));
49
+ }
42
50
  const rule = namespacedPeerOf(ruleName);
43
51
  if (rule === undefined || rule.tool !== undefined)
44
52
  return false;
45
53
  const target = namespacedPeerOf(toolName);
46
54
  return target !== undefined && target.ns.id === rule.ns.id && target.peer === rule.peer;
47
55
  }
48
- export function ruleNameReachIntoPeer(ruleName, ns, peer) {
56
+ export function ruleNameReachIntoPeer(ruleName, ns, peer, readsOtherServers = false) {
49
57
  if (ruleName.includes("*")) {
50
58
  if (ruleName.endsWith("*") && wildcardMatch(ruleName, `${ns.prefix}${peer}__`))
51
59
  return "all";
52
60
  const rule = namespacedPeerOf(ruleName);
53
61
  return rule !== undefined && rule.ns.id === ns.id && rule.peer === peer ? "some" : "none";
54
62
  }
63
+ const readings = readsOtherServers ? peerReadingsOf(ruleName).filter((r) => r.ns.id === ns.id && r.peer === peer) : [];
64
+ if (readings.length > 0)
65
+ return readings.some((r) => r.tool === undefined) ? "all" : "some";
55
66
  const rule = namespacedPeerOf(ruleName);
56
67
  if (rule === undefined || rule.ns.id !== ns.id || rule.peer !== peer)
57
68
  return "none";
@@ -6,7 +6,7 @@ function probeCommand(canonOraclePath) {
6
6
  return `touch -- ${q}/.oracle-isolation-probe 2>/dev/null`;
7
7
  }
8
8
  export async function assertOracleIsolation(workerEnv, grader, opts) {
9
- const isolationClass = isIsolated(grader.env)
9
+ const isolationClass = isIsolated(grader.env) && isRemoteExecutionEnv(grader.env)
10
10
  ? "out_of_process"
11
11
  : "in_process_probe_only";
12
12
  if (grader.env === workerEnv) {
@@ -1,5 +1,7 @@
1
1
  import { describeRejectedValue } from "./tool-search-setting.js";
2
2
  import { inlineUntrusted } from "./untrusted-text.js";
3
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
4
+ const OUTPUT_STYLE_KEYS = optionKeys()({ name: 0, turnReminder: 0 });
3
5
  export const OUTPUT_STYLE_NAME_MAX = 256;
4
6
  const OUTPUT_STYLE_DEFAULT_TURN_REMINDER = "Remember to follow the specific guidelines for this style.";
5
7
  export function renderOutputStyle(name, turnReminder) {
@@ -15,10 +17,7 @@ export function resolveOutputStyleFrame(seat) {
15
17
  };
16
18
  if (seat === null || typeof seat !== "object" || Array.isArray(seat))
17
19
  return refuse(`must be an object { name, turnReminder? } (got ${describeRejectedValue(seat)})`);
18
- const extra = Object.keys(seat).filter((k) => k !== "name" && k !== "turnReminder");
19
- if (extra.length > 0)
20
- return refuse(`carries ${extra.map((k) => JSON.stringify(k)).join(", ")}, which the seat does not read (members: "name", "turnReminder")`);
21
- const { name, turnReminder } = seat;
20
+ const { name, turnReminder } = receiveMembers(seat, { subject: "TaskSpec.outputStyle", unit: "member", moment: "when the seat is read" }, OUTPUT_STYLE_KEYS, (_, extra) => refuse(`carries ${extra.map((k) => JSON.stringify(String(k))).join(", ")}, which the seat does not read (members: "name", "turnReminder")`));
22
21
  if (typeof name !== "string" || name.trim() === "")
23
22
  return refuse(`.name must be a non-empty string (got ${describeRejectedValue(name)})`);
24
23
  if (name.length > OUTPUT_STYLE_NAME_MAX)
@@ -27,5 +27,67 @@ export declare const CONFIG_RECEIPT_MODE: ReceiptMode;
27
27
  * itself, a container nested deeper — a shared one measured where it sits each time it is met), every copied container frozen.
28
28
  */
29
29
  export declare const DECLARATION_RECEIPT_MODE: ReceiptMode;
30
+ /** Only {@link optionKeys} mints an {@link OptionKeys}: a hand-written list carries no brand. */
31
+ declare const OPTION_KEYS: unique symbol;
32
+ /**
33
+ * A constructor's options table: the keys of the options interface `T`, exactly. The brand is a function over `keyof T`
34
+ * in both positions, so a table for one interface is not a table for another (a narrower one, an `Omit` of it) in either
35
+ * direction, and a plain string list is not one at all.
36
+ */
37
+ export type OptionKeys<T> = readonly string[] & {
38
+ readonly [OPTION_KEYS]: (key: keyof T) => keyof T;
39
+ };
40
+ /** The keys of `K` outside `T`, taken arm by arm when `K` is a union (each arm's own keys, not only the keys all arms share). */
41
+ type SurplusKeys<K, T> = K extends unknown ? Exclude<keyof K, keyof T> : never;
42
+ /** The minter {@link optionKeys} hands back: `never` — not callable — for an interface with an index signature, whose keys no
43
+ * table can name. */
44
+ type OptionKeysMinter<T> = string extends keyof T ? never : number extends keyof T ? never : <K extends Record<keyof T, 0>>(table: K & Record<SurplusKeys<K, T>, never>) => OptionKeys<T>;
45
+ /**
46
+ * Mint the options table of interface `T` from a literal naming each of its keys once (`{ fsync: 0, lockWaitMs: 0 }`).
47
+ * Curried so `T` is written and the literal inferred: a key of `T` the literal leaves out does not compile, and neither
48
+ * does a key `T` lacks — whether the literal is fresh, a variable, a spread, or a union whose arms each carry one — since
49
+ * every key outside `T` must be `never`. An interface with an index signature has no table (the minter is not callable).
50
+ */
51
+ export declare function optionKeys<T extends object>(): OptionKeysMinter<T>;
52
+ /** The OPTIONS DOOR — a constructor's options bag received by the receipt law, absent ⇒ an empty one: every option the constructor reads
53
+ * is read off this frozen copy, once, and the caller's bag is never read again (a store keeps no hold of it). `owner` names the
54
+ * constructor; `keys` is the table of the options it takes ({@link optionKeys}), and an option outside it is refused by name
55
+ * ({@link receiveMembers}). */
56
+ export declare function receiveOptions<T extends object>(given: T | undefined, owner: string, keys: OptionKeys<T>): Readonly<T>;
30
57
  /** Read `given` by the receipt law (module note): the plain copy, every own member taken once from its captured descriptor. */
31
58
  export declare function receiveOwnProperties<T extends object>(given: T, words: OwnPropertyReceiptWords): T;
59
+ /** How a door whose family has its own code refuses its stray members: the one sentence, and the stray names it names
60
+ * (a symbol as itself), for a refusal that also carries them as data. */
61
+ export type StrayMembersRefusal = (message: string, stray: readonly (string | symbol)[]) => Error;
62
+ /** A record's members outside a door's table: their names (a symbol as itself) and the one sentence that names them. */
63
+ export interface StrayMembers {
64
+ readonly names: readonly (string | symbol)[];
65
+ readonly sentence: string;
66
+ }
67
+ /**
68
+ * THE NAME JUDGMENT of a door (module note): every own member of `given` that `keys` does not name — a string key,
69
+ * enumerable or not, and a symbol key — with the one sentence that names them all (each with its nearest taken name within
70
+ * two edits, then the members taken); `undefined` when there is none. It reads names only: no getter runs and no value is
71
+ * looked at. On an admitted object (a plain record that is no Proxy, or a copy a receipt made) no caller code runs; a
72
+ * reader whose own law reads the caller's live object judges the names that object answers (a Proxy's own-keys answer
73
+ * included). A reader that answers a sentence instead of throwing takes this; a door that throws takes
74
+ * {@link refuseStrayMembers} or {@link receiveMembers}.
75
+ */
76
+ export declare function strayMembersOf(given: object, words: OwnPropertyReceiptWords, keys: readonly string[]): StrayMembers | undefined;
77
+ /**
78
+ * THE NAME-ONLY DOOR — the receipt's admission (not a Proxy, a plain record), then {@link strayMembersOf}: every own member
79
+ * `keys` does not name is refused, all of them in one sentence, and no getter runs. For an object the door must judge but
80
+ * not copy (a face whose callbacks are later called with the object itself as `this`); a door that takes a copy takes
81
+ * {@link receiveMembers}, which is this judgment followed by the receipt.
82
+ */
83
+ export declare function refuseStrayMembers(given: object, words: OwnPropertyReceiptWords, keys: readonly string[], refusal?: StrayMembersRefusal): void;
84
+ /**
85
+ * Read `given` by the receipt law and refuse every own member `keys` does not name (module note): the members a door
86
+ * takes, and nothing else, by one reading. The names are judged ({@link refuseStrayMembers}) before the receipt runs any
87
+ * getter, and nothing of the caller's runs between that judgment and the receipt's one capture, so the names judged are
88
+ * the names read. `refusal` codes the stray-member refusal for a door whose family has its own code (the receipt's own
89
+ * refusals keep `config.invalid_argument`). The copy handed back is frozen: what was judged is what is held, and a
90
+ * callback the door's owner later calls on it (its `this`) cannot change a member.
91
+ */
92
+ export declare function receiveMembers<T extends object>(given: T, words: OwnPropertyReceiptWords, keys: readonly string[], refusal?: StrayMembersRefusal): Readonly<T>;
93
+ export {};
@@ -1,4 +1,6 @@
1
1
  import { types } from "node:util";
2
+ import { closestName } from "./closest-name.js";
3
+ import { inlineUntrusted } from "./untrusted-text.js";
2
4
  import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
3
5
  import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
4
6
  export function receiptRefusal(message) {
@@ -12,11 +14,37 @@ export function refuseProxy(given, words) {
12
14
  }
13
15
  export const CONFIG_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: 1, others: "as-is", isProxy: (v) => types.isProxy(v) });
14
16
  export const DECLARATION_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: MODS_VALUE_DEPTH + 1, others: "refuse", freeze: true, isProxy: (v) => types.isProxy(v) });
17
+ export function optionKeys() {
18
+ return ((table) => Object.freeze(Object.keys(table)));
19
+ }
20
+ export function receiveOptions(given, owner, keys) {
21
+ return given === undefined ? Object.freeze({}) : receiveMembers(given, { subject: `${owner} options`, unit: "option", moment: `at new ${owner}` }, keys);
22
+ }
15
23
  export function receiveOwnProperties(given, words) {
24
+ admitPlainRecord(given, words);
25
+ return readCaptured(given, words);
26
+ }
27
+ export function strayMembersOf(given, words, keys) {
28
+ const names = Reflect.ownKeys(given).filter((k) => typeof k === "symbol" || !keys.includes(k));
29
+ return names.length === 0 ? undefined : Object.freeze({ names: Object.freeze(names), sentence: strayMembersSentence(words, names, keys) });
30
+ }
31
+ export function refuseStrayMembers(given, words, keys, refusal = receiptRefusal) {
32
+ admitPlainRecord(given, words);
33
+ const stray = strayMembersOf(given, words, keys);
34
+ if (stray !== undefined)
35
+ throw refusal(stray.sentence, stray.names);
36
+ }
37
+ export function receiveMembers(given, words, keys, refusal = receiptRefusal) {
38
+ refuseStrayMembers(given, words, keys, refusal);
39
+ return Object.freeze(readCaptured(given, words));
40
+ }
41
+ function admitPlainRecord(given, words) {
16
42
  refuseProxy(given, words);
17
43
  if (!isPlainRecord(given)) {
18
44
  throw receiptRefusal(`${words.subject} must be a plain object (its prototype is neither Object.prototype nor null): every ${words.unit} is read once as an own property, and a ${words.unit} its prototype would supply is not read — refused rather than wired without it`);
19
45
  }
46
+ }
47
+ function readCaptured(given, words) {
20
48
  const received = receive(given, CONFIG_RECEIPT_MODE);
21
49
  if (received.ok)
22
50
  return received.value;
@@ -27,3 +55,18 @@ export function receiveOwnProperties(given, words) {
27
55
  throw receiptRefusal(`${words.subject}'s prototype changed while its ${words.unit}s were read ${words.moment} — refused rather than wired from a moving object`);
28
56
  throw receiptRefusal(`${words.subject} could not be read ${words.moment}: ${describeFault(received.fault)} — refused rather than wired without it`);
29
57
  }
58
+ const STRAY_NAME_MAX = 80;
59
+ function strayMembersSentence(words, stray, keys) {
60
+ const named = stray.map((k) => {
61
+ if (typeof k === "symbol")
62
+ return `${inlineUntrusted(String(k), STRAY_NAME_MAX)} (a symbol-keyed member)`;
63
+ const shown = JSON.stringify(inlineUntrusted(k, STRAY_NAME_MAX));
64
+ const near = closestName(k, keys);
65
+ return near === undefined ? shown : `${shown} (did you mean ${JSON.stringify(near)}?)`;
66
+ });
67
+ const one = stray.length === 1;
68
+ const unit = words.unit;
69
+ const what = one ? `is not ${/^[aeiou]/i.test(unit) ? "an" : "a"} ${unit}` : `are not ${unit}s`;
70
+ const takes = keys.length === 0 ? `it takes no ${unit}s` : `the ${unit}s it takes are ${keys.map((k) => JSON.stringify(k)).join(", ")}`;
71
+ return `${words.subject}: ${named.join(", ")} ${what} it takes — ${takes}; refused ${words.moment} rather than read as absent (a misspelled ${unit} would leave its default in force and nothing would say so)`;
72
+ }
@@ -92,6 +92,7 @@ function syntheticCheckpoint(scope, fidelity) {
92
92
  batchToolCallIds: [`${scope}:call`],
93
93
  completedCallIds: [],
94
94
  },
95
+ heldRows: [{ role: "user", content: [{ type: "text", text: "park wiring self-check held row" }], timestamp: 0, provenance: "engine-note", rewrittenBy: ["park-selfcheck"] }],
95
96
  state: { activeTools: ["SelfCheck"], nestedStats: { tokens: 0, turns: 0, tasks: 0, costMicroUsd: 0, anyUnpriced: false } },
96
97
  status: "pending",
97
98
  createdAt: Date.now(),
@@ -99,7 +100,7 @@ function syntheticCheckpoint(scope, fidelity) {
99
100
  suspendedAt: Date.now(),
100
101
  resourceLedger: { spentMicroUsd: 0, spentTokens: 0, spentTurns: 0, sliceCount: 1 },
101
102
  humanReview: { count: 1, totalWaitMs: 0, gates: [{ kind: "human", waitMs: 0, decision: "approve", toolName: "SelfCheck", toolCallId: `${scope}:selfcheck-call`, toolArg: "park self-check probe" }] },
102
- sourceTaskId: `${scope}:task`,
103
+ sourceSessionId: `${scope}:session`,
103
104
  principal: `${scope}:principal`,
104
105
  durableApproval: { scope, ttlMs: PARK_SELFCHECK_ROW_TTL_MS },
105
106
  deadline: Date.now() + PARK_SELFCHECK_ROW_TTL_MS,
@@ -112,6 +113,7 @@ function faithfulnessDelta(sent, got) {
112
113
  scope: cp.scope,
113
114
  sessionId: cp.sessionId,
114
115
  leafId: cp.leafId,
116
+ heldRows: cp.heldRows,
115
117
  gate: cp.gate,
116
118
  pendingAction: cp.pendingAction,
117
119
  state: cp.state,
@@ -124,7 +126,7 @@ function faithfulnessDelta(sent, got) {
124
126
  suspendedAt: cp.suspendedAt,
125
127
  resourceLedger: cp.resourceLedger,
126
128
  humanReview: cp.humanReview,
127
- sourceTaskId: cp.sourceTaskId,
129
+ sourceSessionId: cp.sourceSessionId,
128
130
  principal: cp.principal,
129
131
  durableApproval: cp.durableApproval,
130
132
  });
@@ -219,10 +221,11 @@ export async function probeParkRoundTrip(deps, spec = {}) {
219
221
  return await failed("row_not_faithful", delta);
220
222
  if (status !== "pending")
221
223
  return await failed("row_not_pending", `the filed row came back with status ${shown(status)} — a park in any other status is one nobody can resolve`);
222
- const enumerable = store.listByScope !== undefined;
223
- if (store.listByScope !== undefined) {
224
- const listByScope = store.listByScope.bind(store);
225
- const listed = await within(() => listByScope(scope), "listByScope");
224
+ {
225
+ const listByScope = store.listByScope;
226
+ if (typeof listByScope !== "function")
227
+ return await failed("row_not_enumerable", "the store implements no listByScope — an inbox enumerating this scope reads nothing");
228
+ const listed = await within(() => listByScope.call(store, scope), "listByScope");
226
229
  if ("timedOut" in listed)
227
230
  return await failed("row_not_enumerable", listed.timedOut);
228
231
  if ("threw" in listed)
@@ -265,8 +268,7 @@ export async function probeParkRoundTrip(deps, spec = {}) {
265
268
  : `expire lost an UNCONTENDED CAS and the row reads ${shown(afterStatus)} — the fence that keeps a checkpoint from being both reaped and resumed does not close here`);
266
269
  }
267
270
  }
268
- const steps = `filed, read back${enumerable ? ", enumerated" : ""} and fenced`;
269
- const notExercised = enumerable ? "" : " (this store implements no listByScope, so the inbox enumeration was NOT exercised)";
271
+ const steps = "filed, read back, enumerated and fenced";
270
272
  const casNote = fenced ? "" : " (the expire CAS reported a loss while the row closed — consistent with store housekeeping, but a backend that mis-reports CAS wins is not distinguished here)";
271
273
  return {
272
274
  verdict: "round_trip_ok",
@@ -274,8 +276,8 @@ export async function probeParkRoundTrip(deps, spec = {}) {
274
276
  ...(fenced ? {} : { casLossObserved: true }),
275
277
  scope,
276
278
  summary: after === null
277
- ? `the park lane ${steps} a synthetic checkpoint${notExercised} — the row is no longer present (a deleting backend or its own housekeeping removed it), so nothing resumable remains${casNote}`
278
- : `the park lane ${steps} a synthetic checkpoint${notExercised} — residual expired row in scope "${scope}"${casNote}`,
279
+ ? `the park lane ${steps} a synthetic checkpoint — the row is no longer present (a deleting backend or its own housekeeping removed it), so nothing resumable remains${casNote}`
280
+ : `the park lane ${steps} a synthetic checkpoint — residual expired row in scope "${scope}"${casNote}`,
279
281
  ...gapCell,
280
282
  };
281
283
  }
@@ -22,5 +22,16 @@ export type ChainHopsReading = {
22
22
  * cannot answer not vote ({@link chainHopsOrNone}), an allow admits nothing it could not see.
23
23
  */
24
24
  export declare function symlinkChainHops(env: ExecutionEnv, path: string, signal: AbortSignal | undefined, family: PathFamily, baseCwd?: string): Promise<ChainHopsReading>;
25
+ /**
26
+ * Whether a target's leaf chain can hold a hop, once the environment said where the target lands: a link may be on the way
27
+ * when what was walked climbs a `..` (the lexical fold of `..` across a linked parent names another file than the one the
28
+ * filesystem walks to) or when the reader cannot say the target landed at its own lexical spelling (`landedElsewhere`: a
29
+ * link resolved elsewhere, or a resolution that rejoined a missing tail as spelled — the leaf may be a link whose target is
30
+ * not there yet). Where neither holds nothing on the way is a link, and the chain is not asked. The readers that skip the chain where no
31
+ * link can be on the way take this one gate before {@link symlinkChainHops}: a call's target views (`readPath`) and the shell read
32
+ * station's establishment. The write-protection table and the sensitive-path deny set do not: they read the chain whenever one of
33
+ * their rows can hear a hop.
34
+ */
35
+ export declare function leafChainMayHold(walked: readonly (string | undefined)[], landedElsewhere: boolean, family: PathFamily): boolean;
25
36
  /** A path guard's reading of a chain: the hops, or none — a view that cannot answer does not vote (its absence law). */
26
37
  export declare function chainHopsOrNone(reading: ChainHopsReading): readonly string[];
@@ -13,6 +13,10 @@ export async function symlinkChainHops(env, path, signal, family, baseCwd) {
13
13
  const chain = await env.canonicalChain(target, signal);
14
14
  return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: chain.error.message, asked: true };
15
15
  }
16
+ export function leafChainMayHold(walked, landedElsewhere, family) {
17
+ const climbs = family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/;
18
+ return landedElsewhere || walked.some((s) => s !== undefined && climbs.test(s));
19
+ }
16
20
  export function chainHopsOrNone(reading) {
17
21
  return reading.ok ? reading.hops : [];
18
22
  }
@@ -35,7 +35,9 @@ export declare function bindPathRules<S extends PathRuleSpec>(specs: readonly S[
35
35
  * alone. */
36
36
  export declare function policyAnchors(declared: PathRuleBases, install: PathRuleBases | undefined): PathRuleBases;
37
37
  /** A stored row's anchors: a PROJECT row's `/x` and relative words at the row's own scope root (the project it was written
38
- * for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. */
38
+ * for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. A row has no seat for a
39
+ * settings layer's own directory, so the settings import carries only the rules a row reads the way their layer does — a
40
+ * user layer's `/x`, read there at the configuration directory, stays in its file (`prepareCcImport`). */
39
41
  export declare function persistedRowAnchors(scope: RuleScope, chainTop: PathRuleBases): PathRuleBases;
40
42
  /** A leg's root as an identity for project coverage ({@link ScopeRootIdentity}): its canonical root, and each project
41
43
  * row's scope root resolved through the leg's resolution (`leads`, each location once per leg) — so a row written under
@@ -1,5 +1,5 @@
1
1
  import { parsePermissionRule } from "./permission-rule-syntax.js";
2
- import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, ruleBasesNeeded } from "./permission-rule-model.js";
2
+ import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, pathRuleReachShapeOf, ruleBasesNeeded } from "./permission-rule-model.js";
3
3
  import { pathFamilyOf, spellingOfIdentity } from "../tools/fs/safety.js";
4
4
  import { absoluteTargetIdentityOf } from "./effective-path-target.js";
5
5
  import { locationLeadsTo, ruleHeadParts } from "../tools/fs/read-deny.js";
@@ -12,6 +12,7 @@ export function bindPathRules(specs, anchors) {
12
12
  const a = typeof anchors === "function" ? anchors(spec) : anchors;
13
13
  const family = pathFamilyOf(a);
14
14
  const head = pathRuleHeadOf(spec.parsed, a);
15
+ const shape = pathRuleReachShapeOf(spec.parsed, a);
15
16
  const unanchored = ruleBasesNeeded(spec.parsed).filter((b) => !isUsablePathBase(b === "cwd" ? (a.cwd ?? a.root) : a[b], family));
16
17
  const reach = (absolutePath) => {
17
18
  const tree = a.root !== undefined || a.cwd !== undefined ? a : { root: absolutePath };
@@ -28,6 +29,7 @@ export function bindPathRules(specs, anchors) {
28
29
  reach,
29
30
  reaches: (absolutePath) => reach(absolutePath).reach !== "not_reached",
30
31
  ...(head !== undefined ? { head: spellingOfIdentity(head, family) } : {}),
32
+ ...(shape !== undefined && (a.root !== undefined || a.cwd !== undefined) ? { reachShape: shape } : {}),
31
33
  ...(unanchored.length > 0 ? { unanchored } : {}),
32
34
  };
33
35
  });