@sema-agent/core 7.61.0 → 7.63.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 (298) hide show
  1. package/CHANGELOG.md +840 -0
  2. package/dist/agents/cascade.d.ts +11 -3
  3. package/dist/agents/cascade.js +1 -1
  4. package/dist/agents/peer-held-queue.d.ts +27 -4
  5. package/dist/agents/peer-held-queue.js +81 -36
  6. package/dist/agents/peer-session-drain.js +13 -3
  7. package/dist/agents/subagent-transcript-placement.d.ts +23 -0
  8. package/dist/agents/subagent-transcript-placement.js +14 -0
  9. package/dist/agents/subagent.d.ts +6 -1
  10. package/dist/agents/subagent.js +143 -58
  11. package/dist/agents/suspend-guard.d.ts +38 -16
  12. package/dist/agents/suspend-guard.js +9 -4
  13. package/dist/agents/verify.js +4 -3
  14. package/dist/brain/route-adjudicator.js +9 -4
  15. package/dist/core/approval-object.js +1 -1
  16. package/dist/core/arg-summary.js +1 -1
  17. package/dist/core/ask-question.d.ts +2 -2
  18. package/dist/core/canonical-json.d.ts +23 -13
  19. package/dist/core/canonical-json.js +4 -4
  20. package/dist/core/checkpoint-features.d.ts +722 -0
  21. package/dist/core/checkpoint-features.js +98 -0
  22. package/dist/core/checkpoint-queries.d.ts +47 -4
  23. package/dist/core/checkpoint-queries.js +36 -16
  24. package/dist/core/checkpoint-requirements.d.ts +12 -5
  25. package/dist/core/checkpoint-requirements.js +11 -5
  26. package/dist/core/checkpoint-row-verdict.d.ts +110 -0
  27. package/dist/core/checkpoint-row-verdict.js +245 -0
  28. package/dist/core/checkpoint-store.d.ts +76 -753
  29. package/dist/core/checkpoint-store.js +83 -144
  30. package/dist/core/compliance.d.ts +6 -2
  31. package/dist/core/compliance.js +3 -3
  32. package/dist/core/engine-attestation.d.ts +1 -1
  33. package/dist/core/engine-notice.d.ts +38 -7
  34. package/dist/core/engine-notice.js +9 -2
  35. package/dist/core/gate-fold.js +2 -2
  36. package/dist/core/git-worktree-env.d.ts +62 -3
  37. package/dist/core/git-worktree-env.js +91 -30
  38. package/dist/core/governance-codes.d.ts +9 -3
  39. package/dist/core/governance-codes.js +16 -3
  40. package/dist/core/hooks.d.ts +13 -0
  41. package/dist/core/human-input-projection.d.ts +1 -0
  42. package/dist/core/human-input-projection.js +3 -0
  43. package/dist/core/image-admission.d.ts +1 -1
  44. package/dist/core/locked-config.d.ts +2 -2
  45. package/dist/core/mcp-host-seat.js +6 -1
  46. package/dist/core/memory-engine/consolidation-driver.d.ts +33 -18
  47. package/dist/core/memory-engine/consolidation-driver.js +99 -98
  48. package/dist/core/memory-engine/consolidation.d.ts +73 -10
  49. package/dist/core/memory-engine/consolidation.js +167 -11
  50. package/dist/core/memory-engine/data-plane.d.ts +8 -4
  51. package/dist/core/memory-engine/data-plane.js +11 -6
  52. package/dist/core/memory-engine/delegation-settlement.d.ts +37 -35
  53. package/dist/core/memory-engine/delegation-settlement.js +53 -59
  54. package/dist/core/memory-engine/dual-root.d.ts +12 -6
  55. package/dist/core/memory-engine/dual-root.js +9 -5
  56. package/dist/core/memory-engine/engine.d.ts +98 -35
  57. package/dist/core/memory-engine/engine.js +477 -380
  58. package/dist/core/memory-engine/entry-scan.d.ts +8 -0
  59. package/dist/core/memory-engine/entry-scan.js +3 -0
  60. package/dist/core/memory-engine/file-backend.d.ts +29 -3
  61. package/dist/core/memory-engine/file-backend.js +66 -35
  62. package/dist/core/memory-engine/index.d.ts +7 -7
  63. package/dist/core/memory-engine/index.js +6 -6
  64. package/dist/core/memory-engine/landing-admission.d.ts +5 -3
  65. package/dist/core/memory-engine/landing-admission.js +3 -3
  66. package/dist/core/memory-engine/layout.d.ts +121 -45
  67. package/dist/core/memory-engine/layout.js +252 -102
  68. package/dist/core/memory-engine/memory-backend-contract.d.ts +19 -1
  69. package/dist/core/memory-engine/memory-backend-contract.js +320 -0
  70. package/dist/core/memory-engine/memory-deployment.d.ts +31 -8
  71. package/dist/core/memory-engine/memory-deployment.js +26 -12
  72. package/dist/core/memory-engine/scope-contract.d.ts +52 -11
  73. package/dist/core/memory-engine/scope-contract.js +68 -19
  74. package/dist/core/memory-engine/session-write-home.d.ts +3 -1
  75. package/dist/core/memory-engine/session-write-home.js +1 -1
  76. package/dist/core/memory-engine/sync-client.d.ts +3 -1
  77. package/dist/core/memory-engine/sync-client.js +7 -0
  78. package/dist/core/memory-engine/sync-report.d.ts +3 -2
  79. package/dist/core/memory-engine/sync-report.js +6 -2
  80. package/dist/core/memory-engine/tools.d.ts +2 -2
  81. package/dist/core/memory-engine/tools.js +10 -10
  82. package/dist/core/memory-engine/types.d.ts +118 -19
  83. package/dist/core/memory-engine/types.js +1 -0
  84. package/dist/core/memory-vector.d.ts +1 -1
  85. package/dist/core/memory.d.ts +10 -10
  86. package/dist/core/memory.js +15 -6
  87. package/dist/core/mode-policy.js +1 -1
  88. package/dist/core/mods/classic-events.d.ts +9 -1
  89. package/dist/core/mods/dollar.d.ts +32 -1
  90. package/dist/core/mods/dollar.js +13 -1
  91. package/dist/core/mods/kernel/events.d.ts +11 -3
  92. package/dist/core/mods/kernel/events.js +13 -10
  93. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  94. package/dist/core/mods/lifecycle-stations.js +44 -9
  95. package/dist/core/mods/session-append.d.ts +4 -1
  96. package/dist/core/mods/session-append.js +7 -0
  97. package/dist/core/mods/session-receive.js +12 -15
  98. package/dist/core/mods/stations.d.ts +70 -6
  99. package/dist/core/mods/stations.js +144 -1
  100. package/dist/core/own-property-receipt.d.ts +7 -0
  101. package/dist/core/own-property-receipt.js +3 -0
  102. package/dist/core/park-selfcheck.js +2 -2
  103. package/dist/core/pause-registry.d.ts +2 -0
  104. package/dist/core/pause-registry.js +3 -0
  105. package/dist/core/permission-rule-consent.d.ts +10 -3
  106. package/dist/core/permission-rule-consent.js +37 -24
  107. package/dist/core/permission-rule-store.d.ts +35 -1
  108. package/dist/core/permission-rule-store.js +27 -8
  109. package/dist/core/read-only-shell.js +3 -2
  110. package/dist/core/read-root-candidate.js +1 -1
  111. package/dist/core/redaction-marks.d.ts +8 -0
  112. package/dist/core/redaction-marks.js +6 -0
  113. package/dist/core/remote-env.d.ts +12 -1
  114. package/dist/core/remote-env.js +3 -0
  115. package/dist/core/resume-startup-cause.d.ts +5 -4
  116. package/dist/core/runner/child-tree.d.ts +29 -3
  117. package/dist/core/runner/child-tree.js +39 -16
  118. package/dist/core/runner/compact-session.js +5 -2
  119. package/dist/core/runner/contracts.d.ts +36 -17
  120. package/dist/core/runner/delegation-owner.d.ts +43 -0
  121. package/dist/core/runner/delegation-owner.js +59 -0
  122. package/dist/core/runner/gate-exit.js +2 -2
  123. package/dist/core/runner/inherited-ask-grants.js +1 -1
  124. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  125. package/dist/core/runner/lineage-reroot-view.js +108 -0
  126. package/dist/core/runner/memory-consolidation-driver.d.ts +6 -3
  127. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  128. package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
  129. package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
  130. package/dist/core/runner/permission-rule-lanes.d.ts +2 -1
  131. package/dist/core/runner/permission-rule-lanes.js +2 -2
  132. package/dist/core/runner/person-path-rows.d.ts +23 -3
  133. package/dist/core/runner/person-path-rows.js +31 -4
  134. package/dist/core/runner/placement-fence.d.ts +12 -0
  135. package/dist/core/runner/placement-fence.js +20 -6
  136. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  137. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  138. package/dist/core/runner/prepare-ask-lane.js +2 -2
  139. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -1
  140. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  141. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  142. package/dist/core/runner/prepare-config-doors.js +3 -4
  143. package/dist/core/runner/prepare-execution-env.js +17 -6
  144. package/dist/core/runner/prepare-hands-readface.d.ts +3 -2
  145. package/dist/core/runner/prepare-hands-readface.js +32 -10
  146. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -8
  147. package/dist/core/runner/prepare-inherited-gate.js +14 -6
  148. package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
  149. package/dist/core/runner/prepare-memory-engine-session.js +4 -4
  150. package/dist/core/runner/prepare-memory.d.ts +3 -2
  151. package/dist/core/runner/prepare-memory.js +28 -20
  152. package/dist/core/runner/prepare-park-ask.js +4 -3
  153. package/dist/core/runner/prepare-task.js +22 -16
  154. package/dist/core/runner/prepare-workspace-restore.js +3 -6
  155. package/dist/core/runner/resume-admission.d.ts +3 -3
  156. package/dist/core/runner/resume-admission.js +6 -3
  157. package/dist/core/runner/resume-apply.d.ts +4 -0
  158. package/dist/core/runner/resume-apply.js +11 -4
  159. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  160. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  161. package/dist/core/runner/run-git-lane.d.ts +2 -0
  162. package/dist/core/runner/run-git-lane.js +4 -1
  163. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  164. package/dist/core/runner/run-harness-handlers.js +3 -2
  165. package/dist/core/runner/run-leg.js +25 -8
  166. package/dist/core/runner/run-settle-and-teardown.js +6 -4
  167. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  168. package/dist/core/runner/run-turn-boundary.js +7 -4
  169. package/dist/core/runner/runtask.js +6 -6
  170. package/dist/core/runner/steering-preview.d.ts +9 -0
  171. package/dist/core/runner/steering-preview.js +5 -0
  172. package/dist/core/runner/stream-steer-verb.js +8 -0
  173. package/dist/core/runner/terminal-account.js +1 -1
  174. package/dist/core/runner/tool-face-overlay.js +2 -0
  175. package/dist/core/runner/turn-attachments.d.ts +5 -0
  176. package/dist/core/runner/turn-attachments.js +1 -1
  177. package/dist/core/runner-deps.d.ts +8 -4
  178. package/dist/core/secret-env.d.ts +9 -6
  179. package/dist/core/secret-env.js +41 -22
  180. package/dist/core/session-checkout.d.ts +108 -0
  181. package/dist/core/session-checkout.js +485 -0
  182. package/dist/core/session-store.d.ts +13 -5
  183. package/dist/core/session-store.js +28 -4
  184. package/dist/core/session.d.ts +29 -5
  185. package/dist/core/session.js +3 -0
  186. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +6 -12
  187. package/dist/core/store-contracts/checkpoint-store-contract.js +73 -6
  188. package/dist/core/store-contracts/session-store-contract.js +61 -8
  189. package/dist/core/task-event.d.ts +28 -1
  190. package/dist/core/task-notification.d.ts +9 -1
  191. package/dist/core/task-notification.js +8 -1
  192. package/dist/core/task-registry-agent.d.ts +40 -8
  193. package/dist/core/task-registry-agent.js +57 -24
  194. package/dist/core/task-registry-shared.d.ts +33 -11
  195. package/dist/core/task-registry-workflow.js +4 -3
  196. package/dist/core/task-registry.d.ts +27 -10
  197. package/dist/core/task-registry.js +19 -13
  198. package/dist/core/task-result.d.ts +5 -5
  199. package/dist/core/task-spec-members.js +1 -1
  200. package/dist/core/task-spec.d.ts +21 -1
  201. package/dist/core/terminal-cause.d.ts +6 -6
  202. package/dist/core/tool-face.d.ts +6 -2
  203. package/dist/core/tool-face.js +1 -1
  204. package/dist/core/tool-policy.d.ts +16 -13
  205. package/dist/core/tool-policy.js +11 -10
  206. package/dist/core/tool-roster.d.ts +4 -4
  207. package/dist/core/tool-spec.d.ts +42 -19
  208. package/dist/core/types.d.ts +2 -2
  209. package/dist/core/types.js +1 -1
  210. package/dist/core/untrusted-egress.d.ts +15 -4
  211. package/dist/core/untrusted-egress.js +23 -22
  212. package/dist/core/workspace-snapshot.d.ts +3 -1
  213. package/dist/core/workspace-snapshot.js +1 -0
  214. package/dist/engine/execution-env/node-execution-env.d.ts +3 -0
  215. package/dist/engine/execution-env/node-execution-env.js +12 -5
  216. package/dist/engine/harness/types.d.ts +77 -1
  217. package/dist/engine/harness/types.js +108 -0
  218. package/dist/engine/session/import-validate.js +6 -1
  219. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  220. package/dist/engine/session/parent-chain-guard.js +1 -1
  221. package/dist/engine/session/path-to-root.d.ts +18 -3
  222. package/dist/engine/session/path-to-root.js +15 -1
  223. package/dist/engine/session/repo-utils.d.ts +12 -1
  224. package/dist/engine/session/repo-utils.js +41 -0
  225. package/dist/engine/session/session.d.ts +24 -1
  226. package/dist/engine/session/session.js +46 -2
  227. package/dist/engine/session/storage-base.d.ts +20 -0
  228. package/dist/engine/session/storage-base.js +28 -9
  229. package/dist/index.d.ts +16 -12
  230. package/dist/index.js +11 -8
  231. package/dist/internal/harness-types.d.ts +1 -1
  232. package/dist/internal/harness.d.ts +4 -3
  233. package/dist/internal/harness.js +3 -2
  234. package/dist/orchestration/run-workflow-tool.d.ts +7 -1
  235. package/dist/orchestration/run-workflow-tool.js +28 -11
  236. package/dist/orchestration/workflow-governance.d.ts +1 -1
  237. package/dist/orchestration/workflow.d.ts +6 -0
  238. package/dist/orchestration/workflow.js +5 -8
  239. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  240. package/dist/stores/file/checkpoint-store.js +7 -6
  241. package/dist/stores/file/fs-atomic.d.ts +0 -22
  242. package/dist/stores/file/fs-atomic.js +0 -17
  243. package/dist/stores/file/index.d.ts +2 -9
  244. package/dist/stores/file/index.js +2 -4
  245. package/dist/stores/file/session-store.d.ts +13 -7
  246. package/dist/stores/file/session-store.js +42 -18
  247. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  248. package/dist/tools/fs/bash-program-position.js +10 -10
  249. package/dist/tools/fs/program-read-model.d.ts +34 -10
  250. package/dist/tools/fs/program-read-model.js +37 -7
  251. package/dist/tools/fs/program-read-model.rows.js +13 -2
  252. package/dist/tools/fs/read-deny.d.ts +13 -1
  253. package/dist/tools/fs/read-deny.js +10 -2
  254. package/dist/tools/fs/removal-targets.js +5 -5
  255. package/dist/tools/fs/safety.d.ts +2 -0
  256. package/dist/tools/fs/safety.js +1 -1
  257. package/dist/tools/fs/shell-read-argv.d.ts +11 -2
  258. package/dist/tools/fs/shell-read-argv.js +45 -29
  259. package/dist/tools/fs/shell-read-bindings.d.ts +20 -2
  260. package/dist/tools/fs/shell-read-bindings.js +153 -69
  261. package/dist/tools/fs/shell-read-brace.d.ts +18 -0
  262. package/dist/tools/fs/shell-read-brace.js +79 -0
  263. package/dist/tools/fs/shell-read-check.js +29 -11
  264. package/dist/tools/fs/shell-read-establish.js +43 -22
  265. package/dist/tools/fs/shell-read-functions.js +2 -2
  266. package/dist/tools/fs/shell-read-judge.d.ts +11 -0
  267. package/dist/tools/fs/shell-read-judge.js +3 -3
  268. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  269. package/dist/tools/fs/shell-read-object-path.js +119 -0
  270. package/dist/tools/fs/shell-read-plan.d.ts +18 -0
  271. package/dist/tools/fs/shell-read-plan.js +217 -104
  272. package/dist/tools/fs/shell-read-start.d.ts +76 -13
  273. package/dist/tools/fs/shell-read-start.js +97 -17
  274. package/dist/tools/fs/shell-read-word.d.ts +10 -0
  275. package/dist/tools/fs/shell-read-word.js +9 -5
  276. package/dist/tools/fs/shell-read-workdir.d.ts +54 -14
  277. package/dist/tools/fs/shell-read-workdir.js +103 -19
  278. package/dist/tools/fs/shell-read-write-targets.js +13 -8
  279. package/dist/tools/worktree.d.ts +3 -2
  280. package/dist/tools/worktree.js +7 -35
  281. package/package.json +3 -2
  282. package/test/export-surface.snapshot.json +93 -43
  283. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  284. package/wire-changes/core-stores-sql@7.63.0.json +30 -0
  285. package/wire-changes/core@7.62.0.json +2181 -0
  286. package/wire-changes/core@7.63.0.json +3523 -0
  287. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  288. package/wire-changes/mods-kernel@7.63.0.json +30 -0
  289. package/wire-changes/primitives@7.62.0.json +30 -0
  290. package/wire-changes/primitives@7.63.0.json +445 -0
  291. package/dist/core/consolidate-scope.d.ts +0 -93
  292. package/dist/core/consolidate-scope.js +0 -98
  293. package/dist/core/credential-vocabulary.d.ts +0 -176
  294. package/dist/core/credential-vocabulary.js +0 -190
  295. package/dist/core/redaction-passes.d.ts +0 -82
  296. package/dist/core/redaction-passes.js +0 -377
  297. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  298. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -1,22 +1,23 @@
1
- import { principalNameOf } from "../principal-name.js";
1
+ import { delegationOwnerUnbound } from "./delegation-owner.js";
2
2
  import { forkGovernanceDenial, resolveDelegationEntryCaps } from "../../agents/subagent.js";
3
3
  import { isLiveQuestionFace } from "../ask-question.js";
4
4
  import { parentSpecSeatOf } from "../parent-spec-seat.js";
5
5
  import { chainJudges, sameInstallation } from "../mods/stations.js";
6
6
  import { childClampSeats, clampSourceOf } from "../child-clamp-seats.js";
7
7
  import { rowFollowsFloor } from "./session-rule-policy.js";
8
+ import { declaresSubagentPlacement } from "../session.js";
8
9
  import { performsIo } from "../remote-env.js";
9
10
  import { durableMandateSourceOf } from "../tool-policy.js";
10
11
  import { chainAnchorRecords } from "./child-tree.js";
11
12
  import { deliverEngineNotice } from "../types.js";
12
13
  import { PermissionModeController, autoModeFaceOf, modeRequestAfterResume } from "../mode-policy.js";
13
14
  import { SessionModeSeats } from "./session-mode-seats.js";
14
- import { recordedModeSeed } from "../checkpoint-store.js";
15
+ import { recordedModeSeed } from "../checkpoint-row-verdict.js";
15
16
  import { frozenSkillGrants } from "../skill-grant.js";
16
17
  import { attachRebuiltDenialTrackers, createDenialLimitStop } from "./denial-limit-arms.js";
17
18
  import { valveLeaves } from "../../agents/tool-filter.js";
18
19
  export function prepareInheritedGate(input) {
19
- const { spec, deps, askSeat, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, executionEnv, ownedEnv, lockedPreflight, pathRuleAnchors, toolFaceSnapshot, mountsCallerTool, promptLean, resolvedInteractionPosture, permissionModeSeat, handsEnabled, reportUsage, harnessRef, skillGrants, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun } = input;
20
+ const { spec, deps, askSeat, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, delegationCwd, executionEnv, ownedEnv, lockedPreflight, pathRuleAnchors, toolFaceSnapshot, mountsCallerTool, promptLean, resolvedInteractionPosture, permissionModeSeat, handsEnabled, reportUsage, harnessRef, skillGrants, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun } = input;
20
21
  const liveInheritedGate = internals?.inheritedGate;
21
22
  const seedInheritedGate = resume?.seed.inheritedGate;
22
23
  const inheritedAncestorRules = (() => {
@@ -227,7 +228,10 @@ export function prepareInheritedGate(input) {
227
228
  return [...(internals?.memoryCaptureAncestors ?? []), { sessionId, ...(ctl !== undefined ? { controlDir: ctl } : {}) }];
228
229
  },
229
230
  getApiKeyAndHeaders: spec.getApiKeyAndHeaders,
230
- parentCwd: taskRootFinal,
231
+ get parentCwd() {
232
+ return delegationCwd();
233
+ },
234
+ callerRoot: taskRootFinal,
231
235
  ...(input.ownTarget !== undefined ? { placementTarget: input.ownTarget } : {}),
232
236
  ...(input.hostFloor !== undefined ? { hostFloor: input.hostFloor } : {}),
233
237
  ...(fileHistoryEnabled ? { fileHistoryLineage: { scope: historyScope, root: historyRoot, fs: historyFs } } : {}),
@@ -249,14 +253,18 @@ export function prepareInheritedGate(input) {
249
253
  ...(internals?.parentTaskId !== undefined ? { parentTaskId: internals.parentTaskId } : {}),
250
254
  ...(internals?.parentSessionId !== undefined ? { parentSessionId: internals.parentSessionId } : {}),
251
255
  ...(internals?.rootSessionId !== undefined ? { rootSessionId: internals.rootSessionId } : {}), ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}),
256
+ delegationOwner: input.delegationOwner,
252
257
  ...(internals?.explicitAgentName !== undefined ? { spawnedAgentName: internals.explicitAgentName } : {}),
253
258
  ...(internals?.peerSelfRef !== undefined ? { peerSelfRef: internals.peerSelfRef } : {}),
254
259
  ...(internals?.peerInboundChainRef !== undefined ? { peerInboundChainRef: internals.peerInboundChainRef } : {}),
255
260
  ...(deps.rosterStore !== undefined ? { roster: deps.rosterStore } : {}),
256
261
  ...(sessions.fork !== undefined
257
262
  ? {
258
- hostSessionFork: async () => {
259
- const forked = (await sessions.fork(sessionId, principalNameOf(spec.principal) ?? null)) ?? null;
263
+ hostSessionFork: async (forkOpts) => {
264
+ const tree = await input.delegationOwner.read();
265
+ if (!tree.bound)
266
+ throw delegationOwnerUnbound(tree.reason);
267
+ const forked = (await sessions.fork(sessionId, tree.owner, forkOpts !== undefined && declaresSubagentPlacement(sessions) ? forkOpts : undefined)) ?? null;
260
268
  if (forked === null)
261
269
  return null;
262
270
  return {
@@ -17,6 +17,7 @@ import type { LockedPreflight } from "../locked-config.js";
17
17
  import { type DelegationContentSafety } from "../memory-engine/delegation-provenance.js";
18
18
  import type { RunnerDeps, TaskSpec } from "../types.js";
19
19
  import type { Prepared, RunInternals } from "./contracts.js";
20
+ import type { DelegationSettlementSeat } from "../tool-spec.js";
20
21
  import { RosterBuilder } from "../tool-roster.js";
21
22
  export interface PrepareMemoryEngineSessionInput {
22
23
  /** borrowed-readonly — the mounted engine session, or undefined (the ARMING fact's first half). Read: `pollution`
@@ -50,10 +51,7 @@ export interface PrepareMemoryEngineSessionInput {
50
51
  /** borrowed-mutable — the children's settlement seat (the inherited-gate phase mints it). Writer: THIS phase, once at
51
52
  * arming, when the memory session mounted a settlement (memoryProvenance "carry"). */
52
53
  delegationSettlementRef: {
53
- current?: {
54
- controlDir: string;
55
- sessionId: string;
56
- };
54
+ current?: DelegationSettlementSeat;
57
55
  };
58
56
  /** borrowed-readonly — the REBOUND spec; only `tools` (the RAW caller specs: caller-tool names and the marker-bearing
59
57
  * delegation entries — the assembled roster objects carry neither marker). Never mutated. */
@@ -30,7 +30,7 @@ export function prepareMemoryEngineSession(input) {
30
30
  onNotice: deps.onNotice,
31
31
  });
32
32
  if (memoryEngineSession?.settlement !== undefined) {
33
- delegationSettlementRef.current = { controlDir: memoryEngineSession.settlement.controlDir, sessionId: memoryEngineSession.settlement.sessionId };
33
+ delegationSettlementRef.current = { governance: memoryEngineSession.settlement.governance, controlDir: memoryEngineSession.settlement.controlDir, sessionId: memoryEngineSession.settlement.sessionId };
34
34
  }
35
35
  const recordExternal = () => {
36
36
  if (delegationProvenanceChannel !== undefined)
@@ -118,7 +118,7 @@ export function prepareMemoryEngineSession(input) {
118
118
  let preCallLaunchRows;
119
119
  if (delegationEvidenceAttestedOnly && memoryEngineSession?.settlement !== undefined) {
120
120
  try {
121
- preCallLaunchRows = new Set(sessionSettlements(memoryEngineSession.settlement.controlDir, memoryEngineSession.settlement.sessionId)
121
+ preCallLaunchRows = new Set((await sessionSettlements(memoryEngineSession.settlement.governance, memoryEngineSession.settlement.sessionId))
122
122
  .filter((r) => r.row.lane === "background" && r.row.toolUseId === toolCallId)
123
123
  .map((r) => r.row.settleId));
124
124
  }
@@ -165,7 +165,7 @@ export function prepareMemoryEngineSession(input) {
165
165
  preCallLaunchRows !== undefined &&
166
166
  claimedSettleId !== undefined &&
167
167
  !preCallLaunchRows.has(claimedSettleId) &&
168
- sessionSettlements(settlementSeat.controlDir, settlementSeat.sessionId).some((r) => r.row.lane === "background" && r.row.settleId === claimedSettleId && r.row.toolUseId === toolCallId);
168
+ (await sessionSettlements(settlementSeat.governance, settlementSeat.sessionId)).some((r) => r.row.lane === "background" && r.row.settleId === claimedSettleId && r.row.toolUseId === toolCallId);
169
169
  }
170
170
  catch {
171
171
  isLaunchReceipt = false;
@@ -173,7 +173,7 @@ export function prepareMemoryEngineSession(input) {
173
173
  }
174
174
  if (!isLaunchReceipt && settlementSeat !== undefined) {
175
175
  try {
176
- recordSyncUnattestable(settlementSeat.controlDir, { sessionId: settlementSeat.sessionId, toolCallId, now: Date.now });
176
+ await recordSyncUnattestable(settlementSeat.governance, { sessionId: settlementSeat.sessionId, toolCallId, now: Date.now });
177
177
  }
178
178
  catch (err) {
179
179
  const e = new Error(`delegated output withheld (fail-closed): the delegation delivered without a provable attestation and the settlement account could not record the fact (${thrownText(err)}) — repair the memory control plane or retry`);
@@ -212,12 +212,13 @@ export interface PrepareMemoryResult {
212
212
  * so a hands-phase refusal cannot consume announcements a later prepare should deliver, and it takes the
213
213
  * roster-wide persistence verdict the driver can only read off the MOUNTED roster (`rosterCanPersist`: the
214
214
  * `memoryPersistenceCapable` declaration when set, else the store-path inference over the assembled tools) and
215
- * `isSubagent` (a non-fork delegated child — no user conversation, no not-mounted notice). Call once per prepare.
215
+ * `isSubagent` (a non-fork delegated child — no user conversation, no not-mounted notice). Call once per prepare;
216
+ * async because the drain goes through the engine's governance store.
216
217
  */
217
218
  composeInjection: (facts: {
218
219
  rosterCanPersist: boolean;
219
220
  isSubagent: boolean;
220
- }) => MemoryInjectionComposition;
221
+ }) => Promise<MemoryInjectionComposition>;
221
222
  /**
222
223
  * The FROZEN org-admission verdict of this prepare: every org scope the task actually mounts
223
224
  * (deployment-origin kept + request-origin admitted). Threaded into the run's child chain
@@ -4,9 +4,9 @@ import { admitMemoryScopes } from "../memory-admission.js";
4
4
  import { adoptLegacyRepoDirs, canonicalize, deriveRepoControlPlaneDir, deriveProjectControlDir, deriveProjectMemoryDir, deriveRepoKey, deriveRepoMemoryDir, effectiveControlRootOf, isContainedIn, lookupProjectIdHint, recordProjectIdHint, resolveMemoryEngineRoot, transferMemoryAnnouncements } from "../memory-engine/layout.js";
5
5
  import { derivePersonalControlDir, derivePersonalMemoryDir, directoryPinOf, memoryPlaneStore, mergeHarvestReports, mergeInjections, needsDualRoots, parsedProjectPlane, scopePlanesOf } from "../memory-engine/dual-root.js";
6
6
  import { memoryProjectScopeAbsentNotice, normalizeMemorySpec } from "../memory.js";
7
- import { deriveSupersededSet } from "../memory-engine/consolidation.js";
7
+ import { deriveSupersededSet, fileGovernanceStore } from "../memory-engine/consolidation.js";
8
8
  import { shadowNamesOf } from "../memory-engine/shadowing.js";
9
- import { MEMORY_ANNOUNCEMENT_CAPTURE_OPTOUT_CODA, MEMORY_ANNOUNCEMENT_READONLY_CODA, MEMORY_CAPTURE_OPTOUT_NOTICE, MEMORY_PREFERENCE_DISCIPLINE, MEMORY_READONLY_NOTICE, MemoryEngine, entryFileHeadCarriesOrigin, memoryCaptureOptedOutNotice, memoryCaptureOptOutUnpersistedNotice, memoryConsolidationRecommendedNotice, memoryHarvestQuarantinedNotice, memoryHoldNotices, memoryRecallDisciplineSegment, memoryRestoreWithheldNotice, memorySessionPollutedNotice, memoryUnavailableNotice, pollutionContainmentCounts, } from "../memory-engine/engine.js";
9
+ import { MEMORY_ANNOUNCEMENT_CAPTURE_OPTOUT_CODA, MEMORY_ANNOUNCEMENT_READONLY_CODA, MEMORY_CAPTURE_OPTOUT_NOTICE, MEMORY_PREFERENCE_DISCIPLINE, MEMORY_READONLY_NOTICE, MemoryEngine, entryFileHeadCarriesOrigin, memoryCaptureOptedOutNotice, memoryCaptureOptOutUnpersistedNotice, memoryConsolidationRecommendedNotice, memoryHarvestConflictNotice, memoryHarvestQuarantinedNotice, memoryHarvestRefusedNotice, memoryHoldNotices, memoryRecallDisciplineSegment, memoryRestoreWithheldNotice, memorySessionPollutedNotice, memoryUnavailableNotice, pollutionContainmentCounts, } from "../memory-engine/engine.js";
10
10
  import { adjudicateCaptureOptOut, captureOptOutDeniedError, captureOptOutUnpersistedError } from "./memory-capture-optout.js";
11
11
  import { readSessionCaptureOptOut } from "../memory-engine/layout.js";
12
12
  import { sessionIncarnationResolver } from "../memory-engine/session-incarnation.js";
@@ -129,11 +129,11 @@ export async function prepareMemory(input) {
129
129
  const firstSwitch = verdictOnPartitionRoot && lookupProjectIdHint(engineRoot, repoRoot) !== marker.projectId;
130
130
  if (verdictOnPartitionRoot)
131
131
  recordProjectIdHint(engineRoot, repoRoot, marker.projectId);
132
- if (firstSwitch) {
132
+ if (firstSwitch && backend.governance === undefined) {
133
133
  try {
134
134
  const oldCtl = deriveRepoControlPlaneDir(engineRoot, repoRoot);
135
135
  const newCtl = deriveProjectControlDir(engineRoot, marker.projectId);
136
- transferMemoryAnnouncements(oldCtl, newCtl);
136
+ await transferMemoryAnnouncements(fileGovernanceStore(oldCtl), fileGovernanceStore(newCtl));
137
137
  }
138
138
  catch (err) {
139
139
  deps.onError?.(asThrownError(err), { phase: "config", sessionId });
@@ -376,12 +376,12 @@ export async function prepareMemory(input) {
376
376
  sessionId,
377
377
  ...(m.write === null && shadowNames !== undefined && shadowNames.size > 0 ? { shadowNames } : {}),
378
378
  });
379
- openedLegs.push(() => void m.engine.endSessionLeg(handle, sessionId));
379
+ openedLegs.push(() => m.engine.endSessionLeg(handle, sessionId));
380
380
  mounted.push(handle);
381
381
  materializedResidue.push(...planeScopes(m.scopes, m.write));
382
382
  if (m.write !== null) {
383
383
  try {
384
- const withheld = new Set(m.engine.readChallengeExclusions().keys());
384
+ const withheld = new Set((await m.engine.readChallengeExclusions()).keys());
385
385
  const committed = await m.engine.listCommittedHeaders([m.write]);
386
386
  const superseded = deriveSupersededSet(committed, { excluded: (id) => withheld.has(id) });
387
387
  shadowNames = shadowNamesOf(committed, m.write, { excluded: (id) => withheld.has(id) || superseded.has(id) });
@@ -398,7 +398,7 @@ export async function prepareMemory(input) {
398
398
  writeHandle = writeIsPersonal ? personalHandle : projectHandle;
399
399
  readOnlyEngine = writeIsPersonal ? projectEngine : personalEngine;
400
400
  readOnlyHandle = writeIsPersonal ? projectHandle : personalHandle;
401
- injectFn = () => mergeInjections(projectEngine.inject(projectHandle, { writeToolMounted: writeChannelOpen, reminderMark: input.reminderMark }), personalEngine.inject(personalHandle, { writeToolMounted: writeChannelOpen, reminderMark: input.reminderMark }));
401
+ injectFn = async () => mergeInjections(await projectEngine.inject(projectHandle, { writeToolMounted: writeChannelOpen, reminderMark: input.reminderMark }), await personalEngine.inject(personalHandle, { writeToolMounted: writeChannelOpen, reminderMark: input.reminderMark }));
402
402
  toolPlanes = [
403
403
  {
404
404
  backend: retrievalBackend(backend, adoptionRestricted || captureOptedOut || captureIndeterminate || p.writePlane !== "project"),
@@ -440,7 +440,7 @@ export async function prepareMemory(input) {
440
440
  const personalEngine = personal.engine;
441
441
  await armCaptureOptOut(personalEngine);
442
442
  const handle = await personalEngine.materialize(memorySpec.scopes, memorySpec.writeScope, { adoptionRestricted: adoptionRestricted || captureOptedOut || captureIndeterminate, sessionId });
443
- openedLegs.push(() => void personalEngine.endSessionLeg(handle, sessionId));
443
+ openedLegs.push(() => personalEngine.endSessionLeg(handle, sessionId));
444
444
  materializedResidue.push(...planeScopes(memorySpec.scopes, memorySpec.writeScope));
445
445
  memoryMarkedEntriesServed = handle.markedEntriesPresent === true;
446
446
  writeEngine = personalEngine;
@@ -470,7 +470,7 @@ export async function prepareMemory(input) {
470
470
  });
471
471
  await armCaptureOptOut(engine);
472
472
  const handle = await engine.materialize(memorySpec.scopes, memorySpec.writeScope, { adoptionRestricted: adoptionRestricted || captureOptedOut || captureIndeterminate, sessionId });
473
- openedLegs.push(() => void engine.endSessionLeg(handle, sessionId));
473
+ openedLegs.push(() => engine.endSessionLeg(handle, sessionId));
474
474
  materializedResidue.push(...planeScopes(memorySpec.scopes, memorySpec.writeScope));
475
475
  memoryMarkedEntriesServed = handle.markedEntriesPresent === true;
476
476
  writeEngine = engine;
@@ -557,6 +557,12 @@ export async function prepareMemory(input) {
557
557
  }
558
558
  deliverEngineNotice(deps.onNotice, memoryHarvestQuarantinedNotice({ count, moved, escalated, ...(report.reportId !== undefined ? { reportId: report.reportId } : {}), ...(reason !== undefined ? { reason } : {}), sessionId, provenance: input.memoryProvenance, ...(indexOnly ? { indexRolledBack: true } : {}) }));
559
559
  }
560
+ const refused = memoryHarvestRefusedNotice(report, sessionId);
561
+ if (refused !== undefined)
562
+ deliverEngineNotice(deps.onNotice, refused);
563
+ const conflicted = memoryHarvestConflictNotice(report, sessionId);
564
+ if (conflicted !== undefined)
565
+ deliverEngineNotice(deps.onNotice, conflicted);
560
566
  if (report.restoreWithheld !== undefined && report.restoreWithheld.length > 0) {
561
567
  deliverEngineNotice(deps.onNotice, memoryRestoreWithheldNotice({ paths: report.restoreWithheld, sessionId }));
562
568
  }
@@ -607,11 +613,12 @@ export async function prepareMemory(input) {
607
613
  memoryEngineSession = {
608
614
  engine: writeEngine,
609
615
  handle: writeHandle,
616
+ scopeContract: memorySpec.scopeContract,
610
617
  inject: injectFn,
611
618
  harvest: harvestSafe,
612
- release: () => {
619
+ release: async () => {
613
620
  for (const end of openedLegs)
614
- end();
621
+ await end();
615
622
  },
616
623
  captureOptOut: {
617
624
  optedOut: () => {
@@ -677,11 +684,12 @@ export async function prepareMemory(input) {
677
684
  pollution: {
678
685
  polluted: () => writeEngine.sessionPollution(sessionId),
679
686
  markPolluted: (reason, cause) => {
680
- const outcome = writeEngine.markSessionPolluted(sessionId, reason, cause);
681
- if (outcome === "existed" || (outcome === "unpersisted" && pollutionAnnounced))
682
- return;
683
- pollutionAnnounced = true;
684
- deliverEngineNotice(deps.onNotice, memorySessionPollutedNotice({ reason, sessionId, provenance: input.memoryProvenance }));
687
+ void writeEngine.markSessionPolluted(sessionId, reason, cause).then((outcome) => {
688
+ if (outcome === "existed" || (outcome === "unpersisted" && pollutionAnnounced))
689
+ return;
690
+ pollutionAnnounced = true;
691
+ deliverEngineNotice(deps.onNotice, memorySessionPollutedNotice({ reason, sessionId, provenance: input.memoryProvenance }));
692
+ });
685
693
  },
686
694
  },
687
695
  contentSafety: {
@@ -689,7 +697,7 @@ export async function prepareMemory(input) {
689
697
  execIsExternalContent: memorySpec.execIsExternalContent === true,
690
698
  },
691
699
  ...(input.memoryProvenance !== "off"
692
- ? { settlement: { controlDir: writeEngine.controlPlaneDir, sessionId, provenance: "carry" } }
700
+ ? { settlement: { governance: writeEngine.governance, controlDir: writeEngine.controlPlaneDir, sessionId, provenance: "carry" } }
693
701
  : {}),
694
702
  ...(input.memoryProvenance !== "off"
695
703
  ? {
@@ -733,7 +741,7 @@ export async function prepareMemory(input) {
733
741
  catch (err) {
734
742
  if (memoryEngineSession === undefined)
735
743
  for (const end of openedLegs)
736
- end();
744
+ await end();
737
745
  if (typeof err.code === "string" &&
738
746
  (err.code.startsWith("config.memory_scope") ||
739
747
  err.code.startsWith("config.memory_project") ||
@@ -760,12 +768,12 @@ export async function prepareMemory(input) {
760
768
  const detail = "TaskSpec.memory is enabled but RunnerDeps.memoryBackend is not configured; memory is inactive for this task (the legacy memoryStore fallback was retired in design/138 S4 and the dep was removed in design/157 B19).";
761
769
  deps.onError?.(new Error(detail), { phase: "config", sessionId });
762
770
  }
763
- const composeInjection = (facts) => {
771
+ const composeInjection = async (facts) => {
764
772
  let memoryBlock;
765
773
  let seedFiles;
766
774
  let recallDisciplineSegment;
767
775
  if (memoryEngineSession) {
768
- const injection = memoryEngineSession.inject();
776
+ const injection = await memoryEngineSession.inject();
769
777
  let blockBody = injection.block;
770
778
  if (captureOptedOut) {
771
779
  blockBody = [MEMORY_CAPTURE_OPTOUT_NOTICE, injection.index, injection.announceBlock].filter((s) => Boolean(s && s.trim())).join("\n\n");
@@ -57,6 +57,7 @@ export function prepareParkAsk(input) {
57
57
  return refuseBeforeDelivery("question.malformed_request");
58
58
  }
59
59
  const retainedQuestionsHash = boundInputHashOf(retained.questions);
60
+ const retainedCallHash = exactBoundInputHashOf(req.toolName, retained);
60
61
  if (!Value.Check(mountedQuestionTool.parameters, retained) || validateAskQuestions(presented) !== undefined) {
61
62
  return refuseBeforeDelivery("question.malformed_request");
62
63
  }
@@ -71,7 +72,7 @@ export function prepareParkAsk(input) {
71
72
  toolCallId: req.toolCallId,
72
73
  questions: presented,
73
74
  ...questionSourceOf(askSource),
74
- boundInputHash: boundInputHashOf(retained),
75
+ ...(retainedCallHash !== undefined ? { boundInputHash: retainedCallHash } : {}),
75
76
  deliveryId,
76
77
  }, contentAskSignal))();
77
78
  const settlement = await raceAbort(facePromise.then((outcome) => ({ tag: "outcome", outcome }), (error) => ({ tag: "threw", error })), contentAskSignal, () => ({ tag: "aborted" }));
@@ -149,7 +150,7 @@ export function prepareParkAsk(input) {
149
150
  const bindable = bindableArgsOf(req.toolName, parkedArgs);
150
151
  if (!bindable.ok)
151
152
  throw new ParkRefusal(bindable.refusal);
152
- const parkedHash = exactBoundInputHashOf(parkedArgs);
153
+ const parkedHash = exactBoundInputHashOf(req.toolName, parkedArgs);
153
154
  if (parkedHash === undefined)
154
155
  throw new ParkRefusal(`the canonical form of the arguments of "${req.toolName}" cannot be built — no approval row can be bound to them`);
155
156
  const projectionMovedArgs = backendFidelity !== "structured-clone" && !samePlainValue(parked.value, parkedArgs);
@@ -306,7 +307,7 @@ export function prepareParkAsk(input) {
306
307
  toolCallId: req.toolCallId,
307
308
  toolName: req.toolName,
308
309
  ...parkedToolIdentity(toolRosterDeltas.current, req.toolName), ...parkedToolFace(toolRosterDeltas.current, req),
309
- ...(licenseCovers(parkedHash, req.args) ? approvalTargetsOf(callTargetReadingOf(req), shellReadLandings?.(req.toolCallId)) : {}),
310
+ ...(licenseCovers(parkedHash, req.toolName, req.args) ? approvalTargetsOf(callTargetReadingOf(req), shellReadLandings?.(req.toolCallId)) : {}),
310
311
  args: parkedArgs,
311
312
  ...(() => {
312
313
  const p = approvalPreviewOf(req.toolName, parkedArgs);
@@ -19,7 +19,7 @@ import { isValidReminderMark, mintReminderMark } from "../reminder-mint.js";
19
19
  import { clampPermissionMode } from "../ask-origin.js";
20
20
  import { modePolicyOf, modeRequestAfterResume, refusePermissionModeDoors } from "../mode-policy.js";
21
21
  import { resolveOutputStyleFrame } from "../output-style.js";
22
- import { recordedModeSeed } from "../checkpoint-store.js";
22
+ import { recordedModeSeed } from "../checkpoint-row-verdict.js";
23
23
  import { emitTrace } from "../trace.js";
24
24
  import { personPathRowsOfTask, ruleRowsDroppedNotice, ruleStoreUnreadableNotice } from "./person-path-rows.js";
25
25
  import { STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS, STALL_IDLE_MS, withBrainCallGuardrail } from "../../brain/timeout.js";
@@ -35,6 +35,7 @@ import { compileOutputSchema } from "./strict-output-schema.js";
35
35
  import { MEMORY_ENGINE_TOOL_NAMES } from "../memory-engine/tools.js";
36
36
  import { foldAdmissionFreeze } from "../memory-admission.js";
37
37
  import { chainAnchorRecords, chainPolicyOnLeg, chainTopAnchors, deploymentCanRerootChild } from "./child-tree.js";
38
+ import { ownRowDelegationOwner } from "./delegation-owner.js";
38
39
  import { prepareMemory } from "./prepare-memory.js";
39
40
  import { prepareMemoryEngineSession } from "./prepare-memory-engine-session.js";
40
41
  import { prepareDeferClassify } from "./prepare-defer-classify.js";
@@ -87,7 +88,7 @@ import { createRollbackStack } from "./rollback-stack.js";
87
88
  export { __resetMaterializeEnvAnnouncements } from "./prepare-tool-disclosure-mount.js";
88
89
  export { fileHistoryFilesystemIdentity, resolveFileHistoryScope } from "./prepare-file-history.js";
89
90
  import { resolveTriggerWindow, } from "../context-edit.js";
90
- import { declaredHostLocalPaths, isIsolated, pathsAreHostLocal, targetIsExternal } from "../remote-env.js";
91
+ import { declaredHostLocalPaths, isDeclaredSandboxOffHost, pathsAreHostLocal, targetIsExternal } from "../remote-env.js";
91
92
  import { settleTeardownLeg } from "./teardown-bounded.js";
92
93
  import { defaultTaskRegistry } from "../task-registry.js";
93
94
  import { announcePeerLaneMount, judgeSessionBoxDrain } from "../../agents/peer-session-drain.js";
@@ -102,7 +103,7 @@ import { handsWriteHalfMounts } from "../../tools/fs/index.js";
102
103
  import { askSeatEffective } from "../wiring-manifest.js";
103
104
  import { durableParkGapFor } from "../park-selfcheck.js";
104
105
  import { createToolCallEntry, createToolCallStation } from "../mods/tool-call.js";
105
- import { createRowSeat, createSessionAppendEntry } from "../mods/session-append.js";
106
+ import { createRowSeat, createSessionAppendEntry, promptCountOf } from "../mods/session-append.js";
106
107
  import { createReceiveSeat } from "../mods/session-receive.js";
107
108
  import { createCompactStation, createSessionCompactEntry } from "../mods/session-compact.js";
108
109
  import { createSessionSendEntry, createSessionSendStation } from "../mods/session-send.js";
@@ -117,6 +118,7 @@ import { AdvertisedWritableDirs, checkedPlanFileShape, planFileInvalid, planFile
117
118
  import { resolveTaskRootCanonical } from "./task-root-canonical.js";
118
119
  import { projectMarkerFsOf, resolveSessionProject } from "../memory-engine/scope-contract.js";
119
120
  import { createWorkspaceFrameSeat } from "../workspace-snapshot.js";
121
+ import { openSessionCheckout, sessionFrameOf } from "../session-checkout.js";
120
122
  import { createStructuredProjector } from "./tool-output-projection.js";
121
123
  import { imageUnprocessedSeat, toolResultMediaRefusedSeat } from "./tool-result-media-seat.js";
122
124
  import { asThrownError, thrownText } from "../thrown-value.js";
@@ -357,8 +359,9 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
357
359
  for (const cap of MODEL_CAPABILITIES)
358
360
  capabilityOf(model, cap);
359
361
  const fileHistoryRequest = resolveFileHistoryRequest(spec, deps);
360
- const { acquired, session, conflictRef, wakeRecovered, branch } = await prepareAcquireReconcile({ sessions, spec, resume, wakeEffects, report: (e, id) => deps.onError?.(e, { phase: "config", sessionId: id }), ...(legWrites !== undefined ? { legWrites } : {}), ...(internals?.sessionPlacement !== undefined ? { placement: internals.sessionPlacement } : {}), ...(() => { const g = durableParkGapFor(deps, spec); return g !== undefined ? { durableParkGap: g } : {}; })() });
362
+ const { acquired, session, conflictRef, wakeRecovered, branch } = await prepareAcquireReconcile({ sessions, spec, resume, wakeEffects, report: (e, id) => deps.onError?.(e, { phase: "config", sessionId: id }), replayLossNotice: { onNotice: deps.onNotice, runId }, ...(legWrites !== undefined ? { legWrites } : {}), ...(internals?.sessionPlacement !== undefined ? { placement: internals.sessionPlacement } : {}), ...(() => { const g = durableParkGapFor(deps, spec); return g !== undefined ? { durableParkGap: g } : {}; })() });
361
363
  const sessionId = acquired.sessionId;
364
+ const delegationOwner = internals?.delegationOwner ?? ownRowDelegationOwner(sessions, sessionId, async () => (await session.getMetadata()).incarnation);
362
365
  await holdSessionLock?.(sessionId);
363
366
  const onceLedger = await loadAnnounceOnceLedger(session, resume?.seed.announcedListings, deps.onError);
364
367
  internals = restoreRowTaskId(internals, resume?.seed.rowTaskId);
@@ -438,11 +441,10 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
438
441
  failIsolation("the executionEnvFactory returned the shared static env instead of a worktree-rooted env");
439
442
  }
440
443
  else if (!pathsAreHostLocal(ownedEnvSeat.current)) {
441
- if (declaredHostLocalPaths(ownedEnvSeat.current) !== false) {
442
- failIsolation("the executionEnvFactory returned an env that does not declare where its paths land (capabilities.hostLocalPaths) — its tree can be neither compared from here nor exempted as a sandbox");
443
- }
444
- else if (!isIsolated(ownedEnvSeat.current)) {
445
- failIsolation("the executionEnvFactory returned an env whose paths are not the host's (capabilities.hostLocalPaths), without capabilities.isolation — a target that is no declared sandbox is a shared checkout, not a per-agent worktree, and its paths cannot be compared from here");
444
+ if (!isDeclaredSandboxOffHost(ownedEnvSeat.current)) {
445
+ failIsolation(declaredHostLocalPaths(ownedEnvSeat.current) !== false
446
+ ? "the executionEnvFactory returned an env that does not declare where its paths land (capabilities.hostLocalPaths) — its tree can be neither compared from here nor exempted as a sandbox"
447
+ : "the executionEnvFactory returned an env whose paths are not the host's (capabilities.hostLocalPaths), without capabilities.isolation — a target that is no declared sandbox is a shared checkout, not a per-agent worktree, and its paths cannot be compared from here");
446
448
  }
447
449
  }
448
450
  else {
@@ -466,8 +468,12 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
466
468
  }
467
469
  }
468
470
  const ownedEnv = ownedEnvSeat.current;
469
- const { taskRootFinal, rebaseRestoredPath, remote: workspaceRemote, ownTarget } = await prepareWorkspaceRestore({ ownedEnv, deps, spec, internals, resume, taskRootInitial, placement, placementFence, abortController, sessionId });
471
+ const { taskRootFinal: taskRootRestored, rebaseRestoredPath, remote: workspaceRemote, ownTarget } = await prepareWorkspaceRestore({ ownedEnv, deps, spec, internals, resume, taskRootInitial, placement, placementFence, abortController, sessionId });
472
+ const sessionCheckout = await openSessionCheckout({ env: executionEnv, session, sessionId, declaration: spec.workspace, baseRoot: taskRootRestored, additionalDirectories: spec.additionalDirectories });
473
+ const taskRootFinal = sessionCheckout.taskRoot;
470
474
  const { canonical: taskRootCanonical } = await resolveTaskRootCanonical({ env: executionEnv, given: taskRootFinal, onNotice: deps.onNotice, sessionId, runId });
475
+ const { seat: worktreeSeat, writeLocation, checkout } = writeLocationOf({ spelled: taskRootFinal, canonical: taskRootCanonical });
476
+ const delegationCwd = () => { const at = writeLocation(); return at === taskRootCanonical ? taskRootFinal : at; };
471
477
  const legHome = validatePath(executionEnv.homeDir, { intent: "validate-coordinate" });
472
478
  const legAnchors = { root: taskRootCanonical, ...(legHome !== undefined ? { home: legHome } : {}) };
473
479
  const chainTop = chainTopAnchors({ leg: legAnchors, live: internals?.inheritedGate?.pathRuleAnchors, seed: resume?.seed.inheritedGate?.pathRuleAnchors, placement, rebase: rebaseRestoredPath });
@@ -490,7 +496,7 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
490
496
  const mcpPool = installedPreflight.mcp?.length ? { pool: internals?.mcpPool ?? new McpConnectionPool(), owned: internals?.mcpPool === undefined } : undefined;
491
497
  const mcpHostSeats = internals?.mcpHostSeats;
492
498
  const mountedMcpNow = mcpPool !== undefined ? () => mountedMcpOf({ declared: installedPreflight.mcp, roster: roster.tools, aggregateNames: new Set(mcp.tools.filter((t) => t.mcpRemoteName === undefined).map((t) => t.name)), pool: mcpPool.pool, ...(mcpHostSeats !== undefined ? { hostSeats: mcpHostSeats } : {}) }) : undefined;
493
- const { liveInheritedGate, seedInheritedGate, inheritedAncestorRules, inheritedShellGate, inheritedParentConstraints, permissionMode, commitModeSeats, endModeCeiling, inheritedAdmittedOrgScopes, priorOwnOrgVerdict, orgGovernedProvenance, effectiveShellGate, ownSessionRulesRef, ancestorSessionRulesRef, ancestorRulesNow, memoryAdmittedOrgScopesRef, ownOrgVerdictRef, runClampSource, faceCheckpointSection, writeFaceCheckpointSection, skillGrantCheckpointSection, frozenOnAsk, hookEnvSource, frozenOnQuestion, parentSpecSeat, provenanceForChildrenRef, delegationSettlementRef, inheritedGateForChildren, carrierReadFace, carrierWriteFace, fullShellReachable, gateStopRef, stopForDenialLimit, enrichSpecToolCtx } = prepareInheritedGate({ spec, deps, askSeat: doors.askSeat, hostFloor: doors.hostFloor, crossBoundaryTree, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, ownTarget, executionEnv, ownedEnv, lockedPreflight: installedPreflight, pathRuleAnchors: { chainTop, onLeg: onLeg.chained }, checkpointSeat, checkpointScope, toolFaceSnapshot, mountsCallerTool, ...(mountedMcpNow !== undefined ? { mountedMcp: mountedMcpNow } : {}), promptLean, resolvedInteractionPosture, permissionModeSeat, handsEnabled, reportUsage, harnessRef, skillGrants, requestAllowedTools: allowedToolTables.request, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun: () => { abortController.abort(); void harness.abort(); }, runtimeCaps: () => runtimeCaps, modBus: legMods.standing, ownModChain, autoModeDecider: () => autoModeDeciderRef.current, autoModeDenialTracking: () => autoModeDenialTrackingRef.current, autoModeArming: () => autoModeArmingRef.current, agentForkDenial: () => agentForkDenial, agentStations: () => agentStationsRef.current, sendStation: () => sendStationRef.current, observersActive: () => observersActive, resolvedReadFace: () => resolvedReadFace, resolvedWriteFace: () => resolvedWriteFace, readDenyAdditionsNormalized: () => readDenyAdditionsNormalized, handsLessResolvedFace: () => handsLessResolvedFace, handsLessResolvedWriteFace: () => handsLessResolvedWriteFace, centerAdoption: () => centerAdoptionRef.current, memoryEngineSession: () => memoryEngineSession });
499
+ const { liveInheritedGate, seedInheritedGate, inheritedAncestorRules, inheritedShellGate, inheritedParentConstraints, permissionMode, commitModeSeats, endModeCeiling, inheritedAdmittedOrgScopes, priorOwnOrgVerdict, orgGovernedProvenance, effectiveShellGate, ownSessionRulesRef, ancestorSessionRulesRef, ancestorRulesNow, memoryAdmittedOrgScopesRef, ownOrgVerdictRef, runClampSource, faceCheckpointSection, writeFaceCheckpointSection, skillGrantCheckpointSection, frozenOnAsk, hookEnvSource, frozenOnQuestion, parentSpecSeat, provenanceForChildrenRef, delegationSettlementRef, inheritedGateForChildren, carrierReadFace, carrierWriteFace, fullShellReachable, gateStopRef, stopForDenialLimit, enrichSpecToolCtx } = prepareInheritedGate({ spec, deps, delegationOwner, askSeat: doors.askSeat, hostFloor: doors.hostFloor, crossBoundaryTree, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, delegationCwd, ownTarget, executionEnv, ownedEnv, lockedPreflight: installedPreflight, pathRuleAnchors: { chainTop, onLeg: onLeg.chained }, checkpointSeat, checkpointScope, toolFaceSnapshot, mountsCallerTool, ...(mountedMcpNow !== undefined ? { mountedMcp: mountedMcpNow } : {}), promptLean, resolvedInteractionPosture, permissionModeSeat, handsEnabled, reportUsage, harnessRef, skillGrants, requestAllowedTools: allowedToolTables.request, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun: () => { abortController.abort(); void harness.abort(); }, runtimeCaps: () => runtimeCaps, modBus: legMods.standing, ownModChain, autoModeDecider: () => autoModeDeciderRef.current, autoModeDenialTracking: () => autoModeDenialTrackingRef.current, autoModeArming: () => autoModeArmingRef.current, agentForkDenial: () => agentForkDenial, agentStations: () => agentStationsRef.current, sendStation: () => sendStationRef.current, observersActive: () => observersActive, resolvedReadFace: () => resolvedReadFace, resolvedWriteFace: () => resolvedWriteFace, readDenyAdditionsNormalized: () => readDenyAdditionsNormalized, handsLessResolvedFace: () => handsLessResolvedFace, handsLessResolvedWriteFace: () => handsLessResolvedWriteFace, centerAdoption: () => centerAdoptionRef.current, memoryEngineSession: () => memoryEngineSession });
494
500
  bindPermissionModeSeat(permissionMode);
495
501
  const personRowNotices = { onUnread: ruleStoreUnreadableNotice(deps.onNotice, { sessionId, runId }), onRowsDropped: ruleRowsDroppedNotice(deps.onNotice, { sessionId, runId }) };
496
502
  const readerOf = (signals) => personPathRowsOfTask({ deps, notices: personRowNotices, principal: spec.principal, ids: { sessionId, runId, taskId: hostTaskId }, root: taskRootFinal, rootCanonical: taskRootCanonical, leads: headLeads, chainTop, occurrences: toolOccurrences, signals });
@@ -506,10 +512,9 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
506
512
  const effectivePathDenyRules = policyDenyRows.filter((r) => r.unanchored === undefined);
507
513
  const writeTargetJudgeRef = {};
508
514
  const legExemptRoots = Object.freeze(dataRootSpellings(deps.memoryEngineDir));
509
- const { seat: worktreeSeat, writeLocation, checkout } = writeLocationOf({ spelled: taskRootFinal, canonical: taskRootCanonical });
510
515
  const legWriteGuard = { exemptRoots: legExemptRoots, rows: toolPolicyWriteGuardRows([installedToolPolicy, ...(inheritedParentConstraints ?? []).map((c) => c.policy)]), checkout };
511
516
  const sideCallBookRef = {};
512
- const { roster, blockedRef, runtimeCaps, runtimeCapsFaulted, complianceDenies, complianceDegraded, agentForkDenial, observersActive, autoModeArmReason, autoModeDeciderRef, autoModeDenialTrackingRef, autoModeArmingRef, armAutoMode, selfOrchestrationActive, workflowToolsActive, workflowSizeGuideline } = await prepareCapsAndWorkflow({ spec, deps, askSeat: doors.askSeat, internals, crossBoundaryTree, session, sessionId, runId, hostTaskId, taskScope, taskRootFinal, ownTarget, model, thinking, lockedPreflight, checkpointSeat, toolEffects, toolFaceSnapshot, promptLean, resolvedInteractionPosture, harnessRef, parentSpecSeat, runClampSource, forwardEvent, inheritedGateForChildren, enrichSpecToolCtx, maybeOffload, taskArtifacts, requestReview, ...(spec.planFile !== undefined ? { planFileSource: { path: spec.planFile, shown: planFileShown(spec.planFile), read: (signal) => advertisedWritableDirs?.readPlanFile(signal) ?? Promise.resolve({ ok: false, reason: "this run admitted no plan file" }) } } : {}), enterPlanMode, permissionMode, readDenyEntries: () => personRows.tablesReady().then(() => ({ entries: readDenyMatcher?.entries ?? [], ruleRows: pathTables?.ruleRows() ?? effectivePathDenyRules })), peerLaneActive, peerSendMessageBuiltIn, runnerSelf, memoryEngineSession: () => memoryEngineSession, centerAdoption: () => centerAdoptionRef.current, agentStations: () => agentStationsRef.current, delegated: delegation.isDelegatedChild, sideCallBookRef });
517
+ const { roster, blockedRef, runtimeCaps, runtimeCapsFaulted, complianceDenies, complianceDegraded, agentForkDenial, observersActive, autoModeArmReason, autoModeDeciderRef, autoModeDenialTrackingRef, autoModeArmingRef, armAutoMode, selfOrchestrationActive, workflowToolsActive, workflowSizeGuideline } = await prepareCapsAndWorkflow({ spec, deps, delegationOwner, askSeat: doors.askSeat, internals, crossBoundaryTree, session, sessionId, runId, hostTaskId, taskScope, taskRootFinal, delegationCwd, ownTarget, model, thinking, lockedPreflight, checkpointSeat, toolEffects, toolFaceSnapshot, promptLean, resolvedInteractionPosture, harnessRef, parentSpecSeat, runClampSource, forwardEvent, inheritedGateForChildren, enrichSpecToolCtx, maybeOffload, taskArtifacts, requestReview, ...(spec.planFile !== undefined ? { planFileSource: { path: spec.planFile, shown: planFileShown(spec.planFile), read: (signal) => advertisedWritableDirs?.readPlanFile(signal) ?? Promise.resolve({ ok: false, reason: "this run admitted no plan file" }) } } : {}), enterPlanMode, permissionMode, readDenyEntries: () => personRows.tablesReady().then(() => ({ entries: readDenyMatcher?.entries ?? [], ruleRows: pathTables?.ruleRows() ?? effectivePathDenyRules })), peerLaneActive, peerSendMessageBuiltIn, runnerSelf, memoryEngineSession: () => memoryEngineSession, centerAdoption: () => centerAdoptionRef.current, agentStations: () => agentStationsRef.current, delegated: delegation.isDelegatedChild, sideCallBookRef });
513
518
  const tools = roster.tools;
514
519
  const crossBoundary = await prepareCrossBoundaryLane({ token: crossBoundaryTree, posture: doors.crossBoundaryPosture, externalContentTargetActive, env: executionEnv, session, resumeLeg: resume !== undefined, sessionId, runId, hostTaskId, deps });
515
520
  const sessionProject = await resolveSessionProject(projectMarkerFsOf(executionEnv), taskRootCanonical, spec.projectId);
@@ -705,7 +710,7 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
705
710
  }
706
711
  }
707
712
  const rosterCanPersist = rosterCanPersistMemory(tools.filter(valveLeaves(spec, toolFaceSnapshot.selector)), { effects: toolEffects, handsOffHost: handsEnabled && !pathsAreHostLocal(executionEnv) }, spec.memoryPersistenceCapable);
708
- const { memoryBlock: memoryBlockFromEngine, recallDisciplineSegment: memoryRecallSegment, seedFiles: memorySeedFiles } = composeMemoryInjection({ rosterCanPersist, isSubagent: delegation.isNonForkChild });
713
+ const { memoryBlock: memoryBlockFromEngine, recallDisciplineSegment: memoryRecallSegment, seedFiles: memorySeedFiles } = await composeMemoryInjection({ rosterCanPersist, isSubagent: delegation.isNonForkChild });
709
714
  if (memorySeedFiles?.length && seedContextFiles) {
710
715
  try {
711
716
  await seedContextFiles(memorySeedFiles);
@@ -762,6 +767,7 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
762
767
  const rowSeat = createRowSeat();
763
768
  const receiveSeat = createReceiveSeat();
764
769
  const compactStation = createCompactStation();
770
+ const sessionMeasure = {};
765
771
  const imageUnprocessed = imageUnprocessedSeat(deps.onNotice, deps.imageProcessor, { sessionId, runId });
766
772
  const harness = new AgentHarness({
767
773
  admitRows: rowSeat.admitRows,
@@ -870,14 +876,14 @@ export async function prepareTask(request, deps, sessions, resume, internals, ru
870
876
  const preparedHolder = {};
871
877
  const { cacheBreakDetector, cacheFingerprint, promptOverheadTokens, compactionRestore, normalizeAttachmentPath, isDedupStubResult, recentlyReadFiles, onCompactionApplied, detectExternalChanges, syntheticReadVerdict, consolidationWriteJudge, listBackgroundTasks, taskReadHandleOf, centerCompactionCandidate, effectiveReadFaceObserved, effectiveWriteFaceObserved, effectiveReadDenyObserved } = prepareTurnWiring({ deps, systemPromptSeat, harnessTools, fpRef, model, promptIdentityDigest: promptManifest.identity.artifact, systemBlocks, thinking, spec, sessionId, turnSnapshotRef, promptManifest, charsPerToken, handsEnabled, executionEnv, attachmentRootCanonical, readRoots, modelFileReader: modelFileReaderSeat.current, reminderMark, reminderDisclosureCounts, resolvedReadFace, handsCwdRef, readFileStateForCheckpoint, denyNarrowingPolicy, skillGrants: skillGrantLane, callerPolicy: installedToolPolicy, inheritedPolicies: (inheritedParentConstraints ?? []).flatMap((c) => (c.policy !== undefined ? [c.policy] : [])), persistedRuleLane: permissionRuleLane, ruleLaneFacts, personRowsBeyondRun, orgRuleLane: permissionRuleOrgLane, stampCallTarget, abortController, hostTaskId, taskScope, buildAssembleInputs, identityFor, adoptsCandidates, centerAdoptionRef, harnessRef, carrierReadFace, carrierWriteFace, readDenyAdditionsNormalized, preparedHolder });
872
878
  await onceLedger.settle(session, announcedListingsRef);
873
- const buildPrepared = () => ({ harness, session, sessionId, taskId: hostTaskId, runId, crossBoundary, ...(doors.hostFloor !== undefined ? { hostFloor: doors.hostFloor } : {}), registryAccess: { owner: hostTaskId, scope: taskScope }, reminderMark, reminderDisclosureCounts, fullShellReachable, approvalPosture: { get mode() { return permissionMode.current; }, askEffective: askSeatEffective(wiringManifest) }, ...(outputStyleFrame !== undefined ? { outputStyleFrame } : {}), permissionMode, editedFilesSnapshot, taskRootPath: taskRootFinal, model, thinking, compModel: effectiveCompModel, mcp, ...(mcpRedial !== undefined ? { mcpRedial } : {}), ...(a2a.tools.length > 0 ? { a2a } : {}), blockedRef, outputRef, abortController, conflictRef, blockedToolCalls, toolOccurrences, batchHaltRef, nestedStats, ...(rewindNotes.length > 0 ? { rewindNotes } : {}), ...(fileHistoryBoundary !== undefined ? { fileHistoryBoundary } : {}), ...(effectiveReadFaceObserved !== undefined ? { effectiveReadFace: effectiveReadFaceObserved, effectiveWriteFace: effectiveWriteFaceObserved } : {}), ...(effectiveReadDenyObserved !== undefined ? { effectiveReadDenyPatterns: effectiveReadDenyObserved } : {}), effectiveMemoryScopes: memoryEffectiveScopes, ...(placementValueOrAbsent(placementRootResolved) !== undefined ? { placementRoot: placementRootResolved } : {}), cwdRef: handsCwdRef, ...(attachmentRootCanonical !== undefined ? { handsRoot: attachmentRootCanonical } : {}), ...(stampCallTarget !== undefined ? { stampCallTarget } : {}), toolProgressRef, ...(advertisedWritableDirs !== undefined ? { advertisedWritableDirs } : {}), exemptRoots: legExemptRoots, ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), workspaceFrame: createWorkspaceFrameSeat({ root: taskRootCanonical, ...(handsCwdRef !== undefined ? { cwdRef: handsCwdRef } : {}), ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), ...(sessionProject.project !== undefined ? { project: sessionProject.project } : {}), remote: workspaceRemote }), ...(workspaceStateSettle !== undefined ? { workspaceStateSettle } : {}), ...(sealReadStateSeat !== undefined ? { sealReadStateSeat } : {}), denyNarrowingPolicy, skillGrants: skillGrantLane, skillSpecs, ...(permissionRuleLane !== undefined ? { persistedRuleLane: permissionRuleLane } : {}), ...(basePolicyForResumeEdit !== undefined ? { basePolicyForResumeEdit } : {}), consolidationWriteJudge, ...(permissionRuleOrgLane !== undefined ? { permissionRuleOrg: permissionRuleOrgLane } : {}), releaseSignal, endModeCeiling, settleContentAskBindings, cacheBreakDetector, cacheFingerprint, wiringManifest, promptManifest, promptIdentity, activeTools, ...(deferred.size > 0 ? { deferredToolNames: deferred } : {}), toolMaterializeStatic, deferDirectCall, ...(staticFaceForRef.current !== undefined ? { staticFaceFor: staticFaceForRef.current } : {}), ownedEnv, pausedRef, undeliveredContinuationRef, suspendProgressRef, remoteEnvFailures, reviewRequestRef, suspendLoopRef, suspendForResource, ...(suspendForPlatformLimit !== undefined ? { suspendForPlatformLimit } : {}), ...(envLifetimeSuspendAt !== undefined ? { envLifetimeSuspendAt } : {}), ...(usageGovernance !== undefined ? { usageGovernance } : {}), callIssuedAtRef, workCutRef, loopTerminalRef, brainCallGuardrailRef, gateStopRef, stopForDenialLimit, suspendForReview, ...(readFileStateForCheckpoint !== undefined ? { readFileState: readFileStateForCheckpoint } : {}), resourceLedger: priorLedger, liveSpendRef, humanReviewRef, now, tools, toolRoster, toolRosterDeltas: rosterSeat, structuredProjector, toolEffects, wakeRecovered, promptOverheadTokens, lastBrainContext, lastSentRequest: () => lastBrainContextRef.current, ...(advisor.instruction !== undefined ? { advisorInstruction: advisor.instruction } : {}), ...(compactionRestore !== undefined ? { compactionRestore } : {}), recentlyReadFiles, normalizeAttachmentPath, isDedupStubResult, ...(onCompactionApplied ? { onCompactionApplied } : {}), compactionReuseRef, trimPressureRef, microCompact, ...(memoryEngineSession ? { memoryEngineSession } : {}), ...(subagentRetain ? { subagentRetain } : {}), ...(lspDiagnostics && nudgeLspOnEdit && withheldDiagnosticsOf ? { lspDiagnostics: { registry: lspDiagnostics, nudge: nudgeLspOnEdit, runIdent: lspRunIdent, withheldOf: withheldDiagnosticsOf } } : {}), stopRequestedRef, announcedSnapshotRecovered: onceLedger.recovered, ...(dateChange ? { dateChange } : {}), ...(instructionSources ? { instructionSources } : {}), ...(projectInstructionContent !== undefined ? { projectInstructionContent } : {}), ...(workflowSizeGuideline ? { workflowSizeGuideline } : {}), ...(detectExternalChanges ? { detectExternalChanges } : {}), ...(toolsDeltaRef ? { toolsDeltaRef } : {}), ...(mcpUnavailable ? { mcpUnavailable } : {}), ...(agentListing ? { agentListing } : {}), ...(skillsListing ? { skillsListing } : {}), announcedListingsRef, frameReceipts, frameSettlement, ...(userAttachmentsSeat !== undefined ? { userAttachments: userAttachmentsSeat } : {}), attachmentDelivery: createAttachmentDelivery(), imageUnprocessed, ...(modelFileReaderSeat.current !== undefined ? { modelFileReader: modelFileReaderSeat.current } : {}), syntheticReadVerdict, ...(peerLaneRefs.boundaryRound !== undefined ? { peerBoundaryRound: peerLaneRefs.boundaryRound } : {}), gitStatusRef, postureFrameRef, listBackgroundTasks, taskReadHandleOf, hookIdentity, modBus: legMods.bus, admitRows: rowSeat.admitRows, receiveSeat, turnOpenRedelivery: {}, compactStation, sideCallBookRef, ...(sessionBoxBound !== undefined ? { sessionBox: sessionBoxBound } : {}), ...(turnSnapshotRef.current !== undefined ? { turnSnapshot: turnSnapshotRef.current } : {}), ...(centerCompactionCandidate !== undefined ? { centerCompactionCandidate } : {}), ...(shellReadCheck !== undefined ? { shellReadCheck } : {}), ...(shellReadLandings !== undefined ? { shellReadLandings } : {}), ...(toolDisclosureSeat !== undefined ? { toolDisclosure: toolDisclosureSeat } : {}), ...(approvedCallScreen !== undefined ? { approvedCallScreen } : {}), ...(toolCallStationRef.current !== undefined ? { toolCallStation: toolCallStationRef.current } : {}) });
879
+ const buildPrepared = () => ({ harness, session, sessionId, taskId: hostTaskId, runId, crossBoundary, ...(doors.hostFloor !== undefined ? { hostFloor: doors.hostFloor } : {}), registryAccess: { owner: hostTaskId, scope: taskScope }, reminderMark, reminderDisclosureCounts, fullShellReachable, approvalPosture: { get mode() { return permissionMode.current; }, askEffective: askSeatEffective(wiringManifest) }, ...(outputStyleFrame !== undefined ? { outputStyleFrame } : {}), permissionMode, editedFilesSnapshot, taskRootPath: taskRootFinal, model, thinking, compModel: effectiveCompModel, mcp, ...(mcpRedial !== undefined ? { mcpRedial } : {}), ...(a2a.tools.length > 0 ? { a2a } : {}), blockedRef, outputRef, abortController, conflictRef, blockedToolCalls, toolOccurrences, batchHaltRef, nestedStats, ...(rewindNotes.length > 0 ? { rewindNotes } : {}), ...(fileHistoryBoundary !== undefined ? { fileHistoryBoundary } : {}), ...(effectiveReadFaceObserved !== undefined ? { effectiveReadFace: effectiveReadFaceObserved, effectiveWriteFace: effectiveWriteFaceObserved } : {}), ...(effectiveReadDenyObserved !== undefined ? { effectiveReadDenyPatterns: effectiveReadDenyObserved } : {}), effectiveMemoryScopes: memoryEffectiveScopes, ...(placementValueOrAbsent(placementRootResolved) !== undefined ? { placementRoot: placementRootResolved } : {}), cwdRef: handsCwdRef, ...(attachmentRootCanonical !== undefined ? { handsRoot: attachmentRootCanonical } : {}), ...(stampCallTarget !== undefined ? { stampCallTarget } : {}), toolProgressRef, ...(advertisedWritableDirs !== undefined ? { advertisedWritableDirs } : {}), exemptRoots: legExemptRoots, ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), workspaceFrame: createWorkspaceFrameSeat({ root: taskRootCanonical, ...(handsCwdRef !== undefined ? { cwdRef: handsCwdRef } : {}), ...(worktreeSessionRef !== undefined ? { worktreeSessionRef } : {}), ...(() => { const s = sessionFrameOf(sessionCheckout.record); return s !== undefined ? { session: s } : {}; })(), ...(sessionProject.project !== undefined ? { project: sessionProject.project } : {}), remote: workspaceRemote }), ...(workspaceStateSettle !== undefined ? { workspaceStateSettle } : {}), ...(sealReadStateSeat !== undefined ? { sealReadStateSeat } : {}), denyNarrowingPolicy, skillGrants: skillGrantLane, skillSpecs, ...(permissionRuleLane !== undefined ? { persistedRuleLane: permissionRuleLane } : {}), ...(basePolicyForResumeEdit !== undefined ? { basePolicyForResumeEdit } : {}), consolidationWriteJudge, ...(permissionRuleOrgLane !== undefined ? { permissionRuleOrg: permissionRuleOrgLane } : {}), releaseSignal, endModeCeiling, settleContentAskBindings, cacheBreakDetector, cacheFingerprint, wiringManifest, promptManifest, promptIdentity, activeTools, ...(deferred.size > 0 ? { deferredToolNames: deferred } : {}), toolMaterializeStatic, deferDirectCall, ...(staticFaceForRef.current !== undefined ? { staticFaceFor: staticFaceForRef.current } : {}), ownedEnv, pausedRef, undeliveredContinuationRef, suspendProgressRef, remoteEnvFailures, reviewRequestRef, suspendLoopRef, suspendForResource, ...(suspendForPlatformLimit !== undefined ? { suspendForPlatformLimit } : {}), ...(envLifetimeSuspendAt !== undefined ? { envLifetimeSuspendAt } : {}), ...(usageGovernance !== undefined ? { usageGovernance } : {}), callIssuedAtRef, workCutRef, loopTerminalRef, brainCallGuardrailRef, gateStopRef, stopForDenialLimit, suspendForReview, ...(readFileStateForCheckpoint !== undefined ? { readFileState: readFileStateForCheckpoint } : {}), resourceLedger: priorLedger, liveSpendRef, humanReviewRef, now, tools, toolRoster, toolRosterDeltas: rosterSeat, structuredProjector, toolEffects, wakeRecovered, promptOverheadTokens, lastBrainContext, lastSentRequest: () => lastBrainContextRef.current, ...(advisor.instruction !== undefined ? { advisorInstruction: advisor.instruction } : {}), ...(compactionRestore !== undefined ? { compactionRestore } : {}), recentlyReadFiles, normalizeAttachmentPath, isDedupStubResult, ...(onCompactionApplied ? { onCompactionApplied } : {}), compactionReuseRef, trimPressureRef, microCompact, ...(memoryEngineSession ? { memoryEngineSession } : {}), ...(subagentRetain ? { subagentRetain } : {}), ...(lspDiagnostics && nudgeLspOnEdit && withheldDiagnosticsOf ? { lspDiagnostics: { registry: lspDiagnostics, nudge: nudgeLspOnEdit, runIdent: lspRunIdent, withheldOf: withheldDiagnosticsOf } } : {}), stopRequestedRef, announcedSnapshotRecovered: onceLedger.recovered, ...(dateChange ? { dateChange } : {}), ...(instructionSources ? { instructionSources } : {}), ...(projectInstructionContent !== undefined ? { projectInstructionContent } : {}), ...(workflowSizeGuideline ? { workflowSizeGuideline } : {}), ...(detectExternalChanges ? { detectExternalChanges } : {}), ...(toolsDeltaRef ? { toolsDeltaRef } : {}), ...(mcpUnavailable ? { mcpUnavailable } : {}), ...(agentListing ? { agentListing } : {}), ...(skillsListing ? { skillsListing } : {}), announcedListingsRef, frameReceipts, frameSettlement, ...(userAttachmentsSeat !== undefined ? { userAttachments: userAttachmentsSeat } : {}), attachmentDelivery: createAttachmentDelivery(), imageUnprocessed, ...(modelFileReaderSeat.current !== undefined ? { modelFileReader: modelFileReaderSeat.current } : {}), syntheticReadVerdict, ...(peerLaneRefs.boundaryRound !== undefined ? { peerBoundaryRound: peerLaneRefs.boundaryRound } : {}), gitStatusRef, postureFrameRef, listBackgroundTasks, taskReadHandleOf, hookIdentity, modBus: legMods.bus, admitRows: rowSeat.admitRows, receiveSeat, turnOpenRedelivery: {}, compactStation, sessionMeasure, sideCallBookRef, ...(sessionBoxBound !== undefined ? { sessionBox: sessionBoxBound } : {}), ...(turnSnapshotRef.current !== undefined ? { turnSnapshot: turnSnapshotRef.current } : {}), ...(centerCompactionCandidate !== undefined ? { centerCompactionCandidate } : {}), ...(shellReadCheck !== undefined ? { shellReadCheck } : {}), ...(shellReadLandings !== undefined ? { shellReadLandings } : {}), ...(toolDisclosureSeat !== undefined ? { toolDisclosure: toolDisclosureSeat } : {}), ...(approvedCallScreen !== undefined ? { approvedCallScreen } : {}), ...(toolCallStationRef.current !== undefined ? { toolCallStation: toolCallStationRef.current } : {}) });
874
880
  refuseLateRosterChanges(callerRoster.roster);
875
881
  rollback.commit();
876
882
  commitModeSeats(abortController.signal);
877
883
  const prepared = buildPrepared();
878
884
  preparedHolder.current = prepared;
879
885
  const toolCallEntry = createToolCallEntry({ bus: legMods.bus, harness, faceOf: (name) => toolCallFaceOf(rosterSeat.current, name), specOf: (name) => spec.tools?.find((s) => s.name === name) });
880
- legMods.bindFacade(legFacadeSeats({ deps, spec, sessionId, model, executionEnv, readFloor: runFloor, taskRoot: taskRootFinal, cwdRef: handsCwdRef, lastBrainContext: prepared.lastBrainContext, activeTools, agentListing, book: (answeredBy, reply) => {
886
+ legMods.bindFacade(legFacadeSeats({ deps, spec, sessionId, model, executionEnv, readFloor: runFloor, taskRoot: taskRootFinal, cwdRef: handsCwdRef, lastBrainContext: prepared.lastBrainContext, agentSessions: { registry: defaultTaskRegistry, access: { ...prepared.registryAccess, sessionId } }, turns: async () => promptCountOf(await session.getBranch()), measure: sessionMeasure, activeTools, agentListing, book: (answeredBy, reply) => {
881
887
  const book = prepared.sideCallBookRef.book;
882
888
  if (book === undefined)
883
889
  throw new Error("a mod's $.model.complete was answered before the run body bound the leg's usage account, which it does before any tool call");
@@ -1,5 +1,5 @@
1
1
  import { declaredSuspend, frozenHandleCopy, isRemoteExecutionEnv, missingRestoreSurface, pathsAreHostLocal, placementHonored, placementTargetOf } from "../remote-env.js";
2
- import { settleOwnTarget } from "./placement-fence.js";
2
+ import { deviceMoveRefusal, settleOwnTarget } from "./placement-fence.js";
3
3
  import { remoteEnvFailureNote, restoreWorkspaceWithRetry } from "./remote-env-retry.js";
4
4
  import { rebaseWorkspacePathAcross } from "./workspace-path.js";
5
5
  export { remoteEnvFailureNote, restoreWorkspaceWithRetry } from "./remote-env-retry.js";
@@ -22,11 +22,8 @@ export async function prepareWorkspaceRestore(input) {
22
22
  failResume(`resume workspace identity mismatch: the checkpoint records provider "${handle.provider}" but the resumed env reports "${resumedHandle.provider}" — refusing to continue a workspace on a different backend (wire the factory to rebuild the checkpointed lane and re-resume)`);
23
23
  }
24
24
  const reported = placementTargetOf(resumedHandle);
25
- if (!placementHonored(input.placementFence, reported)) {
26
- failResume(reported?.deviceId === undefined
27
- ? `resume workspace identity mismatch: the placement fence names deviceId "${input.placementFence?.deviceId}" but the resumed env reports none — a device-bound workspace cannot be verified on a handle that does not state its device (absence is not a match)`
28
- : `resume workspace identity mismatch: the placement fence names deviceId "${input.placementFence?.deviceId}" but the resumed env reports "${reported.deviceId}" — refusing to continue on a different physical device`);
29
- }
25
+ if (!placementHonored(input.placementFence, reported))
26
+ throw deviceMoveRefusal("resume.env_failed", input.placementFence?.deviceId, reported?.deviceId);
30
27
  };
31
28
  if (ownedEnv === undefined || !isRemoteExecutionEnv(ownedEnv)) {
32
29
  failResume("resume needs a RemoteExecutionEnv from executionEnvFactory to restore the workspace snapshot");
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The resume ladder's ADMISSION rung (E1) and the wake's shaping (E2), verbatim from
3
3
  * `Runner.resumeStream`: the outcome container's domain, the one-read snapshots of the caller's config and
4
- * the trusted internals bag, the store resolution, the row read and its terminal-status confirm, the
5
- * same-process parent-constraint re-supply, then the wake pre-ladder (gate purity, pendingAction purity,
4
+ * the trusted internals bag, the store resolution, the row read and its terminal-status confirm, the row's own verdict,
5
+ * the same-process parent-constraint re-supply, then the wake pre-ladder (gate purity, pendingAction purity,
6
6
  * the message's persist-time validation) and the one read of the outcome discriminant and the signal slot.
7
7
  *
8
8
  * Async (two store reads); every refusal throws a typed `CheckpointError` pre-CAS. It ends by handing what it
@@ -40,7 +40,7 @@ export interface ResumeAdmissionInput<R> {
40
40
  }
41
41
  /** What admission established — the constants every later rung reads. */
42
42
  export interface ResumeAdmissionResult {
43
- /** The caller's config, snapshotted once (own enumerable fields), its MCP / A2A entries the frozen ones the doors judged. */
43
+ /** The caller's config, snapshotted once (own enumerable fields); its MCP / A2A lists are the doors' judged copies of THIS resume's (the row records none). */
44
44
  config: ResumeTaskConfig;
45
45
  /** The trusted internals snapshot, with the parked parent chain re-supplied when this Runner spawned the leg. */
46
46
  internals: RunInternals | undefined;
@@ -1,4 +1,5 @@
1
- import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, refuseRetiredModeSeed, resolveCheckpointStore, validatePendingSteer } from "../checkpoint-store.js";
1
+ import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, resolveCheckpointStore, validatePendingSteer } from "../checkpoint-store.js";
2
+ import { checkpointRowRefusal } from "../checkpoint-row-verdict.js";
2
3
  import { assertResumeConfigRecord, checkpointStoreSeat, refuseResumeDoors } from "./prepare-config-doors.js";
3
4
  import { compositionLegRecord } from "./checkpoint-scope.js";
4
5
  import { asResumeConfigRefusal } from "../mode-policy.js";
@@ -49,6 +50,9 @@ export async function resumeAdmission(input) {
49
50
  }
50
51
  throw new CheckpointError("checkpoint.already_resolved", `checkpoint is ${describeSuppliedValue(live?.status ?? cp.status)} — the token is consumed, so this resume was neither validated nor executed (idempotent); a different outcome cannot redeem it`);
51
52
  }
53
+ const rowRefusal = checkpointRowRefusal(cp);
54
+ if (rowRefusal !== undefined)
55
+ throw rowRefusal;
52
56
  if ((internals?.inheritedGate?.parentConstraints?.length ?? 0) === 0) {
53
57
  const parked = parentConstraintRegistry.get(token);
54
58
  if (parked !== undefined) {
@@ -62,8 +66,7 @@ export async function resumeAdmission(input) {
62
66
  const outcomeGate = outcome.gate;
63
67
  const resumeSignal = config.signal;
64
68
  let suppliedMessage;
65
- refuseRetiredModeSeed(cp.state);
66
- config = refuseResumeDoors(config, cp.state, runner.deps, sessions, internals?.holder);
69
+ config = refuseResumeDoors(config, runner.deps, sessions, internals?.holder);
67
70
  const parkedSteers = readPendingSteerQueue(cp.state);
68
71
  if (outcomeGate === "wake") {
69
72
  suppliedMessage = outcome.message;
@@ -41,6 +41,10 @@ export interface ResumeApplyInput<R> {
41
41
  export interface ResumeApplyResult {
42
42
  /** The screen's `additionalContext` for the wake message, when a screen ran and supplied one. */
43
43
  wakeHookContext: string | undefined;
44
+ /** The wake message the leg delivers: the validated one, or as the screen handed it on (`prompt.submit` rewrote its text). */
45
+ wakeMessage: Omit<PendingSteerEntry, "seq"> | undefined;
46
+ /** Who rewrote the wake message's text, in the order they did; absent when nobody did. */
47
+ wakeRewrittenBy?: readonly string[];
44
48
  /** The resumed leg's bus, when the wake-message screen made this rung admit it (the leg adopts it). */
45
49
  legMods?: LegMods;
46
50
  /** The approval lane's twin WITH its minted settlement record (undefined on every other lane). */