@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,6 +1,7 @@
1
- import { type AskOrigin, type AssertAllKeysHandled } from "./ask-origin.js";
1
+ import { type AskClass, type AskOrigin, type AssertAllKeysHandled } from "./ask-origin.js";
2
2
  import { type EngineAttestation } from "./engine-attestation.js";
3
3
  import { type ReadRootGrantScreen } from "./read-root-grant-screen.js";
4
+ import { type ApprovalWordsSeat } from "./approval-words.js";
4
5
  import { type DecidedVia, type Settlement } from "./gate-outcome.js";
5
6
  export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
6
7
  import { type BindingFault } from "./canonical-json.js";
@@ -242,6 +243,24 @@ export declare function advertisedWritableRootsSeat(seat: {
242
243
  export declare function exemptRootsSeat(exemptRoots: readonly string[]): {
243
244
  exemptRoots: readonly string[];
244
245
  };
246
+ /** The facts a leg stamps on a call it judges, read at the moment of each judgment (the leg's cells move: the tracked cwd, the
247
+ * advertised-directory ledger). Every member is optional — a leg without hands has no roster face, cwd or root. */
248
+ export interface CallFacts {
249
+ /** The leg's budget snapshot (`ToolCallRequest.budget`). */
250
+ budget?: ToolCallRequest["budget"] | undefined;
251
+ /** The roster's face for the judged tool (a containment fence admits a write only by the tool's own declared path target). */
252
+ face?: ToolCallFace | undefined;
253
+ cwd?: string | undefined;
254
+ root?: string | undefined;
255
+ advertisedWritableDirs?: {
256
+ readonly roots: readonly string[];
257
+ } | undefined;
258
+ exemptRoots?: readonly string[] | undefined;
259
+ }
260
+ /** The request members {@link CallFacts} stamp: the ONE reading every request a leg hands a policy goes through — the live gate's
261
+ * call, the parked call's re-adjudication, the resumed call's belts, and every synthetic probe (whose verdict must be the
262
+ * verdict the model's own call would get). The call's own members (name, args, id, grant-binding words) are not leg facts. */
263
+ export declare function callFactsSeat(f: CallFacts): Pick<ToolCallRequest, "budget" | "face" | "cwd" | "root" | "advertisedWritableRoots" | "exemptRoots">;
245
264
  /** Declared beside the receipt's list (decision-receipt.ts) — a new member added to either side is a compile error rather
246
265
  * than a silent drift between the type and the screen; re-exported here, the module every consumer of the decision reads. */
247
266
  export type { DecisionReason };
@@ -283,7 +302,7 @@ export declare const APPROVER_ATTRIBUTION_MAX_CHARS = 256;
283
302
  * TRANSCRIPTION of what the approval channel said about its own settlement — the channel (a server's
284
303
  * approval card, an HMAC-verified callback, an operator console) is where identity is established, and
285
304
  * a library that holds no identity surface cannot second-guess it. What core owns is that the value is
286
- * a value: a string, bounded, free of control bytes, or else loudly refused.
305
+ * a value: a string, bounded, free of control bytes, holding a visible character, or else loudly refused.
287
306
  *
288
307
  * Returns `{}` for "nothing supplied" (absent, and an empty string — an id of no characters is the
289
308
  * absence of an id, the same truthiness fold the deny-note seat uses), `{ approver }` for a value to
@@ -378,14 +397,15 @@ export type PermissionResult = {
378
397
  * decision that states it is refused at the receipt); a DISPLAY member: the approval card and the park row render it,
379
398
  * nothing reads it to decide, and the classifier never sees it (it is not part of `message`). Absent ⇒ no member matched. */
380
399
  allowRuleShadowed?: readonly import("./allow-rule-shadow.js").AllowRuleShadow[];
381
- /** backlog #239 disclosure (additive): WHY the reversibility probe did not clear this call, in the
382
- * probe's own words. ENGINE-STAMPED at the irreversibility tighten (which constructs this decision
383
- * wholesale), already neutralized + capped there; a `"maybe"` tier whose probe supplied no cause,
384
- * and the `"always"` tier (which runs no probe), leave it absent. Also stamped beside a mandate merged onto an
385
- * ask another layer raised (the read station's account of its finding): it is the one sentence that says why
386
- * a matching allow rule did not clear a `probe_mandate` ask, on the card and in the parked row alike. Same DISPLAY-ONLY posture as
387
- * {@link allowRuleShadowed}: a policy that self-declares it can only put its own prose on its
388
- * own card — nothing reads this member to decide anything, so it is not an authority channel. */
400
+ /** Disclosure (additive): the account of a FINDING about this call — a deployment reversibility probe's
401
+ * `reason` (why the probe did not clear the call) or the engine's read station's account of what it found. ENGINE-STAMPED
402
+ * by the gate after the receipt: at the irreversibility tighten (which constructs this decision wholesale), already
403
+ * neutralized + capped there — a `"maybe"` tier whose probe supplied no cause, and the `"always"` tier (which runs no
404
+ * probe), leave it absent —, and beside a mandate merged onto an ask another layer raised: it is the one sentence that
405
+ * says why a matching allow rule did not clear a `probe_mandate` ask, on the card and in the parked row alike. No policy
406
+ * or hook states it (a STAMP member: a decision that carries one is refused at the receipt) — an asker's own words ride
407
+ * the ask's `message`, which the receipt makes its `askReasons` entry. DISPLAY-ONLY like {@link allowRuleShadowed}:
408
+ * nothing reads this member to decide anything. */
389
409
  probeReason?: string;
390
410
  /** This ask puts a person's edit back to the person: the restriction chain would not run it as written and accepts it
391
411
  * only as {@link import("./rewrite-rejudge.js").EditRewritten.acceptableForm}, the bytes this ask presents. ENGINE-MINTED by
@@ -412,7 +432,8 @@ export type PermissionResult = {
412
432
  crossBoundaryMandated?: true;
413
433
  /** This ask is MANDATED — no persisted allow rule and no STANDING ANSWER (a release remembered from an
414
434
  * earlier call, at any scope, a session included) may retire it; only an answer produced for THIS call
415
- * clears it — a person, a hook, a deployment's blanket `onAsk: "allow"` seat, or the live deciders the
435
+ * clears it — a person, a hook, a deployment's blanket `onAsk: "allow"` seat or the class table a seat declares
436
+ * ({@link declareClassAnswers}: it answers each call by that call's classes, remembering nothing), or the live deciders the
416
437
  * ask's class row admits ({@link import("./ask-origin.js").MODE_ARBITRATION}); {@link requiresRealApproval}
417
438
  * is the stronger demand that also refuses the blanket seat. ENGINE-STAMPED at the gate's single origin stamp from the ONE derivation
418
439
  * the approval card's rule-offer word also reads ({@link import("./ask-origin.js").ruleClearanceOf},
@@ -436,10 +457,11 @@ export type PermissionResult = {
436
457
  * hesitation, so a classifier verdict must not be the thing that clears it. A policy self-declaring the member only
437
458
  * ever OPTS ITS OWN ask OUT of classifier auto-resolution (tightening — the false-claim direction is safe, unlike the
438
459
  * engine-stamped `"hook"` word whose risk was laundering provenance AWAY). {@link combinePolicies} carries it onto the
439
- * surviving ask when ANY folded-away concurrent ask bore it (monotone, tighten-only); it is consumed inside the gate
440
- * and NOT copied onto the park/approval-card request — but it is the ONE input of the `ask_rule` origin word they DO
441
- * carry ({@link origin}): a minter raising an ask for a written rule (a person's settings rule, an operator's must-ask
442
- * list) that leaves it unset gets `policy` there, indistinguishable from hesitation. */
460
+ * surviving ask when ANY folded-away concurrent ask bore it (monotone, tighten-only). It is the ONE input of the
461
+ * `ask_rule` origin word ({@link origin}): a minter raising an ask for a written rule (a person's settings rule, an
462
+ * operator's must-ask list) that leaves it unset gets `policy` there, indistinguishable from hesitation. The text
463
+ * itself rides the ask as written to the approval request ({@link AskRequest.matchedAskRule}) and to the parked row
464
+ * (`PendingAction.tool_approval.cardAskRule`); the refusal's gate record carries the origin word only. */
443
465
  matchedAskRule?: string;
444
466
  /** design/252 G-2 (additive): the RULE-PROVENANCE evidence behind this ask — see
445
467
  * {@link AskRuleEvidence}. A STAMP member, written inside the gate once, after the org layer and the
@@ -963,6 +985,7 @@ export type ApprovalSeatOutcome = boolean | (Extract<AskOutcome, {
963
985
  }> & {
964
986
  updatedInput?: never;
965
987
  readRootGrant?: never;
988
+ feedback?: never;
966
989
  });
967
990
  /**
968
991
  * Human-in-the-loop approval for selected tools. Tools in `requireApproval` call `approve(req)` and
@@ -976,13 +999,13 @@ export type ApprovalSeatOutcome = boolean | (Extract<AskOutcome, {
976
999
  * {@link import("./permission-rule-model.js").renderUntrustedCommandText} (the display baseline)
977
1000
  * or run its own screen — absence of the warning bit is "not on this surface", never "clean".
978
1001
  *
979
- * WHAT `approve` MAY RETURN: a boolean, as always, or the `{allow, …}` OUTCOME OBJECT the `onAsk` seat
980
- * takes, read by the SAME screen ({@link readApproverOutcomeObject}) and narrowed to what this seat has
981
- * a lane for ({@link ApprovalSeatOutcome}) — so a deployment here can report WHO ended the wait
982
- * (`settledBy:"policy"` for its own policy's yes or no, `"timeout"` for its own elapsed window), attach the
983
- * decider's `reason` and name the `approver`. A bare `true` / `false` is unchanged: a person's approval or
984
- * refusal, the refusal with this factory's own terse sentence. Before the object arm a bare boolean was the
985
- * only spelling there was, so a machine's decision filed a PERSON's record.
1002
+ * WHAT `approve` MAY RETURN: a boolean, as always, or the `{allow, …}` OUTCOME OBJECT the `onAsk` seat takes, read by the SAME screen
1003
+ * ({@link readApproverOutcomeObject}) and narrowed to what this seat has a lane for ({@link ApprovalSeatOutcome}) — so a deployment
1004
+ * here can report WHO ended the wait (`settledBy:"policy"` for its own policy's yes or no, `"timeout"` for its own elapsed window),
1005
+ * attach the decider's `reason` and name the `approver`. A bare `true` / `false` is unchanged: a person's approval or refusal, the
1006
+ * refusal with this factory's own terse sentence. Before the object arm a bare boolean was the only spelling there was, so a machine's
1007
+ * decision filed a PERSON's record. A person's yes answers this factory's own question about the call, never the `cross_boundary` one
1008
+ * the station raises after the policy (`gate-fold.ts`): that goes to the ask seat, and a run with none refuses the call headless.
986
1009
  */
987
1010
  export declare function createApprovalPolicy(opts: {
988
1011
  /** Tools that need an approval decision. */
@@ -1225,6 +1248,12 @@ export interface AskRequest {
1225
1248
  * account is rendered once onto {@link message} at this request's mint. A DISPLAY value, not an identity channel:
1226
1249
  * a stored rule's identity travels on {@link AskRuleEvidence.personalRuleDots}. */
1227
1250
  allowRuleShadowed?: readonly import("./allow-rule-shadow.js").AllowRuleShadow[];
1251
+ /** The written ask rule this card stands for, exactly as the decision's minter stamped it
1252
+ * ({@link PermissionResult}'s ask arm) — so a card can say "your rule X asks about this". Present only when the
1253
+ * minter stamped a non-empty string; relayed as written, never parsed, never matched against. The durable park
1254
+ * route keeps the same value on `PendingAction.tool_approval.cardAskRule`. UNTRUSTED-for-display; never
1255
+ * adjudication input. */
1256
+ readonly matchedAskRule?: string;
1228
1257
  /** WHY the reversibility probe did not clear this call — the account of the tighten the
1229
1258
  * card was showing WITHOUT until now (the gate knew the cause and dropped it at this seam, leaving the
1230
1259
  * approver the action but not the reason it is being asked about). Present only for a `"maybe"`-tier
@@ -1300,6 +1329,27 @@ export interface AskRequest {
1300
1329
  * bidi bit's two faces can.
1301
1330
  */
1302
1331
  readonly previewWithheld?: "oversize" | "unavailable";
1332
+ /**
1333
+ * What the write's target holds now, beside the change: present on every card of a tool whose roster row writes a file
1334
+ * on the execution environment (the write family, a path target that is not read-only, the environment leg), absent on
1335
+ * every other card. `text` — the target's text exactly when the model's own `Read` of that path, issued now, would be
1336
+ * served (the run's served-read judge with every ask held, then the Read tool's own text read, held to the file the
1337
+ * judgment named); `absent` — nothing is at the path (said only after the read was allowed); `withheld` with `why`:
1338
+ * `oversize` (over `EXISTING_TARGET_READ_CAP` bytes, never cut short), `not_text` (a directory, a binary file, a body
1339
+ * that is not UTF-8), `read_refused` (the resolution or a judgment layer refuses the read or would first ask someone, or
1340
+ * the run's roster has no `Read` — the judgment's probe carries the face the roster gives `Read`),
1341
+ * `unavailable` (no reader on this lane — an ancestor's question, a seat that will not answer, a policy approver's seat
1342
+ * — or the judgment or read could not finish within the judgment's budget).
1343
+ *
1344
+ * Read once per ask, only when a person's seat will answer the card: a seat that answers and is not a policy approver's
1345
+ * (`asPolicyApprover` — a policy seat renders no card, so its card says `unavailable` and nothing is read). Never committed
1346
+ * as the model having read the file. The text is the target's own bytes, unredacted and never cut — a surface that stores
1347
+ * or forwards the card owns its redaction and its rendering budget (`EXISTING_TARGET_READ_CAP` is the read's bound, not a
1348
+ * length to validate the text against). A SNAPSHOT as of the ask: the approved write may meet a changed file. The durable
1349
+ * park's twin is `PendingAction.tool_approval.existingTarget`: this card's member when this ask's live card read it (a
1350
+ * card answered `unavailable` and then parked), else read at the park before the run releases its environment.
1351
+ */
1352
+ readonly existingTarget?: import("./existing-target.js").ExistingTarget;
1303
1353
  /** Canonical digest of the call's tool ({@link toolName}) and {@link args} as presented in THIS ask, computed by the engine's
1304
1354
  * one call binding (`exactBoundInputHashOf`) — the same digest a durable park binds its checkpoint to, so an aggregating
1305
1355
  * approver can reconcile a synchronous ask row against a parked checkpoint row for the same call
@@ -1309,6 +1359,13 @@ export interface AskRequest {
1309
1359
  * wired-approver call, so a mint site added later is covered by construction); optional on the type because a deployment
1310
1360
  * may invoke its approver function directly. */
1311
1361
  readonly boundInputHash?: string;
1362
+ /** THIS question's identity in the checkpoint-id spelling ({@link import("./checkpoint-store.js").mintCheckpointId}), minted once
1363
+ * per question by the station that puts it to the approver: when the approver answers `"unavailable"` and the question parks
1364
+ * over the bytes this card showed, the row's `checkpointId` is this value; answered in-stream, no row ever carries it. A new
1365
+ * question is a new value (a fallback re-put, an approved edit's re-check, another asker's question, another call, bytes moved
1366
+ * after the card) — a card keyed on one is never answered by another. An identity, not a capability (the row's token resumes);
1367
+ * never adjudication input. On every request an engine station mints; optional because a deployment may call its approver. */
1368
+ readonly checkpointId?: string;
1312
1369
  /** A call to the engine's `Skill` tool: the hash of {@link boundGrants} — the digest a parked approval of the same card is judged by, so a live card reconciles against its parked row by `(toolCallId, boundGrantDigest)` and an answer is remembered by "this tool + this binding". Present exactly on that call (whoever asked, however the question was worded); every other card carries {@link boundGrantAbsence} instead; `message` renders the same lists narrowed to what releases in the leg's mode. Reconciliation metadata, never adjudication input. */
1313
1370
  readonly boundGrantDigest?: string;
1314
1371
  /** The value {@link boundGrantDigest} hashes: `{ skill, allowedTools, disallowedTools }` in canonical spelling (de-duplicated, sorted), `skill: null` when no loaded skill is named; a fresh copy per ask; same presence. Display metadata (deployment text — render with contextual escaping). */
@@ -1402,7 +1459,9 @@ export interface AskRequest {
1402
1459
  * carries the same seat under the same contract, filled by the same one factory.
1403
1460
  */
1404
1461
  readonly ruleOffersAbsence?: import("./ask-origin.js").RuleOffersAbsence;
1405
- /** The human/model-readable prompt explaining what needs approval. */
1462
+ /** The one line a person or the model reads for this ask. Not a second reason seat: a structured approval surface reads the
1463
+ * ask's reasons from {@link askReasons} (the askers' own words) and the typed members (the class, the origin, the mandate
1464
+ * word, {@link probeReason}), never from this line. */
1406
1465
  message: string;
1407
1466
  /** Runner-filled source identity (design S1d §1): the end-user {@link AskRequest} issuing task's
1408
1467
  * `principal` (design/62). An AGGREGATING `onAsk` (one approver fanning over N delegated workers)
@@ -1489,7 +1548,7 @@ export interface AskRequest {
1489
1548
  * present on every ask that carries one, whatever lane is wired.
1490
1549
  *
1491
1550
  * WHAT IT DOES NOT SAY: that no answerer may answer. An approver — a person, a hook, a deployment's
1492
- * blanket `onAsk: "allow"` seat — resolves a mandated ask normally; {@link requiresRealApproval} is
1551
+ * blanket `onAsk: "allow"` seat, the class table a seat declares ({@link declareClassAnswers}) — resolves a mandated ask normally; {@link requiresRealApproval} is
1493
1552
  * the stronger, separate demand and is the one the engine's blanket seat refuses. A surface whose
1494
1553
  * POSTURE seat declines to auto-answer mandated cards reads this member to know which they are.
1495
1554
  * ABSENT is not the opposite claim on an older engine: a consumer that must tell "this engine mints
@@ -1549,11 +1608,13 @@ export interface AskRequest {
1549
1608
  * when {@link askClass} is. */
1550
1609
  readonly classes?: readonly import("./ask-origin.js").AskClass[];
1551
1610
  /** WHO asked about this call and what each said, in its OWN words, in fold order ({@link
1552
- * import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, a hook's or an extension's reason, a hook
1553
- * host's cause word. Present ⇔ at least one asker said something of its own about this call; a generic question (the write
1554
- * gate's default sentence, the permission mode's own) and a sentence the engine composes about a fact that rides a typed
1555
- * member of this request are no entry. The structured approval surface renders this member and the typed members beside it,
1556
- * never {@link message}; `words` is untrusted display text (one line, capped). Filled by the four mint stations from one
1611
+ * import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, an integrity guard's question, a hook's or an
1612
+ * extension's reason, a hook host's cause word — the one machine-read seat of an asker's own words. Present ⇔ at least one
1613
+ * asker said something of its own about this call; a generic question (the write gate's default sentence, the permission
1614
+ * mode's own) and a sentence the engine composes about a fact that rides a typed member of this request are no entry. The
1615
+ * structured approval surface renders this member and the typed members beside it, never {@link message} (the line a person or
1616
+ * the model reads, not a second reason seat); `words` is untrusted display text (one line, capped). The inbox listing carries
1617
+ * the same entries (`CheckpointSummary.askReasons`). Filled by the four mint stations from one
1557
1618
  * reader; the parked row carries the same value (`PendingAction.tool_approval.askReasons`). Never caller/worker-settable:
1558
1619
  * a policy or hook answer that states it is refused at the decision receipt. */
1559
1620
  readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
@@ -1597,8 +1658,9 @@ export interface AskRequest {
1597
1658
  * Read it as PRESENCE-or-nothing: the field is either `true` or ABSENT. It is never written `false`,
1598
1659
  * because absence means "not detected", which honestly covers both "clean" and "the bounded scan did
1599
1660
  * not reach it" (a pathologically deep or huge argument graph stops at the scan budget) — a `false`
1600
- * would claim a proof the scan does not offer. Judged over the EXECUTING argument snapshot and the
1601
- * tool's own {@link preview} projection, i.e. the payload; {@link message} is deliberately out of
1661
+ * would claim a proof the scan does not offer. Judged over the EXECUTING argument snapshot, the
1662
+ * tool's own {@link preview} projection, i.e. the payload, and the target's current text the card
1663
+ * shows beside it ({@link existingTarget}); {@link message} is deliberately out of
1602
1664
  * scope (engine/policy-composed prose, not the thing that runs).
1603
1665
  *
1604
1666
  * Filled at the `resolveAsk` chokepoint, beside {@link boundInputHash} — every wired `onAsk`
@@ -1610,7 +1672,8 @@ export interface AskRequest {
1610
1672
  * mint sites, not over every approval callback. The other two human-decision routes:
1611
1673
  * ① a durable park/suspend never invokes `onAsk` and never mints an AskRequest — its twin of this
1612
1674
  * bit is the PERSISTED `PendingAction.tool_approval.hasBidiControls` on the parked row (judged at
1613
- * the park mint over the row's own fidelity-projected args snapshot + preview, so the two faces
1675
+ * the park mint by the same card scan, {@link cardCarriesBidiControls}, over the row's own
1676
+ * fidelity-projected args snapshot + preview + the row's `existingTarget`, so the two faces
1614
1677
  * can honestly differ on a shape-changing backend), projected to the inbox as
1615
1678
  * `CheckpointSummary.hasBidiControls` — see those fields in `checkpoint-store.ts` for the reading
1616
1679
  * contract; absence there is still "not detected", never a clean bill, and an inbox rendering
@@ -1727,8 +1790,8 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
1727
1790
  * already say "a person ended this wait" can also say which one, without core growing an identity
1728
1791
  * surface it deliberately does not have. Read the two together: `settledBy:"policy"` with an `approver` names
1729
1792
  * WHICH of the deployment's answering seats decided (a closed word the host owns, never a person).
1730
- * Screened, not trusted (see {@link screenApproverAttribution}): a non-string, an over-long value or one
1731
- * carrying control characters is a loud fail-closed refusal at {@link resolveAsk}, the same posture this
1793
+ * Screened, not trusted (see {@link screenApproverAttribution}): a non-string, an over-long value, one of
1794
+ * only whitespace or one carrying control characters is a loud fail-closed refusal at {@link resolveAsk}, the same posture this
1732
1795
  * seam takes for every other out-of-contract value — and the same reason, since a defective attribution
1733
1796
  * that were quietly dropped would leave a settlement looking unattributed rather than misreported. It is
1734
1797
  * carried on the DECIDER arms (a person's or a policy's allow or refusal) and never on an end the engine
@@ -1750,6 +1813,18 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
1750
1813
  * path) — announced `approval.read_root_granted`. Anything else changes nothing and is announced
1751
1814
  * `approval.read_root_grant_rejected`; the verdict it rode stands. A seat with no card (a policy's `approve`)
1752
1815
  * refuses it. Keeping the directory beyond this run is the deployment's (`TaskSpec.additionalReadDirectories`).
1816
+ *
1817
+ * `feedback` — "yes, and tell the agent what to do next": what the approving PERSON typed into the card's input, the allow arm's
1818
+ * counterpart of a refusal's `reason` and the exact twin of the durable resume's `ResumeOutcome` `policy_ask` `feedback`. PRESENT
1819
+ * only when the person wrote something: it is read by the one reading the durable decide uses (the outer whitespace dropped; empty
1820
+ * or whitespace-only is nothing, and mints nothing), and the model reads the rest as the user's own words — verbatim, no fence, no
1821
+ * wrapper sentence, no length bound — as the user message that follows the tool results of the batch the approved call is part of
1822
+ * (the durable leg's continuation carries the same bytes in the same position). Like the durable face it is ARM- AND DECIDER-SCOPED, and
1823
+ * refused rather than dropped (a fail-closed deny naming the member, announced as the approver's defect): written words on a refusal
1824
+ * (a refusal's words are `reason`), on an answer settled by `"policy"` or given by a seat declared a policy (a machine's text must
1825
+ * never reach the model as the user's), a non-string, or text carrying the engine's `<system-reminder>` tag (opening or closing). A
1826
+ * seat with no lane to deliver words — the {@link createApprovalPolicy} `approve` door, an Artifact read's own consent card — refuses
1827
+ * them the same way. Words still queued when the run ends are announced by the steer lane's undrained account, never silently lost.
1753
1828
  */
1754
1829
  export type AskOutcome = boolean | "unavailable" | {
1755
1830
  allow: boolean;
@@ -1759,7 +1834,19 @@ export type AskOutcome = boolean | "unavailable" | {
1759
1834
  approver?: string;
1760
1835
  decidedVia?: DecidedVia;
1761
1836
  readRootGrant?: string;
1837
+ feedback?: string;
1762
1838
  };
1839
+ /** An approver callback — the function arm of {@link OnAsk}. */
1840
+ type ApproverFn = Extract<OnAsk, (...args: never[]) => unknown>;
1841
+ /**
1842
+ * The ONE way engine code puts a new function in front of an approver: `wrap` receives the approver and returns the function
1843
+ * that calls it, and the wrapper is registered as the same decision-maker ({@link askApproverIdentity} answers the approver's
1844
+ * root for it). Every fact read off the root — "are these two consultations the same consultation", "is this approver a
1845
+ * policy" ({@link isPolicyApprover}) — therefore reads the same through any number of engine wrappers. A blanket
1846
+ * `"allow"`/`"deny"` or an absent seat is returned as it is: there is no approver to stand in front of.
1847
+ */
1848
+ export declare function wrapApprover(onAsk: OnAsk, wrap: (approver: ApproverFn) => ApproverFn): OnAsk;
1849
+ export declare function wrapApprover(onAsk: OnAsk | undefined, wrap: (approver: ApproverFn) => ApproverFn): OnAsk | undefined;
1763
1850
  /**
1764
1851
  * ruled 2026-08-04 — forward an approver into a delegated child, stamping every ask it raises with the
1765
1852
  * delegation it came from ({@link AskDelegationProvenance}).
@@ -1773,6 +1860,72 @@ export type AskOutcome = boolean | "unavailable" | {
1773
1860
  * otherwise overwrite it with its own shallower one.
1774
1861
  */
1775
1862
  export declare function withDelegationProvenance(onAsk: OnAsk, delegation: AskDelegationProvenance): OnAsk;
1863
+ /**
1864
+ * Declare an approver callback a POLICY — a program that answers asks on the deployment's behalf (it relays an answer a
1865
+ * person gave before, refuses, or answers `"unavailable"` so the ask parks for a person), not a person reachable through
1866
+ * a channel. Returns the same function. The run then reads its seat as `policy_callback`
1867
+ * ({@link import("./wiring-manifest.js").AskSeamForm}): `approvalReach: "none"` keeps it (the declaration sets aside the
1868
+ * one seat that could be a person), the manifest reports `policy_reachable`, the posture door refuses it beside
1869
+ * `interactionPosture: "interactive"`, and an allow it gives on an ask carrying `requiresRealApproval` is refused.
1870
+ *
1871
+ * Mark the value that is actually installed as `onAsk` — the outermost one: a host closure put in front of a marked
1872
+ * approver is a new function, and an unmarked function reads as a person (today's reading — a lost mark never widens
1873
+ * anything). Marking a wrapper the engine made marks the approver behind it. A policy that would answer every ask with
1874
+ * a new allow is the blanket `onAsk: "allow"`, not a marked approver; a blanket is not a callback and cannot be marked.
1875
+ * A non-function is refused (`TypeError`); marking twice is the same as marking once.
1876
+ */
1877
+ export declare function asPolicyApprover<F extends ApproverFn>(fn: F): F;
1878
+ /** Is this seat value an approver a deployment declared a policy ({@link asPolicyApprover})? Read at the approver's root, so
1879
+ * every engine wrapper of a marked approver answers the same; anything that is not a function answers `false`. */
1880
+ export declare function isPolicyApprover(v: unknown): boolean;
1881
+ /**
1882
+ * Declare the ask classes a seat answers by itself: `declareClassAnswers(seat, { classes, approver })` returns a NEW
1883
+ * approver function. An ask whose whole class set ({@link AskRequest.classes}: present, non-empty, every member in
1884
+ * `classes`) the table covers is answered `{ allow: true, settledBy: "policy", approver }` — the deployment's policy
1885
+ * allowed it, named by `approver` (a closed word the host owns) — and `seat` is not called; every other ask is `seat`'s.
1886
+ *
1887
+ * The table is DATA the engine reads: the resolver answers a covered ask with that same outcome without calling the
1888
+ * minted function, and the card's target ({@link AskRequest.existingTarget}) is not read for it, since nobody renders the
1889
+ * card. The settlement is the one the function's own answer files (`policy_allowed`, `who.party: "policy"`,
1890
+ * `who.approver: approver`). `seat` and every value that already holds it are left as they were: a table belongs only to
1891
+ * the function minted here and to the engine's wrappers of it (a delegated child's seat, an artifact mount's consent
1892
+ * wrapper). A host
1893
+ * closure put in front of the minted function is a new function the engine cannot read the table through: it is called,
1894
+ * and its call reaches the same answer.
1895
+ *
1896
+ * Only the classes a standing rule may clear can be declared — the column `ruleMayClear` of
1897
+ * {@link import("./ask-origin.js").MODE_ARBITRATION} (today `ordinary` and `unstated`): a table is a deployment's answer
1898
+ * to the questions the allow layer itself may answer, by class instead of by tool. A question the engine mints demanding a
1899
+ * person ({@link AskRequest.requiresRealApproval}) always carries a class outside that column, so no table covers it; a
1900
+ * hand-built request carrying the bit beside a covered set is answered by the table and refused by the real-approval arm,
1901
+ * as the function's own allow is.
1902
+ *
1903
+ * Whether the asks outside the table reach a person is the seat's form, as for any function: mark the minted function
1904
+ * ({@link asPolicyApprover}) when `seat` is a policy — mark the outermost value, `asPolicyApprover(declareClassAnswers(…))`.
1905
+ *
1906
+ * A bad declaration is refused (`TypeError`): `seat` not a function; `answers` not an object, or carrying a member besides
1907
+ * the two (`answers` is read by the engine's one receipt of a caller's record, so a Proxy or an object of another
1908
+ * prototype is refused in the receipt's own words, `config.invalid_argument`); `classes` not a non-empty array of {@link import("./ask-origin.js").ASK_CLASSES} words in that column;
1909
+ * `approver` absent, empty, or refused by the attribution screen (a string, bounded, no control or bidirectional bytes, not only whitespace).
1910
+ */
1911
+ export declare function declareClassAnswers(seat: ApproverFn, answers: {
1912
+ readonly classes: readonly AskClass[];
1913
+ readonly approver: string;
1914
+ }): ApproverFn;
1915
+ /**
1916
+ * The answer a seat's declared class table ({@link declareClassAnswers}) gives an ask with this class set — `undefined`
1917
+ * when the seat carries no table or the table does not cover the set. Covered = present, non-empty, every member in the
1918
+ * table. Read at the seat's root. The ONE reading of a table: the minted function answers by it, the resolver answers
1919
+ * by it without calling the seat, and the card-target read gate skips the read by it. A fresh object each time.
1920
+ */
1921
+ export declare function declaredClassAnswer(onAsk: unknown, classes: unknown): {
1922
+ allow: true;
1923
+ settledBy: "policy";
1924
+ approver: string;
1925
+ } | undefined;
1926
+ /** The classes a seat's declared table answers ({@link declareClassAnswers}), read at the seat's root — `undefined` when
1927
+ * the value is not a function carrying one. The wiring manifest's `ask.answeredClasses` reads this. */
1928
+ export declare function declaredAnswerClassesOf(onAsk: unknown): readonly AskClass[] | undefined;
1776
1929
  /**
1777
1930
  * ruled 2026-08-04 — the APPROVER BEHIND a possibly-forwarded `onAsk`: the identity that answers
1778
1931
  * "is this the same human/UI?" across delegation hops.
@@ -1785,11 +1938,13 @@ export declare function withDelegationProvenance(onAsk: OnAsk, delegation: AskDe
1785
1938
  */
1786
1939
  export declare function askApproverIdentity(onAsk: unknown): unknown;
1787
1940
  /**
1788
- * Is this `onAsk` seat a LIVE APPROVER — a person the run can actually reach?
1941
+ * Is this `onAsk` seat an ANSWERING SEAT — an approver callback the run can put an ask to and get an answer from now?
1789
1942
  *
1790
- * Only a function is. A blanket `"allow"`/`"deny"` string is a policy setting (the same reading the
1791
- * interaction-posture door gives it), and an absent seat is nobody at all; neither can answer an ask, so
1792
- * neither may outrank a durable park.
1943
+ * Only a function is — a person's channel or a deployment's policy callback ({@link asPolicyApprover}) alike: both are
1944
+ * asked first and answer (a policy may answer `"unavailable"`, and only then does the ask park). WHO answers is a
1945
+ * different question, read off the seat's form ({@link isPolicyApprover}); this one asks only whether anybody does. A
1946
+ * blanket `"allow"`/`"deny"` string is a policy SETTING, not a callback (the same reading the interaction-posture door
1947
+ * gives it), and an absent seat is nobody at all; neither can answer an ask, so neither may outrank a durable park.
1793
1948
  *
1794
1949
  * ONE definition on purpose. Two sites must agree on this — the run's own sync-first decline, and the
1795
1950
  * mandate frozen into the chain its children inherit — and when they were two hand-written booleans they
@@ -1799,7 +1954,7 @@ export declare function askApproverIdentity(onAsk: unknown): unknown;
1799
1954
  * beside {@link askApproverIdentity}, because the two sites are now two prepare phases (the inherited-gate
1800
1955
  * fold and the wiring station) plus the orchestrator, and each reaches DOWN for the one definition.
1801
1956
  */
1802
- export declare function isLiveApproverSeat(onAsk: OnAsk | undefined): boolean;
1957
+ export declare function isAnsweringSeat(onAsk: OnAsk | undefined): boolean;
1803
1958
  /** Where a durable-approval MANDATE on a leg comes from — the closed set of its two sources. */
1804
1959
  export declare const DURABLE_MANDATE_SOURCES: readonly ["force_durable_gate", "durable_approval"];
1805
1960
  export type DurableMandateSource = (typeof DURABLE_MANDATE_SOURCES)[number];
@@ -1810,7 +1965,7 @@ export type DurableMandateSource = (typeof DURABLE_MANDATE_SOURCES)[number];
1810
1965
  * cannot answer an ask, so the park is the only honest resolution). A live seat beside the opt-in is not a
1811
1966
  * mandate: the leg's asks — and its children's, at the same frozen seat — resolve there.
1812
1967
  *
1813
- * ONE definition on purpose, like {@link isLiveApproverSeat} beside it: the chain a parent freezes for its
1968
+ * ONE definition on purpose, like {@link isAnsweringSeat} beside it: the chain a parent freezes for its
1814
1969
  * children and the loud "mandated but no store" disclosure at the wiring station used to derive the same
1815
1970
  * fact with two hand-written conditions, and the second one read only the entitlement — a task that opted
1816
1971
  * in and had no store degraded to the live chain in silence.
@@ -1821,20 +1976,36 @@ export declare function durableMandateSourceOf(args: {
1821
1976
  onAsk: OnAsk | undefined;
1822
1977
  }): DurableMandateSource | undefined;
1823
1978
  /**
1824
- * Has this leg DECLARED a durable park opt-in, from EITHER source (the per-principal
1825
- * entitlement or the task's own `durableApproval`) — with NO live-seat narrowing. Deliberately
1826
- * NOT {@link durableMandateSourceOf}: that one asks "is every ask MANDATED to gate durably" (a
1827
- * live approver seat beside a mere `durableApproval` opt-in defeats the mandate), while this one
1828
- * asks "does this leg have a durable park FACILITY at all" — the question-face mount decision and
1829
- * the inherited-mandate float both need the bare declaration, seat or no seat, and had each spelled
1830
- * `forceDurableGate === true || durableApprovalDeclared` by hand (two call sites, `prepare-
1831
- * question-face.ts` and `prepare-policy-chain.ts`, one drifting from the other silently if either
1832
- * grows a third source or a typo'd operator).
1833
- */
1979
+ * Does this leg carry a durable park opt-in, with NO live-seat narrowing (unlike {@link durableMandateSourceOf}, "is every ask
1980
+ * MANDATED to gate durably")? Read by the question face and mount, the inherited-mandate float and the sandbox prerequisite. The
1981
+ * sources: the leg's `durableApproval` (a delegated leg's is the one its parent forwarded), or the `forceDurableGate` entitlement
1982
+ * (synthesized into an opt-in). Where the leg's approval park cannot be resumed ({@link approvalParkNotResumableOf}) neither counts. */
1834
1983
  export declare function durableParkOptInDeclared(args: {
1835
1984
  forceDurableGate: boolean;
1836
1985
  durableApprovalDeclared: boolean;
1986
+ approvalParkNotResumable: boolean;
1987
+ }): boolean;
1988
+ /** THE leg fact "an approval park of this leg cannot be resumed", derived once per leg (the driver) and read by name: today's one
1989
+ * source is a DELEGATED leg its parent forwarded no opt-in to (a synchronous or fork child; a background child whose lane cannot park). */
1990
+ export declare function approvalParkNotResumableOf(leg: {
1991
+ delegated: boolean;
1992
+ durableApprovalDeclared: boolean;
1837
1993
  }): boolean;
1994
+ /** The leg's EFFECTIVE opt-in: its own (the caller's word wins — it may carry a tighter scope / ttl), else the one the entitlement
1995
+ * synthesizes where {@link durableParkOptInDeclared} lets it (the leg's scope, no ttl). ONE derivation for the leg's park mint and
1996
+ * the opt-in it forwards (a forced root's background child inherits the facility its parent has, not only what the caller wrote). */
1997
+ export declare function effectiveDurableApprovalOf(args: {
1998
+ declared: {
1999
+ scope: string;
2000
+ ttlMs?: number;
2001
+ } | undefined;
2002
+ forceDurableGate: boolean;
2003
+ approvalParkNotResumable: boolean;
2004
+ scope: string;
2005
+ }): {
2006
+ scope: string;
2007
+ ttlMs?: number;
2008
+ } | undefined;
1838
2009
  /** EXACT structural clone for the approval boundary (alias isolation) — fail-closed, never lossy,
1839
2010
  * never identity: a JSON round-trip would silently DROP unclonable members (presented ≠ executing =
1840
2011
  * consent misrepresentation) and an identity fallback would hand the approver the live executing
@@ -2011,6 +2182,9 @@ export type ResolvedAsk = (Extract<PermissionResult, {
2011
2182
  approverUnavailable?: never;
2012
2183
  /** The answer's `readRootGrant` ({@link AskOutcome}), screened against the request's candidate. */
2013
2184
  readRootGrant?: ReadRootGrantScreen;
2185
+ /** The words a person's allow carried ({@link AskOutcome} `feedback`), fit to deliver. Handed to the station's
2186
+ * {@link ApprovalWordsSeat} by {@link resolveAskFor} and gone from the resolution it returns. */
2187
+ feedback?: string;
2014
2188
  }) | (Extract<PermissionResult, {
2015
2189
  action: "deny";
2016
2190
  }> & {
@@ -2018,6 +2192,7 @@ export type ResolvedAsk = (Extract<PermissionResult, {
2018
2192
  approverUnavailable?: true;
2019
2193
  /** A grant riding a refusal: always `rejected` (`on_refusal`). */
2020
2194
  readRootGrant?: ReadRootGrantScreen;
2195
+ feedback?: never;
2021
2196
  });
2022
2197
  /** What one resolver ARM composes: the resolution plus the settlement it ended the wait with — composed at the arm, every deny
2023
2198
  * naming one (there is no unclassified refusal), an allow only when a DECIDER approved (a blanket `"allow"` asked nobody). The
@@ -2084,6 +2259,17 @@ export declare function carriesBidiControls(value: unknown, limits?: {
2084
2259
  maxNodes: number;
2085
2260
  maxChars: number;
2086
2261
  }): boolean;
2262
+ /**
2263
+ * Whether an approval card's shown text carries a directional control: the executing arguments, the tool's preview of
2264
+ * them, and the target's current text the card shows beside them ({@link AskRequest.existingTarget}) — each under the mint
2265
+ * tier of {@link carriesBidiControls}. The one scan both card faces run: the `resolveAsk` chokepoint for the synchronous card
2266
+ * and the durable park mint for the parked row's twin.
2267
+ */
2268
+ export declare function cardCarriesBidiControls(card: {
2269
+ readonly args: unknown;
2270
+ readonly preview?: unknown;
2271
+ readonly existingTarget?: unknown;
2272
+ }): boolean;
2087
2273
  /**
2088
2274
  * Resolve an `ask` decision to a terminal `allow`/`deny` via {@link OnAsk}. Centralizes the headless
2089
2275
  * auto-deny default, fail-closed error handling, and stable deny reasons so every ask site is
@@ -2115,6 +2301,12 @@ onLateSettlement?: (late: {
2115
2301
  kind: "error";
2116
2302
  error: unknown;
2117
2303
  }) => void): Promise<ResolvedAsk>;
2304
+ /** What an engine mint station is told when the approver it asked FAILED (the resolver's `onApproverDefect`): how it failed, and whether
2305
+ * the seat is a policy the deployment declared ({@link asPolicyApprover}) or any other approver. Never the thrown text or the answer. */
2306
+ export interface ApproverDefect {
2307
+ readonly cause: "threw" | "out_of_contract";
2308
+ readonly seat: "policy" | "approver";
2309
+ }
2118
2310
  /**
2119
2311
  * {@link resolveAsk} at an engine mint station, which also hands over the decision it ASKED (`asked`): when the arm that ran
2120
2312
  * quotes the question ({@link quotingQuestion}) and the question the request puts to the approver IS the sentence the engine
@@ -2127,4 +2319,7 @@ export declare function resolveAskFor(req: AskRequest, onAsk: OnAsk | undefined,
2127
2319
  } | {
2128
2320
  kind: "error";
2129
2321
  error: unknown;
2130
- }) => void) | undefined, asked: object | undefined): Promise<ResolvedAsk>;
2322
+ }) => void) | undefined, asked: object | undefined, onApproverDefect?: (defect: ApproverDefect) => void,
2323
+ /** The station's carrier for a person's written `feedback` ({@link AskOutcome}). A station without one is a seat with no lane for
2324
+ * words: the answer that brings them is refused, never approved with the words gone. */
2325
+ approvalWords?: ApprovalWordsSeat): Promise<ResolvedAsk>;