@sema-agent/core 7.59.0 → 7.61.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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,4 +1,4 @@
1
- import { heldBy } from "./tool-name-readings.js";
1
+ import { heldBy, wireOf } from "./tool-name-readings.js";
2
2
  import { ruleIssue } from "./permission-rules.js";
3
3
  import { isCoveringRuleName, ruleNameCovers } from "./namespaced-rule-name.js";
4
4
  import { ruleSpellingOf } from "./permission-rule-syntax.js";
@@ -6,8 +6,10 @@ import { splitNamespacedName, toolNameFaultOf } from "./tool-name-aliases.js";
6
6
  import { catalogToolNames, isShellFaceToolName } from "./tool-registry.js";
7
7
  import { ALLOW_RULE_MEMBERS } from "./allow-rule-shadow.js";
8
8
  import { callHostTargetOf } from "./host-target.js";
9
- import { adjudicatePersistedDomainRules, wholeToolRuleReaches, adjudicatePersistedNameRules, commandCoverageOf, laneToolNamesOf, ruleContentOf, noticeRuleText, parseRuleText, programRunReachOf, ruleToolGrammarOf, commandPatternMayRun } from "./permission-rule-model.js";
9
+ import { adjudicatePersistedDomainRules, wholeToolRuleReaches, adjudicatePersistedNameRules, commandCoverageOf, ruleWordsOf, ruleContentOf, noticeRuleText, parseRuleText, programRunReachOf, ruleToolGrammarOf, unusableDeclaredBase, PATH_RULE_BASES, PATH_RULE_BASE_LABEL, commandPatternMayRun } from "./permission-rule-model.js";
10
10
  import { pathRuleLaneAnswer } from "./runner/permission-rule-lanes.js";
11
+ import { policyAnchors } from "./path-rule-binding.js";
12
+ import { receiptRefusal, receiveOwnProperties } from "./own-property-receipt.js";
11
13
  import { callTargetReadingOf } from "./effective-path-target.js";
12
14
  import { splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
13
15
  import { ASK_RULE_DISCLOSURE, MANDATE_DISCLOSURE, mandateDisclosureOf } from "./ask-origin.js";
@@ -132,12 +134,12 @@ export function autoStripped(compiled, call, allShell) {
132
134
  case "shell":
133
135
  return true;
134
136
  case "tool":
135
- case "covering":
136
137
  return call !== undefined && answersTo(call, isShellFaceToolName);
137
138
  case "command":
138
139
  if (allShell)
139
140
  return true;
140
141
  return compiled.rule.match === "pattern" ? commandPatternMayRun(compiled.rule.command, AUTO_STRIPPED_PROGRAMS) : shellContentStripped(shellRuleContent(compiled.rule));
142
+ case "covering":
141
143
  case "path":
142
144
  case "name":
143
145
  case "domain":
@@ -167,13 +169,19 @@ export function classifiesAllShell(spec) {
167
169
  return spec.classifyAllShell === true;
168
170
  }
169
171
  const NO_LEADS = new Map();
170
- function nameRowReaches(compiled, req) {
172
+ function nameRowReaches(compiled, req, reach) {
173
+ if (reach === "wire_name") {
174
+ const wire = wireOf("allowEntry.launchListNames", req);
175
+ if (compiled.kind === "tool" || compiled.kind === "shell")
176
+ return compiled.name === wire;
177
+ return compiled.kind === "covering" && ruleNameCovers(compiled.pattern, wire);
178
+ }
171
179
  if (compiled.kind === "tool" || compiled.kind === "shell")
172
180
  return wholeToolRuleReaches(compiled.name, req);
173
181
  return compiled.kind === "covering" && answersTo(req, (n) => ruleNameCovers(compiled.pattern, n));
174
182
  }
175
- function commandOf(req) {
176
- const tool = laneToolNamesOf(req).find((n) => ruleToolGrammarOf(n) === "command");
183
+ function commandOf(req, behavior) {
184
+ const tool = ruleWordsOf(req, behavior).find((n) => ruleToolGrammarOf(n) === "command");
177
185
  const command = req.args?.command;
178
186
  return tool !== undefined && typeof command === "string" ? { tool, command } : undefined;
179
187
  }
@@ -181,21 +189,25 @@ function admissionCallOf(call, ctx, liveCwd, posture) {
181
189
  return { tool: call.tool, command: call.command, cwd: ctx.root, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}), ...(liveCwd !== undefined ? { execCwd: liveCwd } : {}), posture };
182
190
  }
183
191
  export function uncoveredCommandSegment(rows, req, ctx, posture) {
184
- const call = commandOf(req);
192
+ const call = commandOf(req, "allow");
185
193
  if (call === undefined)
186
194
  return undefined;
187
195
  const rules = rows.flatMap((r) => (r.behavior === "allow" && r.compiled.kind === "command" ? [r.compiled.rule] : []));
188
196
  const coverage = commandCoverageOf(rules, admissionCallOf(call, ctx, ctx.liveCwd(), posture));
189
197
  return "uncovered" in coverage ? coverage.uncovered : undefined;
190
198
  }
191
- export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
199
+ export function wholeToolEntryOf(rows, tool, behavior, names = "every_name") {
200
+ return rows.find((r) => r.behavior === behavior && nameRowReaches(r.compiled, tool, names));
201
+ }
202
+ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant", names = "every_name") {
192
203
  const live = rows.filter((r) => r.behavior === behavior);
193
204
  if (live.length === 0)
194
205
  return undefined;
195
- for (const row of live)
196
- if (nameRowReaches(row.compiled, req))
197
- return [row];
198
- const call = commandOf(req);
206
+ const nameRow = wholeToolEntryOf(live, req, behavior, names);
207
+ if (nameRow !== undefined)
208
+ return [nameRow];
209
+ const words = ruleWordsOf(req, behavior);
210
+ const call = commandOf(req, behavior);
199
211
  const liveCwd = ctx.liveCwd();
200
212
  if (call !== undefined) {
201
213
  const byRule = new Map();
@@ -217,14 +229,32 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
217
229
  }
218
230
  const pathRows = live.filter((r) => r.compiled.kind === "path");
219
231
  if (pathRows.length > 0) {
220
- const table = pathRows.map((r) => r.compiled.rule);
221
- for (const name of laneToolNamesOf(req).filter((n) => ruleToolGrammarOf(n) === "path")) {
222
- const answer = pathRuleLaneAnswer(table, { ...req, toolName: name }, { root: ctx.root, sessionId: ctx.sessionId, anchorsOf: () => ctx.anchors, leads: callTargetReadingOf(req)?.leads ?? NO_LEADS });
223
- const spoke = answer !== undefined && ("unreadable" in answer ? behavior === "deny" : "behavior" in answer && answer.behavior === behavior);
224
- if (spoke) {
225
- const rule = answer !== undefined && "rules" in answer ? answer.rules[0]?.rule : undefined;
226
- return [pathRows.find((r) => r.compiled.rule.rule === rule) ?? pathRows[0]];
232
+ const sets = new Map();
233
+ for (const r of pathRows) {
234
+ const key = anchorsKey(r.pathBases);
235
+ const set = sets.get(key) ?? { anchors: key === UNDECLARED_SET ? ctx.anchors : policyAnchors(r.pathBases ?? {}, ctx.anchors), rows: [] };
236
+ sets.set(key, set);
237
+ set.rows.push(r);
238
+ }
239
+ for (const name of words.filter((n) => ruleToolGrammarOf(n) === "path")) {
240
+ let unreadable;
241
+ for (const set of sets.values()) {
242
+ const table = set.rows.map((r) => r.compiled.rule);
243
+ const answer = pathRuleLaneAnswer(table, { ...req, toolName: name }, { root: ctx.root, sessionId: ctx.sessionId, anchorsOf: () => set.anchors, leads: callTargetReadingOf(req)?.leads ?? NO_LEADS });
244
+ if (answer === undefined)
245
+ continue;
246
+ if ("unreadable" in answer) {
247
+ if (behavior === "deny")
248
+ unreadable ??= set.rows[0];
249
+ continue;
250
+ }
251
+ if ("behavior" in answer && answer.behavior === behavior) {
252
+ const rule = answer.rules[0]?.rule;
253
+ return [set.rows.find((r) => r.compiled.rule.rule === rule) ?? set.rows[0]];
254
+ }
227
255
  }
256
+ if (unreadable !== undefined)
257
+ return [unreadable];
228
258
  }
229
259
  }
230
260
  for (const grammar of ["name", "domain"]) {
@@ -232,7 +262,7 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
232
262
  if (familyRows.length === 0)
233
263
  continue;
234
264
  const table = familyRows.map((r) => r.compiled.rule);
235
- for (const name of laneToolNamesOf(req).filter((n) => ruleToolGrammarOf(n) === grammar)) {
265
+ for (const name of words.filter((n) => ruleToolGrammarOf(n) === grammar)) {
236
266
  const at = { tool: name, cwd: ctx.root, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}) };
237
267
  const named = { ...req, toolName: name };
238
268
  const verdict = grammar === "name" ? adjudicatePersistedNameRules(table, { ...at, request: req }) : adjudicatePersistedDomainRules(table, { ...at, hosts: { tighten: callHostTargetOf(named, "tighten"), grant: callHostTargetOf(named, "grant") } });
@@ -245,32 +275,52 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
245
275
  export function allowingRows(rows, req, mode, allShell) {
246
276
  return rows.filter((r) => !strippedInAuto(r.compiled, req, mode, allShell));
247
277
  }
278
+ function allowListMemberOf(entry) {
279
+ return typeof entry === "string" ? { rule: entry } : entry;
280
+ }
281
+ function anchorsKey(pathBases) {
282
+ return JSON.stringify(PATH_RULE_BASES.map((word) => pathBases?.[word] ?? null));
283
+ }
284
+ const UNDECLARED_SET = anchorsKey(undefined);
285
+ function allowListMemberKey(member) {
286
+ return JSON.stringify([member.rule, anchorsKey(member.pathBases)]);
287
+ }
248
288
  export class AllowEntryTable {
249
289
  held = [];
250
- heldEntries = new Set();
290
+ heldKeys = new Set();
251
291
  receivedAt = new Map();
252
292
  seed(entries, reading = {}) {
253
- const { rows, inert } = compileAllowList(entries, "allow", reading.roster);
293
+ const members = entries.map(allowListMemberOf);
254
294
  if (reading.received === true) {
255
295
  this.receivedAt = new Map();
256
- entries.forEach((e, i) => {
257
- const at = this.receivedAt.get(e);
296
+ members.forEach((m, i) => {
297
+ const key = allowListMemberKey(m);
298
+ const at = this.receivedAt.get(key);
258
299
  if (at === undefined)
259
- this.receivedAt.set(e, [i]);
300
+ this.receivedAt.set(key, [i]);
260
301
  else
261
302
  at.push(i);
262
303
  });
263
304
  }
264
- for (const r of rows) {
265
- if (this.heldEntries.has(r.entry))
305
+ const inert = [];
306
+ for (const member of members) {
307
+ const read = readRuleEntry(member.rule, "allow", reading.roster);
308
+ if (read.kind !== "row") {
309
+ const { kind: _kind, ...why } = read;
310
+ void _kind;
311
+ inert.push({ entry: member.rule, ...why });
312
+ continue;
313
+ }
314
+ const key = allowListMemberKey(member);
315
+ if (this.heldKeys.has(key))
266
316
  continue;
267
- this.heldEntries.add(r.entry);
268
- this.held.push({ behavior: "allow", entry: r.entry, compiled: r.compiled });
317
+ this.heldKeys.add(key);
318
+ this.held.push({ behavior: "allow", entry: member.rule, compiled: read.compiled, ...(member.pathBases !== undefined ? { pathBases: member.pathBases } : {}) });
269
319
  }
270
320
  return inert;
271
321
  }
272
322
  entries() {
273
- return this.held.map((r) => r.entry);
323
+ return this.held.map((r) => (r.pathBases === undefined ? r.entry : Object.freeze({ rule: r.entry, pathBases: r.pathBases })));
274
324
  }
275
325
  holdsPathRows() {
276
326
  return this.held.some((r) => r.compiled.kind === "path");
@@ -278,11 +328,11 @@ export class AllowEntryTable {
278
328
  lane(ctx) {
279
329
  return {
280
330
  allowing: (req, mode) => {
281
- const hit = judgeAllowEntries(allowingRows(this.held, req, mode, ctx.classifyAllShell === true), req, "allow", ctx);
331
+ const hit = judgeAllowEntries(allowingRows(this.held, req, mode, ctx.classifyAllShell === true), req, "allow", ctx, "grant", "wire_name");
282
332
  if (hit === undefined)
283
333
  return undefined;
284
334
  const entries = hit.map((r) => r.entry);
285
- const positions = entries.flatMap((e) => this.receivedAt.get(e) ?? []).sort((a, b) => a - b);
335
+ const positions = hit.flatMap((r) => this.receivedAt.get(allowListMemberKey({ rule: r.entry, ...(r.pathBases !== undefined ? { pathBases: r.pathBases } : {}) })) ?? []).sort((a, b) => a - b);
286
336
  return { entries, ...(positions.length > 0 ? { positions } : {}) };
287
337
  },
288
338
  };
@@ -302,7 +352,7 @@ export function withDeploymentAllowedTools(deps) {
302
352
  if (deps.allowedTools === undefined)
303
353
  return deps;
304
354
  const allowedTools = screenAllowedToolsValue(deps.allowedTools, "RunnerDeps.allowedTools");
305
- const inert = compileAllowList(allowedTools ?? [], "allow").inert;
355
+ const inert = new AllowEntryTable().seed(allowedTools ?? []);
306
356
  if (inert.length > 0)
307
357
  deliverEngineNotice(deps.onNotice, allowedToolsNotGrantedNotice(inert.map((e) => ({ source: "deployment", ...e })), undefined));
308
358
  return { ...deps, allowedTools };
@@ -312,20 +362,63 @@ const ALLOW_LIST_SEATS = {
312
362
  "TaskSpec.allowedTools": "the request's allow list",
313
363
  "RunnerDeps.allowedTools": "the deployment's allow list",
314
364
  };
365
+ const ANCHORED_MEMBER_KEYS = new Set(["rule", "pathBases"]);
366
+ const PATH_BASE_WORDS = new Set(PATH_RULE_BASES);
367
+ function receiveAnchoredMember(entry, at) {
368
+ const member = receiveOwnProperties(entry, { subject: at, unit: "member", moment: "when the list is read" });
369
+ for (const key of Object.keys(member)) {
370
+ if (!ANCHORED_MEMBER_KEYS.has(key))
371
+ 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`);
372
+ }
373
+ const rule = Object.hasOwn(member, "rule") ? member.rule : undefined;
374
+ const pathBases = Object.hasOwn(member, "pathBases") ? member.pathBases : undefined;
375
+ if (typeof rule !== "string")
376
+ throw receiptRefusal(`${at}.rule must be a permission-rule string (got ${valueTypeLabel(rule)})`);
377
+ if (typeof pathBases !== "object" || pathBases === null || Array.isArray(pathBases))
378
+ throw receiptRefusal(`${at}.pathBases must be an object of base words (got ${valueTypeLabel(pathBases)})`);
379
+ const bases = receiveOwnProperties(pathBases, { subject: `${at}.pathBases`, unit: "base word", moment: "when the list is read" });
380
+ const held = Object.create(null);
381
+ for (const [word, value] of Object.entries(bases)) {
382
+ if (!PATH_BASE_WORDS.has(word))
383
+ throw receiptRefusal(`${at}.pathBases carries ${inlineUntrusted(word, 80)}, which is not a base word (${PATH_RULE_BASES.join(", ")}) — refused rather than read without it`);
384
+ if (typeof value !== "string")
385
+ throw receiptRefusal(`${at}.pathBases.${word} must be a path string (got ${valueTypeLabel(value)})`);
386
+ held[word] = value;
387
+ }
388
+ if (Object.keys(held).length === 0)
389
+ throw receiptRefusal(`${at}.pathBases declares no base word (${PATH_RULE_BASES.join(", ")}) — a member that declares no anchors is written as the rule string`);
390
+ return Object.freeze({ rule, pathBases: Object.freeze(held) });
391
+ }
315
392
  export function screenAllowedToolsValue(value, seat) {
316
393
  if (value === undefined)
317
394
  return undefined;
318
395
  const label = ALLOW_LIST_SEATS[seat];
319
396
  const issues = [];
397
+ const out = [];
320
398
  if (!Array.isArray(value)) {
321
- issues.push(ruleIssue("", "invalid.entry_type", `${label} must be a list of permission-rule strings (got ${value === null ? "null" : typeof value})`, { name: seat }));
399
+ issues.push(ruleIssue("", "invalid.entry_type", `${label} must be a list of permission-rule strings or anchored rule members (got ${value === null ? "null" : typeof value})`, { name: seat }));
322
400
  }
323
401
  else {
324
402
  const list = value;
325
- list.forEach((entry, i) => {
326
- if (typeof entry !== "string")
327
- issues.push(ruleIssue("", "invalid.entry_type", `entry ${i} of ${label} must be a permission-rule string (got ${entry === null ? "null" : typeof entry})`, { name: seat }));
328
- });
403
+ for (let i = 0; i < list.length; i++) {
404
+ const entry = list[i];
405
+ if (typeof entry === "string") {
406
+ out.push(entry);
407
+ continue;
408
+ }
409
+ if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
410
+ issues.push(ruleIssue("", "invalid.entry_type", `entry ${i} of ${label} must be a permission-rule string or an anchored rule member (got ${entry === null ? "null" : Array.isArray(entry) ? "an array" : typeof entry})`, { name: seat }));
411
+ continue;
412
+ }
413
+ const member = receiveAnchoredMember(entry, `${seat}[${i}]`);
414
+ const read = readRuleEntry(member.rule, "allow");
415
+ const bad = read.kind === "row" && read.compiled.kind === "path" ? unusableDeclaredBase(read.compiled.rule, member.pathBases) : undefined;
416
+ if (bad !== undefined) {
417
+ issues.push(ruleIssue(noticeRuleText(member.rule), "unsupported.path_base", `entry ${i} of ${label} is relative to ${PATH_RULE_BASE_LABEL[bad.base]}, and the one its set declares (pathBases.${bad.key}) is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: seat }));
418
+ continue;
419
+ }
420
+ out.push(member);
421
+ }
329
422
  }
330
423
  if (issues.length > 0) {
331
424
  const e = new Error(`${label}: ${issues.length} invalid entr${issues.length === 1 ? "y" : "ies"} — refusing rather than running without them:\n${issues.map((i) => ` [${i.code}] ${i.message}`).join("\n")}`);
@@ -333,7 +426,7 @@ export function screenAllowedToolsValue(value, seat) {
333
426
  e.issues = issues;
334
427
  throw e;
335
428
  }
336
- return Object.freeze([...value]);
429
+ return Object.freeze(out);
337
430
  }
338
431
  const SHADOW_ENTRIES_MAX = 5;
339
432
  const SHADOW_ENTRY_MAX_CHARS = 200;
@@ -474,6 +567,8 @@ export function inertEntryPhrase(e) {
474
567
  case "unprefixed_namespace":
475
568
  return 'tool_name: a "__" name with no protocol prefix';
476
569
  case "unmintable_segment":
570
+ if (e.ambiguous === true && e.guidance !== undefined)
571
+ return `tool_name: ${e.guidance}${spelling !== undefined ? ` Write "${spelling}"` : ""}`;
477
572
  return `tool_name: a namespaced name with a segment the engine never mints${spelling !== undefined ? `, write "${spelling}"` : ""}`;
478
573
  default: {
479
574
  const exhaustive = e.verdict;
@@ -77,8 +77,6 @@ export type ResultCodeTableCoversEveryHostFailure = AssertAllKeysHandled<Exclude
77
77
  /** The one result code that is not a host word: the host threw, timed out, or answered outside its contract. */
78
78
  export declare const ARTIFACT_HOST_ERROR_CODE = "artifact.host_error";
79
79
  export type ArtifactResultCode = (typeof ARTIFACT_FAILURE_RESULT_CODE)[ArtifactHostFailureCode] | typeof ARTIFACT_HOST_ERROR_CODE;
80
- /** The `details.type` card the Artifact tool mints on every result. */
81
- export declare const ARTIFACT_CARD = "artifact";
82
80
  /**
83
81
  * What a host declares at mount time. Invariants (a violation refuses the mount and announces
84
82
  * `config.artifact_host_invalid`): `actions` non-empty, duplicate-free, within {@link ARTIFACT_ACTIONS},
@@ -38,7 +38,6 @@ export const ARTIFACT_FAILURE_RESULT_CODE = {
38
38
  refused: "artifact.refused",
39
39
  };
40
40
  export const ARTIFACT_HOST_ERROR_CODE = "artifact.host_error";
41
- export const ARTIFACT_CARD = "artifact";
42
41
  const isPositiveInt = (v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0;
43
42
  const wordOf = (set, v) => typeof v === "string" && set.includes(v);
44
43
  export function readArtifactHostCapabilities(host) {
@@ -81,6 +81,85 @@ export type AskOrigin = (typeof ASK_ORIGINS)[number];
81
81
  /** Whether a value is a member of the closed origin set. Exported because the word crosses process
82
82
  * boundaries: a host validating one it received must not hand-roll the set. */
83
83
  export declare function isAskOrigin(v: unknown): v is AskOrigin;
84
+ /**
85
+ * WHY a hook asked about a call — the closed set a hook seat's answer states beside its `ask` (`questionCause`), read by the
86
+ * hook entry of {@link AskReason}: `asked` — the hook itself asks, in its own words (the answer's `message`); `verdict_unreadable`
87
+ * — the hook's host could not read the verdict the hook gave, so it asks a person instead; `verdict_unfinished` — the hook did not
88
+ * finish with a verdict (it timed out, exited, could not be run), so its host asks a person. On the two `verdict_*` words the
89
+ * answer's `message` is the host's own account and is not the hook's words: no entry carries it. An answer that states no cause
90
+ * reads as `asked`.
91
+ */
92
+ export declare const HOOK_QUESTION_CAUSES: readonly ["asked", "verdict_unreadable", "verdict_unfinished"];
93
+ export type HookQuestionCause = (typeof HOOK_QUESTION_CAUSES)[number];
94
+ /** Membership test for {@link HookQuestionCause} — the receipt's screen of the hook seat's member. */
95
+ export declare function isHookQuestionCause(v: unknown): v is HookQuestionCause;
96
+ /**
97
+ * One asker of a call and what it said, in its OWN words — an entry of `askReasons` on the approval request and its parked row.
98
+ * The one law: an entry carries a question's asker's own words (a policy chain's ask sentence — the deployment's, an integrity
99
+ * guard's, a rule's —, a hook's or an extension's reason, a hook host's cause word); a sentence the engine composes about a call
100
+ * whose fact already rides a typed member (a tool mark, an allow layer's shadow, a classifier's no-ruling, a generic question)
101
+ * is no entry. `by` names the asker with the {@link AskOrigin} word for it; a hook entry names its registration when the engine
102
+ * knows it and the {@link HookQuestionCause}, and carries `words` only when the hook itself asked (`asked`). `words` is
103
+ * untrusted display text, already one line and capped ({@link ASK_REASON_WORDS_MAX}).
104
+ */
105
+ export type AskReason = {
106
+ readonly by: "hook";
107
+ readonly registration?: string;
108
+ readonly cause: HookQuestionCause;
109
+ readonly words?: string;
110
+ } | {
111
+ readonly by: Exclude<AskOrigin, "hook">;
112
+ readonly words: string;
113
+ };
114
+ /** The cap on an entry's `words` — the one an extension's reason has always been shown under in the question's sentence. */
115
+ export declare const ASK_REASON_WORDS_MAX = 500;
116
+ /**
117
+ * The facts no layer BEFORE the gate holds about a call — the gate's org layer, its question-tool and marked-call lanes, its
118
+ * tightens and the tool seat's marks all read as absent. Two readers. An inherited station: the delegation half of the live
119
+ * gate's classifier eligibility — the SAME class row answers for the FROZEN classifier (an ask raised by a hook, minted by an
120
+ * explicit `ask` rule, or already a denial-limit fallback is as out of the frozen decider's reach as the live one's: the standing
121
+ * decision travels with the frozen entry); an ancestor's frozen classifier runs inside the policy fold, before the live gate's
122
+ * org layer has spoken and before its question-tool and marked-call lanes run, so those asks meet their exclusions downstream,
123
+ * where the facts exist, and excluded asks fall through to the frozen approver chain. The mandate marks are empty (the base
124
+ * names no seat): the policy-chain phase builds each call's facts over this base with THIS task's tool seat, so a marked tool's
125
+ * ask is classified at the station as at the gate; no call either (each station's own). And the receipt of a policy chain's ask,
126
+ * whose entry names the asker its own members say ({@link chainAskReasonsOf}) — not a word the gate's later layers would add.
127
+ */
128
+ export declare const INHERITED_STATION_FACTS: Omit<AskOriginFacts, "call">;
129
+ /** A hook's entry ({@link AskReason}): the registration that answered (when the engine knows it), the cause, and — only when the hook
130
+ * itself asked — its reason as untrusted display text. Every station that reads a hook's or an extension's `ask` mints it here. */
131
+ export declare function hookAskReasonOf(registration: string | undefined, cause: HookQuestionCause, reason: string | undefined): Extract<AskReason, {
132
+ by: "hook";
133
+ }>;
134
+ /**
135
+ * The entry of a policy chain's ask, minted where the ask is RECEIVED (the gate's adjudication and its approved-edit re-check, an
136
+ * inherited station's read of an ancestor's ask): the receipt's own words, under the asker its own members name (the origin
137
+ * ladder over {@link INHERITED_STATION_FACTS} — a rule it matched, a classifier fallback it replays, else the policy). None when
138
+ * the ask has no words, or when its engine record says its words are the engine's generic question for the call
139
+ * (`genericQuestion`, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
140
+ * call's arguments and the ask's class already say it).
141
+ */
142
+ export declare function chainAskReasonsOf(receipt: Extract<PermissionResult, {
143
+ action: "ask";
144
+ }>, call: AskOriginFacts["call"]): readonly AskReason[] | undefined;
145
+ /** A received decision with its policy chain's entry stamped ({@link chainAskReasonsOf}) — the gate's two adjudication receipts
146
+ * (the first judgment, an approved edit's re-check), right after the receipt. Not an ask, or no entry ⇒ the decision itself. */
147
+ export declare function withChainAskReasons(d: PermissionResult, call: AskOriginFacts["call"]): PermissionResult;
148
+ /** Two askers' entries in fold order — the standing ask's first, then the one folded over it; absent when neither has any. An
149
+ * entry is minted once, so the same entry reached twice (one ask relayed into the fold over itself) is one asker, listed once. */
150
+ export declare function joinAskReasons(standing: readonly AskReason[] | undefined, folded: readonly AskReason[] | undefined): readonly AskReason[] | undefined;
151
+ /** The `askReasons` member as a request, a carry and a parked row spread it — present ⇔ the ask carries at least one entry. The ONE
152
+ * reader of a surviving ask's entries for the four request mint stations and the park's carry (one value on the card and the row). */
153
+ export declare function askReasonsOf(d: PermissionResult): {
154
+ askReasons?: readonly AskReason[];
155
+ };
156
+ /**
157
+ * The entries as a boundary a host reads back holds them (the parked row): a list of well-formed entries copied fresh, else
158
+ * nothing — the row's twin is written from the gate's carry, but the row is a boundary, so the value is screened where it is
159
+ * published (the screen the row's `origin` and class pair take). A malformed list publishes no entry at all, never a partial one;
160
+ * an entry's members are read as its own data members (an inherited or accessor member is no member).
161
+ */
162
+ export declare function receiveAskReasons(v: unknown): readonly AskReason[] | undefined;
84
163
  /**
85
164
  * A compile-time fence: `T` must be `never`. Instantiate it with `Exclude<<closed set>, keyof <table>>`
86
165
  * beside a table that is meant to be TOTAL over the set — while every member has a row the argument is
@@ -1,10 +1,86 @@
1
1
  import { attestationOf } from "./engine-attestation.js";
2
2
  import { isShellFaceToolName } from "./tool-registry.js";
3
+ import { inlineUntrusted } from "./untrusted-text.js";
3
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
5
  const ASK_ORIGIN_SET = new Set(ASK_ORIGINS);
5
6
  export function isAskOrigin(v) {
6
7
  return ASK_ORIGIN_SET.has(v);
7
8
  }
9
+ export const HOOK_QUESTION_CAUSES = Object.freeze(["asked", "verdict_unreadable", "verdict_unfinished"]);
10
+ const HOOK_QUESTION_CAUSE_SET = new Set(HOOK_QUESTION_CAUSES);
11
+ export function isHookQuestionCause(v) {
12
+ return HOOK_QUESTION_CAUSE_SET.has(v);
13
+ }
14
+ export const ASK_REASON_WORDS_MAX = 500;
15
+ export const INHERITED_STATION_FACTS = { contentQuestion: false, markedUnresolvable: false, org: undefined, tightened: undefined, mandateMarks: {} };
16
+ export function hookAskReasonOf(registration, cause, reason) {
17
+ const words = cause === "asked" && reason !== undefined ? inlineUntrusted(reason, ASK_REASON_WORDS_MAX) : undefined;
18
+ return Object.freeze({ by: "hook", ...(registration !== undefined ? { registration } : {}), cause, ...(words !== undefined ? { words } : {}) });
19
+ }
20
+ export function chainAskReasonsOf(receipt, call) {
21
+ const message = receipt.message;
22
+ const record = attestationOf(receipt, call);
23
+ if (record?.receivedAskReasons !== undefined)
24
+ return record.receivedAskReasons.length > 0 ? record.receivedAskReasons : undefined;
25
+ if (message === undefined || message === record?.genericQuestion)
26
+ return undefined;
27
+ const by = askOriginOf(receipt, { ...INHERITED_STATION_FACTS, call });
28
+ const words = inlineUntrusted(message, ASK_REASON_WORDS_MAX);
29
+ return Object.freeze([Object.freeze(by === "hook" ? { by, cause: "asked", words } : { by, words })]);
30
+ }
31
+ export function withChainAskReasons(d, call) {
32
+ if (d.action !== "ask")
33
+ return d;
34
+ const askReasons = chainAskReasonsOf(d, call);
35
+ return askReasons === undefined ? d : { ...d, askReasons };
36
+ }
37
+ export function joinAskReasons(standing, folded) {
38
+ const joined = [...(standing ?? [])];
39
+ for (const e of folded ?? [])
40
+ if (!joined.includes(e))
41
+ joined.push(e);
42
+ return joined.length > 0 ? Object.freeze(joined) : undefined;
43
+ }
44
+ export function askReasonsOf(d) {
45
+ return d.action === "ask" && d.askReasons !== undefined && d.askReasons.length > 0 ? { askReasons: d.askReasons } : {};
46
+ }
47
+ const BAD = Symbol("malformed");
48
+ function ownEntryMember(e, k) {
49
+ const d = Object.getOwnPropertyDescriptor(e, k);
50
+ if (d === undefined)
51
+ return undefined;
52
+ return "value" in d ? d.value : BAD;
53
+ }
54
+ function receivedEntry(e) {
55
+ if (typeof e !== "object" || e === null || Array.isArray(e))
56
+ return undefined;
57
+ const by = ownEntryMember(e, "by");
58
+ const words = ownEntryMember(e, "words");
59
+ if (by === "hook") {
60
+ const cause = ownEntryMember(e, "cause");
61
+ const registration = ownEntryMember(e, "registration");
62
+ if (!isHookQuestionCause(cause) || (registration !== undefined && typeof registration !== "string"))
63
+ return undefined;
64
+ if (words !== undefined && (typeof words !== "string" || cause !== "asked"))
65
+ return undefined;
66
+ return Object.freeze({ by: "hook", ...(registration !== undefined ? { registration } : {}), cause, ...(words !== undefined ? { words } : {}) });
67
+ }
68
+ if (!isAskOrigin(by) || typeof words !== "string")
69
+ return undefined;
70
+ return Object.freeze({ by: by, words });
71
+ }
72
+ export function receiveAskReasons(v) {
73
+ if (!Array.isArray(v) || v.length === 0)
74
+ return undefined;
75
+ const out = [];
76
+ for (let i = 0; i < v.length; i++) {
77
+ const entry = Object.prototype.hasOwnProperty.call(v, i) ? receivedEntry(v[i]) : undefined;
78
+ if (entry === undefined)
79
+ return undefined;
80
+ out.push(entry);
81
+ }
82
+ return Object.freeze(out);
83
+ }
8
84
  export function askOriginOf(decision, facts) {
9
85
  const origin = originLadder(decision, facts);
10
86
  if (ORIGIN_IMPLIES_REAL_APPROVAL[origin] === "at_derivation" && decision.requiresRealApproval !== true) {
@@ -66,12 +66,16 @@ export interface AskQuestionRequest {
66
66
  * actually CALLS a question face: the in-tool synchronous call, and the gate's pre-execution content-ask
67
67
  * routing. A durable suspend invokes no face at all, so it carries none. */
68
68
  readonly principal?: string;
69
- /** Runner-filled source-task identity (= issuing task's session id), for per-worker attribution by an
70
- * aggregating onQuestion. **worker-unforgeable for Runner-created delegated subagents/team members**
71
- * (those child specs do not pass TaskSpec.sessionId — the Runner mints the id); a top-level caller CAN
72
- * still set `TaskSpec.sessionId`, so this is NOT a globally unforgeable run id (design S1d §1.3).
73
- * `readonly` + same "only where a face is really called" caveat as `principal`. */
74
- readonly sourceTaskId?: string;
69
+ /** Runner-filled: the issuing leg's session id (the conversation the question was raised in), for per-worker
70
+ * attribution by an aggregating onQuestion. **worker-unforgeable for Runner-created delegated subagents/team
71
+ * members** (those child specs do not pass TaskSpec.sessionId — the Runner mints the id); a top-level caller CAN
72
+ * still set `TaskSpec.sessionId`, so this is NOT a globally unforgeable run id (design S1d §1.3). It names a
73
+ * conversation, never a task. `readonly` + same "only where a face is really called" caveat as `principal`. */
74
+ readonly sourceSessionId?: string;
75
+ /** Runner-filled: the issuing leg's task id when that leg is a delegated child — the same value and the same
76
+ * presence as {@link import("./tool-policy.js").AskRequest}.agentId (one mint for both); absent on a host's
77
+ * question. `readonly` + same caveat as `principal`. */
78
+ readonly agentId?: string;
75
79
  /**
76
80
  * The canonical hash of the tool-call arguments this question was built from, as computed by the
77
81
  * engine's one `boundInputHashOf` (the same digest the durable park binds its checkpoint to, so the
@@ -79,7 +83,7 @@ export interface AskQuestionRequest {
79
83
  * — a directly-mounted tool calling its own face carries none.
80
84
  *
81
85
  * The split to keep straight, because the two words are easy to swap:
82
- * - `(sourceTaskId, toolCallId, boundInputHash)` is the RECONCILIATION key — "is this the same
86
+ * - `(sourceSessionId, toolCallId, boundInputHash)` is the RECONCILIATION key — "is this the same
83
87
  * question, on the same call, in the same run?". It is what lets an in-stream delivery be matched
84
88
  * against a parked one, and what an audit trail joins on. It is NOT an identity: all three
85
89
  * components repeat for two sequential deliveries of an identical question.
@@ -96,7 +100,7 @@ export interface AskQuestionRequest {
96
100
  * refused instead of applied to a question nobody is waiting on any more.
97
101
  *
98
102
  * Why not the tuple you might reach for first: `toolCallId` comes from the model/provider and is not
99
- * guaranteed unique within a session, `sourceTaskId` can be caller-supplied, and the argument hash
103
+ * guaranteed unique within a session, `sourceSessionId` can be caller-supplied, and the argument hash
100
104
  * is identical for two identical questions. Their combination therefore repeats for two sequential
101
105
  * deliveries of the same question — under which a registry would close the second on the first's
102
106
  * ticket, or hand the second the first's late answer. That tuple remains the RECONCILIATION key
@@ -351,15 +355,17 @@ export declare function markBoundOnlyQuestionFace<F extends OnQuestion>(face: F)
351
355
  * Callers resolve the seat first (`spec.onQuestion ?? deps.onQuestion`) and pass the resolved value.
352
356
  */
353
357
  export declare function isLiveQuestionFace(face: unknown): face is OnQuestion;
358
+ /** The issuing leg's members of a question request. */
359
+ export type QuestionSource = Pick<AskQuestionRequest, "principal" | "sourceSessionId" | "agentId">;
360
+ /** The source members a question request carries, each only when present — the mounted tool's call and the gate's routing
361
+ * lane both read the leg's one ask source through this. */
362
+ export declare function questionSourceOf(source: QuestionSource | undefined): QuestionSource;
354
363
  /** Build the AskUserQuestion tool. When `onQuestion` is undefined the tool still mounts but returns the
355
364
  * headless default (so a run started without a human in the loop never hangs). */
356
365
  export declare function createAskUserQuestionTool(onQuestion?: OnQuestion,
357
366
  /** design S1d §1.2: Runner-filled source identity, merged into the {@link AskQuestionRequest} so an
358
- * aggregating onQuestion can attribute per worker/user. Omitted ⇒ fields stay undefined (no-op). */
359
- source?: {
360
- principal?: string;
361
- sourceTaskId?: string;
362
- }, opts?: AskUserQuestionToolOptions): AgentTool;
367
+ * aggregating onQuestion can attribute per worker/user. Omitted ⇒ the members stay absent (no-op). */
368
+ source?: QuestionSource, opts?: AskUserQuestionToolOptions): AgentTool;
363
369
  /**
364
370
  * The ONE producer of the "engine stripped the spawn turn's question face" fact. The strip (removing `onQuestion`
365
371
  * from a child spec — or from the parent SPEC seat a child is built from — when the child OUTLIVES the request that
@@ -94,6 +94,13 @@ export function markBoundOnlyQuestionFace(face) {
94
94
  export function isLiveQuestionFace(face) {
95
95
  return typeof face === "function" && face !== QUESTION_AWAITS_RESUME && !boundOnlyQuestionFaces.has(face);
96
96
  }
97
+ export function questionSourceOf(source) {
98
+ return {
99
+ ...(source?.principal !== undefined ? { principal: source.principal } : {}),
100
+ ...(source?.sourceSessionId !== undefined ? { sourceSessionId: source.sourceSessionId } : {}),
101
+ ...(source?.agentId !== undefined ? { agentId: source.agentId } : {}),
102
+ };
103
+ }
97
104
  export function createAskUserQuestionTool(onQuestion, source, opts) {
98
105
  const disclosedSyntheticContinuations = new Set();
99
106
  let approvalPostureSpent = false;
@@ -191,8 +198,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
191
198
  const outcome = await onQuestion({
192
199
  toolCallId: ctx.toolCallId,
193
200
  questions,
194
- principal: source?.principal,
195
- sourceTaskId: source?.sourceTaskId,
201
+ ...questionSourceOf(source),
196
202
  deliveryId: uuidv7(),
197
203
  }, ctx.signal);
198
204
  const reading = classifyQuestionOutcome(outcome);
@@ -140,6 +140,8 @@ export interface MaybeCompactOptions {
140
140
  /** The session to compact. Typed on the INTERFACE face (typecheck 车 2026-07-24): every member this
141
141
  * module touches lives on `Session` (the optional `getPromptEpoch` degrades honestly via `?.()`). */
142
142
  session: Session;
143
+ /** The leg's admission seat (`session.append`): a row this pass adds to the transcript passes it first. Absent ⇒ as made. */
144
+ admitRows?: import("../internal/harness.js").RowAdmission;
143
145
  /** This run's prompt identity inputs (and the pinned center layer's provenance): the compaction restates the
144
146
  * session's epoch when the identity is unchanged and advances it otherwise — the same identity the prepare-time
145
147
  * record names, so a compaction never flaps the record. Absent ⇒ no restatement (a host compacting outside a run). */
@@ -8,6 +8,7 @@ import { brainToRuntime } from "./runtime.js";
8
8
  import { defuseFenceMarkers, sanitizeUntrustedText } from "./untrusted-text.js";
9
9
  import { createSafeNotifier, observeThenableRejection } from "./safe-notify.js";
10
10
  import { thrownText } from "./thrown-value.js";
11
+ import { appendAdmittedRow } from "./row-admission.js";
11
12
  import { egressThrownText } from "./untrusted-egress.js";
12
13
  export const DEFAULT_COMPACTION_INSTRUCTIONS = "Preserve verbatim every code, identifier, name, number, file path, error message, credential " +
13
14
  "reference, and explicit user instruction or decision mentioned anywhere in the conversation. " +
@@ -493,7 +494,7 @@ export async function maybeCompact(opts) {
493
494
  const delivered = [];
494
495
  for (const f of restoreFrames) {
495
496
  try {
496
- await opts.session.appendMessage({ role: "user", content: [...f.seed.content], timestamp: Date.now(), provenance: "engine-note", attachment: f.seed.attachment });
497
+ await appendAdmittedRow(opts.admitRows, opts.session, { role: "user", content: [...f.seed.content], timestamp: Date.now(), provenance: "engine-note", attachment: f.seed.attachment });
497
498
  delivered.push(f);
498
499
  }
499
500
  catch (err) {
@@ -16,6 +16,14 @@ export declare const AUTO_MODE_DEFAULT_TIMEOUT_MS = 180000;
16
16
  * would only make the person wait out the rung's budget and hear "timed out" for a failure that was not one.
17
17
  */
18
18
  export declare const AUTO_MODE_CLASSIFIER_MAX_RETRIES = 4;
19
+ /**
20
+ * How many CONSECUTIVE classifications must end on a rung's rate limit (an HTTP 429 that outlived the brain's own
21
+ * {@link AUTO_MODE_CLASSIFIER_MAX_RETRIES} backoffs) before that rung is not asked again for the rest of the run, when
22
+ * `RunnerDeps.autoMode.rateLimitBreakAfter` is omitted. Each such classification has already slept the whole
23
+ * backoff ladder, so the number is the wall time a rate-limited seat may still cost before the walk starts behind it:
24
+ * three, the same count the denial limit hands a run to a person after.
25
+ */
26
+ export declare const AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT = 3;
19
27
  /**
20
28
  * What an arming RECORDING that carries no `timeoutMs` meant when it was written: the default of its day. Every
21
29
  * recipe minted since the deadline moved to 60 s MATERIALISES its bound, so an absent recorded knob dates the