@sema-agent/core 7.60.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +605 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +61 -10
  6. package/dist/agents/cascade.js +60 -20
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,5 +1,7 @@
1
- import { ErrorCode, McpError, isJSONRPCErrorResponse, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/sdk/types.js";
1
+ import { DEFAULT_REQUEST_TIMEOUT_MSEC, SdkError, SdkErrorCode, isJSONRPCErrorResponse, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/client";
2
+ import { raceSettlementAgainstSignal } from "./runner/abort-race.js";
2
3
  import { inlineUntrusted } from "./untrusted-text.js";
4
+ const CONDITION_MAX = 400;
3
5
  export class McpHostSeatFailure extends Error {
4
6
  delivered;
5
7
  condition;
@@ -8,35 +10,216 @@ export class McpHostSeatFailure extends Error {
8
10
  throw new TypeError(`McpHostSeatFailure: delivered must be "no" or "unknown"`);
9
11
  if (typeof o.condition !== "string")
10
12
  throw new TypeError("McpHostSeatFailure: condition must be a string");
11
- super(o.condition);
13
+ const condition = inlineUntrusted(o.condition, CONDITION_MAX);
14
+ super(condition);
12
15
  this.name = "McpHostSeatFailure";
13
16
  this.delivered = o.delivered;
14
- this.condition = o.condition;
17
+ this.condition = condition;
15
18
  }
16
19
  }
17
- const VERDICTS = new WeakSet();
18
- function verdict(delivered, condition) {
19
- const minted = Object.freeze({ delivered, condition: inlineUntrusted(condition, 400) });
20
- VERDICTS.add(minted);
21
- return minted;
22
- }
23
20
  export function hostSeatVerdictOf(err) {
24
- if (!(err instanceof McpError))
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 {
25
28
  return undefined;
26
- const data = err.data;
27
- return typeof data === "object" && data !== null && VERDICTS.has(data) ? data : 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);
28
109
  }
29
- function verdictOfThrown(thrown) {
110
+ const pipeFn = (v) => (typeof v === "function" ? v : undefined);
111
+ function partsOf(pipe) {
30
112
  try {
31
- if (thrown instanceof McpHostSeatFailure) {
32
- const { delivered, condition } = thrown;
33
- if ((delivered === "no" || delivered === "unknown") && typeof condition === "string")
34
- return verdict(delivered, condition);
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
+ };
35
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);
36
213
  }
37
214
  catch {
38
215
  }
39
- return verdict("unknown", "the host seat failed without saying whether it handed the request on");
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" });
40
223
  }
41
224
  function responseOf(id, raw) {
42
225
  let answer;
@@ -51,17 +234,9 @@ function responseOf(id, raw) {
51
234
  const candidate = result !== undefined ? { jsonrpc: "2.0", id, result } : { jsonrpc: "2.0", id, error: member("error") };
52
235
  if (isJSONRPCResultResponse(candidate) || isJSONRPCErrorResponse(candidate))
53
236
  return candidate;
54
- return verdict("unknown", "the host seat answered something the protocol cannot carry as a result or an error");
55
- }
56
- export function hostSeatLine(what, serverLabel, seat, writeTail) {
57
- return seat.delivered === "no"
58
- ? `${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.`
59
- : `${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}`;
237
+ return new McpHostSeatFailure({ delivered: "unknown", condition: "the host seat answered something the protocol cannot carry as a result or an error" });
60
238
  }
61
- export function hostSeatMissing(server) {
62
- 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" });
63
- }
64
- export class HostSeatTransport {
239
+ class RequestSeatPipe {
65
240
  seat;
66
241
  serverName;
67
242
  onclose;
@@ -92,27 +267,27 @@ export class HostSeatTransport {
92
267
  const params = (message.params ?? {});
93
268
  if (method === "initialize") {
94
269
  const protocolVersion = params["protocolVersion"];
95
- return this.deliver(id, { jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
270
+ return this.deliver({ jsonrpc: "2.0", id, result: { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: this.serverName, version: "" } } });
96
271
  }
97
272
  if (this.closed)
98
- return this.deliver(id, verdict("no", "the host seat's connection to this leg is closed"));
273
+ throw new McpHostSeatFailure({ delivered: "no", condition: "the host seat's connection to this leg is closed" });
99
274
  if (method !== "tools/list" && method !== "tools/call")
100
- return this.deliver(id, verdict("no", `the host seat carries tools/list and tools/call only, and ${inlineUntrusted(method, 80)} was not handed on`));
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` });
101
276
  const stop = new AbortController();
102
277
  this.inFlight.set(id, stop);
103
- void (async () => {
104
- let answered;
105
- try {
106
- answered = responseOf(id, await this.seat.request(method, params, stop.signal));
107
- }
108
- catch (thrown) {
109
- answered = verdictOfThrown(thrown);
110
- }
111
- if (this.inFlight.get(id) !== stop)
112
- return;
113
- this.inFlight.delete(id);
114
- this.deliver(id, answered);
115
- })();
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);
116
291
  }
117
292
  async close() {
118
293
  if (this.closed)
@@ -124,8 +299,7 @@ export class HostSeatTransport {
124
299
  stop.abort(new Error("the connection to the host seat closed"));
125
300
  this.onclose?.();
126
301
  }
127
- deliver(id, answered) {
128
- const message = VERDICTS.has(answered) ? { jsonrpc: "2.0", id, error: { code: ErrorCode.InternalError, message: answered.condition, data: answered } } : answered;
302
+ deliver(message) {
129
303
  queueMicrotask(() => this.onmessage?.(message));
130
304
  }
131
305
  }
@@ -1,4 +1,4 @@
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
4
  import { transportKindOf } from "./mcp-server-spec.js";
@@ -57,7 +57,7 @@ async function raceDial(dial, ms, signal) {
57
57
  }
58
58
  }
59
59
  function stoppedWaitingStatus(entry, ms) {
60
- const condition = new McpError(ErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
60
+ const condition = new SdkError(SdkErrorCode.RequestTimeout, `the probe stopped waiting for this server's connect and initial tool listing after ${ms} ms`);
61
61
  const { kind, delivered } = classifyMcpFailure(condition, { phase: "connect", transport: transportKindOf(entry) });
62
62
  const liveness = livenessOf(kind, Date.now());
63
63
  return { name: entry.name, status: "failed", errorCode: kind, delivered, error: condition.message, ...(liveness !== undefined ? { liveness } : {}) };
@@ -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,
@@ -22,7 +22,8 @@ export interface McpServerSpec {
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
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) carries every request; the transport has no member beyond
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
26
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
27
28
  * this way cannot opt in to {@link elicitation} — both refused at every entrance (`config.invalid_argument`). It never enters
28
29
  * the run tree's connection pool: its pipe is the leg's own.
@@ -10,8 +10,7 @@
10
10
  * knows the session (404), cannot be reached or does not answer within {@link MCP_SESSION_END_WAIT_MS} costs the close that long at most
11
11
  * and nothing else — the close runs regardless and aborts a request still in the air.
12
12
  */
13
- import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
14
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
13
+ import { StreamableHTTPClientTransport, type Client } from "@modelcontextprotocol/client";
15
14
  import type { McpRequestSite } from "./mcp-failure.js";
16
15
  /** The longest a close waits for the server to answer the request that ends its session. */
17
16
  export declare const MCP_SESSION_END_WAIT_MS = 2000;
@@ -1,4 +1,4 @@
1
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
1
+ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
2
2
  export const MCP_SESSION_END_WAIT_MS = 2_000;
3
3
  export class SessionEndingTransport extends StreamableHTTPClientTransport {
4
4
  closing;
@@ -81,7 +81,7 @@ export interface McpDroppedTool {
81
81
  * ({@link walkMcpListPages}'s `budgetMs`) had too little left to fund another request
82
82
  * ({@link MIN_MCP_PAGE_BUDGET_MS}), so none was sent. Distinct from `page_error` on purpose — the
83
83
  * server neither failed nor was asked. Issuing that request anyway would hand the SDK a
84
- * near-zero timeout, and its -32001 would arrive here wearing the server's failure clothes.
84
+ * near-zero timeout, and its `RequestTimeout` would arrive here wearing the server's failure clothes.
85
85
  * `error` is SERVER-authored text — neutralize it before it rides any model/operator face.
86
86
  */
87
87
  export interface McpListingIncomplete {
@@ -403,7 +403,7 @@ export declare function structuredContentErrorLine(structuredContent: unknown, c
403
403
  export declare function truncateMcpErrorText(s: string): string;
404
404
  /**
405
405
  * Default per-call MCP tool timeout. The SDK's own default (60s) silently kills any long-running MCP tool
406
- * with a -32001 and offers the deployment no knob; a very large default (matching the behavior of the
406
+ * with a `RequestTimeout` and offers the deployment no knob; a very large default (matching the behavior of the
407
407
  * reference agent client) lets the task-level budget/abort govern instead, while `MCP_TOOL_TIMEOUT` (ms)
408
408
  * remains available to tighten it per deployment.
409
409
  */
@@ -432,11 +432,11 @@ export declare function mcpToolTimeoutMs(): number;
432
432
  * per-call timeout). The SDK's `resetTimeoutOnProgress` only re-arms the SDK's OWN per-call timer
433
433
  * (`mcpToolTimeoutMs()` above — a different mechanism from {@link armMcpIdleWatchdog}'s idle watchdog
434
434
  * below, despite the name-adjacent terms; disambiguated here on purpose, see that function's docstring
435
- * for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (protocol.js
436
- * `_resetTimeout`), so without this a
435
+ * for why sema needs both). It enforces a total bound ONLY when `maxTotalTimeout` is provided (the protocol
436
+ * layer's `_resetTimeout`), so without this a
437
437
  * misbehaving/stuck server emitting periodic progress notifications could extend a call forever. Defaulting
438
438
  * the ceiling to the per-call timeout means progress can keep an active call alive only within the same
439
- * window the deployment already accepted; the resulting failure is the same -32001 timeout frame. Env
439
+ * window the deployment already accepted; the resulting failure is the same `RequestTimeout` frame. Env
440
440
  * parsing follows the `MCP_TOOL_TIMEOUT` discipline (unset/unparseable/non-positive → default). Exported
441
441
  * for tests.
442
442
  */
@@ -448,7 +448,7 @@ export declare function mcpToolTotalTimeoutMs(perCallMs: number): number;
448
448
  * from its total ceiling (`j7u` @345484: stdio 30min / http-sse 5min).
449
449
  *
450
450
  * Narrower than the audit's original framing: a CLOSED transport is already handled correctly by the SDK
451
- * itself — `Protocol._onclose` (shared/protocol.js) rejects every in-flight response handler immediately
451
+ * itself — `Protocol._onclose` rejects every in-flight response handler immediately
452
452
  * with `ConnectionClosed` the moment `onclose` fires, so this watchdog exists for the SILENT-but-open case
453
453
  * only, not as a substitute for connection-close handling.
454
454
  */
@@ -470,15 +470,6 @@ export declare function mcpStartupTimeoutMs(server?: Pick<McpServerSpec, "name"
470
470
  /** The protocol-range condition name for a JSON-RPC error code, or `undefined` for every other code
471
471
  * (see {@link MCP_SPEC_ERROR_CODE_NAMES}). */
472
472
  export declare function describeMcpSpecErrorCode(code: unknown): string | undefined;
473
- /**
474
- * The SDK stamps `MCP error <code>: ` onto an McpError's message IN ITS CONSTRUCTOR, and it
475
- * does so at BOTH ends of the wire: a server built on an MCP SDK throws an McpError, its already-stamped
476
- * `.message` goes out as the JSON-RPC `error.message`, and the client constructs its own McpError over
477
- * that string — so the failure reaches the model as `MCP error -32602: MCP error -32602: …`. Collapse a
478
- * repeat of the SAME code (a leading stamp carrying a DIFFERENT code is server data, not a duplicate of
479
- * ours, and is left alone). Exported for unit testing; not part of the package index.
480
- */
481
- export declare function collapseMcpErrorPrefix(message: string): string;
482
473
  export { normalizeNameSegment as normalizeMcpName, clampNameSegment } from "./protocol-naming.js";
483
474
  export * from "./image-downsample.js";
484
475
  /**
@@ -735,37 +726,3 @@ export declare function walkMcpListPages<T>(fetchPage: (cursor: string | undefin
735
726
  items: T[];
736
727
  incomplete?: McpListingIncomplete;
737
728
  }>;
738
- /**
739
- * RB-408 G12 — `tools/call` result parse that accepts the MCP `2026-07-28` widening of
740
- * `structuredContent` from "a JSON object" to ANY JSON value (the same revision that relaxes
741
- * `inputSchema`/`outputSchema` to the full JSON Schema 2020-12 keyword set).
742
- *
743
- * SDK 1.30.0's `CallToolResultSchema` still types the field as a record, so a spec-legal array / string /
744
- * number / boolean / null fails validation for the WHOLE result — and the failure takes the `content`
745
- * blocks down with it: a server returning perfectly usable text plus a scalar `structuredContent`
746
- * produced nothing but `Invalid tools/call result: expected record, received number`. That is a silent
747
- * capability loss dressed as a protocol error, and it gets WORSE as servers adopt the revision.
748
- *
749
- * The widening is deliberately surgical: `structuredContent` is lifted out, the SDK's own strict schema
750
- * runs over the remainder (so content-block validation, the `content` default and the loose passthrough
751
- * of unknown top-level keys are byte-for-byte what they were), and the lifted value is re-attached
752
- * VERBATIM — same reference, no rebuild. An object-valued `structuredContent` therefore behaves exactly
753
- * as before, and a malformed `content` array is still rejected: this must not become a validation bypass.
754
- * Same duck-typing posture as {@link LenientListToolsResultSchema} (no direct `zod` dependency — the SDK's
755
- * `zod-compat` shim calls `.safeParse(data)` on any object lacking a Zod-4 `_zod` marker).
756
- *
757
- * RESIDUAL, SDK-side and deliberately not widened here: `Client.callTool` guards its `outputSchema`
758
- * validation with a TRUTHINESS test on `result.structuredContent`, so a tool that declares an
759
- * `outputSchema` and returns a falsy scalar (`0`, `""`, `false`, `null`) is still rejected by the SDK with
760
- * "has an output schema but did not return structured content". That path is LOUD (never a silent drop),
761
- * is bounded to outputSchema-declaring tools, and widening it means replacing `callTool` itself — which
762
- * would mean re-implementing the two guards it exists for (the output validator and the
763
- * `taskSupport:"required"` refusal, both keyed off SDK-private caches).
764
- */
765
- export declare function parseCallToolResultLenient(data: unknown): {
766
- success: true;
767
- data: unknown;
768
- } | {
769
- success: false;
770
- error: unknown;
771
- };