@sema-agent/core 7.59.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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,83 +1,98 @@
1
1
  import { selectModel } from "./select-model.js";
2
2
  import { namesRoleBase } from "../prompt-assembly/role-base.js";
3
3
  import { readPromptRole } from "../prompt-assembly/select.js";
4
- import { readMember } from "./thrown-value.js";
4
+ import { bindingShown, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
5
+ import { describeFault, receive } from "./mods/kernel/receive.js";
6
+ import { CONFIG_RECEIPT_MODE, DECLARATION_RECEIPT_MODE, receiveOwnProperties } from "./own-property-receipt.js";
5
7
  import { MODEL_ROLES } from "./types.js";
6
8
  export { MODEL_ROLES } from "./types.js";
7
- function catalogModel(ref, models) {
9
+ export { bindingShown } from "./model-receipt.js";
10
+ function catalogEntry(ref, models) {
8
11
  const m = models != null && (typeof models === "object" || typeof models === "function") && Object.hasOwn(models, ref) ? models[ref] : undefined;
9
12
  return m || undefined;
10
13
  }
11
- function modelBindingRefusal(field, reason, message) {
12
- const e = new Error(message);
13
- e.code = "config.unknown_role";
14
- e.detail = { field, reason };
15
- return e;
14
+ export function catalogModel(ref, models, seat, what = `${bindingShown(ref)} (a catalog entry)`) {
15
+ const m = catalogEntry(ref, models);
16
+ return m === undefined ? undefined : receiveModel(m, seat, what);
16
17
  }
17
18
  const ROLE_RECORD_KEYS = new Set(["model", "select", "thinking", "promptRole", "systemPrompt"]);
18
- function isModelShaped(s) {
19
- try {
20
- if (typeof s === "function" || isList(s)) {
21
- Reflect.ownKeys(s);
22
- return false;
23
- }
24
- if (Reflect.ownKeys(s).some((k) => typeof k !== "string" || !ROLE_RECORD_KEYS.has(k)))
25
- return true;
26
- return readMember(s, "id") !== undefined || readMember(s, "api") !== undefined;
27
- }
28
- catch {
29
- return true;
30
- }
31
- }
32
19
  function isBindingObject(value) {
33
20
  return (typeof value === "object" && value !== null) || typeof value === "function";
34
21
  }
35
- export function bindingShown(value) {
36
- if (typeof value === "string")
37
- return JSON.stringify(value.length > 80 ? `${value.slice(0, 80)}…` : value);
38
- return value === null ? "null" : isList(value) ? "a list" : `a ${typeof value}`;
39
- }
40
- function isList(value) {
41
- try {
42
- return Array.isArray(value);
43
- }
44
- catch {
45
- return false;
46
- }
47
- }
48
22
  function unknownModelRefRefusal(ref, seat) {
49
23
  return modelBindingRefusal(seat, "unknown_model_ref", `Unknown model ref ${bindingShown(ref)} in ${seat}. Provide it in RunnerDeps.models or pass a Model object.`);
50
24
  }
51
25
  function modelOfBinding(value, models, seat, binds) {
52
- assertModelBindingShape(value, seat, binds);
53
26
  if (typeof value === "string") {
54
- const held = catalogModel(value, models);
27
+ const held = catalogModel(value, models, seat);
55
28
  if (held === undefined)
56
29
  throw unknownModelRefRefusal(value, seat);
57
- assertModelObject(held, seat, `${bindingShown(value)} (a catalog entry)`);
58
30
  return held;
59
31
  }
60
- return value;
32
+ return modelObjectAt(value, seat, binds);
61
33
  }
62
- function assertModelBindingShape(value, seat, binds) {
63
- if (typeof value === "string")
64
- return;
34
+ function modelObjectAt(value, seat, binds) {
65
35
  if (typeof value !== "object" || value === null || isList(value)) {
66
36
  throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${bindingShown(value)}, not a model reference — ${binds}.`);
67
37
  }
68
- assertModelObject(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object with a key beyond model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "");
69
- }
70
- function assertModelObject(value, seat, what, note = "") {
71
- const id = readMember(value, "id");
72
- const api = readMember(value, "api");
73
- const [member, got] = typeof id !== "string" || id === "" ? ["id", id] : typeof api !== "string" ? ["api", api] : [undefined, undefined];
74
- if (member === undefined)
75
- return;
76
- const shown = got === undefined ? "absent" : bindingShown(got);
77
- throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${what} whose \`${member}\` is ${shown} — a Model carries a non-empty string \`id\` and a string \`api\`.${note}`);
38
+ return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "");
78
39
  }
79
40
  const ROLE_BINDS = "a role binds a catalog model name or a Model object";
41
+ const TIER_BINDS = "a tier binds a catalog model name or a Model object";
80
42
  const roleModelSeat = (named, seat) => (typeof named === "string" ? seat : `${seat}.model`);
43
+ const RECEIVED_ROLES = new WeakSet();
44
+ const EMPTY_ROLE_RECORD = Object.freeze({});
45
+ function receiveRoleSpec(value, seat) {
46
+ if (typeof value === "function")
47
+ return CONFIG_RECEIPT_MODE.isProxy?.(value) === true ? modelObjectAt(value, `${seat}.model`, ROLE_BINDS) : EMPTY_ROLE_RECORD;
48
+ if (typeof value !== "object" || value === null)
49
+ return value;
50
+ if (isModelSnapshot(value) || RECEIVED_ROLES.has(value))
51
+ return value;
52
+ if (isList(value))
53
+ return EMPTY_ROLE_RECORD;
54
+ if (!isRoleRecord(value))
55
+ return modelObjectAt(value, `${seat}.model`, ROLE_BINDS);
56
+ const read = receive(value, CONFIG_RECEIPT_MODE);
57
+ if (!read.ok)
58
+ throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is a role record that could not be read — ${describeFault(read.fault)}.`);
59
+ const given = read.value;
60
+ const out = {};
61
+ for (const key of Object.keys(given)) {
62
+ let member = given[key];
63
+ if (key === "model" && typeof member === "object" && member !== null && !isList(member))
64
+ member = receiveModel(member, `${seat}.model`, "a Model object");
65
+ else if (key !== "model" && typeof member === "object" && member !== null) {
66
+ const data = receive(member, DECLARATION_RECEIPT_MODE);
67
+ if (!data.ok)
68
+ throw modelBindingRefusal(`${seat}.${key}`, "not_a_model_ref", `${seat}.${key} could not be read as plain data — ${describeFault(data.fault)}.`);
69
+ member = data.value;
70
+ }
71
+ Object.defineProperty(out, key, { value: member, enumerable: true, writable: false, configurable: false });
72
+ }
73
+ RECEIVED_ROLES.add(Object.freeze(out));
74
+ return out;
75
+ }
76
+ function isRoleRecord(value) {
77
+ if (CONFIG_RECEIPT_MODE.isProxy?.(value) === true)
78
+ return false;
79
+ const proto = Object.getPrototypeOf(value);
80
+ if (proto !== Object.prototype && proto !== null)
81
+ return false;
82
+ return Reflect.ownKeys(value).every((k) => typeof k === "string" && ROLE_RECORD_KEYS.has(k));
83
+ }
84
+ export function receiveRoleMap(roles, field) {
85
+ if (roles === undefined || roles === null)
86
+ return undefined;
87
+ if (typeof roles === "object" && RECEIVED_ROLES.has(roles))
88
+ return roles;
89
+ const given = receiveOwnProperties(roles, { subject: field, unit: "role", moment: "when its roles are read" });
90
+ const out = {};
91
+ for (const key of Object.keys(given))
92
+ Object.defineProperty(out, key, { value: receiveRoleSpec(given[key], `roles.${key}`), enumerable: true, writable: false, configurable: false });
93
+ RECEIVED_ROLES.add(Object.freeze(out));
94
+ return out;
95
+ }
81
96
  export function resolveModel(ref, models, seat = "model") {
82
97
  return modelOfBinding(ref, models, seat, "a model is named by a catalog model name or a Model object");
83
98
  }
@@ -105,7 +120,7 @@ export function expandTiers(models, tiers) {
105
120
  const b = Object.hasOwn(tiers, name) ? tiers[name] : undefined;
106
121
  if (b === undefined)
107
122
  return undefined;
108
- return modelOfBinding(b, models, `tiers.${name}`, "a tier binds a catalog model name or a Model object");
123
+ return modelOfBinding(b, models, `tiers.${name}`, TIER_BINDS);
109
124
  };
110
125
  const ownKey = (k) => models !== undefined && Object.hasOwn(models, k) && Boolean(models[k]);
111
126
  const landing = (t, self) => {
@@ -160,6 +175,38 @@ export function expandTiers(models, tiers) {
160
175
  }
161
176
  return out;
162
177
  }
178
+ const RECEIVED_CATALOGS = new WeakSet();
179
+ export function isReceivedCatalog(models) {
180
+ return models !== undefined && RECEIVED_CATALOGS.has(models);
181
+ }
182
+ export function catalogOfDeps(deps) {
183
+ return isReceivedCatalog(deps.models) ? deps.models : receiveModelCatalog(deps.models, deps.tiers, "RunnerDeps").models;
184
+ }
185
+ export function receiveModelCatalog(models, tiers, field) {
186
+ let held;
187
+ if (models !== undefined && models !== null) {
188
+ const given = receiveOwnProperties(models, { subject: `${field}.models`, unit: "entry", moment: "when the catalog is received" });
189
+ held = {};
190
+ for (const key of Object.keys(given)) {
191
+ const m = given[key];
192
+ Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)`) : m, enumerable: true, writable: true, configurable: true });
193
+ }
194
+ }
195
+ let bindings;
196
+ if (tiers !== undefined && tiers !== null) {
197
+ const given = receiveOwnProperties(tiers, { subject: `${field}.tiers`, unit: "binding", moment: "when the catalog is received" });
198
+ bindings = {};
199
+ for (const name of Object.keys(given)) {
200
+ const b = given[name];
201
+ Object.defineProperty(bindings, name, { value: b === undefined || typeof b === "string" ? b : modelObjectAt(b, `tiers.${name}`, TIER_BINDS), enumerable: true, writable: false, configurable: false });
202
+ }
203
+ Object.freeze(bindings);
204
+ }
205
+ const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ? expandTiers(held, bindings) : held;
206
+ if (expanded !== undefined)
207
+ RECEIVED_CATALOGS.add(Object.freeze(expanded));
208
+ return { ...(expanded !== undefined ? { models: expanded } : {}), ...(bindings !== undefined ? { tiers: bindings } : {}) };
209
+ }
163
210
  export function tierAliasVia(word, models) {
164
211
  const via = models?.[TIER_ALIAS_VIA];
165
212
  return via?.get(word) ?? [];
@@ -193,10 +240,7 @@ function roleTierModel(role, models) {
193
240
  if (!models || !models[TIERS_ACTIVE])
194
241
  return undefined;
195
242
  const tier = ROLE_TIER_DEFAULTS[role];
196
- const m = tier !== undefined ? models[tier] : undefined;
197
- if (m)
198
- assertModelObject(m, `tiers.${String(tier)}`, "the catalog entry the tier word names");
199
- return m;
243
+ return tier !== undefined ? catalogModel(tier, models, `tiers.${tier}`, "the catalog entry the tier word names") : undefined;
200
244
  }
201
245
  const FALLBACK = {
202
246
  default: [],
@@ -216,21 +260,21 @@ function specParts(s, seat = "a role seat") {
216
260
  if (!isBindingObject(s)) {
217
261
  throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${bindingShown(s)}, not a model reference — a role binds a catalog model name, a Model object or a { model, select, thinking, systemPrompt } record.`);
218
262
  }
219
- if (isModelShaped(s)) {
263
+ if (isModelSnapshot(s)) {
220
264
  return { model: s };
221
265
  }
222
266
  const cfg = s;
223
267
  return { model: cfg.model, select: cfg.select, thinking: cfg.thinking, promptRole: readPromptRole(`${seat}.promptRole`, cfg.promptRole), systemPrompt: cfg.systemPrompt };
224
268
  }
225
269
  export function roleSpecNamesModel(spec) {
226
- const parts = specParts(spec);
270
+ const parts = specParts(receiveRoleSpec(spec, "a role seat"));
227
271
  return parts.model !== undefined || parts.select !== undefined;
228
272
  }
229
273
  function toConfig(s) {
230
274
  if (s === undefined) {
231
275
  return undefined;
232
276
  }
233
- if (typeof s === "string" || isModelShaped(s)) {
277
+ if (typeof s === "string" || isModelSnapshot(s)) {
234
278
  return { model: s };
235
279
  }
236
280
  return s;
@@ -259,18 +303,20 @@ function assertKnownRole(word, field, ofKey = false) {
259
303
  throw modelBindingRefusal(field, "unknown_role_word", `${ofKey ? `${field} key` : field} names the model role ${shown}, which is not one of ${MODEL_ROLES.join(" / ")} — a word outside the vocabulary binds nothing and resolves nothing; bind the model on one of these roles, or name it on TaskSpec.model`);
260
304
  }
261
305
  export function screenRoleMap(roles, field) {
262
- for (const key of Object.keys(roles ?? {}))
306
+ const received = receiveRoleMap(roles, field);
307
+ for (const key of Object.keys(received ?? {}))
263
308
  assertKnownRole(key, field, true);
264
- for (const [key, value] of Object.entries(roles ?? {})) {
309
+ for (const [key, value] of Object.entries(received ?? {})) {
265
310
  const seat = `roles.${key}`;
266
311
  const named = specParts(value, seat).model;
267
- if (named !== undefined)
268
- assertModelBindingShape(named, roleModelSeat(named, seat), ROLE_BINDS);
312
+ if (named !== undefined && typeof named !== "string")
313
+ modelObjectAt(named, roleModelSeat(named, seat), ROLE_BINDS);
269
314
  }
315
+ return received;
270
316
  }
271
- function mergeRoles(base, over) {
272
- screenRoleMap(base, "RunnerDeps.roles");
273
- screenRoleMap(over, "TaskSpec.roles");
317
+ function mergeRoles(deployment, task) {
318
+ const base = screenRoleMap(deployment, "RunnerDeps.roles");
319
+ const over = screenRoleMap(task, "TaskSpec.roles");
274
320
  const out = { ...base };
275
321
  for (const role of Object.keys(over ?? {})) {
276
322
  out[role] = mergeRoleSpec(base?.[role], over?.[role]);
@@ -286,19 +332,19 @@ function partsModel(parts, models, seat = "a role seat") {
286
332
  if (needs != null && !Array.isArray(needs)) {
287
333
  throw modelBindingRefusal(`${seat}.select`, "not_a_model_ref", `${seat}.select.needs is ${bindingShown(needs)}, not a list of capabilities (vision / reasoning).`);
288
334
  }
289
- const held = models != null && typeof models === "object" ? Object.entries(models).filter(([, m]) => Boolean(m)) : [];
290
- for (const [key, m] of held)
291
- assertModelObject(m, `${seat}.select`, `the catalog entry ${bindingShown(key)} the criteria read`);
292
- const picked = selectModel(held.map(([, m]) => m), parts.select);
293
- if (picked !== undefined)
294
- assertModelObject(picked, `${seat}.select`, "the catalog entry the criteria pick");
295
- return picked;
335
+ const held = [];
336
+ for (const key of models != null && typeof models === "object" ? Object.keys(models) : []) {
337
+ const m = catalogModel(key, models, `${seat}.select`, `the catalog entry ${bindingShown(key)} the criteria read`);
338
+ if (m !== undefined)
339
+ held.push(m);
340
+ }
341
+ return selectModel(held, parts.select);
296
342
  }
297
343
  return undefined;
298
344
  }
299
345
  export function unheldSeatWord(spec, models) {
300
346
  const named = typeof spec === "string" ? spec : isBindingObject(spec) && !("id" in spec && "api" in spec) ? spec.model : undefined;
301
- return typeof named === "string" && catalogModel(named, models) === undefined ? named : undefined;
347
+ return typeof named === "string" && catalogEntry(named, models) === undefined ? named : undefined;
302
348
  }
303
349
  const STRICT_SEATS = new Set(["default", "classifier"]);
304
350
  function seatRead(parts, models, seat, role) {
@@ -342,10 +388,12 @@ export function presetRoleBaseOf(spec, deps) {
342
388
  }
343
389
  export function resolveTaskModel(spec, deps) {
344
390
  const { start, merged, startParts } = chainHead(spec, deps);
345
- if (spec.model !== undefined) {
391
+ const written = spec.model;
392
+ if (written !== undefined) {
393
+ const model = resolveModel(written, deps.models, "TaskSpec.model");
346
394
  return {
347
- model: resolveModel(spec.model, deps.models, "TaskSpec.model"),
348
- modelRef: spec.model,
395
+ model,
396
+ modelRef: typeof written === "string" ? written : model,
349
397
  thinking: spec.thinking ?? startParts.thinking,
350
398
  promptRole: startParts.promptRole,
351
399
  systemPrompt: startParts.systemPrompt,
@@ -366,7 +414,7 @@ export function resolveTaskModel(spec, deps) {
366
414
  }
367
415
  if (firstUnheld !== undefined)
368
416
  throw unheldSeatRefusal(firstUnheld);
369
- throw new Error(`No model for role "${start}": set TaskSpec.model, or configure RunnerDeps.roles / TaskSpec.roles["${start}"] (or a "default" role). A "select" RoleSpec also fails here if no catalog model matches.`);
417
+ throw modelBindingRefusal(`roles.${start}`, "no_model_for_role", `No model for role "${start}": set TaskSpec.model, or configure RunnerDeps.roles / TaskSpec.roles["${start}"] (or a "default" role). A "select" RoleSpec also fails here if no catalog model matches.`);
370
418
  }
371
419
  export function roleModelIfSet(role, spec, deps) {
372
420
  const merged = mergeRoles(deps.roles, spec.roles);
@@ -0,0 +1,10 @@
1
+ /**
2
+ * A direct writer's commit point: a conversation row the leg adds itself (a reconcile's result, a restated frame, a resumed
3
+ * call's settled result) passes the leg's one admission seat first — `session.append` (`mods/session-append.ts`), the seat
4
+ * the harness calls at its own commit points — and then the store keeps it. The seat may rewrite the row in place; what is
5
+ * stored, and what the caller reads off the row after, is the row as admitted. Absent seat ⇒ the row as made.
6
+ */
7
+ import type { AgentMessage, RowAdmission } from "../internal/harness-types.js";
8
+ export declare function appendAdmittedRow(admit: RowAdmission | undefined, session: {
9
+ appendMessage(message: AgentMessage): Promise<string>;
10
+ }, row: AgentMessage): Promise<string>;
@@ -0,0 +1,5 @@
1
+ export async function appendAdmittedRow(admit, session, row) {
2
+ if (admit !== undefined)
3
+ await admit([row]);
4
+ return session.appendMessage(row);
5
+ }
@@ -17,6 +17,9 @@ import type { AssertAllKeysHandled } from "./ask-origin.js";
17
17
  * identity surface is indistinguishable from a real one downstream. Cloud sync and cloud tickets accept
18
18
  * ONLY the `principal` kind: syncing is an authenticated act, and a local-owner bucket has no cloud home
19
19
  * until it is adopted (`adoptFilePermissionRuleStore`).
20
+ *
21
+ * A memory layer's owner is read the same way: the identity-less owner is this `local-owner` arm, and its layer
22
+ * keeps an opaque key, never a `user:` key (`@contract memory.identity_absence.opaque_key`, scope-contract.ts).
20
23
  */
21
24
  export type RuleOwner = {
22
25
  kind: "principal";
@@ -4,7 +4,7 @@
4
4
  * the `advisor_tool` attachment kind: it rides a fresh leg's first request, and a compaction inside a leg that mounts the
5
5
  * tool restates the full text right after it lands. Model lane only: no `steering_injected` echo.
6
6
  */
7
- import type { AnnouncedAdvisorState, AnnouncedListingSnapshotInput } from "../../internal/harness.js";
7
+ import type { AnnouncedAdvisorState, AnnouncedListingSnapshotInput, RowAdmission } from "../../internal/harness.js";
8
8
  import type { PostureFrameRef } from "../auto-mode-directive.js";
9
9
  import type { StoredSession } from "../session.js";
10
10
  import type { FrameReceiptLedger } from "./contracts.js";
@@ -63,6 +63,7 @@ export declare function appendAdvisorRestate(prepared: {
63
63
  readonly advisorInstruction?: AdvisorInstructionSeat;
64
64
  readonly reminderMark: string;
65
65
  readonly session: Pick<StoredSession, "appendMessage">;
66
+ readonly admitRows: RowAdmission;
66
67
  readonly batchHaltRef: {
67
68
  readonly current?: unknown;
68
69
  };
@@ -1,3 +1,4 @@
1
+ import { appendAdmittedRow } from "../row-admission.js";
1
2
  import { mintSystemReminder } from "../reminder-mint.js";
2
3
  import { thrownText } from "../thrown-value.js";
3
4
  export const ADVISOR_TOOL_INSTRUCTIONS = `# Advisor Tool
@@ -49,7 +50,7 @@ export async function appendAdvisorRestate(prepared) {
49
50
  return;
50
51
  const text = mintSystemReminder(ADVISOR_TOOL_INSTRUCTIONS, prepared.reminderMark);
51
52
  try {
52
- await prepared.session.appendMessage({ role: "user", content: [{ type: "text", text }], timestamp: Date.now(), engineMinted: true });
53
+ await appendAdmittedRow(prepared.admitRows, prepared.session, { role: "user", content: [{ type: "text", text }], timestamp: Date.now(), engineMinted: true });
53
54
  }
54
55
  catch (err) {
55
56
  try {
@@ -3,10 +3,10 @@ import type { AnnounceOnceSink } from "./contracts.js";
3
3
  import type { McpDroppedTool, McpServerStatus } from "../mcp.js";
4
4
  import type { McpUnavailableEntry } from "../mcp-failure.js";
5
5
  import type { RunnerDeps } from "../types.js";
6
- /** Upper bound on the advisory-digest arm kept in the record (oldest dropped past it). A digest is
7
- * 64 hex chars; a session accumulates a handful of distinct advisories, never hundreds — the bound
8
- * keeps a pathological deployment (a warning whose text embeds a per-run value) from growing the
9
- * snapshot without limit while still holding every realistic set. */
6
+ /** Upper bound on the advisory-digest arm kept in the record (oldest dropped past it). A digest is 64 hex chars; the arm
7
+ * holds a session's distinct advisories (a handful) and the digest of every media block the request budget cut and told
8
+ * (`media-removed-seat.ts` — a session with many images can pass the bound): past it the oldest go, whichever face wrote
9
+ * them, and their fact is said again by a later run, never lost. The bound keeps the snapshot finite. */
10
10
  export declare const ANNOUNCE_ONCE_MAX_DIGESTS = 200;
11
11
  /** Stable digest of one announcement: `sha256(lane \n text)` as hex. Opaque on the wire; only ever
12
12
  * compared for equality. */
@@ -1,8 +1,8 @@
1
1
  import type { AssistantMessage } from "../../internal/llm.js";
2
2
  import type { HumanReviewGateRow } from "../task-result.js";
3
- import type { NestedUsage, PausedCause, TaskResult, TaskSpec, TerminalCause } from "../types.js";
3
+ import type { NestedUsage, PausedCause, TaskResult, TerminalCause } from "../types.js";
4
4
  import type { TerminalBlockedDetail } from "../terminal-cause.js";
5
- import type { HaltConsumption } from "../../internal/harness.js";
5
+ import type { HaltConsumption, LoopTerminalReason } from "../../internal/harness.js";
6
6
  /** Per-task usage/cost accumulator (filled across the run loop, surfaced as `TaskResult.stats`). */
7
7
  export interface Stats {
8
8
  turns: number;
@@ -48,7 +48,6 @@ export interface Stats {
48
48
  * only when ≥1 engaged; flows straight through to `TaskResult.stats.mechanisms` via the
49
49
  * public-stats spread. */
50
50
  mechanisms?: {
51
- finalVerifyInjected?: true;
52
51
  finalVerifyInjections?: number;
53
52
  attachmentsInjected?: number;
54
53
  repetitionCuts?: number;
@@ -90,10 +89,6 @@ export interface Stats {
90
89
  llmRootMicroUsd: number;
91
90
  /** Delegated sub-agent (nested) LLM cost (micro-USD) = `stats.nested?.costMicroUsd ?? 0`. */
92
91
  nestedSubagentMicroUsd: number;
93
- /** Post-task memory-consolidation LLM cost (micro-USD) = `stats.memory?.costMicroUsd ?? 0`. Permanently
94
- * 0: the runner-integrated consolidation pass is retired (the public `TaskStats` doc is the one home
95
- * for what would fill it again). */
96
- memoryConsolidationMicroUsd: number;
97
92
  /** Within-task compaction LLM cost (micro-USD) = the running `compactionMicroUsd` accumulator (the
98
93
  * category Framing-4 missed). This IS part of `costMicroUsd`, so it is subtracted from `llmRoot`. */
99
94
  compactionMicroUsd: number;
@@ -171,6 +166,9 @@ export interface ResultFlags {
171
166
  * read-posture seats above: present iff prepare completed (the memory-less states are their own
172
167
  * values — absence means only "prepare never ran to completion"). */
173
168
  effectiveMemoryScopes?: TaskResult["effectiveMemoryScopes"];
169
+ /** The leg's frozen placement fixed point, echoed on `TaskResult.placementRoot`. Pure pass-through on every terminal (the
170
+ * same law as the observation seats above); absent ⇒ the key is omitted. */
171
+ placementRoot?: TaskResult["placementRoot"];
174
172
  /** The leg's effective reasoning resolution, echoed on `TaskResult.effectiveReasoning`.
175
173
  * Pure pass-through on every terminal (same law as the read-posture seats): the SAME object the
176
174
  * `reasoning.resolved` trace frame carried (runtask resolves once per leg — two faces, one mint);
@@ -208,6 +206,8 @@ export interface ResultFlags {
208
206
  * the loop folded it into a text-only failure message, so the typed code rides this flag. */
209
207
  gitCoreOverBudget?: boolean;
210
208
  outputInvalid?: boolean;
209
+ /** The word the loop's last exit named (`Prepared.loopTerminalRef`), read through `loopExitFailureOf`; absent = the loop never exited. */
210
+ loopTerminal?: LoopTerminalReason;
211
211
  /** A re-suspend was refused because the task already suspended `maxSuspends` times
212
212
  * (a resume/restart loop). It aborted the run (no `threw`) but must read as `failed`/`suspend.loop`,
213
213
  * NOT `suspended` — slotted ABOVE `suspendRef` and the aborted branches (this suspend never minted a
@@ -312,6 +312,11 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
312
312
  * the pass-through seat; an accepted-but-unconsumed halt never reaches this slot)
313
313
  * 10. no `final` → status `"failed"`
314
314
  * 11. stopReason error → brain `[code]` prefix (or `"conflict"` from the storage-layer flag)
315
+ * 11.5 the loop exited on a spent recovery budget (`loopTerminal`, read through `loopExitFailureOf`) →
316
+ * `"model.malformed_tool_use_exhausted"` | `"model.truncated_output_exhausted"` (status `"failed"`)
315
317
  * 12. else → `"completed"`
316
318
  */
317
- export declare function assembleResult(spec: TaskSpec, sessionId: string, final: AssistantMessage | undefined, stats: Stats, flags: ResultFlags): TaskResult;
319
+ export declare function assembleResult(leg: {
320
+ readonly taskId: string;
321
+ readonly sessionId: string;
322
+ }, final: AssistantMessage | undefined, stats: Stats, flags: ResultFlags): TaskResult;
@@ -1,6 +1,6 @@
1
1
  import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
2
2
  import { extractErrorCode, isProviderEchoShape, refusedTheRequest, stripErrorCodePrefix } from "../../brain/errors.js";
3
- import { completedTerminalOf, modelOutputInvalidOfMessage, providerVerdictOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
3
+ import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
4
4
  import { terminalProjection } from "./terminal-projection.js";
5
5
  import { haltConsumed } from "./halt-attribution.js";
6
6
  import { providerReportedModel } from "../message-utils.js";
@@ -50,7 +50,9 @@ export function terminalCauseOf(final, stats, flags) {
50
50
  !flags.abortedLive &&
51
51
  flags.abortedForTimeout !== true &&
52
52
  flags.abortedForTurns !== true;
53
- const isDegenerate = final?.stopReason === "error" && isDegenerateCutMessage(final);
53
+ const errorKind = readMember(final, "errorKind");
54
+ const isDegenerate = final?.stopReason === "error" && isDegenerateCutMessage({ errorKind: errorKind });
55
+ const loopExit = loopExitFailureOf(flags.loopTerminal);
54
56
  if (flags.outputInvalid) {
55
57
  terminal = { kind: "failed", code: "output.invalid", message: "model did not produce a valid structured output within the retry limit" };
56
58
  }
@@ -97,7 +99,7 @@ export function terminalCauseOf(final, stats, flags) {
97
99
  const code = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : undefined;
98
100
  terminal = { kind: "failed", ...(code !== undefined ? { code } : {}), message: final?.errorMessage ?? (flags.abortedForTurns ? "max turns exceeded" : "run aborted") };
99
101
  }
100
- else if (haltConsumed(flags.haltConsumption) && (!final || haltOwnsAbortedFinal)) {
102
+ else if ((haltConsumed(flags.haltConsumption) && (!final || haltOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
101
103
  terminal = { kind: "completed" };
102
104
  }
103
105
  else if (!final) {
@@ -137,20 +139,23 @@ export function terminalCauseOf(final, stats, flags) {
137
139
  let detail;
138
140
  if (messageNamed && apiError && typeof apiStatus === "number" && refusedTheRequest(apiStatus)) {
139
141
  const route = requestRouteOfMessage(final);
140
- detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...(route !== undefined ? { route } : {}) };
142
+ detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
141
143
  }
142
144
  else if (messageNamed && outputInvalid !== undefined) {
143
145
  detail = { kind: "model_output_invalid", ...outputInvalid };
144
146
  }
145
147
  terminal = { kind: "failed", code, message, ...(detail !== undefined ? { detail } : {}) };
146
148
  }
149
+ else if (loopExit !== undefined) {
150
+ terminal = { kind: "failed", code: loopExit.code, message: loopExit.message };
151
+ }
147
152
  else {
148
153
  terminal = completedTerminalOf(final);
149
154
  }
150
155
  return { terminal, apiFailure };
151
156
  }
152
- export function assembleResult(spec, sessionId, final, stats, flags) {
153
- const taskId = spec.taskId ?? sessionId;
157
+ export function assembleResult(leg, final, stats, flags) {
158
+ const { taskId, sessionId } = leg;
154
159
  const text = final ? assistantText(final) : "";
155
160
  const responseModel = final === undefined ? undefined : providerReportedModel(final);
156
161
  if (!flags.unpricedSpend) {
@@ -159,7 +164,6 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
159
164
  stats.costBreakdown = {
160
165
  llmRootMicroUsd: Math.max(0, stats.costMicroUsd - compactionMicroUsd),
161
166
  nestedSubagentMicroUsd,
162
- memoryConsolidationMicroUsd: 0,
163
167
  compactionMicroUsd,
164
168
  ...(stats.sideCallMicroUsd !== undefined ? { sideCallMicroUsd: stats.sideCallMicroUsd } : {}),
165
169
  };
@@ -178,5 +182,5 @@ export function assembleResult(spec, sessionId, final, stats, flags) {
178
182
  if (flags.unpricedSpend)
179
183
  delete publicStats.costMicroUsd;
180
184
  const stampHaltedByUser = haltConsumed(flags.haltConsumption);
181
- return { taskId, ...(flags.runId !== undefined ? { runId: flags.runId } : {}), sessionId, terminal, ...(flags.model !== undefined ? { model: flags.model } : {}), ...(responseModel !== undefined ? { responseModel } : {}), result: result.trim(), ...(flags.answerEntryIds !== undefined ? { resultEntryIds: [...flags.answerEntryIds] } : {}), salvagedOutput, ...(apiFailure !== undefined ? { apiFailure } : {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.editedFiles !== undefined && flags.editedFiles.length > 0 ? { editedFiles: flags.editedFiles } : {}), ...(flags.haltedOnUserRejection === true ? { haltedOnUserRejection: true } : {}), ...(stampHaltedByUser ? { haltedByUser: true } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: [...flags.remoteEnvFailures] } : {}), ...(flags.strandedHumanAnswers !== undefined && flags.strandedHumanAnswers.length > 0 ? { strandedHumanAnswers: flags.strandedHumanAnswers } : {}), ...(flags.effectiveReadFace !== undefined ? { effectiveReadFace: flags.effectiveReadFace } : {}), ...(flags.effectiveWriteFace !== undefined ? { effectiveWriteFace: flags.effectiveWriteFace } : {}), ...(flags.effectiveReadDenyPatterns !== undefined && flags.effectiveReadDenyPatterns.length > 0 ? { effectiveReadDenyPatterns: flags.effectiveReadDenyPatterns } : {}), ...(flags.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: flags.effectiveMemoryScopes } : {}), ...(flags.effectiveReasoning !== undefined ? { effectiveReasoning: flags.effectiveReasoning } : {}), ...(flags.compaction !== undefined ? { compaction: flags.compaction } : {}), stats: publicStats };
185
+ return { taskId, ...(flags.runId !== undefined ? { runId: flags.runId } : {}), sessionId, terminal, ...(flags.model !== undefined ? { model: flags.model } : {}), ...(responseModel !== undefined ? { responseModel } : {}), result: result.trim(), ...(flags.answerEntryIds !== undefined ? { resultEntryIds: [...flags.answerEntryIds] } : {}), salvagedOutput, ...(apiFailure !== undefined ? { apiFailure } : {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.editedFiles !== undefined && flags.editedFiles.length > 0 ? { editedFiles: flags.editedFiles } : {}), ...(flags.haltedOnUserRejection === true ? { haltedOnUserRejection: true } : {}), ...(stampHaltedByUser ? { haltedByUser: true } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: [...flags.remoteEnvFailures] } : {}), ...(flags.strandedHumanAnswers !== undefined && flags.strandedHumanAnswers.length > 0 ? { strandedHumanAnswers: flags.strandedHumanAnswers } : {}), ...(flags.effectiveReadFace !== undefined ? { effectiveReadFace: flags.effectiveReadFace } : {}), ...(flags.effectiveWriteFace !== undefined ? { effectiveWriteFace: flags.effectiveWriteFace } : {}), ...(flags.effectiveReadDenyPatterns !== undefined && flags.effectiveReadDenyPatterns.length > 0 ? { effectiveReadDenyPatterns: flags.effectiveReadDenyPatterns } : {}), ...(flags.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: flags.effectiveMemoryScopes } : {}), ...(flags.placementRoot !== undefined ? { placementRoot: flags.placementRoot } : {}), ...(flags.effectiveReasoning !== undefined ? { effectiveReasoning: flags.effectiveReasoning } : {}), ...(flags.compaction !== undefined ? { compaction: flags.compaction } : {}), stats: publicStats };
182
186
  }
@@ -26,9 +26,12 @@ export interface ToolResultSeatEvent {
26
26
  details: unknown;
27
27
  isError: boolean;
28
28
  }
29
- /** The station: the patch the loop applies to the result (`undefined` = unchanged). */
29
+ /** The station: the patch the loop applies to the result (`undefined` = unchanged); `details` (emptied) and `isError` only on a
30
+ * result it withholds — nothing of the result rides on. */
30
31
  export type ToolResultStation = (e: ToolResultSeatEvent) => Promise<{
31
32
  content: Array<TextContent | ImageContent | DocumentContent>;
33
+ details?: Record<string, never>;
34
+ isError?: true;
32
35
  } | undefined>;
33
36
  export interface ToolResultStationInput {
34
37
  /** borrowed-readonly — the leg's mods bus: `classic.PostToolUse` / `classic.PostToolUseFailure` are raised on it, and a
@@ -40,6 +43,9 @@ export interface ToolResultStationInput {
40
43
  toolRosterDeltas: ToolRosterDeltaSeat;
41
44
  /** borrowed-mutable — PreToolUse `additionalContext` per call id. Writer here: the one-shot drain (`delete`). */
42
45
  preToolContexts: Map<string, string[]>;
46
+ /** borrowed-readonly — an inherited installation judges this leg's calls at its gate, so a context line may be stashed for a
47
+ * call though no handler of the leg's own hangs on `classic.PreToolUse`. */
48
+ inheritedScreens: boolean;
43
49
  /** borrowed-readonly — prepare's abort seat; `.signal` is the post events' abort and the failure event's interrupt fact. */
44
50
  abortController: {
45
51
  readonly signal: AbortSignal;
@@ -61,8 +67,8 @@ export interface ToolResultStationInput {
61
67
  }
62
68
  /** The `tool_result` station, or undefined when no post / screening hook is wired (nothing to register). */
63
69
  export declare function createToolResultStation(input: ToolResultStationInput): ToolResultStation | undefined;
64
- /** What the resumed leg does with the approved call: refuse it with a sentence (it is NOT executed), or run these bytes.
65
- * `admit` stashes the screen's context for the result's drain — called only once the call is past every belt and about
70
+ /** What the resumed leg does with the approved call: refuse it with a sentence (it is NOT executed), or let the approved bytes
71
+ * run. `admit` stashes the screen's context for the result's drain — called only once the call is past every belt and about
66
72
  * to run (a refused call stashes nothing, the live gate's rule). */
67
73
  export type ApprovedCallScreen = NonNullable<Prepared["approvedCallScreen"]>;
68
74
  export type ApprovedCallVerdict = Awaited<ReturnType<ApprovedCallScreen>>;
@@ -89,15 +95,16 @@ export interface ApprovedCallScreenInput {
89
95
  * the call (the decide is the upper bound; the screen can only narrow): a deny, a failed or cancelled screening, or a
90
96
  * refused answer refuses the call in the live gate's own sentences; an ask is the question the decide already answered —
91
97
  * unless it demands a person and the decide was the deployment's policy (the one predicate every resume station holds a
92
- * decide against); a rewrite comes back as the args — what executes when the decide carried no edit, a refusal of the edit
93
- * when it did (a person's bytes are the ceiling, rewrite-rejudge.ts); context rides the result. Undefined when no handler hangs
94
- * on `classic.PreToolUse`.
98
+ * decide against); context rides the result. Its three outlets are those — a refusal, an ask, the context: a rewrite is not
99
+ * one. The bytes that run are the bytes the decide approved (the person's edit, or the call as shown), so an `updatedInput`
100
+ * here is not adopted — the reference's form, where a parked answer's own input stands over the hook's. Undefined when no
101
+ * handler hangs on `classic.PreToolUse`.
95
102
  */
96
103
  export declare function createApprovedCallScreen(input: ApprovedCallScreenInput): ApprovedCallScreen | undefined;
97
104
  /**
98
- * Why the frozen inherited chain cannot judge bytes no gate judged (an approver's edit, the re-screen's rewrite): the
99
- * row predates the chain, a layer is opaque, or a layer declares a live remainder — undefined when the frozen
100
- * projections can judge them, or when no parent constraint binds. ONE rule for the pre-claim edit rung (which refuses
101
- * the edit, the row pending) and the resumed leg's belt (which refuses a rewrite, the approval spent).
105
+ * Why the frozen inherited chain cannot judge bytes no gate judged (an approver's edit): the row predates the chain, a
106
+ * layer is opaque, or a layer declares a live remainder — undefined when the frozen projections can judge them, or when no
107
+ * parent constraint binds. ONE rule for the pre-claim edit rung (which refuses the edit, the row pending) and the resumed
108
+ * leg's belt behind it (which refuses it, the approval spent).
102
109
  */
103
110
  export declare function chainCannotJudge(ig: Checkpoint["state"]["inheritedGate"]): string | undefined;