@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -22,16 +22,17 @@ import { deploymentFaceClampNotice, resolveContainmentFace } from "./containment
22
22
  export * from "./containment-face.js";
23
23
  import {} from "./fs-shared.js";
24
24
  import { createModelFileReader, createReadFileTool } from "./fs-read.js";
25
- import { createEditFileTool, createWriteFileTool, createNotebookEditTool } from "./fs-write.js";
25
+ import { createEditFileTool, createWriteFileTool, createNotebookEditTool, createSaveToolResultTool } from "./fs-write.js";
26
26
  import { createGrepTool, createGlobTool } from "./fs-search-tools.js";
27
27
  import { createBashTool, createBashReadonlyTool } from "./fs-bash.js";
28
+ import { callScopeOf } from "../../core/isolation-scope.js";
28
29
  export function handsWriteHalfMounts(opts) {
29
30
  return opts.readOnly !== true;
30
31
  }
31
32
  export function backgroundOutputReadExemption(registry, seat, env) {
32
33
  if (registry === undefined)
33
34
  return undefined;
34
- return (canonicalKey, c) => registry.isBackgroundOutputFile(canonicalKey, { owner: c?.taskId ?? seat.taskOwner, scope: c?.principal ?? seat.taskScope, ...(seat.sessionId !== undefined ? { sessionId: seat.sessionId } : {}) }, env);
35
+ return (canonicalKey, c) => registry.isBackgroundOutputFile(canonicalKey, { owner: c?.taskId ?? seat.taskOwner, scope: callScopeOf(c, { scope: seat.taskScope }), ...(seat.sessionId !== undefined ? { sessionId: seat.sessionId } : {}) }, env);
35
36
  }
36
37
  export function createHandsToolkit(env, readFileState, rootCanonical, opts = {}) {
37
38
  const { includeShell = false, readOnly = false, bashReadonlyAllow, commitCoAuthor = false, mountBackgroundTaskTools = true, additionalRoots, additionalReadRoots, } = opts;
@@ -79,6 +80,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
79
80
  ...(readFace !== undefined ? { readFace } : {}),
80
81
  ...(opts.reminderMark !== undefined ? { reminderMark: opts.reminderMark } : {}),
81
82
  ...(opts.reminderDisclosureCounts !== undefined ? { reminderDisclosureCounts: opts.reminderDisclosureCounts } : {}),
83
+ ...(opts.contextRoom !== undefined ? { contextRoom: opts.contextRoom } : {}),
82
84
  });
83
85
  if (opts.modelFileReaderSeat !== undefined)
84
86
  opts.modelFileReaderSeat.current = reader;
@@ -87,6 +89,9 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
87
89
  ];
88
90
  if (handsWriteHalfMounts({ readOnly })) {
89
91
  tools.push(createEditFileTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny), createWriteFileTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny), createNotebookEditTool(env, readFileState, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny));
92
+ const keptBytes = opts.toolResultBytes;
93
+ if (keptBytes?.bytesOf !== undefined)
94
+ tools.push(createSaveToolResultTool(env, keptBytes, opts.writeRoot ?? rootCanonical, cwdRef, additionalRoots, opts.beforeWrite, opts.trackFileEdit, opts.onFileEdited, writeFaceOf, writeDeny));
90
95
  }
91
96
  tools.push(afterPlacement(createGrepTool(env, rootCanonical, readFaceRoots, readDeny, readFace, cwdRef, readAdmission)), afterPlacement(createGlobTool(env, rootCanonical, readFaceRoots, readDeny, readFace, cwdRef, readAdmission)), afterPlacement(createRepoMapTool(env, rootCanonical, readFaceRoots, readDeny, readFace, cwdRef, readAdmission)));
92
97
  if (includeShell) {
@@ -97,6 +102,7 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
97
102
  ...(opts.onNotice !== undefined ? { onNotice: opts.onNotice } : {}),
98
103
  ...(opts.shellReadAdmission !== undefined ? { shellReadAdmission: opts.shellReadAdmission } : {}),
99
104
  ...(readFloor !== undefined ? { readFloor } : {}),
105
+ ...(opts.commandSandbox !== undefined ? { commandSandbox: opts.commandSandbox } : {}),
100
106
  ...(opts.imageProcessor !== undefined ? { imageProcessor: opts.imageProcessor } : {}),
101
107
  ...(opts.onToolProgress !== undefined ? { onToolProgress: opts.onToolProgress } : {}),
102
108
  })
@@ -111,10 +117,12 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
111
117
  ...(opts.autoBackgroundOnTimeout !== undefined ? { autoBackgroundOnTimeout: opts.autoBackgroundOnTimeout } : {}),
112
118
  ...(opts.onToolProgress !== undefined ? { onToolProgress: opts.onToolProgress } : {}),
113
119
  ...(opts.queuedHumanInput !== undefined ? { queuedHumanInput: opts.queuedHumanInput } : {}),
120
+ ...(opts.turnCutMovesCommandAside !== undefined ? { turnCutMovesCommandAside: opts.turnCutMovesCommandAside } : {}),
114
121
  ...(opts.oneShot !== undefined ? { oneShot: opts.oneShot } : {}),
115
122
  ...(additionalRoots !== undefined ? { additionalRoots } : {}),
116
123
  ...(opts.shellReadAdmission !== undefined ? { shellReadAdmission: opts.shellReadAdmission } : {}),
117
124
  ...(readFloor !== undefined ? { readFloor } : {}),
125
+ ...(opts.commandSandbox !== undefined ? { commandSandbox: opts.commandSandbox } : {}),
118
126
  ...(opts.imageProcessor !== undefined ? { imageProcessor: opts.imageProcessor } : {}),
119
127
  ...(opts.bashDefaultTimeoutMs !== undefined ? { bashDefaultTimeoutMs: opts.bashDefaultTimeoutMs } : {}),
120
128
  ...(opts.bashMaxTimeoutMs !== undefined ? { bashMaxTimeoutMs: opts.bashMaxTimeoutMs } : {}),
@@ -1,5 +1,6 @@
1
1
  import { isTimeCutCode } from "../../internal/harness.js";
2
2
  import { capabilityHeld } from "../../brain/model-capability.js";
3
+ import { envErrorDetail } from "./env-error-detail.js";
3
4
  export const PDF_MAX_PAGES_PER_READ = 20;
4
5
  export const PDF_INLINE_PAGE_THRESHOLD = 10;
5
6
  export const PDF_MAX_EXTRACT_SIZE = 100 * 1024 * 1024;
@@ -70,12 +71,12 @@ export function pdfCutWords(cut) {
70
71
  export async function extractPdfTextLayer(env, absPath, range, signal, readFloor) {
71
72
  const tmp = await env.createTempDir("sema-pdf-text-", signal);
72
73
  if (!tmp.ok)
73
- return { ok: false, toolMissing: false, error: `cannot create a temp dir for text extraction: ${tmp.error.message}` };
74
+ return { ok: false, toolMissing: false, error: `cannot create a temp dir for text extraction: ${envErrorDetail(tmp.error.message)}` };
74
75
  const dir = tmp.value;
75
76
  try {
76
77
  const outR = await env.joinPath([dir, "out.txt"], signal);
77
78
  if (!outR.ok)
78
- return { ok: false, toolMissing: false, error: outR.error.message };
79
+ return { ok: false, toolMissing: false, error: envErrorDetail(outR.error.message) };
79
80
  const rangeArgs = range ? `-f ${range.first} -l ${range.last} ` : "";
80
81
  const cmd = `pdftotext -layout ${rangeArgs}${shellQuote(absPath)} ${shellQuote(outR.value)}`;
81
82
  const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
@@ -93,7 +94,7 @@ export async function extractPdfTextLayer(env, absPath, range, signal, readFloor
93
94
  error: `pdftotext ${pdfCutWords(cut).clause} before writing any text. Use the pages parameter to extract a narrower range (e.g. pages: "1-5").`,
94
95
  };
95
96
  }
96
- return { ok: false, toolMissing: false, error: r.error.message };
97
+ return { ok: false, toolMissing: false, error: envErrorDetail(r.error.message) };
97
98
  }
98
99
  if (r.value.exitCode !== 0) {
99
100
  const stderr = previewExecStream((r.value.stderr || r.value.stdout || "").trim());
@@ -102,7 +103,7 @@ export async function extractPdfTextLayer(env, absPath, range, signal, readFloor
102
103
  }
103
104
  const bin = await env.readBinaryFile(outR.value, signal);
104
105
  if (!bin.ok)
105
- return { ok: false, toolMissing: false, error: `cannot read the extracted text: ${bin.error.message}` };
106
+ return { ok: false, toolMissing: false, error: `cannot read the extracted text: ${envErrorDetail(bin.error.message)}` };
106
107
  return { ok: true, text: Buffer.from(bin.value).toString("utf8") };
107
108
  }
108
109
  finally {
@@ -116,7 +117,7 @@ function jpegLooksComplete(bytes) {
116
117
  async function listRenderedJpegs(env, dir, signal) {
117
118
  const listing = await env.listDir(dir, signal);
118
119
  if (!listing.ok)
119
- return { ok: false, error: listing.error.message };
120
+ return { ok: false, error: envErrorDetail(listing.error.message) };
120
121
  return {
121
122
  ok: true,
122
123
  jpgs: listing.value
@@ -128,12 +129,12 @@ async function listRenderedJpegs(env, dir, signal) {
128
129
  export async function extractPdfPagesAsImages(env, absPath, first, last, signal, readFloor) {
129
130
  const tmp = await env.createTempDir("sema-pdf-pages-", signal);
130
131
  if (!tmp.ok)
131
- return { ok: false, toolMissing: false, error: `cannot create a temp dir for page extraction: ${tmp.error.message}` };
132
+ return { ok: false, toolMissing: false, error: `cannot create a temp dir for page extraction: ${envErrorDetail(tmp.error.message)}` };
132
133
  const dir = tmp.value;
133
134
  try {
134
135
  const prefixR = await env.joinPath([dir, "page"], signal);
135
136
  if (!prefixR.ok)
136
- return { ok: false, toolMissing: false, error: prefixR.error.message };
137
+ return { ok: false, toolMissing: false, error: envErrorDetail(prefixR.error.message) };
137
138
  const cmd = `pdftoppm -jpeg -r 100 -f ${first} -l ${last} ${shellQuote(absPath)} ${shellQuote(prefixR.value)}`;
138
139
  const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
139
140
  if (!r.ok) {
@@ -157,7 +158,7 @@ export async function extractPdfPagesAsImages(env, absPath, first, last, signal,
157
158
  error: `pdftoppm ${pdfCutWords(cut).clause} before finishing any page. Request a narrower pages range (e.g. a single page like pages: "${first}").`,
158
159
  };
159
160
  }
160
- return { ok: false, toolMissing: false, error: r.error.message };
161
+ return { ok: false, toolMissing: false, error: envErrorDetail(r.error.message) };
161
162
  }
162
163
  if (r.value.exitCode !== 0) {
163
164
  const stderr = previewExecStream((r.value.stderr || r.value.stdout || "").trim());
@@ -174,7 +175,7 @@ export async function extractPdfPagesAsImages(env, absPath, first, last, signal,
174
175
  for (let i = 0; i < jpgs.length; i++) {
175
176
  const bin = await env.readBinaryFile(jpgs[i], signal);
176
177
  if (!bin.ok)
177
- return { ok: false, toolMissing: false, error: `cannot read the rendered page image: ${bin.error.message}` };
178
+ return { ok: false, toolMissing: false, error: `cannot read the rendered page image: ${envErrorDetail(bin.error.message)}` };
178
179
  pages.push({ pageNumber: first + i, jpeg: bin.value });
179
180
  }
180
181
  return { ok: true, pages };
@@ -1,4 +1,5 @@
1
1
  import { randomUUID } from "node:crypto";
2
+ import { describeRejectedValue } from "../../core/tool-search-setting.js";
2
3
  import { sliceHeadSafe, sliceTailSafe } from "../../core/surrogate-safe-slice.js";
3
4
  import { isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity } from "./safety.js";
4
5
  import { PROBE_REASON_MAX } from "../../core/untrusted-text.js";
@@ -286,7 +287,7 @@ export function resolveReadDenyBuiltins(config) {
286
287
  }
287
288
  else {
288
289
  if (!Array.isArray(config.tiers)) {
289
- throw new Error(`readDenyBuiltinTiers: expected an array of tier names, got ${JSON.stringify(config.tiers)}.`);
290
+ throw new Error(`readDenyBuiltinTiers: expected an array of tier names, got ${describeRejectedValue(config.tiers)}.`);
290
291
  }
291
292
  for (const t of config.tiers) {
292
293
  if (typeof t !== "string" || !READ_DENY_BUILTIN_TIERS.includes(t)) {
@@ -301,7 +302,7 @@ export function resolveReadDenyBuiltins(config) {
301
302
  }
302
303
  else {
303
304
  if (!Array.isArray(config.exclude)) {
304
- throw new Error(`readDenyBuiltinExclude: expected an array of built-in row names (canonical pattern texts), got ${JSON.stringify(config.exclude)}.`);
305
+ throw new Error(`readDenyBuiltinExclude: expected an array of built-in row names (canonical pattern texts), got ${describeRejectedValue(config.exclude)}.`);
305
306
  }
306
307
  for (const name of config.exclude) {
307
308
  if (typeof name !== "string" || !READ_FACE_BUILTIN_DENY_TABLE.some((r) => r.pattern === name)) {
@@ -594,14 +595,7 @@ export function persistedReadDenyEntryProblem(e) {
594
595
  }
595
596
  export function checkedReadDenyHomes(homes, seat = "readDenyHomes") {
596
597
  if (!Array.isArray(homes) || !homes.every((h) => validatePath(h, { intent: "validate-coordinate" }) !== undefined)) {
597
- let shown;
598
- try {
599
- shown = JSON.stringify(homes) ?? String(homes);
600
- }
601
- catch {
602
- shown = String(homes);
603
- }
604
- throw new Error(`${seat}: expected an array of absolute ${seat === "readDenyHomes" ? "home paths" : "locations"}, got ${shown} — a home-anchored row ("~/…") is placed ${seat === "readDenyHomes" ? "under each" : "at each"}, so a relative or empty spelling would guard a place that is not the home's.`);
598
+ throw new Error(`${seat}: expected an array of absolute ${seat === "readDenyHomes" ? "home paths" : "locations"}, got ${describeRejectedValue(homes)} — a home-anchored row ("~/…") is placed ${seat === "readDenyHomes" ? "under each" : "at each"}, so a relative or empty spelling would guard a place that is not the home's.`);
605
599
  }
606
600
  return homes;
607
601
  }
@@ -34,8 +34,9 @@ export declare function readFloorSeat(table: ReadDenyMatcher | undefined): ReadF
34
34
  * gate of every door that admits it: a boolean, or absent (`undefined`, read as "not required"); anything else refuses
35
35
  * (`config.read_face_seat`), because a requirement that cannot be read is no requirement and must not read as one side. */
36
36
  export declare function screenReadDenyFloorRequired(value: unknown, seat: string): boolean | undefined;
37
- /** The code a non-empty read-deny table on an environment that does not keep the byte floor carries: the operator's notice,
38
- * and the prepare refusal when the deployment requires the floor — one fact, one word, two loudness dialects. */
37
+ /** The code a non-empty read-deny table on an environment that does not keep the byte floor carries: the session user's notice
38
+ * (its audience row is `user`), and the prepare refusal when the deployment requires the floor — one fact, one word, two
39
+ * loudness dialects. */
39
40
  export declare const READ_DENY_FLOOR_UNKEPT = "config.read_deny_floor_unkept";
40
41
  /** What {@link judgeReadFloorKept} is handed: the table's owner states the environment, its table, the floor its own engine
41
42
  * starts carry off that table (the base table's), and whether the deployment requires the floor. */
@@ -64,7 +65,7 @@ export interface ReadFloorJudgment {
64
65
  * · rows, and no floor for the owner's engine starts to carry ⇒ an engine defect, refused loudly (the starts would run with
65
66
  * fewer rows than the table holds);
66
67
  * · rows, on an environment that declares it keeps the floor ⇒ nothing to say;
67
- * · rows, on one that does not: `required` ⇒ refused with {@link READ_DENY_FLOOR_UNKEPT}; otherwise that word once, to the
68
- * operator — a recursive read under a root still reads the rows below it there, so the notice is no protection.
68
+ * · rows, on one that does not: `required` ⇒ refused with {@link READ_DENY_FLOOR_UNKEPT}; otherwise that word once, as a
69
+ * `user`-audience notice — a recursive read under a root still reads the rows below it there, so the notice is no protection.
69
70
  */
70
71
  export declare function judgeReadFloorKept(j: ReadFloorJudgment): void;
@@ -1,5 +1,6 @@
1
1
  import type { EstablishedRead } from "./shell-read-judge.js";
2
2
  import { type EstablishedPlan } from "./shell-read-establish.js";
3
+ import { type ProgramPositionRefusal } from "./bash-program-position.js";
3
4
  import type { ExecutionEnv } from "../../internal/harness-types.js";
4
5
  import type { ToolCallRequest } from "../../core/tool-policy.js";
5
6
  /** The REMOVAL programs — the reference implementation's dangerous-removal arm reads `rm` and `rmdir`, with or without a
@@ -48,7 +49,8 @@ export declare function dangerousRemovalOf(path: string, seat: RemovalSeat, rm?:
48
49
  * launcher option moved the removal into (`relocated`); or a shell handed text the engine cannot read
49
50
  * (`unverifiable_shell_text`) — a text a program produces (`produced`: what a pipe or a `<(…)` carries, an argv a stream
50
51
  * fills in, a substitution), a text nobody read (`unread`: one the lexer could not read at all, {@link unreadPlan}), or a
51
- * segment whose program the walk could not name (`position`, {@link programUnread}). */
52
+ * segment whose program the walk could not name (`position`, {@link programUnread}: the program-position reader's own refusal
53
+ * of the segment's argv, the reading the planner declined it by). */
52
54
  export type RemovalFinding = (DangerousRemoval & {
53
55
  readonly guard: "dangerous_delete";
54
56
  readonly untrackedFrom?: string;
@@ -61,7 +63,12 @@ export type RemovalFinding = (DangerousRemoval & {
61
63
  readonly guard: "unverifiable_shell_text";
62
64
  readonly program: string;
63
65
  readonly text: string;
64
- readonly source: "produced" | "unread" | "position";
66
+ readonly source: "produced" | "unread";
67
+ } | {
68
+ readonly guard: "unverifiable_shell_text";
69
+ readonly program: string;
70
+ readonly refusal: ProgramPositionRefusal;
71
+ readonly source: "position";
65
72
  };
66
73
  /**
67
74
  * The names a removal target may be built on and still be verified: a root the SHELL provides, never one a command's
@@ -104,9 +111,8 @@ export declare function refusedByRemoval(read: EstablishedRead): boolean;
104
111
  /** Does this plan (nested plans included) run a removal program, hand a shell a script built when it runs, or hold text
105
112
  * nobody could read ({@link unreadPlan}, {@link programUnread})? The guard establishes nothing for a command that does none. */
106
113
  export declare function planRunsRemoval(plan: EstablishedPlan["plan"]): boolean;
107
- /** What the removal guard asks for one command: the guard word and its sentence's account — the first protected location
108
- * (the program, the location, the target), else the first target the guard cannot verify, else the first shell text the
109
- * engine cannot read; `undefined` when none. */
114
+ /** What the removal guard asks for one command: the guard word and the card's whole sentence ({@link REMOVAL_GUARD_SENTENCE}) for the
115
+ * first finding of the first word in {@link REMOVAL_GUARD_ORDER}; `undefined` when none. */
110
116
  export interface RemovalVerdict {
111
117
  readonly guard: RemovalFinding["guard"];
112
118
  readonly text: string;
@@ -3,7 +3,7 @@ import { literalTextOf } from "../../shell/lex.js";
3
3
  import { createShellReadEstablisher, establishShellReadsLexically } from "./shell-read-establish.js";
4
4
  import { isAbsoluteForFamily, isWinFormPath, normalizeAbsPathLexically } from "./safety.js";
5
5
  import { launchedCommands, launchedReadings, reentryText, runsStoredLine, scriptFileAt, spellLaunched } from "./shell-reentry-text.js";
6
- import { declinedProgramSentence, readProgramPosition } from "./bash-program-position.js";
6
+ import { programPositionRefusalSentence, readProgramPosition } from "./bash-program-position.js";
7
7
  import { bashClassifyDefaultAllow } from "./bash-readonly-classifier.js";
8
8
  import { programArgs } from "./shell-read-write-targets.js";
9
9
  import { declaresOption, implementationsOf, programRow, rowRefusesArgv, runsShellText, selectedOptions, writeReadings } from "./program-read-model.js";
@@ -120,6 +120,7 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
120
120
  const safe = new Set(safeRoots);
121
121
  for (const segment of established.plan.segments) {
122
122
  const program = segment.verb?.basename;
123
+ const position = readProgramPosition(segment.argv);
123
124
  const removal = removalProgramOf(segment);
124
125
  const args = removal === undefined ? [] : programArgs(segment);
125
126
  const spelled = args.map((w) => w.spelled);
@@ -132,7 +133,7 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
132
133
  const rm = row.key === "rm" || !named ? { recursive: selectsOptions(row, spelled, received.shellChooses, TRAVERSAL) } : undefined;
133
134
  if (forced && segment.reentry === "argv")
134
135
  out.push({ guard: "unverifiable_delete", program: removal.program, operand: segment.text.trim(), source: "stream" });
135
- const relocated = enclosingRelocated || readProgramPosition(segment.argv).baseMovedAt.length > 0;
136
+ const relocated = enclosingRelocated || position.baseMovedAt.length > 0;
136
137
  for (const read of established.reads.get(segment) ?? []) {
137
138
  if ((named && read.candidate.face !== "write") || read.candidate.provenance === "program_path" || options.has(read.candidate.raw))
138
139
  continue;
@@ -155,9 +156,12 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
155
156
  const script = runtimeScriptOf(segment);
156
157
  if (script !== undefined && program !== undefined)
157
158
  out.push({ guard: "unverifiable_shell_text", program, text: script, source: "produced" });
158
- if (programUnread(segment))
159
- out.push({ guard: "unverifiable_shell_text", program: segment.launcherChain[0] ?? segment.text.trim(), text: segment.text.trim(), source: "position" });
160
- const handedRelocated = enclosingRelocated || readProgramPosition(segment.argv).baseMovedAt.length > 0;
159
+ if (programUnread(segment)) {
160
+ const refusal = position.refusal;
161
+ const named = segment.launcherChain[0] ?? segment.text.trim();
162
+ out.push(refusal !== undefined ? { guard: "unverifiable_shell_text", program: named, refusal, source: "position" } : { guard: "unverifiable_shell_text", program: named, text: segment.text.trim(), source: "unread" });
163
+ }
164
+ const handedRelocated = enclosingRelocated || position.baseMovedAt.length > 0;
161
165
  for (const nested of segment.nested) {
162
166
  if (unreadPlan(nested)) {
163
167
  out.push({ guard: "unverifiable_shell_text", program: program ?? segment.text.trim(), text: segment.text.trim(), source: "unread" });
@@ -217,36 +221,62 @@ export function refusedByRemoval(read) {
217
221
  export function planRunsRemoval(plan) {
218
222
  return unreadPlan(plan) || plan.segments.some((s) => removalProgramOf(s) !== undefined || runtimeScriptOf(s) !== undefined || programUnread(s) || s.nested.some(planRunsRemoval));
219
223
  }
220
- const DANGEROUS_REMOVAL_SENTENCE = {
221
- filesystem_root: (p, t) => `\`${p}\` would remove the filesystem root (${t})`,
222
- home: (p, t) => `\`${p}\` would remove a home directory (${t})`,
223
- workspace: (p, t) => `\`${p}\` would remove a workspace directory — the task root, the working directory or an additional working directory — or one of its ancestors (${t})`,
224
- top_level: (p, t) => `\`${p}\` would remove a top-level system directory (${t})`,
225
- mounted_drive: (p, t) => `\`${p}\` would remove a mounted drive, the folder that holds mounted drives, or a file or folder at the top level of a drive (${t}) — if you meant something deeper inside, name it by its full path`,
226
- };
227
- const UNVERIFIABLE_REMOVAL_SENTENCE = {
228
- rewritten: (p, o) => `\`${p}\` recursive+force target ${o} is rewritten by the shell from a value this command does not settle (a name with no value here or one it sets in a form the guard cannot read, a substitution, a parameter operator) — the deleted path cannot be verified from this command`,
229
- stream: (p, o) => `\`${p}\` recursive+force takes its targets from the stream it is fed (${o}) — the deleted paths cannot be verified from this command`,
230
- relocated: (p, o) => `\`${p}\` recursive+force target ${o} is relative to a directory a launcher option moved the program into, which this command does not settle — the deleted path cannot be verified from this command`,
231
- };
232
- const UNREADABLE_TEXT_SENTENCE = {
233
- produced: (p, t) => `\`${p}\` runs shell text that is built only when the command runs (${inlineUntrusted(t, 200)}) — the text this shell will run cannot be read by the engine, so whether it removes anything is unknown; write the text into the command itself (a \`-c\` string, a here-document or a here-string) and the engine reads it as it reads any command`,
234
- unread: (p, t) => `\`${p}\` runs shell text this guard cannot read (${inlineUntrusted(t, 200)}) — the text this shell will run cannot be read by the engine, so whether it removes anything is unknown`,
235
- position: (_p, t) => inlineUntrusted(declinedProgramSentence(t), 400),
224
+ const untrackedFromOf = (f) => f.untrackedFrom === undefined ? "" : ` — the working directory is not tracked from \`${inlineUntrusted(f.untrackedFrom, 120)}\` on (a directory change before it cannot be followed), so this target was judged where the command stood when tracking stopped`;
225
+ const REMOVAL_GUARD_SENTENCE = {
226
+ dangerous_delete: {
227
+ card: (row, f) => `Dangerous removal: ${row}${untrackedFromOf(f)}. No permission mode, allow rule or classifier clears this — only a person confirming this call does.`,
228
+ rows: {
229
+ filesystem_root: (f) => `\`${f.program}\` would remove the filesystem root (${inlineUntrusted(f.target, 200)})`,
230
+ home: (f) => `\`${f.program}\` would remove a home directory (${inlineUntrusted(f.target, 200)})`,
231
+ workspace: (f) => `\`${f.program}\` would remove a workspace directory — the task root, the working directory or an additional working directory — or one of its ancestors (${inlineUntrusted(f.target, 200)})`,
232
+ top_level: (f) => `\`${f.program}\` would remove a top-level system directory (${inlineUntrusted(f.target, 200)})`,
233
+ mounted_drive: (f) => `\`${f.program}\` would remove a mounted drive, the folder that holds mounted drives, or a file or folder at the top level of a drive (${inlineUntrusted(f.target, 200)}) — if you meant something deeper inside, name it by its full path`,
234
+ },
235
+ },
236
+ unverifiable_delete: {
237
+ card: (row) => `Unverifiable recursive delete (fail-closed unless cleared): ${row}. Re-run the delete with the resolved literal path written into the command itself (or assign the variable a literal path in the same command, e.g. \`DIR=/exact/path; rm -rf "$DIR"\`) so the target can be verified.`,
238
+ rows: {
239
+ rewritten: (f) => `\`${f.program}\` recursive+force target ${inlineUntrusted(f.operand, 200)} is rewritten by the shell from a value this command does not settle (a name with no value here or one it sets in a form the guard cannot read, a substitution, a parameter operator) — the deleted path cannot be verified from this command`,
240
+ stream: (f) => `\`${f.program}\` recursive+force takes its targets from the stream it is fed (${inlineUntrusted(f.operand, 200)}) — the deleted paths cannot be verified from this command`,
241
+ relocated: (f) => `\`${f.program}\` recursive+force target ${inlineUntrusted(f.operand, 200)} is relative to a directory a launcher option moved the program into, which this command does not settle — the deleted path cannot be verified from this command`,
242
+ },
243
+ },
244
+ unverifiable_shell_text: {
245
+ card: (row) => `Unverifiable shell text (fail-closed unless cleared): ${row}.`,
246
+ rows: {
247
+ produced: (f) => `\`${f.program}\` runs shell text that is built only when the command runs (${inlineUntrusted(f.text, 200)}) — the text this shell will run cannot be read by the engine, so whether it removes anything is unknown; write the text into the command itself (a \`-c\` string, a here-document or a here-string) and the engine reads it as it reads any command`,
248
+ unread: (f) => `\`${f.program}\` runs shell text this guard cannot read (${inlineUntrusted(f.text, 200)}) — the text this shell will run cannot be read by the engine, so whether it removes anything is unknown`,
249
+ position: (f) => inlineUntrusted(programPositionRefusalSentence(f.refusal), 400),
250
+ },
251
+ },
236
252
  };
253
+ function removalGuardSentence(f) {
254
+ switch (f.guard) {
255
+ case "dangerous_delete": {
256
+ const g = REMOVAL_GUARD_SENTENCE.dangerous_delete;
257
+ return g.card(g.rows[f.kind](f), f);
258
+ }
259
+ case "unverifiable_delete": {
260
+ const g = REMOVAL_GUARD_SENTENCE.unverifiable_delete;
261
+ return g.card(g.rows[f.source](f), f);
262
+ }
263
+ case "unverifiable_shell_text": {
264
+ const g = REMOVAL_GUARD_SENTENCE.unverifiable_shell_text;
265
+ return g.card(f.source === "position" ? g.rows.position(f) : g.rows[f.source](f), f);
266
+ }
267
+ default: {
268
+ const exhaustive = f;
269
+ return exhaustive;
270
+ }
271
+ }
272
+ }
273
+ const REMOVAL_GUARD_ORDER = Object.keys(REMOVAL_GUARD_SENTENCE);
237
274
  function verdictOf(findings) {
238
- for (const f of findings) {
239
- if (f.guard !== "dangerous_delete")
240
- continue;
241
- const untracked = f.untrackedFrom === undefined ? "" : ` — the working directory is not tracked from \`${inlineUntrusted(f.untrackedFrom, 120)}\` on (a directory change before it cannot be followed), so this target was judged where the command stood when tracking stopped`;
242
- return { guard: f.guard, text: `${DANGEROUS_REMOVAL_SENTENCE[f.kind](f.program, inlineUntrusted(f.target, 200))}${untracked}` };
275
+ for (const guard of REMOVAL_GUARD_ORDER) {
276
+ const f = findings.find((x) => x.guard === guard);
277
+ if (f !== undefined)
278
+ return { guard: f.guard, text: removalGuardSentence(f) };
243
279
  }
244
- for (const f of findings)
245
- if (f.guard === "unverifiable_delete")
246
- return { guard: f.guard, text: UNVERIFIABLE_REMOVAL_SENTENCE[f.source](f.program, inlineUntrusted(f.operand, 200)) };
247
- for (const f of findings)
248
- if (f.guard === "unverifiable_shell_text")
249
- return { guard: f.guard, text: UNREADABLE_TEXT_SENTENCE[f.source](f.program, f.text) };
250
280
  return undefined;
251
281
  }
252
282
  const REMOVAL_RESOLVE_TIMEOUT_MS = 10_000;
@@ -45,10 +45,8 @@ export interface ReadEntry {
45
45
  * additive: undefined on every non-Read write-back (Write/Edit re-record the file they just fully wrote)
46
46
  * and on every seeded/attachment entry — those are never partial by construction. */
47
47
  isPartialView?: boolean;
48
- /** The line window actually served to the model on the last read (the dedup stub's key). Lets
49
- * read_file return a `file_unchanged` stub when the SAME window is re-requested and the content hash is
50
- * unchanged — saving the re-transmitted body. Optional/additive: undefined (e.g. an entry seeded from an
51
- * older checkpoint) just means "no dedup", never a false hit. */
48
+ /** The line window actually served to the model on the last read. Optional/additive: undefined (an entry seeded
49
+ * from an older checkpoint, a write-back, a seed) claims the whole file. */
52
50
  view?: {
53
51
  start: number;
54
52
  end: number;
@@ -57,24 +55,31 @@ export interface ReadEntry {
57
55
  * attachment picks the most RECENTLY read files, the way CC sorts readFileState by timestamp.
58
56
  * Optional/additive: undefined (an entry seeded from an older checkpoint) sorts last, never breaks. */
59
57
  lastReadAt?: number;
60
- /** TRUE when the Runner pre-seeded this entry because the file's FULL
61
- * disk-verbatim text was injected into the model's context at startup
62
- * (ProjectMemoryLoad.seededFiles — CC's own memory preload). A DEFAULT whole-file Read of an
63
- * UNCHANGED seeded file
64
- * answers with the already-in-context reminder instead of re-transmitting the body. Any real
65
- * Read / edit write-back records a FRESH entry without this flag, so a file that changed on
66
- * disk (hash mismatch) always serves real content and the dedup disarms permanently.
58
+ /** TRUE when the Runner pre-seeded this entry because the file's FULL disk-verbatim text is in the
59
+ * system-prompt lane of this leg (the one meaning: today the memory engine's materialized index; an
60
+ * instruction file is never seeded — the instruction-file lane's frame records its own entry): the file passes
61
+ * read-before-edit. Any real
62
+ * Read / edit write-back records a FRESH entry without this flag. (Whether a request carries a Read of the file
63
+ * as the "already in your context" sentence is the request projection's, against the leg's seed table.)
67
64
  * Optional/additive: absent = normal entry. */
68
65
  seededFromContext?: boolean;
69
- /** The transmission that carried the body this entry dedups against — the tool call whose RESULT carried it, or the
70
- * attachment frame that did (`attachmentTransmissionId`): when THAT transmission leaves the request (a stale-result
71
- * clear, a trim), the entry retires with it (`applyContextShrinkToReadFileState`, `transmissions-gone` arm). Recorded
72
- * only by the deliveries that TRANSMIT a body (a Read result or a frame replayed from the transcript included) — a
73
- * write-back's content is the model's own arguments and a context-seeded entry never rode a message, so neither
74
- * carries this and neither is retired by it. Optional/additive: absent (an
75
- * older checkpoint) never matches. */
76
- transmittedByToolCallId?: string;
66
+ /** The WITNESS SET: every transmission that still carries the body this entry stands for — each tool call whose RESULT
67
+ * carried it, each attachment frame that did (`attachmentTransmissionId`), oldest first. The entry retires when the
68
+ * last of them leaves the request (a stale-result clear, a trim, the budget arm's pointer: `applyContextShrinkToReadFileState`,
69
+ * `transmissions-gone` arm); one leaving while another stays leaves the entry standing. A delivery of the SAME body
70
+ * and window joins the set; a delivery of another body (the file changed, another window) starts it over. It is an
71
+ * approximation of "the model can see the body" with two error directions: a path that does not report its
72
+ * departure keeps a witness (the edit gate lets an edit through), a reused call id retires one entry too many (the
73
+ * gate asks for a fresh read). Recorded only by the deliveries that TRANSMIT a body (a Read result or a frame
74
+ * replayed from the transcript included) — a write-back's content is the model's own arguments and a
75
+ * context-seeded entry never rode a message, so neither carries a set and neither is retired by it. Optional/additive:
76
+ * absent (an older checkpoint's entry) never matches. */
77
+ witnesses?: readonly string[];
77
78
  }
79
+ /** The head of an attachment frame's transmission id but an instruction file's, which spells its own word (a witness in
80
+ * {@link ReadEntry.witnesses} for a frame's delivery; minted by `attachmentTransmissionId`; an instruction file's frame spells its origin's word in its place) — a tool call's
81
+ * id never starts with it. */
82
+ export declare const FRAME_TRANSMISSION_PREFIX = "attachment:";
78
83
  /** Per-task record of which files have been read, keyed by canonical path: owned by prepare-task,
79
84
  * closure-captured by the tools, and serialized into the durable checkpoint. */
80
85
  export type ReadFileState = Map<string, ReadEntry>;
@@ -109,6 +114,8 @@ export interface FsViolation {
109
114
  * one family's question, so it is a separate, named predicate rather than a mode of that one.
110
115
  */
111
116
  export declare function relativeInEveryFamily(p: string): boolean;
117
+ /** Does a spelling open with a drive letter and its colon — `C:\x`, `C:/x` and the drive-relative `C:x` alike? */
118
+ export declare function startsWithDriveLetter(p: string): boolean;
112
119
  /** Does this absolute spelling name the opening process's STANDARD INPUT (`/dev/stdin`, `/dev/fd/0`, `/proc/<pid>/fd/0`),
113
120
  * folded lexically first (`/dev/./stdin`, `/dev//fd/0`)? */
114
121
  export declare function namesStandardInput(path: string): boolean;
@@ -1,5 +1,6 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { readDenySentence } from "./read-deny.js";
3
+ import { envErrorDetail } from "./env-error-detail.js";
3
4
  import { homeViewsOf, homeViewUnreadSentence } from "./read-deny-home.js";
4
5
  import { skipsRootsContainment } from "./containment-face.js";
5
6
  import { sliceHeadSafe } from "../../core/surrogate-safe-slice.js";
@@ -15,12 +16,16 @@ export function writeTargetPath(call, pt = protectivePathTargetOf(call)) {
15
16
  const notebook = typeof np === "string" && np.length > 0 ? np : undefined;
16
17
  return fileArgPath(call.args) ?? notebook;
17
18
  }
19
+ export const FRAME_TRANSMISSION_PREFIX = "attachment:";
18
20
  export function sha256(content) {
19
21
  return createHash("sha256").update(content, "utf8").digest("hex");
20
22
  }
21
23
  const SEP = "/";
22
24
  export function relativeInEveryFamily(p) {
23
- return !(p.startsWith("/") || p.startsWith("\\") || /^[A-Za-z]:/.test(p));
25
+ return !(p.startsWith("/") || p.startsWith("\\") || startsWithDriveLetter(p));
26
+ }
27
+ export function startsWithDriveLetter(p) {
28
+ return /^[A-Za-z]:/.test(p);
24
29
  }
25
30
  function nativeSepOf(p) {
26
31
  return isWinFormPath(p) && p.includes("\\") ? "\\" : "/";
@@ -533,12 +538,12 @@ export async function canonicalizeTarget(env, path, signal, family, baseCwd) {
533
538
  async function probeRealTarget(env, path, target, family, signal) {
534
539
  const absR = await env.absolutePath(target, signal);
535
540
  if (!absR.ok)
536
- return { ok: false, message: `cannot resolve path "${path}": ${absR.error.message}` };
541
+ return { ok: false, message: `cannot resolve path "${path}": ${envErrorDetail(absR.error.message)}` };
537
542
  let abs = absR.value;
538
543
  for (let hop = 0; hop < 16; hop++) {
539
544
  const exists = await env.exists(abs, signal);
540
545
  if (!exists.ok) {
541
- return { ok: false, message: `cannot determine whether "${path}" exists: ${exists.error.message}`, unresolvedSymlink: true };
546
+ return { ok: false, message: `cannot determine whether "${path}" exists: ${envErrorDetail(exists.error.message)}`, unresolvedSymlink: true };
542
547
  }
543
548
  if (!exists.value) {
544
549
  const newPath = await canonicalizeNewPath(env, abs, family, signal);
@@ -556,7 +561,7 @@ async function probeRealTarget(env, path, target, family, signal) {
556
561
  return { ok: true, key: canon.value, aliasResolved: true };
557
562
  const info = await env.fileInfo(abs, signal);
558
563
  if (!info.ok) {
559
- return { ok: false, message: `cannot determine whether "${path}" is a symlink: ${info.error.message}`, unresolvedSymlink: true };
564
+ return { ok: false, message: `cannot determine whether "${path}" is a symlink: ${envErrorDetail(info.error.message)}`, unresolvedSymlink: true };
560
565
  }
561
566
  if (info.value.kind !== "symlink") {
562
567
  const viaAncestors = await canonicalizeNewPath(env, abs, family, signal, { skipLeaf: true });
@@ -574,7 +579,7 @@ async function probeRealTarget(env, path, target, family, signal) {
574
579
  }
575
580
  const link = await env.readLink(abs, signal);
576
581
  if (!link.ok) {
577
- return { ok: false, message: `cannot read symlink "${path}": ${link.error.message}`, unresolvedSymlink: true };
582
+ return { ok: false, message: `cannot read symlink "${path}": ${envErrorDetail(link.error.message)}`, unresolvedSymlink: true };
578
583
  }
579
584
  const screenedTarget = win32NamespaceScreen(link.value, family);
580
585
  if (!screenedTarget.ok) {
@@ -588,7 +593,7 @@ async function probeRealTarget(env, path, target, family, signal) {
588
593
  const linkTarget = anchorSpelling(family, parentDir(abs), hopSpelling);
589
594
  const reabs = await env.absolutePath(linkTarget, signal);
590
595
  if (!reabs.ok) {
591
- return { ok: false, message: `cannot resolve symlink target "${linkTarget}" for "${path}": ${reabs.error.message}`, unresolvedSymlink: true };
596
+ return { ok: false, message: `cannot resolve symlink target "${linkTarget}" for "${path}": ${envErrorDetail(reabs.error.message)}`, unresolvedSymlink: true };
592
597
  }
593
598
  abs = reabs.value;
594
599
  }
@@ -624,12 +629,12 @@ async function canonicalizeNewPath(env, abs, family, signal, opts) {
624
629
  const candidate = parts.join(sep) || sep;
625
630
  const ex = await env.exists(candidate, signal);
626
631
  if (!ex.ok) {
627
- return { ok: false, message: `cannot determine whether ancestor "${candidate}" exists: ${ex.error.message}` };
632
+ return { ok: false, message: `cannot determine whether ancestor "${candidate}" exists: ${envErrorDetail(ex.error.message)}` };
628
633
  }
629
634
  if (ex.value) {
630
635
  const canon = await env.canonicalPath(candidate, signal);
631
636
  if (!canon.ok) {
632
- return { ok: false, message: `cannot canonicalize existing ancestor "${candidate}": ${canon.error.message}` };
637
+ return { ok: false, message: `cannot canonicalize existing ancestor "${candidate}": ${envErrorDetail(canon.error.message)}` };
633
638
  }
634
639
  return { ok: true, ...rejoinMissingTail(canon.value, tail.reverse(), family) };
635
640
  }
@@ -14,7 +14,7 @@ export declare const DEFAULT_IGNORE_DIRS: ReadonlySet<string>;
14
14
  export interface GrepParams {
15
15
  /** Regular expression (ripgrep semantics) — the pattern is ALWAYS a regex; the
16
16
  * old `regex?: boolean` literal-by-default switch is retired (a legacy `regex` argument sent by an
17
- * old caller is tolerated and ignored at the tool layer, never a failure). */
17
+ * old caller is refused by name at the tool layer — `fs-search-tools.ts` — never read and never ignored). */
18
18
  pattern: string;
19
19
  /** Restrict the search to this sub-path (relative to root, or absolute within root). */
20
20
  path?: string;
@@ -142,6 +142,7 @@ export function bare(r, provenance, spelled = r.folded) {
142
142
  ...(pattern !== undefined ? { pattern } : {}),
143
143
  ...(whole && r.homeFloor !== undefined ? { floorSpelled: r.homeFloor } : {}),
144
144
  ...(whole && r.floorValues !== undefined ? { floors: r.floorValues } : {}),
145
+ ...(whole && r.floorPastBound === true ? { floorPastBound: true } : {}),
145
146
  };
146
147
  }
147
148
  export function roleReads(r, provenance, value, role, globs, ctx, alsoOperand = false) {