@sema-agent/core 7.66.1 → 7.67.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 (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,9 +1,11 @@
1
1
  import { isMailboxDecisionFinal, mailboxCrossProcessMountVerdict, moveMailboxDecision, sessionBoxMountVerdict } from "../core/mailbox-store.js";
2
2
  import { decodeEngineFrame, deliveryDiscardedNotice, ENGINE_FRAME_CODEC_VERSION, frameDelivery, renderTaskNotificationXml, taskNotificationDedupKey } from "../core/task-notification.js";
3
+ import { isBlankInput } from "../core/input-author.js";
3
4
  import { sameOccupant } from "../engine/session/repo-utils.js";
4
5
  import { createFrameSettlement, toolResultReceiptKey } from "../core/frame-settlement.js";
5
6
  import { PRINCIPAL_INBOX_HANDLE } from "./cross-session-ref.js";
6
- import { isGateMintedRecord, principalInboxConsumerOf } from "./org-delivery-gate.js";
7
+ import { consumerRefusal, isGateMintedRecord, principalInboxConsumerOf } from "./org-delivery-gate.js";
8
+ import { READ_INBOX_TOOL_NAME } from "./read-inbox-tool.js";
7
9
  import { deliverEngineNotice } from "../core/types.js";
8
10
  import { buildCrossSessionEnvelope, CrossSessionCodecError, encodePeerAddress } from "./cross-session-envelope.js";
9
11
  import { isCrossSessionHoldCause, judgeCrossSessionInbound, principalInboundLayers, resolveCrossSessionInboundSetting } from "./cross-session-judge.js";
@@ -16,7 +18,7 @@ import { peerHeldQueueFor } from "./peer-held-queue.js";
16
18
  import { peerIdleMachineFor } from "./peer-idle.js";
17
19
  import { describePeerIdleSubscription, isPeerDeliveryReceiptState, isPeerIdleNoticeKind, peerHeldReceiptStateOf, peerIdleNoticeLabel, renderCrossSessionDeliveryNotice, renderCrossSessionDroppedNotice, renderCrossSessionIdleNotice, resolveCrossSessionDialogExpiry } from "./peer-notices.js";
18
20
  import { routePeerDeliveryReceipt, routePeerDroppedReceipt, routePeerIdleNotice } from "./peer-notice-route.js";
19
- import { thrownText } from "../core/thrown-value.js";
21
+ import { readMember, readMemberOrUnreadable, thrownText, UNREADABLE } from "../core/thrown-value.js";
20
22
  export const PEER_DRAIN_LEASE_TTL_MS = 5 * 60_000;
21
23
  export const PEER_SESSION_ID_UNGRAMMATICAL_CODE = "peer.session_id_ungrammatical";
22
24
  export const PRINCIPAL_INBOX_UNMINTED_CAUSE = "not_minted_by_delivery_gate";
@@ -28,11 +30,67 @@ export function peerDrainLanesOf(deps, leg) {
28
30
  const consumer = principalInboxConsumerOf(deps);
29
31
  const principalInbox = consumer.kind === "terminals"
30
32
  ? sessionBox !== undefined ? "drain" : undefined
31
- : consumer.kind === "assistant" && consumer.handle === leg.hostTaskId && isPeerSessionId(leg.sessionId) ? "pullOnly" : undefined;
33
+ : consumer.kind === "assistant" && seatAnsweringFor(leg.assistantSeat, leg.sessionId) !== undefined && isPeerSessionId(leg.sessionId) ? "pullOnly" : undefined;
32
34
  if (sessionBox === undefined && principalInbox === undefined)
33
35
  return undefined;
34
36
  return { ...(sessionBox !== undefined ? { sessionBox } : {}), ...(principalInbox !== undefined ? { principalInbox } : {}) };
35
37
  }
38
+ function readAssistantSeat(seat) {
39
+ if (seat === null || typeof seat !== "object")
40
+ return { ok: false, problem: seat === null ? "null" : typeof seat };
41
+ const sessionId = readMember(seat, "sessionId");
42
+ const onLetters = readMemberOrUnreadable(seat, "onLetters");
43
+ if (typeof sessionId !== "string")
44
+ return { ok: false, problem: sessionId === undefined ? "an object without sessionId" : `a sessionId of type ${typeof sessionId}` };
45
+ if (sessionId === "")
46
+ return { ok: false, problem: "an empty sessionId" };
47
+ if (isBlankInput(sessionId))
48
+ return { ok: false, problem: "a blank sessionId" };
49
+ if (onLetters === UNREADABLE)
50
+ return { ok: false, problem: "an onLetters that would not read" };
51
+ if (onLetters !== undefined && typeof onLetters !== "function")
52
+ return { ok: false, problem: `an onLetters of type ${onLetters === null ? "null" : typeof onLetters}` };
53
+ return { ok: true, sessionId, onLetters: onLetters, seat };
54
+ }
55
+ function seatAnsweringFor(seat, sessionId) {
56
+ const reading = readAssistantSeat(seat);
57
+ return reading.ok && reading.sessionId === sessionId ? reading : undefined;
58
+ }
59
+ export function principalInboxSeatRefusal(deps, leg) {
60
+ const seat = leg.assistantSeat;
61
+ if (seat === undefined)
62
+ return undefined;
63
+ const reading = readAssistantSeat(seat);
64
+ if (!reading.ok) {
65
+ return consumerRefusal(`RunInternals.principalInboxAssistant must be an object whose sessionId is the assistant leg's own session id (a string with a character that is neither whitespace nor a control character) and whose onLetters, when present, is a function, got ${reading.problem}`, "malformed");
66
+ }
67
+ if (reading.sessionId !== leg.sessionId)
68
+ return undefined;
69
+ if (leg.lanes?.principalInbox === "pullOnly" && leg.readInbox === "free")
70
+ return undefined;
71
+ const facts = [];
72
+ const consumer = principalInboxConsumerOf(deps);
73
+ if (consumer.kind !== "assistant")
74
+ facts.push(`the deployment declares RunnerDeps.principalInboxConsumer ${consumer.kind === "none" ? "absent" : `"${consumer.kind}"`}, not "assistant"`);
75
+ const mailbox = deps.mailboxStore;
76
+ if (mailbox === undefined)
77
+ facts.push("no mailbox store is mounted (RunnerDeps.mailboxStore is absent)");
78
+ else {
79
+ const verdict = mailboxCrossProcessMountVerdict(mailbox);
80
+ if (!verdict.ok)
81
+ facts.push(verdict.reason);
82
+ }
83
+ if (!isPeerSessionId(leg.sessionId))
84
+ facts.push(`the leg's session id ${JSON.stringify(inlineUntrusted(leg.sessionId, 96))} is outside the peer address grammar ${PEER_SESSION_ID_GRAMMAR}`);
85
+ if (!leg.notifies)
86
+ facts.push("the host gave the leg no RunInternals.onTaskNotification, and no drain binds without it");
87
+ if (leg.readInbox === "excluded")
88
+ facts.push(`the leg's tool selector (excludeTools / allowTools / excludeAllTools) takes ${READ_INBOX_TOOL_NAME} away`);
89
+ if (leg.readInbox === "shadowed")
90
+ facts.push(`a caller tool in TaskSpec.tools is named ${READ_INBOX_TOOL_NAME} and shadows the inbox's pull face`);
91
+ return consumerRefusal(`the host handed this leg RunInternals.principalInboxAssistant (it is the scope's assistant leg), but the leg cannot read its principal inbox: ${facts.join("; ")}. ` +
92
+ `A seat is refused rather than run, so the assistant does not end its run having read nothing`, "seat_unbound");
93
+ }
36
94
  export function judgePeerLaneMount(deps, sessionId, sessions) {
37
95
  if (deps.peerDirectory === undefined)
38
96
  return undefined;
@@ -52,18 +110,30 @@ export function judgePeerLaneMount(deps, sessionId, sessions) {
52
110
  return { ok: true };
53
111
  }
54
112
  export function judgeSessionBoxDrain(deps, leg) {
55
- const mailbox = deps.mailboxStore;
56
- if (mailbox === undefined || leg.isDelegatedChild || leg.unread === true)
57
- return undefined;
58
- if (!sessionBoxMountVerdict(mailbox, leg.sessions).ok || !isPeerSessionId(leg.sessionId))
113
+ if (leg.isDelegatedChild || leg.unread === true)
59
114
  return undefined;
115
+ const verdict = sessionBoxVerdictOf(deps, leg);
116
+ return verdict.ok ? verdict.box : undefined;
117
+ }
118
+ export function sessionBoxVerdictOf(deps, at) {
119
+ const mailbox = deps.mailboxStore;
120
+ if (mailbox === undefined)
121
+ return { ok: false, cause: { code: "no_mailbox" } };
122
+ const store = sessionBoxMountVerdict(mailbox, at.sessions);
123
+ if (!store.ok)
124
+ return { ok: false, cause: { code: "mailbox_unsafe", reason: store.reason } };
125
+ if (!isPeerSessionId(at.sessionId))
126
+ return { ok: false, cause: { code: "ungrammatical" } };
60
127
  return {
61
- mailbox,
62
- scope: leg.scope,
63
- handle: peerSessionBoxHandle(leg.sessionId),
64
- sessionId: leg.sessionId,
65
- ...(deps.sessionBoxEngineFrames === true ? { engineFrames: true } : {}),
66
- onError: (e) => deps.onError?.(e, { phase: "degraded", sessionId: leg.sessionId, classification: "session-box-park" }),
128
+ ok: true,
129
+ box: {
130
+ mailbox,
131
+ scope: at.scope,
132
+ handle: peerSessionBoxHandle(at.sessionId),
133
+ sessionId: at.sessionId,
134
+ ...(deps.sessionBoxEngineFrames === true ? { engineFrames: true } : {}),
135
+ onError: (e) => deps.onError?.(e, { phase: "degraded", sessionId: at.sessionId, classification: "session-box-park" }),
136
+ },
67
137
  };
68
138
  }
69
139
  export const PEER_RESUPPLY_CAP = 1;
@@ -93,6 +163,8 @@ export function createPeerSessionDrain(opts) {
93
163
  const lanes = [...(opts.sessionBox === false ? [] : [mintLane("session", false)]), ...(opts.principalInbox !== undefined ? [mintLane("principal", opts.principalInbox === "pullOnly")] : [])];
94
164
  if (lanes.length === 0)
95
165
  throw new Error("createPeerSessionDrain: a drain that consumes no session box needs a principal-inbox lane (the binding judgment mints none here)");
166
+ if (opts.onLetters !== undefined && opts.principalInbox !== "pullOnly")
167
+ throw new Error("createPeerSessionDrain: a letter observer needs a pullOnly principal-inbox lane (a lane delivered at the turn boundaries would hand a letter to the model with no host step)");
96
168
  const principalLane = lanes.find((l) => l.kind === "principal");
97
169
  const seam = opts.settlement ?? createFrameSettlement();
98
170
  let inFlight = Promise.resolve();
@@ -164,7 +236,7 @@ export function createPeerSessionDrain(opts) {
164
236
  const from = lane.kind === "session" ? entry.peerMeta?.fromSession : undefined;
165
237
  return from === undefined ? undefined : { sessionId: from, occupant: entry.peerMeta?.fromOccupant };
166
238
  };
167
- const receipt = (lane) => async (entry, state) => {
239
+ const receipt = (lane) => async (entry, state, releasedBy) => {
168
240
  const to = receiptAddress(lane, entry);
169
241
  if (to === undefined)
170
242
  return;
@@ -179,7 +251,7 @@ export function createPeerSessionDrain(opts) {
179
251
  if (state === "dropped")
180
252
  await routePeerDroppedReceipt(via, to, entry.seq);
181
253
  else
182
- await routePeerDeliveryReceipt(via, to, state, entry.seq);
254
+ await routePeerDeliveryReceipt(via, to, state, entry.seq, releasedBy);
183
255
  if (faults.length > 0)
184
256
  throw faults[0];
185
257
  };
@@ -194,17 +266,29 @@ export function createPeerSessionDrain(opts) {
194
266
  judge: (entry) => judgeMeta(readFacts(), entry.peerMeta),
195
267
  ...(live
196
268
  ? {
197
- inject: (entry) => {
269
+ inject: async (entry) => {
198
270
  if (currentRound === undefined || !currentRound.holds(lane))
199
271
  return "deferred";
200
272
  const payload = buildPeerMessagePayload(lane, entry);
201
273
  if (currentRound.out !== undefined && opts.receive?.listens() === true) {
202
- currentRound.batch.push({ lane, payload, priority: "next", urgent: false, seq: entry.seq, attempt: 1 });
274
+ currentRound.batch.push({ lane, payload, priority: "next", urgent: false, seq: entry.seq, attempt: 1, source: entry });
203
275
  return undefined;
204
276
  }
277
+ if (currentRound.out === undefined && payload._sema_provenance?.peerMeta?.fromScope !== undefined && opts.markExternalContent !== undefined) {
278
+ const round = currentRound;
279
+ try {
280
+ await opts.markExternalContent(`a letter from another principal (cross-principal message seq ${entry.seq} in ${lane.boxHandle}) was delivered into this session`);
281
+ }
282
+ catch (e) {
283
+ opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-external-mark" });
284
+ return "deferred";
285
+ }
286
+ if (currentRound !== round || !round.holds(lane))
287
+ return "deferred";
288
+ }
205
289
  if (currentRound.deliver(payload, "next") === "deferred")
206
290
  return "deferred";
207
- noteDelivered(lane, entry.seq, 1, payload, currentRound.carrier);
291
+ noteDelivered(lane, entry.seq, 1, payload, entry, currentRound.carrier);
208
292
  return undefined;
209
293
  },
210
294
  canInject: () => currentRound !== undefined && currentRound.holds(lane) && !currentRound.spent,
@@ -212,7 +296,7 @@ export function createPeerSessionDrain(opts) {
212
296
  : {}),
213
297
  receipt: receipt(lane),
214
298
  tellsSender: (entry) => receiptAddress(lane, entry) !== undefined,
215
- decide: (entry, expect, next) => moveMailboxDecision(mailbox, scope, lane.boxHandle, entry.seq, expect, next),
299
+ decide: (entry, expect, next) => moveMailboxDecision(mailbox, scope, lane.boxHandle, entry.seq, expect, next, drainOwner),
216
300
  onFault: (entry, e) => opts.onError?.(e, { phase: "degraded", sessionId, classification: `peer-decision-move:${entry.box}#${entry.seq}` }),
217
301
  onHeld: (entry, count, cause, reannounce) => {
218
302
  if (!reannounce && lane.disclosedHeld.has(entry.seq))
@@ -352,21 +436,29 @@ export function createPeerSessionDrain(opts) {
352
436
  return true;
353
437
  return false;
354
438
  };
355
- const noteDelivered = (lane, seq, attempt, payload, carrier, shown = payload) => {
439
+ const noteDelivered = (lane, seq, attempt, payload, source, carrier, shown = payload) => {
356
440
  const own = taskNotificationDedupKey(payload);
357
441
  const key = carrier === undefined ? own : `${carrier}|${own}`;
358
442
  lane.ledger.set(seq, { kind: "delivered", attempt, key, payload });
359
443
  currentRound?.tally(lane, attempt);
360
- if (carrier === undefined && payload._sema_provenance?.peerMeta?.fromScope !== undefined) {
361
- try {
362
- opts.markExternalContent?.(`a letter from another principal (cross-principal message seq ${seq} in ${lane.boxHandle}) was delivered into this session`);
363
- }
364
- catch (e) {
365
- opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-external-mark" });
366
- }
367
- }
444
+ currentRound?.handOver(lane, seq, shown, source);
368
445
  seam.awaiting.set(key, carrier === undefined ? { carrier: own } : { carrier, frameText: renderTaskNotificationXml(shown) });
369
446
  };
447
+ const rollBackDelivery = (lane, seq, d) => {
448
+ if (d.attempt > 1)
449
+ lane.ledger.set(seq, { kind: "invalidated", attempt: d.attempt - 1, payload: d.payload });
450
+ else
451
+ lane.ledger.delete(seq);
452
+ };
453
+ const letterOf = (m) => ({
454
+ seq: m.seq,
455
+ fromScope: m.peerMeta.fromScope,
456
+ gateReceiptId: m.peerMeta.gateReceiptId,
457
+ sentAt: m.sentAt,
458
+ ...(m.from !== undefined ? { from: m.from } : {}),
459
+ ...(m.peerMeta.urgent === true ? { urgent: true } : {}),
460
+ content: m.content,
461
+ });
370
462
  const deriveAckPrefix = (lane, messages) => {
371
463
  let prefix;
372
464
  for (const m of messages) {
@@ -402,10 +494,7 @@ export function createPeerSessionDrain(opts) {
402
494
  continue;
403
495
  }
404
496
  if (seam.withheld.delete(d.key)) {
405
- if (d.attempt > 1)
406
- ledger.set(seq, { kind: "invalidated", attempt: d.attempt - 1, payload: d.payload });
407
- else
408
- ledger.delete(seq);
497
+ rollBackDelivery(lane, seq, d);
409
498
  continue;
410
499
  }
411
500
  const entryId = seam.receipts.get(d.key);
@@ -489,7 +578,7 @@ export function createPeerSessionDrain(opts) {
489
578
  disclose(lane, "notice_user_only", `${judged.cause}: ${text}`, m);
490
579
  }
491
580
  else {
492
- currentRound.batch.push({ lane, payload: buildNoticePayload(lane, m, kind, text), priority: "next", urgent: false, seq: m.seq, attempt: 1 });
581
+ currentRound.batch.push({ lane, payload: buildNoticePayload(lane, m, kind, text), priority: "next", urgent: false, seq: m.seq, attempt: 1, source: m });
493
582
  return;
494
583
  }
495
584
  currentRound.dispose(lane, m.seq, judged.verdict === "refuse" ? "refused" : "notice_user_only");
@@ -554,6 +643,12 @@ export function createPeerSessionDrain(opts) {
554
643
  lane.ledger.set(seq, { kind: "terminal", why });
555
644
  }
556
645
  batch = [];
646
+ handedOver = [];
647
+ handOver(lane, seq, shown, source) {
648
+ if (this.out !== undefined && lane.kind === "principal" && opts.onLetters !== undefined)
649
+ this.handedOver.push({ lane, seq, shown, letter: letterOf(source) });
650
+ }
651
+ waiting = () => ({ pending: 0, urgent: 0 });
557
652
  leasedLanes = new Set();
558
653
  lease(lanes) {
559
654
  this.leasedLanes = new Set(lanes);
@@ -613,6 +708,7 @@ export function createPeerSessionDrain(opts) {
613
708
  const c = countWaiting(lane, lease);
614
709
  return { pending: sum.pending + c.pending, urgent: sum.urgent + c.urgent };
615
710
  }, { pending: 0, urgent: 0 });
711
+ round.waiting = waitingAcross;
616
712
  if (pass.settle)
617
713
  settleLocally();
618
714
  if (pass.settle)
@@ -655,7 +751,7 @@ export function createPeerSessionDrain(opts) {
655
751
  if (round.spent)
656
752
  break;
657
753
  const attempt = prior.attempt + 1;
658
- round.batch.push({ lane, payload: { ...prior.payload, attempt, resupplied: true }, priority: "next", urgent: false, seq: m.seq, attempt });
754
+ round.batch.push({ lane, payload: { ...prior.payload, attempt, resupplied: true }, priority: "next", urgent: false, seq: m.seq, attempt, source: m });
659
755
  }
660
756
  for (const m of lease.messages) {
661
757
  if (ackedUpTo !== undefined && m.seq <= ackedUpTo)
@@ -704,7 +800,7 @@ export function createPeerSessionDrain(opts) {
704
800
  round.dispose(lane, m.seq, `engine_frame_malformed:${decoded.detail}`);
705
801
  continue;
706
802
  }
707
- round.batch.push({ lane, payload: decoded.payload, priority: decoded.priority, urgent: false, seq: m.seq, attempt: 1 });
803
+ round.batch.push({ lane, payload: decoded.payload, priority: decoded.priority, urgent: false, seq: m.seq, attempt: 1, source: m });
708
804
  continue;
709
805
  }
710
806
  const sameTree = meta?.fromRoot !== undefined && meta.fromRoot.toLowerCase() === sessionId.toLowerCase();
@@ -745,7 +841,7 @@ export function createPeerSessionDrain(opts) {
745
841
  round.dispose(lane, m.seq, "uncanonical_fields");
746
842
  continue;
747
843
  }
748
- round.batch.push({ lane, payload, priority: "next", urgent: meta?.urgent === true, seq: m.seq, attempt: 1 });
844
+ round.batch.push({ lane, payload, priority: "next", urgent: meta?.urgent === true, seq: m.seq, attempt: 1, source: m });
749
845
  }
750
846
  if (adoptedThisPass)
751
847
  await held.rejudge();
@@ -765,6 +861,15 @@ export function createPeerSessionDrain(opts) {
765
861
  }
766
862
  shown = verdict.payload;
767
863
  }
864
+ if (round.out === undefined && !round.spent && item.payload._sema_provenance?.peerMeta?.fromScope !== undefined && opts.markExternalContent !== undefined) {
865
+ try {
866
+ await opts.markExternalContent(`a letter from another principal (cross-principal message seq ${item.seq} in ${item.lane.boxHandle}) was delivered into this session`);
867
+ }
868
+ catch (e) {
869
+ opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-external-mark" });
870
+ break;
871
+ }
872
+ }
768
873
  try {
769
874
  if (round.deliver(shown, item.priority) === "deferred")
770
875
  continue;
@@ -773,7 +878,7 @@ export function createPeerSessionDrain(opts) {
773
878
  opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-box-inject" });
774
879
  break;
775
880
  }
776
- noteDelivered(item.lane, item.seq, item.attempt, item.payload, round.carrier, shown);
881
+ noteDelivered(item.lane, item.seq, item.attempt, item.payload, item.source, round.carrier, shown);
777
882
  }
778
883
  }
779
884
  for (const { lane, lease } of leased) {
@@ -813,16 +918,65 @@ export function createPeerSessionDrain(opts) {
813
918
  };
814
919
  const drain = () => serialize(boundPass({ settle: true, deliver: true }));
815
920
  const boundaryRound = (o) => serialize(boundPass({ settle: true, deliver: o.continues }));
816
- const pull = (limit, toolCallId, charBudget) => {
921
+ const hostTakes = async (page, signal) => {
922
+ const notTaken = (why, cause) => {
923
+ opts.onError?.(new Error(`the host's letter observer did not take ${page.length} principal-inbox letter(s) (seq ${page.map((l) => l.seq).join(", ")}): ${why} — they are withdrawn from this ReadInbox result and stay in ${PRINCIPAL_INBOX_HANDLE}, handed over again by a later pull`, cause !== undefined ? { cause } : undefined), { phase: "degraded", sessionId, classification: "peer-inbox-host-observer" });
924
+ return false;
925
+ };
926
+ if (signal.aborted)
927
+ return notTaken("the call was aborted before the page was ready");
928
+ let stopListening = () => undefined;
929
+ const aborted = new Promise((resolve) => {
930
+ const onAbort = () => resolve({ kind: "aborted" });
931
+ signal.addEventListener("abort", onAbort, { once: true });
932
+ stopListening = () => signal.removeEventListener("abort", onAbort);
933
+ });
934
+ try {
935
+ let answer;
936
+ try {
937
+ answer = Promise.resolve(opts.onLetters(page, { signal }));
938
+ }
939
+ catch (e) {
940
+ return notTaken("it threw", e);
941
+ }
942
+ const outcome = await Promise.race([answer.then(() => ({ kind: "taken" }), (e) => ({ kind: "rejected", e })), aborted]);
943
+ if (outcome.kind === "taken")
944
+ return true;
945
+ return outcome.kind === "aborted" ? notTaken("the call was aborted while it was pending") : notTaken("it rejected", outcome.e);
946
+ }
947
+ finally {
948
+ stopListening();
949
+ }
950
+ };
951
+ const withdraw = (round, out) => {
952
+ for (const { lane, seq, shown } of round.handedOver) {
953
+ const at = out.indexOf(shown);
954
+ if (at >= 0)
955
+ out.splice(at, 1);
956
+ const d = lane.ledger.get(seq);
957
+ if (d?.kind !== "delivered")
958
+ continue;
959
+ seam.awaiting.delete(d.key);
960
+ rollBackDelivery(lane, seq, d);
961
+ }
962
+ };
963
+ const pull = (limit, toolCallId, charBudget, signal = new AbortController().signal) => {
817
964
  const out = [];
818
965
  const bound = limit !== undefined && Number.isInteger(limit) && limit > 0 ? limit : resolvePeerLaneConfig(opts.lane, opts.onNotice).maxMessagesPerRound;
819
966
  let counts = { pending: 0, urgent: 0 };
967
+ let notTaken = 0;
820
968
  const once = async () => {
821
- counts = await drainRound(new DrainRound(bound, out, toolCallId !== undefined ? toolResultReceiptKey(toolCallId) : undefined, charBudget), { settle: false, deliver: true });
969
+ const round = new DrainRound(bound, out, toolCallId !== undefined ? toolResultReceiptKey(toolCallId) : undefined, charBudget);
970
+ counts = await drainRound(round, { settle: false, deliver: true });
971
+ if (round.handedOver.length === 0 || (await hostTakes(round.handedOver.map((h) => h.letter), signal)))
972
+ return;
973
+ withdraw(round, out);
974
+ notTaken = round.handedOver.length;
975
+ counts = round.waiting();
822
976
  };
823
977
  const settled = inFlight.then(once, once);
824
978
  inFlight = settled;
825
- return settled.then(() => ({ delivered: out, pending: counts.pending, urgent: counts.urgent }));
979
+ return settled.then(() => ({ delivered: out, pending: counts.pending, urgent: counts.urgent, ...(notTaken > 0 ? { notTaken } : {}) }));
826
980
  };
827
981
  const finishOnce = async () => {
828
982
  const claimed = [];
@@ -967,6 +1121,8 @@ export function bindPeerSessionDrain(harness, opts) {
967
1121
  export function bindPeerLaneDrain(harness, args) {
968
1122
  const { deps } = args;
969
1123
  const { sessionId, occupant } = args.address;
1124
+ const answering = args.lanes.principalInbox === "pullOnly" ? seatAnsweringFor(args.assistantSeat, sessionId) : undefined;
1125
+ const observe = answering?.onLetters;
970
1126
  let rowName;
971
1127
  const lookupRowName = async () => {
972
1128
  if (deps.peerDirectory === undefined)
@@ -1001,10 +1157,11 @@ export function bindPeerLaneDrain(harness, args) {
1001
1157
  ...(args.parked !== undefined ? { parked: args.parked } : {}),
1002
1158
  ...(args.lastTurnText !== undefined ? { lastTurnText: args.lastTurnText } : {}),
1003
1159
  ...(args.markExternalContent !== undefined ? { markExternalContent: args.markExternalContent } : {}),
1160
+ ...(observe !== undefined && answering !== undefined ? { onLetters: (letters, ctx) => observe.call(answering.seat, letters, ctx) } : {}),
1004
1161
  ...(deps.onNotice !== undefined ? { onNotice: deps.onNotice } : {}),
1005
1162
  ...(deps.onError !== undefined ? { onError: deps.onError } : {}),
1006
1163
  });
1007
- args.refs.pull = (limit, toolCallId, charBudget) => drain.pull(limit, toolCallId, charBudget);
1164
+ args.refs.pull = (limit, toolCallId, charBudget, signal) => drain.pull(limit, toolCallId, charBudget, signal);
1008
1165
  args.refs.boundaryRound = (o) => drain.boundaryRound(o);
1009
1166
  args.refs.isBoxBacked = (payload) => drain.isBoxBacked(payload);
1010
1167
  if (args.settlement !== undefined)
@@ -14,8 +14,9 @@ export declare const READ_INBOX_MAX_LIMIT = 50;
14
14
  */
15
15
  export declare const READ_INBOX_RESULT_BUDGET_CHARS = 20000;
16
16
  export interface ReadInboxToolOptions {
17
- /** The bound drain's pull face, read LATE (the drain binds after the roster is minted). Absent ⇒ no box. */
18
- pull: () => ((limit?: number, toolCallId?: string, charBudget?: number) => Promise<PulledInbox>) | undefined;
17
+ /** The bound drain's pull face, read LATE (the drain binds after the roster is minted). Absent ⇒ no box. `signal` = this call's
18
+ * abort, which the host's letter observer races. */
19
+ pull: () => ((limit?: number, toolCallId?: string, charBudget?: number, signal?: AbortSignal) => Promise<PulledInbox>) | undefined;
19
20
  /**
20
21
  * The drain this face pulls from also covers the scope's PRINCIPAL INBOX, so a result
21
22
  * can carry another principal's words: the tool then declares `contentOrigin: "external"`, and the
@@ -3,7 +3,6 @@ import { defineTool } from "../core/tools.js";
3
3
  import { renderTaskNotificationXml } from "../core/task-notification.js";
4
4
  import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
5
5
  import { describeRejectedValue } from "../core/tool-search-setting.js";
6
- import { inlineUntrusted } from "../core/untrusted-text.js";
7
6
  import { consumerRefusal } from "./org-delivery-gate.js";
8
7
  export const READ_INBOX_TOOL_NAME = "ReadInbox";
9
8
  export const READ_INBOX_MAX_LIMIT = 50;
@@ -11,7 +10,7 @@ export const READ_INBOX_RESULT_BUDGET_CHARS = 20_000;
11
10
  export function createReadInboxTool(opts) {
12
11
  const raw = opts.coversPrincipalInbox;
13
12
  if (raw !== undefined && raw !== false && raw !== true && raw !== "pullOnly") {
14
- throw consumerRefusal(`ReadInboxToolOptions.coversPrincipalInbox must be absent, false, true or "pullOnly" (got ${typeof raw === "string" ? JSON.stringify(inlineUntrusted(raw, 96)) : describeRejectedValue(raw)}) — ` +
13
+ throw consumerRefusal(`ReadInboxToolOptions.coversPrincipalInbox must be absent, false, true or "pullOnly" (got ${describeRejectedValue(raw)}) — ` +
15
14
  `it states which principal-inbox lane the leg's drain binds (the Runner's binding judgment sets it), and a value outside that set would mount the face as one that covers no principal inbox`, "malformed");
16
15
  }
17
16
  const covers = raw === true || raw === "pullOnly";
@@ -43,15 +42,18 @@ export function createReadInboxTool(opts) {
43
42
  }
44
43
  const raw = args.limit;
45
44
  const limit = typeof raw === "number" && Number.isInteger(raw) && raw >= 1 ? Math.min(raw, READ_INBOX_MAX_LIMIT) : undefined;
46
- const pulled = await pull(limit, ctx.toolCallId, READ_INBOX_RESULT_BUDGET_CHARS);
45
+ const pulled = await pull(limit, ctx.toolCallId, READ_INBOX_RESULT_BUDGET_CHARS, ctx.signal);
47
46
  const frames = pulled.delivered;
47
+ const notTaken = pulled.notTaken ?? 0;
48
+ const hostLine = notTaken > 0 ? `\n\n[${notTaken} letter(s) in your principal inbox were not taken by the host, so they are not shown here; they are still in the inbox, and a later ReadInbox call hands them over.]` : "";
48
49
  const trailer = pulled.pending > 0
49
50
  ? `\n\n[${pulled.pending} more message(s) still waiting${pulled.urgent > 0 ? `; ${pulled.urgent} marked urgent` : ""} — call ReadInbox again${pullOnly ? " (letters in your principal inbox are read only here: none of them arrives at a turn boundary)" : ", or they arrive at your next turn boundaries"}.]`
50
51
  : frames.length > 0
51
52
  ? "\n\n[The inbox is empty now.]"
52
53
  : "";
53
- const content = frames.length > 0 ? `${frames.map((f) => renderTaskNotificationXml(f)).join("\n\n")}${trailer}` : `No unread cross-session messages.${trailer}`;
54
- return { content, details: { type: "read-inbox", delivered: frames.length, pending: pulled.pending, urgent: pulled.urgent, seqs: frames.map((f) => f.seq ?? null) } };
54
+ const head = frames.length > 0 ? frames.map((f) => renderTaskNotificationXml(f)).join("\n\n") : notTaken > 0 ? "No message is shown by this call." : "No unread cross-session messages.";
55
+ const content = `${head}${hostLine}${trailer}`;
56
+ return { content, details: { type: "read-inbox", delivered: frames.length, pending: pulled.pending, urgent: pulled.urgent, seqs: frames.map((f) => f.seq ?? null), ...(notTaken > 0 ? { notTaken } : {}) } };
55
57
  },
56
58
  });
57
59
  }
@@ -2,8 +2,10 @@ import { isDurablePause, pauseFamily } from "./suspend-guard.js";
2
2
  import { delimitUntrusted, sanitizeUntrustedText } from "../core/untrusted-text.js";
3
3
  import { recipeContinuationLeg } from "../core/input-author.js";
4
4
  import { assertOracleIsolation } from "../core/oracle-isolation.js";
5
- import { buildCumulativeStats } from "./cumulative-stats.js";
5
+ import { buildCumulativeStats, emptyCumulativeUsageFacts, foldUsageFacts } from "./cumulative-stats.js";
6
+ import { foldIntake, withIntake } from "../core/task-intake.js";
6
7
  import { laterLegAllowance } from "./composition-allowance.js";
8
+ import { withOpeningObjective, withoutSessionBinding } from "../core/task-spec-members.js";
7
9
  export function isolationPermitsAutoAccept(verdict) {
8
10
  return verdict.protected && verdict.isolationClass === "out_of_process";
9
11
  }
@@ -51,6 +53,7 @@ export async function runRepairLoop(runner, implSpec, config) {
51
53
  return {
52
54
  taskId: implSpec.taskId ?? "",
53
55
  result: `oracle isolation check failed: ${reason}`, resultEntryIds: [],
56
+ intake: { committed: false },
54
57
  terminal: { kind: "failed", code: "oracle.unprotected", message: `oracle isolation check failed: ${reason}` },
55
58
  sessionId: "",
56
59
  stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
@@ -97,14 +100,16 @@ export async function runRepairLoop(runner, implSpec, config) {
97
100
  bundle.activeElapsedMs = priorActiveMs + (Date.now() - startedAt);
98
101
  };
99
102
  let lastResult;
103
+ const attemptIntakes = [];
100
104
  let lastOracle;
101
105
  let ownTokens = 0, ownTurns = 0, ownPrompt = 0, ownTotalInput = 0, ownCached = 0, ownOutput = 0;
102
106
  let ownCacheWrite = 0, ownCacheWriteLong = 0, ownCostMicro = 0;
107
+ const ownUsageFacts = emptyCumulativeUsageFacts();
103
108
  let ownLlmRootMicro = 0, ownCompactionMicro = 0;
104
109
  let ownSideCallMicro;
105
110
  let anyAttemptUnpriced = false;
106
111
  let nestedTokens = 0, nestedTurns = 0, nestedTasks = 0, nestedCostMicro = 0;
107
- let hrCount = 0, hrWaitMs = 0;
112
+ let hrKept = false, hrCount = 0, hrWaitMs = 0;
108
113
  const hrGates = [];
109
114
  let oracleCostMicroUsd = 0;
110
115
  const accumulate = (s) => {
@@ -116,6 +121,7 @@ export async function runRepairLoop(runner, implSpec, config) {
116
121
  ownOutput += s.outputTokens ?? 0;
117
122
  ownCacheWrite += s.cacheWriteTokens ?? 0;
118
123
  ownCacheWriteLong += s.cacheWriteTokensLong ?? 0;
124
+ foldUsageFacts(ownUsageFacts, s);
119
125
  ownCostMicro += s.costMicroUsd ?? 0;
120
126
  if (s.costMicroUsd === undefined)
121
127
  anyAttemptUnpriced = true;
@@ -126,6 +132,7 @@ export async function runRepairLoop(runner, implSpec, config) {
126
132
  ownSideCallMicro = (ownSideCallMicro ?? 0) + s.costBreakdown.sideCallMicroUsd;
127
133
  }
128
134
  if (s.humanReview) {
135
+ hrKept = true;
129
136
  hrCount += s.humanReview.count;
130
137
  hrWaitMs += s.humanReview.totalWaitMs;
131
138
  hrGates.push(...s.humanReview.gates);
@@ -152,20 +159,19 @@ export async function runRepairLoop(runner, implSpec, config) {
152
159
  compactionMicroUsd: ownCompactionMicro,
153
160
  ...(ownSideCallMicro !== undefined ? { sideCallMicroUsd: ownSideCallMicro } : {}),
154
161
  nested: { tokens: nestedTokens, turns: nestedTurns, tasks: nestedTasks, costMicroUsd: nestedCostMicro },
155
- humanReview: { count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
162
+ humanReview: { kept: hrKept, count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
163
+ usageFacts: ownUsageFacts,
156
164
  });
157
165
  let restartedOnce = false;
158
166
  let restartUsed = false;
159
167
  let firstAttempt = true;
160
168
  let laterAttemptSpec = implSpec;
161
169
  const ownSpend = () => ({ costMicroUsd: anyAttemptUnpriced ? undefined : ownCostMicro, tokens: ownTokens, turns: ownTurns });
162
- const cleanRestartSpec = () => {
163
- const { sessionId: _drop, ...rest } = laterAttemptSpec;
164
- return { ...rest, objective: `${implSpec.objective}\n\n${repairObjective(bundle)}` };
165
- };
170
+ const cleanRestartSpec = () => ({ ...withoutSessionBinding(laterAttemptSpec), objective: `${implSpec.objective}\n\n${repairObjective(bundle)}` });
166
171
  const exhaustedBeforeDispatch = (message, errorCode) => ({
167
172
  taskId: implSpec.taskId ?? "",
168
173
  result: message ?? `repair loop: attempt budget already spent (attemptCount ${bundle.attemptCount} >= maxAttempts ${maxAttempts}) — no attempt dispatched`, resultEntryIds: [],
174
+ intake: { committed: false },
169
175
  terminal: { kind: "failed", code: errorCode ?? "repair.attempts_exhausted", message: message ?? `repair loop: attempt budget already spent (attemptCount ${bundle.attemptCount} >= maxAttempts ${maxAttempts}) — no attempt dispatched` },
170
176
  sessionId: implSpec.sessionId ?? "",
171
177
  stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
@@ -193,12 +199,9 @@ export async function runRepairLoop(runner, implSpec, config) {
193
199
  const spec = restartedOnce
194
200
  ? cleanRestartSpec()
195
201
  : isRepair
196
- ? { ...laterAttemptSpec, sessionId: lastResult.sessionId, objective: repairObjective(bundle) }
202
+ ? withOpeningObjective({ ...laterAttemptSpec, sessionId: lastResult.sessionId }, repairObjective(bundle))
197
203
  : isSeededResume
198
- ? {
199
- ...implSpec,
200
- objective: implSpec.sessionId ? repairObjective(bundle) : `${implSpec.objective}\n\n${repairObjective(bundle)}`,
201
- }
204
+ ? withOpeningObjective(implSpec, implSpec.sessionId ? repairObjective(bundle) : `${implSpec.objective}\n\n${repairObjective(bundle)}`)
202
205
  : implSpec;
203
206
  restartedOnce = false;
204
207
  const liveStamp = setInterval(stampAccount, 1_000);
@@ -215,10 +218,11 @@ export async function runRepairLoop(runner, implSpec, config) {
215
218
  stampAccount();
216
219
  accumulate(result.stats);
217
220
  lastResult = result;
221
+ attemptIntakes.push(result.intake);
218
222
  bundle.attemptCount += 1;
219
223
  if (isDurablePause(result.terminal)) {
220
224
  return {
221
- ...result,
225
+ ...withIntake(result, foldIntake(attemptIntakes)),
222
226
  stats: cumulativeStats(result.stats),
223
227
  repairTerminal: "gave_up",
224
228
  bundle,
@@ -229,7 +233,7 @@ export async function runRepairLoop(runner, implSpec, config) {
229
233
  }
230
234
  if (result.terminal.kind !== "completed") {
231
235
  return {
232
- ...result,
236
+ ...withIntake(result, foldIntake(attemptIntakes)),
233
237
  stats: cumulativeStats(result.stats),
234
238
  repairTerminal: "gave_up",
235
239
  bundle,
@@ -248,7 +252,7 @@ export async function runRepairLoop(runner, implSpec, config) {
248
252
  config.onAttempt?.({ attempt: bundle.attemptCount, repairTerminal: projected, oracle });
249
253
  if (projected !== undefined) {
250
254
  return {
251
- ...result,
255
+ ...withIntake(result, foldIntake(attemptIntakes)),
252
256
  stats: cumulativeStats(result.stats),
253
257
  repairTerminal: projected,
254
258
  bundle,
@@ -276,7 +280,7 @@ export async function runRepairLoop(runner, implSpec, config) {
276
280
  }
277
281
  const terminal = "gave_up";
278
282
  return {
279
- ...lastResult,
283
+ ...withIntake(lastResult, foldIntake(attemptIntakes)),
280
284
  stats: cumulativeStats(lastResult.stats),
281
285
  repairTerminal: terminal,
282
286
  bundle,
@@ -76,7 +76,7 @@ export interface SubagentRetainEntry {
76
76
  };
77
77
  /** The in-flight resume run's abort controller (parent-terminal cleanup aborts it — r1-M2). */
78
78
  activeAbort?: AbortController;
79
- /** Unpin + explicitly release the retained session (best-effort: a release that rejects leaves the session standing and nothing retries it — a detached eviction's rejection reaches `RetainLedgerHooks.onEvictionError`; a damaged placed row needs manual cleanup, see TtlSessionStore.release). */
79
+ /** Unpin + explicitly release the retained session (best-effort: a release that rejects leaves the session standing and nothing retries it — a detached eviction's rejection reaches `RetainLedgerHooks.onEvictionError`; a damaged placed row is the operator's, see SessionStore.deleteUnreadable). */
80
80
  release: () => Promise<void>;
81
81
  }
82
82
  /**
@@ -2,15 +2,13 @@ import { delimitUntrusted } from "../core/untrusted-text.js";
2
2
  import { PEER_MESSAGE_NOTICE } from "./peer-admission.js";
3
3
  import { createSafeNotifier } from "../core/safe-notify.js";
4
4
  import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../config/defaults.js";
5
- import { asThrownError } from "../core/thrown-value.js";
5
+ import { asThrownError, codedRefusal } from "../core/thrown-value.js";
6
6
  import { optionKeys, receiveMembers } from "../core/own-property-receipt.js";
7
7
  const RETAIN_CONFIG_KEYS = optionKeys()({ ttlMs: 0, max: 0 });
8
8
  export const SUBAGENT_RESUME_CAP = 8;
9
9
  export function holdChildDeclarations(runner, declared) {
10
10
  if (typeof runner.holdDeclarations !== "function") {
11
- throw Object.assign(new Error("the runner seat this tool runs children on has no `holdDeclarations` function — a seat built by hand forwards `holdDeclarations(declared)` to the Runner it stands for, or the Runner itself is handed in"), {
12
- code: "config.invalid_argument",
13
- });
11
+ throw codedRefusal("config.invalid_argument", "the runner seat this tool runs children on has no `holdDeclarations` function — a seat built by hand forwards `holdDeclarations(declared)` to the Runner it stands for, or the Runner itself is handed in");
14
12
  }
15
13
  return runner.holdDeclarations(declared);
16
14
  }