@sema-agent/core 7.60.0 → 7.61.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 (482) hide show
  1. package/CHANGELOG.md +605 -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 +61 -10
  6. package/dist/agents/cascade.js +60 -20
  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-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -11,7 +11,7 @@ import { registerMonitorLane, pollMonitorLane, stopMonitorLane } from "./task-re
11
11
  import { registerWorkflowLane, pollWorkflowLane, stopWorkflowLane } from "./task-registry-workflow.js";
12
12
  import { mintCompletionId, taskReadHandleText, canAccessWorkflowRun, formatWorkflowRun, clipTaskOutput, assertOwnership, sleepPollStep, statusFromBackground, rollSpoolText, accountDroppedBytes, renderSpoolBody, stdoutHeadingOf, REPLAY_FACE, SPOOL_REPLAY, INCREMENT_REPLAY, spoolDropNote, droppedGapNote, alreadyTerminalStopNote, terminalTaskSummary, TASK_OUTPUT_MAX_CHARS, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccess, DURABLE_AGENT_HANDLE_RE, } from "./task-registry-shared.js";
13
13
  export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
14
- import { TASK_OUTPUT_TOOL_NAME, TASK_STOP_TOOL_NAME, TASK_OUTPUT_MISSING_ID_MESSAGE, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, resolveTaskIdArg, REGISTRY_TASK_TOOL_CAPS, composeTaskOutputDescription, composeTaskOutputParams, composeTaskStopDescription, } from "./task-tool-shape.js";
14
+ import { TASK_STOP_TOOL_NAME, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, TASK_STOP_DESCRIPTION, resolveTaskIdArg } from "./task-tool-shape.js";
15
15
  import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, childSessionAnchorOf, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
16
16
  import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
17
17
  import { thrownText } from "./thrown-value.js";
@@ -26,7 +26,6 @@ function blockDeadline(timeoutMs, now) {
26
26
  const t = Math.min(BLOCK_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeoutMs ?? BLOCK_DEFAULT_TIMEOUT_MS)));
27
27
  return now + t;
28
28
  }
29
- const BLOCK_WAIT_WRITEOUT_RESERVE_MS = 5_000;
30
29
  const TASK_PREFIX = {
31
30
  background_bash: "b",
32
31
  workflow: "w",
@@ -93,11 +92,11 @@ function commandRecordSink(rowOf, record, guarded, sink) {
93
92
  const retained = row.spool !== undefined && row.spool.stdout.length + row.spool.stderr.length > 0 ? row.spool : undefined;
94
93
  if (row.taskArtifacts === undefined || retained === undefined)
95
94
  return sink(gap === "incomplete" ? { ...n, summary: n.summary + commandRecordGapNote(row, gap, undefined) } : n);
96
- const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, rolledExtraClause: "", drainNote: "" });
95
+ const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, drainNote: "" });
97
96
  void persistTaskArtifact(row.taskArtifacts, row.id, body).then((artifact) => {
98
97
  const ref = artifact.kind === "stored" ? artifact.ref : undefined;
99
98
  if (ref !== undefined)
100
- record(row.id, ref);
99
+ record(row.id, ref, n.completionId);
101
100
  guarded(() => sink(ref === undefined && gap === "missing" ? n : { ...n, summary: n.summary + commandRecordGapNote(row, gap, ref) }));
102
101
  });
103
102
  };
@@ -267,8 +266,8 @@ export class TaskRegistry {
267
266
  runningBackgroundAgentLabels(access) {
268
267
  return runningBackgroundAgentLabelsLane(this.core, access);
269
268
  }
270
- async pollBackgroundAgent(handle, deadline, signal, toolResultStore, sessionId, checkpointSeat) {
271
- return pollBackgroundAgentLane(handle, deadline, signal, toolResultStore, sessionId, checkpointSeat);
269
+ async pollBackgroundAgent(handle, deadline, signal, checkpointSeat) {
270
+ return pollBackgroundAgentLane(handle, deadline, signal, checkpointSeat);
272
271
  }
273
272
  async stopBackgroundAgent(handle) {
274
273
  return stopBackgroundAgentLane(this.core, handle);
@@ -318,7 +317,7 @@ export class TaskRegistry {
318
317
  return id;
319
318
  }
320
319
  commandRecordSink(sink) {
321
- return commandRecordSink((id) => this.handles.get(id), (id, ref) => this.recordArtifactRef(id, ref, 0), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
320
+ return commandRecordSink((id) => this.handles.get(id), (id, ref, completionId) => this.recordArtifactRef(id, ref, completionId), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
322
321
  }
323
322
  isBackgroundOutputFile(canonicalPath, access, env) {
324
323
  for (const handle of this.handles.values()) {
@@ -380,39 +379,6 @@ export class TaskRegistry {
380
379
  }
381
380
  return marked;
382
381
  }
383
- markStopSourceByShellId(shellId, source, env) {
384
- if (env === undefined)
385
- return;
386
- const sid = String(shellId);
387
- for (const [id, handle] of this.handles) {
388
- if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
389
- this.markStopSource(id, source);
390
- return;
391
- }
392
- }
393
- }
394
- clearPendingStopSourceByShellId(shellId, source, env) {
395
- const sid = String(shellId);
396
- const clear = (id) => {
397
- const handle = this.handles.get(id);
398
- if (!handle || handle.type !== "background_bash")
399
- return false;
400
- if (env !== undefined && handle.env !== env)
401
- return false;
402
- if (handle.status === "running" && handle.stopSource === source && handle.stoppedBy === undefined) {
403
- handle.stopSource = undefined;
404
- }
405
- return true;
406
- };
407
- if (env === undefined)
408
- return;
409
- for (const [id, handle] of this.handles) {
410
- if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
411
- clear(id);
412
- return;
413
- }
414
- }
415
- }
416
382
  getStopAttribution(id) {
417
383
  const handle = this.handles.get(id);
418
384
  if (!handle || (handle.type !== "background_agent" && handle.type !== "background_bash" && handle.type !== "monitor"))
@@ -424,11 +390,9 @@ export class TaskRegistry {
424
390
  getCompletionId(id) {
425
391
  return this.handles.get(id)?.completionId;
426
392
  }
427
- recordArtifactRef(id, ref, cycle) {
393
+ recordArtifactRef(id, ref, completionId) {
428
394
  const h = this.handles.get(id);
429
- if (h === undefined)
430
- return;
431
- if ((h.type === "background_agent" ? (h.reviveCycle ?? 0) : 0) !== cycle)
395
+ if (h === undefined || completionId === undefined || h.completionId !== completionId)
432
396
  return;
433
397
  h.artifactRef = ref;
434
398
  }
@@ -822,6 +786,8 @@ export class TaskRegistry {
822
786
  if (!ap.ok)
823
787
  spool.mirrorFailed = true;
824
788
  }
789
+ if (this.handles.get(id) !== handle || handle.status !== "running")
790
+ return stop();
825
791
  handle.status = statusFromBackground(r.value.status, r.value.exitCode);
826
792
  if (handle.status === "killed" && handle.stoppedBy === undefined) {
827
793
  handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
@@ -888,6 +854,7 @@ export class TaskRegistry {
888
854
  };
889
855
  handle.watcher = setInterval(() => void tick(), 1_000);
890
856
  handle.watcher.unref?.();
857
+ void tick();
891
858
  }
892
859
  runningShellIds(env) {
893
860
  const out = [];
@@ -923,7 +890,7 @@ export class TaskRegistry {
923
890
  if (handle.type === "background_bash")
924
891
  return this.pollBackgroundBash(handle, taskId, access, opts.filter, deadline, opts.signal);
925
892
  if (handle.type === "background_agent")
926
- return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.toolResultStore, access.sessionId, opts.checkpointSeat);
893
+ return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.checkpointSeat);
927
894
  if (handle.type === "monitor")
928
895
  return this.pollMonitor(handle, opts.filter, deadline, opts.signal);
929
896
  return this.pollWorkflow(handle, access, deadline, opts.signal);
@@ -964,7 +931,7 @@ export class TaskRegistry {
964
931
  state: ${agentStateSummary(agentState)}
965
932
  The durable record is still marked running (last update ${new Date(row.updatedAt).toISOString()}), but this engine instance is not executing it — the outcome is unknown here. If its host process is gone, a retention sweep (staleRunningMaxAgeMs) settles the record as interrupted.`;
966
933
  return {
967
- content: delimitUntrusted(`TaskOutput ${row.handle}`, body),
934
+ content: delimitUntrusted(`task ${row.handle}`, body),
968
935
  isError: true,
969
936
  details: {
970
937
  task_id: row.handle,
@@ -1164,7 +1131,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1164
1131
  }
1165
1132
  catch {
1166
1133
  return {
1167
- content: `Error (TaskOutput): invalid filter regex: ${filter}`,
1134
+ content: `Error (task poll): invalid filter regex: ${filter}`,
1168
1135
  details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status: "not_ready" },
1169
1136
  isError: true,
1170
1137
  };
@@ -1180,9 +1147,9 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1180
1147
  const shape = (text) => clipTaskOutput(rx ? text.split(/\r?\n/).filter((l) => rx.test(l)).join("\n") : text, handle.outputFile);
1181
1148
  const running = handle.status === "running";
1182
1149
  const retrieval = running && deadline !== undefined && Date.now() >= deadline ? "timeout" : "success";
1183
- const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, rolledExtraClause: "", drainNote: "" });
1150
+ const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, drainNote: "" });
1184
1151
  return {
1185
- content: delimitUntrusted(`TaskOutput ${handle.id}`, body),
1152
+ content: delimitUntrusted(`task ${handle.id}`, body),
1186
1153
  details: {
1187
1154
  task_id: handle.id,
1188
1155
  type: "background_bash",
@@ -1223,7 +1190,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1223
1190
  ? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}`
1224
1191
  : "";
1225
1192
  return {
1226
- content: `Error (TaskOutput): ${r.error.message}${salvaged}`,
1193
+ content: `Error (task poll): ${r.error.message}${salvaged}`,
1227
1194
  details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput ? { details: { replay: INCREMENT_REPLAY } } : {}), error: r.error.code },
1228
1195
  isError: true,
1229
1196
  };
@@ -1248,7 +1215,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1248
1215
  const body = `status: ${displayStatus}\n${droppedNote}--- ${stdoutHeadingOf(INCREMENT_REPLAY, droppedNote !== "")} ---\n${shape(stdout) || "(none)"}\n` +
1249
1216
  `--- ${REPLAY_FACE[INCREMENT_REPLAY].stderr} ---\n${shape(stderr) || "(none)"}`;
1250
1217
  return {
1251
- content: delimitUntrusted(`TaskOutput ${handle.id}`, body),
1218
+ content: delimitUntrusted(`task ${handle.id}`, body),
1252
1219
  details: {
1253
1220
  task_id: handle.id,
1254
1221
  type: "background_bash",
@@ -1354,66 +1321,12 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1354
1321
  }
1355
1322
  }
1356
1323
  export const defaultTaskRegistry = new TaskRegistry();
1357
- export function createTaskOutputTool(opts) {
1358
- const caps = { ...REGISTRY_TASK_TOOL_CAPS, notification: opts.notificationWired !== false };
1359
- return defineTool({
1360
- name: TASK_OUTPUT_TOOL_NAME,
1361
- ...toolFace("task-output"),
1362
- ruleFace: mountRuleFace("task-output"),
1363
- description: composeTaskOutputDescription(caps),
1364
- parameters: composeTaskOutputParams(caps),
1365
- boundaryLegsFor: (rawArgs, at) => {
1366
- const id = resolveTaskIdArg(rawArgs?.task_id);
1367
- return id ? opts.registry.boundaryLegsOf(id, { owner: opts.owner, scope: opts.scope, ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}) }, "output", at.tree) : { legs: [] };
1368
- },
1369
- execute: async (rawArgs, ctx) => {
1370
- const args = rawArgs;
1371
- const id = resolveTaskIdArg(args.task_id);
1372
- if (!id)
1373
- return errorResult(TASK_OUTPUT_MISSING_ID_MESSAGE);
1374
- const requestedMs = typeof args.timeout === "number" ? args.timeout : undefined;
1375
- let effectiveTimeoutMs = requestedMs;
1376
- let waitClampNote = "";
1377
- const wall = opts.deadlineMs?.();
1378
- const requestedWaitMs = Math.max(1, Math.floor(requestedMs ?? BLOCK_DEFAULT_TIMEOUT_MS));
1379
- if (args.block !== false && wall !== undefined) {
1380
- const remainMs = wall - Date.now() - BLOCK_WAIT_WRITEOUT_RESERVE_MS;
1381
- const wantMs = Math.min(BLOCK_MAX_TIMEOUT_MS, requestedWaitMs);
1382
- if (remainMs <= 0) {
1383
- effectiveTimeoutMs = 1;
1384
- waitClampNote =
1385
- "\n\nNOTE: wait skipped — the task's wall-clock deadline has been reached. Do NOT wait on this background task again; write out your results now (an unfinished answer beats a hard timeout).";
1386
- }
1387
- else if (remainMs < wantMs) {
1388
- effectiveTimeoutMs = remainMs;
1389
- waitClampNote = `\n\nNOTE: wait clamped to ${Math.round(remainMs / 1000)}s (requested ${Math.round(requestedWaitMs / 1000)}s) — the task's wall-clock deadline is near. If the task is still running after this wait, do NOT re-wait: proceed with other work or write out your results now.`;
1390
- }
1391
- }
1392
- const r = await opts.registry.pollTask(id, { owner: ctx.taskId ?? opts.owner, scope: ctx.principal ?? opts.scope, ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}) }, {
1393
- workflowStore: opts.workflowStore,
1394
- agentStore: opts.agentStore,
1395
- filter: typeof args.filter === "string" ? args.filter : undefined,
1396
- block: args.block !== false,
1397
- timeoutMs: effectiveTimeoutMs,
1398
- signal: ctx.signal,
1399
- toolResultStore: opts.toolResultStore,
1400
- checkpointSeat: opts.checkpointSeat,
1401
- });
1402
- const { type: taskType, ...rest } = r.details;
1403
- return {
1404
- content: r.content + waitClampNote,
1405
- details: { type: "task-output", ...(taskType !== undefined ? { taskType } : {}), ...(waitClampNote !== "" ? { waitClamped: true } : {}), ...rest },
1406
- ...(r.isError ? { isError: true } : {}),
1407
- };
1408
- },
1409
- });
1410
- }
1411
1324
  export function createTaskStopTool(opts) {
1412
1325
  return defineTool({
1413
1326
  name: TASK_STOP_TOOL_NAME,
1414
1327
  ...toolFace("task-stop"),
1415
1328
  ruleFace: mountRuleFace("task-stop"),
1416
- description: composeTaskStopDescription(REGISTRY_TASK_TOOL_CAPS),
1329
+ description: TASK_STOP_DESCRIPTION,
1417
1330
  parameters: TASK_STOP_PARAMS,
1418
1331
  boundaryLegsFor: (rawArgs, at) => {
1419
1332
  const a = rawArgs;
@@ -164,8 +164,9 @@ export interface TaskResult {
164
164
  /**
165
165
  * The ENGINE-minted identity of THIS run (uuidv7), minted once at the top of prepare and
166
166
  * never rewritten. The third id of the trio, and the only one the engine owns:
167
- * - {@link taskId} — the HOST's task identity, or (when the host named none) the session id: it is
168
- * `spec.taskId ?? sessionId` and therefore answers the SAME value for every run of one session;
167
+ * - {@link taskId} — the leg's task identity: a background sub-agent's registry task id, else the
168
+ * HOST's task identity, else (when the host named none) the session id — so it answers the SAME
169
+ * value for every run of one session (or of one background row);
169
170
  * - {@link sessionId} — the conversation, shared by every run that continues it;
170
171
  * - `runId` — this call. Two runs of one session ALWAYS differ here; a host-supplied `taskId` does
171
172
  * not change it (the host's handle and the engine's run are different questions).
@@ -185,8 +186,22 @@ export interface TaskResult {
185
186
  * never the `"unknown"` sentinel `taskId`/`sessionId` fall back to on that path.
186
187
  */
187
188
  runId?: string;
188
- /** Use this to continue the same conversation on the next call. */
189
+ /**
190
+ * Use this to continue the same conversation on the next call. On a parked result — a `paused` terminal, or a `failed` one
191
+ * carrying `nestedPause` — it is the session of the leg that parked, which is the parked row's own `Checkpoint.sessionId`.
192
+ * A composition entry's legs (a cascade's rungs, a verification gate's verifier) do not run in the caller's session, so a
193
+ * host links such a row to its run by the row's `CheckpointState.compositionLeg.hostSessionId`, never by assuming the row
194
+ * sits in the session it submitted.
195
+ */
189
196
  sessionId: string;
197
+ /**
198
+ * The leg's placement fixed point: the one value its prepare resolved for the tree's placement root (the caller's explicit
199
+ * `RunInternals.placementRoot`, else the delegation root, else the leg's own session — on a resume, the parked row's recorded
200
+ * root), the same value its env factory was minted with and its parks record. A composition entry places every later leg at
201
+ * its first leg's `placementRoot`. **In-presence condition**: present on every terminal of a run whose prepare resolved it;
202
+ * absent on a result a run did not assemble (a host's own stub, a composition's synthetic terminal).
203
+ */
204
+ placementRoot?: string;
190
205
  /**
191
206
  * WHY the run ended — the ONE tagged cause ({@link TerminalCause}), and the ONLY terminal record on this
192
207
  * result: there is no `status` word and no `errorCode`/`errorMessage`/`blockedReason`/`checkpointToken`/
@@ -495,10 +510,12 @@ export interface TaskResult {
495
510
  editedFiles?: import("../agents/subagent-steps.js").SubagentEditedFile[];
496
511
  /**
497
512
  * Present (`true`) exactly when the run's FINAL turn was halted by a person's BARE rejection of a
498
- * tool call — the parent-thread control-flow boundary: the rejected call's same-message siblings
499
- * that had not started were settled un-executed (each an error result coded `gate.batch_halted`),
500
- * and the engine deliberately did NOT re-invoke the model, so the run ends awaiting the user's
501
- * direction. On this path `status` is still `"completed"` (nothing failed, nothing is suspended,
513
+ * tool call, or of the plan a plan pause held — the parent-thread control-flow boundary: the rejected
514
+ * call's same-message siblings that had not started were settled un-executed (each an error result
515
+ * coded `gate.batch_halted`), and the engine deliberately did NOT re-invoke the model, so the run ends
516
+ * awaiting the user's direction. A resumed leg that redeems such a rejection records the decision and
517
+ * makes no model request at all (its `result` is the transcript's last assistant message — the plan
518
+ * request, or the parked call's message; empty when the transcript has no answer yet). On this path `status` is still `"completed"` (nothing failed, nothing is suspended,
502
519
  * the session is continuable as ever) — this field is what tells such an end apart from a natural
503
520
  * finish: `result` text is whatever the model had produced BEFORE the rejection (often empty), and
504
521
  * a consumer surface should read the state as "stopped by the user, awaiting their direction",
@@ -0,0 +1,39 @@
1
+ /**
2
+ * The one reading of a caller's {@link TaskSpec}. A spec is the caller's own object: a literal, a class instance, a bag with
3
+ * accessors, a Proxy. The run takes it through here once, at its entrance, and every reader after that — the session lock, the
4
+ * config doors, prepare, the leg, the backstop terminal — reads the snapshot this returns, never the caller's object again.
5
+ *
6
+ * Each member is read once, by name, through an ordinary property lookup (an inherited, non-enumerable, accessor-backed or
7
+ * Proxy-answered member included — the presence law the retired-key door states, `retired-keys.ts`), and a defined value lands
8
+ * as an own enumerable data member of a new plain frozen object: the snapshot reads exactly like an object literal spec, so any
9
+ * later copy (a spread included) keeps every member, and a getter's value is the one value the whole run sees. Values are taken
10
+ * by reference (a member's own contents — the tool roster's entries, a policy, a signal — are their own readers' to snapshot).
11
+ *
12
+ * Three refusals, each by name and recorded on the read (thrown where the run's prepare refuses, so a failed read ends the run
13
+ * as any prepare refusal does): a member whose lookup throws (`config.spec_member_unreadable`); a retired key the lookup answers
14
+ * (`config.spec_retired_key`, the retired-key door judged over the values just read); an own key (enumerable or not, string or
15
+ * symbol) that is neither a member nor a retired name — the engine's one name judgment, on the spec as given; an inherited key is
16
+ * no own key, so it is neither read as a stray nor refused — (`config.spec_unknown_key` — a key the engine never reads is refused,
17
+ * not carried silently).
18
+ *
19
+ * The one re-read the engine keeps is the tool roster's identity check (`refuseLateRosterChanges`, against the caller's own
20
+ * object): it compares objects, it does not take a value.
21
+ */
22
+ import type { TaskSpec } from "./task-spec.js";
23
+ /** Every {@link TaskSpec} member, by name — the type's own key set, fenced both ways (a member added to `TaskSpec` and not
24
+ * listed here, or a name here that `TaskSpec` does not declare, is a compile error; the value is a placeholder). */
25
+ export declare const TASK_SPEC_MEMBERS: readonly string[];
26
+ /** What one read of a caller's spec answered: the snapshot every reader reads, the caller's own object (for the roster's identity
27
+ * check only), and the refusal the read met (thrown at prepare's door), if any. */
28
+ export interface CallerSpecRead<S extends Partial<TaskSpec> = TaskSpec> {
29
+ readonly spec: S;
30
+ readonly caller: S;
31
+ readonly refusal: (Error & {
32
+ code: string;
33
+ }) | undefined;
34
+ }
35
+ /**
36
+ * Read the caller's spec once (see the module note). Never throws for a spec that is an object: a refusal is recorded on the read
37
+ * and thrown at prepare's door; a spec that is no object at all is a `TypeError`, as any member read of it would be.
38
+ */
39
+ export declare function readCallerSpec<S extends Partial<TaskSpec>>(spec: S): CallerSpecRead<S>;
@@ -0,0 +1,92 @@
1
+ import { RETIRED_TASK_SPEC_KEYS, retiredKeyOf, retiredKeyRefusal } from "./retired-keys.js";
2
+ import { thrownText } from "./thrown-value.js";
3
+ import { strayMembersOf } from "./own-property-receipt.js";
4
+ export const TASK_SPEC_MEMBERS = Object.keys({
5
+ taskId: 0, objective: 0, principal: 0, actor: 0, runOrigin: 0, interactionPosture: 0, approvalReach: 0, interactiveQuestionFallback: 0,
6
+ images: 0, userAttachments: 0, sessionId: 0, projectId: 0, requireExistingSession: 0, oneShot: 0, clientContext: 0, resumeAt: 0,
7
+ resumeAtMode: 0, model: 0, modelRole: 0, roles: 0, compactionModel: 0, advisorModel: 0, thinking: 0, systemPrompt: 0,
8
+ promptRole: 0, promptForm: 0, promptBinding: 0, appendSystemPrompt: 0, outputStyle: 0, memory: 0, suggestNextPrompts: 0, fileHistory: 0,
9
+ projectMemory: 0, restoreFiles: 0, acceptPartialRestore: 0, rewindFilesTo: 0, tools: 0, allowTools: 0, excludeTools: 0, excludeAllTools: 0,
10
+ deferTools: 0, toolMaterializeStrategy: 0, alwaysLoadTools: 0, restoreGatedTools: 0, deferSelfResolve: 0, promptLean: 0, agents: 0, toolPolicy: 0,
11
+ basePolicyForResumeEdit: 0, onAsk: 0, onQuestion: 0, lspManager: 0, lspDiagnostics: 0, mods: 0, peerPresence: 0, durableApproval: 0,
12
+ resourceSuspend: 0, preemptSignal: 0, resilience: 0, finalVerification: 0, maxSuspends: 0, checkpointStore: 0, handsReadOnly: 0, memoryPersistenceCapable: 0,
13
+ additionalDirectories: 0, additionalReadDirectories: 0, readDenyPatterns: 0, writeProtectedAdditions: 0, complianceAdditionalDenies: 0, readFace: 0, writeFace: 0, enablePlanMode: 0,
14
+ planFile: 0, interactiveTools: 0, enableFork: 0, shellGate: 0, permissionMode: 0, classifyAllShell: 0, mcp: 0, a2a: 0,
15
+ skills: 0, userInvokedSkills: 0, allowedTools: 0, skillListingBudgetFraction: 0, skillListingMaxDescChars: 0, backgroundScope: 0, envFacts: 0, limits: 0,
16
+ configOverrides: 0, forwardSubagentEvents: 0, retainSubagentSessions: 0, retainBackgroundProcesses: 0, streamingToolExecution: 0, outputSchema: 0, outputRetries: 0, tracer: 0,
17
+ toolResultThresholdChars: 0, compaction: 0, attachments: 0, enableBlockedReport: 0, selfOrchestration: 0, getApiKeyAndHeaders: 0, signal: 0,
18
+ });
19
+ const MEMBERS = new Set(TASK_SPEC_MEMBERS);
20
+ const RETIRED_NAMES = [...new Set(Object.keys(RETIRED_TASK_SPEC_KEYS).map((key) => key.split(".")[0].replace(/\[\]$/, "")))];
21
+ const READ_NAMES = [...TASK_SPEC_MEMBERS, ...RETIRED_NAMES.filter((name) => !MEMBERS.has(name))];
22
+ const READS = new WeakMap();
23
+ function specRefusal(code, message, detail) {
24
+ const e = new Error(message);
25
+ e.code = code;
26
+ e.detail = detail;
27
+ return e;
28
+ }
29
+ function unreadable(member, cause) {
30
+ const why = thrownText(cause);
31
+ return specRefusal("config.spec_member_unreadable", `TaskSpec.${member} could not be read (${why}) — a run reads each member of its spec once, at its start; a member whose read throws is refused rather than read as absent. Pass the value as a plain data member.`, { member });
32
+ }
33
+ function unknownKeys(keys) {
34
+ return specRefusal("config.spec_unknown_key", `TaskSpec carries ${keys.length === 1 ? "a key" : "keys"} this engine does not read: ${keys.map((k) => JSON.stringify(k)).join(", ")}. Refused rather than ignored: a key that is silently dropped reads to the caller as configured. Drop ${keys.length === 1 ? "it" : "them"}, or spell the member the engine declares.`, { keys: [...keys] });
35
+ }
36
+ export function readCallerSpec(spec) {
37
+ const known = READS.get(spec);
38
+ if (known !== undefined)
39
+ return known;
40
+ if (spec === null || (typeof spec !== "object" && typeof spec !== "function")) {
41
+ throw new TypeError(`TaskSpec must be an object (got ${spec === null ? "null" : typeof spec})`);
42
+ }
43
+ let own;
44
+ try {
45
+ own = { stray: strayMembersOf(spec, { subject: "TaskSpec", unit: "member", moment: "when the run reads its spec" }, READ_NAMES) };
46
+ }
47
+ catch (cause) {
48
+ own = { cause };
49
+ }
50
+ const values = Object.create(null);
51
+ let refusal;
52
+ for (const name of READ_NAMES) {
53
+ let value;
54
+ try {
55
+ value = Reflect.get(spec, name);
56
+ }
57
+ catch (cause) {
58
+ refusal ??= unreadable(name, cause);
59
+ continue;
60
+ }
61
+ if (value !== undefined)
62
+ values[name] = value;
63
+ }
64
+ for (const [key, replacement] of refusal === undefined ? Object.entries(RETIRED_TASK_SPEC_KEYS) : []) {
65
+ let hit;
66
+ try {
67
+ hit = retiredKeyOf(values, { [key]: replacement });
68
+ }
69
+ catch (cause) {
70
+ refusal = unreadable(key, cause);
71
+ break;
72
+ }
73
+ if (hit !== undefined) {
74
+ refusal = retiredKeyRefusal(hit, "TaskSpec");
75
+ break;
76
+ }
77
+ }
78
+ if (refusal === undefined) {
79
+ if ("cause" in own)
80
+ refusal = unreadable("[own keys]", own.cause);
81
+ else if (own.stray !== undefined)
82
+ refusal = unknownKeys(own.stray.names.map((name) => String(name)));
83
+ }
84
+ const members = {};
85
+ for (const name of TASK_SPEC_MEMBERS)
86
+ if (name in values)
87
+ members[name] = values[name];
88
+ const snapshot = Object.freeze(members);
89
+ const read = Object.freeze({ spec: snapshot, caller: spec, refusal });
90
+ READS.set(snapshot, read);
91
+ return read;
92
+ }
@@ -219,14 +219,11 @@ export interface TaskSpec {
219
219
  * is a property of the submission, not of the channel it arrived on — a persistent connection can still
220
220
  * mix interactive and one-shot submissions, which a connection-level flag could not express.
221
221
  *
222
- * Currently consumed by the `RunWorkflow` tool's guidance text only (RB-215 candidate ①):
223
- * a workflow started from a one-shot submission is told to actively block-wait via
224
- * `TaskOutput({ block: true })` before ending its turn, instead of the default "end your turn, you will
225
- * be notified" guidance — the latter is actively wrong here (BGB drilldown case 2, `../sema-test/bench-bg/
226
- * intel/drilldown-C101-B401-20260727.md`: a model that followed that exact guidance lost background
227
- * results because the one-shot process had nothing left alive to receive the notification). Default
228
- * `false`/absent = today's behavior (unchanged for interactive sessions). A deployment MAY thread it
229
- * into other one-shot-sensitive decisions of its own.
222
+ * What the engine does with it: the run's ending waits for the loop-type background tasks it launched (agents,
223
+ * continued agents, workflows) — their terminal frames are owed to the run's lane and arrive as later turns,
224
+ * bounded by the walltime and a 600 s ceiling — and does not wait for process-type ones (a background command,
225
+ * a Monitor watch), whose receipts carry one sentence saying so. Default `false`/absent = interactive (unchanged).
226
+ * A deployment MAY thread it into other one-shot-sensitive decisions of its own.
230
227
  *
231
228
  * INHERITED down the delegation tree (only the `true` value, off the trusted
232
229
  * {@link ToolExecuteContext.oneShot} seat): the property being described — "the process this
@@ -1130,8 +1127,11 @@ export interface TaskSpec {
1130
1127
  * reads as nothing (`*`, `mcp__*` / `mcp__*__*`, a write-path or domain pattern) grants nothing and is announced at the start of the
1131
1128
  * run (`permission.allowed_tool_not_granted`); a list holding `*` grants nothing at all. A value that is not a list of
1132
1129
  * strings refuses the run before it starts (`config.invalid_permission_rules`, with its issues).
1130
+ *
1131
+ * A member may carry its rule SET's anchors, `{ rule, pathBases }` ({@link AllowListEntry} — the seat and the reading of a deny /
1132
+ * ask set's `pathBases`: a user layer's `/x` allow reaches `<config>/x`); one that is not exactly that refuses the run.
1133
1133
  */
1134
- allowedTools?: readonly string[];
1134
+ allowedTools?: readonly import("./allow-entry.js").AllowListEntry[];
1135
1135
  /**
1136
1136
  * Fraction of the model's context window the `<skills>` listing may spend. Absent ⇒ `0.01` (1%).
1137
1137
  * Domain `(0, 1]`; anything else — including `0`, a string, `NaN` — REFUSES at the door with
@@ -1163,7 +1163,7 @@ export interface TaskSpec {
1163
1163
  * design/129 — lifetime scope for BACKGROUND children (Agent/Fork `run_in_background`). Default `"task"`:
1164
1164
  * the parent runTask's terminal reaps them (design/115 — no orphans burning tokens; turn-end killed
1165
1165
  * frame). `"session"`: children OUTLIVE the turn (CC Backgrounded semantics) — registered under the
1166
- * SESSION owner (cross-turn TaskOutput poll works), skipped by the parent-teardown reap, force-capped by
1166
+ * SESSION owner (a later turn's TaskStop and the host poll reach it), skipped by the parent-teardown reap, force-capped by
1167
1167
  * a default child timeout when none is given, and finally reapable via
1168
1168
  * `TaskRegistry.reapSessionBackground(sessionId, scope)` (call it from your session release/sweep).
1169
1169
  * CALLER-trusted (systemPrompt tier): never a model-facing parameter, never on the governed workflow
@@ -1,15 +1,9 @@
1
1
  import { Type } from "typebox";
2
- export declare const TASK_OUTPUT_TOOL_NAME = "TaskOutput";
3
2
  export declare const TASK_STOP_TOOL_NAME = "TaskStop";
4
- export declare const TASK_OUTPUT_CONTRACT: {
5
- readonly contractId: "core.task_output@1";
6
- readonly implementationRevision: "1";
7
- };
8
3
  export declare const TASK_STOP_CONTRACT: {
9
4
  readonly contractId: "core.task_stop@1";
10
5
  readonly implementationRevision: "1";
11
6
  };
12
- export declare const TASK_OUTPUT_MISSING_ID_MESSAGE = "Error (TaskOutput): Missing required parameter: task_id";
13
7
  export declare const TASK_STOP_MISSING_ID_MESSAGE = "Missing required parameter: task_id";
14
8
  export declare const TASK_STOP_PARAMS: Type.TObject<{
15
9
  task_id: Type.TOptional<Type.TString>;
@@ -17,58 +11,14 @@ export declare const TASK_STOP_PARAMS: Type.TObject<{
17
11
  }>;
18
12
  /**
19
13
  * Trims and skips blank/whitespace-only candidates, returning the first non-blank string among `values`.
20
- * RB-479-A①: callers pass ONLY the tool's declared id parameters (TaskOutput: task_id; TaskStop:
21
- * task_id, shell_id) — an id smuggled under any other key falls to the loud missing-parameter refusal.
22
- * The trim/skip-blank behavior stays (a whitespace-only id reports the same missing-parameter text as an
23
- * absent one, instead of falling through to a not-found lookup on the literal " ").
14
+ * RB-479-A①: callers pass ONLY the tool's declared id parameters (TaskStop: task_id, shell_id) — an id smuggled under
15
+ * any other key falls to the loud missing-parameter refusal. The trim/skip-blank behavior stays (a whitespace-only id
16
+ * reports the same missing-parameter text as an absent one, instead of falling through to a not-found lookup on the
17
+ * literal " ").
24
18
  */
25
19
  export declare function resolveTaskIdArg(...values: unknown[]): string | undefined;
26
20
  /**
27
- * design/157 B17 (S2) — the declaration face is a FUNCTION OF CAPABILITY (fable 终判 D3/D4/D6): what the
28
- * tool advertises to the model must match what the mount can actually do. A flag is true only when the
29
- * deployment really delivers that behavior; every composed sentence below is gated on the flag it
30
- * describes, so no mount ever advertises a file path that is never written, a notification that never
31
- * fires, a wait that never blocks, or name addressing that never resolves.
32
- */
33
- export interface TaskToolCapabilities {
34
- /** The unified registry face: workflow-task support + own-scope fencing (registry mounts only). */
35
- lanes: boolean;
36
- /** Bash(run_in_background)'s launch receipt carries the output file path (registry mounts only). */
37
- outputFile: boolean;
38
- /** A terminal <task-notification> fires when the task completes — true only when the deployment
39
- * actually wired `taskNotification` (B17 方案查出的既有假广告: the registry mount used to advertise
40
- * this unconditionally; prepare-task now passes the real wiring state). */
41
- notification: boolean;
42
- /** TaskOutput block/timeout wait semantics (registry pollTask; the env-direct poll is instantaneous). */
43
- blockWait: boolean;
44
- /** TaskStop accepts a background agent's spawn NAME as task_id (registry name resolution only). */
45
- nameAddressing: boolean;
46
- }
47
- /** Full-capability profile = the registry-backed mount with notifications wired. */
48
- export declare const REGISTRY_TASK_TOOL_CAPS: TaskToolCapabilities;
49
- /** The env-direct thin-shell profile: cursor polling over a background shell, nothing else. */
50
- export declare const ENV_DIRECT_TASK_TOOL_CAPS: TaskToolCapabilities;
51
- /**
52
- * TaskOutput description, composed per capability. With every flag true this reproduces the registry's
53
- * pre-S2 literal byte-for-byte — the first two sentences are the A5 deprecated form
54
- * (209-verbatim except the task-type names, mapped to sema's lanes; divergence-logged; the anchor
55
- * commentary lives at the registry factory). With `notification` false the <task-notification> half is
56
- * honestly omitted and the cursor-polling guidance (the env side's long-standing wording) is composed in
57
- * instead — completion must then be detected by status, and SAYING so is the capability-honest guidance.
58
- */
59
- export declare function composeTaskOutputDescription(caps: TaskToolCapabilities): string;
60
- /**
61
- * TaskStop description, composed per capability. All-true reproduces the registry literal (
62
- * the named-agent bullet is the reference's; its teammate bullet stays honestly omitted — sema's team face is
63
- * in-process, not registry-addressable); `nameAddressing:false` drops exactly that bullet (the env shell
64
- * has no agent-name resolution), which reproduces the env-direct literal.
65
- */
66
- export declare function composeTaskStopDescription(caps: TaskToolCapabilities): string;
67
- /**
68
- * TaskOutput params, composed per capability (fable 终判 D3 — an advertised parameter the execute body
69
- * ignores is a lie): block/timeout enter the schema only where the poll can actually wait
70
- * (design/116 W3 — CC TaskOutput block/timeout; sema block default documented as true, CC-parity).
71
- * Canonical surface stays design/115 review S-3: task_id + sema-delta filter — and (RB-479-A①) the
72
- * declared surface is also the RESOLVED surface; no undeclared id key is read.
21
+ * TaskStop's description. The named-agent bullet is the reference's; its teammate bullet stays honestly omitted —
22
+ * sema's team face is in-process, not registry-addressable.
73
23
  */
74
- export declare function composeTaskOutputParams(caps: Pick<TaskToolCapabilities, "blockWait" | "lanes">): ReturnType<typeof Type.Object>;
24
+ export declare const TASK_STOP_DESCRIPTION: string;