@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
@@ -1,9 +1,12 @@
1
1
  import { randomBytes, randomUUID } from "node:crypto";
2
2
  import { uuidv7 } from "../internal/harness.js";
3
- import { PROBE_CAUSE_PATH_MAX, PROBE_REASON_MAX, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
3
+ import { PROBE_REASON_MAX, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
4
+ import { CheckpointError, checkpointVersionOf, isPlainRecord, normalizeProbeCause, safeDataValue } from "./checkpoint-features.js";
5
+ import { judgeCheckpointRow, retiredSteerSeatRefusal } from "./checkpoint-row-verdict.js";
4
6
  import { carriesBidiControls } from "./tool-policy.js";
7
+ import { agentIdOf, legTaskIdOf } from "./leg-identity.js";
5
8
  import { isAutoModeFallbackCause, readDenialLimitFallback } from "./auto-mode.js";
6
- import { isAskOrigin, isPermissionMode, isPersistedRuleMandate } from "./ask-origin.js";
9
+ import { isAskOrigin, isPersistedRuleMandate } from "./ask-origin.js";
7
10
  import { isRunOrigin, RUN_ORIGINS } from "./run-origin.js";
8
11
  import { describeRejectedValue } from "./tool-search-setting.js";
9
12
  import { readBoundBinding } from "./skill-grant-binding.js";
@@ -15,7 +18,8 @@ import { renderUntrustedCommandText, stripFormatCharacters } from "./permission-
15
18
  import { egressText } from "./untrusted-egress.js";
16
19
  import { steerReplayRefusal } from "./steer-replay.js";
17
20
  import { readRetentionDeclaration } from "./retention.js";
18
- import { receiveOptions } from "./own-property-receipt.js";
21
+ import { memberPresent, optionKeys, receiveOptions } from "./own-property-receipt.js";
22
+ export { BINDING_CHECKPOINT_VERSION, CHECKPOINT_CONFIG_REFUSAL_CODES, CHECKPOINT_FEATURES, CheckpointError, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, encodeAtFidelity, F012_CHECKPOINT_VERSION, FACE_CHECKPOINT_VERSION, isCheckpointConfigRefusalCode, isPlainRecord, MAX_SUPPORTED_CHECKPOINT_VERSION, normalizeProbeCause, ORG_ADMISSION_CHECKPOINT_VERSION, REAL_APPROVAL_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, safeDataValue, TOKEN_CHECKPOINT_VERSION, } from "./checkpoint-features.js";
19
23
  export function mintCheckpointToken() {
20
24
  return randomBytes(16).toString("hex");
21
25
  }
@@ -23,37 +27,6 @@ export function mintCheckpointId() {
23
27
  return `cp_${randomUUID()}`;
24
28
  }
25
29
  export { PROBE_REASON_MAX } from "./untrusted-text.js";
26
- const PROBE_CAUSE_MAX_SHOWN = 8;
27
- export function normalizeProbeCause(value) {
28
- if (!isPlainRecord(value))
29
- return undefined;
30
- const code = safeDataValue(value, "code");
31
- if (typeof code !== "string" || code.trim().length === 0)
32
- return undefined;
33
- const family = (raw) => {
34
- if (!isPlainRecord(raw))
35
- return undefined;
36
- const shownRaw = safeDataValue(raw, "shown");
37
- if (!Array.isArray(shownRaw))
38
- return undefined;
39
- const shown = shownRaw
40
- .filter((p) => typeof p === "string")
41
- .slice(0, PROBE_CAUSE_MAX_SHOWN)
42
- .map((p) => inlineUntrusted(p, PROBE_CAUSE_PATH_MAX));
43
- const totalRaw = safeDataValue(raw, "total");
44
- const total = typeof totalRaw === "number" && Number.isFinite(totalRaw) ? Math.max(0, Math.floor(totalRaw)) : shown.length;
45
- return { shown, total: Math.max(total, shown.length) };
46
- };
47
- const roots = family(safeDataValue(value, "roots"));
48
- if (roots === undefined)
49
- return undefined;
50
- const further = family(safeDataValue(value, "further"));
51
- return {
52
- code: inlineUntrusted(code, PROBE_REASON_MAX),
53
- roots,
54
- ...(further !== undefined && further.total > 0 ? { further } : {}),
55
- };
56
- }
57
30
  export function riskSeverity(axes) {
58
31
  return readRiskAxes(axes).tier;
59
32
  }
@@ -83,26 +56,6 @@ export const MAX_PENDING_STEER_CHARS = 16_000;
83
56
  export const PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES = 48_000;
84
57
  export const MAX_PENDING_STEER_ENTRIES = Math.floor(PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES / MAX_PENDING_STEER_CHARS);
85
58
  export const PENDING_STEER_FROZEN_FIELDS = Object.freeze(["text", "trusted", "actor", "seq", "inputId", "priority", "runOrigin"]);
86
- export function isPlainRecord(x) {
87
- try {
88
- if (x === null || typeof x !== "object" || Array.isArray(x))
89
- return false;
90
- const p = Object.getPrototypeOf(x);
91
- return p === Object.prototype || p === null;
92
- }
93
- catch {
94
- return false;
95
- }
96
- }
97
- export function safeDataValue(obj, key) {
98
- try {
99
- const d = Object.getOwnPropertyDescriptor(obj, key);
100
- return d && "value" in d ? d.value : undefined;
101
- }
102
- catch {
103
- return undefined;
104
- }
105
- }
106
59
  function safeKeys(obj) {
107
60
  try {
108
61
  return Object.keys(obj);
@@ -196,29 +149,6 @@ export function realApprovalOrgFact(bit) {
196
149
  return bit.org;
197
150
  return bit.origin === "org_rule" ? "rule" : bit.origin === "org_unavailable" ? "unavailable" : undefined;
198
151
  }
199
- export const CHECKPOINT_FEATURES = {
200
- baseline: { version: 1, introduced: "design/49", writes: "the row itself" },
201
- resource: { version: 2, introduced: "design/74", writes: "resourceLedger; gate/pendingAction kind resource_limit" },
202
- binding: { version: 3, introduced: "design/80", writes: "pendingAction.boundCallId + boundInputHash on a tool_approval; a plan_review carries the stamp only" },
203
- token: { version: 5, introduced: "design/164", writes: "resourceLedger.totalTokens" },
204
- orgAdmission: { version: 6, introduced: "org-admission", writes: "inheritedGate.admittedOrgScopes / ownAdmittedOrgScopes / ownAdmittedOrgWriteScope / orgAdmissionGoverned" },
205
- f012: { version: 7, introduced: "F-012", writes: "inheritedGate.constraintChain + constraintDigest together; delegationProvenance" },
206
- realApproval: { version: 8, introduced: "#130/#120", writes: "gate.realApproval (a well-formed bit) + pendingAction.requiresRealApproval; from v9: readFace.realApproval = true beside it" },
207
- face: { version: 9, introduced: "design/199", writes: "state.readFace { face, denyEntries? } for a non-default posture; realApproval: true only at the mint whose gate carries the bit (a hands-less re-park never carries the seed's marker forward)" },
208
- requirements: { version: 10, introduced: "#1320", writes: "requires (the row's words) + requirementsDigest (the row digest), both derived from its content (checkpoint-requirements.ts)" },
209
- };
210
- export const CURRENT_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.baseline.version;
211
- export const RESOURCE_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.resource.version;
212
- export const BINDING_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.binding.version;
213
- export const TOKEN_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.token.version;
214
- export const ORG_ADMISSION_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.orgAdmission.version;
215
- export const F012_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.f012.version;
216
- export const REAL_APPROVAL_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.realApproval.version;
217
- export const FACE_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.face.version;
218
- export const MAX_SUPPORTED_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.requirements.version;
219
- export function checkpointVersionOf(cp) {
220
- return cp.version ?? 0;
221
- }
222
152
  function finiteBound(v) {
223
153
  return v !== undefined && Number.isFinite(v) ? v : undefined;
224
154
  }
@@ -281,13 +211,15 @@ export function planReviewRequesterOf(pendingAction) {
281
211
  const id = pendingAction.requestedByCallId;
282
212
  return typeof id === "string" && id !== "" ? id : undefined;
283
213
  }
284
- export function summarizeCheckpoint(cp, disclose) {
214
+ export function summarizeCheckpoint(cp, disclose, verdict) {
215
+ const rowVerdict = verdict ?? judgeCheckpointRow(cp);
285
216
  const facts = checkpointIndexFacts(cp);
217
+ const rowName = `checkpoint ${JSON.stringify(cp.checkpointId ?? null)} of session ${JSON.stringify(cp.sessionId)}`;
286
218
  const descriptor = facts.riskDescriptor;
287
219
  const axes = descriptor === null ? undefined : readRiskAxes(descriptor?.axes);
288
220
  const severity = axes?.tier;
289
221
  if (axes?.problem !== undefined) {
290
- disclose?.(`checkpoint ${JSON.stringify(cp.checkpointId ?? null)} of session ${JSON.stringify(cp.sessionId)}: the risk descriptor's axes are ${axes.problem} — ${severity === undefined ? "the summary carries no severity" : `the summary's severity ${severity} is read from the valid marks`}`);
222
+ disclose?.(`${rowName}: the risk descriptor's axes are ${axes.problem} — ${severity === undefined ? "the summary carries no severity" : `the summary's severity ${severity} is read from the valid marks`}`);
291
223
  }
292
224
  const cardReading = parkedApprovalCardOf(cp.gate);
293
225
  const tool = cp.pendingAction.kind === "tool_approval" ? cp.pendingAction : undefined;
@@ -304,11 +236,25 @@ export function summarizeCheckpoint(cp, disclose) {
304
236
  toolInput = undefined;
305
237
  }
306
238
  }
239
+ const shownPreview = tool?.preview;
307
240
  const hasBidi = tool !== undefined &&
308
241
  (facts.hasBidiControls === true ||
309
- carriesBidiControls([toolInput, tool.preview], { maxNodes: BIDI_BACKFILL_MAX_NODES, maxChars: BIDI_BACKFILL_MAX_CHARS }));
242
+ carriesBidiControls([toolInput, shownPreview], { maxNodes: BIDI_BACKFILL_MAX_NODES, maxChars: BIDI_BACKFILL_MAX_CHARS }));
243
+ const agentId = agentIdOf({ taskId: legTaskIdOf({}, cp.state, cp.sessionId), isDelegatedChild: cp.state.isDelegatedChild === true });
244
+ const preview = (() => {
245
+ if (shownPreview === undefined)
246
+ return {};
247
+ try {
248
+ return { copy: structuredClone(shownPreview) };
249
+ }
250
+ catch {
251
+ disclose?.(`${rowName}: its approval preview is not a value a summary can copy — the summary carries no preview`);
252
+ return {};
253
+ }
254
+ })();
310
255
  return {
311
256
  token: facts.token,
257
+ rowVerdict,
312
258
  ...(cp.checkpointId !== undefined ? { checkpointId: cp.checkpointId } : {}),
313
259
  sessionId: facts.sessionId,
314
260
  scope: facts.scope,
@@ -317,7 +263,8 @@ export function summarizeCheckpoint(cp, disclose) {
317
263
  ...(cp.resourceLedger !== undefined ? { spentMicroUsd: cp.resourceLedger.spentMicroUsd } : {}),
318
264
  ...(facts.deadline !== null ? { deadline: facts.deadline } : {}),
319
265
  createdAt: facts.createdAt,
320
- ...(cp.sourceTaskId !== undefined ? { sourceTaskId: cp.sourceTaskId } : {}),
266
+ ...(cp.sourceSessionId !== undefined ? { sourceSessionId: cp.sourceSessionId } : {}),
267
+ ...(agentId !== undefined ? { agentId } : {}),
321
268
  ...(cp.principal !== undefined ? { principal: cp.principal } : {}),
322
269
  ...(facts.toolCallId !== null ? { toolCallId: facts.toolCallId } : {}),
323
270
  ...(requestedByCallId !== undefined ? { requestedByCallId } : {}),
@@ -328,7 +275,7 @@ export function summarizeCheckpoint(cp, disclose) {
328
275
  ? { restoreMode: cp.state.workspaceHandle.restoreMode === "park_only" ? "park_only" : "snapshot" }
329
276
  : {}),
330
277
  ...((runOrigin) => (isRunOrigin(runOrigin) ? { runOrigin } : {}))(cp.state.runOrigin),
331
- ...(tool?.preview !== undefined ? { preview: tool.preview } : {}),
278
+ ...("copy" in preview ? { preview: preview.copy } : {}),
332
279
  ...(tool?.previewWithheld === "oversize" || tool?.previewWithheld === "unavailable" ? { previewWithheld: tool.previewWithheld } : {}),
333
280
  ...(tool?.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
334
281
  ...(tool?.mandated === true ? { mandated: true } : {}),
@@ -347,17 +294,13 @@ export function summarizeCheckpoint(cp, disclose) {
347
294
  ...(hasBidi ? { hasBidiControls: true } : {}),
348
295
  };
349
296
  }
350
- export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing"]);
351
- export const isCheckpointConfigRefusalCode = (word) => CHECKPOINT_CONFIG_REFUSAL_CODES.some((w) => w === word);
352
- export class CheckpointError extends Error {
353
- code;
354
- detail;
355
- constructor(code, message, detail) {
356
- super(message);
357
- this.code = code;
358
- this.detail = detail;
359
- this.name = "CheckpointError";
297
+ export function summarizeStoredCheckpoint(cp, memo, disclose) {
298
+ let verdict = memo.get(cp);
299
+ if (verdict === undefined) {
300
+ verdict = judgeCheckpointRow(cp);
301
+ memo.set(cp, verdict);
360
302
  }
303
+ return summarizeCheckpoint(cp, disclose, verdict);
361
304
  }
362
305
  export function resolveDeclaredFidelity(store, storeName) {
363
306
  const declared = store?.fidelity;
@@ -370,17 +313,6 @@ export function resolveDeclaredFidelity(store, storeName) {
370
313
  e.code = "config.store_fidelity_invalid";
371
314
  throw e;
372
315
  }
373
- export function encodeAtFidelity(fidelity, value) {
374
- if (fidelity === "structured-clone")
375
- return { ok: true, value };
376
- try {
377
- const encoded = JSON.stringify(value);
378
- return { ok: true, value: encoded === undefined ? undefined : JSON.parse(encoded) };
379
- }
380
- catch (err) {
381
- return { ok: false, cause: err };
382
- }
383
- }
384
316
  export function resolveCheckpointStore(spec, deps) {
385
317
  if (Object.is(spec.checkpointStore, null))
386
318
  throw retiredCheckpointStoreNull();
@@ -539,9 +471,9 @@ function captureActorAssertion(actor) {
539
471
  return { id, hostAsserted, ...(issuer !== undefined ? { issuer } : {}) };
540
472
  }
541
473
  export function readPendingSteerQueue(state) {
542
- if (state.pendingSteer !== undefined) {
543
- throw new CheckpointError("checkpoint.unsupported_version", "this checkpoint carries a parked steer in the retired pre-queue single seat (`state.pendingSteer`), which this engine does not read — decide the parked instruction on the host's surface and, if it still applies, park it again with setPendingSteer", { reason: "seat_retired" });
544
- }
474
+ const retired = retiredSteerSeatRefusal(state);
475
+ if (retired !== undefined)
476
+ throw retired;
545
477
  return [...(state.pendingSteerQueue ?? [])].sort((a, b) => a.seq - b.seq);
546
478
  }
547
479
  export function judgeParkedSteerRepeat(queue, entry) {
@@ -574,17 +506,19 @@ export function appendPendingSteer(state, entry) {
574
506
  export function checkpointRowMatches(cp, scope, status) {
575
507
  return cp !== undefined && cp.scope === scope && cp.status === status;
576
508
  }
509
+ const IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ disclose: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
577
510
  export class InMemoryCheckpointStore {
578
511
  retention;
579
512
  durability = "process-local";
580
513
  fidelity = "structured-clone";
581
514
  execution = { outcome: true };
582
515
  cps = new Map();
516
+ rowVerdicts = new WeakMap();
583
517
  fault = null;
584
518
  disclose;
585
519
  holderIsCurrent;
586
520
  constructor(options) {
587
- const opts = receiveOptions(options, "InMemoryCheckpointStore");
521
+ const opts = receiveOptions(options, "InMemoryCheckpointStore", IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS);
588
522
  this.retention = readRetentionDeclaration("InMemoryCheckpointStore.retention", opts.retention);
589
523
  this.disclose = opts.disclose;
590
524
  this.holderIsCurrent = opts.holderIsCurrent;
@@ -613,7 +547,7 @@ export class InMemoryCheckpointStore {
613
547
  current: {
614
548
  status: cp.status,
615
549
  rev: checkpointRevOf(cp),
616
- ...(cp.resolvedOutcome !== undefined ? { resolvedOutcome: structuredClone(cp.resolvedOutcome) } : {}),
550
+ ...(memberPresent(cp, "resolvedOutcome") ? { resolvedOutcome: structuredClone(cp.resolvedOutcome) } : {}),
617
551
  },
618
552
  };
619
553
  }
@@ -634,7 +568,7 @@ export class InMemoryCheckpointStore {
634
568
  cp.rev = checkpointRevOf(cp) + 1;
635
569
  if (winnerClone)
636
570
  cp.resolvedOutcome = winnerClone;
637
- cp.reopenReason = undefined;
571
+ delete cp.reopenReason;
638
572
  return { claimed: true };
639
573
  }
640
574
  claimExpireCore(token, scope) {
@@ -725,7 +659,7 @@ export class InMemoryCheckpointStore {
725
659
  const out = [];
726
660
  for (const cp of this.cps.values()) {
727
661
  if (cp.scope === scope && cp.status === "pending")
728
- out.push(summarizeCheckpoint(cp, this.disclose));
662
+ out.push(summarizeStoredCheckpoint(cp, this.rowVerdicts, this.disclose));
729
663
  }
730
664
  return out;
731
665
  }
@@ -737,7 +671,7 @@ export class InMemoryCheckpointStore {
737
671
  return [...out];
738
672
  }
739
673
  async listOverdue(query) {
740
- return selectOverduePage(this.cps.entries(), readCheckpointOverdueQuery(query), (cp) => summarizeCheckpoint(cp, this.disclose), this.disclose);
674
+ return selectOverduePage(this.cps.entries(), readCheckpointOverdueQuery(query), (cp) => summarizeStoredCheckpoint(cp, this.rowVerdicts, this.disclose), this.disclose);
741
675
  }
742
676
  async listBySession(query) {
743
677
  return selectSessionPage(this.cps.entries(), readCheckpointSessionQuery(query), (cp) => structuredClone(cp), this.disclose);
@@ -749,35 +683,3 @@ export class InMemoryCheckpointStore {
749
683
  return this.cps.size;
750
684
  }
751
685
  }
752
- const RETIRED_MODE_SEED_MEMBERS = Object.freeze([
753
- ["autoModeRequested", () => true],
754
- ["approverPosture", () => true],
755
- ["shellGate", (v) => v !== "always"],
756
- ]);
757
- export function refuseRetiredModeSeed(state) {
758
- const gate = state.inheritedGate;
759
- if (gate === undefined)
760
- return;
761
- for (const [key, retired] of RETIRED_MODE_SEED_MEMBERS) {
762
- const value = gate[key];
763
- if (value === undefined || !retired(value))
764
- continue;
765
- const shown = typeof value === "string" ? JSON.stringify(value.slice(0, 40)) : typeof value === "boolean" ? String(value) : typeof value;
766
- throw new CheckpointError("checkpoint.unsupported_version", `this checkpoint's inheritedGate carries the retired mode-seed member \`${key}\` (${shown}), written before 7.34.0 and read by no engine since 7.39.0 — resume it once on an engine at 7.38.x or earlier (which reads it into \`permissionMode\`), or expire the row (\`CheckpointStore.expire\`); nothing was consumed`, { reason: "seat_retired" });
767
- }
768
- }
769
- export function recordedModeSeed(gate) {
770
- if (gate === undefined)
771
- return {};
772
- const refusal = (message) => {
773
- const e = new Error(message);
774
- e.code = "config.permission_mode_invalid";
775
- return e;
776
- };
777
- const { permissionMode, prePlanMode, shellGate } = gate;
778
- if (permissionMode !== undefined && !isPermissionMode(permissionMode))
779
- throw refusal(`the checkpoint row's inheritedGate.permissionMode is ${JSON.stringify(permissionMode)}, not a permission mode — the row cannot be resumed under a mode this engine does not know`);
780
- if (prePlanMode !== undefined && (!isPermissionMode(prePlanMode) || prePlanMode === "plan"))
781
- throw refusal(`the checkpoint row's inheritedGate.prePlanMode is ${JSON.stringify(prePlanMode)}, not a permission mode a plan can return to`);
782
- return { ...(permissionMode !== undefined ? { permissionMode } : {}), ...(prePlanMode !== undefined ? { prePlanMode } : {}), ...(shellGate !== undefined ? { shellGate } : {}) };
783
- }
@@ -259,8 +259,9 @@ export declare function clampRecordError(message: string): Error & {
259
259
  /**
260
260
  * Refuse a caller-supplied clamp record that names a seat the table does not have (or, with `carrier`, a row another
261
261
  * carrier hands on): a name nobody reads would sit on the record as if wired — the silent drop the retired-key door
262
- * exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge; a member
263
- * whose value is `undefined` carries nothing and is read as absent (the retired-key door's presence rule).
262
+ * exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge. The record is
263
+ * judged by the engine's one name judgment (every own key a row's name, whatever its value: a stray key holding `undefined`
264
+ * is a stray key); no value is read here — the readers read the record itself.
264
265
  */
265
266
  export declare function assertClampRecord(record: unknown, owner: string, carrier?: ClampCarrier, extra?: readonly string[]): void;
266
267
  /**
@@ -1,5 +1,6 @@
1
1
  import { readDenyEntryProblem } from "../tools/fs/read-deny.js";
2
2
  import { COMPLIANCE_CAPABILITIES, complianceCapabilityProblem } from "./compliance.js";
3
+ import { strayMembersOf } from "./own-property-receipt.js";
3
4
  import { writeProtectedEntryIdentity, writeProtectedEntryProblem } from "./write-protect.js";
4
5
  function readDenyIdentity(entry) {
5
6
  return typeof entry === "string" ? `i:${entry}` : `${entry.caseSensitive === true ? "s" : "i"}:${entry.pattern}`;
@@ -235,9 +236,9 @@ export function assertClampRecord(record, owner, carrier, extra = []) {
235
236
  if (record === null || typeof record !== "object")
236
237
  throw clampRecordError(`${owner} must be a record of clamp seats, got ${record === null ? "null" : typeof record}`);
237
238
  const legal = [...ROWS.filter(([, row]) => carrier === undefined || row.carrier === carrier).map(([seat]) => seat), ...extra];
238
- const unknown = Object.keys(record).filter((k) => record[k] !== undefined && !legal.includes(k));
239
- if (unknown.length > 0) {
240
- throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(k)).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
239
+ const unknown = strayMembersOf(record, { subject: owner, unit: "clamp seat", moment: "when the record is handed in" }, legal)?.names;
240
+ if (unknown !== undefined) {
241
+ throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(String(k))).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
241
242
  }
242
243
  }
243
244
  export function readClampFloor(floor) {
@@ -0,0 +1,13 @@
1
+ /**
2
+ * The engine's one "did you mean" reading: the nearest name to a misspelled one, within two edits. A leaf (it imports
3
+ * nothing), so a low-level door — the options receipt — can name the near miss without depending on the task registry
4
+ * that first needed it.
5
+ */
6
+ /** CC `gtr` (fable 复审 F1 — 亲核 @16169850: NOT plain Levenshtein but OSA / restricted
7
+ * Damerau-Levenshtein, WITH the adjacent-transposition term `o[i][s]=min(o[i][s], o[i-2][s-2]+1)`
8
+ * when `e[i-1]===t[s-2] && e[i-2]===t[s-1]`). The transposition matters: a typo like "tset"→"test"
9
+ * is distance 1 (CC has a Did-you-mean), plain Levenshtein would call it 2. */
10
+ export declare function editDistance(a: string, b: string): number;
11
+ /** CC `htr` shape (206:519814-519827): candidates within Levenshtein ≤2 (length-diff ≤2 pre-filter),
12
+ * best-first; the single best is the "Did you mean" suggestion (`htr(e, keys, 1)[0]`, 206:575196). */
13
+ export declare function closestName(query: string, candidates: Iterable<string>): string | undefined;
@@ -0,0 +1,35 @@
1
+ export function editDistance(a, b) {
2
+ if (a === b)
3
+ return 0;
4
+ const m = a.length;
5
+ const n = b.length;
6
+ const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
7
+ for (let i = 1; i <= m; i++) {
8
+ for (let j = 1; j <= n; j++) {
9
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1;
10
+ d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
11
+ if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
12
+ d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
13
+ }
14
+ }
15
+ }
16
+ return d[m][n];
17
+ }
18
+ export function closestName(query, candidates) {
19
+ let best;
20
+ let bestDist = 3;
21
+ const seen = new Set();
22
+ for (const c of candidates) {
23
+ if (seen.has(c))
24
+ continue;
25
+ seen.add(c);
26
+ if (Math.abs(c.length - query.length) > 2)
27
+ continue;
28
+ const dist = editDistance(query, c);
29
+ if (dist <= 2 && dist < bestDist) {
30
+ bestDist = dist;
31
+ best = c;
32
+ }
33
+ }
34
+ return best;
35
+ }
@@ -1,4 +1,6 @@
1
1
  import { tierAliasVia } from "./roles.js";
2
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
3
+ const OVERLAY_KEYS = optionKeys()({ contextTokens: 0, autoCompactTokens: 0, enabled: 0 });
2
4
  export function contextOverlayFor(settings, ref, catalog) {
3
5
  if (settings === undefined || typeof ref !== "string")
4
6
  return undefined;
@@ -26,11 +28,7 @@ export function assertContextSettingsValue(v, where) {
26
28
  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
27
29
  throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] must be a plain object (got ${raw === null ? "null" : Array.isArray(raw) ? "array" : typeof raw})`);
28
30
  }
29
- const o = raw;
30
- const unknown = Object.keys(o).filter((k) => k !== "contextTokens" && k !== "autoCompactTokens" && k !== "enabled");
31
- if (unknown.length > 0) {
32
- throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(k)).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`);
33
- }
31
+ const o = receiveMembers(raw, { subject: `${where}: contextSettings[${JSON.stringify(word)}]`, unit: "member", moment: "when the overlay is read" }, OVERLAY_KEYS, (_, unknown) => new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(String(k))).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`));
34
32
  for (const k of ["contextTokens", "autoCompactTokens"]) {
35
33
  const n = o[k];
36
34
  if (n !== undefined && (typeof n !== "number" || !Number.isFinite(n) || n <= 0)) {
@@ -57,7 +57,7 @@ export interface BoundaryLegsGiven {
57
57
  readonly legs: readonly BoundaryLeg[];
58
58
  readonly env?: Pick<ExecutionEnv, "capabilities">;
59
59
  }
60
- /** What a leg's session is still owed when the leg ends: the legs each unfinished background task its access (the TaskOutput reach) delivers
60
+ /** What a leg's session is still owed when the leg ends: the legs each unfinished background task its access (the registry task access) delivers
61
61
  * along, read as the poll the session's next leg — another tree — would make of it (`TaskRegistry.owedDeliveries`). */
62
62
  export type OwedDeliveries = () => readonly BoundaryLegsGiven[];
63
63
  declare const CROSS_BOUNDARY_TREE_TOKEN: unique symbol;
@@ -1,4 +1,4 @@
1
- import type { AssertAllKeysHandled } from "./ask-origin.js";
1
+ import { type AssertAllKeysHandled } from "./ask-origin.js";
2
2
  import type { DecisionMember, PermissionResult } from "./tool-policy.js";
3
3
  export declare const refusedOutOfContract: (message: string) => PermissionResult;
4
4
  /** Is `d` a refusal the engine itself minted (by object identity — a look-alike `deny` a caller built is not one)? The receipt's
@@ -47,6 +47,7 @@ export declare const DECISION_MEMBER_ARMS: Readonly<{
47
47
  readonly origin: readonly ["ask"];
48
48
  readonly askClass: readonly ["ask"];
49
49
  readonly classes: readonly ["ask"];
50
+ readonly askReasons: readonly ["ask"];
50
51
  readonly ruleUnreadable: readonly ["ask"];
51
52
  readonly authoredBy: readonly ["ask"];
52
53
  readonly editRewritten: readonly ["ask"];
@@ -54,6 +55,17 @@ export declare const DECISION_MEMBER_ARMS: Readonly<{
54
55
  export type DecisionMemberArmsCoverTheUnion = AssertAllKeysHandled<{
55
56
  [M in DecisionMember]: Exclude<ArmOf<M>, (typeof DECISION_MEMBER_ARMS)[M][number]>;
56
57
  }[DecisionMember]>;
58
+ /**
59
+ * The members a PreToolUse hook's answer carries beyond the decision's, with their arms — the hook seat's half of the member ×
60
+ * arm table, read by the same screen: `additionalContext` (the text appended for the model, any arm) and `questionCause` (WHY
61
+ * the hook asked, {@link import("./ask-origin.js").HookQuestionCause} — the ask arm only). The hook seat's member list is the
62
+ * decision's plus these.
63
+ */
64
+ export declare const HOOK_SEAT_MEMBER_ARMS: Readonly<{
65
+ readonly additionalContext: readonly ["allow", "ask", "deny"];
66
+ readonly questionCause: readonly ["ask"];
67
+ }>;
68
+ export type HookSeatMember = keyof typeof HOOK_SEAT_MEMBER_ARMS;
57
69
  /**
58
70
  * WHO writes each member of the decision union — one writer per fact, one table (fenced to the union like
59
71
  * {@link DECISION_MEMBER_ARMS}: a member the union gains without a row is a type error):
@@ -85,6 +97,7 @@ export declare const DECISION_MEMBER_WRITERS: Readonly<{
85
97
  readonly origin: "stamp";
86
98
  readonly askClass: "stamp";
87
99
  readonly classes: "stamp";
100
+ readonly askReasons: "stamp";
88
101
  readonly ruleUnreadable: "composer";
89
102
  readonly authoredBy: "composer";
90
103
  readonly editRewritten: "composer";
@@ -1,4 +1,5 @@
1
1
  import { types } from "node:util";
2
+ import { HOOK_QUESTION_CAUSES, isHookQuestionCause } from "./ask-origin.js";
2
3
  import { AUTO_MODE_FALLBACK_CAUSES, isAutoModeFallbackCause, isDenialLimitBound } from "./auto-mode.js";
3
4
  import { thrownText } from "./thrown-value.js";
4
5
  const ENGINE_REFUSALS = new WeakSet();
@@ -26,6 +27,7 @@ const CLOSED_MEMBERS = [
26
27
  { member: "probeMandated", words: [true], has: (v) => v === true },
27
28
  { member: "crossBoundaryMandated", words: [true], has: (v) => v === true },
28
29
  { member: "mandated", words: [true], has: (v) => v === true },
30
+ { member: "questionCause", words: HOOK_QUESTION_CAUSES, has: isHookQuestionCause },
29
31
  ];
30
32
  const EVERY_ARM = ["allow", "ask", "deny"];
31
33
  const ASK = ["ask"];
@@ -33,15 +35,16 @@ export const DECISION_MEMBER_ARMS = Object.freeze({
33
35
  action: EVERY_ARM, updatedInput: EVERY_ARM, message: EVERY_ARM, decisionReason: EVERY_ARM, attestation: EVERY_ARM,
34
36
  requiresRealApproval: ASK, denialLimitFallback: ASK, classifierNoRuling: ASK, allowRuleShadowed: ASK, probeReason: ASK, probeCause: ASK,
35
37
  probeMandated: ASK, crossBoundaryMandated: ASK, mandated: ASK, mandate: ASK, probeReadRootCandidate: ASK, matchedAskRule: ASK, ruleEvidence: ASK,
36
- segmentCoverage: ASK, origin: ASK, askClass: ASK, classes: ASK, ruleUnreadable: ASK, authoredBy: ASK,
38
+ segmentCoverage: ASK, origin: ASK, askClass: ASK, classes: ASK, askReasons: ASK, ruleUnreadable: ASK, authoredBy: ASK,
37
39
  editRewritten: ASK,
38
40
  });
41
+ export const HOOK_SEAT_MEMBER_ARMS = Object.freeze({ additionalContext: EVERY_ARM, questionCause: ASK });
39
42
  export const DECISION_MEMBER_WRITERS = Object.freeze({
40
43
  action: "composer", updatedInput: "composer", message: "composer", decisionReason: "composer", attestation: "record",
41
44
  requiresRealApproval: "composer", denialLimitFallback: "composer", classifierNoRuling: "composer", allowRuleShadowed: "stamp", probeReason: "composer",
42
45
  probeCause: "composer", probeMandated: "composer", crossBoundaryMandated: "composer", mandated: "composer", mandate: "stamp",
43
46
  probeReadRootCandidate: "composer", matchedAskRule: "composer", ruleEvidence: "stamp", segmentCoverage: "stamp", origin: "stamp", askClass: "stamp",
44
- classes: "stamp", ruleUnreadable: "composer", authoredBy: "composer", editRewritten: "composer",
47
+ classes: "stamp", askReasons: "stamp", ruleUnreadable: "composer", authoredBy: "composer", editRewritten: "composer",
45
48
  });
46
49
  const STAMP_MEMBERS = Object.keys(DECISION_MEMBER_WRITERS).filter((m) => DECISION_MEMBER_WRITERS[m] === "stamp");
47
50
  const RETIRED_WINDOW_MEMBER = "autoDenyAfterMs";
@@ -101,7 +104,7 @@ export function screenContractValues(contract, opts) {
101
104
  return unrecognized(member, v, words);
102
105
  }
103
106
  const arm = contract.action;
104
- for (const [member, arms] of Object.entries(DECISION_MEMBER_ARMS)) {
107
+ for (const [member, arms] of Object.entries({ ...DECISION_MEMBER_ARMS, ...HOOK_SEAT_MEMBER_ARMS })) {
105
108
  if (contract[member] === undefined || (arm === undefined ? EVERY_ARM.every((a) => arms.includes(a)) : arms.includes(arm)))
106
109
  continue;
107
110
  return refusedOutOfContract(`a permission decision carries "${member}" on ${arm === undefined ? "a result with no action (no opinion)" : `its "${arm}" arm`} — the member belongs to ` +
@@ -11,8 +11,10 @@ import type { TaskEvent } from "./task-event.js";
11
11
  /**
12
12
  * design/129-B — one lifecycle event of a BACKGROUND delegation child, delivered to the
13
13
  * process-level {@link RunnerDeps.onBackgroundChildEvent} observer. Keys: `taskId` is the registry handle
14
- * (`a*` domain — the TaskOutput/TaskStop key); `progressTaskId`/`sessionId` are the child RUN's id (uuid
15
- * domain — the same key `task_progress` frames carry).
14
+ * (`a*` domain — the TaskStop / host-poll key), which is also the child run's own task id, so the child's
15
+ * own `task_progress` frames carry it; `sessionId` is the child run's session (uuid domain);
16
+ * `progressTaskId` is the task id of the leg whose frame a tick forwards (the child's own, or a nested
17
+ * descendant's).
16
18
  *
17
19
  * `kind: "spawn"` announces a fleet ROW's birth, which is a different fact from a child RUN's start
18
20
  * (`TaskEvent` `task_started`): an `a*` row is born when its lane registers it, before the child run
@@ -24,9 +26,9 @@ export interface BackgroundChildEvent {
24
26
  kind: "spawn" | "tick" | "terminal";
25
27
  /** Row key, stable across all three kinds. The prefix is the DOMAIN DISCRIMINATOR (load-bearing,
26
28
  * not opaque — design/149): `a*` = registry handle (background subagent —
27
- * TaskOutput/TaskStop addressable, fleet-footer display lane); `wa*` = synthetic workflow-agent
28
- * row (NOT a registry row — per-agent read face is the workflow's `TaskOutput(w*)` agent_runs
29
- * projection + journal API). Display contract (CC anchor): CC's footer renders ONLY the
29
+ * TaskStop addressable, fleet-footer display lane); `wa*` = synthetic workflow-agent
30
+ * row (NOT a registry row — per-agent read face is the workflow run's agent rows in its completion
31
+ * record + journal API). Display contract (CC anchor): CC's footer renders ONLY the
30
32
  * workflow AGGREGATE row — `wa*` rows are read-face/observability rows and SHOULD NOT be
31
33
  * rendered in the footer fleet tree; shells filter on the prefix. */
32
34
  taskId: string;
@@ -79,9 +81,10 @@ export interface BackgroundChildEvent {
79
81
  * authority; this field is the row-level convenience beside it.
80
82
  */
81
83
  model?: string;
82
- /** spawn: the HOST task's DECLARED task id (parent attribution). Omitted when the host
83
- * run declared no task id (the `spec.taskId ?? sessionId` fallback would launder a session id into
84
- * a task-id field — the orphan-pointer shape); {@link parentSessionId} is the always-on linkage. */
84
+ /** spawn: the HOST leg's task id (parent attribution) — a host declared id, or the parent row's id
85
+ * when the host is itself a background sub-agent. Omitted when the host's task id is just its
86
+ * session id (a host that declared none, or a foreground child): writing it would launder a session
87
+ * id into a task-id field — the orphan-pointer shape; {@link parentSessionId} is the always-on linkage. */
85
88
  parentTaskId?: string;
86
89
  /** spawn: the HOST run's session id (uuid domain) — the always-on parent
87
90
  * linkage, present whether or not a task id was declared. */
@@ -113,7 +116,8 @@ export interface BackgroundChildEvent {
113
116
  * field (their own `taskId` is the per-child key). ABSENT, never invented, on a workflow started with no
114
117
  * launching tool call. */
115
118
  parentToolCallId?: string;
116
- /** tick: the forwarded `task_progress` frame's own taskId (uuid domain; nested children carry theirs). */
119
+ /** tick: the forwarded `task_progress` frame's own taskId (the child's row id on its own ticks; a nested
120
+ * descendant's frame carries that descendant's task id). */
117
121
  progressTaskId?: string;
118
122
  /** tick: the forwarded frame's parentTaskId (nested attribution) · terminal: absent. */
119
123
  progressParentTaskId?: string;
@@ -1,6 +1,6 @@
1
1
  import { anchorSpelling, canonicalizeTarget, familyFor, hasWin32AliasedComponent, isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity, win32NamespaceScreen } from "../tools/fs/safety.js";
2
2
  import { declaredPathTargetOf, pathTargetValue, protectivePathTargetOf } from "./tool-registry.js";
3
- import { symlinkChainHops } from "./path-identity.js";
3
+ import { leafChainMayHold, symlinkChainHops } from "./path-identity.js";
4
4
  import { DEFAULT_GATE_AWAIT_TIMEOUT_MS, withGateTimeout } from "./gate-bounded-await.js";
5
5
  import { thrownText } from "./thrown-value.js";
6
6
  import { canonicalize } from "./canonical-json.js";
@@ -106,8 +106,7 @@ export async function readPath(env, spelled, base, bases, contract, signal) {
106
106
  if (contract.views === "lexical" || env === undefined || family === undefined || lexical?.kind === "unreadable")
107
107
  return { lexical, hops: [] };
108
108
  const canonical = await canonicalizeTarget(env, spelled, signal, family, base);
109
- const climbs = (s) => s !== undefined && (family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/).test(s);
110
- const followsALink = canonical.ok && (climbs(spelled) || climbs(base) || lexical?.kind !== "path" || absoluteTargetIdentityOf(canonical.key, bases) !== lexical.identity);
109
+ const followsALink = canonical.ok && leafChainMayHold([spelled, base], lexical?.kind !== "path" || absoluteTargetIdentityOf(canonical.key, bases) !== lexical.identity, family);
111
110
  const chain = contract.views === "chain" && followsALink
112
111
  ? await withGateTimeout(symlinkChainHops(env, spelled, signal, family, base), DEFAULT_GATE_AWAIT_TIMEOUT_MS, signal, "canonicalChain").catch((err) => ({ ok: false, cause: thrownText(err), asked: true }))
113
112
  : { ok: true, hops: [] };
@@ -15,7 +15,7 @@
15
15
  * A leaf (type-only imports): the decision module that receives a record and the class derivation that reads one for its call
16
16
  * both depend on it, and neither depends on the other through it.
17
17
  */
18
- import type { AskClass, AskOrigin } from "./ask-origin.js";
18
+ import type { AskClass, AskOrigin, AskReason } from "./ask-origin.js";
19
19
  import type { ClassifierDenyCause, Settlement } from "./gate-outcome.js";
20
20
  import type { AutoModeClassifierRound } from "./auto-mode.js";
21
21
  import type { AskUnresolvableCause } from "./ask-unresolvable-notice.js";
@@ -56,6 +56,16 @@ export interface EngineAttestation {
56
56
  /** A seat refused the call's arguments because no approval can be bound to them: the refusal's sentence, carried by the
57
57
  * refusal itself — the gate's deny exit reads it (the remedy it gives) instead of judging again. */
58
58
  readonly bindingRefusal?: string;
59
+ /** The engine's own generic question the ask was composed with (the write gate's default "approve write to" sentence, the
60
+ * permission mode's own question) — not anyone's reason. The chain's entry mint ({@link
61
+ * import("./ask-origin.js").chainAskReasonsOf}) writes no entry while the ask's `message` IS this sentence; a later layer
62
+ * that spread the ask and put its own words in `message` keeps them. Written only by the station that composed that
63
+ * sentence, for that sentence; a composer cannot state it (an unbranded record is refused). */
64
+ readonly genericQuestion?: string;
65
+ /** The askers a station read off this ask where it first received it, before it narrated the sentence (an inherited station
66
+ * floating an ancestor's ask back into this leg's fold: its mark frames, its denial-limit fallback's sentence). The chain's
67
+ * entry mint takes these instead of the sentence; empty = the station read no asker. Written only by that float. */
68
+ readonly receivedAskReasons?: readonly AskReason[];
59
69
  }
60
70
  /** The members a station attests — everything but the call binding. */
61
71
  export type AttestationMembers = Omit<EngineAttestation, "toolCallId" | "toolName">;