@sema-agent/core 7.57.0 → 7.59.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 (399) hide show
  1. package/CHANGELOG.md +1161 -0
  2. package/README.md +6 -4
  3. package/dist/agents/cc-peer-directory.js +8 -8
  4. package/dist/agents/child-model-seat.d.ts +4 -2
  5. package/dist/agents/child-model-seat.js +5 -3
  6. package/dist/agents/peer-directory.d.ts +9 -0
  7. package/dist/agents/peer-directory.js +6 -2
  8. package/dist/agents/send-message-tool.js +21 -12
  9. package/dist/agents/subagent-steps.js +2 -4
  10. package/dist/agents/subagent.js +33 -34
  11. package/dist/brain/anthropic.js +161 -45
  12. package/dist/brain/errors.d.ts +9 -3
  13. package/dist/brain/errors.js +7 -1
  14. package/dist/brain/failover.js +2 -1
  15. package/dist/brain/open-responses.js +3 -3
  16. package/dist/brain/openai.js +103 -53
  17. package/dist/brain/provider-dialect.d.ts +11 -0
  18. package/dist/brain/provider-dialect.js +5 -2
  19. package/dist/brain/reasoning-request.js +5 -4
  20. package/dist/brain/reasoning.d.ts +19 -0
  21. package/dist/brain/reasoning.js +17 -2
  22. package/dist/brain/request-route.d.ts +4 -1
  23. package/dist/brain/request-route.js +4 -1
  24. package/dist/brain/route-adjudicator.d.ts +84 -18
  25. package/dist/brain/route-adjudicator.js +89 -22
  26. package/dist/brain/route-conformance.js +1 -1
  27. package/dist/brain/stream-engine.js +84 -49
  28. package/dist/brain/stream-shared.d.ts +30 -0
  29. package/dist/brain/stream-shared.js +34 -1
  30. package/dist/brain/timeout.d.ts +62 -5
  31. package/dist/brain/timeout.js +93 -6
  32. package/dist/core/a2a.d.ts +2 -1
  33. package/dist/core/a2a.js +23 -10
  34. package/dist/core/account-row.d.ts +61 -0
  35. package/dist/core/account-row.js +51 -0
  36. package/dist/core/advisor-verdict.d.ts +2 -1
  37. package/dist/core/advisor-verdict.js +1 -1
  38. package/dist/core/allow-entry.d.ts +20 -7
  39. package/dist/core/allow-entry.js +18 -9
  40. package/dist/core/approval-object.d.ts +29 -15
  41. package/dist/core/approval-object.js +47 -19
  42. package/dist/core/ask-origin.d.ts +21 -2
  43. package/dist/core/ask-origin.js +5 -1
  44. package/dist/core/auto-compaction.d.ts +4 -0
  45. package/dist/core/auto-compaction.js +2 -2
  46. package/dist/core/auto-mode-directive.d.ts +29 -5
  47. package/dist/core/auto-mode-directive.js +38 -8
  48. package/dist/core/background-agent-store.d.ts +16 -3
  49. package/dist/core/checkpoint-requirements.d.ts +19 -1
  50. package/dist/core/checkpoint-requirements.js +5 -1
  51. package/dist/core/checkpoint-store.d.ts +85 -23
  52. package/dist/core/checkpoint-store.js +31 -9
  53. package/dist/core/child-clamp-seats.d.ts +29 -0
  54. package/dist/core/child-clamp-seats.js +56 -1
  55. package/dist/core/compliance.d.ts +2 -2
  56. package/dist/core/compliance.js +1 -1
  57. package/dist/core/effective-path-target.d.ts +8 -2
  58. package/dist/core/effective-path-target.js +8 -3
  59. package/dist/core/engine-notice.d.ts +99 -9
  60. package/dist/core/engine-notice.js +19 -5
  61. package/dist/core/fs-write-gate-policy.d.ts +4 -2
  62. package/dist/core/fs-write-gate-policy.js +7 -3
  63. package/dist/core/gate-fold.js +7 -4
  64. package/dist/core/gate-lanes.js +19 -6
  65. package/dist/core/gate-outcome.d.ts +32 -3
  66. package/dist/core/gate-outcome.js +19 -1
  67. package/dist/core/git-worktree-env.d.ts +53 -11
  68. package/dist/core/git-worktree-env.js +96 -12
  69. package/dist/core/governance-codes.d.ts +9 -1
  70. package/dist/core/governance-codes.js +13 -0
  71. package/dist/core/hooks.d.ts +35 -4
  72. package/dist/core/hooks.js +17 -11
  73. package/dist/core/human-input-projection.d.ts +1 -0
  74. package/dist/core/human-input-projection.js +3 -0
  75. package/dist/core/image-admission.d.ts +6 -5
  76. package/dist/core/image-admission.js +18 -14
  77. package/dist/core/locked-config.d.ts +20 -3
  78. package/dist/core/locked-config.js +40 -3
  79. package/dist/core/mailbox-store.d.ts +45 -1
  80. package/dist/core/mailbox-store.js +53 -9
  81. package/dist/core/mcp-call-meta.d.ts +66 -0
  82. package/dist/core/mcp-call-meta.js +103 -0
  83. package/dist/core/mcp-connection-pool.d.ts +3 -1
  84. package/dist/core/mcp-connection-pool.js +3 -1
  85. package/dist/core/mcp-failure.d.ts +117 -15
  86. package/dist/core/mcp-failure.js +71 -3
  87. package/dist/core/mcp-probe.d.ts +4 -0
  88. package/dist/core/mcp-probe.js +1 -1
  89. package/dist/core/mcp-server-link.d.ts +27 -3
  90. package/dist/core/mcp-server-link.js +25 -1
  91. package/dist/core/mcp-server-spec.d.ts +46 -18
  92. package/dist/core/mcp-server-spec.js +1 -18
  93. package/dist/core/mcp.d.ts +16 -20
  94. package/dist/core/mcp.js +112 -55
  95. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  96. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  97. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  98. package/dist/core/memory-engine/consolidation.js +1 -0
  99. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  100. package/dist/core/memory-engine/distiller.js +2 -2
  101. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  102. package/dist/core/memory-engine/dual-root.js +44 -1
  103. package/dist/core/memory-engine/engine.d.ts +67 -14
  104. package/dist/core/memory-engine/engine.js +384 -212
  105. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  106. package/dist/core/memory-engine/export-bundle.js +23 -4
  107. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  108. package/dist/core/memory-engine/file-backend.js +290 -117
  109. package/dist/core/memory-engine/index.d.ts +1 -1
  110. package/dist/core/memory-engine/layout.d.ts +59 -11
  111. package/dist/core/memory-engine/layout.js +190 -40
  112. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  113. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  114. package/dist/core/memory-engine/scope-contract.d.ts +45 -4
  115. package/dist/core/memory-engine/scope-contract.js +80 -11
  116. package/dist/core/memory-engine/sync-client.d.ts +9 -1
  117. package/dist/core/memory-engine/sync-client.js +31 -8
  118. package/dist/core/memory-engine/sync.d.ts +5 -0
  119. package/dist/core/memory-engine/types.d.ts +6 -0
  120. package/dist/core/mode-policy.d.ts +8 -5
  121. package/dist/core/mode-policy.js +5 -4
  122. package/dist/core/mods/classic-events.d.ts +5 -1
  123. package/dist/core/mods/host.js +1 -1
  124. package/dist/core/mods/kernel/dispatch.d.ts +3 -0
  125. package/dist/core/mods/kernel/dispatch.js +12 -9
  126. package/dist/core/mods/kernel/events.d.ts +6 -1
  127. package/dist/core/mods/kernel/events.js +2 -2
  128. package/dist/core/mods/kernel/registration.d.ts +9 -1
  129. package/dist/core/mods/kernel/registration.js +3 -0
  130. package/dist/core/mods/kernel/site-rules.d.ts +3 -0
  131. package/dist/core/mods/kernel/site-rules.js +10 -0
  132. package/dist/core/mods/package.d.ts +23 -0
  133. package/dist/core/mods/package.js +118 -0
  134. package/dist/core/mods/stations.d.ts +33 -12
  135. package/dist/core/mods/stations.js +45 -11
  136. package/dist/core/mods/tool-call.d.ts +5 -1
  137. package/dist/core/mods/tool-call.js +13 -4
  138. package/dist/core/parent-spec-seat.d.ts +8 -3
  139. package/dist/core/parent-spec-seat.js +2 -0
  140. package/dist/core/park-selfcheck.js +6 -0
  141. package/dist/core/path-guard-rows.d.ts +20 -0
  142. package/dist/core/path-guard-rows.js +11 -0
  143. package/dist/core/peer-seat.d.ts +248 -0
  144. package/dist/core/peer-seat.js +439 -0
  145. package/dist/core/permission-rule-consent.js +10 -4
  146. package/dist/core/permission-rule-model.d.ts +16 -0
  147. package/dist/core/permission-rule-model.js +1 -1
  148. package/dist/core/present-plan-tool.d.ts +20 -3
  149. package/dist/core/present-plan-tool.js +48 -4
  150. package/dist/core/protocol-http-auth.d.ts +40 -29
  151. package/dist/core/protocol-http-auth.js +30 -32
  152. package/dist/core/redaction-marks.d.ts +16 -0
  153. package/dist/core/redaction-marks.js +16 -0
  154. package/dist/core/redaction-passes.js +8 -9
  155. package/dist/core/resume-startup-cause.js +1 -0
  156. package/dist/core/retention.d.ts +41 -15
  157. package/dist/core/retention.js +59 -12
  158. package/dist/core/rewrite-rejudge.d.ts +38 -0
  159. package/dist/core/rewrite-rejudge.js +42 -2
  160. package/dist/core/roles.d.ts +34 -2
  161. package/dist/core/roles.js +43 -4
  162. package/dist/core/run-origin.d.ts +40 -0
  163. package/dist/core/run-origin.js +37 -0
  164. package/dist/core/runner/advertised-writable-dirs.d.ts +57 -38
  165. package/dist/core/runner/advertised-writable-dirs.js +126 -0
  166. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  167. package/dist/core/runner/announce-once-ledger.js +4 -2
  168. package/dist/core/runner/call-hook-stations.js +2 -2
  169. package/dist/core/runner/compaction-restate.d.ts +15 -6
  170. package/dist/core/runner/compaction-restate.js +28 -2
  171. package/dist/core/runner/contracts.d.ts +33 -21
  172. package/dist/core/runner/credential-origin-seat.js +4 -3
  173. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  174. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  175. package/dist/core/runner/decide-continuation.d.ts +2 -2
  176. package/dist/core/runner/gate-exit.d.ts +30 -8
  177. package/dist/core/runner/gate-exit.js +15 -8
  178. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  179. package/dist/core/runner/image-removed-seat.js +19 -0
  180. package/dist/core/runner/inline-image.js +1 -1
  181. package/dist/core/runner/memory-consolidation-driver.js +3 -3
  182. package/dist/core/runner/park-commit.d.ts +1 -1
  183. package/dist/core/runner/park-commit.js +3 -0
  184. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  185. package/dist/core/runner/prepare-ask-lane.js +2 -1
  186. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  187. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -5
  188. package/dist/core/runner/prepare-caps-and-workflow.js +3 -1
  189. package/dist/core/runner/prepare-config-doors.d.ts +8 -5
  190. package/dist/core/runner/prepare-config-doors.js +14 -10
  191. package/dist/core/runner/prepare-context-lane.js +2 -0
  192. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -0
  193. package/dist/core/runner/prepare-delegation-surface.js +16 -18
  194. package/dist/core/runner/prepare-gate-stations.js +1 -1
  195. package/dist/core/runner/prepare-hands-readface.d.ts +11 -3
  196. package/dist/core/runner/prepare-hands-readface.js +9 -1
  197. package/dist/core/runner/prepare-inherited-gate.d.ts +1 -3
  198. package/dist/core/runner/prepare-inherited-gate.js +14 -27
  199. package/dist/core/runner/prepare-memory.d.ts +3 -0
  200. package/dist/core/runner/prepare-memory.js +26 -37
  201. package/dist/core/runner/prepare-park-ask.d.ts +1 -1
  202. package/dist/core/runner/prepare-park-ask.js +2 -1
  203. package/dist/core/runner/prepare-policy-chain.d.ts +7 -7
  204. package/dist/core/runner/prepare-policy-chain.js +18 -15
  205. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  206. package/dist/core/runner/prepare-project-context.js +2 -2
  207. package/dist/core/runner/prepare-prompt-inputs.d.ts +1 -1
  208. package/dist/core/runner/prepare-prompt-inputs.js +8 -19
  209. package/dist/core/runner/prepare-protocol-tools.d.ts +4 -2
  210. package/dist/core/runner/prepare-protocol-tools.js +11 -3
  211. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  212. package/dist/core/runner/prepare-run-refs.js +4 -1
  213. package/dist/core/runner/prepare-suspend-saga.d.ts +2 -0
  214. package/dist/core/runner/prepare-suspend-saga.js +2 -1
  215. package/dist/core/runner/prepare-task.js +28 -13
  216. package/dist/core/runner/prepare-wiring-manifest.d.ts +2 -1
  217. package/dist/core/runner/prepare-wiring-manifest.js +4 -3
  218. package/dist/core/runner/prepare-workspace-restore.d.ts +3 -0
  219. package/dist/core/runner/prepare-workspace-restore.js +4 -4
  220. package/dist/core/runner/reply-pricing.d.ts +30 -0
  221. package/dist/core/runner/reply-pricing.js +19 -0
  222. package/dist/core/runner/resume-admission.js +5 -3
  223. package/dist/core/runner/resume-apply.js +6 -1
  224. package/dist/core/runner/resume-checkpoint-screen.js +2 -0
  225. package/dist/core/runner/resume-policy-outcome.js +5 -5
  226. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  227. package/dist/core/runner/role-seat-defaulted.js +40 -0
  228. package/dist/core/runner/run-brain-sinks.js +2 -0
  229. package/dist/core/runner/run-harness-handlers.d.ts +3 -4
  230. package/dist/core/runner/run-harness-handlers.js +1 -8
  231. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  232. package/dist/core/runner/run-identity-wiring.js +6 -4
  233. package/dist/core/runner/run-leg.d.ts +2 -0
  234. package/dist/core/runner/run-leg.js +42 -29
  235. package/dist/core/runner/run-notification-lane.js +3 -0
  236. package/dist/core/runner/run-stop-and-final-verify.js +2 -2
  237. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  238. package/dist/core/runner/run-terminal-adoption.js +9 -3
  239. package/dist/core/runner/run-turn-boundary.js +77 -70
  240. package/dist/core/runner/runtask.d.ts +1 -1
  241. package/dist/core/runner/runtask.js +2 -2
  242. package/dist/core/runner/side-call-account.d.ts +1 -1
  243. package/dist/core/runner/side-call-account.js +3 -18
  244. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  245. package/dist/core/runner/sub-agent-deny-lists.js +10 -0
  246. package/dist/core/runner/terminal-account.js +3 -3
  247. package/dist/core/runner/tool-end-body.js +2 -1
  248. package/dist/core/runner/tool-occurrence.d.ts +5 -2
  249. package/dist/core/runner/tool-occurrence.js +4 -3
  250. package/dist/core/runner/turn-attachments.d.ts +26 -22
  251. package/dist/core/runner/turn-attachments.js +24 -26
  252. package/dist/core/runner/write-protection-station.d.ts +8 -2
  253. package/dist/core/runner/write-protection-station.js +2 -0
  254. package/dist/core/runner-deps.d.ts +3 -3
  255. package/dist/core/secret-env.d.ts +32 -2
  256. package/dist/core/secret-env.js +65 -3
  257. package/dist/core/sensitive-path-policy.js +9 -10
  258. package/dist/core/session-log-transfer.d.ts +24 -0
  259. package/dist/core/session-log-transfer.js +166 -0
  260. package/dist/core/session-policy-store.d.ts +3 -1
  261. package/dist/core/session-policy-store.js +13 -9
  262. package/dist/core/session-store.d.ts +86 -24
  263. package/dist/core/session-store.js +162 -24
  264. package/dist/core/session.d.ts +92 -1
  265. package/dist/core/shell-read-silence.js +1 -0
  266. package/dist/core/side-query.d.ts +11 -1
  267. package/dist/core/side-query.js +9 -0
  268. package/dist/core/skill-grant-binding.d.ts +31 -2
  269. package/dist/core/skill-grant-binding.js +31 -1
  270. package/dist/core/skill-grant.d.ts +8 -5
  271. package/dist/core/skill-grant.js +6 -6
  272. package/dist/core/steer-replay.d.ts +4 -2
  273. package/dist/core/steer-replay.js +2 -1
  274. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  275. package/dist/core/store-contracts/checkpoint-store-contract.js +20 -2
  276. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  277. package/dist/core/store-contracts/session-repo-contract.js +112 -5
  278. package/dist/core/store-contracts/session-store-contract.d.ts +4 -1
  279. package/dist/core/store-contracts/session-store-contract.js +236 -2
  280. package/dist/core/synthetic-read-verdict.js +2 -1
  281. package/dist/core/task-event.d.ts +92 -8
  282. package/dist/core/task-notification.js +16 -10
  283. package/dist/core/task-registry-agent.js +1 -0
  284. package/dist/core/task-registry-shared.d.ts +7 -1
  285. package/dist/core/task-spec.d.ts +49 -1
  286. package/dist/core/task-stream.d.ts +2 -1
  287. package/dist/core/terminal-cause.d.ts +11 -1
  288. package/dist/core/tool-catalog-entries.js +1 -0
  289. package/dist/core/tool-check-reading.d.ts +1 -0
  290. package/dist/core/tool-check-reading.js +3 -3
  291. package/dist/core/tool-policy.d.ts +16 -0
  292. package/dist/core/tool-result-store.d.ts +17 -10
  293. package/dist/core/tool-result-store.js +3 -1
  294. package/dist/core/tool-roster.d.ts +112 -5
  295. package/dist/core/tool-roster.js +42 -1
  296. package/dist/core/tool-spec.d.ts +3 -1
  297. package/dist/core/types.d.ts +3 -3
  298. package/dist/core/types.js +1 -1
  299. package/dist/core/untrusted-egress.d.ts +0 -2
  300. package/dist/core/untrusted-egress.js +10 -14
  301. package/dist/core/user-attachment.js +1 -1
  302. package/dist/core/wiring-manifest.d.ts +18 -6
  303. package/dist/core/wiring-manifest.js +4 -3
  304. package/dist/core/workspace-snapshot.d.ts +44 -0
  305. package/dist/core/workspace-snapshot.js +34 -0
  306. package/dist/core/write-protect.d.ts +43 -3
  307. package/dist/core/write-protect.js +43 -16
  308. package/dist/engine/compaction/compaction.js +29 -3
  309. package/dist/engine/execution-env/node-execution-env.d.ts +4 -3
  310. package/dist/engine/execution-env/node-execution-env.js +24 -23
  311. package/dist/engine/execution-env/symlink-chain.d.ts +7 -5
  312. package/dist/engine/harness/agent-harness.d.ts +30 -2
  313. package/dist/engine/harness/agent-harness.js +43 -12
  314. package/dist/engine/harness/messages.d.ts +3 -1
  315. package/dist/engine/harness/messages.js +3 -2
  316. package/dist/engine/harness/types.d.ts +56 -7
  317. package/dist/engine/harness/types.js +5 -1
  318. package/dist/engine/llm/rejected-images.d.ts +46 -0
  319. package/dist/engine/llm/rejected-images.js +54 -0
  320. package/dist/engine/llm/tool-turns.d.ts +2 -1
  321. package/dist/engine/llm/types.d.ts +30 -10
  322. package/dist/engine/llm/types.js +1 -1
  323. package/dist/engine/loop/agent-loop.d.ts +8 -0
  324. package/dist/engine/loop/agent-loop.js +52 -15
  325. package/dist/engine/loop/types.d.ts +3 -1
  326. package/dist/engine/session/import-validate.js +3 -0
  327. package/dist/engine/session/memory-repo.d.ts +17 -9
  328. package/dist/engine/session/memory-repo.js +44 -34
  329. package/dist/engine/session/path-to-root.d.ts +38 -0
  330. package/dist/engine/session/path-to-root.js +39 -0
  331. package/dist/engine/session/repo-utils.d.ts +22 -4
  332. package/dist/engine/session/repo-utils.js +49 -1
  333. package/dist/engine/session/storage-base.d.ts +10 -1
  334. package/dist/engine/session/storage-base.js +11 -22
  335. package/dist/index.d.ts +29 -16
  336. package/dist/index.js +21 -11
  337. package/dist/internal/harness-types.d.ts +2 -2
  338. package/dist/internal/harness.d.ts +3 -2
  339. package/dist/internal/harness.js +2 -2
  340. package/dist/internal/llm.d.ts +1 -0
  341. package/dist/orchestration/workflow-observe.d.ts +17 -1
  342. package/dist/orchestration/workflow-observe.js +20 -0
  343. package/dist/orchestration/workflow-types.d.ts +32 -7
  344. package/dist/orchestration/workflow.js +739 -489
  345. package/dist/shell/counting-pass.d.ts +50 -0
  346. package/dist/shell/counting-pass.js +502 -0
  347. package/dist/shell/lex.d.ts +4 -2
  348. package/dist/shell/lex.js +93 -34
  349. package/dist/shell/shell-words.d.ts +1 -1
  350. package/dist/shell/shell-words.js +7 -6
  351. package/dist/stores/file/index.d.ts +4 -1
  352. package/dist/stores/file/index.js +4 -1
  353. package/dist/stores/file/mailbox-store.js +6 -10
  354. package/dist/stores/file/session-store.d.ts +15 -8
  355. package/dist/stores/file/session-store.js +28 -13
  356. package/dist/tools/fs/fs-bash.d.ts +6 -0
  357. package/dist/tools/fs/fs-bash.js +6 -3
  358. package/dist/tools/fs/fs-write.d.ts +6 -3
  359. package/dist/tools/fs/fs-write.js +8 -7
  360. package/dist/tools/fs/index.d.ts +3 -0
  361. package/dist/tools/fs/index.js +7 -3
  362. package/dist/tools/fs/program-read-model.d.ts +13 -0
  363. package/dist/tools/fs/program-read-model.js +15 -0
  364. package/dist/tools/fs/program-read-model.rows.js +1 -1
  365. package/dist/tools/fs/read-deny.d.ts +13 -10
  366. package/dist/tools/fs/read-deny.js +25 -5
  367. package/dist/tools/fs/read-floor.d.ts +19 -0
  368. package/dist/tools/fs/read-floor.js +23 -0
  369. package/dist/tools/fs/safety.js +40 -8
  370. package/dist/tools/fs/search.js +6 -24
  371. package/dist/tools/fs/shell-read-check.d.ts +9 -2
  372. package/dist/tools/fs/shell-read-check.js +61 -16
  373. package/dist/tools/fs/shell-read-establish.js +2 -1
  374. package/dist/tools/fs/shell-read-identity.js +1 -1
  375. package/dist/tools/fs/shell-read-judge.d.ts +26 -9
  376. package/dist/tools/fs/shell-read-judge.js +10 -6
  377. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  378. package/dist/tools/fs/shell-read-plan.js +22 -15
  379. package/dist/tools/fs/shell-read-start.js +1 -0
  380. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  381. package/dist/tools/fs/shell-reentry-text.js +25 -3
  382. package/dist/tools/monitor.d.ts +4 -0
  383. package/dist/tools/monitor.js +2 -0
  384. package/dist/tools/worktree.d.ts +42 -15
  385. package/dist/tools/worktree.js +60 -32
  386. package/package.json +5 -2
  387. package/test/export-surface.snapshot.json +149 -1
  388. package/wire-changes/core-stores-sql@7.58.0.json +29 -0
  389. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  390. package/wire-changes/core@7.58.0.json +2188 -0
  391. package/wire-changes/core@7.59.0.json +2459 -0
  392. package/wire-changes/mods-kernel@7.58.0.json +81 -0
  393. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  394. package/wire-changes/primitives@7.58.0.json +29 -0
  395. package/wire-changes/primitives@7.59.0.json +29 -0
  396. package/dist/primitives/credential-ref.d.ts +0 -89
  397. package/dist/primitives/credential-ref.js +0 -125
  398. package/dist/primitives/index.d.ts +0 -2
  399. package/dist/primitives/index.js +0 -1
@@ -78,7 +78,7 @@ export function prepareBoundaryParks(input) {
78
78
  const suspendForResource = resourceSuspendEligible ? mintResourceSuspend : undefined;
79
79
  const suspendForPlatformLimit = durableSuspendInfraReady ? mintResourceSuspend : undefined;
80
80
  const suspendForReview = checkpointStore
81
- ? async (reason) => {
81
+ ? async (reason, requestedByCallId) => {
82
82
  if (!checkpointStore)
83
83
  return false;
84
84
  if (abortController.signal.aborted)
@@ -133,7 +133,7 @@ export function prepareBoundaryParks(input) {
133
133
  sessionId,
134
134
  leafId,
135
135
  gate,
136
- pendingAction: { kind: "plan_review" },
136
+ pendingAction: { kind: "plan_review", ...(requestedByCallId !== undefined && requestedByCallId !== "" ? { requestedByCallId } : {}) },
137
137
  state: serializeCheckpointState(remoteHandle, inFlightSpendMicroUsd()),
138
138
  status: "pending",
139
139
  createdAt: mintedAt,
@@ -29,6 +29,7 @@ import { type AutoModeDecider, type AutoModeDenialTracker } from "../auto-mode.j
29
29
  import { type CheckpointSeat } from "../checkpoint-seat.js";
30
30
  import { type ComplianceCapability } from "../compliance.js";
31
31
  import type { LockedPreflight } from "../locked-config.js";
32
+ import { type PlanFileSource } from "../present-plan-tool.js";
32
33
  import type { StoredSession } from "../session.js";
33
34
  import type { RunnerDeps, RuntimeCaps, TaskEvent, ToolExecuteContext } from "../types.js";
34
35
  import type { AutoModeArmFact } from "../wiring-manifest.js";
@@ -74,8 +75,8 @@ export interface PrepareCapsAndWorkflowInput {
74
75
  model: Model;
75
76
  /** borrowed-readonly — the run's resolved thinking level, when one is (the Workflow mount's parentThinking fallback). */
76
77
  thinking: ThinkingLevel | undefined;
77
- /** borrowed-readonly — the frozen preflight; only `mcp` (the compliance veto's mcp_servers conflict check). */
78
- lockedPreflight: Pick<LockedPreflight, "mcp">;
78
+ /** borrowed-readonly — the frozen preflight; only `mcp` and `a2a` (the compliance veto's mcp_servers / a2a_peers conflict checks). */
79
+ lockedPreflight: Pick<LockedPreflight, "mcp" | "a2a">;
79
80
  /** borrowed-mutable — the effect collection (`Prepared.toolEffects`): the safety scan's caller entries, then the mounts' writes. */
80
81
  toolEffects: Prepared["toolEffects"];
81
82
  /** borrowed-readonly — the frozen tool-face snapshot the Workflow mount forwards (exclude / defer / alwaysLoad / restoreGated). */
@@ -105,9 +106,8 @@ export interface PrepareCapsAndWorkflowInput {
105
106
  offloadThresholdChars?: number;
106
107
  }) => AgentTool;
107
108
  /** borrowed-readonly — the plan-review primitive the ExitPlanMode tool calls. */
108
- requestReview: (opts?: {
109
- reason?: string;
110
- }) => void;
109
+ requestReview: (opts?: import("../present-plan-tool.js").ReviewRequest) => void;
110
+ /** borrowed-readonly — the declared session plan file as ExitPlanMode's FILE arm reads it (absent ⇒ the parameter arm). */ planFileSource?: PlanFileSource;
111
111
  /** borrowed-readonly — the plan-mode primitive the EnterPlanMode tool calls: a steer of the leg's mode seat into `plan`. */
112
112
  enterPlanMode: () => Promise<void>;
113
113
  /** borrowed-readonly — the leg's live permission-mode seat: the arming's first arm is `declared === "auto"`, and the
@@ -149,7 +149,7 @@ export async function prepareCapsAndWorkflow(input) {
149
149
  if (spec.enablePlanMode === true && spec.interactiveTools !== false) {
150
150
  const planReviewFace = checkpointStoreOfSeat(checkpointSeat) !== undefined;
151
151
  if (spec.interactiveTools === true || planReviewFace) {
152
- roster.mount(defineTool(createPresentPlanTool(requestReview)), { source: "builtin", mountedBy: "optional" });
152
+ roster.mount(defineTool(createPresentPlanTool(requestReview, input.planFileSource)), { source: "builtin", mountedBy: "optional" });
153
153
  if (planReviewFace) {
154
154
  roster.mount(defineTool(createEnterPlanModeTool(enterPlanMode)), { source: "builtin", mountedBy: "optional" });
155
155
  }
@@ -196,6 +196,8 @@ export async function prepareCapsAndWorkflow(input) {
196
196
  if (complianceDenies.has("mcp_servers") && lockedPreflight.mcp?.length) {
197
197
  complianceRefuse("mcp_servers", "TaskSpec.mcp (MCP server materialization)");
198
198
  }
199
+ if (complianceDenies.has("a2a_peers") && lockedPreflight.a2a?.length)
200
+ complianceRefuse("a2a_peers", "TaskSpec.a2a (A2A peer materialization)");
199
201
  if (complianceDenies.has("workflows") && spec.selfOrchestration === true) {
200
202
  complianceRefuse("workflows", "TaskSpec.selfOrchestration (workflow self-orchestration)");
201
203
  }
@@ -24,7 +24,8 @@ import type { ThinkingLevel } from "../../internal/harness.js";
24
24
  import { type MicroCompactMachine } from "../context-edit.js";
25
25
  import { type CrossBoundaryPosture } from "../cross-boundary-taint.js";
26
26
  import { type HostFloor } from "../host-floor.js";
27
- import { recordedModeSeed } from "../checkpoint-store.js";
27
+ import { type CheckpointState } from "../checkpoint-store.js";
28
+ import { runOriginOfLeg, type RunOrigin } from "../run-origin.js";
28
29
  import { type ConfigDoorEntry, type LockedPreflight } from "../locked-config.js";
29
30
  import { type ResolvedRole } from "../roles.js";
30
31
  import { type ResolvedSkillListingBudget } from "../skill-listing-budget.js";
@@ -210,6 +211,7 @@ export interface PrepareConfigDoorsResult {
210
211
  crossBoundaryPosture: CrossBoundaryPosture | undefined;
211
212
  advisorTool: "disabled" | undefined;
212
213
  hostFloor: HostFloor | undefined;
214
+ runOrigin: RunOrigin | undefined;
213
215
  }
214
216
  /** The microCompact knob door (坏值响亮度默认律, the sibling knob doors' form:
215
217
  * interactionPosture / toolModelGate / staleToolResultOffload). Placement is load-bearing:
@@ -234,7 +236,7 @@ export declare const checkpointStoreSeat: (spec: {
234
236
  export declare function assertResumeConfigRecord(config: unknown): void;
235
237
  /** The spec the value doors read: a prepare's (its roster is faces) or a resume's re-supplied config (no objective, no session id). */
236
238
  type ValueDoorSpec = Omit<TaskSpec, "tools" | "objective" | "sessionId" | "userAttachments"> & Partial<Pick<TaskSpec, "objective" | "sessionId">>;
237
- type ConfigValueDoorsResult = Pick<PrepareConfigDoorsResult, "toolFaceLists" | "promptHost" | "promptBinding" | "lockedPreflight" | "microCompactKnob" | "memoryDelegationEvidence" | "memoryProvenance" | "memoryCapturePolicy" | "usageWindows" | "brainCallGuardrailMs" | "crossBoundaryPosture" | "advisorTool" | "promptLean" | "hostFloor"> & {
239
+ type ConfigValueDoorsResult = Pick<PrepareConfigDoorsResult, "toolFaceLists" | "promptHost" | "promptBinding" | "lockedPreflight" | "microCompactKnob" | "memoryDelegationEvidence" | "memoryProvenance" | "memoryCapturePolicy" | "usageWindows" | "brainCallGuardrailMs" | "crossBoundaryPosture" | "advisorTool" | "promptLean" | "hostFloor" | "runOrigin"> & {
238
240
  skillListingSeats: {
239
241
  fraction: unknown;
240
242
  maxDescChars: unknown;
@@ -256,20 +258,21 @@ export declare function configValueDoors(input: {
256
258
  resumeLeg: boolean;
257
259
  sessions: SessionStore;
258
260
  holder?: string | undefined;
261
+ resumedRow?: Parameters<typeof runOriginOfLeg>[1];
259
262
  }, enter?: ConfigDoorEntry): ConfigValueDoorsResult;
260
263
  /**
261
264
  * The doors a RESUMED leg's prepare refuses at, run as one screen BEFORE the claim — prepare's own functions, so a refusal carries
262
265
  * the very sentence and code prepare throws: the mode doors (`refusePermissionModeDoors`), the output-style seat, the approval
263
266
  * reach, the skills invoked by name (the part no roster changes), the attachments (a resume sends no new human message, so any
264
267
  * entry is refused), the leg declarations of the tools it re-supplies (this phase's first door), this phase's value doors over the config, the deployment's deps and the session store the Runner holds
265
- * ({@link configValueDoors}, the retention capability door included) and the mode words the row recorded (`recordedModeSeed`).
266
- * It leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`:
268
+ * ({@link configValueDoors}, the retention capability door and the run-origin door over the row's recorded word included) and the mode
269
+ * words the row recorded (`recordedModeSeed`). It leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`:
267
270
  * `checkpoint.config_refused`, `detail.code` = prepare's code, `detail.field` = `"taskConfig"`, `"deps"` or `"inheritedGate"`)
268
271
  * where prepare would end the leg `failed` after the claim — the row consumed on a store without `reopen`, replayed as a system
269
272
  * retry on one with it, which a configuration fix cannot reach. Before the claim the row stays `pending` and byte-identical and the
270
273
  * corrected resume redeems the same token. A throw that is none of prepare's codes leaves as it was thrown. Returns the config the
271
274
  * leg is handed: the caller's, its MCP servers and A2A peers the frozen entries the lock layer judged (read once, dialed as judged).
272
275
  */
273
- export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C, recordedGate: Parameters<typeof recordedModeSeed>[0], deps: RunnerDeps, sessions: SessionStore, holder?: string): C;
276
+ export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C, recorded: Pick<CheckpointState, "inheritedGate" | "runOrigin"> | undefined, deps: RunnerDeps, sessions: SessionStore, holder?: string): C;
274
277
  export declare function prepareConfigDoors(input: PrepareConfigDoorsInput): PrepareConfigDoorsResult;
275
278
  export {};
@@ -6,6 +6,7 @@ import { CROSS_BOUNDARY_POSTURES } from "../cross-boundary-taint.js";
6
6
  import { compileHostFloor } from "../host-floor.js";
7
7
  import { assertNoRetiredRunnerDeps } from "./retired-runner-deps.js";
8
8
  import { recordedModeSeed, resolveCheckpointStore } from "../checkpoint-store.js";
9
+ import { runOriginOfLeg, screenRecordedRunOrigin } from "../run-origin.js";
9
10
  import { assertCheckpointStoreJudgesHolder, assertHolderValue } from "../checkpoint-generation.js";
10
11
  import { asResumeConfigRefusal, refusePermissionModeDoors } from "../mode-policy.js";
11
12
  import { resolveOutputStyleFrame } from "../output-style.js";
@@ -16,7 +17,7 @@ import { screenHandsBandOptions } from "../hands-band-screen.js";
16
17
  import { assertAutoConsolidationWirable } from "./memory-consolidation-driver.js";
17
18
  import { isModelPriced, malformedPricingField, modelCostToPricing } from "../pricing.js";
18
19
  import { ENTER_AS_IS, preflightLockedConfig } from "../locked-config.js";
19
- import { assertRetentionCapability } from "../retention.js";
20
+ import { assertRetentionWords } from "../retention.js";
20
21
  import { resolveModel, resolveTaskModel, roleModelIfSet, screenRoleMap } from "../roles.js";
21
22
  import { resolveSkillListingBudget } from "../skill-listing-budget.js";
22
23
  import { describeRejectedValue } from "../tool-search-setting.js";
@@ -185,6 +186,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
185
186
  const { spec, deps, resumeLeg, sessions, holder } = input;
186
187
  enter("deps", () => assertNoRetiredRunnerDeps(deps));
187
188
  enter("taskConfig", () => assertPrincipalValue(spec.principal));
189
+ const runOrigin = enter("taskConfig", () => runOriginOfLeg(spec.runOrigin, input.resumedRow));
188
190
  enter("taskConfig", () => assertPeerPresenceValue(spec.peerPresence));
189
191
  enter("taskConfig", () => assertRestoreGatedToolsValue(spec.restoreGatedTools));
190
192
  const microCompactKnob = enter("deps", () => resolveMicroCompactKnob(deps.microCompact));
@@ -280,6 +282,8 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
280
282
  e.code = "config.memory_persistence_invalid";
281
283
  throw e;
282
284
  });
285
+ if (spec.classifyAllShell !== undefined && typeof spec.classifyAllShell !== "boolean")
286
+ enter("taskConfig", () => { throw limitConfigError("config.invalid_argument", `TaskSpec.classifyAllShell must be a boolean when present (got ${describeRejectedValue(spec.classifyAllShell)}) — true lets no shell allow entry clear a call in auto mode; omit the key for the default.`); });
283
287
  if (spec.toolMaterializeStrategy === "static" && spec.deferSelfResolve === false)
284
288
  enter("taskConfig", () => {
285
289
  const e = new Error(`toolMaterializeStrategy "static" cannot be combined with deferSelfResolve: false — with the direct-call ` +
@@ -328,7 +332,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
328
332
  enter(checkpointStoreSeat(spec), () => assertCheckpointStoreJudgesHolder(checkpointStoreSeat(spec) === "taskConfig" ? "TaskSpec.checkpointStore" : "RunnerDeps.checkpointStore", checkpointStore, holder));
329
333
  const taskStore = checkpointStoreSeat(spec) === "taskConfig" ? checkpointStore : undefined;
330
334
  const retention = { policy: deps.retentionPolicy, locked: lockedPreflight.lockedKeys.has("retentionPolicy") };
331
- enter("deps", () => assertRetentionCapability({
335
+ enter("deps", () => assertRetentionWords({
332
336
  ...retention,
333
337
  stores: [
334
338
  { name: "sessionStore", store: sessions },
@@ -337,10 +341,10 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
337
341
  ],
338
342
  }));
339
343
  if (taskStore !== undefined)
340
- enter("taskConfig", () => assertRetentionCapability({ ...retention, stores: [{ name: "checkpointStore", store: taskStore }] }));
341
- return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor };
344
+ enter("taskConfig", () => assertRetentionWords({ ...retention, stores: [{ name: "checkpointStore", store: taskStore }] }));
345
+ return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin };
342
346
  }
343
- export function refuseResumeDoors(config, recordedGate, deps, sessions, holder) {
347
+ export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
344
348
  asResumeConfigRefusal("taskConfig", () => {
345
349
  refusePermissionModeDoors(config);
346
350
  resolveOutputStyleFrame(config.outputStyle);
@@ -350,8 +354,8 @@ export function refuseResumeDoors(config, recordedGate, deps, sessions, holder)
350
354
  assertToolBoundaryLegs(config.tools);
351
355
  assertToolCardDeclarations(config.tools);
352
356
  });
353
- const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder }, asResumeConfigRefusal);
354
- asResumeConfigRefusal("inheritedGate", () => void recordedModeSeed(recordedGate));
357
+ const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder, ...(recorded !== undefined ? { resumedRow: { recorded: recorded.runOrigin } } : {}) }, asResumeConfigRefusal);
358
+ asResumeConfigRefusal("inheritedGate", () => void recordedModeSeed(recorded?.inheritedGate));
355
359
  return { ...config, ...(config.mcp !== undefined ? { mcp: lockedPreflight.mcp ?? [] } : {}), ...(config.a2a !== undefined ? { a2a: lockedPreflight.a2a ?? [] } : {}), skills };
356
360
  }
357
361
  export function prepareConfigDoors(input) {
@@ -359,9 +363,9 @@ export function prepareConfigDoors(input) {
359
363
  assertToolBoundaryLegs(input.spec.tools);
360
364
  assertToolCardDeclarations(input.spec.tools);
361
365
  let spec = input.spec;
362
- const { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor } = configValueDoors({ spec, deps, resumeLeg: resume !== undefined, sessions, holder: internals?.holder });
366
+ const { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin } = configValueDoors({ spec, deps, resumeLeg: resume !== undefined, sessions, holder: internals?.holder, ...(resume !== undefined ? { resumedRow: { recorded: screenRecordedRunOrigin(resume.seed.runOrigin), ...(resume.opening !== undefined ? { opening: resume.opening } : {}) } } : {}) });
363
367
  const doorRead = (value) => ({ value, enumerable: value !== undefined, writable: false, configurable: false });
364
- spec = Object.create(Object.getPrototypeOf(spec), { ...Object.getOwnPropertyDescriptors(spec), skills: doorRead(skills), projectMemory: doorRead(projectMemory) });
368
+ spec = Object.create(Object.getPrototypeOf(spec), { ...Object.getOwnPropertyDescriptors(spec), skills: doorRead(skills), projectMemory: doorRead(projectMemory), runOrigin: doorRead(runOrigin) });
365
369
  const resolvedInteractionPosture = spec.interactionPosture ?? internals?.parentInteractionPosture ?? deps.interactionPosture;
366
370
  const askSeat = resolveAskSeat(spec, deps);
367
371
  {
@@ -505,7 +509,7 @@ export function prepareConfigDoors(input) {
505
509
  memoryDelegationEvidence,
506
510
  skillListingBudget,
507
511
  memoryProvenance,
508
- memoryCapturePolicy, crossBoundaryPosture, advisorTool, hostFloor,
512
+ memoryCapturePolicy, crossBoundaryPosture, advisorTool, hostFloor, runOrigin,
509
513
  usageWindows,
510
514
  brainCallGuardrailRef,
511
515
  brainCallGuardrailMs,
@@ -12,6 +12,7 @@ import { applyGitFrameGuard } from "./git-status-frame.js";
12
12
  import { applyContextShrinkToReadFileState } from "../../tools/fs/index.js";
13
13
  import { rosterToolName } from "../tool-roster.js";
14
14
  import { createToolTurnRepairSeat } from "./tool-turn-repair-seat.js";
15
+ import { createImageRemovedSeat } from "./image-removed-seat.js";
15
16
  export function prepareContextLane(input) {
16
17
  const { model, deps, sessionId, runId, hostTaskId, offloadStore, toolRosterDeltas, microCompactKnob, harness, batchHaltRef, gitStatusRef, postureFrameRef, requestLossyRef, trimPressureRef, readFileState } = input;
17
18
  const toolNameOf = (recorded) => rosterToolName(toolRosterDeltas.current, recorded);
@@ -29,6 +30,7 @@ export function prepareContextLane(input) {
29
30
  requestLossyRef.current = true;
30
31
  announceRepairs(repairs);
31
32
  };
33
+ harness.onImagesRemoved = createImageRemovedSeat((notice) => deps.onNotice?.(notice), { sessionId, runId });
32
34
  harness.on("context", async ({ messages, recheck, signal }) => {
33
35
  batchHaltRef.current = undefined;
34
36
  const pendingProjectionObservations = [];
@@ -20,6 +20,7 @@ import type { AgentTool, ExecutionEnv, WorkspaceState } from "../../internal/har
20
20
  import { type PeerLaneRefs } from "../../agents/peer-session-drain.js";
21
21
  import type { SubagentRetainLedger } from "../../agents/retain-ledger.js";
22
22
  import type { ShellReadAdmission } from "../../tools/fs/shell-read-check.js";
23
+ import type { ReadFloorSeat } from "../../tools/fs/read-floor.js";
23
24
  import { type WorktreeSessionRef } from "../../tools/worktree.js";
24
25
  import type { CwdRef } from "../../tools/fs/index.js";
25
26
  import { type ToolResultStore } from "../tool-result-store.js";
@@ -61,6 +62,9 @@ export interface PrepareDelegationSurfaceInput {
61
62
  backgroundTaskToolsActive: boolean;
62
63
  /** borrowed-readonly — this run's shell read station's pre-spawn ADMISSION (declared at the hands phase), for `Monitor`: the only P11 face that spawns a shell command. */
63
64
  shellReadAdmission: ShellReadAdmission | undefined;
65
+ /** borrowed-readonly — the byte floor's seat over the run's read-deny table (declared at the hands phase), for `Monitor`:
66
+ * the watched command's start carries the table to the environment, as the band's shell starts do. */
67
+ shellReadFloor: ReadFloorSeat | undefined;
64
68
  /** borrowed-readonly — the door's second half: the Workflow tool is on the roster. */
65
69
  workflowToolsActive: boolean;
66
70
  /** borrowed-readonly — the peer lane's mount verdict for this leg. */
@@ -116,6 +120,10 @@ export interface PrepareDelegationSurfaceInput {
116
120
  workspaceStateSettle: {
117
121
  restoredWorktreeDir?: string;
118
122
  } | undefined;
123
+ /** borrowed-mutable — the leg's write-location seat (prepare-task mints it empty, before any write-root reader is built, and
124
+ * reads it through its one reader `currentCheckoutOf`). The worktree mount seeds `current` here and hands THIS object to
125
+ * the tools — a copy would strand their writes from every write-root reader. */
126
+ worktreeSeat: WorktreeSessionRef;
119
127
  }
120
128
  export interface PrepareDelegationSurfaceResult {
121
129
  /** owned — whether the background/workflow door is open (TaskOutput / TaskStop / AgentTranscript ride it). */
@@ -13,7 +13,7 @@ import { deliverEngineNotice } from "../types.js";
13
13
  import { RosterBuilder } from "../tool-roster.js";
14
14
  import { sendMessageContinuationSeats } from "./send-message-continuation.js";
15
15
  export function prepareDelegationSurface(input) {
16
- const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle } = input;
16
+ const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle, worktreeSeat } = input;
17
17
  let worktreeSessionRef;
18
18
  const delegationSurfaceActive = backgroundTaskToolsActive || workflowToolsActive;
19
19
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
@@ -93,6 +93,7 @@ export function prepareDelegationSurface(input) {
93
93
  roster.mount(firstPartyOffload(createMonitorTool(executionEnv, {
94
94
  registry: defaultTaskRegistry,
95
95
  ...(input.shellReadAdmission !== undefined ? { shellReadAdmission: input.shellReadAdmission } : {}),
96
+ ...(input.shellReadFloor !== undefined ? { readFloor: input.shellReadFloor } : {}),
96
97
  owner: hostTaskId,
97
98
  scope: taskScope,
98
99
  ...(sessionId !== undefined ? { sessionId } : {}),
@@ -104,25 +105,22 @@ export function prepareDelegationSurface(input) {
104
105
  })), { source: "builtin", mountedBy: "backgroundTasks" });
105
106
  }
106
107
  if (handsCwdRef !== undefined) {
107
- worktreeSessionRef = {
108
- ...(resume?.seed.activeWorktree
108
+ worktreeSessionRef = worktreeSeat;
109
+ const seeded = resume?.seed.activeWorktree
110
+ ? {
111
+ ...resume.seed.activeWorktree,
112
+ worktreeDir: rebaseRestoredPath(resume.seed.activeWorktree.worktreeDir),
113
+ originalCwd: rebaseRestoredPath(resume.seed.activeWorktree.originalCwd),
114
+ }
115
+ : wsSnapshot?.activeWorktree !== undefined
109
116
  ? {
110
- current: {
111
- ...resume.seed.activeWorktree,
112
- worktreeDir: rebaseRestoredPath(resume.seed.activeWorktree.worktreeDir),
113
- originalCwd: rebaseRestoredPath(resume.seed.activeWorktree.originalCwd),
114
- },
117
+ ...wsSnapshot.activeWorktree,
118
+ worktreeDir: rebaseWsPath(wsSnapshot.activeWorktree.worktreeDir),
119
+ originalCwd: rebaseWsPath(wsSnapshot.activeWorktree.originalCwd),
115
120
  }
116
- : wsSnapshot?.activeWorktree !== undefined
117
- ? {
118
- current: {
119
- ...wsSnapshot.activeWorktree,
120
- worktreeDir: rebaseWsPath(wsSnapshot.activeWorktree.worktreeDir),
121
- originalCwd: rebaseWsPath(wsSnapshot.activeWorktree.originalCwd),
122
- },
123
- }
124
- : {}),
125
- };
121
+ : undefined;
122
+ if (seeded !== undefined)
123
+ worktreeSessionRef.current = seeded;
126
124
  if (workspaceStateSettle !== undefined)
127
125
  workspaceStateSettle.restoredWorktreeDir = worktreeSessionRef.current?.worktreeDir;
128
126
  roster.mountAll(createWorktreeTools(executionEnv, { repoRoot: taskRootFinal, cwdRef: handsCwdRef, session: worktreeSessionRef }).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(t))), { source: "builtin", mountedBy: "hands" });
@@ -223,7 +223,7 @@ export function prepareGateStations(input) {
223
223
  for (const defect of screened.defects)
224
224
  deps.onError?.(new Error(defect), { phase: "config", sessionId });
225
225
  if (screened.gate !== undefined)
226
- toolOccurrences.gateRound(e.toolCallId, screened.gate, result.finalInput);
226
+ toolOccurrences.gateRound(e.toolCallId, screened.gate, result.finalInput, result.rewrite);
227
227
  if (result.block) {
228
228
  const haltRemaining = maybeHumanRejectionHalt({
229
229
  gate: screened.gate,
@@ -3,6 +3,7 @@ import { type ReadFileState } from "../../tools/fs/safety.js";
3
3
  import { type PathTablesFacade, type PersonPathRows, type ReadRootsSeat } from "./person-path-rows.js";
4
4
  import type { HeadLeads } from "../path-rule-binding.js";
5
5
  import { type ShellReadAdmission, type ShellReadCheck, type ShellReadLandings } from "../../tools/fs/shell-read-check.js";
6
+ import { type ReadFloorSeat } from "../../tools/fs/read-floor.js";
6
7
  import type { ShellReadBoundary } from "../../tools/fs/shell-read-judge.js";
7
8
  import type { RunnerDeps, ShellGateDoctrine, TaskSpec } from "../types.js";
8
9
  import type { Model } from "../../internal/llm.js";
@@ -36,6 +37,10 @@ export interface PrepareHandsReadFaceInput {
36
37
  * resolver at the driver's root receiving point ({@link import("./task-root-canonical.js").resolveTaskRootCanonical}):
37
38
  * taken as an input, never re-canonicalized here, so the fence and the root notice cannot disagree. */
38
39
  taskRootCanonical: string;
40
+ /** borrowed-readonly — the leg's ONE write-location reader (prepare-task's `currentCheckoutOf` over the worktree seat): the
41
+ * primary WRITE root of the structured write tools and of the shell's write targets, read per call — it is the task root
42
+ * until EnterWorktree switches it, and moves back on ExitWorktree. The READ roots never read it. */
43
+ writeLocation: () => string;
39
44
  /** borrowed-readonly — B-4's checkpoint-path rebaser (T7): identity unless a divergent restore
40
45
  * armed it; applied to the readFileState seed keys and the handsCwd seed. */
41
46
  rebaseRestoredPath: (p: string) => string;
@@ -86,9 +91,9 @@ export interface PrepareHandsReadFaceInput {
86
91
  * (the Read tool's document-degradation fork). */
87
92
  model: Model;
88
93
  /** borrowed-readonly — the task-spec seats this phase reads, as a Pick over the SAME spec object
89
- * (R-4). `tools` feeds only the band shadow check; `envFacts` only the advertised scratchpad;
90
- * `retainBackgroundProcesses` only the band's retain lane (Bash's lifetime sentence + row stamp). */
91
- spec: Pick<TaskSpec, "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "handsReadOnly" | "readDenyPatterns" | "readFace" | "writeFace" | "oneShot" | "resumeAt" | "retainBackgroundProcesses" | "sessionId" | "tools" | "excludeAllTools">;
94
+ * (R-4). `tools` feeds only the band shadow check; `envFacts` only the advertised scratchpad; `planFile` only the
95
+ * advertised session plan file; `retainBackgroundProcesses` only the band's retain lane (Bash's lifetime sentence + row stamp). */
96
+ spec: Pick<TaskSpec, "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "planFile" | "handsReadOnly" | "readDenyPatterns" | "readFace" | "writeFace" | "oneShot" | "resumeAt" | "retainBackgroundProcesses" | "sessionId" | "tools" | "excludeAllTools">;
92
97
  /** borrowed-readonly — the deployment seats this phase reads, as a Pick over the SAME deps
93
98
  * object (R-4: `deps.onError?.()` keeps its receiver; a new deps read must widen this Pick).
94
99
  * `readDenyBuiltinTiers`/`readDenyBuiltinExclude` are SNAPSHOTTED before the first await that
@@ -215,6 +220,9 @@ export interface PrepareHandsReadFaceResult {
215
220
  /** owned — the same station's pre-spawn ADMISSION, published for the P11 face that spawns a shell command
216
221
  * and mounts LATER than the band (`Monitor`): the SAME function the band's shell faces got. ⇔ a real shell. */
217
222
  shellReadAdmission: ShellReadAdmission | undefined;
223
+ /** owned — the byte floor's seat over the run's read-deny table (read-floor.ts), for the same LATER face (`Monitor`): the
224
+ * table the band's shell faces carry to the environment on every start. ⇔ a real shell. */
225
+ shellReadFloor: ReadFloorSeat | undefined;
218
226
  /** owned — the same station's landings of a judged call (`ShellReadStation.landings`): the park binds them, the resumed leg's execution station compares. ⇔ a real shell. */
219
227
  shellReadLandings: ShellReadLandings | undefined;
220
228
  /** owned — the file read station's admission (`FileReadStation.admitted`) the band's read tools got, for the read tools mounted later (LSP). */
@@ -9,6 +9,7 @@ import { carryReadFace } from "../../tools/fs/read-deny-home.js";
9
9
  import { EMPTY_READ_ROOTS, afterCallTables, denySeatsOf, onPinnedRead, pathTablesCompile, readRootsOver } from "./person-path-rows.js";
10
10
  import { createShellOverflowSpoolFence } from "../../tools/fs/fs-shared.js";
11
11
  import { createShellReadStation } from "../../tools/fs/shell-read-check.js";
12
+ import { readFloorSeat } from "../../tools/fs/read-floor.js";
12
13
  import { createFileReadStation } from "../../tools/fs/file-read-check.js";
13
14
  import { isShellFaceToolName, predictMountedToolNames, readTargetToolNames } from "../tool-registry.js";
14
15
  import { normalizeFileText } from "../../tools/fs/encoding.js";
@@ -86,6 +87,7 @@ export function resolveHandsLessReadFace(input) {
86
87
  shellReadCheck: undefined,
87
88
  shellReadStationArmed: false,
88
89
  shellReadAdmission: undefined,
90
+ shellReadFloor: undefined,
89
91
  shellReadLandings: undefined,
90
92
  readAdmission: undefined,
91
93
  resolvedReadFace: undefined,
@@ -122,6 +124,7 @@ export async function prepareHandsMount(input) {
122
124
  let rebaseWsPath = (p) => p;
123
125
  let backgroundTaskToolsActive = false;
124
126
  let shellReadStation;
127
+ let shellReadFloor;
125
128
  let shellReadTools = new Set();
126
129
  let fileReadStation;
127
130
  let resolvedReadFace;
@@ -172,6 +175,8 @@ export async function prepareHandsMount(input) {
172
175
  if (advertisedWritableDirs !== undefined) {
173
176
  if (spec.envFacts?.scratchpadDir)
174
177
  await advertisedWritableDirs.admit({ path: spec.envFacts.scratchpadDir, advertiser: "scratchpad", materializeMarker: ".sema-scratchpad" });
178
+ if (spec.planFile !== undefined)
179
+ await advertisedWritableDirs.admitPlanFile(spec.planFile);
175
180
  additionalRootsCanonical.push(...advertisedWritableDirs.roots);
176
181
  }
177
182
  for (const a of [additionalRootsCanonical, additionalReadRootsCanonical])
@@ -294,7 +299,7 @@ export async function prepareHandsMount(input) {
294
299
  ...denySeat,
295
300
  ...writeDenySeat,
296
301
  ...(input.personRows.unreadFor(toolCallId) ? { unreadPartitions: true } : {}),
297
- writeRoots: [rootCanonical, ...additionalRootsCanonical],
302
+ writeRoots: [input.writeLocation(), ...additionalRootsCanonical],
298
303
  ...(resolvedWriteFace !== undefined ? { writeFace: resolvedWriteFace.inForce() } : {}),
299
304
  ...((judge) => (judge !== undefined ? { writeTargetJudge: judge } : {}))(input.writeTargetJudge?.()),
300
305
  ...(resolvedReadFace !== undefined ? { face: resolvedReadFace } : {}),
@@ -309,6 +314,7 @@ export async function prepareHandsMount(input) {
309
314
  return { roots: [rootCanonical, ...readRoots.forCall(toolCallId)()], cwd: rootCanonical, ...denySeat, ...writeDenySeat, ...(input.personRows.unreadFor(toolCallId) ? { unreadPartitions: true } : {}), alsoInside: spoolFence };
310
315
  };
311
316
  shellReadTools = new Set(shellFaceHere);
317
+ shellReadFloor = readFloorSeat(tables.readDeny);
312
318
  shellReadStation = createShellReadStation({
313
319
  env: executionEnv,
314
320
  tools: shellReadTools,
@@ -334,6 +340,7 @@ export async function prepareHandsMount(input) {
334
340
  }
335
341
  const band = createHandsToolkit(executionEnv, readFileState, rootCanonical, {
336
342
  ...(additionalRootsCanonical.length > 0 ? { additionalRoots: additionalRootsCanonical } : {}),
343
+ writeRoot: input.writeLocation,
337
344
  readDenyHomes: carryReadFace([], { readDeny: tables.readDeny, writeDeny: tables.writeDeny, readRoots }),
338
345
  readFace: liveReadFace,
339
346
  writeFaceLive: resolvedWriteFace.inForce,
@@ -412,6 +419,7 @@ export async function prepareHandsMount(input) {
412
419
  shellReadCheck: onPinnedRead(input.personRows, [...(shellReadStation !== undefined ? [{ check: shellReadStation.check, tools: shellReadTools }] : []), ...(fileReadStation !== undefined ? [fileReadStation] : [])]),
413
420
  shellReadStationArmed: shellReadStation !== undefined,
414
421
  shellReadAdmission: shellReadStation?.admit,
422
+ shellReadFloor,
415
423
  shellReadLandings: shellReadStation?.landings,
416
424
  readAdmission: fileReadStation?.admitted,
417
425
  resolvedReadFace,
@@ -137,9 +137,7 @@ export interface PrepareInheritedGateInput {
137
137
  /** borrowed-readonly — the worktree-isolation helper (ctx seat; absent ⇒ no key). */
138
138
  worktreeIsolation: SubagentWorktreeIsolation | undefined;
139
139
  /** borrowed-readonly — the three run-ref primitives the ctx exposes (plan mode only under `enablePlanMode`). */
140
- requestReview: (opts?: {
141
- reason?: string;
142
- }) => void;
140
+ requestReview: (opts?: import("../present-plan-tool.js").ReviewRequest) => void;
143
141
  /** borrowed-readonly — see `requestReview`. */
144
142
  requestStopAfterTurn: () => void;
145
143
  /** borrowed-readonly — see `requestReview`; a steer of the leg's mode seat into `plan`. */
@@ -138,37 +138,21 @@ export function prepareInheritedGate(input) {
138
138
  const contentMandate = input.runtimeCaps()?.forceDurableGate === true ||
139
139
  (spec.durableApproval !== undefined && !isLiveQuestionFace(frozenOnQuestion));
140
140
  const ownInstallation = { chain: input.ownModChain, onAsk: frozenOnAsk, durableMandate, contentMandate, hookEnv: hookEnvSource, decider: autoModeDecider };
141
+ const regime = {
142
+ ...(frozenOnAsk !== undefined ? { onAsk: frozenOnAsk } : {}),
143
+ ...(durableMandate ? { durableMandate: true } : {}),
144
+ ...(contentMandate ? { contentMandate: true } : {}),
145
+ ...(autoModeDecider !== undefined
146
+ ? { autoMode: { decider: autoModeDecider, ...(autoModeDenialTracking !== undefined ? { denialTracking: autoModeDenialTracking } : {}), ...(autoModeArming !== undefined ? { arming: autoModeArming } : {}), liveMode: legModeCeiling } }
147
+ : {}),
148
+ };
141
149
  const hookConstraint = chainJudges(input.modBus) && !(inheritedParentConstraints ?? []).some((pc) => sameInstallation(pc, ownInstallation))
142
- ? [
143
- {
144
- policy: createPreToolUseConstraintPolicy(input.modBus, input.hookEnvFace()),
145
- mods: input.ownModChain,
146
- ...(hookEnvSource !== undefined ? { hookEnv: hookEnvSource } : {}),
147
- ...(frozenOnAsk !== undefined ? { onAsk: frozenOnAsk } : {}),
148
- ...(durableMandate ? { durableMandate: true } : {}),
149
- ...(contentMandate ? { contentMandate: true } : {}),
150
- ...(autoModeDecider !== undefined
151
- ? { autoMode: { decider: autoModeDecider, ...(autoModeDenialTracking !== undefined ? { denialTracking: autoModeDenialTracking } : {}), ...(autoModeArming !== undefined ? { arming: autoModeArming } : {}), liveMode: legModeCeiling } }
152
- : {}),
153
- },
154
- ]
150
+ ? [{ policy: createPreToolUseConstraintPolicy(input.modBus, input.hookEnvFace()), mods: input.ownModChain, ...(hookEnvSource !== undefined ? { hookEnv: hookEnvSource } : {}), ...regime }]
155
151
  : [];
156
152
  const parentConstraints = [
157
153
  ...(inheritedParentConstraints ?? []),
158
154
  ...hookConstraint,
159
- ...(ownCallerPolicy !== undefined
160
- ? [
161
- {
162
- policy: ownCallerPolicy,
163
- ...(frozenOnAsk !== undefined ? { onAsk: frozenOnAsk } : {}),
164
- ...(durableMandate ? { durableMandate: true } : {}),
165
- ...(contentMandate ? { contentMandate: true } : {}),
166
- ...(autoModeDecider !== undefined
167
- ? { autoMode: { decider: autoModeDecider, ...(autoModeDenialTracking !== undefined ? { denialTracking: autoModeDenialTracking } : {}), ...(autoModeArming !== undefined ? { arming: autoModeArming } : {}), liveMode: legModeCeiling } }
168
- : {}),
169
- },
170
- ]
171
- : []),
155
+ ...(ownCallerPolicy !== undefined ? [{ policy: ownCallerPolicy, ...regime }] : []),
172
156
  ];
173
157
  return {
174
158
  ...(ancestorRules.length > 0 ? { ancestorRules } : {}),
@@ -290,7 +274,10 @@ export function prepareInheritedGate(input) {
290
274
  ...(internals?.insideFork === true ? { insideFork: true } : {}),
291
275
  ...(agentForkDenial !== undefined ? { forkAccess: { denied: agentForkDenial } } : {}),
292
276
  ...(observersActive ? { observersAllowed: true } : {}),
293
- requestReview,
277
+ requestReview: (opts) => requestReview({
278
+ ...(opts?.reason !== undefined ? { reason: opts.reason } : {}),
279
+ ...(ctx.reviveClaim === undefined && typeof ctx.toolCallId === "string" && ctx.toolCallId !== "" ? { requestedByCallId: ctx.toolCallId } : {}),
280
+ }),
294
281
  requestStopAfterTurn,
295
282
  ...(spec.enablePlanMode === true ? { enterPlanMode } : {}),
296
283
  };
@@ -1,5 +1,6 @@
1
1
  import type { BeforeWriteHook, EffectiveMemoryScopes, RunnerDeps, TaskSpec, ToolSpec } from "../types.js";
2
2
  import { type CaptureEntitlementInput, type MemoryCapturePosture } from "./memory-capture-optout.js";
3
+ import { type SessionProjectVerdict } from "../memory-engine/scope-contract.js";
3
4
  import type { Prepared } from "./contracts.js";
4
5
  import type { AdvertisedWritableDirs } from "./advertised-writable-dirs.js";
5
6
  export interface PrepareMemoryInput {
@@ -18,6 +19,8 @@ export interface PrepareMemoryInput {
18
19
  /** borrowed-readonly — the resolved task root: the containment boundary every derived memory dir
19
20
  * is checked against, and the repo-root fallback when `deps.rootPath` is unset. */
20
21
  taskRootPath: string;
22
+ /** borrowed-readonly — the leg's ONE project verdict (`resolveSessionProject`, read here, never re-resolved). */
23
+ sessionProject: SessionProjectVerdict;
21
24
  /**
22
25
  * borrowed-readonly — #181-F5: whether a tool NAMED `Write` (the tool the CC `# Memory` instruction names) is on the
23
26
  * ASSEMBLED roster this run, not excluded, AND can actually REACH the host-side memory root: