@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,5 +1,5 @@
1
1
  import { randomBytes } from "node:crypto";
2
- import { COMMAND_RULE_TOOL, cardRuleFormOf, escapeForDisclosure, foldSpacing, hasUnrenderableCharacters, parseRuleText, ruleAdmitsCommand, ruleBreadthWarningsOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, EDITED_RULE_BREADTH_WARNING_CODES, RULE_OFFER_KINDS, UNCOVERED_SEGMENT_REASONS, RULE_BEHAVIORS, RULE_BEHAVIOR_PRECEDENCE, isRuleBehavior, } from "./permission-rule-model.js";
2
+ import { COMMAND_RULE_TOOL, cardRuleFormOf, escapeForDisclosure, foldSpacing, hasUnrenderableCharacters, parseRuleText, ruleAdmitsCommand, ruleBasesNeeded, ruleBreadthWarningsOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, EDITED_RULE_BREADTH_WARNING_CODES, RULE_OFFER_KINDS, UNCOVERED_SEGMENT_REASONS, RULE_BEHAVIORS, RULE_BEHAVIOR_PRECEDENCE, isRuleBehavior, } from "./permission-rule-model.js";
3
3
  import { readRuleOwner, sameRuleOwner } from "./rule-owner.js";
4
4
  import { principalNameOf, readPrincipal } from "./principal-name.js";
5
5
  import { isPlainRecord } from "./mods/kernel/receive.js";
@@ -690,6 +690,8 @@ export async function redeemRuleTicket(opts) {
690
690
  const parsedRule = parseRuleText(candidate.rule, candidate.behavior);
691
691
  if ("reject" in parsedRule)
692
692
  return { status: "refused", reason: `${parsedRule.reject.code}: ${parsedRule.reject.message}` };
693
+ if (rec.kind === "import" && !importCarries(candidate.scope, parsedRule.rule))
694
+ return { status: "refused", reason: LAYER_ROOT_RECORD_REASON };
693
695
  let store;
694
696
  try {
695
697
  store = storeForOwner(opts.deps.provider, caller);
@@ -784,11 +786,24 @@ function originOfRecordKind(kind) {
784
786
  }
785
787
  export const IMPORTED_SETTINGS_LAYERS = Object.freeze(["userSettings", "projectSettings", "localSettings"]);
786
788
  const IMPORT_UNCOVERED_LAYERS = { flagSettings: "not-imported-v1", policySettings: "not-imported-v1" };
789
+ function importCarries(scope, rule) {
790
+ return !(scope.kind === "global" && ruleBasesNeeded(rule).includes("root"));
791
+ }
792
+ const LAYER_ROOT_SKIP_REASON = "unsupported.layer_root: a path pattern written from `/` in the user settings layer reads at that layer's own directory (the configuration directory), and a stored global rule reads `/` at the project root of each task — the stored copy would guard or open another directory, so it stays in the settings file, unimported; to carry it, spell the directory out (`//<directory>/…`, or `~/<path>` under the home) — a directory whose name holds `*`, `?`, `[`, `]`, `{` or `}` has no literal spelling in the path grammar and cannot be written this way";
793
+ const LAYER_ROOT_RECORD_REASON = "unsupported.layer_root: this import record carries a global rule written from `/` — the user settings layer reads it at its own directory (the configuration directory), a stored global rule reads it at the project root of each task, so it does not land; prepare the import again and the entry is disclosed in skipped, left in the settings file";
787
794
  export async function prepareCcImport(opts) {
788
795
  const owner = resolveCallerOwner(opts.principal, opts.owner, "prepareCcImport");
796
+ opts.layers.forEach((layer, i) => {
797
+ if (layer.layer === "userSettings" && layer.root !== undefined) {
798
+ const field = `layers[${i}].root`;
799
+ const e = new Error(`prepareCcImport got a root on the user settings layer (${field}) — the user layer has no root: its rules import as global rules, which read \`/\` at each task's project root, and nothing reads that layer's own directory; drop the member (a project or local layer keeps its root)`);
800
+ e.code = "config.invalid_argument";
801
+ e.detail = { field };
802
+ throw e;
803
+ }
804
+ });
789
805
  const candidates = [];
790
806
  const skipped = [];
791
- const translated = [];
792
807
  const layers = [];
793
808
  for (const layer of opts.layers) {
794
809
  let raw;
@@ -861,13 +876,17 @@ export async function prepareCcImport(opts) {
861
876
  skipped.push({ rule: entry, reason: "unsupported.form: a bare tool-name entry is a name-set item the host carries from the settings layer's own lists — it stays in the settings file, unimported" });
862
877
  continue;
863
878
  }
879
+ if (!importCarries(scope, parsed.rule)) {
880
+ skipped.push({ rule: entry, reason: LAYER_ROOT_SKIP_REASON });
881
+ continue;
882
+ }
864
883
  if (candidates.some((c) => c.behavior === behavior && c.rule === parsed.rule.rule && sameScope(c.scope, scope)))
865
884
  continue;
866
885
  candidates.push({ behavior, rule: parsed.rule.rule, scope });
867
886
  }
868
887
  }
869
888
  }
870
- const preview = { candidates, skipped, translated, layers, uncovered: { ...IMPORT_UNCOVERED_LAYERS } };
889
+ const preview = { candidates, skipped, layers, uncovered: { ...IMPORT_UNCOVERED_LAYERS } };
871
890
  if (candidates.length === 0)
872
891
  return { preview };
873
892
  const record = {
@@ -132,7 +132,7 @@ export declare function readRowBehavior(v: unknown): RuleBehavior | undefined;
132
132
  export type PersistedRuleTool = string;
133
133
  /** The command grammar's ONE rule word — the spelling a shell command rule is written in (`Bash(<command>)`, upstream's).
134
134
  * A rule word, not a tool list: the calls a command rule reaches are the SHELL FACE's — every catalog definition whose
135
- * `command` the command grammar judges ({@link laneToolNamesOf}). */
135
+ * `command` the command grammar judges ({@link ruleWordsOf}). */
136
136
  export declare const COMMAND_RULE_TOOL = "Bash";
137
137
  /** The read face's rule word: a `Read(<path>)` rule speaks for every call that reads a path ({@link PATH_RULE_FACES}). */
138
138
  export declare const READ_RULE_TOOL = "Read";
@@ -276,7 +276,7 @@ export declare const DOMAIN_RULE_MARKER = "domain:";
276
276
  * rule policy's compiler through {@link ruleLaneOf}, the entry lists, the approval card), and a property of the rule's tool NAME
277
277
  * as the catalog declares it, never of the tool a leg mounts under that name. The model's tool set is DERIVED, never a hand-kept
278
278
  * list: the command rule word ({@link COMMAND_RULE_TOOL}) takes the COMMAND grammar — the other shell-face tools take none of
279
- * their own, their command is judged by the `Bash(…)` rules ({@link laneToolNamesOf}); the tools of {@link NAME_RULE_FACES} the
279
+ * their own, their command is judged by the `Bash(…)` rules ({@link ruleWordsOf}); the tools of {@link NAME_RULE_FACES} the
280
280
  * NAME grammar (each in its row's spelling: bare `Skill(<name>)`, keyed `Artifact(action:<word>)`); every name the catalog
281
281
  * declares a host target for (`hostTargetOf`: WebFetch) the DOMAIN grammar; every name it declares a path target for
282
282
  * (`pathTargetOf`: Read / Edit / Write / Glob / NotebookEdit / …) the PATH grammar. A rule on any other tool has no content
@@ -288,7 +288,7 @@ export declare function ruleToolGrammarOf(toolName: string): RuleGrammar | undef
288
288
  /**
289
289
  * THE rule a tool's approval card mints a "don't ask again" option in — one answer, read by the offer factory and the consent door
290
290
  * alike: `command` for the command rule word (the shell card's command rules), `name` / `domain` for a tool of those grammars (the one
291
- * exact value rule), `tool` for a call no rule word speaks for under any name it answers to ({@link laneToolNamesOf} empty: the
291
+ * exact value rule), `tool` for a call no rule word speaks for under any name it answers to ({@link ruleWordsOf} of a tightening empty: the
292
292
  * whole-tool rule, the reference's fallback card), and `undefined` for the rest — a path tool (no path offer is minted), a shell-face
293
293
  * sibling of the command word (its commands are `Bash(…)` rules), and a tool that answers to one of those under an alias it declares
294
294
  * (a caller's shell wearing `Bash`: a one-click whole-tool yes on it would be a licence for every program): its card names that it has
@@ -318,13 +318,15 @@ export declare function ruleLaneOf(tool: string, content: string): RuleLane;
318
318
  * `Skill` call is resolved by — or undefined (not a name-grammar tool; no such argument; not a string; the empty string, which
319
319
  * names no value: an empty and an omitted argument are one call to every reader, as they are to the tool that runs it). */
320
320
  export declare function nameRuleSubjectOf(toolName: string, args: unknown): string | undefined;
321
- /** The rule WORDS a call is judged under, once each: for every name the call answers to (the model's spelling, the wire
322
- * name, the other aliases that resolve to it), the word its rules are written in — a shell-face name's is the command
323
- * grammar's {@link COMMAND_RULE_TOOL} (a `Bash(<command>)` rule reaches `Monitor` as it reaches `Bash`), a path, name or
324
- * domain tool's its own name — so a stored `Bash(…)` or `Edit(…)` row reaches a tool that answers to that name under another wire
325
- * name, as a policy's rule does. Every lane that judges a call by a rule's word reads it here: the policy compiler, the
326
- * person's stored rows, the org partition, the allow lists. Empty ⇒ no grammar speaks for the call. */
327
- export declare function laneToolNamesOf(req: NamedCall): readonly string[];
321
+ /** The rule WORDS a rule of `behavior` reaches the call under, once each — the word a name's rules are written in: a shell-face
322
+ * name's is the command grammar's {@link COMMAND_RULE_TOOL} (a `Bash(<command>)` rule reaches `Monitor` as it reaches `Bash`), a
323
+ * path, name or domain tool's its own name. A deny or ask reads every name the call answers to (the model's spelling, the wire
324
+ * name, the other aliases that resolve to it), so a stored `Bash(rm:*)` row reaches a tool that answers to `Bash` under another
325
+ * wire name; an allow reads the call's wire name alone — a grant written in a tool's grammar is a grant for the tool whose
326
+ * grammar it is, so a `Bash(npm test:*)` allow does not reach a caller's tool that only wears `Bash`. Every lane that judges a
327
+ * call by a rule's content reads it here: the policy compiler, the person's stored rows, the org partition, the allow lists.
328
+ * Empty ⇒ no grammar speaks for the call in that direction. A rule with no content is read by {@link wholeToolRuleReaches}. */
329
+ export declare function ruleWordsOf(req: NamedCall, behavior: RuleBehavior): readonly string[];
328
330
  /** The match words a persisted rule is stored with, spelled once: {@link PersistedRuleMatch} is derived from this
329
331
  * tuple (each form is documented there). A store backend that checks a stored row's `match` reads this value
330
332
  * rather than keeping its own list. */
@@ -832,6 +834,14 @@ export declare function ruleBasesNeeded(rule: Pick<PersistedRule, "match" | "com
832
834
  /** Is this base usable by {@link resolvePathPattern} — an absolute path with a lexical normal form? A rule
833
835
  * compiler asks this at compile time so a pattern is refused rather than compiled inert. */
834
836
  export declare function isUsablePathBase(base: string | undefined, family: PathFamily | undefined): boolean;
837
+ /** The base a rule SET declares for this rule's pattern that cannot be read ({@link isUsablePathBase}): the base word the
838
+ * pattern needs and the declared key that holds the bad value (`cwd`'s stand-in is the declared `root`) — the one judgment of
839
+ * declared anchors, a policy's and an allow list member's alike. `undefined` when every base the rule needs that the set
840
+ * declares is usable (a base the set leaves out is the leg's, judged there). */
841
+ export declare function unusableDeclaredBase(rule: Pick<PersistedRule, "match" | "command">, declared: PathRuleBases): {
842
+ readonly base: PathRuleBase;
843
+ readonly key: PathRuleBase;
844
+ } | undefined;
835
845
  /**
836
846
  * The PATH family's tightening reach — three-valued like the command family's ({@link programRunReachOf}):
837
847
  * does this deny/ask rule reach the call's target path? The target is the caller's ALREADY-RESOLVED
@@ -849,9 +859,22 @@ export declare function isUsablePathBase(base: string | undefined, family: PathF
849
859
  * no root reached nothing at all).
850
860
  */
851
861
  export declare function pathRuleReachOf(rule: Pick<PersistedRule, "match" | "command" | "behavior">, target: PathIdentity, bases: PathRuleBases, treeFamily?: PathFamily | undefined): ProgramRunReachOutcome;
862
+ /**
863
+ * A path rule's reach as a SHAPE (the deny table's `reachShape`, what an OS confinement translates): the location the
864
+ * resolved pattern starts at — its base and then its body's segments up to the first one carrying `*` (`/` when the
865
+ * first does; the base's segments are letters), or a directory rule's directory — and the glob segments after it. {@link pathRuleReachOf} is this shape's judgment (the
866
+ * target's segments below `at` match the globs as a prefix), read off the same resolution. `undefined` where the reach is
867
+ * no shape: the pattern needs a base the call does not supply (the rule reads `unreadable` everywhere), a directory rule
868
+ * admits nothing, a UNC pattern, or any other match form.
869
+ */
870
+ export declare function pathRuleReachShapeOf(rule: Pick<PersistedRule, "match" | "command" | "behavior">, bases: PathRuleBases): {
871
+ readonly at: string;
872
+ readonly globs: readonly string[];
873
+ } | undefined;
852
874
  /**
853
875
  * Where a path rule's reach STARTS under the call's bases — its HEAD: the location the resolved pattern names before
854
- * its first segment carrying `*` (the whole path when none does), or a directory rule's directory. Everything the rule
876
+ * its body's first segment carrying `*` (the whole path when none does; the base's segments are letters), or a directory
877
+ * rule's directory. Everything the rule
855
878
  * reaches lies at or below the head, so a spelling of the head that the environment resolves elsewhere (a link, a
856
879
  * firmlink, `/var` → `/private/var`) is a second spelling of everything the rule reaches — the deny tables judge the
857
880
  * rule at both ({@link import("../tools/fs/read-deny.js").withRuleRowsWhereTheyLead}; the reference's "physical twin"
@@ -1310,9 +1333,11 @@ export declare function adjudicatePersistedDomainRules(rules: readonly Persisted
1310
1333
  * THE predicate of a whole-tool rule (`match: "tool"`) over one call: the rule reaches the call iff the call answers to the name it
1311
1334
  * spells, under every name the call answers to (the model's spelling, the wire name, the aliases that resolve to it) — the
1312
1335
  * reference's tool-wide matcher. Every reader of a rule with no content asks it: an entry list's whole-tool row and a person's stored
1313
- * whole-tool row alike.
1336
+ * whole-tool row alike. A row of a list that RESTRICTS (`behavior` deny / ask) whose MCP name the lookup reads more than one way
1337
+ * ({@link peerReadingsOf}: `mcp__a__b` is tool `b` of server `a` and every tool of server `a__b`) reaches the call under any of its
1338
+ * readings; a granting row keeps the one name it spells — an ambiguous spelling never widens a grant.
1314
1339
  */
1315
- export declare function wholeToolRuleReaches(tool: string, call: NamedCall): boolean;
1340
+ export declare function wholeToolRuleReaches(tool: string, call: NamedCall, behavior?: RuleBehavior): boolean;
1316
1341
  /**
1317
1342
  * The whole-tool sibling of {@link adjudicatePersistedRules}: the same precedence walk (deny > ask > allow) over the whole-tool rows
1318
1343
  * (`match: "tool"`) that reach the call ({@link wholeToolRuleReaches}) and are eligible under their own tool ({@link eligiblePersisted},
@@ -3,14 +3,14 @@ import { shellWordsOf } from "../shell/shell-words.js";
3
3
  import { lexShell } from "../shell/lex.js";
4
4
  import { readProgramPosition } from "../tools/fs/bash-program-position.js";
5
5
  import { isNameableToolName, parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
6
- import { isCoveringRuleName } from "./namespaced-rule-name.js";
7
- import { toolNameFaultOf } from "./tool-name-aliases.js";
6
+ import { namesASetOfTools, ruleNameCovers } from "./namespaced-rule-name.js";
7
+ import { peerReadingsOf, readsNameGlob, toolNameFaultOf } from "./tool-name-aliases.js";
8
8
  import { compileReadDeny } from "../tools/fs/read-deny.js";
9
9
  import { carriesShellRedirection, parseLeadingCommandName, splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
10
10
  import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
11
11
  import { catalogRuleFaceOf, catalogToolNames, hostTargetOf, isShellFaceToolName, pathTargetOf, protectivePathTargetOf } from "./tool-registry.js";
12
12
  import { HOST_UNREADABLE_SENTENCE, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
13
- import { heldBy, heldValues } from "./tool-name-readings.js";
13
+ import { heldBy, heldValues, wireOf } from "./tool-name-readings.js";
14
14
  import { carriesDotSegment, isAbsoluteForFamily, isIdentityDir, isPathIdentity, isShellRootedSpellingUnmapped, isUncIdentity, pathFamilyOf, pathIdentityOf } from "../tools/fs/safety.js";
15
15
  import { bindPathRules, judgeRuleRows, rowsWhereTheyLead } from "./path-rule-binding.js";
16
16
  import { readShellCommand } from "./shell-run-candidates.js";
@@ -143,7 +143,7 @@ export function cardRuleFormOf(toolName, call = { toolName }) {
143
143
  const grammar = ruleToolGrammarOf(toolName);
144
144
  if (grammar === "name" || grammar === "domain")
145
145
  return grammar;
146
- return grammar === undefined && laneToolNamesOf(call).length === 0 && laneToolNamesOf({ toolName }).length === 0 ? "tool" : undefined;
146
+ return grammar === undefined && ruleWordsOf(call, "deny").length === 0 && ruleWordsOf({ toolName }, "deny").length === 0 ? "tool" : undefined;
147
147
  }
148
148
  export function shellRuleParamOf(tool, content) {
149
149
  const colon = content.indexOf(":");
@@ -173,7 +173,11 @@ export function nameRuleSubjectOf(toolName, args) {
173
173
  const value = args[face.param];
174
174
  return typeof value === "string" && value !== "" ? value : undefined;
175
175
  }
176
- export function laneToolNamesOf(req) {
176
+ export function ruleWordsOf(req, behavior) {
177
+ if (behavior === "allow") {
178
+ const word = ruleWordOf(wireOf("policy.persistedGrammar.grant", req));
179
+ return word === undefined ? [] : [word];
180
+ }
177
181
  const words = heldValues("policy.persistedGrammar", { get: ruleWordOf }, req);
178
182
  return words.length <= 1 ? words : [...new Set(words)];
179
183
  }
@@ -426,7 +430,7 @@ export function respelledRuleTextOf(text, behavior) {
426
430
  return "rule" in read ? read.rule.rule : undefined;
427
431
  }
428
432
  function parseWholeToolRule(text, tool, behavior) {
429
- if (!isNameableToolName(tool) || isCoveringRuleName(tool, behavior)) {
433
+ if (!isNameableToolName(tool) || namesASetOfTools(tool, behavior)) {
430
434
  return reject("invalid.grammar", `"${text}" names a set of tools — a stored rule names one tool, or one tool's content; a set of tools is a list entry's form`);
431
435
  }
432
436
  const fault = toolNameFaultOf(tool, catalogToolNames(), behavior);
@@ -748,7 +752,7 @@ function resolvePathPattern(pattern, bases, behavior, treeFamily = pathFamilyOf(
748
752
  const tree = bases.root ?? bases.cwd;
749
753
  if (pattern.startsWith("//")) {
750
754
  const abs = pathIdentityOf("/" + pattern.slice(2), family, tree);
751
- return abs.ok ? { resolved: abs.identity } : { missingBase: "root" };
755
+ return abs.ok ? { resolved: abs.identity, literal: 0 } : { missingBase: "root" };
752
756
  }
753
757
  const needed = ruleBasesNeeded({ match: "path", command: pattern })[0];
754
758
  const baseValue = baseValueOf(needed, bases);
@@ -761,11 +765,23 @@ function resolvePathPattern(pattern, bases, behavior, treeFamily = pathFamilyOf(
761
765
  const bare = needed === "cwd" && peeled !== "" && !peeled.includes("/");
762
766
  const anyDepth = bare && (peeled === rest || behavior !== "allow");
763
767
  const body = anyDepth ? "**/" + peeled : rest;
764
- return { resolved: (normal === "/" ? "" : normal) + "/" + body };
768
+ return { resolved: (normal === "/" ? "" : normal) + "/" + body, literal: normal.split("/").filter((sg) => sg !== "").length };
769
+ }
770
+ function firstGlobSegment(segments, literal) {
771
+ return segments.findIndex((sg, i) => i >= literal && sg.includes("*"));
765
772
  }
766
773
  export function isUsablePathBase(base, family) {
767
774
  return base !== undefined && isAbsoluteForFamily(family ?? "own", base) && pathIdentityOf(base, family, base).ok;
768
775
  }
776
+ export function unusableDeclaredBase(rule, declared) {
777
+ for (const base of ruleBasesNeeded(rule)) {
778
+ const key = base === "cwd" && declared.cwd === undefined ? "root" : base;
779
+ const value = declared[key];
780
+ if (value !== undefined && !isUsablePathBase(value, pathFamilyOf(declared)))
781
+ return { base, key };
782
+ }
783
+ return undefined;
784
+ }
769
785
  function segmentGlobMatches(glob, segment) {
770
786
  if (!glob.includes("*"))
771
787
  return glob === segment;
@@ -788,7 +804,7 @@ function segmentGlobMatches(glob, segment) {
788
804
  }
789
805
  return true;
790
806
  }
791
- function globSegmentsReach(globs, target) {
807
+ function globSegmentsReach(globs, target, literal) {
792
808
  const seen = new Set();
793
809
  const width = target.length + 1;
794
810
  const walk = (g, t) => {
@@ -798,6 +814,8 @@ function globSegmentsReach(globs, target) {
798
814
  if (seen.has(key))
799
815
  return false;
800
816
  seen.add(key);
817
+ if (g < literal)
818
+ return t < target.length && globs[g] === target[t] && walk(g + 1, t + 1);
801
819
  if (globs[g] === "**")
802
820
  return walk(g + 1, t) || (t < target.length && walk(g, t + 1));
803
821
  if (t >= target.length)
@@ -822,7 +840,25 @@ export function pathRuleReachOf(rule, target, bases, treeFamily = pathFamilyOf(b
822
840
  return NOT_REACHED;
823
841
  const globs = r.resolved.split("/").filter((sg) => sg !== "");
824
842
  const segments = target.split("/").filter((sg) => sg !== "");
825
- return globSegmentsReach(globs, segments) ? REACHED : NOT_REACHED;
843
+ return globSegmentsReach(globs, segments, r.literal) ? REACHED : NOT_REACHED;
844
+ }
845
+ export function pathRuleReachShapeOf(rule, bases) {
846
+ const family = pathFamilyOf(bases);
847
+ if (rule.match === "subpath") {
848
+ if (carriesDotSegment(rule.command, family))
849
+ return undefined;
850
+ const dir = pathIdentityOf(rule.command, family, bases.root ?? bases.cwd);
851
+ return dir.ok && isIdentityDir(dir.identity, family) && dir.identity.startsWith("/") && !isUncIdentity(dir.identity) ? { at: dir.identity, globs: [] } : undefined;
852
+ }
853
+ if (rule.match !== "path")
854
+ return undefined;
855
+ const r = resolvePathPattern(rule.command, bases, rule.behavior, family);
856
+ if ("missingBase" in r || !r.resolved.startsWith("/") || isUncIdentity(r.resolved))
857
+ return undefined;
858
+ const segments = r.resolved.split("/").filter((sg) => sg !== "");
859
+ const wild = firstGlobSegment(segments, r.literal);
860
+ const lead = wild === -1 ? segments : segments.slice(0, wild);
861
+ return { at: `/${lead.join("/")}`, globs: wild === -1 ? [] : segments.slice(wild) };
826
862
  }
827
863
  export function pathRuleHeadOf(rule, bases) {
828
864
  const family = pathFamilyOf(bases);
@@ -838,9 +874,10 @@ export function pathRuleHeadOf(rule, bases) {
838
874
  const r = resolvePathPattern(rule.command, bases, rule.behavior);
839
875
  if ("missingBase" in r)
840
876
  return undefined;
841
- const parts = r.resolved.split("/");
842
- const wild = parts.findIndex((part) => part.includes("*"));
843
- head = (wild === -1 ? parts : parts.slice(0, wild)).join("/");
877
+ const segments = r.resolved.split("/").filter((sg) => sg !== "");
878
+ const wild = firstGlobSegment(segments, r.literal);
879
+ const lead = wild === -1 ? segments : segments.slice(0, wild);
880
+ head = lead.length === 0 ? "" : `${isUncIdentity(r.resolved) ? "//" : "/"}${lead.join("/")}`;
844
881
  }
845
882
  else
846
883
  return undefined;
@@ -1458,13 +1495,14 @@ export function adjudicatePersistedDomainRules(rules, call) {
1458
1495
  }
1459
1496
  return undefined;
1460
1497
  }
1461
- export function wholeToolRuleReaches(tool, call) {
1462
- return heldBy("policy.persistedToolRule", { has: (name) => name === tool }, call);
1498
+ export function wholeToolRuleReaches(tool, call, behavior) {
1499
+ const readsOtherServers = readsNameGlob(behavior) && peerReadingsOf(tool).length > 0;
1500
+ return heldBy("policy.persistedToolRule", { has: (name) => name === tool || (readsOtherServers && ruleNameCovers(tool, name)) }, call);
1463
1501
  }
1464
1502
  export function adjudicatePersistedToolRules(rules, call) {
1465
1503
  const at = { cwd: call.cwd, ...(call.sessionId !== undefined ? { sessionId: call.sessionId } : {}), ...(call.scopeIdentity !== undefined ? { scopeIdentity: call.scopeIdentity } : {}) };
1466
1504
  for (const behavior of RULE_BEHAVIORS_BY_PRECEDENCE) {
1467
- const row = rules.find((rule) => rule.match === "tool" && wholeToolRuleReaches(rule.tool, call.request) && eligiblePersisted(rule, { ...at, tool: rule.tool }, behavior));
1505
+ const row = rules.find((rule) => rule.match === "tool" && wholeToolRuleReaches(rule.tool, call.request, behavior) && eligiblePersisted(rule, { ...at, tool: rule.tool }, behavior));
1468
1506
  if (row !== undefined)
1469
1507
  return { behavior, rules: [row] };
1470
1508
  }
@@ -238,7 +238,7 @@ export interface ReadOrgRow {
238
238
  readonly behavior: "deny" | "ask";
239
239
  readonly parsed: ParsedRule;
240
240
  }
241
- /** One call as the org layer judges it: the rule words it answers to (`laneToolNamesOf`; one word is enough), its shell
241
+ /** One call as the org layer judges it: the rule words a tightening reaches it under (`ruleWordsOf`; one word is enough), its shell
242
242
  * command when it is the shell tool's, and the face of its path target when it has one (`callPathFaceOf`). */
243
243
  export interface OrgRuleCall {
244
244
  readonly tool: string | readonly string[];
@@ -2,6 +2,7 @@ import { escapeForDisclosure, isRuleBehavior, parseRuleText } from "./permission
2
2
  import { PERMISSION_RULE_WRITER, errText, isValidDurableScope, normalizePersistedRule, sameRuleIdentity, writerOf, } from "./permission-rule-store.js";
3
3
  import { readRuleOwner } from "./rule-owner.js";
4
4
  import { readPrincipal } from "./principal-name.js";
5
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
5
6
  import { UNGOVERNED_ORG_RESOLUTION, compileOrgShadowPredicate, createOrgRulePartition } from "./permission-rule-org.js";
6
7
  export function ruleSourceOf(scope) {
7
8
  return scope.kind === "global" ? "user" : scope.kind;
@@ -176,8 +177,10 @@ export async function effectiveOrThrow(store, query) {
176
177
  return view;
177
178
  }
178
179
  export async function effectivePermissionRules(opts) {
179
- return await resolveOwnerStore(opts).effective(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : undefined);
180
+ const o = receiveMembers(opts, { subject: "effectivePermissionRules options", unit: "option", moment: "at effectivePermissionRules" }, EFFECTIVE_RULES_OPTION_KEYS);
181
+ return await resolveOwnerStore(o).effective(o.sessionId !== undefined ? { sessionId: o.sessionId } : undefined);
180
182
  }
183
+ const EFFECTIVE_RULES_OPTION_KEYS = optionKeys()({ provider: 0, principal: 0, owner: 0, sessionId: 0 });
181
184
  export function resolveOwnerStore(opts) {
182
185
  const owner = opts.owner === undefined ? undefined : readRuleOwner(opts.owner);
183
186
  if (opts.owner !== undefined && owner === undefined) {
@@ -199,6 +199,10 @@ export interface PermissionRulePolicyOptions {
199
199
  * environment's home of the leg it enters the delegation chain on — and stays there for every child and every `cd`.
200
200
  * A declared value that is not an absolute path of its tree's family is refused at compile time
201
201
  * (`unsupported.path_base`, naming the base — {@link ruleBasesNeeded} is the same classification).
202
+ * A SETTINGS LAYER's rules are one rule set, the reference's reading of `/x` (the root of the layer the rule came from):
203
+ * `root` = the layer's root — the task root for a project or local layer, the configuration directory for a user layer —
204
+ * and `cwd` = the task root, since a relative pattern reads at the working directory whatever its layer (left out, it
205
+ * stands in at `root`). Rules of several layers merged into one set read every `/x` at that one set's root.
202
206
  * These are the RULES' anchors, never the call's: a call's target is read from the call (its target reading, else its
203
207
  * own `root` / `cwd`); only a host calling the policy directly with a request that carries neither has its target
204
208
  * resolved against `root` / `cwd` here. A target nothing locates is unreadable: every path rule able to reach the
@@ -3,8 +3,7 @@ import { MCP_NAMESPACE } from "./protocol-table.js";
3
3
  import { catalogRuleFaceOf, isShellFaceToolName, pathTargetOf } from "./tool-registry.js";
4
4
  import { HOST_UNREADABLE_SENTENCE, callHostTargetOf } from "./host-target.js";
5
5
  import { indexOfUnescaped, lastIndexOfUnescaped, parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
6
- import { callPathFaceOf, canonicalNameValue, COMMAND_RULE_TOOL, domainRuleAdmits, isUsablePathBase, laneToolNamesOf, mountedOnlyArgumentOf, mountedValueArmOf, NAME_RULE_FACES, nameRuleReach, nameRuleSubjectOf, nameValueAbsentReason, nameValuesUnreadReason, parseRuleText, PATH_RULE_BASE_LABEL, PATH_RULE_FACES, programRunReachOf, ruleBasesNeeded, ruleLaneOf, ruleShapeOf, shellRuleParamOf, ruleContentOf } from "./permission-rule-model.js";
7
- import { pathFamilyOf } from "../tools/fs/safety.js";
6
+ import { callPathFaceOf, canonicalNameValue, COMMAND_RULE_TOOL, domainRuleAdmits, ruleWordsOf, mountedOnlyArgumentOf, mountedValueArmOf, NAME_RULE_FACES, nameRuleReach, nameRuleSubjectOf, nameValueAbsentReason, nameValuesUnreadReason, parseRuleText, PATH_RULE_BASE_LABEL, PATH_RULE_FACES, programRunReachOf, ruleLaneOf, unusableDeclaredBase, ruleShapeOf, shellRuleParamOf, ruleContentOf } from "./permission-rule-model.js";
8
7
  import { callTargetReadingOf, callTargetViewsOf } from "./effective-path-target.js";
9
8
  import { DEFAULT_MAX_SCALAR_VALUE_CHARS, paramRuleReaches } from "./param-rule-reach.js";
10
9
  import { bindPathRules, judgeRuleRows, policyAnchors, rowsWhereTheyLead } from "./path-rule-binding.js";
@@ -209,11 +208,9 @@ function compile(rules, caps, primaryFieldGeneric, ruleFaces, pathBases = {}) {
209
208
  bad(text, "invalid.command_rule", `${parsedPath.reject.code}: ${parsedPath.reject.message}`);
210
209
  continue;
211
210
  }
212
- for (const base of ruleBasesNeeded(parsedPath.rule)) {
213
- const declared = base === "cwd" ? (pathBases.cwd ?? pathBases.root) : pathBases[base];
214
- if (declared !== undefined && !isUsablePathBase(declared, pathFamilyOf(pathBases))) {
215
- bad(text, "unsupported.path_base", `"${text}" is relative to ${PATH_RULE_BASE_LABEL[base]}, and the one this policy declares for it is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: `pathBases.${base === "cwd" && pathBases.cwd === undefined ? "root" : base}` });
216
- }
211
+ const unusable = unusableDeclaredBase(parsedPath.rule, pathBases);
212
+ if (unusable !== undefined) {
213
+ bad(text, "unsupported.path_base", `"${text}" is relative to ${PATH_RULE_BASE_LABEL[unusable.base]}, and the one this policy declares for it is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: `pathBases.${unusable.key}` });
217
214
  }
218
215
  if (issues.length > 0 && issues[issues.length - 1].rule === text && issues[issues.length - 1].code === "unsupported.path_base")
219
216
  continue;
@@ -332,6 +329,8 @@ export function createPermissionRulePolicy(rules, opts) {
332
329
  const heldFor = (table, req) => heldValues("policy.permissionRules", table, req);
333
330
  const coveringHit = (lane, req) => lane.length === 0 ? undefined : heldFor({ get: (name) => lane.find((r) => ruleNameCovers(r.ruleName, name)) }, req)[0];
334
331
  const hasCovering = namespacedCovering.deny.length > 0 || namespacedCovering.ask.length > 0;
332
+ const wholeToolDeny = (req) => entryFor(req)?.bare.deny ?? (hasCovering ? coveringHit(namespacedCovering.deny, req) : undefined);
333
+ const deniesWhole = namespacedCovering.deny.length > 0 || [...byTool.values()].some((e) => e.bare.deny !== undefined);
335
334
  const faceRules = {
336
335
  deny: [...byTool.values()].flatMap((e) => e.content.deny.filter((r) => r.faces !== undefined)),
337
336
  ask: [...byTool.values()].flatMap((e) => e.content.ask.filter((r) => r.faces !== undefined)),
@@ -462,20 +461,16 @@ export function createPermissionRulePolicy(rules, opts) {
462
461
  };
463
462
  return {
464
463
  nameSets: [nameSets],
464
+ ...(deniesWhole ? { wholeToolRefusals: () => Promise.resolve((tool) => wholeToolDeny(tool) !== undefined) } : {}),
465
465
  ...(pathSpecs.length > 0 ? { pathRules: (anchors) => boundAt(policyAnchors(pathBases, anchors)).rows } : {}),
466
466
  check(req) {
467
467
  const entry = entryFor(req);
468
468
  const covering = hasCovering;
469
- if (entry?.bare.deny) {
470
- return { action: "deny", message: ruleDenial(req, entry.bare.deny.ruleText, entry.bare.deny.source) };
471
- }
472
- if (covering) {
473
- const coveringDeny = coveringHit(namespacedCovering.deny, req);
474
- if (coveringDeny)
475
- return { action: "deny", message: ruleDenial(req, coveringDeny.ruleText, coveringDeny.source) };
476
- }
469
+ const whole = wholeToolDeny(req);
470
+ if (whole !== undefined)
471
+ return { action: "deny", message: ruleDenial(req, whole.ruleText, whole.source) };
477
472
  const callFace = faceRules.deny.length > 0 || faceRules.ask.length > 0 ? callPathFaceOf(req) : undefined;
478
- const shellCall = hasCommandRules && laneToolNamesOf(req).includes(COMMAND_RULE_TOOL);
473
+ const shellCall = hasCommandRules && ruleWordsOf(req, "deny").includes(COMMAND_RULE_TOOL);
479
474
  const denyLane = contentLaneOf("deny", entry, shellCall, callFace);
480
475
  const contentDeny = denyLane.length > 0 ? contentHit(denyLane, req) : undefined;
481
476
  if (contentDeny !== undefined && contentDeny.unreadable === undefined) {
@@ -7,8 +7,8 @@
7
7
  * transport writes itself (an MCP request's session, protocol version, content type, accept and resume headers) is the
8
8
  * protocol's: neither a seat's answer nor the principal header owns it. The hosted-connector assertion header
9
9
  * ({@link MCP_ASSERTION_HEADER}) is the seat's to answer and never the principal header's name. A header the credential
10
- * vocabulary reads as a credential is one the engine holds from the moment it resolves it: no child spawned on this host
11
- * inherits a variable whose value equals it (`holdOwnCredentialValues`, src/core/secret-env.ts).
10
+ * vocabulary reads as a credential is one the engine holds from the moment the seat answers it, before the answer is judged
11
+ * (the carrier's one intake, src/core/peer-seat.ts): no child spawned on this host inherits a variable whose value equals it.
12
12
  *
13
13
  * A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
14
14
  * peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
@@ -54,6 +54,8 @@ export declare function resolveProtocolHttpHeaders(protocol: ProtocolId, t: Prot
54
54
  /** The engine's default request headers under the declared ones: a declared name, in any case, owns that header
55
55
  * (the default of the same name is not sent beside it). */
56
56
  export declare function underDeclaredHeaders(defaults: Readonly<Record<string, string>>, declared: Record<string, string> | undefined): Record<string, string>;
57
+ /** A header value as the transport sends it: the HTTP whitespace at its two edges is not part of the value (WHATWG `Headers`). */
58
+ export declare const httpTrimmed: (value: string) => string;
57
59
  /**
58
60
  * A peer's error text with what the peer was SENT taken out of it. Both kinds of removal are found on the ORIGINAL text (so no marker is
59
61
  * rescanned and no replacement can disturb what another one reads) and the ranges they take are merged, one marker per merged range: every
@@ -69,6 +71,16 @@ export declare function underDeclaredHeaders(defaults: Readonly<Record<string, s
69
71
  * whole marker with it, so the pass over its own output answers the same text.
70
72
  */
71
73
  export declare function scrubRequestEcho(text: string, declared: readonly string[]): string;
74
+ /**
75
+ * A remote's own account of itself read without the credentials its connection's requests carried — THE one eraser of what a successful
76
+ * dial or listing hands the engine (an MCP server's `serverInfo`, instructions and tool listing; an A2A peer's card). The needle is
77
+ * `credentials` (the connection's credential values, `PeerCarrier.credentials`): every occurrence of one, in any spelling the
78
+ * request-echo derivation gives it ({@link requestEchoSpellings}) and in any letter case, becomes the redaction mark in place, the way
79
+ * {@link scrubRequestEcho} takes a declared value out of a failure's words. Nothing else is taken — no Cookie member, no vocabulary
80
+ * guess: the rest of the text is the remote's own account, and only the needle is the engine's to withhold. A text with no needle in it
81
+ * is returned as it was (the same string). The function is a fixed point.
82
+ */
83
+ export declare function eraseSentCredentials(text: string, credentials: readonly string[]): string;
72
84
  /**
73
85
  * THE one form a remote endpoint's words take when the engine carries them in its own words — an MCP server's failure, a model
74
86
  * provider's error body, frame or transport failure, a memory distiller seat's failure: what the request was declared with
@@ -1,4 +1,4 @@
1
- import { authSchemeCredentials, credentialHeaderValues, holdOwnCredentialValues } from "./secret-env.js";
1
+ import { authSchemeCredentials } from "./secret-env.js";
2
2
  import { egressText } from "./untrusted-egress.js";
3
3
  import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
4
4
  import { inlineUntrusted } from "./untrusted-text.js";
@@ -30,7 +30,6 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
30
30
  const principalHeader = t.principalHeader;
31
31
  const answered = t.headers;
32
32
  const own = { ...(answered !== undefined ? { headers: { ...answered } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) };
33
- holdOwnCredentialValues(credentialHeaderValues(own.headers));
34
33
  const collision = headerOwnershipCollision(own, protocol);
35
34
  if (collision !== undefined) {
36
35
  const problem = collision.engineOwned
@@ -49,7 +48,7 @@ export function underDeclaredHeaders(defaults, declared) {
49
48
  const owned = new Set(Object.keys(declared ?? {}).map((k) => k.toLowerCase()));
50
49
  return { ...Object.fromEntries(Object.entries(defaults).filter(([k]) => !owned.has(k.toLowerCase()))), ...declared };
51
50
  }
52
- const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
51
+ export const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
53
52
  function percentEncoded(value) {
54
53
  try {
55
54
  return encodeURIComponent(value);
@@ -105,7 +104,14 @@ function structuredEnd(text, at) {
105
104
  return text.length;
106
105
  }
107
106
  export function scrubRequestEcho(text, declared) {
108
- const removed = requestEchoRanges(text, declared);
107
+ return markedOver(text, requestEchoRanges(text, declared));
108
+ }
109
+ export function eraseSentCredentials(text, credentials) {
110
+ if (credentials.length === 0 || text === "")
111
+ return text;
112
+ return markedOver(text, needleRanges(text, credentials, []));
113
+ }
114
+ function markedOver(text, removed) {
109
115
  if (removed.length === 0)
110
116
  return text;
111
117
  removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
@@ -122,13 +128,16 @@ export function scrubRequestEcho(text, declared) {
122
128
  return out + text.slice(kept);
123
129
  }
124
130
  function requestEchoRanges(text, declared) {
131
+ const members = cookieMembers(text);
132
+ return [...members.map(([, from, end]) => [from, end]), ...needleRanges(text, declared, members)];
133
+ }
134
+ function needleRanges(text, values, members) {
125
135
  const forms = new Set();
126
- for (const value of declared)
136
+ for (const value of values)
127
137
  for (const spelling of requestEchoSpellings(value))
128
138
  forms.add(spelling);
129
139
  forms.delete("");
130
- const members = cookieMembers(text);
131
- const removed = members.map(([, from, end]) => [from, end]);
140
+ const removed = [];
132
141
  const markers = redactionMarkerSpans(text);
133
142
  for (const hit of valueHits(text, [...forms])) {
134
143
  if (members.some(([name, from]) => hit[0] >= name && hit[1] <= from))
@@ -12,8 +12,8 @@ import { type ReadDenyEntry } from "../tools/fs/index.js";
12
12
  * into meaningless one-character entries with zero refusal. Garbage must refuse loudly at the door,
13
13
  * never be consumed letter by letter. */
14
14
  export declare function assertStringArraySeat(value: unknown, seat: string, entryLaw: "strings" | "compiler-owned"): void;
15
- /** The three DEPLOYMENT read-deny seats. */
16
- export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"];
15
+ /** The four DEPLOYMENT read-deny seats: the table's three, and whether the deployment requires the byte floor kept. */
16
+ export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"];
17
17
  export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number];
18
18
  /**
19
19
  * The copy a read-deny seat keeps of its declared value — the one copy law of both doors that admit one (`new Runner`
@@ -24,7 +24,9 @@ export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number]
24
24
  export declare function copyReadDenySeat(value: unknown): unknown;
25
25
  /**
26
26
  * Screen one deployment read-deny seat's value with the laws a prepare applies to it (the array door and the
27
- * one compiler's entry law for the additions; the built-in table's tier / row-name law for the other two) and
28
- * return a copy; `undefined` stays `undefined` (no declaration).
27
+ * one compiler's entry law for the additions; the built-in table's tier / row-name law for the next two; a boolean
28
+ * for the floor requirement) and return a copy; `undefined` stays `undefined` (no declaration — for the requirement,
29
+ * the documented reading "not required", under which an unkept floor is still announced).
29
30
  */
30
- export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | undefined;
31
+ export declare function screenReadDenySeat(seat: "readDenyFloorRequired", value: unknown): boolean | undefined;
32
+ export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | boolean | undefined;
@@ -1,4 +1,5 @@
1
1
  import { compileReadDeny, readDenyBuiltinConfigOf } from "../tools/fs/index.js";
2
+ import { screenReadDenyFloorRequired } from "../tools/fs/read-floor.js";
2
3
  export function assertStringArraySeat(value, seat, entryLaw) {
3
4
  if (value === undefined)
4
5
  return;
@@ -18,7 +19,7 @@ export function assertStringArraySeat(value, seat, entryLaw) {
18
19
  }
19
20
  }
20
21
  }
21
- export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"]);
22
+ export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"]);
22
23
  export function copyReadDenySeat(value) {
23
24
  if (!Array.isArray(value))
24
25
  return value;
@@ -27,6 +28,8 @@ export function copyReadDenySeat(value) {
27
28
  export function screenReadDenySeat(seat, value) {
28
29
  if (value === undefined)
29
30
  return undefined;
31
+ if (seat === "readDenyFloorRequired")
32
+ return screenReadDenyFloorRequired(value, `RunnerDeps.${seat}`);
30
33
  if (seat === "readDenyPatterns") {
31
34
  assertStringArraySeat(value, `RunnerDeps.${seat}`, "compiler-owned");
32
35
  const entries = copyReadDenySeat(value);
@@ -1,12 +1,13 @@
1
1
  /** The marks, by what they stand for. `whole` is the bare mark (a span removed whole — a credential value, a floor, a
2
2
  * depth cut); the others name the shape that was withheld: `credentials` a URL's userinfo, `url` a whole URL, `path` an
3
- * absolute filesystem path. A mark the engine writes is exactly one of these four. */
4
- export declare const REDACTION_MARKS: {
3
+ * absolute filesystem path. A mark the engine writes is exactly one of these four. Frozen: the table is exported to hosts, and every
4
+ * pass reads it at call time, so a write by a reader would change what the engine writes. */
5
+ export declare const REDACTION_MARKS: Readonly<{
5
6
  readonly whole: "[redacted]";
6
7
  readonly credentials: "[redacted-credentials]";
7
8
  readonly url: "[redacted-url]";
8
9
  readonly path: "[redacted-path]";
9
- };
10
+ }>;
10
11
  /** The bare mark — what a host compares against to tell that the engine withheld a value. */
11
12
  export declare const REDACTION_MARK: "[redacted]";
12
13
  /** Where the marks sit in `s`, one [start, end) span at a time, leftmost first. Lazy: a reader that stops early (a display cut stops
@@ -1,9 +1,9 @@
1
- export const REDACTION_MARKS = {
1
+ export const REDACTION_MARKS = Object.freeze({
2
2
  whole: "[redacted]",
3
3
  credentials: "[redacted-credentials]",
4
4
  url: "[redacted-url]",
5
5
  path: "[redacted-path]",
6
- };
6
+ });
7
7
  export const REDACTION_MARK = REDACTION_MARKS.whole;
8
8
  const escapeLiteral = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
9
9
  const REDACTION_MARKER_RE = new RegExp(Object.values(REDACTION_MARKS).map(escapeLiteral).join("|"), "g");