@sema-agent/core 7.66.1 → 7.67.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 (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,5 +1,6 @@
1
1
  import type { AgentTool } from "../internal/harness-types.js";
2
2
  import { type RetentionDeclaration } from "./retention.js";
3
+ import { type KeptBytes, type ToolResultBytesKeeper, type ToolResultBytesSeat } from "./tool-result-bytes.js";
3
4
  /**
4
5
  * Pluggable backing store for **offloaded large tool results** (design/30). When a tool returns more
5
6
  * text than the threshold, the full content is moved here and the conversation keeps only a preview +
@@ -166,10 +167,12 @@ export interface ToolResultStore {
166
167
  * `sessionId`, as the ref and the owner recorded at its winning write. Without it the offloaded results a session's transcript
167
168
  * points at have no way out of a store, so a session moved to another store reads references it cannot dereference.
168
169
  *
169
- * The listing is the whole of the export: the bytes are read with {@link get} (bounded slices; `totalChars` says how much) and
170
- * land in the other store with `put(ref, content, entry.provenance)` — that store's write-once election makes a repeated move an
171
- * idempotent no-op and a ref that already belongs to a different owner a typed refusal ({@link ToolResultRefConflictError}).
172
- * There is no second path for content.
170
+ * The listing is the whole of the export: each listed ref is read the one way every reader reads a ref ({@link bytesOf}'s
171
+ * dispatch rule: text through {@link get}, bounded slices with `totalChars` saying how much; failing that, bytes through
172
+ * {@link bytesOf}) and lands in the other store through the matching write (`put` / `putBytes`, with `entry.provenance`) — that
173
+ * store's write-once election makes a repeated move an idempotent no-op and a ref that already belongs to a different owner a
174
+ * typed refusal ({@link ToolResultRefConflictError}). A destination with no byte arm cannot take a byte entry: the mover counts it
175
+ * and says so, and the transcript's ref to it reads as absent in the new store.
173
176
  *
174
177
  * Rules every implementation follows, the same selection as {@link deleteBySession}:
175
178
  * - **selection is by RECORDED PROVENANCE, never by parsing the ref**; `taskId` is ignored in the match (the entry's
@@ -187,7 +190,48 @@ export interface ToolResultStore {
187
190
  * contract breach. Implementing it does NOT make a store `retention: "managed"`.
188
191
  */
189
192
  listBySession?(sessionId: string): Promise<ToolResultSessionListing> | ToolResultSessionListing;
193
+ /**
194
+ * The BYTE ARM's write: store binary content a tool result carried (bytes the model cannot receive as content) under `ref`, as an
195
+ * entry of this store like any other — the same owner record, the same age, the same sweeps. Its rules:
196
+ * - **one ref, one entry, of one kind**: the write-once election {@link put} runs decides bytes too, across kinds — a
197
+ * `putBytes` on a ref that holds text, or a `put` on a ref that holds bytes, is the typed refusal
198
+ * ({@link ToolResultRefConflictError}, with its `kinds`), never a second entry under one key; a repeat on a ref that holds
199
+ * bytes is the idempotent no-op under the owner rules {@link put} states;
200
+ * - **`provenance` is required**: an engine write always has its session, and a byte entry with no owner is reachable only by
201
+ * an interrupted write or a foreign writer — the orphan leg's ({@link deleteUnattributable});
202
+ * - `mediaType` (the claimed type, in the form a sentence may repeat) is stored with the entry and answered by {@link bytesOf};
203
+ * - **a store with this member implements {@link deleteBySession}**: bytes a session's tools produced must leave with the
204
+ * session; the contract kit refuses the one without the other;
205
+ * - **every sweep reads a byte entry as an entry**: {@link deleteBySession}, {@link reap}, {@link deleteUnattributable} and
206
+ * {@link listBySession} select, age and count it exactly as they do a text entry — its lifetime is the store's, not a second
207
+ * one.
208
+ *
209
+ * Optional, and an OPTIONAL leg of the contract kit (`toolResultStoreContract`, reported through `onOptionalMember`): absent ⇒ the
210
+ * run keeps no binary tool results, and says so where the bytes would have been. The bundled in-memory store does not implement it.
211
+ */
212
+ putBytes?(ref: string, bytes: Uint8Array, provenance: ToolResultProvenance, mediaType?: string): Promise<void> | void;
213
+ /**
214
+ * The BYTE ARM's read: the byte entry stored under `ref` — its length and stored media type, and its bytes on demand (a reader that
215
+ * describes an entry never has to load it) — or `undefined` when `ref` holds no bytes. Present exactly when {@link putBytes} is.
216
+ *
217
+ * **The one way a single ref is read**, by every reader (the reader tools, a host read face, a mover): at most one face answers,
218
+ * because the election above keeps one kind per ref — ask {@link get} first, and when it answers `undefined` ask `bytesOf`; both
219
+ * `undefined` = the ref is absent. A ref is never parsed for its kind (it stays opaque). The read face is lenient like `get`'s: a
220
+ * ref no write could store answers `undefined`, never a throw.
221
+ */
222
+ bytesOf?(ref: string): Promise<ToolResultBytes | undefined> | ToolResultBytes | undefined;
223
+ }
224
+ /** What {@link ToolResultStore.bytesOf} answers for a byte entry. */
225
+ export interface ToolResultBytes {
226
+ /** The entry's length in bytes. */
227
+ readonly byteLength: number;
228
+ /** The media type stored with the entry, when its write stated one. */
229
+ readonly mediaType?: string;
230
+ /** The entry's bytes, read when asked. */
231
+ bytes(): Promise<Uint8Array> | Uint8Array;
190
232
  }
233
+ /** The two kinds of content an entry holds: text ({@link ToolResultStore.put} / `get`) or bytes (`putBytes` / `bytesOf`). */
234
+ export type ToolResultEntryKind = "text" | "bytes";
191
235
  /** One entry a {@link ToolResultStore.listBySession} listing names: the ref and the owner recorded at its winning write — the two
192
236
  * arguments an importing store's `put` takes beside the content `get` returns. */
193
237
  export interface ToolResultListedEntry {
@@ -249,16 +293,25 @@ export interface ToolResultProvenance {
249
293
  /** Backlog #119 — the `code` on {@link ToolResultRefConflictError}, so callers branch on a constant. */
250
294
  export declare const TOOL_RESULT_REF_CONFLICT_CODE = "tool_result.ref_conflict";
251
295
  /**
252
- * Backlog #119 — a `put` whose provenance disagrees with the stored one. Typed (a `code`, like
253
- * `CheckpointError`/`WorkflowRunStoreError`) rather than a silent no-op: this is the one write-once
254
- * outcome where "keep what is there" would hand the second caller a reference to somebody else's bytes.
296
+ * Backlog #119 — a write the occupied ref cannot take: its provenance disagrees with the stored one, or (`kinds` present) it
297
+ * offers the other kind of content than the entry holds (one ref, one entry — {@link ToolResultStore.putBytes}). Typed (a `code`,
298
+ * like `CheckpointError`/`WorkflowRunStoreError`) rather than a silent no-op: these are the write-once outcomes where "keep what
299
+ * is there" would hand the second caller a reference to something other than what it stored. `stored` / `incoming` are the two
300
+ * owners — always both present for an owner conflict; for a kind conflict, whichever side recorded one.
255
301
  */
256
302
  export declare class ToolResultRefConflictError extends Error {
257
303
  readonly ref: string;
258
- readonly stored: ToolResultProvenance;
259
- readonly incoming: ToolResultProvenance;
304
+ readonly stored: ToolResultProvenance | undefined;
305
+ readonly incoming: ToolResultProvenance | undefined;
306
+ readonly kinds?: {
307
+ readonly stored: ToolResultEntryKind;
308
+ readonly incoming: ToolResultEntryKind;
309
+ } | undefined;
260
310
  readonly code = "tool_result.ref_conflict";
261
- constructor(ref: string, stored: ToolResultProvenance, incoming: ToolResultProvenance);
311
+ constructor(ref: string, stored: ToolResultProvenance | undefined, incoming: ToolResultProvenance | undefined, kinds?: {
312
+ readonly stored: ToolResultEntryKind;
313
+ readonly incoming: ToolResultEntryKind;
314
+ } | undefined);
262
315
  }
263
316
  /**
264
317
  * Backlog #119 — the ONE comparison every backend uses, so "same owner" cannot mean two things in two
@@ -398,6 +451,15 @@ export declare const MAX_MINTED_TOOL_RESULT_REF_CHARS: number;
398
451
  * content is byte-identical and the preview stays prompt-cache stable.
399
452
  */
400
453
  export declare function toolResultContentSegment(text: string): string;
454
+ /**
455
+ * The content coordinate of a BYTE entry's ref ({@link ToolResultStore.putBytes}): `b` + 128 bits of a sha256 over the claimed
456
+ * media type (the form a sentence may repeat, `""` when none) and the bytes — the same width and the same reason as
457
+ * {@link toolResultContentSegment}, whose `s` it never shares, so a byte ref and any text ref the engine mints differ in their last
458
+ * segment by construction. The type is inside the digest because the entry stores one type: the same bytes claimed as two types are
459
+ * two entries, each answering its own. Distinct (type, bytes) ⇒ distinct refs rests on the same collision-resistance assumption as
460
+ * every digest here; identical ones are one entry, which the write-once election makes idempotent.
461
+ */
462
+ export declare function toolResultBytesSegment(mediaType: string, bytes: Uint8Array): string;
401
463
  export interface ToolResultSlice {
402
464
  content: string;
403
465
  /** Byte/char offset this slice starts at. */
@@ -412,7 +474,11 @@ export interface ToolResultSlice {
412
474
  * island), so a parent can deref a child's ref within the process. A shared long-lived instance
413
475
  * needs a bound — `maxTotalChars` FIFO-evicts the oldest refs past the cap (an evicted deref lands
414
476
  * on the existing honest "may have expired" text). Durability across restarts still requires a real
415
- * store (e.g. FileToolResultStore) via `RunnerDeps.toolResultStore`. */
477
+ * store (e.g. FileToolResultStore) via `RunnerDeps.toolResultStore`.
478
+ *
479
+ * No byte arm ({@link ToolResultStore.putBytes}): its bound counts characters, and one image is enough to evict a run's text
480
+ * results or, unbounded, to turn this store's emptiness — what a durable suspend is judged on — off for every task sharing it. A
481
+ * run over it keeps no binary tool results and says so. */
416
482
  export declare class InMemoryToolResultStore implements ToolResultStore {
417
483
  /** Managed-retention declaration (retention.ts): whether this store's rows are deleted on schedule by the deployment — given by
418
484
  * the party that runs the sweep (the `retention` option), `"none"` when none is given; the store itself is put/get only. */
@@ -525,6 +591,22 @@ export declare function createOffloadPersist(store: ToolResultStore, sessionId:
525
591
  * seat falls back to `console.warn` plus the once-per-process seat-defect announcement; absent ⇒
526
592
  * `console.warn`. */
527
593
  onNotice?: (notice: import("./types.js").EngineNotice) => void): (toolCallId: string, fullText: string) => string;
594
+ /**
595
+ * The byte sibling of {@link createOffloadPersist}: keep `bytes` (claimed `mimeType`) a tool result carried for the call
596
+ * `toolCallId` in the seat's store (its byte arm), under a content-addressed ref and the session's owner — or say why not, in
597
+ * the closed set (`tool-result-bytes.ts`). The one write every supplier of bytes reaches; the single-piece bound is judged here,
598
+ * once. Never throws, and never writes anywhere else: a store that cannot take the bytes is answered `store_failed` with its error
599
+ * text (the operator's), not routed around. No seat or no byte arm ⇒ `no_byte_store`.
600
+ */
601
+ export declare function keepToolResultBytes(seat: ToolResultBytesSeat | undefined, toolCallId: string, bytes: Uint8Array, mimeType: unknown): Promise<KeptBytes>;
602
+ /**
603
+ * The clause a model-visible line ends with for one {@link KeptBytes}: the ref and how this run can write it to a file (or that it
604
+ * cannot) — the activation step worded as {@link offloadPagebackHint} words its own — or why the bytes were not kept.
605
+ */
606
+ export declare function keptBytesClause(kept: KeptBytes, seat: ToolResultBytesSeat | undefined): string;
607
+ /** The one {@link ToolResultBytesKeeper}: {@link keepToolResultBytes} into `seat` for the call `toolCallId`, worded by
608
+ * {@link keptBytesClause}. Every supplier of bytes (the tool-result seat's admission, an MCP leg) is handed one of these. */
609
+ export declare function toolResultBytesKeeper(seat: ToolResultBytesSeat | undefined, toolCallId: string): ToolResultBytesKeeper;
528
610
  /** Backlog #119 — build the provenance a write site records, from the two coordinates every write site
529
611
  * already has in hand. `taskId` is omitted (not `undefined`-valued) when the run declares none, so the
530
612
  * stored shape compares equal across a durable round-trip. */
@@ -621,5 +703,7 @@ export declare function isOffloadedDetailReplacement(s: string): boolean;
621
703
  * `legsOfRef` = the legs a page-back of one ref travels: a ref holding a background task's result (`persistTaskArtifact`, its
622
704
  * origin in the ref — {@link taskArtifactOriginOf}) travels the legs a poll of that task travels — content from another tree is
623
705
  * an off-target read however it is read back — and the registry's reading answers it; absent, or for any other ref (offloaded
624
- * tool output), none. */
625
- export declare function createReadToolResultTool(store: ToolResultStore, legsOfRef?: (ref: string, tree: import("./cross-boundary-taint.js").CrossBoundaryTreeToken) => import("./cross-boundary-taint.js").BoundaryLegsGiven): AgentTool;
706
+ * tool output), none. A ref is read the one way the store contract states: text first; a ref holding bytes instead
707
+ * (`bytesOf`) is answered — not an error — with its size and type and how this run can write them to a file (`bytesSeat`'s
708
+ * reach of SaveToolResult); a ref holding neither is the honest miss. */
709
+ export declare function createReadToolResultTool(store: ToolResultStore, legsOfRef?: (ref: string, tree: import("./cross-boundary-taint.js").CrossBoundaryTreeToken) => import("./cross-boundary-taint.js").BoundaryLegsGiven, bytesSeat?: ToolResultBytesSeat): AgentTool;
@@ -10,22 +10,29 @@ import { readRetentionDeclaration } from "./retention.js";
10
10
  import { carryNotStartedReceipt } from "./delegation-not-started.js";
11
11
  import { optionKeys, receiveOptions } from "./own-property-receipt.js";
12
12
  import { NON_NEGATIVE_SAFE_INTEGER, readIntegerOption } from "./integer-option.js";
13
+ import { SAVE_TOOL_RESULT_NAME, TOOL_RESULT_BYTES_KEEP_LIMIT, keptBytesFacts, notKeptClause } from "./tool-result-bytes.js";
13
14
  export const TOOL_RESULT_REF_CONFLICT_CODE = "tool_result.ref_conflict";
14
15
  export class ToolResultRefConflictError extends Error {
15
16
  ref;
16
17
  stored;
17
18
  incoming;
19
+ kinds;
18
20
  code = TOOL_RESULT_REF_CONFLICT_CODE;
19
- constructor(ref, stored, incoming) {
20
- super(`tool-result store: ref ${JSON.stringify(ref)} already belongs to a different origin ` +
21
- `(stored ${describeProvenance(stored)}, offered ${describeProvenance(incoming)}) — refusing to store under it`);
21
+ constructor(ref, stored, incoming, kinds) {
22
+ super(kinds !== undefined
23
+ ? `tool-result store: ref ${JSON.stringify(ref)} already holds ${kinds.stored} content — refusing to store ${kinds.incoming} under it`
24
+ : `tool-result store: ref ${JSON.stringify(ref)} already belongs to a different origin ` +
25
+ `(stored ${describeProvenance(stored)}, offered ${describeProvenance(incoming)}) — refusing to store under it`);
22
26
  this.ref = ref;
23
27
  this.stored = stored;
24
28
  this.incoming = incoming;
29
+ this.kinds = kinds;
25
30
  this.name = "ToolResultRefConflictError";
26
31
  }
27
32
  }
28
33
  function describeProvenance(p) {
34
+ if (p === undefined)
35
+ return "no owner";
29
36
  return p.taskId === undefined ? `session=${p.sessionId}` : `session=${p.sessionId} task=${p.taskId}`;
30
37
  }
31
38
  export function assertToolResultProvenanceMatch(ref, stored, incoming) {
@@ -76,6 +83,9 @@ export const MAX_MINTED_TOOL_RESULT_REF_CHARS = 3 + 4 * MAX_REF_SEGMENT_CHARS +
76
83
  export function toolResultContentSegment(text) {
77
84
  return `s${digestOfString(text).slice(0, 32)}`;
78
85
  }
86
+ export function toolResultBytesSegment(mediaType, bytes) {
87
+ return `b${createHash("sha256").update(Buffer.from(`${mediaType.length}:${mediaType}`, "utf16le")).update(bytes).digest("hex").slice(0, 32)}`;
88
+ }
79
89
  function digestOfString(s) {
80
90
  return createHash("sha256").update(Buffer.from(s, "utf16le")).digest("hex");
81
91
  }
@@ -219,6 +229,40 @@ export function createOffloadPersist(store, sessionId, onNotice) {
219
229
  return ref;
220
230
  };
221
231
  }
232
+ export async function keepToolResultBytes(seat, toolCallId, bytes, mimeType) {
233
+ const facts = keptBytesFacts(bytes, mimeType);
234
+ const store = seat?.store;
235
+ if (seat === undefined || store?.putBytes === undefined)
236
+ return { ...facts, notKept: "no_byte_store" };
237
+ if (bytes.byteLength > TOOL_RESULT_BYTES_KEEP_LIMIT)
238
+ return { ...facts, notKept: "over_limit" };
239
+ const ref = buildToolResultRef(seat.sessionId, toolCallId, toolResultBytesSegment(facts.mimeType ?? "", bytes));
240
+ try {
241
+ await store.putBytes(ref, bytes, toolResultProvenanceOf(seat.sessionId), facts.mimeType);
242
+ }
243
+ catch (err) {
244
+ return { ...facts, notKept: "store_failed", saveError: thrownText(err) };
245
+ }
246
+ return { ...facts, ref };
247
+ }
248
+ export function keptBytesClause(kept, seat) {
249
+ if (!("ref" in kept))
250
+ return notKeptClause(kept);
251
+ const reach = seat?.saveReach?.() ?? "absent";
252
+ const call = `call ${SAVE_TOOL_RESULT_NAME} with ref="${kept.ref}" and a new file_path to write them to a file`;
253
+ const how = reach === "callable"
254
+ ? call
255
+ : reach === "deferred"
256
+ ? `${SAVE_TOOL_RESULT_NAME} is not active yet — call ${TOOL_SEARCH_NAME} with {"query":"select:${SAVE_TOOL_RESULT_NAME}"} to activate it, then ${call}`
257
+ : "this run cannot write them to a file";
258
+ return `its bytes were kept as ref "${kept.ref}"; ${how}`;
259
+ }
260
+ export function toolResultBytesKeeper(seat, toolCallId) {
261
+ return async (bytes, mimeType) => {
262
+ const kept = await keepToolResultBytes(seat, toolCallId, bytes, mimeType);
263
+ return { kept, clause: keptBytesClause(kept, seat) };
264
+ };
265
+ }
222
266
  export function toolResultProvenanceOf(sessionId, taskId) {
223
267
  return taskId === undefined ? { sessionId } : { sessionId, taskId };
224
268
  }
@@ -422,7 +466,7 @@ async function offloadOversizedDetailStrings(details, store, thresholdChars, ses
422
466
  };
423
467
  return { value: finalize(value) };
424
468
  }
425
- export function createReadToolResultTool(store, legsOfRef) {
469
+ export function createReadToolResultTool(store, legsOfRef, bytesSeat) {
426
470
  return defineTool({
427
471
  name: OFFLOAD_TOOL_NAME,
428
472
  ...toolFace("read-tool-result"),
@@ -443,6 +487,10 @@ export function createReadToolResultTool(store, legsOfRef) {
443
487
  const off = Math.max(0, intOr(offset, 0));
444
488
  const lim = Math.min(READ_MAX_LIMIT, Math.max(1, intOr(limit, READ_DEFAULT_LIMIT)));
445
489
  const slice = await store.get(ref, { offset: off, limit: lim });
490
+ const kept = slice === undefined ? await store.bytesOf?.(ref) : undefined;
491
+ if (kept !== undefined) {
492
+ return `[ref=${ref} · binary content, ${kept.byteLength} bytes${kept.mediaType !== undefined ? `, claimed type ${kept.mediaType}` : ""} — not text, so it is not paged here] ${keptBytesClause({ bytes: kept.byteLength, ref }, bytesSeat)}.`;
493
+ }
446
494
  if (!slice) {
447
495
  return errorResult(`No persisted output for ref "${ref}" — it may have expired, or this process has no durable tool-result store (the preview above is all that remains).`);
448
496
  }
@@ -1,7 +1,17 @@
1
1
  import { Type, type Static, type TSchema } from "typebox";
2
2
  import type { AgentTool } from "../internal/harness-types.js";
3
+ import { type ToolContractFace } from "../prompt-assembly/tool-catalog.js";
4
+ import { ToolMountLedger, type ToolMountPlan, type ToolMountSource } from "./tool-mount-plan.js";
3
5
  import { type ReservedApprovalCard, type ToolApprovalCard, type ToolFamily, type ToolHostTarget, type ToolRosterPathTarget, type ToolMountTag, type ToolPathTarget, type ToolRenderHints, type ToolRuleFace } from "./tool-face.js";
4
6
  import type { ToolContentOrigin, ToolEffect } from "./tool-spec.js";
7
+ /**
8
+ * The most rows one tool roster carries — the ONE bound on its size: the schema's `entries.maxItems` reads it, and the
9
+ * builder refuses a set that would mint more at both places a roster takes its shape (the prepare-time mint and the run-time
10
+ * domain swap, {@link rosterEntryCountProblem}). A row is one distinct tool NAME (two mounts under a name are one row; an
11
+ * alias is no row; a deferred tool is a row — it rides the frame as one). A set over it is refused where it forms, never cut:
12
+ * which source would lose its tools is a priority nothing declares. A host that wants to know before it asks reads this.
13
+ */
14
+ export declare const TOOL_ROSTER_MAX_ENTRIES = 2048;
5
15
  export declare const ROSTER_SOURCES: readonly ["builtin", "caller", "host", "mcp", "a2a", "external", "synthetic"];
6
16
  export type RosterSource = (typeof ROSTER_SOURCES)[number];
7
17
  export declare const ToolRosterRenderHints: Type.TObject<{
@@ -21,6 +31,10 @@ export declare const ToolRosterEntry: Type.TObject<{
21
31
  peer: Type.TString;
22
32
  declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
23
33
  }>>;
34
+ /** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
35
+ * (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
36
+ * as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
37
+ remoteName: Type.TOptional<Type.TString>;
24
38
  /** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
25
39
  contract: Type.TObject<{
26
40
  contractId: Type.TString;
@@ -30,7 +44,8 @@ export declare const ToolRosterEntry: Type.TObject<{
30
44
  wireSchemaDigest: Type.TString;
31
45
  /** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
32
46
  cardId: Type.TString;
33
- /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}; unique per leg. */
47
+ /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
48
+ * only when the row carries it); unique per leg. */
34
49
  capabilityId: Type.TString;
35
50
  /** The materialized schema's top-level properties (name + coarse type). */
36
51
  inputKeys: Type.TArray<Type.TObject<{
@@ -95,7 +110,8 @@ export declare const ToolRoster: Type.TObject<{
95
110
  schemaVersion: Type.TLiteral<1>;
96
111
  /** Run-time asserted equal to `entries.length`. */
97
112
  count: Type.TInteger;
98
- /** Declaration order = the model's `tools[]` order; names unique (run-time asserted). */
113
+ /** Declaration order = the model's `tools[]` order; names unique (run-time asserted); at most
114
+ * {@link TOOL_ROSTER_MAX_ENTRIES} rows (run-time asserted where the roster forms). */
99
115
  entries: Type.TArray<Type.TObject<{
100
116
  name: Type.TString;
101
117
  /** Always present (empty when the tool answers to no other name). */
@@ -106,6 +122,10 @@ export declare const ToolRoster: Type.TObject<{
106
122
  peer: Type.TString;
107
123
  declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
108
124
  }>>;
125
+ /** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
126
+ * (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
127
+ * as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
128
+ remoteName: Type.TOptional<Type.TString>;
109
129
  /** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
110
130
  contract: Type.TObject<{
111
131
  contractId: Type.TString;
@@ -115,7 +135,8 @@ export declare const ToolRoster: Type.TObject<{
115
135
  wireSchemaDigest: Type.TString;
116
136
  /** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
117
137
  cardId: Type.TString;
118
- /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}; unique per leg. */
138
+ /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
139
+ * only when the row carries it); unique per leg. */
119
140
  capabilityId: Type.TString;
120
141
  /** The materialized schema's top-level properties (name + coarse type). */
121
142
  inputKeys: Type.TArray<Type.TObject<{
@@ -175,7 +196,8 @@ export declare const ToolRoster: Type.TObject<{
175
196
  /** The ONE mount condition that fired for this instance. */
176
197
  mountedBy: Type.TUnion<[Type.TLiteral<"hands">, Type.TLiteral<"backgroundTasks">, Type.TLiteral<"workflow">, Type.TLiteral<"delegation">, Type.TLiteral<"hostInternals">, Type.TLiteral<"peerLane">, Type.TLiteral<"scheduler">, Type.TLiteral<"memory">, Type.TLiteral<"scenario">, Type.TLiteral<"always">, Type.TLiteral<"optional">]>;
177
198
  }>>;
178
- /** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. */
199
+ /** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. The canonical form is the engine's one
200
+ * JSON (`canonicalJsonStringify`: keys sorted, a member holding `undefined` reads as absent). */
179
201
  digest: Type.TString;
180
202
  }>;
181
203
  export type ToolRoster = Static<typeof ToolRoster>;
@@ -188,7 +210,8 @@ export declare const ToolRosterDelta: Type.TObject<{
188
210
  schemaVersion: Type.TLiteral<1>;
189
211
  /** Run-time asserted equal to `entries.length`. */
190
212
  count: Type.TInteger;
191
- /** Declaration order = the model's `tools[]` order; names unique (run-time asserted). */
213
+ /** Declaration order = the model's `tools[]` order; names unique (run-time asserted); at most
214
+ * {@link TOOL_ROSTER_MAX_ENTRIES} rows (run-time asserted where the roster forms). */
192
215
  entries: Type.TArray<Type.TObject<{
193
216
  name: Type.TString;
194
217
  /** Always present (empty when the tool answers to no other name). */
@@ -199,6 +222,10 @@ export declare const ToolRosterDelta: Type.TObject<{
199
222
  peer: Type.TString;
200
223
  declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
201
224
  }>>;
225
+ /** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
226
+ * (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
227
+ * as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
228
+ remoteName: Type.TOptional<Type.TString>;
202
229
  /** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
203
230
  contract: Type.TObject<{
204
231
  contractId: Type.TString;
@@ -208,7 +235,8 @@ export declare const ToolRosterDelta: Type.TObject<{
208
235
  wireSchemaDigest: Type.TString;
209
236
  /** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
210
237
  cardId: Type.TString;
211
- /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}; unique per leg. */
238
+ /** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
239
+ * only when the row carries it); unique per leg. */
212
240
  capabilityId: Type.TString;
213
241
  /** The materialized schema's top-level properties (name + coarse type). */
214
242
  inputKeys: Type.TArray<Type.TObject<{
@@ -268,7 +296,8 @@ export declare const ToolRosterDelta: Type.TObject<{
268
296
  /** The ONE mount condition that fired for this instance. */
269
297
  mountedBy: Type.TUnion<[Type.TLiteral<"hands">, Type.TLiteral<"backgroundTasks">, Type.TLiteral<"workflow">, Type.TLiteral<"delegation">, Type.TLiteral<"hostInternals">, Type.TLiteral<"peerLane">, Type.TLiteral<"scheduler">, Type.TLiteral<"memory">, Type.TLiteral<"scenario">, Type.TLiteral<"always">, Type.TLiteral<"optional">]>;
270
298
  }>>;
271
- /** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. */
299
+ /** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. The canonical form is the engine's one
300
+ * JSON (`canonicalJsonStringify`: keys sorted, a member holding `undefined` reads as absent). */
272
301
  digest: Type.TString;
273
302
  }>;
274
303
  /** Three pairwise-disjoint name lists; a `changed` name's new row is in `roster`. */
@@ -398,6 +427,9 @@ export declare const ROSTER_APPROVAL_BINDING: Readonly<{
398
427
  readonly origin: {
399
428
  readonly unbound: "the peer is the identity's (capabilityId); who declared the server is provenance no decision reads";
400
429
  };
430
+ readonly remoteName: {
431
+ readonly identity: readonly ["capabilityId"];
432
+ };
401
433
  readonly contract: {
402
434
  readonly identity: readonly ["contractId", "implementationRevision"];
403
435
  };
@@ -480,12 +512,16 @@ export type RosterIdentityCarrier = {
480
512
  * the row carries it — one mint for the park row and for the live row it is compared with. */
481
513
  export declare function toolDeclarationDigestOf(entry: ToolRosterEntry): string;
482
514
  /** The engine-minted capability identity: a STRUCTURED tuple (never a joined string — `a:b`+`c` and `a`+`b:c`
483
- * must not collide). Stable across legs for the same source/peer/name/contract. */
515
+ * must not collide). Stable across legs for the same source/peer/name/contract — and, for a tool whose server lists it under a
516
+ * name the wire name does not spell (`remote`, the row's `remoteName`), that server name: two server tools folded onto one wire
517
+ * name are two capabilities. `remote` is a key of the tuple only when given, so the identity of every tool whose wire name spells
518
+ * its server's name is the one minted from the four members alone. */
484
519
  export declare function mintCapabilityId(t: {
485
520
  source: RosterSource;
486
521
  peer: string | null;
487
522
  name: string;
488
523
  contractId: string;
524
+ remote?: string | undefined;
489
525
  }): string;
490
526
  export declare function rosterDigestOf(entries: readonly ToolRosterEntry[]): string;
491
527
  /** The materialized schema's top-level properties, in declaration order. */
@@ -502,6 +538,9 @@ export interface RosterBoundMembers {
502
538
  aliases?: readonly string[];
503
539
  /** An MCP/A2A mount's peer (the row's `origin.peer`) — a NAME on the roster, held to the wire name bound. */
504
540
  peer?: string;
541
+ /** The server's own name for an MCP tool the row carries as `remoteName` — a NAME on the roster, held to the same bound, and to
542
+ * {@link NOT_IN_A_SERVER_TOOL_NAME}. */
543
+ remoteName?: string;
505
544
  contractId?: string;
506
545
  implementationRevision?: string;
507
546
  modelGate?: string;
@@ -590,12 +629,24 @@ export interface RosterSnapshotFacts {
590
629
  /** `TaskSpec.memory.trustedTools` — the exemption channel for an undeclared content class. */
591
630
  trustedTools: ReadonlySet<string>;
592
631
  }
632
+ /** A tool as a mount plan names it: the catalog definition it is (by its name and its contract) and its plan source. The one
633
+ * reading the leg's effective plan and the static plan's caller members both go through. */
634
+ export declare function planIdentityOf(tool: ToolContractFace, source: RosterSource | undefined): {
635
+ readonly id?: string;
636
+ readonly source: ToolMountSource;
637
+ };
593
638
  export declare class RosterBuilder {
594
639
  #private;
595
640
  /** `effects` — the leg's by-name effect map, which the builder keeps equal to the mounted set's answering members. The leg's
596
641
  * safety-axis tables are not the builder's: their marks live under the names they were laid on, and a call reads them under
597
642
  * the names it answers to. */
598
643
  constructor(effects: Map<string, ToolEffect>);
644
+ /** The leg's mount ledger: every mount site asks it before it mounts, and {@link settleMountPlan} checks the
645
+ * mounted set against it. */
646
+ readonly mounts: ToolMountLedger<AgentTool<Type.TSchema, unknown>>;
647
+ /** Check the mounted set (the mount array and the engine lane) against the mount table and return the leg's effective plan.
648
+ * Runs once, after the last mount and before the snapshot. */
649
+ settleMountPlan(): ToolMountPlan;
599
650
  /** The mount array as a READ face. The order is the wire order. */
600
651
  get tools(): readonly AgentTool[];
601
652
  get length(): number;
@@ -617,6 +668,11 @@ export declare class RosterBuilder {
617
668
  * Re-insert a NAME-PREFIX domain in place (the RefreshMcpTools seam): every instance whose name starts with
618
669
  * `prefix` is removed and `fresh` is spliced in at the domain's lowest former index (the wire prefix a
619
670
  * provider cache reads stays put); a domain that was not mounted appends at the tail.
671
+ *
672
+ * The swap is judged before it touches anything: a domain whose fresh tools would put the roster over
673
+ * {@link TOOL_ROSTER_MAX_ENTRIES} rows throws `config.tool_roster_bound` and leaves the builder as it was (the
674
+ * re-mint after the swap is the publish, which runs after the harness is rebuilt — too late to refuse at). An
675
+ * empty `fresh` only shrinks the set and always passes.
620
676
  */
621
677
  replaceDomain(prefix: string, fresh: readonly AgentTool[], meta: RosterMountMeta): {
622
678
  anchor: number;
@@ -624,7 +680,8 @@ export declare class RosterBuilder {
624
680
  /** Mint the roster: one row per mounted NAME, in order. Two mounted instances under one name follow the
625
681
  * harness's own yield (the LATER mount is the one the model dispatches to — design/141 Q4, the
626
682
  * `auditToolCollisions` "yield" record): the roster carries the surviving instance's row at the
627
- * yielded instance's position and never a row per object. */
683
+ * yielded instance's position and never a row per object. A set that would mint more than
684
+ * {@link TOOL_ROSTER_MAX_ENTRIES} rows is refused (`config.tool_roster_bound`) before any row is minted. */
628
685
  snapshot(facts: RosterSnapshotFacts): ToolRoster;
629
686
  }
630
687
  /**
@@ -636,7 +693,7 @@ export declare class RosterBuilder {
636
693
  export declare function rosterEngineNamesProblem(roster: ToolRoster): string | undefined;
637
694
  /** Which source a `TaskSpec.tools` entry mounts as: a definition carrying a CORE contract is a built-in the host chose
638
695
  * to mount; anything else is the caller's own tool. Identity follows the object, never the name. */
639
- export declare function callerMountSource(tool: AgentTool): RosterSource;
696
+ export declare function callerMountSource(tool: ToolContractFace): RosterSource;
640
697
  /** The card namespace a roster row owns (design/388 §2.2 ④) — ONE mint, read by the row and by the prepare door that
641
698
  * judges a caller's `renderHints.resultCards` against it: `builtin:<name>` for engine-owned definitions,
642
699
  * `<mcp|a2a>:<peer>/<tool>` for protocol tools, `<caller|external>:<contractId>` for everything the caller mounts. */
@@ -647,6 +704,10 @@ export declare function callerCardIdOf(tool: Pick<AgentTool, "name" | "parameter
647
704
  /** The protocol segment of a mounted protocol tool's name (`mcp__srv__write_file` ⇒ `write_file`): the name itself when no protocol owns it.
648
705
  * ONE reading, asked by the row's mint below and by the judge that holds an MCP face's cards to the namespace that row will own. */
649
706
  export declare function protocolToolOf(toolName: string): string;
707
+ /** The `remoteName` member a row minted under wire name `toolName` carries for a tool its server lists as `remote`: `remote`
708
+ * when the wire name's protocol segment does not spell it, else nothing (the segment is the server's name). ONE reading, asked by
709
+ * the row's mint and by the MCP intake that drops a listing entry whose member could not ride a row. */
710
+ export declare function rosterRemoteNameOf(toolName: string, remote: string | undefined): string | undefined;
650
711
  /** The refusal of a `boundaryLegs` declaration that is not one — the ONE sentence the roster's declaration door and the row mint both
651
712
  * throw (`config.tool_face_invalid`, the code a caller tool's bad face has). */
652
713
  export declare function boundaryLegsRefusal(toolName: unknown): Error & {