@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1022,11 +1022,11 @@ export async function jsGrep(env, root, p, signal, guards, deny, denyOut) {
1022
1022
  return (await jsGrepDetailed(env, root, p, signal, guards, deny, denyOut)).text;
1023
1023
  }
1024
1024
  const rgCache = new WeakMap();
1025
- export function detectRipgrep(env) {
1025
+ export function detectRipgrep(env, readFloor) {
1026
1026
  let cached = rgCache.get(env);
1027
1027
  if (!cached) {
1028
1028
  cached = env
1029
- .exec("rg --version", { timeout: 10 })
1029
+ .exec("rg --version", { timeout: 10, ...(readFloor !== undefined ? { readFloor } : {}) })
1030
1030
  .then((r) => r.ok && r.value.exitCode === 0)
1031
1031
  .catch(() => false);
1032
1032
  rgCache.set(env, cached);
@@ -1174,7 +1174,7 @@ async function jsGrepFallback(env, root, p, signal, reason, deny) {
1174
1174
  ...(denyOut.withheld !== undefined ? { withheld: denyOut.withheld } : {}),
1175
1175
  };
1176
1176
  }
1177
- export async function rgGrepDetailed(env, root, p, signal, deny) {
1177
+ export async function rgGrepDetailed(env, root, p, signal, deny, readFloor) {
1178
1178
  const mode = p.output_mode ?? "files_with_matches";
1179
1179
  const flags = ["--null", "-H", "--no-messages", "--no-require-git", "--hidden"];
1180
1180
  for (const d of VCS_DIRS)
@@ -1209,7 +1209,7 @@ export async function rgGrepDetailed(env, root, p, signal, deny) {
1209
1209
  flags.push(g.flag, shellQuote(g.glob));
1210
1210
  const target = p.path ? shellQuote(p.path) : ".";
1211
1211
  const cmd = `rg ${flags.join(" ")} -e ${shellQuote(p.pattern)} -- ${target}`;
1212
- const res = await env.exec(cmd, { cwd: root, timeout: 60, abortSignal: signal });
1212
+ const res = await env.exec(cmd, { cwd: root, timeout: 60, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
1213
1213
  if (!res.ok) {
1214
1214
  const err = res.error;
1215
1215
  if (err.code === "aborted" || signal?.aborted === true)
@@ -1244,7 +1244,7 @@ export async function rgGrepDetailed(env, root, p, signal, deny) {
1244
1244
  if (info.ok && info.value.kind === "file")
1245
1245
  return { note: "" };
1246
1246
  }
1247
- const withheld = await rgDenyExistenceProbe(env, root, deny, target, signal);
1247
+ const withheld = await rgDenyExistenceProbe(env, root, deny, target, signal, readFloor);
1248
1248
  if (withheld === undefined)
1249
1249
  return { note: "" };
1250
1250
  const note = withheld.kind === "existence"
@@ -1284,14 +1284,14 @@ export async function rgGrepDetailed(env, root, p, signal, deny) {
1284
1284
  const formatted = formatRgRecords(ordered, p);
1285
1285
  return { text: formatted.text + d.note, rows: formatted.served, ...(d.withheld !== undefined ? { withheld: d.withheld } : {}) };
1286
1286
  }
1287
- async function rgDenyExistenceProbe(env, root, deny, target, signal) {
1287
+ async function rgDenyExistenceProbe(env, root, deny, target, signal, readFloor) {
1288
1288
  const probeFlags = ["--files", "--hidden", "--no-require-git", "--no-messages"];
1289
1289
  for (const d of VCS_DIRS)
1290
1290
  probeFlags.push("--glob", `!${d}`);
1291
1291
  for (const g of deny.rgProbeGlobs)
1292
1292
  probeFlags.push(g.flag, shellQuote(g.glob));
1293
1293
  try {
1294
- const res = await env.exec(`( rg ${probeFlags.join(" ")} -- ${target}; echo "__RG_PROBE_EXIT_$?" 1>&2 ) | head -n 1`, { cwd: root, timeout: 10, abortSignal: signal });
1294
+ const res = await env.exec(`( rg ${probeFlags.join(" ")} -- ${target}; echo "__RG_PROBE_EXIT_$?" 1>&2 ) | head -n 1`, { cwd: root, timeout: 10, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
1295
1295
  if (!res.ok)
1296
1296
  return { kind: "probe_failed" };
1297
1297
  const first = res.value.stdout.split("\n").find((l) => l.trim().length > 0);
@@ -1313,7 +1313,7 @@ async function rgDenyExistenceProbe(env, root, deny, target, signal) {
1313
1313
  return { kind: "probe_failed" };
1314
1314
  }
1315
1315
  }
1316
- export async function runGrepDetailed(env, root, p, signal, deny) {
1316
+ export async function runGrepDetailed(env, root, p, signal, deny, readFloor) {
1317
1317
  const scope = p.path ? anchorSpelling(pathFamilyOf({ root }), root, p.path) : root;
1318
1318
  const unexcludableUnder = async () => {
1319
1319
  if (deny === undefined)
@@ -1325,8 +1325,8 @@ export async function runGrepDetailed(env, root, p, signal, deny) {
1325
1325
  return false;
1326
1326
  return deny.unexcludableUnder(scope) || (home.view !== undefined && deny.unexcludableUnder(home.view));
1327
1327
  };
1328
- if (!(await unexcludableUnder()) && (await detectRipgrep(env)))
1329
- return rgGrepDetailed(env, root, p, signal, deny);
1328
+ if (!(await unexcludableUnder()) && (await detectRipgrep(env, readFloor)))
1329
+ return rgGrepDetailed(env, root, p, signal, deny, readFloor);
1330
1330
  const denyOut = {};
1331
1331
  const { text, rows } = await jsGrepDetailed(env, root, p, signal, undefined, deny, denyOut);
1332
1332
  return { text, ...(rows !== undefined ? { rows } : {}), ...(denyOut.withheld !== undefined ? { withheld: denyOut.withheld } : {}) };
@@ -6,6 +6,7 @@ import { judgedCandidatesOf, sedBackupNames } from "./shell-read-write-targets.j
6
6
  import { movedReads, withHomeViews } from "./shell-read-identity.js";
7
7
  import { passesUnasked } from "./shell-read-device.js";
8
8
  import { compileFsGlob, fsGlobClass } from "./fs-glob.js";
9
+ import { chainHopsOrNone, leafChainMayHold, symlinkChainHops } from "../../core/path-identity.js";
9
10
  const GLOB_METACHAR_RE = /[*?[]/;
10
11
  export const MAX_GLOB_DIRS = 256;
11
12
  export const MAX_GLOB_MATCHES = 8192;
@@ -391,7 +392,8 @@ function establishLegOver(seen, readRoots) {
391
392
  if (!real.exact && real.missing !== true) {
392
393
  return { candidate, established: "unestablishable", spellings, ...(origin !== undefined ? { origin } : {}), cause: `"${spelling}" cannot be resolved to verify where it reads`, unresolved: true };
393
394
  }
394
- return { candidate, established, target: real.value, spellings, ...(origin !== undefined ? { origin } : {}) };
395
+ const hops = seat === "landing" && leafChainMayHold([spelling], !real.exact || real.value !== normalizeAbsPathLexically(spelling), family) ? chainHopsOrNone(await symlinkChainHops(env, spelling, signal, family)) : [];
396
+ return { candidate, established, target: real.value, spellings, ...(origin !== undefined ? { origin } : {}), ...(hops.length > 0 ? { hops } : {}) };
395
397
  };
396
398
  const followedName = async (spelled, base, homeDir, signal) => {
397
399
  let name = spelled;
@@ -2,7 +2,9 @@ import type { EstablishedPlan } from "./shell-read-establish.js";
2
2
  import type { ObservedEnvironment } from "./shell-read-environment.js";
3
3
  import type { EstablishedRead } from "./shell-read-judge.js";
4
4
  import { type HomeViewsCarrier } from "./read-deny-home.js";
5
- /** Every read of either establishment whose candidate's settled target set differs between the two. */
5
+ /** Every read of either establishment whose candidate's settled target set — or the set of link-chain hops it was judged
6
+ * through ({@link EstablishedRead.hops}: a chain re-pointed through another directory may keep its terminal) — differs
7
+ * between the two. */
6
8
  export declare function movedReads(previous: EstablishedPlan, again: EstablishedPlan): EstablishedRead[];
7
9
  /** One read candidate's landing: its key and where it settled, each as a sha256 hex digest (the key's raw tuple joins on
8
10
  * NUL and follows the command's length; a pattern lands on up to thousands of entries), with the raw word and the
@@ -7,7 +7,7 @@ export function movedReads(previous, again) {
7
7
  for (const key of new Set([...before.keys(), ...after.keys()])) {
8
8
  const b = before.get(key);
9
9
  const a = after.get(key);
10
- if (b !== undefined && a !== undefined && landingOf(b.targets) === landingOf(a.targets))
10
+ if (b !== undefined && a !== undefined && landingOf(b.targets) === landingOf(a.targets) && landingOf(b.hops) === landingOf(a.hops))
11
11
  continue;
12
12
  changed.push(...(b?.reads ?? []), ...(a?.reads ?? []));
13
13
  }
@@ -27,11 +27,13 @@ function targetsByCandidate(e) {
27
27
  for (const r of p.reads.get(segment) ?? []) {
28
28
  const c = r.candidate;
29
29
  const key = [at, si, c.denyOnly === true ? "floor" : "read", c.provenance, c.spelled, String(c.expands), c.raw].join("\0");
30
- const landing = out.get(key) ?? { targets: new Set(), reads: [] };
30
+ const landing = out.get(key) ?? { targets: new Set(), hops: new Set(), reads: [] };
31
31
  out.set(key, landing);
32
32
  landing.reads.push(r);
33
33
  if ((r.established === "canonical" || r.established === "expansion") && r.target !== undefined)
34
34
  landing.targets.add(r.target);
35
+ for (const hop of r.hops ?? [])
36
+ landing.hops.add(hop);
35
37
  }
36
38
  segment.nested.forEach((n, ni) => {
37
39
  const nested = p.nested.get(n);
@@ -5,7 +5,8 @@
5
5
  *
6
6
  * · `judgeRead` judges ONE established candidate: the deny half first, over every view the candidate has
7
7
  * (its canonical target, its folded spelling, the kernel spelling of a `..` operand, the folded spelling
8
- * of a candidate that could not be established), then containment over the canonical target alone. The
8
+ * of a candidate that could not be established, the hops of its leaf symlink chain), then containment over
9
+ * the canonical target alone. The
9
10
  * deny judge is the boundary's own `denyMatch` closure (`readDenySeat`, read-deny.ts) — the same function
10
11
  * object every read face mounts; nothing here compiles a pattern or re-derives a view set. The containment
11
12
  * judge is `withinAnyRoot` over the roots the boundary declares — a WRITE target's over the write roots, at the
@@ -248,6 +249,11 @@ export interface EstablishedRead {
248
249
  * name of a GNU sed `--follow-symlinks` backup when the operand's links supplied it. Every other spelling is the command's
249
250
  * own text (folded, or as the kernel walks it). Absent ⇒ none. */
250
251
  readonly derivedSpellings?: readonly string[];
252
+ /** The hops of the landed target's LEAF symlink chain — each an unresolved spelling some link on the way wrote — where the
253
+ * program follows the target's links (the landing seat): the views a call's target reading judges beside the canonical
254
+ * and the lexical one, read through the same chain reader. Deny views only: not a spelling the
255
+ * command wrote, not a containment candidate, not a write view of its own. Absent ⇒ none read. */
256
+ readonly hops?: readonly string[];
251
257
  /** The pattern or traversal root an `expansion` came from, as folded. */
252
258
  readonly origin?: string;
253
259
  /** What the environment said the target IS, where a read asked — only a traversal root asks (it lists the root
@@ -46,7 +46,7 @@ export function judgeRead(read, boundary) {
46
46
  const writeTarget = read.candidate.face === "write";
47
47
  const deny = writeTarget ? boundary.writeDenyMatch : boundary.denyMatch;
48
48
  if (deny !== undefined) {
49
- const views = [...(read.target !== undefined ? [read.target] : []), ...read.spellings];
49
+ const views = [...(read.target !== undefined ? [read.target] : []), ...read.spellings, ...(read.hops ?? [])];
50
50
  for (const view of views) {
51
51
  const folded = normalizeAbsPathLexically(view);
52
52
  const pattern = writeTarget ? boundary.writeDenyMatch(folded) : boundary.denyMatch(folded);
@@ -6,7 +6,7 @@
6
6
  * CC-parity semantics (live-harness schema, the archived ground truth):
7
7
  * ① every stdout LINE becomes one event; ② lines within the 200ms batch window coalesce into ONE
8
8
  * notification; ③ process exit ends the watch (exit code reported); ④ non-persistent watches are killed at
9
- * `timeout_ms` (default 5min, max 60min); ⑤ stderr never notifies but is spooled (TaskOutput-readable);
9
+ * `timeout_ms` (default 5min, max 60min); ⑤ stderr never notifies but is mirrored to the output file (with stdout);
10
10
  * ⑥ an event storm is SUPPRESSED first and auto-stops the monitor only if it persists (RB-334, CC `PCo`
11
11
  * 220:403278-403321 two-level control — the suppressed count and the overload duration are disclosed
12
12
  * on both the suppression frame and the stop notification).
@@ -25,7 +25,8 @@
25
25
  * in-window non-persistent watch alive (process on the dispose except-list, watcher ticking, row kept), so
26
26
  * cross-turn watching — CC's main Monitor use case — works with the default persistent:false too; its
27
27
  * between-turns events AND its timeout/exit terminal ride the same pending lane.
28
- * The handle is a first-class m* registry task: TaskOutput serves the re-readable spool, TaskStop stops the
28
+ * The handle is a first-class m* registry task: its output file is the full record (Read-exempt like a background
29
+ * Bash's, `TaskRegistry.isBackgroundOutputFile`), TaskStop stops the
29
30
  * watch (design/134 stoppedBy attribution applies automatically).
30
31
  *
31
32
  * Security posture: `command` is an arbitrary shell script ⇒ effect:"write", same as Bash; the catalog puts Monitor on the
@@ -40,10 +41,12 @@
40
41
  */
41
42
  import type { AgentTool, ExecutionEnv } from "../internal/harness-types.js";
42
43
  import { type MonitorTimers, type TaskRegistry } from "../core/task-registry.js";
43
- import type { TaskNotificationPayload } from "../core/task-notification.js";
44
- import type { ToolResultStore } from "../core/tool-result-store.js";
44
+ import { type TaskNotificationPayload } from "../core/task-notification.js";
45
45
  import type { ShellReadAdmission } from "./fs/shell-read-check.js";
46
46
  import type { ReadFloorSeat } from "./fs/read-floor.js";
47
+ /** The refusal a watch gets where no event or completion would come back from it (no completion sink for the call, no
48
+ * mount sink): nothing is spawned. */
49
+ export declare const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here \u2014 no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
47
50
  export interface MonitorToolOptions {
48
51
  registry: TaskRegistry;
49
52
  /** Fallbacks when the runtime ctx carries no identity (direct mounts) — same posture as createBashTool. */
@@ -52,8 +55,8 @@ export interface MonitorToolOptions {
52
55
  /** design/129: the session id — a `persistent` monitor registers session-scoped under it (outlives the
53
56
  * turn; reaped by the deployment's session release via `reapSessionBackground`). */
54
57
  sessionId?: string;
55
- /** The notification sink (the run-local task-notification lane). Without it the monitor still runs and
56
- * spools — readable via TaskOutput — but no events reach the model (the tool reply says so honestly). */
58
+ /** The notification sink (the run-local task-notification lane). A call carrying its run's lane delivers there
59
+ * instead; with neither, the watch is refused before anything is spawned (nothing it saw would reach the model). */
57
60
  onTaskNotification?: (n: TaskNotificationPayload, opts?: {
58
61
  priority?: "now" | "next" | "later";
59
62
  }) => void;
@@ -66,10 +69,9 @@ export interface MonitorToolOptions {
66
69
  /** Test/deployment knobs (defaults: 200ms window, 50 batches/min). */
67
70
  batchWindowMs?: number;
68
71
  maxBatchesPerMinute?: number;
69
- /** design/158 S2 (RB-364 半): the offload store a rolled-off spool middle spills to (see
70
- * task-registry-monitor.ts's spill helper). Absent ⇒ legal degrade, byte-identical rolling (no spill,
71
- * same loss shape as before this design). */
72
- toolResultStore?: ToolResultStore;
72
+ /** This run is a one-shot submission (`TaskSpec.oneShot`): its ending does not wait for the watch, and the
73
+ * receipt says so with the one process-lane sentence a background command's receipt carries. */
74
+ oneShot?: boolean;
73
75
  /** The gate's shell read station's pre-spawn ADMISSION — the SAME option `createBashTool` takes: this face
74
76
  * spawns a shell command too, so what it runs is what the station judged, re-established before the watch
75
77
  * spawns. Absent ⇒ no station judged this mount; nothing is re-established. */
@@ -1,18 +1,21 @@
1
1
  import { Type } from "typebox";
2
2
  import { defineTool, errorResult } from "../core/tools.js";
3
- import { envDeclaresRetain, hasBackgroundShell, retainsBackgroundProcesses } from "../core/background-shell.js";
3
+ import { createBackgroundOutputFile, envDeclaresRetain, hasBackgroundShell, retainsBackgroundProcesses } from "../core/background-shell.js";
4
4
  import { MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, } from "../core/task-registry.js";
5
+ import { admitsBackgroundLaunch, resolveCompletionSink } from "../core/task-notification.js";
5
6
  import { toolFace } from "../core/tool-catalog-entries.js";
7
+ import { ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs/fs-bash-background-text.js";
6
8
  import { isDeadCwd, diagnoseDeadCwd } from "./fs/dead-cwd.js";
7
9
  import { thrownText } from "../core/thrown-value.js";
10
+ export const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here — no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
8
11
  const MONITOR_DESCRIPTION = "Run a shell command in the background and watch its stdout as a stream of events.\n" +
9
12
  "\n" +
10
13
  "- Each line the command writes to stdout becomes a notification event delivered to you between turns; " +
11
14
  "multiple lines arriving within a short window (~200ms) are batched into a single notification.\n" +
12
15
  "- When the command exits, the watch ends and one final notification reports its exit code. A watch that " +
13
16
  `exceeds its timeout is killed and reported (default ${MONITOR_DEFAULT_TIMEOUT_MS}ms, max ${MONITOR_MAX_TIMEOUT_MS}ms).\n` +
14
- "- stderr does NOT trigger notifications, but it is captured — read it any time with TaskOutput(task_id), " +
15
- "which also serves the full re-readable stdout spool.\n" +
17
+ "- stderr does NOT trigger notifications, but it is captured — stdout and stderr are both appended to the output " +
18
+ "file the start receipt names; Read that file any time.\n" +
16
19
  "- A monitor that produces too many events is rate-limited: excess batches are suppressed (a notification tells you how many), and a watch that stays over the limit is stopped automatically.\n" +
17
20
  "- Set persistent: true for a session-resident watch with no watch timeout of its own; it still ends when " +
18
21
  "the execution environment's background time budget expires, when you stop it with TaskStop(task_id), or " +
@@ -66,6 +69,9 @@ export function createMonitorTool(env, opts) {
66
69
  if (!hasBackgroundShell(env)) {
67
70
  return errorResult("Error (Monitor): this environment does not support background processes.");
68
71
  }
72
+ const onNotify = resolveCompletionSink(ctx.onTaskNotification, opts.onTaskNotification);
73
+ if (!admitsBackgroundLaunch(onNotify))
74
+ return errorResult(MONITOR_NO_COMPLETION_CHANNEL);
69
75
  const isPersistent = persistent === true;
70
76
  const timeoutMs = Math.min(MONITOR_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeout_ms ?? MONITOR_DEFAULT_TIMEOUT_MS)));
71
77
  const spawnTimeoutSec = isPersistent ? undefined : Math.ceil(timeoutMs / 1000) + 5;
@@ -90,10 +96,12 @@ export function createMonitorTool(env, opts) {
90
96
  const sessionScoped = isPersistent && opts.sessionId !== undefined;
91
97
  const owner = sessionScoped ? opts.sessionId : (ctx.taskId ?? opts.owner);
92
98
  const scope = ctx.principal ?? opts.scope;
93
- const onNotify = opts.onTaskNotification;
99
+ const outputFile = await createBackgroundOutputFile(env, "monitor-task-");
94
100
  let taskId;
95
101
  try {
96
102
  taskId = opts.registry.registerMonitor({
103
+ ...(outputFile !== undefined ? { outputFile } : {}),
104
+ ...(ctx.taskArtifacts !== undefined ? { taskArtifacts: ctx.taskArtifacts } : {}),
97
105
  env,
98
106
  shellId: spawn.value.shellId,
99
107
  description,
@@ -104,12 +112,11 @@ export function createMonitorTool(env, opts) {
104
112
  ...(sessionScoped ? { sessionScoped: true } : {}),
105
113
  ...(isPersistent ? {} : { timeoutMs }),
106
114
  ...(opts.retainBackgroundProcesses !== undefined ? { retainBackgroundProcesses: opts.retainBackgroundProcesses } : {}),
107
- ...(onNotify !== undefined ? { onEvent: (n) => onNotify(n, { priority: "next" }) } : {}),
115
+ onEvent: (n) => onNotify(n, { priority: "next" }),
108
116
  ...(opts.timers !== undefined ? { timers: opts.timers } : {}),
109
117
  ...(opts.batchWindowMs !== undefined ? { batchWindowMs: opts.batchWindowMs } : {}),
110
118
  ...(opts.maxBatchesPerMinute !== undefined ? { maxBatchesPerMinute: opts.maxBatchesPerMinute } : {}),
111
119
  ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}),
112
- ...(opts.toolResultStore !== undefined ? { toolResultStore: opts.toolResultStore } : {}),
113
120
  });
114
121
  }
115
122
  catch (e) {
@@ -126,7 +133,7 @@ export function createMonitorTool(env, opts) {
126
133
  return errorResult(killDetail === undefined
127
134
  ? `Error (Monitor): the watch process was started but could not be registered (${why}); it has been terminated.`
128
135
  : `Error (Monitor): the watch process was started but could not be registered (${why}), and it could NOT be terminated either (${killDetail}). ` +
129
- `It may still be running as background shell ${spawn.value.shellId}; no task id was minted, so TaskOutput/TaskStop cannot reach it — ` +
136
+ `It may still be running as background shell ${spawn.value.shellId}; no task id was minted, so TaskStop cannot reach it — ` +
130
137
  "stop it out of band (the environment's own background time budget and its teardown sweep are the remaining backstops).");
131
138
  }
132
139
  const bgTimeout = envBackgroundWallSec(env.backgroundCapabilities, spawnTimeoutSec);
@@ -159,12 +166,14 @@ export function createMonitorTool(env, opts) {
159
166
  : envWallWins
160
167
  ? `The watch may run up to ${envWallMs}ms — the execution environment's background time budget (${bgTimeout}s) is shorter than the ${timeoutMs}ms watch timeout${clampNote}, and the shorter of the two wins.`
161
168
  : `The watch may run up to ${timeoutMs}ms${clampNote}.`;
162
- const content = onNotify !== undefined
163
- ? `Monitoring in background; task_id=${taskId}. Each stdout line becomes a notification event (lines within ` +
164
- `~200ms are batched); you'll get a final notification with the exit code when it ends — do not poll. ` +
165
- `${lifetime} TaskOutput("${taskId}") reads the full spool (stdout+stderr); TaskStop("${taskId}") stops the watch.`
166
- : `Monitoring in background; task_id=${taskId}. No notification channel is wired in this mount — read output with ` +
167
- `TaskOutput("${taskId}") (re-readable spool, stdout+stderr) and stop with TaskStop("${taskId}"). ${lifetime}`;
169
+ const fileClause = outputFile !== undefined
170
+ ? `Output file: ${outputFile} (stdout and stderr are appended there — Read it any time).`
171
+ : "No output file could be created for this watch.";
172
+ const content = `Monitoring in background; task_id=${taskId}. Each stdout line becomes a notification event (lines within ` +
173
+ (opts.oneShot === true
174
+ ? `~200ms are batched). ${ONE_SHOT_BACKGROUND_COMMAND_NOTE} `
175
+ : `~200ms are batched); you'll get a final notification with the exit code when it ends — do not poll. `) +
176
+ `${lifetime} ${fileClause} TaskStop("${taskId}") stops the watch.`;
168
177
  return {
169
178
  content,
170
179
  details: {
@@ -124,6 +124,34 @@ function cronExprFromSummary(when) {
124
124
  const trimmed = when.trim();
125
125
  return trimmed.startsWith("cron ") ? trimmed.slice("cron ".length).trim() : trimmed;
126
126
  }
127
+ const NEXT_RUN_READ_MS = 2_000;
128
+ function withinReadBudget(read, signal) {
129
+ return new Promise((resolve) => {
130
+ const settle = (value) => {
131
+ clearTimeout(timer);
132
+ signal?.removeEventListener("abort", cut);
133
+ resolve(value);
134
+ };
135
+ const cut = () => settle(undefined);
136
+ const timer = setTimeout(cut, NEXT_RUN_READ_MS);
137
+ if (signal?.aborted === true)
138
+ return cut();
139
+ signal?.addEventListener("abort", cut, { once: true });
140
+ try {
141
+ read().then(settle, cut);
142
+ }
143
+ catch {
144
+ return cut();
145
+ }
146
+ });
147
+ }
148
+ function nextFireAtOf(row, now = Date.now()) {
149
+ const ms = row?.nextRunMs;
150
+ if (typeof ms !== "number" || !Number.isFinite(ms))
151
+ return undefined;
152
+ const at = Math.max(ms, now);
153
+ return Number.isNaN(new Date(at).getTime()) ? undefined : at;
154
+ }
127
155
  export function cronToHuman(expr) {
128
156
  const std = cronExprFromSummary(expr).split(/\s+/);
129
157
  if (std.length !== 5)
@@ -224,7 +252,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
224
252
  })),
225
253
  label: Type.Optional(Type.String({ description: "Short label (also a dedup key with the schedule)." })),
226
254
  }),
227
- execute: async (args) => serializedCronCreateOp(async () => {
255
+ execute: async (args, { signal }) => serializedCronCreateOp(async () => {
228
256
  const a = args;
229
257
  if (a.schedule !== undefined && a.cron !== undefined) {
230
258
  return errorResult("Error (CronCreate): pass exactly one of `schedule` (object form) or `cron` (string form), not both.");
@@ -270,17 +298,21 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
270
298
  if (!r.ok)
271
299
  return errorResult(`Error (CronCreate): ${r.error.message}`);
272
300
  const replaced = knownIds?.has(r.value.id);
301
+ const afterList = await withinReadBudget(() => sched.list(opCtx), signal);
302
+ const nextFireAt = afterList?.ok === true ? nextFireAtOf(afterList.value.find((s) => s.id === r.value.id)) : undefined;
273
303
  const humanSchedule = when.kind === "cron"
274
304
  ? cronToHuman(when.expr)
275
305
  : when.kind === "delay"
276
306
  ? `once in ${when.delaySec}s`
277
307
  : `once at ${new Date(when.atMs).toISOString()}`;
278
308
  const named = `${r.value.id}${a.label ? ` (${a.label})` : ""}`;
279
- const content = replaced === true
309
+ const nextRun = nextFireAt === undefined ? "" : ` Next run: ${new Date(nextFireAt).toISOString()}.`;
310
+ const content = (replaced === true
280
311
  ? `Updated scheduled task ${named} — it replaced an existing job with the same schedule and label, whose prompt is now gone.`
281
312
  : replaced === false
282
313
  ? `Scheduled task ${named}.`
283
- : `Scheduled (or updated) task ${named} — the scheduler's listing was unavailable, so whether this replaced an existing job with the same schedule and label is unknown.`;
314
+ : `Scheduled (or updated) task ${named} — the scheduler's listing was unavailable, so whether this replaced an existing job with the same schedule and label is unknown.`) +
315
+ nextRun;
284
316
  return {
285
317
  content,
286
318
  details: {
@@ -290,6 +322,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
290
322
  recurring: when.kind === "cron" && a.recurring !== false,
291
323
  durable,
292
324
  ...(replaced !== undefined ? { replaced } : {}),
325
+ ...(nextFireAt !== undefined ? { nextFireAt } : {}),
293
326
  },
294
327
  };
295
328
  }),
@@ -351,17 +384,21 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
351
384
  if (rows.length === 0) {
352
385
  return { content: "No scheduled tasks.", details: { type: "cron-list", jobs: [] } };
353
386
  }
387
+ const now = Date.now();
354
388
  const content = rows
355
389
  .map((s) => {
356
390
  const shown = cronExprFromSummary(s.when);
357
391
  const human = cronToHuman(s.when);
358
392
  const tier = s.lifetime === "session" ? " [session]" : "";
359
393
  const once = s.recurring === false ? " [once]" : "";
360
- return `- ${s.id}: ${shown}${human !== s.when ? ` — ${human}` : ""}${s.label ? ` (${s.label})` : ""}${tier}${once}`;
394
+ const at = nextFireAtOf(s, now);
395
+ const next = at === undefined ? "" : `, next run ${new Date(at).toISOString()}`;
396
+ return `- ${s.id}: ${shown}${human !== s.when ? ` — ${human}` : ""}${s.label ? ` (${s.label})` : ""}${tier}${once}${next}`;
361
397
  })
362
398
  .join("\n");
363
399
  const jobs = rows.map((s) => {
364
400
  const human = cronToHuman(s.when);
401
+ const nextFireAt = nextFireAtOf(s, now);
365
402
  return {
366
403
  id: s.id,
367
404
  cron: cronExprFromSummary(s.when),
@@ -369,6 +406,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
369
406
  ...(s.label !== undefined ? { label: s.label } : {}),
370
407
  ...(s.recurring !== undefined ? { recurring: s.recurring } : {}),
371
408
  ...(s.lifetime !== undefined ? { durable: s.lifetime === "durable" } : {}),
409
+ ...(nextFireAt !== undefined ? { nextFireAt } : {}),
372
410
  };
373
411
  });
374
412
  return { content, details: { type: "cron-list", jobs } };
@@ -1,4 +1,3 @@
1
- import type { AgentTool } from "../internal/harness-types.js";
2
1
  import type { Brain, ToolSpec } from "../core/types.js";
3
2
  import { type HostFloor } from "../core/host-floor.js";
4
3
  import type { Model } from "../internal/llm.js";
@@ -75,15 +74,6 @@ export interface WebFetchGrounding {
75
74
  }
76
75
  export declare function htmlToText(html: string): string;
77
76
  export declare function webFetchToolSpec(config?: WebFetchConfig): ToolSpec;
78
- /** Defined (harness) form of web_fetch — back-compat (RL-1336-webfetch-factory) for direct execution / tests. For `spec.tools`, use the raw
79
- * {@link webFetchToolSpec} (prepare-task defineTool-wraps spec.tools entries).
80
- *
81
- * ⚠️ CTX-DEPENDENT BEHAVIOR: this factory takes no `enrichCtx`, so the product it returns runs on the minimal
82
- * `{toolCallId, signal}` ctx when executed directly — every `ctx.*` read inside {@link webFetchToolSpec} reads absent:
83
- * the deployment's host floor (`ctx.hostFloor` — the private-network floor alone then holds) and the design/319 exact-mark
84
- * defuse with its counters. Fed into `TaskSpec.tools`, the Runner rebinds the product to its own trusted ctx builder
85
- * (`rebindProductEntry`, caller-roster.ts), exactly as it wraps the raw {@link webFetchToolSpec}. */
86
- export declare function createWebFetchTool(config?: WebFetchConfig): AgentTool;
87
77
  /** {@link createWebFetchSummarizer}'s truncation bound — CC's `MAX_MARKDOWN_LENGTH`
88
78
  * (WebFetchTool/utils.ts:128). Exported so a deployment wiring the reference summarizer doesn't need
89
79
  * its own copy of this number to reason about (a downstream deployment asked for this explicitly,
package/dist/tools/web.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Type } from "typebox";
2
- import { defineTool, errorResult } from "../core/tools.js";
2
+ import { errorResult } from "../core/tools.js";
3
3
  import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
4
4
  import { discloseReminderShaped, observeReminderMarkEcho } from "../core/reminder-disclosure.js";
5
5
  import { egressThrownText } from "../core/untrusted-egress.js";
@@ -649,9 +649,6 @@ export function webFetchToolSpec(config = {}) {
649
649
  },
650
650
  };
651
651
  }
652
- export function createWebFetchTool(config = {}) {
653
- return defineTool(webFetchToolSpec(config));
654
- }
655
652
  export const WEBFETCH_SUMMARY_MAX_CONTENT = 100_000;
656
653
  export const WEBFETCH_SUMMARY_GUIDELINES = `Provide a concise response based only on the content above. In your response:\n` +
657
654
  ` - Enforce a strict 125-character maximum for quotes from any source document. Open Source Software is ok as long as we respect the license.\n` +
@@ -45,7 +45,7 @@
45
45
  * `CheckpointState.activeWorktree` (+ the cwd into `handsCwd`); resume re-seeds both, so
46
46
  * Enter→suspend→resume→Exit behaves exactly like an unsuspended session.
47
47
  */
48
- import type { ActiveWorktreeSession, AgentTool, ExecutionEnv } from "../internal/harness-types.js";
48
+ import type { ActiveWorktreeSession, AgentTool, ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
49
49
  import type { ManagedCheckoutView } from "../core/write-protect.js";
50
50
  import type { CwdRef } from "./fs/index.js";
51
51
  /** the ACTIVE worktree session, ALL-SERIALIZABLE (plain strings, no closures):
@@ -111,6 +111,10 @@ export interface WorktreeToolsOptions {
111
111
  * the durable checkpoint and re-seeds it on resume). Omitted ⇒ a private per-mount ref (same live
112
112
  * behavior, minus durable-suspend survival — prepare-task always passes one). */
113
113
  session?: WorktreeSessionRef;
114
+ /** The byte floor's seat (`ExecutionEnvExecOptions.readFloor`): every git command a call starts carries the floor of the
115
+ * table that call judges with, read as the call begins. Absent ⇒ the starts carry none (a host mount that holds no
116
+ * run's table); the Runner always passes the run's. */
117
+ readFloor?: (toolCallId: string | undefined) => ReadFloor | undefined;
114
118
  }
115
119
  /**
116
120
  * Build the EnterWorktree/ExitWorktree pair. One session-state closure per mount (= per task): the