@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,8 +1,6 @@
1
1
  import { emitTrace } from "../trace.js";
2
- import { performsIo } from "../remote-env.js";
3
- import { hasBackgroundShell } from "../background-shell.js";
4
2
  import { defaultTaskRegistry } from "../task-registry.js";
5
- import { bashReversibilityProbe, activeReadDenyBuiltinTiers, readDenyBuiltinConfigOf, compileReadDeny, createHandsToolkit, deploymentFaceClampNotice, pdfModelCapabilitiesOf, inheritSessionReadFileState, backgroundOutputReadExemption, resolveContainmentFace, seedReadFileStateFromContext, seedReadFileStateFromTranscript, } from "../../tools/fs/index.js";
3
+ import { bashReversibilityProbe, activeReadDenyBuiltinTiers, readDenyBuiltinConfigOf, compileReadDeny, createHandsToolkit, deploymentFaceClampNotice, pdfModelCapabilitiesOf, inheritSessionReadFileState, entriesCarriedAcrossLegs, backgroundOutputReadExemption, resolveContainmentFace, seedReadFileStateFromContext, seedReadFileStateFromTranscript, } from "../../tools/fs/index.js";
6
4
  import { resolveKey, rootAdmittingArtifactStore, sha256 } from "../../tools/fs/safety.js";
7
5
  import { thrownText } from "../thrown-value.js";
8
6
  import { carryReadFace } from "../../tools/fs/read-deny-home.js";
@@ -11,7 +9,7 @@ import { createShellOverflowSpoolFence } from "../../tools/fs/fs-shared.js";
11
9
  import { createShellReadStation } from "../../tools/fs/shell-read-check.js";
12
10
  import { judgeReadFloorKept, readFloorSeat } from "../../tools/fs/read-floor.js";
13
11
  import { createFileReadStation } from "../../tools/fs/file-read-check.js";
14
- import { isShellFaceToolName, predictMountedToolNames, readTargetToolNames } from "../tool-registry.js";
12
+ import { isShellFaceToolName, readTargetToolNames } from "../tool-registry.js";
15
13
  import { normalizeFileText } from "../../tools/fs/encoding.js";
16
14
  import { wholeFileRecordsFromTranscript } from "./session-file-state-replay.js";
17
15
  import { deliverEngineNotice } from "../types.js";
@@ -80,6 +78,7 @@ export function resolveHandsLessReadFace(input) {
80
78
  return {
81
79
  readFileStateForCheckpoint: undefined,
82
80
  seedContextFiles: undefined,
81
+ seededCopies: new Map(),
83
82
  handsCwdRef: undefined,
84
83
  workspaceStateSettle: undefined,
85
84
  wsSnapshot: undefined,
@@ -119,6 +118,7 @@ export async function prepareHandsMount(input) {
119
118
  let readFileStateForCheckpoint;
120
119
  let sealReadStateSeat;
121
120
  let seedContextFiles;
121
+ const seededCopies = new Map();
122
122
  let handsCwdRef;
123
123
  let workspaceStateSettle;
124
124
  let wsSnapshot;
@@ -183,19 +183,19 @@ export async function prepareHandsMount(input) {
183
183
  for (const a of [additionalRootsCanonical, additionalReadRootsCanonical])
184
184
  a.splice(0, a.length, ...new Set(a));
185
185
  grantReadRoot = readRootGrantOver({ env: executionEnv, writeRoots: additionalRootsCanonical, readRoots: additionalReadRootsCanonical, artifactStore: artifactStoreRef });
186
- const readFileState = new Map((resume?.seed.readFileState ?? []).map(([k, v]) => [rebaseRestoredPath(k), v]));
186
+ const readFileState = new Map(entriesCarriedAcrossLegs(resume?.seed.readFileState ?? []).map(([k, v]) => [rebaseRestoredPath(k), v]));
187
187
  readFileStateForCheckpoint = readFileState;
188
188
  seedContextFiles = async (files) => {
189
189
  for (const f of files) {
190
190
  const rk = await readRoots.ready().then(() => resolveKey(executionEnv, rootCanonical, f.path, undefined, undefined, readRoots(), undefined, undefined, resolvedReadFace));
191
191
  if (rk.ok)
192
- seedReadFileStateFromContext(readFileState, rk.key, f.content);
192
+ seededCopies.set(rk.key, seedReadFileStateFromContext(readFileState, rk.key, f.content));
193
193
  }
194
194
  };
195
- const handsIncludeShell = performsIo(executionEnv) === true;
196
- const handsReadOnly = spec.handsReadOnly === true;
197
- backgroundTaskToolsActive = handsIncludeShell && !handsReadOnly && hasBackgroundShell(executionEnv);
198
- const shellFaceHere = [...predictMountedToolNames(new Set(backgroundTaskToolsActive ? ["hands", "backgroundTasks"] : ["hands"]))].filter(isShellFaceToolName);
195
+ const handsIncludeShell = roster.mounts.holds("bash") || roster.mounts.holds("bash-readonly");
196
+ const handsReadOnly = !roster.mounts.holds("edit");
197
+ backgroundTaskToolsActive = roster.mounts.holds("monitor");
198
+ const shellFaceHere = roster.mounts.holding((e) => isShellFaceToolName(e.name));
199
199
  const checkpointTracked = resume?.seed.handsCwd !== undefined;
200
200
  wsSnapshot = checkpointTracked || !(handsIncludeShell && !handsReadOnly) ? undefined : await session.getWorkspaceState().catch(() => undefined);
201
201
  rebaseWsPath = (p) => (wsSnapshot === undefined || wsSnapshot.taskRoot === rootCanonical ? p : rebaseWorkspacePath(p, wsSnapshot.taskRoot, rootCanonical));
@@ -283,7 +283,7 @@ export async function prepareHandsMount(input) {
283
283
  if (k === undefined)
284
284
  continue;
285
285
  const entry = readFileState.get(k);
286
- if (entry === undefined || entry.seededFromContext === true)
286
+ if (entry === undefined)
287
287
  continue;
288
288
  const cur = await executionEnv.readTextFile(abs);
289
289
  if (cur.ok && entry.hash === sha256(normalizeFileText(cur.value)))
@@ -358,11 +358,14 @@ export async function prepareHandsMount(input) {
358
358
  reminderMark: input.reminderMark,
359
359
  reminderDisclosureCounts: input.reminderDisclosureCounts,
360
360
  ...(input.modelFileReaderSeat !== undefined ? { modelFileReaderSeat: input.modelFileReaderSeat } : {}),
361
+ ...(input.contextRoom !== undefined ? { contextRoom: input.contextRoom } : {}),
361
362
  ...(input.trackFileEdit !== undefined ? { trackFileEdit: input.trackFileEdit } : {}),
362
363
  ...(input.onFileEdited !== undefined ? { onFileEdited: input.onFileEdited } : {}),
364
+ ...(input.offloadStore !== undefined ? { toolResultBytes: input.offloadStore } : {}),
363
365
  includeShell: handsIncludeShell,
364
366
  readOnly: handsReadOnly,
365
367
  ...(shellReadStation !== undefined ? { shellReadAdmission: shellReadStation.admit } : {}),
368
+ ...(input.commandSandbox !== undefined ? { commandSandbox: input.commandSandbox } : {}),
366
369
  ...(fileReadStation !== undefined ? { readAdmission: fileReadStation.admitted } : {}),
367
370
  ...(handsCwdRef ? { cwdRef: handsCwdRef } : {}),
368
371
  taskRegistry: defaultTaskRegistry,
@@ -375,6 +378,7 @@ export async function prepareHandsMount(input) {
375
378
  ...(internals?.detachHub !== undefined ? { detachHub: internals.detachHub } : {}),
376
379
  onToolProgress: (body) => input.toolProgressRef.current?.emit(body),
377
380
  queuedHumanInput: () => input.harnessRef.current?.hasPendingUserInput() === true,
381
+ ...(input.delegation.isDelegatedChild ? {} : { turnCutMovesCommandAside: (signal) => input.harnessRef.current?.cutMovesArmedCommandAside(signal) === true }),
378
382
  ...(deps.onNotice !== undefined ? { onNotice: deps.onNotice } : {}),
379
383
  pdfModelCapabilities: pdfModelCapabilitiesOf(model),
380
384
  ...(deps.hands?.bashReadonlyAllow !== undefined ? { bashReadonlyAllow: deps.hands.bashReadonlyAllow } : {}),
@@ -420,7 +424,8 @@ export async function prepareHandsMount(input) {
420
424
  deps.onError?.(new Error(`spec.tools ${collisions.length > 1 ? "entries collide" : "entry collides"} with the built-in hands tool band — the built-in wins each contested name: ${collisions.join("; ")}. Rename the colliding name, or don't inject executionEnv if you intend to replace the band.`), { phase: "config", sessionId });
421
425
  }
422
426
  }
423
- roster.mountAll(band.map((t) => (envHandToolNames.add(t.name), firstPartyOffload(afterCallTables(input.personRows, t)))), { source: "builtin", mountedBy: "hands" });
427
+ roster.mounts.know({ "seat.offloadBytes": input.offloadStore?.bytesOf !== undefined });
428
+ roster.mountAll(band.filter((t) => roster.mounts.judgeTool(t)).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(afterCallTables(input.personRows, t)))), { source: "builtin", mountedBy: "hands" });
424
429
  const shellFloor = effectiveShellGate;
425
430
  if (handsIncludeShell && spec.handsReadOnly !== true) {
426
431
  const installShellSeat = (name) => {
@@ -441,6 +446,7 @@ export async function prepareHandsMount(input) {
441
446
  return {
442
447
  readFileStateForCheckpoint,
443
448
  seedContextFiles,
449
+ seededCopies,
444
450
  handsCwdRef,
445
451
  workspaceStateSettle,
446
452
  wsSnapshot,
@@ -44,7 +44,7 @@ import type { OwnOrgAdmissionVerdict } from "../memory-admission.js";
44
44
  import type { DelegationContentSafety } from "../memory-engine/delegation-provenance.js";
45
45
  import type { SessionPermissionRules } from "../session-policy-store.js";
46
46
  import { type SessionStore } from "../session.js";
47
- import { type PlacementTarget } from "../remote-env.js";
47
+ import type { PlacementTarget } from "../remote-env.js";
48
48
  import { type OnAsk, type ToolPolicy } from "../tool-policy.js";
49
49
  import type { PathRuleBases } from "../permission-rule-model.js";
50
50
  import type { PermissionMode, RunnerDeps, RuntimeCaps, ShellGateDoctrine, TaskEvent, TaskSpec, ToolExecuteContext, ToolSpec } from "../types.js";
@@ -52,17 +52,23 @@ import { PermissionModeController } from "../mode-policy.js";
52
52
  import { type SkillGrantTable } from "../skill-grant.js";
53
53
  import type { InheritedGate, Prepared, PrepareResume, RunInternals, StopForDenialLimit, ToolFaceSnapshot, WriteFaceSeat } from "./contracts.js";
54
54
  import type { DelegationSettlementSeat } from "../tool-spec.js";
55
+ import type { ToolMountFacts } from "../tool-mount-facts.js";
55
56
  export interface PrepareInheritedGateInput {
56
57
  /** borrowed-readonly — the REBOUND spec. Read: `shellGate` (the own doctrine the chain fold tightens), `durableApproval`
57
58
  * (the mandate tests + the children's copy), `onQuestion` (the frozen question seat), `handsReadOnly` / `interactiveTools`
58
59
  * / `oneShot` / `clientContext` / `principal` / `additionalDirectories` / `additionalReadDirectories` / `envFacts` /
59
60
  * `memoryPersistenceCapable` / `getApiKeyAndHeaders` / `backgroundScope` / `enablePlanMode` (the ctx enrichment's
60
61
  * trusted seats). Never mutated. */
61
- spec: Pick<TaskSpec, "shellGate" | "durableApproval" | "onQuestion" | "handsReadOnly" | "interactiveTools" | "oneShot" | "clientContext" | "principal" | "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "memoryPersistenceCapable" | "getApiKeyAndHeaders" | "backgroundScope" | "enablePlanMode" | "excludeAllTools">;
62
+ spec: Pick<TaskSpec, "shellGate" | "durableApproval" | "onQuestion" | "handsReadOnly" | "interactiveTools" | "oneShot" | "clientContext" | "principal" | "isolationScope" | "additionalDirectories" | "additionalReadDirectories" | "envFacts" | "memoryPersistenceCapable" | "getApiKeyAndHeaders" | "backgroundScope" | "enablePlanMode" | "excludeAllTools">;
62
63
  /** borrowed-readonly — the seat this run hands its children (`checkpointSeatOf`, minted once by the driver after the config doors): the ctx's `checkpointStoreForChildren`, absent when the run has no seat. */
63
64
  checkpointSeat: import("../checkpoint-seat.js").CheckpointSeat | undefined;
64
65
  /** borrowed-readonly — this leg's checkpoint scope (the driver's one `checkpointScopeOf` derivation): the ctx's `checkpointScopeForChildren`, which every delegation lane copies into its children's internals. */
65
66
  checkpointScope: string;
67
+ /** borrowed-readonly — the leg's registry scope (`taskScope`): the scope its own session box mounts in, which a root leg hands
68
+ * its children as the tree's `rootSessionScope`. */
69
+ taskScope: string;
70
+ /** borrowed-readonly — the run's committed-pause holder (`Prepared.pausedRef`), read at call time by the ctx's `hostRunParked`. */
71
+ pausedRef: Prepared["pausedRef"];
66
72
  /** borrowed-readonly — the deployment's host floor as the config doors compiled it (`RunnerDeps.hostFloor`): the ctx's `hostFloor`, absent when none is declared. */
67
73
  hostFloor: import("../host-floor.js").HostFloor | undefined;
68
74
  /** borrowed-readonly — the deployment seats: `autoMode.denialLimit` (the rebuilt trackers' bounds), `memoryScopeAdmission` /
@@ -80,7 +86,7 @@ export interface PrepareInheritedGateInput {
80
86
  /** borrowed-readonly — the trusted spawn-side channel: `inheritedGate` (the LIVE half of the chain fold), `ownOrgAdmissionRef`
81
87
  * (the same-session continuation's freeze), `delegationProvenance` (the F-012 stamp), and the identity / peer / notification
82
88
  * seats the ctx enrichment forwards. Never mutated. */
83
- internals: Pick<RunInternals, "inheritedGate" | "sessionModeSeats" | "ownOrgAdmissionRef" | "delegationProvenance" | "memoryCaptureAncestors" | "parentTaskId" | "parentSessionId" | "rootSessionId" | "rootSessionIncarnation" | "placementRoot" | "explicitAgentName" | "peerSelfRef" | "peerInboundChainRef" | "onTaskNotification" | "onSubagentSpawn" | "insideFork" | "questionFaceStripped"> | undefined;
89
+ internals: Pick<RunInternals, "inheritedGate" | "sessionModeSeats" | "ownOrgAdmissionRef" | "delegationProvenance" | "memoryCaptureAncestors" | "parentTaskId" | "parentSessionId" | "rootSessionId" | "rootSessionIncarnation" | "rootSessionScope" | "placementRoot" | "explicitAgentName" | "peerSelfRef" | "peerInboundChainRef" | "onTaskNotification" | "onSubagentSpawn" | "onSubtreeActivity" | "insideFork" | "questionFaceStripped"> | undefined;
84
90
  /** borrowed-readonly — the resume leg, or undefined on a fresh one: `seed.inheritedGate` is the CHECKPOINT half of the chain
85
91
  * fold (the trust floor the live half may only tighten), `seed.readFace` the hands-less re-park's carried section. */
86
92
  resume: Pick<PrepareResume, "seed" | "outcome"> | undefined;
@@ -128,8 +134,8 @@ export interface PrepareInheritedGateInput {
128
134
  /** borrowed-readonly — the task's own permission-mode key, screened and snapshotted before the first await (undefined =
129
135
  * declared nothing: a root runs `default`, a child inherits). */
130
136
  permissionModeSeat: PermissionMode | undefined;
131
- /** borrowed-readonly — whether an execution env is wired at all (the full-shell predicate's first term). */
132
- handsEnabled: boolean;
137
+ /** borrowed-readonly — the leg's mount facts as the driver read them once (the full shell's verdict reads them). */
138
+ mountFacts: ToolMountFacts;
133
139
  /** borrowed-readonly — the nested-usage sink the ctx forwards. */
134
140
  reportUsage: ToolExecuteContext["reportUsage"];
135
141
  /** borrowed-readonly — the harness seat (the ctx's model / thinking snapshots read it call-time). Not written here. */
@@ -172,6 +178,7 @@ export interface PrepareInheritedGateInput {
172
178
  /** borrowed-readonly — LATE-BOUND: the per-principal entitlements the caps phase resolves after this one; read only inside
173
179
  * `inheritedGateForChildren` (the two mandate tests), at spawn time. */
174
180
  runtimeCaps: () => RuntimeCaps | undefined;
181
+ /** borrowed-readonly — the driver's one leg fact `approvalParkNotResumable`: the opt-in this leg forwards is its EFFECTIVE one (`effectiveDurableApprovalOf`). */ approvalParkNotResumable: boolean;
175
182
  /** borrowed-readonly — what the leg hands its descendants of its mods bus (`LegMods.handedDown`: without the skills' own
176
183
  * registrations): the chain assembly hands it down as this leg's screening installation. */
177
184
  modBus: LegModBus;
@@ -2,12 +2,13 @@ import { delegationOwnerUnbound } from "./delegation-owner.js";
2
2
  import { forkGovernanceDenial, resolveDelegationEntryCaps } from "../../agents/subagent.js";
3
3
  import { isLiveQuestionFace } from "../ask-question.js";
4
4
  import { parentSpecSeatOf } from "../parent-spec-seat.js";
5
+ import { isolationScopeOf } from "../isolation-scope.js";
5
6
  import { chainJudges, sameInstallation } from "../mods/stations.js";
6
7
  import { childClampSeats, clampSourceOf } from "../child-clamp-seats.js";
7
8
  import { rowFollowsFloor } from "./session-rule-policy.js";
8
9
  import { declaresSubagentPlacement } from "../session.js";
9
- import { performsIo } from "../remote-env.js";
10
- import { durableMandateSourceOf } from "../tool-policy.js";
10
+ import { durableMandateSourceOf, effectiveDurableApprovalOf } from "../tool-policy.js";
11
+ import { askSeamFormOf, reachSetsAside } from "../wiring-manifest.js";
11
12
  import { chainAnchorRecords } from "./child-tree.js";
12
13
  import { defaultTaskRegistry } from "../task-registry.js";
13
14
  import { deliverEngineNotice } from "../types.js";
@@ -17,8 +18,9 @@ import { recordedModeSeed } from "../checkpoint-row-verdict.js";
17
18
  import { frozenSkillGrants } from "../skill-grant.js";
18
19
  import { attachRebuiltDenialTrackers, createDenialLimitStop } from "./denial-limit-arms.js";
19
20
  import { valveLeaves } from "../../agents/tool-filter.js";
21
+ import { mountRowVerdict } from "../tool-mount-plan.js";
20
22
  export function prepareInheritedGate(input) {
21
- const { spec, deps, askSeat, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, delegationCwd, executionEnv, ownedEnv, lockedPreflight, pathRuleAnchors, toolFaceSnapshot, mountsCallerTool, promptLean, resolvedInteractionPosture, permissionModeSeat, handsEnabled, reportUsage, harnessRef, skillGrants, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun } = input;
23
+ const { spec, deps, askSeat, internals, resume, sessions, sessionId, runId, hostTaskId, taskRootFinal, delegationCwd, executionEnv, ownedEnv, lockedPreflight, pathRuleAnchors, toolFaceSnapshot, mountsCallerTool, promptLean, resolvedInteractionPosture, permissionModeSeat, reportUsage, harnessRef, skillGrants, forwardEvent, subagentRetain, taskArtifacts, worktreeIsolation, requestReview, requestStopAfterTurn, enterPlanMode, reminderMark, reminderDisclosureCounts, fileHistoryEnabled, historyScope, historyRoot, historyFs, abortRun } = input;
22
24
  const liveInheritedGate = internals?.inheritedGate;
23
25
  const seedInheritedGate = resume?.seed.inheritedGate;
24
26
  const inheritedAncestorRules = (() => {
@@ -40,7 +42,7 @@ export function prepareInheritedGate(input) {
40
42
  })();
41
43
  const modeSeed = recordedModeSeed(seedInheritedGate);
42
44
  const inheritedShellGate = liveInheritedGate?.shellGate ?? modeSeed.shellGate;
43
- const askView = askSeat.reach === "none" ? liveInheritedGate?.parentConstraints?.map((pc) => (typeof pc.onAsk === "function" ? ((({ onAsk: _person, ...rest }) => rest)(pc)) : pc)) : liveInheritedGate?.parentConstraints;
45
+ const askView = askSeat.reach === "none" ? liveInheritedGate?.parentConstraints?.map((pc) => (reachSetsAside(askSeamFormOf(pc.onAsk)) ? ((({ onAsk: _person, ...rest }) => rest)(pc)) : pc)) : liveInheritedGate?.parentConstraints;
44
46
  const chainView = askView?.map((pc, position) => {
45
47
  if (pc.policy === undefined)
46
48
  return pc;
@@ -178,12 +180,10 @@ export function prepareInheritedGate(input) {
178
180
  readDenyPatterns: input.readDenyAdditionsNormalized(),
179
181
  approvalReach: askSeat.reach,
180
182
  });
181
- const fullShellReachable = handsEnabled &&
182
- performsIo(executionEnv) === true &&
183
- spec.handsReadOnly !== true &&
184
- valveLeaves(spec, toolFaceSnapshot.selector)({ name: "Bash" });
183
+ const fullShellReachable = mountRowVerdict("bash", input.mountFacts, valveLeaves(spec, toolFaceSnapshot.selector));
185
184
  const { gateStopRef, stopForDenialLimit } = createDenialLimitStop({ sessionId, runId, onNotice: deps.onNotice, abort: abortRun });
186
185
  const delegationEntryCapsResolved = resolveDelegationEntryCaps(deps.delegationEntryCaps);
186
+ const isolationScope = isolationScopeOf(spec);
187
187
  const enrichSpecToolCtx = (ctx) => {
188
188
  const agentForkDenial = input.agentForkDenial();
189
189
  const observersActive = input.observersActive();
@@ -192,6 +192,7 @@ export function prepareInheritedGate(input) {
192
192
  const agentStations = input.agentStations();
193
193
  const sendStation = input.sendStation();
194
194
  const rootSessionIncarnation = internals?.rootSessionId !== undefined ? internals.rootSessionIncarnation : input.sessionIncarnation();
195
+ const rootSessionScope = internals?.rootSessionId !== undefined ? internals.rootSessionScope : input.taskScope;
195
196
  return {
196
197
  ...ctx,
197
198
  delegationEntryCaps: delegationEntryCapsResolved,
@@ -202,6 +203,7 @@ export function prepareInheritedGate(input) {
202
203
  modelRef: harnessRef.current?.getModelRef(),
203
204
  thinkingLevel: harnessRef.current?.getThinkingLevel(),
204
205
  principal: spec.principal,
206
+ ...(isolationScope !== undefined ? { isolationScope } : {}),
205
207
  ...(frozenOnAsk !== undefined ? { onAsk: frozenOnAsk } : {}),
206
208
  ...childClampSeats(runClampSource()),
207
209
  ...(frozenOnQuestion !== undefined ? { onQuestion: frozenOnQuestion } : {}),
@@ -248,15 +250,16 @@ export function prepareInheritedGate(input) {
248
250
  delegationProvenanceForChildren,
249
251
  delegationSettlement: delegationSettlementForChildren,
250
252
  ...(autoModeDecider ? { autoModeReview: { decider: autoModeDecider } } : {}),
251
- ...(spec.durableApproval !== undefined ? { durableApprovalForChildren: { ...spec.durableApproval } } : {}),
253
+ ...((own) => (own !== undefined ? { durableApprovalForChildren: { ...own } } : {}))(effectiveDurableApprovalOf({ declared: spec.durableApproval, forceDurableGate: input.runtimeCaps()?.forceDurableGate === true, approvalParkNotResumable: input.approvalParkNotResumable, scope: input.checkpointScope })),
252
254
  ...(input.checkpointSeat !== undefined ? { checkpointStoreForChildren: input.checkpointSeat } : {}),
253
255
  checkpointScopeForChildren: input.checkpointScope,
254
256
  taskRegistry: defaultTaskRegistry,
257
+ hostRunParked: () => input.pausedRef.current !== undefined,
255
258
  taskId: hostTaskId,
256
259
  ...(internals?.parentTaskId !== undefined ? { parentTaskId: internals.parentTaskId } : {}),
257
260
  ...(internals?.parentSessionId !== undefined ? { parentSessionId: internals.parentSessionId } : {}),
258
261
  ...(internals?.rootSessionId !== undefined ? { rootSessionId: internals.rootSessionId } : {}), ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}),
259
- ...(rootSessionIncarnation !== undefined ? { rootSessionIncarnation } : {}),
262
+ ...(rootSessionIncarnation !== undefined ? { rootSessionIncarnation } : {}), ...(rootSessionScope !== undefined ? { rootSessionScope } : {}),
260
263
  delegationOwner: input.delegationOwner,
261
264
  ...(internals?.explicitAgentName !== undefined ? { spawnedAgentName: internals.explicitAgentName } : {}),
262
265
  ...(internals?.peerSelfRef !== undefined ? { peerSelfRef: internals.peerSelfRef } : {}),
@@ -287,6 +290,7 @@ export function prepareInheritedGate(input) {
287
290
  ...(internals?.onTaskNotification ? { onTaskNotification: internals.onTaskNotification } : {}),
288
291
  ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
289
292
  ...(forwardEvent ? { forwardEvent } : {}),
293
+ ...(internals?.onSubtreeActivity ? { onSubtreeActivity: internals.onSubtreeActivity } : {}),
290
294
  ...(internals?.onSubagentSpawn ? { onSubagentSpawn: internals.onSubagentSpawn } : {}),
291
295
  ...(subagentRetain ? { subagentRetain } : {}),
292
296
  ...(worktreeIsolation ? { worktreeIsolation } : {}),
@@ -4,7 +4,8 @@ import { RosterBuilder } from "../tool-roster.js";
4
4
  export function prepareLsp(input) {
5
5
  const { spec, deps, executionEnv, readFloor, taskRootFinal, readFace, sessionId, roster, envHandToolNames } = input;
6
6
  const lspManager = spec.lspManager ?? deps.lspManager;
7
- if (lspManager && readFace) {
7
+ roster.mounts.know({ "lsp.readFace": readFace !== undefined });
8
+ if (roster.mounts.judge("lsp") && lspManager && readFace) {
8
9
  roster.mount(createLspTool(lspManager, { isPathIgnored: gitCheckIgnoreFilter(executionEnv, taskRootFinal, () => readFloor(undefined)), env: executionEnv, readFace }), { source: "builtin", mountedBy: "hands" });
9
10
  envHandToolNames.add("LSP");
10
11
  }
@@ -79,18 +79,25 @@ export function prepareMemoryEngineSession(input) {
79
79
  continue;
80
80
  }
81
81
  const inner = t.execute.bind(t);
82
- const mark = (reason, cause) => {
82
+ const mark = async (reason, cause) => {
83
+ let outcome;
83
84
  try {
84
- pollution?.markPolluted(reason, cause);
85
+ outcome = await pollution?.markPolluted(reason, cause);
85
86
  }
86
87
  catch {
88
+ outcome = "unpersisted";
87
89
  }
90
+ if (outcome !== "unpersisted")
91
+ return;
92
+ const e = new Error("external content withheld (fail-closed): this session's exposure to it could not be recorded durably (the memory control plane refused the pollution marker) — repair the memory control plane or retry");
93
+ e.code = "memory.pollution_mark_failed";
94
+ throw e;
88
95
  };
89
96
  const wrapped = {
90
97
  ...t,
91
98
  execute: async (toolCallId, params, signal, onUpdate) => {
92
99
  if (pollutes) {
93
- mark(`tool "${t.name}" (${origin} content class) was invoked in this session`, "observed");
100
+ await mark(`tool "${t.name}" (${origin} content class) was invoked in this session`, "observed");
94
101
  recordExternal();
95
102
  }
96
103
  if (!isDelegation) {
@@ -107,13 +114,13 @@ export function prepareMemoryEngineSession(input) {
107
114
  ? contentField[0].text
108
115
  : "";
109
116
  const delivered = result?.isError !== true &&
110
- result?.details?.type !== "file_unchanged" &&
111
117
  !headText.startsWith("<system-reminder");
112
118
  const fp = fileArgPath(params);
113
- if (delivered && fp !== undefined && recallTaintJudge(fp)) {
114
- mark(`the "${t.name}" tool delivered the content of an external-origin memory entry file`, "derived");
115
- }
116
- return result;
119
+ const verdict = delivered && fp !== undefined ? await recallTaintJudge(fp) : "clean";
120
+ if (verdict === "clean")
121
+ return result;
122
+ await mark(verdict === "marked" ? `the "${t.name}" tool delivered the content of an external-origin memory entry file` : `the "${t.name}" tool delivered the content of a challenged memory entry file`, "derived");
123
+ return verdict === "challenged" ? withAppendedNote(result, CHALLENGED_ENTRY_READ_NOTE) : result;
117
124
  }
118
125
  let preCallLaunchRows;
119
126
  if (delegationEvidenceAttestedOnly && memoryEngineSession?.settlement !== undefined) {
@@ -139,7 +146,7 @@ export function prepareMemoryEngineSession(input) {
139
146
  return result;
140
147
  const att = readCardAttestation(result?.details);
141
148
  if (att === "external") {
142
- mark(`tool "${t.name}" returned the output of a delegated agent that invoked an external-content-class tool at runtime` +
149
+ await mark(`tool "${t.name}" returned the output of a delegated agent that invoked an external-content-class tool at runtime` +
143
150
  (typeof requested === "string" ? ` (subagent_type "${requested}")` : ""), "observed");
144
151
  recordExternal();
145
152
  }
@@ -151,7 +158,7 @@ export function prepareMemoryEngineSession(input) {
151
158
  (typeof requested === "string" ? ` (subagent_type "${requested}")` : " (no subagent_type named — classified fail-closed)") +
152
159
  (delivery === "launched" ? " — its output enters this session when it finishes" : "");
153
160
  if (!delegationEvidenceAttestedOnly) {
154
- mark(staticFaceReason, "static");
161
+ await mark(staticFaceReason, "static");
155
162
  }
156
163
  else {
157
164
  const receiptDetails = result?.details;
@@ -214,6 +221,19 @@ export function prepareMemoryEngineSession(input) {
214
221
  }
215
222
  return { armed: memoryEngineSession !== undefined || delegationProvenanceChannel !== undefined };
216
223
  }
224
+ const CHALLENGED_ENTRY_READ_NOTE = "[memory] This memory entry file is challenged: the memory tools and the injected memory index withhold it pending host review, so its content is not established memory — treat it as unverified.";
225
+ function withAppendedNote(result, note) {
226
+ if (typeof result === "string")
227
+ return `${result}\n\n${note}`;
228
+ if (typeof result !== "object" || result === null || !("content" in result))
229
+ return result;
230
+ const content = result.content;
231
+ if (typeof content === "string")
232
+ return { ...result, content: `${content}\n\n${note}` };
233
+ if (Array.isArray(content))
234
+ return { ...result, content: [...content, { type: "text", text: note }] };
235
+ return result;
236
+ }
217
237
  function delegationDeliveryOf(result) {
218
238
  if (isNotStartedDelegationResult(result))
219
239
  return "none";
@@ -193,6 +193,10 @@ export interface PrepareMemoryInput {
193
193
  * returned string — #493 单铸), and the RB-276 index seed files whose full disk text rides in the block. */
194
194
  export interface MemoryInjectionComposition {
195
195
  memoryBlock: string | undefined;
196
+ /** The run has no store to persist through and holds the user's conversation: a prompt fact (`memoryStoreAbsent`) —
197
+ * the memory section leads with the catalog's no-persistent-store sentence, rendered in the run's locale. The
198
+ * sentence never enters `memoryBlock`. */
199
+ memoryStoreAbsent?: true;
196
200
  recallDisciplineSegment?: string;
197
201
  seedFiles?: ReadonlyArray<{
198
202
  path: string;
@@ -1,19 +1,19 @@
1
1
  import { isAbsolute, resolve, sep } from "node:path";
2
2
  import { deliverEngineNotice } from "../types.js";
3
3
  import { admitMemoryScopes } from "../memory-admission.js";
4
- import { adoptLegacyRepoDirs, canonicalize, deriveRepoControlPlaneDir, deriveProjectControlDir, deriveProjectMemoryDir, deriveRepoKey, deriveRepoMemoryDir, effectiveControlRootOf, isContainedIn, lookupProjectIdHint, recordProjectIdHint, resolveMemoryEngineRoot, transferMemoryAnnouncements } from "../memory-engine/layout.js";
4
+ import { adoptLegacyRepoDirs, assertRootNotSensitive, canonicalize, deriveRepoControlPlaneDir, deriveProjectControlDir, deriveProjectMemoryDir, deriveRepoKey, deriveRepoMemoryDir, effectiveControlRootOf, isContainedIn, lookupProjectIdHint, recordProjectIdHint, resolveMemoryEngineRoot, transferMemoryAnnouncements } from "../memory-engine/layout.js";
5
5
  import { derivePersonalControlDir, derivePersonalMemoryDir, directoryPinOf, memoryPlaneStore, mergeHarvestReports, mergeInjections, needsDualRoots, parsedProjectPlane, scopePlanesOf } from "../memory-engine/dual-root.js";
6
6
  import { memoryProjectScopeAbsentNotice, normalizeMemorySpec } from "../memory.js";
7
7
  import { deriveSupersededSet, fileGovernanceStore, fileSessionCaptureRecordStore, governanceStoreIsFileOver } from "../memory-engine/consolidation.js";
8
8
  import { shadowNamesOf } from "../memory-engine/shadowing.js";
9
9
  import { mintSystemReminder } from "../reminder-mint.js";
10
- import { MEMORY_ANNOUNCEMENT_CAPTURE_OPTOUT_CODA, MEMORY_ANNOUNCEMENT_READONLY_CODA, MEMORY_CAPTURE_OPTOUT_NOTICE, MEMORY_PREFERENCE_DISCIPLINE, MEMORY_READONLY_NOTICE, MemoryEngine, entryFileHeadCarriesOrigin, memoryCaptureOptedOutNotice, memoryCaptureOptOutUnpersistedNotice, memoryConsolidationRecommendedNotice, memoryHarvestConflictNotice, memoryHarvestQuarantinedNotice, memoryHarvestRefusedNotice, memoryHoldNotices, memoryRecallDisciplineSegment, memoryRestoreWithheldNotice, memorySessionPollutedNotice, memoryUnavailableNotice, pollutionContainmentCounts, } from "../memory-engine/engine.js";
10
+ import { MEMORY_ANNOUNCEMENT_CAPTURE_OPTOUT_CODA, MEMORY_ANNOUNCEMENT_READONLY_CODA, MEMORY_CAPTURE_OPTOUT_NOTICE, MEMORY_PREFERENCE_DISCIPLINE, MEMORY_READONLY_NOTICE, MemoryEngine, memoryCaptureOptedOutNotice, memoryCaptureOptOutUnpersistedNotice, memoryConsolidationRecommendedNotice, memoryHarvestConflictNotice, memoryHarvestQuarantinedNotice, memoryHarvestRefusedNotice, memoryHoldNotices, memoryRecallDisciplineSegment, memoryRestoreWithheldNotice, memorySessionPollutedNotice, memoryUnavailableNotice, pollutionContainmentCounts, } from "../memory-engine/engine.js";
11
+ import { memoryMountFailedCauseOf, memoryMountFailedNotice } from "../memory-engine/mount-failed-notice.js";
11
12
  import { adjudicateCaptureOptOut, captureOptOutDeniedError, captureOptOutUnpersistedError } from "./memory-capture-optout.js";
12
13
  import { sessionIncarnationResolver } from "../memory-engine/session-incarnation.js";
13
14
  import { createMemoryEngineTools } from "../memory-engine/tools.js";
14
15
  import { assertScopeContractPlacement, parseScopeKey } from "../memory-engine/scope-contract.js";
15
16
  import { writableRootOf } from "../memory-engine/types.js";
16
- import { catalogText } from "../../prompt-assembly/catalog/index.js";
17
17
  import { asThrownError, thrownText } from "../thrown-value.js";
18
18
  function heldCapturePlane(engine, backend) {
19
19
  const carrier = backend.governance;
@@ -120,6 +120,7 @@ export async function prepareMemory(input) {
120
120
  const incarnationOpt = { sessionIncarnation: sessionIncarnationResolver(sessionId, input.sessionIncarnation, lineageTokens) };
121
121
  const pinned = directoryPinOf(backend);
122
122
  const engineRoot = resolveMemoryEngineRoot(deps.memoryEngineDir);
123
+ assertRootNotSensitive("engine_root", engineRoot);
123
124
  const repoRoot = deps.rootPath ?? taskRootPath;
124
125
  if (repoRoot) {
125
126
  adoptLegacyRepoDirs(engineRoot, repoRoot, (err) => deps.onError?.(err, { phase: "memory", sessionId }));
@@ -567,6 +568,7 @@ export async function prepareMemory(input) {
567
568
  return writeEngine.gateWrite(writeHandle, w.key, w.content);
568
569
  };
569
570
  let pollutionAnnounced = false;
571
+ let pollutionDurable = false;
570
572
  const announceHarvestContainment = async (report) => {
571
573
  const { count, moved, escalated } = pollutionContainmentCounts(report);
572
574
  const indexOnly = input.memoryProvenance !== "off" && count === 0 && report.containment?.indexRolledBack === true;
@@ -706,12 +708,19 @@ export async function prepareMemory(input) {
706
708
  pollution: {
707
709
  polluted: () => writeEngine.sessionPollution(sessionId),
708
710
  markPolluted: (reason, cause) => {
709
- void writeEngine.markSessionPolluted(sessionId, reason, cause).then((outcome) => {
710
- if (outcome === "existed" || (outcome === "unpersisted" && pollutionAnnounced))
711
- return;
711
+ const outcome = writeEngine.markSessionPolluted(sessionId, reason, cause).then((o) => {
712
+ if (o !== "unpersisted")
713
+ pollutionDurable = true;
714
+ if (o === "existed" || (o === "unpersisted" && pollutionAnnounced))
715
+ return o;
712
716
  pollutionAnnounced = true;
713
717
  deliverEngineNotice(deps.onNotice, memorySessionPollutedNotice({ reason, sessionId, provenance: input.memoryProvenance }));
718
+ return o;
714
719
  });
720
+ if (!pollutionDurable)
721
+ return outcome;
722
+ void outcome.catch(() => undefined);
723
+ return Promise.resolve("existed");
715
724
  },
716
725
  },
717
726
  contentSafety: {
@@ -724,17 +733,22 @@ export async function prepareMemory(input) {
724
733
  ...(input.memoryProvenance !== "off"
725
734
  ? {
726
735
  recallTaint: {
727
- judgeDeliveredPath: (absPath) => {
736
+ judgeDeliveredPath: async (absPath) => {
728
737
  try {
729
738
  if (!isAbsolute(absPath))
730
- return false;
731
- const roots = [writeHandle.memoryDir, ...(readOnlyHandle !== undefined ? [readOnlyHandle.memoryDir] : [])];
732
- if (!roots.some((r) => isContainedIn(r, absPath)))
733
- return false;
734
- return entryFileHeadCarriesOrigin(absPath);
739
+ return "clean";
740
+ const planes = [{ engine: writeEngine, handle: writeHandle }, ...(readOnlyEngine !== undefined && readOnlyHandle !== undefined ? [{ engine: readOnlyEngine, handle: readOnlyHandle }] : [])];
741
+ for (const plane of planes) {
742
+ if (!isContainedIn(plane.handle.memoryDir, absPath))
743
+ continue;
744
+ const id = await plane.engine.entryIdAtPlanePath(plane.handle, absPath);
745
+ if (id !== undefined)
746
+ return await plane.engine.entryExposureVerdict(id);
747
+ }
748
+ return "clean";
735
749
  }
736
750
  catch {
737
- return false;
751
+ return "clean";
738
752
  }
739
753
  },
740
754
  },
@@ -750,9 +764,11 @@ export async function prepareMemory(input) {
750
764
  };
751
765
  if (input.memoryProvenance !== "off") {
752
766
  const session = memoryEngineSession;
753
- const markDerived = (ids) => {
767
+ const markDerived = async (ids) => {
754
768
  const shown = ids.slice(0, 3).join(", ") + (ids.length > 3 ? ", …" : "");
755
- session.pollution.markPolluted(`this session read the content of external-origin memory entr${ids.length === 1 ? "y" : "ies"} ${shown}`, "derived");
769
+ if ((await session.pollution.markPolluted(`this session read the content of external-origin memory entr${ids.length === 1 ? "y" : "ies"} ${shown}`, "derived")) === "unpersisted") {
770
+ throw new Error("the external-origin take-up could not be recorded durably for this session");
771
+ }
756
772
  };
757
773
  for (const plane of toolPlanes)
758
774
  plane.onTaintedDelivery = markDerived;
@@ -783,6 +799,7 @@ export async function prepareMemory(input) {
783
799
  writeScope: null,
784
800
  ...(materializedResidue.length > 0 ? { materializedResidue: [...new Set(materializedResidue)] } : {}),
785
801
  };
802
+ deliverEngineNotice(deps.onNotice, memoryMountFailedNotice({ sessionId, scopes: [...new Set([...memorySpec.scopes, ...(memorySpec.writeScope !== null ? [memorySpec.writeScope] : [])])], cause: memoryMountFailedCauseOf(err) }));
786
803
  }
787
804
  }
788
805
  }
@@ -792,6 +809,7 @@ export async function prepareMemory(input) {
792
809
  }
793
810
  const composeInjection = async (facts) => {
794
811
  let memoryBlock;
812
+ let memoryStoreAbsent = false;
795
813
  let seedFiles;
796
814
  let recallDisciplineSegment;
797
815
  let noticesFrame;
@@ -830,10 +848,14 @@ export async function prepareMemory(input) {
830
848
  seedFiles = [injection.indexSeed];
831
849
  }
832
850
  else if (!facts.rosterCanPersist && !facts.isSubagent) {
833
- memoryBlock = effectiveMemoryScopes?.reason === "mount-failed" ? memoryUnavailableNotice({ what: "mount-failed", notesReadable: false }) : catalogText("core/memory.no-persistent-store");
851
+ if (effectiveMemoryScopes?.reason === "mount-failed")
852
+ memoryBlock = memoryUnavailableNotice({ what: "mount-failed", notesReadable: false });
853
+ else
854
+ memoryStoreAbsent = true;
834
855
  }
835
856
  return {
836
857
  memoryBlock,
858
+ ...(memoryStoreAbsent ? { memoryStoreAbsent: true } : {}),
837
859
  ...(recallDisciplineSegment !== undefined ? { recallDisciplineSegment } : {}),
838
860
  ...(seedFiles !== undefined ? { seedFiles } : {}),
839
861
  ...(noticesFrame !== undefined ? { noticesFrame } : {}),
@@ -1,17 +1,3 @@
1
- /**
2
- * (The offload half of the prelude) — prepareTask's nested-usage accumulator, the
3
- * large-tool-result offload store resolution and the THREE offload wrappers every later mount site
4
- * applies (caller tools, first-party hand tools, remote MCP/A2A peers), verbatim from the driver.
5
- *
6
- * SYNCHRONOUS by construction: the segment held no await in the driver, and a phase that yields where
7
- * the driver did not would open a microtask window between two steps that used to be adjacent (the
8
- * posture). Nothing here touches the store — the wrappers close over it and only the
9
- * wrapped tools' `execute` reach it, at run time.
10
- *
11
- * What stays in the driver: the trust-axis choice of `offloadScope` (`spec.principal ?? "default"`)
12
- * and its disclosure, and the reserved-name door that FOLLOWS these wrappers (it awaits a bounded
13
- * session forget, so it belongs with the driver's other refusal legs).
14
- */
15
1
  import { type ToolResultStore } from "../tool-result-store.js";
16
2
  import type { AgentTool } from "../../internal/harness.js";
17
3
  import type { NestedUsage, NestedUsageAccum, RunnerDeps, TaskSpec } from "../types.js";
@@ -31,8 +17,9 @@ export interface PrepareOffloadWrappersInput {
31
17
  /** borrowed-readonly — the resume leg, read for the checkpoint seed's nested-usage snapshot so
32
18
  * delegated cost spent before a suspend is not lost; `undefined` on a fresh run. */
33
19
  resume: Pick<PrepareResume, "seed"> | undefined;
34
- /** borrowed-readonly — the run's TRUST identity (`spec.principal ?? "default"`, minted by the
35
- * driver): the namespace a Runner-shared store is scoped under. Never the registry domain. */
20
+ /** borrowed-readonly — the run's isolation scope (`isolationScopeOf(spec) ?? "default"`, minted by the
21
+ * driver — the partition, which is the person when no partition is named): the namespace a Runner-shared
22
+ * store is scoped under. Never the registry domain. */
36
23
  offloadScope: string;
37
24
  /** borrowed-readonly — the acquired session id, the offload wrapper's ref-minting coordinate. */
38
25
  sessionId: string;
@@ -1,6 +1,8 @@
1
- import { DEFAULT_TOOL_RESULT_THRESHOLD_CHARS, InMemoryToolResultStore, OFFLOAD_TOOL_NAME, RunnerSharedToolResultStore, ScopedToolResultStore, withToolResultOffload, } from "../tool-result-store.js";
1
+ import { offloadSeatFact, offloadThresholdsOf } from "../tool-mount-facts.js";
2
+ import { InMemoryToolResultStore, OFFLOAD_TOOL_NAME, RunnerSharedToolResultStore, ScopedToolResultStore, withToolResultOffload, } from "../tool-result-store.js";
2
3
  import { faceOf } from "../tool-roster.js";
3
4
  import { valveLeaves } from "../../agents/tool-filter.js";
5
+ import { MCP_REMOTE_RESULT_MAX_CHARS } from "../mcp-tool-meta.js";
4
6
  const FIRST_PARTY_OFFLOAD_THRESHOLD_CHARS = 50_000;
5
7
  export function prepareOffloadWrappers(input) {
6
8
  const { spec, deps, resume, offloadScope, sessionId, selector } = input;
@@ -20,9 +22,8 @@ export function prepareOffloadWrappers(input) {
20
22
  if (u.costMicroUsd === undefined)
21
23
  nestedStats.anyUnpriced = true;
22
24
  };
23
- const explicitGlobalThreshold = spec.toolResultThresholdChars ?? deps.toolResultThresholdChars;
24
- const offloadThreshold = explicitGlobalThreshold ?? DEFAULT_TOOL_RESULT_THRESHOLD_CHARS;
25
- const offloadEnabled = Number.isFinite(offloadThreshold) && offloadThreshold > 0 && valveLeaves(spec, selector)({ name: OFFLOAD_TOOL_NAME });
25
+ const { explicit: explicitGlobalThreshold, effective: offloadThreshold } = offloadThresholdsOf(spec, deps);
26
+ const offloadEnabled = offloadSeatFact(offloadThreshold) && valveLeaves(spec, selector)({ name: OFFLOAD_TOOL_NAME });
26
27
  const rawOffloadStore = offloadEnabled ? (deps.toolResultStore ?? new InMemoryToolResultStore()) : undefined;
27
28
  const offloadStore = rawOffloadStore instanceof RunnerSharedToolResultStore
28
29
  ? new ScopedToolResultStore(rawOffloadStore, offloadScope)
@@ -42,7 +43,7 @@ export function prepareOffloadWrappers(input) {
42
43
  const remoteToolOffload = (tool) => {
43
44
  if (explicitGlobalThreshold !== undefined)
44
45
  return maybeOffload(tool);
45
- return maybeOffload(tool, { offloadThresholdChars: tool.mcpMaxResultSizeChars ?? 50_000 });
46
+ return maybeOffload(tool, { offloadThresholdChars: tool.mcpMaxResultSizeChars ?? MCP_REMOTE_RESULT_MAX_CHARS });
46
47
  };
47
48
  return { nestedStats, reportUsage, offloadStore, offloadReachableToolsRef, maybeOffload, firstPartyOffload, remoteToolOffload };
48
49
  }