@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,5 +1,6 @@
1
- import { convertToLlm, uuidv7 } from "../../internal/harness.js";
2
- import { compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
1
+ import { convertToLlm, leafIdAfterEntry, uuidv7 } from "../../internal/harness.js";
2
+ import { resolveCheckpointStore } from "../checkpoint-store.js";
3
+ import { compactionFailureCause, compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent } from "../auto-compaction.js";
3
4
  import { compactionSeatsDefect, contextOverlayFor } from "../context-settings.js";
4
5
  import { RETIRED_COMPACTION_SEAT_KEYS } from "../retired-keys.js";
5
6
  import { createRowSeat, promptCountOf } from "../mods/session-append.js";
@@ -10,33 +11,63 @@ import { resolveTaskModel } from "../roles.js";
10
11
  import { StoredSession } from "../session.js";
11
12
  import { emitTrace } from "../trace.js";
12
13
  import { egressThrownText } from "../untrusted-egress.js";
14
+ import { readElements, readMember } from "../thrown-value.js";
15
+ import { inlineUntrusted } from "../untrusted-text.js";
13
16
  import { emitInputTruncated, legCompactionSettings } from "./compaction-call-options.js";
14
17
  import { compactionHookOptions, summaryProviderOptions } from "./compaction-seams.js";
15
18
  import { compactionSummaryFallback, compactionSummaryIsDerived } from "./derived-route-fallback.js";
16
19
  import { resolveCompactionModel } from "./prepare-config-doors.js";
17
20
  import { compactionActivationSnapshot } from "./prepare-tool-disclosure-mount.js";
18
21
  import { derivedLegBrain, sideCallBookOf } from "./side-call-account.js";
19
- import { acquireExistingSession, claimIdleSession, readPlainRequest, shownValue } from "./session-verb-doors.js";
22
+ import { createModelFallbackSeat } from "./model-fallback-seat.js";
23
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
24
+ import { projectRequestCopies } from "../request-copy-projection.js";
25
+ import { acquireExistingSession, claimIdleSession, readOccupantExpectation, readPlainRequest, shownValue } from "./session-verb-doors.js";
20
26
  const VERB = "Runner.compactSession";
21
- const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "signal"]);
27
+ const REQUEST_KEYS = new Set(["sessionId", "model", "instructions", "compaction", "compactionModel", "getApiKeyAndHeaders", "checkpointStore", "signal", "expect"]);
22
28
  const SETTINGS_KEYS = new Set(["manualCompact", "reserveTokens", "keepRecentTokens", "instructions", "clampTolerance", ...Object.keys(RETIRED_COMPACTION_SEAT_KEYS)]);
23
29
  export async function compactIdleSession(seats, request) {
24
30
  const req = screenCompactSessionRequest(request);
25
31
  const { deps } = seats;
26
32
  const resolved = resolveTaskModel({ model: req.model }, deps);
27
33
  const named = resolveCompactionModel(req.compactionModel !== undefined ? { compactionModel: req.compactionModel } : {}, deps, "compactSession.compactionModel");
34
+ const store = resolveCheckpointStore(req.checkpointStore !== undefined ? { checkpointStore: req.checkpointStore } : {}, deps);
28
35
  if (req.signal?.aborted === true)
29
36
  return { outcome: "mooted", events: [] };
30
37
  const release = await claimIdleSession(seats, req.sessionId, () => sessionBusyRefusal(req.sessionId));
38
+ let legMods;
31
39
  try {
32
- const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted");
33
- const legMods = await admitLegMods({ spec: {}, deps, sessionId: req.sessionId });
34
- return await compactOnSession(req, deps, new StoredSession(acquired.session.getStorage()), resolved, named, legMods);
40
+ const acquired = await acquireExistingSession(seats.sessions, req.sessionId, VERB, "nothing was compacted", req.expect);
41
+ await refuseParkedSession(store, req.sessionId, req.checkpointStore !== undefined ? "the request's" : "the deployment's");
42
+ legMods = await admitLegMods({ spec: {}, deps, sessionId: req.sessionId });
43
+ return await compactOnSession(req, deps, new StoredSession(pinnedToLeaf(acquired.session.getStorage())), resolved, named, legMods);
35
44
  }
36
45
  finally {
46
+ legMods?.end();
37
47
  release();
38
48
  }
39
49
  }
50
+ function pinnedToLeaf(storage) {
51
+ let pinned;
52
+ return new Proxy(storage, {
53
+ get(target, prop, receiver) {
54
+ if (prop === "getLeafId")
55
+ return () => (pinned ??= target.getLeafId());
56
+ if (prop === "appendEntry")
57
+ return async (entry, opts) => {
58
+ await target.appendEntry(entry, opts);
59
+ pinned = Promise.resolve(leafIdAfterEntry(entry));
60
+ };
61
+ if (prop === "setLeafId")
62
+ return async (leafId, opts) => {
63
+ await target.setLeafId(leafId, opts);
64
+ pinned = Promise.resolve(leafId);
65
+ };
66
+ const value = Reflect.get(target, prop, receiver);
67
+ return typeof value === "function" ? value.bind(target) : value;
68
+ },
69
+ });
70
+ }
40
71
  async function compactOnSession(req, deps, session, resolved, named, legMods) {
41
72
  const { sessionId } = req;
42
73
  const events = [];
@@ -44,7 +75,8 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
44
75
  const passReport = compactionPassReport({ push: (e) => events.push(e) }, ident);
45
76
  const stats = { turns: 0, tokens: 0, toolCalls: 0, promptTokens: 0, totalInputTokens: 0, cachedTokens: 0, cacheWriteTokens: 0, cacheWriteTokensLong: 0, outputTokens: 0, costMicroUsd: 0 };
46
77
  const telemetry = { unpricedSpend: false, tracer: deps.tracer, taskId: sessionId };
47
- const accountBook = sideCallBookOf(stats, { telemetry, pricing: () => deps.pricing, noteUnevaluablePriceTable: (p) => void (malformedPricingField(p) !== undefined && (telemetry.unpricedSpend = true)), catalog: deps.models });
78
+ const fallbackSeat = createModelFallbackSeat(deps.onNotice, { sessionId });
79
+ const accountBook = sideCallBookOf(stats, { telemetry, pricing: () => deps.pricing, noteUnevaluablePriceTable: (p) => void (malformedPricingField(p) !== undefined && (telemetry.unpricedSpend = true)), noteFallback: (lane, requested, reading) => fallbackSeat.observe(lane, requested, reading) });
48
80
  let calls = 0;
49
81
  const book = (lane, model, reply) => {
50
82
  calls += 1;
@@ -71,9 +103,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
71
103
  });
72
104
  const trace = deps.tracer;
73
105
  try {
74
- const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: deps.brain, getApiKeyAndHeaders: req.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId }) : named;
106
+ const compactionModel = compactionSummaryIsDerived(req.compactionModel !== undefined, named) ? await compactionSummaryFallback({ derived: named, primary: resolved.model, brain: modelLaneBrainOf(deps), getApiKeyAndHeaders: req.getApiKeyAndHeaders, onNotice: deps.onNotice, sessionId }) : named;
75
107
  const branch = await session.getBranch();
76
- const contextMessages = convertToLlm((await session.buildContext()).messages);
108
+ const contextMessages = projectRequestCopies(convertToLlm((await session.buildContext()).messages));
77
109
  bindSessionFacade(legMods, { deps, req, model: resolved.model, messages: contextMessages, book, turns: async () => promptCountOf(await session.getBranch()) });
78
110
  const rowSeat = createRowSeat();
79
111
  rowSeat.bind({ bus: legMods.bus, identity: undefined, report: legMods.report });
@@ -88,7 +120,7 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
88
120
  model: resolved.model,
89
121
  ...(overlay !== undefined ? { contextOverlay: overlay } : {}),
90
122
  ...(compactionModel !== undefined ? { compactionModel } : {}),
91
- brain: derivedLegBrain(() => deps.brain, "compaction", book),
123
+ brain: derivedLegBrain(() => modelLaneBrainOf(deps), "compaction", book),
92
124
  ...(req.getApiKeyAndHeaders !== undefined ? { getApiKeyAndHeaders: req.getApiKeyAndHeaders } : {}),
93
125
  ...(thinking !== undefined ? { thinking } : {}),
94
126
  settings: legCompactionSettings(req.compaction !== undefined ? { compaction: req.compaction } : {}, overlay, "manualCompact"),
@@ -124,8 +156,9 @@ async function compactOnSession(req, deps, session, resolved, named, legMods) {
124
156
  }
125
157
  deps.onError?.(asError(err), { phase: "compaction", sessionId });
126
158
  const reason = compactionFailureReason(err);
159
+ const cause = compactionFailureCause(err);
127
160
  emitTrace(trace, () => ({ kind: "compaction.failed", version: 1, taskId: sessionId, trigger: "manual", reason, ts: Date.now() }));
128
- events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...passReport.end, ...ident() });
161
+ events.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason, ...(cause !== undefined ? { cause } : {}), ...passReport.end, ...ident() });
129
162
  return answer("failed");
130
163
  }
131
164
  }
@@ -146,6 +179,7 @@ function bindSessionFacade(legMods, input) {
146
179
  agentSessions: undefined,
147
180
  turns: input.turns,
148
181
  measure: {},
182
+ turnAbort: {},
149
183
  activeTools: new Set(),
150
184
  agentListing: undefined,
151
185
  book: (answeredBy, reply) => input.book("mod", answeredBy, reply),
@@ -162,6 +196,7 @@ function bindSessionFacade(legMods, input) {
162
196
  root: () => unavailable("session.root"),
163
197
  tools: () => unavailable("tool.list"),
164
198
  agents: () => unavailable("agent.list"),
199
+ turnAbort: () => unavailable("turn.abort"),
165
200
  });
166
201
  }
167
202
  function asError(err) {
@@ -169,11 +204,11 @@ function asError(err) {
169
204
  }
170
205
  function screenCompactSessionRequest(request) {
171
206
  const bad = (what) => {
172
- const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, signal? }.`);
207
+ const e = new Error(`${VERB}: ${what} — nothing was compacted. The request is { sessionId, model, instructions?, compaction?, compactionModel?, getApiKeyAndHeaders?, checkpointStore?, signal?, expect? }.`);
173
208
  e.code = "compact.invalid_request";
174
209
  throw e;
175
210
  };
176
- const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, signal } = readPlainRequest(request, REQUEST_KEYS, bad);
211
+ const { sessionId, model, instructions, compaction, compactionModel, getApiKeyAndHeaders, checkpointStore, signal, expect } = readPlainRequest(request, REQUEST_KEYS, bad);
177
212
  if (typeof sessionId !== "string" || sessionId === "")
178
213
  return bad(`sessionId must be a non-empty string, got ${shownValue(sessionId)}`);
179
214
  if (model === undefined)
@@ -191,7 +226,9 @@ function screenCompactSessionRequest(request) {
191
226
  compaction: compaction === undefined ? undefined : screenSettings(compaction, bad),
192
227
  compactionModel: compactionModel,
193
228
  getApiKeyAndHeaders: getApiKeyAndHeaders,
229
+ checkpointStore: checkpointStore,
194
230
  signal,
231
+ expect: readOccupantExpectation(expect, bad),
195
232
  };
196
233
  }
197
234
  function screenSettings(raw, bad) {
@@ -214,6 +251,39 @@ function screenSettings(raw, bad) {
214
251
  ...(clampTolerance !== undefined ? { clampTolerance: clampTolerance } : {}),
215
252
  };
216
253
  }
254
+ async function refuseParkedSession(store, sessionId, whose) {
255
+ if (store === undefined)
256
+ return;
257
+ const parked = (why, cause) => {
258
+ const e = new Error(`${VERB}: ${why} — a parked session's resume rewinds its branch to the checkpoint's leaf, where a summary written now would not be read, so nothing was compacted; decide the checkpoint (resume it) or expire it, then compact`, cause !== undefined ? { cause } : undefined);
259
+ e.code = "compact.session_parked";
260
+ throw e;
261
+ };
262
+ if (typeof store.listBySession !== "function")
263
+ return parked(`${whose} checkpoint store has no listBySession, so it cannot say whether session "${sessionId}" is parked at a checkpoint`);
264
+ let answer;
265
+ try {
266
+ answer = await store.listBySession({ sessionId, status: "pending", limit: 1 });
267
+ }
268
+ catch (err) {
269
+ return parked(`${whose} checkpoint store could not say whether session "${sessionId}" is parked at a checkpoint (listBySession failed: ${egressThrownText("same-principal", err)})`, err);
270
+ }
271
+ const unanswered = (what) => parked(`${whose} checkpoint store answered ${what}, so it cannot say whether session "${sessionId}" is parked at a checkpoint`, new Error(`listBySession answered ${what}`));
272
+ const rows = readElements(readMember(answer, "rows"));
273
+ if (rows === undefined)
274
+ return unanswered("without a list of rows");
275
+ if (rows.length === 0)
276
+ return;
277
+ const row = rows[0];
278
+ const kind = readMember(row, "kind");
279
+ const checkpoint = kind === "row" ? readMember(row, "checkpoint") : undefined;
280
+ const token = kind === "row" ? readMember(checkpoint, "token") : kind === "unreadable" ? readMember(row, "token") : undefined;
281
+ if (typeof token !== "string" || token === "")
282
+ return unanswered("a first row that is no checkpoint row with a token");
283
+ const id = readMember(checkpoint, "checkpointId");
284
+ const named = typeof id === "string" && id.trim() !== "" ? `checkpoint "${inlineUntrusted(id, 64)}"` : "a checkpoint";
285
+ return parked(`session "${sessionId}" is parked at ${named}, which is pending`);
286
+ }
217
287
  function sessionBusyRefusal(sessionId) {
218
288
  const e = new Error(`${VERB}: a task is running or queued on session "${sessionId}" in this Runner, or a write one of its tasks issued has not settled — compacting it now would rewrite the transcript under that work, so nothing was compacted; a running task takes the request through its own stream (TaskStream.compact), otherwise retry once it has ended and its writes have settled`);
219
289
  e.code = "compact.session_busy";
@@ -32,35 +32,6 @@ import { type CompactionSettings } from "../../internal/harness.js";
32
32
  * task has no hands (no `compactionRestore` ⇒ nothing can be re-read).
33
33
  */
34
34
  export declare function buildWorkingFileAttachments(spec: TaskSpec, prepared: Prepared): MaybeCompactOptions["workingFileAttachments"];
35
- /**
36
- * `MaybeCompactOptions.contextInstructionFiles`: the deployment's instruction-file content (the CLAUDE.md
37
- * family) delivered to the SUMMARIZER, assembled once here and spread on all three lanes — the compaction
38
- * boundary is where the summary REPLACES the transcript that carried those instructions.
39
- *
40
- * Contract:
41
- * - Bytes = `Prepared.projectInstructionContent`, the RAW loader text captured under the same non-blank
42
- * predicate that composes the project layer. Not the assembled `memoryBlock` (model-authored in-band
43
- * bytes would gain an instructing envelope), not the COMPOSED project block (`contextInstructionFilesSection`
44
- * neutralizes the whole authority family, `user_memory`/`scope` included), not `instructionSources`
45
- * (path + hash only). Raw text in, one fence at the mint.
46
- * - Provenance: REPOSITORY-CONTROLLED text delivered through a host callback — delivery is not authorship;
47
- * the mint's neutralization stops tag breakout, not a sentence asking for an omission. Two no-code exits
48
- * for a deployment that does not want it: do not wire the loader, or return vouched content. A separate
49
- * deployment-vouched summarization-instructions seat is an open design candidate, not built here.
50
- * - Both summary forms, no per-form split: fork eligibility is decided per pass inside maybeCompact, and the
51
- * form NOT covered by a `compModel`-gated split is exactly the fork that degrades mid-pass to the
52
- * independent form; the section rides the APPENDED instruction message, never the cached prefix.
53
- * - No new size knob: the bound is `fitContextInstructionFilesSection` (independent form only). Its three
54
- * known limits are accepted knowingly: a token-dense payload can pass a chars-domain fit and still overflow;
55
- * an unknown `contextWindow` leaves the section unbounded; the FORK form cannot fit and degrades ONCE. When
56
- * a limit bites the boundary FAILS (the section is a fixed request part the retry loop cannot drop) — the
57
- * task loses that compaction rather than sending a shorter one; making the section participate in the
58
- * retry loop is a library-face contract change, tracked there.
59
- * - Cost: instruction-file content + exactly 716 chars of framing on every summarization request, both
60
- * forms, once per pass (pinned in the REF-A2 suite). Deployments that never wired the loader pay nothing:
61
- * the key is ABSENT, so their requests are byte-identical to the pre-wiring shape.
62
- */
63
- export declare function contextInstructionFilesOption(prepared: Prepared): Partial<Pick<MaybeCompactOptions, "contextInstructionFiles">>;
64
35
  /**
65
36
  * The CC-form fork seam, assembled identically on all three lanes (REF-A2): the
66
37
  * summary request forks the main lane's latest real request (recorded by prepare-task's provider
@@ -164,5 +135,7 @@ export declare function legContextOverlayOption(prepared: Prepared, runner: Runn
164
135
  * for the boundary's own pass, the recovery pass and the end-of-task summary, `manualCompact` for a requested one —
165
136
  * keeps "who decides whether this pass runs" a single expression ({@link compactionEnabled}: the request authored the
166
137
  * seat > the deployment declared it > on). The two seats themselves do not ride the settings: the pass reads its gate.
138
+ * The reserve follows the same law ({@link compactionReserve}: the request's value > the overlay's for the leg's model > the
139
+ * engine default), and the disclosures that estimate the threshold read it through this function too.
167
140
  */
168
141
  export declare function legCompactionSettings(spec: Pick<TaskSpec, "compaction">, overlay: ContextWindowOverlay | undefined, seat: CompactionSeat): CompactionSettings;
@@ -1,6 +1,6 @@
1
1
  import { emitTrace } from "../trace.js";
2
2
  import { buildToolResultRef, OFFLOAD_TOOL_NAME, PERSISTED_OUTPUT_PREFIX, toolResultContentSegment, toolResultProvenanceOf, } from "../tool-result-store.js";
3
- import { compactionEnabled, contextOverlayFor } from "../context-settings.js";
3
+ import { compactionEnabled, compactionReserve, contextOverlayFor } from "../context-settings.js";
4
4
  import { DEFAULT_COMPACTION_SETTINGS } from "../../internal/harness.js";
5
5
  export function buildWorkingFileAttachments(spec, prepared) {
6
6
  if (spec.compaction?.attachWorkingFiles === false || !prepared.compactionRestore)
@@ -9,16 +9,9 @@ export function buildWorkingFileAttachments(spec, prepared) {
9
9
  ...prepared.compactionRestore,
10
10
  ...(prepared.recentlyReadFiles ? { recentlyReadFiles: prepared.recentlyReadFiles } : {}),
11
11
  ...(prepared.normalizeAttachmentPath ? { normalizePath: prepared.normalizeAttachmentPath } : {}),
12
- ...(prepared.isDedupStubResult ? { isDedupStubResult: prepared.isDedupStubResult } : {}),
13
- ...(prepared.instructionSources
14
- ? { instructionSourcePaths: prepared.instructionSources.filter((s) => s.contentHash !== null).map((s) => s.path) }
15
- : {}),
16
12
  ...(typeof spec.compaction?.attachWorkingFiles === "object" ? spec.compaction.attachWorkingFiles : undefined),
17
13
  };
18
14
  }
19
- export function contextInstructionFilesOption(prepared) {
20
- return prepared.projectInstructionContent !== undefined ? { contextInstructionFiles: prepared.projectInstructionContent } : {};
21
- }
22
15
  export function forkContextOption(prepared, disable) {
23
16
  return disable ? {} : { forkContext: prepared.lastBrainContext };
24
17
  }
@@ -123,5 +116,5 @@ export function legContextOverlayOption(prepared, runner) {
123
116
  }
124
117
  export function legCompactionSettings(spec, overlay, seat) {
125
118
  const { autoCompact: _auto, manualCompact: _manual, ...members } = spec.compaction ?? {};
126
- return { ...DEFAULT_COMPACTION_SETTINGS, ...members, enabled: compactionEnabled(seat, spec.compaction, overlay) };
119
+ return { ...DEFAULT_COMPACTION_SETTINGS, ...members, reserveTokens: compactionReserve(members.reserveTokens, overlay) ?? DEFAULT_COMPACTION_SETTINGS.reserveTokens, enabled: compactionEnabled(seat, spec.compaction, overlay) };
127
120
  }
@@ -1,6 +1,7 @@
1
1
  import type { MaybeCompactOptions } from "../auto-compaction.js";
2
2
  import { type PostureFacts } from "../auto-mode-directive.js";
3
3
  import type { Prepared } from "./contracts.js";
4
+ import { type InstructionEcho } from "./nested-memory-lane.js";
4
5
  /**
5
6
  * The facts the posture composition reads, as the leg IS now: the live effective mode and ask answer, the plan-exit
6
7
  * tool's presence on the minted roster, the minted delegation identity, and the session plan file the run admitted. The one place a leg's facts are assembled —
@@ -42,6 +43,13 @@ export declare function mintOutputStyleReminder(prepared: Pick<Prepared, "output
42
43
  /** Is a frame of this source already on its way to the next request (a pending receipt)? The one reading, for every
43
44
  * collector that could state it again: the boundary bundle, the direct-write style lane and the posture writer. */
44
45
  export declare function frameCarried(ledger: Prepared["frameReceipts"], source: Prepared["frameReceipts"]["pending"][number]["source"]): boolean;
46
+ /**
47
+ * Settle the receipts a landed message carries, in receipt order. A step that must read the session first (a changed-files notice's
48
+ * announcement) returns a promise: the steps behind it wait for it, and the one promise is handed back to the `message_end` handler
49
+ * (the harness awaits its listeners), so every announcement lands before the next listener reads the event. `undefined` when every
50
+ * step was synchronous.
51
+ */
52
+ export declare function settleFrameReceipts(settled: ReadonlyArray<Prepared["frameReceipts"]["pending"][number]>, entryId: string): Promise<void> | undefined;
45
53
  /**
46
54
  * The turn boundary's direct writes, for a boundary a request can follow: the owed posture, and the output style when
47
55
  * the turn's tool results do not go back as the next request (`turnOwesRequest` false) and queued input already
@@ -59,5 +67,13 @@ export declare function appendBoundaryFrames(prepared: Pick<Prepared, "approvalP
59
67
  * and never fails the landed compaction.
60
68
  */
61
69
  export declare function planFileRestateOption(prepared: Prepared): Pick<MaybeCompactOptions, "planFileRestate">;
62
- /** Every post-compaction restatement the turn boundary registers, at one spread site. */
63
- export declare function compactionRestateOptions(prepared: Prepared): Pick<MaybeCompactOptions, "gitRestate" | "postureRestate" | "planFileRestate" | "advisorRestate">;
70
+ /** The instruction files' compaction arm (`restateInstructionFiles`): a leg with the instruction-file lane writes what the
71
+ * compacted context owes — the task root's members first — before any reader of the new baseline. It keeps the posture's
72
+ * halt rule (a person's bare rejection halted the batch: nothing the engine says enters the transcript ahead of that
73
+ * person's next words; the next load owes the files again). */
74
+ export declare function instructionsRestateOption(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "instructionsRestate">;
75
+ /** Every post-compaction restatement the three compaction routes register, at one spread site, and the frames those
76
+ * restatements post again (`restatedFrames`: the floor the trigger's "window below overhead" judgment reads beside the
77
+ * prefix — the request core's engine frames, the one set the guard trim holds); `echo` is the run's echo of a restated
78
+ * instruction frame. */
79
+ export declare function compactionRestateOptions(prepared: Prepared, echo: InstructionEcho): Pick<MaybeCompactOptions, "gitRestate" | "instructionsRestate" | "postureRestate" | "planFileRestate" | "advisorRestate" | "languageRestate" | "restatedFrames">;
@@ -6,9 +6,11 @@ import { thrownText } from "../thrown-value.js";
6
6
  import { rosterEntryNamed } from "../tool-roster.js";
7
7
  import { delimitUntrusted, sanitizeUntrustedText } from "../untrusted-text.js";
8
8
  import { appendAdvisorRestate } from "./advisor-instructions.js";
9
+ import { languageRestateOption } from "./language-frame.js";
9
10
  import { appendAdmittedRow } from "../row-admission.js";
10
11
  import { gitRestateOption } from "./git-leg-delivery.js";
11
12
  import { attachmentEnvelopeTags } from "./turn-attachments.js";
13
+ import { restateInstructionFiles } from "./nested-memory-lane.js";
12
14
  export function postureFactsOf(prepared) {
13
15
  return {
14
16
  mode: prepared.approvalPosture.mode,
@@ -97,6 +99,16 @@ async function appendOutputStyleRestate(prepared) {
97
99
  export function frameCarried(ledger, source) {
98
100
  return ledger.pending.some((r) => r.source === source);
99
101
  }
102
+ export function settleFrameReceipts(settled, entryId) {
103
+ let owed;
104
+ for (const r of settled) {
105
+ const step = () => r.commit(entryId);
106
+ const done = owed === undefined ? step() : owed.then(step);
107
+ if (done instanceof Promise)
108
+ owed = done;
109
+ }
110
+ return owed;
111
+ }
100
112
  export function appendBoundaryFrames(prepared, turnOwesRequest) {
101
113
  const styleOwed = prepared.outputStyleFrame !== undefined && !turnOwesRequest && prepared.batchHaltRef.current === undefined && !frameCarried(prepared.frameReceipts, "output_style") && prepared.harness.pendingInjectionCount() > 0;
102
114
  const posture = appendOwedPosture(prepared, "on_change");
@@ -126,6 +138,28 @@ export function planFileRestateOption(prepared) {
126
138
  },
127
139
  };
128
140
  }
129
- export function compactionRestateOptions(prepared) {
130
- return { ...gitRestateOption(prepared), ...postureRestateOption(prepared), ...planFileRestateOption(prepared), ...(prepared.advisorInstruction?.mounted === true ? { advisorRestate: () => appendAdvisorRestate(prepared) } : {}) };
141
+ export function instructionsRestateOption(prepared, echo) {
142
+ const lane = prepared.nestedMemory;
143
+ if (lane === undefined)
144
+ return {};
145
+ return {
146
+ instructionsRestate: async () => {
147
+ if (prepared.batchHaltRef.current !== undefined)
148
+ return;
149
+ await restateInstructionFiles(lane, { session: prepared.session, admitRows: prepared.admitRows, ...(prepared.postureFrameRef.report !== undefined ? { report: prepared.postureFrameRef.report } : {}) }, echo);
150
+ },
151
+ };
152
+ }
153
+ export function compactionRestateOptions(prepared, echo) {
154
+ const posture = prepared.postureFrameRef.protectedText;
155
+ const git = prepared.gitStatusRef.protectedText;
156
+ return {
157
+ ...gitRestateOption(prepared),
158
+ ...instructionsRestateOption(prepared, echo),
159
+ ...postureRestateOption(prepared),
160
+ ...planFileRestateOption(prepared),
161
+ ...(prepared.advisorInstruction?.mounted === true ? { advisorRestate: () => appendAdvisorRestate(prepared) } : {}),
162
+ ...languageRestateOption(prepared),
163
+ restatedFrames: { protectedTexts: posture !== undefined ? [posture] : [], restatedTexts: git !== undefined ? [git] : [] },
164
+ };
131
165
  }
@@ -7,6 +7,9 @@ import { copyReadDenySeat, READ_DENY_DEPLOYMENT_SEATS } from "../read-face-seats
7
7
  import { receiveHostFloor } from "../host-floor.js";
8
8
  import { holdOwnCredentialValues } from "../secret-env.js";
9
9
  import { receivePeerSeat } from "../peer-seat.js";
10
+ import { receiveProtocolRevocations } from "../protocol-revocation.js";
11
+ import { receiveModelFallbackPolicy } from "../model-fallbacks.js";
12
+ import { receiveCacheRetention } from "./model-lane-seat.js";
10
13
  export function retainRunnerDeps(deps) {
11
14
  const words = { subject: "RunnerDeps", unit: "seat", moment: "at new Runner" };
12
15
  refuseProxy(deps, words);
@@ -23,6 +26,11 @@ export function retainRunnerDeps(deps) {
23
26
  Object.defineProperty(retained, "hostFloor", { value: receiveHostFloor(Reflect.get(retained, "hostFloor")), enumerable: true, writable: true, configurable: true });
24
27
  if (Object.hasOwn(retained, "peerSeat"))
25
28
  Object.defineProperty(retained, "peerSeat", { value: receivePeerSeat(Reflect.get(retained, "peerSeat"), "RunnerDeps.peerSeat"), enumerable: true, writable: true, configurable: true });
29
+ if (Object.hasOwn(retained, "protocolRevocations"))
30
+ Object.defineProperty(retained, "protocolRevocations", { value: receiveProtocolRevocations(Reflect.get(retained, "protocolRevocations"), "RunnerDeps.protocolRevocations"), enumerable: true, writable: true, configurable: true });
31
+ if (Object.hasOwn(retained, "modelFallback"))
32
+ Object.defineProperty(retained, "modelFallback", { value: receiveModelFallbackPolicy(Reflect.get(retained, "modelFallback"), "RunnerDeps.modelFallback"), enumerable: true, writable: true, configurable: true });
33
+ receiveCacheRetention(retained.cacheRetention, "RunnerDeps.cacheRetention");
26
34
  let consolidationKey;
27
35
  try {
28
36
  const chat = retained.memoryConsolidationDriver?.chat;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * The leg's context room: how many more tokens one model reply's tool calls may still pull into the
3
+ * context before it crosses the compaction point. Read's `allow_large` raises its size limits up to this
4
+ * room, and books what it served against it, so two raised reads in the same reply share one budget.
5
+ *
6
+ * One seat per leg. `open(toolCallId)` snapshots the conversation once and finds the assistant message
7
+ * that issued the call (its parent); the ledger is keyed by that message, so a new reply starts a new
8
+ * ledger. The room of a call is
9
+ *
10
+ * max(0, floor((compactAt − (held + pending)) × 0.7))
11
+ *
12
+ * where `compactAt` is the leg's compaction point (the autocompact window minus the repaired reserve —
13
+ * read whether or not compaction is switched on), `held` is the larger of the parent message's billed
14
+ * usage and the measured occupancy of the whole context (the same `measureContext` the compaction trigger
15
+ * reads), and `pending` is what raised reads of this reply booked whose results the snapshot does not yet
16
+ * hold. A result already in the context is counted once, inside `held`; one still in flight is counted
17
+ * once, in `pending` — so a ledger lost with a process restart loses nothing the context does not
18
+ * already show.
19
+ *
20
+ * No room (`undefined`): the call has no parent assistant message in the session (a host-issued call), or
21
+ * the window is unknown — the latter is reported once through `onNoWindow`.
22
+ */
23
+ import { type AgentMessage, type CompactionSettings } from "../../internal/harness.js";
24
+ import type { Model } from "../../internal/llm.js";
25
+ import { type UnevaluableWindow } from "../auto-compaction.js";
26
+ import type { ContextWindowOverlay } from "../context-settings.js";
27
+ /** The share of the measured headroom a read may take (the rest is left for the reply that reads it). */
28
+ export declare const CONTEXT_ROOM_SHARE = 0.7;
29
+ /** One tool call's view of the room. `room()` and `claim()` are synchronous: a read rechecks and books with no await between. */
30
+ export interface ContextRoomTicket {
31
+ /** The room this call may still take, as of now. */
32
+ room(): number;
33
+ /** Book `tokens` this call served against the reply's room. */
34
+ claim(tokens: number): void;
35
+ /** The model's characters-per-token coefficient the room was measured with (the read side measures with the same one). */
36
+ readonly charsPerToken: number;
37
+ }
38
+ export interface ContextRoomSeat {
39
+ /** This call's ticket on its reply's ledger; `undefined` = there is no room to measure where this call runs. */
40
+ open(toolCallId: string | undefined): Promise<ContextRoomTicket | undefined>;
41
+ }
42
+ export interface ContextRoomSeatInput {
43
+ /** The session context as the next request would carry it, read at the call. */
44
+ readonly messages: () => Promise<AgentMessage[]>;
45
+ /** The model the leg is on now (its window and structural coefficient). */
46
+ readonly model: () => Model;
47
+ readonly contextOverlay: () => ContextWindowOverlay | undefined;
48
+ /** The leg's compaction settings (their `enabled` is not read). */
49
+ readonly settings: () => CompactionSettings;
50
+ /** The fixed prompt overhead the compaction trigger adds to an anchor-less estimate. */
51
+ readonly overheadTokens: () => number | undefined;
52
+ /** Called when a ticket is asked for on a window the measurement cannot use. */
53
+ readonly onNoWindow?: (u: UnevaluableWindow) => void;
54
+ }
55
+ export declare function createContextRoomSeat(input: ContextRoomSeatInput): ContextRoomSeat;
@@ -0,0 +1,71 @@
1
+ import { calculateContextTokens } from "../../internal/harness.js";
2
+ import { measureContext, unevaluableWindowOf } from "../auto-compaction.js";
3
+ export const CONTEXT_ROOM_SHARE = 0.7;
4
+ function parentOf(messages, toolCallId) {
5
+ for (let i = messages.length - 1; i >= 0; i--) {
6
+ const m = messages[i];
7
+ if (m === undefined || m.role !== "assistant" || !Array.isArray(m.content))
8
+ continue;
9
+ const calls = m.content.filter((part) => part.type === "toolCall");
10
+ if (calls.some((c) => c.id === toolCallId))
11
+ return { message: m, key: calls[0].id };
12
+ }
13
+ return undefined;
14
+ }
15
+ function billedOf(message) {
16
+ const u = message.usage;
17
+ if (u === undefined || u.input + (u.cacheRead ?? 0) + (u.cacheWrite ?? 0) <= 0)
18
+ return 0;
19
+ return calculateContextTokens(u);
20
+ }
21
+ export function createContextRoomSeat(input) {
22
+ let ledger;
23
+ return {
24
+ async open(toolCallId) {
25
+ if (toolCallId === undefined || toolCallId === "")
26
+ return undefined;
27
+ const messages = await input.messages();
28
+ const parent = parentOf(messages, toolCallId);
29
+ if (parent === undefined)
30
+ return undefined;
31
+ const model = input.model();
32
+ const overlay = input.contextOverlay();
33
+ const overhead = input.overheadTokens();
34
+ const measure = measureContext({
35
+ messages,
36
+ model,
37
+ ...(overlay !== undefined ? { contextOverlay: overlay } : {}),
38
+ settings: input.settings(),
39
+ ...(overhead !== undefined ? { overheadTokens: overhead } : {}),
40
+ });
41
+ if (measure.contextUsage === undefined) {
42
+ const u = unevaluableWindowOf(measure, model);
43
+ if (u !== undefined)
44
+ input.onNoWindow?.(u);
45
+ return undefined;
46
+ }
47
+ const compactAt = measure.contextUsage.compactAtTokens;
48
+ const held = Math.max(billedOf(parent.message), measure.tokens);
49
+ const landed = new Set();
50
+ for (const m of messages)
51
+ if (m.role === "toolResult")
52
+ landed.add(m.toolCallId);
53
+ if (ledger === undefined || ledger.key !== parent.key)
54
+ ledger = { key: parent.key, claims: new Map() };
55
+ const book = ledger;
56
+ return {
57
+ room() {
58
+ let pending = 0;
59
+ for (const [id, tokens] of book.claims)
60
+ if (!landed.has(id))
61
+ pending += tokens;
62
+ return Math.max(0, Math.floor((compactAt - (held + pending)) * CONTEXT_ROOM_SHARE));
63
+ },
64
+ claim(tokens) {
65
+ book.claims.set(toolCallId, (book.claims.get(toolCallId) ?? 0) + tokens);
66
+ },
67
+ charsPerToken: measure.charsPerToken,
68
+ };
69
+ },
70
+ };
71
+ }