@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
@@ -0,0 +1,88 @@
1
+ import { rosterEntryNamed, toolCallFaceOf } from "./tool-roster.js";
2
+ import { pathTargetValue } from "./tool-registry.js";
3
+ import { ORG_ADJUDICATION_TIMEOUT_MS } from "./permission-rule-org.js";
4
+ import { declaredClassAnswer, isAnsweringSeat, isPolicyApprover } from "./tool-policy.js";
5
+ import { exactBoundInputHashOf } from "./canonical-json.js";
6
+ export const EXISTING_TARGET_KINDS = Object.freeze(["text", "absent", "withheld"]);
7
+ export const EXISTING_TARGET_WITHHELD_REASONS = Object.freeze(["oversize", "not_text", "read_refused", "unavailable"]);
8
+ export const EXISTING_TARGET_READ_CAP = 262_144;
9
+ export const EXISTING_TARGET_PROBE_FACE = "approval-card";
10
+ export function existingTargetCovers(row) {
11
+ return row !== undefined && row.family === "file-write" && row.pathTarget !== undefined && row.pathTarget.access !== "read" && Array.isArray(row.boundaryLegs) && row.boundaryLegs.includes("env");
12
+ }
13
+ export function createExistingTargetSeat() {
14
+ return { current: undefined, read: new WeakMap() };
15
+ }
16
+ export function readsCardTarget(onAsk, classes) {
17
+ return isAnsweringSeat(onAsk) && !isPolicyApprover(onAsk) && declaredClassAnswer(onAsk, classes) === undefined;
18
+ }
19
+ export async function cardTargetFor(seat, roster, ask, args, reads, signal) {
20
+ const earlier = seat.read.get(ask);
21
+ if (earlier !== undefined && (earlier.args === args || (earlier.binding !== undefined && earlier.binding === exactBoundInputHashOf(ask.toolName, args))))
22
+ return earlier.member;
23
+ const source = reads ? seat.current : undefined;
24
+ const member = await existingTargetOf(roster, ask.toolName, args, source, signal);
25
+ if (source !== undefined)
26
+ seat.read.set(ask, { args, binding: exactBoundInputHashOf(ask.toolName, args), member });
27
+ return member;
28
+ }
29
+ const UNAVAILABLE = Object.freeze({ kind: "withheld", why: "unavailable" });
30
+ const READ_REFUSED = Object.freeze({ kind: "withheld", why: "read_refused" });
31
+ const ENDED = Symbol("ended");
32
+ function within(p, signal) {
33
+ if (signal.aborted)
34
+ return Promise.resolve(ENDED);
35
+ return new Promise((resolve) => {
36
+ const end = () => resolve(ENDED);
37
+ signal.addEventListener("abort", end, { once: true });
38
+ p.then((v) => {
39
+ signal.removeEventListener("abort", end);
40
+ resolve(v);
41
+ }, () => {
42
+ signal.removeEventListener("abort", end);
43
+ resolve(ENDED);
44
+ });
45
+ });
46
+ }
47
+ function fromReading(r) {
48
+ switch (r.kind) {
49
+ case "text":
50
+ return { kind: "text", text: r.text };
51
+ case "absent":
52
+ return { kind: "absent" };
53
+ case "refused":
54
+ return READ_REFUSED;
55
+ case "not_text":
56
+ case "oversize":
57
+ return { kind: "withheld", why: r.kind };
58
+ case "moved":
59
+ case "unavailable":
60
+ return UNAVAILABLE;
61
+ }
62
+ }
63
+ export async function existingTargetOf(roster, toolName, args, source, signal) {
64
+ const row = roster !== undefined ? rosterEntryNamed(roster, toolName) : undefined;
65
+ if (!existingTargetCovers(row))
66
+ return {};
67
+ const path = row?.pathTarget !== undefined ? pathTargetValue(args, row.pathTarget) : undefined;
68
+ if (source === undefined || path === undefined)
69
+ return { existingTarget: UNAVAILABLE };
70
+ const face = toolCallFaceOf(roster, "Read");
71
+ if (face === undefined)
72
+ return { existingTarget: READ_REFUSED };
73
+ const deadlineAt = Date.now() + ORG_ADJUDICATION_TIMEOUT_MS;
74
+ const timeout = AbortSignal.timeout(ORG_ADJUDICATION_TIMEOUT_MS);
75
+ const wait = signal !== undefined ? AbortSignal.any([signal, timeout]) : timeout;
76
+ try {
77
+ const verdict = await within(source.judge({ file_path: path, face }, EXISTING_TARGET_PROBE_FACE, { deadlineAt }), wait);
78
+ if (verdict === ENDED || verdict.verdict === "unanswerable")
79
+ return { existingTarget: UNAVAILABLE };
80
+ if (verdict.verdict !== "no_objection")
81
+ return { existingTarget: READ_REFUSED };
82
+ const reading = await within(source.reader.readText(path, { signal: wait }, { capBytes: EXISTING_TARGET_READ_CAP, ...(verdict.judged !== undefined ? { judgedKey: verdict.judged } : {}) }), wait);
83
+ return { existingTarget: reading === ENDED ? UNAVAILABLE : fromReading(reading) };
84
+ }
85
+ catch {
86
+ return { existingTarget: UNAVAILABLE };
87
+ }
88
+ }
@@ -1,6 +1,6 @@
1
1
  import type { GovernanceRetryClass } from "./governance-codes.js";
2
2
  import { type FileHistoryRetentionPolicy } from "./file-history-retention.js";
3
- import type { ExecutionEnv } from "../internal/harness-types.js";
3
+ import type { ExecutionEnv, SessionRowExpectation } from "../internal/harness-types.js";
4
4
  /** rel path of `child` under `root` in "/" form (win root) / verbatim form (posix root); null when not under.
5
5
  * Fold "\" only under a WIN-family root ({@link isWinFormPath}); a POSIX tree may legally contain literal
6
6
  * backslashes in FILE NAMES, and folding them would corrupt both the track key and the restore target. */
@@ -223,7 +223,8 @@ export interface FileHistoryDiffStats {
223
223
  export interface RewindFilesRequest {
224
224
  /** The session whose history is converged. It must exist. */
225
225
  sessionId: string;
226
- /** The boundary key: the entry id of a turn's FIRST user entry — the id space `TaskSpec.rewindFilesTo`
226
+ /** The boundary key: the entry id of the person's input that opened a turn (its run's first row of a person's
227
+ * input; an engine entry ahead of it, such as a task notification, is not one) — the id space `TaskSpec.rewindFilesTo`
227
228
  * addresses ("the files as they were when that turn began"). An entry with no boundary of its own refuses. */
228
229
  to: string;
229
230
  /** Preview only: the working tree is not written (a fork whose history was never carried may have its carry
@@ -231,6 +232,11 @@ export interface RewindFilesRequest {
231
232
  dryRun?: boolean;
232
233
  /** Caller cancel for the restore. */
233
234
  signal?: AbortSignal;
235
+ /** The occupant the caller read the session as: `{ row: { owner, incarnation } }` (a `SessionHead` serves as `row`) — the
236
+ * session under `sessionId` must still be that row (`sessionRowMatches` on the acquired session), or nothing is rewound and
237
+ * the answer is `resume.session_not_found`. `row: null` and `log` are refused (`rewind.invalid_spec`). Absent ⇒ any
238
+ * session under the id. The same member, read the same way, as `CompactSessionRequest.expect`. */
239
+ expect?: SessionRowExpectation;
234
240
  }
235
241
  /** `Runner.rewindFiles`' answer. A refusal is a thrown `Error` carrying a `code`. */
236
242
  export type RewindFilesResult =
@@ -441,9 +447,9 @@ export interface FileHistoryStore {
441
447
  /**
442
448
  * Converge ONLY the tracked set to the boundary `entryId`: for each tracked file, target-version
443
449
  * bytes ⇒ write via `env` (the guarded-write arm and the symlink/parent-chain/kind preflights are
444
- * the design/381 slice-3 hardening — until then the write is plain and ADVISORY, stated, never
445
- * overclaimed); deletion marker ⇒ remove; identical ⇒ untouched; tracked-later-than-target ⇒ fall
446
- * back to its v1 (pristine) version, and a base-unavailable path (DV-14) is REFUSED with reason
450
+ * the design/381 slice-3 preflight family, `applyFileRestoreViaEnv`; an env without the guarded write
451
+ * converges ADVISORY on the TOCTOU axis, stated, never overclaimed); deletion marker ⇒ remove;
452
+ * identical ⇒ untouched; tracked-later-than-target ⇒ fall back to its v1 (pristine) version, and a base-unavailable path (DV-14) is REFUSED with reason
447
453
  * `base_unavailable` (left at its current state — never overwritten with a fake baseline).
448
454
  * Per-file refusals SKIP that file and are counted, never failing the whole restore (CC form).
449
455
  * Paths recorded relative to `root` re-join against the CURRENT root (worktree/moved-cwd safe).
@@ -568,7 +574,9 @@ export interface FileHistoryStore {
568
574
  *
569
575
  * A HOST MAY STILL CALL IT — the engine's seat covers sessions the engine prepares, and a
570
576
  * deployment that copies history between scopes for its own reasons (a migration, a scope rename)
571
- * is calling the same verb under the same law. What a MISSED carry gets is degraded, not broken,
577
+ * is calling the same verb under the same law. The session-deletion cascade is one such caller: before it deletes a
578
+ * session's history it carries that history into each of the session's forks, with the same `conflict` reading (a fork that
579
+ * already received it, or has grown its own, is done) ({@link import("./retention.js").RETENTION_CASCADE}'s file-history row). What a MISSED carry gets is degraded, not broken,
572
580
  * and it is worth naming precisely: the new scope starts EMPTY, so nothing the old one tracked is
573
581
  * restorable from it. A rewind aimed at a pre-fork boundary answers "no boundary" (honest, typed)
574
582
  * instead of converging those files, and the new lineage's own first touch of a path records THAT
@@ -10,7 +10,7 @@ import { ASK_USER_QUESTION_TOOL_NAME, isEngineQuestionFace } from "./ask-questio
10
10
  import { routesContent } from "./tool-catalog-entries.js";
11
11
  import { applyPersistedTightening, disclosedRuleSet } from "./persisted-rule-arms.js";
12
12
  import { skillAllowDecision, skillRowRefusal } from "./skill-grant.js";
13
- import { allowRuleShadowOf, withAllowRuleShadow } from "./allow-entry.js";
13
+ import { allowRuleShadowOf, askFallbackMessage, cardDisclosureOf, inheritedAskFallbackMessage, withAllowRuleShadow } from "./allow-entry.js";
14
14
  import { CD_GIT_COMPOUND_SENTENCE, changesDirectoryBeforeGit, readOnlyShellVerdict } from "./read-only-shell.js";
15
15
  import { readShellCommand } from "./shell-run-candidates.js";
16
16
  import { COMMAND_RULE_TOOL, ruleShapeOf } from "./permission-rule-model.js";
@@ -53,8 +53,13 @@ export async function runGateLanes(pass) {
53
53
  throw new Error(`a real-approval ask for "${toolName}" reached a park site with no origin word — the origin stamp precedes every park`);
54
54
  return { origin: d.origin, ...(org !== undefined ? { org } : {}) };
55
55
  };
56
- const carryOf = (d) => ({
56
+ const cardQuestionOf = ({ message, matchedAskRule }) => ({
57
+ cardMessage: message,
58
+ ...(matchedAskRule !== undefined ? { cardAskRule: matchedAskRule } : {}),
59
+ });
60
+ const carryOf = (d, req) => ({
57
61
  ...(callSignal !== undefined ? { signal: callSignal } : {}),
62
+ ...(d.action === "ask" ? cardQuestionOf(cardDisclosureOf(d, (markedUnresolvable() ? inheritedAskFallbackMessage : askFallbackMessage)(req.toolName))) : {}),
58
63
  ...(d.action === "ask" && d.denialLimitFallback !== undefined ? { denialLimitFallback: unarmedWindow(d.denialLimitFallback) } : {}),
59
64
  ...(d.action === "ask" && d.classifierNoRuling !== undefined ? { classifierNoRuling: d.classifierNoRuling } : {}),
60
65
  ...(d.action === "ask" && d.origin !== undefined ? { origin: d.origin } : {}),
@@ -66,7 +71,7 @@ export async function runGateLanes(pass) {
66
71
  const parkAsk = async (d, req, args, safety, liveFaceUnavailable, org) => {
67
72
  if (suspendAsk === undefined || d.action !== "ask")
68
73
  return undefined;
69
- const suspended = await parkWith(suspendAsk, [req, args, safety, liveFaceUnavailable, realApprovalOf(d, org), d.allowRuleShadowed, d.decisionReason, d.probeReason, d.probeCause, d.segmentCoverage, d.matchedAskRule, d.probeMandated], carryOf(d));
74
+ const suspended = await parkWith(suspendAsk, [req, args, safety, liveFaceUnavailable, realApprovalOf(d, org), d.allowRuleShadowed, d.decisionReason, d.probeReason, d.probeCause, d.segmentCoverage, d.matchedAskRule, d.probeMandated], carryOf(d, req));
70
75
  if (suspended && "parkFailed" in suspended)
71
76
  pass.parkFailed = suspended.parkFailed;
72
77
  return suspended && !("parkFailed" in suspended) ? { suspend: suspended, preToolContext: pass.preToolContext } : undefined;
@@ -303,7 +303,8 @@ export type WinnerDecisionTableCoversEveryDecision = AssertAllKeysHandled<Exclud
303
303
  * to share one seven-word list (`PermissionDeniedSource`) in which `classifier` meant both "the classifier
304
304
  * asked" and "the classifier denied".
305
305
  * - `policy` — the deployment `ToolPolicy` denied (directly, or re-checking an approved edit), or the
306
- * approval-edit chain hit its round cap.
306
+ * approval-edit chain hit its round cap, or the deployment's cross-boundary posture refused at the allow exit (the
307
+ * call's obligation, read again as it would run, is one no person answered, or the record it owes could not be written).
307
308
  * - `hook` — a PreToolUse hook denied, threw, or never answered (the engine's fail-closed block on a
308
309
  * hook that made no decision counts as the hook layer's refusal for attribution).
309
310
  * - `org` — an organization policy rule denied; or, on a durable resume, the org's current verdict demands a person and
@@ -58,7 +58,81 @@ export interface AddWorktreeOptions {
58
58
  * start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
59
59
  * step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
60
60
  readFloor?: () => ReadFloor | undefined;
61
+ /** What the env's `destroy()` does with the tree. `"discard"` (default): removes it whatever it holds (`--force`), the
62
+ * caller having decided its changes go; `destroy()` answers nothing. `"keep-if-dirty"`: removes it only when
63
+ * {@link treeKeptBecause} — the judgment `releaseSessionCheckout` reads — finds nothing to keep (no uncommitted file, no file
64
+ * git ignores, no commit past the base the tree was minted at, a readable state), and then without `--force`; `destroy()`
65
+ * answers the tree's {@link ReleasedTree} — a tree with something in it stays where it is, with its branch, and the answer
66
+ * says why (`kept`). Any other value is refused before anything is created (`config.invalid_argument`). */
67
+ onExit?: "discard" | "keep-if-dirty";
61
68
  }
69
+ /** The release outcome of one tree — what `destroy()` of an {@link addWorktree} env and the release doors of a session's
70
+ * checkout answer. `branch` is present while the tree's branch still exists after the release. */
71
+ export interface ReleasedTree {
72
+ readonly path: string;
73
+ readonly removed: boolean;
74
+ readonly branch?: string;
75
+ readonly kept?: "dirty" | "ignored" | "commits" | "unverifiable" | "requested" | "not_owned";
76
+ readonly detail?: string;
77
+ }
78
+ /** The reasons {@link treeKeptBecause} answers: a subset of {@link ReleasedTree.kept} (the other two are a door's own). */
79
+ export type TreeKeptReason = Extract<NonNullable<ReleasedTree["kept"]>, "dirty" | "ignored" | "commits" | "unverifiable">;
80
+ /** The first {@link IGNORED_NAMED} ignored paths (each bounded) and how many more — how a tree's ignored files are named wherever
81
+ * a sentence names them (`removeTreeIfClean`'s `detail`, ExitWorktree's reply). */
82
+ export declare function namedIgnored(paths: readonly string[]): string;
83
+ /** What a managed tree holds that removing it would lose, as ONE reading of it answers ({@link treeHoldsOf}): `files` — the entries
84
+ * git lists as changed or untracked; `ignored` — the paths git ignores in it (an `.env`, build output, `node_modules/`); `commits` —
85
+ * how many commits sit past the base the tree was minted at (`undefined`: no base was read, or the count did not answer). */
86
+ export interface TreeHolds {
87
+ readonly files: number;
88
+ readonly ignored: readonly string[];
89
+ readonly commits: number | undefined;
90
+ }
91
+ /**
92
+ * THE reading of a managed tree's contents, the one every door that removes a tree reads: one status read with
93
+ * `--ignored --untracked-files=normal` (untracked files are listed whatever the repository's `status.showUntrackedFiles` says —
94
+ * `no` would hide them) for the files and the ignored paths, then — when a base commit was read — one count of the commits past
95
+ * it. `undefined` when the status read failed. The verdict is {@link keptByHolds}'s; a door that also says how much the tree
96
+ * holds (ExitWorktree's reply) reads the counts off the same answer. A start that REJECTS (an environment whose `exec` throws, a
97
+ * floor that cannot be read) is read as a failed reading — a tree is kept on a guess, never removed — unless the caller passes
98
+ * `rethrow`: a door whose own state must survive a transient failure to retry it (ExitWorktree keeps its session active) lets the
99
+ * rejection propagate.
100
+ */
101
+ export declare function treeHoldsOf(env: ExecutionEnv, path: string, baseSha: string | undefined, readFloor?: () => ReadFloor | undefined, opts?: {
102
+ readonly rethrow?: boolean;
103
+ }): Promise<TreeHolds | undefined>;
104
+ /**
105
+ * THE keep verdict over {@link treeHoldsOf}'s reading: why the tree must not be removed, or `undefined` when nothing in it would be
106
+ * lost. A tracked change or an untracked file keeps it (`dirty`); a file git ignores keeps it too (`ignored`), since removing the
107
+ * tree would delete it with it; then a commit past the base keeps it (`commits`). A reading that failed, and a base that was never
108
+ * read or a count that did not answer, are `unverifiable` — nothing is removed on a guess.
109
+ */
110
+ export declare function keptByHolds(holds: TreeHolds | undefined): {
111
+ readonly kept: TreeKeptReason;
112
+ readonly detail?: string;
113
+ } | undefined;
114
+ /** The keep verdict of the tree at `path` ({@link keptByHolds} over {@link treeHoldsOf}): every removing door that keeps changes
115
+ * reads this one answer. */
116
+ export declare function treeKeptBecause(env: ExecutionEnv, path: string, baseSha: string | undefined, readFloor?: () => ReadFloor | undefined): Promise<{
117
+ readonly kept: TreeKeptReason;
118
+ readonly detail?: string;
119
+ } | undefined>;
120
+ /** `{ branch }` while `branch` still exists in the repository at `repository`, else `{}`. */
121
+ export declare function branchLeftOf(env: ExecutionEnv, repository: string, branch: string, readFloor?: () => ReadFloor | undefined): Promise<{
122
+ branch?: string;
123
+ }>;
124
+ /**
125
+ * THE keeping removal of a managed tree: {@link treeKeptBecause} first (a tree with something in it is kept and named, its branch
126
+ * left), then `stillOurs` — a door's own re-read right before the removal, answering the outcome when the tree is no longer
127
+ * its to remove — then the removal without `--force` (a write landing after the judgment keeps the tree: `unverifiable`, with
128
+ * git's words), its branch deleted with it only while the branch sits at the base commit.
129
+ */
130
+ export declare function removeTreeIfClean(env: ExecutionEnv, tree: {
131
+ readonly path: string;
132
+ readonly repository: string;
133
+ readonly branch: string;
134
+ readonly baseSha: string | undefined;
135
+ }, readFloor: (() => ReadFloor | undefined) | undefined, stillOurs?: () => Promise<ReleasedTree | undefined>): Promise<ReleasedTree>;
62
136
  /** Single-quote a path for the `exec` command STRING (the Shell API takes a command string, not argv). */
63
137
  export declare function shq(s: string): string;
64
138
  /**
@@ -105,8 +179,25 @@ how: "discard" | "clean"): Promise<{
105
179
  * arbitrary shell access (bash can still reach the host — sandbox separately); UNCOMMITTED changes in the base
106
180
  * repo are absent in the child (the tree starts at the base commit); a worktree orphaned by a process crash is reaped by
107
181
  * {@link pruneWorktrees} (userland — there is no Runner hook for post-kill cleanup).
182
+ *
183
+ * Under `onExit: "keep-if-dirty"`, `destroy()` answers the tree's {@link ReleasedTree}: `removed: true` once it is gone, or
184
+ * `removed: false` with the reason it was kept (the tree and its branch left in place for the caller to inspect or merge).
185
+ * Under `"discard"` (the default) it answers nothing: the tree is gone, or `destroy()` rejects.
108
186
  */
109
- export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions): Promise<{
187
+ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions & {
188
+ readonly onExit: "keep-if-dirty";
189
+ }): Promise<{
190
+ env: ExecutionEnv & {
191
+ destroy(): Promise<ReleasedTree>;
192
+ };
193
+ worktreeDir: string;
194
+ name: string;
195
+ branch: string;
196
+ baseSha?: string;
197
+ }>;
198
+ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions & {
199
+ readonly onExit?: "discard";
200
+ }): Promise<{
110
201
  env: ExecutionEnv & {
111
202
  destroy(): Promise<void>;
112
203
  };
@@ -66,6 +66,73 @@ export function managedWorktreeBranchOf(dir) {
66
66
  return undefined;
67
67
  return `${WORKTREE_BRANCH_PREFIX}/${dir.slice(dir.lastIndexOf("/") + 1)}`;
68
68
  }
69
+ async function gitAt(env, command, cwd, readFloor, rethrow = false) {
70
+ try {
71
+ const floor = readFloor?.();
72
+ const r = await env.exec(command, { cwd, ...(floor !== undefined ? { readFloor: floor } : {}) });
73
+ return r.ok ? r.value : undefined;
74
+ }
75
+ catch (err) {
76
+ if (rethrow)
77
+ throw err;
78
+ return undefined;
79
+ }
80
+ }
81
+ const IGNORED_NAMED = 5;
82
+ export function namedIgnored(paths) {
83
+ const named = paths.slice(0, IGNORED_NAMED).map((p) => p.slice(0, 120)).join(", ");
84
+ return paths.length > IGNORED_NAMED ? `${named} and ${paths.length - IGNORED_NAMED} more` : named;
85
+ }
86
+ function ignoredDetail(paths) {
87
+ return `the tree holds files git ignores (${namedIgnored(paths)}), which removing it would delete — delete or move them, then release again`;
88
+ }
89
+ export async function treeHoldsOf(env, path, baseSha, readFloor, opts) {
90
+ const rethrow = opts?.rethrow === true;
91
+ const status = await gitAt(env, "git status --porcelain --ignored --untracked-files=normal", path, readFloor, rethrow);
92
+ if (status === undefined || status.exitCode !== 0)
93
+ return undefined;
94
+ const entries = status.stdout.split("\n").filter((line) => line !== "");
95
+ const ignored = entries.filter((line) => line.startsWith("!! ")).map((line) => line.slice(3));
96
+ let commits;
97
+ if (baseSha !== undefined) {
98
+ const ahead = await gitAt(env, `git rev-list --count ${shq(`${baseSha}..HEAD`)}`, path, readFloor, rethrow);
99
+ const counted = ahead !== undefined && ahead.exitCode === 0 ? Number.parseInt(ahead.stdout.trim(), 10) : Number.NaN;
100
+ if (Number.isFinite(counted))
101
+ commits = counted;
102
+ }
103
+ return { files: entries.length - ignored.length, ignored, commits };
104
+ }
105
+ export function keptByHolds(holds) {
106
+ if (holds === undefined)
107
+ return { kept: "unverifiable" };
108
+ if (holds.files > 0)
109
+ return { kept: "dirty" };
110
+ if (holds.ignored.length > 0)
111
+ return { kept: "ignored", detail: ignoredDetail(holds.ignored) };
112
+ if (holds.commits === undefined)
113
+ return { kept: "unverifiable" };
114
+ return holds.commits > 0 ? { kept: "commits" } : undefined;
115
+ }
116
+ export async function treeKeptBecause(env, path, baseSha, readFloor) {
117
+ return keptByHolds(await treeHoldsOf(env, path, baseSha, readFloor));
118
+ }
119
+ export async function branchLeftOf(env, repository, branch, readFloor) {
120
+ const ref = await gitAt(env, `git rev-parse --verify --quiet ${shq(`refs/heads/${branch}`)}`, repository, readFloor);
121
+ return ref !== undefined && ref.exitCode === 0 ? { branch } : {};
122
+ }
123
+ export async function removeTreeIfClean(env, tree, readFloor, stillOurs) {
124
+ const { path, repository, branch, baseSha } = tree;
125
+ const keep = await treeKeptBecause(env, path, baseSha, readFloor);
126
+ if (keep !== undefined)
127
+ return { path, removed: false, branch, ...keep };
128
+ const notOurs = await stillOurs?.();
129
+ if (notOurs !== undefined)
130
+ return notOurs;
131
+ const removed = await removeManagedWorktree(env, repository, path, baseSha !== undefined ? { name: branch, baseSha } : undefined, readFloor, "clean");
132
+ if (!removed.ok)
133
+ return { path, removed: false, kept: "unverifiable", branch, detail: removed.detail.trim().slice(0, 300) };
134
+ return { path, removed: true, ...(await branchLeftOf(env, repository, branch, readFloor)) };
135
+ }
69
136
  export function shq(s) {
70
137
  return `'${s.replace(/'/g, "'\\''")}'`;
71
138
  }
@@ -121,6 +188,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
121
188
  }
122
189
  }
123
190
  export async function addWorktree(baseEnv, opts) {
191
+ const onExit = opts.onExit ?? "discard";
192
+ if (onExit !== "discard" && onExit !== "keep-if-dirty") {
193
+ throw Object.assign(new Error(`addWorktree: onExit must be "discard" or "keep-if-dirty"; nothing was created`), { code: "config.invalid_argument" });
194
+ }
124
195
  const { worktreeDir, name, branch, anchor, baseSha } = await mintManagedWorktree(baseEnv, opts);
125
196
  const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
126
197
  let inner;
@@ -133,18 +204,28 @@ export async function addWorktree(baseEnv, opts) {
133
204
  }
134
205
  const innerDestroy = inner.destroy;
135
206
  const env = inner;
207
+ const release = async () => {
208
+ if (onExit === "keep-if-dirty")
209
+ return removeTreeIfClean(baseEnv, { path: worktreeDir, repository: anchor, branch, baseSha }, opts.readFloor);
210
+ const removed = await removeManagedWorktree(baseEnv, anchor, worktreeDir, branchRule, opts.readFloor, "discard");
211
+ if (!removed.ok) {
212
+ throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
213
+ `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
214
+ }
215
+ };
136
216
  env.destroy = async () => {
217
+ let innerFailure;
137
218
  try {
138
219
  if (typeof innerDestroy === "function")
139
220
  await innerDestroy.call(inner);
140
221
  }
141
- finally {
142
- const removed = await removeManagedWorktree(baseEnv, anchor, worktreeDir, branchRule, opts.readFloor, "discard");
143
- if (!removed.ok) {
144
- throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
145
- `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
146
- }
222
+ catch (error) {
223
+ innerFailure = { error };
147
224
  }
225
+ const released = await release();
226
+ if (innerFailure !== undefined)
227
+ throw innerFailure.error;
228
+ return released;
148
229
  };
149
230
  return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
150
231
  }
@@ -61,7 +61,11 @@ export declare function governanceRetryClass(code: string): GovernanceRetryClass
61
61
  * `write` (`config.egress_requires_write_effect` — also minted, same meaning, for a protocol tool's resolved
62
62
  * axes), a name the run reserves for a tool the engine injects (`config.reserved_tool_name` — structured output,
63
63
  * the skill tool, tool search, the offload reader, an injected protocol tool; `runGoal`'s completion tool, which
64
- * refuses before any run). Each ends the run `failed` with the code on `terminal.code`. A caller-shape refusal, not a policy
64
+ * refuses before any run). `config.tool_roster_bound` is also the roster's own bound: a leg whose mounted face would mint more
65
+ * than `TOOL_ROSTER_MAX_ENTRIES` rows is refused where prepare mints the roster, after the mounts and before any row; at
66
+ * run time the same judge refuses a domain swap over it, and the MCP refresh / re-dial reads that refusal as the server's
67
+ * empty listing, not as the run's failure. Each prepare-time refusal ends the run `failed` with the code on
68
+ * `terminal.code`. A caller-shape refusal, not a policy
65
69
  * verdict: none of these is a governance code ({@link GOVERNANCE_CODES}); re-issuing the same declaration
66
70
  * changes nothing. Every mint site at the door types its code against this set.
67
71
  */
@@ -125,6 +129,11 @@ export type RuleQuarantineReason = Exclude<RuleSyncDropReason, "own_actor_forged
125
129
  * routing property into an entitlement vocabulary, and the two answer different questions: several
126
130
  * codes below carry a session attribution while the person entitled to the fact is still the
127
131
  * operator (a failed offload write, a routing fallback, a consolidation recommendation).
132
+ *
133
+ * Entitlement is who has the right to know, not who can fix it. A fact that changed what THIS session's run did —
134
+ * a deny row not kept under a recursive read, a model word the person named that the catalog does not hold, an input
135
+ * withheld from the model — is the session user's to hear even when the remedy is the operator's; a row stays
136
+ * `"operator"` only when the run itself is unchanged and the fact is the deployment's own.
128
137
  */
129
138
  export type NoticeAudience = "user" | "operator";
130
139
  /**
@@ -145,7 +154,7 @@ export type NoticeAudience = "user" | "operator";
145
154
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
155
  * so the catalog is not written a second time here and the two cannot drift.
147
156
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "config.legacy_tool_name", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "delegation.resume_lane_missing", "delegation.delivery_discarded", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.harvest_refused", "memory.harvest_conflict", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "instructions.source_changed", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
157
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.inherit_env_declared_late", "config.command_sandbox_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "config.legacy_tool_name", "config.toolpolicy.unmatched_names", "config.agent.unknown_tool", "permission.allowed_tool_not_granted", "mods.registration_refused", "mods.display_withheld", "mods.stop_ended", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "delegation.resume_lane_missing", "delegation.delivery_discarded", "mcp.injection_dropped", "protocol.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.server_unavailable", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.harvest_refused", "memory.harvest_conflict", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "model.fallback", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "context.messages_omitted", "instructions.withheld", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "approval.approver_defect", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "memory.mount_failed", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "tool_result.media_persisted", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "rewind.boundary_unrecorded", "verify.verifier_is_implementer", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped", "model.context_window_assumed", "config.store_ephemeral"];
149
158
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
159
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
160
  * sink is a supported shape, and narrowing that field would break it. */
@@ -191,6 +200,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
191
200
  readonly "route.credential_origin_mismatch": "user";
192
201
  readonly "approval.read_root_granted": "user";
193
202
  readonly "approval.read_root_grant_rejected": "user";
203
+ readonly "approval.approver_defect": "operator";
194
204
  readonly "config.durable_gate_unavailable": "user";
195
205
  readonly "config.permission_mode_unavailable": "user";
196
206
  readonly "permission.ask_released_by_mode": "user";
@@ -199,10 +209,15 @@ declare const NOTICE_AUDIENCE_TABLE: {
199
209
  readonly "permission.rule_row_dropped": "user";
200
210
  readonly "config.session_rules_earlier_grammar": "user";
201
211
  readonly "config.legacy_tool_name": "user";
212
+ readonly "config.toolpolicy.unmatched_names": "user";
213
+ readonly "config.agent.unknown_tool": "user";
202
214
  readonly "permission.allowed_tool_not_granted": "user";
203
215
  readonly "mods.registration_refused": "user";
216
+ readonly "mods.display_withheld": "user";
217
+ readonly "mods.stop_ended": "user";
204
218
  readonly "memory.capture_opted_out": "user";
205
219
  readonly "memory.capture_optout_unpersisted": "user";
220
+ readonly "memory.mount_failed": "user";
206
221
  readonly "memory.consolidation_withheld": "operator";
207
222
  readonly "delegation.ask_unresolvable": "user";
208
223
  readonly "inherit_env.names_withheld": "user";
@@ -224,8 +239,10 @@ declare const NOTICE_AUDIENCE_TABLE: {
224
239
  readonly "config.write_protection_target_view_absent": "operator";
225
240
  readonly "config.path_view_unresolved": "operator";
226
241
  readonly "config.execution_env_capability_invalid": "operator";
227
- readonly "config.read_deny_floor_unkept": "operator";
242
+ readonly "config.read_deny_floor_unkept": "user";
228
243
  readonly "config.read_floor_confinement_unavailable": "operator";
244
+ readonly "config.inherit_env_declared_late": "operator";
245
+ readonly "config.command_sandbox_unavailable": "user";
229
246
  readonly "config.tool_card_undeclared": "operator";
230
247
  readonly "config.tool_face_undeclared": "operator";
231
248
  readonly "config.tool_face_invalid": "operator";
@@ -243,9 +260,10 @@ declare const NOTICE_AUDIENCE_TABLE: {
243
260
  readonly "delegation.delivery_discarded": "operator";
244
261
  readonly "checkpoint.execution_outcome_unrecorded": "operator";
245
262
  readonly "mcp.injection_dropped": "user";
246
- readonly "mcp.revocation_probe_failed": "operator";
263
+ readonly "protocol.revocation_probe_failed": "operator";
247
264
  readonly "mcp.server_redialed": "operator";
248
265
  readonly "mcp.authorization_required": "user";
266
+ readonly "mcp.server_unavailable": "user";
249
267
  readonly "mcp.credential_echoed": "operator";
250
268
  readonly "workflow.governance_key_stripped": "operator";
251
269
  readonly "workflow.agent_option_ignored": "operator";
@@ -266,23 +284,30 @@ declare const NOTICE_AUDIENCE_TABLE: {
266
284
  readonly "route.tool_call_id_folded": "operator";
267
285
  readonly "route.extra_body_reserved_dropped": "operator";
268
286
  readonly "model.capability_downgraded": "user";
269
- readonly "model.role_defaulted": "operator";
287
+ readonly "model.role_defaulted": "user";
288
+ readonly "model.fallback": "user";
270
289
  readonly "context.tool_turn_repaired": "operator";
271
290
  readonly "context.media_removed": "user";
272
291
  readonly "context.tool_schema_removed": "user";
292
+ readonly "context.messages_omitted": "user";
293
+ readonly "instructions.withheld": "user";
273
294
  readonly "skills.listing_truncated": "operator";
274
295
  readonly "agents.listing_truncated": "operator";
275
296
  readonly "tool_result.offload_put_failed": "operator";
276
297
  readonly "tool_result.media_refused": "operator";
298
+ readonly "tool_result.media_persisted": "operator";
277
299
  readonly "config.image_processor_unavailable": "operator";
278
300
  readonly "fs.staging_file_left": "operator";
279
301
  readonly "fs.staging_file_swept": "operator";
280
302
  readonly "session.lineage_rerooted": "user";
303
+ readonly "rewind.boundary_unrecorded": "user";
304
+ readonly "verify.verifier_is_implementer": "user";
281
305
  readonly "config.forward_sink_failed": "operator";
282
- readonly "instructions.source_changed": "user";
283
306
  readonly "server.model_unreachable": "user";
284
307
  readonly "permission.entry_mode_clamped": "user";
308
+ readonly "model.context_window_assumed": "user";
285
309
  readonly "memory.layer_locked_legacy": "operator";
310
+ readonly "config.store_ephemeral": "user";
286
311
  };
287
312
  /** Compile-time fence: every catalogued code has an audience row (and, via `satisfies`, only those). */
288
313
  export type AudienceTableCoversEveryNoticeCode = AssertAllKeysHandled<Exclude<EngineNoticeCode, keyof typeof NOTICE_AUDIENCE_TABLE>>;
@@ -328,6 +353,8 @@ declare const NOTICE_MINTER_TABLE: {
328
353
  readonly "config.execution_env_capability_invalid": "engine";
329
354
  readonly "config.read_deny_floor_unkept": "engine";
330
355
  readonly "config.read_floor_confinement_unavailable": "engine";
356
+ readonly "config.inherit_env_declared_late": "engine";
357
+ readonly "config.command_sandbox_unavailable": "engine";
331
358
  readonly "config.tool_card_undeclared": "engine";
332
359
  readonly "config.tool_face_undeclared": "engine";
333
360
  readonly "config.tool_face_invalid": "engine";
@@ -347,8 +374,12 @@ declare const NOTICE_MINTER_TABLE: {
347
374
  readonly "permission.rule_row_dropped": "engine";
348
375
  readonly "config.session_rules_earlier_grammar": "engine";
349
376
  readonly "config.legacy_tool_name": "engine";
377
+ readonly "config.toolpolicy.unmatched_names": "engine";
378
+ readonly "config.agent.unknown_tool": "engine";
350
379
  readonly "permission.allowed_tool_not_granted": "engine";
351
380
  readonly "mods.registration_refused": "engine";
381
+ readonly "mods.display_withheld": "engine";
382
+ readonly "mods.stop_ended": "engine";
352
383
  readonly "peer.inbound_disposition": "engine";
353
384
  readonly "peer.held_settled": "engine";
354
385
  readonly "peer.idle_subscription": "engine";
@@ -364,9 +395,10 @@ declare const NOTICE_MINTER_TABLE: {
364
395
  readonly "delegation.resume_lane_missing": "engine";
365
396
  readonly "delegation.delivery_discarded": "engine";
366
397
  readonly "mcp.injection_dropped": "engine";
367
- readonly "mcp.revocation_probe_failed": "engine";
398
+ readonly "protocol.revocation_probe_failed": "engine";
368
399
  readonly "mcp.server_redialed": "engine";
369
400
  readonly "mcp.authorization_required": "engine";
401
+ readonly "mcp.server_unavailable": "engine";
370
402
  readonly "mcp.credential_echoed": "engine";
371
403
  readonly "workflow.governance_key_stripped": "engine";
372
404
  readonly "workflow.agent_option_ignored": "engine";
@@ -400,9 +432,12 @@ declare const NOTICE_MINTER_TABLE: {
400
432
  readonly "route.extra_body_reserved_dropped": "engine";
401
433
  readonly "model.capability_downgraded": "engine";
402
434
  readonly "model.role_defaulted": "engine";
435
+ readonly "model.fallback": "engine";
403
436
  readonly "context.tool_turn_repaired": "engine";
404
437
  readonly "context.media_removed": "engine";
405
438
  readonly "context.tool_schema_removed": "engine";
439
+ readonly "context.messages_omitted": "engine";
440
+ readonly "instructions.withheld": "engine";
406
441
  readonly "task.user_steer_undrained": "engine";
407
442
  readonly "task.user_followup_undrained": "engine";
408
443
  readonly "steering.parked_input_blocked": "engine";
@@ -413,20 +448,26 @@ declare const NOTICE_MINTER_TABLE: {
413
448
  readonly "task.tool_turn_incomplete": "engine";
414
449
  readonly "approval.read_root_granted": "engine";
415
450
  readonly "approval.read_root_grant_rejected": "engine";
451
+ readonly "approval.approver_defect": "engine";
416
452
  readonly "memory.capture_opted_out": "engine";
417
453
  readonly "memory.capture_optout_unpersisted": "engine";
454
+ readonly "memory.mount_failed": "engine";
418
455
  readonly "skills.listing_truncated": "engine";
419
456
  readonly "agents.listing_truncated": "engine";
420
457
  readonly "tool_result.offload_put_failed": "engine";
421
458
  readonly "tool_result.media_refused": "engine";
459
+ readonly "tool_result.media_persisted": "engine";
422
460
  readonly "config.image_processor_unavailable": "engine";
423
461
  readonly "fs.staging_file_left": "engine";
424
462
  readonly "fs.staging_file_swept": "engine";
425
463
  readonly "session.lineage_rerooted": "engine";
426
- readonly "instructions.source_changed": "server";
464
+ readonly "rewind.boundary_unrecorded": "engine";
465
+ readonly "verify.verifier_is_implementer": "engine";
427
466
  readonly "memory.layer_locked_legacy": "server";
428
467
  readonly "server.model_unreachable": "server";
429
468
  readonly "permission.entry_mode_clamped": "server";
469
+ readonly "model.context_window_assumed": "server";
470
+ readonly "config.store_ephemeral": "server";
430
471
  };
431
472
  /** Compile-time fence: every catalogued code has a minter row (and, via `satisfies`, only those). */
432
473
  export type MinterTableCoversEveryNoticeCode = AssertAllKeysHandled<Exclude<EngineNoticeCode, keyof typeof NOTICE_MINTER_TABLE>>;