@sema-agent/core 7.60.0 → 7.62.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -17,14 +17,15 @@ export { DEFAULT_CHARS_PER_TOKEN, DEFAULT_CLAMP_TOLERANCE, DEFAULT_COMPACTION_SE
17
17
  export { SKILL_RETENTION_PER_SKILL_MAX_CHARS, SKILL_RETENTION_TOTAL_MAX_CHARS, SKILL_RETENTION_TRUNCATION_MARKER, formatFileOperations, formatPersistedOutputRefs, readCompactionActiveTools, readRetainedInvokedSkills, renderInvokedSkillsRetention, } from "../engine/compaction/utils.js";
18
18
  export { NodeExecutionEnv } from "../engine/execution-env/node-execution-env.js";
19
19
  export { StoredSession, buildSessionContext } from "../engine/session/session.js";
20
- export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, readIncarnationCell, readOwnerCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
20
+ export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
21
21
  export { validateEntriesForImport, StreamingImportValidator } from "../engine/session/import-validate.js";
22
- export { BaseSessionStorage, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
22
+ export { BaseSessionStorage, entryParentLinks, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
23
23
  export { InMemorySessionStorage } from "../engine/session/memory-storage.js";
24
24
  export { InMemorySessionRepo } from "../engine/session/memory-repo.js";
25
25
  export { uuidv7 } from "../engine/session/uuid.js";
26
26
  export { ParentChainGuard } from "../engine/session/parent-chain-guard.js";
27
- export type { ForkPoint } from "../engine/session/path-to-root.js";
27
+ export type { ForkPoint, ReplayLoss } from "../engine/session/path-to-root.js";
28
+ export { LineageBreak, pathToRoot, replayLossText } from "../engine/session/path-to-root.js";
28
29
  export { findUnansweredToolBatch, readToolCallArguments } from "../engine/loop/agent-loop.js";
29
30
  export { SessionError } from "../engine/harness/types.js";
30
31
  export type { AnnouncedAdvisorState, AnnouncedListingSnapshot, AnnouncedListingSnapshotInput, AnnouncedMcpFailure } from "../engine/harness/types.js";
@@ -5,13 +5,14 @@ export { DEFAULT_CHARS_PER_TOKEN, DEFAULT_CLAMP_TOLERANCE, DEFAULT_COMPACTION_SE
5
5
  export { SKILL_RETENTION_PER_SKILL_MAX_CHARS, SKILL_RETENTION_TOTAL_MAX_CHARS, SKILL_RETENTION_TRUNCATION_MARKER, formatFileOperations, formatPersistedOutputRefs, readCompactionActiveTools, readRetainedInvokedSkills, renderInvokedSkillsRetention, } from "../engine/compaction/utils.js";
6
6
  export { NodeExecutionEnv } from "../engine/execution-env/node-execution-env.js";
7
7
  export { StoredSession, buildSessionContext } from "../engine/session/session.js";
8
- export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, readIncarnationCell, readOwnerCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
8
+ export { assertForkTarget, compareOccupants, forkRowCells, frozenRow, getEntriesToFork, importRowCells, incarnationCell, ownerCell, placementCellToWrite, readIncarnationCell, readOwnerCell, readPlacementCell, rowExpectationMissed, sessionRowMatches } from "../engine/session/repo-utils.js";
9
9
  export { validateEntriesForImport, StreamingImportValidator } from "../engine/session/import-validate.js";
10
- export { BaseSessionStorage, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
10
+ export { BaseSessionStorage, entryParentLinks, leafIdAfterEntry, resolveLeafId, sessionLogMarkOf } from "../engine/session/storage-base.js";
11
11
  export { InMemorySessionStorage } from "../engine/session/memory-storage.js";
12
12
  export { InMemorySessionRepo } from "../engine/session/memory-repo.js";
13
13
  export { uuidv7 } from "../engine/session/uuid.js";
14
14
  export { ParentChainGuard } from "../engine/session/parent-chain-guard.js";
15
+ export { LineageBreak, pathToRoot, replayLossText } from "../engine/session/path-to-root.js";
15
16
  export { findUnansweredToolBatch, readToolCallArguments } from "../engine/loop/agent-loop.js";
16
17
  export { SessionError } from "../engine/harness/types.js";
17
18
  export { normalizeGitAnnouncement } from "../engine/harness/types.js";
@@ -5,5 +5,6 @@
5
5
  * llm-core); the facade stays so consumers never notice which side a symbol lives on.
6
6
  */
7
7
  export { createAssistantMessageEventStream, DATA_LABEL_UNSAFE, ensureToolTurnInvariants, findToolByName, isTextBlock, MODEL_OUTPUT_INVALID_CAUSES, quoteDataLabel, renderContentBlock, renderUserAttachmentView, snapshotActorAssertion, stampStreamDrops, streamDropsOf, stripEngineMetadata, TOOL_TURN_INCOMPLETE_CAUSES, TOOL_TURN_REPAIR_DROPS, toolNameIndex, userAttachmentOf } from "../engine/llm/index.js";
8
- export type { ActorAssertion, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, UserMessageAttachment, AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ModelOutputInvalid, ModelOutputInvalidCause, OutputLimit, ResilienceOptions, RouteAdjudication, RouteCredential, RouteCredentialSource, RoutePairingConfig, RoutePairingPosture, RouteRefusalCode, RouteRefusalDetail, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolDescriptionVariant, ToolResultMessage, StreamDrop, StreamDropCause, ToolTurnIncompleteCause, ToolTurnRepair, Usage, UserMessage, } from "../engine/llm/index.js";
8
+ export type { ActorAssertion, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, UserMessageAttachment, AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ModelOutputInvalid, ModelOutputInvalidCause, OutputLimit, ResilienceOptions, RouteAdjudication, RouteCredential, RouteCredentialSource, RoutePairingConfig, RoutePairingPosture, RouteRefusalCode, RouteRefusalDetail, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolDescriptionVariant, ToolResultMessage, StreamDrop, StreamDropCause, ToolTurnIncompleteCause, ToolTurnRepair, Usage, UserMessage, RowRewrittenBy, } from "../engine/llm/index.js";
9
9
  export type { RejectedImageRemoval } from "../engine/llm/rejected-images.js";
10
+ export { MEDIA_REMOVED_REASONS, mediaRemovedPlaceholder, type MediaRemovedReason } from "../engine/llm/media-removed.js";
@@ -1 +1,2 @@
1
1
  export { createAssistantMessageEventStream, DATA_LABEL_UNSAFE, ensureToolTurnInvariants, findToolByName, isTextBlock, MODEL_OUTPUT_INVALID_CAUSES, quoteDataLabel, renderContentBlock, renderUserAttachmentView, snapshotActorAssertion, stampStreamDrops, streamDropsOf, stripEngineMetadata, TOOL_TURN_INCOMPLETE_CAUSES, TOOL_TURN_REPAIR_DROPS, toolNameIndex, userAttachmentOf } from "../engine/llm/index.js";
2
+ export { MEDIA_REMOVED_REASONS, mediaRemovedPlaceholder } from "../engine/llm/media-removed.js";
@@ -11,7 +11,7 @@
11
11
  * **无任何 commit/accept 副作用**(纯 loop,同 runRepairLoop SAFE-tier 永不 `fixed`)。要 accept,caller 自走
12
12
  * design/77 Gate-1 out-of-process oracle 隔离边界,不在 goal helper 开后门。
13
13
  */
14
- import type { RunnerSelfSeat } from "../core/runner/contracts.js";
14
+ import type { RunInternals, RunnerSelfSeat } from "../core/runner/contracts.js";
15
15
  import type { CheckpointToken } from "../core/checkpoint-store.js";
16
16
  import type { GateKind, PAUSE_REGISTRY } from "../core/pause-registry.js";
17
17
  import type { PausedCause, TaskResult, TaskSpec } from "../core/types.js";
@@ -124,6 +124,10 @@ export declare const DECLARE_DONE_TOOL_NAME = "DeclareDone";
124
124
  * Only `declare_done` AND `doneCheck.done` → `achieved` (surfaced, NEVER auto-accepted, G1). A rejected
125
125
  * doneCheck feeds its reason back (fenced) and continues. Bounded by maxIterations / budget / wall-clock /
126
126
  * cancel; a durable pause (suspended/needs_review) is a hard boundary that surfaces the checkpointToken.
127
+ *
128
+ * `internals` is the trusted run-scoped channel of the caller, forwarded to every iteration (the shape the verification gate
129
+ * takes): a goal run inside a delegated leg keeps the delegation fact and its caller's author. The first iteration hands over the
130
+ * caller's goal and carries the caller's author; every later one is this loop's own words (`engine`).
127
131
  */
128
- export declare function runGoal(runner: RunnerSelfSeat, spec: GoalSpec): Promise<GoalResult>;
132
+ export declare function runGoal(runner: RunnerSelfSeat, spec: GoalSpec, internals?: RunInternals): Promise<GoalResult>;
129
133
  export {};
@@ -1,6 +1,8 @@
1
1
  import { createHash, randomUUID } from "node:crypto";
2
2
  import { Type } from "typebox";
3
3
  import { delimitUntrusted } from "../core/untrusted-text.js";
4
+ import { recipeContinuationLeg } from "../core/input-author.js";
5
+ import { legTaskIdOf } from "../core/leg-identity.js";
4
6
  import { isDurablePause, pauseFamily } from "../agents/suspend-guard.js";
5
7
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
6
8
  export const DECLARE_DONE_TOOL_NAME = "DeclareDone";
@@ -57,7 +59,7 @@ function raceAbortReject(p, signal) {
57
59
  });
58
60
  });
59
61
  }
60
- export async function runGoal(runner, spec) {
62
+ export async function runGoal(runner, spec, internals) {
61
63
  if (!Number.isFinite(spec.maxIterations) || spec.maxIterations < 1) {
62
64
  throw new Error(`runGoal: maxIterations must be a finite number ≥ 1 (got ${spec.maxIterations})`);
63
65
  }
@@ -108,7 +110,7 @@ export async function runGoal(runner, spec) {
108
110
  if (verificationKind === "mechanical" && status !== "suspended" && status !== "needs_review") {
109
111
  runner.emitTaskOutcome?.({
110
112
  taskSignature: spec.taskSignature ?? `goal:${objectiveHash}`,
111
- runId: r.result?.taskId ?? sessionId,
113
+ runId: r.result?.taskId ?? legTaskIdOf(spec.taskSpec, internals, sessionId),
112
114
  model: r.result?.model,
113
115
  verificationKind: "mechanical",
114
116
  status,
@@ -140,7 +142,8 @@ export async function runGoal(runner, spec) {
140
142
  const tools = hasOutputSchema
141
143
  ? spec.taskSpec.tools
142
144
  : [...(spec.taskSpec.tools ?? []), createDeclareDoneTool(doneRef)];
143
- const result = await runner.runTask({ ...spec.taskSpec, sessionId, objective, tools, signal: goalSignal }, { goalMode: true });
145
+ const roundInternals = { ...internals, goalMode: true };
146
+ const result = await runner.runTask({ ...spec.taskSpec, sessionId, objective, tools, signal: goalSignal }, iteration === 1 ? roundInternals : recipeContinuationLeg(roundInternals));
144
147
  lastResult = result;
145
148
  cumulativeTokens += (result.stats.tokens ?? 0) + (result.stats.nested?.tokens ?? 0);
146
149
  spentCostMicroUsd += (result.stats.costMicroUsd ?? 0) + (result.stats.nested?.costMicroUsd ?? 0);
@@ -27,6 +27,9 @@ import { type WorkflowSizeGuideline } from "./workflow-size-guideline.js";
27
27
  * `run_workflow` are NOT callable — they live in RETIRED_TOOL_NAMES as validation data only (a call
28
28
  * under either gets a loud roster miss), so every model-visible mention must use THIS constant. */
29
29
  export declare const RUN_WORKFLOW_TOOL_NAME = "Workflow";
30
+ /** The refusal a workflow call gets where its completion would come back on no channel (no completion sink for the call,
31
+ * none on the mount, no deployment notifier): a workflow has no synchronous form, so nothing is started. */
32
+ export declare const WORKFLOW_NO_COMPLETION_CHANNEL = "a workflow run is not available here \u2014 no completion would come back from one on this mount (no notification channel and no deployment notifier is wired), and a workflow has no synchronous form. Do the work directly instead.";
30
33
  /**
31
34
  * design/98 §D.5 — the seam the deployment implements to RE-INVOKE the originating LLM when its workflow
32
35
  * finishes. Core calls `notify` once per run (at most once — `runId` dedup) with a REDACTED, BOUNDED summary;
@@ -58,21 +61,6 @@ export interface WorkflowCompletionNotifier {
58
61
  * repeat the diagnostics field's own drift history (the comment right above this one). */
59
62
  completionId?: string;
60
63
  }): Promise<void> | void;
61
- /**
62
- * Poll-then-also-notify dedup: the ORIGINATING session was served this run's TERMINAL
63
- * state IN-BAND (a `TaskOutput` poll through the task registry returned a non-running snapshot) —
64
- * the deployment should ack/drop any still-pending completion-inbox entry for (originatingSessionId,
65
- * runId), so a later stream-open doesn't re-deliver a `workflow_complete` the model already
66
- * consumed. Fired at most once per run, AFTER `notify` may already have enqueued (the whole point:
67
- * the poll usually wins the race in-turn). Optional; errors are swallowed. The shell-side same-process
68
- * seed dedup remains the belt — this is the durable/cross-restart half.
69
- */
70
- ackServed?(input: {
71
- runId: string;
72
- originatingSessionId?: string;
73
- sourceTaskId?: string;
74
- principal?: string;
75
- }): Promise<void> | void;
76
64
  }
77
65
  /** design/98 §D.6 — the deployment's hard CEILINGS for an LLM-authored workflow (the tool forces them; a
78
66
  * script may only tighten). All optional; sensible defaults bound a runaway script. */
@@ -176,7 +164,8 @@ export interface RunWorkflowToolDeps {
176
164
  onAgentSpawn?: (handle: WorkflowAgentHandle) => void;
177
165
  /** Tenant/grouping key for the run. */
178
166
  scope?: string;
179
- /** Completion re-invoke seam. */
167
+ /** Completion re-invoke seam — the deployment-channel term of the one background admission: with it, a call is
168
+ * admitted even when no completion sink resolves. */
180
169
  notifier?: WorkflowCompletionNotifier;
181
170
  /** The originating session id, threaded into every completion notify. */
182
171
  originatingSessionId?: string;
@@ -195,12 +184,16 @@ export interface RunWorkflowToolDeps {
195
184
  /** The host run tree's cross-boundary token (`RunInternals.crossBoundaryTree`), riding deps for the same auto-mounted-ctx reason as
196
185
  * `rootSessionId` above; handed to the workflow run so every workflow-spawned agent joins the host tree's state. */
197
186
  crossBoundaryTree?: import("../core/cross-boundary-taint.js").CrossBoundaryTreeToken;
187
+ /** The host run tree's owner seat (`RunInternals.delegationOwner`), riding deps for the same auto-mounted-ctx reason; handed to the
188
+ * workflow run so every workflow-spawned agent (and the children it delegates) reads the host tree's owner. */
189
+ delegationOwner?: import("../core/runner/delegation-owner.js").DelegationOwnerSeat;
198
190
  /** Process-local unified task registry. When present, RunWorkflow returns `task_id === runId` with a `w*` id. */
199
191
  taskRegistry?: TaskRegistry;
200
192
  /** design/115 P2 core slice: run-local task-notification sink for SDK event + live model XML injection.
201
193
  * design/373 §3.7: the sink accepts the injection tier — workflow terminals declare `"next"`
202
194
  * explicitly (a completion must reach a busy model at the boundary; the parameterless funnel
203
- * default is the EXTERNAL lane's `"later"` and no internal lane may lean on it). */
195
+ * default is the EXTERNAL lane's `"later"` and no internal lane may lean on it). A call carrying its run's lane
196
+ * delivers there instead; with neither this nor a {@link notifier}, a call is refused before anything starts. */
204
197
  taskNotification?: (notification: TaskNotificationPayload, opts?: {
205
198
  priority?: "now" | "next" | "later";
206
199
  }) => void;
@@ -268,6 +261,10 @@ export interface RunWorkflowToolDeps {
268
261
  /** The HOST task's effective working root — threaded into every spawned agent's trusted internals so a
269
262
  * TOC env factory can root the child at the parent's cwd (CC parity, 2026-07-03). */
270
263
  parentCwd?: string;
264
+ /** The HOST task's own placement target (what its env reported as its workspace settled) — the fence every agent the
265
+ * workflow spawns is minted under (`RunInternals.placementTarget`). Rides deps for the auto-mounted form (whose
266
+ * execute ctx carries none); a rich ctx's own `placementTarget` wins. */
267
+ placementTarget?: import("../core/remote-env.js").PlacementTarget;
271
268
  /** Call-time getter for the level a spawned agent runs at when neither the script, the agentType
272
269
  * definition nor the governance baseline set `thinking` (the mount folds the deployment's STATED
273
270
  * `roles.subagent.thinking` over the HOST task's current level — the child thinking seat's lower rungs).
@@ -3,11 +3,12 @@ import { defineTool, errorResult } from "../core/tools.js";
3
3
  import { governanceBaselineError, governanceBaselineProblem } from "./governance-baseline-validity.js";
4
4
  import { formatWorkflowRun, WORKFLOW_RECORD_WHOLE } from "../core/task-registry-shared.js";
5
5
  import { persistTaskArtifact } from "../core/tool-result-store.js";
6
- import { oweTerminalDelivery, resolveCompletionSink } from "../core/task-notification.js";
6
+ import { admitsBackgroundLaunch, oweTerminalDelivery, resolveCompletionSink } from "../core/task-notification.js";
7
7
  import { egressText, egressThrownText, boundedRedactedSummary } from "../core/untrusted-egress.js";
8
8
  import { withDelegationProvenance } from "../core/tool-policy.js";
9
9
  import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "../agents/launch-receipt-contract.js";
10
10
  import { startWorkflow } from "./workflow.js";
11
+ import { settledRunOf } from "../core/workflow-settled-run.js";
11
12
  import { WORKFLOW_AGENT_PARKED_ERROR_CODE, parkedAgentsOf } from "./workflow-types.js";
12
13
  import { checkpointStoreOfSeat } from "../core/checkpoint-seat.js";
13
14
  import { buildWorkflowPrimitives } from "./workflow-primitives.js";
@@ -30,8 +31,9 @@ import { parseWorkflowMeta, splitWorkflowMeta, workflowScriptReadsClockOrRandom
30
31
  import { mergeWorkflowArgs, normalizeStringArg } from "./workflow-script-store.js";
31
32
  import { workflowSizeGuidelineSection } from "./workflow-size-guideline.js";
32
33
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
33
- import { thrownText } from "../core/thrown-value.js";
34
+ import { readMember, thrownText } from "../core/thrown-value.js";
34
35
  export const RUN_WORKFLOW_TOOL_NAME = "Workflow";
36
+ export const WORKFLOW_NO_COMPLETION_CHANNEL = "a workflow run is not available here — no completion would come back from one on this mount (no notification channel and no deployment notifier is wired), and a workflow has no synchronous form. Do the work directly instead.";
35
37
  function stripCodeFences(s) {
36
38
  const t = s.trim();
37
39
  const m = /^```[A-Za-z]*\r?\n([\s\S]*?)\r?\n?```$/.exec(t);
@@ -70,18 +72,10 @@ function workflowRecordTeach(run, artifact) {
70
72
  const recordTeach = artifact.kind === "stored"
71
73
  ? `Full record (the result and every agent's row): read it with ReadToolResult (ref "${artifact.ref}") before assuming an empty or unexpected result.`
72
74
  : artifact.kind === "unconfirmed"
73
- ? "The full record (the result and every agent's row) could not be stored (the write failed or went unconfirmed), so no ref can read it back; TaskOutput reads it where mounted."
74
- : "The full record (the result and every agent's row) is not stored behind a ref (no offload store); TaskOutput reads it where mounted.";
75
+ ? "The full record (the result and every agent's row) could not be stored (the write failed or went unconfirmed), so no ref can read it back — it is not readable in this session."
76
+ : "The full record (the result and every agent's row) is not stored behind a ref (no offload store) — it is not readable in this session.";
75
77
  return `${rowsTeach}${recordTeach}`;
76
78
  }
77
- function completionIdFromRejection(err) {
78
- return workflowRunOfRejection(err)?.completionId;
79
- }
80
- function workflowRunOfRejection(err) {
81
- if (err === null || (typeof err !== "object" && typeof err !== "function"))
82
- return undefined;
83
- return err.workflowRun;
84
- }
85
79
  function workflowUsageBlock(run) {
86
80
  const agents = run.agents;
87
81
  const parked = parkedAgentsOf(agents);
@@ -125,10 +119,11 @@ const SCRIPT_ERROR_CODES = new Set([
125
119
  "workflow.budget_exceeded",
126
120
  ]);
127
121
  function failureSummary(err, runId) {
128
- const e = err;
129
- const code = typeof e?.code === "string" ? e.code : undefined;
122
+ const codeWord = readMember(err, "code");
123
+ const code = typeof codeWord === "string" ? codeWord : undefined;
130
124
  if (code === WORKFLOW_AGENT_PARKED_ERROR_CODE) {
131
- const msg = typeof e?.message === "string" ? egressText("same-principal", e.message) : "";
125
+ const parkedWords = readMember(err, "message");
126
+ const msg = typeof parkedWords === "string" ? egressText("same-principal", parkedWords) : "";
132
127
  return (`workflow parked (${code}): ${msg.length > 200 ? `${msg.slice(0, 200)}…` : msg} — it did not fail and is not finished` +
133
128
  (runId ? `; the diagnostics below name its record (the parked agent's row reads status "parked")` : "") +
134
129
  `; do not re-issue the same call — once the approval is decided, the deployment resumes this run${runId ? ` (resumeFromRunId: "${runId}")` : ""} and the script continues from the parked call`);
@@ -136,8 +131,9 @@ function failureSummary(err, runId) {
136
131
  const guide = runId
137
132
  ? `; which agents failed is in the diagnostics below; after fixing, re-invoke with resumeFromRunId: "${runId}" (completed agents replay from the journal)`
138
133
  : "";
139
- if (code && SCRIPT_ERROR_CODES.has(code) && typeof e?.message === "string") {
140
- const msg = egressText("same-principal", e.message);
134
+ const scriptWords = code && SCRIPT_ERROR_CODES.has(code) ? readMember(err, "message") : undefined;
135
+ if (code && typeof scriptWords === "string") {
136
+ const msg = egressText("same-principal", scriptWords);
141
137
  return `workflow failed (${code}): ${msg.length > 200 ? `${msg.slice(0, 200)}…` : msg}${guide}`;
142
138
  }
143
139
  return `${code && code.startsWith("workflow.") ? `workflow failed (${code})` : "workflow failed"}${guide}`;
@@ -360,10 +356,9 @@ async function mountRunWorkflowTool(d) {
360
356
  "role.\n" +
361
357
  "\n" +
362
358
  "Don't race. After launching, you know nothing about what the workflow found. Never fabricate or predict its " +
363
- "results in any format — not as prose, summary, or structured output. When a completion notifier is wired " +
364
- "(the launch note will say so) END YOUR TURN and wait — the notification carries the result; poll " +
365
- "TaskOutput(task_id) only when the user asks for progress. If the user asks a follow-up before it lands, " +
366
- "give status, not a guess." +
359
+ "results in any format — not as prose, summary, or structured output. END YOUR TURN and wait — the completion " +
360
+ "notification carries the result and each agent's outcome (the launch note says how it reaches you). If the " +
361
+ "user asks a follow-up before it lands, give status, not a guess." +
367
362
  (namedWorkflowSection !== undefined ? `\n\n${namedWorkflowSection}` : "") +
368
363
  sizeGuidelineSection,
369
364
  parameters: Type.Object({
@@ -398,6 +393,9 @@ async function mountRunWorkflowTool(d) {
398
393
  const rawResume = rawArgs.resumeFromRunId;
399
394
  const resumeFromRunId = typeof rawResume === "string" && rawResume.length > 0 ? rawResume : undefined;
400
395
  const sourceTaskId = ctx.taskId ?? d.sourceTaskId;
396
+ const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
397
+ if (!admitsBackgroundLaunch(completionSink, d.notifier !== undefined))
398
+ return structuredError(WORKFLOW_NO_COMPLETION_CHANNEL);
401
399
  const hostSeat = parentSpecSeatOfCtx(ctx) ?? d.parentSpecSeat;
402
400
  const detachedSeat = hostSeat !== undefined ? stripSpawnTurnQuestionFace(hostSeat) : undefined;
403
401
  const parentSpecSeat = detachedSeat?.spec;
@@ -519,7 +517,9 @@ async function mountRunWorkflowTool(d) {
519
517
  ...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
520
518
  ...((ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? d.rootSessionId ?? d.originatingSessionId } : {}),
521
519
  ...((ctx.placementRoot ?? d.placementRoot) !== undefined ? { placementRoot: ctx.placementRoot ?? d.placementRoot } : {}),
520
+ ...((ctx.placementTarget ?? d.placementTarget) !== undefined ? { placementTarget: ctx.placementTarget ?? d.placementTarget } : {}),
522
521
  ...((ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree) !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren ?? d.crossBoundaryTree } : {}),
522
+ ...((ctx.delegationOwner ?? d.delegationOwner) !== undefined ? { delegationOwner: ctx.delegationOwner ?? d.delegationOwner } : {}),
523
523
  ...(workflowTaskId !== undefined ? { runId: workflowTaskId } : {}),
524
524
  journalStore: d.journalStore,
525
525
  ...(resumeFromRunId !== undefined ? { resumeFromRunId } : {}),
@@ -593,19 +593,8 @@ async function mountRunWorkflowTool(d) {
593
593
  ...(taskOwner !== undefined ? { owner: taskOwner } : {}),
594
594
  ...(taskScope !== undefined ? { scope: taskScope } : {}),
595
595
  ...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
596
- onServedTerminal: () => {
597
- void Promise.resolve()
598
- .then(() => d.notifier?.ackServed?.({
599
- runId,
600
- ...(d.originatingSessionId !== undefined ? { originatingSessionId: d.originatingSessionId } : {}),
601
- ...(sourceTaskId !== undefined ? { sourceTaskId } : {}),
602
- ...(principal !== undefined ? { principal } : {}),
603
- }))
604
- .catch(() => { });
605
- },
606
596
  });
607
597
  }
608
- const completionSink = resolveCompletionSink(ctx.onTaskNotification, d.taskNotification);
609
598
  oweTerminalDelivery(completionSink, { task_id: runId, task_type: "workflow" });
610
599
  {
611
600
  let notified = false;
@@ -641,7 +630,7 @@ async function mountRunWorkflowTool(d) {
641
630
  const recordOf = async (run) => {
642
631
  const artifact = await persistTaskArtifact(d.taskArtifacts, runId, formatWorkflowRun(run, WORKFLOW_RECORD_WHOLE).content);
643
632
  if (artifact.kind === "stored")
644
- d.taskRegistry?.recordArtifactRef(runId, artifact.ref, 0);
633
+ d.taskRegistry?.recordArtifactRef(runId, artifact.ref, run.completionId);
645
634
  return workflowRecordTeach(run, artifact);
646
635
  };
647
636
  handle.done
@@ -656,17 +645,29 @@ async function mountRunWorkflowTool(d) {
656
645
  diagnostics: workflowDiagnostics(runId, d.journalStore?.locator?.(runId, res.run.scope), res.run.resume?.journalEntries === 0, await recordOf(res.run).catch(() => "This run's record could not be read.")),
657
646
  completionId: res.run.completionId,
658
647
  }), async (err) => {
659
- const carried = workflowRunOfRejection(err);
660
- const failedRun = (carried?.id === runId && Array.isArray(carried.agents) ? carried : undefined) ?? (d.store !== undefined ? ((await d.store.get(runId).catch(() => null)) ?? undefined) : undefined);
661
- const record = failedRun !== undefined ? await recordOf(failedRun).catch(() => "This run's record could not be read.") : "This failure carries no record of the run's agents and no run store holds one.";
648
+ let parts = {
649
+ summary: failureSummary(undefined, runId),
650
+ diagnostics: workflowDiagnostics(runId, undefined, undefined, "This run's record could not be read."),
651
+ };
652
+ try {
653
+ const failedRun = settledRunOf(handle.done);
654
+ const record = (failedRun !== undefined ? await recordOf(failedRun).catch(() => undefined) : undefined) ?? "This run's record could not be read.";
655
+ const summary = failureSummary(err, runId);
656
+ const settleId = failedRun?.completionId;
657
+ parts = {
658
+ summary,
659
+ diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
660
+ ...(settleId !== undefined ? { completionId: settleId } : {}),
661
+ };
662
+ }
663
+ catch {
664
+ }
662
665
  fire({
663
666
  task_id: runId,
664
667
  task_type: "workflow",
665
668
  ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}),
666
669
  status: "failed",
667
- summary: failureSummary(err, runId),
668
- diagnostics: workflowDiagnostics(runId, undefined, undefined, record),
669
- ...(completionIdFromRejection(err) !== undefined ? { completionId: completionIdFromRejection(err) } : {}),
670
+ ...parts,
670
671
  });
671
672
  })
672
673
  .catch(() => { });
@@ -680,20 +681,12 @@ async function mountRunWorkflowTool(d) {
680
681
  ...(persistedScriptPath !== undefined ? { scriptPath: persistedScriptPath } : {}),
681
682
  handling: `${launchReceiptNoQuoteClause(" (the ids above, and scriptPath when present)")} ${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE}`,
682
683
  note: (() => {
683
- const pollExpr = d.taskRegistry ? `TaskOutput({ task_id: "${runId}" })` : undefined;
684
684
  const journalRef = d.journalStore?.locator?.(runId, taskScope ?? d.scope ?? "");
685
- const carries = pollExpr
686
- ? ` A terminal ${pollExpr} reply carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`
687
- : "";
685
+ const carries = ` The completion notification carries its result AND per-agent rows — read them${journalRef !== undefined ? ` (full journal: ${journalRef})` : ""} before assuming an empty or unexpected result.`;
688
686
  if (d.notifier) {
689
- return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll unless the user asks for progress.${carries}`;
690
- }
691
- if (completionSink) {
692
- return `The workflow runs asynchronously. Its completion is injected into THIS session if it is still active; if you have ended your turn and hear nothing, ${pollExpr ? `poll ${pollExpr}` : "there is no poll path wired"}.${carries}`;
687
+ return `The workflow runs asynchronously. You will be NOTIFIED when it completes (the notification carries the result). End your turn and wait — do not poll.${carries}`;
693
688
  }
694
- return pollExpr
695
- ? `The workflow runs asynchronously and no completion notifier is wired. Poll ${pollExpr}.${carries}`
696
- : "The workflow runs asynchronously; no completion notifier is wired and no status/poll path is available.";
689
+ return `The workflow runs asynchronously. Its completion is delivered to this session (its next turn, if this one has ended) — end your turn and wait.${carries}`;
697
690
  })(),
698
691
  }),
699
692
  };
@@ -365,8 +365,8 @@ export interface WorkflowRun {
365
365
  * Absent on `completed` runs (their per-agent failures ride `agentFailures` + each `WorkflowAgentRun.errorCode`). */
366
366
  errorCode?: string;
367
367
  /** The script's RETURN VALUE, bounded + redacted at completion time (same egress
368
- * discipline as the notifier `result`), so a terminal `TaskOutput` poll can hand the
369
- * model the result instead of sending it in poll circles. Absent on failed runs and runs recorded by
368
+ * discipline as the notifier `result`), so a terminal host poll and the completion record carry the
369
+ * result. Absent on failed runs and runs recorded by
370
370
  * older engine versions. */
371
371
  result?: string;
372
372
  /** NH-1: the FULL return value (redacted, capped at {@link WORKFLOW_RESULT_FULL_MAX}), set ONLY
@@ -348,9 +348,16 @@ export interface RunWorkflowOptions {
348
348
  * placed at the ladder/gate root. Absent ⇒ nothing extra travels (the rootSessionId chain is the
349
349
  * placement root through prepare's mint middle segment). */
350
350
  placementRoot?: string;
351
+ /** The host run's own placement target (threaded by the run-workflow tool: what the host leg's env reported as its
352
+ * workspace settled) — every workflow-spawned agent, on either spawn leg, is minted under it as its fence
353
+ * (`RunInternals.placementTarget`). Absent ⇒ the agents carry no fence. */
354
+ placementTarget?: import("../core/remote-env.js").PlacementTarget;
351
355
  /** The host run tree's cross-boundary token (`RunInternals.crossBoundaryTree`, threaded by the run-workflow tool): every
352
356
  * workflow-spawned agent joins the tree it names, so a bit a workflow agent sets is read by the host and its siblings. */
353
357
  crossBoundaryTree?: import("../core/cross-boundary-taint.js").CrossBoundaryTreeToken;
358
+ /** The host run tree's owner seat (`RunInternals.delegationOwner`, threaded by the run-workflow tool): every workflow-spawned agent
359
+ * holds it, so a child it delegates records the host tree's owner. */
360
+ delegationOwner?: import("../core/runner/delegation-owner.js").DelegationOwnerSeat;
354
361
  /** design/149 — the PROCESS-level child observer (same seam as
355
362
  * {@link import("../core/types.js").RunnerDeps.onBackgroundChildEvent}). When set, every workflow
356
363
  * agent emits spawn/tick/terminal {@link import("../core/types.js").BackgroundChildEvent} frames with a
@@ -15,7 +15,7 @@ import { combinePolicies, createAllowDenyPolicy } from "../core/tool-policy.js";
15
15
  import { createSafeNotifier } from "../core/safe-notify.js";
16
16
  import { callKeyOrdinal, clampRunIdText, oversizeJournalResult, journalOversizeTombstone, readWorkflowJournalEntry, JOURNAL_OVERSIZE_ERROR_CODE, MAX_JOURNAL_RESULT_BYTES, WorkflowJournalIncompatibleError, } from "../core/workflow-journal-store.js";
17
17
  import { isWorkflowRunActive, closeWorkflowChannel, markWorkflowActive, publishWorkflowEvent, registerWorkflowParkDelivery } from "./workflow-observe.js";
18
- import { isDurablePause } from "../agents/suspend-guard.js";
18
+ import { isDurablePause, resumeNeverStarted } from "../agents/suspend-guard.js";
19
19
  import { RUNNING_AGENT_OBSERVE_EVERY_BEATS } from "../config/defaults.js";
20
20
  import { boundInputHashOf } from "../core/canonical-json.js";
21
21
  import { boundedRedactedSummary, egressThrownText } from "../core/untrusted-egress.js";
@@ -30,6 +30,7 @@ import { WorkflowBudgetExceededError, WorkflowNestingError, WorkflowAgentBlocked
30
30
  import { WorkflowScriptError } from "./workflow-meta.js";
31
31
  import { firstByteLaneKnobMs, STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS } from "../brain/timeout.js";
32
32
  import { asThrownError, isErrorLike, readMember, thrownIs, thrownName, thrownText } from "../core/thrown-value.js";
33
+ import { bindSettledRun } from "../core/workflow-settled-run.js";
33
34
  export * from "./workflow-types.js";
34
35
  const MAX_TRANSCRIPT_CHARS = 4000;
35
36
  const WORKFLOW_RESULT_MAX = 4000;
@@ -727,6 +728,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
727
728
  };
728
729
  const spawnAttribution = {
729
730
  isDelegatedChild: true,
731
+ objectiveAuthor: "workflow",
730
732
  ...(opts.questionFaceStripped === true ? { questionFaceStripped: true } : {}),
731
733
  ...(opts.interactionPosture !== undefined ? { parentInteractionPosture: opts.interactionPosture } : {}),
732
734
  ...(opts.parentToolCallId !== undefined ? { parentToolCallId: opts.parentToolCallId } : {}),
@@ -738,7 +740,9 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
738
740
  ...(agentCeiling !== undefined ? { toolCeiling: agentCeiling } : {}),
739
741
  ...((opts.rootSessionId ?? opts.originatingSessionId) !== undefined ? { rootSessionId: opts.rootSessionId ?? opts.originatingSessionId } : {}),
740
742
  ...(opts.placementRoot !== undefined ? { placementRoot: opts.placementRoot } : {}),
743
+ ...(opts.placementTarget !== undefined ? { placementTarget: opts.placementTarget } : {}),
741
744
  ...(opts.crossBoundaryTree !== undefined ? { crossBoundaryTree: opts.crossBoundaryTree } : {}),
745
+ ...(opts.delegationOwner !== undefined ? { delegationOwner: opts.delegationOwner } : {}),
742
746
  ...(opts.originatingSessionId !== undefined ? { parentSessionId: opts.originatingSessionId } : {}),
743
747
  };
744
748
  const captureFloorSeatsNow = async () => {
@@ -1060,7 +1064,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
1060
1064
  return p;
1061
1065
  };
1062
1066
  const degradedParkMaterial = (cp) => ({
1063
- taskId: cp.sourceTaskId ?? "",
1067
+ taskId: cp.sourceSessionId ?? "",
1064
1068
  sessionId: cp.sessionId,
1065
1069
  result: "",
1066
1070
  stats: { turns: 0, tokens: 0, costMicroUsd: 0, usageMissing: true },
@@ -1164,7 +1168,6 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
1164
1168
  throw Object.assign(new Error("agent.checkpointStore is not the store this run's children park in (the workflow's resolved checkpoint seat, RunWorkflowOptions.checkpointStore) — wire the one store, or leave the field unset and let the seat ride."), { code: "config.invalid_checkpoint_store" });
1165
1169
  }
1166
1170
  };
1167
- const driveNeverStarted = (r) => r.terminal.kind === "failed" && (r.terminal.code === "resume.reopened_unstarted" || r.terminal.code === "resume.reopen_failed_unstarted");
1168
1171
  const isPausedResult = (r) => isDurablePause(r.terminal);
1169
1172
  let isolationAdvised = false;
1170
1173
  const adviseIsolationIfConcurrent = (opts) => {
@@ -2151,7 +2154,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
2151
2154
  }
2152
2155
  if (finalized)
2153
2156
  return result;
2154
- const unstartedDrive = drive !== undefined && driveNeverStarted(result) ? drive : undefined;
2157
+ const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
2155
2158
  if (unstartedDrive !== undefined)
2156
2159
  emitRunLog(`[park] the parked leg "${label}" was driven but the approved action never started (${result.terminal.kind === "failed" ? result.terminal.code : ""}); the park stands.`);
2157
2160
  const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
@@ -2399,7 +2402,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
2399
2402
  releaseLeg();
2400
2403
  if (finalized)
2401
2404
  return result;
2402
- const unstartedDrive = drive !== undefined && driveNeverStarted(result) ? drive : undefined;
2405
+ const unstartedDrive = drive !== undefined && resumeNeverStarted(result) ? drive : undefined;
2403
2406
  if (unstartedDrive !== undefined)
2404
2407
  emitRunLog(`[park] the parked leg "${label}" was driven but the approved action never started (${result.terminal.kind === "failed" ? result.terminal.code : ""}); the park stands.`);
2405
2408
  const parkOn = isPausedResult(result) ? { paused: result, live: true } : unstartedDrive !== undefined ? { paused: unstartedDrive.paused, live: false } : undefined;
@@ -2780,13 +2783,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
2780
2783
  run.error = egressThrownText("same-principal", err);
2781
2784
  closeAbandonedAgents(run.endedAt);
2782
2785
  {
2783
- let thrownCode;
2784
- try {
2785
- thrownCode = err !== null && (typeof err === "object" || typeof err === "function") ? err.code : undefined;
2786
- }
2787
- catch {
2788
- thrownCode = undefined;
2789
- }
2786
+ const thrownCode = readMember(err, "code");
2790
2787
  const firstFailed = run.agents
2791
2788
  .filter((a) => a.status === "failed" && typeof a.errorCode === "string" && a.errorCode !== "")
2792
2789
  .sort((a, b) => (a.endedAt ?? Number.POSITIVE_INFINITY) - (b.endedAt ?? Number.POSITIVE_INFINITY))[0];
@@ -2850,6 +2847,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
2850
2847
  closeWorkflowChannel(runId);
2851
2848
  }
2852
2849
  })();
2850
+ bindSettledRun(done, run);
2853
2851
  return {
2854
2852
  runId,
2855
2853
  done,
@@ -1,9 +1,11 @@
1
1
  import { join } from "node:path";
2
- import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, assertBackgroundAgentReapOptions, queryBackgroundAgents, } from "../../core/background-agent-store.js";
2
+ import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, receiveBackgroundAgentReapOptions, queryBackgroundAgents, } from "../../core/background-agent-store.js";
3
3
  import { SharedLedgerTable } from "./shared-ledger.js";
4
4
  import { guardCorruptSink } from "./corrupt-read-sink.js";
5
5
  import { assertAdoptionBootGate } from "./adoption/marker.js";
6
- import { receiveOptions } from "../../core/own-property-receipt.js";
6
+ import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
7
+ import { readLedgerTuning } from "./ledger-tuning.js";
8
+ const FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0 });
7
9
  const isAgentRow = (x) => x !== null && typeof x === "object" && typeof x.handle === "string" && typeof x.scope === "string";
8
10
  const agentLedgers = new SharedLedgerTable({
9
11
  label: "background-agent ledger",
@@ -32,10 +34,11 @@ export class FileBackgroundAgentStore {
32
34
  return this.ledger.rows;
33
35
  }
34
36
  constructor(root, options) {
35
- const opts = receiveOptions(options, "FileBackgroundAgentStore");
37
+ const opts = receiveOptions(options, "FileBackgroundAgentStore", FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS);
36
38
  assertAdoptionBootGate(root, "FileBackgroundAgentStore");
37
- this.fsyncEnabled = opts.fsync !== false;
38
- this.compactEvery = opts.compactEvery ?? 1000;
39
+ const tuning = readLedgerTuning(opts, "FileBackgroundAgentStore", "FileBackgroundAgentStore options");
40
+ this.fsyncEnabled = tuning.fsync;
41
+ this.compactEvery = tuning.compactEvery;
39
42
  const dir = join(root, "background-agents");
40
43
  this.ledger = agentLedgers.acquire({
41
44
  dir,
@@ -128,18 +131,18 @@ export class FileBackgroundAgentStore {
128
131
  });
129
132
  }
130
133
  async reap(scope, now, opts) {
131
- assertBackgroundAgentReapOptions(opts);
132
- if (!opts || (opts.maxAgeMs === undefined && opts.keep === undefined && opts.staleRunningMaxAgeMs === undefined))
134
+ const policy = receiveBackgroundAgentReapOptions(opts);
135
+ if (policy.maxAgeMs === undefined && policy.keep === undefined && policy.staleRunningMaxAgeMs === undefined)
133
136
  return 0;
134
137
  const changed = new Set();
135
- if (opts.staleRunningMaxAgeMs !== undefined) {
138
+ if (policy.staleRunningMaxAgeMs !== undefined) {
136
139
  const staleCandidates = [...this.rows.entries()]
137
- .filter(([, r]) => r.scope === scope && r.status === "running" && now - r.updatedAt > opts.staleRunningMaxAgeMs)
140
+ .filter(([, r]) => r.scope === scope && r.status === "running" && now - r.updatedAt > policy.staleRunningMaxAgeMs)
138
141
  .map(([k]) => k);
139
142
  for (const k of staleCandidates) {
140
143
  const flipped = await this.withLock(k, () => {
141
144
  const live = this.rows.get(k);
142
- if (!live || live.status !== "running" || now - live.updatedAt <= opts.staleRunningMaxAgeMs)
145
+ if (!live || live.status !== "running" || now - live.updatedAt <= policy.staleRunningMaxAgeMs)
143
146
  return false;
144
147
  const next = structuredClone(live);
145
148
  next.status = "failed";
@@ -160,14 +163,14 @@ export class FileBackgroundAgentStore {
160
163
  .filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
161
164
  .sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
162
165
  const doomed = new Map();
163
- if (opts.maxAgeMs !== undefined) {
166
+ if (policy.maxAgeMs !== undefined) {
164
167
  for (const [k, r] of terminal) {
165
- if ((r.settledAt ?? r.spawnedAt) < now - opts.maxAgeMs)
168
+ if ((r.settledAt ?? r.spawnedAt) < now - policy.maxAgeMs)
166
169
  doomed.set(k, { byAge: true });
167
170
  }
168
171
  }
169
- if (opts.keep !== undefined) {
170
- for (const [k] of terminal.slice(Math.max(0, opts.keep))) {
172
+ if (policy.keep !== undefined) {
173
+ for (const [k] of terminal.slice(Math.max(0, policy.keep))) {
171
174
  if (!doomed.has(k))
172
175
  doomed.set(k, { byAge: false });
173
176
  }
@@ -177,7 +180,7 @@ export class FileBackgroundAgentStore {
177
180
  const live = this.rows.get(k);
178
181
  if (!live || live.scope !== scope || live.status === "running" || live.status === "parked")
179
182
  return false;
180
- if (why.byAge && opts.maxAgeMs !== undefined && (live.settledAt ?? live.spawnedAt) >= now - opts.maxAgeMs)
183
+ if (why.byAge && policy.maxAgeMs !== undefined && (live.settledAt ?? live.spawnedAt) >= now - policy.maxAgeMs)
181
184
  return false;
182
185
  this.commit({ t: "delete", k });
183
186
  return true;
@@ -174,6 +174,8 @@ export declare class FileCheckpointStore implements CheckpointStore {
174
174
  private readonly ledger;
175
175
  private closed;
176
176
  private get cps();
177
+ /** The listing's memo of each replayed row object's verdict: a put or a replay holds a new object, so a replaced row is judged again. */
178
+ private readonly rowVerdicts;
177
179
  /** One-shot crash fault (mirrors `InMemoryCheckpointStore.testInjectFault`). */
178
180
  private fault;
179
181
  /** The guarded {@link FileCheckpointStoreOptions.onCorruptRead} seat (the ledger's replay and this store's projection share it). */