@sema-agent/core 7.60.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +605 -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 +61 -10
  6. package/dist/agents/cascade.js +60 -20
  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-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -143,6 +143,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
143
143
  "config.path_view_unresolved",
144
144
  "config.execution_env_capability_invalid",
145
145
  "config.read_deny_floor_unkept",
146
+ "config.read_floor_confinement_unavailable",
146
147
  "config.tool_card_undeclared",
147
148
  "config.tool_face_undeclared",
148
149
  "config.tool_face_invalid",
@@ -211,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
211
212
  "model.capability_downgraded",
212
213
  "model.role_defaulted",
213
214
  "context.tool_turn_repaired",
214
- "context.image_removed",
215
+ "context.media_removed",
216
+ "context.tool_schema_removed",
215
217
  "task.user_steer_undrained",
216
218
  "task.user_followup_undrained",
217
219
  "steering.parked_input_blocked",
@@ -229,6 +231,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
229
231
  "tool_result.offload_put_failed",
230
232
  "tool_result.media_refused",
231
233
  "config.image_processor_unavailable",
234
+ "fs.staging_file_left",
235
+ "fs.staging_file_swept",
232
236
  "instructions.source_changed",
233
237
  "session.records_skipped",
234
238
  "memory.layer_locked_legacy",
@@ -247,7 +251,7 @@ const NOTICE_AUDIENCE_TABLE = {
247
251
  "classifier.denial_limit": "user",
248
252
  "classifier.unavailable": "user",
249
253
  "classifier.fallback": "operator",
250
- "classifier.seat_rate_limited": "operator",
254
+ "classifier.seat_rate_limited": "user",
251
255
  "classifier.role_defaulted": "operator",
252
256
  "classifier.contract_broken": "operator",
253
257
  "task.turn_interrupted": "user",
@@ -294,6 +298,7 @@ const NOTICE_AUDIENCE_TABLE = {
294
298
  "config.path_view_unresolved": "operator",
295
299
  "config.execution_env_capability_invalid": "operator",
296
300
  "config.read_deny_floor_unkept": "operator",
301
+ "config.read_floor_confinement_unavailable": "operator",
297
302
  "config.tool_card_undeclared": "operator",
298
303
  "config.tool_face_undeclared": "operator",
299
304
  "config.tool_face_invalid": "operator",
@@ -334,12 +339,15 @@ const NOTICE_AUDIENCE_TABLE = {
334
339
  "model.capability_downgraded": "user",
335
340
  "model.role_defaulted": "operator",
336
341
  "context.tool_turn_repaired": "operator",
337
- "context.image_removed": "user",
342
+ "context.media_removed": "user",
343
+ "context.tool_schema_removed": "user",
338
344
  "skills.listing_truncated": "operator",
339
345
  "agents.listing_truncated": "operator",
340
346
  "tool_result.offload_put_failed": "operator",
341
347
  "tool_result.media_refused": "operator",
342
348
  "config.image_processor_unavailable": "operator",
349
+ "fs.staging_file_left": "operator",
350
+ "fs.staging_file_swept": "operator",
343
351
  "config.forward_sink_failed": "operator",
344
352
  "instructions.source_changed": "user",
345
353
  "session.records_skipped": "user",
@@ -371,6 +379,7 @@ const NOTICE_MINTER_TABLE = {
371
379
  "config.path_view_unresolved": "engine",
372
380
  "config.execution_env_capability_invalid": "engine",
373
381
  "config.read_deny_floor_unkept": "engine",
382
+ "config.read_floor_confinement_unavailable": "engine",
374
383
  "config.tool_card_undeclared": "engine",
375
384
  "config.tool_face_undeclared": "engine",
376
385
  "config.tool_face_invalid": "engine",
@@ -439,7 +448,8 @@ const NOTICE_MINTER_TABLE = {
439
448
  "model.capability_downgraded": "engine",
440
449
  "model.role_defaulted": "engine",
441
450
  "context.tool_turn_repaired": "engine",
442
- "context.image_removed": "engine",
451
+ "context.media_removed": "engine",
452
+ "context.tool_schema_removed": "engine",
443
453
  "task.user_steer_undrained": "engine",
444
454
  "task.user_followup_undrained": "engine",
445
455
  "steering.parked_input_blocked": "engine",
@@ -457,6 +467,8 @@ const NOTICE_MINTER_TABLE = {
457
467
  "tool_result.offload_put_failed": "engine",
458
468
  "tool_result.media_refused": "engine",
459
469
  "config.image_processor_unavailable": "engine",
470
+ "fs.staging_file_left": "engine",
471
+ "fs.staging_file_swept": "engine",
460
472
  "instructions.source_changed": "server",
461
473
  "session.records_skipped": "server",
462
474
  "memory.layer_locked_legacy": "server",
@@ -450,8 +450,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
450
450
  export interface HookInvocationIdentity {
451
451
  /** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
452
452
  readonly sessionId: string;
453
- /** The run's unified task id (`spec.taskId ?? sessionId` — the value TaskEvent's `sourceTaskId`
454
- * and `task_progress` frames key on). Equal to {@link sessionId} when no task id was declared. */
453
+ /** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
454
+ * sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
455
455
  readonly taskId: string;
456
456
  /** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
457
457
  * derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
@@ -549,6 +549,10 @@ export interface HookToolOutput {
549
549
  */
550
550
  export type PreToolUseResult = PermissionResult & {
551
551
  additionalContext?: string;
552
+ /** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
553
+ * `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
554
+ * decision receipt refuses it (an engine fail-closed deny). */
555
+ questionCause?: import("./ask-origin.js").HookQuestionCause;
552
556
  };
553
557
  /** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
554
558
  export interface PostToolUseResult {
@@ -1384,11 +1388,14 @@ export interface AskCarry {
1384
1388
  readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
1385
1389
  /** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
1386
1390
  readonly authoredBy?: "deployment";
1391
+ /** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
1392
+ * same value the synchronous card carries. */
1393
+ readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
1387
1394
  }
1388
1395
  /** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
1389
1396
  * the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
1390
- * number), the origin word only when it is a member of the closed set, and the class pair only when it is
1391
- * well-formed, as a fresh copy (the carry is typed, but the row is the boundary a host reads back through —
1397
+ * number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
1398
+ * well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
1392
1399
  * the same screen the summary applies to the word). */
1393
1400
  export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1394
1401
  denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
@@ -1396,6 +1403,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1396
1403
  origin?: import("./ask-origin.js").AskOrigin;
1397
1404
  askClass?: import("./ask-origin.js").AskClass;
1398
1405
  classes?: readonly import("./ask-origin.js").AskClass[];
1406
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
1399
1407
  };
1400
1408
  /**
1401
1409
  * The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant
@@ -1,13 +1,13 @@
1
1
  import { argsAsTheToolReads, stampArgsReading } from "./effective-path-target.js";
2
2
  import { extensionAuthors, noteRewrite, readRejudge, rewriteChasedSentence, screeningAuthorship } from "./rewrite-rejudge.js";
3
- import { decisionText, describeThrown, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
3
+ import { decisionText, describeThrown, extensionQuestionText, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
4
4
  import { createSettlementLedger, engineFailClosedExit, hookDenyExit, settledScreen, settledScreenExit, takeInheritedScreen, unownedArgsExit } from "./runner/gate-exit.js";
5
5
  import { composeCallSignal } from "./runner/abort-race.js";
6
6
  import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, failedHandlerClause, judgedInputOf, observePermissionDenied } from "./mods/stations.js";
7
7
  import { runGateFold } from "./gate-fold.js";
8
8
  import { runGateLanes } from "./gate-lanes.js";
9
9
  export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
10
- import { isAskOrigin, screenAskClassMembers } from "./ask-origin.js";
10
+ import { hookAskReasonOf, isAskOrigin, receiveAskReasons, screenAskClassMembers } from "./ask-origin.js";
11
11
  import { isAutoModeFallbackCause } from "./auto-mode.js";
12
12
  import { inlineUntrusted } from "./untrusted-text.js";
13
13
  export { formatHookFeedback } from "./reminder-mint.js";
@@ -111,6 +111,11 @@ function preToolUseRefusedReason(subject, failed) {
111
111
  : "";
112
112
  return `a PreToolUse hook ${failedHandlerClause(failed)} while screening ${subject}; the call was NOT executed (fail-closed).${tail}`;
113
113
  }
114
+ function hookAskOf(r, answeredBy, toolName) {
115
+ const { questionCause, ...ask } = r;
116
+ const entry = hookAskReasonOf(answeredBy, questionCause ?? "asked", decisionText(ask));
117
+ return { ...ask, ...(answeredBy !== undefined ? { message: extensionQuestionText(toolName, entry) } : {}), askReasons: Object.freeze([entry]) };
118
+ }
114
119
  export function createPreToolUseScreening(input, readSettled = (decision) => ({ decision })) {
115
120
  const own = input.modBus !== undefined && input.modBus.hasHandlers("classic.PreToolUse") ? input.modBus : undefined;
116
121
  const inherited = (input.inheritedInstallations ?? []).filter((i) => i.bus.hasHandlers("classic.PreToolUse", i.judges));
@@ -143,7 +148,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
143
148
  if (outcome.kind === "failed")
144
149
  return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
145
150
  const r = screenPreToolUseResult(outcome.answer);
146
- const answer = r === null || r === false ? undefined : r;
151
+ const answer = r === null || r === false || r === undefined ? undefined : r.action === "ask" ? hookAskOf(r, outcome.answeredBy, toolName) : r;
147
152
  const rewrittenBy = authorship.of(outcome.answer);
148
153
  return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), rewrittenBy: answer?.updatedInput === undefined ? [] : rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] };
149
154
  };
@@ -214,7 +219,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
214
219
  allowedBy.set(i, r.answeredBy);
215
220
  if (verdict?.action !== "ask")
216
221
  return undefined;
217
- const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}) };
222
+ const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}), ...(verdict.askReasons !== undefined ? { askReasons: verdict.askReasons } : {}) };
218
223
  const call = Object.freeze({ toolName, toolCallId, args: bytes, ...(as.face !== undefined ? { face: as.face } : {}) });
219
224
  const settled = readSettled(await seat.installation.settle(ask, call, signal));
220
225
  if (settled.decision.action === "deny")
@@ -241,11 +246,13 @@ export function askCarryRowMembers(carry) {
241
246
  const origin = carry.origin;
242
247
  const why = carry.classifierNoRuling;
243
248
  const classed = screenAskClassMembers(carry.askClass, carry.classes);
249
+ const askReasons = receiveAskReasons(carry.askReasons);
244
250
  return {
245
251
  ...(carry.denialLimitFallback !== undefined ? { denialLimitFallback: { ...carry.denialLimitFallback } } : {}),
246
252
  ...(isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {}),
247
253
  ...(isAskOrigin(origin) ? { origin } : {}),
248
254
  ...(classed !== undefined ? classed : {}),
255
+ ...(askReasons !== undefined ? { askReasons } : {}),
249
256
  };
250
257
  }
251
258
  export async function runToolGate(input) {
@@ -2,7 +2,7 @@ import { isIP } from "node:net";
2
2
  import { HOST_UNREADABLE_SENTENCE, callHostTargetOf, hostOfUrl, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
3
3
  import { inlineUntrusted } from "./untrusted-text.js";
4
4
  import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
5
- import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
5
+ import { DECLARATION_RECEIPT_MODE, optionKeys, refuseStrayMembers } from "./own-property-receipt.js";
6
6
  function isPrivateV4(ip) {
7
7
  const o = ip.split(".").map(Number);
8
8
  if (o.length !== 4 || o.some((n) => !Number.isInteger(n) || n < 0 || n > 255))
@@ -48,7 +48,7 @@ export function isPrivateHost(host) {
48
48
  return /^fe[89ab]/.test(h) || /^f[cd]/.test(h) || /^fe[c-f]/.test(h);
49
49
  }
50
50
  export const HOST_FLOOR_INVALID_CODE = "config.host_floor_invalid";
51
- const FLOOR_MEMBERS = ["deny", "only"];
51
+ const FLOOR_KEYS = optionKeys()({ deny: 0, only: 0 });
52
52
  function floorInvalid(what) {
53
53
  return Object.assign(new Error(`RunnerDeps.hostFloor ${what} — a host floor that does not read is refused whole, never half-armed (an entry is a host pattern: \`example.com\` or \`*.example.com\`).`), { code: HOST_FLOOR_INVALID_CODE });
54
54
  }
@@ -95,9 +95,7 @@ export function compileHostFloor(declared) {
95
95
  return undefined;
96
96
  if (!isPlainRecord(value))
97
97
  throw floorInvalid(`must be a record { deny?, only? } (got ${value === null ? "null" : Array.isArray(value) ? "a list" : typeof value})`);
98
- const unknownMember = Object.keys(value).find((k) => !FLOOR_MEMBERS.includes(k));
99
- if (unknownMember !== undefined)
100
- throw floorInvalid(`has a member "${inlineUntrusted(unknownMember, 60)}" — its members are \`deny\` and \`only\``);
98
+ refuseStrayMembers(value, { subject: "RunnerDeps.hostFloor", unit: "member", moment: "when the floor is compiled" }, FLOOR_KEYS, (_, [stray]) => floorInvalid(`has a member "${inlineUntrusted(String(stray), 60)}" — its members are \`deny\` and \`only\``));
101
99
  const deny = readEntries(value.deny, "deny") ?? [];
102
100
  const only = readEntries(value.only, "only");
103
101
  for (const o of only ?? []) {
@@ -1,24 +1,32 @@
1
1
  import type { DocumentContent, ImageContent } from "../internal/llm.js";
2
2
  import type { ImageDimensions, ImageDownsampler } from "./image-downsample.js";
3
- import { type MediaBlock } from "./media-byte-cap.js";
3
+ import type { MediaBlock } from "./media-byte-cap.js";
4
4
  /** Max raw size sent whole as a document block (CC `PDF_TARGET_RAW_SIZE`). */
5
5
  export declare const PDF_TARGET_RAW_SIZE: number;
6
6
  /**
7
7
  * Every number an image passes on its way to the model, in one table — the admission and its processor read it, and so
8
8
  * does every carrier that words a refusal; a downstream that bounds an image by the same limit reads the same field.
9
- * - `hard`: what refuses. `formats` (the header rows above), `readBytes` (the raw read cap — larger when a processor can
10
- * shrink what was read; the 64 MiB bound is an OOM sanity bound, CC reads the file whole), `urlBytes` (a fetched
11
- * image's body), `rejectEdge` (the longest edge the bytes that ship may state — `fI` (cli309.js:253044), the 2000 box,
12
- * its no-flag reject width), `imageBase64Chars` (the provider's single-image limit, on the base64 length — CC `fI`
13
- * `maxBase64Size`).
9
+ * - `hard`: what refuses. `formats` (the header rows above), `readBytes` (the raw read cap — without a processor the bytes
10
+ * ship as they are, so the cap is the raw size whose base64 fits `imageBase64Chars`, the one bound that binds there;
11
+ * with one it is larger, since the processor shrinks what was read, and the 64 MiB bound is an OOM sanity bound, CC
12
+ * reads the file whole), `urlBytes` (a fetched image's body), `rejectEdge` (the longest edge the bytes that ship may
13
+ * state — `fI` (cli309.js:253044), the 2000 box, its no-flag reject width), `imageBase64Chars` (the provider's
14
+ * single-image limit, on the base64 length — CC `fI` `maxBase64Size`).
14
15
  * - `soft`: what the processor aims at, best effort. `frameEdge` and `rawBytes` are the frame ladder's box and byte rung
15
16
  * (CC `fI` `maxWidth` / `targetRawSize`: 3.75 MB raw = 5 MiB base64); `targetBytes` is the byte-target step's goal
16
17
  * (`SZ` (cli309.js:253044), the bytes `N$o` compresses toward).
17
- * The request's media budget is not a row of this table yet.
18
+ * - `request`: what one provider request may carry of the media the conversation holds (CC `eSn` (cli309.js:265961) and
19
+ * its constants `Xai` / `Jai` (cli309.js:253044)), every size in base64 characters — the unit the provider counts. Over `maxItems`
20
+ * media blocks (images and documents together; `largeWindow.maxItems` for a model whose window is at least
21
+ * `largeWindow.fromContextWindow` tokens) the oldest go until `maxItems - margin` remain; over the budget the oldest go
22
+ * until `hysteresisBase64Chars` under it. `budgetBase64Chars` is the default budget a deployment may replace
23
+ * (`RunnerDeps.mediaBudgetBase64Chars`); it is not CC's first-party 24 MiB, because a sema deployment mostly serves
24
+ * endpoints CC treats as third-party, for which CC's own budget is 75 MiB. There is no document-only budget: CC holds
25
+ * one for its first-party endpoint alone.
18
26
  */
19
27
  export declare const IMAGE_ADMISSION: Readonly<{
20
28
  readonly hard: Readonly<{
21
- formats: Readonly<Record<"image/jpeg" | "image/png" | "image/gif" | "image/webp", (b: Uint8Array) => boolean>>;
29
+ formats: Readonly<Record<"image/png" | "image/jpeg" | "image/gif" | "image/webp", (b: Uint8Array) => boolean>>;
22
30
  readBytes: Readonly<{
23
31
  withoutProcessor: number;
24
32
  withProcessor: number;
@@ -32,7 +40,37 @@ export declare const IMAGE_ADMISSION: Readonly<{
32
40
  rawBytes: number;
33
41
  targetBytes: 512000;
34
42
  }>;
43
+ readonly request: Readonly<{
44
+ maxItems: 100;
45
+ largeWindow: Readonly<{
46
+ fromContextWindow: 1000000;
47
+ maxItems: 600;
48
+ }>;
49
+ margin: 20;
50
+ budgetBase64Chars: number;
51
+ hysteresisBase64Chars: number;
52
+ }>;
35
53
  }>;
54
+ /** What one request may carry, resolved for a model and a deployment's budget: the media-block count, the margin a count
55
+ * cut leaves under it, the base64 budget (`Infinity`: none) and the hysteresis a budget cut leaves under that. */
56
+ export interface RequestMediaLimits {
57
+ maxItems: number;
58
+ margin: number;
59
+ budgetBase64Chars: number;
60
+ hysteresisBase64Chars: number;
61
+ }
62
+ /** The one reading of a deployment's request media budget (`RunnerDeps.mediaBudgetBase64Chars`, screened by
63
+ * {@link checkedRequestMediaBudget} at `new Runner`), for both of its readers — the request trim and the `tool_end.output`
64
+ * projection: absent ⇒ `IMAGE_ADMISSION.request.budgetBase64Chars`; `0` or `Infinity` ⇒ no budget (`Infinity`). */
65
+ export declare function requestMediaBudget(knob: number | undefined): number;
66
+ /** The limits a request on `model` under the deployment's budget `knob` is trimmed to. */
67
+ export declare function requestMediaLimits(model: {
68
+ readonly contextWindow?: unknown;
69
+ }, knob: number | undefined): RequestMediaLimits;
70
+ /** The deployment's request media budget, screened once at `new Runner`: absent, `0` or `Infinity` (no budget), or a whole
71
+ * number of base64 characters no smaller than twice the hysteresis. Anything else — a non-number, `NaN`, a negative, a
72
+ * fraction, a budget a cut would empty — is refused (`config.invalid_argument`), never read as a default or as none. */
73
+ export declare function checkedRequestMediaBudget(value: unknown, seat: string): void;
36
74
  /** Verify the raw bytes actually ARE the image format the claimed type names (`IMAGE_ADMISSION.hard.formats`). Extension
37
75
  * alone is forgeable: a `.png` holding text / an empty file / a truncated blob / an Apple-optimized PNG would otherwise
38
76
  * become a malformed `ImageContent` that makes the NEXT provider request fail (400). Pure — no I/O. */
@@ -149,6 +187,8 @@ export interface ToolResultMediaAdmission {
149
187
  content: unknown[];
150
188
  refused: ToolResultMediaRefusal[];
151
189
  }
190
+ /** The media type a block claims — its `type`, read once, when that is a media type — or `undefined` for any other value. */
191
+ export declare function claimedMediaType(block: unknown): MediaBlock["type"] | undefined;
152
192
  /**
153
193
  * The decoded size of the first image block that goes to the model over `IMAGE_ADMISSION.soft.targetBytes` with no
154
194
  * processor to bring it down — the one fact the run's operator notice reads (`config.image_processor_unavailable`), at
@@ -1,6 +1,6 @@
1
1
  import { createHash } from "node:crypto";
2
- import { claimedMediaType } from "./media-byte-cap.js";
3
2
  import { readMember } from "./thrown-value.js";
3
+ import { describeRejectedValue } from "./tool-search-setting.js";
4
4
  export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
5
5
  const spells = (b, at, text) => {
6
6
  if (b.length < at + text.length)
@@ -22,16 +22,42 @@ const IMAGE_HEADER_CHECKS = Object.freeze({
22
22
  "image/webp": (b) => b.length >= 16 && spells(b, 0, "RIFF") && spells(b, 8, "WEBP") && (spells(b, 12, "VP8 ") || spells(b, 12, "VP8L") || spells(b, 12, "VP8X")),
23
23
  });
24
24
  const MiB = 1024 * 1024;
25
+ const IMAGE_BASE64_CHARS = 5 * MiB;
26
+ const IMAGE_BASE64_RAW_BYTES = (IMAGE_BASE64_CHARS * 3) / 4;
25
27
  export const IMAGE_ADMISSION = Object.freeze({
26
28
  hard: Object.freeze({
27
29
  formats: IMAGE_HEADER_CHECKS,
28
- readBytes: Object.freeze({ withoutProcessor: 5 * MiB, withProcessor: 64 * MiB }),
30
+ readBytes: Object.freeze({ withoutProcessor: IMAGE_BASE64_RAW_BYTES, withProcessor: 64 * MiB }),
29
31
  urlBytes: 20 * MiB,
30
32
  rejectEdge: 2000,
31
- imageBase64Chars: 5 * MiB,
33
+ imageBase64Chars: IMAGE_BASE64_CHARS,
34
+ }),
35
+ soft: Object.freeze({ frameEdge: 2000, rawBytes: IMAGE_BASE64_RAW_BYTES, targetBytes: 512_000 }),
36
+ request: Object.freeze({
37
+ maxItems: 100,
38
+ largeWindow: Object.freeze({ fromContextWindow: 1_000_000, maxItems: 600 }),
39
+ margin: 20,
40
+ budgetBase64Chars: 40 * MiB,
41
+ hysteresisBase64Chars: 10 * MiB,
32
42
  }),
33
- soft: Object.freeze({ frameEdge: 2000, rawBytes: (5 * MiB * 3) / 4, targetBytes: 512_000 }),
34
43
  });
44
+ const smallestRequestMediaBudget = () => 2 * IMAGE_ADMISSION.request.hysteresisBase64Chars;
45
+ export function requestMediaBudget(knob) {
46
+ const budget = knob ?? IMAGE_ADMISSION.request.budgetBase64Chars;
47
+ return budget === 0 ? Infinity : budget;
48
+ }
49
+ export function requestMediaLimits(model, knob) {
50
+ const { maxItems, largeWindow, margin, hysteresisBase64Chars } = IMAGE_ADMISSION.request;
51
+ const window = model.contextWindow;
52
+ return { maxItems: typeof window === "number" && window >= largeWindow.fromContextWindow ? largeWindow.maxItems : maxItems, margin, budgetBase64Chars: requestMediaBudget(knob), hysteresisBase64Chars };
53
+ }
54
+ export function checkedRequestMediaBudget(value, seat) {
55
+ if (value === undefined || value === 0 || value === Infinity || (Number.isInteger(value) && value >= smallestRequestMediaBudget()))
56
+ return;
57
+ const e = new Error(`${seat} ${describeRejectedValue(value)} is not a request media budget — expected a whole number of base64 characters of at least ${smallestRequestMediaBudget()} (twice the ${IMAGE_ADMISSION.request.hysteresisBase64Chars}-character margin a cut leaves under the budget), 0 or Infinity for no budget, or omit it for the default ${IMAGE_ADMISSION.request.budgetBase64Chars}`);
58
+ e.code = "config.invalid_argument";
59
+ throw e;
60
+ }
35
61
  export function imageMagicMatches(bytes, mimeType) {
36
62
  const formats = IMAGE_ADMISSION.hard.formats;
37
63
  return Object.hasOwn(formats, mimeType) && formats[mimeType](bytes);
@@ -188,6 +214,11 @@ const placeholderOf = (toolName, r) => ({
188
214
  type: "text",
189
215
  text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
190
216
  });
217
+ const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
218
+ export function claimedMediaType(block) {
219
+ const type = readMember(block, "type");
220
+ return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
221
+ }
191
222
  const claimsMedia = (block) => claimedMediaType(block) !== undefined;
192
223
  async function admitBlock(block, processor) {
193
224
  const type = claimedMediaType(block);
@@ -0,0 +1,36 @@
1
+ import type { RunInternals } from "./runner/contracts.js";
2
+ export declare const INPUT_AUTHORS: readonly ["operator", "parent_model", "workflow", "peer", "observer", "engine"];
3
+ export type InputAuthor = (typeof INPUT_AUTHORS)[number];
4
+ /** Membership test for {@link InputAuthor}. */
5
+ export declare function isInputAuthor(v: unknown): v is InputAuthor;
6
+ /** An author as read: a member of the set, or `unknown` for anything else. */
7
+ export type InputAuthorReading = InputAuthor | "unknown";
8
+ /** The one reader: a member reads as itself, anything else (`undefined` included) as `unknown`. */
9
+ export declare function readInputAuthor(raw: unknown): InputAuthorReading;
10
+ /** THE predicate: does this input count as the operator's — screened by `classic.UserPromptSubmit`, carried across a pause, on
11
+ * the person's undelivered-input account? An unreadable word does (a filter's safe side); the five other words do not. */
12
+ export declare function countsAsOperator(reading: InputAuthorReading): boolean;
13
+ /**
14
+ * The objective's author on a leg, from the trusted channel's word (`RunInternals.objectiveAuthor`): absent is the public
15
+ * entry's own mint, `operator` — the host that called `runTask` wrote the objective or relays the person who did; a member is
16
+ * itself; anything else is `unknown`, screened like the operator's, and its sentence is handed to `onUnreadable` (the caller
17
+ * reports it once).
18
+ */
19
+ export declare function objectiveAuthorOf(declared: unknown, onUnreadable: (error: Error) => void): InputAuthorReading;
20
+ /** The trusted channel of a recipe's continuation leg — the one mint of `engine`: a fresh shallow copy of the internals the leg rides
21
+ * otherwise, its objective the recipe's own words (the caller's request rode the recipe's first leg). A composition whose later legs
22
+ * re-run the caller's objective (a cascade's rungs) does not call it. */
23
+ export declare function recipeContinuationLeg(internals: RunInternals | undefined): RunInternals;
24
+ /**
25
+ * The engine's own relay into a running stream's steer lane, under the author it states. The public `TaskStream.steer` mints
26
+ * `operator` on every call; this seat is how the engine hands a stream an input someone else wrote (an observer's report). It
27
+ * lives on the stream object the Runner minted — registered here, never on the package face — so no caller can name an author.
28
+ */
29
+ export type AuthoredSteer = (author: InputAuthor, text: string) => Promise<void>;
30
+ /** Register the authored steer of a stream the Runner minted (the driver calls this once per stream). */
31
+ export declare function bindAuthoredSteer(stream: object, steer: AuthoredSteer): void;
32
+ /** The authored steer of a stream the Runner minted; `undefined` for any other object. */
33
+ export declare function authoredSteerOf(stream: object): AuthoredSteer | undefined;
34
+ /** The terminal account's sentence for inputs of other authors a run accepted and never delivered: they are dropped, never
35
+ * carried across a pause and never counted as the person's (the caller hands it to `onError` once, `phase: "degraded"`). */
36
+ export declare function droppedInputsDisclosure(authors: readonly InputAuthor[]): Error;
@@ -0,0 +1,39 @@
1
+ import { describeRejectedValue } from "./tool-search-setting.js";
2
+ export const INPUT_AUTHORS = Object.freeze(["operator", "parent_model", "workflow", "peer", "observer", "engine"]);
3
+ const INPUT_AUTHOR_SET = new Set(INPUT_AUTHORS);
4
+ export function isInputAuthor(v) {
5
+ return INPUT_AUTHOR_SET.has(v);
6
+ }
7
+ export function readInputAuthor(raw) {
8
+ return isInputAuthor(raw) ? raw : "unknown";
9
+ }
10
+ const COUNTS_AS_OPERATOR = Object.freeze({ operator: true, parent_model: false, workflow: false, peer: false, observer: false, engine: false });
11
+ export function countsAsOperator(reading) {
12
+ return reading === "unknown" || COUNTS_AS_OPERATOR[reading];
13
+ }
14
+ export function objectiveAuthorOf(declared, onUnreadable) {
15
+ if (declared === undefined)
16
+ return "operator";
17
+ const reading = readInputAuthor(declared);
18
+ if (reading === "unknown") {
19
+ onUnreadable(new Error(`RunInternals.objectiveAuthor ${describeRejectedValue(declared)} is not an input author (${INPUT_AUTHORS.join(" / ")}) — the objective is screened as the operator's`));
20
+ }
21
+ return reading;
22
+ }
23
+ export function recipeContinuationLeg(internals) {
24
+ return { ...internals, objectiveAuthor: "engine" };
25
+ }
26
+ const authoredSteers = new WeakMap();
27
+ export function bindAuthoredSteer(stream, steer) {
28
+ authoredSteers.set(stream, steer);
29
+ }
30
+ export function authoredSteerOf(stream) {
31
+ return authoredSteers.get(stream);
32
+ }
33
+ export function droppedInputsDisclosure(authors) {
34
+ const counts = new Map();
35
+ for (const a of authors)
36
+ counts.set(a, (counts.get(a) ?? 0) + 1);
37
+ const named = [...counts].map(([a, n]) => `${n} from ${a}`).join(", ");
38
+ return new Error(`the run ended with ${authors.length} accepted input(s) it never delivered that are not the operator's (${named}): they are dropped — only an operator's input is carried across a pause or counted as the person's undelivered input`);
39
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * A leg's two identity readings, as pure functions with no runtime imports — so a store's projection reads them exactly as
3
+ * the prepare mint and the stations do (one predicate each, never a second spelling at a reader that cannot reach the
4
+ * mods layer).
5
+ */
6
+ import type { HookInvocationIdentity } from "./hooks.js";
7
+ import type { AskSourceIdentity } from "./tool-policy.js";
8
+ /**
9
+ * The id a delegated leg's events carry as `agentId`: the leg's task id ({@link legTaskIdOf}) — for a background child, the
10
+ * registry task id its spawner registered it under (the string its row, launch card, notifications, `TaskStop` and
11
+ * `SendMessage` use); a foreground child has no row, so it is its session id. A top-level leg carries none. It reads two facts of
12
+ * the leg's identity, so a face minted before the leg's hook envelope (the ask source) asks it with the same two, and a parked
13
+ * row's summary asks it with the two the row records.
14
+ */
15
+ export declare function agentIdOf(identity: Pick<HookInvocationIdentity, "taskId" | "isDelegatedChild"> | undefined): string | undefined;
16
+ /** A leg's task id — the row a delegation lane runs it as (`internals.rowTaskId`), else its host's `spec.taskId`, else its
17
+ * session id. Minted once at prepare (`Prepared.taskId`); a reader before prepare asks this same function (the resume screen;
18
+ * the throw backstop, which has no session yet). The session id is the leg's transcript address. */
19
+ export declare function legTaskIdOf(spec: {
20
+ readonly taskId?: string | undefined;
21
+ }, internals: {
22
+ readonly rowTaskId?: string | undefined;
23
+ } | undefined, sessionId: string): string;
24
+ export declare function legTaskIdOf(spec: {
25
+ readonly taskId?: string | undefined;
26
+ }, internals: {
27
+ readonly rowTaskId?: string | undefined;
28
+ } | undefined, sessionId: string | undefined): string | undefined;
29
+ /** The facts a leg's ask source is minted from — all the leg's own, read once its session and task id are minted. */
30
+ export interface AskSourceFacts {
31
+ /** The leg's end-user principal (its spec's). */
32
+ readonly principal: string | undefined;
33
+ /** The leg's session id: the conversation every ask of the leg is raised in. */
34
+ readonly sessionId: string;
35
+ /** The leg's one task id ({@link legTaskIdOf}, as minted at prepare). */
36
+ readonly taskId: string;
37
+ /** The leg's effective delegation fact — forks included, the checkpoint's record on a deps-only resume. */
38
+ readonly isDelegatedChild: boolean;
39
+ /** The leg's trusted internals: the parent link and the display names. */
40
+ readonly internals: {
41
+ readonly parentTaskId?: string | undefined;
42
+ readonly explicitAgentName?: string | undefined;
43
+ readonly agentName?: string | undefined;
44
+ } | undefined;
45
+ }
46
+ /**
47
+ * The leg's ask source, minted ONCE per leg and read by every face that names the issuing leg: the four `resolveAsk`
48
+ * construction sites (the main gate, both inherited wrapper arms, the approved-edit re-ask) spread it, the question tool and
49
+ * the gate's question routing project it, and the approval and plan_review parks stamp its session onto the row — so the
50
+ * explicit "from a background agent" discriminator can never be dropped on one leg, and the same leg is never named two ways.
51
+ * Every member is a fact of THIS leg's own prepare (an inherited ask fires in the child's gate): `internals` never rides a
52
+ * TaskSpec, so a worker cannot self-declare or suppress them.
53
+ *
54
+ * - `sourceSessionId` — the leg's session: the conversation, never a task.
55
+ * - `agentId` — {@link agentIdOf} over the leg's task id and delegation fact: present exactly on a delegated child.
56
+ * - `fromSubagent` — the attribution discriminator: trusted `parentTaskId` presence (a directly-started workflow's agent has
57
+ * none, so it carries `agentId` without it).
58
+ * - `isDelegatedChild` — the refusal posture: the RAW delegation fact, forks included (a fork's interaction contract is
59
+ * one-shot — "no waiting for the user" — so a stop-and-wait refusal would ask it the impossible), so `resolveAsk`'s human
60
+ * refusal texts speak the right posture (parent thread: stop and wait for the user; delegated child: adapt or report).
61
+ */
62
+ export declare function mintAskSourceIdentity(leg: AskSourceFacts): AskSourceIdentity;
@@ -0,0 +1,18 @@
1
+ export function agentIdOf(identity) {
2
+ return identity?.isDelegatedChild === true ? identity.taskId : undefined;
3
+ }
4
+ export function legTaskIdOf(spec, internals, sessionId) {
5
+ return internals?.rowTaskId ?? spec.taskId ?? sessionId;
6
+ }
7
+ export function mintAskSourceIdentity(leg) {
8
+ const agentId = agentIdOf({ taskId: leg.taskId, isDelegatedChild: leg.isDelegatedChild });
9
+ const sourceAgentName = leg.internals?.explicitAgentName ?? leg.internals?.agentName;
10
+ return Object.freeze({
11
+ principal: leg.principal,
12
+ sourceSessionId: leg.sessionId,
13
+ ...(agentId !== undefined ? { agentId } : {}),
14
+ ...(leg.internals?.parentTaskId !== undefined ? { fromSubagent: true } : {}),
15
+ ...(sourceAgentName !== undefined ? { sourceAgentName } : {}),
16
+ ...(leg.isDelegatedChild ? { isDelegatedChild: true } : {}),
17
+ });
18
+ }
@@ -204,7 +204,8 @@ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
204
204
  /**
205
205
  * The host-transport question for ONE snapshot MCP entry: a `{ kind: "host" }` transport carries no member beyond its kind (its host seat
206
206
  * carries its own pieces — a reference, a principal header, a command or a url would be declared and never in force), and its server
207
- * cannot opt in to `elicitation` (the seat answers the engine's requests only: a server's request has no way back). Either refuses under
207
+ * cannot opt in to `elicitation` (the server behind a host's pipe is the host's own code: a question it has for the user goes through the
208
+ * host's own interface, and the engine advertises no elicitation for it). Either refuses under
208
209
  * `config.invalid_argument`, naming the server and the member. Any other entry is unchanged.
209
210
  */
210
211
  export declare function judgeEntryHostTransport(copy: McpServerSpec): {
@@ -3,7 +3,7 @@ import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RU
3
3
  import { isPlainRecord, receive } from "./mods/kernel/receive.js";
4
4
  import { TOOL_FACE_WORDS, readToolFaces } from "./tool-face-reader.js";
5
5
  import { judgeSessionMetaKey } from "./mcp-call-meta.js";
6
- import { CONFIG_RECEIPT_MODE } from "./own-property-receipt.js";
6
+ import { CONFIG_RECEIPT_MODE, optionKeys, strayMembersOf } from "./own-property-receipt.js";
7
7
  import { isToolContentOrigin, TOOL_CONTENT_ORIGINS } from "./memory-engine/content-origin.js";
8
8
  import { inlineUntrusted } from "./untrusted-text.js";
9
9
  import { assertNoRetiredToolPolicyKeys } from "./retired-keys.js";
@@ -150,15 +150,17 @@ export function judgeEntrySessionMetaKey(copy) {
150
150
  return { ok: true, entry: copy };
151
151
  return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${inlineUntrusted(read.problem, 200)}. The key decides where the leg's session id rides on this server's requests, so it is refused rather than dropped or defaulted — a connector keyed on a session it never receives would share one state across every session.`) };
152
152
  }
153
+ const HOST_TRANSPORT_KEYS = optionKeys()({ kind: 0 });
153
154
  export function judgeEntryHostTransport(copy) {
154
155
  const transport = copy.transport;
155
156
  if (!isPlainRecord(transport) || transport["kind"] !== "host")
156
157
  return { ok: true, entry: copy };
157
- const extra = Object.keys(transport).find((member) => member !== "kind" && transport[member] !== undefined);
158
+ const stray = strayMembersOf(transport, { subject: "a host-supplied transport", unit: "member", moment: "when the entry is read" }, HOST_TRANSPORT_KEYS)?.names[0];
159
+ const extra = stray === undefined ? undefined : String(stray);
158
160
  const problem = extra !== undefined
159
161
  ? `a host-supplied transport with the member ${inlineUntrusted(JSON.stringify(extra), 80)}: a host transport carries its kind alone — the host seat carries what each request needs, so a member here would read as in force while nothing carries it`
160
162
  : copy.elicitation === true
161
- ? `elicitation on a host-supplied transport: the host seat answers the engine's requests only, so a server's question would have no way back`
163
+ ? `elicitation on a host-supplied transport: the server behind a host's pipe is the host's own code, so a question it has for the user goes through the host's own interface — the engine advertises no elicitation for it`
162
164
  : undefined;
163
165
  return problem === undefined ? { ok: true, entry: copy } : { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${problem}.`) };
164
166
  }
@@ -2,7 +2,7 @@ import { type RootsSeat } from "../tools/fs/safety.js";
2
2
  import { type ReadDenyMatcher } from "../tools/fs/read-deny.js";
3
3
  import type { HomeViewsCarrier } from "../tools/fs/read-deny-home.js";
4
4
  import type { ContainmentFace } from "../tools/fs/containment-face.js";
5
- import type { AgentTool, BoundFileObject, ExecutionEnv } from "../internal/harness-types.js";
5
+ import type { AgentTool, BoundFileObject, ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
6
6
  /**
7
7
  * LSP code-intelligence tool (design/64 §13.1) — the app-dev命门 (go-to-def / find-refs / hover across
8
8
  * Dart/Kotlin/TS). A single `lsp` tool with a 9-operation enum, built over a pluggable {@link LspServerManager}.
@@ -301,6 +301,8 @@ export interface LspToolOptions {
301
301
  export declare function createLspTool(manager: LspServerManager, opts?: LspToolOptions): AgentTool;
302
302
  /**
303
303
  * A git-check-ignore-based path filter for {@link LspToolOptions.isPathIgnored} (CC parity). Best-effort:
304
- * if git isn't available or the check fails, nothing is treated as ignored (keep all). Caches per path.
304
+ * if git isn't available or the check fails, nothing is treated as ignored (keep all). Caches per path. `readFloor` = the
305
+ * byte floor each check's start carries, read as it starts (a run's: the run's base table; absent ⇒ none — a caller with
306
+ * no run). A floor that cannot be read is a failed check.
305
307
  */
306
- export declare function gitCheckIgnoreFilter(env: ExecutionEnv, root: string): (uri: string) => Promise<boolean>;
308
+ export declare function gitCheckIgnoreFilter(env: ExecutionEnv, root: string, readFloor?: () => ReadFloor | undefined): (uri: string) => Promise<boolean>;
package/dist/core/lsp.js CHANGED
@@ -349,7 +349,7 @@ function toModelBase(result) {
349
349
  }
350
350
  return result;
351
351
  }
352
- export function gitCheckIgnoreFilter(env, root) {
352
+ export function gitCheckIgnoreFilter(env, root, readFloor) {
353
353
  const cache = new Map();
354
354
  return async (uri) => {
355
355
  const path = uriToPath(uri);
@@ -359,7 +359,8 @@ export function gitCheckIgnoreFilter(env, root) {
359
359
  let ignored = false;
360
360
  try {
361
361
  const q = `'${path.replace(/'/g, `'\\''`)}'`;
362
- const res = await env.exec(`git check-ignore ${q}`, { cwd: root, timeout: 10 });
362
+ const floor = readFloor?.();
363
+ const res = await env.exec(`git check-ignore ${q}`, { cwd: root, timeout: 10, ...(floor !== undefined ? { readFloor: floor } : {}) });
363
364
  ignored = res.ok && res.value.exitCode === 0;
364
365
  }
365
366
  catch {