@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,4 @@
1
- import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
2
- import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
1
+ import { ProtocolError, SdkError, SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
3
2
  import { proxyTunnelRefusedSentence, readConnectFailure } from "../brain/errors.js";
4
3
  import { PeerAuthorizationRefused, PeerSeatFailure } from "./peer-seat.js";
5
4
  import { hostSeatVerdictOf } from "./mcp-host-seat.js";
@@ -84,7 +83,7 @@ const NETWORK_CODES_NEVER_DELIVERED = new Set([
84
83
  export function networkErrorCode(err, depth = 0) {
85
84
  if (depth > 5 || !(err instanceof Error))
86
85
  return undefined;
87
- const code = err.code;
86
+ const code = err instanceof SdkError ? undefined : err.code;
88
87
  if (typeof code === "string" && /^(?:E[A-Z_]+|UND_ERR_[A-Z_]+)$/.test(code))
89
88
  return code;
90
89
  if (err instanceof AggregateError) {
@@ -98,6 +97,43 @@ export function networkErrorCode(err, depth = 0) {
98
97
  }
99
98
  const isNodeErrCode = (code) => code.startsWith("ERR_");
100
99
  const isDeclarationFault = (code) => code === "ERR_INVALID_URL" || (typeof code === "string" && code.startsWith("config."));
100
+ export const SDK_ERROR_READINGS = {
101
+ [SdkErrorCode.NotConnected]: { kind: "connection_closed", unsent: true },
102
+ [SdkErrorCode.AlreadyConnected]: { kind: "unknown" },
103
+ [SdkErrorCode.NotInitialized]: { kind: "unknown" },
104
+ [SdkErrorCode.CapabilityNotSupported]: { kind: "unknown" },
105
+ [SdkErrorCode.RequestTimeout]: { kind: "timeout" },
106
+ [SdkErrorCode.ConnectionClosed]: { kind: "connection_closed" },
107
+ [SdkErrorCode.SendFailed]: { kind: "unknown" },
108
+ [SdkErrorCode.InvalidResult]: { kind: "protocol" },
109
+ [SdkErrorCode.UnsupportedResultType]: { kind: "protocol" },
110
+ [SdkErrorCode.InputRequiredRoundsExceeded]: { kind: "protocol" },
111
+ [SdkErrorCode.ListPaginationExceeded]: { kind: "protocol" },
112
+ [SdkErrorCode.MethodNotSupportedByProtocolVersion]: { kind: "protocol", unsent: true },
113
+ [SdkErrorCode.EraNegotiationFailed]: { kind: "unknown" },
114
+ [SdkErrorCode.ClientHttpNotImplemented]: "status",
115
+ [SdkErrorCode.ClientHttpAuthentication]: { kind: "unauthorized", reason: "rejected" },
116
+ [SdkErrorCode.ClientHttpForbidden]: { kind: "unauthorized", reason: "scope" },
117
+ [SdkErrorCode.ClientHttpUnexpectedContent]: { kind: "not_mcp_response" },
118
+ [SdkErrorCode.ClientHttpFailedToOpenStream]: "status",
119
+ [SdkErrorCode.ClientHttpFailedToTerminateSession]: "status",
120
+ };
121
+ function httpStatusClass(err) {
122
+ const status = err instanceof SdkHttpError ? err.status : undefined;
123
+ if (status === 401)
124
+ return { kind: "unauthorized", authorization: { reason: "rejected" } };
125
+ return typeof status === "number" && Number.isInteger(status) && status > 0 ? { kind: "http_status", httpStatus: status } : { kind: "not_mcp_response" };
126
+ }
127
+ function sdkErrorClass(err) {
128
+ const reading = SDK_ERROR_READINGS[err.code];
129
+ if (reading === undefined)
130
+ return { kind: "unknown" };
131
+ if (reading === "status")
132
+ return httpStatusClass(err);
133
+ if (reading.kind === "unauthorized")
134
+ return { kind: "unauthorized", authorization: { reason: reading.reason } };
135
+ return { kind: reading.kind, ...(reading.unsent === true ? { unsent: true } : {}) };
136
+ }
101
137
  export const FAILURE_CLASSIFIER = [
102
138
  {
103
139
  name: "peer seat answered the principal is not authorized",
@@ -110,42 +146,28 @@ export const FAILURE_CLASSIFIER = [
110
146
  reads: () => ({ kind: "credential_unavailable", unsent: true }),
111
147
  },
112
148
  {
113
- name: "host seat did not carry the request",
114
- when: (err) => hostSeatVerdictOf(err) !== undefined,
115
- reads: (err) => ({ kind: hostSeatVerdictOf(err).delivered === "no" ? "host_refused" : "unknown" }),
149
+ name: "http endpoint refused the authorization",
150
+ when: (err) => err instanceof PeerAuthorizationRefused,
151
+ reads: (err) => {
152
+ const refused = err;
153
+ return { kind: "unauthorized", authorization: authorizationOf(refused.reason, refused.authorizeUrl, refused.resourceMetadataUrl) };
154
+ },
116
155
  },
117
156
  {
118
- name: "sdk connection closed",
119
- when: (err) => err instanceof McpError && err.code === ErrorCode.ConnectionClosed,
120
- reads: () => ({ kind: "connection_closed" }),
157
+ name: "host seat did not carry the request",
158
+ when: (err) => hostSeatVerdictOf(err) !== undefined,
159
+ reads: (err) => ({ kind: hostSeatVerdictOf(err)?.delivered === "no" ? "host_refused" : "unknown" }),
121
160
  },
122
161
  {
123
- name: "sdk request timeout",
124
- when: (err) => err instanceof McpError && err.code === ErrorCode.RequestTimeout,
125
- reads: () => ({ kind: "timeout" }),
162
+ name: "sdk error read by its code",
163
+ when: (err) => err instanceof SdkError,
164
+ reads: (err) => sdkErrorClass(err),
126
165
  },
127
166
  {
128
167
  name: "server answered with a protocol error",
129
- when: (err) => err instanceof McpError,
168
+ when: (err) => err instanceof ProtocolError,
130
169
  reads: () => ({ kind: "protocol" }),
131
170
  },
132
- {
133
- name: "http endpoint refused the authorization",
134
- when: (err) => err instanceof StreamableHTTPError && (err.code === 401 || err instanceof PeerAuthorizationRefused),
135
- reads: (err) => err instanceof PeerAuthorizationRefused
136
- ? { kind: "unauthorized", authorization: authorizationOf(err.reason, err.authorizeUrl, err.resourceMetadataUrl) }
137
- : { kind: "unauthorized", authorization: { reason: "rejected" } },
138
- },
139
- {
140
- name: "http endpoint answered a status",
141
- when: (err) => err instanceof StreamableHTTPError && typeof err.code === "number" && err.code > 0,
142
- reads: (err) => ({ kind: "http_status", httpStatus: err.code }),
143
- },
144
- {
145
- name: "http endpoint answered a non-mcp payload",
146
- when: (err) => err instanceof StreamableHTTPError,
147
- reads: () => ({ kind: "not_mcp_response" }),
148
- },
149
171
  {
150
172
  name: "malformed declaration",
151
173
  when: (err, at) => at.phase === "connect" && err instanceof Error && isDeclarationFault(err.code),
@@ -199,19 +221,24 @@ export function readMcpFailure(err, at) {
199
221
  function authorizationOf(reason, authorizeUrl, resourceMetadataUrl) {
200
222
  return { reason, ...(authorizeUrl !== undefined ? { authorizeUrl } : {}), ...(resourceMetadataUrl !== undefined ? { resourceMetadataUrl } : {}) };
201
223
  }
224
+ const NO_AUTHORIZATION_ADDRESS = "no authorization address was given";
202
225
  export function whereToAuthorize(authorizeUrl) {
203
- return authorizeUrl !== undefined ? `at ${authorizeUrl}` : "through the deployment's connector settings";
226
+ return authorizeUrl !== undefined ? `at ${authorizeUrl}` : `(${NO_AUTHORIZATION_ADDRESS})`;
204
227
  }
205
228
  export function needsAuthorizationArm(entries, max) {
206
229
  const named = entries.filter((f) => f.authorization !== undefined);
207
230
  if (named.length === 0)
208
231
  return undefined;
209
232
  const withUrl = named.filter((f) => f.authorization?.authorizeUrl !== undefined).length;
210
- const where = withUrl === named.length ? "at the address listed beside it" : withUrl === 0 ? whereToAuthorize(undefined) : `at the address listed beside it, or, for a server listed without one, ${whereToAuthorize(undefined)}`;
233
+ const where = withUrl === named.length
234
+ ? "— at the address listed beside it —"
235
+ : withUrl === 0
236
+ ? whereToAuthorize(undefined)
237
+ : "— at the address listed beside it (a server listed without one was given no authorization address) —";
211
238
  const lines = named.slice(0, max).map((f) => `${f.name}${f.authorization?.authorizeUrl !== undefined ? ` — authorize ${whereToAuthorize(f.authorization.authorizeUrl)}` : ""}`);
212
239
  return (`The following MCP servers require authentication before their tools can be used:\n${lines.join("\n")}${named.length > max ? `\n…and ${named.length - max} more` : ""}\n\n` +
213
240
  `You cannot start the authorization flow yourself. If the user's request depends on one of these servers (even if they didn't name it explicitly), ` +
214
- `or they ask about it, tell them that it needs to be authorized — ${where} — and that the capability is unavailable until they do. ` +
241
+ `or they ask about it, tell them that it needs to be authorized ${where} and that the capability is unavailable until they do. ` +
215
242
  `Otherwise carry on with the request and do not mention these servers. Do not ask the user for authorization codes, tokens, or callback URLs.`);
216
243
  }
217
244
  export function unauthorizedLine(what, serverLabel, a, renewed, writeTail) {
@@ -1,29 +1,55 @@
1
1
  /**
2
- * The host seat: an MCP pipe the HOST supplies for one leg, mounted by a declaration whose transport is `{ kind: "host" }`
3
- * ({@link import("./mcp-server-spec.js").McpServerSpec}). The engine owns the seat's shape and the one adapter that turns it
4
- * into an MCP transport ({@link HostSeatTransport}); the host owns what is behind it. The declaration is data (it rides
5
- * `TaskSpec.mcp`, the wiring manifest and a resume config like any other entry); the seat is a live object and rides the
6
- * trusted channel only (`RunInternals.mcpHostSeats`, keyed by the declaration's `name`), never a spec, a checkpoint or a
7
- * retained child's snapshot.
2
+ * The host seat: the source of the MCP pipe the HOST supplies for one leg, mounted by a declaration whose transport is `{ kind: "host" }`
3
+ * ({@link import("./mcp-server-spec.js").McpServerSpec}). The declaration is data (it rides `TaskSpec.mcp`, the wiring manifest and a
4
+ * resume config like any other entry); the seat is a live object and rides the trusted channel only (`RunInternals.mcpHostSeats`, keyed
5
+ * by the declaration's `name`), never a spec, a checkpoint or a retained child's snapshot.
8
6
  *
9
- * A host-seat server goes through the one MCP pipeline every server does — the dial, the listing intake, the call lane, the
10
- * failure record — so its listed `_meta`, its call `_meta` and its tool names are what a stdio or http server's would be.
11
- * What the adapter does itself, and only this:
12
- * · answers `initialize` locally: the server's name is the declaration's `name`, its version the empty string (a host-seat
13
- * declaration states no version), its capabilities `tools` only, no instructions; swallows `notifications/initialized`;
14
- * · hands `tools/list` and `tools/call` to the seat, one {@link McpHostSeat.request} each, with a signal of the request's own
15
- * — aborted when the engine cancels that request (its abort, its timeout, the idle watchdog) and when the connection closes;
16
- * · refuses every other method locally (the request is not handed on), and drops an answer that arrives after its request
17
- * was cancelled.
18
- * Every outcome reaches the SDK as a JSON-RPC response: the seat's answer as it gave it, a seat failure as an error response
19
- * whose `data` is a verdict object only this module mints ({@link hostSeatVerdictOf}) — `send` itself never rejects, so the
20
- * SDK's per-request handlers are always cleared by the response.
7
+ * A seat hands one MCP SDK `Transport` per dial ({@link McpHostSeat.open}); the server behind it answers the whole protocol itself — its
8
+ * handshake, its instructions, its resources — and goes through the one MCP pipeline every server does (the dial, the listing intake,
9
+ * the call lane, the failure record), so its tool names, its listed `_meta` and its call `_meta` are what a stdio or http server's would
10
+ * be. Its server is the host's own code: it is not confined by the engine's sandbox, and what it reaches is not judged by the engine's
11
+ * host floor (that floor judges an http declaration's URL).
12
+ *
13
+ * THE PIPE'S OWNERSHIP — one rule, four checkpoints, all at the dial ({@link openHostPipe}, {@link hostMount}):
14
+ * · one open per dial: every dial (the first, a re-dial, a child's, a resumed leg's) asks the seat once; no pipe is kept across dials;
15
+ * · one deadline over the whole mount — the open, the pipe's `start`, the handshake, the first listing — raced against the dial's stop:
16
+ * the host's pipe can hold any of those steps, where the SDK's own timer covers the requests only. At the deadline the dial fails
17
+ * `timeout`, and the engine closes the pipe (one that arrives later too) without waiting on the host;
18
+ * · a pipe is taken once, at its arrival: one handed again — to another dial, or to this one after it stopped waiting — is refused
19
+ * and left alone (it is its first taker's); a late pipe nobody took is taken and closed;
20
+ * · a pipe is a transport: `start` / `send` / `close` functions, and no `sessionId` (the SDK skips the handshake on a pipe that holds one,
21
+ * and the server's capabilities and instructions would never be read).
22
+ * A pipe taken is the dial's: the engine connects it and the engine closes it — at once, for the engine: the connection reads closed when
23
+ * the engine closes it, and the host's own close runs on the host's time, never waited on, its failure nobody's (`TakenPipe`). A refusal is
24
+ * `host_refused` (nothing was sent), in the engine's own words.
25
+ *
26
+ * WHAT THE HOST CAN SAY — one class, {@link McpHostSeatFailure}, read by one classifier row wherever it surfaces: thrown by `open` (the
27
+ * dial fails, nothing was sent), or the rejection of the pipe's `send` of a request (that request fails). A request settles ONCE, by
28
+ * whichever comes first: the server's answer, its send's rejection, the engine's cancel (its abort, its timer, the idle watchdog), the
29
+ * pipe's close — a host that closes the pipe and then rejects a send reads as the closed connection. A cancellation the pipe fails to
30
+ * send is no request's ending (the cancelled request already ended as cancelled): cancelling a call on the host's server is best effort.
31
+ *
32
+ * A host that serves requests rather than messages hands {@link hostSeatOfRequests} of its {@link McpHostRequestSeat}: the one adapter
33
+ * answers the handshake itself, carries `tools/list` and `tools/call` only, and hands back the seat's failures through the same `send`
34
+ * rejection (see {@link hostSeatOfRequests}).
21
35
  */
22
- import { type JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
23
- import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
24
- /** The requests a host seat answers: a listing and a call. */
36
+ import { type Transport } from "@modelcontextprotocol/client";
37
+ /**
38
+ * The host's pipe source for one leg (`RunInternals.mcpHostSeats`, TRUSTED, by declaration name). `open` is asked once per dial of that
39
+ * declaration and hands one transport (or a promise of one); `server` is the declaration's name, `signal` aborts when the engine stops
40
+ * waiting for this mount (the run's abort, the mount's deadline). What `open` hands is the dial's from its arrival (see the module note):
41
+ * a transport handed a second time is refused. `open` throws {@link McpHostSeatFailure} to say why there is no pipe; anything else it
42
+ * throws refuses the dial in the engine's words. The engine never disposes a seat: the host releases it when its leg ends.
43
+ */
44
+ export interface McpHostSeat {
45
+ open(at: {
46
+ readonly server: string;
47
+ readonly signal: AbortSignal;
48
+ }): Transport | Promise<Transport>;
49
+ }
50
+ /** The requests a request-level host seat answers: a listing and a call. */
25
51
  export type McpHostSeatMethod = "tools/list" | "tools/call";
26
- /** A host seat's answer to one request: the JSON-RPC result, or the JSON-RPC error the remote answered with. */
52
+ /** A request-level host seat's answer to one request: the JSON-RPC result, or the JSON-RPC error the remote answered with. */
27
53
  export type McpHostSeatAnswer = {
28
54
  readonly result: unknown;
29
55
  } | {
@@ -34,20 +60,20 @@ export type McpHostSeatAnswer = {
34
60
  };
35
61
  };
36
62
  /**
37
- * The host's MCP pipe for one leg (`RunInternals.mcpHostSeats`, TRUSTED). `request` answers one request; `signal` is that
38
- * request's own cancellation. A request the host could not hand to the remote, or whose ending it cannot tell, is answered by
39
- * throwing {@link McpHostSeatFailure}. The engine never disposes a seat: the host releases it when its leg ends.
63
+ * A host's seat that answers requests rather than messages — handed to the engine as {@link hostSeatOfRequests}`(seat)`. `request`
64
+ * answers one request; `signal` is that request's own cancellation. A request the host could not hand to the remote, or whose ending it
65
+ * cannot tell, is answered by throwing {@link McpHostSeatFailure}.
40
66
  */
41
- export interface McpHostSeat {
67
+ export interface McpHostRequestSeat {
42
68
  request(method: McpHostSeatMethod, params: Readonly<Record<string, unknown>>, signal: AbortSignal): Promise<McpHostSeatAnswer>;
43
69
  }
44
70
  /**
45
- * A host seat's failure to carry one request, in the one fact the host knows: `delivered: "no"` — the request was not handed to the
46
- * remote (nothing ran; the failure word is `host_refused`); `delivered: "unknown"` — it was handed on and the host cannot tell how it
47
- * ended (the failure word is `unknown`). `condition` is the host's own sentence about why, read as untrusted text and bounded; the
48
- * engine adds what the verdict owes the model (retry safety, the verify-first warning of a write-capable tool) itself, so the
49
- * condition carries none of it. Any other value thrown by a seat — or this class built with a delivery word outside the two — is a
50
- * request whose ending the engine cannot tell either: it reads as `unknown`, in the engine's own words, never the thrown text.
71
+ * What a host says it could not carry, in the one fact the host knows: `delivered: "no"` — nothing was handed to the remote (no pipe was
72
+ * handed over, or the request was not sent; the failure word is `host_refused`); `delivered: "unknown"` — the request was handed on and
73
+ * the host cannot tell how it ended (the failure word is `unknown`; at the dial, nothing of the caller's was sent either way).
74
+ * `condition` is the host's own sentence about why, read as untrusted text and bounded here; the engine adds what the verdict owes the
75
+ * model (retry safety, the verify-first warning of a write-capable tool) itself, so the condition carries none of it. A value of this
76
+ * class whose two facts do not read as they were built is no verdict: it reads as any other thrown value does.
51
77
  */
52
78
  export declare class McpHostSeatFailure extends Error {
53
79
  readonly delivered: "no" | "unknown";
@@ -57,36 +83,49 @@ export declare class McpHostSeatFailure extends Error {
57
83
  condition: string;
58
84
  });
59
85
  }
60
- /** What a host seat said about a request it did not answer: the delivery fact and the sentence a failure renders. */
86
+ /** The host's verdict a failure states: the delivery fact and the sentence a failure renders. */
61
87
  export interface HostSeatVerdict {
62
88
  readonly delivered: "no" | "unknown";
63
89
  readonly condition: string;
64
90
  }
65
- /** The host seat's verdict a failure carries (the SDK's error for a response this module synthesized), else `undefined`. Structure only. */
91
+ /** The host's verdict a thrown value states — a {@link McpHostSeatFailure} whose two facts read as they were built, read once into the
92
+ * engine's own copy (the condition bounded again: re-bounding a bounded sentence leaves it as it is) — else `undefined`, also for a value
93
+ * whose inspection throws. Structure only: a remote's JSON cannot build one, and its shape is no verdict. */
66
94
  export declare function hostSeatVerdictOf(err: unknown): HostSeatVerdict | undefined;
67
- /** The sentence a host seat's verdict becomes on the call lane: who failed and why, then the tail the delivery fact owes. */
95
+ /** The sentence a host's verdict becomes on the call lane: who failed and why, then the tail the delivery fact owes. */
68
96
  export declare function hostSeatLine(what: string, serverLabel: string, seat: HostSeatVerdict, writeTail: string): string;
69
97
  /** A host-seat declaration whose leg holds no seat of its name: refused at its dial (`config.mcp_host_seat_missing`), nothing sent. */
70
98
  export declare function hostSeatMissing(server: string): Error & {
71
99
  code: string;
72
100
  };
73
101
  /**
74
- * The one adapter from a {@link McpHostSeat} to the SDK's `Transport` (see the module note). One per connection: `close` aborts every
75
- * request still in the seat's hands and closes the connection.
102
+ * One host row's mount under ONE deadline (the module note): `signal` aborts when `ms` (the row's startup bound; absent, the SDK's own
103
+ * request default) has passed since the mount began — a `RequestTimeout`, which the dial reads as `timeout` — or when `run` (the run's
104
+ * abort) fires, with its reason. `end` stands both down once the first listing is in, or the dial failed.
76
105
  */
77
- export declare class HostSeatTransport implements Transport {
78
- private readonly seat;
79
- private readonly serverName;
80
- onclose?: () => void;
81
- onerror?: (error: Error) => void;
82
- onmessage?: <T extends JSONRPCMessage>(message: T) => void;
83
- /** The requests in the seat's hands, by id: an answer is delivered only while its request is still here. */
84
- private readonly inFlight;
85
- private closed;
86
- constructor(seat: McpHostSeat, serverName: string);
87
- start(): Promise<void>;
88
- send(message: JSONRPCMessage): Promise<void>;
89
- close(): Promise<void>;
90
- /** One response to the request `id`, on its own turn (never inside the `send` that carried the request). */
91
- private deliver;
92
- }
106
+ export declare function hostMount(ms: number | undefined, run: AbortSignal | undefined): {
107
+ readonly signal: AbortSignal;
108
+ end(): void;
109
+ };
110
+ /** `work`, unless `stop` fires first: then the stop's reason, at once — whatever `work` does later is dropped (never an unhandled
111
+ * rejection). Without a stop, `work` itself. A mount step on a host's pipe waits through here (the module note). */
112
+ export declare function settledBefore<T>(work: Promise<T>, stop: AbortSignal | undefined): Promise<T>;
113
+ /**
114
+ * The dial's pipe from the leg's seat (the module note's four checkpoints): `open` asked once, raced against `stop` (the mount's signal);
115
+ * what arrives is taken, then judged a transport. Throws the stop's reason when the dial stopped waiting (a pipe that arrives later is
116
+ * taken and closed, unless another dial took it), the host's own {@link McpHostSeatFailure} when `open` threw one, and the engine's
117
+ * refusal for everything else (an `open` that threw anything else or is not a function, a value that is no transport, a pipe already taken).
118
+ */
119
+ export declare function openHostPipe(seat: McpHostSeat, server: string, stop: AbortSignal | undefined): Promise<Transport>;
120
+ /**
121
+ * The one adapter from a request-level seat to a pipe source: each `open` hands a fresh pipe over `seat`. What the pipe does itself:
122
+ * · answers `initialize` locally — the server's name is the dial's declaration name, its version the empty string (a host-seat declaration
123
+ * states no version), its capabilities `tools` only, no instructions — and swallows `notifications/initialized`;
124
+ * · hands `tools/list` and `tools/call` to the seat, one {@link McpHostRequestSeat.request} each, with a signal of the request's own —
125
+ * aborted when the engine cancels that request (its abort, its timeout, the idle watchdog) and when the pipe closes;
126
+ * · refuses every other method locally (the request is not handed on), and drops an answer that arrives after its request was cancelled.
127
+ * The seat's answer reaches the SDK as the JSON-RPC response it is; the seat's failure — its {@link McpHostSeatFailure}, anything else it
128
+ * throws (read as `unknown`, in the engine's words, never the thrown text), an answer the protocol cannot carry — as the rejection of that
129
+ * request's `send`, which the SDK hands to the waiting request as it is, clearing its handlers.
130
+ */
131
+ export declare function hostSeatOfRequests(seat: McpHostRequestSeat): McpHostSeat;