@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -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 +169 -0
  71. package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
  362. package/dist/core/roles.js +148 -21
  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 +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
  730. package/dist/index.js +45 -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 +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -3,6 +3,7 @@ import { isWithin } from "./session-rule-policy.js";
3
3
  import { isWinFormPath, normalizeAbsPathLexically } from "../../tools/fs/safety.js";
4
4
  import { validatePath } from "../effective-path-target.js";
5
5
  import { inlineUntrusted } from "../untrusted-text.js";
6
+ import { envErrorDetail } from "../../tools/fs/env-error-detail.js";
6
7
  export const PLAN_FILE_INVALID_CODE = "config.plan_file_invalid";
7
8
  export function planFileInvalid(value, why) {
8
9
  let shown;
@@ -105,19 +106,19 @@ export class AdvertisedWritableDirs {
105
106
  if (leaf.ok && leaf.value.kind !== "file")
106
107
  throw planFileInvalid(spelled, leaf.value.kind === "symlink" ? "is a symbolic link (the plan file must be the file itself, not a link to one)" : `is a ${leaf.value.kind}, not a file`);
107
108
  if (!leaf.ok && leaf.error.code !== "not_found")
108
- throw planFileInvalid(spelled, `could not be examined (${leaf.error.code}: ${leaf.error.message})`);
109
+ throw planFileInvalid(spelled, `could not be examined (${leaf.error.code}: ${envErrorDetail(leaf.error.message)})`);
109
110
  const parentCanonical = await this.env.canonicalPath(parent);
110
111
  if (!parentCanonical.ok)
111
- throw planFileInvalid(spelled, `has a directory that does not resolve (${parentCanonical.error.code}: ${parentCanonical.error.message}) — the host creates the plan file's directory before the run`);
112
+ throw planFileInvalid(spelled, `has a directory that does not resolve (${parentCanonical.error.code}: ${envErrorDetail(parentCanonical.error.message)}) — the host creates the plan file's directory before the run`);
112
113
  const parentInfo = await this.env.fileInfo(parentCanonical.value);
113
114
  if (!parentInfo.ok || parentInfo.value.kind !== "directory")
114
115
  throw planFileInvalid(spelled, `has a parent ${parentCanonical.value} that is not a directory`);
115
116
  const own = leaf.ok ? await this.env.canonicalPath(spelled) : undefined;
116
117
  if (own !== undefined && !own.ok)
117
- throw planFileInvalid(spelled, `could not be resolved (${own.error.code}: ${own.error.message})`);
118
+ throw planFileInvalid(spelled, `could not be resolved (${own.error.code}: ${envErrorDetail(own.error.message)})`);
118
119
  const joined = own?.ok === true ? own : await this.env.joinPath([parentCanonical.value, name]);
119
120
  if (!joined.ok)
120
- throw planFileInvalid(spelled, `could not be joined below its directory (${joined.error.code}: ${joined.error.message})`);
121
+ throw planFileInvalid(spelled, `could not be joined below its directory (${joined.error.code}: ${envErrorDetail(joined.error.message)})`);
121
122
  const key = joined.value;
122
123
  await this.resolveDeclaredRoots();
123
124
  const swallowed = swallowedFenceRoot(key, [...this.fenceRoots, ...this.admitted]);
@@ -135,20 +136,20 @@ export class AdvertisedWritableDirs {
135
136
  return { ok: false, reason: "this run admitted no plan file" };
136
137
  const canonical = await this.env.canonicalPath(planFile.key, signal);
137
138
  if (!canonical.ok)
138
- return canonical.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${canonical.error.code}: ${canonical.error.message}` };
139
+ return canonical.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${canonical.error.code}: ${envErrorDetail(canonical.error.message)}` };
139
140
  if (canonical.value !== planFile.key)
140
141
  return { ok: false, reason: `it now resolves to ${canonical.value} (a link replaced it or one of its directories), which is not read through` };
141
142
  let bytes;
142
143
  if (this.env.openBound !== undefined) {
143
144
  const held = await this.env.openBound(planFile.key, signal);
144
145
  if (!held.ok)
145
- return held.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${held.error.code}: ${held.error.message}` };
146
+ return held.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${held.error.code}: ${envErrorDetail(held.error.message)}` };
146
147
  try {
147
148
  if (held.value.kind !== "file")
148
149
  return { ok: false, reason: `it is now a ${held.value.kind}` };
149
150
  const read = await held.value.readBytes(PLAN_FILE_MAX_BYTES, signal);
150
151
  if (!read.ok)
151
- return { ok: false, reason: `${read.error.code}: ${read.error.message}` };
152
+ return { ok: false, reason: `${read.error.code}: ${envErrorDetail(read.error.message)}` };
152
153
  bytes = read.value;
153
154
  }
154
155
  finally {
@@ -158,14 +159,14 @@ export class AdvertisedWritableDirs {
158
159
  else {
159
160
  const leaf = await this.env.fileInfo(planFile.key, signal);
160
161
  if (!leaf.ok)
161
- return leaf.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${leaf.error.code}: ${leaf.error.message}` };
162
+ return leaf.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${leaf.error.code}: ${envErrorDetail(leaf.error.message)}` };
162
163
  if (leaf.value.kind !== "file")
163
164
  return { ok: false, reason: leaf.value.kind === "symlink" ? "it is now a symbolic link, which is not read through" : `it is now a ${leaf.value.kind}` };
164
165
  if (leaf.value.size > PLAN_FILE_MAX_BYTES)
165
166
  return { ok: false, reason: `it is ${leaf.value.size} bytes, over the ${PLAN_FILE_MAX_BYTES} a plan is read up to` };
166
167
  const read = await this.env.readBinaryFile(planFile.key, signal);
167
168
  if (!read.ok)
168
- return read.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${read.error.code}: ${read.error.message}` };
169
+ return read.error.code === "not_found" ? { ok: true, text: undefined } : { ok: false, reason: `${read.error.code}: ${envErrorDetail(read.error.message)}` };
169
170
  const after = await this.env.canonicalPath(planFile.key, signal);
170
171
  const afterLeaf = await this.env.fileInfo(planFile.key, signal);
171
172
  if (!after.ok || after.value !== planFile.key || !afterLeaf.ok || afterLeaf.value.kind !== "file")
@@ -4,10 +4,9 @@
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, RowAdmission } from "../../internal/harness.js";
8
- import type { PostureFrameRef } from "../auto-mode-directive.js";
9
- import type { StoredSession } from "../session.js";
10
- import type { FrameReceiptLedger } from "./contracts.js";
7
+ import type { AnnouncedAdvisorState, AnnouncedListingSnapshotInput } from "../../internal/harness.js";
8
+ import { type ToldSeat } from "./conversation-segment.js";
9
+ import type { FrameReceiptLedger, Prepared } from "./contracts.js";
11
10
  export declare const ADVISOR_TOOL_INSTRUCTIONS = "# Advisor Tool\n\nYou have access to an `advisor` tool backed by a stronger reviewer model. It takes NO parameters -- when you call advisor(), your entire conversation history is automatically forwarded. They see the task, every tool call you've made, every result you've seen.\n\nCall advisor BEFORE substantive work -- before writing, before committing to an interpretation, before building on an assumption. If the task requires orientation first (finding files, fetching a source, seeing what's there), do that, then call advisor. Orientation is not substantive work. Writing, editing, and declaring an answer are.\n\nAlso call advisor:\n- When you believe the task is complete. BEFORE this call, make your deliverable durable: write the file, save the result, commit the change. The advisor call takes time; if the session ends during it, a durable result persists and an unwritten one doesn't.\n- When stuck -- errors recurring, approach not converging, results that don't fit.\n- When considering a change of approach.\n\nOn tasks longer than a few steps, call advisor at least once before committing to an approach and once before declaring done. On short reactive tasks where the next action is dictated by tool output you just read, you don't need to keep calling -- the advisor adds most of its value on the first call, before the approach crystallizes.\n\nGive the advice serious weight. If you follow a step and it fails empirically, or you have primary-source evidence that contradicts a specific claim (the file says X, the paper states Y), adapt. A passing self-test is not evidence the advice is wrong -- it's evidence your test doesn't check what the advice is checking.\n\nIf you've already retrieved data pointing one way and the advisor points another: don't silently switch. Surface the conflict in one more advisor call -- \"I found X, you suggest Y, which constraint breaks the tie?\" The advisor saw your evidence but may have underweighted it; a reconcile call is cheaper than committing to the wrong branch.";
12
11
  export declare const ADVISOR_TOOL_ABBREVIATED = "The advisor tool is available; the advisor instructions announced earlier apply.";
13
12
  export declare const ADVISOR_TOOL_REMOVED = "The advisor tool is no longer available; disregard the earlier advisor instructions.";
@@ -16,19 +15,14 @@ export type AdvisorInstructionState = AnnouncedAdvisorState["state"];
16
15
  /**
17
16
  * The advisor instructions a leg owes, from what the model was told and whether the tool is mounted now: nothing told and
18
17
  * mounted ⇒ the full text; told and not mounted ⇒ the withdrawal; withdrawn and mounted again ⇒ the short re-attach; every
19
- * other pair owes nothing. `state` is what the model has been told once the frame is delivered.
18
+ * other pair owes nothing. `value` is what the model has been told once the frame is delivered.
20
19
  */
21
20
  export declare function advisorInstructionFrame(told: AdvisorInstructionState | undefined, mounted: boolean): {
22
21
  body: string;
23
- state: AdvisorInstructionState;
22
+ value: AdvisorInstructionState;
24
23
  } | undefined;
25
- /** A leg's advisor-instructions seat: the frame its first request owes, the segment that was judged in, whether the tool is mounted. */
26
- export interface AdvisorInstructionSeat {
27
- owed?: {
28
- readonly body: string;
29
- readonly state: AdvisorInstructionState;
30
- };
31
- readonly segment: string | null;
24
+ /** A leg's advisor-instructions seat: the told seat (the frame its first request owes, the segment that was judged in) and whether the tool is mounted. */
25
+ export interface AdvisorInstructionSeat extends ToldSeat<AdvisorInstructionState> {
32
26
  readonly mounted: boolean;
33
27
  }
34
28
  /** The owed frame as one engine-marked reminder — what a fresh leg's first message and a resumed leg's continuation both
@@ -54,18 +48,8 @@ export declare function settleAdvisorInstruction(prepared: {
54
48
  };
55
49
  }): void;
56
50
  /**
57
- * A compaction landed on a leg that mounts the advisor: the full instructions it summarized away are appended to the
58
- * transcript as one engine-minted message, before any reader of the new baseline — the posture's compaction rule, halt
59
- * included (no engine message enters the transcript ahead of a person's next words). The record is left as it was: it names
60
- * the segment before this compaction, so the next leg tells the model again (a duplicate, never a gap). Never throws.
51
+ * A compaction landed on a leg that mounts the advisor: the full instructions it summarized away are restated (the told seat's
52
+ * one compaction arm), and the record moves to the new segment — so a leg that no longer mounts the tool withdraws what the
53
+ * model now holds, and a leg that still does tells nothing twice. Never throws.
61
54
  */
62
- export declare function appendAdvisorRestate(prepared: {
63
- readonly advisorInstruction?: AdvisorInstructionSeat;
64
- readonly reminderMark: string;
65
- readonly session: Pick<StoredSession, "appendMessage">;
66
- readonly admitRows: RowAdmission;
67
- readonly batchHaltRef: {
68
- readonly current?: unknown;
69
- };
70
- readonly postureFrameRef: Pick<PostureFrameRef, "report">;
71
- }): Promise<void>;
55
+ export declare function appendAdvisorRestate(prepared: Pick<Prepared, "advisorInstruction" | "reminderMark" | "session" | "admitRows" | "batchHaltRef" | "postureFrameRef" | "announcedListingsRef" | "frameReceipts" | "announcedSnapshotRecovered">): Promise<void>;
@@ -1,6 +1,5 @@
1
- import { appendAdmittedRow } from "../row-admission.js";
2
1
  import { mintSystemReminder } from "../reminder-mint.js";
3
- import { thrownText } from "../thrown-value.js";
2
+ import { restateToldSeat } from "./conversation-segment.js";
4
3
  export const ADVISOR_TOOL_INSTRUCTIONS = `# Advisor Tool
5
4
 
6
5
  You have access to an \`advisor\` tool backed by a stronger reviewer model. It takes NO parameters -- when you call advisor(), your entire conversation history is automatically forwarded. They see the task, every tool call you've made, every result you've seen.
@@ -21,11 +20,11 @@ export const ADVISOR_TOOL_ABBREVIATED = "The advisor tool is available; the advi
21
20
  export const ADVISOR_TOOL_REMOVED = "The advisor tool is no longer available; disregard the earlier advisor instructions.";
22
21
  export function advisorInstructionFrame(told, mounted) {
23
22
  if (mounted && told === undefined)
24
- return { body: ADVISOR_TOOL_INSTRUCTIONS, state: "announced" };
23
+ return { body: ADVISOR_TOOL_INSTRUCTIONS, value: "announced" };
25
24
  if (mounted && told === "withdrawn")
26
- return { body: ADVISOR_TOOL_ABBREVIATED, state: "announced" };
25
+ return { body: ADVISOR_TOOL_ABBREVIATED, value: "announced" };
27
26
  if (!mounted && told === "announced")
28
- return { body: ADVISOR_TOOL_REMOVED, state: "withdrawn" };
27
+ return { body: ADVISOR_TOOL_REMOVED, value: "withdrawn" };
29
28
  return undefined;
30
29
  }
31
30
  export function advisorFrameText(prepared) {
@@ -42,21 +41,20 @@ export function settleAdvisorInstruction(prepared) {
42
41
  if (seat === undefined || owed === undefined)
43
42
  return;
44
43
  seat.owed = undefined;
45
- prepared.announcedListingsRef.advisor = { state: owed.state, segment: seat.segment };
44
+ if (seat.segment === undefined)
45
+ return;
46
+ prepared.announcedListingsRef.advisor = { state: owed.value, segment: seat.segment };
46
47
  prepared.frameReceipts.listingSnapshotOwed = true;
47
48
  }
48
- export async function appendAdvisorRestate(prepared) {
49
- if (prepared.advisorInstruction?.mounted !== true || prepared.batchHaltRef.current !== undefined)
50
- return;
51
- const text = mintSystemReminder(ADVISOR_TOOL_INSTRUCTIONS, prepared.reminderMark);
52
- try {
53
- await appendAdmittedRow(prepared.admitRows, prepared.session, { role: "user", content: [{ type: "text", text }], timestamp: Date.now(), engineMinted: true });
54
- }
55
- catch (err) {
56
- try {
57
- prepared.postureFrameRef.report?.(new Error(`the advisor instructions could not be restated after compaction (the next leg states them): ${thrownText(err)}`));
58
- }
59
- catch {
60
- }
61
- }
49
+ export function appendAdvisorRestate(prepared) {
50
+ const seat = prepared.advisorInstruction;
51
+ if (seat?.mounted !== true)
52
+ return Promise.resolve();
53
+ return restateToldSeat(prepared, seat, {
54
+ body: ADVISOR_TOOL_INSTRUCTIONS,
55
+ value: "announced",
56
+ what: "the advisor instructions",
57
+ carried: seat.owed?.body === ADVISOR_TOOL_INSTRUCTIONS,
58
+ record: (state, segment) => void (prepared.announcedListingsRef.advisor = { state, segment }),
59
+ });
62
60
  }
@@ -87,6 +87,7 @@ async function consult(seat, toolCallId, signal) {
87
87
  ...(sent.tools !== undefined && sent.tools.length > 0 ? { tools: sent.tools.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters })) } : {}),
88
88
  ...(signal !== undefined ? { signal } : {}),
89
89
  ...(seat.getApiKeyAndHeaders !== undefined ? { getApiKeyAndHeaders: seat.getApiKeyAndHeaders } : {}),
90
+ ...(sent.promptLocale !== undefined ? { promptLocale: sent.promptLocale } : {}),
90
91
  }, { brain: seat.brain });
91
92
  return outcomeOf(model, r);
92
93
  }
@@ -60,7 +60,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
60
60
  recovered = false;
61
61
  return undefined;
62
62
  });
63
- const seed = checkpointMirror?.mcpFailed !== undefined || checkpointMirror?.advisories !== undefined || checkpointMirror?.advisor !== undefined ? checkpointMirror : entry;
63
+ const seed = checkpointMirror?.mcpFailed !== undefined || checkpointMirror?.advisories !== undefined || checkpointMirror?.advisor !== undefined || checkpointMirror?.language !== undefined ? checkpointMirror : entry;
64
64
  const listingSrc = checkpointMirror?.agents !== undefined || checkpointMirror?.skills !== undefined || checkpointMirror?.models !== undefined ? checkpointMirror : entry;
65
65
  let mcpFailed = (seed?.mcpFailed ?? []).map((f) => ({ ...f }));
66
66
  const advisories = new Set(seed?.advisories ?? []);
@@ -116,6 +116,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
116
116
  ...(mcpFailed.length > 0 ? { mcpFailed: mcpFailed.map((f) => ({ ...f })) } : {}),
117
117
  ...(advisories.size > 0 ? { advisories: withAnnounceDigests(undefined, [...advisories]) } : {}),
118
118
  ...(seed?.advisor !== undefined ? { advisor: { ...seed.advisor } } : {}),
119
+ ...(seed?.language !== undefined ? { language: { ...seed.language } } : {}),
119
120
  }),
120
121
  settle: async (s, ref) => {
121
122
  if (advisories.size > 0)
@@ -130,6 +131,7 @@ export async function loadAnnounceOnceLedger(session, checkpointMirror, onError)
130
131
  ...(ref.mcpFailed !== undefined && ref.mcpFailed.length > 0 ? { mcpFailed: ref.mcpFailed } : {}),
131
132
  ...(ref.advisories !== undefined && ref.advisories.length > 0 ? { advisories: ref.advisories } : {}),
132
133
  ...(ref.advisor !== undefined ? { advisor: ref.advisor } : {}),
134
+ ...(ref.language !== undefined ? { language: ref.language } : {}),
133
135
  })
134
136
  .catch(() => undefined);
135
137
  },
@@ -143,6 +145,7 @@ export function serializeAnnouncedListings(ref) {
143
145
  ...(ref.mcpFailed !== undefined ? { mcpFailed: ref.mcpFailed.map((f) => ({ ...f })) } : {}),
144
146
  ...(ref.advisories !== undefined ? { advisories: [...ref.advisories] } : {}),
145
147
  ...(ref.advisor !== undefined ? { advisor: { ...ref.advisor } } : {}),
148
+ ...(ref.language !== undefined ? { language: { ...ref.language } } : {}),
146
149
  };
147
150
  return Object.keys(out).length > 0 ? out : undefined;
148
151
  }
@@ -1,25 +1,26 @@
1
1
  /**
2
- * What the approving person wrote on the card ({@link ResumeOutcome} `policy_ask` `allow` `feedback`) — the one place that
3
- * says what counts as written, which decide may carry it, and how it joins the resume continuation.
2
+ * What the approving person wrote on the card ({@link ResumeOutcome} `policy_ask` `allow` `feedback`) — which decide may carry it,
3
+ * and how it joins the resume continuation; and the live leg's carrier for the same words ({@link approvalWordsSeat}).
4
4
  *
5
- * ONE READING of "did the person write anything" ({@link writtenFeedback}): the text with the whitespace the card's input does
6
- * not keep removed, or nothing when that leaves nothing. The pre-CAS checks and the continuation both ask it, so they cannot
7
- * disagree about a blank value. (A deny's `reason` keeps its own rule, `decidersNote`: only `""` is blank there.)
5
+ * ONE READING of "did the person write anything" ({@link writtenFeedback}, in approval-words.ts beside the judge of which words
6
+ * may be delivered): the text with the whitespace the card's input does not keep removed, or nothing when that leaves nothing. The
7
+ * pre-CAS checks and the continuation both ask it, as does the live answer's reading, so they cannot disagree about a blank value.
8
+ * (A deny's `reason` keeps its own rule, `decidersNote`: only `""` is blank there.)
8
9
  *
9
10
  * The words ride the resume continuation user message — the first message after the batch's tool results, once the batch's
10
11
  * unanswered siblings have settled — as a user-lane range of their own: outside every engine segment, so a derived view reads
11
12
  * them as user speech; verbatim, no fence, no wrapper sentence, no length bound. They are owed with the rest of the
12
13
  * continuation: when the batch parks again before the prompt lands they ride the new row as its last parked steer.
13
14
  */
15
+ import type { AgentHarness } from "../../internal/harness.js";
16
+ import { type ApprovalWordsSeat } from "../approval-words.js";
14
17
  import { type PendingSteerEntry, type ResumeOutcome } from "../checkpoint-store.js";
15
18
  type PolicyAsk = Extract<ResumeOutcome, {
16
19
  gate: "policy_ask";
17
20
  }>;
18
- /** The words as the model is to read them, or `undefined` when nothing was written (absent, empty, whitespace-only). */
19
- export declare function writtenFeedback(feedback: string | undefined): string | undefined;
20
21
  /**
21
22
  * Pre-CAS: a WRITTEN feedback is the allow arm's, a person's, and free of the `<system-reminder>` tag (opening or closing — the one
22
- * judge `sanitizeUntrustedText`, the same rule a deny's `reason` is held to, applied here by the same call). Each is refused
23
+ * judge `sanitizeUntrustedText`; why a tag is refused at this door and not defused is the one reading in `docs/CLOSED-SETS.md`). Each is refused
23
24
  * (`checkpoint.invalid_outcome`, the row stays pending for a well-formed decide) rather than dropped or delivered as something it
24
25
  * is not: a deny's words are `reason`, and a machine's text must never reach the model as the user's. The twin is the captured
25
26
  * plain data (its text already held to the string domain by the capture), never the caller's object.
@@ -35,6 +36,14 @@ export declare function withApprovalWords(continuation: string, engineSegments:
35
36
  start: number;
36
37
  end: number;
37
38
  }>, words: string): string;
39
+ /**
40
+ * The live leg's carrier ({@link ApprovalWordsSeat}): the words queue on the harness's steer lane as a plain user message — verbatim,
41
+ * no fence, no wrapper sentence, no provenance mark, so a derived view reads them as the person's speech, exactly as the resume
42
+ * continuation's user-lane range is read. The lane drains at the turn boundary after the batch's tool results, which is where a
43
+ * durable leg's continuation also lands. A queue that refuses them (the run is no longer taking input) is reported through `report`,
44
+ * never thrown into the gate; words still queued when the run ends are the steer lane's own undrained account.
45
+ */
46
+ export declare function approvalWordsSeat(harness: Pick<AgentHarness, "steer">, report: (error: Error) => void): ApprovalWordsSeat;
38
47
  /**
39
48
  * The words as the continuation's owed content: the last parked steer, an untrusted one (the carrier that exists for an owed instruction).
40
49
  * The frame is remembered by identity ({@link isApprovalWordsFrame}) — never by a member, which the steer store would refuse as an unknown
@@ -1,23 +1,18 @@
1
+ import { unfitFeedbackOf, writtenFeedback } from "../approval-words.js";
1
2
  import { CheckpointError } from "../checkpoint-store.js";
2
- import { sanitizeUntrustedText, sentinelTagRefusal } from "../untrusted-text.js";
3
- export function writtenFeedback(feedback) {
4
- const trimmed = feedback?.trim();
5
- return trimmed === undefined || trimmed === "" ? undefined : trimmed;
6
- }
3
+ import { asThrownError } from "../thrown-value.js";
4
+ import { sentinelTagRefusal } from "../untrusted-text.js";
7
5
  export function refuseUnfitFeedback(twin) {
8
- const words = writtenFeedback(twin.feedback);
9
- if (words === undefined)
6
+ const unfit = unfitFeedbackOf(writtenFeedback(twin.feedback), { allowed: twin.decision === "allow", byPerson: twin.hostDecision.decidedBy === "person" });
7
+ if (unfit === undefined)
10
8
  return;
11
- if (twin.decision !== "allow") {
9
+ if (unfit === "on_a_deny") {
12
10
  throw feedbackRefusal("resume carried `feedback` on a `deny` — feedback is the approving person's words on an `allow` (a denial's words are `reason`); refusing rather than dropping it silently, the checkpoint stays pending");
13
11
  }
14
- const byPerson = twin.hostDecision.decidedBy === "person";
15
- if (!byPerson) {
12
+ if (unfit === "by_a_machine") {
16
13
  throw feedbackRefusal(`resume carried \`feedback\` on a decide made by "${twin.hostDecision.decidedBy}" — feedback is delivered to the model as the user's own words, which only a person's decide can be; refusing rather than attributing a machine's text to the user, the checkpoint stays pending`);
17
14
  }
18
- if (sanitizeUntrustedText(words) !== words) {
19
- throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
20
- }
15
+ throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
21
16
  }
22
17
  function feedbackRefusal(message) {
23
18
  return new CheckpointError("checkpoint.invalid_outcome", message, { field: "feedback" });
@@ -31,6 +26,16 @@ export function withApprovalWords(continuation, engineSegments, words) {
31
26
  engineSegments.push({ start: glueStart, end: withGlue.length });
32
27
  return withGlue + words;
33
28
  }
29
+ export function approvalWordsSeat(harness, report) {
30
+ return async (words) => {
31
+ try {
32
+ await harness.steer(words);
33
+ }
34
+ catch (err) {
35
+ report(new Error(`the approving person's words could not be queued for the model: ${asThrownError(err).message}`));
36
+ }
37
+ };
38
+ }
34
39
  const APPROVAL_WORDS_FRAMES = new WeakSet();
35
40
  export function owedApprovalWords(words, inputId) {
36
41
  if (words === undefined)
@@ -0,0 +1,17 @@
1
+ import type { ApproverDefect } from "../tool-policy.js";
2
+ /**
3
+ * The announcer `resolveAskFor` is handed at every station that puts an ask to an approver (`approval.approver_defect`): the approver
4
+ * threw, or answered outside its contract, and the call it was asked about is denied fail-closed. The denial is the model's and the
5
+ * run's — it reads as any refusal; this is the deployment's, who wired a seat that does not keep its contract. Once per denied ask. The
6
+ * detail names how it failed and what kind of seat it was, and never the thrown text or the answer (the denial the model reads names
7
+ * them).
8
+ */
9
+ export declare function approverDefectAnnouncer(args: {
10
+ toolName: string;
11
+ toolCallId: string;
12
+ sessionId: string;
13
+ runId: string;
14
+ /** The leg's own task id (`Prepared.taskId`), always present. */
15
+ taskId: string;
16
+ onNotice: import("../types.js").RunnerDeps["onNotice"];
17
+ }): (defect: ApproverDefect) => void;
@@ -0,0 +1,22 @@
1
+ import { legNoticeTaskId } from "../mods/stations.js";
2
+ import { deliverEngineNotice } from "../types.js";
3
+ export function approverDefectAnnouncer(args) {
4
+ return (defect) => {
5
+ const how = defect.cause === "threw" ? "threw" : 'answered outside its contract (an answer that is not true, false, "unavailable" or the {allow} object, or an object the seam refuses)';
6
+ const which = defect.seat === "policy" ? "approval policy (asPolicyApprover)" : "approver";
7
+ deliverEngineNotice(args.onNotice, {
8
+ code: "approval.approver_defect",
9
+ message: `the deployment's ${which} ${how} on the ask for "${args.toolName}" — the call was denied fail-closed and the tool did not run. ` +
10
+ "Every ask this seat fails to answer in contract is refused the same way; the model reads the denial as an ordinary one.",
11
+ detail: {
12
+ toolName: args.toolName,
13
+ toolCallId: args.toolCallId,
14
+ cause: defect.cause,
15
+ seat: defect.seat,
16
+ sessionId: args.sessionId,
17
+ runId: args.runId,
18
+ ...legNoticeTaskId(args),
19
+ },
20
+ });
21
+ };
22
+ }
@@ -16,7 +16,13 @@ export interface Stats {
16
16
  cacheWriteTokensLong: number;
17
17
  outputTokens: number;
18
18
  cacheHitRate?: number;
19
- /** Cache-INCLUSIVE prompt total (`promptTokens + cachedTokens + cacheWriteTokens*`) — the
19
+ /** The cache account's marks, exclusions and per-lane operands (`./cache-hit-account.ts`; the public faces are documented on
20
+ * `TaskResult.stats`). `cacheLanes` is run-loop internal, stripped at assembly. */
21
+ cacheReadUnreported?: true;
22
+ cacheWriteUnreported?: true;
23
+ cacheHitRateExcludes?: import("./cache-hit-account.js").CacheHitExclusion[];
24
+ cacheLanes?: import("./cache-hit-account.js").CacheLanes;
25
+ /** Cache-INCLUSIVE prompt total (`promptTokens + cachedTokens + cacheWriteTokens`; the one-hour writes are a part of the last) — the
20
26
  * billing/window/hit-rate denominator. Required (not derived) so a new accumulation site that forgets
21
27
  * it fails the type check instead of silently reporting a total short by its own leg. */
22
28
  totalInputTokens: number;
@@ -38,7 +44,8 @@ export interface Stats {
38
44
  * `gate.kind`, accumulated across resume legs. Set by the run loop from the per-task human-review
39
45
  * accumulator (synchronous `resolveAsk` timing + durable resume latency). **NOT an LLM cost** — never
40
46
  * folded into `costMicroUsd`/`costBreakdown`/the budget gate (same budget-excluded treatment as `memory`).
41
- * Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread; absent ⇒ no gate. */
47
+ * Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread (`TaskResult.stats.humanReview`
48
+ * says when it is present). */
42
49
  humanReview?: {
43
50
  count: number;
44
51
  totalWaitMs: number;
@@ -136,14 +143,21 @@ export interface ResultFlags {
136
143
  * one — the model did not finish; the person stopped it and the run awaits their direction). */
137
144
  haltedOnUserRejection?: boolean;
138
145
  /** the harness's STATEMENT of what the run's halt did (see `HaltConsumption`):
139
- * the loop's report that the halt's cut settled the final turn, and/or the boundary consult that
140
- * stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser`
141
- * (`haltConsumed`, halt-attribution.ts) and to slot 9.7 — the assembly never infers causation from the
146
+ * the loop's report that the halt's (or an extension's) cut settled the final turn, and/or the boundary consult that
147
+ * stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser` / `turnAbortedBy`
148
+ * (halt-attribution.ts) and to slot 9.7 — the assembly never infers causation from the
142
149
  * final's shape or from the verb's acceptance. A halt that was accepted but consumed nothing (the run
143
150
  * ended for its own reason first) leaves this empty: the original terminal stands and the seat is
144
151
  * NOT signed (the settle lane mints `task.halt_unconsumed` for it). */
145
152
  haltConsumption?: HaltConsumption;
146
153
  answerEntryIds?: readonly string[];
154
+ intake?: TaskResult["intake"];
155
+ /** What the leg's display showed of those messages, when a `classic.MessageDisplay` handler changed it (the display's own
156
+ * reading, `MessageDisplay.displayedOf`): `result` is then that text, through the same projection, and `resultDisplayedBy` names who. */
157
+ displayed?: {
158
+ readonly text: string;
159
+ readonly by: readonly string[];
160
+ };
147
161
  /** Call ids of answered-but-never-collected questions, echoed on
148
162
  * `TaskResult.strandedHumanAnswers`. Pure pass-through; empty/absent ⇒ the field is omitted. The
149
163
  * optional `onError` alert is NOT the disclosure — this mandatory result face is. */
@@ -202,9 +216,9 @@ export interface ResultFlags {
202
216
  blockedReason?: string;
203
217
  blockedDetail?: TerminalBlockedDetail;
204
218
  conflict?: boolean;
205
- /** env-tail migration F5: the request-build guard threw the irreducible-core terminal this run —
206
- * the loop folded it into a text-only failure message, so the typed code rides this flag. */
207
- gitCoreOverBudget?: boolean;
219
+ /** The request-build guard threw the irreducible-core terminal this run (the trim's core or the git frame's) — the loop
220
+ * folded it into a text-only failure message, so the typed code rides this flag. */
221
+ coreOverBudget?: boolean;
208
222
  outputInvalid?: boolean;
209
223
  /** The word the loop's last exit named (`Prepared.loopTerminalRef`), read through `loopExitFailureOf`; absent = the loop never exited. */
210
224
  loopTerminal?: LoopTerminalReason;
@@ -270,8 +284,8 @@ export interface ResultFlags {
270
284
  * landed on work or on the tail. Evaluated ONCE per leg (the terminal-adoption lane, where both facts
271
285
  * are in hand) and handed on as a value — {@link ResultFlags.answerSettled} — so the arbitration, the
272
286
  * marker gate, the hook-seat grace, the teardown attribution and the notice read the same verdict.
273
- * (A limit that is NOT a stop — a budget ceiling crossed by the last turn's own spend — is arbitrated
274
- * above slot 9 and is unaffected.)
287
+ * (A budget ceiling crossed by the last turn's own spend reads the same verdict at its own slot, above
288
+ * slot 9: an answered turn owes no further request, so the ceiling is a fact on `stats`, not a failure.)
275
289
  */
276
290
  export declare function answerSettled(final: AssistantMessage | undefined, continuationCut?: boolean): boolean;
277
291
  export declare function terminalCauseOf(final: AssistantMessage | undefined, stats: Pick<Stats, "humanReview">, flags: ResultFlags): {
@@ -286,7 +300,7 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
286
300
  * 2. degenerate → `"output.degenerate"` + `salvagedOutput` (wins over budget/timeout)
287
301
  * 3. `budgetHit` → `"limits.max_tokens_exceeded"` | `"limits.max_cost_exceeded"` (by `budgetAxis`;
288
302
  * the pre-call estimate rejection and the after-spend crossing share the code — the distinction
289
- * lives in `errorMessage`, not in a second code)
303
+ * lives in `errorMessage`, not in a second code), EXCEPT when `answerSettled` (the answering turn's own spend crossed it → 12)
290
304
  * 3.5 `suspendLoop` → `"suspend.loop"` (the re-suspend cap; deterministic root
291
305
  * cause, above `threw` because it owns the abort)
292
306
  * 4. `threw` + walltime → `"limits.max_walltime_exceeded"`
@@ -301,15 +315,16 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
301
315
  * 9. `abortedLive` | stopReason aborted → `"limits.max_walltime_exceeded"` | `"limits.max_turns_exceeded"` | undefined
302
316
  * (audit A-1: hoisted ABOVE no-final — the loop exits cleanly on abort, so `final` may be a
303
317
  * normal message or absent; a plain user interrupt carries NO errorCode — switch on `status`),
304
- * EXCEPT when the aborted `final` is the bare halt's OWN cut artifact (`haltOwnsAbortedFinal`: the
305
- * loop reported the halt's cut settled the final turn — never shape inference),
318
+ * EXCEPT when the aborted `final` is an ending cut's OWN artifact (`cutOwnsAbortedFinal`: the
319
+ * loop reported the halt's, or an extension's `$.turn.abort`, cut settled the final turn — never shape inference),
306
320
  * and EXCEPT when the answer had already settled (`answerSettled`: a clean `"stop"` final, not
307
321
  * partial) — a stop landing on the run's tail cuts no work, so the run falls through to 12
308
322
  * (`completed`, the answer as `result`, no `limits.*` code for the axis; three axes, one law)
309
323
  * 9.7 halt CONSUMED (`haltConsumed(flags.haltConsumption)`) + (no `final` | the halt's own aborted
310
324
  * `final`) → status `"completed"` (a bare user halt — the verb working, not a defect; below the
311
325
  * aborts on purpose, a real abort/limit that also fired owns the terminal and the halt rides as
312
- * the pass-through seat; an accepted-but-unconsumed halt never reaches this slot)
326
+ * the pass-through seat; an accepted-but-unconsumed halt never reaches this slot); an extension's
327
+ * `$.turn.abort` that ended the final turn reaches it the same way (`endingCutConsumed`, `turnAbortedBy`)
313
328
  * 10. no `final` → status `"failed"`
314
329
  * 11. stopReason error → brain `[code]` prefix (or `"conflict"` from the storage-layer flag)
315
330
  * 11.5 the loop exited on a spent recovery budget (`loopTerminal`, read through `loopExitFailureOf`) →
@@ -1,11 +1,10 @@
1
1
  import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
2
2
  import { extractErrorCode, isProviderEchoShape, refusedTheRequest, stripErrorCodePrefix } from "../../brain/errors.js";
3
- import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
3
+ import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerSentenceOf, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
4
4
  import { terminalProjection } from "./terminal-projection.js";
5
- import { haltConsumed } from "./halt-attribution.js";
5
+ import { endingCutConsumed, haltConsumed, turnAbortedByOf } from "./halt-attribution.js";
6
6
  import { providerReportedModel } from "../message-utils.js";
7
- import { isErrorLike, readMember } from "../thrown-value.js";
8
- import { describeRejectedValue } from "../tool-search-setting.js";
7
+ import { readMember, thrownText } from "../thrown-value.js";
9
8
  const SALVAGE_ELIGIBLE_TERMINALS = new Set([
10
9
  "output.degenerate",
11
10
  "limits.max_tokens_exceeded",
@@ -15,14 +14,6 @@ const SALVAGE_ELIGIBLE_TERMINALS = new Set([
15
14
  "env.lifetime_expired",
16
15
  "usage.window_exhausted",
17
16
  ]);
18
- function thrownMessage(threw) {
19
- if (isErrorLike(threw)) {
20
- const m = readMember(threw, "message");
21
- if (typeof m === "string")
22
- return m;
23
- }
24
- return describeRejectedValue(threw);
25
- }
26
17
  function stripThinkTags(text) {
27
18
  let t = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
28
19
  const lower = t.toLowerCase();
@@ -45,7 +36,7 @@ export function answerSettled(final, continuationCut = false) {
45
36
  export function terminalCauseOf(final, stats, flags) {
46
37
  let terminal;
47
38
  let apiFailure;
48
- const haltOwnsAbortedFinal = flags.haltConsumption?.turnCut === "halt" &&
39
+ const cutOwnsAbortedFinal = endingCutConsumed(flags.haltConsumption) &&
49
40
  final?.stopReason === "aborted" &&
50
41
  !flags.abortedLive &&
51
42
  flags.abortedForTimeout !== true &&
@@ -59,7 +50,7 @@ export function terminalCauseOf(final, stats, flags) {
59
50
  else if (isDegenerate) {
60
51
  terminal = { kind: "failed", code: "output.degenerate", ...(final?.errorMessage !== undefined ? { message: final.errorMessage } : {}) };
61
52
  }
62
- else if (flags.budgetHit) {
53
+ else if (flags.budgetHit && flags.answerSettled !== true) {
63
54
  const axisName = flags.budgetAxis === "tokens" ? "limits.maxTokens" : "limits.maxCostUsd";
64
55
  terminal = {
65
56
  kind: "failed",
@@ -83,7 +74,7 @@ export function terminalCauseOf(final, stats, flags) {
83
74
  terminal = { kind: "failed", code: "suspend.loop", message };
84
75
  }
85
76
  else if (flags.threw) {
86
- const thrown = thrownFailureOf(flags.threw, thrownMessage(flags.threw));
77
+ const thrown = thrownFailureOf(flags.threw, thrownText(flags.threw));
87
78
  const axisCode = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : flags.conflict ? "conflict" : undefined;
88
79
  const code = axisCode ?? thrown.code;
89
80
  const detail = axisCode === undefined ? thrown.detail : undefined;
@@ -95,11 +86,11 @@ export function terminalCauseOf(final, stats, flags) {
95
86
  else if (flags.paused) {
96
87
  terminal = flags.paused;
97
88
  }
98
- else if ((flags.abortedLive || final?.stopReason === "aborted") && !haltOwnsAbortedFinal && flags.answerSettled !== true) {
89
+ else if ((flags.abortedLive || final?.stopReason === "aborted") && !cutOwnsAbortedFinal && flags.answerSettled !== true) {
99
90
  const code = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : undefined;
100
91
  terminal = { kind: "failed", ...(code !== undefined ? { code } : {}), message: final?.errorMessage ?? (flags.abortedForTurns ? "max turns exceeded" : "run aborted") };
101
92
  }
102
- else if ((haltConsumed(flags.haltConsumption) && (!final || haltOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
93
+ else if (((haltConsumed(flags.haltConsumption) || endingCutConsumed(flags.haltConsumption)) && (!final || cutOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
103
94
  terminal = { kind: "completed" };
104
95
  }
105
96
  else if (!final) {
@@ -124,7 +115,7 @@ export function terminalCauseOf(final, stats, flags) {
124
115
  code = lifted;
125
116
  message = stripErrorCodePrefix(message);
126
117
  }
127
- else if (flags.gitCoreOverBudget) {
118
+ else if (flags.coreOverBudget) {
128
119
  code = "irreducible_core_over_budget";
129
120
  messageNamed = false;
130
121
  }
@@ -139,7 +130,7 @@ export function terminalCauseOf(final, stats, flags) {
139
130
  let detail;
140
131
  if (messageNamed && apiError && typeof apiStatus === "number" && refusedTheRequest(apiStatus)) {
141
132
  const route = requestRouteOfMessage(final);
142
- detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
133
+ detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...providerSentenceOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
143
134
  }
144
135
  else if (messageNamed && outputInvalid !== undefined) {
145
136
  detail = { kind: "model_output_invalid", ...outputInvalid };
@@ -168,19 +159,19 @@ export function assembleResult(leg, final, stats, flags) {
168
159
  ...(stats.sideCallMicroUsd !== undefined ? { sideCallMicroUsd: stats.sideCallMicroUsd } : {}),
169
160
  };
170
161
  }
171
- const result = text;
162
+ const result = flags.displayed !== undefined ? stripThinkTags(flags.displayed.text) : text;
172
163
  let salvagedOutput;
173
164
  const { terminal, apiFailure } = terminalCauseOf(final, stats, flags);
174
165
  const { errorCode } = terminalProjection(terminal);
175
166
  if (errorCode !== undefined && SALVAGE_ELIGIBLE_TERMINALS.has(errorCode)) {
176
- salvagedOutput = text.trim() || undefined;
167
+ salvagedOutput = result.trim() || undefined;
177
168
  }
178
169
  const retryAfterMs = errorCode === "usage.window_exhausted" || errorCode === "memory.admission_required" ? flags.retryAfterMs : undefined;
179
- const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, ...publicStats } = stats;
180
- void _internalCompaction;
181
- void _internalSideCall;
170
+ const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, cacheLanes: _internalCacheLanes, ...publicStats } = stats;
171
+ void [_internalCompaction, _internalSideCall, _internalCacheLanes];
182
172
  if (flags.unpricedSpend)
183
173
  delete publicStats.costMicroUsd;
184
174
  const stampHaltedByUser = haltConsumed(flags.haltConsumption);
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 };
175
+ const turnAbortedBy = turnAbortedByOf(flags.haltConsumption);
176
+ 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] } : {}), ...(flags.intake !== undefined ? { intake: flags.intake } : {}), ...(flags.displayed !== undefined ? { resultDisplayedBy: [...flags.displayed.by] } : {}), 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 } : {}), ...(turnAbortedBy !== undefined ? { turnAbortedBy } : {}), ...(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 };
186
177
  }