@sema-agent/core 7.66.0 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (903) hide show
  1. package/CHANGELOG.md +3498 -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 +145 -0
  71. package/dist/brain/model-lane.js +444 -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 +161 -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 +103 -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 +6 -0
  362. package/dist/core/roles.js +65 -4
  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 +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -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 +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
  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 +13 -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 +115 -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 +63 -34
  730. package/dist/index.js +44 -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 +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,13 +1,13 @@
1
1
  import { join } from "node:path";
2
2
  import { receiveRetentionPolicy } from "../../core/retention-policy.js";
3
- import { WorkflowRunStoreError, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, WORKFLOW_RUN_REAP_KNOBS, } from "../../core/workflow-run-store.js";
3
+ import { WorkflowRunStoreError, admitWorkflowRun, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, readStoredWorkflowRun, workflowRunReapCandidates, WORKFLOW_RUN_REAP_KNOBS, WORKFLOW_RUN_ROW_SHAPE, } from "../../core/workflow-run-store.js";
4
4
  import { SharedLedgerTable } from "./shared-ledger.js";
5
5
  import { guardCorruptSink } from "./corrupt-read-sink.js";
6
6
  import { assertAdoptionBootGate } from "./adoption/marker.js";
7
7
  import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
8
8
  import { readLedgerTuning } from "./ledger-tuning.js";
9
9
  const FILE_WORKFLOW_RUN_STORE_OPTION_KEYS = optionKeys()({ fsync: 0, compactEvery: 0, onCorruptRead: 0 });
10
- const isRunRow = (x) => x !== null && typeof x === "object" && typeof x.id === "string";
10
+ const isRunRow = (x) => WORKFLOW_RUN_ROW_SHAPE.rowKey(x);
11
11
  const runLedgers = new SharedLedgerTable({
12
12
  label: "workflow-run ledger",
13
13
  keyOf: (run) => run.id,
@@ -31,6 +31,7 @@ export class FileWorkflowRunStore {
31
31
  compactEvery;
32
32
  ledger;
33
33
  closed = false;
34
+ disclose;
34
35
  get runs() {
35
36
  return this.ledger.rows;
36
37
  }
@@ -41,11 +42,14 @@ export class FileWorkflowRunStore {
41
42
  this.fsyncEnabled = tuning.fsync;
42
43
  this.compactEvery = tuning.compactEvery;
43
44
  const dir = join(root, "workflow-runs");
45
+ const sink = guardCorruptSink(opts.onCorruptRead);
46
+ const ledgerPath = join(dir, "runs.jsonl");
47
+ this.disclose = sink === undefined ? undefined : (reason) => sink({ kind: "file", path: ledgerPath, reason });
44
48
  this.ledger = runLedgers.acquire({
45
49
  dir,
46
50
  tmpDir: join(root, "tmp"),
47
- ...(opts.onCorruptRead !== undefined ? { onCorruptRead: guardCorruptSink(opts.onCorruptRead) } : {}),
48
- ledgerPath: join(dir, "runs.jsonl"),
51
+ ...(sink !== undefined ? { onCorruptRead: sink } : {}),
52
+ ledgerPath,
49
53
  snapshotPath: join(dir, "runs.snapshot.jsonl"),
50
54
  });
51
55
  }
@@ -63,16 +67,16 @@ export class FileWorkflowRunStore {
63
67
  const stored = structuredClone(run);
64
68
  stored.id = id;
65
69
  stored.rev = run.rev ?? 0;
66
- this.commit({ t: "put", id, run: stored }, this.fsyncEnabled);
70
+ this.commit({ t: "put", id, run: admitWorkflowRun(stored, id) }, this.fsyncEnabled);
67
71
  });
68
72
  }
69
73
  async get(id) {
70
74
  const run = this.runs.get(id);
71
- return run ? structuredClone(run) : null;
75
+ return run ? structuredClone(readStoredWorkflowRun(run, { key: id }, this.disclose)) : null;
72
76
  }
73
77
  async update(id, scope, run, expect) {
74
78
  return this.withLock(id, () => {
75
- const next = nextWorkflowRunOnUpdate(this.runs.get(id), id, scope, run, expect);
79
+ const next = nextWorkflowRunOnUpdate(this.runs.get(id), id, scope, run, expect, this.disclose);
76
80
  if (!next)
77
81
  return false;
78
82
  this.commit({ t: "update", id, run: next }, this.fsyncEnabled);
@@ -80,18 +84,17 @@ export class FileWorkflowRunStore {
80
84
  });
81
85
  }
82
86
  async listByScope(scope, opts) {
83
- return queryWorkflowRuns(this.runs.values(), scope, opts);
87
+ return queryWorkflowRuns(this.runs.entries(), scope, opts, this.disclose);
84
88
  }
85
89
  async reap(scope, now, opts) {
86
90
  const policy = receiveRetentionPolicy("WorkflowRunStore.reap", opts, WORKFLOW_RUN_REAP_KNOBS);
87
91
  if (policy.maxAgeMs === undefined && policy.keep === undefined)
88
92
  return 0;
89
- const terminal = [...this.runs.values()].filter((r) => r.scope === scope && isTerminalWorkflowStatus(r.status));
90
- terminal.sort((a, b) => b.createdAt - a.createdAt);
93
+ const terminal = workflowRunReapCandidates(this.runs.entries(), scope, this.disclose);
91
94
  const doomed = [];
92
95
  for (let i = 0; i < terminal.length; i++) {
93
96
  const r = terminal[i];
94
- const tooOld = policy.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - policy.maxAgeMs;
97
+ const tooOld = policy.maxAgeMs !== undefined && r.age < now - policy.maxAgeMs;
95
98
  const overKeep = policy.keep !== undefined && i >= policy.keep;
96
99
  if (tooOld || overKeep)
97
100
  doomed.push({ id: r.id, byAge: tooOld });
@@ -10,6 +10,7 @@ const ARTIFACT_ACTION_LEGS = {
10
10
  };
11
11
  import { ARTIFACT_TOOL_NAME, mountRuleFace, toolFace } from "../../core/tool-catalog-entries.js";
12
12
  import { attest, resolveAsk } from "../../core/tool-policy.js";
13
+ import { mintCheckpointId } from "../../core/checkpoint-store.js";
13
14
  import { NOT_BINDABLE } from "../../core/skill-grant-binding.js";
14
15
  import { approvalCardOf } from "../../core/tool-roster.js";
15
16
  import { errorResult } from "../../core/tools.js";
@@ -349,6 +350,7 @@ export function createArtifactTool(opts) {
349
350
  const resolved = await resolveAsk({
350
351
  toolName: ARTIFACT_TOOL_NAME,
351
352
  toolCallId: ctx.toolCallId,
353
+ checkpointId: mintCheckpointId(),
352
354
  args: { action: "read", url },
353
355
  message: `Read a shared artifact: ${inlineUntrusted(url, 300)}${title}${version} — an artifact another person shared with this user; approving covers re-reads of it for the rest of this run.`,
354
356
  requiresRealApproval: true,
@@ -3,6 +3,7 @@ import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, re
3
3
  import { dirname, join, resolve, sep } from "node:path";
4
4
  import { ARTIFACT_HOST_FAILURE_CODES, } from "../../core/artifact-host.js";
5
5
  import { physicalPathOf } from "../../core/physical-path.js";
6
+ import { openExclusiveTemp } from "../../core/exclusive-temp.js";
6
7
  import { acquireStoreDirLock } from "../../stores/file/fs-atomic.js";
7
8
  import { normalizePublishedPath } from "./artifact-tool.js";
8
9
  export const EVAL_STUB_URL_PREFIX = "eval-stub://artifact/";
@@ -76,8 +77,7 @@ function fsyncTreeBestEffort(dir) {
76
77
  fsyncTreeBestEffort(join(dir, entry.name));
77
78
  fsyncDirBestEffort(dir);
78
79
  }
79
- function writeFsync(path, bytes) {
80
- const fd = openSync(path, "w", 0o600);
80
+ function fillFsync(fd, bytes) {
81
81
  try {
82
82
  writeFileSync(fd, bytes);
83
83
  fsyncSync(fd);
@@ -156,10 +156,10 @@ export class LocalArtifactStub {
156
156
  }
157
157
  }
158
158
  #commitLedger(next) {
159
- const ledgerTmp = join(this.dir, `${LEDGER_FILE}.${randomBytes(4).toString("hex")}.tmp`);
159
+ const text = JSON.stringify(next, null, 2);
160
+ const { fd, path: ledgerTmp } = openExclusiveTemp(join(this.dir, LEDGER_FILE));
160
161
  try {
161
- const text = JSON.stringify(next, null, 2);
162
- writeFsync(ledgerTmp, text);
162
+ fillFsync(fd, text);
163
163
  const verified = parseLedger(readFileSync(ledgerTmp, "utf8"), ledgerTmp);
164
164
  if (JSON.stringify(verified) !== JSON.stringify(next))
165
165
  throw new Error("artifact stub ledger did not read back as written");
@@ -216,7 +216,7 @@ export class LocalArtifactStub {
216
216
  for (const f of files) {
217
217
  const target = join(tmpDir, ...f.path.split("/"));
218
218
  mkdirSync(dirname(target), { recursive: true, mode: 0o700 });
219
- writeFsync(target, f.content);
219
+ fillFsync(openSync(target, "wx", 0o600), f.content);
220
220
  }
221
221
  fsyncTreeBestEffort(tmpDir);
222
222
  mkdirSync(dirname(versionDir), { recursive: true, mode: 0o700 });
@@ -145,6 +145,5 @@ export declare function shellScanDeclineOf(pos: ProgramPosition, acceptsStreamTa
145
145
  /** ONE sentence per refusal kind, minted here and nowhere else. */
146
146
  export declare function programPositionRefusalSentence(refusal: ProgramPositionRefusal): string;
147
147
  /** The sentence a segment whose program the walk DECLINED carries, read off the segment's text — the program-position reader's own
148
- * refusal, the stream fact, or that no program could be named: the read station's account of the segment and the removal guard's
149
- * are this one sentence. */
148
+ * refusal, the stream fact, or that no program could be named: the read station's account of the segment. */
150
149
  export declare function declinedProgramSentence(text: string): string;
@@ -110,6 +110,14 @@ export interface LeadingCommandNameOptions {
110
110
  * {@link import("../../core/permission-rule-model.js").BARE_INTERPRETER_NAMES}).
111
111
  */
112
112
  pathPrefixedNameIsText?: boolean;
113
+ /**
114
+ * Read an arithmetic expansion that names nothing — digits, operators and blanks, no variable, no `$`, no
115
+ * substitution ({@link literalArithmeticSpelling}) — as the number it prints, not as an expansion to refuse.
116
+ * Only meaningful with {@link quotedOperatorsAreText}, which is where the leading-name parser reads the lexer's
117
+ * result at all. OPT-IN for the compound classify face, the face that asks "does this command change anything":
118
+ * a persisted rule's text is compared literally, where `ls $((1+2))` and `ls 3` are two commands.
119
+ */
120
+ literalArithmeticIsText?: boolean;
113
121
  }
114
122
  /**
115
123
  * The SINGLE fail-closed simple-command parser shared by `bash_readonly`'s single-command admission, the
@@ -131,6 +139,19 @@ export declare function parseLeadingCommandName(command: string, options?: Leadi
131
139
  } | {
132
140
  reject: string;
133
141
  };
142
+ /** What a refused read-only call is worded by, and the one place each cause is worded: the program is not among a face's
143
+ * programs (`unlisted`), or it is a program the reader's tables know whose call uses an option outside its read-only set
144
+ * (`option` — `sort -o out`: `sort` without it is read-only). */
145
+ export type ReadOnlyRefusalCause = {
146
+ readonly kind: "unlisted";
147
+ readonly program: string;
148
+ } | {
149
+ readonly kind: "option";
150
+ readonly program: string;
151
+ readonly option: string;
152
+ };
153
+ /** The sentence for a {@link ReadOnlyRefusalCause}. */
154
+ export declare function readOnlyRefusalSentence(cause: ReadOnlyRefusalCause): string;
134
155
  /** The one sentence for a program a face's list of programs does not name — the compound classifier's list check and
135
156
  * the read-only reader's `readers` narrowing both mint it here. */
136
157
  export declare function unlistedReaderSentence(program: string): string;
@@ -155,6 +176,9 @@ export interface StrictResidualOptions {
155
176
  /** The declared home: a word that spells it ({@link homeExpansionOf}) is not an expansion to refuse — unless the
156
177
  * command may rebind `HOME` ({@link textBindsHome}), which makes the declared home a guess. */
157
178
  readonly homeDir?: string;
179
+ /** An arithmetic expansion that names nothing ({@link literalArithmeticSpelling}) is the number it prints, not an
180
+ * expansion to refuse — in the expansion pass and in the quote-blind class (its parentheses and operators). */
181
+ readonly literalArithmetic?: boolean;
158
182
  }
159
183
  /**
160
184
  * THE classify faces' whole-string gate, as a PREDICATE over the one lexer's result: the residual space those
@@ -216,6 +240,7 @@ export declare function splitShellCompoundSegments(source: string, options?: {
216
240
  trailingTerminator?: "strip" | "keep";
217
241
  redirection?: "reject" | "tolerate" | "data-free";
218
242
  homeDir?: string;
243
+ literalArithmetic?: boolean;
219
244
  }): ShellCompoundSegments | {
220
245
  reject: string;
221
246
  };
@@ -495,6 +520,16 @@ export declare function classifyCompoundReadonlyDetailed(command: string, allow:
495
520
  boundary?: {
496
521
  readonly homeDir?: string;
497
522
  }): CompoundReadonlyVerdict;
523
+ /** {@link classifyCompoundReadonlyDetailed}'s verdict with the one fact its sentence does not carry: `unlistedProgram` is set exactly
524
+ * when the verdict's reason IS the list refusal ({@link unlistedReaderSentence}) of that program, so a reader that words a refusal by
525
+ * its cause asks for the cause instead of reading it back out of the sentence. Not part of the package surface. */
526
+ export interface CompoundReadonlyFacts extends CompoundReadonlyVerdict {
527
+ readonly unlistedProgram?: string;
528
+ }
529
+ /** The compound classifier itself ({@link classifyCompoundReadonlyDetailed} is its package-surface face). */
530
+ export declare function classifyCompoundReadonlyFacts(command: string, allow: ReadonlySet<string>, boundary?: {
531
+ readonly homeDir?: string;
532
+ }): CompoundReadonlyFacts;
498
533
  /**
499
534
  * Compound read-only classification, reason-only face. Returns the demotion reason, or
500
535
  * undefined when the command classifies read-only. ⚠️ `undefined` is NOT "safe to auto-execute":
@@ -1,5 +1,5 @@
1
1
  import { anchorSpelling, isAbsoluteForFamily, isBlockedDevicePath, isShellRootedSpellingUnmapped, nativeUncSpellingOf, normalizeAbsPathLexically, win32NamespaceScreen, pathFamilyOf } from "./safety.js";
2
- import { PARSE_FAILURE_SENTENCE, UNRESOLVED_SENTENCE, argvOf, lexShell, literalTildeSpelling, } from "../../shell/lex.js";
2
+ import { PARSE_FAILURE_SENTENCE, UNRESOLVED_SENTENCE, argvOf, expansionHidesRun, lexShell, literalTildeSpelling, } from "../../shell/lex.js";
3
3
  import { shellWordsOf } from "../../shell/shell-words.js";
4
4
  import { textBindsHome } from "./shell-read-bindings.js";
5
5
  import { GENERATOR_DEVICES, newLineDescriptors, bindDescriptors, isNamedDescriptorWord, standardDeviceUnrebound, descriptorsBoundBy } from "./shell-read-device.js";
@@ -16,7 +16,7 @@ export function bashClassifyDefaultAllow() {
16
16
  return [...BASH_READONLY_DEFAULT_ALLOW, ...BASH_CLASSIFY_EXTRA_ALLOW];
17
17
  }
18
18
  const SHELL_OPERATORS = /[;&|<>$()`\n\r\\]/;
19
- function hasBareShellOperator(s, quotedOperatorsAreText) {
19
+ function hasBareShellOperator(s, quotedOperatorsAreText, literalArithmeticIsText = false) {
20
20
  if (!quotedOperatorsAreText)
21
21
  return SHELL_OPERATORS.test(s);
22
22
  const lexed = lexShell(s);
@@ -27,18 +27,44 @@ function hasBareShellOperator(s, quotedOperatorsAreText) {
27
27
  for (const t of lexed.segments[0].tokens) {
28
28
  if (t.kind !== "word")
29
29
  return true;
30
- if (expandsBeyondText(t) || t.assignment?.form === "compound")
30
+ if (expandsBeyondText(t, literalArithmeticIsText ? s : undefined) || t.assignment?.form === "compound")
31
31
  return true;
32
32
  if (t.pieces.some((p) => p.quotedBy === "\\" || (p.quotedBy === undefined && p.literal !== undefined && /[\r\\]/.test(p.literal))))
33
33
  return true;
34
34
  }
35
35
  return false;
36
36
  }
37
- function expandsBeyondText(w) {
37
+ const LITERAL_ARITHMETIC_SPELLING = /^[\t\x20-\x5b\x5d-\x7e]*$/;
38
+ function literalArithmeticSpelling(p, source) {
39
+ if (p.expansion?.kind !== "arithmetic" || expansionHidesRun(p.expansion))
40
+ return undefined;
41
+ const text = source.slice(p.span[0], p.span[1]);
42
+ return LITERAL_ARITHMETIC_SPELLING.test(text) ? text : undefined;
43
+ }
44
+ function literalArithmeticOf(w, source) {
45
+ const found = new Map();
46
+ for (const p of w.pieces) {
47
+ const text = literalArithmeticSpelling(p, source);
48
+ if (text === undefined)
49
+ return new Map();
50
+ found.set(p, text);
51
+ }
52
+ return found;
53
+ }
54
+ function withoutLiteralArithmetic(w, source) {
55
+ let raw = w.raw;
56
+ for (const text of literalArithmeticOf(w, source).values())
57
+ raw = raw.replace(text, "");
58
+ return raw;
59
+ }
60
+ function expandsBeyondText(w, literalArithmeticIn) {
38
61
  if (w.quotedSpans.some((q) => q.by === '$"'))
39
62
  return true;
63
+ const numbers = literalArithmeticIn !== undefined ? literalArithmeticOf(w, literalArithmeticIn) : undefined;
40
64
  for (const p of w.pieces) {
41
65
  const k = p.expansion?.kind;
66
+ if (k === "arithmetic" && numbers?.has(p) === true)
67
+ continue;
42
68
  if (k === "parameter" || k === "command" || k === "process" || k === "arithmetic")
43
69
  return true;
44
70
  if (p.expansion?.inner !== undefined)
@@ -54,7 +80,7 @@ export function parseLeadingCommandName(command, options) {
54
80
  const trimmed = command.trim();
55
81
  if (!trimmed)
56
82
  return { reject: "empty command" };
57
- if (hasBareShellOperator(trimmed, options?.quotedOperatorsAreText === true)) {
83
+ if (hasBareShellOperator(trimmed, options?.quotedOperatorsAreText === true, options?.literalArithmeticIsText === true)) {
58
84
  return {
59
85
  reject: "shell operators (pipes, redirects, ;, &&, command substitution, subshells, variable expansion) are not allowed — run a single simple command",
60
86
  };
@@ -71,8 +97,11 @@ export function parseLeadingCommandName(command, options) {
71
97
  return { reject: "the command name must be a bare token (no quotes, braces, globs, or ~)" };
72
98
  return { name: first };
73
99
  }
100
+ export function readOnlyRefusalSentence(cause) {
101
+ return cause.kind === "unlisted" ? `command "${cause.program}" is not in the read-only allowlist` : `option "${cause.option}" is not one of the read-only options of "${cause.program}"`;
102
+ }
74
103
  export function unlistedReaderSentence(program) {
75
- return `command "${program}" is not in the read-only allowlist`;
104
+ return readOnlyRefusalSentence({ kind: "unlisted", program });
76
105
  }
77
106
  const SHELL_SEGMENT_QUOTE_BLIND_REJECT = /[<>()`\n\r\\]/;
78
107
  const SHELL_EXPANSION_CHARS = /[$]/;
@@ -113,7 +142,7 @@ export function strictResidualRefusal(lexed, source, opts = {}) {
113
142
  return reason;
114
143
  for (const t of s.tokens) {
115
144
  if (t.kind === "word") {
116
- if (inClass(t.raw))
145
+ if (inClass(opts.literalArithmetic === true ? withoutLiteralArithmetic(t, source) : t.raw))
117
146
  return reason;
118
147
  words.push(t);
119
148
  continue;
@@ -133,7 +162,7 @@ export function strictResidualRefusal(lexed, source, opts = {}) {
133
162
  }
134
163
  const home = opts.homeDir !== undefined && !textBindsHome(source) ? opts.homeDir : undefined;
135
164
  for (const w of words) {
136
- if (expandsBeyondText(w) && !(home !== undefined && homeSpelledForClassify(w, home) !== undefined))
165
+ if (expandsBeyondText(w, opts.literalArithmetic === true ? source : undefined) && !(home !== undefined && homeSpelledForClassify(w, home) !== undefined))
137
166
  return reason;
138
167
  }
139
168
  for (const s of lexed.segments) {
@@ -156,6 +185,7 @@ export function splitShellCompoundSegments(source, options) {
156
185
  tolerateRedirection: options?.redirection === "tolerate",
157
186
  dataFreeRedirections: options?.redirection === "data-free",
158
187
  ...(options?.homeDir !== undefined ? { homeDir: options.homeDir } : {}),
188
+ ...(options?.literalArithmetic === true ? { literalArithmetic: true } : {}),
159
189
  });
160
190
  if (refused !== undefined)
161
191
  return { reject: refused };
@@ -732,15 +762,20 @@ function segmentCompoundForReadonly(command, homeDir) {
732
762
  if (!trimmed)
733
763
  return { reject: "empty command" };
734
764
  const terminatorStripped = trimmed.endsWith(";") ? trimmed.slice(0, -1) : trimmed;
735
- return splitShellCompoundSegments(terminatorStripped, { trailingTerminator: "keep", redirection: "data-free", ...(homeDir !== undefined ? { homeDir } : {}) });
765
+ return splitShellCompoundSegments(terminatorStripped, { trailingTerminator: "keep", redirection: "data-free", literalArithmetic: true, ...(homeDir !== undefined ? { homeDir } : {}) });
736
766
  }
737
767
  export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
768
+ const { reason } = classifyCompoundReadonlyFacts(command, allow, boundary);
769
+ return reason === undefined ? {} : { reason };
770
+ }
771
+ export function classifyCompoundReadonlyFacts(command, allow, boundary) {
738
772
  const split = segmentCompoundForReadonly(command, boundary?.homeDir);
739
773
  if ("reject" in split)
740
774
  return { reason: split.reject };
741
775
  const { segments, pipeFed } = split;
742
776
  const homeRebound = boundary?.homeDir !== undefined && textBindsHome(command);
743
777
  let nameRefusal;
778
+ let unlistedProgram;
744
779
  const unlistedSegments = new Set();
745
780
  const reheaded = new Map();
746
781
  for (let si = 0; si < segments.length; si++) {
@@ -765,7 +800,7 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
765
800
  if (familyRefusal !== undefined)
766
801
  nameRefusal ??= familyRefusal;
767
802
  }
768
- const parsed = parseLeadingCommandName(toks.raw.slice(from).join(" "), { quotedOperatorsAreText: true, pathPrefixedNameIsText: true });
803
+ const parsed = parseLeadingCommandName(toks.raw.slice(from).join(" "), { quotedOperatorsAreText: true, pathPrefixedNameIsText: true, literalArithmeticIsText: true });
769
804
  if ("reject" in parsed)
770
805
  return { reason: parsed.reject };
771
806
  const pathPrefixed = parsed.name.includes("/");
@@ -781,7 +816,10 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
781
816
  nameRefusal ??= unlistedReaderSentence(folded[0]);
782
817
  continue;
783
818
  }
784
- nameRefusal ??= unlistedReaderSentence(parsed.name);
819
+ if (nameRefusal === undefined) {
820
+ nameRefusal = unlistedReaderSentence(parsed.name);
821
+ unlistedProgram = parsed.name;
822
+ }
785
823
  if (runsShellText(name))
786
824
  return { reason: unjudgedProgramTextRefusal(parsed.name, "runs its argument as shell text") };
787
825
  if (pos.launchers.length > 0) {
@@ -887,7 +925,7 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
887
925
  const cdSegments = foldedSegments.filter((st) => st.folded[0] === "cd");
888
926
  if (cdSegments.length > 1)
889
927
  shapeRefusal ??= `multiple directory changes in one command require approval for clarity ${NOT_AUTO_ALLOWED}`;
890
- return shapeRefusal !== undefined ? { reason: shapeRefusal } : {};
928
+ return shapeRefusal === undefined ? {} : { reason: shapeRefusal, ...(unlistedProgram !== undefined ? { unlistedProgram } : {}) };
891
929
  }
892
930
  export function classifyCompoundReadonly(command, allow, boundary) {
893
931
  return classifyCompoundReadonlyDetailed(command, allow, boundary).reason;
@@ -0,0 +1 @@
1
+ export declare function envErrorDetail(message: string | undefined): string;
@@ -0,0 +1,7 @@
1
+ import { hasVisibleContent } from "../../core/principal-name.js";
2
+ import { extensionWords } from "../../core/untrusted-egress.js";
3
+ const ENV_ERROR_DETAIL_MAX = 512;
4
+ export function envErrorDetail(message) {
5
+ const folded = extensionWords(typeof message === "string" ? message : "", ENV_ERROR_DETAIL_MAX);
6
+ return hasVisibleContent(folded) ? folded : "the execution environment reported no reason";
7
+ }
@@ -5,6 +5,7 @@ import { type CwdRef } from "./fs-shared.js";
5
5
  import type { ReversibilityVerdict } from "../../core/types.js";
6
6
  import type { ShellReadAdmission } from "./shell-read-check.js";
7
7
  import type { ReadFloorSeat } from "./read-floor.js";
8
+ import { type CommandSandboxSeat } from "../../core/command-sandbox.js";
8
9
  /**
9
10
  * The full shell face's SHAPE classifier for the `bash` tool, exposed as a `ToolSpec.reversibilityProbe`
10
11
  * (the "maybe" tier's probe, installed on every full shell). A command is reversible ONLY if every connected
@@ -93,13 +94,14 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
93
94
  * it). A deployment that wants the CC-parity behavior sets this explicitly; sema's own default
94
95
  * Runner wiring currently does NOT set it, so this feature ships INERT until a caller opts in.
95
96
  *
96
- * IT ARMS TWO TRIGGERS, not one — the name is older than the second. Both are the engine deciding
97
- * to adopt a running command instead of ending it, both take the same adoption chain, and both are
97
+ * IT ARMS THREE TRIGGERS, not one — the name is older than the other two. All are the engine deciding
98
+ * to adopt a running command instead of ending it, all take the same adoption chain, and all are
98
99
  * gated on the same eligibility read of this command's text (`canAutoBackground`): (1) the command's
99
- * OWN timeout fires, and (2) a person's input is waiting for the turn boundary while this command
100
- * still runs (see {@link queuedHumanInput}). A deployment that opted in for one has opted in for
101
- * both; there is deliberately no second knob, because "may this command be moved to the background
102
- * by the engine" is one question and answering it twice is how the two triggers would drift apart.
100
+ * OWN timeout fires, (2) a person's input is waiting for the turn boundary while this command
101
+ * still runs (see {@link queuedHumanInput}), and (3) a cut whose source moves an armed command aside
102
+ * ends the turn (see {@link turnCutMovesCommandAside}). A deployment that opted in for one has opted in
103
+ * for all; there is deliberately no second knob, because "may this command be moved to the background
104
+ * by the engine" is one question and answering it twice is how the triggers would drift apart.
103
105
  */
104
106
  autoBackgroundOnTimeout?: boolean;
105
107
  /**
@@ -121,6 +123,17 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
121
123
  * message (the pre-seat behavior), which is also what a standalone toolkit build gets.
122
124
  */
123
125
  queuedHumanInput?: () => boolean;
126
+ /**
127
+ * Does the cut now aborting `signal` (the call's own turn signal) move an {@link autoBackgroundOnTimeout}-armed running
128
+ * command into the background instead of ending it? Asked once, inside that abort's own dispatch, by the answer the
129
+ * harness keeps per cut source (an extension's turn end moves it; a person's halt and a steer-now end it). `true` fires
130
+ * the SAME detach verb ctrl+b fires, ahead of the environment's own abort, so a command the environment adopts on the
131
+ * spot is never killed; one it refuses to adopt is ended exactly as before. Reference field `backgroundedByTurnAbort`.
132
+ *
133
+ * Wired on a top-level leg only (the reference moves a command aside for a turn abort on its main thread alone): absent
134
+ * ⇒ every cut ends the running command, which is also what a delegated leg and a standalone toolkit build get.
135
+ */
136
+ turnCutMovesCommandAside?: (signal: AbortSignal) => boolean;
124
137
  /**
125
138
  * Mirrors {@link import("../../core/types.js").TaskSpec.oneShot}: this run has no later
126
139
  * turn for an async background notification to land in (a headless `-p` process exits once the
@@ -149,6 +162,9 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
149
162
  /** The byte floor's seat (read-floor.ts): every command this leg starts, foreground or background, carries the
150
163
  * read-deny table its call judges with to the environment. Absent ⇒ no table, the starts carry nothing. */
151
164
  readFloor?: ReadFloorSeat;
165
+ /** The run's command sandbox seat (`command-sandbox.ts`): every command this leg starts, foreground or background, hands
166
+ * its call's sandbox instruction to the environment, or is refused. Absent ⇒ the run requires no sandbox. */
167
+ commandSandbox?: CommandSandboxSeat;
152
168
  /** The run's image processor seat (`RunnerDeps.imageProcessor`), for an image-data-URI stdout. */
153
169
  imageProcessor?: ImageDownsampler | false;
154
170
  /** Override of the `timeout` parameter's DEFAULT budget, in ms — see
@@ -210,6 +226,8 @@ export declare function createBashReadonlyTool(env: ExecutionEnv, rootCanonical:
210
226
  shellReadAdmission?: ShellReadAdmission;
211
227
  /** The byte floor's seat — the SAME one the full shell leg takes (read-floor.ts). */
212
228
  readFloor?: ReadFloorSeat;
229
+ /** The command sandbox seat — the SAME one the full shell leg takes (command-sandbox.ts). */
230
+ commandSandbox?: CommandSandboxSeat;
213
231
  /** The image processor seat — the SAME one the full shell leg takes. */
214
232
  imageProcessor?: ImageDownsampler | false;
215
233
  /** The run's tool-progress sink — the SAME seat the full shell leg takes, for the same reason its