@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
@@ -19,11 +19,14 @@
19
19
  */
20
20
  import { type AgentHarness, type AgentMessage } from "../../internal/harness.js";
21
21
  import { type Model } from "../../internal/llm.js";
22
+ import { type CopyProjectionInput } from "../request-copy-projection.js";
22
23
  import { type ClearedProjectionLedger, type MicroCompactMachine, type OccurrenceFingerprint, type OccurrenceIndex } from "../context-edit.js";
23
24
  import type { ContextWindowOverlay } from "../context-settings.js";
25
+ import { type RequestCoreRef, type RequestSize } from "../context-guard.js";
24
26
  import { type ToolResultStore } from "../tool-result-store.js";
25
27
  import { type RunnerDeps } from "../types.js";
26
28
  import type { Prepared, PreparedMicroCompact } from "./contracts.js";
29
+ import type { TurnPromptSnapshot } from "../../prompt-assembly/turn-snapshot.js";
27
30
  import { type GitStatusLaneRef } from "./git-status-frame.js";
28
31
  import type { ReadFileState } from "../../tools/fs/safety.js";
29
32
  import { type ToolRosterDeltaSeat } from "../tool-roster.js";
@@ -68,17 +71,25 @@ export interface PrepareContextLaneInput {
68
71
  protectedText?: string;
69
72
  unwritten?: string;
70
73
  };
74
+ /** borrowed-mutable — the limit-approach seat (`Prepared.limitApproachRef`). The turn boundary writes the crossing; the
75
+ * handler appends its sentence to the end of every request and runs (then clears) the crossing's echo on the first one. */
76
+ limitApproachRef: Prepared["limitApproachRef"];
71
77
  /** borrowed-mutable — the per-request lossy-projection flag. Writers here: the handler re-derives it at every request
72
78
  * build, and the repair sink raises it when the provider boundary's law left recorded content out of the same request
73
79
  * (the boundary runs after the handler, before the recording shim); the shim reads it immediately after. */
74
80
  requestLossyRef: {
75
81
  current: boolean;
76
82
  };
83
+ /** borrowed-readonly — the leg's declaration seat (the turn snapshot): a clear that lands and a guard trim that drops declare `history_rewrite`. */
84
+ turnSnapshotRef: {
85
+ readonly current?: Pick<TurnPromptSnapshot, "declare">;
86
+ };
77
87
  /** borrowed-mutable — the hands' read-state map, or undefined without hands. Writer here: a landed stale-result
78
88
  * clear RETIRES the entries whose transmission it just replaced with a marker — the same retirement the compaction
79
89
  * lanes run through the SAME function (`applyContextShrinkToReadFileState`), because a Read body taken off the wire
80
- * is off the wire whichever mechanism took it. Without it a re-read of an unchanged file answers "content omitted"
81
- * pointing at a cleared marker. */
90
+ * is off the wire whichever mechanism took it. Without it the edit gate admits an edit of a file whose contents the
91
+ * request carries only as a cleared marker. The budget arm retires the entries its pointer copies witnessed the same
92
+ * way. */
82
93
  readFileState?: ReadFileState;
83
94
  /** borrowed-mutable — the trim-pressure flag (`Prepared.trimPressureRef`). Writer here: the guard chain's trim arm sets
84
95
  * `droppedMessages`; the run loop's boundary reads and clears it. */
@@ -90,7 +101,43 @@ export interface PrepareContextLaneInput {
90
101
  * is the one deployment seat an in-flight leg re-reads, and the request-layer frontiers below are asked
91
102
  * per request. Absent (a standalone prepare exercise, no Runner behind it) ⇒ no overlay, ever. */
92
103
  contextOverlay?: () => ContextWindowOverlay | undefined;
104
+ /** borrowed-readonly — the leg's startup seed table (`seededCopies` of the hands phase; filled before the first
105
+ * request): the request's copy projection carries a whole copy of a seeded, unchanged file as the "already in your
106
+ * context" sentence. Absent ⇒ no seed. */
107
+ seededCopies?: ReadonlyMap<string, string>;
108
+ /** borrowed-readonly — the session's reminder mark, for the projection's marked sentences. */
109
+ reminderMark?: string;
110
+ }
111
+ /**
112
+ * The request's copy projection as one request build reads it (`request-copy-projection.ts`): the lane measures the view
113
+ * as it will be sent, and the provider boundary renders the same projection after the tool-turn law. One per run; the
114
+ * budget arm's pointer identities are the CURRENT request's (reset at every build, read by the boundary right after).
115
+ */
116
+ export interface RequestCopies {
117
+ /** The projection's input for the request being built. */
118
+ input(): CopyProjectionInput;
119
+ /** What each message of `view` costs as the request sends it, and the anchored total of that view. */
120
+ measure(view: readonly AgentMessage[], cpt: number): {
121
+ sizeOf: RequestSize;
122
+ anchoredTokens: number;
123
+ };
124
+ /** The budget arm: when the core alone cannot fit `line`, the identities of its copies carried as pointers (oldest lose
125
+ * their contents first) — recorded for this request, and the read-state entries their copies witness retired. */
126
+ degradeCore(view: readonly AgentMessage[], held: ReadonlySet<AgentMessage>, line: number, cpt: number): void;
127
+ /** A new request build: no pointer identities yet. */
128
+ reset(): void;
93
129
  }
130
+ export declare function createRequestCopies(seat: {
131
+ seeded?: ReadonlyMap<string, string>;
132
+ mark?: string;
133
+ readFileState?: ReadFileState;
134
+ }): RequestCopies;
135
+ /**
136
+ * The stale-result clear's savings as the request sends them: the structural savings, less what the projection had
137
+ * already taken off the cleared results (a repeated copy is one sentence on the request) and less what the clear puts
138
+ * back on the others (the next copy of a cleared chain head carries the contents now).
139
+ */
140
+ export declare function clearNetSavingsFor(view: readonly AgentMessage[], cpt: number, copies?: RequestCopies): (cleared: readonly number[], structural: number) => number;
94
141
  export interface PrepareContextLaneResult {
95
142
  /** owned — the per-run microCompact machine state (`Prepared.microCompact`): machine, MC-R flag, ledger, the projection
96
143
  * and in-turn-compaction seats the handler and the runtask arms fill. */
@@ -99,6 +146,9 @@ export interface PrepareContextLaneResult {
99
146
  * prompt-overhead term downstream is computed in. The per-REQUEST defenses read the CURRENT model's
100
147
  * instead (`requestGeometry`), beside the window they compare against — one snapshot, one coordinate. */
101
148
  charsPerToken: number;
149
+ /** owned — the request's irreducible core for the leg (`Prepared.requestCoreRef`): the objective lane names the input the
150
+ * guard trim holds; both request-build guards park their typed terminal on it. */
151
+ requestCoreRef: RequestCoreRef;
102
152
  }
103
153
  /** The M21 phase body — prepareTask's context-lane stretch, verbatim (see the module header). */
104
154
  export declare function prepareContextLane(input: PrepareContextLaneInput): PrepareContextLaneResult;
@@ -115,7 +165,8 @@ export declare function prepareContextLane(input: PrepareContextLaneInput): Prep
115
165
  /**
116
166
  * The ONE landing of a set of stale-result clears: the ledger entry that makes the marker survive every
117
167
  * later rebuild, and the retirement of the read-state entries those transmissions carried. The pair is
118
- * inseparable — a ledger entry WITHOUT the retirement leaves a dedup stub pointing at a marker — which
168
+ * inseparable — a ledger entry WITHOUT the retirement leaves the read state saying the model holds contents every
169
+ * later request carries as a marker (the edit gate would admit an edit of a file the model no longer sees) — which
119
170
  * is why it is a function rather than two statements repeated at each of the two clear sites (the
120
171
  * frontier/blocking pass and the provider-rejection recovery arm, which used to write the ledger
121
172
  * independently, so only one of them retired anything). Posture: a ledger entry means the marker is
@@ -133,6 +184,9 @@ export declare function landStaleResultClears(args: {
133
184
  toolCallId?: string;
134
185
  }>;
135
186
  readFileState?: ReadFileState;
187
+ /** The leg's declaration seat: a clear that lands is a bounded `history_rewrite` (the ledger replays it byte-stably after). */
188
+ seat: Pick<TurnPromptSnapshot, "declare"> | undefined;
189
+ firstChangedIndex?: number;
136
190
  }): void;
137
191
  /** See {@link runGuardChain}. */
138
192
  export interface GuardChainArgs {
@@ -160,6 +214,15 @@ export interface GuardChainArgs {
160
214
  /** The hands' read-state map, or undefined without hands — arm A's clear retires the entries its
161
215
  * cleared transmissions carried (see `PrepareContextLaneInput.readFileState`). */
162
216
  readFileState?: ReadFileState;
217
+ /** The rows of the run's objective input in THIS view (`objectiveInputRows`): with the summaries, the request's
218
+ * irreducible core, which the trim never drops (the verdict on a core over the line is the caller's — `overLine`).
219
+ * Absent ⇒ only the summaries are core (an exercise of the chain without a run behind it). */
220
+ held?: ReadonlySet<AgentMessage>;
221
+ /** The request's copy projection ({@link createRequestCopies}): every size the chain reads is the view's as the
222
+ * request sends it, and the trim's budget arm records its pointer identities there. Absent ⇒ structural sizes. */
223
+ copies?: RequestCopies;
224
+ /** The leg's declaration seat: arm A's landing and the guard trim's drop declare their `history_rewrite` on it. */
225
+ seat: Pick<TurnPromptSnapshot, "declare"> | undefined;
163
226
  }
164
227
  export type GuardChainOutcome = {
165
228
  earlyReturn: {
@@ -170,6 +233,8 @@ export type GuardChainOutcome = {
170
233
  working: AgentMessage[];
171
234
  trimmed: AgentMessage[];
172
235
  trimDroppedMessages: boolean;
236
+ /** the request reached the trim over the guard line — its core is then the caller's to judge */ overLine: boolean;
237
+ /** how many messages the trim left out (zero: the view fits) — absent on the stand-down, whose view is never announced */ omitted?: number;
173
238
  };
174
239
  /**
175
240
  * The GUARD CHAIN over one request build (D-7 case-ii transfer table),
@@ -1,8 +1,10 @@
1
- import { DEFAULT_CHARS_PER_TOKEN, estimateContextTokens } from "../../internal/harness.js";
2
- import { TOOL_TURN_REPAIR_DROPS } from "../../internal/llm.js";
3
- import { droppedTransmissions } from "../user-attachment.js";
1
+ import { convertToLlm, DEFAULT_CHARS_PER_TOKEN, estimateContextTokens, estimateTokens } from "../../internal/harness.js";
2
+ import { ensureToolTurnInvariants, TOOL_TURN_REPAIR_DROPS } from "../../internal/llm.js";
3
+ import { droppedTransmissions, messageTransmission } from "../user-attachment.js";
4
+ import { chooseDegraded, copyIdentityOf, projectRequestCopies, projectRequestView } from "../request-copy-projection.js";
5
+ import { messageRole } from "../message-utils.js";
4
6
  import { clearStaleToolResults, createClearedProjectionLedger, dropEmptyFailureAssistants, editBudget, replayClearedProjection, resolveTriggerWindow } from "../context-edit.js";
5
- import { guardBudget, insertTrimNotice, protectGitFrame, trimToBudget } from "../context-guard.js";
7
+ import { guardBudget, heldEngineFrames, insertTrimNotice, irreducibleCoreTokens, objectiveInputRows, refuseCoreOverLine, trimToBudget } from "../context-guard.js";
6
8
  import { requestMediaLimits } from "../image-admission.js";
7
9
  import { trimRequestMedia } from "../media-byte-cap.js";
8
10
  import { capAggregateToolResults } from "../tool-result-budget.js";
@@ -14,8 +16,72 @@ import { applyContextShrinkToReadFileState } from "../../tools/fs/index.js";
14
16
  import { rosterToolName } from "../tool-roster.js";
15
17
  import { createToolTurnRepairSeat } from "./tool-turn-repair-seat.js";
16
18
  import { createMediaBudgetSeat, createProviderRefusalSeat, createToolSchemaRemovedSeat } from "./media-removed-seat.js";
19
+ import { createMessagesOmittedSeat } from "./messages-omitted-seat.js";
20
+ export function createRequestCopies(seat) {
21
+ let degraded = new Set();
22
+ const input = () => ({ degraded, ...(seat.seeded !== undefined ? { seeded: seat.seeded } : {}), ...(seat.mark !== undefined ? { mark: seat.mark } : {}) });
23
+ const measureWith = (view, cpt, projection) => {
24
+ const law = ensureToolTurnInvariants(convertToLlm([...view]));
25
+ const sentLaw = projectRequestView(law.messages, { ...projection, folds: law.folds });
26
+ const rendered = new Map();
27
+ law.messages.forEach((m, i) => {
28
+ const r = sentLaw[i];
29
+ if (r === m)
30
+ return;
31
+ const parts = law.folds.get(m);
32
+ if (parts === undefined)
33
+ rendered.set(m, r);
34
+ else
35
+ parts.forEach((p, k) => rendered.set(p, k === 0 ? r : undefined));
36
+ });
37
+ const asSent = (m) => (rendered.has(m) ? rendered.get(m) : m);
38
+ const sizeOf = (m) => {
39
+ const r = asSent(m);
40
+ return r === undefined ? 0 : estimateTokens(r, cpt);
41
+ };
42
+ return { sizeOf, anchoredTokens: estimateContextTokens(view.map(asSent).filter((m) => m !== undefined), cpt).tokens };
43
+ };
44
+ return {
45
+ input,
46
+ measure: (view, cpt) => measureWith(view, cpt, input()),
47
+ degradeCore(view, held, line, cpt) {
48
+ const core = view.filter((m) => held.has(m) || messageRole(m) === "compactionSummary");
49
+ const coreTokens = (d) => {
50
+ const sent = projectRequestCopies(core, { ...input(), degraded: d });
51
+ return sent.reduce((n, m) => n + estimateTokens(m, cpt), 0);
52
+ };
53
+ if (coreTokens(degraded) <= line)
54
+ return;
55
+ const chosen = chooseDegraded(core, (d) => coreTokens(d) <= line);
56
+ if (chosen.size === 0)
57
+ return;
58
+ degraded = chosen;
59
+ if (seat.readFileState !== undefined) {
60
+ const gone = view.flatMap((m) => (chosen.has(copyIdentityOf(m) ?? "") ? [messageTransmission(m)].filter((t) => t !== undefined) : []));
61
+ applyContextShrinkToReadFileState(seat.readFileState, { kind: "transmissions-gone", transmissions: gone });
62
+ }
63
+ },
64
+ reset() {
65
+ degraded = new Set();
66
+ },
67
+ };
68
+ }
69
+ export function clearNetSavingsFor(view, cpt, copies = createRequestCopies({})) {
70
+ return (cleared, structural) => {
71
+ const gone = new Set(cleared);
72
+ const before = copies.measure(view, cpt);
73
+ const after = view.map((m, i) => (gone.has(i) && messageRole(m) === "toolResult" ? Object.assign({}, m, { content: [], details: undefined }) : m));
74
+ const sentAfter = copies.measure(after, cpt);
75
+ let overcount = 0;
76
+ view.forEach((m, i) => {
77
+ overcount += gone.has(i) ? estimateTokens(m, cpt) - before.sizeOf(m) : sentAfter.sizeOf(after[i]) - before.sizeOf(m);
78
+ });
79
+ return structural - overcount;
80
+ };
81
+ }
17
82
  export function prepareContextLane(input) {
18
- const { model, deps, sessionId, runId, hostTaskId, offloadStore, toolRosterDeltas, microCompactKnob, harness, batchHaltRef, gitStatusRef, postureFrameRef, requestLossyRef, trimPressureRef, readFileState } = input;
83
+ const { model, deps, sessionId, runId, hostTaskId, offloadStore, toolRosterDeltas, microCompactKnob, harness, batchHaltRef, gitStatusRef, postureFrameRef, limitApproachRef, requestLossyRef, trimPressureRef, readFileState, turnSnapshotRef } = input;
84
+ const requestCoreRef = {};
19
85
  const toolNameOf = (recorded) => rosterToolName(toolRosterDeltas.current, recorded);
20
86
  const contextOverlay = input.contextOverlay ?? (() => undefined);
21
87
  const requestGeometry = () => {
@@ -35,7 +101,11 @@ export function prepareContextLane(input) {
35
101
  harness.onImagesRemoved = createProviderRefusalSeat(mediaNotices);
36
102
  harness.onToolSchemaRefused = createToolSchemaRemovedSeat((notice) => deps.onNotice?.(notice), { sessionId, runId });
37
103
  const accountMediaCut = createMediaBudgetSeat(mediaNotices, input.announced, { tracer: deps.tracer, taskId: hostTaskId });
104
+ const announceOmitted = createMessagesOmittedSeat(mediaNotices);
105
+ const copies = createRequestCopies({ ...(input.seededCopies !== undefined ? { seeded: input.seededCopies } : {}), ...(input.reminderMark !== undefined ? { mark: input.reminderMark } : {}), ...(readFileState !== undefined ? { readFileState } : {}) });
106
+ harness.projectRequestCopies = (view, folds) => projectRequestCopies(view, { ...copies.input(), folds });
38
107
  harness.on("context", async ({ messages, recheck, signal }) => {
108
+ copies.reset();
39
109
  batchHaltRef.current = undefined;
40
110
  const pendingProjectionObservations = [];
41
111
  try {
@@ -65,7 +135,8 @@ export function prepareContextLane(input) {
65
135
  budgetTokens: editAt, toolNameOf,
66
136
  clearSource: replayed,
67
137
  onCleared: (pass) => { ccPass = pass; },
68
- anchoredTotalTokens: estimateContextTokens(mediaCapped, cpt).tokens,
138
+ anchoredTotalTokens: copies.measure(mediaCapped, cpt).anchoredTokens,
139
+ netSavings: clearNetSavingsFor(mediaCapped, cpt, copies),
69
140
  charsPerToken: cpt,
70
141
  ...(offloadStore
71
142
  ? {
@@ -76,25 +147,33 @@ export function prepareContextLane(input) {
76
147
  : {}),
77
148
  });
78
149
  if (ccPass !== undefined) {
79
- recordFrontierClears({ pass: ccPass, index: replay.index, edited, ledger: microCompact.ledger, tracer: deps.tracer, taskId: hostTaskId, trigger: "frontier", ...(readFileState !== undefined ? { readFileState } : {}) });
150
+ recordFrontierClears({ pass: ccPass, index: replay.index, edited, ledger: microCompact.ledger, tracer: deps.tracer, taskId: hostTaskId, trigger: "frontier", seat: turnSnapshotRef.current, ...(readFileState !== undefined ? { readFileState } : {}) });
80
151
  }
152
+ const held = new Set([...objectiveInputRows(edited, requestCoreRef.objective), ...heldEngineFrames(edited, postureFrameRef.protectedText !== undefined ? [postureFrameRef.protectedText] : [])]);
153
+ const isHeld = (m) => held.has(m);
81
154
  const chain = await runGuardChain({
82
155
  edited, replayed, index: replay.index, microCompact, guardAt, charsPerToken: cpt, offloadStore,
83
156
  sessionId, taskId: hostTaskId, deps, trimPressureRef, recheck, signal, toolNameOf,
84
- pendingProjectionObservations,
157
+ pendingProjectionObservations, seat: turnSnapshotRef.current,
85
158
  ...(readFileState !== undefined ? { readFileState } : {}),
159
+ held,
160
+ copies,
86
161
  });
87
162
  if ("earlyReturn" in chain) {
88
163
  return chain.earlyReturn;
89
164
  }
90
- const { working, trimDroppedMessages } = chain;
165
+ const { working, trimDroppedMessages, overLine } = chain;
91
166
  let trimmed = chain.trimmed;
92
- trimmed = applyGitFrameGuard({
167
+ const sentTrimmed = copies.measure(trimmed, cpt);
168
+ const guardedFrame = applyGitFrameGuard({
93
169
  before: working,
94
170
  trimmed,
95
171
  budgetTokens: guardAt,
96
172
  ref: gitStatusRef,
173
+ coreRef: requestCoreRef,
97
174
  charsPerToken: cpt,
175
+ sizeOf: sentTrimmed.sizeOf,
176
+ ...(overLine ? { held: isHeld } : {}),
98
177
  onDegrade: (message) => {
99
178
  try {
100
179
  deps.onError?.(new Error(message), { phase: "degraded", sessionId, classification: "env-git-snapshot" });
@@ -103,17 +182,22 @@ export function prepareContextLane(input) {
103
182
  }
104
183
  },
105
184
  });
106
- if (postureFrameRef.protectedText !== undefined) {
107
- const kept = protectGitFrame(working, trimmed, guardAt, { protectedText: postureFrameRef.protectedText }, cpt);
108
- if (kept.action === "kept" || kept.action === "reinserted")
109
- trimmed = kept.messages;
110
- }
185
+ trimmed = guardedFrame.messages;
186
+ if (overLine)
187
+ refuseCoreOverLine(guardedFrame.core ?? irreducibleCoreTokens(trimmed, isHeld, cpt, sentTrimmed.sizeOf), guardAt, held.size, requestCoreRef);
111
188
  if (postureFrameRef.unwritten !== undefined) {
112
189
  let at = trimmed.length;
113
190
  while (at > 0 && trimmed[at - 1].role === "user")
114
191
  at--;
115
192
  trimmed = [...trimmed.slice(0, at), { role: "user", content: [{ type: "text", text: postureFrameRef.unwritten }], timestamp: Date.now(), engineMinted: true }, ...trimmed.slice(at)];
116
193
  }
194
+ const approach = limitApproachRef.crossed;
195
+ if (approach !== undefined) {
196
+ trimmed = [...trimmed, { role: "user", content: [{ type: "text", text: approach.text }], timestamp: Date.now(), engineMinted: true }];
197
+ const announce = approach.announce;
198
+ approach.announce = undefined;
199
+ announce?.();
200
+ }
117
201
  requestLossyRef.current =
118
202
  replayed !== healed ||
119
203
  capped !== replayed ||
@@ -123,13 +207,16 @@ export function prepareContextLane(input) {
123
207
  trimDroppedMessages ||
124
208
  gitStatusRef.overBudgetShrunk === true;
125
209
  microCompact.projectionRef.current = { messages: trimmed, keyOf: replay.index.keyOf };
210
+ const { omitted } = chain;
211
+ if (omitted !== undefined)
212
+ pendingProjectionObservations.push(() => announceOmitted(omitted));
126
213
  return { messages: trimmed };
127
214
  }
128
215
  finally {
129
216
  flushProjectionObservations(pendingProjectionObservations);
130
217
  }
131
218
  });
132
- return { microCompact, charsPerToken };
219
+ return { microCompact, charsPerToken, requestCoreRef };
133
220
  }
134
221
  function buildMicroCompactState(deps, model, sessionId, runId, offloadStore, knob, overlay) {
135
222
  const triggerWindow = resolveTriggerWindow(model, overlay);
@@ -164,6 +251,8 @@ export function landStaleResultClears(args) {
164
251
  if (c.toolCallId !== undefined)
165
252
  transmissions.push(c.toolCallId);
166
253
  }
254
+ if (args.cleared.length > 0)
255
+ args.seat?.declare({ cause: "history_rewrite", bounded: true, ...(args.firstChangedIndex !== undefined ? { firstChangedIndex: args.firstChangedIndex } : {}) });
167
256
  if (args.readFileState !== undefined) {
168
257
  applyContextShrinkToReadFileState(args.readFileState, { kind: "transmissions-gone", transmissions });
169
258
  }
@@ -184,7 +273,7 @@ function recordFrontierClears(args) {
184
273
  });
185
274
  }
186
275
  }
187
- landStaleResultClears({ ledger: args.ledger, cleared: landed, ...(args.readFileState !== undefined ? { readFileState: args.readFileState } : {}) });
276
+ landStaleResultClears({ ledger: args.ledger, cleared: landed, seat: args.seat, ...(args.pass.clears.length > 0 ? { firstChangedIndex: Math.min(...args.pass.clears.map((c) => c.index)) } : {}), ...(args.readFileState !== undefined ? { readFileState: args.readFileState } : {}) });
188
277
  emitTrace(args.tracer, () => ({
189
278
  kind: "context.mc_clear",
190
279
  version: 1,
@@ -205,13 +294,33 @@ function flushProjectionObservations(pending) {
205
294
  }
206
295
  }
207
296
  export async function runGuardChain(args) {
208
- const { edited, microCompact, guardAt, charsPerToken, deps, taskId } = args;
297
+ const { edited, microCompact, guardAt, charsPerToken, deps, taskId, held, copies } = args;
298
+ const isHeld = held !== undefined ? (m) => held.has(m) : undefined;
299
+ const anchoredOf = (view) => (copies !== undefined ? copies.measure(view, charsPerToken).anchoredTokens : estimateContextTokens([...view], charsPerToken).tokens);
300
+ const trimAsSent = (view, anchoredTotal) => {
301
+ if (copies === undefined)
302
+ return trimToBudget(view, guardAt, anchoredTotal, charsPerToken, isHeld);
303
+ let kept = view;
304
+ let total = anchoredTotal;
305
+ for (;;) {
306
+ const next = trimToBudget(kept, guardAt, total, charsPerToken, isHeld, copies.measure(kept, charsPerToken).sizeOf);
307
+ if (next === kept || next.length >= kept.length)
308
+ return kept;
309
+ kept = next;
310
+ total = anchoredOf(kept);
311
+ }
312
+ };
209
313
  const applyGuardTrim = (view, anchoredTotal) => {
210
- let trimmed = trimToBudget(view, guardAt, anchoredTotal, charsPerToken);
314
+ if (copies !== undefined && held !== undefined && anchoredTotal > guardAt) {
315
+ copies.degradeCore(view, held, guardAt, charsPerToken);
316
+ anchoredTotal = anchoredOf(view);
317
+ }
318
+ let trimmed = trimAsSent(view, anchoredTotal);
211
319
  const dropped = trimmed.length < view.length;
320
+ const omitted = view.length - trimmed.length;
212
321
  if (dropped) {
322
+ args.seat?.declare({ cause: "history_rewrite" });
213
323
  args.trimPressureRef.droppedMessages = true;
214
- const droppedCount = view.length - trimmed.length;
215
324
  if (args.readFileState !== undefined)
216
325
  applyContextShrinkToReadFileState(args.readFileState, { kind: "transmissions-gone", transmissions: droppedTransmissions(view, trimmed) });
217
326
  trimmed = insertTrimNotice(trimmed);
@@ -219,14 +328,14 @@ export async function runGuardChain(args) {
219
328
  kind: "context.trim",
220
329
  version: 1,
221
330
  taskId,
222
- dropped: droppedCount,
331
+ dropped: omitted,
223
332
  ts: Date.now(),
224
333
  }));
225
334
  }
226
- return { trimmed, dropped };
335
+ return { trimmed, dropped, omitted };
227
336
  };
228
337
  let working = edited;
229
- let anchoredWorking = estimateContextTokens(working, charsPerToken).tokens;
338
+ let anchoredWorking = anchoredOf(working);
230
339
  if (microCompact.machine === "off" && anchoredWorking > guardAt) {
231
340
  let blockingPass;
232
341
  const blockingEdited = clearStaleToolResults(working, {
@@ -234,13 +343,14 @@ export async function runGuardChain(args) {
234
343
  clearSource: args.replayed,
235
344
  onCleared: (pass) => { blockingPass = pass; },
236
345
  anchoredTotalTokens: anchoredWorking,
346
+ ...(copies !== undefined ? { netSavings: clearNetSavingsFor(working, charsPerToken, copies) } : {}),
237
347
  charsPerToken,
238
348
  ...(args.offloadStore ? { offload: { persist: createOffloadPersist(args.offloadStore, args.sessionId, deps.onNotice) } } : {}),
239
349
  });
240
350
  if (blockingPass !== undefined) {
241
- recordFrontierClears({ pass: blockingPass, index: args.index, edited: blockingEdited, ledger: microCompact.ledger, tracer: deps.tracer, taskId, trigger: "blocking", ...(args.readFileState !== undefined ? { readFileState: args.readFileState } : {}) });
351
+ recordFrontierClears({ pass: blockingPass, index: args.index, edited: blockingEdited, ledger: microCompact.ledger, tracer: deps.tracer, taskId, trigger: "blocking", seat: args.seat, ...(args.readFileState !== undefined ? { readFileState: args.readFileState } : {}) });
242
352
  working = blockingEdited;
243
- anchoredWorking = estimateContextTokens(working, charsPerToken).tokens;
353
+ anchoredWorking = anchoredOf(working);
244
354
  }
245
355
  }
246
356
  if (anchoredWorking > guardAt && args.recheck !== true) {
@@ -251,9 +361,9 @@ export async function runGuardChain(args) {
251
361
  }
252
362
  if (args.signal?.aborted === true) {
253
363
  args.pendingProjectionObservations.length = 0;
254
- return { working, trimmed: working, trimDroppedMessages: false };
364
+ return { working, trimmed: working, trimDroppedMessages: false, overLine: false };
255
365
  }
256
366
  }
257
367
  const t = applyGuardTrim(working, anchoredWorking);
258
- return { working, trimmed: t.trimmed, trimDroppedMessages: t.dropped };
368
+ return { working, trimmed: t.trimmed, trimDroppedMessages: t.dropped, overLine: anchoredWorking > guardAt, omitted: t.omitted };
259
369
  }
@@ -19,10 +19,6 @@ export interface PrepareDeferClassifyInput {
19
19
  roster: RosterBuilder;
20
20
  /** borrowed-readonly — the frozen task-start tool face: the selector (the valve, and whether the search tool deferral needs is admitted), `defer` (operator defers, exact wire names), `alwaysLoad` (the pins). */
21
21
  toolFaceSnapshot: Pick<ToolFaceSnapshot, "selector" | "defer" | "alwaysLoad">;
22
- /** borrowed-readonly — whether a real execution env is mounted (the full-shell invariant runs only where a shell could be on the roster). */
23
- handsEnabled: boolean;
24
- /** borrowed-readonly — the spec-time precomputation the invariant checks the post-exclusion roster against: a mismatch is an engine bug, thrown. */
25
- fullShellReachable: boolean;
26
22
  /** borrowed-readonly — the run's effective prompt traits (each tool's description variants are chosen on them). */
27
23
  promptTraits: ReadonlySet<PromptTraitName>;
28
24
  /** borrowed-readonly — the resolved model (the deferral gate's threshold reads its context window). */
@@ -1,5 +1,4 @@
1
- import { getToolContract, mountDescriptionVariant } from "../../prompt-assembly/tool-catalog.js";
2
- import { FULL_SHELL_CONTRACT_ID } from "../../tools/fs/index.js";
1
+ import { mountDescriptionVariant } from "../../prompt-assembly/tool-catalog.js";
3
2
  import { ASK_USER_QUESTION_TOOL_NAME } from "../ask-question.js";
4
3
  import { MEMORY_ENGINE_TOOL_NAMES } from "../memory-engine/tools.js";
5
4
  import { SHARED_MEMORY_TOOL_NAMES } from "../shared-memory/types.js";
@@ -17,21 +16,11 @@ function memoryGroupRetractionSet(builtinDeferPairNames, engineTrioInPlay) {
17
16
  return new Set([...builtinDeferPairNames, ...(engineTrioInPlay ? MEMORY_ENGINE_TOOL_NAMES : [])]);
18
17
  }
19
18
  export function prepareDeferClassify(input) {
20
- const { spec, deps, roster, toolFaceSnapshot, handsEnabled, fullShellReachable, promptTraits, model, mcp, a2a, sharedMemoryPairMounted, memoryEnginePairMounted, memoryRecallSegment, onceLedger, sessionId } = input;
19
+ const { spec, deps, roster, toolFaceSnapshot, promptTraits, model, mcp, a2a, sharedMemoryPairMounted, memoryEnginePairMounted, memoryRecallSegment, onceLedger, sessionId } = input;
21
20
  const tools = roster.tools;
22
21
  let memoryBlock = input.memoryBlock;
23
22
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
24
23
  roster.unmountWhere((t) => !leaves(t));
25
- if (handsEnabled) {
26
- const fullShellOnRoster = tools.some((t) => t.name === "Bash" && getToolContract(t, "core").contractId === FULL_SHELL_CONTRACT_ID);
27
- if (fullShellOnRoster !== fullShellReachable) {
28
- const e = new Error(`internal invariant: fullShellReachable=${String(fullShellReachable)} but the post-exclusion roster ` +
29
- `${fullShellOnRoster ? "carries" : "does not carry"} the full shell (${FULL_SHELL_CONTRACT_ID}). ` +
30
- `A new roster-affecting mechanism was added without updating the predicate.`);
31
- e.code = "internal.full_shell_reachable_mismatch";
32
- throw e;
33
- }
34
- }
35
24
  for (let i = 0; i < tools.length; i++) {
36
25
  const t = tools[i];
37
26
  const face = mountDescriptionVariant(t, promptTraits);
@@ -74,6 +63,11 @@ export function prepareDeferClassify(input) {
74
63
  const memoryEnginePair = explicitlyDeferredMemoryTrio(memoryEnginePairMounted, tools, toolFaceSnapshot.defer);
75
64
  const builtinDeferPairNames = [...sharedMemoryPair, ...memoryEnginePair];
76
65
  let deferred;
66
+ let retracted = false;
67
+ const stateRetraction = () => {
68
+ roster.mounts.retract("sharedMemory", retracted && sharedMemoryPair.length > 0);
69
+ roster.mounts.retract("memoryEngine", retracted && memoryEnginePair.length > 0);
70
+ };
77
71
  if (builtinDeferPairNames.length > 0) {
78
72
  const withoutPairs = tools.filter((t) => !builtinDeferPairNames.some((n) => n === t.name));
79
73
  const d1 = classifyDeferredOverFace(tools, builtinDeferPairNames);
@@ -82,6 +76,7 @@ export function prepareDeferClassify(input) {
82
76
  const supportNameTaken = tools.some((t) => t.name === TOOL_SEARCH_NAME || (t.aliases ?? []).includes(TOOL_SEARCH_NAME));
83
77
  if (soleCause && supportNameTaken) {
84
78
  const retractNames = memoryGroupRetractionSet(builtinDeferPairNames, memoryEnginePair.length > 0);
79
+ retracted = true;
85
80
  roster.unmountWhere((t) => retractNames.has(t.name));
86
81
  if (sharedMemoryPair.length > 0) {
87
82
  announceMemoryNotMounted(onceLedger, sessionId, "shared", SHARED_MEMORY_TOOL_NAMES, `mounting them would inject the "${TOOL_SEARCH_NAME}" tool, whose name this task already declares`);
@@ -107,5 +102,6 @@ export function prepareDeferClassify(input) {
107
102
  else {
108
103
  deferred = classifyDeferredOverFace(tools, []);
109
104
  }
105
+ stateRetraction();
110
106
  return { deferred, memoryBlock, toolSearch: resolvedToolSearch };
111
107
  }
@@ -21,6 +21,7 @@ import { type PeerLaneRefs } from "../../agents/peer-session-drain.js";
21
21
  import type { SubagentRetainLedger } from "../../agents/retain-ledger.js";
22
22
  import type { ShellReadAdmission } from "../../tools/fs/shell-read-check.js";
23
23
  import type { ReadFloorSeat } from "../../tools/fs/read-floor.js";
24
+ import type { CommandSandboxSeat } from "../command-sandbox.js";
24
25
  import { type WorktreeSessionRef } from "../../tools/worktree.js";
25
26
  import type { CwdRef } from "../../tools/fs/index.js";
26
27
  import { type ToolResultStore } from "../tool-result-store.js";
@@ -37,8 +38,8 @@ export interface PrepareDelegationSurfaceInput {
37
38
  * `onBackgroundChildEvent`, `tracer`. */
38
39
  deps: Pick<RunnerDeps, "workflowRunStore" | "backgroundAgentStore" | "mailboxStore" | "rosterStore" | "peerLane" | "peerDirectory" | "peerChannel" | "principalInboxConsumer" | "onNotice" | "onBackgroundChildEvent" | "tracer">;
39
40
  /** borrowed-readonly — the trusted spawn-side channel: `parentNotify` (the delegated-child door), the uplink / sibling /
40
- * identity seats the SendMessage mount forwards, `onTaskNotification`, `onSubagentSpawn`. Never mutated. */
41
- internals: Pick<RunInternals, "parentNotify" | "parentPeerRef" | "uplinkSessionId" | "parentRetainLedger" | "explicitAgentName" | "parentTaskId" | "parentSessionId" | "peerSelfRef" | "peerInboundChainRef" | "onTaskNotification" | "onSubagentSpawn"> | undefined;
41
+ * identity seats the SendMessage mount forwards, `onTaskNotification`, `onSubagentSpawn`, `principalInboxAssistant`. Never mutated. */
42
+ internals: Pick<RunInternals, "parentNotify" | "parentPeerRef" | "uplinkSessionId" | "parentRetainLedger" | "explicitAgentName" | "parentTaskId" | "parentSessionId" | "peerSelfRef" | "peerInboundChainRef" | "onTaskNotification" | "onSubagentSpawn" | "principalInboxAssistant"> | undefined;
42
43
  /** borrowed-readonly — the resume leg, or undefined: `seed.activeWorktree` seeds the worktree session (checkpoint first). */
43
44
  resume: Pick<PrepareResume, "seed"> | undefined;
44
45
  /** borrowed-readonly — the acquired session id (the mounts' session axis). */
@@ -61,19 +62,16 @@ export interface PrepareDelegationSurfaceInput {
61
62
  /** borrowed-readonly — the trusted Runner self-reference the SendMessage / AgentTranscript mounts execute through; undefined
62
63
  * when prepareTask runs standalone (then neither mounts). */
63
64
  runnerSelf: RunnerSelfSeat | undefined;
64
- /** borrowed-readonly — the background/workflow door's first half: the hands mount decided a real shell with write hands. */
65
- backgroundTaskToolsActive: boolean;
66
65
  /** borrowed-readonly — this run's shell read station's pre-spawn ADMISSION (declared at the hands phase), for `Monitor`: the only P11 face that spawns a shell command. */
67
66
  shellReadAdmission: ShellReadAdmission | undefined;
68
67
  /** borrowed-readonly — the run's byte-floor seat (read-floor.ts), for the faces mounted here that start commands
69
68
  * (`Monitor`, EnterWorktree / ExitWorktree): each start carries the floor it answers, as the band's shell starts do. */
70
69
  runReadFloor: ReadFloorSeat;
71
- /** borrowed-readonly — the door's second half: the Workflow tool is on the roster. */
72
- workflowToolsActive: boolean;
70
+ /** borrowed-readonly — the run's command sandbox seat (`command-sandbox.ts`), for `Monitor`: each watch it starts carries the
71
+ * instruction its call's plan holds, as the band's shell starts do. Absent ⇒ the run requires no sandbox. */
72
+ commandSandbox?: CommandSandboxSeat;
73
73
  /** borrowed-readonly — the peer lane's mount verdict for this leg. */
74
74
  peerLaneActive: boolean;
75
- /** borrowed-readonly — whether the BUILT-IN SendMessage is on this face (the ListAgents mount's second term). */
76
- peerSendMessageBuiltIn: boolean;
77
75
  /** borrowed-mutable — the lane's late-bound facts; the SendMessage mount hands the SAME object to its peer seats (identity is
78
76
  * the contract: the wiring station fills `askEffective` later). Not written here. */
79
77
  peerLaneRefs: PeerLaneRefs;
@@ -102,6 +100,8 @@ export interface PrepareDelegationSurfaceInput {
102
100
  /** borrowed-readonly — the run's offload store, or undefined when offload is disabled (then no reader mounts and the
103
101
  * read/kill faces spill nowhere). */
104
102
  offloadStore: ToolResultStore | undefined;
103
+ /** borrowed-readonly — the run's bytes seat over that store: the reader answers a ref holding bytes with how this run can write them out. */
104
+ toolResultBytes: import("../tool-result-bytes.js").ToolResultBytesSeat;
105
105
  /** borrowed-readonly — where a cut completion's full result is stored (the driver's one mint over `offloadStore`). */
106
106
  taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
107
107
  /** borrowed-readonly — the retain ledger the SendMessage mount continues children through (absent ⇒ honest not-retained). */