@sema-agent/core 7.66.1 → 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 (899) hide show
  1. package/CHANGELOG.md +3483 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +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.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -4,30 +4,42 @@
4
4
  * A parent model answers "how far along is it?" from what its read faces show. Three faces read a
5
5
  * background agent: AgentTranscript (its recent steps), ListAgents (the roster) and the host task poll.
6
6
  * Each one projects {@link readAgentState}'s result and renders it with {@link agentStateSummary} /
7
- * {@link agentActivityClause} / {@link agentApprovalClause}; none derives status, activity time or approval
7
+ * {@link agentActivityClause} / {@link agentParkClause}; none derives status, activity time or park
8
8
  * facts on its own, so the three cannot disagree about one agent at one instant.
9
9
  *
10
10
  * Sources:
11
11
  * - the registry row — the live handle this engine process runs ({@link agentStateSourceOfHandle}), or the
12
12
  * durable record when no live handle answers ({@link agentStateSourceOfRecord});
13
- * - for a row whose status is `parked` only, the approval checkpoint the row names, read through the run's
14
- * checkpoint seat (the same seat the Agent tool parks children into). The checkpoint token is the resume
15
- * capability and never leaves this module: a face renders the checkpoint's non-secret `checkpointId`.
13
+ * - for a row whose status is `parked` only, the checkpoint the row names, read through the run's checkpoint
14
+ * seat (the same seat the Agent tool parks children into). The checkpoint is the ONE source of what the park
15
+ * waits on (its gate): a person's approval, or a resource limit — a scheduler's yield among them. The token is
16
+ * the resume capability and never leaves this module: a face renders the checkpoint's non-secret `checkpointId`.
16
17
  *
17
18
  * Absence is stated, never left silent: a missing activity time renders as "last activity unknown (…why)",
18
- * and a parked row whose card cannot be read carries `approval.state` `missing` / `unreadable`. A face that
19
- * goes quiet on a fact invites the reader to fill the gap with a guess.
19
+ * and a parked row whose card cannot be read carries `park.state` `missing` / `unreadable` (and no gate). A face
20
+ * that goes quiet on a fact invites the reader to fill the gap with a guess.
20
21
  */
21
22
  import type { SemaTaskStatus } from "./task-registry-shared.js";
22
23
  import { type CheckpointSeat } from "./checkpoint-seat.js";
23
- /** The approval card's state: the checkpoint row's own `status`, plus `missing` (the row names no card, or
24
+ import type { CheckpointGate, ResourceLimitReason } from "./checkpoint-store.js";
25
+ /** The park card's state: the checkpoint row's own `status`, plus `missing` (the row names no card, or
24
26
  * the store holds none under its token) and `unreadable` (no checkpoint seat on this face, or the store
25
27
  * threw). The same five answers the parked-row reconciliation sweep gives the same question. */
26
- export type AgentApprovalState = "pending" | "resolved" | "expired" | "missing" | "unreadable";
27
- /** The approval checkpoint a parked agent waits on. */
28
- export interface AgentApproval {
29
- state: AgentApprovalState;
30
- /** The checkpoint's non-secret identity (the card id a person sees in the approval inbox). Present when
28
+ export type AgentParkState = "pending" | "resolved" | "expired" | "missing" | "unreadable";
29
+ /** What a parked agent waits on — its checkpoint's gate, reduced to the non-secret kind (and, for a resource
30
+ * limit, the closed reason word; the other kinds' free-text reason never leaves the card). */
31
+ export type AgentParkGate = {
32
+ readonly kind: "resource_limit";
33
+ readonly reason: ResourceLimitReason;
34
+ } | {
35
+ readonly kind: Exclude<CheckpointGate["kind"], "resource_limit">;
36
+ };
37
+ /** The checkpoint a parked agent waits on. */
38
+ export interface AgentPark {
39
+ state: AgentParkState;
40
+ /** What the park waits on, read off the checkpoint. Present when the card was read and carries a known gate. */
41
+ gate?: AgentParkGate;
42
+ /** The checkpoint's non-secret identity (the card id a person sees in an approval inbox). Present when
31
43
  * the card was read and carries one. */
32
44
  checkpointId?: string;
33
45
  /** The card's SLA / abandonment deadline, epoch ms. Present when the card was read and carries one. */
@@ -49,7 +61,7 @@ export interface AgentState {
49
61
  * process is not observable here), or a row that never recorded one. */
50
62
  lastActivityAt?: number;
51
63
  /** Present exactly when {@link status} is `parked`. */
52
- approval?: AgentApproval;
64
+ park?: AgentPark;
53
65
  }
54
66
  /** The row facts {@link readAgentState} reads. Built by the two projections below — never by a face. */
55
67
  export interface AgentStateSource {
@@ -85,7 +97,8 @@ export declare function readAgentState(src: AgentStateSource, seat: CheckpointSe
85
97
  export declare function formatAgo(ms: number): string;
86
98
  /** `last activity <age> ago`, or the reason the time is unknown. */
87
99
  export declare function agentActivityClause(s: AgentState): string;
88
- /** `approval <card id> <state>[ (deadline in <age> | deadline passed <age> ago)]` — facts only. */
89
- export declare function agentApprovalClause(a: AgentApproval, readAt: number): string;
90
- /** The one-line state sentence: `<status> · <activity clause>[ · <approval clause>]`. */
100
+ /** `<what it waits on> <card id> <state>[ (deadline in <age> | deadline passed <age> ago)]` — facts only; a pending
101
+ * yield adds when it continues (nobody decides it: its owner's next run does). */
102
+ export declare function agentParkClause(p: AgentPark, readAt: number): string;
103
+ /** The one-line state sentence: `<status> · <activity clause>[ · <park clause>]`. */
91
104
  export declare function agentStateSummary(s: AgentState): string;
@@ -19,7 +19,24 @@ export function agentStateSourceOfRecord(r) {
19
19
  };
20
20
  }
21
21
  const finite = (n) => typeof n === "number" && Number.isFinite(n);
22
- async function readApprovalCard(store, token) {
22
+ const PARK_GATE_WORDS = {
23
+ human: "approval",
24
+ irreversible_ask: "approval",
25
+ needs_review: "review",
26
+ plan_review: "review",
27
+ task_done: "awaiting task",
28
+ resource_limit: null,
29
+ };
30
+ const RESOURCE_LIMIT_REASONS = { budget_tokens: true, budget_cost: true, walltime: true, turns: true, preempt: true, usage_window: true, env_lifetime: true };
31
+ function parkGateOf(gate) {
32
+ const g = gate;
33
+ if (typeof g?.kind !== "string" || !Object.hasOwn(PARK_GATE_WORDS, g.kind))
34
+ return undefined;
35
+ if (g.kind !== "resource_limit")
36
+ return { kind: g.kind };
37
+ return typeof g.reason === "string" && Object.hasOwn(RESOURCE_LIMIT_REASONS, g.reason) ? { kind: "resource_limit", reason: g.reason } : undefined;
38
+ }
39
+ async function readParkCard(store, token) {
23
40
  let cp;
24
41
  try {
25
42
  cp = (await store.get(token));
@@ -30,8 +47,10 @@ async function readApprovalCard(store, token) {
30
47
  if (cp === null || cp === undefined)
31
48
  return { state: "missing" };
32
49
  const state = cp.status === "pending" || cp.status === "resolved" || cp.status === "expired" ? cp.status : "unreadable";
50
+ const gate = parkGateOf(cp.gate);
33
51
  return {
34
52
  state,
53
+ ...(gate !== undefined ? { gate } : {}),
35
54
  ...(typeof cp.checkpointId === "string" && cp.checkpointId !== "" ? { checkpointId: cp.checkpointId } : {}),
36
55
  ...(finite(cp.deadline) ? { deadline: cp.deadline } : {}),
37
56
  };
@@ -46,11 +65,11 @@ export function readAgentState(src, seat, now) {
46
65
  if (base.status !== "parked")
47
66
  return base;
48
67
  if (src.parkedCheckpointToken === undefined)
49
- return { ...base, approval: { state: "missing" } };
68
+ return { ...base, park: { state: "missing" } };
50
69
  const store = checkpointStoreOfSeat(seat);
51
70
  if (store === undefined)
52
- return { ...base, approval: { state: "unreadable" } };
53
- return readApprovalCard(store, src.parkedCheckpointToken).then((approval) => ({ ...base, approval }));
71
+ return { ...base, park: { state: "unreadable" } };
72
+ return readParkCard(store, src.parkedCheckpointToken).then((park) => ({ ...base, park }));
54
73
  }
55
74
  export function formatAgo(ms) {
56
75
  const sec = Math.max(0, Math.floor(ms / 1000));
@@ -69,11 +88,19 @@ export function agentActivityClause(s) {
69
88
  return `last activity ${formatAgo(s.readAt - s.lastActivityAt)} ago`;
70
89
  return s.row === "durable_row" && s.status === "running" ? "last activity unknown (recorded as running by another engine process)" : "last activity unknown (not recorded)";
71
90
  }
72
- export function agentApprovalClause(a, readAt) {
73
- const id = a.checkpointId !== undefined ? ` ${inlineUntrusted(a.checkpointId, 64)}` : "";
74
- const deadline = a.deadline === undefined ? "" : a.deadline > readAt ? ` (deadline in ${formatAgo(a.deadline - readAt)})` : ` (deadline passed ${formatAgo(readAt - a.deadline)} ago)`;
75
- return `approval${id} ${a.state}${deadline}`;
91
+ function parkWord(gate) {
92
+ if (gate === undefined)
93
+ return "park";
94
+ if (gate.kind !== "resource_limit")
95
+ return PARK_GATE_WORDS[gate.kind];
96
+ return gate.reason === "preempt" ? "yielded" : `paused (${gate.reason})`;
97
+ }
98
+ export function agentParkClause(p, readAt) {
99
+ const id = p.checkpointId !== undefined ? ` ${inlineUntrusted(p.checkpointId, 64)}` : "";
100
+ const deadline = p.deadline === undefined ? "" : p.deadline > readAt ? ` (deadline in ${formatAgo(p.deadline - readAt)})` : ` (deadline passed ${formatAgo(readAt - p.deadline)} ago)`;
101
+ const continues = p.state === "pending" && p.gate?.kind === "resource_limit" && p.gate.reason === "preempt" ? " — continues when its owner runs again" : "";
102
+ return `${parkWord(p.gate)}${id} ${p.state}${deadline}${continues}`;
76
103
  }
77
104
  export function agentStateSummary(s) {
78
- return [s.status, agentActivityClause(s), ...(s.approval !== undefined ? [agentApprovalClause(s.approval, s.readAt)] : [])].join(" · ");
105
+ return [s.status, agentActivityClause(s), ...(s.park !== undefined ? [agentParkClause(s.park, s.readAt)] : [])].join(" · ");
79
106
  }
@@ -386,9 +386,16 @@ export declare function allowRuleShadowSentence(shadows: readonly AllowRuleShado
386
386
  authoredBy?: "deployment";
387
387
  probeReason?: string;
388
388
  }): string;
389
- /** The card's disclosure members off a surviving ask, minted at every station that builds an approval request: the
390
- * sanitized records, the message with the sentence rendered onto it, and the outlet of a person's rewritten edit (the
391
- * approved-edit pass's own member, whose form is the bytes the card presents). */
389
+ /** The question a card asks when the decision carried no sentence of its own — the one fallback every approval request
390
+ * and every parked row of the gate's own lane shares. */
391
+ export declare const askFallbackMessage: (toolName: string) => string;
392
+ /** The provenance sentence an inherited card carries when the ancestor's ask brought no words of its own — the one spelling
393
+ * the inherited request mint, the frame join and the park of that ask (floated back unresolved) share. */
394
+ export declare const inheritedAskFallbackMessage: (toolName: string) => string;
395
+ /** The card's disclosure members off a surviving ask, minted at every station that builds an approval request and at the
396
+ * park twin that keeps the same members on the row: the sanitized records, the message with the sentence rendered onto
397
+ * it, the written ask rule the card stands for (relayed as written: a non-empty string or nothing), and the outlet of a
398
+ * person's rewritten edit (the approved-edit pass's own member, whose form is the bytes the card presents). */
392
399
  export declare function cardDisclosureOf(decision: {
393
400
  message?: string;
394
401
  allowRuleShadowed?: unknown;
@@ -397,10 +404,12 @@ export declare function cardDisclosureOf(decision: {
397
404
  authoredBy?: "deployment";
398
405
  probeReason?: string;
399
406
  editRewritten?: EditRewritten;
407
+ matchedAskRule?: unknown;
400
408
  }, fallbackMessage: string): {
401
409
  message: string;
402
410
  allowRuleShadowed?: readonly AllowRuleShadow[];
403
411
  editRewritten?: EditRewritten;
412
+ matchedAskRule?: string;
404
413
  };
405
414
  /** The notice for list entries that grant (or refuse) nothing — one code for every list. */
406
415
  export declare const ALLOWED_TOOL_NOT_GRANTED_CODE = "permission.allowed_tool_not_granted";
@@ -14,6 +14,7 @@ import { callTargetReadingOf } from "./effective-path-target.js";
14
14
  import { splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
15
15
  import { ASK_RULE_DISCLOSURE, MANDATE_DISCLOSURE, mandateDisclosureOf } from "./ask-origin.js";
16
16
  import { inlineUntrusted, isMintableProbeReason } from "./untrusted-text.js";
17
+ import { callerText } from "./caller-text.js";
17
18
  import { valueTypeLabel } from "./tool-name-list.js";
18
19
  import { deliverEngineNotice } from "./engine-notice.js";
19
20
  export const ALLOW_ENTRY_INERT_REASONS = Object.freeze(["wildcard_all", "namespace_wildcard", "content_unsupported", "grammar", "tool_name", "near_miss", "earlier_grammar"]);
@@ -374,7 +375,7 @@ function receiveAnchoredMember(entry, at) {
374
375
  const member = receiveOwnProperties(entry, { subject: at, unit: "member", moment: "when the list is read" });
375
376
  for (const key of Object.keys(member)) {
376
377
  if (!ANCHORED_MEMBER_KEYS.has(key))
377
- throw receiptRefusal(`${at} carries ${inlineUntrusted(key, 80)}, which is not a member of an anchored entry (its members are rule and pathBases) — refused rather than read without it`);
378
+ throw receiptRefusal(`${at} carries ${callerText(key)}, which is not a member of an anchored entry (its members are rule and pathBases) — refused rather than read without it`);
378
379
  }
379
380
  const rule = Object.hasOwn(member, "rule") ? member.rule : undefined;
380
381
  const pathBases = Object.hasOwn(member, "pathBases") ? member.pathBases : undefined;
@@ -386,7 +387,7 @@ function receiveAnchoredMember(entry, at) {
386
387
  const held = Object.create(null);
387
388
  for (const [word, value] of Object.entries(bases)) {
388
389
  if (!PATH_BASE_WORDS.has(word))
389
- throw receiptRefusal(`${at}.pathBases carries ${inlineUntrusted(word, 80)}, which is not a base word (${PATH_RULE_BASES.join(", ")}) — refused rather than read without it`);
390
+ throw receiptRefusal(`${at}.pathBases carries ${callerText(word)}, which is not a base word (${PATH_RULE_BASES.join(", ")}) — refused rather than read without it`);
390
391
  if (typeof value !== "string")
391
392
  throw receiptRefusal(`${at}.pathBases.${word} must be a path string (got ${valueTypeLabel(value)})`);
392
393
  held[word] = value;
@@ -533,9 +534,15 @@ export function allowRuleShadowSentence(shadows, ask) {
533
534
  : SHADOW_REASON[askClass ?? "ordinary"];
534
535
  return `${shadows.map(memberPhrase).join("; ")} ${one ? "matches this call but does not clear the ask" : "match this call but do not clear the ask"}${why !== undefined ? ` — ${why}` : ""}`;
535
536
  }
537
+ export const askFallbackMessage = (toolName) => `approval required for "${toolName}"`;
538
+ export const inheritedAskFallbackMessage = (toolName) => `approval required for "${toolName}" (inherited parent policy)`;
536
539
  export function cardDisclosureOf(decision, fallbackMessage) {
537
540
  const base = decision.message ?? fallbackMessage;
538
- const outlet = decision.editRewritten !== undefined ? { editRewritten: decision.editRewritten } : {};
541
+ const rule = decision.matchedAskRule;
542
+ const outlet = {
543
+ ...(decision.editRewritten !== undefined ? { editRewritten: decision.editRewritten } : {}),
544
+ ...(typeof rule === "string" && rule.length > 0 ? { matchedAskRule: rule } : {}),
545
+ };
539
546
  const shadows = readAllowRuleShadows(decision.allowRuleShadowed);
540
547
  if (shadows === undefined)
541
548
  return { message: base, ...outlet };
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The approval card's display sanitizer and size bound — one reading for every value the engine hands an approval
3
+ * surface as display metadata: the tool's approval preview at the card's mint, and the card's question as the parked
4
+ * row keeps it. A leaf: it imports nothing, so the gate lane and the park twin read the same rule.
5
+ *
6
+ * Every string leaf is model-, tool- or policy-authored and flows to approval UIs: control characters (terminal
7
+ * escapes, CR; `\n` and `\t` kept for legible multi-line detail) become U+2400 here, so no lane forwards a raw escape
8
+ * sequence. Markdown / content semantics stay the renderer's contextual-escaping job; these values are advisory and
9
+ * never adjudication input.
10
+ */
11
+ /** The serialized-size bound (JSON characters) past which a display value is replaced by a truncation account. */
12
+ export declare const APPROVAL_DISPLAY_MAX_CHARS = 16384;
13
+ /** Neutralize control characters in every string leaf (keys included); a value nested deeper than six levels is
14
+ * dropped. Non-string scalars pass unchanged. */
15
+ export declare const sanitizeApprovalDisplay: (node: unknown, depth?: number) => unknown;
16
+ /** The card's question as a parked row keeps it: sanitized, and past the bound replaced by an account naming the
17
+ * size. A non-string or empty value keeps nothing. */
18
+ export declare function approvalMessageOf(message: unknown): string | undefined;
@@ -0,0 +1,26 @@
1
+ export const APPROVAL_DISPLAY_MAX_CHARS = 16_384;
2
+ const CONTROL = /[\u0000-\u0008\u000b-\u001f\u007f]/g;
3
+ const neutralize = (text) => text.replace(CONTROL, "␀");
4
+ export const sanitizeApprovalDisplay = (node, depth = 0) => {
5
+ if (depth > 6)
6
+ return undefined;
7
+ if (typeof node === "string")
8
+ return neutralize(node);
9
+ if (node === null || typeof node !== "object")
10
+ return node;
11
+ if (Array.isArray(node))
12
+ return node.map((v) => sanitizeApprovalDisplay(v, depth + 1));
13
+ const out = {};
14
+ for (const [k, v] of Object.entries(node)) {
15
+ out[`${sanitizeApprovalDisplay(k, depth + 1)}`] = sanitizeApprovalDisplay(v, depth + 1);
16
+ }
17
+ return out;
18
+ };
19
+ export function approvalMessageOf(message) {
20
+ if (typeof message !== "string" || message.length === 0)
21
+ return undefined;
22
+ const serialized = JSON.stringify(message).length;
23
+ if (serialized > APPROVAL_DISPLAY_MAX_CHARS)
24
+ return `approval message exceeded 16KiB (${serialized} chars serialized)`;
25
+ return neutralize(message);
26
+ }
@@ -1,4 +1,4 @@
1
- import { canonicalize } from "./canonical-json.js";
1
+ import { canonicalize, isSha16 } from "./canonical-json.js";
2
2
  import { licenseCovers } from "./tool-policy.js";
3
3
  import { pathTargetResolutionOf } from "./effective-path-target.js";
4
4
  import { parkedSkillApprovalRefusal } from "./skill-grant.js";
@@ -11,7 +11,7 @@ const isString = (v) => typeof v === "string";
11
11
  const absentOr = (shape) => (v) => v === undefined || shape(v);
12
12
  const isSlot = (v) => isPlainRecord(v) && typeof v["param"] === "string";
13
13
  const TOOL_MEMBER_SHAPES = Object.freeze({
14
- capabilityId: isString, contractId: isString, shapeDigest: isString, implementationRevision: isString, family: isString, declarationDigest: isString,
14
+ capabilityId: isSha16, contractId: isString, shapeDigest: isString, implementationRevision: isString, family: isString, declarationDigest: isString,
15
15
  engineMounted: absentOr((v) => v === true), pathTarget: absentOr(isSlot), hostTarget: absentOr(isSlot),
16
16
  });
17
17
  const unreadToolMembers = (row) => Object.keys(TOOL_MEMBER_SHAPES).filter((k) => !TOOL_MEMBER_SHAPES[k](row[k]));
@@ -0,0 +1,16 @@
1
+ /**
2
+ * The APPROVAL ROUTE words — where an ask carrying `requiresRealApproval` goes from a station, the closed set of the ONE
3
+ * approval-seat decision. A leaf: the route is derived in `wiring-manifest.ts` (`approvalRouteOf` there; that module
4
+ * re-exports these names as its consumer face) and screened by the stations that fork on it, some of which sit below the
5
+ * manifest in the import graph.
6
+ *
7
+ * `live_approver` (a live approver callback answers it now), `policy_seat` (the deployment's approval policy callback
8
+ * answers it now — it cannot approve it, since the bit asks for a person; it refuses it, or answers `"unavailable"` and the
9
+ * ask parks), `durable_park` (it parks for a person to answer later), `none` (nobody can: a blanket policy seat, no seat, or
10
+ * a run that declared nobody can be asked — each only when no park lane is armed, since an armed park is the deployment's
11
+ * own statement that an answer can wait for a person — or a word that cannot be resolved — the fail-closed reading).
12
+ */
13
+ export declare const APPROVAL_ROUTES: readonly ["live_approver", "policy_seat", "durable_park", "none"];
14
+ export type ApprovalRoute = (typeof APPROVAL_ROUTES)[number];
15
+ /** Membership test for {@link ApprovalRoute} — a station's stated route is screened through it, never trusted by shape. */
16
+ export declare function isApprovalRoute(v: unknown): v is ApprovalRoute;
@@ -0,0 +1,5 @@
1
+ export const APPROVAL_ROUTES = Object.freeze(["live_approver", "policy_seat", "durable_park", "none"]);
2
+ const APPROVAL_ROUTE_SET = new Set(APPROVAL_ROUTES);
3
+ export function isApprovalRoute(v) {
4
+ return APPROVAL_ROUTE_SET.has(v);
5
+ }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * The words as the model is to read them, or `undefined` when nothing was written: absent, or — after the outer whitespace is dropped —
3
+ * a text that says nothing by the input path's one definition of that ({@link isBlankInput}: whitespace and control characters only).
4
+ * The queue the live leg delivers through drops such a text for the same reason, so the two cannot disagree about whether words exist.
5
+ */
6
+ export declare function writtenFeedback(feedback: string | undefined): string | undefined;
7
+ /** Why written words may not be delivered as the person's: they ride a refusal (a refusal's words are its `reason`), the answer is not
8
+ * a person's (a machine's text must never reach the model as the user's), or they carry the engine's `<system-reminder>` tag. */
9
+ export type UnfitFeedback = "on_a_deny" | "by_a_machine" | "reminder_tag";
10
+ /**
11
+ * The one judge of written words, in the order both faces refuse them: the arm first, then the party, then the tag. `words` is
12
+ * {@link writtenFeedback}'s output (the caller has already held the value to the string domain); nothing written is never unfit.
13
+ */
14
+ export declare function unfitFeedbackOf(words: string | undefined, arm: {
15
+ readonly allowed: boolean;
16
+ readonly byPerson: boolean;
17
+ }): UnfitFeedback | undefined;
18
+ /**
19
+ * The live leg's carrier for the words: queues them so the next model request, after the batch the approved call is part of has
20
+ * settled its tool results, begins with them as a user message of their own. It never throws — a queue that refuses them reports
21
+ * the refusal itself — so the resolver that calls it can stay a plain wait on the approver.
22
+ */
23
+ export type ApprovalWordsSeat = (words: string) => Promise<void>;
24
+ /** What a live answer's `feedback` reads as: the trimmed words (`undefined` when nothing was written), or the sentence the answer is refused in. */
25
+ export type LiveWords = {
26
+ readonly kind: "words";
27
+ readonly words: string | undefined;
28
+ } | {
29
+ readonly kind: "refused";
30
+ readonly message: string;
31
+ };
32
+ /**
33
+ * The live face's ONE reading of an approver's `feedback` member, composed on the judge above: the string domain first (never coerced,
34
+ * never read as blank), then {@link writtenFeedback}, then whether the seat can carry words at all, then {@link unfitFeedbackOf}. A
35
+ * refusal is the approver's defect in the seam's own words, never words quietly dropped behind an approval. `answer` states what the
36
+ * seam knows: the tool the card is about, the arm, whether a person gave it, and whether this seat has a carrier.
37
+ */
38
+ export declare function liveWordsOf(feedback: unknown, answer: {
39
+ readonly toolName: string;
40
+ readonly allowed: boolean;
41
+ readonly byPerson: boolean;
42
+ readonly hasCarrier: boolean;
43
+ }): LiveWords;
@@ -0,0 +1,37 @@
1
+ import { isBlankInput } from "./input-author.js";
2
+ import { sanitizeUntrustedText, sentinelTagRefusal } from "./untrusted-text.js";
3
+ export function writtenFeedback(feedback) {
4
+ const trimmed = feedback?.trim();
5
+ return trimmed === undefined || isBlankInput(trimmed) ? undefined : trimmed;
6
+ }
7
+ export function unfitFeedbackOf(words, arm) {
8
+ if (words === undefined)
9
+ return undefined;
10
+ if (!arm.allowed)
11
+ return "on_a_deny";
12
+ if (!arm.byPerson)
13
+ return "by_a_machine";
14
+ return sanitizeUntrustedText(words) !== words ? "reminder_tag" : undefined;
15
+ }
16
+ export function liveWordsOf(feedback, answer) {
17
+ const who = `the approver for "${answer.toolName}" attached \`feedback\``;
18
+ if (feedback !== undefined && typeof feedback !== "string") {
19
+ return { kind: "refused", message: `${who} that is not a plain string (got ${feedback === null ? "null" : typeof feedback}) — the approving person's words are plain text; denied fail-closed` };
20
+ }
21
+ const words = writtenFeedback(feedback);
22
+ if (words === undefined)
23
+ return { kind: "words", words };
24
+ if (!answer.hasCarrier) {
25
+ return { kind: "refused", message: `${who} on a seat that has no lane to deliver words to the model — denied fail-closed (the words ride an approval card's allow through the run's own approver seat)` };
26
+ }
27
+ switch (unfitFeedbackOf(words, answer)) {
28
+ case undefined:
29
+ return { kind: "words", words };
30
+ case "on_a_deny":
31
+ return { kind: "refused", message: `${who} to a refusal — feedback is the approving person's words on an allow (a refusal's words are \`reason\`); denied fail-closed rather than dropping them silently` };
32
+ case "by_a_machine":
33
+ return { kind: "refused", message: `${who} to an answer no person gave (settledBy "policy", or an approver the deployment declared a policy) — feedback is delivered to the model as the user's own words, which only a person's answer can be; denied fail-closed rather than attributing a machine's text to the user` };
34
+ case "reminder_tag":
35
+ return { kind: "refused", message: `${who}: ${sentinelTagRefusal("approval allow feedback")}; denied fail-closed` };
36
+ }
37
+ }
@@ -23,6 +23,12 @@
23
23
  * bit any origin can carry — a safety policy's own ask carries it with origin `policy`), and the
24
24
  * gate's `autoMode` seat says whether a classifier is WIRED at all (a property of the session, not of
25
25
  * the ask). Both stay where they are and are consumed beside the origin, not folded into it.
26
+ *
27
+ * Where an ask says WHY. An asker's own words have one machine-read seat, the ask's `askReasons` entries ({@link AskReason});
28
+ * a fact that rides a typed member is said by that member — the class (`askClass` / `classes`), the origin, the mandate word,
29
+ * and the account of a finding a read station or a deployment's reversibility probe made (`probeReason`, the `probe_mandate`
30
+ * word's disclosure). The ask's `message` is the one line a person or the model reads, not a second reason seat: a structured
31
+ * approval surface reads its reasons from the entries and the typed members, never from it.
26
32
  */
27
33
  import type { PermissionResult } from "./tool-policy.js";
28
34
  import { type EngineAttestation } from "./engine-attestation.js";
@@ -62,6 +68,14 @@ import type { ContainmentFace } from "../tools/fs/containment-face.js";
62
68
  * an instruction rather than hesitation.
63
69
  * - `denial_limit_fallback` — the auto-mode classifier reached its denial bound and handed the call
64
70
  * to a person; the classifier stands BEFORE this ask, never after it.
71
+ * - `integrity_guard` — an always-on engine integrity guard put the question in its own words: a removal of a protected
72
+ * location, an unverifiable recursive delete, shell text the engine cannot read, the session-transcript write. Read off the
73
+ * guard's own account of the sentence the ask still says ({@link engineSentenceOf}`(…).guard`), never off the record's
74
+ * `guards` (a read station's silence lists a guard behind a question another layer raised): a later layer that rewrote the
75
+ * message without restating that account leaves the ask to the words below. Above the two tighten words: a tighten only
76
+ * ever replaces an allow, so the two never hold together on one pass, and where a pass's tighten fact outlived its turn
77
+ * (an approved edit's re-check) the decision's own record is the one that speaks for it. The reference implementation's
78
+ * `safetyCheck`.
65
79
  * - `shell_gate_tighten` — the gate's own irreversibility tighten raised the ask over a tier the COARSE
66
80
  * shell seat installed (the shape tier on every full shell, or the `shellGate: "always"` floor), not an
67
81
  * explicit per-tool mark. The gate records that its own tighten spoke; a policy stamping
@@ -76,7 +90,7 @@ import type { ContainmentFace } from "../tools/fs/containment-face.js";
76
90
  * observer or an approval card can say WHICH engine layer raised the question, which one word
77
91
  * could not.
78
92
  */
79
- export declare const ASK_ORIGINS: readonly ["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"];
93
+ export declare const ASK_ORIGINS: readonly ["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "integrity_guard", "shell_gate_tighten", "safety_tighten", "policy"];
80
94
  export type AskOrigin = (typeof ASK_ORIGINS)[number];
81
95
  /** Whether a value is a member of the closed origin set. Exported because the word crosses process
82
96
  * boundaries: a host validating one it received must not hand-roll the set. */
@@ -345,10 +359,11 @@ export declare function askMandateMember(ask: RuleClearanceFacts | undefined): {
345
359
  * A MANDATE merged onto an ask another layer raised — the one writer of both merge arms (the read station's, the reversibility
346
360
  * probe's; `gate-fold.ts`). The mandate is the fact that a standing allow rule may not clear the ask, and its account is the only
347
361
  * sentence that can say why (the allow layer's disclosure words a `probe_mandate` with it, on the card and in the parked row): the
348
- * two travel together. The FIRST layer to mandate an ask brings its account, or none: a `probeReason` the ask arrived with can only
349
- * be its own author's prose, and is replaced by the account — or removed where the mandating layer gave none, so it is never read as
350
- * the reason the mandate stands; an ask already mandated keeps the first layer's. The ask's action, message, reason and every other
351
- * disclosure are untouched.
362
+ * two travel together. The FIRST layer to mandate an ask brings its account, or none: a `probeReason` the ask arrived with is another
363
+ * station's account of a finding that did not mandate it (no policy states one: the receipt refuses it — the read station's account of
364
+ * an ask it raised without a mandate, which the reversibility probe's merge arm meets), and is replaced by the account — or removed
365
+ * where the mandating layer gave none, so it is never read as the reason the mandate stands; an ask already mandated keeps the first
366
+ * layer's. The ask's action, message, reason and every other disclosure are untouched.
352
367
  */
353
368
  export declare function withProbeMandate<D extends Extract<PermissionResult, {
354
369
  action: "ask";
@@ -375,7 +390,10 @@ export declare function ownedClearanceFacts(d: Extract<PermissionResult, {
375
390
  * (`denialLimitFallback`: a self-declared one opts the policy's own ask out of automatic
376
391
  * resolution, the safe direction, not a defect), so the invariant is pinned at the engine's two
377
392
  * mint sites (the gate's fallback re-mint and the inherited station's) rather than thrown at
378
- * derivation, where a policy's own object could trip it;
393
+ * derivation, where a policy's own object could trip it; `integrity_guard` likewise: its input is the
394
+ * guard's own record, which no policy composes but a policy wrapping an exported guard can relay beside a
395
+ * bit it cleared, so the bit is pinned at the two guard mint sites (the removal guard's ask, the
396
+ * session-transcript guard's);
379
397
  * - `false` — the origin says nothing about the bit: a `policy` ask may carry it (a safety policy's
380
398
  * own mandate) or not, and both are legal.
381
399
  */
@@ -389,6 +407,7 @@ export declare const ORIGIN_IMPLIES_REAL_APPROVAL: {
389
407
  readonly hook: false;
390
408
  readonly ask_rule: false;
391
409
  readonly denial_limit_fallback: "at_mint";
410
+ readonly integrity_guard: "at_mint";
392
411
  readonly shell_gate_tighten: false;
393
412
  readonly safety_tighten: false;
394
413
  readonly policy: false;
@@ -867,6 +886,11 @@ export declare function askFaceOf(toolName: string): AskFace;
867
886
  * shell floor) mint no bit and explain none — except `requires_user_interaction`, whose declaration the origin stamp
868
887
  * turns into the bit on every ask of the tool. */
869
888
  export declare const RRA_EXPLAINERS: ReadonlySet<AskClass>;
889
+ /** Whether a set of classes holds one that explains the `requiresRealApproval` bit ({@link RRA_EXPLAINERS}) — the ONE reading of the
890
+ * bit's fence. A bit a member explains is that member's demand for a person, not the bare bit `policy_rra` names: the mint reads it over
891
+ * an ask's own members ({@link ownAskClassesOf}) and again over the whole set ({@link classifyAsk}), and the edit re-check reads it
892
+ * over the classes a person answered ({@link import("./real-approval.js").editRecheckUnanswered}). */
893
+ export declare function explainsRealApprovalBit(classes: Iterable<AskClass>): boolean;
870
894
  /** The classes a permission mode can RELEASE for a call on `face`, in {@link ASK_CLASSES} order. The same list on every face
871
895
  * but one class — {@link RELEASED_ON_SHELL_FACE}. A frozen list: a caller holding it cannot change the next read. A word
872
896
  * outside {@link ASK_FACES} throws. */
@@ -997,10 +1021,11 @@ export declare function dontAskRefusalMessage(input: {
997
1021
  readonly ruleShape: string;
998
1022
  }): string;
999
1023
  /** The state of the approver seat a remedy is written for: `absent` — no approver is wired for the leg; `unavailable` — one is
1000
- * wired and answered that nobody is reachable for this ask; `declared_none` — the run declared that nobody on it can be
1024
+ * wired and answered that nobody is reachable for this ask; `policy` — the approver wired is the deployment's approval policy
1025
+ * (`asPolicyApprover`) and it answered `unavailable` for this ask; `declared_none` — the run declared that nobody on it can be
1001
1026
  * asked (`approvalReach: "none"`), whatever is wired. Absent in the input reads as `absent` (the posture the function was
1002
1027
  * written for). */
1003
- export type HeadlessApproverSeat = "absent" | "unavailable" | "declared_none";
1028
+ export type HeadlessApproverSeat = "absent" | "unavailable" | "policy" | "declared_none";
1004
1029
  /** The kinds of way out a refusal carries as DATA: `approver` — a person who can answer becomes reachable (the sentence's approver clause);
1005
1030
  * `permission_mode` — a mode that releases the ask with nobody answering it (`bypassPermissions`, unless the deployment's caps deny it:
1006
1031
  * a denied bypass folds to `default`). A host renders a kind or leaves it unrendered; the sentence a user reads never teaches the release. */
@@ -1032,7 +1057,8 @@ export interface HeadlessApprovalRemedy {
1032
1057
  * after its refusal: the caller-side change that would have let this call run, as a sentence (`sentence`) and as the
1033
1058
  * ways out in data (`remedies`, {@link ApprovalRemedy}: the approver in every arm). Read off the effective mode, the
1034
1059
  * ask's folded class row and whether the call is a covered write (the mode write gate's own question):
1035
- * · a class no permission mode releases (`bypassImmune`) — only a person can answer it: wire an approver;
1060
+ * · a class no permission mode releases (`bypassImmune`) — only a person can answer it: wire an approver (a `cross_boundary` ask adds
1061
+ * that an earlier yes from the policy or an approval factory does not answer it, {@link CROSS_BOUNDARY_EARLIER_YES});
1036
1062
  * · the plan mode's own question (`mode`) — leave plan (steer the mode, or approve the plan) or wire an approver;
1037
1063
  * · the write gate's own ask under `default` / `auto` — `acceptEdits` lets writes inside the working
1038
1064
  * directories through without asking;
@@ -1042,7 +1068,8 @@ export interface HeadlessApprovalRemedy {
1042
1068
  * the sentence does not say so; `remedies` carries it as a `permission_mode` member for a host that chooses to offer it.
1043
1069
  * Every arm also names the approver, in the clause of the seat's own state ({@link HeadlessApproverSeat}): none wired ⇒
1044
1070
  * wire one; one wired that answered `unavailable` for this ask ⇒ make a person reachable through it (a wired approver is
1045
- * never told to be wired); the run declared nobody can be asked ⇒ run it where a person can be, or park it. The refusal's tool text and the `delegation.ask_unresolvable` notice both carry this sentence —
1071
+ * never told to be wired); the deployment's approval policy answered `unavailable` ⇒ park it for a person, or run it where a
1072
+ * person can be asked (a policy is not a person to make reachable); the run declared nobody can be asked ⇒ run it where a person can be, or park it. The refusal's tool text and the `delegation.ask_unresolvable` notice both carry this sentence —
1046
1073
  * they call this function, neither spells it — and the notice carries `remedies` beside it.
1047
1074
  * Under `dontAsk` (the mode answers no ask: {@link dontAskRefusalMessage} carries this arm) the one question is whether an allow
1048
1075
  * rule may clear the ask — the folded row's `ruleMayClear`, the allow layer's own reading: yes ⇒ add an allow rule covering the
@@ -1,7 +1,7 @@
1
1
  import { attestationOf, engineSentenceOf } from "./engine-attestation.js";
2
2
  import { isShellFaceToolName } from "./tool-registry.js";
3
3
  import { inlineUntrusted } from "./untrusted-text.js";
4
- export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"]);
4
+ export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "integrity_guard", "shell_gate_tighten", "safety_tighten", "policy"]);
5
5
  const ASK_ORIGIN_SET = new Set(ASK_ORIGINS);
6
6
  export function isAskOrigin(v) {
7
7
  return ASK_ORIGIN_SET.has(v);
@@ -173,6 +173,8 @@ function originLadder(decision, facts) {
173
173
  return "ask_rule";
174
174
  if (decision.denialLimitFallback !== undefined)
175
175
  return "denial_limit_fallback";
176
+ if (engineSentenceOf(decision, facts.call)?.guard !== undefined)
177
+ return "integrity_guard";
176
178
  if (facts.tightened === "shell_gate")
177
179
  return "shell_gate_tighten";
178
180
  if (facts.tightened === "safety")
@@ -189,6 +191,7 @@ export const ORIGIN_IMPLIES_REAL_APPROVAL = {
189
191
  hook: false,
190
192
  ask_rule: false,
191
193
  denial_limit_fallback: "at_mint",
194
+ integrity_guard: "at_mint",
192
195
  shell_gate_tighten: false,
193
196
  safety_tighten: false,
194
197
  policy: false,
@@ -338,6 +341,12 @@ function bypassImmuneOf(c) {
338
341
  }
339
342
  const CLASSIFIER_WITHHELD_ON_ROOTS = new Set(["probe"]);
340
343
  export const RRA_EXPLAINERS = new Set(["dangerous_delete", "unverifiable_delete", "unverifiable_shell_text", "transcript_write", "org_rule", "rule_unreadable", "denial_limit_fallback", "classifier_no_ruling", "ancestor", "artifact_shared_read", "requires_user_interaction", "cross_boundary"]);
344
+ export function explainsRealApprovalBit(classes) {
345
+ for (const c of classes)
346
+ if (RRA_EXPLAINERS.has(c))
347
+ return true;
348
+ return false;
349
+ }
341
350
  const RELEASABLE_BY_FACE = Object.freeze({
342
351
  shell: Object.freeze(ASK_CLASSES.filter((c) => !bypassImmuneOn(c, "shell"))),
343
352
  other: Object.freeze(ASK_CLASSES.filter((c) => !bypassImmuneOn(c, "other"))),
@@ -386,7 +395,7 @@ export function ownAskClassesOf(d, record) {
386
395
  out.add("hook");
387
396
  if (d.decisionReason === "mode")
388
397
  out.add("mode");
389
- if (d.requiresRealApproval === true && ![...out].some((c) => RRA_EXPLAINERS.has(c)))
398
+ if (d.requiresRealApproval === true && !explainsRealApprovalBit(out))
390
399
  out.add("policy_rra");
391
400
  if (out.size === 0 && d.mandated === true)
392
401
  out.add("operator_forced");
@@ -453,7 +462,7 @@ export function classifyAsk(d, facts) {
453
462
  classes.add("unstated");
454
463
  for (const c of facts.ancestorClasses ?? [])
455
464
  classes.add(c);
456
- if (d.requiresRealApproval === true && ![...classes].some((c) => RRA_EXPLAINERS.has(c)))
465
+ if (d.requiresRealApproval === true && !explainsRealApprovalBit(classes))
457
466
  classes.add("policy_rra");
458
467
  for (const c of record?.foldedClasses ?? [])
459
468
  classes.add(c);
@@ -509,6 +518,7 @@ export function readApprovalRemedy(v) {
509
518
  }
510
519
  }
511
520
  }
521
+ const CROSS_BOUNDARY_EARLIER_YES = "an earlier yes from the policy or an approval factory does not answer this question";
512
522
  const APPROVER_REMEDY = Object.freeze({ kind: "approver" });
513
523
  const RELEASE_REMEDY = Object.freeze({ kind: "permission_mode", value: "bypassPermissions", disclosedOn: "gate.disposition.released" });
514
524
  export function headlessApprovalRemedy(input) {
@@ -521,14 +531,16 @@ export function headlessApprovalRemedy(input) {
521
531
  }
522
532
  const approver = input.approverSeat === "unavailable"
523
533
  ? "make a person reachable through the approver that is wired (it answered `unavailable` for this ask)"
524
- : input.approverSeat === "declared_none"
525
- ? 'run it where a person can be asked — this run declares `approvalReach: "none"` (nobody on it can be asked) — or arm a durable approval park so the ask waits for a person'
526
- : "wire an approver (`onAsk`) to put it to a person";
534
+ : input.approverSeat === "policy"
535
+ ? "the deployment's approval policy answered `unavailable` for this ask — arm a durable approval park so the ask waits for a person, or run it where a person can be asked"
536
+ : input.approverSeat === "declared_none"
537
+ ? 'run it where a person can be asked — this run declares `approvalReach: "none"` (nobody on it can be asked) — or arm a durable approval park so the ask waits for a person'
538
+ : "wire an approver (`onAsk`) to put it to a person";
527
539
  const c = input.classification;
528
540
  if (input.mode === "acceptEdits" && input.unplacedOptions !== undefined && (c === undefined || (c.classes.size === 1 && c.classes.has("ordinary"))))
529
541
  return way(`${fileCommandOptionsSentence(input.unplacedOptions.program)} Spell the ${input.unplacedOptions.program} without option words for the mode to answer it, or ${approver}`);
530
542
  if (c !== undefined && bypassImmuneOf(c))
531
- return way(`no permission mode releases this ask (${c.askClass}): ${approver}, or change the call`);
543
+ return way(`no permission mode releases this ask (${c.askClass}): ${approver}, or change the call${c.classes.has("cross_boundary") ? ` — ${CROSS_BOUNDARY_EARLIER_YES}` : ""}`);
532
544
  if (input.mode === "plan" && c?.classes.has("mode") === true)
533
545
  return way(`the plan permission mode asks before every write and every call to a tool the engine does not define that is not read-only — leave plan mode (\`setPermissionMode\` to another mode, or approve the plan) to run it, or ${approver}`);
534
546
  if (c !== undefined && c.classes.size === 1 && c.classes.has("unstated"))