@sema-agent/core 7.66.0 → 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 (903) hide show
  1. package/CHANGELOG.md +3498 -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 +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
  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.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,215 @@
1
+ import { readlinkSync } from "node:fs";
2
+ import { hostname, uptime } from "node:os";
3
+ import { hrtime } from "node:process";
4
+ import { execFileSync } from "node:child_process";
5
+ import { inheritedHostEnv } from "./secret-env.js";
6
+ const UNCHECKABLE_TEXT = Object.freeze({
7
+ another_host: "it was written on another host",
8
+ another_pid_namespace: "it was written in another pid namespace (another container, or one this process cannot name)",
9
+ pid_namespace_unrecorded: "it was written without naming its pid namespace (by an engine before this one, or by a process that could not read it), and this host has more than one",
10
+ start_time_unknown: "no start time could be compared, so a process now holding that pid cannot be told apart from the one that wrote it",
11
+ probe_refused: "the process table refused the question",
12
+ });
13
+ export function uncheckableProcessText(why) {
14
+ return UNCHECKABLE_TEXT[why];
15
+ }
16
+ const START_TIME_TOLERANCE_MS = 2_000;
17
+ const START_TIME_PROBE_TIMEOUT_MS = 2_000;
18
+ const START_TIME_PROBE_PRECISION_MS = 250;
19
+ const ETIME_PATTERN = /^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/;
20
+ const PID_NAMESPACE_LINK = "/proc/self/ns/pid";
21
+ let cachedHostname;
22
+ let cachedPidNamespace;
23
+ let selfFingerprint;
24
+ let startTimeProbeUnavailable = false;
25
+ function thisHost() {
26
+ return (cachedHostname ??= hostname());
27
+ }
28
+ function uptimeMs() {
29
+ try {
30
+ return Math.round(uptime() * 1000);
31
+ }
32
+ catch {
33
+ return null;
34
+ }
35
+ }
36
+ function ownPidNamespace() {
37
+ if (cachedPidNamespace === undefined) {
38
+ try {
39
+ const link = readlinkSync(PID_NAMESPACE_LINK);
40
+ cachedPidNamespace = typeof link === "string" && link !== "" ? link : null;
41
+ }
42
+ catch {
43
+ cachedPidNamespace = null;
44
+ }
45
+ }
46
+ return cachedPidNamespace;
47
+ }
48
+ function announceStartTimeDegrade(reason) {
49
+ if (startTimeProbeUnavailable)
50
+ return;
51
+ startTimeProbeUnavailable = true;
52
+ console.warn(`[sema] this host cannot report process start times (${reason}), so a record naming a process — a file store's ` +
53
+ `directory lock, a run claim, a memory writer's session account — is judged by PID ALONE. A record left behind ` +
54
+ `by a crashed process whose pid the OS has since handed to an unrelated process then reads as a LIVE owner: a ` +
55
+ `lock or claim stays refused until it is removed by hand, and a writer's account stays open until its session ` +
56
+ `resumes or the host closes it.`);
57
+ }
58
+ const START_TIME_PROBE_ATTEMPTS = 3;
59
+ function probeStartTimes(pid) {
60
+ for (let attempt = 0; attempt < START_TIME_PROBE_ATTEMPTS; attempt++) {
61
+ const reading = probeStartTimesOnce(pid);
62
+ if (reading !== "imprecise")
63
+ return reading;
64
+ }
65
+ return null;
66
+ }
67
+ function probeStartTimesOnce(pid) {
68
+ if (startTimeProbeUnavailable)
69
+ return null;
70
+ const knownToExist = pid === process.pid;
71
+ if (process.platform === "win32") {
72
+ announceStartTimeDegrade("no ps(1) on win32");
73
+ return null;
74
+ }
75
+ const monotonicBefore = hrtime.bigint();
76
+ const wallBefore = Date.now();
77
+ const uptimeBefore = uptimeMs();
78
+ if (uptimeBefore === null) {
79
+ announceStartTimeDegrade("the host refused its uptime");
80
+ return null;
81
+ }
82
+ let raw;
83
+ try {
84
+ raw = execFileSync("ps", ["-p", String(pid), "-o", "etime="], {
85
+ encoding: "utf8",
86
+ timeout: START_TIME_PROBE_TIMEOUT_MS,
87
+ stdio: ["ignore", "pipe", "ignore"],
88
+ env: { ...inheritedHostEnv("scrub"), LC_ALL: "C", LANG: "C" },
89
+ });
90
+ }
91
+ catch (err) {
92
+ if (typeof err.status === "number") {
93
+ if (knownToExist)
94
+ announceStartTimeDegrade("ps refused a query about this very process");
95
+ return null;
96
+ }
97
+ announceStartTimeDegrade(`ps failed (${err.code ?? "unknown"})`);
98
+ return null;
99
+ }
100
+ const latency = Number(hrtime.bigint() - monotonicBefore) / 1e6;
101
+ const wallDelta = Date.now() - wallBefore;
102
+ const trimmed = raw.trim();
103
+ const parts = ETIME_PATTERN.exec(trimmed);
104
+ if (parts === null) {
105
+ if (trimmed !== "" || knownToExist)
106
+ announceStartTimeDegrade("ps produced no elapsed time");
107
+ return null;
108
+ }
109
+ if (latency > START_TIME_PROBE_PRECISION_MS)
110
+ return "imprecise";
111
+ if (Math.abs(wallDelta - latency) > START_TIME_PROBE_PRECISION_MS)
112
+ return "imprecise";
113
+ const elapsedMs = (Number(parts[1] ?? "0") * 86_400 + Number(parts[2] ?? "0") * 3_600 + Number(parts[3] ?? "0") * 60 + Number(parts[4] ?? "0")) *
114
+ 1000;
115
+ return {
116
+ startedAtMs: Math.round((wallBefore - elapsedMs) / 1000) * 1000,
117
+ startedSinceBootMs: Math.round((uptimeBefore - elapsedMs) / 1000) * 1000,
118
+ };
119
+ }
120
+ export function processFingerprint(pid) {
121
+ const host = thisHost();
122
+ const pidNs = ownPidNamespace();
123
+ const of = (id, probed) => ({
124
+ pid: id,
125
+ startedAtMs: probed?.startedAtMs ?? null,
126
+ startedSinceBootMs: probed?.startedSinceBootMs ?? null,
127
+ host,
128
+ ...(pidNs !== null ? { pidNs } : {}),
129
+ });
130
+ if (pid === undefined || pid === process.pid) {
131
+ if (selfFingerprint === undefined || selfFingerprint.startedAtMs === null) {
132
+ const answer = of(process.pid, probeStartTimes(process.pid));
133
+ if (answer.startedAtMs === null)
134
+ return answer;
135
+ selfFingerprint = answer;
136
+ }
137
+ return selfFingerprint;
138
+ }
139
+ if (processFingerprint().startedAtMs === null)
140
+ return of(pid, null);
141
+ return of(pid, probeStartTimes(pid));
142
+ }
143
+ function signalProbe(pid) {
144
+ try {
145
+ process.kill(pid, 0);
146
+ return "present";
147
+ }
148
+ catch (err) {
149
+ const code = err.code;
150
+ if (code === "ESRCH")
151
+ return "absent";
152
+ return code === "EPERM" ? "present" : "refused";
153
+ }
154
+ }
155
+ function isMeasure(value) {
156
+ return typeof value === "number" && Number.isFinite(value);
157
+ }
158
+ const GONE = Object.freeze({ state: "gone" });
159
+ const RUNNING = Object.freeze({ state: "running" });
160
+ function uncheckable(why) {
161
+ return { state: "uncheckable", why };
162
+ }
163
+ export function processCensus() {
164
+ const signalled = new Map();
165
+ const observed = new Map();
166
+ const signal = (pid) => {
167
+ let answer = signalled.get(pid);
168
+ if (answer === undefined) {
169
+ answer = signalProbe(pid);
170
+ signalled.set(pid, answer);
171
+ }
172
+ return answer;
173
+ };
174
+ const observe = (pid) => {
175
+ let fp = observed.get(pid);
176
+ if (fp === undefined) {
177
+ fp = processFingerprint(pid);
178
+ observed.set(pid, fp);
179
+ }
180
+ return fp;
181
+ };
182
+ return {
183
+ verdict(record) {
184
+ if (typeof record.host === "string" && record.host !== "" && record.host !== thisHost())
185
+ return uncheckable("another_host");
186
+ const theirs = typeof record.pidNs === "string" && record.pidNs !== "" ? record.pidNs : null;
187
+ if (theirs !== ownPidNamespace())
188
+ return uncheckable(theirs === null ? "pid_namespace_unrecorded" : "another_pid_namespace");
189
+ const answer = signal(record.pid);
190
+ if (answer === "absent")
191
+ return GONE;
192
+ if (answer === "refused")
193
+ return uncheckable("probe_refused");
194
+ if (!isMeasure(record.startedAtMs) && !isMeasure(record.startedSinceBootMs))
195
+ return uncheckable("start_time_unknown");
196
+ const now = observe(record.pid);
197
+ const falsified = (was, seen) => isMeasure(was) && seen !== null && seen - was > START_TIME_TOLERANCE_MS;
198
+ const bootIsOver = (was) => {
199
+ if (!isMeasure(was))
200
+ return false;
201
+ const up = uptimeMs();
202
+ return up !== null && was - up > START_TIME_TOLERANCE_MS;
203
+ };
204
+ const wallSaysGone = falsified(record.startedAtMs, now.startedAtMs);
205
+ const uptimeSaysGone = falsified(record.startedSinceBootMs, now.startedSinceBootMs) || bootIsOver(record.startedSinceBootMs);
206
+ if (wallSaysGone && uptimeSaysGone)
207
+ return GONE;
208
+ const compared = (isMeasure(record.startedAtMs) && now.startedAtMs !== null) || (isMeasure(record.startedSinceBootMs) && now.startedSinceBootMs !== null);
209
+ return compared ? RUNNING : uncheckable("start_time_unknown");
210
+ },
211
+ };
212
+ }
213
+ export function isProcessLive(record) {
214
+ return processCensus().verdict(record).state !== "gone";
215
+ }
@@ -12,9 +12,10 @@
12
12
  *
13
13
  * A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
14
14
  * peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
15
- * is not made. The MCP transport binds its endpoint by dialing only the declared URL with redirects not followed (the seat's
16
- * fetch, `peerFetch`); the A2A peer, whose card may name another endpoint, is bound at each send that carries pieces by
17
- * {@link assertEndpointBound} and by its follow law (a request carrying them follows no redirect, {@link carriesDeclaredHeaders}).
15
+ * is not made. Every send that carries pieces — an MCP request (the seat's fetch, `peerFetch`) and an A2A send, whose card may name
16
+ * another endpoint — is bound by the one judge {@link assertEndpointBound}: over https (or plain http to this machine) and to a
17
+ * declared origin. Neither follows a redirect while it carries them (the MCP fetch follows none; A2A's follow law reads
18
+ * {@link carriesDeclaredHeaders}).
18
19
  */
19
20
  import type { ProtocolId } from "./protocol-table.js";
20
21
  import { type Egress } from "./untrusted-egress.js";
@@ -96,9 +97,30 @@ export declare function remoteWords(text: string, declared: readonly string[]):
96
97
  /** Whether a resolved header set carries anything the declaration bound to its endpoints — a request that does follows no redirect (the
97
98
  * next hop is not a declared endpoint; A2A's follow law reads this). */
98
99
  export declare function carriesDeclaredHeaders(headers: Record<string, string> | undefined): boolean;
100
+ /** The code a send carrying a credential is refused with when its endpoint is reached in the clear across a network
101
+ * ({@link crossesNetworkInClear}): a protocol send carrying pieces (the peer seat's headers, the principal header;
102
+ * {@link assertEndpointBound}), a model request carrying a key or a credential header (the model lane's pairing law,
103
+ * `adjudicateModelRoute` in src/brain/route-adjudicator.ts, where it is a `RouteRefusalCode` word), and the memory distiller's
104
+ * chat seat (src/core/memory-engine/distiller.ts, refused when it is built). One code for the one question, wherever it is asked. */
105
+ export declare const PROTOCOL_PLAINTEXT_CREDENTIALS_CODE = "config.protocol_plaintext_credentials";
99
106
  /**
100
- * Refuse a send to `endpoint` (an A2A card's interface URL, judged at every send) when it lies outside every origin the
101
- * declaration names and the send carries pieces the peer seat answered: `config.protocol_endpoint_unbound`. A send that
102
- * carries none goes where the card says.
107
+ * Would a request to this endpoint cross a network in the clear — the ONE "over what" question every credential-carrying send asks
108
+ * before it is made: `true` unless the scheme is `https:`, or the scheme is plain `http:` and the host is this machine
109
+ * (`isLoopbackHost`, the private-network floor's own loopback reading, over the host as `URL` normalizes it: no DNS, so a name other
110
+ * than `localhost` is not this machine whatever it resolves to, and RFC 1918 / cluster addresses are not exempt). A send that carries
111
+ * no credential does not ask it. Read by {@link assertEndpointBound} (the protocol chains), the model lane's pairing law and the
112
+ * memory distiller's chat seat; exported from the package root for a host that sends a credential itself.
113
+ */
114
+ export declare function crossesNetworkInClear(endpoint: URL): boolean;
115
+ /**
116
+ * THE judge of where a send that carries pieces may go — the seat's answered headers and the principal under the principal header, as
117
+ * {@link carriesDeclaredHeaders} reads the resolved set — for MCP and A2A alike, judged at every send (each MCP request; each A2A card
118
+ * fetch and JSON-RPC send) and at an A2A card's advertised endpoint before its skills mount. Two questions, in this order:
119
+ * 1. over what ({@link crossesNetworkInClear}): `https:`, or plain `http:` to this machine; anything else is
120
+ * `config.protocol_plaintext_credentials` — the pieces would cross a network in the clear (a URL that names credentials is the
121
+ * hop judge's own refusal, not this one's);
122
+ * 2. to whom: an origin the declaration names (an MCP server's `url`; an A2A peer's `url` and `cardUrl`); anything else is
123
+ * `config.protocol_endpoint_unbound`.
124
+ * A send that carries none goes where it goes (the hop judge, host-floor.ts, judges every hop of every request either way).
103
125
  */
104
126
  export declare function assertEndpointBound(protocol: ProtocolId, peer: string, endpoint: string, declared: readonly string[], headers: Record<string, string> | undefined): void;
@@ -1,7 +1,9 @@
1
+ import { isLoopbackHost } from "./host-floor.js";
1
2
  import { authSchemeCredentials } from "./secret-env.js";
2
3
  import { egressText } from "./untrusted-egress.js";
3
4
  import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
4
5
  import { inlineUntrusted } from "./untrusted-text.js";
6
+ import { callerText } from "./caller-text.js";
5
7
  export const MCP_ASSERTION_HEADER = "connector-assertion";
6
8
  const PROTOCOL_OWNED_HEADERS = Object.freeze({
7
9
  mcp: Object.freeze(["mcp-session-id", "mcp-protocol-version", "content-type", "accept", "last-event-id"]),
@@ -33,8 +35,8 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
33
35
  const collision = headerOwnershipCollision(own, protocol);
34
36
  if (collision !== undefined) {
35
37
  const problem = collision.engineOwned
36
- ? `the header "${inlineUntrusted(collision.second, 80)}" is the ${PROTOCOL_OWNED_HEADERS[protocol].includes(collision.first) ? "protocol's own" : "engine's"} ${collision.first} header (header names are case-insensitive) and not ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header's name" : "a header an answer may set"} — remove it`
37
- : `the header "${inlineUntrusted(collision.first, 80)}" is named twice ("${inlineUntrusted(collision.second, 80)}" — header names are case-insensitive); ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header is the engine's to send, so the answer may not set it" : "keep one spelling"}`;
38
+ ? `the header ${callerText(collision.second)} is the ${PROTOCOL_OWNED_HEADERS[protocol].includes(collision.first) ? "protocol's own" : "engine's"} ${collision.first} header (header names are case-insensitive) and not ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header's name" : "a header an answer may set"} — remove it`
39
+ : `the header ${callerText(collision.first)} is named twice (as ${callerText(collision.second)} — header names are case-insensitive); ${principalHeader !== undefined && collision.second === principalHeader ? "the principal header is the engine's to send, so the answer may not set it" : "keep one spelling"}`;
38
40
  throw Object.assign(new Error(`${protocol}: ${problem} — this peer is not dialed`), { code: "config.protocol_header_collision" });
39
41
  }
40
42
  if (principalHeader && principal !== undefined) {
@@ -117,13 +119,15 @@ function markedOver(text, removed) {
117
119
  removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
118
120
  let out = "";
119
121
  let kept = 0;
122
+ let wrote = false;
120
123
  for (const [start, end] of removed) {
121
- if (start < kept) {
124
+ if (wrote && start <= kept) {
122
125
  kept = Math.max(kept, end);
123
126
  continue;
124
127
  }
125
128
  out += text.slice(kept, start) + REDACTION_MARK;
126
129
  kept = end;
130
+ wrote = true;
127
131
  }
128
132
  return out + text.slice(kept);
129
133
  }
@@ -207,12 +211,25 @@ function valueHits(text, forms) {
207
211
  export function carriesDeclaredHeaders(headers) {
208
212
  return headers !== undefined && Object.keys(headers).length > 0;
209
213
  }
214
+ export const PROTOCOL_PLAINTEXT_CREDENTIALS_CODE = "config.protocol_plaintext_credentials";
215
+ export function crossesNetworkInClear(endpoint) {
216
+ if (endpoint.protocol === "https:")
217
+ return false;
218
+ return !(endpoint.protocol === "http:" && isLoopbackHost(endpoint.hostname));
219
+ }
210
220
  export function assertEndpointBound(protocol, peer, endpoint, declared, headers) {
211
221
  if (!carriesDeclaredHeaders(headers))
212
222
  return;
223
+ const subject = `${protocol}: ${protocol === "mcp" ? "server" : "peer"} "${inlineUntrusted(peer, 80)}"`;
224
+ const url = new URL(endpoint);
225
+ const carried = Object.values(headers ?? {});
226
+ const named = (text) => inlineUntrusted(eraseSentCredentials(text, carried), 120);
227
+ if (crossesNetworkInClear(url)) {
228
+ throw Object.assign(new Error(`${subject} would send the headers its peer seat answers or its principal header to ${named(url.origin === "null" ? url.protocol : url.origin)}, which is not https — they travel only over https, or over plain http to this machine (localhost, 127.0.0.0/8, ::1); declare the endpoint as an https url, or send it neither pieces nor a principal header`), { code: PROTOCOL_PLAINTEXT_CREDENTIALS_CODE });
229
+ }
213
230
  const origins = declared.map((u) => new URL(u).origin);
214
- const at = new URL(endpoint).origin;
231
+ const at = url.origin;
215
232
  if (origins.includes(at))
216
233
  return;
217
- throw Object.assign(new Error(`${protocol}: peer "${inlineUntrusted(peer, 80)}" advertises the endpoint origin ${inlineUntrusted(at, 120)}, outside the origins its declaration names (${origins.map((o) => inlineUntrusted(o, 120)).join(", ")}); the headers the peer seat answers travel only to those — declare that origin as the peer's url (and the card's location as cardUrl) or have the seat answer none for it`), { code: "config.protocol_endpoint_unbound" });
234
+ throw Object.assign(new Error(`${subject} advertises the endpoint origin ${named(at)}, outside the origins its declaration names (${origins.map((o) => inlineUntrusted(o, 120)).join(", ")}); the headers the peer seat answers travel only to those — declare that origin as the peer's url (and the card's location as cardUrl) or have the seat answer none for it`), { code: "config.protocol_endpoint_unbound" });
218
235
  }
@@ -40,6 +40,13 @@ export declare function clampNameSegment(seg: string, max?: number): string;
40
40
  * (ticket #10), and the property test holds the two legs to the identical law.
41
41
  */
42
42
  export declare function mintNamespacePrefix(ns: ProtocolNamespace, peer: string): string;
43
+ /**
44
+ * Is the peer segment {@link mintNamespacePrefix} spells for `peer` the peer's own name — only charset-normalized and
45
+ * separator-folded (`github.com` → `github_com`), so a person reads it back to the name? False when the length budget cut
46
+ * the name and gave it a digest, and when nothing of it was nameable and the segment is a bare digest: such a segment is
47
+ * not something a person can derive from the name. Read off the same two steps the mint takes, never a second criterion.
48
+ */
49
+ export declare function mintKeepsPeerName(ns: ProtocolNamespace, peer: string): boolean;
43
50
  /**
44
51
  * The first pair of peers in `peers` that mint the SAME {@link mintNamespacePrefix} — i.e. that would
45
52
  * register into one indistinguishable namespace domain — or `undefined` when every peer owns its own.
@@ -4,7 +4,10 @@ export const MINTED_TOOL_SEGMENT_MIN_CHARS = 16;
4
4
  const SEGMENT_DIGEST_CHARS = 8;
5
5
  const NAME_SEP = "__";
6
6
  export function normalizeNameSegment(name) {
7
- return clampNameSegment(name.replace(/[^a-zA-Z0-9_-]/g, "_"));
7
+ return clampNameSegment(charsetNormalize(name));
8
+ }
9
+ function charsetNormalize(name) {
10
+ return name.replace(/[^a-zA-Z0-9_-]/g, "_");
8
11
  }
9
12
  const SEGMENT_DIGEST_JOIN = "-";
10
13
  export function clampNameSegment(seg, max = TOOL_NAME_MAX_CHARS) {
@@ -17,15 +20,22 @@ export function clampNameSegment(seg, max = TOOL_NAME_MAX_CHARS) {
17
20
  return keep > 0 ? `${seg.slice(0, keep)}${SEGMENT_DIGEST_JOIN}${digest}` : digest.slice(0, max);
18
21
  }
19
22
  function settlePeerSegment(clamped) {
20
- const folded = clamped.replace(/_{2,}/g, "_").replace(/_+$/, "");
23
+ const folded = foldSeparatorRuns(clamped);
21
24
  if (folded !== "")
22
25
  return folded;
23
26
  return createHash("sha256").update(clamped).digest("hex").slice(0, SEGMENT_DIGEST_CHARS);
24
27
  }
28
+ function foldSeparatorRuns(segment) {
29
+ return segment.replace(/_{2,}/g, "_").replace(/_+$/, "");
30
+ }
25
31
  export function mintNamespacePrefix(ns, peer) {
26
32
  const peerBudget = Math.max(1, TOOL_NAME_MAX_CHARS - ns.prefix.length - NAME_SEP.length - MINTED_TOOL_SEGMENT_MIN_CHARS);
27
33
  return `${ns.prefix}${settlePeerSegment(clampNameSegment(normalizeNameSegment(peer), peerBudget))}${NAME_SEP}`;
28
34
  }
35
+ export function mintKeepsPeerName(ns, peer) {
36
+ const minted = mintNamespacePrefix(ns, peer).slice(ns.prefix.length, -NAME_SEP.length);
37
+ return minted === foldSeparatorRuns(charsetNormalize(peer));
38
+ }
29
39
  export function findNamespacePrefixCollision(ns, peers) {
30
40
  return findNamespacePrefixCollisions(ns, peers)[0];
31
41
  }
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Which declaration a request goes to, as the ledger is asked about it: the protocol, and the declaration's name in that protocol's own
3
+ * namespace (an MCP server named "x" and an A2A peer named "x" are two declarations). `fingerprint` is present exactly when the MCP
4
+ * server's declaration carries one (`McpServerSpec.fingerprint`); an A2A peer declares none.
5
+ */
6
+ export type ProtocolRevocationTarget = {
7
+ readonly protocol: "mcp";
8
+ readonly server: string;
9
+ readonly fingerprint?: string;
10
+ } | {
11
+ readonly protocol: "a2a";
12
+ readonly peer: string;
13
+ };
14
+ /** The host's revocation ledger ({@link RunnerDeps.protocolRevocations}): `revoked` answers, synchronously, whether the deployment has
15
+ * withdrawn the declaration the target names. */
16
+ export interface ProtocolRevocationLedger {
17
+ revoked(target: ProtocolRevocationTarget): boolean;
18
+ }
19
+ /** The code a request refused because its target was revoked is answered with, per protocol: each protocol's own namespace. */
20
+ export declare const REVOKED_PEER_CODES: Readonly<{
21
+ readonly mcp: "mcp.server_revoked";
22
+ readonly a2a: "a2a.peer_revoked";
23
+ }>;
24
+ export type RevokedPeerCode = (typeof REVOKED_PEER_CODES)[keyof typeof REVOKED_PEER_CODES];
25
+ /** The declaration's name as the target carries it. */
26
+ export declare function revocationTargetName(target: ProtocolRevocationTarget): string;
27
+ /**
28
+ * A request the revocation ledger stopped at the request exit: nothing of it was sent. Thrown by the exits only; every outlet that answers
29
+ * the model maps it to its own result form (mcp-server-link.ts `revokedCallResult`), and the failure classifier reads it as `revoked`
30
+ * (mcp-failure.ts). Its code comes from {@link REVOKED_PEER_CODES} and nowhere else. `afterSentHop`: the door stopped a REDIRECT of a
31
+ * request whose earlier hop was already sent (an A2A hop judge), so what the peer did with that hop is unknown. Its `details` say what
32
+ * any failure record says of it — `delivered: "no"` when nothing of the request was sent, `"unknown"` after a sent hop — so a re-send
33
+ * the door stopped does not speak for a call whose first attempt was sent (the peer seat's re-send rule, `sentOnceMore`): that call
34
+ * answers what its first attempt met.
35
+ */
36
+ export declare class ProtocolRevokedRefusal extends Error {
37
+ readonly code: RevokedPeerCode;
38
+ readonly target: ProtocolRevocationTarget;
39
+ readonly afterSentHop: boolean;
40
+ readonly details: {
41
+ readonly code: RevokedPeerCode;
42
+ readonly delivered: "no" | "unknown";
43
+ };
44
+ constructor(target: ProtocolRevocationTarget, afterSentHop?: boolean);
45
+ }
46
+ /** Run `send` carrying the revocation question `ask` to its exit ({@link askCarriedRevocation}). */
47
+ export declare function carryRevocation<T>(ask: () => ProtocolRevokedRefusal | undefined, send: () => Promise<T>): Promise<T>;
48
+ /** A transport's send, said for what it is — a request's own bytes, or anything else — under the question it carries, if any. Only the
49
+ * transport knows which message a send carries; the exit it reaches does not. */
50
+ export declare function sendingUnder<T>(sending: "request" | "other", send: () => Promise<T>): Promise<T>;
51
+ /** At a request exit, after the pieces were taken and before anything is sent: the question the send carries, asked; its refusal is
52
+ * thrown. A send that carries none, or that is not a request's own, is not asked. */
53
+ export declare function askCarriedRevocation(): void;
54
+ /** One question to the ledger as a materialization asks it: fail-open, told once (see {@link revocationProbe}). */
55
+ export type RevocationProbe = (target: ProtocolRevocationTarget) => boolean;
56
+ /**
57
+ * The one reader of a revocation seat handed to the engine (`new Runner`, the two library materializations): absent ⇒ `undefined`; else
58
+ * an object whose `revoked` member is a function, read once and kept bound to that object in a frozen copy — or refused
59
+ * (`config.invalid_argument`) naming what does not fit. The form before this seat (`{ isRevoked(serverName, mount?) }`) is refused by
60
+ * name with the form that replaced it: a ledger of that form, handed a target object, would answer "not revoked" for every request.
61
+ */
62
+ export declare function receiveProtocolRevocations(raw: unknown, subject: string): ProtocolRevocationLedger | undefined;
63
+ /** The revocation argument of a library materialization: the seat ({@link receiveProtocolRevocations}) and, beside it, the optional
64
+ * `onProbeFailure` that hears a broken probe once per call of the entrance. */
65
+ export declare function libraryRevocationProbe(raw: unknown, subject: string): RevocationProbe | undefined;
66
+ /**
67
+ * THE probe over one ledger, for one leg (the runner builds one per leg and hands it to both materializations; a library entrance builds
68
+ * one per call): each question asks the ledger again — the answer is never kept — and an answer that is not a boolean, or a throw, is a
69
+ * broken probe answered `false` (not revoked). The first broken answer is told to `onProbeFailure` once; later ones stay quiet (the
70
+ * condition is standing, not news per request). A sink that throws is not a second fault source.
71
+ */
72
+ export declare function revocationProbe(ledger: ProtocolRevocationLedger | undefined, onProbeFailure: ((error: unknown) => void) | undefined): RevocationProbe | undefined;
@@ -0,0 +1,98 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { types } from "node:util";
3
+ import { declarerWord } from "./mcp-server-spec.js";
4
+ import { inlineUntrusted } from "./untrusted-text.js";
5
+ export const REVOKED_PEER_CODES = Object.freeze({ mcp: "mcp.server_revoked", a2a: "a2a.peer_revoked" });
6
+ export function revocationTargetName(target) {
7
+ return target.protocol === "mcp" ? target.server : target.peer;
8
+ }
9
+ export class ProtocolRevokedRefusal extends Error {
10
+ code;
11
+ target;
12
+ afterSentHop;
13
+ details;
14
+ constructor(target, afterSentHop = false) {
15
+ super(`${declarerWord(target.protocol)} "${inlineUntrusted(revocationTargetName(target), 120)}" was revoked by the operator; ` +
16
+ (afterSentHop ? "the request's redirect was NOT followed" : "the request was NOT sent"));
17
+ this.name = "ProtocolRevokedRefusal";
18
+ this.code = REVOKED_PEER_CODES[target.protocol];
19
+ this.target = target;
20
+ this.afterSentHop = afterSentHop;
21
+ this.details = Object.freeze({ code: this.code, delivered: afterSentHop ? "unknown" : "no" });
22
+ }
23
+ }
24
+ const carried = new AsyncLocalStorage();
25
+ export function carryRevocation(ask, send) {
26
+ return carried.run({ ask }, send);
27
+ }
28
+ export function sendingUnder(sending, send) {
29
+ const question = carried.getStore();
30
+ return question === undefined ? send() : carried.run({ ask: question.ask, sending }, send);
31
+ }
32
+ export function askCarriedRevocation() {
33
+ const question = carried.getStore();
34
+ if (question === undefined || question.sending === "other")
35
+ return;
36
+ const refused = question.ask();
37
+ if (refused !== undefined)
38
+ throw refused;
39
+ }
40
+ const SEAT_FORM = "the revocation seat is an object { revoked({ protocol, server | peer, fingerprint? }) } that answers synchronously";
41
+ function refusal(subject, problem) {
42
+ return Object.assign(new Error(`${subject} ${problem} — ${SEAT_FORM}`), { code: "config.invalid_argument" });
43
+ }
44
+ export function receiveProtocolRevocations(raw, subject) {
45
+ if (raw === undefined)
46
+ return undefined;
47
+ if (typeof raw !== "object" || raw === null || types.isProxy(raw))
48
+ throw refusal(subject, raw === null ? "is null" : typeof raw !== "object" ? `is a ${typeof raw}` : "is a Proxy");
49
+ const member = readMemberOf(raw, "revoked", subject);
50
+ if (typeof member !== "function") {
51
+ const retired = member === undefined && typeof readMemberOf(raw, "isRevoked", subject) === "function";
52
+ throw refusal(subject, retired ? "is the MCP-only ledger form `{ isRevoked(serverName, mount?) }`: name the method `revoked` and read the target's `protocol`, `server` / `peer` and `fingerprint`" : "has no `revoked` function");
53
+ }
54
+ return Object.freeze({ revoked: (target) => Reflect.apply(member, raw, [target]) });
55
+ }
56
+ export function libraryRevocationProbe(raw, subject) {
57
+ const ledger = receiveProtocolRevocations(raw, subject);
58
+ if (ledger === undefined)
59
+ return undefined;
60
+ const sink = readMemberOf(raw, "onProbeFailure", subject);
61
+ if (sink !== undefined && typeof sink !== "function")
62
+ throw refusal(subject, `has an \`onProbeFailure\` that is a ${sink === null ? "null" : typeof sink}, not a function`);
63
+ return revocationProbe(ledger, sink === undefined ? undefined : (error) => void Reflect.apply(sink, raw, [error]));
64
+ }
65
+ function readMemberOf(raw, name, subject) {
66
+ try {
67
+ return Reflect.get(raw, name);
68
+ }
69
+ catch {
70
+ throw refusal(subject, `threw while its \`${name}\` was read`);
71
+ }
72
+ }
73
+ export function revocationProbe(ledger, onProbeFailure) {
74
+ if (ledger === undefined)
75
+ return undefined;
76
+ let told = false;
77
+ return (target) => {
78
+ try {
79
+ const answer = ledger.revoked(Object.freeze({ ...target }));
80
+ if (typeof answer === "boolean")
81
+ return answer;
82
+ if (typeof answer?.then === "function")
83
+ Promise.resolve(answer).catch(() => undefined);
84
+ throw new Error(`revoked returned ${answer instanceof Promise ? "a Promise — the ledger seat is SYNCHRONOUS by contract" : `a non-boolean (${answer === null ? "null" : typeof answer})`}`);
85
+ }
86
+ catch (e) {
87
+ if (!told) {
88
+ told = true;
89
+ try {
90
+ onProbeFailure?.(e);
91
+ }
92
+ catch {
93
+ }
94
+ }
95
+ return false;
96
+ }
97
+ };
98
+ }
@@ -7,10 +7,10 @@
7
7
  * makes "which protocol owns this tool name" a lookup: a second protocol (e.g. A2A) lands by
8
8
  * APPENDING one entry, and every table-driven site picks it up unchanged.
9
9
  *
10
- * Dependency-free by design (pure string logic) — `mcp.ts` re-exports {@link MCP_NAMESPACE}'s prefix
11
- * as its public `MCP_PREFIX` face, never the other way around. The MINTING pipeline (charset
12
- * normalization + the assembled-name budget, which needs a digest) lives in `protocol-naming.ts`, which
13
- * imports this module's type; the dependency never runs the other way, so this file stays dependency-free.
10
+ * Pure string logic: its one import is the zero-import text leaf a refusal echoes an identity through —
11
+ * `mcp.ts` re-exports {@link MCP_NAMESPACE}'s prefix as its public `MCP_PREFIX` face, never the other way
12
+ * around. The MINTING pipeline (charset normalization + the assembled-name budget, which needs a digest)
13
+ * lives in `protocol-naming.ts`, which imports this module's type; the dependency never runs the other way.
14
14
  */
15
15
  /** The ids of every protocol the engine speaks. Doubles as the protocol slice of the tool-manifest
16
16
  * `ToolOrigin` union — adding a protocol extends BOTH (tsc pairs the change). */
@@ -1,3 +1,4 @@
1
+ import { inlineUntrusted } from "./untrusted-text.js";
1
2
  const NAME_SEP = "__";
2
3
  function makeProtocolNamespace(id, prefix) {
3
4
  const parse = (name) => {
@@ -14,10 +15,10 @@ function makeProtocolNamespace(id, prefix) {
14
15
  };
15
16
  const makeName = (peer, tool) => {
16
17
  if (peer.length === 0 || tool.length === 0) {
17
- throw new Error(`protocol table (${id}): peer and tool must both be non-empty (got peer=${JSON.stringify(peer)}, tool=${JSON.stringify(tool)})`);
18
+ throw new Error(`protocol table (${id}): peer and tool must both be non-empty (got an empty ${peer.length === 0 ? "peer" : "tool"})`);
18
19
  }
19
20
  if (peer.includes(NAME_SEP)) {
20
- throw new Error(`protocol table (${id}): peer must not contain the ${NAME_SEP} separator (got ${JSON.stringify(peer)}) — the composed name would parse back as a DIFFERENT peer`);
21
+ throw new Error(`protocol table (${id}): peer must not contain the ${NAME_SEP} separator (got "${inlineUntrusted(peer)}") — the composed name would parse back as a DIFFERENT peer`);
21
22
  }
22
23
  return `${prefix}${peer}${NAME_SEP}${tool}`;
23
24
  };
@@ -1,12 +1,45 @@
1
- /** A minimal async iterable you can push values into and close. Backpressure-free (buffers). */
1
+ /**
2
+ * A place a writer keeps in a {@link PushQueue}: what it puts there is delivered at that place, and every value pushed after the
3
+ * place was kept waits behind it until the place is filled. `put` delivers values and keeps the place (more may follow there);
4
+ * `fill` delivers values and frees the place. Once filled, the place takes nothing more (a later `put` / `fill` is a no-op);
5
+ * filling with nothing frees it.
6
+ */
7
+ export interface QueueSlot<T> {
8
+ put(values: readonly T[]): void;
9
+ fill(values: readonly T[]): void;
10
+ }
11
+ /**
12
+ * A minimal async iterable you can push values into and close. Backpressure-free (buffers).
13
+ *
14
+ * A writer that must decide later what stands at the present point of the stream keeps a place with {@link reserve}: values pushed
15
+ * after it are held behind it (accepted, in push order) until it is filled. `close()` refuses later pushes and later places, and the
16
+ * iteration ends once every place kept before the close is filled and everything ahead of the end is delivered — a kept place is
17
+ * part of what was pushed before the close, so its owner must fill it (a place that is never filled holds the iteration open).
18
+ */
2
19
  export declare class PushQueue<T> implements AsyncIterable<T> {
3
20
  private buffer;
4
21
  private waiters;
5
22
  private closed;
23
+ /** What waits behind the oldest open place, in order — empty when no place is kept. */
24
+ private held;
6
25
  /** Returns whether the value was ACCEPTED (`false` after close — the push is a silent no-op then).
7
26
  * Callers that mirror a pushed value to a second reader gate on this so both sides stay in parity
8
- * (#253: a status frame must not reach a side sink the stream itself already refused). */
27
+ * (#253: a status frame must not reach a side sink the stream itself already refused). A value accepted while a place is kept
28
+ * is delivered after that place is filled: a reader mirroring at push sees it earlier than the stream's reader does. */
9
29
  push(value: T): boolean;
30
+ /** Keep a place at the present point of the stream; `undefined` after close (nothing more is accepted). */
31
+ reserve(): QueueSlot<T> | undefined;
10
32
  close(): void;
33
+ /**
34
+ * Free every kept place with what was put into it so far: the writer that kept them can no longer fill them (the run that
35
+ * owned it died before its own settle). Values held behind the places are delivered in order; a later `put` / `fill` on a
36
+ * freed place is a no-op.
37
+ */
38
+ freePlaces(): void;
39
+ /** Deliver what stands ahead of the oldest open place (and what was put into it), then end the iteration if it is closed and
40
+ * nothing is held. */
41
+ private release;
42
+ private deliver;
43
+ private endIfDone;
11
44
  [Symbol.asyncIterator](): AsyncIterator<T>;
12
45
  }