@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
@@ -406,7 +406,15 @@ export interface UserMessage {
406
406
  * custom Brain); the session import door strips it (an imported frame is an ordinary engine note).
407
407
  */
408
408
  attachment?: UserMessageAttachment;
409
+ /** {@link RowRewrittenBy} */
410
+ rewrittenBy?: RowRewrittenBy;
409
411
  }
412
+ /**
413
+ * The extensions whose rewrite of this row the conversation kept (a `session.append` handler's, at the row's admission),
414
+ * in the order they handed it on — absent ⇒ the row is as its writer made it. Attribution only: never sent to a provider
415
+ * (brains rebuild wire messages field by field; {@link stripEngineMetadata} strips it for a custom Brain).
416
+ */
417
+ export type RowRewrittenBy = readonly string[];
410
418
  /** What the engine found an attachment to be: the four Read lanes, a directory, or bytes the host supplied. */
411
419
  export type UserAttachmentKind = "text" | "notebook" | "image" | "pdf" | "directory" | "client_text" | "client_image";
412
420
  /** Who held the bytes: the engine read a path in its workspace, or the host supplied text / an image. */
@@ -608,8 +616,16 @@ export interface AssistantMessage {
608
616
  * brain boundary off the provider's envelope (`brain/provider-dialect.ts`, `IMAGE_UNPROCESSABLE_RE`). Such a turn —
609
617
  * live, or as the transcript's persisted record of it — is the request view's instruction to remove the images of
610
618
  * the newest earlier message still carrying any (`engine/llm/rejected-images.ts`, at `convertToLlm`); the loop
611
- * re-sends the turn without them. */
612
- errorKind?: "length_empty" | "degenerate" | "input_too_long" | "image_unprocessable";
619
+ * re-sends the turn without them.
620
+ *
621
+ * `"tool_schema_refused"`: the provider refused the request because of one tool's input schema, and located that
622
+ * tool ({@link refusedTool}) — classified at the brain boundary off the provider's envelope (`brain/provider-dialect.ts`,
623
+ * the tool-schema rows). Such a turn, live or as its persisted record, is the request view's instruction to send that
624
+ * tool — when an external protocol (MCP, A2A) provides it — with an empty object schema in every request built from a
625
+ * transcript it stands in (`engine/llm/rejected-images.ts`); the loop re-sends the turn so. */
626
+ errorKind?: "length_empty" | "degenerate" | "input_too_long" | "image_unprocessable" | "tool_schema_refused";
627
+ /** With `errorKind: "tool_schema_refused"`: the engine name of the tool whose input schema the provider refused. */
628
+ refusedTool?: string;
613
629
  /** The AUTHORITATIVE-NEGATIVE twin of `errorKind: "input_too_long"`: the brain's provenance-checked
614
630
  * classifier RAN and ruled this failure NOT input-too-long (wrong status family, or the provider's
615
631
  * own envelope states a different error). The loop's prompt-too-long recovery treats it as a hard
@@ -670,6 +686,8 @@ export interface AssistantMessage {
670
686
  * the 2-downgrade stop-loss. Additive — absent everywhere else (incl. the dynamicCut shape).
671
687
  */
672
688
  staticReasoningCut?: true;
689
+ /** {@link RowRewrittenBy} */
690
+ rewrittenBy?: RowRewrittenBy;
673
691
  timestamp: number;
674
692
  }
675
693
  export interface ToolResultMessage<TDetails = unknown> {
@@ -679,6 +697,8 @@ export interface ToolResultMessage<TDetails = unknown> {
679
697
  content: (TextContent | ImageContent | DocumentContent)[];
680
698
  details?: TDetails;
681
699
  isError: boolean;
700
+ /** {@link RowRewrittenBy} */
701
+ rewrittenBy?: RowRewrittenBy;
682
702
  timestamp: number;
683
703
  }
684
704
  export type Message = UserMessage | AssistantMessage | ToolResultMessage;
@@ -687,7 +707,8 @@ export type Message = UserMessage | AssistantMessage | ToolResultMessage;
687
707
  * serializing a Context to an external wire. The eight fields (`enginePrefixChars`/`engineSegments`/
688
708
  * `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`runOrigin`) are INTERNAL coordination between the engine's
689
709
  * minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
690
- * multiplayer attribution, attachment delivery, run attribution) — they must never reach a provider payload. The built-in brains construct
710
+ * multiplayer attribution, attachment delivery, run attribution) — they must never reach a provider payload; so is
711
+ * {@link RowRewrittenBy}, on every role. The built-in brains construct
691
712
  * their own wire shapes and are immune; a CUSTOM Brain that whole-object-serializes messages
692
713
  * (`JSON.stringify(context.messages)`) would leak them — run the array through this projection first.
693
714
  */
@@ -50,9 +50,13 @@ export function renderUserAttachmentView(m, a, cap) {
50
50
  }
51
51
  export function stripEngineMetadata(messages) {
52
52
  return messages.map((m) => {
53
- if (m.role !== "user")
54
- return m;
55
- const { enginePrefixChars: _a, engineSegments: _b, engineMinted: _c, provenance: _d, actor: _e, engineNoteKey: _f, attachment: _g, runOrigin: _h, ...rest } = m;
53
+ if (m.role !== "user") {
54
+ if (m.rewrittenBy === undefined)
55
+ return m;
56
+ const { rewrittenBy: _r, ...kept } = m;
57
+ return kept;
58
+ }
59
+ const { enginePrefixChars: _a, engineSegments: _b, engineMinted: _c, provenance: _d, actor: _e, engineNoteKey: _f, attachment: _g, runOrigin: _h, rewrittenBy: _i, ...rest } = m;
56
60
  return rest;
57
61
  });
58
62
  }
@@ -38,6 +38,8 @@ export type LoopContinueReason =
38
38
  | "reactive_compact_retry"
39
39
  /** The provider refused an image; the request view removed it and the turn was re-sent in-turn. */
40
40
  | "image_refusal_retry"
41
+ /** The provider refused one tool's input schema; the tool view emptied it and the turn was re-sent in-turn. */
42
+ | "tool_schema_refusal_retry"
41
43
  /** ④b recovery: a `length`-stopped answer triggered a synthetic continue nudge for another turn. */
42
44
  | "max_output_tokens_recovery"
43
45
  /** S2 recovery (design/119): a `toolUse` stop with ZERO parseable tool calls got a retry nudge. */
@@ -69,7 +71,8 @@ export type LoopTerminalReason =
69
71
  * budget is used up — the model believes it acted, nothing ran, and there is no more recovery budget
70
72
  * left to try again. Before this reason existed, this case fell through to the generic no-more-work
71
73
  * path and was reported as a plain `"completed"`, indistinguishable from a turn that genuinely had
72
- * nothing left to do.
74
+ * nothing left to do. A Runner run reads this exit (and `truncated_output_exhausted`) as a `failed`
75
+ * terminal: `model.malformed_tool_use_exhausted` / `model.truncated_output_exhausted`.
73
76
  *
74
77
  * `malformedToolUseRetries` 数的是**连续**畸形轮:任何带可解析工具调用的轮(即工具真的跑了)都把它
75
78
  * 清零,与上游「重试至多两次、成功即复位」同形——"exhausted" 说的是"刚刚连续 maxRetries + 1 个轮次
@@ -131,6 +134,8 @@ export interface TrailingToolBatchSettlement {
131
134
  /** A prompt run's seam beyond its prompts (the trailing-batch settlement); a prompt is delivered at its `message_end`. */
132
135
  export interface RunAgentLoopSeams {
133
136
  settle?: TrailingToolBatchSettlement;
137
+ /** The prompts RECORD a turn a person's bare refusal ended: they owe no model turn (a drain point's queued input still continues the run). */
138
+ endsAwaitingUser?: true;
134
139
  }
135
140
  /** The last assistant message of `messages` when at least one of its tool calls has no tool result after it. */
136
141
  export declare function findUnansweredToolBatch(messages: readonly AgentMessage[]): AssistantMessage | undefined;
@@ -9,7 +9,7 @@ import { remoteWords } from "../../core/protocol-http-auth.js";
9
9
  import { types } from "node:util";
10
10
  import { admitToolResultMediaBlocks, firstUnprocessedOverTarget, toolResultMediaBlocks } from "../../core/image-admission.js";
11
11
  import { resolveImageProcessor } from "../../core/image-downsample.js";
12
- import { IMAGE_REFUSAL_KIND, imageRefusalRemoves } from "../llm/rejected-images.js";
12
+ import { IMAGE_REFUSAL_KIND, imageRefusalRemoves, toolSchemaRefusalReplaces, withoutRefusedToolSchemas } from "../llm/rejected-images.js";
13
13
  const IMAGE_REFUSAL_RETRIES = 3;
14
14
  function appendTextDeltaToAssistantMessage(message, contentIndex, delta) {
15
15
  const content = [...message.content];
@@ -77,7 +77,7 @@ export async function runAgentLoop(prompts, context, config, emit, signal, strea
77
77
  }
78
78
  const delivered = typeof prompts === "function" ? await prompts() : prompts;
79
79
  if (delivered.length > 0)
80
- state.hasMoreToolCalls = true;
80
+ state.hasMoreToolCalls = seams?.endsAwaitingUser !== true;
81
81
  state.context.messages.push(...delivered);
82
82
  state.newMessages.push(...delivered);
83
83
  for (const prompt of delivered) {
@@ -370,18 +370,27 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
370
370
  raiseFatalCancellation(executor);
371
371
  let interruptedInRecovery = false;
372
372
  let imageRetries = 0;
373
- const resendWithoutRefusedImages = async () => {
373
+ const refusalChangesRequest = () => message.errorKind === IMAGE_REFUSAL_KIND
374
+ ? imageRetries < IMAGE_REFUSAL_RETRIES && imageRefusalRemoves(state.context.messages, message)
375
+ : toolSchemaRefusalReplaces(state.context.messages, message, state.context.tools);
376
+ const resendWithoutRefusedParts = async () => {
374
377
  while (message.stopReason === "error" &&
375
- message.errorKind === IMAGE_REFUSAL_KIND &&
376
378
  !signal?.aborted &&
377
379
  !turnController.signal.aborted &&
378
380
  isBlankFailureContent(message) &&
379
381
  executor.admittedCount === 0 &&
380
- imageRetries < IMAGE_REFUSAL_RETRIES &&
381
382
  state.context.messages[state.context.messages.length - 1] === message &&
382
- imageRefusalRemoves(state.context.messages, message)) {
383
- imageRetries++;
384
- trace?.({ kind: "continue", reason: "image_refusal_retry" });
383
+ refusalChangesRequest()) {
384
+ if (message.errorKind === IMAGE_REFUSAL_KIND)
385
+ imageRetries++;
386
+ else if (message.refusedTool !== undefined) {
387
+ try {
388
+ state.config.onToolSchemaRefused?.({ tool: message.refusedTool, refusalAt: message.timestamp });
389
+ }
390
+ catch {
391
+ }
392
+ }
393
+ trace?.({ kind: "continue", reason: message.errorKind === IMAGE_REFUSAL_KIND ? "image_refusal_retry" : "tool_schema_refusal_retry" });
385
394
  executor = new StreamToolExecutor(state.context, state.config, turnController.signal, emit);
386
395
  try {
387
396
  ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade));
@@ -392,7 +401,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
392
401
  raiseFatalCancellation(executor);
393
402
  }
394
403
  };
395
- await resendWithoutRefusedImages();
404
+ await resendWithoutRefusedParts();
396
405
  {
397
406
  if (ptl) {
398
407
  const detect = ptlDetect;
@@ -445,7 +454,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
445
454
  }
446
455
  }
447
456
  }
448
- await resendWithoutRefusedImages();
457
+ await resendWithoutRefusedParts();
449
458
  const unrecoveredPtlFailureUnderInterrupt = ptl !== undefined &&
450
459
  message.stopReason === "error" &&
451
460
  ptlDetect(message) &&
@@ -719,7 +728,7 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
719
728
  systemPrompt: context.systemPrompt,
720
729
  ...(context.systemBlocks ? { systemBlocks: context.systemBlocks } : {}),
721
730
  messages: llmMessages,
722
- tools: context.tools,
731
+ tools: withoutRefusedToolSchemas(context.tools, context.messages),
723
732
  };
724
733
  const streamFunction = resolveAgentCoreStreamFn(runtime, streamFn);
725
734
  const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : undefined) || config.apiKey;
@@ -1,5 +1,5 @@
1
1
  import type { Static, TSchema } from "typebox";
2
- import type { AssistantMessage, AssistantMessageEvent, DocumentContent, ImageContent, Message, Model, SimpleStreamOptions, StreamFn as LlmStreamFn, TextContent, Tool, ToolResultMessage } from "../llm/index.js";
2
+ import type { AssistantMessage, AssistantMessageEvent, DocumentContent, ImageContent, Message, Model, RowRewrittenBy, SimpleStreamOptions, StreamFn as LlmStreamFn, TextContent, Tool, ToolResultMessage } from "../llm/index.js";
3
3
  /**
4
4
  * Stream function used by the agent loop.
5
5
  *
@@ -232,8 +232,9 @@ export interface LoopPromptTooLongRecovery {
232
232
  * ends the run — the pre-④b behavior).
233
233
  *
234
234
  * RB-258: when the budget IS configured and runs out on a still-`length` turn, the loop ends with the
235
- * dedicated terminal reason `truncated_output_exhausted` (visible on the `LoopTraceSink`) instead of a
236
- * plain `completed` — the caller can tell "kept hitting the output cap" apart from "actually finished".
235
+ * dedicated terminal reason `truncated_output_exhausted` (visible on the `LoopTraceSink`; a Runner run reads it as a
236
+ * `failed` terminal, `model.truncated_output_exhausted`) instead of a plain `completed` — the caller can tell "kept
237
+ * hitting the output cap" apart from "actually finished".
237
238
  * The OFF case is unchanged (no budget ⇒ nothing to exhaust ⇒ still `completed`).
238
239
  */
239
240
  export interface LoopTruncatedOutputRecovery {
@@ -585,6 +586,12 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
585
586
  toolCallId: string;
586
587
  error: unknown;
587
588
  }) => void;
589
+ /** Told once per refusal, when the loop re-sends a turn the provider refused over `tool`'s input schema (the tool view then
590
+ * sends it with an empty object schema); `refusalAt` = the refusal's timestamp. Advisory: a throwing sink changes nothing. */
591
+ onToolSchemaRefused?: (refusal: {
592
+ tool: string;
593
+ refusalAt: number;
594
+ }) => void;
588
595
  /**
589
596
  * Told, once per executed call, of the media blocks the tool-result seat refused (`admitToolResultMedia`, the last step
590
597
  * of the post-execution half): each already stands in the result as a text placeholder naming the tool and the refusal,
@@ -660,6 +667,8 @@ export interface CustomMessage<T = unknown> {
660
667
  * derived views (auto-mode window, compaction serializer) present it under a neutral engine label,
661
668
  * never `[user]` authority. Set by the INJECTOR at mint time; absent ⇒ verbatim user-lane render. */
662
669
  provenance?: "engine-note";
670
+ /** {@link RowRewrittenBy} */
671
+ rewrittenBy?: RowRewrittenBy;
663
672
  /** Millisecond timestamp for transcript ordering. */
664
673
  timestamp: number;
665
674
  }
@@ -265,6 +265,13 @@ function normalizeEngineProvenanceStamp(message, preserveActorAssertions = false
265
265
  if (message === null || typeof message !== "object")
266
266
  return;
267
267
  const m = message;
268
+ if (m.rewrittenBy !== undefined) {
269
+ const r = m.rewrittenBy;
270
+ if (Array.isArray(r) && r.length > 0 && r.every((n) => typeof n === "string" && n.length > 0))
271
+ m.rewrittenBy = [...r];
272
+ else
273
+ delete m.rewrittenBy;
274
+ }
268
275
  if (m.role !== "user")
269
276
  return;
270
277
  if (m.actor !== undefined) {
@@ -21,10 +21,10 @@ export declare const FIXTURE_PLACEHOLDER_RE: RegExp;
21
21
  /**
22
22
  * AskRequest, HOST form — the shape a live `onAsk` approver receives when the HOST task's own
23
23
  * gate raises a permission ask. Key facts downstream must not re-derive by guessing:
24
- * - `sourceTaskId` is PRESENT on host asks too (always the issuing task's session id) — it is
25
- * NOT a subagent discriminator;
26
- * - `fromSubagent` / `sourceAgentName` are ABSENT on host asks (design/153 §1: `fromSubagent`
27
- * is THE discriminator);
24
+ * - `sourceSessionId` is PRESENT on host asks too (the issuing leg's session id — a conversation,
25
+ * never a task) — it is NOT a subagent discriminator;
26
+ * - `agentId` / `fromSubagent` / `sourceAgentName` are ABSENT on host asks (design/153 §1:
27
+ * `fromSubagent` is THE attribution discriminator);
28
28
  * - `principal` is absent unless the deployment sets TaskSpec.principal.
29
29
  */
30
30
  export declare const ASK_REQUEST_HOST: AskRequest;
@@ -34,7 +34,8 @@ export declare const ASK_REQUEST_HOST: AskRequest;
34
34
  * - `fromSubagent: true` — the explicit, unforgeable discriminator (1.378);
35
35
  * - `sourceAgentName` — display identity (UNTRUSTED-for-display; redact + bound before render);
36
36
  * present only when the spawn named the child (an unnamed child omits it);
37
- * - `sourceTaskId` — the CHILD's session id (≠ the host's);
37
+ * - `sourceSessionId` — the CHILD's session id (≠ the host's);
38
+ * - `agentId` — the child's task id: a background child's registry id (`a…`), else its session id;
38
39
  * - `isDelegatedChild: true` — the refusal-POSTURE fact (the raw trusted internals fact, set by
39
40
  * every core spawn leg — a FORK carries it too, its interaction contract being one-shot). NOT a
40
41
  * synonym for `fromSubagent` (`parentTaskId` presence): a directly-started workflow's children
@@ -46,6 +47,7 @@ export declare const ASK_REQUEST_SUBAGENT: AskRequest;
46
47
  * tool call (e.g. cron-triggered) spawns an agent whose gate raises the ask. THE form that keeps
47
48
  * `isDelegatedChild` and `fromSubagent` from being conflated downstream:
48
49
  * - `isDelegatedChild: true` — refusals speak the child posture to it;
50
+ * - `agentId` PRESENT — it rides the delegation fact, not the parent link (the leg's task id);
49
51
  * - `fromSubagent` ABSENT — there is no nameable `parentTaskId` and no id is ever fabricated;
50
52
  * - `sourceAgentName` — the workflow spawn's display label.
51
53
  * A consumer that requires the two flags together, or classifies by `fromSubagent` alone, misreads
@@ -4,14 +4,15 @@ export const ASK_REQUEST_HOST = {
4
4
  toolCallId: "<tool-call-id>",
5
5
  args: { "<arg-key>": "<arg-value>" },
6
6
  message: "<message>",
7
- sourceTaskId: "<issuing-session-id>",
7
+ sourceSessionId: "<issuing-session-id>",
8
8
  };
9
9
  export const ASK_REQUEST_SUBAGENT = {
10
10
  toolName: "target",
11
11
  toolCallId: "<tool-call-id>",
12
12
  args: { "<arg-key>": "<arg-value>" },
13
13
  message: "<message>",
14
- sourceTaskId: "<issuing-session-id>",
14
+ sourceSessionId: "<issuing-session-id>",
15
+ agentId: "<agent-id>",
15
16
  fromSubagent: true,
16
17
  sourceAgentName: "<agent-name>",
17
18
  isDelegatedChild: true,
@@ -21,7 +22,8 @@ export const ASK_REQUEST_WORKFLOW_CHILD = {
21
22
  toolCallId: "<tool-call-id>",
22
23
  args: { "<arg-key>": "<arg-value>" },
23
24
  message: "<message>",
24
- sourceTaskId: "<issuing-session-id>",
25
+ sourceSessionId: "<issuing-session-id>",
26
+ agentId: "<agent-id>",
25
27
  sourceAgentName: "<agent-name>",
26
28
  isDelegatedChild: true,
27
29
  };
package/dist/index.d.ts CHANGED
@@ -9,6 +9,7 @@ export { Runner, runTask } from "./core/runner/runtask.js";
9
9
  export { resolveTaskLimits } from "./core/runner/prepare-task.js";
10
10
  export type { RunInternals, ResolvedWorkspace } from "./core/runner/prepare-task.js";
11
11
  export type { RunnerSelfSeat } from "./core/runner/contracts.js";
12
+ export type { CompositionLeg } from "./core/runner/contracts.js";
12
13
  export type { BudgetAxis } from "./core/runner/assemble-result.js";
13
14
  export { terminalProjection } from "./core/runner/terminal-projection.js";
14
15
  export { toolOutputBlockChars } from "./core/runner/tool-output-projection.js";
@@ -33,7 +34,6 @@ export { createTaskListTools, createMemoryTaskListStore, assertJsonMetadata, typ
33
34
  export { assembleCodeTools, type CodeToolsConfig, CODE_ROLE } from "./scenarios/full-body.js";
34
35
  export { TOOL_MODEL_GATE_CLASSES, isModelGatedForClass, type ToolModelGateRule } from "./core/tool-model-gate.js";
35
36
  export { capAggregateToolResults, AGGREGATE_TOOL_RESULT_BUDGET_CHARS, type AggregateBudgetOptions, } from "./core/tool-result-budget.js";
36
- export { capAggregateMediaBytes, AGGREGATE_MEDIA_BUDGET_BYTES, type MediaStripInfo } from "./core/media-byte-cap.js";
37
37
  export { isMediaBlock, mediaBlockDescriptor, type MediaDescriptor } from "./core/media-byte-cap.js";
38
38
  export { createAskUserQuestionTool, createDurableQuestionPolicy, QUESTION_AWAITS_RESUME, isQuestionUnavailable, type OnQuestionOutcome, type QuestionUnavailable, type OnQuestion, type AskQuestion, type AskQuestionOption, type AskQuestionRequest, type QuestionAnswer, type QuestionAnswerItem, type AskQuestionCardDetails, type AskUserQuestionToolOptions, type AskAnswerContinuationSource, type SyntheticContinuationReason, ASK_USER_QUESTION_TOOL_NAME, } from "./core/ask-question.js";
39
39
  export { createLspTool, gitCheckIgnoreFilter, LSP_OPERATIONS, LSP_FAILURE_BRAND, brandLspFailure, lspFailureOf, SharedAbortScope, settleOnAbort, type LspNoneReason, type LspOperation, type LspServerManager, type LspSession, type LspResult, type LspLocation, type LspSymbolInfo, type LspRequestParams, type LspToolOptions, type LspTransport, type LspReadText, } from "./core/lsp.js";
@@ -58,7 +58,7 @@ export { runWithVerification, resumeWithVerification, verifyCompleted, runDevelo
58
58
  export { runRepairLoop, terminalForTier, repairBundleFromCheckpoint, isolationPermitsAutoAccept, type OracleTier, type RepairTerminal, type OracleResult, type RepairOracle, type RepairBundle, type RepairLoopConfig, type RepairResult, } from "./agents/repair-loop.js";
59
59
  export { assertOracleIsolation, type GraderEnv, type OracleIsolationVerdict, type AssertOracleIsolationOptions, } from "./core/oracle-isolation.js";
60
60
  export { decideAutoPromote, deriveTripwire, FROZEN_DENYLIST_FLOOR, type AutoPromoteTerminal, type AutoPromoteInputs, type PromotedRecord, type TripwireResult, } from "./core/auto-promote.js";
61
- export { runCascade, type CascadeRung, type CascadeConfig, type CascadeAttempt, type CascadeRunResult, type GateVerdict, } from "./agents/cascade.js";
61
+ export { runCascade, resumeCascade, type CascadeRung, type CascadeConfig, type CascadeAttempt, type CascadeRunResult, type GateVerdict, } from "./agents/cascade.js";
62
62
  export { pgQuery, mysqlQuery, sqliteQuery } from "./tools/sql-adapters.js";
63
63
  export { materializeMcpTools, MCP_PREFIX, type MaterializedMcp, type McpServerStatus, type McpRefreshResult, type McpReconnectResult } from "./core/mcp.js";
64
64
  export { mcpStartupTimeoutMs } from "./core/mcp.js";
@@ -76,7 +76,7 @@ export { STEER_REPLAY_FACETS, type SteerReplayFacet } from "./core/steer-replay.
76
76
  export { TOOL_TURN_INCOMPLETE_CAUSES, type ToolTurnIncompleteCause } from "./internal/llm.js";
77
77
  export { MODEL_OUTPUT_INVALID_CAUSES, type ModelOutputInvalidCause, type ModelOutputInvalid, type OutputLimit } from "./internal/llm.js";
78
78
  export { DURABLE_MANDATE_SOURCES } from "./core/tool-policy.js";
79
- export { TERMINAL_CAUSE_IS_REPLAYABLE, type TerminalFailureDetail, type CodedFailureDetail, type CodedFailureDetailValue, type TerminalCompletedDetail, type TerminalBlockedDetail, PROMPT_BLOCK_CAUSES, type PromptBlockCause, isPromptBlockCause } from "./core/terminal-cause.js";
79
+ export { TERMINAL_CAUSE_IS_REPLAYABLE, type TerminalFailureDetail, type CodedFailureDetail, type CodedFailureDetailValue, type TerminalCompletedDetail, type TerminalBlockedDetail, PROMPT_BLOCK_CAUSES, type PromptBlockCause, isPromptBlockCause, REFUSED_REQUEST_PARTS, type RefusedRequestPart } from "./core/terminal-cause.js";
80
80
  export { RESERVED_AGENT_NAMES } from "./agents/subagent.js";
81
81
  export { WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS } from "./orchestration/workflow-size-guideline.js";
82
82
  export { ENGINE_AUTHORITY_ENVELOPE_TAGS } from "./core/untrusted-text.js";
@@ -113,11 +113,12 @@ export { physicalPathOf, physicalPathOfExisting } from "./core/physical-path.js"
113
113
  export type { ExecutionEnv, FileInfo, Result, FileErrorCode, ExecutionErrorCode, WriteExpectation, WriteReceipt, SymlinkChain, BoundFileObject } from "./internal/harness.js";
114
114
  export type { ExecResult } from "./internal/harness.js";
115
115
  export type { ReadFloor } from "./internal/harness.js";
116
+ export { confineShellStart } from "./core/shell-confinement.js";
116
117
  export type { ExecutionEnvCapabilities } from "./internal/harness.js";
117
118
  export { RemoteExecutionError, hasDestroy, isRemoteExecutionEnv, isSuspendable, isIsolated, canonicalPathIsAuthoritative, pathsAreHostLocal, keepsReadFloor, missingRestoreSurface, isRetryableRemoteErrorCode, RETRYABLE_REMOTE_ERROR_CODES, } from "./core/remote-env.js";
118
119
  export { withRetry } from "./core/with-retry.js";
119
120
  export type { RetryPolicy, RetryResult } from "./core/with-retry.js";
120
- export type { RemoteExecutionEnv, WorkspaceHandle, SnapshotId, SessionToken, SandboxTier, OutputChunk, ExecStreamOptions, RemoteConnectConfig, VmLifecycleOptions, SecretRef, RemoteExecutionErrorCode, ExecutionEnvFactory, ExecutionEnvFactoryContext, } from "./core/remote-env.js";
121
+ export type { RemoteExecutionEnv, WorkspaceHandle, SnapshotId, SessionToken, SandboxTier, OutputChunk, ExecStreamOptions, RemoteConnectConfig, VmLifecycleOptions, SecretRef, RemoteExecutionErrorCode, ExecutionEnvFactory, ExecutionEnvFactoryContext, PlacementTarget, } from "./core/remote-env.js";
121
122
  export { addWorktree, pruneWorktrees, WORKTREE_PARENT, type AddWorktreeOptions } from "./core/git-worktree-env.js";
122
123
  export { runExecGate } from "./core/exec-gate.js";
123
124
  export type { ExecStep, ExecStepResult, ExecGateResult, ExecGateOptions } from "./core/exec-gate.js";
@@ -154,6 +155,8 @@ export type { RewindFilesRequest, RewindFilesResult } from "./core/file-history-
154
155
  export type { CompactSessionRequest, CompactSessionResult } from "./core/auto-compaction.js";
155
156
  export { trackKeyOf as fileHistoryTrackKeyOf, resolveTrackKey as fileHistoryResolveTrackKey } from "./core/file-history-store.js";
156
157
  export { describeTrackKey as fileHistoryDescribeTrackKey, fileHistoryExportDigest, validateFileHistoryExport } from "./core/file-history-store.js";
158
+ export { fileHistoryBlobExchangeOf } from "./core/file-history-store.js";
159
+ export type { FileHistoryBlobExchange } from "./core/file-history-store.js";
157
160
  export type { FileHistoryStore, FileHistoryResult, FileHistoryTrackResult, FileHistoryError, FileHistoryKeyFamily, FileHistoryTrackKeyDescriptor, FileHistoryRestoreResult, FileHistoryDiffStats, FileHistoryExport, FileHistoryExportResult, FileBackupCapture, FileRestoreTarget, FileRestoreApplyOptions, FileRestoreApplyOutcome, FileHistoryTrackKeyResolution } from "./core/file-history-store.js";
158
161
  export type { InMemoryFileHistoryStoreOptions } from "./core/file-history-store.js";
159
162
  export { DEFAULT_FILE_HISTORY_BOUNDARY_KEEP, resolveFileHistoryRetention, fileHistoryBoundariesToKeep } from "./core/file-history-retention.js";
@@ -195,14 +198,15 @@ export { type RuleFaceView, catalogRuleFaceView } from "./core/permission-rules.
195
198
  export { DURABLE_HISTORY_NAMES } from "./engine/compaction/utils.js";
196
199
  export { describeStaticWiring, deriveWiringManifest, deriveAskEffective, resolveDeclaredDurability, resolveSubagentTranscriptTier, type SubagentTranscriptTier, resolveAskSeamForm, resolveQuestionSeam, countElicitOptIns, AUTO_MODE_ARM_REASONS, type AutoModeArmReason, type AutoModeArmFact, type WiringManifest, type WiringManifestMcpEntry, LSP_LANES, type LspLane, type WiringFacts, type WiringLegKind, type AskSeamForm, APPROVAL_REACH, type ApprovalReach, isApprovalReach, type AskEffective, type QuestionChannelState, type SeamProvenance, type ParkLaneReason, type ManifestDurability, type StaticWiringDeps, type StaticWiringSpec, } from "./core/wiring-manifest.js";
197
200
  export { RUN_ORIGINS, type RunOrigin, isRunOrigin } from "./core/run-origin.js";
201
+ export { INPUT_AUTHORS, type InputAuthor, isInputAuthor } from "./core/input-author.js";
198
202
  export { probeParkRoundTrip, durableParkGapOf, durableParkGapFor, PARK_SELFCHECK_SCOPE_PREFIX, type ParkSelfCheckResult, type ParkProbeFinding, type ParkProbeFindingCode, } from "./core/park-selfcheck.js";
199
203
  export { type StoreDurability } from "./core/checkpoint-store.js";
200
204
  export { type StoreFidelity } from "./core/checkpoint-store.js";
201
205
  export { projectHumanInput, buildHumanInputEvent, type HumanInputSource, type HumanInputFrame, type HumanInputEvent, type HumanInputDelivery, } from "./core/human-input-projection.js";
202
206
  export { USER_ATTACHMENT_SEAT, USER_ATTACHMENT_KINDS, USER_ATTACHMENT_SUPPLIES, USER_ATTACHMENT_OUTCOMES, USER_ATTACHMENTS_MAX, USER_ATTACHMENT_LABEL_MAX, type UserAttachmentDeclaration, } from "./core/user-attachment.js";
203
207
  export type { HumanInputAttachment } from "./core/types.js";
204
- export { TaskRegistry, defaultTaskRegistry, createTaskOutputTool, createTaskStopTool, type SemaTaskType, type SemaTaskStatus, type SemaTaskHandle, type ParkedClaimTicket, type TaskAccess, type TaskListRow, type UnifiedTaskOutput, type TaskRetrievalStatus, type StopSource, type RegisterMonitorInput, type MonitorTimers, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, engineAgentName, chosenAgentName, type BackgroundShellHardKillReceipt, } from "./core/task-registry.js";
205
- export { InMemoryMailboxStore, type MailboxStore, type MailboxMessage, type MailboxLease, MailboxStoreError, type MailboxStoreErrorCode, MAILBOX_TOMBSTONED_RECIPIENT_CODE, type MailboxAppendMessage, type MailboxPeerMeta, type MailboxPeerFromMode, type MailboxPeerRecordKind, type MailboxPeerNoticeMeta, type MailboxPeerNoticeState, MAILBOX_PEER_NOTICE_STATES, MAILBOX_PEER_FROM_MODES, MAILBOX_PEER_RECORD_KINDS, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_CROSS_PROCESS_UNSAFE_CODE, readMailboxPeerMeta, mailboxCrossProcessMountVerdict, type MailboxCrossProcessVerdict, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_RECORD_ID_MAX_CHARS, MAILBOX_REPLAY_FACETS, type MailboxReplayFacet, readMailboxRecordId, readMailboxAppend, judgeMailboxAppendById, type MailboxAckResult, type MailboxDecision, type MailboxDecisionOutcome, MAILBOX_DECISIONS, MAILBOX_INVALID_DECISION_MOVE_CODE, isMailboxDecision, isMailboxDecisionFinal, isMailboxDecisionDeliverable, mailboxDecisionEdgeAllowed, assertMailboxDecisionMove, moveMailboxDecision, readStoredMailboxDecision, } from "./core/mailbox-store.js";
208
+ export { TaskRegistry, defaultTaskRegistry, createTaskStopTool, type SemaTaskType, type SemaTaskStatus, type SemaTaskHandle, type ParkedClaimTicket, type TaskAccess, type TaskListRow, type UnifiedTaskOutput, type TaskRetrievalStatus, type StopSource, type RegisterMonitorInput, type MonitorTimers, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, engineAgentName, chosenAgentName, type BackgroundShellHardKillReceipt, } from "./core/task-registry.js";
209
+ export { InMemoryMailboxStore, type MailboxStore, type MailboxMessage, type MailboxLease, MailboxStoreError, type MailboxStoreErrorCode, MAILBOX_TOMBSTONED_RECIPIENT_CODE, type MailboxAppendMessage, type MailboxPeerMeta, type MailboxPeerFromMode, type MailboxPeerRecordKind, type MailboxPeerNoticeMeta, type MailboxPeerNoticeState, MAILBOX_PEER_NOTICE_STATES, MAILBOX_PEER_FROM_MODES, MAILBOX_PEER_RECORD_KINDS, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_CROSS_PROCESS_UNSAFE_CODE, readMailboxPeerMeta, mailboxCrossProcessMountVerdict, type MailboxCrossProcessVerdict, mailboxRecipientLifecycleOf, type MailboxRecipientTombstone, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_RECORD_ID_MAX_CHARS, MAILBOX_REPLAY_FACETS, type MailboxReplayFacet, readMailboxRecordId, readMailboxAppend, judgeMailboxAppendById, MAILBOX_CONSUMED_ID_WINDOW, type MailboxConsumedRecord, mailboxReplayDigests, type MailboxAckResult, type MailboxDecision, type MailboxDecisionOutcome, MAILBOX_DECISIONS, MAILBOX_INVALID_DECISION_MOVE_CODE, isMailboxDecision, isMailboxDecisionFinal, isMailboxDecisionDeliverable, mailboxDecisionEdgeAllowed, assertMailboxDecisionMove, moveMailboxDecision, readStoredMailboxDecision, } from "./core/mailbox-store.js";
206
210
  export { FileMailboxStore, type FileMailboxStoreOptions } from "./stores/file/mailbox-store.js";
207
211
  export { createFileTaskListStore } from "./stores/file/task-list-store.js";
208
212
  export { createMonitorTool, type MonitorToolOptions } from "./tools/monitor.js";
@@ -224,6 +228,7 @@ export { createAllowDenyPolicy, createApprovalPolicy,
224
228
  type ApprovalSeatOutcome, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, combinePolicies, abortedSeatDeny, noApproverSeatDeny, wrapToolPolicy, decisionText, resolveAsk, toolPolicyNameSets, toolPolicyPathRules, type ToolPolicyNameSets, type NamedToolPolicy, type ToolPolicyProjection, type ToolPolicyProjectionComponent, type ConstraintChainEntry, checkToolPolicyProjection, constraintChainEntryOf, constraintChainDigest, type ToolPolicy, type ToolCallRequest, type PermissionResult, type DecisionReason, screenApproverAttribution, APPROVER_ATTRIBUTION_MAX_CHARS, BIDI_CONTROL_CHARS, carriesBidiControls, type OnAsk, type AskOutcome, type ResolvedAsk, type EngineAttestation, type AskRequest, type AskDelegationProvenance, type AskRuleEvidence, type AskEvidenceAbsence, ASK_EVIDENCE_ABSENCE_VALUES, } from "./core/tool-policy.js";
225
229
  export { type ReadRootGrantScreen } from "./core/read-root-grant-screen.js";
226
230
  export { type AskOrigin, ASK_ORIGINS, isAskOrigin, ORIGIN_IMPLIES_REAL_APPROVAL, PERSISTED_RULE_MANDATES, type PersistedRuleMandate, isPersistedRuleMandate, screenAskClassMembers } from "./core/ask-origin.js";
231
+ export { type AskReason, HOOK_QUESTION_CAUSES, type HookQuestionCause } from "./core/ask-origin.js";
227
232
  export { PERMISSION_MODES, type PermissionMode, isPermissionMode, PERMISSION_MODE_RANK, clampPermissionMode, ASK_CLASSES, type AskClass, isAskClass, MODE_ARBITRATION, type ModeArbitrationRow, ASK_FACES, type AskFace, askFaceOf, releasableAskClassesFor, MODE_RELEASE_REASONS, type ModeReleaseReason, isModeReleaseReason, RRA_EXPLAINERS, classifyAsk, foldArbitrationRow, type AskClassification, type AskClassFacts, type ToolMarkSource, arbitrateByMode, type Arbitration, fileCommandOptionsSentence } from "./core/ask-origin.js";
228
233
  export { CROSS_BOUNDARY_TAINT_BITS, type CrossBoundaryTaintBit, CROSS_BOUNDARY_POSTURES, type CrossBoundaryPosture, BOUNDARY_LEGS, type BoundaryLeg, type BoundaryLegList, type BoundaryLegsDeclaration, type CrossBoundaryTree, type CrossBoundaryObligation, crossBoundaryObligation, CROSS_BOUNDARY_RECORD_TYPE, type CrossBoundaryRecordData, type CrossBoundaryRecordEntry, type CrossBoundaryRecordRead, readCrossBoundaryRecord, type BoundaryLegsFor, type BoundaryLegsGiven, type CrossBoundaryCall, type CrossBoundaryCheck, type CrossBoundaryExitRefusal, type CrossBoundaryTreeToken } from "./core/cross-boundary-taint.js";
229
234
  export { modePolicyOf, type ModePolicy, PERMISSION_MODE_FOLD_REASONS, type PermissionModeFoldReason, type PermissionModeReceipt, ACCEPT_EDITS_FILE_COMMANDS, modeAcceptsFileCommand } from "./core/mode-policy.js";
@@ -231,12 +236,12 @@ export type { PermissionSeatInputs, PermissionSeatReading } from "./core/mode-po
231
236
  export type { SkillGateSeats, SkillGrantHit, SkillGrantLane, SkillGrantOrigin, SkillGrantRecord } from "./core/skill-grant.js";
232
237
  export { SKILL_GRANT_ORIGINS } from "./core/skill-grant.js";
233
238
  export type { BoundSkillGrants } from "./core/skill-grant-binding.js";
234
- export { ALLOW_ENTRY_INERT_REASONS, readRuleEntry, compileAllowList, renderListEntry, type RuleEntryReading, type AllowEntryInertReason, type AllowEntryInertDetail, type CompiledAllowEntry, type AllowEntryGateSeats, type AllowEntryLane, type AllowEntryHit } from "./core/allow-entry.js";
239
+ export { ALLOW_ENTRY_INERT_REASONS, readRuleEntry, compileAllowList, renderListEntry, type RuleEntryReading, type AllowEntryInertReason, type AllowEntryInertDetail, type CompiledAllowEntry, type AllowEntryGateSeats, type AllowEntryLane, type AllowEntryHit, type AllowListEntry } from "./core/allow-entry.js";
235
240
  export { ALLOW_RULE_MEMBERS, type AllowRuleMember, type AllowRuleShadow } from "./core/allow-rule-shadow.js";
236
241
  export { mintNamespacePrefix } from "./core/protocol-naming.js";
237
242
  export { readDenyClassifierRules, renderClassifierDenyRules, type DerivedDenyRule } from "./core/auto-mode-prompt.js";
238
243
  export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource, type AutoModeDenySource } from "./core/runtime-caps.js";
239
- export { SETTLEMENT_KINDS, type SettlementKind, isSettlementKind, type Settlement, SETTLEMENT_PARTIES, type SettlementParty, isSettlementParty, HOST_DECIDERS, type HostDecider, type HostDecisionFacts, isHostDecider, SETTLEMENT_IS_REFUSAL, DENIED_BY_VALUES, type DeniedBy, isDeniedBy, DENIED_BY_MAY_VETO, CLASSIFIER_DENY_CAUSES, type ClassifierDenyCause, isClassifierDenyCause, DENIED_BY_MAY_CARRY_CAUSE, type GateDisposition, type GateOutcome, type ModeRelease, type ModeRefusal, screenGateOutcome, RETIRED_MEMBERS, isRetiredMember } from "./core/gate-outcome.js";
244
+ export { SETTLEMENT_KINDS, type SettlementKind, isSettlementKind, type Settlement, SETTLEMENT_PARTIES, type SettlementParty, isSettlementParty, HOST_DECIDERS, type HostDecider, type HostDecisionFacts, isHostDecider, DECIDED_VIA, type DecidedVia, SETTLEMENT_IS_REFUSAL, DENIED_BY_VALUES, type DeniedBy, isDeniedBy, DENIED_BY_MAY_VETO, CLASSIFIER_DENY_CAUSES, type ClassifierDenyCause, isClassifierDenyCause, DENIED_BY_MAY_CARRY_CAUSE, type GateDisposition, type GateOutcome, type ModeRelease, type ModeRefusal, screenGateOutcome, RETIRED_MEMBERS, isRetiredMember } from "./core/gate-outcome.js";
240
245
  export { ENGINE_BUILTIN_TOOL_NAMES, isEngineBuiltinToolName } from "./core/tool-catalog-entries.js";
241
246
  export { policyCannotAnswer, type HeldQuestion } from "./core/real-approval.js";
242
247
  export { type AskCarry } from "./core/hooks.js";
@@ -288,8 +293,11 @@ export { adoptLocalDataRoot, ackAdoptionConfig, witnessAdoptionConfig, listAdopt
288
293
  export { formatHookFeedback, runToolGate, createHookEnvCapabilities, type PersistedRuleHit, type PersistedRuleHitRule, type PersistedRuleUnreadable, type PersistedRuleCoverage, type PersistedRuleAnswer, normalizePersistedRuleHit, type HookInvocationIdentity, type ClassicEventBase, type PreToolUseEvent, type PostToolUseEvent, type PostToolUseFailureEvent, type PostToolBatchEvent, type UserPromptSubmitEvent, type SubagentStartEvent, type StopEvent, type StopFailureEvent, type PreCompactEvent, type PostCompactEvent, type StopHookResult, type HookEnvCapabilities, type HookToolOutput, type PreToolUseResult, type PostToolUseResult, type UserPromptSubmitResult, type SubagentStartResult, type HookToolFailure, type PostToolUseFailureResult, type PostToolBatchCall, type PostToolBatchResult, type PreCompactContext, type PreCompactResult, type PostCompactContext, type PermissionDeniedPayload, } from "./core/hooks.js";
289
294
  export type { ClassicEventMap, ClassicEventName, ObservedAnswer, EngineModRegistration } from "./core/mods/classic-events.js";
290
295
  export { KERNEL_CONTRACT_VERSION, MOD_TIERS, MOD_SEATS, MOD_EVENT_SIDES, MOD_EVENT_TABLE, MODS_INVALID_CODE, MODS_REGISTRATION_REFUSED_CODE, type ModTier, type ModRegistrationTier, type ModSeat, type ModEventSide, type ModEventName, type ModEventRow, type ModStation, type ModRegistration, type ModUses, type On, type ModHandler, type ModHandlerOptions, type ModNext, type ModOrigin, type ModTraceEntry, type ModCaughtError, type ModDollarBase, type ModEventPayload, type ModMatcher, type ModAdmissionRecord, } from "./core/mods/kernel/index.js";
291
- export type { EngineDollar, ModelCompleteBlock, ToolCallAnswer } from "./core/mods/dollar.js";
296
+ export type { AgentSpawnAnswer, EngineDollar, ModelCompleteBlock, SessionAppendAnswer, SessionCompactAnswer, SessionSendAnswer, ToolCallAnswer } from "./core/mods/dollar.js";
292
297
  export { admitModChain } from "./core/mods/stations.js";
298
+ export { SESSION_APPEND_DOORS, SESSION_APPEND_ORIGIN_KINDS, type SessionAppendDoor, type SessionAppendOrigin } from "./core/mods/session-append.js";
299
+ export { SESSION_RECEIVE_ORIGIN_KINDS, type SessionReceiveOrigin } from "./core/mods/session-receive.js";
300
+ export { SESSION_SEND_ORIGIN_KINDS, type SessionSendOrigin } from "./core/mods/session-send.js";
293
301
  export { loadModPackage, type ModPackageHost, type ModPackageRegistration } from "./core/mods/package.js";
294
302
  export { CREDENTIAL_REF_KINDS, CREDENTIAL_REF_TRUST, CREDENTIAL_REF_TEXT_MAX, CREDENTIAL_REF_MAP_MAX, CREDENTIAL_REF_PROBLEM_REASONS, readCredentialRef, type CredentialRef, type CredentialRefKind, type CredentialRefRequestAdmission, type CredentialRefProblem, type CredentialRefProblemReason, type CredentialRefReading, } from "@sema-agent/primitives";
295
303
  export { InMemoryMemoryStore, composeMemoryBlock, composeLayeredMemoryBlock, normalizeMemorySpec, type NormalizedMemorySpec, type MemorySpecInput, supportsConsolidation, supportsPeriodicConsolidation, firstSentence, expandLexicalTerms, lexicalSearchMatch, type Embedder, classifyPromotable, enforcePromotableWriteGate, guardedMemoryStore, MemoryGateError, MemoryProjectionError, detectSecret, enforceSecretWriteGate, enforceStructuredNoteSecretGate, type UtilityGate, type MemoryStore, type MemoryVectorMode, type ScoredMemory, type MemoryNoteHeader, type MemoryNoteRecord, type MemoryNoteType, type StructuredNoteInput, MEMORY_PROJECT_KEY_ABSENT_REASONS, type MemoryProjectKeyAbsentReason, type MemoryProjectKey, } from "./core/memory.js";
@@ -297,6 +305,8 @@ export { MemoryEngine, FileMemoryEngineBackend, memoryBackendContract, assertMem
297
305
  export { createConsolidationWriteJudge, deliverWriteRefusal, type ConsolidationWriteJudgeInput } from "./core/runner/memory-consolidation-write-judge.js";
298
306
  export { STORE_FORM_REFUSAL_CODES, TARGET_OUTSIDE_STORE, SCOPE_HOME_NOT_DIRECTORY, SCOPE_HOME_FORMS, type StoreFormRefusalCode, type StoreFormRefusalDetail, type StoreFormRefusal, type ScopeHomeForm } from "./core/memory-engine/layout.js";
299
307
  export { resolveMemoryScopeStore, type MemoryScopeStore, type MemoryScopeStoreInput } from "./core/memory-engine/dual-root.js";
308
+ export { classifyScopePlanes, scopePlanesOf, type ScopePlanes } from "./core/memory-engine/dual-root.js";
309
+ export { createMemoryDeployment, type MemoryDeployment, type MemoryDeploymentInput, type MemoryDeploymentStore, type DeploymentSessionMemoryStatus, } from "./core/memory-engine/memory-deployment.js";
300
310
  export { reanchorMemoryStoreRoot, type StoreRootReanchor } from "./core/memory-engine/layout.js";
301
311
  export { SHARED_MEMORY_READ_CAP_BYTES, SHARED_MEMORY_LIST_PAGE_SIZE, SharedMemoryStoreError, type SharedMemoryStoreProvider, type SharedMemoryStoreReader, type SharedMemoryPagedList, type SharedMemoryStoreInfo, type SharedMemoryDocumentEntry, type SharedMemorySnapshot, type SharedMemoryRequestContext, type MemoryListDetails, type MemoryReadDetails, } from "./core/shared-memory/types.js";
302
312
  export { isSharedMemoryDocumentPath, isSharedMemoryStoreId } from "./core/shared-memory/normalize.js";
@@ -441,7 +451,7 @@ export type { RouteAdjudication, RouteCredential, RouteCredentialSource, RoutePa
441
451
  export { ROUTE_ADJUDICATION_CONFORMANCE_CORPUS, type RouteAdjudicationVector } from "./brain/route-conformance.js";
442
452
  export { type BrainTimeoutConfig } from "./brain/timeout.js";
443
453
  export { createAssistantMessageEventStream } from "./internal/llm.js";
444
- export type { AssistantMessage, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, StopReason, StreamFn, TextContent, ThinkingContent, ToolCall, ToolDescriptionVariant, ToolResultMessage, Usage, UserMessage, UserMessageAttachment, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, } from "./internal/llm.js";
454
+ export type { AssistantMessage, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, StopReason, StreamFn, TextContent, ThinkingContent, ToolCall, ToolDescriptionVariant, ToolResultMessage, Usage, UserMessage, UserMessageAttachment, UserAttachmentKind, UserAttachmentObservation, UserAttachmentOutcome, UserAttachmentSupply, RowRewrittenBy, } from "./internal/llm.js";
445
455
  export type { AgentDefinition, BeforeWriteHook, BeforeWriteRequest, BeforeWriteResult, TrackFileEditHook, TrackEditRequest, TrackEditResult, FileEditedHook, FileEditedNotice, HandsBandOptions, Brain, BrainStatus, BrainStatusPhase, BrainRetryErrClass, ImageInput, UserAttachment, McpElicitRequest, McpElicitResponse, McpServerSpec, A2aServerSpec, OnElicit, Model, ModelRef, ProjectMemoryLoad, RunnerDeps, ResumePreflightInfo, ResumePreflightVerdict, EngineNotice, RuntimeCaps, BackgroundChildEvent, DelegationLifecycleEvent, SkillSpec, TaskEvent, ExtensionRequester, RewriteAuthor, ToolInputRewrite, TaskEventIdentity, ToolActivity, TaskLimits, StaleToolResultOffloadOptions, TaskResult, TerminalCause, PausedCause, EffectiveMemoryScopes, RemoteEnvFailureNote, TaskSpec, ShellGateDoctrine, TaskStatus, TaskStream, CompactOutcome, ThinkingLevel, ToolExecuteContext, ToolReturn, ToolSpec, ToolInputVerdict, ToolInputValidationContext, ReversibilityVerdict, ReadRootGrantCandidate, ToolEffect, ToolContentOrigin, WorkflowGovernanceBaseline, DelegationTaskType, } from "./core/types.js";
446
456
  export { Type } from "typebox";
447
457
  export type { TSchema, Static } from "typebox";
@@ -456,7 +466,7 @@ export type { PeerSeat, PeerQuestion, PeerAnswer, PeerSeatTarget, PeerAskCause }
456
466
  export type { PeerDeclarations, PeerDeclarationHold } from "./core/peer-seat.js";
457
467
  export { readPeerAnswer } from "./core/peer-seat.js";
458
468
  export type { PeerLane, CarriedPieces } from "./core/peer-seat.js";
459
- export { McpHostSeatFailure, type McpHostSeat, type McpHostSeatMethod, type McpHostSeatAnswer } from "./core/mcp-host-seat.js";
469
+ export { McpHostSeatFailure, hostSeatOfRequests, type McpHostSeat, type McpHostRequestSeat, type McpHostSeatMethod, type McpHostSeatAnswer } from "./core/mcp-host-seat.js";
460
470
  export { MCP_TRANSPORT_KINDS, type McpTransportKind } from "./core/mcp-server-spec.js";
461
471
  export { readToolAxes, readMcpToolAxes } from "./core/mcp-server-spec.js";
462
472
  export type { ToolAxesRead, ToolAxesSurface } from "./core/mcp-server-spec.js";
package/dist/index.js CHANGED
@@ -20,7 +20,6 @@ export { createTaskListTools, createMemoryTaskListStore, assertJsonMetadata } fr
20
20
  export { assembleCodeTools, CODE_ROLE } from "./scenarios/full-body.js";
21
21
  export { TOOL_MODEL_GATE_CLASSES, isModelGatedForClass } from "./core/tool-model-gate.js";
22
22
  export { capAggregateToolResults, AGGREGATE_TOOL_RESULT_BUDGET_CHARS, } from "./core/tool-result-budget.js";
23
- export { capAggregateMediaBytes, AGGREGATE_MEDIA_BUDGET_BYTES } from "./core/media-byte-cap.js";
24
23
  export { isMediaBlock, mediaBlockDescriptor } from "./core/media-byte-cap.js";
25
24
  export { createAskUserQuestionTool, createDurableQuestionPolicy, QUESTION_AWAITS_RESUME, isQuestionUnavailable, ASK_USER_QUESTION_TOOL_NAME, } from "./core/ask-question.js";
26
25
  export { createLspTool, gitCheckIgnoreFilter, LSP_OPERATIONS, LSP_FAILURE_BRAND, brandLspFailure, lspFailureOf, SharedAbortScope, settleOnAbort, } from "./core/lsp.js";
@@ -44,7 +43,7 @@ export { runWithVerification, resumeWithVerification, verifyCompleted, runDevelo
44
43
  export { runRepairLoop, terminalForTier, repairBundleFromCheckpoint, isolationPermitsAutoAccept, } from "./agents/repair-loop.js";
45
44
  export { assertOracleIsolation, } from "./core/oracle-isolation.js";
46
45
  export { decideAutoPromote, deriveTripwire, FROZEN_DENYLIST_FLOOR, } from "./core/auto-promote.js";
47
- export { runCascade, } from "./agents/cascade.js";
46
+ export { runCascade, resumeCascade, } from "./agents/cascade.js";
48
47
  export { pgQuery, mysqlQuery, sqliteQuery } from "./tools/sql-adapters.js";
49
48
  export { materializeMcpTools, MCP_PREFIX } from "./core/mcp.js";
50
49
  export { mcpStartupTimeoutMs } from "./core/mcp.js";
@@ -62,7 +61,7 @@ export { STEER_REPLAY_FACETS } from "./core/steer-replay.js";
62
61
  export { TOOL_TURN_INCOMPLETE_CAUSES } from "./internal/llm.js";
63
62
  export { MODEL_OUTPUT_INVALID_CAUSES } from "./internal/llm.js";
64
63
  export { DURABLE_MANDATE_SOURCES } from "./core/tool-policy.js";
65
- export { TERMINAL_CAUSE_IS_REPLAYABLE, PROMPT_BLOCK_CAUSES, isPromptBlockCause } from "./core/terminal-cause.js";
64
+ export { TERMINAL_CAUSE_IS_REPLAYABLE, PROMPT_BLOCK_CAUSES, isPromptBlockCause, REFUSED_REQUEST_PARTS } from "./core/terminal-cause.js";
66
65
  export { RESERVED_AGENT_NAMES } from "./agents/subagent.js";
67
66
  export { WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS } from "./orchestration/workflow-size-guideline.js";
68
67
  export { ENGINE_AUTHORITY_ENVELOPE_TAGS } from "./core/untrusted-text.js";
@@ -94,6 +93,7 @@ export { isBlankCredential } from "./core/secret-env.js";
94
93
  export { ENGINE_CAPABILITIES } from "./core/engine-capabilities.js";
95
94
  export { MAX_EXEC_OUTPUT_BYTES, RollingTailBuffer, markTruncated } from "./core/exec-output-tail.js";
96
95
  export { physicalPathOf, physicalPathOfExisting } from "./core/physical-path.js";
96
+ export { confineShellStart } from "./core/shell-confinement.js";
97
97
  export { RemoteExecutionError, hasDestroy, isRemoteExecutionEnv, isSuspendable, isIsolated, canonicalPathIsAuthoritative, pathsAreHostLocal, keepsReadFloor, missingRestoreSurface, isRetryableRemoteErrorCode, RETRYABLE_REMOTE_ERROR_CODES, } from "./core/remote-env.js";
98
98
  export { withRetry } from "./core/with-retry.js";
99
99
  export { addWorktree, pruneWorktrees, WORKTREE_PARENT } from "./core/git-worktree-env.js";
@@ -125,6 +125,7 @@ export { worldStillMatchesMint, annulProofFailure } from "./core/file-history-st
125
125
  export { FILE_HISTORY_REFUSAL_CLASSES } from "./core/file-history-store.js";
126
126
  export { trackKeyOf as fileHistoryTrackKeyOf, resolveTrackKey as fileHistoryResolveTrackKey } from "./core/file-history-store.js";
127
127
  export { describeTrackKey as fileHistoryDescribeTrackKey, fileHistoryExportDigest, validateFileHistoryExport } from "./core/file-history-store.js";
128
+ export { fileHistoryBlobExchangeOf } from "./core/file-history-store.js";
128
129
  export { DEFAULT_FILE_HISTORY_BOUNDARY_KEEP, resolveFileHistoryRetention, fileHistoryBoundariesToKeep } from "./core/file-history-retention.js";
129
130
  export { FileStorageBackend, FileSessionRepo, FileCheckpointStore, CHECKPOINT_LEDGER_EVENT_KINDS, readCheckpointLedger, FileMemoryStore, FileToolResultStore, FileSessionPolicyStore, FileFileHistoryStore, FileWorkflowJournalStore, MAX_JOURNAL_RESULT_BYTES, oversizeJournalResult, resolveDataRoot, sanitizeScope, sanitizePathComponent, createFileConsolidationLock, atomicWriteFile, writeThenLink, ensureDir, readJsonlRecords, AppendLog, FileStoreLockError, processFingerprint, isProcessLive, } from "./stores/file/index.js";
130
131
  export { CacheBreakDetector } from "./core/cache-break-detector.js";
@@ -157,13 +158,14 @@ export { catalogRuleFaceView } from "./core/permission-rules.js";
157
158
  export { DURABLE_HISTORY_NAMES } from "./engine/compaction/utils.js";
158
159
  export { describeStaticWiring, deriveWiringManifest, deriveAskEffective, resolveDeclaredDurability, resolveSubagentTranscriptTier, resolveAskSeamForm, resolveQuestionSeam, countElicitOptIns, AUTO_MODE_ARM_REASONS, LSP_LANES, APPROVAL_REACH, isApprovalReach, } from "./core/wiring-manifest.js";
159
160
  export { RUN_ORIGINS, isRunOrigin } from "./core/run-origin.js";
161
+ export { INPUT_AUTHORS, isInputAuthor } from "./core/input-author.js";
160
162
  export { probeParkRoundTrip, durableParkGapOf, durableParkGapFor, PARK_SELFCHECK_SCOPE_PREFIX, } from "./core/park-selfcheck.js";
161
163
  export {} from "./core/checkpoint-store.js";
162
164
  export {} from "./core/checkpoint-store.js";
163
165
  export { projectHumanInput, buildHumanInputEvent, } from "./core/human-input-projection.js";
164
166
  export { USER_ATTACHMENT_SEAT, USER_ATTACHMENT_KINDS, USER_ATTACHMENT_SUPPLIES, USER_ATTACHMENT_OUTCOMES, USER_ATTACHMENTS_MAX, USER_ATTACHMENT_LABEL_MAX, } from "./core/user-attachment.js";
165
- export { TaskRegistry, defaultTaskRegistry, createTaskOutputTool, createTaskStopTool, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, engineAgentName, chosenAgentName, } from "./core/task-registry.js";
166
- export { InMemoryMailboxStore, MailboxStoreError, MAILBOX_TOMBSTONED_RECIPIENT_CODE, MAILBOX_PEER_NOTICE_STATES, MAILBOX_PEER_FROM_MODES, MAILBOX_PEER_RECORD_KINDS, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_CROSS_PROCESS_UNSAFE_CODE, readMailboxPeerMeta, mailboxCrossProcessMountVerdict, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_RECORD_ID_MAX_CHARS, MAILBOX_REPLAY_FACETS, readMailboxRecordId, readMailboxAppend, judgeMailboxAppendById, MAILBOX_DECISIONS, MAILBOX_INVALID_DECISION_MOVE_CODE, isMailboxDecision, isMailboxDecisionFinal, isMailboxDecisionDeliverable, mailboxDecisionEdgeAllowed, assertMailboxDecisionMove, moveMailboxDecision, readStoredMailboxDecision, } from "./core/mailbox-store.js";
167
+ export { TaskRegistry, defaultTaskRegistry, createTaskStopTool, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, engineAgentName, chosenAgentName, } from "./core/task-registry.js";
168
+ export { InMemoryMailboxStore, MailboxStoreError, MAILBOX_TOMBSTONED_RECIPIENT_CODE, MAILBOX_PEER_NOTICE_STATES, MAILBOX_PEER_FROM_MODES, MAILBOX_PEER_RECORD_KINDS, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_CROSS_PROCESS_UNSAFE_CODE, readMailboxPeerMeta, mailboxCrossProcessMountVerdict, mailboxRecipientLifecycleOf, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_RECORD_ID_MAX_CHARS, MAILBOX_REPLAY_FACETS, readMailboxRecordId, readMailboxAppend, judgeMailboxAppendById, MAILBOX_CONSUMED_ID_WINDOW, mailboxReplayDigests, MAILBOX_DECISIONS, MAILBOX_INVALID_DECISION_MOVE_CODE, isMailboxDecision, isMailboxDecisionFinal, isMailboxDecisionDeliverable, mailboxDecisionEdgeAllowed, assertMailboxDecisionMove, moveMailboxDecision, readStoredMailboxDecision, } from "./core/mailbox-store.js";
167
169
  export { FileMailboxStore } from "./stores/file/mailbox-store.js";
168
170
  export { createFileTaskListStore } from "./stores/file/task-list-store.js";
169
171
  export { createMonitorTool } from "./tools/monitor.js";
@@ -178,6 +180,7 @@ export { tightenTaskSpec, TaskSpecTightenError } from "./core/tighten-task-spec.
178
180
  export { createAllowDenyPolicy, createApprovalPolicy, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, combinePolicies, abortedSeatDeny, noApproverSeatDeny, wrapToolPolicy, decisionText, resolveAsk, toolPolicyNameSets, toolPolicyPathRules, checkToolPolicyProjection, constraintChainEntryOf, constraintChainDigest, screenApproverAttribution, APPROVER_ATTRIBUTION_MAX_CHARS, BIDI_CONTROL_CHARS, carriesBidiControls, ASK_EVIDENCE_ABSENCE_VALUES, } from "./core/tool-policy.js";
179
181
  export {} from "./core/read-root-grant-screen.js";
180
182
  export { ASK_ORIGINS, isAskOrigin, ORIGIN_IMPLIES_REAL_APPROVAL, PERSISTED_RULE_MANDATES, isPersistedRuleMandate, screenAskClassMembers } from "./core/ask-origin.js";
183
+ export { HOOK_QUESTION_CAUSES } from "./core/ask-origin.js";
181
184
  export { PERMISSION_MODES, isPermissionMode, PERMISSION_MODE_RANK, clampPermissionMode, ASK_CLASSES, isAskClass, MODE_ARBITRATION, ASK_FACES, askFaceOf, releasableAskClassesFor, MODE_RELEASE_REASONS, isModeReleaseReason, RRA_EXPLAINERS, classifyAsk, foldArbitrationRow, arbitrateByMode, fileCommandOptionsSentence } from "./core/ask-origin.js";
182
185
  export { CROSS_BOUNDARY_TAINT_BITS, CROSS_BOUNDARY_POSTURES, BOUNDARY_LEGS, crossBoundaryObligation, CROSS_BOUNDARY_RECORD_TYPE, readCrossBoundaryRecord } from "./core/cross-boundary-taint.js";
183
186
  export { modePolicyOf, PERMISSION_MODE_FOLD_REASONS, ACCEPT_EDITS_FILE_COMMANDS, modeAcceptsFileCommand } from "./core/mode-policy.js";
@@ -187,7 +190,7 @@ export { ALLOW_RULE_MEMBERS } from "./core/allow-rule-shadow.js";
187
190
  export { mintNamespacePrefix } from "./core/protocol-naming.js";
188
191
  export { readDenyClassifierRules, renderClassifierDenyRules } from "./core/auto-mode-prompt.js";
189
192
  export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./core/runtime-caps.js";
190
- export { SETTLEMENT_KINDS, isSettlementKind, SETTLEMENT_PARTIES, isSettlementParty, HOST_DECIDERS, isHostDecider, SETTLEMENT_IS_REFUSAL, DENIED_BY_VALUES, isDeniedBy, DENIED_BY_MAY_VETO, CLASSIFIER_DENY_CAUSES, isClassifierDenyCause, DENIED_BY_MAY_CARRY_CAUSE, screenGateOutcome, RETIRED_MEMBERS, isRetiredMember } from "./core/gate-outcome.js";
193
+ export { SETTLEMENT_KINDS, isSettlementKind, SETTLEMENT_PARTIES, isSettlementParty, HOST_DECIDERS, isHostDecider, DECIDED_VIA, SETTLEMENT_IS_REFUSAL, DENIED_BY_VALUES, isDeniedBy, DENIED_BY_MAY_VETO, CLASSIFIER_DENY_CAUSES, isClassifierDenyCause, DENIED_BY_MAY_CARRY_CAUSE, screenGateOutcome, RETIRED_MEMBERS, isRetiredMember } from "./core/gate-outcome.js";
191
194
  export { ENGINE_BUILTIN_TOOL_NAMES, isEngineBuiltinToolName } from "./core/tool-catalog-entries.js";
192
195
  export { policyCannotAnswer } from "./core/real-approval.js";
193
196
  export {} from "./core/hooks.js";
@@ -221,6 +224,9 @@ export { adoptLocalDataRoot, ackAdoptionConfig, witnessAdoptionConfig, listAdopt
221
224
  export { formatHookFeedback, runToolGate, createHookEnvCapabilities, normalizePersistedRuleHit, } from "./core/hooks.js";
222
225
  export { KERNEL_CONTRACT_VERSION, MOD_TIERS, MOD_SEATS, MOD_EVENT_SIDES, MOD_EVENT_TABLE, MODS_INVALID_CODE, MODS_REGISTRATION_REFUSED_CODE, } from "./core/mods/kernel/index.js";
223
226
  export { admitModChain } from "./core/mods/stations.js";
227
+ export { SESSION_APPEND_DOORS, SESSION_APPEND_ORIGIN_KINDS } from "./core/mods/session-append.js";
228
+ export { SESSION_RECEIVE_ORIGIN_KINDS } from "./core/mods/session-receive.js";
229
+ export { SESSION_SEND_ORIGIN_KINDS } from "./core/mods/session-send.js";
224
230
  export { loadModPackage } from "./core/mods/package.js";
225
231
  export { CREDENTIAL_REF_KINDS, CREDENTIAL_REF_TRUST, CREDENTIAL_REF_TEXT_MAX, CREDENTIAL_REF_MAP_MAX, CREDENTIAL_REF_PROBLEM_REASONS, readCredentialRef, } from "@sema-agent/primitives";
226
232
  export { InMemoryMemoryStore, composeMemoryBlock, composeLayeredMemoryBlock, normalizeMemorySpec, supportsConsolidation, supportsPeriodicConsolidation, firstSentence, expandLexicalTerms, lexicalSearchMatch, classifyPromotable, enforcePromotableWriteGate, guardedMemoryStore, MemoryGateError, MemoryProjectionError, detectSecret, enforceSecretWriteGate, enforceStructuredNoteSecretGate, MEMORY_PROJECT_KEY_ABSENT_REASONS, } from "./core/memory.js";
@@ -228,6 +234,8 @@ export { MemoryEngine, FileMemoryEngineBackend, memoryBackendContract, assertMem
228
234
  export { createConsolidationWriteJudge, deliverWriteRefusal } from "./core/runner/memory-consolidation-write-judge.js";
229
235
  export { STORE_FORM_REFUSAL_CODES, TARGET_OUTSIDE_STORE, SCOPE_HOME_NOT_DIRECTORY, SCOPE_HOME_FORMS } from "./core/memory-engine/layout.js";
230
236
  export { resolveMemoryScopeStore } from "./core/memory-engine/dual-root.js";
237
+ export { classifyScopePlanes, scopePlanesOf } from "./core/memory-engine/dual-root.js";
238
+ export { createMemoryDeployment, } from "./core/memory-engine/memory-deployment.js";
231
239
  export { reanchorMemoryStoreRoot } from "./core/memory-engine/layout.js";
232
240
  export { SHARED_MEMORY_READ_CAP_BYTES, SHARED_MEMORY_LIST_PAGE_SIZE, SharedMemoryStoreError, } from "./core/shared-memory/types.js";
233
241
  export { isSharedMemoryDocumentPath, isSharedMemoryStoreId } from "./core/shared-memory/normalize.js";
@@ -370,7 +378,7 @@ export { RULE_OFFERS_ABSENCES } from "./core/ask-origin.js";
370
378
  export { BOUND_GRANT_ABSENCES } from "./core/skill-grant-binding.js";
371
379
  export { DISPOSABLE_PROMPT_SECTIONS } from "./core/prompt-section-seat.js";
372
380
  export { readPeerAnswer } from "./core/peer-seat.js";
373
- export { McpHostSeatFailure } from "./core/mcp-host-seat.js";
381
+ export { McpHostSeatFailure, hostSeatOfRequests } from "./core/mcp-host-seat.js";
374
382
  export { MCP_TRANSPORT_KINDS } from "./core/mcp-server-spec.js";
375
383
  export { readToolAxes, readMcpToolAxes } from "./core/mcp-server-spec.js";
376
384
  export { receiveDeclaration, DECLARATION_PATH_RULES } from "./core/mcp-server-spec.js";
@@ -7,10 +7,12 @@
7
7
  export type { CompactionPreparation, SummarizationClampDryRun } from "../engine/compaction/compaction.js";
8
8
  export type { InvokedSkillRetention } from "../engine/compaction/utils.js";
9
9
  export type { AgentCoreRuntimeDeps } from "../engine/loop/runtime-deps.js";
10
+ export type { LoopTerminalReason } from "../engine/loop/agent-loop.js";
10
11
  export type { AgentMessage, AgentTool, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode, ToolInputValidationContext, ToolInputVerdict, } from "../engine/loop/types.js";
11
12
  export type { AgentHarnessEvent, CompactionSettings, ExecutionEnv, ExecutionErrorCode, FileError, FileKind, FileErrorCode, FileInfo, Result, WriteExpectation, WriteReceipt, SymlinkChain, BoundFileObject, Session, SessionMetadata, SessionRepo, SessionStorage, SessionTreeEntry, Skill, } from "../engine/harness/types.js";
12
13
  export type { ExecutionEnvExecOptions, ExecResult, ReadFloor, ExecutionEnvCapabilities } from "../engine/harness/types.js";
13
14
  export type { SessionWriteOptions, CompactionEntry } from "../engine/harness/types.js";
15
+ export type { RowAdmission, RowRaising } from "../engine/harness/types.js";
14
16
  export type { ActiveWorktreeSession, WorkspaceState } from "../engine/harness/types.js";
15
17
  export type { GitAnnouncementKind, GitAnnouncementState } from "../engine/harness/types.js";
16
18
  export type { SessionForkOptions } from "../engine/harness/types.js";