@sema-agent/core 7.59.0 → 7.60.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 (360) hide show
  1. package/CHANGELOG.md +564 -0
  2. package/dist/agents/agent-definition.d.ts +7 -0
  3. package/dist/agents/agent-definition.js +12 -0
  4. package/dist/agents/agent-transcript-tool.d.ts +2 -1
  5. package/dist/agents/agent-transcript-tool.js +3 -1
  6. package/dist/agents/child-model-seat.js +6 -3
  7. package/dist/agents/cumulative-stats.js +0 -1
  8. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  9. package/dist/agents/inherited-tool-pool.js +22 -0
  10. package/dist/agents/retain-ledger.d.ts +11 -1
  11. package/dist/agents/retain-ledger.js +13 -2
  12. package/dist/agents/roster-store.d.ts +1 -1
  13. package/dist/agents/roster-store.js +3 -1
  14. package/dist/agents/send-message-tool.d.ts +8 -19
  15. package/dist/agents/send-message-tool.js +11 -38
  16. package/dist/agents/subagent.d.ts +51 -17
  17. package/dist/agents/subagent.js +117 -78
  18. package/dist/agents/tool-filter.d.ts +1 -3
  19. package/dist/agents/tool-filter.js +4 -12
  20. package/dist/bench/metrics.d.ts +3 -5
  21. package/dist/bench/metrics.js +0 -1
  22. package/dist/brain/degrading.js +3 -1
  23. package/dist/brain/route-adjudicator.js +3 -1
  24. package/dist/brain/status-sink.d.ts +7 -1
  25. package/dist/brain/status-sink.js +6 -0
  26. package/dist/brain/timeout.d.ts +3 -1
  27. package/dist/brain/timeout.js +18 -5
  28. package/dist/core/a2a.d.ts +15 -5
  29. package/dist/core/a2a.js +34 -19
  30. package/dist/core/agent-definition.d.ts +20 -0
  31. package/dist/core/allow-entry.d.ts +2 -0
  32. package/dist/core/allow-entry.js +3 -1
  33. package/dist/core/artifact-host.d.ts +0 -2
  34. package/dist/core/artifact-host.js +0 -1
  35. package/dist/core/auto-mode-defaults.d.ts +8 -0
  36. package/dist/core/auto-mode-defaults.js +1 -0
  37. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  38. package/dist/core/auto-mode.d.ts +39 -4
  39. package/dist/core/auto-mode.js +63 -12
  40. package/dist/core/background-agent-store.d.ts +10 -1
  41. package/dist/core/background-agent-store.js +3 -2
  42. package/dist/core/background-shell.d.ts +12 -1
  43. package/dist/core/background-shell.js +12 -0
  44. package/dist/core/checkpoint-store.d.ts +8 -13
  45. package/dist/core/checkpoint-store.js +4 -3
  46. package/dist/core/compliance.d.ts +1 -1
  47. package/dist/core/credential-echo.d.ts +52 -0
  48. package/dist/core/credential-echo.js +65 -0
  49. package/dist/core/credential-vocabulary.d.ts +13 -3
  50. package/dist/core/credential-vocabulary.js +12 -4
  51. package/dist/core/cross-boundary-taint.d.ts +4 -5
  52. package/dist/core/engine-notice.d.ts +58 -15
  53. package/dist/core/frame-settlement.d.ts +5 -0
  54. package/dist/core/frame-settlement.js +4 -0
  55. package/dist/core/gate-fold.js +7 -5
  56. package/dist/core/gate-lanes.js +39 -8
  57. package/dist/core/governance-codes.d.ts +9 -1
  58. package/dist/core/governance-codes.js +12 -0
  59. package/dist/core/hands-band-screen.js +0 -1
  60. package/dist/core/hands-band.d.ts +0 -3
  61. package/dist/core/hooks.d.ts +39 -56
  62. package/dist/core/hooks.js +123 -77
  63. package/dist/core/image-admission.d.ts +104 -51
  64. package/dist/core/image-admission.js +170 -46
  65. package/dist/core/image-downsample.d.ts +36 -69
  66. package/dist/core/image-downsample.js +111 -73
  67. package/dist/core/integer-option.d.ts +21 -0
  68. package/dist/core/integer-option.js +13 -0
  69. package/dist/core/locked-config.d.ts +54 -3
  70. package/dist/core/locked-config.js +81 -50
  71. package/dist/core/mcp-call-meta.d.ts +2 -2
  72. package/dist/core/mcp-call-meta.js +9 -10
  73. package/dist/core/mcp-failure.d.ts +9 -3
  74. package/dist/core/mcp-failure.js +10 -0
  75. package/dist/core/mcp-host-seat.d.ts +92 -0
  76. package/dist/core/mcp-host-seat.js +131 -0
  77. package/dist/core/mcp-probe.d.ts +7 -2
  78. package/dist/core/mcp-probe.js +7 -2
  79. package/dist/core/mcp-server-spec.d.ts +38 -9
  80. package/dist/core/mcp-server-spec.js +55 -21
  81. package/dist/core/mcp.d.ts +17 -6
  82. package/dist/core/mcp.js +67 -55
  83. package/dist/core/memory-admission.d.ts +23 -6
  84. package/dist/core/memory-admission.js +19 -9
  85. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  86. package/dist/core/memory-engine/content-origin.js +21 -3
  87. package/dist/core/memory-engine/index.d.ts +2 -1
  88. package/dist/core/memory-engine/index.js +2 -1
  89. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  90. package/dist/core/memory-engine/scope-contract.js +2 -2
  91. package/dist/core/memory-engine/sync-client.d.ts +45 -11
  92. package/dist/core/memory-engine/sync-client.js +82 -11
  93. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  94. package/dist/core/memory-engine/sync-report.js +119 -0
  95. package/dist/core/memory-engine/sync.d.ts +4 -2
  96. package/dist/core/mode-policy.d.ts +9 -1
  97. package/dist/core/mode-policy.js +11 -1
  98. package/dist/core/model-receipt.d.ts +39 -0
  99. package/dist/core/model-receipt.js +139 -0
  100. package/dist/core/mods/agent-stations.d.ts +65 -0
  101. package/dist/core/mods/agent-stations.js +105 -0
  102. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  103. package/dist/core/mods/kernel/dispatch.js +4 -4
  104. package/dist/core/mods/kernel/events.d.ts +10 -4
  105. package/dist/core/mods/kernel/events.js +10 -6
  106. package/dist/core/mods/kernel/receive.d.ts +5 -0
  107. package/dist/core/mods/kernel/receive.js +10 -0
  108. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  109. package/dist/core/mods/lifecycle-stations.js +35 -0
  110. package/dist/core/mods/stations.d.ts +51 -59
  111. package/dist/core/mods/stations.js +32 -42
  112. package/dist/core/mods/tool-call.d.ts +10 -4
  113. package/dist/core/mods/tool-call.js +28 -12
  114. package/dist/core/mounted-mcp.d.ts +5 -0
  115. package/dist/core/mounted-mcp.js +2 -2
  116. package/dist/core/namespaced-rule-name.d.ts +7 -1
  117. package/dist/core/namespaced-rule-name.js +13 -2
  118. package/dist/core/oracle-isolation.js +1 -1
  119. package/dist/core/own-property-receipt.d.ts +3 -0
  120. package/dist/core/own-property-receipt.js +3 -0
  121. package/dist/core/park-selfcheck.js +8 -8
  122. package/dist/core/peer-seat.d.ts +63 -8
  123. package/dist/core/peer-seat.js +179 -34
  124. package/dist/core/permission-rule-consent.d.ts +0 -21
  125. package/dist/core/permission-rule-consent.js +1 -2
  126. package/dist/core/permission-rule-model.d.ts +4 -2
  127. package/dist/core/permission-rule-model.js +7 -6
  128. package/dist/core/protocol-http-auth.d.ts +14 -2
  129. package/dist/core/protocol-http-auth.js +16 -7
  130. package/dist/core/read-face-seats.d.ts +7 -5
  131. package/dist/core/read-face-seats.js +4 -1
  132. package/dist/core/redaction-marks.d.ts +4 -3
  133. package/dist/core/redaction-marks.js +2 -2
  134. package/dist/core/remote-env.d.ts +146 -98
  135. package/dist/core/remote-env.js +113 -14
  136. package/dist/core/retention.js +37 -12
  137. package/dist/core/retired-keys.d.ts +6 -1
  138. package/dist/core/retired-keys.js +4 -1
  139. package/dist/core/rewrite-rejudge.d.ts +12 -5
  140. package/dist/core/rewrite-rejudge.js +9 -5
  141. package/dist/core/roles.d.ts +37 -3
  142. package/dist/core/roles.js +126 -78
  143. package/dist/core/rule-owner.d.ts +3 -0
  144. package/dist/core/runner/assemble-result.d.ts +0 -5
  145. package/dist/core/runner/assemble-result.js +0 -1
  146. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  147. package/dist/core/runner/call-hook-stations.js +21 -10
  148. package/dist/core/runner/child-tree.d.ts +7 -8
  149. package/dist/core/runner/child-tree.js +6 -6
  150. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  151. package/dist/core/runner/classifier-ladder.js +39 -8
  152. package/dist/core/runner/construction-doors.js +5 -0
  153. package/dist/core/runner/contracts.d.ts +62 -41
  154. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  155. package/dist/core/runner/cross-boundary-lane.js +11 -2
  156. package/dist/core/runner/env-capability-census.d.ts +15 -20
  157. package/dist/core/runner/env-capability-census.js +25 -34
  158. package/dist/core/runner/file-history-request.d.ts +2 -2
  159. package/dist/core/runner/file-history-request.js +0 -8
  160. package/dist/core/runner/gate-exit.d.ts +75 -7
  161. package/dist/core/runner/gate-exit.js +20 -1
  162. package/dist/core/runner/git-status-frame.d.ts +5 -2
  163. package/dist/core/runner/git-status-frame.js +3 -4
  164. package/dist/core/runner/image.d.ts +7 -2
  165. package/dist/core/runner/image.js +14 -8
  166. package/dist/core/runner/inline-image.d.ts +10 -8
  167. package/dist/core/runner/inline-image.js +11 -9
  168. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  169. package/dist/core/runner/permission-rule-lanes.js +1 -1
  170. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  171. package/dist/core/runner/prepare-boundary-parks.js +3 -3
  172. package/dist/core/runner/prepare-caps-and-workflow.d.ts +4 -0
  173. package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
  174. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  175. package/dist/core/runner/prepare-config-doors.js +14 -9
  176. package/dist/core/runner/prepare-delegation-surface.d.ts +5 -3
  177. package/dist/core/runner/prepare-delegation-surface.js +4 -4
  178. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  179. package/dist/core/runner/prepare-file-history.js +3 -12
  180. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  181. package/dist/core/runner/prepare-gate-stations.js +4 -3
  182. package/dist/core/runner/prepare-hands-readface.d.ts +3 -1
  183. package/dist/core/runner/prepare-hands-readface.js +15 -7
  184. package/dist/core/runner/prepare-inherited-gate.d.ts +5 -4
  185. package/dist/core/runner/prepare-inherited-gate.js +9 -5
  186. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  187. package/dist/core/runner/prepare-memory.d.ts +2 -2
  188. package/dist/core/runner/prepare-memory.js +2 -2
  189. package/dist/core/runner/prepare-park-ask.d.ts +3 -5
  190. package/dist/core/runner/prepare-park-ask.js +3 -8
  191. package/dist/core/runner/prepare-policy-chain.d.ts +5 -4
  192. package/dist/core/runner/prepare-policy-chain.js +120 -108
  193. package/dist/core/runner/prepare-project-context.js +8 -5
  194. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -1
  195. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  196. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  197. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  198. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  199. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  200. package/dist/core/runner/prepare-task.js +41 -27
  201. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  202. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  203. package/dist/core/runner/prepare-wiring-manifest.d.ts +4 -3
  204. package/dist/core/runner/prepare-wiring-manifest.js +32 -18
  205. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  206. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  207. package/dist/core/runner/retired-runner-deps.js +4 -1
  208. package/dist/core/runner/run-attachment-seats.js +3 -3
  209. package/dist/core/runner/run-brain-sinks.js +1 -0
  210. package/dist/core/runner/run-git-lane.d.ts +3 -1
  211. package/dist/core/runner/run-git-lane.js +1 -1
  212. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  213. package/dist/core/runner/run-harness-handlers.js +3 -1
  214. package/dist/core/runner/run-identity-wiring.js +1 -1
  215. package/dist/core/runner/run-leg.js +26 -28
  216. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  217. package/dist/core/runner/run-notification-lane.js +16 -10
  218. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  219. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  220. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  221. package/dist/core/runner/run-turn-boundary.js +12 -7
  222. package/dist/core/runner/runtask.d.ts +7 -4
  223. package/dist/core/runner/runtask.js +19 -11
  224. package/dist/core/runner/skills-seat.js +2 -2
  225. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  226. package/dist/core/runner/synthetic-tools.js +2 -2
  227. package/dist/core/runner/tool-disclosure.js +0 -2
  228. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  229. package/dist/core/runner/tool-face-overlay.js +26 -19
  230. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  231. package/dist/core/runner/tool-result-media-seat.js +17 -1
  232. package/dist/core/runner/turn-attachments.d.ts +3 -5
  233. package/dist/core/runner/turn-attachments.js +3 -16
  234. package/dist/core/runner-deps.d.ts +31 -18
  235. package/dist/core/secret-env.d.ts +3 -2
  236. package/dist/core/session-policy-store.d.ts +9 -2
  237. package/dist/core/session-policy-store.js +16 -1
  238. package/dist/core/session-store.d.ts +3 -2
  239. package/dist/core/session-store.js +50 -11
  240. package/dist/core/skill-grant.d.ts +9 -0
  241. package/dist/core/skill-grant.js +18 -0
  242. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  243. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  244. package/dist/core/stub-env.d.ts +5 -5
  245. package/dist/core/stub-env.js +11 -1
  246. package/dist/core/swappable-deps.d.ts +17 -43
  247. package/dist/core/swappable-deps.js +15 -5
  248. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  249. package/dist/core/task-event.d.ts +18 -2
  250. package/dist/core/task-notification.d.ts +88 -5
  251. package/dist/core/task-notification.js +130 -7
  252. package/dist/core/task-registry-agent.d.ts +18 -12
  253. package/dist/core/task-registry-agent.js +18 -6
  254. package/dist/core/task-registry-monitor.d.ts +7 -0
  255. package/dist/core/task-registry-monitor.js +28 -1
  256. package/dist/core/task-registry-shared.d.ts +38 -3
  257. package/dist/core/task-registry-shared.js +21 -7
  258. package/dist/core/task-registry-workflow.js +1 -1
  259. package/dist/core/task-registry.d.ts +50 -35
  260. package/dist/core/task-registry.js +64 -23
  261. package/dist/core/task-result.d.ts +3 -12
  262. package/dist/core/task-spec.d.ts +3 -6
  263. package/dist/core/task-stream.d.ts +1 -1
  264. package/dist/core/tool-catalog-entries.js +1 -1
  265. package/dist/core/tool-face-reader.d.ts +7 -6
  266. package/dist/core/tool-face-reader.js +4 -3
  267. package/dist/core/tool-name-aliases.d.ts +19 -0
  268. package/dist/core/tool-name-aliases.js +54 -2
  269. package/dist/core/tool-policy.d.ts +5 -4
  270. package/dist/core/tool-policy.js +1 -1
  271. package/dist/core/tool-registry.d.ts +5 -5
  272. package/dist/core/tool-registry.js +2 -2
  273. package/dist/core/tool-result-store.d.ts +88 -5
  274. package/dist/core/tool-result-store.js +51 -12
  275. package/dist/core/tool-spec.d.ts +20 -4
  276. package/dist/core/trace.d.ts +0 -1
  277. package/dist/core/types.d.ts +3 -3
  278. package/dist/core/types.js +1 -1
  279. package/dist/core/untrusted-text.js +1 -1
  280. package/dist/core/user-attachment.d.ts +10 -5
  281. package/dist/core/user-attachment.js +14 -6
  282. package/dist/engine/execution-env/node-execution-env.d.ts +7 -2
  283. package/dist/engine/execution-env/node-execution-env.js +12 -1
  284. package/dist/engine/harness/agent-harness.d.ts +1 -1
  285. package/dist/engine/harness/agent-harness.js +8 -4
  286. package/dist/engine/harness/types.d.ts +112 -29
  287. package/dist/engine/loop/agent-loop.d.ts +12 -12
  288. package/dist/engine/loop/agent-loop.js +153 -21
  289. package/dist/engine/loop/types.d.ts +9 -2
  290. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  291. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  292. package/dist/index.d.ts +22 -14
  293. package/dist/index.js +15 -10
  294. package/dist/internal/harness-types.d.ts +1 -1
  295. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  296. package/dist/orchestration/run-workflow-tool.js +59 -29
  297. package/dist/orchestration/workflow-governance.d.ts +1 -1
  298. package/dist/orchestration/workflow-governance.js +2 -1
  299. package/dist/orchestration/workflow.d.ts +4 -0
  300. package/dist/orchestration/workflow.js +25 -4
  301. package/dist/prompts/default.d.ts +1 -10
  302. package/dist/prompts/default.js +0 -2
  303. package/dist/stores/file/background-agent-store.d.ts +1 -1
  304. package/dist/stores/file/background-agent-store.js +3 -1
  305. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  306. package/dist/stores/file/checkpoint-store.js +19 -14
  307. package/dist/stores/file/file-history-store.d.ts +1 -1
  308. package/dist/stores/file/file-history-store.js +3 -1
  309. package/dist/stores/file/index.d.ts +4 -3
  310. package/dist/stores/file/index.js +17 -8
  311. package/dist/stores/file/mailbox-store.d.ts +1 -1
  312. package/dist/stores/file/mailbox-store.js +3 -1
  313. package/dist/stores/file/memory-store.d.ts +1 -1
  314. package/dist/stores/file/memory-store.js +3 -1
  315. package/dist/stores/file/session-policy-store.d.ts +1 -1
  316. package/dist/stores/file/session-policy-store.js +3 -1
  317. package/dist/stores/file/session-store.d.ts +1 -1
  318. package/dist/stores/file/session-store.js +3 -1
  319. package/dist/stores/file/shared-ledger.d.ts +26 -0
  320. package/dist/stores/file/shared-ledger.js +38 -9
  321. package/dist/stores/file/tool-result-store.d.ts +20 -2
  322. package/dist/stores/file/tool-result-store.js +74 -6
  323. package/dist/stores/file/usage-window-store.d.ts +1 -1
  324. package/dist/stores/file/usage-window-store.js +3 -1
  325. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  326. package/dist/stores/file/workflow-journal-store.js +3 -2
  327. package/dist/tools/fs/containment-face.d.ts +5 -0
  328. package/dist/tools/fs/encoding.d.ts +13 -4
  329. package/dist/tools/fs/encoding.js +17 -2
  330. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  331. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  332. package/dist/tools/fs/fs-bash.d.ts +8 -4
  333. package/dist/tools/fs/fs-bash.js +26 -35
  334. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  335. package/dist/tools/fs/fs-pdf.js +26 -21
  336. package/dist/tools/fs/fs-read.d.ts +5 -4
  337. package/dist/tools/fs/fs-read.js +35 -18
  338. package/dist/tools/fs/fs-search-tools.js +4 -1
  339. package/dist/tools/fs/fs-shared.d.ts +11 -13
  340. package/dist/tools/fs/fs-shared.js +11 -7
  341. package/dist/tools/fs/fs-write.js +5 -5
  342. package/dist/tools/fs/index.d.ts +14 -8
  343. package/dist/tools/fs/index.js +8 -4
  344. package/dist/tools/fs/read-floor.d.ts +44 -1
  345. package/dist/tools/fs/read-floor.js +35 -0
  346. package/dist/tools/fs/removal-targets.d.ts +9 -4
  347. package/dist/tools/fs/removal-targets.js +17 -9
  348. package/dist/tools/fs/search.d.ts +3 -3
  349. package/dist/tools/fs/search.js +4 -4
  350. package/dist/tools/monitor.d.ts +5 -4
  351. package/dist/tools/monitor.js +15 -8
  352. package/dist/tools/scheduler-tools.js +42 -4
  353. package/dist/tools/web.d.ts +0 -10
  354. package/dist/tools/web.js +1 -4
  355. package/package.json +4 -2
  356. package/test/export-surface.snapshot.json +75 -21
  357. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  358. package/wire-changes/core@7.60.0.json +3274 -0
  359. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  360. package/wire-changes/primitives@7.60.0.json +30 -0
package/dist/core/mcp.js CHANGED
@@ -2,7 +2,8 @@ import { __resetEnvKnobAnnouncements } from "./env-knob-announce.js";
2
2
  import { resolveEnvBudget } from "./env-budget.js";
3
3
  import { MCP_NAMESPACE } from "./protocol-table.js";
4
4
  import { remoteWords, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
5
- import { PeerCarrier, Reauthorized, answeredUnauthorized, carrierOf, inFlight, mcpPeerTarget, peerFetch, peerSeatMissing, recordCarrier, refusedThenRenewed, sentOnceMore, settledInFlight } from "./peer-seat.js";
5
+ import { NO_CREDENTIAL_ECHO, carrierEcho, echoAnnouncer, echoedToolDrop, erasedEcho, serverInfoOf } from "./credential-echo.js";
6
+ import { PeerCarrier, Reauthorized, answeredUnauthorized, carrierOf, inFlight, mcpPeerTarget, peerFetch, peerSeatMissing, receivePeerSeat, recordCarrier, refusedThenRenewed, sentOnceMore, settledInFlight } from "./peer-seat.js";
6
7
  import { disposeSectionEntry, sectionAnswerWarning } from "./prompt-section-seat.js";
7
8
  import { createToolNameClaims, mintNamespacePrefix, normalizeNameSegment } from "./protocol-naming.js";
8
9
  import { mcpToolDropReason, refuseCollidingMcpServerNames } from "./mcp-name-judge.js";
@@ -20,9 +21,12 @@ import { tmpdir } from "node:os";
20
21
  import { join } from "node:path";
21
22
  import { CallToolResultSchema, ElicitRequestSchema, ErrorCode, ListResourcesResultSchema, McpError } from "@modelcontextprotocol/sdk/types.js";
22
23
  import { DEFAULT_REQUEST_TIMEOUT_MSEC } from "@modelcontextprotocol/sdk/shared/protocol.js";
23
- import { MCP_IMAGE_MAX_BASE64, sharpImageResizer } from "./image-downsample.js";
24
+ import { resolveImageProcessor } from "./image-downsample.js";
25
+ import { admitImageBytes, IMAGE_ADMISSION, unprocessedSizeClause } from "./image-admission.js";
24
26
  import { sliceHeadSafe, sliceTailSafe } from "./surrogate-safe-slice.js";
25
27
  import { truncateError } from "./tool-errors.js";
28
+ import { transportKindOf } from "./mcp-server-spec.js";
29
+ import { HostSeatTransport, hostSeatLine, hostSeatMissing, hostSeatVerdictOf } from "./mcp-host-seat.js";
26
30
  import { peerRequestRefusal } from "./host-floor.js";
27
31
  import { delimitUntrusted, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
28
32
  import { discloseReminderShaped, observeReminderMarkEcho } from "./reminder-disclosure.js";
@@ -172,6 +176,9 @@ function sanitizeMcpErrorTextInPlace(err, declared) {
172
176
  err.message = sanitized;
173
177
  }
174
178
  function namedMcpFailureText(err, declared) {
179
+ const seat = hostSeatVerdictOf(err);
180
+ if (seat !== undefined)
181
+ return seat.condition;
175
182
  const detail = remoteErrorText(err, declared, { collapse: true });
176
183
  const condition = thrownIs(err, McpError) ? describeMcpSpecErrorCode(readMember(err, "code")) : undefined;
177
184
  return condition !== undefined ? `${condition}: ${detail}` : detail;
@@ -250,9 +257,13 @@ function rethrowHonestMcpError(err, ctx) {
250
257
  finish(markMcpFailure(new Error(unauthorizedLine(ctx.what, serverLabel, failure.authorization, refusedThenRenewed(err) && ctx.attempt !== "resent", writeEffectWarning(ctx.writeEffect)), { cause: err }), details()));
251
258
  case "credential_unavailable":
252
259
  finish(markMcpFailure(new Error(`${ctx.what} was not sent to MCP server "${serverLabel}": ${inlineUntrusted(thrownText(err), 400)}. The request was not delivered, so the server did not execute it. This is the deployment's credential seat, not the server — do not retry the call until it is fixed; use an alternative if one exists.`), details()));
260
+ case "host_refused":
253
261
  case "spawn_failed":
254
262
  case "invalid_config":
255
263
  case "unknown": {
264
+ const seat = hostSeatVerdictOf(err);
265
+ if (seat !== undefined)
266
+ finish(markMcpFailure(new Error(hostSeatLine(ctx.what, serverLabel, seat, writeEffectWarning(ctx.writeEffect)), { cause: err }), details()));
256
267
  if (ctx.attributeServer) {
257
268
  finish(markMcpFailure(new Error(`${ctx.what} on MCP server "${serverLabel}" failed. The server's error text follows as external/untrusted data:\n${fenceServerText(`${ctx.server} error`, remoteErrorText(err, ctx.declared))}`, { cause: err }), details()));
258
269
  }
@@ -326,26 +337,24 @@ async function blobToTextBlock(base64Data, mimeType, server, prefix, refetchHint
326
337
  }
327
338
  return { type: "text", text: `${prefix}Binary content (${mt}, ${r.bytes} bytes) saved to ${r.filePath}` };
328
339
  }
329
- async function boundedImageBlock(data, mimeType, server, resizer) {
330
- if (data.length <= MCP_IMAGE_MAX_BASE64)
340
+ async function boundedImageBlock(data, mimeType, server, processor) {
341
+ const admitted = await admitImageBytes(Buffer.from(data, "base64"), mimeType, processor);
342
+ if (admitted.ok)
343
+ return admitted.block;
344
+ const over = admitted.reason === "raw_too_large"
345
+ ? `over the ${admitted.cap}-byte read cap`
346
+ : admitted.reason === "dimensions_too_large"
347
+ ? unprocessedSizeClause(admitted)
348
+ : admitted.reason === "base64_too_large"
349
+ ? `base64 ${admitted.base64.length} chars after processing exceeds the ${IMAGE_ADMISSION.hard.imageBase64Chars}-char API image limit`
350
+ : undefined;
351
+ if (over === undefined)
331
352
  return { type: "image", data, mimeType };
332
- if (resizer) {
333
- const resized = await resizer(data, mimeType).catch(() => undefined);
334
- if (resized && resized.base64.length <= MCP_IMAGE_MAX_BASE64) {
335
- return { type: "image", data: resized.base64, mimeType: resized.mimeType };
336
- }
337
- }
338
353
  const r = await persistMcpBlob(data, mimeType, server);
339
354
  if ("error" in r) {
340
- return {
341
- type: "text",
342
- text: `[image (${mimeType}): too large to inline (${r.bytes} bytes; base64 ${data.length} chars exceeds the 5MB API image limit) and could not be saved to disk: ${r.error} — image omitted]`,
343
- };
355
+ return { type: "text", text: `[image (${mimeType}): too large to inline (${r.bytes} bytes; ${over}) and could not be saved to disk: ${r.error} — image omitted]` };
344
356
  }
345
- return {
346
- type: "text",
347
- text: `[image (${mimeType}): too large to inline (${r.bytes} bytes; base64 ${data.length} chars exceeds the 5MB API image limit) — saved to ${r.filePath}]`,
348
- };
357
+ return { type: "text", text: `[image (${mimeType}): too large to inline (${r.bytes} bytes; ${over}) — saved to ${r.filePath}]` };
349
358
  }
350
359
  export function inferCompactSchema(value, depth = 2) {
351
360
  if (value === null)
@@ -365,8 +374,10 @@ export function inferCompactSchema(value, depth = 2) {
365
374
  }
366
375
  return typeof value;
367
376
  }
368
- function buildTransport(spec, principal, kind, carrier, pieces) {
377
+ function buildTransport(spec, principal, kind, carrier, pieces, hostSeat) {
369
378
  const t = spec.transport;
379
+ if (kind === "host")
380
+ return new HostSeatTransport(hostSeat, spec.name);
370
381
  if (kind === "stdio") {
371
382
  if (!("command" in t))
372
383
  throw new Error(`MCP server "${spec.name}": transport kind "stdio" carries no command`);
@@ -381,9 +392,8 @@ function buildTransport(spec, principal, kind, carrier, pieces) {
381
392
  resolveProtocolHttpHeaders(MCP_NAMESPACE.id, t.principalHeader !== undefined ? { principalHeader: t.principalHeader } : {}, principal);
382
393
  return new SessionEndingTransport(new URL(t.url), { fetch: peerFetch(carrier, t.principalHeader, principal) });
383
394
  }
384
- let autoResizer;
385
- export async function mapContent(content, serverName, imageResizer) {
386
- const resizer = imageResizer ?? (await (autoResizer ??= sharpImageResizer()));
395
+ export async function mapContent(content, serverName, imageProcessor) {
396
+ const processor = await resolveImageProcessor(imageProcessor);
387
397
  const out = [];
388
398
  for (const item of content ?? []) {
389
399
  if (item.type === "text" && typeof item.text === "string") {
@@ -392,7 +402,7 @@ export async function mapContent(content, serverName, imageResizer) {
392
402
  else if (item.type === "image") {
393
403
  const data = typeof item.data === "string" ? item.data : "";
394
404
  const mimeType = typeof item.mimeType === "string" ? item.mimeType : "";
395
- out.push(data !== "" && mimeType !== "" ? await boundedImageBlock(data, mimeType, serverName, resizer) : { type: "image", data, mimeType });
405
+ out.push(data !== "" && mimeType !== "" ? await boundedImageBlock(data, mimeType, serverName, processor) : { type: "image", data, mimeType });
396
406
  }
397
407
  else if (item.type === "audio" && typeof item.data === "string" && item.data) {
398
408
  out.push(await blobToTextBlock(item.data, item.mimeType, serverName, `[Audio from ${serverName ?? "MCP server"}] `));
@@ -406,7 +416,7 @@ export async function mapContent(content, serverName, imageResizer) {
406
416
  out.push({ type: "text", text: `[resource${r.uri ? ` ${r.uri}` : ""}]\n${r.text}` });
407
417
  }
408
418
  else if (r.blob && r.mimeType && r.mimeType.startsWith("image/")) {
409
- out.push(await boundedImageBlock(r.blob, r.mimeType, serverName, resizer));
419
+ out.push(await boundedImageBlock(r.blob, r.mimeType, serverName, processor));
410
420
  }
411
421
  else if (r.blob) {
412
422
  out.push(await blobToTextBlock(r.blob, r.mimeType, serverName, `[resource${r.uri ? ` ${r.uri}` : ""}] `, ` — data not inlined; it can be re-fetched via ${READ_MCP_RESOURCE}${r.uri ? ` (uri ${r.uri})` : ""}.`));
@@ -643,10 +653,10 @@ export function mcpToolSchemaProblem(schema) {
643
653
  }
644
654
  return undefined;
645
655
  }
646
- export async function materializeMcpTools(specs, principal, onElicit, imageResizer, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired) {
647
- return materializeLegMcpTools(undefined, specs, principal, onElicit, imageResizer, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired);
656
+ export async function materializeMcpTools(specs, principal, onElicit, imageProcessor, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired, hostSeats, onCredentialEchoed) {
657
+ return materializeLegMcpTools(undefined, specs, principal, onElicit, imageProcessor, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, receivePeerSeat(peerSeat, "materializeMcpTools peerSeat"), onAuthorizationRequired, hostSeats, onCredentialEchoed);
648
658
  }
649
- export async function materializeLegMcpTools(seat, ...[specs, principal, onElicit, imageResizer, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired]) {
659
+ export async function materializeLegMcpTools(seat, ...[specs, principal, onElicit, imageProcessor, reminderDisclosure, mcpRevocations, poolOpts, promptSections, dialable, signal, hostFloor, peerSeat, onAuthorizationRequired, hostSeats, onCredentialEchoed]) {
650
660
  const snapshot = snapshotMcpEntries(specs);
651
661
  const axesRefused = new WeakMap();
652
662
  const entries = snapshot.map((spec) => {
@@ -701,6 +711,7 @@ export async function materializeLegMcpTools(seat, ...[specs, principal, onElici
701
711
  catch {
702
712
  }
703
713
  };
714
+ const announceEcho = echoAnnouncer(onCredentialEchoed);
704
715
  const failedStatus = (spec, err, dialKind, declared) => {
705
716
  const { failure, exchange } = readMcpFailure(err, { phase: "connect", transport: dialKind });
706
717
  const liveness = livenessOf(exchange, Date.now());
@@ -767,21 +778,13 @@ export async function materializeLegMcpTools(seat, ...[specs, principal, onElici
767
778
  statuses[sIdx] = s.status;
768
779
  return raised;
769
780
  };
770
- const readDialKind = (spec) => {
771
- try {
772
- const kind = spec.transport.kind;
773
- return kind === "stdio" || kind === "http" ? kind : undefined;
774
- }
775
- catch {
776
- return undefined;
777
- }
778
- };
781
+ const readDialKind = transportKindOf;
779
782
  const dialKinds = entries.map(readDialKind);
780
783
  const liveOf = (server) => serverHandles.find((h) => h.name === server);
781
784
  const gatesNow = (h) => {
782
785
  const latest = h.listing.latest();
783
786
  if (latest.at !== h.gatesAt.at)
784
- h.gatesAt = { at: latest.at, gates: intakeListedTools({ tools: [...latest.entries], unproven: latest.unproven }, h.spec, linkOf(h.name), echoOf(h.spec), imageResizer, mcpDisclosure, isServerRevoked, h.transportKind, seat).gates };
787
+ h.gatesAt = { at: latest.at, gates: intakeListedTools({ tools: [...latest.entries], unproven: latest.unproven }, h.spec, linkOf(h.name), echoOf(h.spec), imageProcessor, mcpDisclosure, isServerRevoked, h.transportKind, seat, echoReadOf(h.spec)).gates };
785
788
  return h.gatesAt.gates;
786
789
  };
787
790
  const linkOf = (server) => ({
@@ -803,26 +806,28 @@ export async function materializeLegMcpTools(seat, ...[specs, principal, onElici
803
806
  return peerRequestRefusal(`mcp: server "${inlineUntrusted(spec.name, 120)}"`, url, hostFloor);
804
807
  };
805
808
  const dialServer = async (spec, dialKind, dialOpts) => {
806
- const refusal = axesRefused.get(spec) ?? peerSeatMissing(`mcp: server "${inlineUntrusted(spec.name, 120)}"`, spec.transport.credentials, peerSeat) ?? endpointRefusal(spec, dialKind);
809
+ const hostSeat = dialKind === "host" ? hostSeats?.get(spec.name) : undefined;
810
+ const refusal = axesRefused.get(spec) ?? peerSeatMissing(`mcp: server "${inlineUntrusted(spec.name, 120)}"`, "credentials" in spec.transport ? spec.transport.credentials : undefined, peerSeat) ?? endpointRefusal(spec, dialKind) ?? (dialKind === "host" && hostSeat === undefined ? hostSeatMissing(spec.name) : undefined);
807
811
  if (refusal !== undefined)
808
812
  throw refusal;
809
813
  const carrier = new PeerCarrier(peerSeat, mcpPeerTarget(spec, dialKind), principal, dialKind === "stdio" ? "stdio" : "http", dialKind !== "stdio" && "principalHeader" in spec.transport && spec.transport.principalHeader !== undefined);
810
- sentOf.set(spec.name, carrier.sent);
811
- const dial = () => connectServer(spec, principal, onElicit, imageResizer, mcpDisclosure, isServerRevoked, dialKind, poolOpts?.pool, { ...dialOpts, link: linkOf(spec.name), carrier, ...(signal !== undefined ? { signal } : {}) }, seat);
814
+ dialedBy.set(spec.name, carrier);
815
+ const dial = () => connectServer(spec, principal, onElicit, imageProcessor, mcpDisclosure, isServerRevoked, dialKind, poolOpts?.pool, { ...dialOpts, link: linkOf(spec.name), carrier, announceEcho: (where) => announceEcho(spec.name, where), ...(signal !== undefined ? { signal } : {}), ...(hostSeat !== undefined ? { hostSeat } : {}) }, seat);
812
816
  const connected = await dial().catch(async (err) => {
813
817
  if (typeof err === "object" && err !== null)
814
- sentOf.set(spec.name, (carrierOf(err) ?? carrier).sent);
818
+ dialedBy.set(spec.name, carrierOf(err) ?? carrier);
815
819
  const dialing = (typeof err === "object" && err !== null ? carrierOf(err) : undefined) ?? carrier;
816
820
  if (!(dialing.renewed && answeredUnauthorized(err)) || signal?.aborted === true)
817
821
  throw err;
818
822
  return dial();
819
823
  });
820
- sentOf.set(spec.name, (carrierOf(connected.client) ?? carrier).sent);
824
+ dialedBy.set(spec.name, carrierOf(connected.client) ?? carrier);
821
825
  return connected;
822
826
  };
823
827
  const prefixOf = (name) => mintNamespacePrefix(MCP_NAMESPACE, name);
824
- const sentOf = new Map();
825
- const echoOf = (spec) => sentOf.get(spec.name) ?? [];
828
+ const dialedBy = new Map();
829
+ const echoOf = (spec) => dialedBy.get(spec.name)?.sent ?? [];
830
+ const echoReadOf = (spec) => carrierEcho(dialedBy.get(spec.name) ?? NO_CREDENTIAL_ECHO, (where) => announceEcho(spec.name, where));
826
831
  const heldCount = (name) => serverHandles.find((h) => h.name === name)?.tools.length ?? 0;
827
832
  const reconcileInstructions = (name, after, connected) => {
828
833
  if (!connected)
@@ -987,7 +992,7 @@ export async function materializeLegMcpTools(seat, ...[specs, principal, onElici
987
992
  results.push({ server: h.name, prefix: prefixOf(h.name), status: "failed", toolCount: h.tools.length, added: [], removed: [], error: "a later listing of this server was opened and applied while this one was in the air — this one was discarded" });
988
993
  continue;
989
994
  }
990
- const { serverTools, serverAxes, gates, dropped, accepted } = intakeListedTools({ tools: [...mergedRaw], unproven: answered.unproven }, h.spec, linkOf(h.name), echoOf(h.spec), imageResizer, mcpDisclosure, isServerRevoked, h.transportKind, seat);
995
+ const { serverTools, serverAxes, gates, dropped, accepted } = intakeListedTools({ tools: [...mergedRaw], unproven: answered.unproven }, h.spec, linkOf(h.name), echoOf(h.spec), imageProcessor, mcpDisclosure, isServerRevoked, h.transportKind, seat, echoReadOf(h.spec));
991
996
  cacheTools(accepted, answered.kept);
992
997
  const priorNames = h.tools.map((t) => t.name);
993
998
  const newNames = serverTools.map((t) => t.name);
@@ -1569,7 +1574,7 @@ async function listToolsLenient(client, options, declared) {
1569
1574
  });
1570
1575
  return { tools: walk.items, ...(walk.incomplete !== undefined ? { incomplete: walk.incomplete } : {}) };
1571
1576
  }
1572
- async function connectServer(spec, principal, onElicit, imageResizer, reminderDisclosure, isServerRevoked, transportKind, pool, dialOpts, seat) {
1577
+ async function connectServer(spec, principal, onElicit, imageProcessor, reminderDisclosure, isServerRevoked, transportKind, pool, dialOpts, seat) {
1573
1578
  const fp = spec.fingerprint;
1574
1579
  if (fp !== undefined && !(typeof fp === "string" && fp.length > 0 && fp.length <= 128)) {
1575
1580
  throw Object.assign(new Error(`MCP server "${inlineUntrusted(spec.name, 160)}": fingerprint must be a non-empty string of at most 128 characters (got ${typeof fp === "string" ? `${fp.length} characters` : typeof fp}) — not dialed`), { code: "config.mcp_fingerprint_invalid" });
@@ -1603,7 +1608,7 @@ async function connectServer(spec, principal, onElicit, imageResizer, reminderDi
1603
1608
  });
1604
1609
  }
1605
1610
  const pieces = transportKind === "stdio" ? await dialOpts.carrier.next(stop) : undefined;
1606
- const transport = buildTransport(spec, principal, transportKind, dialOpts.carrier, pieces);
1611
+ const transport = buildTransport(spec, principal, transportKind, dialOpts.carrier, pieces, dialOpts.hostSeat);
1607
1612
  const hangUp = () => void client.close().catch(() => undefined);
1608
1613
  stop?.addEventListener("abort", hangUp, { once: true });
1609
1614
  try {
@@ -1621,7 +1626,8 @@ async function connectServer(spec, principal, onElicit, imageResizer, reminderDi
1621
1626
  recordCarrier(client, dialOpts.carrier);
1622
1627
  return client;
1623
1628
  };
1624
- const lease = pool !== undefined && !elicitOn ? await pool.acquire(McpConnectionPool.keyOf(spec, principal, transportKind, startupMs), dialClient, dialOpts) : undefined;
1629
+ const answersOneLeg = elicitOn || transportKind === "host";
1630
+ const lease = pool !== undefined && !answersOneLeg ? await pool.acquire(McpConnectionPool.keyOf(spec, principal, transportKind, startupMs), dialClient, dialOpts) : undefined;
1625
1631
  const client = lease !== undefined ? lease.client : await dialClient();
1626
1632
  const close = () => (lease !== undefined ? lease.release() : client.close());
1627
1633
  const openListing = () => {
@@ -1641,9 +1647,10 @@ async function connectServer(spec, principal, onElicit, imageResizer, reminderDi
1641
1647
  const at = listing.open();
1642
1648
  const cacheTools = openListing();
1643
1649
  const declared = (carrierOf(client) ?? dialOpts.carrier).sent;
1650
+ const echo = carrierEcho(carrierOf(client) ?? dialOpts.carrier, dialOpts.announceEcho);
1644
1651
  const listed = await underStartupBound(startupMs, dialOpts?.signal, (options) => listToolsLenient(client, options, declared));
1645
1652
  const answered = listing.answer(at, listed.tools, listed.incomplete !== undefined, dialOpts.carried);
1646
- const { serverTools, serverAxes, gates, dropped, advisories, accepted } = intakeListedTools({ tools: [...answered.view], unproven: answered.unproven }, spec, dialOpts.link, declared, imageResizer, reminderDisclosure, isServerRevoked, transportKind, seat);
1653
+ const { serverTools, serverAxes, gates, dropped, advisories, accepted } = intakeListedTools({ tools: [...answered.view], unproven: answered.unproven }, spec, dialOpts.link, declared, imageProcessor, reminderDisclosure, isServerRevoked, transportKind, seat, echo);
1647
1654
  cacheTools(accepted, answered.kept);
1648
1655
  const caps = client.getServerCapabilities();
1649
1656
  const resourceInfo = caps?.resources
@@ -1652,15 +1659,15 @@ async function connectServer(spec, principal, onElicit, imageResizer, reminderDi
1652
1659
  readAllowed: !spec.allowTools || spec.allowTools.includes(MCP_RESOURCE_READ_ALLOW),
1653
1660
  }
1654
1661
  : undefined;
1655
- const rawInstructions = client.getInstructions();
1662
+ const rawInstructions = erasedEcho(client.getInstructions(), echo, "instructions");
1656
1663
  const sanitized = rawInstructions && rawInstructions.trim() ? sanitizeUntrustedText(rawInstructions.trim()) : undefined;
1657
1664
  const disposed = sanitized === undefined ? undefined : await disposeSectionEntry(dialOpts?.sections, { section: "core/discovery.mcp-instructions", server: spec.name, text: sanitized, mountedTools: serverTools.map((t) => t.name) });
1658
1665
  const instructions = disposed?.kept === undefined ? undefined : { server: spec.name, ...disposed.kept };
1659
- const info = client.getServerVersion();
1666
+ const info = serverInfoOf(client.getServerVersion(), echo);
1660
1667
  const status = {
1661
1668
  name: spec.name,
1662
1669
  status: "connected",
1663
- ...(info ? { serverInfo: { name: info.name, version: info.version } } : {}),
1670
+ ...(info ? { serverInfo: info } : {}),
1664
1671
  toolNames: serverTools.map((t) => t.name),
1665
1672
  liveness: livenessOf("completed", Date.now()),
1666
1673
  };
@@ -1691,7 +1698,7 @@ async function connectServer(spec, principal, onElicit, imageResizer, reminderDi
1691
1698
  throw err;
1692
1699
  }
1693
1700
  }
1694
- function intakeListedTools(listed, spec, link, declared, imageResizer, reminderDisclosure, isServerRevoked, transportKind, seat) {
1701
+ function intakeListedTools(listed, spec, link, declared, imageProcessor, reminderDisclosure, isServerRevoked, transportKind, seat, echo = NO_CREDENTIAL_ECHO) {
1695
1702
  const declaredContentOrigin = spec.contentOrigin;
1696
1703
  const serverTools = [];
1697
1704
  const serverAxes = [];
@@ -1704,11 +1711,16 @@ function intakeListedTools(listed, spec, link, declared, imageResizer, reminderD
1704
1711
  if (spec.allowTools && !spec.allowTools.includes(t.name)) {
1705
1712
  continue;
1706
1713
  }
1714
+ const echoDrop = echoedToolDrop(t.name, t.inputSchema, echo);
1715
+ if (echoDrop !== undefined) {
1716
+ dropped.push(echoDrop);
1717
+ continue;
1718
+ }
1707
1719
  let modelFacingSchema;
1708
1720
  let sanitizedDescription;
1709
1721
  try {
1710
1722
  modelFacingSchema = sanitizeMcpModelFacingValue(t.inputSchema);
1711
- sanitizedDescription = t.description !== undefined ? sanitizeMcpModelFacingText(t.description) : undefined;
1723
+ sanitizedDescription = t.description !== undefined ? sanitizeMcpModelFacingText(erasedEcho(t.description, echo, "tool_listing")) : undefined;
1712
1724
  }
1713
1725
  catch (err) {
1714
1726
  const reason = err instanceof McpPayloadKeyCollision
@@ -1844,7 +1856,7 @@ function intakeListedTools(listed, spec, link, declared, imageResizer, reminderD
1844
1856
  const res = await callThroughLink(link, namespacedName, gate, signal, send, () => throwDeadServer(spec.name, what));
1845
1857
  if (typeof res === "string")
1846
1858
  return listingRefusal(res, remoteName, spec.name);
1847
- const mapped = await mapContent(res.content, spec.name, imageResizer);
1859
+ const mapped = await mapContent(res.content, spec.name, imageProcessor);
1848
1860
  if (res.isError === true) {
1849
1861
  const parts = [];
1850
1862
  for (const block of mapped) {
@@ -6,6 +6,26 @@ export interface MemoryScopeRequest {
6
6
  scope: string;
7
7
  origin: MemoryScopeOrigin;
8
8
  }
9
+ /** A deployment-origin org scope: the only kind an admission with no caller is asked about. */
10
+ export interface DeploymentMemoryScopeRequest extends MemoryScopeRequest {
11
+ origin: "deployment";
12
+ }
13
+ /**
14
+ * What the resolver is asked, discriminated by whether a caller asks. `principal` a string: the caller's principal name,
15
+ * and the request may hold scopes of either origin. `principal: undefined`: no caller — the door has already refused
16
+ * every request-origin scope, so only deployment-origin ones are asked about. Caller presence is read once, at the door
17
+ * (`readPrincipal`: absent = omitted or the empty string; a provided value that is no name is refused); a resolver reads
18
+ * this discriminant and never decides absence for itself.
19
+ */
20
+ export type MemoryScopeAdmissionInput = {
21
+ principal: string;
22
+ requested: ReadonlyArray<MemoryScopeRequest>;
23
+ requestedWriteScope: MemoryScopeRequest | null;
24
+ } | {
25
+ principal: undefined;
26
+ requested: ReadonlyArray<DeploymentMemoryScopeRequest>;
27
+ requestedWriteScope: DeploymentMemoryScopeRequest | null;
28
+ };
9
29
  /**
10
30
  * The resolver's verdict — exactly two states. `ok: true` carries the FROZEN admitted projection:
11
31
  * `scopes` must be a subset of the requested org scopes (an unrequested grant is a resolver fault ⇒
@@ -23,16 +43,13 @@ export type MemoryAdmissionVerdict = {
23
43
  /**
24
44
  * The trusted deployment resolver ({@link import("./types.js").RunnerDeps.memoryScopeAdmission}).
25
45
  * Receives ONLY the org-parsed scopes (non-org scopes are not its business), each tagged with its
26
- * origin, plus the run's principal. Both async and sync forms are accepted.
46
+ * origin, and the caller ({@link MemoryScopeAdmissionInput}). Both async and sync forms are accepted.
27
47
  */
28
- export type MemoryScopeAdmission = (input: {
29
- principal: string | undefined;
30
- requested: ReadonlyArray<MemoryScopeRequest>;
31
- requestedWriteScope: MemoryScopeRequest | null;
32
- }) => MemoryAdmissionVerdict | Promise<MemoryAdmissionVerdict>;
48
+ export type MemoryScopeAdmission = (input: MemoryScopeAdmissionInput) => MemoryAdmissionVerdict | Promise<MemoryAdmissionVerdict>;
33
49
  /** Inputs to {@link admitMemoryScopes} — assembled by the prepare path (prepare-memory.ts). */
34
50
  export interface MemoryAdmissionInput {
35
51
  memorySpec: NormalizedMemorySpec;
52
+ /** The task's principal as given (`TaskSpec.principal`); the door reads caller presence from it. */
36
53
  principal: string | undefined;
37
54
  admission: MemoryScopeAdmission | undefined;
38
55
  /** The deployment's self-certified org scopes (`RunnerDeps.deploymentMemoryScopes`). */
@@ -1,4 +1,5 @@
1
1
  import { parseScopeKey } from "./memory-engine/scope-contract.js";
2
+ import { readPrincipal } from "./principal-name.js";
2
3
  import { thrownText } from "./thrown-value.js";
3
4
  function codedError(code, message) {
4
5
  const e = new Error(message);
@@ -19,6 +20,22 @@ function orgScopesOf(spec) {
19
20
  const writeOrg = spec.writeScope !== null && parseScopeKey(spec.writeScope).kind === "org" ? spec.writeScope : null;
20
21
  return { readOrg, writeOrg };
21
22
  }
23
+ const isDeploymentRequest = (r) => r.origin === "deployment";
24
+ function admissionInputOf(principal, requested, requestedWriteScope) {
25
+ const copy = (r) => ({ ...r });
26
+ const caller = readPrincipal(principal);
27
+ if (caller.kind === "name")
28
+ return { principal: caller.name, requested: requested.map(copy), requestedWriteScope: requestedWriteScope && copy(requestedWriteScope) };
29
+ if (caller.kind === "invalid") {
30
+ throw codedError("memory.admission_denied", `the task's principal is not a principal name (got ${caller.fault}) — org memory admission takes a principal name or none.`);
31
+ }
32
+ const deployment = requested.filter(isDeploymentRequest);
33
+ const write = requestedWriteScope === null || isDeploymentRequest(requestedWriteScope) ? requestedWriteScope : undefined;
34
+ if (deployment.length === requested.length && write !== undefined)
35
+ return { principal: undefined, requested: deployment.map(copy), requestedWriteScope: write && copy(write) };
36
+ throw codedError("memory.admission_denied", `org memory scope(s) ${requested.filter((r) => !isDeploymentRequest(r)).map((r) => `"${r.scope}"`).join(", ")} require an authenticated ` +
37
+ `TaskSpec.principal for admission — a principal-less request cannot be admitted to a tenant plane.`);
38
+ }
22
39
  export async function admitMemoryScopes(input) {
23
40
  const { memorySpec, principal, admission, deploymentScopes, parentAdmittedOrgScopes } = input;
24
41
  const governed = admission !== undefined ||
@@ -109,17 +126,10 @@ export async function admitMemoryScopes(input) {
109
126
  writeScopeNarrowed: false,
110
127
  });
111
128
  }
112
- if (requestOrigin.length > 0 && principal === undefined) {
113
- throw codedError("memory.admission_denied", `org memory scope(s) ${requestOrigin.map((r) => `"${r.scope}"`).join(", ")} require an authenticated ` +
114
- `TaskSpec.principal for admission — a principal-less request cannot be admitted to a tenant plane.`);
115
- }
129
+ const asked = admissionInputOf(principal, requests, writeOrg !== null ? requests[allOrg.indexOf(writeOrg)] : null);
116
130
  let verdict;
117
131
  try {
118
- verdict = await admission({
119
- principal,
120
- requested: requests,
121
- requestedWriteScope: writeOrg !== null ? { scope: writeOrg, origin: originOf(writeOrg) } : null,
122
- });
132
+ verdict = await admission(asked);
123
133
  }
124
134
  catch (err) {
125
135
  const hinted = err.retryAfterMs;
@@ -34,6 +34,13 @@ export interface AgentToolFace {
34
34
  * level and this face does not exclude the delegation tool). Such a child can reach any SIBLING
35
35
  * face, so its own narrowing is not the boundary — see {@link delegationCallIsExternal}. */
36
36
  canRedelegate?: boolean;
37
+ /** The MCP servers a child of this type declares itself (its definition's `mcp`), each with the content class its declaration states:
38
+ * tools of the child's universe that no pool row carries — a server lists them only once the child dials it — so a face reaches one
39
+ * of them exactly when its lists can admit a tool of that server, and it is classified by the server's declaration. */
40
+ servers?: ReadonlyArray<{
41
+ readonly name: string;
42
+ readonly contentOrigin?: ToolContentOrigin;
43
+ }>;
37
44
  }
38
45
  /** One tool in the pool a delegated child draws from — enough to classify it, nothing more. */
39
46
  export interface AgentPoolTool {
@@ -78,6 +85,12 @@ export declare function delegationCallIsExternal(input: {
78
85
  pool: ReadonlyArray<AgentPoolTool> | undefined;
79
86
  /** Whether one pool tool carries a polluting class — the caller owns the deployment's config. */
80
87
  isPolluting: (tool: AgentPoolTool) => boolean;
88
+ /** The MCP servers the spawning run declares, when the delegation tool's children inherit its mount: one of them may hold its namespace
89
+ * over a face's own server of the same namespace ({@link AgentToolFace.servers}), so it is counted beside it. */
90
+ inheritedServers?: ReadonlyArray<{
91
+ readonly name: string;
92
+ readonly contentOrigin?: ToolContentOrigin;
93
+ }>;
81
94
  }): boolean;
82
95
  /** Whether a tool of `origin` pollutes the session's memory when invoked (strict = the
83
96
  * `execIsExternalContent` upgrade). */
@@ -1,4 +1,7 @@
1
- import { resolveToolSubset } from "../../agents/tool-filter.js";
1
+ import { compileToolSelector, resolveToolSubset, valveLeaves, valveLeavesPeer } from "../../agents/tool-filter.js";
2
+ import { MCP_RESOURCE_FACES } from "../mounted-mcp.js";
3
+ import { mintNamespacePrefix } from "../protocol-naming.js";
4
+ import { MCP_NAMESPACE } from "../protocol-table.js";
2
5
  const TOOL_CONTENT_ORIGIN_SET = { external: true, execution: true, local: true };
3
6
  export const TOOL_CONTENT_ORIGINS = Object.keys(TOOL_CONTENT_ORIGIN_SET);
4
7
  export function isToolContentOrigin(value) {
@@ -25,9 +28,24 @@ export function delegationCallIsExternal(input) {
25
28
  if (face === undefined)
26
29
  return true;
27
30
  const selectedFor = (f) => resolveToolSubset(input.pool, f.allowTools, f.denyTools);
28
- if (selectedFor(face).some((t) => input.isPolluting(t)))
31
+ const broughtBy = (f) => {
32
+ if (f.servers === undefined || f.servers.length === 0)
33
+ return [];
34
+ const own = f.servers;
35
+ const lists = compileToolSelector([{ ...(f.allowTools !== undefined ? { allow: f.allowTools } : {}), deny: f.denyTools ?? [] }]);
36
+ const peerLeft = valveLeavesPeer({}, lists);
37
+ const sameNamespace = (input.inheritedServers ?? []).filter((p) => own.some((s) => mintNamespacePrefix(MCP_NAMESPACE, s.name) === mintNamespacePrefix(MCP_NAMESPACE, p.name)));
38
+ const namespaces = [...own, ...sameNamespace].flatMap((s) => {
39
+ const prefix = mintNamespacePrefix(MCP_NAMESPACE, s.name);
40
+ return peerLeft(prefix) ? [{ name: prefix, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) }] : [];
41
+ });
42
+ const readers = MCP_RESOURCE_FACES.filter((name) => valveLeaves({}, lists)({ name })).map((name) => ({ name, contentOrigin: "external" }));
43
+ return [...namespaces, ...readers];
44
+ };
45
+ const reachesPolluting = (f) => [...selectedFor(f), ...broughtBy(f)].some((t) => input.isPolluting(t));
46
+ if (reachesPolluting(face))
29
47
  return true;
30
- if (face.canRedelegate === true && input.faces.some((f) => selectedFor(f).some((t) => input.isPolluting(t))))
48
+ if (face.canRedelegate === true && input.faces.some(reachesPolluting))
31
49
  return true;
32
50
  return false;
33
51
  }
@@ -21,4 +21,5 @@ export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, dec
21
21
  export { migrateScope, type MigrateScopeReport } from "./migrate.js";
22
22
  export { materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, type RemoteMemoryFile, type RemoteMemoryBaseline, type RemoteMaterialization, type RemoteHarvestResult, type InboundEntryFinding, } from "./data-plane.js";
23
23
  export { reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, type MemorySyncCursor, type MemorySyncConflict, type MemorySyncPlan, type RecallSource, } from "./sync.js";
24
- export { syncMemoryScope, type MemorySyncTransport, type MemorySyncRequestBody, type MemorySyncResponseBody, type MemorySyncClientConflict, type SyncMemoryScopeOptions, type MemorySyncClientResult, } from "./sync-client.js";
24
+ export { syncMemoryScope, memorySyncStoreOf, carriesCredential, type MemorySyncTransport, type MemorySyncRequestBody, type MemorySyncResponseBody, type MemorySyncClientConflict, type SyncMemoryScopeOptions, type MemorySyncClientResult, } from "./sync-client.js";
25
+ export { memorySyncReportOf, memoryTravelGapOf, type MemorySyncLayerReport, type MemorySyncRoundReport } from "./sync-report.js";
@@ -19,4 +19,5 @@ export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, dec
19
19
  export { migrateScope } from "./migrate.js";
20
20
  export { materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, } from "./data-plane.js";
21
21
  export { reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, } from "./sync.js";
22
- export { syncMemoryScope, } from "./sync-client.js";
22
+ export { syncMemoryScope, memorySyncStoreOf, carriesCredential, } from "./sync-client.js";
23
+ export { memorySyncReportOf, memoryTravelGapOf } from "./sync-report.js";
@@ -64,7 +64,16 @@ export declare function isPersonalScope(parsed: ParsedScopeKey): boolean;
64
64
  /** True when the key's AUTHORITY is central (design/142 §2 表: user/userproj/org rows) — these keys
65
65
  * must never project into an in-repo memory dir (they would leak to every collaborator AND enter
66
66
  * commit history; extended the F9 gate from personal to org). `proj:`/legacy stay
67
- * repo-planed. */
67
+ * repo-planed.
68
+ *
69
+ * @contract memory.identity_absence.opaque_key — the memory of an owner with no identity is keyed by an opaque,
70
+ * unprefixed key the deployment chooses (such as `local`) and never by a sentinel principal: no `user:` key stands for
71
+ * identity absence (a `user:local` key is the key of a principal named `local`), so this function answers `false`
72
+ * for that layer — its authority is not central. The engine mints no key for identity absence. Read as an
73
+ * owner, it is the `local-owner` arm of `RuleOwner` (core/rule-owner.ts), not a principal. A principal's memory is
74
+ * keyed by that principal's keys (`user:<P>` and the principal's project layers); moving this layer to a principal
75
+ * is a re-keying of its entries (`migrateScope`), and the engine never reads the opaque name as a principal.
76
+ * Admission authorizes by the caller's principal (`MemoryScopeAdmissionInput`), never by a layer's owner. */
68
77
  export declare function isCentralAuthorityScope(parsed: ParsedScopeKey): boolean;
69
78
  /**
70
79
  * design/142 §7 S1 hard gate (复审 F9): until S1b per-scope physical roots land, ALL scopes of a
@@ -105,8 +114,9 @@ export type ProjectMarkerFs = Pick<ExecutionEnv, "exists" | "readTextFile">;
105
114
  * other failure is an error, never an absence. Read synchronously, as the memory phase always read the marker: a leg
106
115
  * with no I/O of its own gains no event-loop turn from its project read (its scheduling against sibling legs stays). */
107
116
  export declare const hostProjectMarkerFs: ProjectMarkerFs;
108
- /** The filesystem a leg's task root names: its execution env, or the host's when the env is the no-I/O placeholder (a leg
109
- * with no env, or one handed none — the hands band's own "is there a filesystem" reading). */
117
+ /** The filesystem a leg's task root names: its execution env — its read limits included — or the host's only when the env
118
+ * declares it is the no-I/O placeholder (`performsIo` is `false`: a leg with no env, or one handed none). An undeclared env
119
+ * is read through, never past. */
110
120
  export declare function projectMarkerFsOf(env: ExecutionEnv): ProjectMarkerFs;
111
121
  /**
112
122
  * design/142 §1.1 — resolve a project's identity. READS ONLY THE MARKER (复审 F2: never derives an
@@ -1,7 +1,7 @@
1
1
  import { lstatSync, readFileSync } from "node:fs";
2
2
  import { dirname, join, resolve } from "node:path";
3
3
  import { err, FileError, ok } from "../../internal/harness.js";
4
- import { StubExecutionEnv } from "../stub-env.js";
4
+ import { performsIo } from "../remote-env.js";
5
5
  import { thrownText } from "../thrown-value.js";
6
6
  import { canonicalize } from "./layout.js";
7
7
  function pathSegmentsDualFamily(p) {
@@ -201,7 +201,7 @@ export const hostProjectMarkerFs = {
201
201
  },
202
202
  };
203
203
  export function projectMarkerFsOf(env) {
204
- return env instanceof StubExecutionEnv ? hostProjectMarkerFs : env;
204
+ return performsIo(env) === false ? hostProjectMarkerFs : env;
205
205
  }
206
206
  function identityError(code, message) {
207
207
  const e = new Error(message);