@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,5 +1,6 @@
1
1
  import type { AgentTool } from "../internal/harness-types.js";
2
2
  import type { ToolPolicy } from "./tool-policy.js";
3
+ import type { AssertAllKeysHandled } from "./ask-origin.js";
3
4
  /** The reserved tool name for AskUserQuestion — shared so the durable-resume path (runtask) can recognize it
4
5
  * as a content-ask whose SHOWN questions must not be rewritten by an operator `updatedInput` (design/80 D-F).
5
6
  *
@@ -33,7 +34,7 @@ export declare const isEngineQuestionFace: (face: {
33
34
  * input) is wrapped in an untrusted-DATA fence so it can never be read as instructions. Abort while waiting is
34
35
  * handled by the §9 interrupt path (the pending call is closed). Mounting (CC non-interactive `isEnabled`
35
36
  * parity): only when a delivery face exists — a live `onQuestion`, or a durable park consumer (`checkpointStore`
36
- * + `durableApproval`/`forceDurableGate`), or an explicit `TaskSpec.interactiveTools: true` — see that knob.
37
+ * + `durableApproval`, or `forceDurableGate` on a root leg), or an explicit `TaskSpec.interactiveTools: true` — see that knob.
37
38
  */
38
39
  export interface AskQuestionOption {
39
40
  /** The choice text the user picks. */
@@ -142,10 +143,25 @@ export interface QuestionUnavailable {
142
143
  * · a THROW — delivery was attempted and failed. Never collapse a throw into `unavailable`.
143
144
  */
144
145
  export type OnQuestionOutcome = QuestionAnswer | QuestionUnavailable;
145
- /** How an {@link OnQuestionOutcome} reads. `"contradictory"` covers a value claiming BOTH arms at
146
- * once (the `unavailable` discriminant alongside an `answers` array — structural typing permits it, and
147
- * the outcome is deployment-supplied and may cross a wire), a value claiming NEITHER arm (a failed
148
- * decode must not read as "the user selected nothing"), and a value that cannot be read at all. */
146
+ /** The four ways an outcome reads as neither an answer nor "nobody was reachable", the word each reading carries:
147
+ * · `unreadable` — a member of the value threw when it was read (a throwing getter);
148
+ * · `both_arms` — the `unavailable` discriminant alongside an `answers` array (structural typing permits it, and the
149
+ * outcome is deployment-supplied and may cross a wire);
150
+ * · `neither_arm` — no discriminant and no `answers` array (a failed decode must not read as "the user selected nothing");
151
+ * · `not_capturable` — an `answers` array that is not plain data the engine can keep (a hole, a named member, a cycle). */
152
+ export declare const QUESTION_OUTCOME_FAULTS: readonly ["unreadable", "both_arms", "neither_arm", "not_capturable"];
153
+ export type QuestionOutcomeFault = (typeof QUESTION_OUTCOME_FAULTS)[number];
154
+ /** The clause per fault — the disposition table over {@link QUESTION_OUTCOME_FAULTS}, quoted by the one sentence
155
+ * {@link QuestionOutcomeUnreadableError} says. */
156
+ export declare const QUESTION_OUTCOME_FAULT_TEXT: {
157
+ readonly unreadable: "a member of the value threw when it was read";
158
+ readonly both_arms: "the value claims an answer and \"unavailable\" at once";
159
+ readonly neither_arm: "the value claims neither an answer nor \"unavailable\"";
160
+ readonly not_capturable: "its answers are not plain data the engine can keep";
161
+ };
162
+ export type FaultTextCoversEveryFault = AssertAllKeysHandled<Exclude<QuestionOutcomeFault, keyof typeof QUESTION_OUTCOME_FAULT_TEXT>>;
163
+ /** How an {@link OnQuestionOutcome} reads. `"contradictory"` covers a value that is neither of the two arms the seam
164
+ * allows — it takes the channel-failure exit, never a resolution — and says which of the four ways ({@link QuestionOutcomeFault}). */
149
165
  export type QuestionOutcomeReading =
150
166
  /** The answer, already narrowed AND captured as an inert, density-validated clone — a caller
151
167
  * neither re-reads the caller's value to get at it nor needs a `structuredClone` of its own. */
@@ -156,7 +172,15 @@ export type QuestionOutcomeReading =
156
172
  readonly shape: "unavailable";
157
173
  } | {
158
174
  readonly shape: "contradictory";
175
+ readonly fault: QuestionOutcomeFault;
159
176
  };
177
+ /** The failure a channel's unreadable outcome is — the ONE sentence for it, said by the tool, the engine's routing lane and the
178
+ * headless exit alike. It is a channel failure that names its cause: the model is never told that nobody is available when a
179
+ * human may have answered in a shape the engine cannot read. */
180
+ export declare class QuestionOutcomeUnreadableError extends Error {
181
+ readonly fault: QuestionOutcomeFault;
182
+ constructor(fault: QuestionOutcomeFault);
183
+ }
160
184
  /**
161
185
  * THE reader for a question outcome, and the only place its fields are touched. Total by construction:
162
186
  * every way the value can misbehave — a throwing getter, both arms at once — lands on
@@ -185,9 +209,13 @@ export declare function isQuestionUnavailable(outcome: OnQuestionOutcome): outco
185
209
  * an unanswered question is released at the deadline (it does not hang the worker).
186
210
  *
187
211
  * **Single-winner obligation (the deployment's half).** A face that races a deadline against a real UI
188
- * owns the atomicity: before returning {@link QuestionUnavailable} it must CLOSE the open request, so a
189
- * submission arriving one tick later is refused rather than applied. A signal race alone is not enough —
190
- * two independent resolutions of one question is the shape this seam exists to prevent. Key the registry
212
+ * owns the atomicity, and the race covers only the stretch BEFORE the question reached a human: a deadline
213
+ * or abort that elapses while nothing has been shown ends in {@link QuestionUnavailable}, whose contract is
214
+ * zero interaction; once the card is shown, an elapsed deadline or an abort ends in a THROW, which is what
215
+ * {@link QuestionUnavailable} says of a face that showed the question and then failed. Either way the face
216
+ * CLOSES the open request first, so a submission arriving one tick later is refused rather than applied:
217
+ * the single winner is guaranteed by the close, not by the value the face hands back. A signal race alone
218
+ * is not enough — two independent resolutions of one question is the shape this seam exists to prevent. Key the registry
191
219
  * on {@link AskQuestionRequest.deliveryId} (scoped by tenant) — NOT on the call id or the argument hash,
192
220
  * neither of which is unique per delivery. The engine consumes exactly one outcome per call id
193
221
  * and never asks the same call twice, so honoring this contract makes the whole path single-winner; core
@@ -4,9 +4,24 @@ import { boundInputHashOf, capturedJsonOf } from "./canonical-json.js";
4
4
  import { defineTool, errorResult } from "./tools.js";
5
5
  import { delimitUntrusted, inlineUntrusted } from "./untrusted-text.js";
6
6
  import { engineMountedAs, mountRuleFace, toolFace } from "./tool-catalog-entries.js";
7
- import { thrownText } from "./thrown-value.js";
7
+ import { thrownIs, thrownText } from "./thrown-value.js";
8
8
  export const ASK_USER_QUESTION_TOOL_NAME = "AskUserQuestion";
9
9
  export const isEngineQuestionFace = engineMountedAs(["ask-user-question"]);
10
+ export const QUESTION_OUTCOME_FAULTS = Object.freeze(["unreadable", "both_arms", "neither_arm", "not_capturable"]);
11
+ export const QUESTION_OUTCOME_FAULT_TEXT = {
12
+ unreadable: "a member of the value threw when it was read",
13
+ both_arms: 'the value claims an answer and "unavailable" at once',
14
+ neither_arm: 'the value claims neither an answer nor "unavailable"',
15
+ not_capturable: "its answers are not plain data the engine can keep",
16
+ };
17
+ export class QuestionOutcomeUnreadableError extends Error {
18
+ fault;
19
+ constructor(fault) {
20
+ super(`the answer the question channel returned could not be read (${fault}: ${QUESTION_OUTCOME_FAULT_TEXT[fault]})`);
21
+ this.name = "QuestionOutcomeUnreadableError";
22
+ this.fault = fault;
23
+ }
24
+ }
10
25
  export function classifyQuestionOutcome(outcome) {
11
26
  let unavailable;
12
27
  let answers;
@@ -16,25 +31,25 @@ export function classifyQuestionOutcome(outcome) {
16
31
  answers = o?.answers;
17
32
  }
18
33
  catch {
19
- return { shape: "contradictory" };
34
+ return { shape: "contradictory", fault: "unreadable" };
20
35
  }
21
36
  const carriesAnswers = Array.isArray(answers);
22
37
  if (unavailable && carriesAnswers)
23
- return { shape: "contradictory" };
38
+ return { shape: "contradictory", fault: "both_arms" };
24
39
  if (unavailable)
25
40
  return { shape: "unavailable" };
26
41
  if (!carriesAnswers)
27
- return { shape: "contradictory" };
42
+ return { shape: "contradictory", fault: "neither_arm" };
28
43
  const captured = capturedJsonOf(answers, "list");
29
44
  if (!captured.ok)
30
- return { shape: "contradictory" };
45
+ return { shape: "contradictory", fault: "not_capturable" };
31
46
  return { shape: "answered", answer: { answers: captured.value } };
32
47
  }
33
48
  export function isQuestionUnavailable(outcome) {
34
49
  return classifyQuestionOutcome(outcome).shape === "unavailable";
35
50
  }
36
- const NO_HUMAN = "No human is available to answer right now. Proceed with your best judgment: pick the most reasonable " +
37
- "option, state the assumption you made, and continue.";
51
+ const PROCEED_ON_JUDGMENT = "Proceed with your best judgment: pick the most reasonable option, state the assumption you made, and continue.";
52
+ const NO_HUMAN = `No human is available to answer right now. ${PROCEED_ON_JUDGMENT}`;
38
53
  export function askQuestionContinuationCard(questionId, continuationSource, reason) {
39
54
  return {
40
55
  type: "ask-question",
@@ -203,7 +218,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
203
218
  }, ctx.signal);
204
219
  const reading = classifyQuestionOutcome(outcome);
205
220
  if (reading.shape === "contradictory") {
206
- throw new Error("the question channel returned a contradictory outcome (an unavailable answer)");
221
+ throw new QuestionOutcomeUnreadableError(reading.fault);
207
222
  }
208
223
  if (reading.shape === "unavailable") {
209
224
  if (redeemsApproval) {
@@ -254,7 +269,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
254
269
  }
255
270
  discloseSyntheticContinuation(ctx.toolCallId, "callback_failed");
256
271
  return {
257
- content: `${NO_HUMAN} (no answer was obtained: ${thrownText(e)})`,
272
+ content: thrownIs(e, QuestionOutcomeUnreadableError) ? `${e.message}, so no answer was obtained. ${PROCEED_ON_JUDGMENT}` : `${NO_HUMAN} (no answer was obtained: ${thrownText(e)})`,
258
273
  details: continuationCard(ctx.toolCallId, "synthetic_self_answer_instruction", "callback_failed"),
259
274
  };
260
275
  }
@@ -21,7 +21,7 @@
21
21
  *
22
22
  * Audience `"user"`: the refused work is the user's own (their run, or a delegation their run made), and
23
23
  * the recovery — a checkpoint store with a durable approval opt-in so such asks can wait for a person, or
24
- * a live approver reachable for delegated children — is a deployment posture the operator hears through
24
+ * a live approver reachable for delegated agents — is a deployment posture the operator hears through
25
25
  * the sink like every other code; the row only adds the session-stream projection so the person whose
26
26
  * call was refused sees WHY it did not run. `sessionId` is therefore REQUIRED at the mint (the routing
27
27
  * half of a user row). On a delegated leg it is the delegation tree's root — the session a person
@@ -70,7 +70,8 @@ export interface AskUnresolvableFacts {
70
70
  * the rule, and it is total over the closed set (a cause with no row is a red build: {@link CauseRemedySeatCoversEveryCause}).
71
71
  * The two causes that say NOBODY COULD BE ASKED take it — no approver is wired (`absent`: the clause says to wire one), or the
72
72
  * wired approver reported nobody reachable (`unavailable`: the clause says to make a person reachable through it, never to
73
- * wire what is wired): one fact, one sentence about the way out, whichever way nobody was there. The inherited-mandate cause
73
+ * wire what is wired — and the deny exit reads it as the `policy` clause when the wired approver is the deployment's approval
74
+ * policy, which is no person to make reachable): one fact, one sentence about the way out, whichever way nobody was there. The inherited-mandate cause
74
75
  * takes none (`undefined`): its recovery is a park facility on this leg, which neither a permission mode nor an `onAsk` here
75
76
  * supplies, so the remedy's arms would name a change that does not release the call. (The settlement-axis table
76
77
  * `SETTLEMENT_NOBODY_JUDGED` keeps `approver_unavailable` false because there a park route may still take the ask; this table is
@@ -5,6 +5,7 @@ const ASK_UNRESOLVABLE_CAUSE_SET = new Set(ASK_UNRESOLVABLE_CAUSES);
5
5
  export function isAskUnresolvableCause(v) {
6
6
  return ASK_UNRESOLVABLE_CAUSE_SET.has(v);
7
7
  }
8
+ const DELEGATED = "delegated agent";
8
9
  const CAUSE_CLAUSE = {
9
10
  approver_unavailable: "the approver reported that nobody is reachable for this ask",
10
11
  no_approver_wired: "nobody in this run can be asked to answer it — the headless posture",
@@ -55,9 +56,9 @@ export function askUnresolvableNotice(facts) {
55
56
  const park = parkLaneExisted ? "the durable approval park did not take it" : "no durable approval park is armed for this run";
56
57
  return {
57
58
  code: "delegation.ask_unresolvable",
58
- message: `approval for "${toolName}"${delegated ? " (a delegated agent's call)" : ""} could not be resolved: ${CAUSE_CLAUSE[cause]} and ${park} — ` +
59
+ message: `approval for "${toolName}"${delegated ? ` (a ${DELEGATED}'s call)` : ""} could not be resolved: ${CAUSE_CLAUSE[cause]} and ${park} — ` +
59
60
  `the call was denied fail-closed and did not run. ${typeof remedy === "string" && remedy.length > 0 ? `To let it run: ${remedy}. ` : ""}To let such approvals wait for a person, run with a checkpoint store and a ` +
60
- `durable approval opt-in (or a live approver reachable for delegated children).`,
61
+ `durable approval opt-in (or a live approver reachable for ${DELEGATED}s).`,
61
62
  detail: { sessionId, ...(delegated ? { sourceSessionId } : {}), ...(agentId !== undefined ? { agentId } : {}), toolName, toolCallId, cause, parkLaneExisted: parkLaneExisted === true, ...(typeof remedy === "string" && remedy.length > 0 ? { remedy } : {}), ...(remedyList !== undefined ? { remedies: remedyList } : {}) },
62
63
  };
63
64
  }
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Where a turn-boundary attachment comes from — one word of a closed set, the producer of one `<system-reminder>` block the
3
+ * runner delivers to the model at a turn boundary (a todo nudge, a changed-files notice, a listing, a delta …). The set is the
4
+ * attachment lane's vocabulary: the lane's delivery-class table (`ATTACHMENT_DELIVERY_CLASS`, in `runner/turn-attachments.ts`)
5
+ * is total over it, a frame receipt names one of its words, and the transcript row of a bundle message names the words of the
6
+ * attachments it carries ({@link BundledAttachment}). The `steering_injected` echo's `source` reads this set by name and spells,
7
+ * beside it, only the words no attachment-lane producer owns — so a word added here reaches the echo with no second edit, and a
8
+ * word is a member of this set or one of those, never both.
9
+ */
10
+ export declare const ATTACHMENT_SOURCES: readonly ["todo_reminder", "task_reminder", "tool_search_usage_reminder", "changed_files", "output_style", "date_change", "workflow_size_guideline_change", "budget_usd", "total_tokens_reminder", "background_tasks", "tools_delta", "mcp_unavailable", "agent_listing", "skills_listing", "mcp_instructions", "mcp_dropped_tools"];
11
+ export type AttachmentSource = (typeof ATTACHMENT_SOURCES)[number];
12
+ /** Membership test for {@link AttachmentSource}. */
13
+ export declare function isAttachmentSource(v: unknown): v is AttachmentSource;
14
+ /**
15
+ * One attachment of a bundle message, as its transcript row states it (`UserMessage.attachments`): the attachment's
16
+ * {@link AttachmentSource} and the length — in UTF-16 code units, the `.length` of the message text — of its framed block, the
17
+ * `<system-reminder>` block the message text holds for it (shell tags and body). The blocks sit in the text in the order of the
18
+ * list, one `"\n"` between neighbours and the first at offset 0, so a reader attributes any span of the text to a source by
19
+ * these lengths alone; whatever follows the last block (the post-tool-batch context block, when that rode the same message)
20
+ * belongs to none of them.
21
+ */
22
+ export interface BundledAttachment {
23
+ readonly source: AttachmentSource;
24
+ readonly chars: number;
25
+ }
26
+ /** The string that joins two framed blocks in a bundle message's text. */
27
+ export declare const BUNDLE_BLOCK_SEPARATOR = "\n";
28
+ /**
29
+ * THE composition of a bundle message: the framed blocks in order → the text they make and, per block, its source and its
30
+ * length in that text. The text and the lengths come from this one function, so a length can never describe a text it was not
31
+ * measured in. A reader of the lengths ({@link readBundledAttachments}) and a writer of the text agree on the separator
32
+ * through {@link BUNDLE_BLOCK_SEPARATOR}.
33
+ */
34
+ export declare function composeBundle(blocks: ReadonlyArray<{
35
+ readonly source: AttachmentSource;
36
+ readonly block: string;
37
+ }>): {
38
+ readonly text: string;
39
+ readonly attachments: readonly BundledAttachment[];
40
+ };
41
+ /**
42
+ * The one reading of a bundle message's `attachments` member (the mint and the session import door both call it): a non-empty
43
+ * list whose every entry names a member of {@link ATTACHMENT_SOURCES} and a non-negative integer length comes back as a fresh
44
+ * canonical copy (extra keys never enter a log); anything else — wrong type, an empty list, an unknown word, a length that is
45
+ * not a count, blocks that with their separators do not fit in the text (`textLength`, the length of the one text the message
46
+ * holds) — is `undefined`, the whole member is refused rather than half-kept. The relation it can check is the one the text
47
+ * leaves room for: the blocks start at offset 0 and sit one separator apart, so they take `Σ chars + (n − 1)` of the text and
48
+ * anything after the last block (a post-tool-batch context block) is the rest.
49
+ */
50
+ export declare function readBundledAttachments(raw: unknown, textLength: number): readonly BundledAttachment[] | undefined;
@@ -0,0 +1,46 @@
1
+ export const ATTACHMENT_SOURCES = Object.freeze([
2
+ "todo_reminder",
3
+ "task_reminder",
4
+ "tool_search_usage_reminder",
5
+ "changed_files",
6
+ "output_style",
7
+ "date_change",
8
+ "workflow_size_guideline_change",
9
+ "budget_usd",
10
+ "total_tokens_reminder",
11
+ "background_tasks",
12
+ "tools_delta",
13
+ "mcp_unavailable",
14
+ "agent_listing",
15
+ "skills_listing",
16
+ "mcp_instructions",
17
+ "mcp_dropped_tools",
18
+ ]);
19
+ const ATTACHMENT_SOURCE_SET = new Set(ATTACHMENT_SOURCES);
20
+ export function isAttachmentSource(v) {
21
+ return ATTACHMENT_SOURCE_SET.has(v);
22
+ }
23
+ export const BUNDLE_BLOCK_SEPARATOR = "\n";
24
+ export function composeBundle(blocks) {
25
+ return {
26
+ text: blocks.map((b) => b.block).join(BUNDLE_BLOCK_SEPARATOR),
27
+ attachments: blocks.map((b) => ({ source: b.source, chars: b.block.length })),
28
+ };
29
+ }
30
+ export function readBundledAttachments(raw, textLength) {
31
+ if (!Array.isArray(raw) || raw.length === 0)
32
+ return undefined;
33
+ const list = raw;
34
+ const out = [];
35
+ let spanned = (list.length - 1) * BUNDLE_BLOCK_SEPARATOR.length;
36
+ for (const item of list) {
37
+ if (item === null || typeof item !== "object")
38
+ return undefined;
39
+ const e = item;
40
+ if (!isAttachmentSource(e.source) || typeof e.chars !== "number" || !Number.isSafeInteger(e.chars) || e.chars < 0)
41
+ return undefined;
42
+ out.push({ source: e.source, chars: e.chars });
43
+ spanned += e.chars;
44
+ }
45
+ return spanned <= textLength ? out : undefined;
46
+ }
@@ -1,12 +1,12 @@
1
- import { type AgentMessage, type CompactionSettings, type Session, type ThinkingLevel } from "../internal/harness.js";
2
- import { type Message, type Model, type Tool } from "../internal/llm.js";
1
+ import { type AgentMessage, type CompactionSettings, type Session, type SessionRowExpectation, type ThinkingLevel } from "../internal/harness.js";
2
+ import { type Context, type Message, type Model, type Tool } from "../internal/llm.js";
3
3
  import type { ContextWindowOverlay } from "./context-settings.js";
4
4
  import type { PostCompactContext, PreCompactContext, PreCompactResult } from "./hooks.js";
5
5
  import type { TraceEvent } from "./trace.js";
6
6
  import type { Brain, ModelRef, TaskSpec } from "./types.js";
7
- import type { CompactOutcome, TaskEvent, TaskEventIdentity } from "./task-event.js";
7
+ import type { CompactOutcome, HumanInputAttachment, TaskEvent, TaskEventIdentity } from "./task-event.js";
8
8
  import type { CompactionEffect } from "./frame-settlement.js";
9
- import type { MintedAttachmentFrame } from "./user-attachment.js";
9
+ import { type MintedAttachmentFrame } from "./user-attachment.js";
10
10
  /**
11
11
  * Default summarization focus, applied when a task does not provide `compaction.instructions`.
12
12
  * Addresses the common fidelity failure where summaries drop specific facts.
@@ -51,6 +51,20 @@ export declare function isCompactionManualCancel(err: unknown): boolean;
51
51
  * the prompt-too-long recovery) for its trace frame and its `compaction_outcome{failed}` event: the thrown value's words through the
52
52
  * same-principal tier, THEN bounded — minted before the cut, so the cut can leave no part of a value. */
53
53
  export declare function compactionFailureReason(err: unknown): string;
54
+ /** The machine causes a failed pass's `compaction_outcome{failed}` frame names (its `cause`), as a value. Root-exported.
55
+ * `leaf_moved`: another writer moved the session's leaf while the pass ran, so the session's own leaf compare-and-set refused
56
+ * the summary record and nothing landed — the pass may be asked for again, over the branch as it is now. A failure with no
57
+ * word here carries no `cause` (its `reason` is the whole account).
58
+ *
59
+ * @contract compaction.failure_cause.capability — this set is the one fact a host reads to learn whether the engine it loaded
60
+ * names a failure cause: `COMPACTION_FAILURE_CAUSES.includes(word)`, read from the loaded package the way its version is
61
+ * read from `CONTRACT_KIT_ENGINE_VERSION`; there is no second version word, and a word the set lacks is never on a frame. */
62
+ export declare const COMPACTION_FAILURE_CAUSES: readonly ["leaf_moved"];
63
+ /** A word of {@link COMPACTION_FAILURE_CAUSES}. */
64
+ export type CompactionFailureCause = (typeof COMPACTION_FAILURE_CAUSES)[number];
65
+ /** The ONE reading of a failed pass's machine cause, beside its {@link compactionFailureReason} and read at the same sites: the session's
66
+ * leaf compare-and-set refusing a write of the pass is `leaf_moved`; anything else names no cause. */
67
+ export declare function compactionFailureCause(err: unknown): CompactionFailureCause | undefined;
54
68
  /**
55
69
  * design/145 §1/§3 — the window-safety decision surfaced to the caller BEFORE the summary call
56
70
  * (same pre-call posture as `onInputTruncated`: the disclosure must survive a later summary
@@ -106,6 +120,9 @@ export interface CompactionForkContext {
106
120
  /** The model id that served the recorded request — part of the provider cache key; the fork
107
121
  * eligibility gate refuses a snapshot from a different model (see the engine-side twin's doc). */
108
122
  modelId?: string;
123
+ /** The recorded request's locale of the engine's own texts (`Context.promptLocale`): a request built from the record
124
+ * (the fork, the advisor) carries it on. */
125
+ promptLocale?: Context["promptLocale"];
109
126
  }
110
127
  /**
111
128
  * What a compaction pass reports at the moment it commits ({@link MaybeCompactOptions.onStarted}) — and the
@@ -130,9 +147,57 @@ export interface CompactionRestoreAsk {
130
147
  readonly perFileChars: number;
131
148
  readonly totalChars: number;
132
149
  readonly charsPerToken: number;
133
- /** The reads the context the summary leaves still shows (canonical keys) — the restore dedups against them. */
134
- readonly preserveKeys: readonly string[];
135
150
  }
151
+ /** Which of the three autocompact-window fields the `??` precedence selected (see `resolveTriggerWindow`). */
152
+ export type TriggerWindowField = "autoCompactTokens" | "contextTokens" | "contextWindow";
153
+ /**
154
+ * A pass's report that its window is unusable: the size it DID manage to estimate, the field that decided
155
+ * the window, and that field's unusable value when it carried one.
156
+ */
157
+ export interface UnevaluableWindow {
158
+ estTokens: number;
159
+ /** WHICH of the three window fields the `??` precedence actually selected. A defined-but-unusable
160
+ * higher-precedence field (`autoCompactTokens: 0`) shadows a healthy lower one, so "no window is
161
+ * declared" is the wrong story on that path — the caller reports THIS field, not all three. */
162
+ windowField: TriggerWindowField;
163
+ /** The unusable value that field carried, when it carried one at all (absent = nothing declared). */
164
+ windowValue?: number;
165
+ modelId?: string;
166
+ }
167
+ /**
168
+ * How full the context is, and against what threshold. One pure measurement with three readers: the
169
+ * auto-compaction trigger, the `contextUsage` every `maybeCompact` return carries (the `context_usage`
170
+ * frame is built from it), and the per-turn read room (`runner/context-room.ts`). Same messages, model,
171
+ * overlay, settings and overhead ⇒ the same record. It never reads `settings.enabled`: a leg with
172
+ * compaction switched off still has a compaction point to measure against.
173
+ */
174
+ export interface ContextMeasure {
175
+ /** `shouldCompact`'s first argument: usage-anchored when the anchor is fresh, structural + overhead otherwise. */
176
+ readonly tokens: number;
177
+ /** The AUTOCOMPACT window (may be the unknown sentinel: non-finite or ≤ 0). */
178
+ readonly window: number;
179
+ readonly windowKnown: boolean;
180
+ readonly windowField: TriggerWindowField;
181
+ /** The settings repaired for this window (`sanitizeCompactionSettings`). */
182
+ readonly settings: CompactionSettings;
183
+ /** The structural coefficient every quantity here lives in. */
184
+ readonly charsPerToken: number;
185
+ /** Present exactly when the window is known: `usedTokens > compactAtTokens` is the trigger predicate. */
186
+ readonly contextUsage?: {
187
+ usedTokens: number;
188
+ windowTokens: number;
189
+ compactAtTokens: number;
190
+ };
191
+ }
192
+ export declare function measureContext(input: {
193
+ readonly messages: AgentMessage[];
194
+ readonly model: Model;
195
+ readonly contextOverlay?: ContextWindowOverlay;
196
+ readonly settings: CompactionSettings;
197
+ readonly overheadTokens?: number;
198
+ }): ContextMeasure;
199
+ /** The unevaluable-window record of a measurement whose window is unknown (`undefined` when it is known). */
200
+ export declare function unevaluableWindowOf(measure: ContextMeasure, model: Model): UnevaluableWindow | undefined;
136
201
  export interface MaybeCompactOptions {
137
202
  /** Disclosure channel for CONTAINED host-callback failures in this scope (the RB-463
138
203
  * isolation primitive's bounded first-failure per site). Absent ⇒ failures are counted only. */
@@ -312,11 +377,13 @@ export interface MaybeCompactOptions {
312
377
  * (`CompactionDetails.modifiedFilesByRecency`), else the alphabetical `modifiedFiles` of older details.
313
378
  */
314
379
  workingFileAttachments?: {
315
- /** Re-read the candidates and mint their frames — the engine's one read of a file for the model, deduplicated against
316
- * the context the summary leaves (`preserveKeys` = the reads that context still shows). Side-effect free: each frame
380
+ /** Re-read the candidates and mint their frames — the engine's one read of a file for the model, into the context the
381
+ * summary leaves (each frame carries the file's contents; a request sends them by its own copy projection). Side-effect free: each frame
317
382
  * carries the commit its delivery owes, run here once the frame is in the transcript. Wired by the Runner. */
318
383
  restore: (ask: CompactionRestoreAsk) => Promise<ReadonlyArray<MintedAttachmentFrame>>;
319
- /** A minted restore frame the transcript would not take (not delivered, nothing committed) — the operator's line. */
384
+ /** A fault that kept a file from the transcript — the restore threw (every candidate it was asked for), or the transcript
385
+ * would not take a minted frame (not delivered, nothing committed) — with its cause: the operator's line. What became of
386
+ * each frame, refusals included, is its record on `restoreOutcomes`; this hears only the faults. */
320
387
  undelivered?: (label: string, reason: string) => void;
321
388
  /** Max files to restore. Default 3. */
322
389
  maxFiles?: number;
@@ -331,13 +398,13 @@ export interface MaybeCompactOptions {
331
398
  */
332
399
  recentlyReadFiles?: () => string[];
333
400
  /**
334
- * RB-197② (CC `compact.ts:1415-1463` `shouldExcludeFromPostCompactRestore` parity): paths already
335
- * re-seeded through a DIFFERENT channel every turn (the deployment's declared instruction files —
336
- * `ProjectMemoryLoad.instructionSources`, e.g. a project/user CLAUDE.md) are excluded from the
337
- * `recentlyReadFiles`/fallback candidate set — re-attaching them here would just duplicate content
338
- * the system-prompt lane already carries. A plain path list, not a hardcoded filename: core still
339
- * never decides what counts as "an instruction file" on its own (types.ts's own seam rule) — it
340
- * only trusts what the deployment already declared.
401
+ * RB-197② (CC `compact.ts:1415-1463` `shouldExcludeFromPostCompactRestore` parity): paths a caller
402
+ * re-states through a DIFFERENT channel (e.g. its own instruction files) are excluded from the
403
+ * `recentlyReadFiles`/fallback candidate set — re-attaching them here would duplicate content that
404
+ * channel carries — and their read-state entries survive the clear. A plain path list, not a
405
+ * hardcoded filename. The Runner itself supplies none: its `restore` leaves its instruction-file lane's
406
+ * members out of whatever candidates it is handed (their entries retire with the summary and the lane
407
+ * states them again), so this seat is a library caller's.
341
408
  */
342
409
  instructionSourcePaths?: ReadonlyArray<string>;
343
410
  /**
@@ -355,18 +422,6 @@ export interface MaybeCompactOptions {
355
422
  * ALREADY in the same raw coordinate, so the fallback exact-string comparison is already correct.
356
423
  */
357
424
  normalizePath?: (raw: string) => Promise<string>;
358
- /**
359
- * A kept-tail Read tool-CALL's mere presence does not prove the
360
- * file's real content is visible there: its toolRESULT may be a dedup stub ("unchanged since you
361
- * last read it…") whose ORIGINAL full transmission sits in the summarized prefix THIS compaction is
362
- * about to cut away — preserving read-state for such a path would leave both the kept tail and the
363
- * next read pointing at content that is nowhere in context (RB-197①'s failure, reintroduced one hop
364
- * removed). Optional predicate (present exactly when the caller's Read tool actually emits a
365
- * recognizable stub marker) so `maybeCompact` can require at least one SUBSTANTIVE kept-tail Read
366
- * result before trusting a path as genuinely visible; absent ⇒ every non-error kept-tail Read is
367
- * trusted (the pre-this-fix behavior — still safe when the caller has no stub concept at all).
368
- */
369
- isDedupStubResult?: (resultText: string) => boolean;
370
425
  };
371
426
  /**
372
427
  * Fires ONCE per LANDED compaction (after `appendCompaction` committed the new baseline and the restore frames were
@@ -421,6 +476,10 @@ export interface MaybeCompactOptions {
421
476
  };
422
477
  land: () => Promise<void>;
423
478
  };
479
+ /** The instruction files' post-compaction restatement (the runner's `compactionRestateOptions`): runs right after
480
+ * `gitRestate.land`, under the same belt — the landed compaction retired the entries of the instruction frames it
481
+ * summarized away, and the task root's own (owed on every load) must be in context for the next request. */
482
+ instructionsRestate?: () => Promise<void>;
424
483
  /** The approval-posture directive's post-compaction restatement (the runner's `compactionRestateOptions`):
425
484
  * runs right after `gitRestate.land`, under the same belt and for the same reason — the compacted
426
485
  * context may have lost an engine frame the run still needs, and every reader of the new baseline
@@ -433,6 +492,9 @@ export interface MaybeCompactOptions {
433
492
  /** The advisor tool's instructions' post-compaction restatement on a leg that mounts the tool (the runner's
434
493
  * `compactionRestateOptions`): runs right after `postureRestate`, under the same belt, for the same reason. */
435
494
  advisorRestate?: () => Promise<void>;
495
+ /** The declared reply language's post-compaction restatement (`languageRestateOption`, the runner's `compactionRestateOptions`):
496
+ * runs right after `advisorRestate`, under the same belt, for the same reason. */
497
+ languageRestate?: () => Promise<void>;
436
498
  /**
437
499
  * Fixed per-request prompt overhead (system prompt + tool schemas, in tokens), applied ONLY in the
438
500
  * anchor-less regime (design/64 §26.7, search [91] fourth candidate): when no assistant in the
@@ -440,8 +502,22 @@ export interface MaybeCompactOptions {
440
502
  * chars/4 fallback counts MESSAGES only and is blind to this overhead — the threshold would compare
441
503
  * apples to oranges and under-trigger. When usage-anchored, the anchor IS the provider-billed input
442
504
  * (system+tools included), so the overhead is already in and this is not added.
505
+ * In every regime it is also the prefix size the pass judges before anything else: a prefix at or past the
506
+ * line makes a non-`force` pass return `windowBelowOverhead` without compacting. Absent ⇒ 0 (never judged so).
443
507
  */
444
508
  overheadTokens?: number;
509
+ /**
510
+ * The engine frames every landing states again (the runner's `compactionRestateOptions`): the texts a landing writes again
511
+ * (`protectedTexts` — the permission posture's text; `restatedTexts` — the git frame), with the task root's instruction
512
+ * frames the context holds, counted whole (`restatedFramesTokens`).
513
+ * The "window below overhead" judgment reads them as a floor beside {@link overheadTokens}: a landing posts them again, so
514
+ * a prefix plus these frames at or past the line cannot be compacted under it. `overheadTokens` keeps its meaning — the
515
+ * anchor-less trigger estimate never adds this floor (the frames are messages the estimate already counts). Absent ⇒ no floor.
516
+ */
517
+ restatedFrames?: {
518
+ readonly protectedTexts: readonly string[];
519
+ readonly restatedTexts: readonly string[];
520
+ };
445
521
  /**
446
522
  * design/84 Seam C — compact-boundary COST optimization (data-gated). Fidelity is already achieved by
447
523
  * the iterative-merge UPDATE_SUMMARY path (compaction.ts); the only remaining cost is one LLM call per
@@ -557,6 +633,29 @@ export interface MaybeCompactOptions {
557
633
  */
558
634
  activeTools?: ReadonlyArray<string>;
559
635
  }
636
+ /**
637
+ * The fixed request prefix (system prompt + tool schemas), with the engine frames every landing states again, is at or
638
+ * past the compaction line, so no summary can bring a request back under it: compaction shrinks conversation history and
639
+ * nothing else, and every landing would post over the line again. The numbers the judgment read, in the trigger's own
640
+ * coordinate (`compactAtTokens = windowTokens - reserveTokens`); `restatedTokens` (present when non-zero) is the frames'
641
+ * share of the floor.
642
+ */
643
+ export interface WindowBelowOverhead {
644
+ overheadTokens: number;
645
+ restatedTokens?: number;
646
+ compactAtTokens: number;
647
+ windowTokens: number;
648
+ reserveTokens: number;
649
+ }
650
+ /**
651
+ * The one judgment of "even a full compaction cannot get below the line": the window is known and the floor — the fixed
652
+ * overhead plus the frames every landing states again — meets or exceeds `window - reserve`. Undefined when the window is
653
+ * unknown (that state has its own report, `unevaluableWindow`) or when history still has room to shrink into.
654
+ */
655
+ export declare function windowBelowOverheadOf(overheadTokens: number, windowTokens: number, reserveTokens: number, restatedTokens?: number): WindowBelowOverhead | undefined;
656
+ /** The `compaction_outcome{outcome:"disabled"}` reason for {@link WindowBelowOverhead}: the word, then both numbers
657
+ * and the smallest window that would let compaction work with this floor and reserve. */
658
+ export declare function windowBelowOverheadReason(w: WindowBelowOverhead): string;
560
659
  /**
561
660
  * Compact the session in place when context usage exceeds the threshold.
562
661
  *
@@ -618,6 +717,9 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
618
717
  chars: number;
619
718
  truncated: boolean;
620
719
  }>;
720
+ /** What became of each restore frame, frame order — its attachment record (`human_input.attachments`' own projection); a
721
+ * frame the transcript did not take is `not_attached`. Set only when `compacted` is true and the restore minted a frame. */
722
+ restoreOutcomes?: HumanInputAttachment[];
621
723
  /** design/123 D4: true when the NATURAL gate fired (est ≥ max(threshold, minTokens) — no force was
622
724
  * needed); false on a forced landing (`force`/`forceUnderThreshold`). Set only when `compacted`. */
623
725
  naturalTrigger?: boolean;
@@ -650,6 +752,12 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
650
752
  estTokens: number;
651
753
  floor: number;
652
754
  };
755
+ /** Set (with `compacted:false`, no summary call made) when a pass that was not `force` met a fixed prefix at or past
756
+ * its line ({@link windowBelowOverheadOf}): the pass is not attempted, at this boundary or any later one, while the
757
+ * prefix stays that large. `force` passes (manual, the prompt-too-long recovery, the in-turn guard compaction)
758
+ * are not judged here — they answer an overflow, not the line. The caller bridges this to one
759
+ * `compaction_outcome{outcome:"disabled"}` per task. */
760
+ windowBelowOverhead?: WindowBelowOverhead;
653
761
  /**
654
762
  * Set (with `compacted:false`) when the trigger predicate could not be EVALUATED at all: the model
655
763
  * declares no usable autocompact window (non-finite or <= 0), so `shouldCompact` refuses on the
@@ -666,16 +774,7 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
666
774
  * usage anchor is available), so the disclosure can say how big the context already is even though
667
775
  * it cannot say how big the window is.
668
776
  */
669
- unevaluableWindow?: {
670
- estTokens: number;
671
- /** WHICH of the three window fields the `??` precedence actually selected. A defined-but-unusable
672
- * higher-precedence field (`autoCompactTokens: 0`) shadows a healthy lower one, so "no window is
673
- * declared" is the wrong story on that path — the caller reports THIS field, not all three. */
674
- windowField: "autoCompactTokens" | "contextTokens" | "contextWindow";
675
- /** The unusable value that field carried, when it carried one at all (absent = nothing declared). */
676
- windowValue?: number;
677
- modelId?: string;
678
- };
777
+ unevaluableWindow?: UnevaluableWindow;
679
778
  /**
680
779
  * The trigger inputs THIS pass used, reported on
681
780
  * EVERY return path — including the ordinary "nothing to do" one. A consumer rendering "how full is the
@@ -707,8 +806,8 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
707
806
  * ordinary truncation (disclosed, not silent). */
708
807
  clampReason?: "budget" | "tolerance";
709
808
  }>;
710
- /** What a landed compaction hands the wire frame. Structural, so both the full `maybeCompact` result
711
- * and the settle lane's narrower `EndOfTaskCompaction` satisfy it without either importing the other. */
809
+ /** What a landed compaction hands the wire frame. Structural, so the full `maybeCompact` result satisfies it; the settle
810
+ * lane's `EndOfTaskCompaction` is this type itself (plus `compacted`). */
712
811
  export interface CompactedFrameSource {
713
812
  /** The pass this landing concludes (see {@link MaybeCompactOptions.onStarted}). */
714
813
  pass?: string;
@@ -724,6 +823,7 @@ export interface CompactedFrameSource {
724
823
  chars: number;
725
824
  truncated: boolean;
726
825
  }>;
826
+ restoreOutcomes?: HumanInputAttachment[];
727
827
  modelFallback?: true;
728
828
  fallbackReason?: "window";
729
829
  clampedRatio?: number;
@@ -765,9 +865,20 @@ export interface CompactSessionRequest {
765
865
  compactionModel?: ModelRef;
766
866
  /** Per-model credentials (`TaskSpec.getApiKeyAndHeaders`). */
767
867
  getApiKeyAndHeaders?: TaskSpec["getApiKeyAndHeaders"];
868
+ /** The checkpoint store the session's runs park in, when a run named its own (`TaskSpec.checkpointStore`): the same three-valued
869
+ * seat, read by the same one resolver — a store wins, absent falls through to the deployment's `RunnerDeps.checkpointStore`, and
870
+ * `"disabled"` says the session has no store (no durable park to ask about). The pass's park check asks the store this names. */
871
+ checkpointStore?: TaskSpec["checkpointStore"];
768
872
  /** Withdraws the pass: aborted before the session's lock is taken, the answer is `"mooted"` with nothing done; while the pass
769
873
  * runs the summary call and the credential wait read it (store reads and appends, and the pre-flight's own 5 s timer, do not); a pass that already persisted is not undone. */
770
874
  signal?: AbortSignal;
875
+ /** The occupant the caller read the session as: `{ row: { owner, incarnation } }` (a `SessionHead` serves as `row`). The
876
+ * session the store holds under `sessionId` must still be that row — the same owner and occupant cell, judged by
877
+ * `sessionRowMatches` on the acquired session — or nothing is compacted and the answer is `resume.session_not_found`
878
+ * (it is not the session the caller meant: deleted and created again under the id, or another owner's). Only the row:
879
+ * `row: null` and `log` are refused at the request door (`compact.invalid_request`) — the session exists, and the pass
880
+ * binds its own leaf. Absent ⇒ any session under the id. */
881
+ expect?: SessionRowExpectation;
771
882
  }
772
883
  /** `Runner.compactSession`'s answer. */
773
884
  export interface CompactSessionResult {