@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
@@ -146,19 +146,25 @@ export declare function zeroOutputSentence(error: {
146
146
  partialStdout?: string;
147
147
  partialStderr?: string;
148
148
  }, timeoutSec: number, noOutputSec: number | undefined): string;
149
- /** Output-token cap as a char proxy (CC's 25000, at ~4 chars/token). Caps the shown body so 2000 very
150
- * long lines cannot blow the context budget.
149
+ /** Read's base output budget in tokens (CC's 25000): the size a read is served or paged at without
150
+ * `allow_large`, and the bar `allow_large` must clear before it raises anything (a turn whose room is not
151
+ * above this keeps the base limits). Every sentence that names the base limit renders this one number. */
152
+ export declare const BASE_READ_TOKENS = 25000;
153
+ /** Output-token cap as a char proxy (`BASE_READ_TOKENS` at ~4 chars/token). Caps the shown body so 2000
154
+ * very long lines cannot blow the context budget.
151
155
  *
152
156
  * Only the 25000 NUMBER is CC's. CC does NOT use a flat chars/4 proxy — it pre-filters with a
153
157
  * PER-EXTENSION chars-per-token coefficient (json/jsonl = 2, half the 4 assumed here) and then
154
- * confirms with a REAL tokenizer; its budget is also overridable per call and by a feature gate,
155
- * neither of which has a sema lane. Consequence, stated rather than hidden: on token-dense text
156
- * (JSON/CJK/base64) this proxy UNDER-counts, so sema serves a page CC would have cut further; on
157
- * token-sparse text it over-counts and paginates earlier than CC. A real tokenizer here would need a
158
- * provider-neutral counting seam (BYOM — no single vocabulary), which is why the proxy stands; the
159
- * divergence is a fidelity delta, not a correctness one (the partial-view marker always states the
160
- * served window truthfully). */
161
- export declare const MAX_READ_OUTPUT_CHARS = 100000;
158
+ * confirms with a REAL tokenizer; its budget is also overridable by a feature gate, which has no sema
159
+ * lane. The per-call override does: `allow_large` raises the budget to the turn's context room
160
+ * (`fs-read.ts`), measuring the served body as `max(chars / charsPerToken, bytes / 2)` — CC's own
161
+ * tokenizer-less floor. Consequence, stated rather than hidden: on token-dense text (JSON/CJK/base64)
162
+ * this proxy UNDER-counts, so sema serves a page CC would have cut further; on token-sparse text it
163
+ * over-counts and paginates earlier than CC. A real tokenizer here would need a provider-neutral
164
+ * counting seam (BYOM — no single vocabulary), which is why the proxy stands; the divergence is a
165
+ * fidelity delta, not a correctness one (the partial-view marker always states the served window
166
+ * truthfully). */
167
+ export declare const MAX_READ_OUTPUT_CHARS: number;
162
168
  export declare const BASH_DEFAULT_TIMEOUT_SEC = 120;
163
169
  export declare const BASH_MAX_TIMEOUT_SEC = 600;
164
170
  export declare const BASH_DEFAULT_TIMEOUT_MS: number;
@@ -186,14 +192,6 @@ export declare const MIN_BASH_TIMEOUT_MS = 1000;
186
192
  * the 1-second floor. Between {@link MIN_BASH_TIMEOUT_MS} (exclusive) and this, every request lands on
187
193
  * the floor with its remainder discarded. */
188
194
  export declare const BASH_TIMEOUT_PLATEAU_END_MS = 1500;
189
- /**
190
- * A host-supplied failure `message` is untrusted as a CARRIER OF FACTS: an execution env whose adapter
191
- * hands back an empty (or whitespace-only) string turns any text built as `Error (X): ${message}` into a
192
- * bare `Error (X):` — a card with a red badge and nothing to act on, which is exactly what a model (and
193
- * a person) reads as "the engine broke and won't say how". Use this wherever the message IS the whole
194
- * fact; where it only decorates a sentence the engine wrote itself, interpolate it directly.
195
- */
196
- export declare function envErrorDetail(message: string | undefined): string;
197
195
  /**
198
196
  * The `timeout` parameter's model-facing description, rendered from the SAME caps the runtime enforces
199
197
  * and the SAME plateau the refusal applies — one text for both shell legs so a boundary can never be
@@ -406,35 +404,23 @@ export declare function ipynbRedirect(toolName: string, path: string): string |
406
404
  * ends in "\n". Behavior is identical for content WITHOUT a trailing newline. Shared by read_file's
407
405
  * `total`, edit_file/write_file's "N lines" report, and the persisted ReadFileState.totalLines. */
408
406
  export declare function countLines(s: string): number;
409
- /** The reminder served when a DEFAULT whole-file Read hits a startup-seeded,
410
- * unchanged file. `filePath` is the CANONICAL key (CC passes the resolved full path, matching the
407
+ /** The sentence a request carries in place of a whole-file Read of a file this leg seeded into its system prompt,
408
+ * unchanged (`request-copy-projection.ts`; the result itself stores the contents). `filePath` is the CANONICAL key (CC passes the resolved full path, matching the
411
409
  * `Contents of <path>` header its context seeding emits — deployments seeding files should title the
412
410
  * injected block the same way so the back-reference lands). Locked verbatim by test: the BODY and
413
411
  * close tag stay fixed; the open tag alone is rendered by the mint home and carries the session
414
412
  * mark when one is threaded (the recorded wire-form divergence). */
415
413
  export declare function seededFileUnchangedReminder(filePath: string, mark?: string): string;
416
- /**
417
- * True when `resultText` is one of the Read tool's TWO dedup markers (the ordinary
418
- * unchanged-since-last-read stub below, or {@link seededFileUnchangedReminder}) rather than a genuine
419
- * content transmission. A consumer deciding "is this file's real content present in THIS message"
420
- * (e.g. auto-compaction's kept-tail visibility scan) must treat a stub hit as absence — the marker
421
- * POINTS AT an earlier read that may itself no longer be in context.
422
- *
423
- * Both emitters ALSO carry a structured marker (`details.type === "file_unchanged"`,
424
- * fs-read.ts `fileUnchangedResult`) — consumers with access to the tool result's `details` should
425
- * branch on that instead of this prose match (which can false-positive on file CONTENT that quotes
426
- * either sentence). This predicate stays for text-only surfaces (compaction sees rendered text).
427
- */
428
- export declare function isReadDedupStubResult(resultText: string): boolean;
429
414
  /** Pre-seed the hands' read state for a file whose FULL, disk-verbatim text was injected into the
430
- * model's context at startup (`seededFromContext` seeding of the memory preload; sema:
431
- * ProjectMemoryLoad.seededFiles → prepare-task).
432
- * `content` MUST be the file's exact disk text at load time — the Read tool's seeded dedup treats a
433
- * hash match as "unchanged"; a truncated/annotated variant must NOT be seeded (CC exempts those via
415
+ * model's context at startup (`seededFromContext` seeding of the memory preload; sema: the memory
416
+ * engine's materialized index → prepare-task).
417
+ * `content` MUST be the file's exact disk text at load time — a hash match reads as "the seed is the file"; a
418
+ * truncated/annotated variant must NOT be seeded (CC exempts those via
434
419
  * `isPartialView`; sema's contract is simply "don't seed partials"). `key` is the CANONICAL path
435
420
  * (resolveKey output), so it collides correctly with real Read/Edit entries. Note the CC-faithful
436
- * side effect: a seeded file passes read-before-edit (the model legitimately has the full text). */
437
- export declare function seedReadFileStateFromContext(state: ReadFileState, key: string, content: string): void;
421
+ * side effect: a seeded file passes read-before-edit (the model legitimately has the full text).
422
+ * Returns the hash the entry carries — the leg's seed table (the request projection's seeded sentence) records it. */
423
+ export declare function seedReadFileStateFromContext(state: ReadFileState, key: string, content: string): string;
438
424
  /**
439
425
  * Seed the hands' read state from a WHOLE-file content the session transcript recorded on an earlier
440
426
  * turn (the selection rules live in core/runner/session-file-state-replay.ts).
@@ -444,15 +430,26 @@ export declare function seedReadFileStateFromContext(state: ReadFileState, key:
444
430
  * - `lastReadAt` is the RECORDED moment, not now. It is what the changed-files detector compares an
445
431
  * mtime against, so an honest old stamp keeps a between-turns modification detectable; stamping
446
432
  * "now" would hide exactly the change the model needs told about.
447
- * - no `view`, so the Read dedup stub can never fire off this entry. The dedup answers a re-read
448
- * with "unchanged since you last read it" — true only while the earlier read's body is still IN
449
- * the context, which a continuation (or a compaction inside it) cannot promise.
433
+ * - no `view`: the entry claims the file's whole text, not a window the model was served.
450
434
  * - no `seededFromContext`: that flag means the text lives in the system-prompt lane and survives
451
435
  * compaction. This text lives in the transcript and does not.
452
436
  * A Read result's text carries that result's call id (`transmission`), as the live read's entry does, so a trim that
453
437
  * drops the result retires the entry; a Write's post-condition rode no result body and carries none.
454
438
  */
455
439
  export declare function seedReadFileStateFromTranscript(state: ReadFileState, key: string, content: string, lastReadAt: number, transmission?: string): void;
440
+ /**
441
+ * The entries a leg may carry out of ANOTHER leg's read state — the one answer every cross-leg carrier reads (the
442
+ * same-Runner inheritance arm below, the durable resume's checkpoint seed): all of them but the seeded ones.
443
+ *
444
+ * `seededFromContext` claims the file's text lives in the system-prompt lane OF THAT LEG — a claim only the receiving
445
+ * leg's own startup seeding can make. A still-declared file is seeded again on the receiving leg (no loss); one the
446
+ * receiving deployment no longer declares must not keep answering a Read with an "already in your context" reminder
447
+ * that is no longer true, nor keep admitting an Edit the model never saw the text for. The filter is on the READ side:
448
+ * a checkpoint row an earlier release wrote still carries the flag, and is one case with a new row.
449
+ *
450
+ * Entries are returned by REFERENCE, in the source's order (ReadEntry values are never mutated in place).
451
+ */
452
+ export declare function entriesCarriedAcrossLegs(entries: Iterable<readonly [string, ReadEntry]>): Array<[string, ReadEntry]>;
456
453
  /**
457
454
  * Copy a SESSION-inherited read-file state into a new task's map, under the new task's
458
455
  * own containment judgment (CC parity: readFileState is session-scoped — minted once per REPL session,
@@ -465,25 +462,21 @@ export declare function seedReadFileStateFromTranscript(state: ReadFileState, ke
465
462
  * root or face narrowed between the turns must narrow what the state remembers, exactly as the
466
463
  * replay leg already judges — an unjudged copy would smuggle out-of-face entries into the task
467
464
  * (and into its checkpoints).
468
- * - **`seededFromContext` entries do not inherit.** That flag claims the file's text lives in the
469
- * system-prompt lane OF THIS TASK — a claim only this task's own startup seeding can make.
470
- * A still-declared file is re-seeded the same turn (no loss); a no-longer-declared one must not
471
- * keep answering reads with an "already in your context" reminder that is no longer true.
465
+ * - **Only what {@link entriesCarriedAcrossLegs} lets cross crosses** — the seeded entries do not inherit.
472
466
  *
473
467
  * Entries are copied by REFERENCE (ReadEntry values are never mutated in place — every write-back
474
468
  * `set`s a fresh object), so recorded facts (view / isPartialView / lastReadAt) ride verbatim: the
475
- * dedup stub and the partial-view refusal keep working across turns exactly as inside one task.
469
+ * edit gate and the partial-view refusal keep working across turns exactly as inside one task.
476
470
  */
477
471
  export declare function inheritSessionReadFileState(target: ReadFileState, inherited: ReadFileState, judgeKey: (recordedKey: string) => Promise<string | undefined>): Promise<void>;
478
472
  /**
479
473
  * CC parity: a landed compaction summarizes old Read results OUT of the context, so every non-seeded
480
474
  * read-state entry must be dropped — CC snapshots then
481
- * `readFileState.clear()`s at the same spot. Without this, the Read dedup stub above answers a re-read of
482
- * an unchanged file with "content omitted to save context" pointing at content that no longer exists
483
- * anywhere in the context (the model works from hallucinated memory or has to vary offset/limit to escape).
475
+ * `readFileState.clear()`s at the same spot. Without this, the read-before-edit gate admits an edit of a file
476
+ * whose content no longer exists anywhere in the context (the model works from memory of a summarized read).
484
477
  * Two deliberate divergences from CC's bare clear(), each from sema's own structure:
485
478
  * - SEEDED entries survive: their content lives in the system-prompt lane, which compaction never touches,
486
- * so their dedup remains CORRECT (CC re-seeds the same family right after its clear — equivalent end state).
479
+ * so the model still holds the text (CC re-seeds the same family right after its clear — equivalent end state).
487
480
  * - A file still visible in the compaction's KEPT tail (its read or its attachment frame is there) survives
488
481
  * unmodified, for the same reason: the model's view of it did not change. Wiping it would make the
489
482
  * read-before-edit gate reject an Edit the model can visibly justify, and the next Read retransmit the file.
@@ -494,8 +487,10 @@ export declare function inheritSessionReadFileState(target: ReadFileState, inher
494
487
  */
495
488
  /**
496
489
  * What the read state holds once a landed summary has taken its reads out of view — the ONE answer to "which entries
497
- * survive a compaction": the seeded entries and `preserveKeys`. The summarized clear applies it to the live state; the
498
- * restore's reads dedup against it (the context they deliver into is the one the summary leaves).
490
+ * survive a compaction": the seeded entries and `preserveKeys`, a surviving entry holding its newest witness only (the
491
+ * kept tail is the newest stretch of the transcript, so what it still shows of a file is the file's newest copy; the older
492
+ * copies went into the summary and would otherwise keep the entry standing after the last visible one leaves). The
493
+ * summarized clear applies it to the live state.
499
494
  */
500
495
  export declare function readFileStateAfterSummary(state: ReadonlyMap<string, ReadEntry>, preserveKeys: ReadonlyArray<string>): ReadFileState;
501
496
  /**
@@ -503,18 +498,19 @@ export declare function readFileStateAfterSummary(state: ReadonlyMap<string, Rea
503
498
  * SHRINK rather than compaction: the request-layer stale-result pass replaces an old tool result's
504
499
  * content with a cleared marker, and the request guard's last-resort trim drops old messages — a Read's
505
500
  * result or an attachment frame among them — from the request; no summary, no re-attachment, nothing changed in the
506
- * session — and for a read the effect on the entry is identical: the body its dedup stub points at is no
507
- * longer anywhere the model can see, so the entry must retire with it. A transmission is named by the
501
+ * session — and for a read the effect on the entry is identical: the body it records the model as holding is no
502
+ * longer anywhere the model can see, so the entry must retire with it (the edit gate then asks for a fresh read). A transmission is named by the
508
503
  * tool call that carried it, or by the attachment frame (`attachmentTransmissionId`).
509
504
  *
510
- * Selection is by the TRANSMISSION, not by path — an entry a LATER Read re-transmitted carries that
511
- * later call's id and so survives a clear of the earlier one, which a path-keyed retirement could not
512
- * tell apart. KNOWN IMPRECISION: a call id is not unique over a run (the clear ledger keys occurrences
513
- * by id + message timestamp + ordinal for that reason) and the finer key is not reachable at the Read
514
- * mint, which does not know the timestamp of the message its result will land in. A reused id can
515
- * therefore retire one entry too many, costing a re-transmission and a tightened read-before-edit gate
516
- * — the same tightening the summarized arm accepts wholesale. The converse is not reachable: an entry
517
- * carries the id of the last Read that transmitted it, so if that result was cleared its id is in the list.
505
+ * Selection is by the TRANSMISSION, not by path — an entry holds the id of every delivery of its body (its witness
506
+ * set, `ReadEntry.witnesses`), so a clear or a trim of one copy leaves the entry standing while another stays and
507
+ * retires it with the last, which a path-keyed retirement could not tell apart. KNOWN IMPRECISION: a call id is not
508
+ * unique over a run (the clear ledger keys occurrences by id + message timestamp + ordinal for that reason) and the
509
+ * finer key is not reachable at the Read mint, which does not know the timestamp of the message its result will land
510
+ * in. A reused id can therefore retire one entry too many, costing a re-transmission and a tightened read-before-edit
511
+ * gate — the same tightening the summarized arm accepts wholesale. The converse is a departure no arm reports (a copy
512
+ * the tool-turn law drops from the request is the candidate; none is constructed): the witness stays and the edit gate
513
+ * lets an edit through on a body the request does not carry.
518
514
  */
519
515
  export type ReadFileStateShrink =
520
516
  /** A landed compaction: everything but {@link readFileStateAfterSummary} retires (`preserveKeys` stayed visible in the kept tail). */
@@ -80,7 +80,8 @@ export function zeroOutputSentence(error, timeoutSec, noOutputSec) {
80
80
  : "";
81
81
  return `(no output was produced before the cutoff${hint})`;
82
82
  }
83
- export const MAX_READ_OUTPUT_CHARS = 100_000;
83
+ export const BASE_READ_TOKENS = 25_000;
84
+ export const MAX_READ_OUTPUT_CHARS = BASE_READ_TOKENS * 4;
84
85
  export const BASH_DEFAULT_TIMEOUT_SEC = 120;
85
86
  export const BASH_MAX_TIMEOUT_SEC = 600;
86
87
  export const BASH_DEFAULT_TIMEOUT_MS = BASH_DEFAULT_TIMEOUT_SEC * 1000;
@@ -109,10 +110,6 @@ function validTimeoutMs(n) {
109
110
  const floored = Math.floor(n);
110
111
  return bashTimeoutDefect(floored) === undefined ? floored : undefined;
111
112
  }
112
- export function envErrorDetail(message) {
113
- const trimmed = (message ?? "").trim();
114
- return trimmed === "" ? "the execution environment reported no reason" : trimmed;
115
- }
116
113
  let announcedTimeoutConfigBySink = new WeakMap();
117
114
  const announcedTimeoutConfigConsole = new Set();
118
115
  function timeoutConfigLedger(onNotice) {
@@ -332,21 +329,24 @@ export function countLines(s) {
332
329
  export function seededFileUnchangedReminder(filePath, mark) {
333
330
  return `${openSystemReminder(mark)}This file is already in your context (see "Contents of ${filePath}" above) and has not changed on disk. Use that content instead of re-reading.</system-reminder>`;
334
331
  }
335
- export function isReadDedupStubResult(resultText) {
336
- return (resultText.includes("unchanged since you last read it") ||
337
- resultText.includes("has not changed on disk. Use that content instead of re-reading"));
338
- }
339
332
  export function seedReadFileStateFromContext(state, key, content) {
340
- state.set(key, { hash: sha256(normalizeFileText(content)), totalLines: countLines(content), truncated: false, lastReadAt: Date.now(), seededFromContext: true });
333
+ const hash = sha256(normalizeFileText(content));
334
+ state.set(key, { hash, totalLines: countLines(content), truncated: false, lastReadAt: Date.now(), seededFromContext: true });
335
+ return hash;
341
336
  }
342
337
  export function seedReadFileStateFromTranscript(state, key, content, lastReadAt, transmission) {
343
338
  const text = normalizeFileText(content);
344
- state.set(key, { hash: sha256(text), totalLines: countLines(text), truncated: false, lastReadAt, ...(transmission !== undefined ? { transmittedByToolCallId: transmission } : {}) });
339
+ state.set(key, { hash: sha256(text), totalLines: countLines(text), truncated: false, lastReadAt, ...(transmission !== undefined ? { witnesses: [transmission] } : {}) });
340
+ }
341
+ export function entriesCarriedAcrossLegs(entries) {
342
+ const kept = [];
343
+ for (const [key, entry] of entries)
344
+ if (entry.seededFromContext !== true)
345
+ kept.push([key, entry]);
346
+ return kept;
345
347
  }
346
348
  export async function inheritSessionReadFileState(target, inherited, judgeKey) {
347
- for (const [key, entry] of inherited) {
348
- if (entry.seededFromContext === true)
349
- continue;
349
+ for (const [key, entry] of entriesCarriedAcrossLegs(inherited)) {
350
350
  const judged = await judgeKey(key);
351
351
  if (judged !== undefined)
352
352
  target.set(judged, entry);
@@ -354,7 +354,9 @@ export async function inheritSessionReadFileState(target, inherited, judgeKey) {
354
354
  }
355
355
  export function readFileStateAfterSummary(state, preserveKeys) {
356
356
  const preserve = new Set(preserveKeys);
357
- return new Map([...state].filter(([k, v]) => v.seededFromContext === true || preserve.has(k)));
357
+ return new Map([...state]
358
+ .filter(([k, v]) => v.seededFromContext === true || preserve.has(k))
359
+ .map(([k, v]) => [k, v.witnesses !== undefined && v.witnesses.length > 1 ? { ...v, witnesses: v.witnesses.slice(-1) } : v]));
358
360
  }
359
361
  export function applyContextShrinkToReadFileState(state, shrink) {
360
362
  if (shrink.kind === "transmissions-gone") {
@@ -362,15 +364,26 @@ export function applyContextShrinkToReadFileState(state, shrink) {
362
364
  return;
363
365
  const cleared = new Set(shrink.transmissions);
364
366
  for (const [k, v] of [...state]) {
365
- if (v.transmittedByToolCallId !== undefined && cleared.has(v.transmittedByToolCallId))
367
+ if (v.witnesses === undefined)
368
+ continue;
369
+ const left = v.witnesses.filter((w) => !cleared.has(w));
370
+ if (left.length === v.witnesses.length)
371
+ continue;
372
+ if (left.length === 0)
366
373
  state.delete(k);
374
+ else
375
+ state.set(k, { ...v, witnesses: left });
367
376
  }
368
377
  return;
369
378
  }
370
379
  const surviving = readFileStateAfterSummary(state, shrink.preserveKeys ?? []);
371
- for (const k of [...state.keys()])
372
- if (!surviving.has(k))
380
+ for (const k of [...state.keys()]) {
381
+ const kept = surviving.get(k);
382
+ if (kept === undefined)
373
383
  state.delete(k);
384
+ else if (kept !== state.get(k))
385
+ state.set(k, kept);
386
+ }
374
387
  }
375
388
  export async function enoentMessage(env, key, cwd, signal, readDeny) {
376
389
  let msg = `File does not exist. Note: your current working directory is ${cwd}.`;
@@ -4,6 +4,7 @@ import { type ReadFileState } from "./safety.js";
4
4
  import type { ContainmentFace } from "./containment-face.js";
5
5
  import { type WriteDenyMatcher } from "./read-deny.js";
6
6
  import { type CwdRef } from "./fs-shared.js";
7
+ import type { ToolResultStore } from "../../core/tool-result-store.js";
7
8
  /**
8
9
  * The `beforeWrite` CONTENT hook, mounted here rather than in ToolPolicy because only this band sees
9
10
  * the FINAL text an Edit/NotebookEdit produces — the applied old→new full text is what actually lands
@@ -19,6 +20,18 @@ export type { BeforeWriteRequest, BeforeWriteResult, BeforeWriteHook, TrackEditR
19
20
  export type WriteRootSeat = string | (() => string);
20
21
  export declare function createEditFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
21
22
  export declare function createWriteFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
23
+ /** The reads SaveToolResult makes of the run's tool-result store: the one way a ref is read (text first, then bytes). */
24
+ export type KeptBytesReader = Pick<ToolResultStore, "get" | "bytesOf">;
25
+ /**
26
+ * SaveToolResult — writes the bytes a tool result kept in the run's tool-result store (the ref its line named) into a NEW file.
27
+ * The lane is Edit's create lane step for step: the path resolved and confined as every write tool's (`resolveKey`), an existing
28
+ * path refused, the write gate over the bytes themselves (`beforeWrite`), the first-touch history ("did not exist"), and the
29
+ * final write exclusive where the environment can make it so — a lost create race answers `already_exists`, a moved target
30
+ * `precondition_failed`, each in its own sentence; an environment with neither atomic seam keeps Edit's two-step create (the
31
+ * same accepted residue). The ref is read the way every reader reads one: a ref holding text is refused (it is ReadToolResult's),
32
+ * and one holding neither is the honest miss.
33
+ */
34
+ export declare function createSaveToolResultTool(env: ExecutionEnv, store: KeptBytesReader, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
22
35
  /**
23
36
  * design v1.163 — NotebookEdit: replace/insert/delete a single cell in a .ipynb. CC-parity tool over the SAME hand-band
24
37
  * safety skeleton as Edit/Write (resolveKey containment → requireRead read-before-edit → checkStale content-hash
@@ -5,8 +5,10 @@ import { sha256, resolveKey, violationText, violationDetails, requireRead, check
5
5
  import { decodeTextBytes, encodeTextForFile, normalizeEditText, normalizeFileText } from "./encoding.js";
6
6
  import { seatForCall } from "./read-deny.js";
7
7
  import { MAX_EDIT_BYTES, decodeEditBytes, tooLargeToEditMessage, malformedBodyMessage, persistedTextOf, notReadRefusalText, enoentMessage, FILE_STATE_TRAILER, FILE_PATH_PARAMS, coerceWriteArguments, ipynbRedirect, countLines, applyRecordedEdit, } from "./fs-shared.js";
8
+ import { envErrorDetail } from "./env-error-detail.js";
8
9
  import { toolFace } from "../../core/tool-catalog-entries.js";
9
10
  import { fileArgPath } from "../../core/tool-registry.js";
11
+ import { SAVE_TOOL_RESULT_NAME } from "../../core/tool-result-bytes.js";
10
12
  import { thrownText } from "../../core/thrown-value.js";
11
13
  async function envFinalWrite(env, key, content, signal, opts) {
12
14
  const fireEdited = () => {
@@ -162,7 +164,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
162
164
  const singleOld = batch ? undefined : a.old_string;
163
165
  const exists = await env.exists(r.key, ctx.signal);
164
166
  if (!exists.ok)
165
- return errorResult(`Error (Edit): cannot stat "${path}": ${exists.error.message}`);
167
+ return errorResult(`Error (Edit): cannot stat "${path}": ${envErrorDetail(exists.error.message)}`);
166
168
  if (!exists.value) {
167
169
  if (singleOld === "") {
168
170
  const created = a.new_string ?? "";
@@ -180,9 +182,9 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
180
182
  return errorResult(`Error (Edit): cannot create "${path}": file already exists (created concurrently since the existence check). Read the file first, then edit it normally (or Write after the Read to overwrite it).`);
181
183
  }
182
184
  if (write.error.code === "precondition_failed") {
183
- return errorResult(`Error (Edit): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${write.error.message.slice(0, 512)}) — the on-disk state at that path changed between the existence check and the write (something may now exist there, or the path may now resolve somewhere else, e.g. through a symlink). Nothing was written. Read the path to see what is actually there before acting on it.`);
185
+ return errorResult(`Error (Edit): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${envErrorDetail(write.error.message)}) — the on-disk state at that path changed between the existence check and the write (something may now exist there, or the path may now resolve somewhere else, e.g. through a symlink). Nothing was written. Read the path to see what is actually there before acting on it.`);
184
186
  }
185
- return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
187
+ return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
186
188
  }
187
189
  const createdNorm = normalizeFileText(created);
188
190
  state.set(r.key, { hash: sha256(createdNorm), totalLines: countLines(createdNorm), truncated: false, lastReadAt: Date.now() });
@@ -200,7 +202,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
200
202
  if (singleOld === "") {
201
203
  const preBin = await env.readBinaryFile(r.key, ctx.signal);
202
204
  if (!preBin.ok)
203
- return errorResult(`Error (Edit): cannot read "${path}": ${preBin.error.message}`);
205
+ return errorResult(`Error (Edit): cannot read "${path}": ${envErrorDetail(preBin.error.message)}`);
204
206
  if (preBin.value.byteLength > MAX_EDIT_BYTES) {
205
207
  return errorResult(tooLargeToEditMessage(path, preBin.value.byteLength));
206
208
  }
@@ -230,7 +232,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
230
232
  const encodedOverwrite = encodeTextForFile(newContent, preDec.encoding, preDec.endings);
231
233
  const write = await envFinalWrite(env, r.key, encodedOverwrite, ctx.signal, { track: trackedOverwrite, edited: { hook: onEdited, tool: "Edit", path } });
232
234
  if (!write.ok)
233
- return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
235
+ return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
234
236
  const persistedOverwrite = persistedTextOf(encodedOverwrite);
235
237
  state.set(r.key, { hash: sha256(persistedOverwrite), totalLines: countLines(persistedOverwrite), truncated: false, lastReadAt: Date.now() });
236
238
  return {
@@ -246,7 +248,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
246
248
  return errorResult(await notReadRefusalText(env, "Edit", r.key, notRead, ctx.signal, READ_REFUSED_ESCAPE_HINT));
247
249
  const readBin = await env.readBinaryFile(r.key, ctx.signal);
248
250
  if (!readBin.ok)
249
- return errorResult(`Error (Edit): cannot read "${path}": ${readBin.error.message}`);
251
+ return errorResult(`Error (Edit): cannot read "${path}": ${envErrorDetail(readBin.error.message)}`);
250
252
  if (readBin.value.byteLength > MAX_EDIT_BYTES) {
251
253
  return errorResult(tooLargeToEditMessage(path, readBin.value.byteLength));
252
254
  }
@@ -307,7 +309,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
307
309
  const encodedEdit = encodeTextForFile(working, decoded.encoding, decoded.endings);
308
310
  const write = await envFinalWrite(env, r.key, encodedEdit, ctx.signal, { track: trackedEdit, edited: { hook: onEdited, tool: "Edit", path } });
309
311
  if (!write.ok)
310
- return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
312
+ return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
311
313
  const persistedEdit = persistedTextOf(encodedEdit);
312
314
  state.set(r.key, { hash: sha256(persistedEdit), totalLines: countLines(persistedEdit), truncated: false, lastReadAt: Date.now() });
313
315
  const a0 = appliedEdits[0];
@@ -371,7 +373,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
371
373
  return errorResult(violationText("Write", r.violation), violationDetails(r.violation));
372
374
  const exists = await env.exists(r.key, ctx.signal);
373
375
  if (!exists.ok)
374
- return errorResult(`Error (Write): cannot stat "${path}": ${exists.error.message}`);
376
+ return errorResult(`Error (Write): cannot stat "${path}": ${envErrorDetail(exists.error.message)}`);
375
377
  let originalFile;
376
378
  if (exists.value) {
377
379
  const notRead = requireRead(state, r.key);
@@ -380,7 +382,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
380
382
  }
381
383
  const readBin = await env.readBinaryFile(r.key, ctx.signal);
382
384
  if (!readBin.ok)
383
- return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${readBin.error.message}`);
385
+ return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${envErrorDetail(readBin.error.message)}`);
384
386
  const decodedPrev = decodeTextBytes(readBin.value);
385
387
  if (decodedPrev.malformed)
386
388
  return errorResult(malformedBodyMessage("Write", path, decodedPrev.malformed));
@@ -397,7 +399,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
397
399
  const encodedWrite = encodeTextForFile(content, decodedPrev.encoding, "preserve");
398
400
  const write = await envFinalWrite(env, r.key, encodedWrite, ctx.signal, { track: trackedWrite, edited: { hook: onEdited, tool: "Write", path } });
399
401
  if (!write.ok)
400
- return errorResult(`Error (Write): cannot write "${path}": ${write.error.message}`);
402
+ return errorResult(`Error (Write): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
401
403
  const persistedWrite = persistedTextOf(encodedWrite);
402
404
  state.set(r.key, { hash: sha256(persistedWrite), totalLines: countLines(persistedWrite), truncated: false, lastReadAt: Date.now() });
403
405
  return {
@@ -413,7 +415,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
413
415
  return errorResult(trackedCreate.refusal);
414
416
  const write = await envFinalWrite(env, r.key, content, ctx.signal, { track: trackedCreate, edited: { hook: onEdited, tool: "Write", path } });
415
417
  if (!write.ok)
416
- return errorResult(`Error (Write): cannot write "${path}": ${write.error.message}`);
418
+ return errorResult(`Error (Write): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
417
419
  const totalLines = countLines(content);
418
420
  state.set(r.key, { hash: sha256(normalizeFileText(content)), totalLines, truncated: false, lastReadAt: Date.now() });
419
421
  void originalFile;
@@ -426,6 +428,60 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
426
428
  write.prepareArguments = coerceWriteArguments;
427
429
  return write;
428
430
  }
431
+ export function createSaveToolResultTool(env, store, rootCanonical, cwdRef, additionalRoots, beforeWrite, trackEdit, onEdited, writeFace, writeDeny) {
432
+ return defineTool({
433
+ name: SAVE_TOOL_RESULT_NAME,
434
+ ...toolFace("save-tool-result"),
435
+ description: "Writes the binary content a tool result kept (its line names a ref) into a new file.\n" +
436
+ "\n" +
437
+ "- `ref` is the ref the tool result named; `file_path` is where to write it.\n" +
438
+ "- The path must not exist yet: this tool creates files, it never overwrites one.",
439
+ parameters: Type.Object({
440
+ ref: Type.String({ description: "The ref the tool result named for its kept bytes." }),
441
+ ...FILE_PATH_PARAMS,
442
+ }),
443
+ execute: async (args, ctx) => {
444
+ const ref = args.ref;
445
+ if (typeof ref !== "string" || ref === "")
446
+ return errorResult(`Error (SaveToolResult): ref is required.`);
447
+ const path = fileArgPath(args);
448
+ if (path === undefined)
449
+ return errorResult(`Error (SaveToolResult): file_path is required.`);
450
+ const r = await resolveKey(env, rootOf(rootCanonical), path, ctx.signal, cwdRef?.current, additionalRoots, undefined, seatForCall(writeDeny, ctx.toolCallId), writeFace?.());
451
+ if (!r.ok)
452
+ return errorResult(violationText(SAVE_TOOL_RESULT_NAME, r.violation), violationDetails(r.violation));
453
+ if ((await store.get(ref, { limit: 0 })) !== undefined) {
454
+ return errorResult(`Error (SaveToolResult): ref "${ref.slice(0, 600)}" holds text, not kept bytes — read it with ReadToolResult.`);
455
+ }
456
+ const kept = await store.bytesOf?.(ref);
457
+ if (kept === undefined)
458
+ return errorResult(`No kept bytes for ref "${ref.slice(0, 600)}" — they may have expired, or this run's tool-result store does not hold them. Nothing was written.`);
459
+ const exists = await env.exists(r.key, ctx.signal);
460
+ if (!exists.ok)
461
+ return errorResult(`Error (SaveToolResult): cannot stat "${path.slice(0, 512)}": ${envErrorDetail(exists.error.message)}`);
462
+ if (exists.value)
463
+ return errorResult(`Error (SaveToolResult): "${path.slice(0, 512)}" already exists — this tool only creates new files; choose a path that does not exist. Nothing was written.`);
464
+ const bytes = await kept.bytes();
465
+ const gated = await gateToolWrite(beforeWrite, SAVE_TOOL_RESULT_NAME, path, r.key, bytes);
466
+ if (gated !== undefined)
467
+ return errorResult(gated);
468
+ const tracked = await trackToolEdit(trackEdit, SAVE_TOOL_RESULT_NAME, path, r.key, ctx.signal);
469
+ if (tracked.refusal !== undefined)
470
+ return errorResult(tracked.refusal);
471
+ const write = await envFinalWrite(env, r.key, bytes, ctx.signal, { exclusive: true, track: tracked, edited: { hook: onEdited, tool: SAVE_TOOL_RESULT_NAME, path } });
472
+ if (!write.ok) {
473
+ if (write.error.code === "already_exists") {
474
+ return errorResult(`Error (SaveToolResult): cannot create "${path.slice(0, 512)}": file already exists (created concurrently since the existence check). Nothing was written; choose another path.`);
475
+ }
476
+ if (write.error.code === "precondition_failed") {
477
+ return errorResult(`Error (SaveToolResult): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${envErrorDetail(write.error.message)}) — the on-disk state at that path changed between the existence check and the write. Nothing was written.`);
478
+ }
479
+ return errorResult(`Error (SaveToolResult): cannot write "${path.slice(0, 512)}": ${envErrorDetail(write.error.message)}`);
480
+ }
481
+ return `Wrote ${bytes.byteLength} bytes${kept.mediaType !== undefined ? ` (${kept.mediaType})` : ""} from ref "${ref}" to ${path}.`;
482
+ },
483
+ });
484
+ }
429
485
  const notebookNotIpynbMessage = (notebookPath) => `Error (NotebookEdit): "${notebookPath}" is not a .ipynb file; use Edit for other file types.`;
430
486
  const NOTEBOOK_CELL_TYPE_REQUIRED_MESSAGE = `Error (NotebookEdit): Cell type is required when using edit_mode=insert.`;
431
487
  const NOTEBOOK_CELL_ID_REQUIRED_MESSAGE = `Error (NotebookEdit): cell_id is required for replace/delete.`;
@@ -491,7 +547,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
491
547
  return errorResult(await notReadRefusalText(env, "NotebookEdit", r.key, notRead, ctx.signal, READ_REFUSED_ESCAPE_HINT));
492
548
  const readBin = await env.readBinaryFile(r.key, ctx.signal);
493
549
  if (!readBin.ok)
494
- return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${readBin.error.message}`);
550
+ return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${envErrorDetail(readBin.error.message)}`);
495
551
  const decodedNb = decodeTextBytes(readBin.value);
496
552
  if (decodedNb.malformed)
497
553
  return errorResult(malformedBodyMessage("NotebookEdit", notebook_path, decodedNb.malformed));
@@ -568,7 +624,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
568
624
  return errorResult(trackedNb.refusal);
569
625
  const w = await envFinalWrite(env, r.key, encodeTextForFile(updated, decodedNb.encoding, decodedNb.endings), ctx.signal, { track: trackedNb, edited: { hook: onEdited, tool: "NotebookEdit", path: notebook_path } });
570
626
  if (!w.ok)
571
- return errorResult(`Error (NotebookEdit): cannot write "${notebook_path}": ${w.error.message}`);
627
+ return errorResult(`Error (NotebookEdit): cannot write "${notebook_path}": ${envErrorDetail(w.error.message)}`);
572
628
  state.set(r.key, { hash: sha256(updated), totalLines: countLines(updated), truncated: false, lastReadAt: Date.now() });
573
629
  const nbDetails = {
574
630
  type: "notebook-edit",
@@ -13,11 +13,14 @@ export * from "./fs-bash.js";
13
13
  export * from "./read-deny.js";
14
14
  export { readDenyHomesOf } from "./read-deny-home.js";
15
15
  import type { ShellReadAdmission } from "./shell-read-check.js";
16
+ import type { CommandSandboxSeat } from "../../core/command-sandbox.js";
16
17
  export { BASH_CLASSIFY_EXTRA_ALLOW, bashClassifyDefaultAllow } from "./bash-readonly-classifier.js";
17
18
  import { type ReadDenyEntry } from "./read-deny.js";
18
19
  import { type ContainmentFace } from "./containment-face.js";
19
20
  export * from "./containment-face.js";
20
21
  import { type CwdRef } from "./fs-shared.js";
22
+ import { type KeptBytesReader } from "./fs-write.js";
23
+ import type { ContextRoomSeat } from "../../core/runner/context-room.js";
21
24
  /** Options for {@link createHandsToolkit}. */
22
25
  export interface HandsToolkitOptions {
23
26
  /** CC --add-dir parity: extra allowed containment roots (canonical). Widens file-tool containment
@@ -59,10 +62,18 @@ export interface HandsToolkitOptions {
59
62
  * consumer mounting the read-only band outside the Runner must run `runToolGate` with a station of its own
60
63
  * (`createShellReadStation`). */
61
64
  shellReadAdmission?: ShellReadAdmission;
65
+ /** The run's command sandbox seat (`command-sandbox.ts`), for both shell faces: every command they start hands its call's
66
+ * sandbox instruction to the environment, or is refused. ABSENT ⇒ the starts carry no sandbox (a run that requires none, a
67
+ * library-direct toolkit). */
68
+ commandSandbox?: CommandSandboxSeat;
62
69
  /** The gate's file read station's ADMISSION (`FileReadStation.admitted`, file-read-check.ts), handed to Read / Grep /
63
70
  * Glob / RepoMap: an out-of-root target the gate put to a question and then let through is read once, on the canonical key the
64
71
  * station judged. ABSENT ⇒ no station (a library-direct toolkit): the tools refuse every out-of-root target. */
65
72
  readAdmission?: (toolCallId: string | undefined, canonicalKey: string) => boolean;
73
+ /** The leg's context-room seat, handed to the file reader: Read's `allow_large` raises a text read's limits to the room
74
+ * measured for its call. ABSENT ⇒ no room is measured (a library-direct toolkit): a call that sets the key is told it is not
75
+ * available when it is over the limits. */
76
+ contextRoom?: ContextRoomSeat;
66
77
  /** Commit-message attribution trailer for the `bash` git protocol. Default NONE — attribution is a
67
78
  * deployment identity asset, so the branded deployment sets it; pass `"Name <email>"` to advertise
68
79
  * one, `false` (≡ unset) for no trailer section. */
@@ -131,6 +142,10 @@ export interface HandsToolkitOptions {
131
142
  * of the same name. Runner-wired (reads the harness's own accepted-but-unserved account); absent ⇒ the
132
143
  * shell never auto-backgrounds a running command, exactly as before. */
133
144
  queuedHumanInput?: () => boolean;
145
+ /** Does the cut now aborting a call's turn move an armed running command into the background — see createBashTool's
146
+ * taskOpts field of the same name. Runner-wired on a top-level leg (reads the harness's row for the cut's source); absent
147
+ * ⇒ every cut ends the running command, exactly as before. */
148
+ turnCutMovesCommandAside?: (signal: AbortSignal) => boolean;
134
149
  /** The run's image processor seat (`RunnerDeps.imageProcessor`), for every image this band hands the model (Read, a
135
150
  * rendered PDF page, a Bash data URI): a processor; `false` = none (deterministic no-sharp behavior); undefined =
136
151
  * auto-detect the optional sharp dependency once per process. */
@@ -154,6 +169,9 @@ export interface HandsToolkitOptions {
154
169
  * Purely additive: it cannot refuse a write, and a fault in it is contained in both shapes (a
155
170
  * synchronous throw and a rejected promise), neither of them awaited. */
156
171
  onFileEdited?: FileEditedHook;
172
+ /** The run's tool-result store, when it keeps bytes (its byte arm): the write half then mounts SaveToolResult beside Write, under
173
+ * the same gate, history and edited seats. Absent, or a store without `bytesOf` ⇒ no SaveToolResult. */
174
+ toolResultBytes?: KeptBytesReader;
157
175
  /** See createBashTool's taskOpts field of the same name: whether the Monitor tool is on this run's
158
176
  * roster (the Runner mounts Monitor, this band never does). `false` drops the gh rate-limit hint's
159
177
  * Monitor clause; absent ⇒ the full wording. */
@@ -275,7 +293,7 @@ export declare function backgroundOutputReadExemption(registry: TaskRegistry | u
275
293
  readonly sessionId?: string;
276
294
  }, env: ExecutionEnv): ((canonicalKey: string, c?: {
277
295
  taskId?: string;
278
- principal?: string;
296
+ isolationScope?: string;
279
297
  }) => boolean) | undefined;
280
298
  /**
281
299
  * Build the per-task hand tool band over an injected env + fresh per-task read state.