@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -92,6 +92,7 @@ function syntheticCheckpoint(scope, fidelity) {
92
92
  batchToolCallIds: [`${scope}:call`],
93
93
  completedCallIds: [],
94
94
  },
95
+ heldRows: [{ role: "user", content: [{ type: "text", text: "park wiring self-check held row" }], timestamp: 0, provenance: "engine-note", rewrittenBy: ["park-selfcheck"] }],
95
96
  state: { activeTools: ["SelfCheck"], nestedStats: { tokens: 0, turns: 0, tasks: 0, costMicroUsd: 0, anyUnpriced: false } },
96
97
  status: "pending",
97
98
  createdAt: Date.now(),
@@ -99,7 +100,7 @@ function syntheticCheckpoint(scope, fidelity) {
99
100
  suspendedAt: Date.now(),
100
101
  resourceLedger: { spentMicroUsd: 0, spentTokens: 0, spentTurns: 0, sliceCount: 1 },
101
102
  humanReview: { count: 1, totalWaitMs: 0, gates: [{ kind: "human", waitMs: 0, decision: "approve", toolName: "SelfCheck", toolCallId: `${scope}:selfcheck-call`, toolArg: "park self-check probe" }] },
102
- sourceTaskId: `${scope}:task`,
103
+ sourceSessionId: `${scope}:session`,
103
104
  principal: `${scope}:principal`,
104
105
  durableApproval: { scope, ttlMs: PARK_SELFCHECK_ROW_TTL_MS },
105
106
  deadline: Date.now() + PARK_SELFCHECK_ROW_TTL_MS,
@@ -112,6 +113,7 @@ function faithfulnessDelta(sent, got) {
112
113
  scope: cp.scope,
113
114
  sessionId: cp.sessionId,
114
115
  leafId: cp.leafId,
116
+ heldRows: cp.heldRows,
115
117
  gate: cp.gate,
116
118
  pendingAction: cp.pendingAction,
117
119
  state: cp.state,
@@ -124,7 +126,7 @@ function faithfulnessDelta(sent, got) {
124
126
  suspendedAt: cp.suspendedAt,
125
127
  resourceLedger: cp.resourceLedger,
126
128
  humanReview: cp.humanReview,
127
- sourceTaskId: cp.sourceTaskId,
129
+ sourceSessionId: cp.sourceSessionId,
128
130
  principal: cp.principal,
129
131
  durableApproval: cp.durableApproval,
130
132
  });
@@ -22,5 +22,16 @@ export type ChainHopsReading = {
22
22
  * cannot answer not vote ({@link chainHopsOrNone}), an allow admits nothing it could not see.
23
23
  */
24
24
  export declare function symlinkChainHops(env: ExecutionEnv, path: string, signal: AbortSignal | undefined, family: PathFamily, baseCwd?: string): Promise<ChainHopsReading>;
25
+ /**
26
+ * Whether a target's leaf chain can hold a hop, once the environment said where the target lands: a link may be on the way
27
+ * when what was walked climbs a `..` (the lexical fold of `..` across a linked parent names another file than the one the
28
+ * filesystem walks to) or when the reader cannot say the target landed at its own lexical spelling (`landedElsewhere`: a
29
+ * link resolved elsewhere, or a resolution that rejoined a missing tail as spelled — the leaf may be a link whose target is
30
+ * not there yet). Where neither holds nothing on the way is a link, and the chain is not asked. The readers that skip the chain where no
31
+ * link can be on the way take this one gate before {@link symlinkChainHops}: a call's target views (`readPath`) and the shell read
32
+ * station's establishment. The write-protection table and the sensitive-path deny set do not: they read the chain whenever one of
33
+ * their rows can hear a hop.
34
+ */
35
+ export declare function leafChainMayHold(walked: readonly (string | undefined)[], landedElsewhere: boolean, family: PathFamily): boolean;
25
36
  /** A path guard's reading of a chain: the hops, or none — a view that cannot answer does not vote (its absence law). */
26
37
  export declare function chainHopsOrNone(reading: ChainHopsReading): readonly string[];
@@ -13,6 +13,10 @@ export async function symlinkChainHops(env, path, signal, family, baseCwd) {
13
13
  const chain = await env.canonicalChain(target, signal);
14
14
  return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: chain.error.message, asked: true };
15
15
  }
16
+ export function leafChainMayHold(walked, landedElsewhere, family) {
17
+ const climbs = family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/;
18
+ return landedElsewhere || walked.some((s) => s !== undefined && climbs.test(s));
19
+ }
16
20
  export function chainHopsOrNone(reading) {
17
21
  return reading.ok ? reading.hops : [];
18
22
  }
@@ -35,7 +35,9 @@ export declare function bindPathRules<S extends PathRuleSpec>(specs: readonly S[
35
35
  * alone. */
36
36
  export declare function policyAnchors(declared: PathRuleBases, install: PathRuleBases | undefined): PathRuleBases;
37
37
  /** A stored row's anchors: a PROJECT row's `/x` and relative words at the row's own scope root (the project it was written
38
- * for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. */
38
+ * for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. A row has no seat for a
39
+ * settings layer's own directory, so the settings import carries only the rules a row reads the way their layer does — a
40
+ * user layer's `/x`, read there at the configuration directory, stays in its file (`prepareCcImport`). */
39
41
  export declare function persistedRowAnchors(scope: RuleScope, chainTop: PathRuleBases): PathRuleBases;
40
42
  /** A leg's root as an identity for project coverage ({@link ScopeRootIdentity}): its canonical root, and each project
41
43
  * row's scope root resolved through the leg's resolution (`leads`, each location once per leg) — so a row written under
@@ -1,5 +1,5 @@
1
1
  import { parsePermissionRule } from "./permission-rule-syntax.js";
2
- import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, ruleBasesNeeded } from "./permission-rule-model.js";
2
+ import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, pathRuleReachShapeOf, ruleBasesNeeded } from "./permission-rule-model.js";
3
3
  import { pathFamilyOf, spellingOfIdentity } from "../tools/fs/safety.js";
4
4
  import { absoluteTargetIdentityOf } from "./effective-path-target.js";
5
5
  import { locationLeadsTo, ruleHeadParts } from "../tools/fs/read-deny.js";
@@ -12,6 +12,7 @@ export function bindPathRules(specs, anchors) {
12
12
  const a = typeof anchors === "function" ? anchors(spec) : anchors;
13
13
  const family = pathFamilyOf(a);
14
14
  const head = pathRuleHeadOf(spec.parsed, a);
15
+ const shape = pathRuleReachShapeOf(spec.parsed, a);
15
16
  const unanchored = ruleBasesNeeded(spec.parsed).filter((b) => !isUsablePathBase(b === "cwd" ? (a.cwd ?? a.root) : a[b], family));
16
17
  const reach = (absolutePath) => {
17
18
  const tree = a.root !== undefined || a.cwd !== undefined ? a : { root: absolutePath };
@@ -28,6 +29,7 @@ export function bindPathRules(specs, anchors) {
28
29
  reach,
29
30
  reaches: (absolutePath) => reach(absolutePath).reach !== "not_reached",
30
31
  ...(head !== undefined ? { head: spellingOfIdentity(head, family) } : {}),
32
+ ...(shape !== undefined && (a.root !== undefined || a.cwd !== undefined) ? { reachShape: shape } : {}),
31
33
  ...(unanchored.length > 0 ? { unanchored } : {}),
32
34
  };
33
35
  });
@@ -1,4 +1,4 @@
1
- import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
1
+ import { SdkHttpError } from "@modelcontextprotocol/client";
2
2
  import { type CredentialRef } from "@sema-agent/primitives";
3
3
  import { type McpServerSpec, type McpTransportKind } from "./mcp-server-spec.js";
4
4
  import type { ProtocolId } from "./protocol-table.js";
@@ -121,7 +121,7 @@ export declare class PeerSeatFailure extends Error {
121
121
  /**
122
122
  * An MCP HTTP request the endpoint refused for its authorization — a 401, or a 403 whose Bearer challenge says `insufficient_scope`
123
123
  * (RFC 6750 §3.1) — raised by the one fetch ({@link peerFetch}) in place of the SDK's status error, which keeps no header. It IS the
124
- * SDK's status error (same class, same `code`), so every structural reader of a status reads it unchanged; it adds what the response
124
+ * SDK's status error (same class, same `status`), so every structural reader of a status reads it unchanged; it adds what the response
125
125
  * said and what the re-ask after a 401 answered:
126
126
  * · `reason` — `rejected` (401) or `scope` (403);
127
127
  * · `resourceMetadataUrl` — the Bearer challenge's `resource_metadata` ({@link bearerChallengeParams}), the REMOTE's claim, read by
@@ -133,7 +133,7 @@ export declare class PeerSeatFailure extends Error {
133
133
  * The text is the engine's sentence followed by the response body as the SDK's own error would have carried it (bounded to
134
134
  * {@link REFUSAL_BODY_MAX} characters) — REMOTE text, read by every face through the one remote-words reading like any status body.
135
135
  */
136
- export declare class PeerAuthorizationRefused extends StreamableHTTPError {
136
+ export declare class PeerAuthorizationRefused extends SdkHttpError {
137
137
  readonly reason: "rejected" | "scope";
138
138
  readonly resourceMetadataUrl: string | undefined;
139
139
  readonly authorizeUrl: string | undefined;
@@ -1,9 +1,10 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { types } from "node:util";
3
- import { StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
3
+ import { SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
4
4
  import { canonicalize } from "./canonical-json.js";
5
5
  import { readCredentialRef } from "@sema-agent/primitives";
6
6
  import { callerText } from "./mcp-server-spec.js";
7
+ import { optionKeys, strayMembersOf } from "./own-property-receipt.js";
7
8
  import { readMember, readOwnMembers } from "./thrown-value.js";
8
9
  import { httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
9
10
  import { credentialHeaderValues, holdOwnCredentialValues, isSecretEnvKey, namesASecret } from "./secret-env.js";
@@ -141,14 +142,15 @@ export class PeerSeatFailure extends Error {
141
142
  this.code = extra?.code ?? (reason === "answer_invalid" ? "config.peer_answer_invalid" : undefined);
142
143
  }
143
144
  }
144
- export class PeerAuthorizationRefused extends StreamableHTTPError {
145
+ export class PeerAuthorizationRefused extends SdkHttpError {
145
146
  reason;
146
147
  resourceMetadataUrl;
147
148
  authorizeUrl;
148
149
  renewed;
149
150
  constructor(reason, facts) {
150
151
  const lead = reason === "rejected" ? "the endpoint refused the request's authorization (HTTP 401)" : "the endpoint refused the request for insufficient scope (HTTP 403)";
151
- super(reason === "rejected" ? 401 : 403, facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead);
152
+ const text = facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead;
153
+ super(reason === "rejected" ? SdkErrorCode.ClientHttpAuthentication : SdkErrorCode.ClientHttpForbidden, text, { status: reason === "rejected" ? 401 : 403 });
152
154
  this.name = "PeerAuthorizationRefused";
153
155
  this.reason = reason;
154
156
  this.resourceMetadataUrl = facts.resourceMetadataUrl;
@@ -172,7 +174,10 @@ const VALUE_LAW = Object.freeze({
172
174
  headers: Object.freeze({ refuses: /[^\t\x20-\x7e\x80-\xff]/, holds: "a character an HTTP header value cannot carry" }),
173
175
  env: Object.freeze({ refuses: /[\r\n\0]|\p{Surrogate}/u, holds: "a line break, a NUL or a lone surrogate" }),
174
176
  });
175
- const ANSWER_MEMBERS = { carry: ["kind", "headers", "env", "expiresAt"], unauthorized: ["kind", "authorizeUrl"] };
177
+ const ANSWER_MEMBERS = Object.freeze({
178
+ carry: optionKeys()({ kind: 0, headers: 0, env: 0, expiresAt: 0 }),
179
+ unauthorized: optionKeys()({ kind: 0, authorizeUrl: 0 }),
180
+ });
176
181
  const digestOf = (pieces) => {
177
182
  const rows = (m) => Object.entries(m ?? {}).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
178
183
  return createHash("sha256").update(JSON.stringify([rows(pieces.headers), rows(pieces.env)])).digest("hex");
@@ -210,9 +215,9 @@ export function readPeerAnswer(raw, lane) {
210
215
  const kind = memberOf("kind");
211
216
  if (kind !== "carry" && kind !== "unauthorized")
212
217
  return { problem: `answered the kind ${inlineUntrusted(JSON.stringify(kind) ?? String(kind), 80)}, which is neither "carry" nor "unauthorized"` };
213
- const extra = Object.keys(record).find((key) => !ANSWER_MEMBERS[kind].includes(key));
218
+ const extra = strayMembersOf(record, { subject: "the peer seat's answer", unit: "member", moment: "when the answer is read" }, ANSWER_MEMBERS[kind])?.names[0];
214
219
  if (extra !== undefined)
215
- return { problem: `answered the member ${inlineUntrusted(JSON.stringify(extra), 80)}, which a "${kind}" answer does not have` };
220
+ return { problem: `answered the member ${inlineUntrusted(JSON.stringify(String(extra)), 80)}, which a "${kind}" answer does not have` };
216
221
  if (kind === "unauthorized") {
217
222
  const given = memberOf("authorizeUrl");
218
223
  if (given === undefined)
@@ -480,7 +485,7 @@ export function peerFetch(carrier, principalHeader, principal) {
480
485
  return res;
481
486
  const challenge = bearerChallengeParams(res.headers.get("www-authenticate"));
482
487
  if (res.status === 403 && challenge?.get("error") !== "insufficient_scope")
483
- return res;
488
+ return unchallenged(res);
484
489
  const resourceMetadataUrl = authorizationUrlOf(challenge?.get("resource_metadata"));
485
490
  const body = init?.method === "POST" ? await bodyHead(res, REFUSAL_BODY_MAX) : void (await res.body?.cancel().catch(() => undefined));
486
491
  const reask = res.status === 401 ? await carrier.rejected(pieces, signal) : undefined;
@@ -492,6 +497,13 @@ export function peerFetch(carrier, principalHeader, principal) {
492
497
  });
493
498
  };
494
499
  }
500
+ function unchallenged(res) {
501
+ if (!res.headers.has("www-authenticate"))
502
+ return res;
503
+ const headers = new Headers(res.headers);
504
+ headers.delete("www-authenticate");
505
+ return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
506
+ }
495
507
  export const RETIRED_VALUE_MEMBERS = Object.freeze({ mcp: Object.freeze([Object.freeze(["transport", "headers"]), Object.freeze(["transport", "env"])]), a2a: Object.freeze([Object.freeze(["headers"])]) });
496
508
  export function retiredValueMember(copy, at) {
497
509
  for (const path of RETIRED_VALUE_MEMBERS[at]) {
@@ -535,7 +547,7 @@ export function mcpPeerTarget(spec, kind) {
535
547
  export function answeredUnauthorized(err) {
536
548
  let at = err;
537
549
  for (let depth = 0; depth < 6 && at instanceof Error; depth++) {
538
- if (at instanceof StreamableHTTPError && at.code === 401)
550
+ if (at instanceof SdkHttpError && at.status === 401)
539
551
  return true;
540
552
  at = at.cause;
541
553
  }
@@ -546,14 +546,22 @@ export declare function redeemRuleTicket(opts: {
546
546
  export declare const IMPORTED_SETTINGS_LAYERS: readonly ["userSettings", "projectSettings", "localSettings"];
547
547
  /** The three user-editable settings layers this version reads. */
548
548
  export type ImportedSettingsLayer = (typeof IMPORTED_SETTINGS_LAYERS)[number];
549
- /** One layer to read. `root` is the canonical directory a project-layer rule is scoped to — taken from
550
- * where the FILE actually lives, since the local layer is not always at a repository root. */
551
- export interface CcImportLayer {
552
- layer: ImportedSettingsLayer;
549
+ /** One layer to read — a union by `layer`, so a member is present exactly where it is read. A project or local layer
550
+ * carries `root`: the canonical directory its rules are scoped to, taken from where the FILE actually lives, since the
551
+ * local layer is not always at a repository root. The user layer carries none — a root handed for it does not compile:
552
+ * its rules import as global rules, which read `/x` at each task's project root, so nothing here reads that layer's own
553
+ * directory, and an entry written against it stays in the settings file ({@link prepareCcImport}). */
554
+ export type CcImportLayer = {
555
+ layer: "userSettings";
556
+ path: string;
557
+ root?: never;
558
+ readFile: (path: string) => Promise<string | undefined>;
559
+ } | {
560
+ layer: Exclude<ImportedSettingsLayer, "userSettings">;
553
561
  path: string;
554
562
  root: string;
555
563
  readFile: (path: string) => Promise<string | undefined>;
556
- }
564
+ };
557
565
  /**
558
566
  * What the import WOULD do, shown before anyone confirms.
559
567
  *
@@ -627,6 +635,14 @@ export type RedeemedBatchMember = {
627
635
  * being escorted by a shell into a bare tool-name ask that widens `Bash(rm -r:*)` into "every Bash call
628
636
  * asks". An entry that does not import (a spelling with no rule form, a tool the lane does not speak
629
637
  * for, a non-string) is DISCLOSED in `skipped` with its reason and stays in the settings file.
638
+ *
639
+ * Only a rule the store reads the way its layer does is carried. A bare tool name is not (`unsupported.form`), and
640
+ * neither is a user-layer path pattern written from `/` (`unsupported.layer_root`, every behavior): the user layer reads
641
+ * it at its own directory (the configuration directory), a stored global rule reads `/x` at each task's project root, and
642
+ * no stored row has a seat for the layer's directory. `//abs`, `~/`, relative and non-path entries of the user layer carry
643
+ * as global rules; a project or local layer's `/x` carries, scoped to that layer's `root` (a project row reads `/x` there).
644
+ * A user layer handed a `root` refuses the whole call before any layer is read (`config.invalid_argument`, `detail.field`
645
+ * `layers[<i>].root`; the value is not echoed).
630
646
  */
631
647
  export declare function prepareCcImport(opts: {
632
648
  layers: CcImportLayer[];
@@ -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,8 +786,22 @@ 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
807
  const layers = [];
@@ -860,6 +876,10 @@ export async function prepareCcImport(opts) {
860
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" });
861
877
  continue;
862
878
  }
879
+ if (!importCarries(scope, parsed.rule)) {
880
+ skipped.push({ rule: entry, reason: LAYER_ROOT_SKIP_REASON });
881
+ continue;
882
+ }
863
883
  if (candidates.some((c) => c.behavior === behavior && c.rule === parsed.rule.rule && sameScope(c.scope, scope)))
864
884
  continue;
865
885
  candidates.push({ behavior, rule: parsed.rule.rule, scope });
@@ -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"
@@ -10,7 +10,7 @@ import { carriesShellRedirection, parseLeadingCommandName, splitShellCompoundSeg
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
  }
@@ -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;
@@ -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