@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,344 @@
1
+ import { types } from "node:util";
2
+ import { receive } from "./mods/kernel/receive.js";
3
+ import { commandSandboxPlanInForce } from "./command-sandbox-dispatch.js";
4
+ import { isShellFaceToolName } from "./tool-registry.js";
5
+ import { wireOf } from "./tool-name-readings.js";
6
+ import { providesCommandSandbox } from "./remote-env.js";
7
+ import { deliverEngineNotice } from "./engine-notice.js";
8
+ export const SANDBOX_SETTINGS_INVALID = "config.sandbox_settings_invalid";
9
+ export const COMMAND_SANDBOX_UNAVAILABLE = "config.command_sandbox_unavailable";
10
+ const BOOL = { t: "bool" };
11
+ const STR = { t: "str" };
12
+ const STRINGS = { t: "strings" };
13
+ const PATHS = { t: "strings", paths: true };
14
+ const NO_MATCH = { t: "enum", of: ["warn", "deny", "error"] };
15
+ const MODE = { t: "enum", of: ["deny", "mask"] };
16
+ const SIG = { t: "enum", of: ["deny", "passthrough"] };
17
+ const SETTINGS = {
18
+ t: "obj",
19
+ fields: {
20
+ enabled: BOOL,
21
+ failIfUnavailable: BOOL,
22
+ autoAllowBashIfSandboxed: BOOL,
23
+ allowUnsandboxedCommands: BOOL,
24
+ excludedCommands: STRINGS,
25
+ ignoreViolations: { t: "map", value: PATHS },
26
+ filesystem: { t: "obj", fields: { allowWrite: PATHS, denyWrite: PATHS, denyRead: PATHS, allowRead: PATHS, disabled: BOOL, allowManagedReadPathsOnly: { t: "merge" } } },
27
+ network: {
28
+ t: "obj",
29
+ fields: {
30
+ allowedDomains: STRINGS, deniedDomains: STRINGS, strictAllowlist: BOOL, allowManagedDomainsOnly: { t: "merge" }, allowUnixSockets: PATHS, allowAllUnixSockets: BOOL,
31
+ allowLocalBinding: BOOL, allowMachLookup: STRINGS, httpProxyPort: { t: "port" }, socksProxyPort: { t: "port" },
32
+ tlsTerminate: { t: "obj", fields: { caCertPath: { t: "abs" }, caKeyPath: { t: "abs" } } },
33
+ },
34
+ },
35
+ credentials: {
36
+ t: "obj",
37
+ fields: {
38
+ files: { t: "list", item: { t: "obj", required: ["path", "mode"], fields: { path: { t: "abs" }, mode: MODE, extract: STR, onExtractNoMatch: NO_MATCH, decode: { t: "enum", of: ["jwt"] }, maskClaims: STRINGS, maskDuplicates: BOOL, injectHosts: STRINGS } } },
39
+ envVars: { t: "list", item: { t: "obj", required: ["name", "mode"], fields: { name: STR, mode: MODE, extract: STR, onExtractNoMatch: NO_MATCH, decode: { t: "enum", of: ["jwt"] }, maskClaims: STRINGS, injectHosts: STRINGS } } },
40
+ allowPlaintextInject: BOOL,
41
+ awsPairs: { t: "list", item: { t: "obj", required: ["accessKeyIdVar", "secretAccessKeyVar"], fields: { accessKeyIdVar: STR, secretAccessKeyVar: STR, sessionTokenVar: STR } } },
42
+ sigv4: { t: "obj", fields: { streaming: SIG, presigned: SIG, sigv4a: SIG } },
43
+ },
44
+ },
45
+ enableWeakerNestedSandbox: BOOL,
46
+ allowNestedUserNamespaces: BOOL,
47
+ enableWeakerNetworkIsolation: BOOL,
48
+ allowAppleEvents: BOOL,
49
+ ripgrep: { t: "obj", required: ["command"], fields: { command: STR, args: STRINGS } },
50
+ bwrapPath: { t: "abs" },
51
+ socatPath: { t: "abs" },
52
+ },
53
+ };
54
+ function settingsInvalid(key, why) {
55
+ const e = new Error(`TaskSpec.sandbox${key === "" ? "" : `.${key}`} ${why} — a sandbox requirement that cannot be read is no requirement, so the run is refused rather than started without it.`);
56
+ e.code = SANDBOX_SETTINGS_INVALID;
57
+ e.detail = { key: key === "" ? "sandbox" : key, reason: why };
58
+ return e;
59
+ }
60
+ const shown = (v) => {
61
+ if (typeof v === "string")
62
+ return JSON.stringify(v.slice(0, 120));
63
+ if (v === null)
64
+ return "null";
65
+ if (Array.isArray(v))
66
+ return "an array";
67
+ return typeof v === "object" ? "an object" : `${typeof v} ${String(v).slice(0, 40)}`;
68
+ };
69
+ function pathProblem(p) {
70
+ if (p.includes("\0"))
71
+ return "holds a NUL character";
72
+ if (p.startsWith("/") || p.startsWith("~/"))
73
+ return undefined;
74
+ return "is not an absolute path or one under the home directory (`~/`): resolve it against the settings file it came from before sending it";
75
+ }
76
+ function judge(value, field, key) {
77
+ switch (field.t) {
78
+ case "merge":
79
+ throw settingsInvalid(key, "is applied by the host when it merges settings sources, and a task's requirement does not carry it");
80
+ case "bool":
81
+ if (typeof value !== "boolean")
82
+ throw settingsInvalid(key, `must be a boolean (got ${shown(value)})`);
83
+ return value;
84
+ case "str":
85
+ if (typeof value !== "string" || value.length === 0)
86
+ throw settingsInvalid(key, `must be a non-empty string (got ${shown(value)})`);
87
+ return value;
88
+ case "abs": {
89
+ if (typeof value !== "string" || value.length === 0)
90
+ throw settingsInvalid(key, `must be a non-empty path (got ${shown(value)})`);
91
+ const problem = pathProblem(value);
92
+ if (problem !== undefined)
93
+ throw settingsInvalid(key, `${shown(value)} ${problem}`);
94
+ return value;
95
+ }
96
+ case "port":
97
+ if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 65535)
98
+ throw settingsInvalid(key, `must be a TCP port, a whole number from 1 to 65535 (got ${shown(value)})`);
99
+ return value;
100
+ case "enum":
101
+ if (typeof value !== "string" || !field.of.includes(value))
102
+ throw settingsInvalid(key, `must be one of ${field.of.map((w) => JSON.stringify(w)).join(", ")} (got ${shown(value)})`);
103
+ return value;
104
+ case "strings": {
105
+ if (!Array.isArray(value))
106
+ throw settingsInvalid(key, `must be an array of strings (got ${shown(value)})`);
107
+ return Array.from(value, (v, i) => judge(v, field.paths === true ? { t: "abs" } : STR, `${key}[${i}]`));
108
+ }
109
+ case "list": {
110
+ if (!Array.isArray(value))
111
+ throw settingsInvalid(key, `must be an array (got ${shown(value)})`);
112
+ return Array.from(value, (v, i) => judge(v, field.item, `${key}[${i}]`));
113
+ }
114
+ case "map": {
115
+ if (typeof value !== "object" || value === null || Array.isArray(value))
116
+ throw settingsInvalid(key, `must be an object of lists (got ${shown(value)})`);
117
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, judge(v, field.value, `${key}[${JSON.stringify(k)}]`)]));
118
+ }
119
+ case "obj": {
120
+ if (typeof value !== "object" || value === null || Array.isArray(value))
121
+ throw settingsInvalid(key, `must be an object (got ${shown(value)})`);
122
+ const out = {};
123
+ for (const [k, v] of Object.entries(value)) {
124
+ const member = Object.hasOwn(field.fields, k) ? field.fields[k] : undefined;
125
+ const at = key === "" ? k : `${key}.${k}`;
126
+ if (member === undefined)
127
+ throw settingsInvalid(at, "is not a member of the sandbox settings");
128
+ if (v === undefined)
129
+ continue;
130
+ out[k] = judge(v, member, at);
131
+ }
132
+ for (const k of field.required ?? [])
133
+ if (out[k] === undefined)
134
+ throw settingsInvalid(key === "" ? k : `${key}.${k}`, "is required");
135
+ return out;
136
+ }
137
+ }
138
+ }
139
+ function resolvePaths(value, field, key, home) {
140
+ switch (field.t) {
141
+ case "abs":
142
+ return resolvedPath(String(value), key, home);
143
+ case "strings":
144
+ return field.paths === true && Array.isArray(value) ? value.map((p, i) => resolvedPath(String(p), `${key}[${i}]`, home)) : value;
145
+ case "list":
146
+ return Array.isArray(value) ? value.map((v, i) => resolvePaths(v, field.item, `${key}[${i}]`, home)) : value;
147
+ case "map":
148
+ return typeof value === "object" && value !== null ? Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolvePaths(v, field.value, `${key}[${JSON.stringify(k)}]`, home)])) : value;
149
+ case "obj":
150
+ return typeof value === "object" && value !== null
151
+ ? Object.fromEntries(Object.entries(value).map(([k, v]) => [k, Object.hasOwn(field.fields, k) ? resolvePaths(v, field.fields[k], key === "" ? k : `${key}.${k}`, home) : v]))
152
+ : value;
153
+ default:
154
+ return value;
155
+ }
156
+ }
157
+ export function receiveTaskSandbox(value) {
158
+ if (value === undefined)
159
+ return undefined;
160
+ const prior = typeof value === "object" && value !== null ? RECEIVED_REQUIREMENTS.get(value) : undefined;
161
+ if (prior !== undefined)
162
+ return prior;
163
+ const received = receive(value, { accessors: "call-once", depth: 6, others: "refuse", past: "refuse", isProxy: (v) => types.isProxy(v) });
164
+ if (!received.ok)
165
+ throw settingsInvalid(received.fault.path.join("."), `cannot be received as data (${received.fault.kind})`);
166
+ const judged = deepFreeze(judge(received.value, SETTINGS, ""));
167
+ if (typeof value === "object" && value !== null)
168
+ RECEIVED_REQUIREMENTS.set(value, judged);
169
+ return judged;
170
+ }
171
+ const RECEIVED_REQUIREMENTS = new WeakMap();
172
+ function deepFreeze(v) {
173
+ if (typeof v === "object" && v !== null && !Object.isFrozen(v)) {
174
+ for (const m of Object.values(v))
175
+ deepFreeze(m);
176
+ Object.freeze(v);
177
+ }
178
+ return v;
179
+ }
180
+ const OFF = Object.freeze({ state: "off" });
181
+ export function judgeCommandSandbox(j) {
182
+ const settings = receiveTaskSandbox(j.requirement);
183
+ if (settings === undefined || settings.enabled !== true)
184
+ return OFF;
185
+ const failIfUnavailable = settings.failIfUnavailable ?? true;
186
+ if (!providesCommandSandbox(j.env)) {
187
+ const reason = "the execution environment does not declare a command sandbox (capabilities.commandSandbox is not true)";
188
+ if (failIfUnavailable) {
189
+ const e = new Error(`sandbox required but unavailable: ${reason} — sandbox.failIfUnavailable is set, so the run is refused rather than started without a working sandbox. Run it on an environment that keeps a command sandbox, or set sandbox.failIfUnavailable to false to run without one.`);
190
+ e.code = COMMAND_SANDBOX_UNAVAILABLE;
191
+ throw e;
192
+ }
193
+ deliverEngineNotice(j.onNotice, {
194
+ code: COMMAND_SANDBOX_UNAVAILABLE,
195
+ message: `Sandbox disabled: ${reason}. Commands will run WITHOUT sandboxing: the network and filesystem restrictions of sandbox will NOT be enforced.`,
196
+ detail: { reason, ...(j.attribution?.sessionId !== undefined ? { sessionId: j.attribution.sessionId } : {}), ...(j.attribution?.runId !== undefined ? { runId: j.attribution.runId } : {}) },
197
+ });
198
+ return Object.freeze({ state: "unavailable", reason });
199
+ }
200
+ return Object.freeze({ state: "armed", requirement: instructionOf(settings, j.home) });
201
+ }
202
+ function resolvedPath(p, key, home) {
203
+ if (!p.startsWith("~/"))
204
+ return p;
205
+ if (home === undefined || !home.startsWith("/"))
206
+ throw settingsInvalid(key, `${shown(p)} is under the home directory, and the execution environment states no absolute home directory to read it against`);
207
+ return `${home.replace(/\/+$/, "")}/${p.slice(2)}`;
208
+ }
209
+ function instructionOf(judged, home) {
210
+ const s = resolvePaths(judged, SETTINGS, "", home);
211
+ const fsPaths = (k) => [...(s.filesystem?.[k] ?? [])];
212
+ const { allowedDomains: _a, deniedDomains: _d, strictAllowlist: _s, ...networkMechanism } = s.network ?? {};
213
+ const mechanism = {
214
+ ...(s.filesystem?.disabled !== undefined ? { filesystem: { disabled: s.filesystem.disabled } } : {}),
215
+ ...(Object.keys(networkMechanism).length > 0 ? { network: networkMechanism } : {}),
216
+ ...(s.credentials !== undefined ? { credentials: s.credentials } : {}),
217
+ ...(s.enableWeakerNestedSandbox !== undefined ? { enableWeakerNestedSandbox: s.enableWeakerNestedSandbox } : {}),
218
+ ...(s.allowNestedUserNamespaces !== undefined ? { allowNestedUserNamespaces: s.allowNestedUserNamespaces } : {}),
219
+ ...(s.enableWeakerNetworkIsolation !== undefined ? { enableWeakerNetworkIsolation: s.enableWeakerNetworkIsolation } : {}),
220
+ ...(s.allowAppleEvents !== undefined ? { allowAppleEvents: s.allowAppleEvents } : {}),
221
+ ...(s.ripgrep !== undefined ? { ripgrep: s.ripgrep } : {}),
222
+ ...(s.bwrapPath !== undefined ? { bwrapPath: s.bwrapPath } : {}),
223
+ ...(s.socatPath !== undefined ? { socatPath: s.socatPath } : {}),
224
+ };
225
+ return deepFreeze({
226
+ boundary: {
227
+ filesystem: { allowWrite: fsPaths("allowWrite"), denyWrite: fsPaths("denyWrite"), denyRead: fsPaths("denyRead"), allowRead: fsPaths("allowRead") },
228
+ network: { allowedDomains: [...(s.network?.allowedDomains ?? [])], deniedDomains: [...(s.network?.deniedDomains ?? [])] },
229
+ },
230
+ mechanism: structuredClone(mechanism),
231
+ });
232
+ }
233
+ const NO_PLAN = Object.freeze({ kind: "none" });
234
+ export function commandSandboxPlan(run, call, envHandToolNames, writeRoots) {
235
+ if (run.state !== "armed" || !envHandToolNames.has(wireOf("commandSandbox.plan.hand", call)) || !isShellFaceToolName(call.toolName))
236
+ return NO_PLAN;
237
+ const { boundary, mechanism } = run.requirement;
238
+ const allowWrite = Object.freeze([...new Set([...writeRoots(), ...boundary.filesystem.allowWrite])]);
239
+ const instruction = Object.freeze({ boundary: Object.freeze({ filesystem: Object.freeze({ ...boundary.filesystem, allowWrite }), network: boundary.network }), mechanism });
240
+ return Object.freeze({ kind: "command", instruction });
241
+ }
242
+ const REFUSED_START = Object.freeze({ ok: false });
243
+ export function commandSandboxSeat(run) {
244
+ if (run.state !== "armed")
245
+ return undefined;
246
+ return () => {
247
+ const plan = commandSandboxPlanInForce();
248
+ return plan?.kind === "command" ? { ok: true, sandbox: plan.instruction } : REFUSED_START;
249
+ };
250
+ }
251
+ export function sandboxRefusalText(toolName, refusal) {
252
+ const head = `Error (${toolName.slice(0, 64)}): the command was not run`;
253
+ if (refusal.by === "gate")
254
+ return `${head}: the run requires an OS sandbox for its commands and this call carries no sandbox plan (it was not let go by the run's gate).`;
255
+ const tail = refusal.refusedBy === "this_call"
256
+ ? "The environment cannot keep an entry of this command's sandbox boundary; a command whose boundary it can keep still runs."
257
+ : "The environment's sandbox is not working, so no command can run sandboxed here; report it rather than retrying.";
258
+ return `${head}: the sandbox could not be enforced for it (${refusal.detail.slice(0, 600)}). ${tail}`;
259
+ }
260
+ const listOf = (v) => (Array.isArray(v) ? v : undefined);
261
+ const literalIntersection = (a, b) => b.filter((x) => (a ?? []).includes(x));
262
+ const union = (a, b) => [...new Set([...(a ?? []), ...(b ?? [])])];
263
+ const NO_MATCH_ORDER = ["warn", "deny", "error"];
264
+ const TIGHTEN_BOOLS = { enabled: false, "network.strictAllowlist": false };
265
+ const LOOSEN_BOOLS = {
266
+ autoAllowBashIfSandboxed: true, allowUnsandboxedCommands: true, "filesystem.disabled": false, enableWeakerNestedSandbox: false, allowNestedUserNamespaces: false,
267
+ enableWeakerNetworkIsolation: false, allowAppleEvents: false, "network.allowAllUnixSockets": false, "network.allowLocalBinding": false, "credentials.allowPlaintextInject": false,
268
+ };
269
+ const DENY_LISTS = ["filesystem.denyWrite", "filesystem.denyRead", "network.deniedDomains"];
270
+ const ALLOW_LISTS = ["filesystem.allowWrite", "filesystem.allowRead", "network.allowedDomains", "network.allowUnixSockets", "network.allowMachLookup", "excludedCommands"];
271
+ const at = (o, path) => path.split(".").reduce((v, k) => (typeof v === "object" && v !== null ? v[k] : undefined), o);
272
+ function put(o, path, value) {
273
+ const keys = path.split(".");
274
+ let cur = o;
275
+ for (const k of keys.slice(0, -1)) {
276
+ if (typeof cur[k] !== "object" || cur[k] === null)
277
+ cur[k] = {};
278
+ cur = cur[k];
279
+ }
280
+ if (value === undefined)
281
+ delete cur[keys[keys.length - 1]];
282
+ else
283
+ cur[keys[keys.length - 1]] = value;
284
+ }
285
+ export function mergeChildSandbox(parent, childValue) {
286
+ const child = receiveTaskSandbox(childValue);
287
+ if (parent === undefined)
288
+ return child;
289
+ if (child === undefined)
290
+ return parent;
291
+ const p = { ...parent };
292
+ const out = structuredClone({ ...parent });
293
+ const stated = (path) => at(child, path) !== undefined;
294
+ const parentBool = (path, absent) => {
295
+ if (path === "failIfUnavailable")
296
+ return typeof p["failIfUnavailable"] === "boolean" ? p["failIfUnavailable"] : p["enabled"] === true;
297
+ const v = at(p, path);
298
+ return typeof v === "boolean" ? v : absent;
299
+ };
300
+ for (const [path, absent] of Object.entries({ ...TIGHTEN_BOOLS, failIfUnavailable: false }))
301
+ if (stated(path))
302
+ put(out, path, parentBool(path, absent) || at(child, path) === true);
303
+ for (const [path, absent] of Object.entries(LOOSEN_BOOLS))
304
+ if (stated(path))
305
+ put(out, path, parentBool(path, absent) && at(child, path) === true);
306
+ for (const path of DENY_LISTS)
307
+ if (stated(path))
308
+ put(out, path, union(listOf(at(p, path)), listOf(at(child, path))));
309
+ for (const path of ALLOW_LISTS)
310
+ if (stated(path))
311
+ put(out, path, literalIntersection(listOf(at(p, path)), listOf(at(child, path)) ?? []));
312
+ if (stated("ignoreViolations")) {
313
+ const pv = (p["ignoreViolations"] ?? {});
314
+ const cv = at(child, "ignoreViolations");
315
+ const merged = {};
316
+ if (typeof cv === "object" && cv !== null)
317
+ for (const [pattern, paths] of Object.entries(cv))
318
+ if (pv[pattern] !== undefined)
319
+ merged[pattern] = literalIntersection(pv[pattern], listOf(paths) ?? []);
320
+ out["ignoreViolations"] = merged;
321
+ }
322
+ for (const [list, key] of [["credentials.files", "path"], ["credentials.envVars", "name"]]) {
323
+ if (!stated(list))
324
+ continue;
325
+ const entries = new Map();
326
+ for (const e of listOf(at(p, list)) ?? [])
327
+ if (typeof e === "object" && e !== null)
328
+ entries.set(e[key], { ...e });
329
+ for (const e of listOf(at(child, list)) ?? []) {
330
+ if (typeof e !== "object" || e === null)
331
+ continue;
332
+ const mine = e;
333
+ const theirs = entries.get(mine[key]);
334
+ if (theirs === undefined) {
335
+ entries.set(mine[key], { ...mine });
336
+ continue;
337
+ }
338
+ const strictest = (a, b) => (NO_MATCH_ORDER.indexOf(String(a ?? "warn")) >= NO_MATCH_ORDER.indexOf(String(b ?? "warn")) ? a : b);
339
+ entries.set(mine[key], { ...theirs, mode: theirs["mode"] === "deny" || mine["mode"] === "deny" ? "deny" : "mask", ...(theirs["onExtractNoMatch"] !== undefined || mine["onExtractNoMatch"] !== undefined ? { onExtractNoMatch: strictest(theirs["onExtractNoMatch"], mine["onExtractNoMatch"]) } : {}) });
340
+ }
341
+ put(out, list, [...entries.values()]);
342
+ }
343
+ return receiveTaskSandbox(out);
344
+ }
@@ -0,0 +1,21 @@
1
+ /** Mint the completion identity of `target` ONCE, fill-once (first writer wins): every terminal-transition site calls
2
+ * this instead of writing `completionId` directly, so however many sites a lane has (settle / TaskStop circumvention /
3
+ * backfill / a store-side terminal write), the value is minted exactly once and every later caller — including an
4
+ * idempotent re-call from a path that already ran — gets back the SAME id. The parameter is any object with an
5
+ * optional `completionId`, so one helper serves a registry handle, a `WorkflowRun` and a durable
6
+ * `BackgroundAgentRecord` alike (no shared base type, same fill-once shape). */
7
+ export declare function mintCompletionId(target: {
8
+ completionId?: string;
9
+ }): string;
10
+ /** A completion identity chosen BEFORE it is safe to commit — for a caller whose terminal write is a CAS not yet known to
11
+ * win. The value goes into the durable payload at once (that write only takes effect if its own CAS wins) and onto the
12
+ * live object only through {@link commitCompletionIdIfEmpty}, from the call that already knows the CAS won. */
13
+ export declare function completionIdCandidate(): string;
14
+ /** Sibling of {@link mintCompletionId} for the CAS caller above: fill-once with an EXTERNALLY-chosen value (from
15
+ * {@link completionIdCandidate}) instead of generating a fresh one. Exists because committing a candidate onto a live
16
+ * handle before its durable CAS was confirmed left a losing attempt's id on a non-terminal ("parked") handle that nothing
17
+ * ever cleared, and a later legitimate parked→running flip then carried it into an unrelated real completion through
18
+ * {@link mintCompletionId}'s own fill-once guard. */
19
+ export declare function commitCompletionIdIfEmpty(target: {
20
+ completionId?: string;
21
+ }, value: string): string;
@@ -0,0 +1,14 @@
1
+ import { uuidv7 } from "../internal/harness.js";
2
+ export function mintCompletionId(target) {
3
+ if (target.completionId === undefined)
4
+ target.completionId = uuidv7();
5
+ return target.completionId;
6
+ }
7
+ export function completionIdCandidate() {
8
+ return uuidv7();
9
+ }
10
+ export function commitCompletionIdIfEmpty(target, value) {
11
+ if (target.completionId === undefined)
12
+ target.completionId = value;
13
+ return target.completionId;
14
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The CONFIG REFUSAL WORDS — every word of the `config.*` / `resume_at.*` family the engine throws as the `code` of a refusal: the one closed
3
+ * set a host holds its status table over (`satisfies Record<ConfigRefusalCode, …>`), so a door that gains a word turns the host `tsc`-red until it
4
+ * places the word, instead of failing in production as a code nobody mapped.
5
+ *
6
+ * Where a word reaches a host: `TaskResult.errorCode` of a run refused at prepare's doors, `detail.code` of a resume's `checkpoint.config_refused`
7
+ * ({@link CHECKPOINT_CONFIG_REFUSAL_CODES} — the subset a resume's pre-claim screen can carry, typed against this set), the thrown error of a library
8
+ * entry that refuses at the same kind of door (the memory engine's requests and scope contract, the MCP probe, the web tool's knobs, the protocol
9
+ * auth head, the containment faces), and the tool-declaration door (`TOOL_DECLARATION_CODES`, also a subset of this set). The set is the NAMESPACE's
10
+ * registry, not the prepare path's: whether a given word is reachable from `runTask` is a fact about the door, which a syntax reader cannot decide,
11
+ * and a word a host never meets costs it one status row.
12
+ *
13
+ * NOT members: a notice word (`ENGINE_NOTICE_CODES`) that is only ever a notice's `code` — a disclosure, never a refusal; a family-shaped string that
14
+ * is no code at all (a trace frame's `kind`, a station name — `scripts/config-refusal-nonwords.json`, each with its reason). A notice word that is ALSO
15
+ * thrown (the retired-tool-name refusal, `config.read_deny_floor_unkept`, `config.tool_model_gate_env_invalid`, the sandbox's
16
+ * `config.command_sandbox_unavailable`) is a member.
17
+ *
18
+ * A CLOSED SET with one home, registered in `docs/CLOSED-SETS.md`; `gate:closed-sets` holds the whole family to it: every family literal under
19
+ * `src/` is a member, a notice word in a notice's `code`, or a ledgered non-word, and every member is still spelled somewhere.
20
+ */
21
+ export declare const CONFIG_REFUSAL_CODES: readonly ["config.a2a_peer_name_collision", "config.advisor_model_invalid", "config.advisor_tool_invalid", "config.agent.duplicate", "config.agent.invalid", "config.agent.reserved_name", "config.agent.unknown_model", "config.agent.unknown_tool", "config.agent_config_dir_invalid", "config.agents.no_delegation_tool", "config.approval_reach_invalid", "config.attachment_invalid", "config.auto_consolidation", "config.auto_mode_classifier_fallback_invalid", "config.auto_mode_denial_limit_invalid", "config.auto_mode_rate_limit_break_invalid", "config.auto_mode_timeout_invalid", "config.brain_call_guardrail_invalid", "config.cascade_invalid", "config.circuit_breaker_invalid", "config.command_sandbox_unavailable", "config.compliance_denied", "config.compliance_posture", "config.compliance_required", "config.context_settings_unknown_word", "config.credential_in_declaration", "config.credential_ref_invalid", "config.cross_boundary_posture", "config.cwd_conflicts_restore", "config.cwd_not_honored", "config.cwd_outside_root", "config.cwd_unsupported", "config.defer_mode_invalid", "config.delegation_entry_caps", "config.deps_retired_key", "config.egress_requires_write_effect", "config.empty_objective", "config.env_lifetime_invalid", "config.execution_env_home_dir_invalid", "config.extra_body_output_cap", "config.extra_tool_names", "config.host_floor_invalid", "config.host_floor_refused", "config.image_invalid", "config.interaction_posture", "config.interaction_wiring", "config.invalid_argument", "config.invalid_checkpoint_store", "config.invalid_file_history_capture", "config.invalid_file_history_store", "config.invalid_governance_baseline", "config.invalid_on_track_failure", "config.invalid_output_schema", "config.invalid_permission_rules", "config.invalid_task_registry", "config.invalid_tool_name_set", "config.language_invalid", "config.legacy_tool_name", "config.limit_invalid", "config.limit_unknown_key", "config.locked_key", "config.locked_registry", "config.mcp_content_class", "config.mcp_dialable_failed", "config.mcp_fingerprint_invalid", "config.mcp_host_seat_missing", "config.mcp_host_seat_undeclared", "config.mcp_pool_foreign_connection", "config.mcp_probe_option", "config.mcp_server_name_collision", "config.mcp_startup_timeout_invalid", "config.memory_capture_policy", "config.memory_capture_spelling", "config.memory_capture_unsupported", "config.memory_challenge_request", "config.memory_consolidation", "config.memory_consolidation_driver", "config.memory_consolidation_lease_required", "config.memory_consolidation_provenance_off", "config.memory_consolidation_replica_local", "config.memory_consolidation_write_gate", "config.memory_delegation_evidence", "config.memory_dir_not_backend_root", "config.memory_distiller_purity_contract", "config.memory_dual_root_overlap", "config.memory_erasure_request", "config.memory_erasure_scope", "config.memory_export_request", "config.memory_hold_timeout", "config.memory_import_request", "config.memory_persistence_invalid", "config.memory_project_identity", "config.memory_project_key_spelling", "config.memory_project_marker", "config.memory_project_marker_nested", "config.memory_provenance", "config.memory_reanchor", "config.memory_rebuild_reason", "config.memory_scope_key", "config.memory_scope_placement", "config.memory_scope_spelling", "config.memory_sync_cursor_mismatch", "config.memory_sync_store", "config.memory_sync_target_mismatch", "config.memory_write_scope_mismatch", "config.microcompact_invalid", "config.missing_scope", "config.model_fallback_invalid", "config.mods_invalid", "config.nothing_to_wake", "config.output_style_invalid", "config.parent_spec_seat_missing", "config.peer_answer_invalid", "config.peer_presence_invalid", "config.peer_seat_missing", "config.permission_mode_invalid", "config.placement_not_honored", "config.placement_root_invalid", "config.plan_file_invalid", "config.principal_inbox_consumer_invalid", "config.project_id_invalid", "config.project_identity_mismatch", "config.prompt_selector_invalid", "config.prompt_trait_unknown", "config.protocol_endpoint_unbound", "config.protocol_header_collision", "config.protocol_plaintext_credentials", "config.read_deny_floor_unkept", "config.read_face_invalid", "config.read_face_org_task_escalation", "config.read_face_readonly_conflict", "config.read_face_seat", "config.registry_scope_mismatch", "config.reserved_tool_name", "config.retention_capability", "config.retention_policy", "config.retention_policy_invalid", "config.run_origin_invalid", "config.safe_vars_reserved_name", "config.sandbox_admission_unavailable", "config.sandbox_settings_invalid", "config.session_rules_unreadable", "config.session_workspace_changed", "config.session_workspace_invalid", "config.shell_gate_value_retired", "config.skill_base_dir_invalid", "config.skill_deny_unreadable", "config.skill_listing_budget_invalid", "config.spec_member_unreadable", "config.spec_retired_key", "config.spec_unknown_key", "config.stale_tool_result_offload_invalid", "config.stall_timeout_invalid", "config.stall_timeout_retired", "config.store_durability_invalid", "config.store_fidelity_invalid", "config.tool_contract_too_long", "config.tool_face_control", "config.tool_face_invalid", "config.tool_materialize_invalid", "config.tool_materialize_unreachable", "config.tool_model_gate_env_invalid", "config.tool_model_gate_invalid", "config.tool_mount_denied", "config.tool_name_invalid", "config.tool_name_too_long", "config.tool_roster_bound", "config.tool_roster_mount_tag", "config.tool_roster_origin", "config.tool_schema_bound", "config.tool_search_invalid", "config.toolpolicy.unmatched_names", "config.unknown_role", "config.usage_window_invalid", "config.usage_window_unpriced", "config.user_attachment_invalid", "config.user_invoked_skill_unknown", "config.verify_internals_invalid", "config.web_max_bytes_invalid", "config.web_search_max_results_invalid", "config.web_summary_max_content_invalid", "config.web_timeout_invalid", "config.write_exempt_dir_covers_root", "config.write_face_invalid", "config.write_face_org_task_escalation", "config.write_face_readonly_conflict", "resume_at.before_root_unsupported", "resume_at.before_target_not_user", "resume_at.conflicts_resume", "resume_at.invalid_mode", "resume_at.mode_without_target", "resume_at.no_session", "resume_at.not_a_message", "resume_at.not_found"];
22
+ export type ConfigRefusalCode = (typeof CONFIG_REFUSAL_CODES)[number];
@@ -0,0 +1,196 @@
1
+ export const CONFIG_REFUSAL_CODES = Object.freeze([
2
+ "config.a2a_peer_name_collision",
3
+ "config.advisor_model_invalid",
4
+ "config.advisor_tool_invalid",
5
+ "config.agent.duplicate",
6
+ "config.agent.invalid",
7
+ "config.agent.reserved_name",
8
+ "config.agent.unknown_model",
9
+ "config.agent.unknown_tool",
10
+ "config.agent_config_dir_invalid",
11
+ "config.agents.no_delegation_tool",
12
+ "config.approval_reach_invalid",
13
+ "config.attachment_invalid",
14
+ "config.auto_consolidation",
15
+ "config.auto_mode_classifier_fallback_invalid",
16
+ "config.auto_mode_denial_limit_invalid",
17
+ "config.auto_mode_rate_limit_break_invalid",
18
+ "config.auto_mode_timeout_invalid",
19
+ "config.brain_call_guardrail_invalid",
20
+ "config.cascade_invalid",
21
+ "config.circuit_breaker_invalid",
22
+ "config.command_sandbox_unavailable",
23
+ "config.compliance_denied",
24
+ "config.compliance_posture",
25
+ "config.compliance_required",
26
+ "config.context_settings_unknown_word",
27
+ "config.credential_in_declaration",
28
+ "config.credential_ref_invalid",
29
+ "config.cross_boundary_posture",
30
+ "config.cwd_conflicts_restore",
31
+ "config.cwd_not_honored",
32
+ "config.cwd_outside_root",
33
+ "config.cwd_unsupported",
34
+ "config.defer_mode_invalid",
35
+ "config.delegation_entry_caps",
36
+ "config.deps_retired_key",
37
+ "config.egress_requires_write_effect",
38
+ "config.empty_objective",
39
+ "config.env_lifetime_invalid",
40
+ "config.execution_env_home_dir_invalid",
41
+ "config.extra_body_output_cap",
42
+ "config.extra_tool_names",
43
+ "config.host_floor_invalid",
44
+ "config.host_floor_refused",
45
+ "config.image_invalid",
46
+ "config.interaction_posture",
47
+ "config.interaction_wiring",
48
+ "config.invalid_argument",
49
+ "config.invalid_checkpoint_store",
50
+ "config.invalid_file_history_capture",
51
+ "config.invalid_file_history_store",
52
+ "config.invalid_governance_baseline",
53
+ "config.invalid_on_track_failure",
54
+ "config.invalid_output_schema",
55
+ "config.invalid_permission_rules",
56
+ "config.invalid_task_registry",
57
+ "config.invalid_tool_name_set",
58
+ "config.language_invalid",
59
+ "config.legacy_tool_name",
60
+ "config.limit_invalid",
61
+ "config.limit_unknown_key",
62
+ "config.locked_key",
63
+ "config.locked_registry",
64
+ "config.mcp_content_class",
65
+ "config.mcp_dialable_failed",
66
+ "config.mcp_fingerprint_invalid",
67
+ "config.mcp_host_seat_missing",
68
+ "config.mcp_host_seat_undeclared",
69
+ "config.mcp_pool_foreign_connection",
70
+ "config.mcp_probe_option",
71
+ "config.mcp_server_name_collision",
72
+ "config.mcp_startup_timeout_invalid",
73
+ "config.memory_capture_policy",
74
+ "config.memory_capture_spelling",
75
+ "config.memory_capture_unsupported",
76
+ "config.memory_challenge_request",
77
+ "config.memory_consolidation",
78
+ "config.memory_consolidation_driver",
79
+ "config.memory_consolidation_lease_required",
80
+ "config.memory_consolidation_provenance_off",
81
+ "config.memory_consolidation_replica_local",
82
+ "config.memory_consolidation_write_gate",
83
+ "config.memory_delegation_evidence",
84
+ "config.memory_dir_not_backend_root",
85
+ "config.memory_distiller_purity_contract",
86
+ "config.memory_dual_root_overlap",
87
+ "config.memory_erasure_request",
88
+ "config.memory_erasure_scope",
89
+ "config.memory_export_request",
90
+ "config.memory_hold_timeout",
91
+ "config.memory_import_request",
92
+ "config.memory_persistence_invalid",
93
+ "config.memory_project_identity",
94
+ "config.memory_project_key_spelling",
95
+ "config.memory_project_marker",
96
+ "config.memory_project_marker_nested",
97
+ "config.memory_provenance",
98
+ "config.memory_reanchor",
99
+ "config.memory_rebuild_reason",
100
+ "config.memory_scope_key",
101
+ "config.memory_scope_placement",
102
+ "config.memory_scope_spelling",
103
+ "config.memory_sync_cursor_mismatch",
104
+ "config.memory_sync_store",
105
+ "config.memory_sync_target_mismatch",
106
+ "config.memory_write_scope_mismatch",
107
+ "config.microcompact_invalid",
108
+ "config.missing_scope",
109
+ "config.model_fallback_invalid",
110
+ "config.mods_invalid",
111
+ "config.nothing_to_wake",
112
+ "config.output_style_invalid",
113
+ "config.parent_spec_seat_missing",
114
+ "config.peer_answer_invalid",
115
+ "config.peer_presence_invalid",
116
+ "config.peer_seat_missing",
117
+ "config.permission_mode_invalid",
118
+ "config.placement_not_honored",
119
+ "config.placement_root_invalid",
120
+ "config.plan_file_invalid",
121
+ "config.principal_inbox_consumer_invalid",
122
+ "config.project_id_invalid",
123
+ "config.project_identity_mismatch",
124
+ "config.prompt_selector_invalid",
125
+ "config.prompt_trait_unknown",
126
+ "config.protocol_endpoint_unbound",
127
+ "config.protocol_header_collision",
128
+ "config.protocol_plaintext_credentials",
129
+ "config.read_deny_floor_unkept",
130
+ "config.read_face_invalid",
131
+ "config.read_face_org_task_escalation",
132
+ "config.read_face_readonly_conflict",
133
+ "config.read_face_seat",
134
+ "config.registry_scope_mismatch",
135
+ "config.reserved_tool_name",
136
+ "config.retention_capability",
137
+ "config.retention_policy",
138
+ "config.retention_policy_invalid",
139
+ "config.run_origin_invalid",
140
+ "config.safe_vars_reserved_name",
141
+ "config.sandbox_admission_unavailable",
142
+ "config.sandbox_settings_invalid",
143
+ "config.session_rules_unreadable",
144
+ "config.session_workspace_changed",
145
+ "config.session_workspace_invalid",
146
+ "config.shell_gate_value_retired",
147
+ "config.skill_base_dir_invalid",
148
+ "config.skill_deny_unreadable",
149
+ "config.skill_listing_budget_invalid",
150
+ "config.spec_member_unreadable",
151
+ "config.spec_retired_key",
152
+ "config.spec_unknown_key",
153
+ "config.stale_tool_result_offload_invalid",
154
+ "config.stall_timeout_invalid",
155
+ "config.stall_timeout_retired",
156
+ "config.store_durability_invalid",
157
+ "config.store_fidelity_invalid",
158
+ "config.tool_contract_too_long",
159
+ "config.tool_face_control",
160
+ "config.tool_face_invalid",
161
+ "config.tool_materialize_invalid",
162
+ "config.tool_materialize_unreachable",
163
+ "config.tool_model_gate_env_invalid",
164
+ "config.tool_model_gate_invalid",
165
+ "config.tool_mount_denied",
166
+ "config.tool_name_invalid",
167
+ "config.tool_name_too_long",
168
+ "config.tool_roster_bound",
169
+ "config.tool_roster_mount_tag",
170
+ "config.tool_roster_origin",
171
+ "config.tool_schema_bound",
172
+ "config.tool_search_invalid",
173
+ "config.toolpolicy.unmatched_names",
174
+ "config.unknown_role",
175
+ "config.usage_window_invalid",
176
+ "config.usage_window_unpriced",
177
+ "config.user_attachment_invalid",
178
+ "config.user_invoked_skill_unknown",
179
+ "config.verify_internals_invalid",
180
+ "config.web_max_bytes_invalid",
181
+ "config.web_search_max_results_invalid",
182
+ "config.web_summary_max_content_invalid",
183
+ "config.web_timeout_invalid",
184
+ "config.write_exempt_dir_covers_root",
185
+ "config.write_face_invalid",
186
+ "config.write_face_org_task_escalation",
187
+ "config.write_face_readonly_conflict",
188
+ "resume_at.before_root_unsupported",
189
+ "resume_at.before_target_not_user",
190
+ "resume_at.conflicts_resume",
191
+ "resume_at.invalid_mode",
192
+ "resume_at.mode_without_target",
193
+ "resume_at.no_session",
194
+ "resume_at.not_a_message",
195
+ "resume_at.not_found",
196
+ ]);
@@ -159,6 +159,14 @@ export interface ContextEditOptions {
159
159
  * sum triggers.
160
160
  */
161
161
  anchoredTotalTokens?: number;
162
+ /**
163
+ * What a clear of these results (indices into `messages`) saves on the request as it is sent, given their structural
164
+ * savings — the minimum-savings gate reads it when set. The request carries a repeated copy of a file as one sentence
165
+ * (`request-copy-projection.ts`), so clearing a result that was itself a repeat saves nearly nothing, and clearing the
166
+ * earliest copy of a chain makes the next copy carry the contents instead: the gate's premise (every break of the
167
+ * prefix buys at least {@link MIN_CLEAR_SAVINGS_TOKENS}) is a statement about the request. Absent ⇒ the structural sum.
168
+ */
169
+ netSavings?: (cleared: readonly number[], structural: number) => number;
162
170
  /** design/123 D2 — structural coefficient (`Model.charsPerToken`); default 3 (design/374 slice 4;
163
171
  * it was 4 before). Note this does NOT reach the ≥20k gate, which is CC-exactly
164
172
  * hard-coded to 4 — see {@link structuralClearSavings}. */
@@ -185,6 +193,24 @@ export interface ContextEditOptions {
185
193
  */
186
194
  clearSource?: ReadonlyArray<AgentMessage>;
187
195
  }
196
+ /**
197
+ * The already-cleared predicate — the THREE-form family (design/374 §3.1, r2-Md⑪). CC's own `vby`
198
+ * predicate is not complete on this tree, so each sema-reachable cleared/persisted shape is
199
+ * enumerated:
200
+ * ① plain marker (CC bytes, exact) ② extended prefix (ref/media disclosures survive — re-clearing
201
+ * an extended marker would destroy them) ③ aggregate-offload preview
202
+ * ({@link PERSISTED_OUTPUT_PREFIX}, single-source import — a persisted result's inline text is
203
+ * already a stub; re-clearing it would destroy the pageback envelope). ③ checks the FIRST block
204
+ * only: a preview may legitimately carry trailing media blocks (`tool-result-store` keeps images
205
+ * beside the preview), unlike the marker forms.
206
+ * Every form is excluded from BOTH the savings estimate and the application set, while its
207
+ * occurrence still holds a keep-window slot (CC window-base semantics, `EUs` :397708). Tool output
208
+ * is untrusted bytes and can legitimately spell the marker — that dodge is accepted (the marker is
209
+ * the machine's own vocabulary; a result that quotes it is treated as already cleared).
210
+ * The request's copy projection reads the same predicate: a cleared result keeps its card (`details`)
211
+ * but carries none of its contents, so it stands for no copy.
212
+ */
213
+ export declare function isCleared(m: object): boolean;
188
214
  /**
189
215
  * audit A-1 (view-level heal for HISTORICAL pollution): drop synthetic EMPTY failure assistants —
190
216
  * stopReason aborted/error with no tool calls and no non-whitespace text/thinking. Sessions persisted