@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,7 +1,18 @@
1
- import { mintNamespacePrefix } from "./protocol-naming.js";
1
+ import { TOOL_NAME_MAX_CHARS, mintNamespacePrefix, normalizeNameSegment } from "./protocol-naming.js";
2
2
  import { MCP_NAMESPACE } from "./protocol-table.js";
3
3
  export const MCP_RESOURCE_LIST_ALLOW = "list_resources";
4
4
  export const MCP_RESOURCE_READ_ALLOW = "read_resource";
5
+ export const MCP_RESOURCE_TEMPLATE_LIST_ALLOW = "list_resource_templates";
6
+ export const MCP_PROMPT_LIST_ALLOW = "list_prompts";
7
+ export const MCP_PROMPT_GET_ALLOW = "get_prompt";
8
+ export const MCP_FACE_WORDS = Object.freeze([MCP_RESOURCE_LIST_ALLOW, MCP_RESOURCE_READ_ALLOW, MCP_RESOURCE_TEMPLATE_LIST_ALLOW, MCP_PROMPT_LIST_ALLOW, MCP_PROMPT_GET_ALLOW]);
9
+ export function isMcpFaceWord(name) {
10
+ return typeof name === "string" && MCP_FACE_WORDS.includes(name);
11
+ }
12
+ export function faceAllowed(allowTools, face) {
13
+ return allowTools === undefined || allowTools.includes(face);
14
+ }
15
+ export const MCP_FACE_WORD_DROP_REASON = "its name is one of the reserved MCP face words an allowTools list uses for a kind of read (list_resources, read_resource, list_resource_templates, list_prompts, get_prompt), never a tool, so the tool is not mounted";
5
16
  export const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
6
17
  export const READ_MCP_RESOURCE = "ReadMcpResourceTool";
7
18
  export const READ_MCP_RESOURCE_DIR = "ReadMcpResourceDirTool";
@@ -21,56 +32,111 @@ function ledgerOf(lane) {
21
32
  return ledger;
22
33
  }
23
34
  const queuedFor = (lane, server) => lane.pendingAdds.some((e) => e.server === server);
35
+ const sameEntry = (a, b) => a.text === b.text && a.author === b.author;
36
+ function slotOf(lane, server) {
37
+ const ledger = ledgerOf(lane);
38
+ const slot = ledger.get(server);
39
+ if (slot === undefined)
40
+ return undefined;
41
+ if (slot.retracting && !lane.pendingRemovals.includes(server)) {
42
+ slot.retracting = false;
43
+ slot.held = undefined;
44
+ }
45
+ if (slot.queued !== undefined && !queuedFor(lane, server)) {
46
+ slot.held = slot.queued;
47
+ slot.queued = undefined;
48
+ }
49
+ if (slot.held === undefined && slot.queued === undefined && !slot.retracting) {
50
+ ledger.delete(server);
51
+ return undefined;
52
+ }
53
+ return slot;
54
+ }
24
55
  export function instructionsTold(lane, server) {
25
- const state = ledgerOf(lane).get(server);
26
- return state === "context" || (state === "queued" && !queuedFor(lane, server));
56
+ const slot = slotOf(lane, server);
57
+ return slot !== undefined && !slot.retracting && slot.held !== undefined;
27
58
  }
28
- export function toldOnDial(lane, server) {
29
- ledgerOf(lane).set(server, "context");
59
+ export function instructionsUnchanged(lane, entry) {
60
+ const slot = slotOf(lane, entry.server);
61
+ if (slot === undefined || slot.retracting)
62
+ return false;
63
+ const latest = slot.queued ?? slot.held;
64
+ return latest !== undefined && sameEntry(latest, entry);
30
65
  }
31
- export function toldAtStart(lane, servers) {
66
+ export function toldOnDial(lane, entry) {
67
+ ledgerOf(lane).set(entry.server, { held: entry, queued: undefined, retracting: false });
68
+ }
69
+ export function toldAtStart(lane, taught) {
32
70
  const ledger = ledgerOf(lane);
33
71
  ledger.clear();
72
+ const servers = new Set(taught.map((entry) => entry.server));
34
73
  for (let i = lane.pendingRemovals.length - 1; i >= 0; i--)
35
74
  if (!servers.has(lane.pendingRemovals[i]))
36
75
  lane.pendingRemovals.splice(i, 1);
37
- for (const server of servers)
38
- if (!lane.pendingRemovals.includes(server))
39
- ledger.set(server, "context");
76
+ for (const entry of taught)
77
+ ledger.set(entry.server, { held: entry, queued: undefined, retracting: lane.pendingRemovals.includes(entry.server) });
40
78
  }
41
79
  export function withdrawInstructionAdds(lane, server) {
42
- const told = instructionsTold(lane, server);
80
+ const slot = slotOf(lane, server);
43
81
  for (let i = lane.pendingAdds.length - 1; i >= 0; i--)
44
82
  if (lane.pendingAdds[i].server === server)
45
83
  lane.pendingAdds.splice(i, 1);
46
- if (!told)
84
+ if (slot === undefined)
85
+ return;
86
+ slot.queued = undefined;
87
+ if (slot.held === undefined && !slot.retracting)
47
88
  ledgerOf(lane).delete(server);
48
89
  }
49
90
  export function tellInstructions(lane, entry) {
50
- const told = instructionsTold(lane, entry.server);
91
+ if (instructionsUnchanged(lane, entry))
92
+ return;
51
93
  withdrawInstructionAdds(lane, entry.server);
94
+ if (instructionsUnchanged(lane, entry))
95
+ return;
52
96
  lane.pendingAdds.push(entry);
53
- ledgerOf(lane).set(entry.server, told ? "context" : "queued");
97
+ const ledger = ledgerOf(lane);
98
+ const slot = ledger.get(entry.server);
99
+ if (slot !== undefined)
100
+ slot.queued = entry;
101
+ else
102
+ ledger.set(entry.server, { held: undefined, queued: entry, retracting: false });
54
103
  }
55
104
  export function retractInstructions(lane, server) {
56
105
  const told = instructionsTold(lane, server);
57
106
  withdrawInstructionAdds(lane, server);
58
- if (told && !lane.pendingRemovals.includes(server))
107
+ if (!told)
108
+ return;
109
+ if (!lane.pendingRemovals.includes(server))
59
110
  lane.pendingRemovals.push(server);
60
- ledgerOf(lane).delete(server);
111
+ const slot = ledgerOf(lane).get(server);
112
+ if (slot !== undefined)
113
+ slot.retracting = true;
61
114
  }
62
115
  export function unretractInstructions(lane, server) {
63
116
  if (!lane.pendingRemovals.includes(server))
64
117
  return;
118
+ const slot = slotOf(lane, server);
65
119
  for (let i = lane.pendingRemovals.length - 1; i >= 0; i--)
66
120
  if (lane.pendingRemovals[i] === server)
67
121
  lane.pendingRemovals.splice(i, 1);
68
- ledgerOf(lane).set(server, "context");
122
+ if (slot !== undefined)
123
+ slot.retracting = false;
69
124
  }
70
125
  export function toolNamesOfServer(names, serverName) {
71
126
  const prefix = mintNamespacePrefix(MCP_NAMESPACE, serverName);
72
127
  return [...names].filter((name) => name.startsWith(prefix));
73
128
  }
129
+ export function toolFieldsOfServer(rosterNames, serverName, max) {
130
+ const held = toolNamesOfServer(rosterNames, serverName);
131
+ const listed = [];
132
+ for (const name of held) {
133
+ if (listed.length === max)
134
+ break;
135
+ if (name.length <= TOOL_NAME_MAX_CHARS && normalizeNameSegment(name) === name)
136
+ listed.push(name);
137
+ }
138
+ return { toolCount: held.length, ...(listed.length > 0 ? { toolNames: listed } : {}), ...(listed.length < held.length ? { toolNamesTruncated: true } : {}) };
139
+ }
74
140
  export function mountedMcpOf(input) {
75
141
  const servers = (input.declared ?? []).map((server) => {
76
142
  const owned = new Set(toolNamesOfServer(input.roster.map((t) => t.name), server.name));
@@ -1,3 +1,4 @@
1
+ import { describeRejectedValue } from "./tool-search-setting.js";
1
2
  import { grantWildcardRefusalOf, peerReadingsOf, readsNameGlob, splitNamespacedName } from "./tool-name-aliases.js";
2
3
  export function wildcardMatch(pattern, value) {
3
4
  const first = pattern.indexOf("*");
@@ -32,7 +33,7 @@ export function isCoveringRuleName(name, behavior) {
32
33
  }
33
34
  export function namesASetOfTools(name, behavior) {
34
35
  if (behavior !== "deny" && behavior !== "ask" && behavior !== "allow") {
35
- throw new TypeError(`isCoveringRuleName: the list's behavior must be "deny", "ask" or "allow" (got ${typeof behavior === "string" ? JSON.stringify(behavior) : typeof behavior}) — a "*" in a name reads one way on a list that restricts and another on one that grants`);
36
+ throw new TypeError(`isCoveringRuleName: the list's behavior must be "deny", "ask" or "allow" (got ${describeRejectedValue(behavior)}) — a "*" in a name reads one way on a list that restricts and another on one that grants`);
36
37
  }
37
38
  if (name.includes("*"))
38
39
  return readsNameGlob(behavior) || grantWildcardRefusalOf(name) === undefined;
@@ -1,6 +1,6 @@
1
1
  import { types } from "node:util";
2
2
  import { closestName } from "./closest-name.js";
3
- import { inlineUntrusted } from "./untrusted-text.js";
3
+ import { callerText } from "./caller-text.js";
4
4
  import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
5
5
  import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
6
6
  export function receiptRefusal(message) {
@@ -58,14 +58,12 @@ function readCaptured(given, words) {
58
58
  throw receiptRefusal(`${words.subject}'s prototype changed while its ${words.unit}s were read ${words.moment} — refused rather than wired from a moving object`);
59
59
  throw receiptRefusal(`${words.subject} could not be read ${words.moment}: ${describeFault(received.fault)} — refused rather than wired without it`);
60
60
  }
61
- const STRAY_NAME_MAX = 80;
62
61
  function strayMembersSentence(words, stray, keys) {
63
62
  const named = stray.map((k) => {
64
63
  if (typeof k === "symbol")
65
- return `${inlineUntrusted(String(k), STRAY_NAME_MAX)} (a symbol-keyed member)`;
66
- const shown = JSON.stringify(inlineUntrusted(k, STRAY_NAME_MAX));
64
+ return callerText(k);
67
65
  const near = closestName(k, keys);
68
- return near === undefined ? shown : `${shown} (did you mean ${JSON.stringify(near)}?)`;
66
+ return near === undefined ? callerText(k) : `${callerText(k)} (did you mean ${JSON.stringify(near)}?)`;
69
67
  });
70
68
  const one = stray.length === 1;
71
69
  const unit = words.unit;
@@ -11,15 +11,18 @@
11
11
  import type { OnQuestion } from "./ask-question.js";
12
12
  import type { ModRegistration } from "./mods/kernel/index.js";
13
13
  import type { EngineDollar } from "./mods/dollar.js";
14
+ import { type TaskSandboxSettings } from "./command-sandbox.js";
14
15
  import type { ToolExecuteContext } from "./tool-spec.js";
15
16
  import type { TaskSpec } from "./types.js";
16
17
  /** The fields of a spec the seat carries — one `Pick`, shared by the mint's input and the apply's target. */
17
- export type ParentSpecSeatFields = Pick<TaskSpec, "principal" | "oneShot" | "clientContext" | "onQuestion" | "mods" | "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "memoryPersistenceCapable" | "classifyAllShell" | "memory" | "compaction" | "skillListingBudgetFraction" | "skillListingMaxDescChars" | "fileHistory" | "projectMemory" | "promptForm" | "promptBinding" | "advisorModel" | "attachments">;
18
+ export type ParentSpecSeatFields = Pick<TaskSpec, "principal" | "isolationScope" | "oneShot" | "clientContext" | "onQuestion" | "mods" | "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "sandbox" | "memoryPersistenceCapable" | "classifyAllShell" | "memory" | "compaction" | "skillListingBudgetFraction" | "skillListingMaxDescChars" | "fileHistory" | "projectMemory" | "promptForm" | "promptBinding" | "promptLocale" | "advisorModel" | "attachments" | "language" | "instructionFamily">;
18
19
  /**
19
20
  * The seat a run hands its children. Every member is the parent's own value, frozen at mint (arrays copied and
20
21
  * frozen; the facts object copied). Members present iff the parent carries them — an absent member is "nothing to
21
22
  * inherit", never a value.
22
23
  * · `principal` — the end-user identity (design/62: inherits verbatim, a worker cannot delegate under another).
24
+ * · `isolationScope` — the parent's working-state partition, the same shape and law as `principal`: a child works
25
+ * inside the scope its parent works in, so its rows, offloads and parked approvals land in the parent's bucket.
23
26
  * · `oneShot` — the process fact ("no later turn"): only `true` travels; it is a REMOVAL (see the apply law).
24
27
  * · `clientContext` — the user's TZ/email facts (the child's environment block localizes the same way).
25
28
  * · `onQuestion` — the parent's FROZEN question face (`spec.onQuestion ?? deps.onQuestion`, the value the parent's
@@ -33,6 +36,9 @@ export type ParentSpecSeatFields = Pick<TaskSpec, "principal" | "oneShot" | "cli
33
36
  * own value wins, the seat fills an unset one.
34
37
  * · `additionalDirectories` / `additionalReadDirectories` — the fs-fence widening (deployment property).
35
38
  * · `envFacts` — the sandbox facts (profile / egress / scratchpad).
39
+ * · `sandbox` — the command sandbox requirement, as the parent's own prepare judged it: a FLOOR, merged with the child's own
40
+ * requirement toward the stricter side, member by member (`mergeChildSandbox`) — never the fill law, so a child cannot
41
+ * author a looser sandbox than its parent runs under, and may author a stricter one.
36
42
  * · `memoryPersistenceCapable` — the deployment's DECLARED persistence statement: `false` is a REMOVAL (floor),
37
43
  * `true` a default a child's own declaration may narrow.
38
44
  * · `classifyAllShell` — the request's "no shell allow entry clears a call in `auto`" declaration: only `true` travels and
@@ -60,6 +66,9 @@ export type ParentSpecSeatFields = Pick<TaskSpec, "principal" | "oneShot" | "cli
60
66
  * observer sidecar) composes the same set of sections. An ORDINARY member (fill law).
61
67
  * · `promptBinding` — the binding (a deployment's scenario name), a prompt selector value. A child composes its
62
68
  * parent's center artifact, so its overlays' `when.binding` reads the same binding. An ORDINARY member (fill law).
69
+ * · `promptLocale` — the rendering of the catalog text (`"zh-Hans"`, its only word), a prompt selector value: the delegates
70
+ * that work for a run read the engine's text in the run's locale. An ORDINARY member (fill law); not a floor, so no
71
+ * clamp row.
63
72
  * · `advisorModel` — the person's advisor setting: every engine-built child judges it against its OWN model (an advisor
64
73
  * weaker than the child's model does not attach there). An ORDINARY member (fill law); the observer sidecar takes it and
65
74
  * excludes the tool by name.
@@ -67,9 +76,15 @@ export type ParentSpecSeatFields = Pick<TaskSpec, "principal" | "oneShot" | "cli
67
76
  * switched off): one declaration for the delegation tree, so a lane the parent turned on or off is on or off for the
68
77
  * delegates that work for it. An ORDINARY member (fill law): a child that authors `attachments` at all keeps exactly what it
69
78
  * authored, never half to the parent.
79
+ * · `language` — the person's reply language. It reaches every engine-built child; a named teammate states it to its model
80
+ * and an ordinary delegated child does not (the leg's own judgment, `language-frame.ts`). An ORDINARY member (fill law).
81
+ * · `instructionFamily` — the instruction-file family the deployment declared: the delegates read the same names in the
82
+ * directories they access. Its own member, not a lane of `attachments`, so a child that authors `attachments` still
83
+ * inherits it. An ORDINARY member (fill law): a child that declares a family keeps exactly that one.
70
84
  */
71
85
  export interface ParentSpecSeat {
72
86
  readonly principal?: string;
87
+ readonly isolationScope?: string;
73
88
  readonly oneShot?: true;
74
89
  readonly clientContext?: TaskSpec["clientContext"];
75
90
  readonly onQuestion?: OnQuestion;
@@ -77,6 +92,7 @@ export interface ParentSpecSeat {
77
92
  readonly additionalDirectories?: readonly string[];
78
93
  readonly additionalReadDirectories?: readonly string[];
79
94
  readonly envFacts?: TaskSpec["envFacts"];
95
+ readonly sandbox?: TaskSandboxSettings;
80
96
  readonly memoryPersistenceCapable?: boolean;
81
97
  readonly classifyAllShell?: true;
82
98
  readonly memory?: {
@@ -89,8 +105,11 @@ export interface ParentSpecSeat {
89
105
  readonly projectMemory?: "disabled";
90
106
  readonly promptForm?: "minimal";
91
107
  readonly promptBinding?: string;
108
+ readonly promptLocale?: TaskSpec["promptLocale"];
92
109
  readonly advisorModel?: TaskSpec["advisorModel"];
93
110
  readonly attachments?: TaskSpec["attachments"];
111
+ readonly language?: string;
112
+ readonly instructionFamily?: TaskSpec["instructionFamily"];
94
113
  }
95
114
  /** Refuse (by name, `config.deps_retired_key`) a seat that still carries a retired member. Read at every door a seat enters
96
115
  * by hand: the ctx reader, the apply, and the send lane's waker clamps. */
@@ -1,5 +1,7 @@
1
1
  import { applyClampSeats, clampFieldSeatsOf } from "./child-clamp-seats.js";
2
2
  import { assertNoRetiredKeys } from "./retired-keys.js";
3
+ import { mergeChildSandbox, receiveTaskSandbox } from "./command-sandbox.js";
4
+ import { codedRefusal } from "./thrown-value.js";
3
5
  const RETIRED_PARENT_SPEC_SEAT_KEYS = Object.freeze({
4
6
  memoryOff: "the request-level memory-off fact is the clamp table's `memory` row now — carry `memory: { enabled: false }`",
5
7
  });
@@ -10,6 +12,7 @@ export function assertParentSpecSeatCurrent(seat) {
10
12
  export function parentSpecSeatOf(spec, frozenOnQuestion) {
11
13
  return Object.freeze({
12
14
  ...(spec.principal !== undefined ? { principal: spec.principal } : {}),
15
+ ...(spec.isolationScope !== undefined ? { isolationScope: spec.isolationScope } : {}),
13
16
  ...(spec.oneShot === true ? { oneShot: true } : {}),
14
17
  ...(spec.clientContext !== undefined ? { clientContext: spec.clientContext } : {}),
15
18
  ...(frozenOnQuestion !== undefined ? { onQuestion: frozenOnQuestion } : {}),
@@ -17,6 +20,7 @@ export function parentSpecSeatOf(spec, frozenOnQuestion) {
17
20
  ...(spec.additionalDirectories !== undefined ? { additionalDirectories: Object.freeze([...spec.additionalDirectories]) } : {}),
18
21
  ...(spec.additionalReadDirectories !== undefined ? { additionalReadDirectories: Object.freeze([...spec.additionalReadDirectories]) } : {}),
19
22
  ...(spec.envFacts !== undefined ? { envFacts: Object.freeze({ ...spec.envFacts }) } : {}),
23
+ ...(spec.sandbox !== undefined ? { sandbox: receiveTaskSandbox(spec.sandbox) } : {}),
20
24
  ...(spec.memoryPersistenceCapable !== undefined ? { memoryPersistenceCapable: spec.memoryPersistenceCapable } : {}),
21
25
  ...(spec.classifyAllShell === true ? { classifyAllShell: true } : {}),
22
26
  ...(spec.compaction !== undefined ? { compaction: Object.freeze({ ...spec.compaction }) } : {}),
@@ -26,8 +30,11 @@ export function parentSpecSeatOf(spec, frozenOnQuestion) {
26
30
  ...(spec.projectMemory !== undefined ? { projectMemory: spec.projectMemory } : {}),
27
31
  ...(spec.promptForm !== undefined ? { promptForm: spec.promptForm } : {}),
28
32
  ...(spec.promptBinding !== undefined ? { promptBinding: spec.promptBinding } : {}),
33
+ ...(spec.promptLocale !== undefined ? { promptLocale: spec.promptLocale } : {}),
29
34
  ...(spec.advisorModel !== undefined ? { advisorModel: spec.advisorModel } : {}),
30
35
  ...(spec.attachments !== undefined ? { attachments: Object.freeze({ ...spec.attachments }) } : {}),
36
+ ...(spec.language !== undefined ? { language: spec.language } : {}),
37
+ ...(spec.instructionFamily !== undefined ? { instructionFamily: Object.freeze({ ...spec.instructionFamily }) } : {}),
31
38
  ...clampFieldSeatsOf(spec),
32
39
  });
33
40
  }
@@ -39,6 +46,7 @@ export function applyParentSpecSeat(child, seat) {
39
46
  const landed = {
40
47
  ...child,
41
48
  ...fill("principal", seat.principal),
49
+ ...fill("isolationScope", seat.isolationScope),
42
50
  ...fill("clientContext", seat.clientContext),
43
51
  ...fill("onQuestion", seat.onQuestion),
44
52
  ...fill("mods", seat.mods),
@@ -52,8 +60,12 @@ export function applyParentSpecSeat(child, seat) {
52
60
  ...fill("projectMemory", seat.projectMemory),
53
61
  ...fill("promptForm", seat.promptForm),
54
62
  ...fill("promptBinding", seat.promptBinding),
63
+ ...fill("promptLocale", seat.promptLocale),
55
64
  ...fill("advisorModel", seat.advisorModel),
56
65
  ...fill("attachments", (seat.attachments !== undefined ? { ...seat.attachments } : undefined)),
66
+ ...fill("language", seat.language),
67
+ ...(seat.sandbox !== undefined ? { sandbox: mergeChildSandbox(seat.sandbox, child.sandbox) } : {}),
68
+ ...fill("instructionFamily", (seat.instructionFamily !== undefined ? { ...seat.instructionFamily } : undefined)),
57
69
  ...(seat.oneShot === true ? { oneShot: true } : {}),
58
70
  ...(seat.classifyAllShell === true ? { classifyAllShell: true } : {}),
59
71
  ...(seat.memoryPersistenceCapable === false ? { memoryPersistenceCapable: false } : fill("memoryPersistenceCapable", seat.memoryPersistenceCapable)),
@@ -76,7 +88,5 @@ export function parentSpecSeatOfCtx(ctx) {
76
88
  return seat;
77
89
  }
78
90
  function seatRefusal(message) {
79
- const e = new Error(`parentSpecSeat: ${message}`);
80
- e.code = "config.parent_spec_seat_missing";
81
- return e;
91
+ return codedRefusal("config.parent_spec_seat_missing", `parentSpecSeat: ${message}`);
82
92
  }
@@ -74,6 +74,7 @@ function syntheticCheckpoint(scope, fidelity) {
74
74
  hasBidiControls: true,
75
75
  preview: { probe: true, note: "park wiring self-check display stub" },
76
76
  previewWithheld: "oversize",
77
+ existingTarget: { kind: "text", text: "park wiring self-check target text\n" },
77
78
  requiresRealApproval: true,
78
79
  mandated: true,
79
80
  denialLimitFallback: { consecutive: 3, total: 3, limit: "consecutive", autoDenyAfterMs: 0 },
@@ -1,4 +1,5 @@
1
1
  import { anchorSpelling, win32NamespaceScreen } from "../tools/fs/safety.js";
2
+ import { envErrorDetail } from "../tools/fs/env-error-detail.js";
2
3
  import { isUncSpelling } from "./unc-spelling.js";
3
4
  export async function symlinkChainHops(env, path, signal, family, baseCwd) {
4
5
  if (typeof env.canonicalChain !== "function")
@@ -11,7 +12,7 @@ export async function symlinkChainHops(env, path, signal, family, baseCwd) {
11
12
  return { ok: false, cause: "a network share spelling the chain reader does not walk", asked: false };
12
13
  const target = baseCwd !== undefined && baseCwd.length > 0 ? anchorSpelling(family, baseCwd, spelled) : spelled;
13
14
  const chain = await env.canonicalChain(target, signal);
14
- return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: chain.error.message, asked: true };
15
+ return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: envErrorDetail(chain.error.message), asked: true };
15
16
  }
16
17
  export function leafChainMayHold(walked, landedElsewhere, family) {
17
18
  const climbs = family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/;
@@ -1,6 +1,6 @@
1
1
  import { SdkHttpError } from "@modelcontextprotocol/client";
2
2
  import { type CredentialRef } from "@sema-agent/primitives";
3
- import { type McpServerSpec, type McpTransportKind } from "./mcp-server-spec.js";
3
+ import type { McpServerSpec, McpTransportKind } from "./mcp-server-spec.js";
4
4
  import type { ProtocolId } from "./protocol-table.js";
5
5
  /** Why the seat is asked: the first send of a connection, any later send, or the send after a 401. */
6
6
  export type PeerAskCause = "connect" | "request" | "rejected";
@@ -156,6 +156,8 @@ export interface CarriedPieces {
156
156
  readonly expiresAt?: number;
157
157
  readonly digest: string;
158
158
  }
159
+ /** The pieces a send carries when the seat answered none (or there is no seat). */
160
+ export declare const NO_PIECES: CarriedPieces;
159
161
  /** The seat's answer for `lane`, read once: the pieces, the `unauthorized` answer, or the problem (which member did not fit). The
160
162
  * answer's members are its OWN members (a member its prototype would supply is not read), and each value is judged by the grammar of
161
163
  * the send that will carry it ({@link VALUE_LAW}). */
@@ -247,11 +249,18 @@ export declare function carriedHttpHeaders(protocol: ProtocolId, carrier: PeerCa
247
249
  /**
248
250
  * The MCP HTTP transport's `fetch` under the seat: every request the transport makes (the POST, the SSE GET, the DELETE) asks the
249
251
  * carrier first, carries what it answered, goes only to the endpoint the declaration named (no redirect is followed — a 3xx is the
250
- * answer) and, answered 401, has the carrier ask once more for the next send. A refusal of the authorization — 401, or 403 whose
251
- * challenge says `insufficient_scope` — is raised here as {@link PeerAuthorizationRefused} carrying the challenge, the re-ask's answer
252
- * and the bounded body (the SDK would raise its status error from the same response with no header kept).
252
+ * answer; a request carrying anything is judged by {@link assertEndpointBound} before it is sent: over https or plain http to this
253
+ * machine, to the declared origin `bound.declared`), then — when the fetch carries a request's own bytes, not a notification, an answer or
254
+ * the session end — asks the revocation question the request carries from its door, after the seat answered (protocol-revocation.ts
255
+ * `askCarriedRevocation`; the transport says what each send carries) and, answered 401, has the carrier ask once more for the next send. A refusal of
256
+ * the authorization — 401, or 403 whose challenge says `insufficient_scope` — is raised here as {@link PeerAuthorizationRefused}
257
+ * carrying the challenge, the re-ask's answer and the bounded body (the SDK would raise its status error from the same response with
258
+ * no header kept).
253
259
  */
254
- export declare function peerFetch(carrier: PeerCarrier, principalHeader: string | undefined, principal: string | undefined): typeof fetch;
260
+ export declare function peerFetch(carrier: PeerCarrier, principalHeader: string | undefined, principal: string | undefined, bound: {
261
+ readonly server: string;
262
+ readonly declared: readonly string[];
263
+ }): typeof fetch;
255
264
  /** The member of a declaration that would carry a value (retired: values come from the seat). */
256
265
  export declare const RETIRED_VALUE_MEMBERS: Readonly<{
257
266
  readonly mcp: readonly (readonly string[])[];
@@ -285,6 +294,11 @@ export type PeerCarrierIdentity = PeerSeatTarget | {
285
294
  export declare function mcpPeerTarget(spec: McpServerSpec, kind: McpTransportKind | undefined): PeerCarrierIdentity;
286
295
  /** Whether a failure is the HTTP endpoint answering 401 (the SDK's status error, on the thrown value or its cause chain). Structure only. */
287
296
  export declare function answeredUnauthorized(err: unknown): boolean;
297
+ /** The one reading of a re-send's failure: its record says it was not delivered (`details.delivered === "no"` — the seat could not
298
+ * furnish it, the endpoint refused the connection, the revocation ledger stopped it at the request door). Such a re-send does not speak
299
+ * for a call whose earlier attempt was sent: the call answers that attempt's failure (a 401's re-send here, a lost session's in
300
+ * mcp-server-link.ts `callThroughLink`). */
301
+ export declare function resendUndelivered(err: unknown): boolean;
288
302
  /** A call answered 401 after which the seat's re-ask answered other pieces: its failure as it would have been thrown then. */
289
303
  export declare class Reauthorized {
290
304
  readonly error: unknown;
@@ -292,8 +306,8 @@ export declare class Reauthorized {
292
306
  }
293
307
  /**
294
308
  * The call layer's one re-send after a 401: `attempt(false)` once; when it answers {@link Reauthorized} and `mayResend`
295
- * (the revocation probe and `reach`, asked again) holds, `attempt(true)` once more, carrying what the re-ask answered — the flag says
296
- * whether this is the last attempt (its refusal is the call's answer). A re-send the seat could not furnish ends with the first
309
+ * (`reach`, asked again) holds, `attempt(true)` once more, carrying what the re-ask answered — the flag says whether this is the last
310
+ * attempt (its refusal is the call's answer). A re-send that was not delivered ({@link resendUndelivered}) ends with the first
297
311
  * attempt's failure, whose delivery verdict stands for the call (one of its attempts was sent).
298
312
  */
299
313
  export declare function sentOnceMore<R>(attempt: (last: boolean) => Promise<R | Reauthorized>, mayResend: () => boolean): Promise<R>;
@@ -3,10 +3,11 @@ import { types } from "node:util";
3
3
  import { SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
4
4
  import { canonicalize } from "./canonical-json.js";
5
5
  import { readCredentialRef } from "@sema-agent/primitives";
6
- import { callerText } from "./mcp-server-spec.js";
6
+ import { callerText } from "./caller-text.js";
7
7
  import { optionKeys, strayMembersOf } from "./own-property-receipt.js";
8
8
  import { readMember, readOwnMembers } from "./thrown-value.js";
9
- import { httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
9
+ import { assertEndpointBound, httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
10
+ import { askCarriedRevocation } from "./protocol-revocation.js";
10
11
  import { credentialHeaderValues, holdOwnCredentialValues, isSecretEnvKey, namesASecret } from "./secret-env.js";
11
12
  import { inlineUntrusted } from "./untrusted-text.js";
12
13
  const PEER_SEAT_MEMBERS = Object.freeze(["answer", "hold", "release"]);
@@ -182,25 +183,28 @@ const digestOf = (pieces) => {
182
183
  const rows = (m) => Object.entries(m ?? {}).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
183
184
  return createHash("sha256").update(JSON.stringify([rows(pieces.headers), rows(pieces.env)])).digest("hex");
184
185
  };
185
- const NO_PIECES = Object.freeze({ digest: digestOf({}) });
186
+ export const NO_PIECES = Object.freeze({ digest: digestOf({}) });
186
187
  function nameValues(raw, member) {
187
188
  const members = readOwnMembers(raw);
188
189
  if (members === undefined)
189
190
  return `its ${member} is not a record of names to strings`;
190
191
  const out = Object.create(null);
191
- const folded = new Set();
192
- for (const name of Object.keys(members)) {
192
+ const folded = new Map();
193
+ const names = Object.keys(members);
194
+ const at = (i) => `#${i + 1} of ${names.length}`;
195
+ for (const [i, name] of names.entries()) {
193
196
  const value = members[name];
194
197
  if (typeof value !== "string")
195
- return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} is not a string`;
198
+ return `its ${member} member ${at(i)} (${callerText(name)}) is not a string`;
196
199
  if (!(member === "headers" ? HEADER_NAME : ENV_NAME).test(name))
197
- return `its ${member} name ${inlineUntrusted(JSON.stringify(name), 80)} is not a ${member === "headers" ? "header" : "variable"} name`;
200
+ return `its ${member} member ${at(i)} (${callerText(name)}) is not a ${member === "headers" ? "header" : "variable"} name`;
198
201
  if (VALUE_LAW[member].refuses.test(value))
199
- return `its ${member} member ${inlineUntrusted(JSON.stringify(name), 80)} holds ${VALUE_LAW[member].holds}`;
202
+ return `its ${member} member ${at(i)} (${callerText(name)}) holds ${VALUE_LAW[member].holds}`;
200
203
  if (member === "headers") {
201
- if (folded.has(name.toLowerCase()))
202
- return `its headers name ${inlineUntrusted(JSON.stringify(name), 80)} twice (header names are case-insensitive)`;
203
- folded.add(name.toLowerCase());
204
+ const first = folded.get(name.toLowerCase());
205
+ if (first !== undefined)
206
+ return `its headers members ${at(first)} and ${at(i)} are one header name (header names are case-insensitive)`;
207
+ folded.set(name.toLowerCase(), i);
204
208
  }
205
209
  out[name] = value;
206
210
  }
@@ -214,10 +218,10 @@ export function readPeerAnswer(raw, lane) {
214
218
  const memberOf = (name) => (Object.hasOwn(record, name) ? record[name] : undefined);
215
219
  const kind = memberOf("kind");
216
220
  if (kind !== "carry" && kind !== "unauthorized")
217
- return { problem: `answered the kind ${inlineUntrusted(JSON.stringify(kind) ?? String(kind), 80)}, which is neither "carry" nor "unauthorized"` };
221
+ return { problem: `answered the kind ${callerText(kind)}, which is neither "carry" nor "unauthorized"` };
218
222
  const extra = strayMembersOf(record, { subject: "the peer seat's answer", unit: "member", moment: "when the answer is read" }, ANSWER_MEMBERS[kind])?.names[0];
219
223
  if (extra !== undefined)
220
- return { problem: `answered the member ${inlineUntrusted(JSON.stringify(String(extra)), 80)}, which a "${kind}" answer does not have` };
224
+ return { problem: `answered the member ${callerText(extra)}, which a "${kind}" answer does not have — its members are ${ANSWER_MEMBERS[kind].map((m) => JSON.stringify(m)).join(", ")}` };
221
225
  if (kind === "unauthorized") {
222
226
  const given = memberOf("authorizeUrl");
223
227
  if (given === undefined)
@@ -472,11 +476,13 @@ export function carriedHttpHeaders(protocol, carrier, pieces, principalHeader, p
472
476
  throw new PeerSeatFailure("answer_invalid", carrier.label, `answered headers the engine cannot send (${inlineUntrusted(message, 240)})`, typeof code === "string" ? { code } : undefined);
473
477
  }
474
478
  }
475
- export function peerFetch(carrier, principalHeader, principal) {
479
+ export function peerFetch(carrier, principalHeader, principal, bound) {
476
480
  return async (url, init) => {
477
481
  const signal = init?.signal ?? undefined;
478
482
  const pieces = await carrier.next(signal);
479
483
  const own = carriedHttpHeaders("mcp", carrier, pieces, principalHeader, principal);
484
+ assertEndpointBound("mcp", bound.server, typeof url === "string" ? url : url instanceof URL ? url.href : url.url, bound.declared, own === undefined ? undefined : { ...own });
485
+ askCarriedRevocation();
480
486
  const headers = new Headers(init?.headers);
481
487
  for (const [name, value] of Object.entries(own ?? {}))
482
488
  headers.set(name, value);
@@ -553,6 +559,10 @@ export function answeredUnauthorized(err) {
553
559
  }
554
560
  return false;
555
561
  }
562
+ export function resendUndelivered(err) {
563
+ const details = readMember(err, "details");
564
+ return typeof details === "object" && details !== null && readMember(details, "delivered") === "no";
565
+ }
556
566
  export class Reauthorized {
557
567
  error;
558
568
  constructor(error) {
@@ -566,8 +576,7 @@ export async function sentOnceMore(attempt, mayResend) {
566
576
  if (!mayResend())
567
577
  throw first.error;
568
578
  const again = await attempt(true).catch((err) => {
569
- const details = readMember(err, "details");
570
- throw typeof details === "object" && details !== null && readMember(details, "delivered") === "no" ? first.error : err;
579
+ throw resendUndelivered(err) ? first.error : err;
571
580
  });
572
581
  if (again instanceof Reauthorized)
573
582
  throw again.error;
@@ -680,18 +680,28 @@ function refusal(code, reason, committed = "no") {
680
680
  }
681
681
  async function storeStep(step, failure) {
682
682
  try {
683
- return { value: await step() };
683
+ const value = await step();
684
+ const answers = failure.answers;
685
+ if (answers !== undefined && !answers.accepts(value)) {
686
+ return { refused: refusal(failure.code, `${failure.what}: the store answered ${answerKindOf(value)}, not ${answers.expected}`) };
687
+ }
688
+ return { value };
684
689
  }
685
690
  catch (err) {
686
691
  return { refused: refusal(failure.code, `${failure.what}: ${errText(err)}`) };
687
692
  }
688
693
  }
689
- const RECORD_READ = { code: "store_read", what: "could not read the approval record" };
690
- const RECORD_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this redemption's dot" };
694
+ function answerKindOf(answer) {
695
+ return answer === null ? "null" : Array.isArray(answer) ? "a list" : typeof answer === "object" ? "an object" : `a ${typeof answer}`;
696
+ }
697
+ const RECORD_ANSWER = { accepts: (a) => a === undefined || (typeof a === "object" && a !== null && !Array.isArray(a)), expected: "a record, a stale-record envelope or nothing" };
698
+ const CAS_ANSWER = { accepts: (a) => typeof a === "boolean", expected: "a boolean" };
699
+ const RECORD_READ = { code: "store_read", what: "could not read the approval record", answers: RECORD_ANSWER };
700
+ const RECORD_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this redemption's dot", answers: CAS_ANSWER };
691
701
  const DOT_ALLOCATION = { code: "store_write", what: "the permission-rule store failed to allocate this redemption's dot" };
692
702
  const RECORD_CREATE = { code: "store_write", what: "the approval record store failed to create the record" };
693
- const RECORD_CONFIRM_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this confirmation" };
694
- const RECORD_EDIT_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this card edit" };
703
+ const RECORD_CONFIRM_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this confirmation", answers: CAS_ANSWER };
704
+ const RECORD_EDIT_CAS = { code: "store_write", what: "the approval record store failed the compare-and-set that records this card edit", answers: CAS_ANSWER };
695
705
  function confirmStoreFailure(refused) {
696
706
  return { ok: false, reason: refused.code, detail: { message: refused.reason } };
697
707
  }
@@ -954,8 +954,10 @@ export type ProgramRunReachOutcome = {
954
954
  * rule's word there — unless it is the SAME glob/brace spelling the body wrote); a prefix body whose
955
955
  * every word is matched is `reached` whatever follows; an exact body needs equal length — a longer
956
956
  * command is `not_reached` unless an extra word is an UNQUOTED expansion (or `"$@"` / an array
957
- * expansion), which may expand to nothing. The commands inside a substitution and an unquoted heredoc
958
- * body are segments of their own (`echo "$(rm -r x)"` runs `rm`). A compound
957
+ * expansion), which may expand to nothing. The command line a command or process substitution runs (in a
958
+ * word, a redirection operand, an unquoted heredoc body, an arithmetic text) is read by the same reader and
959
+ * judged as a line of its own, to every depth the reader reads (`echo "$(rm -r x)"` runs `rm`; a deny reaches
960
+ * it there as at the top level); a substitution whose line the reader cannot read stands as an unreadable segment. A compound
959
961
  * body (`Bash(echo ok && rm -r:*)`) reaches only a chain of the same shape — same segment count, same
960
962
  * connectors, every leading segment equal, the final one by the body's match kind; a single-segment
961
963
  * body reaches any segment. A segment the lexer could not read makes the answer `unreadable` when no