@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,7 +1,4 @@
1
- import { PROJECT_CONTEXT_FRAMING } from "../../prompts/default.js";
2
1
  import { MEMORY_ENGINE_TOOL_NAMES } from "../memory-engine/tools.js";
3
- import { composeMemoryBlock } from "../memory.js";
4
- import { hasConversationContent } from "../session.js";
5
2
  import { createSharedMemoryTools } from "../shared-memory/tools.js";
6
3
  import { SHARED_MEMORY_TOOL_NAMES } from "../shared-memory/types.js";
7
4
  import { defineTool } from "../tools.js";
@@ -9,82 +6,17 @@ import { readFrozenSkillGrants, seedSkillGrants, skillSeatReader, tellRetiredSki
9
6
  import { allowedToolsNotGrantedNotice, classifiesAllShell, seedAllowEntryTables } from "../allow-entry.js";
10
7
  import { deliverEngineNotice } from "../engine-notice.js";
11
8
  import { announceMemoryNotMounted } from "./announce-once-ledger.js";
9
+ import { instructionFamilyOf } from "./nested-memory-lane.js";
12
10
  import { SKILL_CONTENT_MAX_CHARS, SKILL_TOOL_NAME, createSkillTool, normalizeSkills } from "./synthetic-tools.js";
13
11
  import { skillLoadReading } from "./skill-base-dir.js";
14
12
  import { RosterBuilder } from "../tool-roster.js";
15
13
  import { mountedToolNames } from "../tool-name-aliases.js";
16
14
  import { valveLeaves } from "../../agents/tool-filter.js";
17
- import { asThrownError } from "../thrown-value.js";
18
15
  export async function prepareProjectContext(input) {
19
- const { deps, spec, internals, session, sessionId, runId, hostTaskId, taskRootFinal, handsEnabled, delegation, seedContextFiles, memoryBlockFromEngine, skillGrants, allowedTools, allowedToolTables, roster, toolFaceSnapshot, onceLedger, memoryTools, memoryEngineSession, memorySearchToolsPlanned, memoryPairExcludedName, memoryPairOccupiedName, resume, skillListingBudget } = input;
16
+ const { deps, spec, internals, sessionId, hostTaskId, skillGrants, allowedTools, allowedToolTables, roster, toolFaceSnapshot, onceLedger, memoryTools, memoryEngineSession, memorySearchToolsPlanned, memoryPairExcludedName, memoryPairOccupiedName, resume, skillListingBudget } = input;
20
17
  const tools = roster.tools;
21
18
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
22
- let memoryBlock = memoryBlockFromEngine;
23
- let instructionSources;
24
- let projectInstructionContent;
25
- const seam = deps.loadProjectMemory;
26
- const loadProjectMemory = seam && spec.projectMemory === undefined ? seam : undefined;
27
- const projectMemoryFact = loadProjectMemory ? "on" : seam ? "disabled" : "absent";
28
- if (loadProjectMemory) {
29
- let projectMemoryPhase = spec.sessionId ? "resume" : "fresh";
30
- if (spec.sessionId) {
31
- try {
32
- const branch = await session.getBranch();
33
- const hasConversation = hasConversationContent(branch);
34
- if (!hasConversation)
35
- projectMemoryPhase = "fresh";
36
- else {
37
- for (let i = branch.length - 1; i >= 0; i--) {
38
- const e = branch[i];
39
- if (e.type === "compaction") {
40
- projectMemoryPhase = "post-compact";
41
- break;
42
- }
43
- if (e.type === "message" && e.message.role === "user")
44
- break;
45
- }
46
- }
47
- }
48
- catch {
49
- }
50
- }
51
- let loaded;
52
- try {
53
- const answered = await Promise.resolve(loadProjectMemory.call(deps, {
54
- cwd: taskRootFinal,
55
- handsEnabled,
56
- isSubagent: delegation.isNonForkChild,
57
- ...(internals?.agentName ? { agentName: internals.agentName } : {}),
58
- sessionId,
59
- runId,
60
- phase: projectMemoryPhase,
61
- }));
62
- if (answered === null || typeof answered !== "object")
63
- throw new Error(`RunnerDeps.loadProjectMemory answered ${answered === null ? "null" : typeof answered} — the answer is a ProjectMemoryLoad object ({ content: string | null, … }); answer { content: null } for no project layer. Not read: this leg runs with no project layer.`);
64
- loaded = answered;
65
- }
66
- catch (err) {
67
- deps.onError?.(asThrownError(err), { phase: "config", sessionId });
68
- }
69
- const projectMem = loaded?.content;
70
- const seededFiles = loaded?.seededFiles;
71
- const declaredSources = loaded?.instructionSources;
72
- if (declaredSources !== undefined && declaredSources.length > 0)
73
- instructionSources = declaredSources;
74
- if (seededFiles?.length && seedContextFiles) {
75
- try {
76
- await seedContextFiles(seededFiles);
77
- }
78
- catch (err) {
79
- deps.onError?.(asThrownError(err), { phase: "config", sessionId });
80
- }
81
- }
82
- if (projectMem != null && projectMem.trim()) {
83
- projectInstructionContent = projectMem;
84
- const projectBlock = `${PROJECT_CONTEXT_FRAMING}\n\n${composeMemoryBlock(projectMem, "project")}`;
85
- memoryBlock = memoryBlock ? `${memoryBlock}\n\n${projectBlock}` : projectBlock;
86
- }
87
- }
19
+ const projectMemoryFact = instructionFamilyOf(spec) === undefined ? "absent" : spec.projectMemory === "disabled" ? "disabled" : "on";
88
20
  const declaredSkillRank = new Map();
89
21
  for (const s of spec.skills ?? [])
90
22
  if (!declaredSkillRank.has(s.name))
@@ -105,7 +37,8 @@ export async function prepareProjectContext(input) {
105
37
  const inert = seedAllowEntryTables(allowedToolTables, { skillInert: tellRetiredSkillDeny(deps.onNotice, seedSkillGrants(skillGrants, { skills: skillSpecs, userInvokedSkills: spec.userInvokedSkills, inherited: [...(internals?.inheritedSkillGrants ?? []), ...frozenSkillGrants] }), sessionId, mounted()), inherited: internals?.inheritedAllowedTools, request: allowedTools, deployment: deps.allowedTools }, mounted());
106
38
  if (inert.length > 0)
107
39
  deliverEngineNotice(deps.onNotice, allowedToolsNotGrantedNotice(inert, sessionId));
108
- if (skillSpecs.length > 0) {
40
+ roster.mounts.know({ "listing.skills": skillSpecs.length > 0 });
41
+ if (roster.mounts.judge("skill")) {
109
42
  if (tools.some((t) => t.name === SKILL_TOOL_NAME)) {
110
43
  const e = new Error(`Tool name "${SKILL_TOOL_NAME}" is reserved when spec.skills is present.`);
111
44
  e.code = "config.reserved_tool_name";
@@ -123,24 +56,28 @@ export async function prepareProjectContext(input) {
123
56
  for (const alias of t.aliases ?? [])
124
57
  mountedNameDomain.add(alias);
125
58
  }
126
- const excludedName = SHARED_MEMORY_TOOL_NAMES.find((n) => !leaves({ name: n }));
127
59
  const occupiedName = SHARED_MEMORY_TOOL_NAMES.find((n) => mountedNameDomain.has(n));
128
- if (excludedName !== undefined || occupiedName !== undefined) {
129
- announceMemoryNotMounted(onceLedger, sessionId, "shared", SHARED_MEMORY_TOOL_NAMES, excludedName !== undefined
130
- ? `the run's tool face (allowTools / excludeTools / excludeAllTools) does not admit "${excludedName}"`
131
- : `this task already declares a tool named "${occupiedName}" (the built-in yields to it)`);
132
- }
133
- else {
60
+ roster.mounts.know({ "names.occupied.sharedMemory": occupiedName !== undefined });
61
+ if (roster.mounts.holds("memory-list")) {
134
62
  roster.mountAll(createSharedMemoryTools({
135
63
  provider: sharedMemoryProvider,
136
64
  context: { sessionId, taskId: hostTaskId, ...(spec.principal !== undefined ? { principal: spec.principal } : {}) },
137
- }).map((s) => defineTool(s)), { source: "builtin", mountedBy: "memory" });
65
+ })
66
+ .map((s) => defineTool(s))
67
+ .filter((t) => roster.mounts.judgeTool(t)), { source: "builtin", mountedBy: "memory" });
138
68
  sharedMemoryPairMounted = true;
139
69
  }
70
+ else {
71
+ const excludedName = SHARED_MEMORY_TOOL_NAMES.find((n) => !leaves({ name: n }));
72
+ announceMemoryNotMounted(onceLedger, sessionId, "shared", SHARED_MEMORY_TOOL_NAMES, excludedName !== undefined
73
+ ? `the run's tool face (allowTools / excludeTools / excludeAllTools) does not admit "${excludedName}"`
74
+ : `this task already declares a tool named "${occupiedName}" (the built-in yields to it)`);
75
+ }
140
76
  }
141
77
  let memoryEnginePairMounted = false;
142
- if (memoryTools !== undefined && memoryTools.length > 0) {
143
- roster.mountAll(memoryTools.map((s) => defineTool(s)), { source: "builtin", mountedBy: "memory" });
78
+ roster.mounts.know({ "seat.memoryEngine": memoryEngineSession !== undefined && (memoryTools !== undefined || !memorySearchToolsPlanned) });
79
+ if (roster.mounts.holds("memory-search") && memoryTools !== undefined) {
80
+ roster.mountAll(memoryTools.map((s) => defineTool(s)).filter((t) => roster.mounts.judgeTool(t)), { source: "builtin", mountedBy: "memory" });
144
81
  memoryEnginePairMounted = true;
145
82
  }
146
83
  else if (memoryEngineSession !== undefined && !memorySearchToolsPlanned) {
@@ -164,5 +101,5 @@ export async function prepareProjectContext(input) {
164
101
  ?
165
102
  { entries: [], seedAnnounced: true, budget: skillListingBudget }
166
103
  : undefined;
167
- return { memoryBlock, instructionSources, projectMemoryFact, projectInstructionContent, skillSpecs, skillSeatOf, skillsListing, sharedMemoryPairMounted, memoryEnginePairMounted };
104
+ return { projectMemoryFact, skillSpecs, skillSeatOf, skillsListing, sharedMemoryPairMounted, memoryEnginePairMounted };
168
105
  }
@@ -3,7 +3,7 @@ import type { Model } from "../../internal/llm.js";
3
3
  import { assemblePrompt, type AssembledPrompt } from "../../prompt-assembly/assemble.js";
4
4
  import { type CenterAdoption } from "../../prompt-assembly/artifact.js";
5
5
  import { type RunPromptIdentity } from "../../prompt-assembly/epoch.js";
6
- import type { HostForm, HostRole, PromptTraitName } from "../../prompt-assembly/catalog/schema.js";
6
+ import type { HostForm, HostRole, PromptTraitName, RenderedLocale } from "../../prompt-assembly/catalog/schema.js";
7
7
  import type { SourcedOverlay } from "../../prompt-assembly/overlay.js";
8
8
  import { type EnvironmentFacts } from "../../prompts/default.js";
9
9
  import { type LegModBus } from "../mods/stations.js";
@@ -33,6 +33,8 @@ export interface PreparePromptAssemblyInput {
33
33
  };
34
34
  /** borrowed-readonly — the run's binding (`TaskSpec.promptBinding`, validated), or undefined: a selector value. */
35
35
  binding: string | undefined;
36
+ /** borrowed-readonly — the run's locale (`TaskSpec.promptLocale`, validated), or undefined (`canonical`): a selector value. */
37
+ locale: RenderedLocale | undefined;
36
38
  /** borrowed-readonly — the leg's mods bus: `prompt.compose` collects the deploy and task seats' overlays. */
37
39
  modBus: LegModBus;
38
40
  /** borrowed-readonly — the run's abort signal (the compose raise ends with it). */
@@ -93,6 +95,10 @@ export interface PreparePromptAssemblyResult {
93
95
  centerAdoptionRef: {
94
96
  current: CenterAdoption | undefined;
95
97
  };
98
+ /** owned — the head's per-block digests as the session's epoch anchor keeps them (`PrefixHeadDigests.blocks`):
99
+ * unsalted, because the anchor compares across processes, and written only into the session's own store —
100
+ * never onto a trace (the trace's block hashes are the salted ones). */
101
+ prefixHeadBlocks: Readonly<Record<string, string>>;
96
102
  }
97
103
  /** The M13 phase body — prepareTask's prompt-assembly stretch (see the module header). */
98
104
  export declare function preparePromptAssembly(input: PreparePromptAssemblyInput): Promise<PreparePromptAssemblyResult>;
@@ -7,6 +7,7 @@ import { catalogDigestOf, digestOf, prepareEpochRecord } from "../../prompt-asse
7
7
  import { rendererVector } from "../../prompt-assembly/renderers.js";
8
8
  import { SEMA_DEFAULT_CATALOG } from "../../prompt-assembly/catalog/index.js";
9
9
  import { describeCatalog } from "../../prompt-assembly/explain.js";
10
+ import { engineTextFor } from "../../prompt-assembly/engine-text.js";
10
11
  import { selectorRecordOf, selectorsOf } from "../../prompt-assembly/select.js";
11
12
  import { auditToolCollisions, projectToolManifest } from "../../prompt-assembly/tool-catalog.js";
12
13
  import { buildEnvironmentContext } from "../../prompts/default.js";
@@ -14,6 +15,7 @@ import { raisePromptCompose } from "../mods/stations.js";
14
15
  import { protocolOf } from "../protocol-table.js";
15
16
  import { hasConversationContent } from "../session.js";
16
17
  import { PROMPT_HASH_SALT } from "./prompt-hash-salt.js";
18
+ import { prefixHeadBlocksOf } from "./conversation-segment.js";
17
19
  const CATALOG_DIGEST = catalogDigestOf(SEMA_DEFAULT_CATALOG);
18
20
  const TASK_TEXT_DIGEST_SCHEME = "sid-sha256:";
19
21
  function taskLayerDigestOf(sessionId, text) {
@@ -31,7 +33,7 @@ function taskLayerOf(task, sessionId) {
31
33
  }));
32
34
  }
33
35
  export async function preparePromptAssembly(input) {
34
- const { session, deps, internals, resume, sugar, host, binding, modBus, featureFlags, mcpInstructionsBlock, memoryBlock, envFacts, promptTraits, tools, model, sessionId, onceLedger } = input;
36
+ const { session, deps, internals, resume, sugar, host, binding, locale, modBus, featureFlags, mcpInstructionsBlock, memoryBlock, envFacts, promptTraits, tools, model, sessionId, onceLedger } = input;
35
37
  const topLevel = internals?.parentTaskId === undefined && internals?.parentSessionId === undefined && internals?.parentCenterArtifactDigest === undefined;
36
38
  const stored = await session.getPromptEpoch();
37
39
  let centerAdoption;
@@ -87,7 +89,8 @@ export async function preparePromptAssembly(input) {
87
89
  orchestrationEnabled: featureFlags.orchestrationEnabled && tools.some((t) => t.name === "Workflow"),
88
90
  orchestrationDeferred: featureFlags.orchestrationDeferred && tools.some((t) => t.name === "Workflow"),
89
91
  };
90
- const selectorRecord = selectorRecordOf(selectorsOf(facts, host, binding, promptTraits));
92
+ const selectors = selectorsOf(facts, host, binding, promptTraits, locale);
93
+ const selectorRecord = selectorRecordOf(selectors);
91
94
  const centerOverlays = centerOverlaysOf(centerAdoption);
92
95
  const lowerAdds = new Map();
93
96
  for (const { overlay } of [...sugar, ...centerOverlays])
@@ -105,15 +108,13 @@ export async function preparePromptAssembly(input) {
105
108
  taskOverlays,
106
109
  centerOverlays: centerOverlaysOf(center),
107
110
  deployOverlays: composed.deploy,
108
- host,
109
- ...(binding !== undefined ? { binding } : {}),
110
- traits: promptTraits,
111
+ selectors,
111
112
  tools,
112
113
  facts,
113
114
  ...(envFacts.cwd !== undefined ? { workspaceFolder: envFacts.cwd } : {}),
114
115
  mcpInstructionsBlock,
115
116
  memoryBlock,
116
- buildEnvBlock: (date) => buildEnvironmentContext({ ...envFacts, date }) || undefined,
117
+ buildEnvBlock: (date) => buildEnvironmentContext({ ...envFacts, date }, engineTextFor(selectors.locale)) || undefined,
117
118
  date: envFacts.date,
118
119
  onWarn: (message, phase) => deps.onError?.(new Error(message), { phase, sessionId }),
119
120
  });
@@ -167,7 +168,7 @@ export async function preparePromptAssembly(input) {
167
168
  ...(s.variant !== undefined ? { variant: s.variant } : {}),
168
169
  ...(s.renderer !== undefined ? { renderer: { ...s.renderer } } : {}),
169
170
  chars: s.text.length,
170
- locale: s.chain.some((l) => l.source !== "bundled" && l.superseded !== true) ? "overlay" : "canonical",
171
+ locale: s.chain.some((l) => l.source !== "bundled" && l.superseded !== true) ? "overlay" : s.variant !== undefined ? selectors.locale : "canonical",
171
172
  contentHash: contentHashOf(s),
172
173
  chain: s.chain.map((l) => ({ ...l })),
173
174
  })),
@@ -185,6 +186,7 @@ export async function preparePromptAssembly(input) {
185
186
  },
186
187
  renderWithDate,
187
188
  systemBlocks: assembled.systemBlocks,
189
+ prefixHeadBlocks: prefixHeadBlocksOf(promptBlocks),
188
190
  promptManifest,
189
191
  promptIdentity,
190
192
  buildAssembleInputs,
@@ -24,6 +24,7 @@ import type { ExecutionEnv, ThinkingLevel } from "../../internal/harness.js";
24
24
  import type { Model } from "../../internal/llm.js";
25
25
  import { type EnvironmentFacts } from "../../prompts/default.js";
26
26
  import type { HostRole } from "../../prompt-assembly/catalog/schema.js";
27
+ import type { EngineText } from "../../prompt-assembly/engine-text.js";
27
28
  import { type RequestBodySugar } from "../../prompt-assembly/sugar.js";
28
29
  import type { ContainmentFace } from "../../tools/fs/index.js";
29
30
  import type { LockedPreflight } from "../locked-config.js";
@@ -60,6 +61,11 @@ export interface PreparePromptInputsInput {
60
61
  executionEnv: ExecutionEnv;
61
62
  /** borrowed-readonly — the session's reminder mark (rides the prompt facts for the declaration). */
62
63
  reminderMark: string;
64
+ /** borrowed-readonly — the memory phase's verdict that this run has no store to persist through (the memory section's
65
+ * no-persistent-store sentence rides the prompt facts). */
66
+ memoryStoreAbsent: boolean;
67
+ /** borrowed-readonly — the run's engine text reading (its locale's): the stable MCP block's catalog lines. */
68
+ engineText: EngineText;
63
69
  /** borrowed-readonly — the resolved read face (the open-reads flag + the structured env fact). */
64
70
  resolvedReadFace: ContainmentFace | undefined;
65
71
  /** borrowed-readonly — the resolved write face (the open-writes flag + the structured env fact). */
@@ -67,9 +73,9 @@ export interface PreparePromptInputsInput {
67
73
  /** borrowed-readonly — the frozen tool face; `defer` (the Workflow short-pointer flag) and `selector` (with the spec's whole-face
68
74
  * switch, the valve's reading that decides which servers' instructions are taught). */
69
75
  toolFaceSnapshot: Pick<ToolFaceSnapshot, "defer" | "selector">;
70
- /** borrowed-readonly — trusted internals: `goalMode` (goal flag), `isolation` (worktree flag),
71
- * `defaultSystemPrompt` (the sugar's third source). `undefined` on a standalone prepare. */
72
- internals: Pick<RunInternals, "goalMode" | "isolation" | "defaultSystemPrompt"> | undefined;
76
+ /** borrowed-readonly — trusted internals: `goalMode` (goal flag), `isolation` (worktree flag). `undefined` on a
77
+ * standalone prepare. */
78
+ internals: Pick<RunInternals, "goalMode" | "isolation"> | undefined;
73
79
  /** borrowed-readonly — the resolved, role-folded reasoning tier (the awareness flag's input). */
74
80
  thinking: ThinkingLevel | undefined;
75
81
  /** borrowed-readonly — the factory-minted isolated env, read for PRESENCE only (the worktree flag's
@@ -30,12 +30,14 @@ export async function preparePromptInputs(input) {
30
30
  worktreeIsolated: internals?.isolation === "worktree" && ownedEnv !== undefined,
31
31
  withinTaskCompactionEnabled: compactionEnabled("autoCompact", spec.compaction, input.contextOverlay) && (spec.compaction?.withinTask ?? true),
32
32
  isSubagent: delegation.isNonForkChild,
33
+ memoryStoreAbsent: input.memoryStoreAbsent,
33
34
  };
34
- const sugar = requestBodySugar({ spec, resolvedRole, ...(input.taskRole !== undefined ? { taskRole: input.taskRole } : {}), ...(internals !== undefined ? { internals } : {}) });
35
+ const sugar = requestBodySugar({ spec, resolvedRole, ...(input.taskRole !== undefined ? { taskRole: input.taskRole } : {}) });
35
36
  const valveLeft = valveLeaves(spec, toolFaceSnapshot.selector);
36
37
  const taught = mcp.serverInstructions.filter((entry) => instructionsTaught(valveLeft, entry.server, input.roster.tools, mcp.tools));
37
- toldAtStart(mcp.instructionsDelta, new Set(taught.map((entry) => entry.server)));
38
- const mcpInstructionsBlock = taught.length ? `# MCP Server Instructions\n${taught.map(renderMcpInstructionsEntry).join("\n\n")}` : undefined;
38
+ toldAtStart(mcp.instructionsDelta, taught);
39
+ const say = input.engineText;
40
+ const mcpInstructionsBlock = taught.length ? `${say("core/engine.mcp-header")}\n${taught.map((entry) => renderMcpInstructionsEntry(entry, say)).join("\n\n")}` : undefined;
39
41
  const userTz = spec.clientContext?.timeZone;
40
42
  const tzValid = userTz !== undefined && isValidTimeZone(userTz);
41
43
  const dateAnchor = await readDateAnchor(session);
@@ -38,14 +38,15 @@ export interface PrepareProtocolToolsInput {
38
38
  lockedPreflight: Pick<LockedPreflight, "mcp" | "a2a">;
39
39
  /** borrowed-readonly — the deployment's host floor as the config doors compiled it: each MCP http dial and every A2A request is judged by it. */
40
40
  hostFloor: import("../host-floor.js").HostFloor | undefined;
41
- /** borrowed-readonly — the REBOUND spec. Read: `principal` (the MCP header / the A2A identity), `tools`
41
+ /** borrowed-readonly — the REBOUND spec. Read: `principal` (the MCP header / the A2A identity), `isolationScope` (with `principal`,
42
+ * through `isolationScopeOf`: the partition the MCP pool keys this leg's connections under), `tools`
42
43
  * (the caller names both reserved-name guards check against), `excludeAllTools` (the valve's whole-face switch: the live roster lane's
43
44
  * reading, and the first-dial gate), `signal` (the host's abort, which stops an MCP dial). */
44
- spec: Pick<TaskSpec, "principal" | "tools" | "excludeAllTools" | "signal">;
45
+ spec: Pick<TaskSpec, "principal" | "isolationScope" | "tools" | "excludeAllTools" | "signal">;
45
46
  /** borrowed-readonly — the deployment seats the materializers and their operator faces read: `onElicit`
46
47
  * and `imageProcessor` ride into the MCP intake; `onError` takes the A2A warnings (no ledger — a peer is
47
- * re-read every prepare); `mcpRevocations` + `onNotice` make the revocation wiring; `peerSeat` answers what each MCP / A2A request carries. */
48
- deps: Pick<RunnerDeps, "onElicit" | "imageProcessor" | "onError" | "mcpRevocations" | "onNotice" | "peerSeat">;
48
+ * re-read every prepare); `protocolRevocations` + `onNotice` make the leg's one revocation probe; `peerSeat` answers what each MCP / A2A request carries. */
49
+ deps: Pick<RunnerDeps, "onElicit" | "imageProcessor" | "onError" | "protocolRevocations" | "onNotice" | "peerSeat">;
49
50
  /** borrowed-readonly — the leg's mods bus: its `prompt.section` station disposes of each server's instructions at the dial. */
50
51
  modBus: LegModBus;
51
52
  /** borrowed-readonly — the run tree's MCP connection pool (the leg leases its connections from it) and whether THIS leg created it
@@ -63,6 +64,8 @@ export interface PrepareProtocolToolsInput {
63
64
  reminderDisclosureCounts: Prepared["reminderDisclosureCounts"];
64
65
  /** borrowed-readonly — the leg's request-meta seat: every minted MCP tool reads what stands for its call, and the leg's session id (`_meta`). */
65
66
  mcpRequestMeta: import("../mcp-call-meta.js").McpLegMetaReader;
67
+ /** borrowed-readonly — the leg's activity seat (`RunInternals.onSubtreeActivity`): an MCP call's progress notification beats it. Absent ⇒ none. */
68
+ onSubtreeActivity?: RunInternals["onSubtreeActivity"];
66
69
  /** borrowed-readonly — the run's invocation id (the revocation probe-failure notice names it). */
67
70
  runId: string;
68
71
  /** borrowed-readonly — the acquired session id (operator-line context). */
@@ -83,6 +86,8 @@ export interface PrepareProtocolToolsInput {
83
86
  rosterSeat: ToolRosterDeltaSeat;
84
87
  /** borrowed-readonly — the large-result wrapper for protocol tools (per-tool `_meta` bar, 50K default). */
85
88
  remoteToolOffload: (tool: AgentTool) => AgentTool;
89
+ /** borrowed-readonly — where an MCP call's binary content is kept: the run's offload store, session and SaveToolResult reach. */
90
+ toolResultBytes: import("../tool-result-bytes.js").ToolResultBytesSeat;
86
91
  /** borrowed-readonly — the frozen tool face; its selector is read at REFRESH time so a tool the leg may not use is never
87
92
  * mounted by a model-triggered refresh. */
88
93
  toolFaceSnapshot: Pick<ToolFaceSnapshot, "selector">;
@@ -1,11 +1,14 @@
1
1
  import { Type } from "typebox";
2
- import { materializeLegMcpTools } from "../mcp.js";
2
+ import { NO_DECLARED_MCP_READ_PORTS, materializeLegMcpTools } from "../mcp.js";
3
3
  import { applyMcpRosterDelta, commitMcpRosterChanges, redialMcpServer, rosterHolding, settledOnRoster } from "./mcp-redial.js";
4
4
  import { valveLeaves, valveLeavesPeer } from "../../agents/tool-filter.js";
5
5
  import { resourceFacesLeft } from "../mounted-mcp.js";
6
- import { materializeA2aTools } from "../a2a.js";
6
+ import { materializeLegA2aTools } from "../a2a.js";
7
+ import { revocationProbe } from "../protocol-revocation.js";
7
8
  import { whereToAuthorize } from "../mcp-failure.js";
9
+ import { mcpServerUnavailableNotice } from "../mcp-server-unavailable-notice.js";
8
10
  import { deliverEngineNotice } from "../types.js";
11
+ import { isolationScopeOf } from "../isolation-scope.js";
9
12
  import { RosterBuilder } from "../tool-roster.js";
10
13
  import { TOOL_WIRE_NAME_MAX_CHARS } from "../tool-face.js";
11
14
  import { REFRESH_MCP_TOOLS_TOOL_NAME, mountRuleFace, toolFace } from "../tool-catalog-entries.js";
@@ -17,8 +20,9 @@ import { thrownText } from "../thrown-value.js";
17
20
  import { inlineUntrusted } from "../untrusted-text.js";
18
21
  import { transportKindOf } from "../mcp-server-spec.js";
19
22
  import { credentialEchoNotice } from "../credential-echo.js";
23
+ import { mcpBinaryKeptSeat } from "./tool-result-media-seat.js";
20
24
  export async function prepareProtocolTools(input) {
21
- const { lockedPreflight, hostFloor, spec, deps, mcpPool, reminderMark, reminderDisclosureCounts, runId, sessionId, onceLedger, roster, rosterSeat, remoteToolOffload, toolFaceSnapshot, toolEffects, axisExplicitNegatives, irreversibilityTier, irreversibleTools, egressTools, toolMarkSources, abortController, rollback } = input;
25
+ const { lockedPreflight, hostFloor, spec, deps, mcpPool, reminderMark, reminderDisclosureCounts, runId, sessionId, onceLedger, roster, rosterSeat, remoteToolOffload, toolResultBytes, toolFaceSnapshot, toolEffects, axisExplicitNegatives, irreversibilityTier, irreversibleTools, egressTools, toolMarkSources, abortController, rollback } = input;
22
26
  const markedBy = (name, source) => {
23
27
  const set = toolMarkSources.get(name);
24
28
  if (set !== undefined)
@@ -33,14 +37,19 @@ export async function prepareProtocolTools(input) {
33
37
  const serverReached = valveLeavesPeer(spec, toolFaceSnapshot.selector);
34
38
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
35
39
  const resourcesReached = resourceFacesLeft(leaves);
40
+ const revocations = legRevocationProbe(deps, runId);
36
41
  const mcp = lockedPreflight.mcp?.length
37
- ? await materializeLegMcpTools(input.mcpRequestMeta, lockedPreflight.mcp, spec.principal, deps.onElicit, deps.imageProcessor, { reminderMark, counts: reminderDisclosureCounts }, mcpRevocationWiring(deps, runId), mcpPool === undefined ? undefined : { pool: mcpPool.pool, ownsPool: mcpPool.owned }, sectionDisposerOf(input.modBus, abortController.signal), (entry) => resourcesReached || serverReached(mintNamespacePrefix(MCP_NAMESPACE, entry.name)), AbortSignal.any([abortController.signal, ...(spec.signal !== undefined ? [spec.signal] : [])]), hostFloor, deps.peerSeat, mcpAuthorizationNotice(deps, sessionId, runId, spec.principal), input.mcpHostSeats, credentialEchoNotice(deps.onNotice, sessionId, runId, "mcp"))
42
+ ? await materializeLegMcpTools(input.mcpRequestMeta, input.onSubtreeActivity, lockedPreflight.mcp, spec.principal, deps.onElicit, undefined, { reminderMark, counts: reminderDisclosureCounts }, revocations, mcpPool === undefined ? undefined : { pool: mcpPool.pool, ownsPool: mcpPool.owned, ...poolPartition(spec) }, sectionDisposerOf(input.modBus, abortController.signal), (entry) => resourcesReached || serverReached(mintNamespacePrefix(MCP_NAMESPACE, entry.name)), AbortSignal.any([abortController.signal, ...(spec.signal !== undefined ? [spec.signal] : [])]), hostFloor, deps.peerSeat, mcpAuthorizationNotice(deps, sessionId, runId, spec.principal), input.mcpHostSeats, credentialEchoNotice(deps.onNotice, sessionId, runId, "mcp"), { ...toolResultBytes, onKept: mcpBinaryKeptSeat(deps.onNotice, { sessionId, runId }) })
38
43
  :
39
- { tools: [], toolAxes: [], warnings: [], serverInstructions: [], instructionsDelta: { pendingAdds: [], pendingRemovals: [] }, droppedTools: [], statuses: [], refresh: async () => [], reconnect: async (server) => ({ server, prefix: mintNamespacePrefix(MCP_NAMESPACE, server), outcome: "not_declared", reason: "this task declared no MCP servers", toolCount: 0, added: [], removed: [] }), dispose: async () => { } };
44
+ { tools: [], toolAxes: [], warnings: [], serverInstructions: [], instructionsDelta: { pendingAdds: [], pendingRemovals: [] }, droppedTools: [], statuses: [], refresh: async () => [], reconnect: async (server) => ({ server, prefix: mintNamespacePrefix(MCP_NAMESPACE, server), outcome: "not_declared", reason: "this task declared no MCP servers", toolCount: 0, added: [], removed: [] }), ...NO_DECLARED_MCP_READ_PORTS, dispose: async () => { } };
40
45
  if (lockedPreflight.mcp?.length)
41
46
  rollback.push(function mcpDispose() { return mcp.dispose(); });
42
- for (const w of mcp.warnings)
47
+ for (const w of mcp.warnings) {
43
48
  onceLedger.onError(w, { phase: "mcp", sessionId });
49
+ const told = mcpServerUnavailableNotice(w, mcp.statuses, { sessionId, runId });
50
+ if (told !== undefined)
51
+ deliverEngineNotice(deps.onNotice, told);
52
+ }
44
53
  for (const name of input.mcpHostSeats?.keys() ?? []) {
45
54
  if (lockedPreflight.mcp?.some((s) => s.name === name && transportKindOf(s) === "host") !== true)
46
55
  onceLedger.onError(Object.assign(new Error(`mcp: this leg holds a host seat named "${inlineUntrusted(name, 120)}" and declares no MCP server of that name with a host-supplied transport — nothing is mounted through it`), { code: "config.mcp_host_seat_undeclared" }), { phase: "mcp", sessionId });
@@ -76,7 +85,9 @@ export async function prepareProtocolTools(input) {
76
85
  const mounted = server === undefined ? t : faced.get(t.name);
77
86
  if (mounted === undefined)
78
87
  continue;
79
- roster.mount(remoteToolOffload(mounted), { source: "mcp", mountedBy: "optional", origin: { peer: server?.name ?? MCP_NAMESPACE.parse(t.name)?.peer ?? t.name } });
88
+ const member = remoteToolOffload(mounted);
89
+ if (roster.mounts.judgeMember(server === undefined ? "mcp-resources" : "mcp", member))
90
+ roster.mount(member, { source: "mcp", mountedBy: "optional", origin: { peer: server?.name ?? MCP_NAMESPACE.parse(t.name)?.peer ?? t.name } });
80
91
  }
81
92
  }
82
93
  const rebuildHarnessToolsRef = {};
@@ -85,8 +96,9 @@ export async function prepareProtocolTools(input) {
85
96
  const rosterApply = { spec, toolFaceSnapshot, withFaces, remoteToolOffload, foldProtocolAxes: (axes, label) => foldProtocolAxes(axes, label), toolEffects, axisExplicitNegatives, roster, declared: lockedPreflight.mcp ?? [], instructionsDelta: mcp.instructionsDelta };
86
97
  const rosterCommit = { rebuildHarnessToolsRef, rosterSeat, toolCallGateArmedRef, irreversibleTools, egressTools };
87
98
  const redialInput = { ...rosterApply, ...rosterCommit, mcp, deps, sessionId, runId, irreversibilityTier };
88
- const mcpRedial = lockedPreflight.mcp?.length ? (server) => redialMcpServer(redialInput, server) : undefined;
89
- if (lockedPreflight.mcp?.length) {
99
+ roster.mounts.know({ "spec.mcp": (lockedPreflight.mcp?.length ?? 0) > 0 });
100
+ const mcpRedial = roster.mounts.holds("refresh-mcp-tools") ? (server) => redialMcpServer(redialInput, server) : undefined;
101
+ if (roster.mounts.judge("refresh-mcp-tools")) {
90
102
  roster.mount({
91
103
  ...toolFace("refresh-mcp-tools"),
92
104
  ...{ ruleFace: mountRuleFace("refresh-mcp-tools") },
@@ -102,6 +114,7 @@ export async function prepareProtocolTools(input) {
102
114
  const lines = [];
103
115
  let changed = false;
104
116
  let anyActiveFailure = false;
117
+ let anyRefreshed = false;
105
118
  const reported = [];
106
119
  for (const r of results) {
107
120
  if (r.tools === undefined) {
@@ -112,13 +125,18 @@ export async function prepareProtocolTools(input) {
112
125
  continue;
113
126
  }
114
127
  const applied = applyMcpRosterDelta(rosterApply, { server: r.server, prefix: r.prefix, tools: r.tools, axes: r.axes ?? [], dropped: r.dropped ?? [], ...(r.instructions !== undefined ? { instructions: r.instructions } : {}) });
115
- reported.push(settledOnRoster(r, applied, roster));
128
+ const settled = settledOnRoster(r, applied, roster);
116
129
  if (!applied.applied) {
117
- lines.push(`${r.server}: failed (${applied.foldError})`);
130
+ const { listingIncomplete: _incomplete, instructions: _instructions, ...entry } = settled;
131
+ reported.push({ ...entry, status: "failed", error: applied.refusal });
132
+ lines.push(`${r.server}: failed (${applied.refusal})`);
118
133
  anyActiveFailure = true;
134
+ changed = true;
119
135
  continue;
120
136
  }
137
+ reported.push(settled);
121
138
  changed = true;
139
+ anyRefreshed = true;
122
140
  const detail = [];
123
141
  if (applied.added.length > 0)
124
142
  detail.push(`added: ${applied.added.join(", ")}`);
@@ -140,7 +158,7 @@ export async function prepareProtocolTools(input) {
140
158
  content: [{ type: "text", text }],
141
159
  details: { results: reported },
142
160
  terminate: false,
143
- ...(anyActiveFailure && !changed ? { isError: true } : {}),
161
+ ...(anyActiveFailure && !anyRefreshed ? { isError: true } : {}),
144
162
  };
145
163
  },
146
164
  }, { source: "builtin", mountedBy: "optional" });
@@ -175,7 +193,7 @@ export async function prepareProtocolTools(input) {
175
193
  foldProtocolAxes(mcp.toolAxes, "MCP");
176
194
  const a2aDeclared = lockedPreflight.a2a;
177
195
  const a2a = a2aDeclared
178
- ? await materializeA2aTools(a2aDeclared, spec.principal, abortController.signal, hostFloor, deps.peerSeat, credentialEchoNotice(deps.onNotice, sessionId, runId, "a2a"))
196
+ ? await materializeLegA2aTools(revocations, a2aDeclared, spec.principal, abortController.signal, hostFloor, deps.peerSeat, credentialEchoNotice(deps.onNotice, sessionId, runId, "a2a"))
179
197
  : { tools: [], toolAxes: [], warnings: [], statuses: [], refresh: async () => [], dispose: async () => { } };
180
198
  if (a2aDeclared)
181
199
  rollback.push(function a2aDispose() { return a2a.dispose(); });
@@ -190,11 +208,18 @@ export async function prepareProtocolTools(input) {
190
208
  throw e;
191
209
  }
192
210
  }
193
- for (const t of a2a.tools)
194
- roster.mount(remoteToolOffload(t), { source: "a2a", mountedBy: "optional", origin: { peer: A2A_NAMESPACE.parse(t.name)?.peer ?? t.name } });
211
+ for (const t of a2a.tools) {
212
+ const member = remoteToolOffload(t);
213
+ if (roster.mounts.judgeMember("a2a", member))
214
+ roster.mount(member, { source: "a2a", mountedBy: "optional", origin: { peer: A2A_NAMESPACE.parse(t.name)?.peer ?? t.name } });
215
+ }
195
216
  foldProtocolAxes(a2a.toolAxes, "A2A");
196
217
  return { mcp, a2a, rebuildHarnessToolsRef, contentOriginWrapRef, toolCallGateArmedRef, ...(mcpRedial !== undefined ? { mcpRedial } : {}) };
197
218
  }
219
+ function poolPartition(spec) {
220
+ const isolationScope = isolationScopeOf(spec);
221
+ return isolationScope !== undefined ? { isolationScope } : {};
222
+ }
198
223
  function mcpAuthorizationNotice(deps, sessionId, runId, principal) {
199
224
  return (server, { reason, authorizeUrl }) => deliverEngineNotice(deps.onNotice, {
200
225
  code: "mcp.authorization_required",
@@ -202,16 +227,10 @@ function mcpAuthorizationNotice(deps, sessionId, runId, principal) {
202
227
  detail: { server, reason, ...(authorizeUrl !== undefined ? { authorizeUrl } : {}), ...(principal !== undefined ? { principal } : {}), sessionId, runId },
203
228
  });
204
229
  }
205
- function mcpRevocationWiring(deps, runId) {
206
- if (deps.mcpRevocations === undefined)
207
- return undefined;
208
- const ledger = deps.mcpRevocations;
209
- return {
210
- isRevoked: (name, mount) => (mount === undefined ? ledger.isRevoked(name) : ledger.isRevoked(name, mount)),
211
- onProbeFailure: (e) => deliverEngineNotice(deps.onNotice, {
212
- code: "mcp.revocation_probe_failed",
213
- message: `the mcpRevocations.isRevoked probe threw — MCP dispatch fails OPEN (no server treated as revoked) until the probe recovers: ${thrownText(e)}`,
214
- detail: { message: thrownText(e), runId },
215
- }),
216
- };
230
+ function legRevocationProbe(deps, runId) {
231
+ return revocationProbe(deps.protocolRevocations, (e) => deliverEngineNotice(deps.onNotice, {
232
+ code: "protocol.revocation_probe_failed",
233
+ message: `the protocolRevocations.revoked probe failed — MCP and A2A requests fail OPEN (no server or peer is treated as revoked) until it recovers: ${thrownText(e)}`,
234
+ detail: { message: thrownText(e), runId },
235
+ }));
217
236
  }
@@ -21,7 +21,7 @@ import { type OnQuestion } from "../ask-question.js";
21
21
  import type { CheckpointStore } from "../checkpoint-store.js";
22
22
  import { type AskSourceIdentity } from "../tool-policy.js";
23
23
  import type { RunnerDeps, RuntimeCaps, TaskSpec } from "../types.js";
24
- import type { PrepareResume, ToolFaceSnapshot } from "./contracts.js";
24
+ import type { PrepareResume } from "./contracts.js";
25
25
  import { type ContentAskBinding } from "./content-ask-bindings.js";
26
26
  import { RosterBuilder } from "../tool-roster.js";
27
27
  export { CONTENT_ASK_BINDING_CAP, type ContentAskBinding } from "./content-ask-bindings.js";
@@ -34,8 +34,6 @@ export interface PrepareQuestionFaceInput {
34
34
  spec: Pick<TaskSpec, "durableApproval" | "interactiveTools" | "interactiveQuestionFallback" | "excludeAllTools">;
35
35
  /** borrowed-readonly — the leg's one ask source (minted once by the driver): the mounted tool's source members. */
36
36
  askSource: AskSourceIdentity;
37
- /** borrowed-readonly — the frozen tool face; its selector with the spec's `excludeAllTools` is the valve's reading: the tool mounts only if the valve leaves it. */
38
- toolFaceSnapshot: Pick<ToolFaceSnapshot, "selector">;
39
37
  /** borrowed-readonly — the deployment seat `onError` (the stranded-answer and synthetic-continuation operator
40
38
  * lines; swallow-guarded). */
41
39
  deps: Pick<RunnerDeps, "onError">;
@@ -44,6 +42,7 @@ export interface PrepareQuestionFaceInput {
44
42
  /** borrowed-readonly — the principal's resolved runtime caps as of this point (`forceDurableGate` is the
45
43
  * mandate that outranks a live face only where a store exists to park the question). */
46
44
  runtimeCaps: Pick<RuntimeCaps, "forceDurableGate"> | undefined;
45
+ /** borrowed-readonly — the driver's one leg fact `approvalParkNotResumable` (the opt-in judge's third input). */ approvalParkNotResumable: boolean;
47
46
  /** borrowed-readonly — the resolved interaction posture (the door's value), threaded to the tool so both
48
47
  * no-answer arms harden under it. */
49
48
  resolvedInteractionPosture: "interactive" | "headless" | undefined;
@@ -58,7 +57,9 @@ export interface PrepareQuestionFaceInput {
58
57
  roster: RosterBuilder;
59
58
  /** borrowed-readonly — LIVE GETTER over the inherited-unavailable marker set (declared by the driver's
60
59
  * gate-fold section after this phase; `has` only, per call at run time). See the module header. */
61
- inheritedUnavailableAsks: () => ReadonlySet<string>;
60
+ inheritedUnavailableAsks: () => {
61
+ has(toolCallId: string): boolean;
62
+ };
62
63
  }
63
64
  export interface PrepareQuestionFaceResult {
64
65
  /** borrowed-readonly — THE leg's store snapshot (`resolveCheckpointStore(spec, deps)`): the mount face, the
@@ -91,7 +92,7 @@ export interface PrepareQuestionFaceResult {
91
92
  deliveryId: string;
92
93
  toolCallId: string;
93
94
  }>;
94
- /** owned — whether a durable delivery face exists (store wired ∧ (durableApproval ∨ forceDurableGate)); the manifest's
95
+ /** owned — whether a durable delivery face exists (store wired ∧ `durableParkOptInDeclared`: the leg can be resumed); the manifest's
95
96
  * composition-lie detector and the park closure's content-ask decline (a question parks only where it holds) reuse this exact value. */
96
97
  durableQuestionFace: boolean;
97
98
  /** owned — the face the tool was mounted with: the gate-bound answer for THIS call id if one exists (one-shot),
@@ -1,12 +1,12 @@
1
- import { valveLeaves } from "../../agents/tool-filter.js";
2
- import { ASK_USER_QUESTION_TOOL_NAME, createAskUserQuestionTool, isLiveQuestionFace } from "../ask-question.js";
1
+ import { createAskUserQuestionTool, isLiveQuestionFace } from "../ask-question.js";
3
2
  import { boundInputHashOf } from "../canonical-json.js";
4
3
  import { durableParkOptInDeclared } from "../tool-policy.js";
5
4
  import { CONTENT_ASK_BINDING_CAP } from "./content-ask-bindings.js";
6
5
  import { RosterBuilder } from "../tool-roster.js";
6
+ import { questionSeatFact } from "../tool-mount-facts.js";
7
7
  export { CONTENT_ASK_BINDING_CAP } from "./content-ask-bindings.js";
8
8
  export function prepareQuestionFace(input) {
9
- const { frozenOnQuestion, spec, askSource, deps, checkpointStore, runtimeCaps, resolvedInteractionPosture, resume, sessionId, roster, toolFaceSnapshot, inheritedUnavailableAsks } = input;
9
+ const { frozenOnQuestion, spec, askSource, deps, checkpointStore, runtimeCaps, approvalParkNotResumable, resolvedInteractionPosture, resume, sessionId, roster, inheritedUnavailableAsks } = input;
10
10
  const tools = roster.tools;
11
11
  const onQuestion = frozenOnQuestion;
12
12
  const liveQuestionFace = isLiveQuestionFace(onQuestion) ? onQuestion : undefined;
@@ -43,7 +43,7 @@ export function prepareQuestionFace(input) {
43
43
  byDelivery.set(r.deliveryId, r);
44
44
  return [...byDelivery.values()];
45
45
  };
46
- const durableQuestionFace = questionParkStoreWired && durableParkOptInDeclared({ forceDurableGate: runtimeCaps?.forceDurableGate === true, durableApprovalDeclared: spec.durableApproval !== undefined });
46
+ const durableQuestionFace = questionParkStoreWired && durableParkOptInDeclared({ forceDurableGate: runtimeCaps?.forceDurableGate === true, durableApprovalDeclared: spec.durableApproval !== undefined, approvalParkNotResumable });
47
47
  const mountedQuestionFace = liveQuestionFace !== undefined
48
48
  ? async (req, signal) => {
49
49
  const bound = contentAskBindings.get(req.toolCallId);
@@ -59,9 +59,10 @@ export function prepareQuestionFace(input) {
59
59
  return liveQuestionFace(req, signal);
60
60
  }
61
61
  : onQuestion;
62
- const questionToolMounted = (spec.interactiveTools === true || (spec.interactiveTools !== false && (onQuestion !== undefined || durableQuestionFace))) && valveLeaves(spec, toolFaceSnapshot.selector)({ name: ASK_USER_QUESTION_TOOL_NAME });
62
+ roster.mounts.know({ "seat.question": questionSeatFact({ face: onQuestion !== undefined, parkStore: questionParkStoreWired, forceDurableGate: runtimeCaps?.forceDurableGate === true, durableApprovalDeclared: spec.durableApproval !== undefined, approvalParkNotResumable }) });
63
+ const questionToolMounted = roster.mounts.judge("ask-user-question");
63
64
  let mountedQuestionTool;
64
- if (questionToolMounted)
65
+ if (roster.mounts.judge("ask-user-question"))
65
66
  roster.mount((mountedQuestionTool =
66
67
  createAskUserQuestionTool(mountedQuestionFace, askSource, {
67
68
  ...(resume?.redeemedContentAskCallId !== undefined
@@ -166,6 +166,9 @@ export interface PrepareSuspendSagaInput {
166
166
  gitStatusRef: Prepared["gitStatusRef"];
167
167
  /** borrowed-readonly — the leg's identity envelope; only `isDelegatedChild` is read (the row's presence-coded bit). */
168
168
  hookIdentity: Pick<HookInvocationIdentity, "isDelegatedChild">;
169
+ /** borrowed-readonly — the parent coordinates of a synchronous child's leg ({@link import("../leg-identity.js").syncChildBlockOf}, read once at
170
+ * prepare): handed through as the saga's seat every row mint stamps. */
171
+ syncChildBlock: SuspendSaga["syncChildBlock"];
169
172
  /** borrowed-readonly — the frozen prepare-time placement resolution (the row's placement stamp). */
170
173
  placementRootResolved: string;
171
174
  /** borrowed-readonly — the leg's composition identity as prepare resolved it once (the live member, else the resumed row's;
@@ -338,5 +338,5 @@ export function prepareSuspendSaga(input) {
338
338
  const { snapshotId: _lineage, ...identity } = env.workspaceHandle();
339
339
  return { ...identity, restoreMode: "park_only" };
340
340
  };
341
- return { saga: { inFlightSpendMicroUsd, serializeCheckpointState, compensatePausedVM, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle } };
341
+ return { saga: { inFlightSpendMicroUsd, serializeCheckpointState, compensatePausedVM, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle, syncChildBlock: input.syncChildBlock } };
342
342
  }