@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
@@ -0,0 +1,305 @@
1
+ import { DEFAULT_REQUEST_TIMEOUT_MSEC, SdkError, SdkErrorCode, isJSONRPCErrorResponse, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/client";
2
+ import { raceSettlementAgainstSignal } from "./runner/abort-race.js";
3
+ import { inlineUntrusted } from "./untrusted-text.js";
4
+ const CONDITION_MAX = 400;
5
+ export class McpHostSeatFailure extends Error {
6
+ delivered;
7
+ condition;
8
+ constructor(o) {
9
+ if (o.delivered !== "no" && o.delivered !== "unknown")
10
+ throw new TypeError(`McpHostSeatFailure: delivered must be "no" or "unknown"`);
11
+ if (typeof o.condition !== "string")
12
+ throw new TypeError("McpHostSeatFailure: condition must be a string");
13
+ const condition = inlineUntrusted(o.condition, CONDITION_MAX);
14
+ super(condition);
15
+ this.name = "McpHostSeatFailure";
16
+ this.delivered = o.delivered;
17
+ this.condition = condition;
18
+ }
19
+ }
20
+ export function hostSeatVerdictOf(err) {
21
+ try {
22
+ if (!(err instanceof McpHostSeatFailure))
23
+ return undefined;
24
+ const { delivered, condition } = err;
25
+ return (delivered === "no" || delivered === "unknown") && typeof condition === "string" ? Object.freeze({ delivered, condition: inlineUntrusted(condition, CONDITION_MAX) }) : undefined;
26
+ }
27
+ catch {
28
+ return undefined;
29
+ }
30
+ }
31
+ export function hostSeatLine(what, serverLabel, seat, writeTail) {
32
+ return seat.delivered === "no"
33
+ ? `${what} was not sent to MCP server "${serverLabel}": ${seat.condition}. The host did not hand the request on, so the server did not execute it; sending it again is safe.`
34
+ : `${what} on MCP server "${serverLabel}" ended without an outcome the host could report: ${seat.condition}. The request may or may not have executed on the server — the outcome is unknown.${writeTail}`;
35
+ }
36
+ export function hostSeatMissing(server) {
37
+ return Object.assign(new Error(`MCP server "${inlineUntrusted(server, 120)}" is declared with a host-supplied transport, and this leg holds no host seat of that name (RunInternals.mcpHostSeats) — not dialed`), { code: "config.mcp_host_seat_missing" });
38
+ }
39
+ export function hostMount(ms, run) {
40
+ const bound = ms ?? DEFAULT_REQUEST_TIMEOUT_MSEC;
41
+ const mount = new AbortController();
42
+ const follow = () => mount.abort(run?.reason);
43
+ const timer = setTimeout(() => mount.abort(new SdkError(SdkErrorCode.RequestTimeout, `the host's pipe did not finish mounting within ${bound} ms`, { timeout: bound })), bound);
44
+ if (run?.aborted === true)
45
+ follow();
46
+ else
47
+ run?.addEventListener("abort", follow, { once: true });
48
+ return {
49
+ signal: mount.signal,
50
+ end: () => {
51
+ clearTimeout(timer);
52
+ run?.removeEventListener("abort", follow);
53
+ },
54
+ };
55
+ }
56
+ export async function settledBefore(work, stop) {
57
+ if (stop === undefined)
58
+ return work;
59
+ const raced = await raceSettlementAgainstSignal(work, stop);
60
+ if (raced.tag === "aborted")
61
+ throw stop.reason;
62
+ if (raced.tag === "threw")
63
+ throw raced.error;
64
+ return raced.value;
65
+ }
66
+ const TAKEN = new WeakMap();
67
+ const refusal = (condition) => new McpHostSeatFailure({ delivered: "no", condition });
68
+ export async function openHostPipe(seat, server, stop) {
69
+ stop?.throwIfAborted();
70
+ let open;
71
+ try {
72
+ open = seat.open;
73
+ }
74
+ catch {
75
+ open = undefined;
76
+ }
77
+ if (typeof open !== "function")
78
+ throw refusal("the host seat has no open function, so no pipe was opened");
79
+ let opened;
80
+ try {
81
+ opened = Promise.resolve(Reflect.apply(open, seat, [Object.freeze({ server, signal: stop ?? new AbortController().signal })]));
82
+ }
83
+ catch (thrown) {
84
+ opened = Promise.reject(thrown);
85
+ }
86
+ const raced = stop !== undefined ? await raceSettlementAgainstSignal(opened, stop) : await opened.then((value) => ({ tag: "value", value }), (error) => ({ tag: "threw", error }));
87
+ if (raced.tag === "aborted") {
88
+ void opened.then((late) => dropLate(late, server), () => undefined);
89
+ throw stop.reason;
90
+ }
91
+ if (raced.tag === "threw") {
92
+ const said = hostSeatVerdictOf(raced.error);
93
+ throw said !== undefined ? new McpHostSeatFailure(said) : refusal("the host seat failed to open a pipe for this dial without saying why");
94
+ }
95
+ return take(raced.value, server);
96
+ }
97
+ function take(pipe, server) {
98
+ if ((typeof pipe !== "object" && typeof pipe !== "function") || pipe === null)
99
+ throw refusal("the host seat's open handed over something that is not an MCP transport");
100
+ const holder = TAKEN.get(pipe);
101
+ if (holder !== undefined)
102
+ throw refusal(`the host seat handed over a pipe the dial of MCP server "${inlineUntrusted(holder, 120)}" already took — a pipe serves one dial`);
103
+ TAKEN.set(pipe, server);
104
+ const parts = partsOf(pipe);
105
+ if (typeof parts !== "string")
106
+ return new TakenPipe(pipe, parts);
107
+ closeUnwaited(pipe);
108
+ throw refusal(parts);
109
+ }
110
+ const pipeFn = (v) => (typeof v === "function" ? v : undefined);
111
+ function partsOf(pipe) {
112
+ try {
113
+ const t = pipe;
114
+ const [start, send, close, sessionId, setProtocolVersion, setSupportedProtocolVersions, hasPerRequestStream] = [pipeFn(t["start"]), pipeFn(t["send"]), pipeFn(t["close"]), t["sessionId"], t["setProtocolVersion"], t["setSupportedProtocolVersions"], t["hasPerRequestStream"]];
115
+ if (start === undefined || send === undefined || close === undefined)
116
+ return "the host seat's open handed over something that is not an MCP transport (it needs start, send and close functions)";
117
+ if (sessionId !== undefined)
118
+ return "the host seat's open handed over a pipe that already holds a session, so the server's handshake would be skipped";
119
+ return { start, send, close, setProtocolVersion: pipeFn(setProtocolVersion), setSupportedProtocolVersions: pipeFn(setSupportedProtocolVersions), hasPerRequestStream: hasPerRequestStream === true ? true : undefined };
120
+ }
121
+ catch {
122
+ return "the host seat's open handed over a pipe whose members cannot be read";
123
+ }
124
+ }
125
+ class TakenPipe {
126
+ onclose;
127
+ onerror;
128
+ onmessage;
129
+ hasPerRequestStream;
130
+ #pipe;
131
+ #parts;
132
+ #inFlight = new Map();
133
+ #ended = false;
134
+ #closing = false;
135
+ constructor(pipe, parts) {
136
+ this.#pipe = pipe;
137
+ this.#parts = parts;
138
+ this.hasPerRequestStream = parts.hasPerRequestStream;
139
+ }
140
+ async start() {
141
+ try {
142
+ const p = this.#pipe;
143
+ const [heard, ended, failed] = [p.onmessage, p.onclose, p.onerror];
144
+ p.onmessage = (message, extra) => {
145
+ heard?.(message, extra);
146
+ if ((isJSONRPCResultResponse(message) || isJSONRPCErrorResponse(message)) && this.#inFlight.has(message.id))
147
+ this.#inFlight.set(message.id, true);
148
+ this.onmessage?.(message, extra);
149
+ };
150
+ p.onclose = () => {
151
+ ended?.();
152
+ this.#end();
153
+ };
154
+ p.onerror = (error) => {
155
+ failed?.(error);
156
+ this.onerror?.(error);
157
+ };
158
+ }
159
+ catch {
160
+ throw refusal("the host's pipe would not take the engine's callbacks");
161
+ }
162
+ await Reflect.apply(this.#parts.start, this.#pipe, []);
163
+ }
164
+ async send(message, options) {
165
+ if (!isJSONRPCRequest(message))
166
+ return void (await Reflect.apply(this.#parts.send, this.#pipe, [message, options]));
167
+ const id = message.id;
168
+ this.#inFlight.set(id, false);
169
+ try {
170
+ await Reflect.apply(this.#parts.send, this.#pipe, [message, options]);
171
+ }
172
+ catch (err) {
173
+ if (this.#inFlight.get(id) !== true)
174
+ throw err;
175
+ }
176
+ finally {
177
+ this.#inFlight.delete(id);
178
+ }
179
+ }
180
+ async close() {
181
+ if (!this.#closing) {
182
+ this.#closing = true;
183
+ closeUnwaited(this.#pipe, this.#parts.close);
184
+ }
185
+ this.#end();
186
+ }
187
+ setProtocolVersion(version) {
188
+ if (this.#parts.setProtocolVersion !== undefined)
189
+ Reflect.apply(this.#parts.setProtocolVersion, this.#pipe, [version]);
190
+ }
191
+ setSupportedProtocolVersions(versions) {
192
+ if (this.#parts.setSupportedProtocolVersions !== undefined)
193
+ Reflect.apply(this.#parts.setSupportedProtocolVersions, this.#pipe, [versions]);
194
+ }
195
+ #end() {
196
+ if (this.#ended)
197
+ return;
198
+ this.#ended = true;
199
+ this.onclose?.();
200
+ }
201
+ }
202
+ function dropLate(late, server) {
203
+ if ((typeof late !== "object" && typeof late !== "function") || late === null || TAKEN.has(late))
204
+ return;
205
+ TAKEN.set(late, server);
206
+ closeUnwaited(late);
207
+ }
208
+ function closeUnwaited(pipe, close) {
209
+ try {
210
+ const fn = close ?? pipeFn(pipe["close"]);
211
+ if (fn !== undefined)
212
+ void Promise.resolve(Reflect.apply(fn, pipe, [])).catch(() => undefined);
213
+ }
214
+ catch {
215
+ }
216
+ }
217
+ export function hostSeatOfRequests(seat) {
218
+ return { open: ({ server }) => new RequestSeatPipe(seat, server) };
219
+ }
220
+ function failureOfThrown(thrown) {
221
+ const said = hostSeatVerdictOf(thrown);
222
+ return new McpHostSeatFailure(said ?? { delivered: "unknown", condition: "the host seat failed without saying whether it handed the request on" });
223
+ }
224
+ function responseOf(id, raw) {
225
+ let answer;
226
+ try {
227
+ answer = JSON.parse(JSON.stringify(raw) ?? "null");
228
+ }
229
+ catch {
230
+ answer = undefined;
231
+ }
232
+ const member = (name) => (typeof answer === "object" && answer !== null && Object.hasOwn(answer, name) ? answer[name] : undefined);
233
+ const result = member("result");
234
+ const candidate = result !== undefined ? { jsonrpc: "2.0", id, result } : { jsonrpc: "2.0", id, error: member("error") };
235
+ if (isJSONRPCResultResponse(candidate) || isJSONRPCErrorResponse(candidate))
236
+ return candidate;
237
+ return new McpHostSeatFailure({ delivered: "unknown", condition: "the host seat answered something the protocol cannot carry as a result or an error" });
238
+ }
239
+ class RequestSeatPipe {
240
+ seat;
241
+ serverName;
242
+ onclose;
243
+ onerror;
244
+ onmessage;
245
+ inFlight = new Map();
246
+ closed = false;
247
+ constructor(seat, serverName) {
248
+ this.seat = seat;
249
+ this.serverName = serverName;
250
+ }
251
+ async start() { }
252
+ async send(message) {
253
+ if (isJSONRPCNotification(message)) {
254
+ if (message.method === "notifications/cancelled") {
255
+ const id = message.params?.requestId;
256
+ const held = typeof id === "string" || typeof id === "number" ? this.inFlight.get(id) : undefined;
257
+ if (held !== undefined) {
258
+ this.inFlight.delete(id);
259
+ held.abort(new Error("the engine cancelled the request"));
260
+ }
261
+ }
262
+ return;
263
+ }
264
+ if (!isJSONRPCRequest(message))
265
+ return;
266
+ const { id, method } = message;
267
+ const params = (message.params ?? {});
268
+ if (method === "initialize") {
269
+ const protocolVersion = params["protocolVersion"];
270
+ return this.deliver({ jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
271
+ }
272
+ if (this.closed)
273
+ throw new McpHostSeatFailure({ delivered: "no", condition: "the host seat's connection to this leg is closed" });
274
+ if (method !== "tools/list" && method !== "tools/call")
275
+ throw new McpHostSeatFailure({ delivered: "no", condition: `the host seat carries tools/list and tools/call only, and ${inlineUntrusted(method, 80)} was not handed on` });
276
+ const stop = new AbortController();
277
+ this.inFlight.set(id, stop);
278
+ let answered;
279
+ try {
280
+ answered = responseOf(id, await this.seat.request(method, params, stop.signal));
281
+ }
282
+ catch (thrown) {
283
+ answered = failureOfThrown(thrown);
284
+ }
285
+ if (this.inFlight.get(id) !== stop)
286
+ return;
287
+ this.inFlight.delete(id);
288
+ if (answered instanceof McpHostSeatFailure)
289
+ throw answered;
290
+ this.deliver(answered);
291
+ }
292
+ async close() {
293
+ if (this.closed)
294
+ return;
295
+ this.closed = true;
296
+ const held = [...this.inFlight.values()];
297
+ this.inFlight.clear();
298
+ for (const stop of held)
299
+ stop.abort(new Error("the connection to the host seat closed"));
300
+ this.onclose?.();
301
+ }
302
+ deliver(message) {
303
+ queueMicrotask(() => this.onmessage?.(message));
304
+ }
305
+ }
@@ -1,6 +1,7 @@
1
1
  import { type McpFailureKind } from "./mcp-failure.js";
2
- import type { McpServerSpec, OnElicit } from "./mcp-server-spec.js";
3
- import type { PeerSeat } from "./peer-seat.js";
2
+ import { type McpServerSpec, type OnElicit } from "./mcp-server-spec.js";
3
+ import { type PeerSeat } from "./peer-seat.js";
4
+ import { type HostFloorDeclaration } from "./host-floor.js";
4
5
  import type { WiringManifestMcpEntry } from "./wiring-manifest.js";
5
6
  /** One server's probe reading, beside its manifest row. `connectMs` is wall time this probe measured
6
7
  * for THIS server's dial — the spawn/handshake, the initial `tools/list` walk and the intake, ending
@@ -60,6 +61,10 @@ export interface McpProbeOptions {
60
61
  /** The peer seat a prepared leg dials with (`RunnerDeps.peerSeat`): what each request carries. Absent ⇒ nothing is carried, and a
61
62
  * server whose declaration names `credentials` reads `failed` (`invalid_config`, `config.peer_seat_missing`). */
62
63
  peerSeat?: PeerSeat;
64
+ /** The deployment's host floor, as `RunnerDeps.hostFloor` declares it: compiled by the one compile ({@link compileHostFloor} — a
65
+ * declaration that does not read is refused before anything is dialed) and judged at the one dial, so an http server whose
66
+ * endpoint a task's floor refuses is refused here too and never contacted. Absent ⇒ no floor, as a deployment that declares none. */
67
+ hostFloor?: HostFloorDeclaration;
63
68
  /** Abort reading, stated once: the call rejects with the signal's own reason when that reason is an
64
69
  * Error (a bare `abort()` supplies a DOMException named `AbortError`) and with this module's own
65
70
  * `AbortError` otherwise — a face that throws a string is a face no `catch` can read. A condition
@@ -1,6 +1,9 @@
1
- import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
1
+ import { SdkError, SdkErrorCode } from "@modelcontextprotocol/client";
2
2
  import { snapshotMcpEntries } from "./locked-config.js";
3
3
  import { classifyMcpFailure, livenessOf } from "./mcp-failure.js";
4
+ import { transportKindOf } from "./mcp-server-spec.js";
5
+ import { receivePeerSeat } from "./peer-seat.js";
6
+ import { compileHostFloor } from "./host-floor.js";
4
7
  import { MCP_ENV_MS_MAX, materializeMcpTools } from "./mcp.js";
5
8
  import { refuseCollidingMcpServerNames } from "./mcp-name-judge.js";
6
9
  import { mcpManifestEntries } from "./runner/prepare-wiring-manifest.js";
@@ -54,8 +57,8 @@ async function raceDial(dial, ms, signal) {
54
57
  }
55
58
  }
56
59
  function stoppedWaitingStatus(entry, ms) {
57
- const condition = new McpError(ErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
58
- const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: entry.transport.kind });
60
+ const condition = new SdkError(SdkErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
61
+ const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: transportKindOf(entry) });
59
62
  const liveness = livenessOf(kind, Date.now());
60
63
  return { name: entry.name, status: "failed", errorCode: kind, delivered, error: condition.message, ...(liveness !== undefined ? { liveness } : {}) };
61
64
  }
@@ -64,7 +67,9 @@ export async function probeMcpServers(specs, opts = {}) {
64
67
  const timeoutMs = wholeInRange("timeoutMs", opts.timeoutMs, 1, MCP_ENV_MS_MAX);
65
68
  const concurrency = wholeInRange("concurrency", opts.concurrency, 1, Number.MAX_SAFE_INTEGER) ?? 1;
66
69
  const onElicit = opts.onElicit ?? DECLINE_EVERY_ELICITATION;
70
+ const hostFloor = compileHostFloor(opts.hostFloor);
67
71
  const signal = opts.signal;
72
+ const peerSeat = receivePeerSeat(opts.peerSeat, "probeMcpServers peerSeat");
68
73
  refuseCollidingMcpServerNames(declared.map((e) => e.name));
69
74
  const statuses = [];
70
75
  const servers = new Array(declared.length);
@@ -74,7 +79,7 @@ export async function probeMcpServers(specs, opts = {}) {
74
79
  const entry = declared[i];
75
80
  const started = performance.now();
76
81
  const elapsed = () => Math.round(performance.now() - started);
77
- const dial = materializeMcpTools([entry], opts.principal, onElicit, undefined, undefined, undefined, undefined, undefined, undefined, undefined, undefined, opts.peerSeat);
82
+ const dial = materializeMcpTools([entry], opts.principal, onElicit, undefined, undefined, undefined, undefined, undefined, undefined, undefined, hostFloor, peerSeat);
78
83
  const verdict = await raceDial(dial, timeoutMs, signal);
79
84
  if (verdict.kind === "settled") {
80
85
  const found = verdict.handle.statuses.find((s) => s.name === entry.name);
@@ -12,7 +12,7 @@
12
12
  * session while that connection is still the live one — a call that lost its session on a connection already replaced is sent on the
13
13
  * replacement, so a late 404 never closes a connection other calls have moved to.
14
14
  */
15
- import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
15
+ import type { Client, Tool } from "@modelcontextprotocol/client";
16
16
  import { type McpAuthorization, type McpExchangeOutcome, type McpFailure, type McpFailureSite } from "./mcp-failure.js";
17
17
  /**
18
18
  * One request failure, read once and told to the server's two writers: its reach ({@link ServerHealth.observe}) always, and — when
@@ -90,12 +90,19 @@ export interface LenientListedTool {
90
90
  inputSchema?: unknown;
91
91
  annotations?: unknown;
92
92
  _meta?: unknown;
93
- /** codex review (RB-199 FO-2 follow-up, confirmed HIGH): carried through UNVALIDATED (same posture as
94
- * inputSchema) so `cacheMcpToolMetadata` (mcp.ts) can restore what `client.listTools()` used to do for
95
- * free. Not fed through core's own gate — see that function's docstring for why. */
93
+ /** Carried through UNVALIDATED (same posture as inputSchema): the tool's definition rides every call to it (mcp.ts
94
+ * `toolDefinitionOf`), and the SDK validates a structured result against it; whether this client can compile it is judged at intake. */
96
95
  outputSchema?: unknown;
97
96
  execution?: unknown;
98
97
  }
98
+ /** A mounted tool as its calls hand it to the SDK (`callTool`'s `toolDefinition`), from the connection's latest listing through the
99
+ * leg's own intake: the definition the server listed, and whether this client's schema validator cannot compile its `outputSchema`
100
+ * (`outputSchemaUncompilable`) — {@link reach} then refuses the call before it is sent, rather than leaving it to the SDK's refusal in
101
+ * words a reader would take for the server's answer. The compiler's own message is not kept: it quotes the server's schema. */
102
+ export interface McpToolDefinition {
103
+ readonly tool: Tool;
104
+ readonly outputSchemaUncompilable?: true;
105
+ }
99
106
  /**
100
107
  * The server's listing as one connection knows it, from whichever of its holders listed last (each leg of a pooled run lists on the
101
108
  * shared connection) — what every holder's mounted tools are checked against, each through its own leg's intake, and what a leg mounts.
@@ -139,6 +146,9 @@ export interface McpLiveConnection {
139
146
  readonly health: ServerHealth;
140
147
  /** Minted tool name → the gate the connection's latest listing ({@link ConnectionListing}) mints it, through this leg's intake. */
141
148
  gates(): ReadonlyMap<string, string>;
149
+ /** Minted tool name → its definition from that same listing through that same intake ({@link McpToolDefinition}): what a call to it
150
+ * hands the SDK. One reading with {@link gates}, so a call is never validated against a listing other than the one that let it go. */
151
+ definitions(): ReadonlyMap<string, McpToolDefinition>;
142
152
  }
143
153
  export interface McpServerLink {
144
154
  /** The connection the materialization holds for the server now; `undefined` while it holds none (a re-dial's old one is gone and the new one has not landed, or the last dial failed). */
@@ -149,8 +159,10 @@ export interface McpServerLink {
149
159
  * connection is replaced once for all its holders). */
150
160
  recover(lost: McpLiveConnection, cause?: "session" | "expired"): Promise<unknown>;
151
161
  }
152
- /** Why a tool may not be sent on a live connection: its listing mints the tool another gate or none (`changed`), or no listing of the connection has reached it (`unreached`). */
153
- export type McpListingRefusal = "changed" | "unreached";
162
+ /** Why a tool may not be sent on a live connection: its listing mints the tool another gate or none (`changed`), no listing of the connection has reached it (`unreached`), or that
163
+ * listing gives it an output schema this connection's validator cannot compile (`output_schema`: the SDK would refuse the call unsent itself, in words a reader takes for the
164
+ * server's answer). */
165
+ export type McpListingRefusal = "changed" | "unreached" | "output_schema";
154
166
  /** Where the tool `name` minted with `gate` may be sent now: the live connection, `"gone"` when there is none (or it closed), or why its listing does not vouch for the tool ({@link McpListingRefusal}). */
155
167
  export declare function reach(link: McpServerLink, name: string, gate: string): McpLiveConnection | "gone" | McpListingRefusal;
156
168
  /** An attempt whose session was found gone: the connection it was sent on, and its failure as it would have been thrown then. */
@@ -75,7 +75,9 @@ export function reach(link, name, gate) {
75
75
  const listed = live.gates().get(name);
76
76
  if (listed === UNPROVEN_GATE)
77
77
  return "unreached";
78
- return listed === gate ? live : "changed";
78
+ if (listed !== gate)
79
+ return "changed";
80
+ return live.definitions().get(name)?.outputSchemaUncompilable === true ? "output_schema" : live;
79
81
  }
80
82
  export class Resendable {
81
83
  on;
@@ -113,11 +115,24 @@ export function refusalScope(judge) {
113
115
  const j = REFUSAL_JUDGES[judge];
114
116
  return `${j.standing}This refusal is for this call only: ${j.rule}.`;
115
117
  }
118
+ const LISTING_REFUSAL_CODES = {
119
+ changed: "mcp.tool_declaration_changed",
120
+ unreached: "mcp.tool_listing_unreached",
121
+ output_schema: "mcp.tool_output_schema_invalid",
122
+ };
116
123
  export function listingRefusal(refusal, remoteName, server) {
117
- const changed = refusal === "changed";
118
- const code = changed ? "mcp.tool_declaration_changed" : "mcp.tool_listing_unreached";
124
+ const code = LISTING_REFUSAL_CODES[refusal];
119
125
  return {
120
- content: [{ type: "text", text: `The call to tool ${inlineUntrusted(remoteName)} was refused before it was sent: MCP server "${inlineUntrusted(server)}" ${changed ? "no longer declares this tool the way it was mounted (its safety declaration changed, or a complete listing no longer lists it)" : "has not listed this tool since it was reconnected (the re-listing stopped before it reached the tool), so whether the server still declares it the way it was mounted is unknown"}. The server did not execute it. ${refusalScope("listing")}` }],
126
+ content: [
127
+ {
128
+ type: "text",
129
+ text: `The call to tool ${inlineUntrusted(remoteName)} was refused before it was sent: MCP server "${inlineUntrusted(server)}" ${refusal === "changed"
130
+ ? "no longer declares this tool the way it was mounted (its safety declaration changed, or a complete listing no longer lists it)"
131
+ : refusal === "unreached"
132
+ ? "has not listed this tool since it was reconnected (the re-listing stopped before it reached the tool), so whether the server still declares it the way it was mounted is unknown"
133
+ : "lists this tool with an output schema this client cannot compile, so its structured result could not be checked"}. The server did not execute it. ${refusalScope("listing")}`,
134
+ },
135
+ ],
121
136
  details: { error: code, code, delivered: "no", server },
122
137
  terminate: false,
123
138
  isError: true,
@@ -21,13 +21,20 @@ export interface McpServerSpec {
21
21
  * carries — an http request's credential headers, a stdio child's environment — are answered per send by the deployment's
22
22
  * peer seat ({@link RunnerDeps.peerSeat}). A `credentials` reference with no seat wired refuses the entry
23
23
  * (`config.peer_seat_missing`); a declaration carrying the retired value members `headers` / `env` is refused at every
24
- * entrance (`config.credential_in_declaration`).
24
+ * entrance (`config.credential_in_declaration`). `host`: the host supplies the pipe itself — the leg's host seat of this
25
+ * declaration's `name` (`RunInternals.mcpHostSeats`, mcp-host-seat.ts) hands one MCP transport per dial, and the server behind
26
+ * it answers the whole protocol (its handshake, instructions and resources included); the transport has no member beyond
27
+ * its kind (a host seat carries its own pieces, so a reference or a principal header has nothing to ride), and a server mounted
28
+ * this way cannot opt in to {@link elicitation} — both refused at every entrance (`config.invalid_argument`). It never enters
29
+ * the run tree's connection pool: its pipe is the leg's own.
25
30
  */
26
31
  transport: {
27
32
  kind: "stdio";
28
33
  command: string;
29
34
  args?: string[];
30
35
  credentials?: CredentialRef;
36
+ } | {
37
+ kind: "host";
31
38
  } | {
32
39
  kind: "http";
33
40
  url: string;
@@ -199,6 +206,12 @@ export interface McpServerSpec {
199
206
  */
200
207
  sessionMetaKey?: string;
201
208
  }
209
+ /** The transport kinds a declaration names, one list: the dial reads a kind against it, so a word outside it is no kind at all. */
210
+ export declare const MCP_TRANSPORT_KINDS: readonly ["stdio", "http", "host"];
211
+ export type McpTransportKind = McpServerSpec["transport"]["kind"];
212
+ /** The one reading of a declaration's transport kind: a word of {@link MCP_TRANSPORT_KINDS}, or `undefined` for anything else (no transport,
213
+ * not a record, a word outside the list, a member that throws) — total, so a reader never fails on a declaration the dial would refuse. */
214
+ export declare function transportKindOf(spec: McpServerSpec): McpTransportKind | undefined;
202
215
  type ToolAxes = NonNullable<McpServerSpec["toolAxes"]>;
203
216
  /**
204
217
  * The surfaces that declare `toolAxes`, which {@link readToolAxes} names its reading by: an MCP server's keys are the server's
@@ -218,10 +231,23 @@ export type ToolAxesRead = {
218
231
  ok: false;
219
232
  problem: string;
220
233
  };
221
- /** A name the declarer wrote, quoted and bounded for a sentence (the sentence names; it never carries a value). The bound holds on the
222
- * QUOTED form — escaping a quote, a backslash or a control character lengthens a name — so a sentence's budget is spent the same way
223
- * whatever the name holds. */
224
- export declare function quotedName(name: string): string;
234
+ /**
235
+ * THE one shape text the caller wrote takes in a judge's sentence — a value, or a key the caller chose (a tool or skill name, the name of
236
+ * a member the declaration does not have, a `_meta` key): the redaction mark and its length, never the text. A caller's text can be
237
+ * anything a deployment put in the wrong field, a credential included, and the sentence travels to logs, panels and probes. A value that
238
+ * is no string is named by its kind ({@link dataKind}). Everything else a judge's sentence says is the engine's own: where (the
239
+ * declaration's member names, a list index), why (the closed vocabulary, a kind, a count and its bound) and whose (the declarer's name,
240
+ * the entry's published identity, which the engine already mints into every tool name it mounts).
241
+ */
242
+ export declare function callerText(value: unknown): string;
243
+ /**
244
+ * Where in a declaration a sentence points, from `base`: a list index in brackets, a member name after a dot — the declaration's own
245
+ * member names (`words`, the engine's words) as written, any other key in the caller's-text shape ({@link callerText}). Bounded: no key is
246
+ * added once the path runs past 120 characters, and a path cut short ends in the truncation mark, so a deep declaration never makes a long
247
+ * sentence. Every judge of a declaration renders its paths here.
248
+ */
249
+ export declare function declarationPath(path: readonly (string | number)[], words: ReadonlySet<string>, base?: string): string;
250
+ export declare const DECLARATION_ENTRY_WORDS: ReadonlySet<string>;
225
251
  /** The kind of a value that is plain data, for a sentence that names what was declared without carrying it. */
226
252
  export declare function dataKind(value: unknown): string;
227
253
  /**
@@ -303,12 +329,16 @@ type PerToolDeclarationRead = {
303
329
  };
304
330
  /**
305
331
  * A per-tool declaration's receipt: {@link receiveDeclaration} (plain data held to the engine's one depth, every own member read once,
306
- * lists of names, no `__proto__`), then the copy must be a record of names. A refusal names the tool (or skill) and the member where
307
- * reading stopped, never a value. `unit` is what the keys are called (`tool` / `skill`).
332
+ * lists of names, no `__proto__`), then the copy must be a record of names. A refusal points at the tool (or skill) and the member where
333
+ * reading stopped in the engine's words — the declaration's member names (`words`), a list index — and shows the caller's own keys and
334
+ * values in the one caller's-text shape ({@link callerText}). `unit` is what the keys are called (`tool` / `skill`).
308
335
  */
309
- export declare function receivePerToolDeclaration(declared: unknown, field: PerToolDeclaration, unit: string): PerToolDeclarationRead;
310
- /** The sentence for one tool's (or skill's) declaration that does not fit: `detail` says which member and why. */
336
+ export declare function receivePerToolDeclaration(declared: unknown, field: PerToolDeclaration, unit: string, words: ReadonlySet<string>): PerToolDeclarationRead;
337
+ /** The sentence for one tool's (or skill's) declaration that does not fit: `detail` says which member and why. The tool's name is the
338
+ * caller's text ({@link callerText}). */
311
339
  export declare function perToolEntryRefusal(field: PerToolDeclaration, unit: string, key: string, detail: string): string;
340
+ /** The member names of one tool's axes ({@link TOOL_AXIS_MEMBERS}): the words a `toolAxes` refusal's member path spells. */
341
+ export declare const TOOL_AXIS_WORDS: ReadonlySet<string>;
312
342
  /** The sentence for a per-tool declaration that names a tool (or skill) with an empty name. */
313
343
  export declare function perToolEmptyName(field: PerToolDeclaration, unit: string): string;
314
344
  /**