@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
@@ -4,10 +4,10 @@ import { resolveCheckpointStore } from "../checkpoint-store.js";
4
4
  import { createHookEnvCapabilities, mintHookInvocationIdentity } from "../hooks.js";
5
5
  import { chainJudges } from "../mods/stations.js";
6
6
  import { failureFields } from "../mcp-failure.js";
7
- import { toolNamesOfServer } from "../mounted-mcp.js";
8
- import { declaredSuspend, isRemoteExecutionEnv, missingRestoreSurface } from "../remote-env.js";
7
+ import { toolFieldsOfServer } from "../mounted-mcp.js";
8
+ import { suspendTargetGapRowOf } from "../remote-env.js";
9
9
  import { isVolatileOffloadStore } from "../tool-result-store.js";
10
- import { durableMandateSourceOf, isLiveApproverSeat } from "../tool-policy.js";
10
+ import { durableMandateSourceOf, effectiveDurableApprovalOf, isAnsweringSeat } from "../tool-policy.js";
11
11
  import { deliverEngineNotice } from "../types.js";
12
12
  import { inlineUntrusted } from "../untrusted-text.js";
13
13
  import { mountWriteProtection } from "./write-protection-station.js";
@@ -15,7 +15,7 @@ import { autoRunOnRecommendationEffective } from "./memory-consolidation-driver.
15
15
  import { GLOBAL_USAGE_KEY, usageRetryAfterMs, windowsGovernCost } from "../usage-window-store.js";
16
16
  import { rosterEntryNamed, toolCallFaceOf } from "../tool-roster.js";
17
17
  import { isShellFaceToolName } from "../tool-registry.js";
18
- import { LSP_CONTRACT_ID, askSeatEffective, countElicitOptIns, deriveHandsSeam, deriveLspSeam, deriveWiringManifest, resolveDeclaredDurability, resolveElicitSeam, resolveQuestionSeam, resolveSubagentTranscriptTier } from "../wiring-manifest.js";
18
+ import { LSP_CONTRACT_ID, MCP_ENTRY_TOOL_NAMES_MAX, askAnsweredClassesOf, askSeatEffective, countElicitOptIns, deriveHandsSeam, deriveLspSeam, deriveWiringManifest, resolveDeclaredDurability, resolveElicitSeam, resolveQuestionSeam, resolveSubagentTranscriptTier } from "../wiring-manifest.js";
19
19
  import { modePolicyOf, modeQuestionReaches } from "../mode-policy.js";
20
20
  export function mcpManifestEntries(entries, statuses, rosterNames) {
21
21
  return (entries ?? []).map((entry) => {
@@ -25,7 +25,7 @@ export function mcpManifestEntries(entries, statuses, rosterNames) {
25
25
  if (status === undefined)
26
26
  return { name: entry.name, ...source, status: "skipped", toolCount: 0 };
27
27
  if (status.status === "connected")
28
- return { name: entry.name, ...source, status: "connected", toolCount: toolNamesOfServer(rosterNames, entry.name).length, ...liveness };
28
+ return { name: entry.name, ...source, status: "connected", ...toolFieldsOfServer(rosterNames, entry.name, MCP_ENTRY_TOOL_NAMES_MAX), ...liveness };
29
29
  return {
30
30
  name: entry.name,
31
31
  ...source,
@@ -93,34 +93,66 @@ function buildUsageGovernance(windows, deps, principal, sessionId) {
93
93
  };
94
94
  }
95
95
  const ungatedWarnedShapes = new WeakMap();
96
+ function liveChainSeatClause(form) {
97
+ switch (form) {
98
+ case "callback":
99
+ return "a live approver answers permission asks in-stream";
100
+ case "policy_callback":
101
+ return "the deployment's approval policy answers permission asks in-stream (it cannot approve an ask that requires a person)";
102
+ case "allow":
103
+ return 'a blanket "allow" posture answers ordinary permission asks without judgment (a mandated ask is refused)';
104
+ case "deny":
105
+ case "absent":
106
+ case "declared_none":
107
+ return "permission asks are denied fail-closed — nobody in this run can be asked to approve them";
108
+ default: {
109
+ const _exhaustive = form;
110
+ void _exhaustive;
111
+ throw new Error(`unreachable ask seat form ${String(form)}`);
112
+ }
113
+ }
114
+ }
115
+ const LEG_NOT_RESUMABLE_SENTENCE = "Durable approval gate mandated but unavailable: the runtime entitlement forceDurableGate is in force for this principal, but this delegated leg cannot be resumed — its parent forwarded it no durable approval (a synchronous or fork child, or a background child whose lane cannot park) — so no ask of it can be parked for a durable answer, and none is answered in its place: every permission ask is refused without asking anyone and AskUserQuestion is refused (not shown). NO durable approval record is written. Ask from the parent leg itself, delegate the work as a background agent on a lane that can park, or withdraw the entitlement.";
96
116
  function announceDurableGateUnavailable(args) {
97
- if (args.mandate === undefined || args.storeWired)
117
+ if (args.mandate === undefined || (args.storeWired && !args.notResumable))
98
118
  return;
99
119
  const source = args.mandate;
100
- const cause = args.taskStoreDisabled ? "task_store_disabled" : "no_deployment_store";
120
+ const cause = args.storeWired ? "leg_not_resumable" : args.taskStoreDisabled ? "task_store_disabled" : "no_deployment_store";
101
121
  const inheritedContentMandate = (args.parentConstraints ?? []).some((pc) => pc.contentMandate === true);
102
- const liveQuestionFace = args.liveQuestionFace && !inheritedContentMandate;
122
+ const answersLive = cause !== "leg_not_resumable";
123
+ const liveQuestionFace = args.liveQuestionFace && !inheritedContentMandate && answersLive;
103
124
  deliverEngineNotice(args.onNotice, {
104
125
  code: "config.durable_gate_unavailable",
105
- message: `Durable approval gate mandated but unavailable: ${source === "force_durable_gate" ? "the runtime entitlement forceDurableGate is in force for this principal" : "this task opted into durable approval (durableApproval) with no live approver seat"}, ` +
106
- `but ${cause === "task_store_disabled" ? 'this task disabled the checkpoint store (checkpointStore: "disabled")' : "this deployment wired no checkpoint store"}, ` +
107
- `so no interactive ask of this task can be parked for a durable answer. Asks resolve on the live chain instead ` +
108
- `(${args.liveApprover ? "a live approver answers permission asks in-stream" : args.blanketAllow ? 'a blanket "allow" posture answers ordinary permission asks without judgment (a mandated ask is refused)' : "permission asks are denied fail-closed — nobody in this run can be asked to approve them"}; ` +
109
- `${liveQuestionFace ? "a live question face answers AskUserQuestion in-stream" : args.liveQuestionFace ? "AskUserQuestion is withheld from the live face by an inherited durable mandate and refused" : "AskUserQuestion has no live face and is refused"}) ` +
110
- `and NO durable approval record is written. ${cause === "task_store_disabled" ? "Run this task with its store" : "Wire a checkpoint store on this deployment"}, or ${source === "force_durable_gate" ? "withdraw the entitlement for principals served here" : args.declaredNone ? 'run the task where a person can be asked (without approvalReach: "none"), or drop durableApproval' : "give the task a live approver seat (or drop durableApproval)"}.`,
126
+ message: !answersLive ? LEG_NOT_RESUMABLE_SENTENCE :
127
+ `Durable approval gate mandated but unavailable: ${source === "force_durable_gate" ? "the runtime entitlement forceDurableGate is in force for this principal" : "this task opted into durable approval (durableApproval) with no live approver seat"}, ` +
128
+ `but ${cause === "task_store_disabled" ? 'this task disabled the checkpoint store (checkpointStore: "disabled")' : "this deployment wired no checkpoint store"}, ` +
129
+ `so no interactive ask of this task can be parked for a durable answer. Asks resolve on the live chain instead ` +
130
+ `(${liveChainSeatClause(args.seatForm)}; ` +
131
+ `${liveQuestionFace ? "a live question face answers AskUserQuestion in-stream" : args.liveQuestionFace ? "AskUserQuestion is withheld from the live face by an inherited durable mandate and refused" : "AskUserQuestion has no live face and is refused"}) ` +
132
+ `and NO durable approval record is written. ${cause === "task_store_disabled" ? "Run this task with its store" : "Wire a checkpoint store on this deployment"}, or ${source === "force_durable_gate" ? "withdraw the entitlement for principals served here" : args.declaredNone ? 'run the task where a person can be asked (without approvalReach: "none"), or drop durableApproval' : "give the task a live approver seat (or drop durableApproval)"}.`,
111
133
  detail: {
112
134
  sessionId: args.sessionId,
113
135
  runId: args.runId,
114
136
  ...(args.principal ? { principal: args.principal } : {}),
115
137
  cause,
116
138
  source,
117
- liveApprover: args.liveApprover,
139
+ liveApprover: args.liveApprover && answersLive,
118
140
  liveQuestionFace,
119
141
  },
120
142
  });
121
143
  }
144
+ export function durableSuspendInfraGaps(facts) {
145
+ const gaps = [];
146
+ if (!facts.storeWired)
147
+ gaps.push({ code: "no_checkpoint_store", why: "no CheckpointStore is wired" });
148
+ if (facts.volatileToolResults)
149
+ gaps.push({ code: "volatile_tool_results", why: "tool-result offload uses the in-memory store (a resume needs durable results)" });
150
+ if (facts.envGap !== undefined)
151
+ gaps.push({ code: facts.envGap.code, why: `the per-task execution env ${facts.envGap.clause}` });
152
+ return gaps;
153
+ }
122
154
  export function prepareWiringManifest(input) {
123
- const { spec, deps, internals, resume, sessionId, runId, hostTaskId, taskScope, modBus, standingModBus, checkpointScope, policyLayers, effectivePolicy, handsEnabled, taskRootFinal, legWriteGuard, mcp, irreversibleTools, egressTools, toolEffects, ownedEnv, executionEnv, offloadStore, onceLedger, usageWindows, envLifetimeSuspendAt, runtimeCaps, resolvedInteractionPosture, durableQuestionFace, liveQuestionFace, checkpointStore, sessions, modelGateManifest, autoModeArmReason, permissionMode, lockedPreflight, peerLaneRefs, frameSettlement, receiveSeat, sessionBox, sessionAddress, harness, pausedRef, askSeat, liveInheritedGate, delegation, toolRoster, readDenyBuiltinTiersActive, lspManagerWired, shellReadStationArmed, crossBoundaryStationEngaged, lspDiagnosticsLive, fileHistoryFact, projectMemoryFact, sessionRulesChildrenReadLive, memoryPollution, advisorFact, hostFloorPosture, runOrigin } = input;
155
+ const { spec, deps, internals, resume, sessionId, runId, hostTaskId, taskScope, modBus, standingModBus, checkpointScope, policyLayers, effectivePolicy, handsEnabled, taskRootFinal, legWriteGuard, mcp, irreversibleTools, egressTools, toolEffects, ownedEnv, executionEnv, offloadStore, onceLedger, usageWindows, envLifetimeSuspendAt, runtimeCaps, resolvedInteractionPosture, durableQuestionFace, liveQuestionFace, checkpointStore, sessions, modelGateManifest, autoModeArmReason, permissionMode, lockedPreflight, peerLaneRefs, frameSettlement, receiveSeat, sessionBox, sessionAddress, harness, pausedRef, askSeat, liveInheritedGate, delegation, approvalParkNotResumable, forcedGateNotResumable, toolRoster, toolPlan, readDenyBuiltinTiersActive, lspManagerWired, shellReadStationArmed, crossBoundaryStationEngaged, lspDiagnosticsLive, fileHistoryFact, projectMemoryFact, sessionRulesChildrenReadLive, memoryPollution, advisorFact, hostFloorPosture, runOrigin, commandSandboxFact } = input;
124
156
  const onAsk = askSeat.value;
125
157
  const handWriteTools = toolRoster.entries.filter((e) => e.mountedBy === "hands" && (e.effect === "write" || e.effect === "idempotent")).map((e) => e.name);
126
158
  const hasEffectAwareGate = policyLayers.length > 0 || chainJudges(standingModBus);
@@ -167,31 +199,25 @@ export function prepareWiringManifest(input) {
167
199
  const blockedToolCalls = new Set();
168
200
  const batchHaltRef = {};
169
201
  const blockedTracked = ["classic.PostToolUse", "classic.PreToolUse", "classic.PostToolUseFailure", "classic.PostToolBatch"].some((ev) => modBus.hasHandlers(ev));
170
- const ownedRemote = ownedEnv !== undefined && isRemoteExecutionEnv(ownedEnv) ? ownedEnv : undefined;
171
- const ownedSuspend = ownedRemote !== undefined ? declaredSuspend(ownedRemote) : undefined;
172
- const restoreSurfaceGap = ownedRemote !== undefined && ownedSuspend === true ? missingRestoreSurface(ownedRemote) : [];
173
- const suspendTargetGap = ownedEnv === undefined ? undefined
174
- : ownedRemote === undefined ? "is not a RemoteExecutionEnv (it would be destroyed on suspend, so a resumed file or shell tool would act on a fresh, empty env)"
175
- : ownedSuspend === "undeclared" ? "does not declare capabilities.suspendable (absent, not a boolean, or unreadable), so it is neither snapshot nor parked"
176
- : restoreSurfaceGap.length > 0 ? `declares capabilities.suspendable but its adapter does not implement ${restoreSurfaceGap.join(" or ")}` : undefined;
177
- const durableSuspendInfraReady = resolveCheckpointStore(spec, deps) !== undefined &&
178
- !(offloadStore !== undefined && isVolatileOffloadStore(offloadStore)) &&
179
- suspendTargetGap === undefined;
202
+ const suspendTargetGapRow = suspendTargetGapRowOf(ownedEnv);
203
+ const suspendTargetGap = suspendTargetGapRow?.clause;
204
+ const suspendInfraGaps = durableSuspendInfraGaps({
205
+ storeWired: resolveCheckpointStore(spec, deps) !== undefined,
206
+ volatileToolResults: offloadStore !== undefined && isVolatileOffloadStore(offloadStore),
207
+ envGap: suspendTargetGapRow,
208
+ });
209
+ const durableSuspendInfraReady = suspendInfraGaps.length === 0;
210
+ const suspendLaneGap = durableSuspendInfraReady ? undefined : suspendInfraGaps.map((g) => g.why).join("; ");
180
211
  const resourceSuspendEligible = spec.resourceSuspend !== undefined && durableSuspendInfraReady;
181
212
  if (spec.resourceSuspend !== undefined && !resourceSuspendEligible) {
182
- const why = resolveCheckpointStore(spec, deps) === undefined
183
- ? "no CheckpointStore is wired"
184
- : offloadStore !== undefined && isVolatileOffloadStore(offloadStore)
185
- ? "tool-result offload uses the in-memory store (a resume needs durable results)"
186
- : `the per-task execution env ${suspendTargetGap}`;
187
- onceLedger.onError(new Error(`resourceSuspend is set but INACTIVE: ${why}; resource limits will hard-fail, not suspend`), {
213
+ onceLedger.onError(new Error(`resourceSuspend is set but INACTIVE: ${suspendLaneGap}; resource limits will hard-fail, not suspend`), {
188
214
  phase: "config",
189
215
  sessionId,
190
216
  });
191
217
  }
192
218
  const usageGovernance = buildUsageGovernance(usageWindows, deps, spec.principal, sessionId);
193
- const platformSuspendArmed = durableSuspendInfraReady && (envLifetimeSuspendAt !== undefined || usageGovernance !== undefined);
194
- const durableApproval = spec.durableApproval ?? (runtimeCaps?.forceDurableGate ? { scope: checkpointScope } : undefined);
219
+ const platformSuspendArmed = durableSuspendInfraReady && (spec.preemptSignal !== undefined || envLifetimeSuspendAt !== undefined || usageGovernance !== undefined);
220
+ const durableApproval = effectiveDurableApprovalOf({ declared: spec.durableApproval, forceDurableGate: runtimeCaps?.forceDurableGate === true, approvalParkNotResumable, scope: checkpointScope });
195
221
  const writeProtection = mountWriteProtection({ deps, guard: legWriteGuard, spec, env: handsEnabled ? executionEnv : undefined, rootPath: taskRootFinal, roster: toolRoster, sessionId, runId });
196
222
  const wiringQuestionSeam = resolveQuestionSeam(spec, deps);
197
223
  const wiringQuestionStripped = internals?.questionFaceStripped === true;
@@ -202,6 +228,7 @@ export function prepareWiringManifest(input) {
202
228
  ...(spec.peerPresence !== undefined ? { peerPresence: spec.peerPresence } : {}),
203
229
  askForm: askSeat.form,
204
230
  ...(askSeat.provenance !== undefined ? { askProvenance: askSeat.provenance } : {}),
231
+ ...((answered) => (answered !== undefined ? { askAnsweredClasses: answered } : {}))(askAnsweredClassesOf(askSeat)),
205
232
  questionWired: wiringQuestionSeam.wired,
206
233
  ...(wiringQuestionSeam.provenance !== undefined ? { questionProvenance: wiringQuestionSeam.provenance } : {}),
207
234
  ...(wiringQuestionStripped ? { questionStrippedByEngine: true } : {}),
@@ -213,10 +240,11 @@ export function prepareWiringManifest(input) {
213
240
  elicitServersOptedIn: countElicitOptIns(spec),
214
241
  parkCapable: checkpointStore !== undefined,
215
242
  parkDurableApprovalOptIn: spec.durableApproval !== undefined,
216
- parkForceDurableGate: runtimeCaps?.forceDurableGate === true,
243
+ parkForceDurableGate: runtimeCaps?.forceDurableGate === true && durableApproval !== undefined,
217
244
  parkSafetyVocabularyArmed: irreversibleTools.size > 0 || egressTools.size > 0 || shellReadStationArmed,
218
245
  ...(checkpointStore !== undefined ? { checkpointDurability: resolveDeclaredDurability(checkpointStore, "checkpointStore") } : {}),
219
246
  sessionDurability: resolveDeclaredDurability(sessions, "sessionStore"),
247
+ suspendLaneReasons: suspendInfraGaps.map((g) => g.code),
220
248
  backgroundAgentStoreWired: deps.backgroundAgentStore !== undefined,
221
249
  subagentTranscriptTier: resolveSubagentTranscriptTier(deps.backgroundAgentStore !== undefined, sessions),
222
250
  permissionRuleStoreWired: deps.permissionRuleStore?.partitions.durable === true,
@@ -235,18 +263,19 @@ export function prepareWiringManifest(input) {
235
263
  readDenyBuiltinTiersActive,
236
264
  autoConsolidationOnRecommendation: autoRunOnRecommendationEffective(deps),
237
265
  tools: toolRoster,
266
+ toolPlan,
238
267
  mods: modBus.records,
239
268
  ...(lspManagerWired ? { lsp: deriveLspSeam(toolRoster.entries.some((e) => e.contract.contractId === LSP_CONTRACT_ID), lspDiagnosticsLive) } : {}),
240
269
  hands: deriveHandsSeam(handsEnabled),
241
- fileHistory: fileHistoryFact, projectMemory: projectMemoryFact, sessionRulesChildrenReadLive, ...(advisorFact !== undefined ? { advisor: advisorFact } : {}), ...(hostFloorPosture !== undefined ? { hostFloor: hostFloorPosture } : {}),
270
+ fileHistory: fileHistoryFact, commandSandbox: commandSandboxFact, projectMemory: projectMemoryFact, sessionRulesChildrenReadLive, ...(advisorFact !== undefined ? { advisor: advisorFact } : {}), ...(hostFloorPosture !== undefined ? { hostFloor: hostFloorPosture } : {}),
242
271
  });
243
272
  peerLaneRefs.askEffective = askSeatEffective(wiringManifest);
244
273
  peerLaneRefs.permissionMode = () => permissionMode.current;
245
- const drainLanes = internals?.onTaskNotification !== undefined ? peerDrainLanesOf(deps, { sessionBox, hostTaskId, sessionId }) : undefined;
274
+ const drainLanes = internals?.onTaskNotification !== undefined ? peerDrainLanesOf(deps, { sessionBox, assistantSeat: internals.principalInboxAssistant, sessionId }) : undefined;
246
275
  const sessionBoxBound = drainLanes?.sessionBox;
247
276
  if (drainLanes !== undefined && internals?.onTaskNotification !== undefined) {
248
277
  bindPeerLaneDrain(harness, {
249
- deps, lanes: drainLanes,
278
+ deps, lanes: drainLanes, assistantSeat: internals.principalInboxAssistant,
250
279
  address: sessionAddress,
251
280
  sessions,
252
281
  runId,
@@ -258,7 +287,16 @@ export function prepareWiringManifest(input) {
258
287
  receive: receiveSeat,
259
288
  selfName: () => internals?.explicitAgentName,
260
289
  parked: () => pausedRef.current !== undefined,
261
- markExternalContent: (reason) => memoryPollution?.()?.markPolluted(reason, "observed"),
290
+ markExternalContent: async (reason) => {
291
+ const face = memoryPollution?.();
292
+ if (face === undefined)
293
+ return;
294
+ if ((await face.markPolluted(reason, "observed")) === "unpersisted") {
295
+ const e = new Error("a letter from another principal was not injected: this session's exposure to it could not be recorded durably (the memory control plane refused the pollution marker) — it stays in the box and is delivered once the record can be made");
296
+ e.code = "memory.pollution_mark_failed";
297
+ throw e;
298
+ }
299
+ },
262
300
  });
263
301
  frameSettlement.boxBacked = (payload) => peerLaneRefs.isBoxBacked?.(payload) ?? false;
264
302
  }
@@ -270,8 +308,9 @@ export function prepareWiringManifest(input) {
270
308
  shellReadStationArmed || crossBoundaryStationEngaged ||
271
309
  resourceSuspendEligible ||
272
310
  platformSuspendArmed ||
273
- spec.enablePlanMode === true;
274
- announceDurableGateUnavailable({ onNotice: deps.onNotice, mandate: durableMandateSourceOf({ forceDurableGate: runtimeCaps?.forceDurableGate === true, durableApprovalDeclared: spec.durableApproval !== undefined, onAsk }), storeWired: checkpointStore !== undefined, taskStoreDisabled: spec.checkpointStore === "disabled", liveApprover: isLiveApproverSeat(onAsk), blanketAllow: onAsk === "allow", declaredNone: askSeat.reach === "none", liveQuestionFace: liveQuestionFace !== undefined, parentConstraints: liveInheritedGate?.parentConstraints, sessionId, runId, principal: spec.principal });
311
+ spec.enablePlanMode === true ||
312
+ commandSandboxFact.state === "armed";
313
+ announceDurableGateUnavailable({ onNotice: deps.onNotice, mandate: durableMandateSourceOf({ forceDurableGate: runtimeCaps?.forceDurableGate === true, durableApprovalDeclared: spec.durableApproval !== undefined, onAsk }), storeWired: checkpointStore !== undefined, taskStoreDisabled: spec.checkpointStore === "disabled", notResumable: forcedGateNotResumable, liveApprover: isAnsweringSeat(onAsk), seatForm: askSeat.form, declaredNone: askSeat.reach === "none", liveQuestionFace: liveQuestionFace !== undefined, parentConstraints: liveInheritedGate?.parentConstraints, sessionId, runId, principal: spec.principal });
275
314
  const hookIdentity = mintHookInvocationIdentity({
276
315
  sessionId,
277
316
  taskId: hostTaskId,
@@ -285,5 +324,5 @@ export function prepareWiringManifest(input) {
285
324
  });
286
325
  const hookContextConsumerWired = ["classic.PreToolUse", "classic.PostToolUse", "classic.PostToolUseFailure"].some((ev) => modBus.hasHandlers(ev));
287
326
  const hookEnvFace = hookContextConsumerWired && (ownedEnv ?? deps.executionEnv) != null ? createHookEnvCapabilities(executionEnv) : undefined;
288
- return { onAsk, preToolContexts, blockedToolCalls, batchHaltRef, blockedTracked, suspendTargetGap, durableSuspendInfraReady, resourceSuspendEligible, usageGovernance, platformSuspendArmed, durableApproval, wiringManifest, writeProtection, parkLaneArmed, gateMachineryActive, hookIdentity, hookEnvFace, sessionBoxBound };
327
+ return { onAsk, preToolContexts, blockedToolCalls, batchHaltRef, blockedTracked, suspendTargetGap, durableSuspendInfraReady, suspendLaneGap, resourceSuspendEligible, usageGovernance, platformSuspendArmed, durableApproval, wiringManifest, writeProtection, parkLaneArmed, gateMachineryActive, hookIdentity, hookEnvFace, sessionBoxBound };
289
328
  }
@@ -2,6 +2,7 @@ import { declaredSuspend, frozenHandleCopy, isRemoteExecutionEnv, missingRestore
2
2
  import { deviceMoveRefusal, settleOwnTarget } from "./placement-fence.js";
3
3
  import { remoteEnvFailureNote, restoreWorkspaceWithRetry } from "./remote-env-retry.js";
4
4
  import { rebaseWorkspacePathAcross } from "./workspace-path.js";
5
+ import { envErrorDetail } from "../../tools/fs/env-error-detail.js";
5
6
  export { remoteEnvFailureNote, restoreWorkspaceWithRetry } from "./remote-env-retry.js";
6
7
  export async function prepareWorkspaceRestore(input) {
7
8
  const { ownedEnv, deps, spec, internals, resume, abortController, sessionId } = input;
@@ -51,7 +52,7 @@ export async function prepareWorkspaceRestore(input) {
51
52
  priorHandle: frozenHandleCopy(handle),
52
53
  });
53
54
  if (!restored.ok) {
54
- failResume(`resumeVM failed after ${restoreAttempts} attempt(s) (${restored.error.code}): ${restored.error.message}`, restored.error, remoteEnvFailureNote("resumeVM", restored.error, restoreAttempts));
55
+ failResume(`resumeVM failed after ${restoreAttempts} attempt(s) (${restored.error.code}): ${envErrorDetail(restored.error.message)}`, restored.error, remoteEnvFailureNote("resumeVM", restored.error, restoreAttempts));
55
56
  }
56
57
  else {
57
58
  refuseIdentityMismatch(restored.value);
@@ -102,7 +103,7 @@ export async function prepareWorkspaceRestore(input) {
102
103
  }
103
104
  const init = await ownedEnv.postResumeInit();
104
105
  if (!init.ok) {
105
- failResume(`postResumeInit failed (${init.error.code}): ${init.error.message}`, init.error, remoteEnvFailureNote("postResumeInit", init.error, 1));
106
+ failResume(`postResumeInit failed (${init.error.code}): ${envErrorDetail(init.error.message)}`, init.error, remoteEnvFailureNote("postResumeInit", init.error, 1));
106
107
  }
107
108
  }
108
109
  }
@@ -4,6 +4,7 @@ import { READ_ROOT_CANDIDATE_DIR_MAX } from "../read-root-candidate.js";
4
4
  import { DEFAULT_GATE_AWAIT_TIMEOUT_MS } from "../gate-bounded-await.js";
5
5
  import { thrownText } from "../thrown-value.js";
6
6
  import { rootAdmittingArtifactStore } from "../../tools/fs/safety.js";
7
+ import { envErrorDetail } from "../../tools/fs/env-error-detail.js";
7
8
  export function readRootGrantOver(seats) {
8
9
  const { env, writeRoots, readRoots, artifactStore } = seats;
9
10
  return async (candidate, signal) => {
@@ -11,7 +12,7 @@ export function readRootGrantOver(seats) {
11
12
  if (signal.aborted)
12
13
  return { ok: false, reason: "unresolvable", cause: "the lookup was cut" };
13
14
  if (!c.ok)
14
- return { ok: false, reason: "unresolvable", cause: `${c.error.code}: ${c.error.message}` };
15
+ return { ok: false, reason: "unresolvable", cause: `${c.error.code}: ${envErrorDetail(c.error.message)}` };
15
16
  if (c.value !== candidate.dir)
16
17
  return { ok: false, reason: "resolves_elsewhere", cause: `it resolves to ${c.value}` };
17
18
  const store = artifactStore.current;
@@ -1,30 +1,43 @@
1
- import type { Model, Usage } from "../../internal/llm.js";
1
+ import type { AssistantMessageDiagnostic, Model, Usage } from "../../internal/llm.js";
2
+ import { type ServedReading } from "../../brain/model-lane.js";
2
3
  import { type ModelPricing } from "../pricing.js";
3
4
  import type { RunnerDeps } from "../types.js";
4
- /** One reply's usage priced by the engine: the model that served it, its price table, whether a table exists at all, and the
5
- * re-priced figures. */
5
+ /** One model call as the account bills it: the model it is priced at, the usage it reported, and whether that usage is a lower
6
+ * bound (`usageMissing`). */
7
+ export interface Bill {
8
+ readonly model: Model;
9
+ readonly usage: Usage;
10
+ readonly usageMissing?: true;
11
+ }
12
+ /**
13
+ * THE bills of one answer to a request for `requested`: every request it left behind on its way, then the answer itself — each at
14
+ * the model that made it ({@link servedReadingOf}: ids resolved along the requested model's own chain, never looked up by word).
15
+ * An answer that lists nothing left behind is one bill, at the model that answered. `usage` absent ⇒ no bill for the answer
16
+ * (the caller marks the lower bound).
17
+ */
18
+ export declare function billsOf(requested: Model, msg: {
19
+ readonly usage?: Usage;
20
+ readonly usageMissing?: true;
21
+ readonly diagnostics?: AssistantMessageDiagnostic[];
22
+ } | undefined): {
23
+ readonly reading: ServedReading;
24
+ readonly bills: readonly Bill[];
25
+ };
26
+ /** One bill priced by the engine: its model's price table, whether a table exists at all, and the re-priced figures. */
6
27
  export interface PricedReply {
7
- readonly served: Model | undefined;
28
+ readonly served: Model;
8
29
  readonly modelId: string;
9
30
  readonly price: ModelPricing;
10
- /** A price table EXISTS for the serving model (`isModelPriced`'s predicate): `false` ⇒ `costMicroUsd` is a fabricated 0 — unknown, not free. */
31
+ /** A price table EXISTS for the model (`isModelPriced`'s predicate): `false` ⇒ `costMicroUsd` is a fabricated 0 — unknown, not free. */
11
32
  readonly priced: boolean;
12
33
  readonly totalInputTokens: number;
13
34
  readonly uncachedInputTokens: number;
14
35
  readonly costMicroUsd: number;
15
36
  }
16
37
  /**
17
- * THE one place a model call made BESIDE the main loop is priced — the run's side-call lanes (`recordSideCallUsage`) and
18
- * `Runner.sideQuery`'s account line both read it, so a run's reported cost and a side query's cost are the same arithmetic. The
19
- * call's model prices independently of the main loop's telemetry state. A degrading brain may have served the reply from its
20
- * fallback: the model that ANSWERED is the one priced (the main loop re-points its pricing at it the same way). A fallback the
21
- * catalog does not know prices from the deployment's table by id when that has one, else as unpriced spend, and takes the cache
22
- * family that never undercounts.
38
+ * THE one pricing of a model call made BESIDE the main loop — the run's side-call lanes (`recordSideCallUsage`) and
39
+ * `Runner.sideQuery`'s account line both read it, so a run's reported cost and a side query's cost are the same arithmetic: the
40
+ * deployment's table for the model's id, else the model's own `cost`, with the model's cache family. The call's model prices
41
+ * independently of the main loop's telemetry state.
23
42
  */
24
- export declare function priceReply(usage: Usage, call: {
25
- readonly model: Model;
26
- readonly servedBy?: string;
27
- }, seats: {
28
- readonly pricing: RunnerDeps["pricing"];
29
- readonly catalog: RunnerDeps["models"];
30
- }): PricedReply;
43
+ export declare function priceReply(usage: Usage, model: Model, pricing: RunnerDeps["pricing"]): PricedReply;
@@ -1,19 +1,14 @@
1
+ import { servedReadingOf } from "../../brain/model-lane.js";
1
2
  import { isModelPriced, modelCostToPricing } from "../pricing.js";
2
3
  import { cacheFamilyOf, usageCostMicroUsd } from "./usage-accounting.js";
3
- function catalogModel(id, catalog) {
4
- if (catalog === undefined)
5
- return undefined;
6
- for (const m of Object.values(catalog))
7
- if (m.id === id)
8
- return m;
9
- return Object.hasOwn(catalog, id) ? catalog[id] : undefined;
4
+ export function billsOf(requested, msg) {
5
+ const reading = servedReadingOf(requested, msg);
6
+ const bills = reading.attempts.map((a) => ({ model: a.model, usage: a.usage, ...(a.usageMissing === true ? { usageMissing: true } : {}) }));
7
+ if (msg?.usage !== undefined)
8
+ bills.push({ model: reading.served, usage: msg.usage, ...(msg.usageMissing === true ? { usageMissing: true } : {}) });
9
+ return { reading, bills };
10
10
  }
11
- export function priceReply(usage, call, seats) {
12
- const { pricing, catalog } = seats;
13
- const served = call.servedBy === undefined ? call.model : catalogModel(call.servedBy, catalog);
14
- const modelId = served?.id ?? call.servedBy ?? call.model.id;
15
- const price = pricing?.[modelId] ?? modelCostToPricing(served?.cost);
16
- const priced = served !== undefined ? isModelPriced(served, pricing) : pricing?.[modelId] !== undefined;
17
- const family = served !== undefined ? cacheFamilyOf(served) : "input-excludes-cached";
18
- return { served, modelId, price, priced, ...usageCostMicroUsd(family, usage, price) };
11
+ export function priceReply(usage, model, pricing) {
12
+ const price = pricing?.[model.id] ?? modelCostToPricing(model.cost);
13
+ return { served: model, modelId: model.id, price, priced: isModelPriced(model, pricing), ...usageCostMicroUsd(cacheFamilyOf(model), usage, price) };
19
14
  }
@@ -1,13 +1,11 @@
1
- import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, resolveCheckpointStore, validatePendingSteer } from "../checkpoint-store.js";
1
+ import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, validatePendingSteer } from "../checkpoint-store.js";
2
2
  import { checkpointRowRefusal } from "../checkpoint-row-verdict.js";
3
- import { assertResumeConfigRecord, checkpointStoreSeat, refuseResumeDoors } from "./prepare-config-doors.js";
4
- import { compositionLegRecord } from "./checkpoint-scope.js";
5
- import { asResumeConfigRefusal } from "../mode-policy.js";
3
+ import { refuseResumeDoors } from "./prepare-config-doors.js";
4
+ import { readResumeConfig, resolveResumeStore, snapshotResumeInternals } from "../resume-config-judge.js";
6
5
  import { runExpiredDuty } from "./expire-settle.js";
7
6
  import { describeSuppliedValue } from "./decide-continuation.js";
8
- import { detachSkillLists } from "../skill-grant.js";
9
- import { readCallerSpec } from "../task-spec-members.js";
10
7
  import { PAUSE_REGISTRY } from "../pause-registry.js";
8
+ import { admitLegFrameSeat } from "./leg-frame.js";
11
9
  const DECIDE_ENTRY_BY_RESUME_GATE = {
12
10
  policy_ask: "a `policy_ask` outcome (decision allow/deny bound to the pending tool call)",
13
11
  dry_run_review: "a `dry_run_review` outcome (decision approve/reject)",
@@ -16,18 +14,13 @@ const DECIDE_ENTRY_BY_RESUME_GATE = {
16
14
  };
17
15
  export async function resumeAdmission(input) {
18
16
  const { token, outcome, taskConfig, runner, sessions, parentConstraintRegistry, suspendedEnvReaps } = input;
19
- let internals = input.internals;
17
+ let internals = admitLegFrameSeat(input.internals, "resumeStream");
20
18
  if (outcome === null || typeof outcome !== "object") {
21
19
  throw new CheckpointError("checkpoint.invalid_outcome", `resume outcome must be an object naming its gate (got ${outcome === null ? "null" : typeof outcome})`, { field: "outcome" });
22
20
  }
23
- asResumeConfigRefusal("taskConfig", () => assertResumeConfigRecord(taskConfig));
24
- const configRead = readCallerSpec(taskConfig);
25
- asResumeConfigRefusal("taskConfig", () => { if (configRead.refusal !== undefined)
26
- throw configRead.refusal; });
27
- let config = { ...configRead.spec, ...(Array.isArray(configRead.spec.skills) ? { skills: detachSkillLists(configRead.spec.skills) } : {}) };
28
- const snapshot = internals !== undefined ? { ...internals } : undefined;
29
- internals = snapshot?.compositionLeg !== undefined ? { ...snapshot, compositionLeg: compositionLegRecord(snapshot.compositionLeg) } : snapshot;
30
- const store = asResumeConfigRefusal(checkpointStoreSeat(config), () => resolveCheckpointStore(config, runner.deps));
21
+ let config = readResumeConfig(taskConfig);
22
+ internals = snapshotResumeInternals(internals);
23
+ const store = resolveResumeStore(config, runner.deps);
31
24
  if (!store) {
32
25
  throw new CheckpointError("checkpoint.not_found", "no CheckpointStore wired — cannot resume (set RunnerDeps.checkpointStore or taskConfig.checkpointStore)");
33
26
  }
@@ -76,6 +69,8 @@ export async function resumeAdmission(input) {
76
69
  }
77
70
  if (suppliedMessage !== undefined) {
78
71
  wakeMessage = validatePendingSteer(suppliedMessage);
72
+ if (wakeMessage.reply !== undefined)
73
+ throw new CheckpointError("steering.invalid_content", "a wake message carries no reply — the answer an extension gives an input is the engine's to record when it takes the input");
79
74
  if (judgeParkedSteerRepeat(parkedSteers, wakeMessage) !== undefined)
80
75
  wakeMessage = undefined;
81
76
  }
@@ -3,12 +3,14 @@ import { CheckpointError, remainingBudgetMicroUsd } from "../checkpoint-store.js
3
3
  import { chainPolicyOnLeg, chainTopAnchors } from "./child-tree.js";
4
4
  import { mintHookInvocationIdentity } from "../hooks.js";
5
5
  import { admitLegMods, classicEventBase, failedHandlerClause, promptScreenHasHandlers, screenUserPrompt } from "../mods/stations.js";
6
+ import { inputSourceOf } from "../steer-replay.js";
6
7
  import { legTaskIdOf } from "../leg-identity.js";
7
8
  import { restoreRowTaskId } from "./checkpoint-scope.js";
8
- import { checkToolPolicyProjection, policyCannotAnswer, refuseOutOfContractDecision } from "../tool-policy.js";
9
+ import { callFactsSeat, checkToolPolicyProjection, policyCannotAnswer, refuseOutOfContractDecision } from "../tool-policy.js";
10
+ import { editRecheckUnanswered } from "../real-approval.js";
9
11
  import { requestGrantBinding } from "../skill-grant-binding.js";
10
12
  import { skillGrantBindingMembers } from "../skill-grant.js";
11
- import { callFaceSeat, parkedCallFaceOf } from "../tool-roster.js";
13
+ import { parkedCallFaceOf } from "../tool-roster.js";
12
14
  import { readCallTarget } from "../effective-path-target.js";
13
15
  import { inlineUntrusted } from "../untrusted-text.js";
14
16
  import { describeSuppliedValue, mintDecideRecord } from "./decide-continuation.js";
@@ -21,6 +23,16 @@ import { SKILL_TOOL_NAME, normalizeSkills, skillsThatLoad } from "./synthetic-to
21
23
  import { readSkillsSeat } from "./skills-seat.js";
22
24
  import { frozenSkillScopesOf } from "../mods/spec-seats.js";
23
25
  export async function resumeApply(input) {
26
+ const admitted = {};
27
+ try {
28
+ return await applyRungs(input, admitted);
29
+ }
30
+ catch (err) {
31
+ admitted.legMods?.end();
32
+ throw err;
33
+ }
34
+ }
35
+ async function applyRungs(input, admitted) {
24
36
  const { cp, config, internals, outcomeGate, wakeMessage, resumeSignal, recheckGovernanceWindow, plainReviewOutcome, plainParkOutcome, runner, effectiveDelegationFacts } = input;
25
37
  let plainPolicyOutcome = input.plainPolicyOutcome;
26
38
  let wakeHookContext;
@@ -30,6 +42,7 @@ export async function resumeApply(input) {
30
42
  if (outcomeGate === "wake" && wakeMessage !== undefined) {
31
43
  if (resumeSignal?.aborted !== true) {
32
44
  legMods = await admitLegMods({ spec: config, deps: runner.deps, sessionId: cp.sessionId, skills: skillsThatLoad(readSkillsSeat(config.skills)), reopenedSkills: frozenSkillScopesOf(cp.state) });
45
+ admitted.legMods = legMods;
33
46
  }
34
47
  if (legMods !== undefined && promptScreenHasHandlers(legMods.bus)) {
35
48
  const screenedMessage = wakeMessage;
@@ -47,7 +60,7 @@ export async function resumeApply(input) {
47
60
  const screen = await screenUserPrompt(legMods.bus, {
48
61
  ...classicEventBase(identity),
49
62
  prompt: screenedMessage.text,
50
- source: "resume_message",
63
+ source: inputSourceOf(screenedMessage, "resume_message"),
51
64
  ...(screenedMessage.inputId !== undefined ? { inputId: screenedMessage.inputId } : {}),
52
65
  ...(screenedMessage.actor !== undefined ? { actor: snapshotActorAssertion(screenedMessage.actor) } : {}),
53
66
  }, resumeSignal);
@@ -107,10 +120,7 @@ export async function resumeApply(input) {
107
120
  args: editedArgs,
108
121
  toolCallId: cp.pendingAction.toolCallId,
109
122
  ...requestGrantBinding((call, args) => skillGrantBindingMembers(call, args, servedSkills, SKILL_TOOL_NAME), cp.pendingAction, editedArgs),
110
- budget: editBudget,
111
- ...callFaceSeat(parkedCallFaceOf(cp.pendingAction)),
112
- ...(cp.state.handsCwd !== undefined ? { cwd: cp.state.handsCwd } : {}),
113
- ...(cp.state.handsRoot !== undefined ? { root: cp.state.handsRoot } : {}),
123
+ ...callFactsSeat({ budget: editBudget, face: parkedCallFaceOf(cp.pendingAction), cwd: cp.state.handsCwd, root: cp.state.handsRoot }),
114
124
  };
115
125
  const editedReq = { ...editedCall, targetReading: await readCallTarget(undefined, editedCall) };
116
126
  const ig = cp.state.inheritedGate;
@@ -158,8 +168,9 @@ export async function resumeApply(input) {
158
168
  throw new CheckpointError("resume.constraint_rejected", `the approver EDITED this call's input and the deployment's resume-edit policy denies the edited args${rechecked.message ? `: ${rechecked.message}` : ""}. ` +
159
169
  "Refused pre-CAS (the checkpoint stays pending and remains decidable)");
160
170
  }
161
- if (policyCannotAnswer(rechecked, plainPolicyOutcome.hostDecision.decidedBy))
162
- throw new CheckpointError("checkpoint.invalid_outcome", `the approver EDITED this call's input, the edited args raise a question that requires real approval, and the decision is the deployment's policy — a policy's answer is not a person's (decide the edit as "person", or approve the shown input); refusing pre-CAS, the checkpoint stays pending`, { field: "hostDecision" });
171
+ const answered = plainPolicyOutcome.hostDecision.decidedBy === "person" ? cp.pendingAction.classes : undefined;
172
+ if (editRecheckUnanswered(rechecked, { toolCallId: cp.pendingAction.toolCallId, toolName: cp.pendingAction.toolName }, answered))
173
+ throw new CheckpointError("checkpoint.invalid_outcome", `the approver EDITED this call's input, the edited args raise a question that requires a person's approval, and the decision on this checkpoint (decided by "${plainPolicyOutcome.hostDecision.decidedBy}") was not a person's answer to that question — decide the shown input instead, or deny; refusing pre-CAS, the checkpoint stays pending`, { field: "hostDecision" });
163
174
  const reread = readRejudge(editedReq, editedArgs, rechecked);
164
175
  if (reread.kind === "rewritten") {
165
176
  throw new CheckpointError("resume.constraint_rejected", `${editRewrittenSentence(cp.pendingAction.toolName)} (detail.editRewritten) — refused pre-CAS, the checkpoint stays pending and decidable`, { editRewritten: { acceptableForm: reread.form } });
@@ -2,8 +2,7 @@ import { CheckpointError, realApprovalOrgFact } from "../checkpoint-store.js";
2
2
  import { constraintChainDigest, constraintChainEntryOfSuppliedLayer } from "../tool-policy.js";
3
3
  import { chainInstallationGaps, chainInstallationRefusal } from "./child-tree.js";
4
4
  import { chainEntryFault } from "../mods/stations.js";
5
- import { refusePersistedToolNames, refuseRenamedDelegationMounts } from "./sub-agent-deny-lists.js";
6
- import { asResumeConfigRefusal } from "../mode-policy.js";
5
+ import { refuseRecordedAndMountedToolNames } from "../resume-config-judge.js";
7
6
  export function resumeCheckpointScreen(input) {
8
7
  const { cp, resumeSignal, internals, tools, runner } = input;
9
8
  const preCasGateBit = cp.gate.kind === "irreversible_ask" ? cp.gate.realApproval : undefined;
@@ -21,8 +20,7 @@ export function resumeCheckpointScreen(input) {
21
20
  "the restored workspace's own mount path is authoritative for the task root. Drop requestedCwd on resume legs " +
22
21
  "(the checkpoint stays pending and is resumable without it).");
23
22
  }
24
- asResumeConfigRefusal("inheritedGate", () => refusePersistedToolNames((internals?.toolCeiling ?? undefined) === undefined ? cp.state.toolCeiling : undefined, undefined, (internals?.ownToolLists ?? undefined) === undefined ? cp.state.ownToolLists : undefined));
25
- asResumeConfigRefusal("taskConfig", () => refuseRenamedDelegationMounts(tools));
23
+ refuseRecordedAndMountedToolNames(cp, internals, tools);
26
24
  if (cp.state.inheritedGate?.requiresParentConstraint === true) {
27
25
  const supplied = internals?.inheritedGate?.parentConstraints?.length ?? 0;
28
26
  if (supplied === 0) {
@@ -1,13 +1,14 @@
1
1
  /**
2
2
  * The resume ladder's INTERNALS-AND-CONFIG rung (E7), verbatim from `Runner.resumeStream`:
3
3
  * the inherited constraints' retired-member door, the principal, placement and composition-leg identity-continuity rungs,
4
+ * the own-lists continuity rung (the definition a delegated leg's name resolves to now against the one it was parked under),
4
5
  * and the governance-window ENTRANCE check for a row that still owes a delivery.
5
6
  *
6
- * Synchronous by construction, with the ladder's ONE await at this rung handed back instead of taken: the
7
- * window read is STARTED here (the same expression, on the same tick) and returned as `windowEntrance` for the
8
- * driver to await exactly where the ladder always awaited it — an `async` wrapper would add a suspension point
9
- * the ladder never had, on the path where no window is armed most of all. Same reason the forwarding drain is a
10
- * synchronous predicate plus a Promise factory (prepare-run-refs.ts).
7
+ * Synchronous by construction: the window verdict is handed back as a closure and NOT started here. The driver
8
+ * asserts it as the entrance once the resume holds the session's lock, so the wait for the lock is never spent
9
+ * between the verdict and the claim; an `async` wrapper would add a suspension point on the path where no window
10
+ * is armed most of all. Same reason the forwarding drain is a synchronous predicate plus a Promise factory
11
+ * (prepare-run-refs.ts).
11
12
  */
12
13
  import { type Checkpoint, type ResumeOutcome } from "../checkpoint-store.js";
13
14
  import type { ResumeTaskConfig, RunInternals, RunnerDepsSeat } from "./contracts.js";
@@ -16,18 +17,20 @@ export interface ResumeInternalsAndConfigInput {
16
17
  cp: Checkpoint;
17
18
  /** borrowed-readonly — the config snapshot (`principal`). */
18
19
  config: ResumeTaskConfig;
19
- /** borrowed-readonly — the internals snapshot (`placementRoot`, `compositionLeg`). */
20
+ /** borrowed-readonly — the internals snapshot (`placementRoot`, `compositionLeg`, `ownToolLists`). */
20
21
  internals: RunInternals | undefined;
21
22
  /** borrowed-readonly — the ONE read of the outcome discriminant (a bare resource_limit continue owes nothing). */
22
23
  outcomeGate: ResumeOutcome["gate"];
23
24
  /** borrowed-readonly — the Runner's deployment deps, read LIVE through the Runner (reads `usageWindowStore`, `usageWindows`); the one home of why it is a
24
25
  * seat and not a captured object is {@link RunnerDepsSeat}. */
25
26
  runner: RunnerDepsSeat;
27
+ /** borrowed-readonly — the resume's cancellation. The ledger read takes no signal, so the verdict races it: every assertion runs
28
+ * while the resume holds the session's lock, and an abort must end the wait (and so the hold) whether or not the ledger answers. */
29
+ resumeSignal: AbortSignal | undefined;
26
30
  }
27
31
  export interface ResumeInternalsAndConfigResult {
28
- /** The window verdict as a re-assertable closure (armed only when governance is active), for the rungs whose awaits sit inside the read→CAS window. */
32
+ /** The window verdict as a re-assertable closure (armed only when governance is active; absent otherwise). Not started here: the driver
33
+ * asserts it first as the entrance under the session's lock, and the rungs whose awaits sit inside the read→CAS window assert it again. */
29
34
  recheckGovernanceWindow: (() => Promise<void>) | undefined;
30
- /** The entrance check already in flight (started on this tick) — the driver awaits it where the ladder did; absent when governance is unarmed. */
31
- windowEntrance: Promise<void> | undefined;
32
35
  }
33
36
  export declare function resumeInternalsAndConfig(input: ResumeInternalsAndConfigInput): ResumeInternalsAndConfigResult;