@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
@@ -261,7 +261,7 @@ function findingAccount(fold, boundary) {
261
261
  return `"${fitMiddle(fold.declined.text.trim(), ACCOUNT_PART_MAX)}": ${fold.declined.unreadProgramText}, so where it ${verb} cannot be established ${NOT_AUTO_ALLOWED}`;
262
262
  if (fold.declined !== undefined)
263
263
  return `the text given to ${reenteredPrograms(fold)} — as an argument, on standard input, or in the file it names — runs as shell text this station does not parse ${NOT_AUTO_ALLOWED}`;
264
- return `the command's text could not be read as shell, so where it ${verb} cannot be established ${NOT_AUTO_ALLOWED}`;
264
+ return `where this command ${verb} could not be established ${NOT_AUTO_ALLOWED}`;
265
265
  case "declined":
266
266
  return fold.declined !== undefined ? declinedProgramSentence(fold.declined.text) : `the station could not read which program runs ${NOT_AUTO_ALLOWED}`;
267
267
  case "identity_changed":
@@ -395,7 +395,10 @@ export interface ShellReadFold {
395
395
  * standard input) and so is at least `unestablishable`, in text order — `declined` holds only the first finding of the rank, and the
396
396
  * account of this question names each program, not the first. Present only with an `unestablished` fold. */
397
397
  readonly reentered?: readonly ShellReadSegment[];
398
- /** What the judge did not finish, for an `unanswered` finding: the first thing the establishment recorded ({@link Incomplete.detail}). */
398
+ /** What could not be settled, in words, for a finding that has no witness read or declined segment to say it: for `unanswered`
399
+ * the first thing the establishment recorded ({@link Incomplete.detail}); for an `unestablishable` text the plan refused
400
+ * ({@link ShellReadPlan.unreadable}) the sentence the plan itself carries — a construct the lexer cannot close, a word whose
401
+ * value the text does not hold, a value a parameter expansion re-reads at run time. */
399
402
  readonly cause?: string;
400
403
  /** Some read of the text could not be established (an `unestablishable`, `unanswered` or `declined` finding anywhere, winning or not). */
401
404
  readonly unestablished?: true;
@@ -69,6 +69,10 @@ export function judgeRead(read, boundary) {
69
69
  }
70
70
  }
71
71
  }
72
+ if (read.candidate.floorPastBound === true && deny !== undefined) {
73
+ const cause = `the spellings "${read.candidate.raw}" may take pass the bound the station reads, so it may name a value no deny row was asked about`;
74
+ return { read: { ...read, cause }, kind: "unanswered", containment: writeTarget ? writeContainmentOf(read, boundary) : containmentOf(read, boundary) };
75
+ }
72
76
  if (writeTarget)
73
77
  return judgeWrite(read, boundary);
74
78
  const containment = containmentOf(read, boundary);
@@ -149,7 +153,7 @@ export function foldShellReadFindings(judged) {
149
153
  const walk = (j, reading) => {
150
154
  const denyOnly = reading !== "full";
151
155
  if (j.plan.unreadable !== undefined && !denyOnly)
152
- raise({ finding: "unestablishable" });
156
+ raise({ finding: "unestablishable", cause: j.plan.unreadable });
153
157
  for (const s of j.segments) {
154
158
  for (const f of s.findings) {
155
159
  if (denyOnly && f.kind !== "deny_hit" && (reading === "deny-hit" || f.kind !== "unanswered"))
@@ -88,6 +88,10 @@ export interface ReadCandidate {
88
88
  /** A home word the plan does not place (the text may rebind `HOME`, it sits in a value, or it is a literal tilde the
89
89
  * program may expand itself): spelled with the DECLARED home. The judge reads it for deny rows ONLY. */
90
90
  readonly floorSpelled?: string;
91
+ /** The word's names are unknown here and the spellings their bindings left for the deny judge passed the bound the
92
+ * station reads: some were let go, so the word may spell one no deny row was asked about. The judge answers it
93
+ * `unanswered` (the station stopped at its own bound) where a deny row guards the face, unless a view hits a row. */
94
+ readonly floorPastBound?: true;
91
95
  /** Deny rows only (never containment): a `floorSpelled` shadow, or the read copy of a word the program only writes. */
92
96
  readonly denyOnly?: true;
93
97
  /** A WRITE target (a `>`-family redirection, a `sed` `w` file, a file-writing command's operand): established like a
@@ -2,7 +2,7 @@ import { assignedWords, expansionsInHeredocBody, descriptorNameWords, lexShell,
2
2
  import { programTextOf, readOfText, readsOf, rewritten, segmentReadingsOf, settledFieldsOf, spelledWithHome, unreadableSentenceOf } from "./shell-read-word.js";
3
3
  import { braceWordListsOf } from "./shell-read-brace.js";
4
4
  import { assignmentArithmetic, bare, listedVerbCandidates, pathSubcommandOf, programTextSentence, pushAssignment, roleReads, subscriptOnly, unlistedWords } from "./shell-read-argv.js";
5
- import { ARITHMETIC_TEST_OPERATORS, BindingThread, arithmeticSubstitutions, assignsAsStatement, inheritedFunctionsOf, inheritedExportedFunctions, isArithmeticCommand, bindingEffectOf, joinRebound, loopListHeadAt, namesBoundIn, parameterBodySubstitutions, projectSegments, valueOf, } from "./shell-read-bindings.js";
5
+ import { ARITHMETIC_TEST_OPERATORS, BindingThread, arithmeticSubstitutions, assignsAsStatement, inheritedFunctionsOf, inheritedExportedFunctions, isArithmeticCommand, bindingEffectOf, bindingFloors, floorReaderOf, joinRebound, loopListHeadAt, namesBoundIn, parameterBodySubstitutions, projectSegments, valueOf, } from "./shell-read-bindings.js";
6
6
  import { commandEnvironmentNames, isShellSyntaxWord, programBasename, programPositionRunsShell, readProgramPosition, shellScanDeclineOf, } from "./bash-program-position.js";
7
7
  import { WorkdirThread, baseShiftOf, textCalls, textMayMove, textMovesOf, textSetsPhysical, withCommandEnvironment } from "./shell-read-workdir.js";
8
8
  import { POLL_LOOP_MAX_BEATS, attachedOptionPayloads, isPathShapedToken, programTextSlotFiles, } from "./bash-readonly-classifier.js";
@@ -10,7 +10,7 @@ import { mayCarryGitVariables, objectPathPlacement } from "./shell-read-object-p
10
10
  import { BLOCK_WORD_NAMES, commandLineOf, commandLineOptionSpellings, declaredAttributes, isDeclarationBuiltin, isInertBuiltin, launcherOptionPathRole, launcherOptionStep, readOptionRole, programLanguageOf, programTextOpensOf, selectedOptions, movesBaseByStack, opensNoOperand, programDelivery, programRow, readArgRoles, runsShellText, } from "./program-read-model.js";
11
11
  import { shellWordsOf } from "../../shell/shell-words.js";
12
12
  import { isAbsoluteForFamily } from "./safety.js";
13
- import { codeBodies, launchedInput, literalEvalText, pipedTextOf, printedByProcess, reentersShell, reentryText, scriptFileAt, stdinTextsOf } from "./shell-reentry-text.js";
13
+ import { codeBodies, launchedInput, literalEvalText, pipedTextOf, printedByProcess, reentersShell, reentryText, scriptFileAt, stdinTextOf, stdinTextsOf } from "./shell-reentry-text.js";
14
14
  import { heldAt, launchedAt, launchedInOf, nestedStartOf, plannedOnce, rebasePlan, startedAt, stdinFeeds } from "./shell-read-start.js";
15
15
  import { inlineSourcedLiterals } from "./shell-read-sourced.js";
16
16
  import { markStandardDevices } from "./shell-read-device.js";
@@ -87,11 +87,11 @@ function planText(command, decl, depth, start, from) {
87
87
  const bodies0 = new BindingThread(lexed.segments, named0, initial, boundAnywhere, loopEndOf, start?.homeTouched === true, start?.inherited, start?.names);
88
88
  const ifsBoundBefore = (si) => start?.boundAnywhere("IFS") === true || (bodies0.inFunctionBody(si) && boundHere("IFS")) || named0.some((_, j) => j < si && unknownAt(j)) || [...loopEndOf].some(([h, end]) => h <= si && si < end && named0.some((_, j) => h <= j && j < end && unknownAt(j)));
89
89
  const feedsItself = (si) => lexed.segments[si].tokens.some((t) => (t.kind === "heredoc" && (t.fd ?? 0) === 0) || (t.kind === "redirect" && (t.fd ?? (t.op === "<" || t.op === "<<<" || t.op === "<>" || t.op === "<&" ? 0 : 1)) === 0));
90
- const readFeedOf = (si) => ifsBoundBefore(si) ? [undefined, false] : [stdinOf(si), !feedsItself(si) && loopFeedOf(si) !== undefined];
91
- const named = projected.map((p, si) => (ifsBoundBefore(si) ? named0[si] : bindingEffectOf(lexed.segments[si], p.argv, p, () => "unknown", undefined, undefined, ...readFeedOf(si))));
90
+ const readFeedOf = (si) => [stdinOf(si), !feedsItself(si) && loopFeedOf(si) !== undefined, ifsBoundBefore(si)];
91
+ const named = projected.map((p, si) => bindingEffectOf(lexed.segments[si], p.argv, p, (w, quoted, overlay) => valueOf(w, undefined, quoted, overlay), undefined, undefined, ...readFeedOf(si)));
92
92
  const names = new BindingThread(lexed.segments, named, initial, boundAnywhere, loopEndOf, start?.homeTouched === true, start?.inherited, start?.names);
93
93
  const laterStart = { initial: (name) => declared(name, boundAnywhere(name)), boundAnywhere, homeTouched: boundAnywhere("HOME"), inherited: names.inheritedAt() };
94
- const nestedTextStart = (table, si, kind, at, exported = exportedNames) => kind === "substitution" ? { initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.functions), names: heldAt(table), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) } : startedAt(kind === "now" ? { ...laterStart, inherited: { ...laterStart.inherited, rebound: joinRebound(table.inherited.rebound, commandEnvironmentNames(projected[si].argv)) }, ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}), ...(readProgramPosition(projected[si].argv).program?.basename === "eval" ? { thread: heldThread(moves.unread), names: heldAt(table, names.functionBound()) } : exportedFunctions.size > 0 ? { thread: { physical: false, functions: exported, unread: exported, reached: workdir.reached }, names: inheritedExportedFunctions(exportedFunctions) } : {}) } : { ...laterStart, thread: heldThread(moves.functions, workdir.mayBePhysical || moves.physicalAt.some(Boolean)), names: names.heldAnywhere(), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) }, at);
94
+ const nestedTextStart = (table, si, kind, at, exported = exportedNames) => kind === "substitution" ? { initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.functions), names: heldAt(table), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) } : startedAt(kind === "now" && readProgramPosition(projected[si].argv).program?.basename === "eval" ? evalStart(withCommandEnvironment(table, projected[si].argv)) : kind === "now" ? { ...laterStart, inherited: { ...laterStart.inherited, rebound: joinRebound(table.inherited.rebound, commandEnvironmentNames(projected[si].argv)) }, ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}), ...(exportedFunctions.size > 0 ? { thread: { physical: false, functions: exported, unread: exported, reached: workdir.reached }, names: inheritedExportedFunctions(exportedFunctions) } : {}) } : { ...laterStart, thread: heldThread(moves.functions, workdir.mayBePhysical || moves.physicalAt.some(Boolean)), names: names.heldAnywhere(), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) }, at);
95
95
  const nestedPlanner = (table, si) => (text, kind, at) => planShellReads(text, decl, depth + 1, nestedTextStart(table, si, kind, at));
96
96
  const empty = lexed.segments.map((segment, si) => segmentIsEmpty(segment, projected[si]));
97
97
  const facts = projected.map(() => undefined);
@@ -124,7 +124,7 @@ function planText(command, decl, depth, start, from) {
124
124
  return { end: ran.end, physical: ran.physical, reached: ran.reached, ...(ran.unsettled === true ? { unsettled: true } : {}) };
125
125
  },
126
126
  };
127
- const evalStart = (table) => ({ initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.unread), names: heldAt(table, names.functionBound()) });
127
+ const evalStart = (table) => ({ initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched || table.commandSets.has("HOME"), inherited: { ...table.inherited, rebound: joinRebound(table.inherited.rebound, table.commandSets) }, thread: heldThread(moves.unread), names: heldAt(table, names.functionBound()), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) });
128
128
  const heldThread = (unread, physical = workdir.mayBePhysical) => ({ physical, functions: moves.functions, unread, reached: workdir.reached });
129
129
  let andRunStart = 0;
130
130
  let crossedAllAnd = true;
@@ -192,21 +192,16 @@ function planText(command, decl, depth, start, from) {
192
192
  const end = loopEndOf.get(si);
193
193
  if (end !== undefined) {
194
194
  const body = named.slice(si + 1, end);
195
- names.kill(si, body.some((e) => e.all === "unknown") ? "all" : [...body.flatMap((e) => e.bindings.map((b) => b.name)), ...(moves.mayMove.slice(si + 1, end).some(Boolean) ? ["PWD", "OLDPWD"] : [])], lexed.segments[si].spliced === true);
195
+ const carried = bindingFloors(body.flatMap((e) => e.bindings));
196
+ names.kill(si, body.some((e) => e.all === "unknown") ? "all" : [...carried.keys(), ...(moves.mayMove.slice(si + 1, end).some(Boolean) ? ["PWD", "OLDPWD"] : [])], carried);
196
197
  }
197
198
  const segment = lexed.segments[si];
198
- const effect = bindingEffectOf(segment, projected[si].argv, projected[si], (w, quoted, overlay) => valueOf(w, table, quoted, overlay), moves.callAt(si, table), (builtin) => table.builtinState(builtin), ...readFeedOf(si));
199
+ const effect = bindingEffectOf(segment, projected[si].argv, projected[si], (w, quoted, overlay) => valueOf(w, table, quoted, overlay), moves.callAt(si, table), (builtin) => table.builtinState(builtin), ...readFeedOf(si), floorReaderOf(table));
199
200
  const { all, ...rest } = effect;
200
201
  names.apply(si, all === "reset" ? rest : effect, segment.connector === "&&" || segment.connector === "||", end, segment.spliced === true);
201
202
  if (moves.callAt(si, table) !== undefined) {
202
- const bound = moves.callsUnread(si, table) ? "all" : names.functionBound();
203
- if (bound === "all")
204
- names.kill(si, "all", segment.spliced === true);
205
- else {
206
- const maybe = names.functionMaybeBound();
207
- names.kill(si, [...bound].filter((n) => !maybe.has(n)), segment.spliced === true);
208
- names.kill(si, maybe, true);
209
- }
203
+ const bound = names.functionBindings();
204
+ names.kill(si, moves.callsUnread(si, table) || bound === "all" ? "all" : bound.keys(), bound === "all" ? undefined : bound);
210
205
  }
211
206
  if (moves.bodiesAt[si].length > 0)
212
207
  names.runsLater(si, moves.bodiesAt[si].reduce((held, b) => joinRebound(held, namesBoundIn(b)), names.functionBound()));
@@ -254,6 +249,13 @@ function planText(command, decl, depth, start, from) {
254
249
  };
255
250
  walk(projected.map((_, si) => si), true);
256
251
  closeScopes();
252
+ projected.forEach((_, si) => {
253
+ const table = tables[si];
254
+ if (!names.inFunctionBody(si) || facts[si] === undefined || table === undefined)
255
+ return;
256
+ facts[si] = undefined;
257
+ factsAt(si, table);
258
+ });
257
259
  const end = workdir.end();
258
260
  const gather = (ats) => {
259
261
  const at = new Map();
@@ -277,7 +279,7 @@ function planText(command, decl, depth, start, from) {
277
279
  const key = JSON.stringify([j, t.text, t.in, s.at.map(keyOf)]);
278
280
  let ran = handedCallers.get(key);
279
281
  if (ran === undefined) {
280
- const start = t.in === "shell" ? evalStart(table) : nestedTextStart(table, j, t.in === "child" ? "now" : "substitution", undefined, t.functions);
282
+ const start = t.in === "shell" ? evalStart(withCommandEnvironment(table, projected[j].argv)) : nestedTextStart(table, j, t.in === "child" ? "now" : "substitution", undefined, t.functions);
281
283
  ran = planText(t.text, decl, depth + 1, start, s.at).callers ?? s;
282
284
  handedCallers.set(key, ran);
283
285
  }
@@ -383,7 +385,7 @@ function planText(command, decl, depth, start, from) {
383
385
  ...(f.verb !== undefined ? { verb: f.verb } : {}),
384
386
  ...(f.reentry !== undefined ? { reentry: f.reentry } : {}),
385
387
  ...(f.unreadProgramText !== undefined ? { unreadProgramText: f.unreadProgramText } : {}),
386
- ...(f.stdin !== undefined ? { stdin: f.stdin } : {}),
388
+ ...(f.stdin !== undefined ? { stdin: f.stdin.map(stdinTextOf) } : {}),
387
389
  declines: f.declines,
388
390
  reads: dedupe(f.reads).map(programRead),
389
391
  redirects: f.redirects.map((r) => ({ op: r.op, direction: r.direction, ...(r.fd !== undefined ? { fd: r.fd } : {}), ...(r.target !== undefined ? { target: withBases(r.target) } : {}) })),
@@ -463,7 +465,7 @@ function readingFacts(segment, p, decl, reading, nestedPlan, fed, inheritedFns =
463
465
  const unsettle = (c) => floor((unresolvedRaw.has(c.raw) || (homeWithheld && c.spelled.startsWith("~"))) && c.expands !== "unresolvable" ? { ...c, expands: "unresolvable" } : c);
464
466
  const each = (c) => {
465
467
  const { floors, ...one } = c;
466
- const shadows = (floors ?? []).map((v) => ({ spelled: v.spelled, ...(v.pattern !== undefined ? { pattern: v.pattern } : {}), raw: one.raw, provenance: one.provenance, expands: v.glob === true ? "glob" : false, denyOnly: true }));
468
+ const shadows = (floors ?? []).map((v) => ({ spelled: v.spelled, ...(v.pattern !== undefined ? { pattern: v.pattern } : {}), raw: one.raw, provenance: one.provenance, expands: v.piece === true ? "unresolvable" : v.glob === true ? "glob" : false, denyOnly: true }));
467
469
  return [unsettle(one), ...shadows];
468
470
  };
469
471
  const move = facts.baseMove;
@@ -3,15 +3,16 @@
3
3
  *
4
4
  * `. ./lib.sh` / `source lib.sh` run a file's text in THIS shell: the functions it defines stand after it, and a call
5
5
  * to one later runs its body where the call stands. The station cannot read a file — but where the same command wrote
6
- * the file first, with a literal printer and a `>` redirection (`printf 'f(){ …; }\n' > lib.sh; . ./lib.sh`), the text
7
- * it sources IS the literal the printer spells: the segments of that literal are spliced in place of the `source`
6
+ * the file first, with a literal printer and a `>` redirection (`printf 'f(){ …; }\n' > lib.sh; . ./lib.sh`, or `cat`
7
+ * fed a here-document the shell expands nothing in), the text it sources IS the literal the printer spells: the
8
+ * segments of that literal are spliced in place of the `source`
8
9
  * segment, before anything is projected, so every later reader (definitions, bodies, callers, bindings, the
9
10
  * working-directory thread) reads them as the shell runs them — no reader of its own.
10
11
  *
11
12
  * Fail-closed where the claim does not hold: a file the command did not write IMMEDIATELY before the source (another
12
13
  * segment between — a second write, a move, a pipe, a group — is a claim the station does not make), a write reached
13
14
  * through `&&` / `||` that the source is not chained to (it may not have run), a write with `>>`, through a pipe, with
14
- * a word the shell rewrites or a format that converts, a printer with a launcher or a prefix assignment, a `source`
15
+ * a word the shell rewrites, a format that converts or a here-document the shell expands, a printer with a launcher or a prefix assignment, a `source`
15
16
  * carrying a redirection of its own, or a literal the lexer cannot read, splices nothing — the `source` segment stays what it was (text run in this shell that the
16
17
  * station does not hold: an unsettled start, the #3358 law). Bash's `sourcepath` PATH search of a bare name is not
17
18
  * read: the file the command wrote at that spelling is taken as the text (docs/KNOWN-LIMITS.md KL-3400-a).
@@ -32,9 +32,17 @@ function printfFormatText(format) {
32
32
  }
33
33
  return out;
34
34
  }
35
+ function hereDocumentText(h) {
36
+ if (h.body.split("\n").some((line) => line.startsWith("\t")))
37
+ return undefined;
38
+ if (!h.quoted && /[$`\\]/.test(h.body))
39
+ return undefined;
40
+ return h.body.length === 0 ? "" : `${h.body}\n`;
41
+ }
35
42
  function writtenLiteralOf(segment) {
36
43
  const redirects = segment.tokens.filter((t) => t.kind === "redirect");
37
- if (redirects.length !== 1 || segment.tokens.some((t) => t.kind === "heredoc" || t.kind === "group"))
44
+ const heredocs = segment.tokens.filter((t) => t.kind === "heredoc");
45
+ if (redirects.length !== 1 || heredocs.length > 1 || segment.tokens.some((t) => t.kind === "group"))
38
46
  return undefined;
39
47
  const r = redirects[0];
40
48
  if (r.kind !== "redirect" || r.op !== ">" || (r.fd ?? 1) !== 1 || r.target === undefined)
@@ -50,6 +58,15 @@ function writtenLiteralOf(segment) {
50
58
  if (words.some((w) => w === undefined))
51
59
  return undefined;
52
60
  const literal = words;
61
+ const heredoc = heredocs[0];
62
+ if (pos.program.basename === "cat") {
63
+ if (heredoc === undefined || literal.length !== 0 || (heredoc.fd ?? 0) !== 0 || heredoc.allocated === true)
64
+ return undefined;
65
+ const text = hereDocumentText(heredoc);
66
+ return text === undefined ? undefined : { file, text };
67
+ }
68
+ if (heredoc !== undefined)
69
+ return undefined;
53
70
  if (pos.program.basename === "printf") {
54
71
  if (literal.length !== 1)
55
72
  return undefined;
@@ -6,10 +6,10 @@
6
6
  * does —, unless it starts in a working directory of its own.
7
7
  */
8
8
  import { type LexedSegment } from "../../shell/lex.js";
9
- import type { BindingTable, FloorValue, InheritedBody, InheritedFunctions, NameReader } from "./shell-read-bindings.js";
9
+ import { type BindingTable, type InheritedBody, type InheritedFunctions, type NameReader, type WordFloor } from "./shell-read-bindings.js";
10
10
  import { type ProgramPosition } from "./bash-program-position.js";
11
11
  import { type TargetUser } from "./program-read-model.js";
12
- import type { StdinText } from "./shell-reentry-text.js";
12
+ import type { InputText } from "./shell-reentry-text.js";
13
13
  import type { ReadCandidate, ShellReadPlan } from "./shell-read-plan.js";
14
14
  import type { Read } from "./shell-read-word.js";
15
15
  /** Where a nested text starts its names: a substitution body inherits the table of the segment it sits in (a subshell
@@ -33,7 +33,7 @@ export interface PlanStart {
33
33
  * ({@link InheritedFunctions}). A text a new process runs (a child shell's `-c`) holds none: every builtin enabled, no function. */
34
34
  readonly names?: InheritedFunctions;
35
35
  /** What arrives on its own standard input (the input of the shell running it). */
36
- readonly stdin?: readonly StdinText[];
36
+ readonly stdin?: readonly InputText[];
37
37
  /** The functions the shell running this text inherited (`export -f`, an environment's `BASH_FUNC_*`), each with whether
38
38
  * its body is text the engine read ({@link InheritedBody}), inherited by it and by ITS child shells: a child adds its own
39
39
  * exports and passes the whole on, so a grandchild still sees a function exported two shells up (#1628). Only on a
@@ -61,9 +61,9 @@ export declare function heldAt(table: BindingTable, bound?: InheritedFunctions["
61
61
  /** What a segment says of the start of a text it hands a shell to run later: the deny floors of the words it holds as
62
62
  * written, the user the shell runs as ({@link TargetUser}), and the shell's standard input. */
63
63
  export interface NestedStart {
64
- readonly floors?: ReadonlyMap<string, readonly FloorValue[]>;
64
+ readonly floors?: ReadonlyMap<string, WordFloor>;
65
65
  readonly as?: TargetUser;
66
- readonly stdin?: readonly StdinText[];
66
+ readonly stdin?: readonly InputText[];
67
67
  }
68
68
  /** Where a text run later starts ({@link NestedStart}): the later start, with the shell's standard input, the floors of the
69
69
  * words that hand it on, and — run as another user — that user's `HOME` (the caller's, the target's, or either) and, for
@@ -77,7 +77,7 @@ export declare function plannedOnce<K, P>(plan: (text: string, kind: K, at?: Nes
77
77
  * prints); else the input of the group (`{ …; }`, `( … )`) it stands in — a group a pipe feeds hands each member that
78
78
  * pipe; else the input the text itself was handed (`start`: a shell's `-c` text reads that shell's standard input).
79
79
  */
80
- export declare function stdinFeeds(segments: readonly LexedSegment[], start: readonly StdinText[], piped: (si: number) => readonly StdinText[]): (si: number) => readonly StdinText[];
80
+ export declare function stdinFeeds(segments: readonly LexedSegment[], start: readonly InputText[], piped: (si: number) => readonly InputText[]): (si: number) => readonly InputText[];
81
81
  /**
82
82
  * Where a nested text with no working directory of its own starts (a substitution body, a here-document's substitution, a
83
83
  * launcher's command string): a PLACEHOLDER below the declared working directory, joined as its path family joins, whose last
@@ -1,4 +1,5 @@
1
1
  import { literalTildeSpelling } from "../../shell/lex.js";
2
+ import { joinedFloors } from "./shell-read-bindings.js";
2
3
  import { programBasename } from "./bash-program-position.js";
3
4
  import { launcherOptionPathRole, launcherOptionStep, programRow, readOptionRole } from "./program-read-model.js";
4
5
  import { chdirFrom } from "./shell-read-object-path.js";
@@ -36,12 +37,6 @@ export function plannedOnce(plan) {
36
37
  return planned.get(key);
37
38
  };
38
39
  }
39
- function joinedFloors(a, b) {
40
- const out = new Map(a);
41
- for (const [name, floors] of b)
42
- out.set(name, [...(out.get(name) ?? []), ...floors]);
43
- return out;
44
- }
45
40
  export function stdinFeeds(segments, start, piped) {
46
41
  const opener = [];
47
42
  const enclosing = [];
@@ -5,7 +5,7 @@
5
5
  * does to the word before the program sees it.
6
6
  */
7
7
  import { type LexedCommand, type LexedWord, type WordPiece } from "../../shell/lex.js";
8
- import { type BindingTable, type BoundValue, type FloorValue } from "./shell-read-bindings.js";
8
+ import { type BindingTable, type BoundValue, type FloorValue, type WordFloor } from "./shell-read-bindings.js";
9
9
  /** `"glob"` = an unquoted pathname-expansion character; `"unresolvable"` = the shell rewrites the word (a brace,
10
10
  * variable or command substitution) so its text is not the path. The read candidate's own field, spelled here. */
11
11
  export type WordExpands = false | "glob" | "unresolvable";
@@ -34,6 +34,8 @@ export interface Read {
34
34
  /** The word's names are unknown here, but their bindings left spellings for the deny judge (an array's elements):
35
35
  * what the word may then spell, for the deny judge alone. */
36
36
  readonly floorValues?: readonly FloorValue[];
37
+ /** The word's deny floor passed the reader's bound ({@link import("./shell-read-bindings.js").WordFloor.pastBound}). */
38
+ readonly floorPastBound?: true;
37
39
  }
38
40
  /** The reads of a segment's words against the binding table at that segment (`homeDir` = the declared home, the
39
41
  * state `HOME` starts in). A word that refers to no name, or only to a `HOME` the text has not touched (`~/x`, placed
@@ -50,7 +52,7 @@ export interface SegmentReading {
50
52
  readonly table: BindingTable;
51
53
  readonly reads: readonly Read[];
52
54
  readonly argv: readonly LexedWord[];
53
- readonly floors: ReadonlyMap<string, readonly FloorValue[]>;
55
+ readonly floors: ReadonlyMap<string, WordFloor>;
54
56
  }
55
57
  /**
56
58
  * The readings of one segment's words (its argv and its redirection targets): the names they read through the table that
@@ -1,6 +1,6 @@
1
1
  import { argvOf, assignedWords, lexShell, literalTildeSpelling, UNRESOLVED_SENTENCE } from "../../shell/lex.js";
2
2
  import { expansionInWord, extglobOpenerIn, globInWord, homeExpansionOf } from "./bash-readonly-classifier.js";
3
- import { floorOf, judgedSpellingOf, namesIn, wordFloorValues, wordValues } from "./shell-read-bindings.js";
3
+ import { floorOf, isEmptyFloor, joinFloors, judgedSpellingOf, NO_FLOOR, namesIn, wordFloorValues, wordValues } from "./shell-read-bindings.js";
4
4
  import { READINGS_MAX } from "./shell-read-brace.js";
5
5
  export function readsOf(words, table, homeDir, split = false) {
6
6
  return words.map((word) => {
@@ -12,8 +12,8 @@ export function readsOf(words, table, homeDir, split = false) {
12
12
  if (values === undefined)
13
13
  return { ...asWritten, expands: expandsOf(word) };
14
14
  if (values === "unknown") {
15
- const floors = refersToName ? wordFloorValues(word, table) : [];
16
- return { ...asWritten, expands: refersToName ? "unresolvable" : expandsOf(word), ...(floors.length > 0 ? { floorValues: floors } : {}) };
15
+ const floor = refersToName ? wordFloorValues(word, table) : NO_FLOOR;
16
+ return { ...asWritten, expands: refersToName ? "unresolvable" : expandsOf(word), ...(floor.values.length > 0 ? { floorValues: floor.values } : {}), ...(floor.pastBound ? { floorPastBound: true } : {}) };
17
17
  }
18
18
  const glob = values.some((v) => v.glob === true) || globInWord(word);
19
19
  const refersToHome = word.pieces.some((p) => p.expansion?.kind === "tilde" || (p.expansion?.kind === "parameter" && p.expansion.name === "HOME"));
@@ -68,8 +68,8 @@ export function segmentReadingsOf(argv, targets, table, homeDir) {
68
68
  if (name === undefined)
69
69
  continue;
70
70
  const held = reading.stateOf(name);
71
- const floor = [...(held === "unknown" ? [] : held.map(floorOf)), ...reading.floorOf(name)];
72
- if (floor.length > 0)
71
+ const floor = joinFloors({ values: held === "unknown" ? [] : held.map(floorOf), pastBound: false }, reading.floorOf(name));
72
+ if (!isEmptyFloor(floor))
73
73
  floors.set(name, floor);
74
74
  }
75
75
  }
@@ -82,6 +82,7 @@ function namesReadIn(word, table) {
82
82
  function overlaidTable(table, overlay) {
83
83
  return {
84
84
  stateOf: (name) => overlay.get(name) ?? table.stateOf(name),
85
+ arrayOf: (name) => (overlay.has(name) ? undefined : table.arrayOf(name)),
85
86
  isInteger: (name) => table.isInteger(name),
86
87
  ifsTouched: table.ifsTouched,
87
88
  homeTouched: table.homeTouched,
@@ -91,7 +92,7 @@ function overlaidTable(table, overlay) {
91
92
  builtinState: (name) => table.builtinState(name),
92
93
  floorOf: (name) => {
93
94
  const held = table.stateOf(name);
94
- return overlay.get(name) !== "unknown" || held === "unknown" ? table.floorOf(name) : [...table.floorOf(name), ...held.map(floorOf)];
95
+ return overlay.get(name) !== "unknown" || held === "unknown" ? table.floorOf(name) : joinFloors(table.floorOf(name), { values: held.map(floorOf), pastBound: false });
95
96
  },
96
97
  inherited: table.inherited,
97
98
  };
@@ -51,7 +51,7 @@ export type BaseShift = {
51
51
  export interface WorkdirContext {
52
52
  readonly homeDir?: string;
53
53
  readonly textBinds: (name: string) => boolean;
54
- readonly evalEnd: (text: string, from: readonly BaseCandidate[] | "unmodelled", table: BindingTable) => {
54
+ readonly evalEnd: (text: string, from: readonly BaseCandidate[] | "unmodelled", table: CommandTable) => {
55
55
  readonly end: readonly BaseCandidate[] | "unmodelled";
56
56
  readonly physical: boolean;
57
57
  readonly reached: ReadonlySet<string>;
@@ -151,16 +151,28 @@ export interface StdinText {
151
151
  * only — bash ≥ 4.1 puts it on a descriptor of its own and leaves standard input what it was. */
152
152
  readonly allocated?: true;
153
153
  }
154
- /** The text a producer's words say it prints ({@link printedText}): one simple command — no redirection, here-document or
155
- * group — whose program word and every argument are literal, run by a printer row. `undefined` for any other producer. The
156
- * reading is no claim about the stream (a function, an alias or a trap of the printer's name, a second writer on it are not
157
- * read): its one reader refuses by it and never clears by it (`ShellReadSegment.printed`). */
154
+ /** A text as the station reads it: the {@link StdinText} and the words it is made of, where the command spells them
155
+ * ({@link TextSource}). The plan reports the {@link StdinText} alone ({@link stdinTextOf}). */
156
+ export interface InputText extends StdinText {
157
+ readonly source?: TextSource;
158
+ }
159
+ /** The {@link StdinText} a plan reports of an input text. */
160
+ export declare function stdinTextOf(input: InputText): StdinText;
161
+ /** The words a text is made of where the command spells them, and how the text is made of their texts (`made`): a
162
+ * here-string's word (the word and a newline), a here-document's body (the body), a printer's operands (what it prints,
163
+ * {@link printedText}). `made` answers `undefined` for a text it does not read (a word it is not handed, a printer form the
164
+ * station does not spell). What a builtin the text feeds binds is read off it for the deny judge alone
165
+ * ({@link import("./shell-read-bindings.js").sourcedFloor}). */
166
+ export interface TextSource {
167
+ readonly words: readonly Pick<LexedWord, "pieces">[];
168
+ readonly made: (texts: readonly (string | undefined)[]) => string | undefined;
169
+ }
170
+ /** The text a producer's words say it prints, where every one is literal ({@link printerOf}). */
158
171
  export declare function printedBy(segment: LexedSegment): string | undefined;
159
172
  /** What a pipe hands the segment after it: the producing segment as written, and the text it spells where it is a literal
160
- * printer ({@link printedBy}). */
161
- export declare function pipedTextOf(producer: LexedSegment): StdinText;
162
- /** The text a word that is one process substitution prints, where its body is one literal printer ({@link printedBy}):
163
- * `<(printf 'X')` — a script file a shell is handed, or the file its standard input is redirected from. */
173
+ * printer ({@link printedBy}) — its words where it is a printer ({@link printerOf}). */
174
+ export declare function pipedTextOf(producer: LexedSegment): InputText;
175
+ /** The text a word that is one process substitution prints, where its printer's words are literal ({@link processPrinterOf}). */
164
176
  export declare function printedByProcess(word: LexedWord): string | undefined;
165
177
  /** What may arrive on a segment's standard input: each here-document opened on descriptor 0 (one on another descriptor, `3<<EOF`, is not standard input) —
166
178
  * its body, literal when quoted or when nothing in it expands — each here-string (literal when its word is), `<` file
@@ -168,4 +180,7 @@ export declare function printedByProcess(word: LexedWord): string | undefined;
168
180
  * pipe or the input of the group it stands in, the input of the shell running its text) unless one of those three
169
181
  * replaces it. One opened on a `{NAME}` descriptor is in the list (bash 3.2 reads it on 0) and replaces nothing (bash ≥ 4.1
170
182
  * does not): both readings ({@link StdinText.allocated}). */
171
- export declare function stdinTextsOf(segment: LexedSegment, fed: readonly StdinText[]): StdinText[];
183
+ export declare function stdinTextsOf(segment: LexedSegment, fed: readonly InputText[]): InputText[];
184
+ /** What the segment's own redirections may deliver on descriptor `fd` ({@link inputTextOn}) — a builtin reading another
185
+ * descriptor (`read -u 3`); `fd` absent: one the text does not settle, any of them. */
186
+ export declare function descriptorTextsOf(segment: LexedSegment, fd: number | undefined): InputText[];
@@ -1,4 +1,4 @@
1
- import { lexShell, literalHeredocBody, literalTextOf } from "../../shell/lex.js";
1
+ import { heredocBodyPieces, lexShell, literalHeredocBody, literalTextOf } from "../../shell/lex.js";
2
2
  import { programBasename, readProgramPosition } from "./bash-program-position.js";
3
3
  import { implementationRejects, implementationsOf, printedText, programRow, readArgRoles, selectedOptions, selectedSpellings, targetUserOf } from "./program-read-model.js";
4
4
  import { namesStandardInput } from "./safety.js";
@@ -244,7 +244,12 @@ function scriptSourceOf(row, args) {
244
244
  return { stdin: true };
245
245
  return { file: first.at, stdin: options.some((e) => e.kind === "option" && e.reading === "speculative") };
246
246
  }
247
- export function printedBy(segment) {
247
+ export function stdinTextOf(input) {
248
+ const { source: _words, ...text } = input;
249
+ return text;
250
+ }
251
+ const literalMade = (source) => source.made(source.words.map((w) => literalTextOf(w.pieces)));
252
+ function printerOf(segment) {
248
253
  if (segment.tokens.some((t) => t.kind !== "word"))
249
254
  return undefined;
250
255
  const argv = segment.tokens.filter((t) => t.kind === "word");
@@ -252,36 +257,61 @@ export function printedBy(segment) {
252
257
  const program = pos.program;
253
258
  if (program === undefined || pos.refusal !== undefined || pos.launchers.length > 0 || literalTextOf(argv[program.index].pieces) === undefined)
254
259
  return undefined;
255
- return printedText(programRow(program.basename), argv.slice(program.index + 1).map((w) => literalTextOf(w.pieces)));
260
+ const row = programRow(program.basename);
261
+ return row?.prints === undefined ? undefined : { words: argv.slice(program.index + 1), made: (texts) => printedText(row, texts) };
262
+ }
263
+ export function printedBy(segment) {
264
+ const printer = printerOf(segment);
265
+ return printer === undefined ? undefined : literalMade(printer);
256
266
  }
257
267
  export function pipedTextOf(producer) {
258
- const printed = printedBy(producer);
259
- return { from: `${producer.text.trim()} |`, ...(printed !== undefined ? { printed } : {}) };
268
+ const source = printerOf(producer);
269
+ const printed = source === undefined ? undefined : literalMade(source);
270
+ return { from: `${producer.text.trim()} |`, ...(printed !== undefined ? { printed } : {}), ...(source !== undefined ? { source } : {}) };
260
271
  }
261
- export function printedByProcess(word) {
272
+ function processPrinterOf(word) {
262
273
  const e = word.pieces.length === 1 ? word.pieces[0].expansion : undefined;
263
274
  if (e?.kind !== "process" || e.body === undefined || !word.raw.startsWith("<("))
264
275
  return undefined;
265
276
  const lexed = lexShell(e.body);
266
- return "parseFailure" in lexed || lexed.segments.length !== 1 ? undefined : printedBy(lexed.segments[0]);
277
+ return "parseFailure" in lexed || lexed.segments.length !== 1 ? undefined : printerOf(lexed.segments[0]);
278
+ }
279
+ export function printedByProcess(word) {
280
+ const printer = processPrinterOf(word);
281
+ return printer === undefined ? undefined : literalMade(printer);
267
282
  }
268
283
  export function stdinTextsOf(segment, fed) {
269
284
  const out = [];
270
285
  let replacesPipe = false;
271
286
  for (const t of segment.tokens) {
272
- const onAllocated = (t.kind === "heredoc" || t.kind === "redirect") && t.allocated === true;
273
- const allocated = onAllocated ? { allocated: true } : {};
274
- if (t.kind === "heredoc" && (t.fd ?? 0) === 0) {
275
- const literal = t.quoted ? t.body : literalHeredocBody(t.body);
276
- out.push(literal === undefined ? { from: t.body, ...allocated } : { from: t.body, literal, ...allocated });
277
- }
278
- else if (t.kind === "redirect" && (t.fd ?? 0) === 0 && (t.op === "<<<" || t.op === "<" || t.op === "<>" || (t.op === "<&" && t.dup !== "-"))) {
279
- const literal = t.op === "<<<" && t.target !== undefined ? literalTextOf(t.target.pieces) : undefined;
280
- const printed = t.op === "<" && t.target !== undefined ? printedByProcess(t.target) : undefined;
281
- out.push({ from: `${t.op}${t.target?.raw ?? t.dup ?? ""}`, ...(literal !== undefined ? { literal } : {}), ...(printed !== undefined ? { printed } : {}), ...allocated });
282
- if (!onAllocated)
283
- replacesPipe = true;
284
- }
287
+ const text = inputTextOn(t, 0);
288
+ if (text === undefined)
289
+ continue;
290
+ out.push(text);
291
+ if (t.kind === "redirect" && text.allocated !== true)
292
+ replacesPipe = true;
285
293
  }
286
294
  return replacesPipe ? out : [...fed, ...out];
287
295
  }
296
+ export function descriptorTextsOf(segment, fd) {
297
+ return segment.tokens.flatMap((t) => {
298
+ const text = fd !== undefined ? inputTextOn(t, fd) : t.kind === "heredoc" || t.kind === "redirect" ? inputTextOn(t, t.fd ?? 0) : undefined;
299
+ return text === undefined ? [] : [text];
300
+ });
301
+ }
302
+ function inputTextOn(t, fd) {
303
+ const allocated = (t.kind === "heredoc" || t.kind === "redirect") && t.allocated === true ? { allocated: true } : {};
304
+ if (t.kind === "heredoc" && (t.fd ?? 0) === fd) {
305
+ const literal = t.quoted ? t.body : literalHeredocBody(t.body);
306
+ const pieces = t.quoted ? [{ span: [0, t.body.length], quotedBy: "'", literal: t.body }] : heredocBodyPieces(t.body);
307
+ const source = pieces === undefined ? undefined : { words: [{ pieces }], made: ([body]) => body };
308
+ return { from: t.body, ...(literal !== undefined ? { literal } : {}), ...(source !== undefined ? { source } : {}), ...allocated };
309
+ }
310
+ if (t.kind !== "redirect" || (t.fd ?? 0) !== fd || !(t.op === "<<<" || t.op === "<" || t.op === "<>" || (t.op === "<&" && t.dup !== "-")))
311
+ return undefined;
312
+ const literal = t.op === "<<<" && t.target !== undefined ? literalTextOf(t.target.pieces) : undefined;
313
+ const printer = t.op === "<" && t.target !== undefined ? processPrinterOf(t.target) : undefined;
314
+ const printed = printer === undefined ? undefined : literalMade(printer);
315
+ const source = t.op === "<<<" && t.target !== undefined ? { words: [t.target], made: ([word]) => (word === undefined ? undefined : `${word}\n`) } : printer;
316
+ return { from: `${t.op}${t.target?.raw ?? t.dup ?? ""}`, ...(literal !== undefined ? { literal } : {}), ...(printed !== undefined ? { printed } : {}), ...(source !== undefined ? { source } : {}), ...allocated };
317
+ }
@@ -44,6 +44,7 @@ import { type MonitorTimers, type TaskRegistry } from "../core/task-registry.js"
44
44
  import { type TaskNotificationPayload } from "../core/task-notification.js";
45
45
  import type { ShellReadAdmission } from "./fs/shell-read-check.js";
46
46
  import type { ReadFloorSeat } from "./fs/read-floor.js";
47
+ import { type CommandSandboxSeat } from "../core/command-sandbox.js";
47
48
  /** The refusal a watch gets where no event or completion would come back from it (no completion sink for the call, no
48
49
  * mount sink): nothing is spawned. */
49
50
  export declare const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here \u2014 no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
@@ -79,6 +80,9 @@ export interface MonitorToolOptions {
79
80
  /** The byte floor's seat (read-floor.ts) — the SAME table the shell faces carry: the watched command's start hands it to
80
81
  * the environment. Absent ⇒ the start carries no floor. */
81
82
  readFloor?: ReadFloorSeat;
83
+ /** The command sandbox seat (`command-sandbox.ts`) — the SAME one the shell faces take: the watched command's start hands
84
+ * its call's sandbox instruction to the environment, or is refused. Absent ⇒ the start carries no sandbox. */
85
+ commandSandbox?: CommandSandboxSeat;
82
86
  /** RB-465-b (HRD-PTL-3 残件): spec-level retain (`TaskSpec.retainBackgroundProcesses`) — the task lane of
83
87
  * THE retain predicate (`retainsBackgroundProcesses`), OR-composed with the env capability. Read twice,
84
88
  * by the same predicate: the persistent-watch receipt's wording, and the row's `retained` mark at
@@ -5,8 +5,11 @@ import { MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, } from "../core/tas
5
5
  import { admitsBackgroundLaunch, resolveCompletionSink } from "../core/task-notification.js";
6
6
  import { toolFace } from "../core/tool-catalog-entries.js";
7
7
  import { ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs/fs-bash-background-text.js";
8
+ import { sandboxRefusalText } from "../core/command-sandbox.js";
8
9
  import { isDeadCwd, diagnoseDeadCwd } from "./fs/dead-cwd.js";
10
+ import { envErrorDetail } from "./fs/env-error-detail.js";
9
11
  import { thrownText } from "../core/thrown-value.js";
12
+ import { callScopeOf } from "../core/isolation-scope.js";
10
13
  export const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here — no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
11
14
  const MONITOR_DESCRIPTION = "Run a shell command in the background and watch its stdout as a stream of events.\n" +
12
15
  "\n" +
@@ -86,16 +89,23 @@ export function createMonitorTool(env, opts) {
86
89
  if (ctx.signal?.aborted === true)
87
90
  return errorResult("Error (Monitor): the call was cancelled before the watch started.");
88
91
  const readFloor = opts.readFloor?.(ctx.toolCallId);
92
+ const sandbox = opts.commandSandbox?.();
93
+ if (sandbox !== undefined && !sandbox.ok)
94
+ return errorResult(sandboxRefusalText("Monitor", { by: "gate" }), { type: "monitor-start", sandboxUnavailable: true });
89
95
  const spawn = await env.spawnBackground(command, {
90
96
  ...(opts.cwdRef !== undefined ? { cwd: opts.cwdRef.current } : {}),
91
97
  ...(spawnTimeoutSec !== undefined ? { timeout: spawnTimeoutSec } : {}),
92
98
  ...(readFloor !== undefined ? { readFloor } : {}),
99
+ ...(sandbox?.sandbox !== undefined ? { sandbox: sandbox.sandbox } : {}),
93
100
  });
94
- if (!spawn.ok)
95
- return errorResult(`Error (Monitor): ${spawn.error.message}`);
101
+ if (!spawn.ok) {
102
+ if (spawn.error.code === "sandbox_unavailable")
103
+ return errorResult(sandboxRefusalText("Monitor", { by: "environment", detail: envErrorDetail(spawn.error.message), refusedBy: spawn.error.refusedBy }), { type: "monitor-start", sandboxUnavailable: true, refusedBy: spawn.error.refusedBy ?? "environment" });
104
+ return errorResult(`Error (Monitor): ${envErrorDetail(spawn.error.message)}`);
105
+ }
96
106
  const sessionScoped = isPersistent && opts.sessionId !== undefined;
97
107
  const owner = sessionScoped ? opts.sessionId : (ctx.taskId ?? opts.owner);
98
- const scope = ctx.principal ?? opts.scope;
108
+ const scope = callScopeOf(ctx, opts);
99
109
  const outputFile = await createBackgroundOutputFile(env, "monitor-task-");
100
110
  let taskId;
101
111
  try {
@@ -125,7 +135,7 @@ export function createMonitorTool(env, opts) {
125
135
  try {
126
136
  const kill = await env.killBackground(spawn.value.shellId);
127
137
  if (!kill.ok)
128
- killDetail = `${kill.error.code}: ${kill.error.message}`;
138
+ killDetail = `${kill.error.code}: ${envErrorDetail(kill.error.message)}`;
129
139
  }
130
140
  catch (killErr) {
131
141
  killDetail = thrownText(killErr);