@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,6 +1,6 @@
1
- import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
1
+ import { SdkHttpError } from "@modelcontextprotocol/client";
2
2
  import { type CredentialRef } from "@sema-agent/primitives";
3
- import type { McpServerSpec } from "./mcp-server-spec.js";
3
+ import { type McpServerSpec, type McpTransportKind } from "./mcp-server-spec.js";
4
4
  import type { ProtocolId } from "./protocol-table.js";
5
5
  /** Why the seat is asked: the first send of a connection, any later send, or the send after a 401. */
6
6
  export type PeerAskCause = "connect" | "request" | "rejected";
@@ -40,7 +40,7 @@ export interface PeerQuestion {
40
40
  }
41
41
  /**
42
42
  * The seat's answer: the pieces to carry (`headers` for an http request and an A2A send, `env` for a stdio child — the member of the
43
- * other lane is refused; `expiresAt`, epoch ms, is read by a stdio child only), or that the principal is not authorized here.
43
+ * other lane is refused; `expiresAt`, a non-negative epoch-millisecond number, is read by a stdio child only; a header value is held to the HTTP request grammar and an env value to what a spawn hands the child unchanged), or that the principal is not authorized here.
44
44
  */
45
45
  export type PeerAnswer = {
46
46
  readonly kind: "carry";
@@ -52,10 +52,26 @@ export type PeerAnswer = {
52
52
  readonly authorizeUrl?: string;
53
53
  };
54
54
  /**
55
- * The deployment's peer seat (`RunnerDeps.peerSeat`, TRUSTED). It owes the binding the engine cannot judge: answer only for the
56
- * reference, principal, protocol and destination (or start command) it was asked about — never one token for every peer.
55
+ * The deployment's peer seat (`RunnerDeps.peerSeat`, TRUSTED): one object, three members, all required.
56
+ * · `answer` — what one send carries. It owes the binding the engine cannot judge: answer only for the reference, principal,
57
+ * protocol and destination (or start command) it was asked about — never one token for every peer.
58
+ * · `hold` / `release` — an engine object started / stopped keeping a declaration that names `ref` (see the module note): called
59
+ * once each per keeper and distinct reference, `release` only for a `hold` that succeeded (it returned, or the promise it returned
60
+ * fulfilled — a release due before then is sent then); the reference is a frozen copy, never a value, never a session. A seat that
61
+ * keeps no state per reference makes both no-ops. A throw or a rejection is reported (`onError`, phase `config`) and changes
62
+ * nothing else: a `hold` that failed is not held and gets no `release`.
57
63
  */
58
- export type PeerSeat = (question: PeerQuestion, signal: AbortSignal) => Promise<PeerAnswer>;
64
+ export interface PeerSeat {
65
+ answer(question: PeerQuestion, signal: AbortSignal): Promise<PeerAnswer>;
66
+ hold(ref: CredentialRef): void;
67
+ release(ref: CredentialRef): void;
68
+ }
69
+ /**
70
+ * The one reader of a peer seat handed to the engine (`new Runner`, the three library entrances): absent ⇒ `undefined`; else an
71
+ * object whose three members are functions, each read once and kept bound to that object in a frozen copy — or refused
72
+ * (`config.invalid_argument`) naming what does not fit. A function is the form before 7.60.0: refused with the form that replaced it.
73
+ */
74
+ export declare function receivePeerSeat(raw: unknown, subject: string): PeerSeat | undefined;
59
75
  /** Which answer member each transport carries. */
60
76
  export declare const PEER_ANSWER_LANES: Readonly<{
61
77
  readonly http: "headers";
@@ -105,7 +121,7 @@ export declare class PeerSeatFailure extends Error {
105
121
  /**
106
122
  * An MCP HTTP request the endpoint refused for its authorization — a 401, or a 403 whose Bearer challenge says `insufficient_scope`
107
123
  * (RFC 6750 §3.1) — raised by the one fetch ({@link peerFetch}) in place of the SDK's status error, which keeps no header. It IS the
108
- * SDK's status error (same class, same `code`), so every structural reader of a status reads it unchanged; it adds what the response
124
+ * SDK's status error (same class, same `status`), so every structural reader of a status reads it unchanged; it adds what the response
109
125
  * said and what the re-ask after a 401 answered:
110
126
  * · `reason` — `rejected` (401) or `scope` (403);
111
127
  * · `resourceMetadataUrl` — the Bearer challenge's `resource_metadata` ({@link bearerChallengeParams}), the REMOTE's claim, read by
@@ -117,7 +133,7 @@ export declare class PeerSeatFailure extends Error {
117
133
  * The text is the engine's sentence followed by the response body as the SDK's own error would have carried it (bounded to
118
134
  * {@link REFUSAL_BODY_MAX} characters) — REMOTE text, read by every face through the one remote-words reading like any status body.
119
135
  */
120
- export declare class PeerAuthorizationRefused extends StreamableHTTPError {
136
+ export declare class PeerAuthorizationRefused extends SdkHttpError {
121
137
  readonly reason: "rejected" | "scope";
122
138
  readonly resourceMetadataUrl: string | undefined;
123
139
  readonly authorizeUrl: string | undefined;
@@ -140,7 +156,9 @@ export interface CarriedPieces {
140
156
  readonly expiresAt?: number;
141
157
  readonly digest: string;
142
158
  }
143
- /** The seat's answer for `lane`, read once: the pieces, the `unauthorized` answer, or the problem (which member did not fit). */
159
+ /** The seat's answer for `lane`, read once: the pieces, the `unauthorized` answer, or the problem (which member did not fit). The
160
+ * answer's members are its OWN members (a member its prototype would supply is not read), and each value is judged by the grammar of
161
+ * the send that will carry it ({@link VALUE_LAW}). */
144
162
  export declare function readPeerAnswer(raw: unknown, lane: PeerLane): {
145
163
  readonly carry: CarriedPieces;
146
164
  } | {
@@ -150,6 +168,24 @@ export declare function readPeerAnswer(raw: unknown, lane: PeerLane): {
150
168
  } | {
151
169
  readonly problem: string;
152
170
  };
171
+ /** Declarations as a keeper holds them: a spec's (or a spec snapshot's) `mcp` and `a2a` lists, read as given. */
172
+ export interface PeerDeclarations {
173
+ readonly mcp?: unknown;
174
+ readonly a2a?: unknown;
175
+ }
176
+ /** One keeper's hold on the references its declarations name (see the module note), taken when it is made. */
177
+ export interface PeerDeclarationHold {
178
+ /** Release every reference this keeper holds, each once. A second call does nothing. */
179
+ release(): void;
180
+ }
181
+ /**
182
+ * A keeper's hold: `seat.hold` once for each distinct reference (by its canonical form) `declared` names, now, and one `seat.release`
183
+ * for each hold that succeeded, at `release`. A hold succeeds when it returns — or, when it returns a promise, when that promise
184
+ * fulfils (a release asked for before then is sent then). No seat ⇒ nothing is held (a declared reference is refused at the door). A
185
+ * seat member that throws or whose promise rejects reaches `onFault` as the engine's own sentence (the seat's error is not repeated:
186
+ * deployment code may put a value in it); a hold that failed is not held and gets no release.
187
+ */
188
+ export declare function holdPeerDeclarations(seat: PeerSeat | undefined, declared: PeerDeclarations, onFault: (err: Error) => void): PeerDeclarationHold;
153
189
  /** What the re-ask after a 401 said: whether it answered other pieces than the refused send carried, and the seat's `authorizeUrl` when it answered `unauthorized`. */
154
190
  export interface PeerReask {
155
191
  readonly renewed: boolean;
@@ -167,13 +203,17 @@ export declare class PeerCarrier {
167
203
  private readonly principal;
168
204
  private readonly lane;
169
205
  readonly sent: string[];
206
+ /** Every credential value the seat's answers handed this connection, accepted or refused ({@link answeredCredentialValues}), that the
207
+ * withheld table holds (one that names a secret, `namesASecret`: never a blank one, a placeholder or a short dev key) — the needle a
208
+ * remote's account of itself is read without. */
209
+ readonly credentials: string[];
170
210
  /** When the pieces a stdio child was started with stop being good; `undefined` when the answer said nothing. */
171
211
  expiresAt: number | undefined;
172
212
  renewed: boolean;
173
213
  private asked;
174
214
  private waiting;
175
215
  private rejection;
176
- constructor(seat: PeerSeat | undefined, identity: PeerSeatTarget, principal: string | undefined, lane: PeerLane, principalSent: boolean);
216
+ constructor(seat: PeerSeat | undefined, identity: PeerCarrierIdentity, principal: string | undefined, lane: PeerLane, principalSent: boolean);
177
217
  /** The peer as the refusal sentences name it. */
178
218
  get label(): string;
179
219
  /** The pieces the next send carries (see the class note). A seat failure throws {@link PeerSeatFailure}. */
@@ -188,6 +228,14 @@ export declare class PeerCarrier {
188
228
  /** Whether the pieces a stdio child was started with have stopped being good. */
189
229
  expired(now?: number): boolean;
190
230
  private ask;
231
+ /**
232
+ * THE one intake of a seat's answer: every credential value it hands ({@link answeredCredentialValues}) is a value the engine now
233
+ * holds — no child spawned on this host inherits a variable holding it — and a credential of this connection's sends
234
+ * ({@link PeerCarrier.credentials}). Asked of the answer as given, before it is judged, and of the judge's copy of an accepted answer
235
+ * (the pieces that are sent). Each value is held on its own, so one that cannot be withheld (the value of a variable every child is
236
+ * handed) does not keep the others out; the answer is then refused, after the rest were held.
237
+ */
238
+ private holdAnswered;
191
239
  private remember;
192
240
  }
193
241
  /**
@@ -226,8 +274,15 @@ export declare function declaredCredentials(copy: object, at: keyof typeof CREDE
226
274
  export declare function peerSeatMissing(subject: string, credentials: CredentialRef | undefined, seat: PeerSeat | undefined): (Error & {
227
275
  code: string;
228
276
  }) | undefined;
277
+ /** A carrier's identity: the peer the seat is asked about, or a server on a host-supplied transport — whose host seat carries its own
278
+ * pieces, so the peer seat is never asked about it (its carrier carries nothing). */
279
+ export type PeerCarrierIdentity = PeerSeatTarget | {
280
+ readonly protocol: "mcp";
281
+ readonly server: string;
282
+ readonly transport: "host";
283
+ };
229
284
  /** Who an MCP server is, as the seat is asked about it: its name, the whole start command or endpoint, its reference, its mount identity. */
230
- export declare function mcpPeerTarget(spec: McpServerSpec, kind: "stdio" | "http" | undefined): PeerSeatTarget;
285
+ export declare function mcpPeerTarget(spec: McpServerSpec, kind: McpTransportKind | undefined): PeerCarrierIdentity;
231
286
  /** Whether a failure is the HTTP endpoint answering 401 (the SDK's status error, on the thrown value or its cause chain). Structure only. */
232
287
  export declare function answeredUnauthorized(err: unknown): boolean;
233
288
  /** A call answered 401 after which the seat's re-ask answered other pieces: its failure as it would have been thrown then. */
@@ -1,10 +1,42 @@
1
1
  import { createHash } from "node:crypto";
2
- import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
2
+ import { types } from "node:util";
3
+ import { SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
4
+ import { canonicalize } from "./canonical-json.js";
3
5
  import { readCredentialRef } from "@sema-agent/primitives";
4
- import { readMember } from "./thrown-value.js";
5
- import { resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
6
- import { holdOwnCredentialValues, isSecretEnvKey } from "./secret-env.js";
6
+ import { callerText } from "./mcp-server-spec.js";
7
+ import { optionKeys, strayMembersOf } from "./own-property-receipt.js";
8
+ import { readMember, readOwnMembers } from "./thrown-value.js";
9
+ import { httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
10
+ import { credentialHeaderValues, holdOwnCredentialValues, isSecretEnvKey, namesASecret } from "./secret-env.js";
7
11
  import { inlineUntrusted } from "./untrusted-text.js";
12
+ const PEER_SEAT_MEMBERS = Object.freeze(["answer", "hold", "release"]);
13
+ export function receivePeerSeat(raw, subject) {
14
+ if (raw === undefined)
15
+ return undefined;
16
+ const refuse = (problem) => Object.assign(new Error(`${subject} ${problem} — the peer seat is an object { answer(question, signal), hold(ref), release(ref) }`), { code: "config.invalid_argument" });
17
+ if (typeof raw === "function")
18
+ throw refuse("is a function (the answer alone): put it under `answer` and add `hold` / `release`");
19
+ if (typeof raw !== "object" || raw === null || types.isProxy(raw))
20
+ throw refuse(raw === null ? "is null" : typeof raw !== "object" ? `is a ${typeof raw}` : "is a Proxy");
21
+ const read = Object.create(null);
22
+ for (const name of PEER_SEAT_MEMBERS) {
23
+ let member;
24
+ try {
25
+ member = Reflect.get(raw, name);
26
+ }
27
+ catch {
28
+ throw refuse(`threw while its \`${name}\` was read`);
29
+ }
30
+ if (typeof member !== "function")
31
+ throw refuse(`has no \`${name}\` function`);
32
+ read[name] = member;
33
+ }
34
+ return Object.freeze({
35
+ answer: (question, signal) => Reflect.apply(read.answer, raw, [question, signal]),
36
+ hold: (ref) => Reflect.apply(read.hold, raw, [ref]),
37
+ release: (ref) => Reflect.apply(read.release, raw, [ref]),
38
+ });
39
+ }
8
40
  export const PEER_ANSWER_LANES = Object.freeze({ http: "headers", a2a: "headers", stdio: "env" });
9
41
  export const PEER_SEAT_WAIT_MS = 30_000;
10
42
  export const AUTHORIZATION_URL_MAX = 2048;
@@ -110,14 +142,15 @@ export class PeerSeatFailure extends Error {
110
142
  this.code = extra?.code ?? (reason === "answer_invalid" ? "config.peer_answer_invalid" : undefined);
111
143
  }
112
144
  }
113
- export class PeerAuthorizationRefused extends StreamableHTTPError {
145
+ export class PeerAuthorizationRefused extends SdkHttpError {
114
146
  reason;
115
147
  resourceMetadataUrl;
116
148
  authorizeUrl;
117
149
  renewed;
118
150
  constructor(reason, facts) {
119
151
  const lead = reason === "rejected" ? "the endpoint refused the request's authorization (HTTP 401)" : "the endpoint refused the request for insufficient scope (HTTP 403)";
120
- super(reason === "rejected" ? 401 : 403, facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead);
152
+ const text = facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead;
153
+ super(reason === "rejected" ? SdkErrorCode.ClientHttpAuthentication : SdkErrorCode.ClientHttpForbidden, text, { status: reason === "rejected" ? 401 : 403 });
121
154
  this.name = "PeerAuthorizationRefused";
122
155
  this.reason = reason;
123
156
  this.resourceMetadataUrl = facts.resourceMetadataUrl;
@@ -137,26 +170,33 @@ export function refusedThenRenewed(err) {
137
170
  }
138
171
  const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
139
172
  const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
140
- const VALUE_BREAK = /[\r\n\0]/;
141
- const ANSWER_MEMBERS = { carry: ["kind", "headers", "env", "expiresAt"], unauthorized: ["kind", "authorizeUrl"] };
173
+ const VALUE_LAW = Object.freeze({
174
+ headers: Object.freeze({ refuses: /[^\t\x20-\x7e\x80-\xff]/, holds: "a character an HTTP header value cannot carry" }),
175
+ env: Object.freeze({ refuses: /[\r\n\0]|\p{Surrogate}/u, holds: "a line break, a NUL or a lone surrogate" }),
176
+ });
177
+ const ANSWER_MEMBERS = Object.freeze({
178
+ carry: optionKeys()({ kind: 0, headers: 0, env: 0, expiresAt: 0 }),
179
+ unauthorized: optionKeys()({ kind: 0, authorizeUrl: 0 }),
180
+ });
142
181
  const digestOf = (pieces) => {
143
182
  const rows = (m) => Object.entries(m ?? {}).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
144
183
  return createHash("sha256").update(JSON.stringify([rows(pieces.headers), rows(pieces.env)])).digest("hex");
145
184
  };
146
185
  const NO_PIECES = Object.freeze({ digest: digestOf({}) });
147
186
  function nameValues(raw, member) {
148
- if (typeof raw !== "object" || raw === null || Array.isArray(raw))
187
+ const members = readOwnMembers(raw);
188
+ if (members === undefined)
149
189
  return `its ${member} is not a record of names to strings`;
150
190
  const out = Object.create(null);
151
191
  const folded = new Set();
152
- for (const name of Object.keys(raw)) {
153
- const value = raw[name];
192
+ for (const name of Object.keys(members)) {
193
+ const value = members[name];
154
194
  if (typeof value !== "string")
155
195
  return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} is not a string`;
156
196
  if (!(member === "headers" ? HEADER_NAME : ENV_NAME).test(name))
157
197
  return `its ${member} name ${inlineUntrusted(JSON.stringify(name), 80)} is not a ${member === "headers" ? "header" : "variable"} name`;
158
- if (VALUE_BREAK.test(value))
159
- return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} holds a line break or NUL`;
198
+ if (VALUE_LAW[member].refuses.test(value))
199
+ return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} holds ${VALUE_LAW[member].holds}`;
160
200
  if (member === "headers") {
161
201
  if (folded.has(name.toLowerCase()))
162
202
  return `its headers name ${inlineUntrusted(JSON.stringify(name), 80)} twice (header names are case-insensitive)`;
@@ -171,30 +211,31 @@ export function readPeerAnswer(raw, lane) {
171
211
  if (typeof raw !== "object" || raw === null || Array.isArray(raw))
172
212
  return { problem: "answered something that is not an answer record" };
173
213
  const record = raw;
174
- const kind = record["kind"];
214
+ const memberOf = (name) => (Object.hasOwn(record, name) ? record[name] : undefined);
215
+ const kind = memberOf("kind");
175
216
  if (kind !== "carry" && kind !== "unauthorized")
176
217
  return { problem: `answered the kind ${inlineUntrusted(JSON.stringify(kind) ?? String(kind), 80)}, which is neither "carry" nor "unauthorized"` };
177
- const extra = Object.keys(record).find((key) => !ANSWER_MEMBERS[kind].includes(key));
218
+ const extra = strayMembersOf(record, { subject: "the peer seat's answer", unit: "member", moment: "when the answer is read" }, ANSWER_MEMBERS[kind])?.names[0];
178
219
  if (extra !== undefined)
179
- return { problem: `answered the member ${inlineUntrusted(JSON.stringify(extra), 80)}, which a "${kind}" answer does not have` };
220
+ return { problem: `answered the member ${inlineUntrusted(JSON.stringify(String(extra)), 80)}, which a "${kind}" answer does not have` };
180
221
  if (kind === "unauthorized") {
181
- const raw = record["authorizeUrl"];
182
- if (raw === undefined)
222
+ const given = memberOf("authorizeUrl");
223
+ if (given === undefined)
183
224
  return { unauthorized: {} };
184
- const url = authorizationUrlOf(raw);
225
+ const url = authorizationUrlOf(given);
185
226
  if (url === undefined)
186
227
  return { problem: `answered an authorizeUrl that is not an absolute http(s) URL without user-info, of at most ${AUTHORIZATION_URL_MAX} characters, without control characters` };
187
228
  return { unauthorized: { authorizeUrl: url } };
188
229
  }
189
230
  const own = PEER_ANSWER_LANES[lane];
190
231
  const other = own === "headers" ? "env" : "headers";
191
- if (record[other] !== undefined)
232
+ if (memberOf(other) !== undefined)
192
233
  return { problem: `answered ${other} for a ${lane} peer, which carries ${own} only` };
193
- const expiresAt = record["expiresAt"];
194
- if (expiresAt !== undefined && (typeof expiresAt !== "number" || !Number.isFinite(expiresAt)))
195
- return { problem: "answered an expiresAt that is not a finite epoch-millisecond number" };
196
- const given = record[own];
197
- const values = given === undefined ? undefined : nameValues(given, own);
234
+ const expiresAt = memberOf("expiresAt");
235
+ if (expiresAt !== undefined && (typeof expiresAt !== "number" || !Number.isFinite(expiresAt) || expiresAt < 0))
236
+ return { problem: "answered an expiresAt that is not a finite, non-negative epoch-millisecond number" };
237
+ const carried = memberOf(own);
238
+ const values = carried === undefined ? undefined : nameValues(carried, own);
198
239
  if (typeof values === "string")
199
240
  return { problem: `answered ${values}` };
200
241
  const lanePieces = values === undefined ? {} : { [own]: values };
@@ -204,6 +245,86 @@ export function readPeerAnswer(raw, lane) {
204
245
  return { problem: "answered a record whose members could not be read" };
205
246
  }
206
247
  }
248
+ function dataMember(holder, key) {
249
+ if (typeof holder !== "object" || holder === null || types.isProxy(holder))
250
+ return undefined;
251
+ const descriptor = Object.getOwnPropertyDescriptor(holder, key);
252
+ return descriptor !== undefined && Object.hasOwn(descriptor, "value") ? descriptor.value : undefined;
253
+ }
254
+ function declaredReferences(declared) {
255
+ const refs = [];
256
+ for (const [list, path] of [[dataMember(declared, "mcp"), CREDENTIALS_MEMBER.mcp], [dataMember(declared, "a2a"), CREDENTIALS_MEMBER.a2a]]) {
257
+ if (!Array.isArray(list) || types.isProxy(list))
258
+ continue;
259
+ const length = dataMember(list, "length");
260
+ for (let index = 0; typeof length === "number" && index < length; index++) {
261
+ let at = dataMember(list, String(index));
262
+ for (const key of path)
263
+ at = dataMember(at, key);
264
+ if (at === undefined || (typeof at === "object" && at !== null && types.isProxy(at)))
265
+ continue;
266
+ const read = readCredentialRef(at);
267
+ if (read.ok)
268
+ refs.push(read.ref);
269
+ }
270
+ }
271
+ return refs;
272
+ }
273
+ export function holdPeerDeclarations(seat, declared, onFault) {
274
+ let released = false;
275
+ const holds = [];
276
+ const fault = (member, ref) => onFault(new Error(`the deployment's peer seat threw from \`${member}\` for a "${ref.kind}" reference${member === "hold" ? " — the reference is not held" : ""}`));
277
+ const call = (member, ref) => {
278
+ let returned;
279
+ try {
280
+ returned = seat[member](ref);
281
+ }
282
+ catch {
283
+ fault(member, ref);
284
+ return false;
285
+ }
286
+ if (typeof returned?.then !== "function")
287
+ return true;
288
+ return Promise.resolve(returned).then(() => true, () => (fault(member, ref), false));
289
+ };
290
+ if (seat !== undefined) {
291
+ const seen = new Set();
292
+ for (const ref of declaredReferences(declared)) {
293
+ const key = canonicalize(ref);
294
+ if (seen.has(key))
295
+ continue;
296
+ seen.add(key);
297
+ const outcome = call("hold", ref);
298
+ if (outcome === false)
299
+ continue;
300
+ if (outcome === true) {
301
+ holds.push(() => void call("release", ref));
302
+ continue;
303
+ }
304
+ let releaseAsked = false;
305
+ let fulfilled = false;
306
+ void outcome.then((ok) => {
307
+ fulfilled = ok;
308
+ if (ok && releaseAsked)
309
+ void call("release", ref);
310
+ });
311
+ holds.push(() => {
312
+ releaseAsked = true;
313
+ if (fulfilled)
314
+ void call("release", ref);
315
+ });
316
+ }
317
+ }
318
+ return {
319
+ release() {
320
+ if (released)
321
+ return;
322
+ released = true;
323
+ for (const releaseOne of holds.splice(0))
324
+ releaseOne();
325
+ },
326
+ };
327
+ }
207
328
  async function askBounded(seat, question, signal) {
208
329
  signal?.throwIfAborted();
209
330
  const wait = new AbortController();
@@ -213,7 +334,7 @@ async function askBounded(seat, question, signal) {
213
334
  try {
214
335
  const stopped = new Promise((_, reject) => stop.addEventListener("abort", () => reject(stop.reason), { once: true }));
215
336
  stopped.catch(() => undefined);
216
- return { answer: await Promise.race([seat(question, stop), stopped]) };
337
+ return { answer: await Promise.race([seat.answer(question, stop), stopped]) };
217
338
  }
218
339
  catch (err) {
219
340
  if (signal?.aborted === true)
@@ -230,6 +351,7 @@ export class PeerCarrier {
230
351
  principal;
231
352
  lane;
232
353
  sent = [];
354
+ credentials = [];
233
355
  expiresAt;
234
356
  renewed = false;
235
357
  asked = false;
@@ -278,40 +400,66 @@ export class PeerCarrier {
278
400
  return this.expiresAt !== undefined && now >= this.expiresAt;
279
401
  }
280
402
  async ask(cause, signal, destination) {
281
- if (this.seat === undefined)
403
+ const identity = this.identity;
404
+ if (this.seat === undefined || (identity.protocol === "mcp" && identity.transport === "host"))
282
405
  return NO_PIECES;
283
- const peer = this.identity.protocol === "a2a" && destination !== undefined ? { ...this.identity, destination } : this.identity;
406
+ const peer = identity.protocol === "a2a" && destination !== undefined ? { ...identity, destination } : identity;
284
407
  const asked = await askBounded(this.seat, { peer, ...(this.principal !== undefined ? { principal: this.principal } : {}), cause }, signal);
285
408
  if ("failed" in asked)
286
409
  throw new PeerSeatFailure(asked.failed, this.label, asked.failed === "timed_out" ? `did not answer within ${PEER_SEAT_WAIT_MS} ms` : "threw");
410
+ this.holdAnswered(asked.answer);
287
411
  const read = readPeerAnswer(asked.answer, this.lane);
288
412
  if ("problem" in read)
289
413
  throw new PeerSeatFailure("answer_invalid", this.label, read.problem);
290
414
  if ("unauthorized" in read)
291
415
  throw new PeerSeatFailure("unauthorized", this.label, "answered that this principal is not authorized", read.unauthorized.authorizeUrl === undefined ? undefined : { authorizeUrl: read.unauthorized.authorizeUrl });
292
416
  const pieces = read.carry;
293
- if (pieces.env !== undefined) {
294
- const held = Object.entries(pieces.env).filter(([name, value]) => isSecretEnvKey(name, value)).map(([, value]) => value);
295
- try {
296
- holdOwnCredentialValues(held);
297
- }
298
- catch {
299
- throw new PeerSeatFailure("answer_invalid", this.label, "answered an environment value that is the value of a variable every child on this host is handed");
300
- }
301
- for (const value of held)
417
+ this.holdAnswered(pieces);
418
+ for (const [name, value] of Object.entries(pieces.env ?? {}))
419
+ if (isSecretEnvKey(name, value))
302
420
  this.remember(value);
303
- }
304
421
  if (this.lane === "stdio")
305
422
  this.expiresAt = pieces.expiresAt;
306
423
  for (const value of Object.values(pieces.headers ?? {}))
307
424
  this.remember(value);
308
425
  return pieces;
309
426
  }
427
+ holdAnswered(answer) {
428
+ let refused;
429
+ for (const value of answeredCredentialValues(answer)) {
430
+ try {
431
+ holdOwnCredentialValues([value]);
432
+ }
433
+ catch (err) {
434
+ refused ??= err instanceof Error ? err.message : "the value of a variable every child on this host is handed";
435
+ }
436
+ if (namesASecret(value) && !this.credentials.includes(value))
437
+ this.credentials.push(value);
438
+ }
439
+ if (refused !== undefined)
440
+ throw new PeerSeatFailure("answer_invalid", this.label, `answered a credential value the engine cannot withhold (${inlineUntrusted(refused, 240)})`);
441
+ }
310
442
  remember(value) {
311
443
  if (value !== "" && !this.sent.includes(value))
312
444
  this.sent.push(value);
313
445
  }
314
446
  }
447
+ function answeredCredentialValues(answer) {
448
+ const found = new Set();
449
+ const members = readOwnMembers(answer) ?? {};
450
+ for (const [name, value] of stringMembers(members["headers"])) {
451
+ for (const sent of new Set([value, httpTrimmed(value)]))
452
+ for (const credential of credentialHeaderValues({ [name]: sent }))
453
+ found.add(credential);
454
+ }
455
+ for (const [name, value] of stringMembers(members["env"]))
456
+ if (isSecretEnvKey(name, value))
457
+ found.add(value);
458
+ return [...found];
459
+ }
460
+ function stringMembers(record) {
461
+ return Object.entries(readOwnMembers(record) ?? {}).filter((entry) => typeof entry[1] === "string");
462
+ }
315
463
  export function carriedHttpHeaders(protocol, carrier, pieces, principalHeader, principal) {
316
464
  try {
317
465
  return resolveProtocolHttpHeaders(protocol, { ...(pieces.headers !== undefined ? { headers: { ...pieces.headers } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) }, principal);
@@ -337,7 +485,7 @@ export function peerFetch(carrier, principalHeader, principal) {
337
485
  return res;
338
486
  const challenge = bearerChallengeParams(res.headers.get("www-authenticate"));
339
487
  if (res.status === 403 && challenge?.get("error") !== "insufficient_scope")
340
- return res;
488
+ return unchallenged(res);
341
489
  const resourceMetadataUrl = authorizationUrlOf(challenge?.get("resource_metadata"));
342
490
  const body = init?.method === "POST" ? await bodyHead(res, REFUSAL_BODY_MAX) : void (await res.body?.cancel().catch(() => undefined));
343
491
  const reask = res.status === 401 ? await carrier.rejected(pieces, signal) : undefined;
@@ -349,6 +497,13 @@ export function peerFetch(carrier, principalHeader, principal) {
349
497
  });
350
498
  };
351
499
  }
500
+ function unchallenged(res) {
501
+ if (!res.headers.has("www-authenticate"))
502
+ return res;
503
+ const headers = new Headers(res.headers);
504
+ headers.delete("www-authenticate");
505
+ return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
506
+ }
352
507
  export const RETIRED_VALUE_MEMBERS = Object.freeze({ mcp: Object.freeze([Object.freeze(["transport", "headers"]), Object.freeze(["transport", "env"])]), a2a: Object.freeze([Object.freeze(["headers"])]) });
353
508
  export function retiredValueMember(copy, at) {
354
509
  for (const path of RETIRED_VALUE_MEMBERS[at]) {
@@ -372,7 +527,7 @@ export function declaredCredentials(copy, at) {
372
527
  if (read.ok)
373
528
  return { ref: read.ref };
374
529
  const p = read.problem;
375
- return { problem: `${p.reason}${"kind" in p && p.kind !== undefined ? ` (kind ${JSON.stringify(p.kind)})` : ""}${"field" in p ? ` at ${JSON.stringify(p.field)}` : ""}` };
530
+ return { problem: `${p.reason}${"kind" in p && p.kind !== undefined ? ` (kind ${callerText(p.kind)})` : ""}${"field" in p ? ` at ${JSON.stringify(p.field)}` : ""}` };
376
531
  }
377
532
  export function peerSeatMissing(subject, credentials, seat) {
378
533
  if (credentials === undefined || seat !== undefined)
@@ -381,8 +536,10 @@ export function peerSeatMissing(subject, credentials, seat) {
381
536
  }
382
537
  export function mcpPeerTarget(spec, kind) {
383
538
  const t = spec.transport;
539
+ if (kind === "host")
540
+ return { protocol: "mcp", server: spec.name, transport: "host" };
384
541
  const fingerprint = typeof spec.fingerprint === "string" ? { fingerprint: spec.fingerprint } : {};
385
- const credentials = t.credentials !== undefined ? { credentials: t.credentials } : {};
542
+ const credentials = "credentials" in t && t.credentials !== undefined ? { credentials: t.credentials } : {};
386
543
  if (kind === "stdio" && "command" in t)
387
544
  return { protocol: "mcp", server: spec.name, transport: "stdio", command: t.command, args: [...(t.args ?? [])], ...credentials, ...fingerprint };
388
545
  return { protocol: "mcp", server: spec.name, transport: "http", url: "url" in t ? t.url : "", ...credentials, ...fingerprint };
@@ -390,7 +547,7 @@ export function mcpPeerTarget(spec, kind) {
390
547
  export function answeredUnauthorized(err) {
391
548
  let at = err;
392
549
  for (let depth = 0; depth < 6 && at instanceof Error; depth++) {
393
- if (at instanceof StreamableHTTPError && at.code === 401)
550
+ if (at instanceof SdkHttpError && at.status === 401)
394
551
  return true;
395
552
  at = at.cause;
396
553
  }
@@ -546,14 +546,22 @@ export declare function redeemRuleTicket(opts: {
546
546
  export declare const IMPORTED_SETTINGS_LAYERS: readonly ["userSettings", "projectSettings", "localSettings"];
547
547
  /** The three user-editable settings layers this version reads. */
548
548
  export type ImportedSettingsLayer = (typeof IMPORTED_SETTINGS_LAYERS)[number];
549
- /** One layer to read. `root` is the canonical directory a project-layer rule is scoped to — taken from
550
- * where the FILE actually lives, since the local layer is not always at a repository root. */
551
- export interface CcImportLayer {
552
- layer: ImportedSettingsLayer;
549
+ /** One layer to read — a union by `layer`, so a member is present exactly where it is read. A project or local layer
550
+ * carries `root`: the canonical directory its rules are scoped to, taken from where the FILE actually lives, since the
551
+ * local layer is not always at a repository root. The user layer carries none — a root handed for it does not compile:
552
+ * its rules import as global rules, which read `/x` at each task's project root, so nothing here reads that layer's own
553
+ * directory, and an entry written against it stays in the settings file ({@link prepareCcImport}). */
554
+ export type CcImportLayer = {
555
+ layer: "userSettings";
556
+ path: string;
557
+ root?: never;
558
+ readFile: (path: string) => Promise<string | undefined>;
559
+ } | {
560
+ layer: Exclude<ImportedSettingsLayer, "userSettings">;
553
561
  path: string;
554
562
  root: string;
555
563
  readFile: (path: string) => Promise<string | undefined>;
556
- }
564
+ };
557
565
  /**
558
566
  * What the import WOULD do, shown before anyone confirms.
559
567
  *
@@ -567,27 +575,6 @@ export interface ImportPreview {
567
575
  rule: string;
568
576
  reason: string;
569
577
  }>;
570
- /**
571
- * ALWAYS EMPTY in this version — a compatibility seat (RL-1336-import-translated), kept on the wire shape so an existing reader
572
- * keeps finding the key (removing a wire field would break readers for no gain).
573
- *
574
- * The seat once carried the entries whose MATCH FORM was rewritten on the way in (the space-star
575
- * suggestion form of the other product translated to this lane's colon-star form, one row per
576
- * translated candidate with its `scope`). That translation is retired: the space-star wildcard is
577
- * now a first-class match form of this lane's own grammar, so an entry's match form imports as the
578
- * file states it — `Bash(npm run *)` lands as `Bash(npm run *)`, never as a colon-star — and nothing
579
- * is ever pushed here. What `candidates` carries is the grammar's CANONICAL re-projection of each
580
- * entry (the parser folds spacing: `Bash(npm<TAB>run *)` lands as `Bash(npm run *)`); that is the
581
- * ordinary normalization every rule text in this lane undergoes, the same one the store applies,
582
- * and not a translation this seat reports. An entry whose star placement has no rule form is
583
- * refused into `skipped` under `unsupported.wildcard`, named as the file writes it. A reader
584
- * rendering a "rewritten spellings" column from this seat renders an empty column, correctly.
585
- */
586
- translated: Array<{
587
- from: string;
588
- to: string;
589
- scope: RuleScope;
590
- }>;
591
578
  layers: Array<{
592
579
  path: string;
593
580
  layer: ImportedSettingsLayer;
@@ -648,6 +635,14 @@ export type RedeemedBatchMember = {
648
635
  * being escorted by a shell into a bare tool-name ask that widens `Bash(rm -r:*)` into "every Bash call
649
636
  * asks". An entry that does not import (a spelling with no rule form, a tool the lane does not speak
650
637
  * for, a non-string) is DISCLOSED in `skipped` with its reason and stays in the settings file.
638
+ *
639
+ * Only a rule the store reads the way its layer does is carried. A bare tool name is not (`unsupported.form`), and
640
+ * neither is a user-layer path pattern written from `/` (`unsupported.layer_root`, every behavior): the user layer reads
641
+ * it at its own directory (the configuration directory), a stored global rule reads `/x` at each task's project root, and
642
+ * no stored row has a seat for the layer's directory. `//abs`, `~/`, relative and non-path entries of the user layer carry
643
+ * as global rules; a project or local layer's `/x` carries, scoped to that layer's `root` (a project row reads `/x` there).
644
+ * A user layer handed a `root` refuses the whole call before any layer is read (`config.invalid_argument`, `detail.field`
645
+ * `layers[<i>].root`; the value is not echoed).
651
646
  */
652
647
  export declare function prepareCcImport(opts: {
653
648
  layers: CcImportLayer[];