@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -0,0 +1,108 @@
1
+ import { LineageBreak, entryParentLinks, pathToRoot, replayLossText } from "../../internal/harness.js";
2
+ import { deliverEngineNotice } from "../engine-notice.js";
3
+ const LINEAGE_REROOTED = "session.lineage_rerooted";
4
+ export function viewThroughReplayLoss(storage, found) {
5
+ return new Proxy(storage, {
6
+ get(target, prop, receiver) {
7
+ if (prop === "getPathToRoot")
8
+ return (leafId) => branchReadingLoss(target, leafId, found);
9
+ const value = Reflect.get(target, prop, receiver);
10
+ return typeof value === "function" ? value.bind(target) : value;
11
+ },
12
+ });
13
+ }
14
+ async function branchReadingLoss(storage, leafId, found) {
15
+ let path;
16
+ try {
17
+ path = await storage.getPathToRoot(leafId);
18
+ }
19
+ catch (err) {
20
+ if (!(err instanceof LineageBreak) || err.replayLoss === undefined || err.replayLoss.dropped === 0 || leafId === null)
21
+ throw err;
22
+ const entries = await storage.getEntries();
23
+ const byId = new Map(entries.map((entry) => [entry.id, entry]));
24
+ const leaf = byId.get(leafId);
25
+ if (leaf === undefined)
26
+ throw err;
27
+ const rerooted = pathToRoot(leaf, entryParentLinks(byId), err.childId);
28
+ found({
29
+ break: true,
30
+ missingParentId: err.missingParentId,
31
+ rootedAt: err.childId,
32
+ recordsDropped: err.replayLoss.dropped,
33
+ recordsTotal: err.replayLoss.total,
34
+ leaf: leafId,
35
+ entriesOnPath: rerooted.length,
36
+ entriesCut: entries.length - descendantsOf(entries, err.childId),
37
+ });
38
+ return rerooted;
39
+ }
40
+ const loss = storage.getReplayLoss?.();
41
+ if (loss !== undefined && loss.dropped > 0)
42
+ found({ break: false, recordsDropped: loss.dropped, recordsTotal: loss.total, leaf: leafId, entriesOnPath: path.length });
43
+ return path;
44
+ }
45
+ function descendantsOf(entries, rootId) {
46
+ const children = new Map();
47
+ for (const entry of entries) {
48
+ const parent = entry.parentId || null;
49
+ if (parent === null)
50
+ continue;
51
+ const list = children.get(parent);
52
+ if (list === undefined)
53
+ children.set(parent, [entry.id]);
54
+ else
55
+ list.push(entry.id);
56
+ }
57
+ const seen = new Set([rootId]);
58
+ const todo = [rootId];
59
+ for (let id = todo.pop(); id !== undefined; id = todo.pop()) {
60
+ for (const child of children.get(id) ?? []) {
61
+ if (seen.has(child))
62
+ continue;
63
+ seen.add(child);
64
+ todo.push(child);
65
+ }
66
+ }
67
+ return seen.size;
68
+ }
69
+ const WHOLE_BRANCH = "\0whole";
70
+ function lossSentence(finding) {
71
+ const count = replayLossText({ dropped: finding.recordsDropped, total: finding.recordsTotal });
72
+ if (finding.break) {
73
+ return (`This session's log is damaged: entry ${finding.missingParentId}, the parent of ${finding.rootedAt}, is not in it (${count}). ` +
74
+ `The run continues from ${finding.rootedAt}: ${finding.entriesOnPath} entries of the conversation are kept, and ${finding.entriesCut} entries the log holds above the damage are not in its context.`);
75
+ }
76
+ if (finding.leaf === null)
77
+ return `This session's log is damaged: ${count}, and none of it is readable. The run starts from an empty conversation.`;
78
+ return (`This session's log is damaged: ${count}. The run continues from entry ${finding.leaf}, where the records the log still holds leave the conversation: ` +
79
+ `${finding.entriesOnPath} entries of it are kept, and what the unreadable records said — possibly its latest turns — is not in its context.`);
80
+ }
81
+ export function replayLossSeat(ids) {
82
+ const said = new Set();
83
+ return (finding, sessionId) => {
84
+ const key = finding.break ? `${finding.missingParentId}\n${finding.rootedAt}` : WHOLE_BRANCH;
85
+ if (said.has(key))
86
+ return;
87
+ said.add(key);
88
+ if (finding.break)
89
+ said.add(WHOLE_BRANCH);
90
+ deliverEngineNotice(ids.onNotice, { code: LINEAGE_REROOTED, message: lossSentence(finding), detail: { ...finding, sessionId, runId: ids.runId } });
91
+ };
92
+ }
93
+ export function replayLossLeg(ids) {
94
+ const say = replayLossSeat(ids);
95
+ let held = [];
96
+ return {
97
+ view: (storage, sessionId) => viewThroughReplayLoss(storage, (finding) => (held !== undefined ? void held.push({ finding, sessionId }) : say(finding, sessionId))),
98
+ discard: () => {
99
+ held = [];
100
+ },
101
+ settle: () => {
102
+ const found = [...(held ?? [])].sort((a, b) => Number(b.finding.break) - Number(a.finding.break));
103
+ held = undefined;
104
+ for (const { finding, sessionId } of found)
105
+ say(finding, sessionId);
106
+ },
107
+ };
108
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The Runner's same-Runner settle claims on checkpoint tokens. A claim is PER ATTEMPT: every in-Runner actor that settles a
3
+ * row (a resume's resolve, an in-Runner expire) opens its own claim with its CAS attempt and closes exactly that claim, once,
4
+ * when its duty is decided (a lost CAS, or the winner's duty done). A token is held while ANY attempt's claim is open — so a
5
+ * losing attempt never closes a winner's still-open claim, and a stream-side reap that loses its own expire preserves the
6
+ * paused-env reap record for whichever same-Runner winner is still on its way to it.
7
+ */
8
+ import type { CheckpointToken } from "../checkpoint-store.js";
9
+ export declare class LocalClaims {
10
+ #private;
11
+ /** Open one attempt's claim on `token` (with its CAS attempt). */
12
+ open(token: CheckpointToken): void;
13
+ /** Close one attempt's claim on `token` — the attempt's own, once, at its duty decision. */
14
+ close(token: CheckpointToken): void;
15
+ /** Whether any same-Runner attempt's claim on `token` is open. */
16
+ held(token: CheckpointToken): boolean;
17
+ }
@@ -0,0 +1,18 @@
1
+ export class LocalClaims {
2
+ #open = new Map();
3
+ open(token) {
4
+ this.#open.set(token, (this.#open.get(token) ?? 0) + 1);
5
+ }
6
+ close(token) {
7
+ const n = this.#open.get(token);
8
+ if (n === undefined)
9
+ return;
10
+ if (n > 1)
11
+ this.#open.set(token, n - 1);
12
+ else
13
+ this.#open.delete(token);
14
+ }
15
+ held(token) {
16
+ return this.#open.has(token);
17
+ }
18
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * The person's account of the media that left the model's view of a request (`context.media_removed`, user) — one code,
3
+ * the reason in `detail.reason`, the message minted once here for both:
4
+ * - `rejected_by_provider`: the harness's request view removes the images a provider refusal points at
5
+ * (`engine/llm/rejected-images.ts`) and hands {@link createProviderRefusalSeat} the removals the run itself met; every
6
+ * request re-reads the transcript — the live failure, then its record or a rebuilt copy — so that seat announces ONCE
7
+ * PER RUN PER REFUSAL, keyed by the identity all of those share (`refusalAt`);
8
+ * - `media_budget`: the request trim (`media-byte-cap.ts`) hands {@link createMediaBudgetSeat} what it did to a request
9
+ * view the context hook handed on (the lane's observation flush, KL-2988-a); that seat traces every such view (`context.media_removed`, the request's numbers) and announces
10
+ * each block ONCE PER SESSION, by the block's identity — the digest of its bytes, which a compaction, a resume or a
11
+ * rewind does not change. The digest rides the session's announced record (the advisory arm, bounded) and the write is
12
+ * parked for the leg's flush; best effort — a lost write, or a block whose digest the bound let go, is said again by a
13
+ * later run, never lost. Within a run a block is looked at once.
14
+ * Beside the provider's image refusal sits its other refused part, a tool's input schema ({@link createToolSchemaRemovedSeat},
15
+ * its own code).
16
+ */
17
+ import { type EngineNotice } from "../engine-notice.js";
18
+ import type { RejectedImageRemoval } from "../../internal/llm.js";
19
+ import type { RequestMediaLimits } from "../image-admission.js";
20
+ import type { RequestMediaTrim } from "../media-byte-cap.js";
21
+ import { type TracerHook } from "../trace.js";
22
+ import type { Prepared } from "./contracts.js";
23
+ import type { NoticeSeatInput } from "./notice-seat-input.js";
24
+ /** The session's announced record and the leg's receipt ledger (the parked write). */
25
+ export type MediaBudgetRecord = Pick<Prepared, "announcedListingsRef" | "frameReceipts">;
26
+ /** The provider-refusal account: one notice per refusal, once per run. */
27
+ export declare function createProviderRefusalSeat(ids: NoticeSeatInput): (removals: readonly RejectedImageRemoval[]) => void;
28
+ /**
29
+ * The run's account of a tool whose input schema a provider refused (`context.tool_schema_removed`, user): the loop re-sent
30
+ * the turn with that tool's parameters taken out of what the model sees (`engine/llm/rejected-images.ts`), and every later
31
+ * request built from a transcript the refusal's record stands in sends it so. ONCE PER REFUSAL (`refusalAt`): the loop
32
+ * re-sends once per refusal, and a refusal recorded before the run began is never re-sent, so never announced again.
33
+ */
34
+ export declare function createToolSchemaRemovedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
35
+ sessionId: string;
36
+ runId: string;
37
+ }): (refusal: {
38
+ tool: string;
39
+ refusalAt: number;
40
+ }) => void;
41
+ /** The request budget's account of one request view the trim cut: its trace frame, then — of the blocks it left out, those
42
+ * the session was not yet told of — one notice. */
43
+ export declare function createMediaBudgetSeat(ids: NoticeSeatInput, record: MediaBudgetRecord, trace: {
44
+ readonly tracer: TracerHook | undefined;
45
+ readonly taskId: string;
46
+ }): (trim: RequestMediaTrim, limits: RequestMediaLimits) => void;
@@ -0,0 +1,88 @@
1
+ import { deliverEngineNotice } from "../engine-notice.js";
2
+ import { inlineUntrusted } from "../untrusted-text.js";
3
+ import { emitTrace } from "../trace.js";
4
+ import { announceDigest, withAnnounceDigests } from "./announce-once-ledger.js";
5
+ const MEDIA_REMOVED = "context.media_removed";
6
+ const counted = (n, noun) => (n === 1 ? `${noun === "image" ? "an" : "a"} ${noun}` : `${n} ${noun}s`);
7
+ function announceMediaRemoved(ids, reason, images, documents) {
8
+ const what = [images > 0 ? counted(images, "image") : undefined, documents > 0 ? counted(documents, "document") : undefined].filter((s) => s !== undefined).join(" and ");
9
+ const one = images + documents === 1;
10
+ const it = one ? "it" : "them";
11
+ const message = reason === "rejected_by_provider"
12
+ ? `The model provider could not process ${what} in this conversation, so ${one ? "it was" : "they were"} removed ` +
13
+ `from what the model sees (each replaced by a line saying so) and the request was sent again without ${it}. ` +
14
+ `The session still holds the original; to show the model this content again, send it in another format.`
15
+ : `${what[0].toUpperCase()}${what.slice(1)} in this conversation no longer fit the request's media budget, so ${one ? "it was" : "they were"} removed ` +
16
+ `from what the model sees (the oldest go first; each is replaced by a line saying so). ` +
17
+ `The session still holds the original; to show the model ${it} again, read the file again or send ${it} again. Said once per image or document per conversation.`;
18
+ deliverEngineNotice(ids.onNotice, { code: MEDIA_REMOVED, message, detail: { reason, images, documents, sessionId: ids.sessionId, runId: ids.runId } });
19
+ }
20
+ export function createProviderRefusalSeat(ids) {
21
+ const announced = new Set();
22
+ return (removals) => {
23
+ for (const { refusalAt, images } of removals) {
24
+ if (announced.has(refusalAt))
25
+ continue;
26
+ announced.add(refusalAt);
27
+ announceMediaRemoved(ids, "rejected_by_provider", images, 0);
28
+ }
29
+ };
30
+ }
31
+ export function createToolSchemaRemovedSeat(onNotice, ids) {
32
+ const announced = new Set();
33
+ return ({ tool, refusalAt }) => {
34
+ if (announced.has(refusalAt))
35
+ return;
36
+ announced.add(refusalAt);
37
+ const name = inlineUntrusted(tool, 160);
38
+ deliverEngineNotice(onNotice, {
39
+ code: "context.tool_schema_removed",
40
+ message: `Tool "${name}": the model provider refused this tool's input schema, so the request was sent again with the tool's parameters ` +
41
+ `taken out of what the model sees. The model can still call the tool in this conversation, but does not see its parameters. ` +
42
+ `Fix the schema on the server that provides the tool, then start a new conversation.`,
43
+ detail: { tool, sessionId: ids.sessionId, runId: ids.runId },
44
+ });
45
+ };
46
+ }
47
+ export function createMediaBudgetSeat(ids, record, trace) {
48
+ const lookedAt = new WeakSet();
49
+ return ({ removed, removedBase64Chars, items, base64Chars }, { maxItems, budgetBase64Chars }) => {
50
+ const cutImages = removed.filter((r) => r.type === "image").length;
51
+ emitTrace(trace.tracer, () => ({
52
+ kind: MEDIA_REMOVED,
53
+ version: 1,
54
+ taskId: trace.taskId,
55
+ reason: "media_budget",
56
+ images: cutImages,
57
+ documents: removed.length - cutImages,
58
+ removedBase64Chars,
59
+ items,
60
+ base64Chars,
61
+ maxItems,
62
+ ...(budgetBase64Chars !== Infinity ? { budgetBase64Chars } : {}),
63
+ ts: Date.now(),
64
+ }));
65
+ const told = new Set(record.announcedListingsRef.advisories ?? []);
66
+ const fresh = new Set();
67
+ let images = 0;
68
+ let documents = 0;
69
+ for (const { block, type, data } of removed) {
70
+ if (lookedAt.has(block))
71
+ continue;
72
+ lookedAt.add(block);
73
+ const digest = announceDigest(MEDIA_REMOVED, `${type}\n${data}`);
74
+ if (told.has(digest) || fresh.has(digest))
75
+ continue;
76
+ fresh.add(digest);
77
+ if (type === "image")
78
+ images++;
79
+ else
80
+ documents++;
81
+ }
82
+ if (fresh.size === 0)
83
+ return;
84
+ announceMediaRemoved(ids, "media_budget", images, documents);
85
+ record.announcedListingsRef.advisories = withAnnounceDigests(record.announcedListingsRef.advisories, [...fresh]);
86
+ record.frameReceipts.listingSnapshotOwed = true;
87
+ };
88
+ }
@@ -3,8 +3,8 @@
3
3
  * marker the loop stamps on the contaminated siblings, and the deadline arithmetic every mint shares (the retention
4
4
  * defaults and the one TTL sanitizer). Moved whole out of the orchestrator so the boundary-parks phase (resource /
5
5
  * platform / review) and the park-ask phase (the approval park) reach DOWN for the same publication seam and the same
6
- * numbers, and the driver keeps reaching down for the marker its harness stamps. Pure: no engine state; the only clock
7
- * is the caller's.
6
+ * numbers, and the driver keeps reaching down for the marker its harness stamps. No engine state of its own (the
7
+ * publication writes the pause holder and marks the harness's capture); the only clock is the caller's.
8
8
  */
9
9
  import { type CheckpointGate, type CheckpointToken, type PendingAction } from "../checkpoint-store.js";
10
10
  import type { WorkspaceHandle } from "../remote-env.js";
@@ -23,7 +23,7 @@
23
23
  * position (a permanent no-op) and a layer's mere presence flips `hasEffectAwareGate`, which would
24
24
  * silence the ungated-write warning for deployments that wired no policy at all.
25
25
  */
26
- import type { AskRuleEvidence, ToolCallRequest } from "../tool-policy.js";
26
+ import { type ToolPolicy, type AskRuleEvidence, type ToolCallRequest, type WholeToolRefusal } from "../tool-policy.js";
27
27
  import { persistedRuleMandateOf, type RuleClearanceFacts, type RuleOffersAbsence } from "../ask-origin.js";
28
28
  import { type OrgGateVerdict, type PersistedRuleAnswer, type PersistedRuleHit, type PersistedRuleUnreadable } from "../hooks.js";
29
29
  import type { PersistedRule, PersistedRuleVerdict, RuleOffer, ScopeRootIdentity, SegmentCoverage } from "../permission-rule-model.js";
@@ -111,7 +111,11 @@ export interface PermissionRuleLanes {
111
111
  } | undefined;
112
112
  org: {
113
113
  adjudicate: (req: ToolCallRequest) => Promise<OrgGateVerdict>;
114
+ refusesWholeOver: (resolution: OrgRuleResolution) => WholeToolRefusal;
114
115
  } | undefined;
116
+ /** The tools the stored rules refuse every call of — the person's and the org's, over ONE read (a request's view is one
117
+ * judgment), a fold of the two readings; `undefined` when neither lane is wired. */
118
+ wholeToolRefusals: ToolPolicy["wholeToolRefusals"];
115
119
  }
116
120
  /** The ORG lane: the org's verdict about one call, off the store view `read` supplies — the gate's `orgRules` face over the
117
121
  * call's pinned read ({@link createPermissionRuleLanes}), and {@link orgVerdictBeforeClaim} over a view of its own.
@@ -175,9 +179,10 @@ export declare function createPermissionRuleLanes(cfg: {
175
179
  /** Sink for a judgment against the rows that threw, and for the org lane's degraded-snapshot line. */
176
180
  onDisclosure: (message: string) => void;
177
181
  /** The run's one reader of the person's rules: the call's ONE read of the bytes judged, pinned, that the read station, the
178
- * org lane and the personal lane all take (the lanes consume a reader; they do not make one). */
182
+ * org lane and the personal lane all take, and a request's read the whole-tool readings take (the lanes consume a reader). */
179
183
  rows: {
180
184
  pin(toolCallId: string, judged?: unknown): Promise<PersonRowsRead>;
185
+ forRequest(): Promise<PersonRowsRead>;
181
186
  };
182
187
  /** The allow layer's auto strip over a stored ALLOW row (true ⇒ out of this call's table BEFORE the coverage is chosen). */
183
188
  stripsAllow?: (rule: PersistedRule, req: ToolCallRequest) => boolean;
@@ -1,6 +1,7 @@
1
+ import { REFUSES_NO_WHOLE_TOOL, toolPolicyWholeToolRefusals } from "../tool-policy.js";
1
2
  import { persistedRuleMandateOf, ruleClearanceOf } from "../ask-origin.js";
2
3
  import {} from "../hooks.js";
3
- import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, laneToolNamesOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
+ import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, ruleWordsOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
5
  import { callHostTargetOf } from "../host-target.js";
5
6
  import { callTargetViewsOf, validatePath } from "../effective-path-target.js";
6
7
  import { bindPathRules, persistedRowAnchors, projectScopeIdentity } from "../path-rule-binding.js";
@@ -54,9 +55,10 @@ export function pathRuleLaneAnswer(table, req, ctx) {
54
55
  return persistedRuleAnswerOf(adjudicatePersistedPathRules(table, { tool: req.toolName, cwd: ctx.root, sessionId: ctx.sessionId, face: callPathFaceOf(req), ...(ctx.scopeIdentity !== undefined ? { scopeIdentity: ctx.scopeIdentity } : {}) }, { ...(tighten !== undefined ? { tighten } : {}), ...(allow !== undefined ? { allow } : {}) }, ctx.anchorsOf, ctx.leads));
55
56
  }
56
57
  export function orgRuleLane(cfg) {
58
+ const questionToolExempt = (call) => wireOf("offer.orgQuestionExemption", call) === cfg.questionToolName && cfg.questionToolMounted;
57
59
  return {
58
60
  adjudicate: async (req) => {
59
- if (wireOf("offer.orgQuestionExemption", req) === cfg.questionToolName && cfg.questionToolMounted)
61
+ if (questionToolExempt(req))
60
62
  return { status: "available" };
61
63
  let resolution;
62
64
  try {
@@ -73,13 +75,19 @@ export function orgRuleLane(cfg) {
73
75
  return { status: "unavailable", disclosures: [`the store's org resolution cannot be read (${reading.refused}) — unreadable governance, never an empty one`] };
74
76
  const command = req.args?.command;
75
77
  const face = callPathFaceOf(req);
76
- const verdict = reading.verdictFor({ tool: laneToolNamesOf(req), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
78
+ const verdict = reading.verdictFor({ tool: ruleWordsOf(req, "deny"), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
77
79
  const revisionCell = orgRevisionEvidenceOf(resolution, cfg.onRevisionDefect);
78
80
  const degraded = describeUnreadableOrgRows(reading.unreadable, revisionCell.revision);
79
81
  if (degraded !== undefined)
80
82
  cfg.onDegraded(degraded);
81
83
  return verdict === undefined ? { status: "available", ...revisionCell } : { status: "available", verdict, ...revisionCell };
82
84
  },
85
+ refusesWholeOver: (resolution) => {
86
+ const reading = resolution.status === "unavailable" || resolution.status === "ungoverned" ? undefined : readOrgRules(resolution.rules);
87
+ if (reading === undefined || "refused" in reading)
88
+ return REFUSES_NO_WHOLE_TOOL;
89
+ return (tool) => !questionToolExempt(tool) && reading.verdictFor({ tool: ruleWordsOf(tool, "deny"), face: callPathFaceOf({ ...tool, args: undefined }) })?.behavior === "deny";
90
+ },
83
91
  };
84
92
  }
85
93
  export function orgVerdictBeforeClaim(cfg, req) {
@@ -106,7 +114,7 @@ export function createPermissionRuleLanes(cfg) {
106
114
  }
107
115
  }
108
116
  if (provider === undefined)
109
- return { personal: undefined, org: undefined };
117
+ return { personal: undefined, org: undefined, wholeToolRefusals: undefined };
110
118
  const anonymous = readPrincipal(cfg.principal).kind === "absent";
111
119
  const reader = cfg.rows;
112
120
  const orgViewOf = async (toolCallId, judged) => {
@@ -119,9 +127,9 @@ export function createPermissionRuleLanes(cfg) {
119
127
  const personalAdjudicate = async (req) => {
120
128
  if (anonymous && !cfg.localOwnerDeclared)
121
129
  return undefined;
122
- const judged = laneToolNamesOf(req).map((n) => [n, ruleToolGrammarOf(n)]);
123
- if (!judged.some(([, g]) => g === "path") && faceRowsSpeakFor(callPathFaceOf(req)))
124
- judged.push([req.toolName, "path"]);
130
+ const judged = ruleWordsOf(req, "deny").map((n) => [n, ruleToolGrammarOf(n), ruleWordsOf(req, "allow").includes(n)]);
131
+ if (!judged.some(([, g, grants]) => g === "path" && grants) && faceRowsSpeakFor(callPathFaceOf(req)))
132
+ judged.push([req.toolName, "path", true]);
125
133
  const view = await reader.pin(req.toolCallId, req.args);
126
134
  const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req, r.behavior);
127
135
  if (judged.length === 0 && !view.rules.some(ownRow))
@@ -139,7 +147,7 @@ export function createPermissionRuleLanes(cfg) {
139
147
  const leads = judgesPath ? await cfg.leads.resolve(bindPathRules(table.filter((r) => r.match === "path" || r.match === "subpath").map((r) => ({ parsed: r, ruleText: r.rule, rule: r })), (spec) => anchorsOf(spec.rule))) : NO_LEADS;
140
148
  const scopeIdentity = await projectScopeIdentity(table, cfg.rootCanonical, cfg.leads);
141
149
  const wholeTool = persistedRuleAnswerOf(adjudicatePersistedToolRules(table, { request: req, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }));
142
- const judgedAnswer = strongestAnswer([...judged.map(([n, grammar]) => judgeAgainst(table, { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
150
+ const judgedAnswer = strongestAnswer([...judged.map(([n, grammar, grants]) => judgeAgainst(grants ? table : table.filter((r) => r.behavior !== "allow"), { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
143
151
  const unjudged = noRule.find(({ row }) => (row.behavior === "deny" || row.behavior === "ask") && eligiblePersisted(row, { tool: row.tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }, row.behavior));
144
152
  const answer = unjudged !== undefined && !(judgedAnswer !== undefined && "behavior" in judgedAnswer && judgedAnswer.behavior === "deny") ? unjudgedRowAnswer(unjudged.row, unjudged.why, req.toolName) : judgedAnswer;
145
153
  const stands = answer !== undefined && (("behavior" in answer && answer.behavior === "deny") || "unreadable" in answer);
@@ -176,8 +184,19 @@ export function createPermissionRuleLanes(cfg) {
176
184
  const coverage = segmentCoverageOf(command, { persisted: table }, { tool: req.toolName, cwd: cfg.root, sessionId: cfg.sessionId, ...execCwd, ...scope });
177
185
  return coverage !== undefined ? { segmentCoverage: coverage } : undefined;
178
186
  };
187
+ const personalRefusesWholeOver = async (rules) => {
188
+ const deny = anonymous && !cfg.localOwnerDeclared ? [] : rules.filter((r) => r.behavior === "deny" && r.match === "tool");
189
+ const scopeIdentity = deny.length === 0 ? undefined : await projectScopeIdentity(deny, cfg.rootCanonical, cfg.leads);
190
+ return deny.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => !routesContent(tool.face) && adjudicatePersistedToolRules(deny, { request: tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) })?.behavior === "deny";
191
+ };
179
192
  const personal = provider.partitions.durable ? { adjudicate: personalAdjudicate } : undefined;
180
- return { personal, org };
193
+ let inFlight;
194
+ const viewRead = () => (inFlight ??= reader.forRequest().finally(() => (inFlight = undefined)));
195
+ const wholeToolRefusals = toolPolicyWholeToolRefusals([
196
+ personal !== undefined ? { wholeToolRefusals: async () => personalRefusesWholeOver((await viewRead()).rules) } : undefined,
197
+ org !== undefined ? { wholeToolRefusals: async () => ((read) => (read.org !== undefined ? org.refusesWholeOver(read.org) : REFUSES_NO_WHOLE_TOOL))(await viewRead()) } : undefined,
198
+ ]);
199
+ return { personal, org, wholeToolRefusals };
181
200
  }
182
201
  export function createRuleOffersOf(cfg) {
183
202
  return (call, args, ask) => {
@@ -11,6 +11,17 @@
11
11
  * table no longer holds that attempt. A judgment that is no call of the leg (a visibility probe's fixed id, a gate with no
12
12
  * leg) keeps nothing: its rule lanes take a read of their own, its read station the run's latest tables.
13
13
  *
14
+ * ## One read per request
15
+ *
16
+ * A model request's view of the tool table stands on one read per request ({@link PersonPathRows.forRequest}), asked when the
17
+ * request is sent: a read asked earlier may have been asked before a tool the request follows wrote a rule (a call's read
18
+ * always is; a visibility probe's may be — a changed-files scan outlives its turn's boundary). Two reads stand for a request
19
+ * instead, and ask the store nothing new: the prepare read, for the first request while no read has started after it (no
20
+ * call has been judged before it); and the newest read the store has left unanswered past its bound, asked since the
21
+ * previous request, while no read started after it has been answered — its verdict is the failure law's, the one a new read
22
+ * of the silent store would give. A store that answers slowly, or not at all, so costs a request at most one bound beyond its
23
+ * calls' own reads.
24
+ *
14
25
  * ## The run's unit, one entry per partition
15
26
  *
16
27
  * Every read's outcome lands in the run's unit, per personal partition (the durable one — its user and project rows — and
@@ -113,6 +124,10 @@ export interface PersonPathRows {
113
124
  * holds — a judgment reads the store, as the session rules' does. Any other judgment (no leg, or an id the table does not
114
125
  * hold — a visibility probe) takes a read of its own, kept by nobody. Bounded ({@link PERSON_READ_BOUND_MS}); never rejects. */
115
126
  pin(toolCallId: string, judged?: unknown): Promise<PersonRowsRead>;
127
+ /** The read one model request's view of the tool table stands on, which the request then holds: a read asked now — or,
128
+ * asking the store nothing new, the prepare read for the first request, and the newest read asked since the previous
129
+ * request that the store has left unanswered past its bound. Bounded ({@link PERSON_READ_BOUND_MS}); never rejects. */
130
+ forRequest(): Promise<PersonRowsRead>;
116
131
  /** Settles once the tables a reader takes are compiled: a pinned call's own; any other reader's (no id, or a call holding
117
132
  * no pin), the unit's newest — through every change that lands meanwhile, within {@link PATH_TABLES_READY_BOUND_MS} —
118
133
  * or at `signal` or the run's cut ({@link PersonPathRowsConfig.signal}). Never rejects: a reader whose wait was cut
@@ -29,6 +29,10 @@ export function createPersonPathRows(cfg) {
29
29
  const unit = { durable: { failedSeq: 0 }, session: { failedSeq: 0 } };
30
30
  let seqs = 0;
31
31
  const pins = new Map();
32
+ let prepared;
33
+ let silent;
34
+ let answeredSeq = 0;
35
+ let requestSeq = 0;
32
36
  let compile;
33
37
  const compiled = new Map();
34
38
  let unitTables;
@@ -72,22 +76,40 @@ export function createPersonPathRows(cfg) {
72
76
  raw = Promise.reject(err);
73
77
  }
74
78
  const outcomeOf = (view) => ({ seq, view: holdsPersonRows ? view : { ...view, rules: [] }, failed: holdsPersonRows ? failedOf(view) : new Set() });
79
+ const answer = () => void (answeredSeq = Math.max(answeredSeq, seq));
75
80
  void raw.then((view) => {
81
+ answer();
76
82
  for (const line of view.disclosures)
77
83
  cfg.onDisclosure(line);
78
84
  cfg.onRowsDropped(view.droppedRows);
79
85
  if (holdsPersonRows && view.unreadable !== undefined)
80
86
  announce(at, view.unreadable, view.unreadableSources);
81
87
  land(outcomeOf(view));
82
- }, () => undefined);
83
- return withGateTimeout(raw, PERSON_READ_BOUND_MS, cfg.signal, "personRules").then((view) => readOf(outcomeOf(view)), (err) => {
84
- const cut = gateWaitFailureOf(err) === "aborted";
88
+ }, answer);
89
+ const read = withGateTimeout(raw, PERSON_READ_BOUND_MS, cfg.signal, "personRules").then((view) => readOf(outcomeOf(view)), (err) => {
90
+ const failure = gateWaitFailureOf(err);
91
+ const cut = failure === "aborted";
85
92
  const outcome = { seq, failed: new Set(partitions), why: thrownText(err), ...(cut ? { cut: true } : {}) };
86
93
  land(outcome);
87
94
  if (holdsPersonRows && !cut)
88
95
  announce(at, outcome.why);
96
+ if (failure === "timeout" && seq > (silent?.seq ?? 0))
97
+ silent = { seq, read };
89
98
  return readOf(outcome);
90
99
  });
100
+ if (at === "prepare")
101
+ prepared = { seq, read };
102
+ return read;
103
+ };
104
+ const forRequest = () => {
105
+ const first = prepared;
106
+ prepared = undefined;
107
+ const s = silent;
108
+ const read = first !== undefined && first.seq === seqs ? first.read
109
+ : s !== undefined && s.seq > requestSeq && s.seq > answeredSeq ? s.read
110
+ : readOnce("call");
111
+ requestSeq = seqs;
112
+ return read;
91
113
  };
92
114
  const failedOf = (view) => view.unreadable !== undefined && (view.unreadableSources ?? []).length === 0 ? new Set(partitions) : new Set((view.unreadableSources ?? []).map(partitionOf).filter((p) => partitions.includes(p)));
93
115
  const defect = (message) => {
@@ -245,6 +267,7 @@ export function createPersonPathRows(cfg) {
245
267
  ? readOnce("prepare").then(() => undefined)
246
268
  : undefined,
247
269
  pin,
270
+ forRequest,
248
271
  tablesReady: (toolCallId, signal) => {
249
272
  const p = pinOf(toolCallId);
250
273
  const cut = signal === undefined || cfg.signal === undefined ? (signal ?? cfg.signal) : AbortSignal.any([signal, cfg.signal]);
@@ -271,7 +294,7 @@ export function createPersonPathRows(cfg) {
271
294
  unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
272
295
  rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
273
296
  rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
274
- forCall: (id) => tablesFor(id).readDeny,
297
+ forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
275
298
  });
276
299
  const writeDeny = {
277
300
  face: "write",
@@ -0,0 +1,26 @@
1
+ /**
2
+ * The placement fence's two engine readings (the seat and its contract: `ExecutionEnvFactoryContext.placementTarget`,
3
+ * remote-env.ts): the MINT folds a leg's fence once, and the SETTLE POINT reads the leg's own target once — which is
4
+ * also every fenced leg's receipt (a restore takes the same receipt earlier as well, against the env before and the
5
+ * handle after `resumeVM`, in prepare-workspace-restore.ts).
6
+ */
7
+ import { type PlacementTarget, type WorkspaceHandle } from "../remote-env.js";
8
+ import type { ExecutionEnv } from "../../internal/harness.js";
9
+ /**
10
+ * The fence a leg is minted under, from its two sources: the target its checkpoint row recorded (a durable resume leg)
11
+ * and the one its trusted internals carry (the leg that handed it work). Member by member — a member the row states
12
+ * wins, a member it does not state is the internals' (a row recorded before `deviceId` existed takes the waking leg's
13
+ * device) — so neither source replaces the other whole. `undefined` when neither names a provider. A handed value the
14
+ * engine cannot read as a target (no non-empty string `provider`, a `deviceId` that is not a string) is refused loudly
15
+ * rather than read as "no fence", which would place the leg wherever the current binding points.
16
+ */
17
+ export declare function mintPlacementFence(row: WorkspaceHandle | undefined, handedValue: unknown): PlacementTarget | undefined;
18
+ /**
19
+ * The leg's OWN target, read once at its settle point (what its env reports, {@link reportedPlacementTarget}) — the fence
20
+ * of every leg it hands work to — and every fenced leg's receipt on that same reading: an env that does not name the
21
+ * device its fence names is refused before anything reports the workspace or runs on it. A leg that restored a
22
+ * checkpointed workspace (its restore took the receipt already, against the restored handle) is refused
23
+ * `resume.env_failed` here too — its env may have moved after the restore (re-initialization reconnecting elsewhere) —
24
+ * any other leg `config.placement_not_honored`.
25
+ */
26
+ export declare function settleOwnTarget(env: ExecutionEnv | undefined, fence: PlacementTarget | undefined, restoredCheckpoint: boolean): PlacementTarget | undefined;
@@ -0,0 +1,38 @@
1
+ import { placementHonored, placementTargetOf, reportedPlacementTarget } from "../remote-env.js";
2
+ export function mintPlacementFence(row, handedValue) {
3
+ const fromRow = row !== undefined ? placementTargetOf(row) : undefined;
4
+ const handed = handedFence(handedValue);
5
+ const provider = fromRow?.provider ?? handed?.provider;
6
+ if (provider === undefined)
7
+ return undefined;
8
+ const deviceId = fromRow?.deviceId ?? handed?.deviceId;
9
+ return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
10
+ }
11
+ function handedFence(value) {
12
+ if (value === undefined)
13
+ return undefined;
14
+ const provider = typeof value === "object" && value !== null ? value.provider : undefined;
15
+ const deviceId = typeof value === "object" && value !== null ? value.deviceId : undefined;
16
+ if (typeof provider !== "string" || provider === "" || (deviceId !== undefined && typeof deviceId !== "string")) {
17
+ throw placementNotHonored("RunInternals.placementTarget cannot be read as a target (it needs a non-empty string `provider`, and a string `deviceId` when it names one) — a fence the engine cannot read cannot be honored; fix the lane that handed it instead of dropping it.");
18
+ }
19
+ return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
20
+ }
21
+ export function settleOwnTarget(env, fence, restoredCheckpoint) {
22
+ const own = reportedPlacementTarget(env);
23
+ if (!placementHonored(fence, own)) {
24
+ const reported = own?.deviceId !== undefined ? `reports device "${own.deviceId}"` : "reports no device";
25
+ throw restoredCheckpoint
26
+ ? refusal("resume.env_failed", `resume workspace identity mismatch: the placement fence names deviceId "${fence?.deviceId}" but the restored execution environment ${reported} once its workspace settled — refusing to continue on a different physical device`)
27
+ : refusal("config.placement_not_honored", `this agent's placement fence names device "${fence?.deviceId}" but its execution environment ${reported} — refusing to run it on another target than the one it was handed (the factory must mint on the fenced device or throw)`);
28
+ }
29
+ return own;
30
+ }
31
+ function placementNotHonored(message) {
32
+ return refusal("config.placement_not_honored", message);
33
+ }
34
+ function refusal(code, message) {
35
+ const e = new Error(message);
36
+ e.code = code;
37
+ return e;
38
+ }
@@ -14,7 +14,7 @@
14
14
  * cached view and never hands out a half-acquired resource.
15
15
  *
16
16
  * Throws pass through unchanged: `resume.session_not_found` (requireExisting fail-loud mapping),
17
- * the `resume_at.*` target-validation refusals, `invalid_session` for a log whose parent links loop back, and — after the
17
+ * the `resume_at.*` target-validation refusals, `corrupt_session` for a log whose parent links loop back, and — after the
18
18
  * bounded re-wake budget — the session conflict itself. A throw after a `resumeAt` branch landed first writes that branch
19
19
  * back (`settleBranchWriteBack`); on success the branch is handed over with the session.
20
20
  */
@@ -25,6 +25,7 @@ import type { TaskSpec, ToolEffect } from "../types.js";
25
25
  import type { PrepareResume } from "./contracts.js";
26
26
  import { type ResumeAtBranch } from "./branch-writeback.js";
27
27
  import { type LegWrites } from "./session-write-ledger.js";
28
+ import { replayLossLeg } from "./lineage-reroot-view.js";
28
29
  export interface PrepareAcquireReconcileInput {
29
30
  /** borrowed-mutable (service port) — the deployment's session store. This phase's verbs on it are
30
31
  * the acquire/forget half of the session resource protocol: `acquire` per attempt, `forget` to
@@ -57,6 +58,8 @@ export interface PrepareAcquireReconcileInput {
57
58
  report?: (err: Error, sessionId: string) => void;
58
59
  /** borrowed-mutable (the Runner's) — this leg's view of the session write ledger, every storage write issued through it ({@link writesThroughLeg}); absent for a standalone prepare. */
59
60
  legWrites?: LegWrites;
61
+ /** borrowed-readonly — where the leg says what the log's replay dropped, and re-rooted a branch at it ({@link replayLossLeg}): absent ⇒ nothing said and no re-root (a break is refused). */
62
+ replayLossNotice?: Parameters<typeof replayLossLeg>[0];
60
63
  }
61
64
  /** The phase's outputs (four-class form). All six are fresh bindings —
62
65
  * the driver destructures them into consts, so a consumer moved ahead of this call is a lexical