@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -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 +169 -0
  71. package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
  362. package/dist/core/roles.js +148 -21
  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 +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
  730. package/dist/index.js +45 -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 +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,8 +1,10 @@
1
1
  import { types } from "node:util";
2
- import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, callerText, declarationFaultOf, declarationPath, declarerWord, readToolAxes, receiveDeclaration, toolAxesRefusal, } from "./mcp-server-spec.js";
2
+ import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, declarationFaultOf, declarationPath, declarerWord, readToolAxes, receiveDeclaration, toolAxesRefusal, } from "./mcp-server-spec.js";
3
+ import { callerText } from "./caller-text.js";
3
4
  import { isPlainRecord, receive } from "./mods/kernel/receive.js";
4
5
  import { TOOL_FACE_WORDS, readToolFaces } from "./tool-face-reader.js";
5
6
  import { judgeSessionMetaKey } from "./mcp-call-meta.js";
7
+ import { isMcpFaceWord } from "./mounted-mcp.js";
6
8
  import { CONFIG_RECEIPT_MODE, optionKeys, strayMembersOf } from "./own-property-receipt.js";
7
9
  import { isToolContentOrigin, TOOL_CONTENT_ORIGINS } from "./memory-engine/content-origin.js";
8
10
  import { inlineUntrusted } from "./untrusted-text.js";
@@ -150,6 +152,17 @@ export function judgeEntrySessionMetaKey(copy) {
150
152
  return { ok: true, entry: copy };
151
153
  return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${inlineUntrusted(read.problem, 200)}. The key decides where the leg's session id rides on this server's requests, so it is refused rather than dropped or defaulted — a connector keyed on a session it never receives would share one state across every session.`) };
152
154
  }
155
+ export function judgeEntryReservedKeys(copy) {
156
+ const reservedKey = (declared) => (isPlainRecord(declared) ? Object.keys(declared).find(isMcpFaceWord) : undefined);
157
+ const problem = (word) => `its key "${word}" is a reserved allowTools face word (a kind of read the engine makes of the server), never a tool name — no tool is ever mounted under it`;
158
+ const axesWord = reservedKey(copy.toolAxes);
159
+ if (axesWord !== undefined)
160
+ return { ok: false, error: toolAxesRefusal("mcp", declarerNameOf(copy.name), problem(axesWord)) };
161
+ const facesWord = reservedKey(copy.toolFaces);
162
+ if (facesWord !== undefined)
163
+ return { ok: false, error: toolFacesRefusal(declarerNameOf(copy.name), problem(facesWord)) };
164
+ return { ok: true, entry: copy };
165
+ }
153
166
  const HOST_TRANSPORT_KEYS = optionKeys()({ kind: 0 });
154
167
  export function judgeEntryHostTransport(copy) {
155
168
  const transport = copy.transport;
@@ -158,16 +171,21 @@ export function judgeEntryHostTransport(copy) {
158
171
  const stray = strayMembersOf(transport, { subject: "a host-supplied transport", unit: "member", moment: "when the entry is read" }, HOST_TRANSPORT_KEYS)?.names[0];
159
172
  const extra = stray === undefined ? undefined : String(stray);
160
173
  const problem = extra !== undefined
161
- ? `a host-supplied transport with the member ${inlineUntrusted(JSON.stringify(extra), 80)}: a host transport carries its kind alone — the host seat carries what each request needs, so a member here would read as in force while nothing carries it`
174
+ ? `a host-supplied transport with the member ${callerText(extra)}: a host transport carries its kind alone — the host seat carries what each request needs, so a member here would read as in force while nothing carries it`
162
175
  : copy.elicitation === true
163
176
  ? `elicitation on a host-supplied transport: the server behind a host's pipe is the host's own code, so a question it has for the user goes through the host's own interface — the engine advertises no elicitation for it`
164
177
  : undefined;
165
178
  return problem === undefined ? { ok: true, entry: copy } : { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${problem}.`) };
166
179
  }
167
180
  export function judgeMcpEntryDeclarations(copy) {
181
+ const entry = copy;
182
+ if (types.isProxy(entry) || !isPlainRecord(entry)) {
183
+ return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} declaration must be a plain object of the server's members (it is ${typeof entry === "object" && entry !== null && !Array.isArray(entry) ? "an object that is not a plain record: a Proxy, or one that carries a prototype" : callerText(entry)}) — an entry the engine cannot read as one is refused rather than judged ok or let throw.`) };
184
+ }
168
185
  const axes = judgeEntryToolAxes(copy, "mcp");
169
186
  const faces = axes.ok ? judgeEntryToolFaces(axes.entry) : axes;
170
- const metaKey = faces.ok ? judgeEntrySessionMetaKey(faces.entry) : faces;
187
+ const reserved = faces.ok ? judgeEntryReservedKeys(faces.entry) : faces;
188
+ const metaKey = reserved.ok ? judgeEntrySessionMetaKey(reserved.entry) : reserved;
171
189
  return metaKey.ok ? judgeEntryHostTransport(metaKey.entry) : metaKey;
172
190
  }
173
191
  function declaredEntriesOf(declared, at, where) {
package/dist/core/lsp.js CHANGED
@@ -8,6 +8,7 @@ import { Type } from "typebox";
8
8
  import { defineTool, errorResult } from "./tools.js";
9
9
  import { toolFace } from "./tool-catalog-entries.js";
10
10
  import { thrownText } from "./thrown-value.js";
11
+ import { envErrorDetail } from "../tools/fs/env-error-detail.js";
11
12
  export const LSP_OPERATIONS = [
12
13
  "goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol",
13
14
  "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls",
@@ -107,7 +108,7 @@ export function lspReadGateOf(env, face, authorizedKey) {
107
108
  return { ok: false, reason: thrownText(e) };
108
109
  }
109
110
  if (!held.ok)
110
- return { ok: false, reason: held.error.message };
111
+ return { ok: false, reason: envErrorDetail(held.error.message) };
111
112
  if ((await keyOf(filePath, signal)) !== key) {
112
113
  await held.value.close();
113
114
  return { ok: false, reason: "it resolved to a different file while it was being checked" };
@@ -1,3 +1,4 @@
1
+ import { type RowCorrupt } from "./row-shape.js";
1
2
  /** One parked message. `seq` is minted by the store, monotonic per (scope, handle), stable across
2
3
  * lease/expiry cycles (a re-leased message keeps its number — dedup/ordering key). */
3
4
  export interface MailboxMessage {
@@ -39,8 +40,26 @@ export type MailboxDecision = (typeof MAILBOX_DECISIONS)[number];
39
40
  * as `held` — never delivered on a guess, and left for a person (or that newer engine) to decide. */
40
41
  export declare function readStoredMailboxDecision(raw: unknown): MailboxDecision | undefined;
41
42
  /** The refusal code of a malformed {@link MailboxStore.moveDecision} call (a word outside the
42
- * closed set, a non-positive seq, or an edge the decision law does not allow). */
43
+ * closed set, a non-positive seq, a holder that is no lease-owner spelling, or an edge the decision law does not allow). */
43
44
  export declare const MAILBOX_INVALID_DECISION_MOVE_CODE = "mailbox.invalid_decision_move";
45
+ /** The refusal code of a {@link MailboxStore.claimLease} whose `owner` is not a spelling a lease can be named by
46
+ * ({@link isMailboxNameSpelling}): the owner is the identity the lease fence ({@link mailboxDecisionMoveFenced}) and `ack`
47
+ * compare, so a blank or control-carrying one would make two different holders read as one. */
48
+ export declare const MAILBOX_INVALID_LEASE_OWNER_CODE = "mailbox.invalid_lease_owner";
49
+ /**
50
+ * THE one spelling judge of a name the box keeps and compares by equality — a receipt id, a lease owner, a decision move's holder: a
51
+ * string with visible content ({@link hasVisibleContent}: the one reading of "blank" a principal's name uses too — white space and the
52
+ * format characters, the joiners included, count for nothing), at most {@link NAME_MAX_CHARS} characters, and no control or
53
+ * format character. A blank one names nothing (`"" === ""` reads two holders as the same one; so does a string of one joiner or
54
+ * zero-width mark, which prints as nothing), a control character reads as another line wherever the name is printed, a format
55
+ * character (zero-width, a direction override) prints as nothing or reorders what is printed, and a name of any length is kept in
56
+ * every box record, log line and refusal sentence that carries it. The box keeps the name as an opaque key — it is not required to be
57
+ * a principal's name. Read by the receipt id's mint (`mintCrossPrincipalRecord`), by {@link assertMailboxLeaseOwner} (`claimLease`) and
58
+ * by {@link assertMailboxDecisionMove} (a move's `holder`); each refuses with the code of the call that was malformed.
59
+ */
60
+ export declare function isMailboxNameSpelling(raw: unknown): raw is string;
61
+ /** The validator `claimLease` runs BEFORE touching storage, in every backend: a malformed owner has zero side effects. */
62
+ export declare function assertMailboxLeaseOwner(owner: unknown): void;
44
63
  export declare function isMailboxDecision(value: unknown): value is MailboxDecision;
45
64
  /** Final states: the record is never delivered again, by any consumer. */
46
65
  export declare function isMailboxDecisionFinal(state: MailboxDecision | undefined): boolean;
@@ -49,12 +68,22 @@ export declare function isMailboxDecisionDeliverable(state: MailboxDecision | un
49
68
  /**
50
69
  * THE decision law — a decision only moves forward, and every hand-over of a held record is itself a move:
51
70
  * absent → `held`; `held` → `approved` / `delivered` / `denied` / `expired` / `refused`; `approved` →
52
- * `delivered` or a final state; `delivered` → `dropped` (the handed-over frame was refused by policy inside a lease-holding pass) only;
53
- * a final state never moves.
71
+ * `delivered` or a final state; `delivered` → `dropped` (the handed-over frame was refused by policy inside a lease-holding pass) only,
72
+ * and only by the box's lease holder ({@link mailboxDecisionMoveFenced}); a final state never moves.
54
73
  */
55
74
  export declare function mailboxDecisionEdgeAllowed(from: MailboxDecision | undefined, to: MailboxDecision): boolean;
75
+ /**
76
+ * THE lease fence of the decision law, the one every backend reads after the record's state matched `expect`:
77
+ * `true` = the move must not happen. A record in `delivered` was handed over — its injection is owed by the consumer
78
+ * that holds the box — so an edge out of `delivered` is taken only by that consumer: the box's current lease must name
79
+ * `holder`, the fence {@link MailboxStore.ack} takes (a lease that lapsed and nobody claimed since is still its holder's;
80
+ * a box with no lease, or a caller that names no holder, holds nothing). Every other edge is a person's or a policy's
81
+ * answer about a held record, which any process may give: the lease is not asked.
82
+ */
83
+ export declare function mailboxDecisionMoveFenced(expect: MailboxDecision | undefined, leaseOwner: string | undefined, holder: string | undefined): boolean;
56
84
  /** What {@link MailboxStore.moveDecision} answers: the move happened, or the record's actual state
57
- * (`unset` = never held, `gone` = no such record any more — acked, reaped or dropped). */
85
+ * (`unset` = never held, `gone` = no such record any more — acked, reaped or dropped). The state is what the caller
86
+ * expected exactly when the lease fence refused it ({@link mailboxDecisionMoveFenced}: `current: "delivered"`). */
58
87
  export type MailboxDecisionOutcome = {
59
88
  readonly ok: true;
60
89
  } | {
@@ -65,11 +94,12 @@ export type MailboxDecisionOutcome = {
65
94
  * THE caller-side reading of {@link MailboxStore.moveDecision}: a fault can arrive AFTER the move
66
95
  * committed (a lock release that failed, a reply lost on the wire), so a call that throws is asked once
67
96
  * more, and a store that already holds `next` answers the first call's success. A second fault throws.
68
- * Every engine-side decision move goes through this one function.
97
+ * Every engine-side decision move goes through this one function. `holder` = the lease owner the caller
98
+ * claims the box with (see {@link MailboxStore.moveDecision}).
69
99
  */
70
- export declare function moveMailboxDecision(store: Pick<MailboxStore, "moveDecision">, scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
100
+ export declare function moveMailboxDecision(store: Pick<MailboxStore, "moveDecision">, scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
71
101
  /** The one validator every backend runs BEFORE touching storage: a malformed call has zero side effects. */
72
- export declare function assertMailboxDecisionMove(seq: unknown, expect: unknown, next: unknown): void;
102
+ export declare function assertMailboxDecisionMove(seq: unknown, expect: unknown, next: unknown, holder?: unknown): void;
73
103
  /** design/385 — the typed peer-metadata record on a parked message. ONE optional object, one-time
74
104
  * contract extension; every field optional. Bundled backends persist it verbatim and hand back a
75
105
  * detached copy. */
@@ -127,7 +157,8 @@ export interface MailboxPeerNoticeMeta {
127
157
  dropReason?: string;
128
158
  /** idle_notice `idle`/`exited`: when the target finished its turn (epoch ms). */
129
159
  finishedAt?: number;
130
- /** idle_notice `idle`: the target's one-line detail (already bounded by the producer). */
160
+ /** idle_notice `idle`: the target's one-line detail (already bounded by the producer). delivery_notice `refused`: who refused the
161
+ * message there; `delivered`: what released the held message (`approved` | `rejudge`, the peer-notices `PEER_RELEASE_CAUSES`). */
131
162
  detail?: string;
132
163
  /** idle_notice `expired` (the requester answering ITSELF): the label the ask carried for the target
133
164
  * that never answered — the record's author is the requester, so the target must be named here. */
@@ -197,7 +228,10 @@ export declare const MAILBOX_TOMBSTONED_RECIPIENT_CODE = "mailbox.recipient_tomb
197
228
  * A backend may raise the same code with a plain `Error` carrying `.code`; consumers branch on the
198
229
  * string, not on this class (a cross-process/out-of-repo store cannot hand back an instance).
199
230
  */
200
- export type MailboxStoreErrorCode = typeof MAILBOX_TOMBSTONED_RECIPIENT_CODE | typeof MAILBOX_INVALID_PEER_META_CODE | typeof MAILBOX_CROSS_PROCESS_UNSAFE_CODE | typeof MAILBOX_INVALID_DECISION_MOVE_CODE | typeof MAILBOX_INVALID_RECORD_ID_CODE | typeof MAILBOX_DUPLICATE_RECORD_ID_CODE;
231
+ export type MailboxStoreErrorCode = typeof MAILBOX_TOMBSTONED_RECIPIENT_CODE | typeof MAILBOX_INVALID_PEER_META_CODE | typeof MAILBOX_CROSS_PROCESS_UNSAFE_CODE | typeof MAILBOX_INVALID_DECISION_MOVE_CODE | typeof MAILBOX_INVALID_LEASE_OWNER_CODE | typeof MAILBOX_INVALID_RECORD_ID_CODE | typeof MAILBOX_DUPLICATE_RECORD_ID_CODE | typeof MAILBOX_ROW_MALFORMED_CODE;
232
+ /** A parked record (or an append's record) that does not read as {@link MAILBOX_MESSAGE_ROW_SHAPE}: an append refuses it before
233
+ * any side effect; on a held record, an `ack` that would consume past it and a decision move on it are refused. */
234
+ export declare const MAILBOX_ROW_MALFORMED_CODE = "mailbox.row_malformed";
201
235
  export declare class MailboxStoreError extends Error {
202
236
  readonly code: MailboxStoreErrorCode;
203
237
  constructor(code: MailboxStoreErrorCode, message: string);
@@ -268,6 +302,37 @@ export declare function readMailboxRecordId(raw: unknown): string | undefined;
268
302
  * mutation while the append waits for its lock, cannot make the record judged differ from the record stored.
269
303
  */
270
304
  export declare function readMailboxAppend(msg: MailboxAppendMessage): MailboxAppendMessage;
305
+ /**
306
+ * THE PARKED RECORD'S MEMBER-SHAPE TABLE (`rowShapeReader`, row-shape.ts). `rowKey` is the box replay's predicate for an `append`
307
+ * event's record (an object with a finite `seq`); `members` is what a delivery reads: the content, the stamp, the producer's id
308
+ * ({@link readMailboxRecordId}), the sender name, the forwarding chain (a list of hops, a hole being absence), the peer metadata
309
+ * slot (an object — its words are validated at `append` by {@link readMailboxPeerMeta}; a stored slot whose words another writer
310
+ * chose is the drain's foreign judgment, never this table's) and the hold decision ({@link readStoredMailboxDecision}, which reads
311
+ * a word it does not know as `held`). The exit is `block`: a box is an ordered log, so its records before the first one that does not read are served and
312
+ * nothing at or past that one is leased, acknowledged, counted or swept — the box visibly stops there, every claim tells it, and
313
+ * the remedy is to drop the box or repair the record ({@link mailboxReadablePrefix}).
314
+ */
315
+ export declare const MAILBOX_MESSAGE_ROW_SHAPE: import("./row-shape.js").RowShapeReader<MailboxMessage>;
316
+ /** A box's held records as a delivery reads them: the readable PREFIX, and — when one does not read — the record it stops at. */
317
+ export interface MailboxReadablePrefix {
318
+ readonly prefix: readonly MailboxMessage[];
319
+ readonly blocked?: {
320
+ readonly seq: number;
321
+ readonly corrupt: RowCorrupt;
322
+ };
323
+ }
324
+ /**
325
+ * The `block` exit over a box's held records (in seq order): the records before the first one that does not read
326
+ * ({@link MAILBOX_MESSAGE_ROW_SHAPE}), and that one. Every bundled backend's lease, ack fence and count read this, so no face serves,
327
+ * consumes or counts past a record nobody can read.
328
+ */
329
+ export declare function mailboxReadablePrefix(messages: readonly MailboxMessage[]): MailboxReadablePrefix;
330
+ /** The sentence a box's disclosure carries when its delivery stops at a record that does not read. */
331
+ export declare function mailboxBlockedSentence(scope: string, handle: string, blocked: NonNullable<MailboxReadablePrefix["blocked"]>): string;
332
+ /** The refusal of an `ack` that would consume past a record that does not read: nothing is consumed. */
333
+ export declare function mailboxAckBlockedRefusal(blocked: NonNullable<MailboxReadablePrefix["blocked"]>): MailboxStoreError;
334
+ /** The refusal of a decision move on a held record that does not read: nothing moves. */
335
+ export declare function mailboxDecisionOnUnreadableRefusal(corrupt: RowCorrupt): MailboxStoreError;
271
336
  /**
272
337
  * THE append-by-identity judgment, the one every backend runs inside its write critical section
273
338
  * (with `msg` already validated: `id` by {@link readMailboxRecordId}, `peerMeta` by {@link readMailboxPeerMeta}),
@@ -299,8 +364,16 @@ export declare function judgeMailboxAppendById(box: {
299
364
  * per window — the row claim-CAS already guarantees one revival winner; this is the belt); the
300
365
  * SAME owner re-claiming RENEWS the lease and picks up any newer messages (the crash-retry form
301
366
  * — server[1523] 定谳: both bundled impls behave so, the contract follows the implementations).
367
+ * `owner` is a NAME the box compares by equality (the lease fence, `ack`, `releaseLease`): a string with a non-blank character and no
368
+ * control character ({@link isMailboxNameSpelling}); anything else is refused with {@link MAILBOX_INVALID_LEASE_OWNER_CODE} before
369
+ * any read or write ({@link assertMailboxLeaseOwner}, which every backend calls first) — a blank owner would make two holders read as one.
302
370
  * - `ack` deletes every message with seq ≤ upToSeq (the winner calls it at ATTACH success, never
303
371
  * before — §7.1: ack-late is what makes a crashed revival lossless).
372
+ * - A HELD RECORD THAT DOES NOT READ ({@link MAILBOX_MESSAGE_ROW_SHAPE}; the box's exit is `block`): `claimLease` serves the records
373
+ * before it and leases nothing at or past it (an empty prefix answers `null`); an `ack` whose `upToSeq` reaches it is refused with
374
+ * {@link MAILBOX_ROW_MALFORMED_CODE} and consumes nothing; `peekCount` counts the prefix; a decision move on it is refused in the
375
+ * same code. Nothing removes it but `drop` (or a repair of its bytes) — so a producer's retry under a later record's id is never
376
+ * absorbed by a received window the stuck record was folded past. {@link mailboxReadablePrefix} is the one reading.
304
377
  * - `releaseLease` (best-effort) returns a lease early (spawn preflight failed before delivery).
305
378
  * - `reap` ages out whole mailboxes by newest-message age (explicit policy). It is the BACKSTOP, not
306
379
  * the only reclaim path: the winning-delete arm of `reapDurableAgents` calls {@link MailboxStore.drop}
@@ -343,6 +416,9 @@ export declare function judgeMailboxAppendById(box: {
343
416
  * high-water mark, and the same judgment answers from it: the consumed record's `seq` (nothing written),
344
417
  * or the refusal. `drop` clears the window; `reap` keeps it. Acceptance: the window cases of
345
418
  * `mailboxStoreContract` (T1) and `mailboxCrossProcessContract` (T2).
419
+ * {@link MailboxStore.replayOf} is the same judgment asked without writing: a caller that must know whether
420
+ * its record is a repeat BEFORE it spends anything on it (a delivery gate's quota, an inbox bound) asks that,
421
+ * and the answer is the one `append` would give.
346
422
  * - CROSS-PROCESS SAFETY (design/385, optional capability declared on the store): the session-box
347
423
  * drain shares ONE box between several OS processes. A backend that is correct under that sharing —
348
424
  * seq minted once across processes, lease/ack never crossing, one process's housekeeping never
@@ -370,6 +446,17 @@ export interface MailboxStore {
370
446
  /** Durably park one message. Refuses `"mailbox.recipient_tombstoned"` when the backend can see
371
447
  * that its recipient is in the deployment's pre-delete state (see the interface notes above). */
372
448
  append(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number>;
449
+ /**
450
+ * Would `append(scope, handle, msg)` be a REPEAT? The read-only form of the record-identity judgment: the `seq`
451
+ * an append of `msg` would answer from a record the box holds or has received ({@link judgeMailboxAppendById}),
452
+ * `undefined` when it would write a new record (`msg` states no `id`, or the box has none under it), and the
453
+ * {@link MAILBOX_DUPLICATE_RECORD_ID_CODE} refusal an append would give when a different record holds the id.
454
+ * Writes nothing, creates no box, mints no seq, and does not consult the recipient's pre-delete state: a record
455
+ * the box already took is answered with its first `seq` whether or not its recipient is being deleted since. A
456
+ * malformed `msg` is refused with the codes `append` refuses it with, before anything is read. An answer is a
457
+ * snapshot: a repeat racing the first append can still read `undefined`, and its `append` then decides.
458
+ */
459
+ replayOf(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number | undefined>;
373
460
  claimLease(scope: string, handle: string, owner: string, ttlMs: number, now?: number): Promise<MailboxLease | null>;
374
461
  /**
375
462
  * Consume the leased prefix up to `upToSeq` (the records are DELETED). Fenced by the current lease:
@@ -385,15 +472,20 @@ export interface MailboxStore {
385
472
  ack(scope: string, handle: string, owner: string, upToSeq: number): Promise<MailboxAckResult>;
386
473
  /**
387
474
  * Move one record's hold decision from `expect` (absent = never held) to `next`, atomically
388
- * against every other transition and against `ack` — the compare-and-set every decision about a held
389
- * record goes through. NOT fenced by the lease: a person answers from whichever process shows the
390
- * record, whether or not it holds the box. A state that is not `expect` answers `{ ok: false, current }`
391
- * and changes nothing; a record no longer in the box answers `current: "gone"`. A malformed call (see
392
- * {@link assertMailboxDecisionMove}) is refused with {@link MAILBOX_INVALID_DECISION_MOVE_CODE}
393
- * before any side effect. The state is durable like the record, and `ack` / `reap` / `drop` remove it
394
- * with the record.
475
+ * against every other transition, against `claimLease` and against `ack` — the compare-and-set every decision
476
+ * about a held record goes through. A person's or a policy's answer about a held record is NOT fenced by the
477
+ * lease: it comes from whichever process shows the record, whether or not it holds the box. An edge out of
478
+ * `delivered` is: the record was handed over and its injection is owed by the box's lease holder, so the move
479
+ * happens only when the box's CURRENT lease names `holder` (the lease owner the caller claims the box with —
480
+ * the fence {@link ack} takes, read in the same atomic step as the record's state; {@link mailboxDecisionMoveFenced}
481
+ * is the one reading). `holder` absent = the caller claims no lease; on every other edge it is not read. A state
482
+ * that is not `expect` answers `{ ok: false, current }` and changes nothing; a move the lease fence refuses answers
483
+ * `{ ok: false, current: "delivered" }` and changes nothing; a record no longer in the box answers
484
+ * `current: "gone"`. A malformed call (see {@link assertMailboxDecisionMove}) is refused with
485
+ * {@link MAILBOX_INVALID_DECISION_MOVE_CODE} before any side effect. The state is durable like the record, and
486
+ * `ack` / `reap` / `drop` remove it with the record.
395
487
  */
396
- moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
488
+ moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
397
489
  releaseLease(scope: string, handle: string, owner: string): Promise<void>;
398
490
  /** Observation face (the "N pending" receipt figure) — count of currently-visible messages. */
399
491
  peekCount(scope: string, handle: string): Promise<number>;
@@ -503,9 +595,10 @@ export declare class InMemoryMailboxStore implements MailboxStore {
503
595
  private key;
504
596
  private box;
505
597
  append(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number>;
598
+ replayOf(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number | undefined>;
506
599
  claimLease(scope: string, handle: string, owner: string, ttlMs: number, now?: number): Promise<MailboxLease | null>;
507
600
  ack(scope: string, handle: string, owner: string, upToSeq: number): Promise<MailboxAckResult>;
508
- moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
601
+ moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
509
602
  releaseLease(scope: string, handle: string, owner: string): Promise<void>;
510
603
  peekCount(scope: string, handle: string): Promise<number>;
511
604
  drop(scope: string, handle: string): Promise<void>;
@@ -1,6 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
+ import { isFiniteNumber, isListOf, isRecord, isRowCorrupt, isString, optional, required, rowShapeReader, takesExit, via } from "./row-shape.js";
2
3
  import { receiveRetentionPolicy } from "./retention-policy.js";
3
4
  import { readMemberGroup } from "./member-group.js";
5
+ import { NAME_MAX_CHARS, hasVisibleContent } from "./principal-name.js";
4
6
  export const MAILBOX_DECISIONS = Object.freeze(["held", "approved", "delivered", "denied", "expired", "refused", "dropped"]);
5
7
  export function readStoredMailboxDecision(raw) {
6
8
  if (raw === undefined)
@@ -8,6 +10,17 @@ export function readStoredMailboxDecision(raw) {
8
10
  return isMailboxDecision(raw) ? raw : "held";
9
11
  }
10
12
  export const MAILBOX_INVALID_DECISION_MOVE_CODE = "mailbox.invalid_decision_move";
13
+ export const MAILBOX_INVALID_LEASE_OWNER_CODE = "mailbox.invalid_lease_owner";
14
+ const CONTROL_CHARACTER = /\p{Cc}/u;
15
+ const FORMAT_CHARACTER = /(?![\u200c\u200d])\p{Cf}/u;
16
+ export function isMailboxNameSpelling(raw) {
17
+ return typeof raw === "string" && hasVisibleContent(raw) && raw.length <= NAME_MAX_CHARS && !CONTROL_CHARACTER.test(raw) && !FORMAT_CHARACTER.test(raw);
18
+ }
19
+ export function assertMailboxLeaseOwner(owner) {
20
+ if (!isMailboxNameSpelling(owner)) {
21
+ throw new MailboxStoreError(MAILBOX_INVALID_LEASE_OWNER_CODE, `MailboxStore.claimLease: owner must be a string with a non-blank character and no control character, no format character, and at most ${NAME_MAX_CHARS} characters`);
22
+ }
23
+ }
11
24
  export function isMailboxDecision(value) {
12
25
  return typeof value === "string" && MAILBOX_DECISIONS.includes(value);
13
26
  }
@@ -28,21 +41,26 @@ export function mailboxDecisionEdgeAllowed(from, to) {
28
41
  return to === "dropped";
29
42
  return false;
30
43
  }
31
- export async function moveMailboxDecision(store, scope, handle, seq, expect, next) {
44
+ export function mailboxDecisionMoveFenced(expect, leaseOwner, holder) {
45
+ return expect === "delivered" && (holder === undefined || leaseOwner !== holder);
46
+ }
47
+ export async function moveMailboxDecision(store, scope, handle, seq, expect, next, holder) {
32
48
  try {
33
- return await store.moveDecision(scope, handle, seq, expect, next);
49
+ return await store.moveDecision(scope, handle, seq, expect, next, holder);
34
50
  }
35
51
  catch {
36
- const again = await store.moveDecision(scope, handle, seq, expect, next);
52
+ const again = await store.moveDecision(scope, handle, seq, expect, next, holder);
37
53
  return !again.ok && again.current === next ? { ok: true } : again;
38
54
  }
39
55
  }
40
- export function assertMailboxDecisionMove(seq, expect, next) {
56
+ export function assertMailboxDecisionMove(seq, expect, next, holder) {
41
57
  const refuse = (why) => {
42
58
  throw new MailboxStoreError(MAILBOX_INVALID_DECISION_MOVE_CODE, `MailboxStore.moveDecision: ${why}`);
43
59
  };
44
60
  if (typeof seq !== "number" || !Number.isInteger(seq) || seq < 1)
45
61
  refuse(`seq must be a positive integer (got ${String(seq)})`);
62
+ if (holder !== undefined && !isMailboxNameSpelling(holder))
63
+ refuse(`holder must be absent or a lease owner spelling — a string with a non-blank character and no control character, no format character, and at most ${NAME_MAX_CHARS} characters (got ${typeof holder === "string" ? "a string that is not one" : typeof holder})`);
46
64
  if (expect !== undefined && !isMailboxDecision(expect))
47
65
  refuse(`expect must be absent or one of ${MAILBOX_DECISIONS.join("|")}`);
48
66
  if (!isMailboxDecision(next))
@@ -144,6 +162,7 @@ export function cloneMailboxPeerMeta(meta) {
144
162
  return meta === undefined ? undefined : { ...meta, ...(meta.notice !== undefined ? { notice: { ...meta.notice } } : {}) };
145
163
  }
146
164
  export const MAILBOX_TOMBSTONED_RECIPIENT_CODE = "mailbox.recipient_tombstoned";
165
+ export const MAILBOX_ROW_MALFORMED_CODE = "mailbox.row_malformed";
147
166
  export class MailboxStoreError extends Error {
148
167
  code;
149
168
  constructor(code, message) {
@@ -183,14 +202,62 @@ export function readMailboxAppend(msg) {
183
202
  const content = msg.content;
184
203
  const sentAt = msg.sentAt;
185
204
  const hopChain = msg.hopChain;
186
- return {
205
+ const record = {
187
206
  ...(id !== undefined ? { id } : {}),
188
207
  ...(from !== undefined ? { from } : {}),
189
208
  content,
190
209
  sentAt,
191
- ...(hopChain !== undefined ? { hopChain: [...hopChain] } : {}),
210
+ ...(hopChain !== undefined ? { hopChain } : {}),
192
211
  ...(peerMeta !== undefined ? { peerMeta } : {}),
193
212
  };
213
+ const answer = MAILBOX_MESSAGE_ROW_SHAPE.admit(record, { key: "" }, ["members"]);
214
+ if (isRowCorrupt(answer))
215
+ throw new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.append: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(answer)}`);
216
+ return { ...record, ...(hopChain !== undefined ? { hopChain: [...hopChain] } : {}) };
217
+ }
218
+ const isChainHop = (v) => (v === undefined || v === null || typeof v === "string" ? undefined : "is not a string");
219
+ export const MAILBOX_MESSAGE_ROW_SHAPE = rowShapeReader({
220
+ family: "mailbox",
221
+ code: MAILBOX_ROW_MALFORMED_CODE,
222
+ sentence: "This mailbox holds a record that does not read the way this engine reads a parked message — an earlier engine release wrote it, or it was changed in storage. Delivery stops in front of it: the records before it are delivered, and nothing at or after it is leased, acknowledged or counted until the box is dropped or the record repaired.",
223
+ exit: "block",
224
+ segments: [
225
+ { name: "rowKey", entries: [required("seq", isFiniteNumber)] },
226
+ {
227
+ name: "members",
228
+ entries: [
229
+ required("content", isString),
230
+ required("sentAt", isFiniteNumber),
231
+ via("id", readMailboxRecordId),
232
+ optional("from", isString),
233
+ optional("hopChain", isListOf(isChainHop)),
234
+ optional("peerMeta", isRecord),
235
+ via("decision", readStoredMailboxDecision),
236
+ ],
237
+ },
238
+ ],
239
+ });
240
+ export function mailboxReadablePrefix(messages) {
241
+ const prefix = [];
242
+ for (const m of messages) {
243
+ const answer = MAILBOX_MESSAGE_ROW_SHAPE.read(m, { key: String(m.seq) });
244
+ if (!isRowCorrupt(answer)) {
245
+ prefix.push(answer.row);
246
+ continue;
247
+ }
248
+ takesExit(answer, "block", "mailbox delivery");
249
+ return { prefix, blocked: { seq: m.seq, corrupt: answer } };
250
+ }
251
+ return { prefix };
252
+ }
253
+ export function mailboxBlockedSentence(scope, handle, blocked) {
254
+ return `mailbox (${JSON.stringify(scope)}, ${JSON.stringify(handle)}): the record at seq ${blocked.seq} does not read (${blocked.corrupt.why}) — delivery stops in front of it`;
255
+ }
256
+ export function mailboxAckBlockedRefusal(blocked) {
257
+ return new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.ack: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(blocked.corrupt)} Nothing was consumed: an ack stops before seq ${blocked.seq}.`);
258
+ }
259
+ export function mailboxDecisionOnUnreadableRefusal(corrupt) {
260
+ return new MailboxStoreError(MAILBOX_ROW_MALFORMED_CODE, `MailboxStore.moveDecision: ${MAILBOX_MESSAGE_ROW_SHAPE.refusalText(corrupt)}`);
194
261
  }
195
262
  function facetSpelling(v) {
196
263
  if (v === undefined || v === null)
@@ -288,15 +355,26 @@ export class InMemoryMailboxStore {
288
355
  b.messages.push({ seq, ...record });
289
356
  return seq;
290
357
  }
358
+ async replayOf(scope, handle, msg) {
359
+ if (scope === undefined || scope === "")
360
+ throw new Error("MailboxStore.replayOf: refusing a message without a scope");
361
+ const record = readMailboxAppend(msg);
362
+ const b = this.boxes.get(this.key(scope, handle));
363
+ return judgeMailboxAppendById({ held: b?.messages ?? [], consumed: b?.consumed ?? [] }, record);
364
+ }
291
365
  async claimLease(scope, handle, owner, ttlMs, now = Date.now()) {
366
+ assertMailboxLeaseOwner(owner);
292
367
  const b = this.boxes.get(this.key(scope, handle));
293
- if (!b || b.messages.length === 0)
368
+ if (!b)
369
+ return null;
370
+ const { prefix } = mailboxReadablePrefix(b.messages);
371
+ if (prefix.length === 0)
294
372
  return null;
295
373
  if (b.lease !== undefined && b.lease.expiresAt > now && b.lease.owner !== owner)
296
374
  return null;
297
- const maxSeq = b.messages[b.messages.length - 1].seq;
375
+ const maxSeq = prefix[prefix.length - 1].seq;
298
376
  b.lease = { owner, expiresAt: now + ttlMs, maxSeq };
299
- return { messages: b.messages.map((m) => detachMailboxMessage(m)), maxSeq };
377
+ return { messages: prefix.map((m) => detachMailboxMessage(m)), maxSeq };
300
378
  }
301
379
  async ack(scope, handle, owner, upToSeq) {
302
380
  const b = this.boxes.get(this.key(scope, handle));
@@ -304,19 +382,28 @@ export class InMemoryMailboxStore {
304
382
  return { acked: false };
305
383
  if (b.lease === undefined || b.lease.owner !== owner)
306
384
  return { acked: false };
385
+ const { blocked } = mailboxReadablePrefix(b.messages);
386
+ if (blocked !== undefined && upToSeq >= blocked.seq)
387
+ throw mailboxAckBlockedRefusal(blocked);
307
388
  b.consumed = foldMailboxConsumed(b.consumed, b.messages.filter((m) => m.seq <= upToSeq));
308
389
  b.messages = b.messages.filter((m) => m.seq > upToSeq);
309
390
  if (b.lease.maxSeq <= upToSeq)
310
391
  b.lease = undefined;
311
392
  return { acked: true };
312
393
  }
313
- async moveDecision(scope, handle, seq, expect, next) {
314
- assertMailboxDecisionMove(seq, expect, next);
315
- const m = this.boxes.get(this.key(scope, handle))?.messages.find((x) => x.seq === seq);
394
+ async moveDecision(scope, handle, seq, expect, next, holder) {
395
+ assertMailboxDecisionMove(seq, expect, next, holder);
396
+ const b = this.boxes.get(this.key(scope, handle));
397
+ const m = b?.messages.find((x) => x.seq === seq);
316
398
  if (m === undefined)
317
399
  return { ok: false, current: "gone" };
400
+ const read = MAILBOX_MESSAGE_ROW_SHAPE.read(m, { key: String(m.seq) });
401
+ if (isRowCorrupt(read))
402
+ throw mailboxDecisionOnUnreadableRefusal(read);
318
403
  if (m.decision !== expect)
319
404
  return { ok: false, current: m.decision ?? "unset" };
405
+ if (mailboxDecisionMoveFenced(expect, b?.lease?.owner, holder))
406
+ return { ok: false, current: m.decision ?? "unset" };
320
407
  m.decision = next;
321
408
  return { ok: true };
322
409
  }
@@ -326,7 +413,8 @@ export class InMemoryMailboxStore {
326
413
  b.lease = undefined;
327
414
  }
328
415
  async peekCount(scope, handle) {
329
- return this.boxes.get(this.key(scope, handle))?.messages.length ?? 0;
416
+ const b = this.boxes.get(this.key(scope, handle));
417
+ return b === undefined ? 0 : mailboxReadablePrefix(b.messages).prefix.length;
330
418
  }
331
419
  async drop(scope, handle) {
332
420
  this.boxes.delete(this.key(scope, handle));
@@ -1,7 +1,7 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import { types } from "node:util";
3
3
  import { isPlainRecord } from "./mods/kernel/receive.js";
4
- import { callerText, dataKind } from "./mcp-server-spec.js";
4
+ import { callerText, dataKind } from "./caller-text.js";
5
5
  export const MCP_TOOL_USE_ID_META_KEY = "sema/toolUseId";
6
6
  export const MCP_REQUEST_META_KEY = "sema/requestMeta";
7
7
  export const MCP_REQUEST_META_MAX_BYTES = 262_144;
@@ -14,7 +14,8 @@
14
14
  * a revived one), so the DECLARATION stays the one source of truth — no handle is ever recorded anywhere.
15
15
  *
16
16
  * THE KEY is the server's declaration as the dial reads it (name and transport) and the principal the task runs under: a
17
- * different principal is a different identity at the server. The transport holds no value (a declaration carries at most an
17
+ * different principal is a different identity at the server. A task whose isolation scope names a partition other than that
18
+ * person adds it to the key (a connection's state between requests is one partition's working state). The transport holds no value (a declaration carries at most an
18
19
  * opaque credential reference, so two references that differ never share a connection); the pieces a request carries are the
19
20
  * peer seat's, asked under this same identity, so every holder of a connection sends what the one seat answers for it. A server that opted in to elicitation never enters the pool — the
20
21
  * answer to its questions belongs to the leg that is waiting on it.
@@ -50,8 +51,13 @@ export declare class McpConnectionPool {
50
51
  * So is the startup bound the dial runs under (`startupMs`, the dial's one reading of {@link mcpStartupTimeoutMs}, threaded like `kind`):
51
52
  * a connection is dialled under the declaration of the mount that dials it, so a mount never waits on, or shares, a dial bounded by
52
53
  * another mount's clock. No bound in force (none declared, no environment seat) leaves the key as it always was.
54
+ * So is the task's isolation scope (`isolationScope`, the value of `isolationScopeOf(spec)` — `isolation-scope.ts`) when it names a
55
+ * partition other than the person: what a connection holds between requests (a server-side session, its state) belongs to the working
56
+ * state of one partition, so the same person in two partitions holds two connections. The identity the connection presents at the server
57
+ * stays the person's (`principal`). A partition that is the person (no `TaskSpec.isolationScope`, or the same string) leaves the key as it
58
+ * always was.
53
59
  */
54
- static keyOf(spec: McpServerSpec, principal: string | undefined, kind: string | undefined, startupMs: number | undefined): string;
60
+ static keyOf(spec: McpServerSpec, principal: string | undefined, kind: string | undefined, startupMs: number | undefined, isolationScope?: string): string;
55
61
  /**
56
62
  * Lease the connection for `key`, dialling it with `dial` when none is live. `fresh` replaces the pool's current connection with a new
57
63
  * dial (a re-dial): the connection it replaces lives on until its other holders release it. Resolves `undefined` once the pool is
@@ -10,7 +10,7 @@ export class McpConnectionPool {
10
10
  dialing = new Map();
11
11
  generation = new Map();
12
12
  shut = false;
13
- static keyOf(spec, principal, kind, startupMs) {
13
+ static keyOf(spec, principal, kind, startupMs, isolationScope) {
14
14
  const rest = Object.fromEntries(Object.keys(spec.transport).filter((k) => k !== "kind").map((k) => [k, Reflect.get(spec.transport, k)]));
15
15
  const fingerprint = spec.fingerprint;
16
16
  const identity = [spec.name, kind ?? null, rest, principal ?? null];
@@ -18,6 +18,8 @@ export class McpConnectionPool {
18
18
  identity.push(fingerprint);
19
19
  if (startupMs !== undefined)
20
20
  identity.push({ startupTimeoutMs: startupMs });
21
+ if (isolationScope !== undefined && isolationScope !== principal)
22
+ identity.push({ isolationScope });
21
23
  return canonicalize(identity);
22
24
  }
23
25
  async acquire(key, dial, opts) {
@@ -34,10 +34,13 @@ import type { McpTransportKind } from "./mcp-server-spec.js";
34
34
  * remote, or handed its dial no pipe the engine could take (it said so, or what it handed is no
35
35
  * transport or was already taken): nothing ran, and nothing is said about whether the remote can be
36
36
  * reached;
37
+ * · `revoked` — the deployment's revocation ledger answered that the server or peer is withdrawn, so the engine did not send
38
+ * the request — or, at a redirect, its next hop (protocol-revocation.ts): nothing is said about whether the remote
39
+ * can be reached;
37
40
  * · `unknown` — the thrown value carried no structure this table reads, or the host seat took the request
38
41
  * and cannot tell how it ended (said at the dial, nothing of the caller's was sent either way).
39
42
  */
40
- export declare const MCP_FAILURE_KINDS: readonly ["connect_refused", "connection_failed", "connection_closed", "unauthorized", "http_status", "not_mcp_response", "spawn_failed", "timeout", "protocol", "invalid_config", "credential_unavailable", "host_refused", "unknown"];
43
+ export declare const MCP_FAILURE_KINDS: readonly ["connect_refused", "connection_failed", "connection_closed", "unauthorized", "http_status", "not_mcp_response", "spawn_failed", "timeout", "protocol", "invalid_config", "credential_unavailable", "host_refused", "revoked", "unknown"];
41
44
  export type McpFailureKind = (typeof MCP_FAILURE_KINDS)[number];
42
45
  /**
43
46
  * Why a server is `unauthorized` ({@link McpAuthorization.reason}), closed:
@@ -90,6 +93,7 @@ export declare const DELIVERED_BY_KIND: {
90
93
  readonly invalid_config: "no";
91
94
  readonly credential_unavailable: "no";
92
95
  readonly host_refused: "no";
96
+ readonly revoked: "unknown";
93
97
  readonly unknown: "unknown";
94
98
  };
95
99
  /** The fence over the delivery table: `never` while every kind has a verdict. */
@@ -154,6 +158,7 @@ export declare const LIVENESS_BY_FAILURE_KIND: {
154
158
  readonly invalid_config: undefined;
155
159
  readonly credential_unavailable: undefined;
156
160
  readonly host_refused: undefined;
161
+ readonly revoked: undefined;
157
162
  readonly unknown: "unknown";
158
163
  };
159
164
  /** The fence over the liveness table: `never` while every kind has a verdict. */