@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,23 +1,18 @@
1
+ import { unfitFeedbackOf, writtenFeedback } from "../approval-words.js";
1
2
  import { CheckpointError } from "../checkpoint-store.js";
2
- import { sanitizeUntrustedText, sentinelTagRefusal } from "../untrusted-text.js";
3
- export function writtenFeedback(feedback) {
4
- const trimmed = feedback?.trim();
5
- return trimmed === undefined || trimmed === "" ? undefined : trimmed;
6
- }
3
+ import { asThrownError } from "../thrown-value.js";
4
+ import { sentinelTagRefusal } from "../untrusted-text.js";
7
5
  export function refuseUnfitFeedback(twin) {
8
- const words = writtenFeedback(twin.feedback);
9
- if (words === undefined)
6
+ const unfit = unfitFeedbackOf(writtenFeedback(twin.feedback), { allowed: twin.decision === "allow", byPerson: twin.hostDecision.decidedBy === "person" });
7
+ if (unfit === undefined)
10
8
  return;
11
- if (twin.decision !== "allow") {
9
+ if (unfit === "on_a_deny") {
12
10
  throw feedbackRefusal("resume carried `feedback` on a `deny` — feedback is the approving person's words on an `allow` (a denial's words are `reason`); refusing rather than dropping it silently, the checkpoint stays pending");
13
11
  }
14
- const byPerson = twin.hostDecision.decidedBy === "person";
15
- if (!byPerson) {
12
+ if (unfit === "by_a_machine") {
16
13
  throw feedbackRefusal(`resume carried \`feedback\` on a decide made by "${twin.hostDecision.decidedBy}" — feedback is delivered to the model as the user's own words, which only a person's decide can be; refusing rather than attributing a machine's text to the user, the checkpoint stays pending`);
17
14
  }
18
- if (sanitizeUntrustedText(words) !== words) {
19
- throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
20
- }
15
+ throw feedbackRefusal(sentinelTagRefusal("resume allow feedback"));
21
16
  }
22
17
  function feedbackRefusal(message) {
23
18
  return new CheckpointError("checkpoint.invalid_outcome", message, { field: "feedback" });
@@ -31,6 +26,16 @@ export function withApprovalWords(continuation, engineSegments, words) {
31
26
  engineSegments.push({ start: glueStart, end: withGlue.length });
32
27
  return withGlue + words;
33
28
  }
29
+ export function approvalWordsSeat(harness, report) {
30
+ return async (words) => {
31
+ try {
32
+ await harness.steer(words);
33
+ }
34
+ catch (err) {
35
+ report(new Error(`the approving person's words could not be queued for the model: ${asThrownError(err).message}`));
36
+ }
37
+ };
38
+ }
34
39
  const APPROVAL_WORDS_FRAMES = new WeakSet();
35
40
  export function owedApprovalWords(words, inputId) {
36
41
  if (words === undefined)
@@ -0,0 +1,17 @@
1
+ import type { ApproverDefect } from "../tool-policy.js";
2
+ /**
3
+ * The announcer `resolveAskFor` is handed at every station that puts an ask to an approver (`approval.approver_defect`): the approver
4
+ * threw, or answered outside its contract, and the call it was asked about is denied fail-closed. The denial is the model's and the
5
+ * run's — it reads as any refusal; this is the deployment's, who wired a seat that does not keep its contract. Once per denied ask. The
6
+ * detail names how it failed and what kind of seat it was, and never the thrown text or the answer (the denial the model reads names
7
+ * them).
8
+ */
9
+ export declare function approverDefectAnnouncer(args: {
10
+ toolName: string;
11
+ toolCallId: string;
12
+ sessionId: string;
13
+ runId: string;
14
+ /** The leg's own task id (`Prepared.taskId`), always present. */
15
+ taskId: string;
16
+ onNotice: import("../types.js").RunnerDeps["onNotice"];
17
+ }): (defect: ApproverDefect) => void;
@@ -0,0 +1,22 @@
1
+ import { legNoticeTaskId } from "../mods/stations.js";
2
+ import { deliverEngineNotice } from "../types.js";
3
+ export function approverDefectAnnouncer(args) {
4
+ return (defect) => {
5
+ const how = defect.cause === "threw" ? "threw" : 'answered outside its contract (an answer that is not true, false, "unavailable" or the {allow} object, or an object the seam refuses)';
6
+ const which = defect.seat === "policy" ? "approval policy (asPolicyApprover)" : "approver";
7
+ deliverEngineNotice(args.onNotice, {
8
+ code: "approval.approver_defect",
9
+ message: `the deployment's ${which} ${how} on the ask for "${args.toolName}" — the call was denied fail-closed and the tool did not run. ` +
10
+ "Every ask this seat fails to answer in contract is refused the same way; the model reads the denial as an ordinary one.",
11
+ detail: {
12
+ toolName: args.toolName,
13
+ toolCallId: args.toolCallId,
14
+ cause: defect.cause,
15
+ seat: defect.seat,
16
+ sessionId: args.sessionId,
17
+ runId: args.runId,
18
+ ...legNoticeTaskId(args),
19
+ },
20
+ });
21
+ };
22
+ }
@@ -16,7 +16,13 @@ export interface Stats {
16
16
  cacheWriteTokensLong: number;
17
17
  outputTokens: number;
18
18
  cacheHitRate?: number;
19
- /** Cache-INCLUSIVE prompt total (`promptTokens + cachedTokens + cacheWriteTokens*`) — the
19
+ /** The cache account's marks, exclusions and per-lane operands (`./cache-hit-account.ts`; the public faces are documented on
20
+ * `TaskResult.stats`). `cacheLanes` is run-loop internal, stripped at assembly. */
21
+ cacheReadUnreported?: true;
22
+ cacheWriteUnreported?: true;
23
+ cacheHitRateExcludes?: import("./cache-hit-account.js").CacheHitExclusion[];
24
+ cacheLanes?: import("./cache-hit-account.js").CacheLanes;
25
+ /** Cache-INCLUSIVE prompt total (`promptTokens + cachedTokens + cacheWriteTokens`; the one-hour writes are a part of the last) — the
20
26
  * billing/window/hit-rate denominator. Required (not derived) so a new accumulation site that forgets
21
27
  * it fails the type check instead of silently reporting a total short by its own leg. */
22
28
  totalInputTokens: number;
@@ -38,7 +44,8 @@ export interface Stats {
38
44
  * `gate.kind`, accumulated across resume legs. Set by the run loop from the per-task human-review
39
45
  * accumulator (synchronous `resolveAsk` timing + durable resume latency). **NOT an LLM cost** — never
40
46
  * folded into `costMicroUsd`/`costBreakdown`/the budget gate (same budget-excluded treatment as `memory`).
41
- * Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread; absent ⇒ no gate. */
47
+ * Flows straight through to `TaskResult.stats.humanReview` via the public-stats spread (`TaskResult.stats.humanReview`
48
+ * says when it is present). */
42
49
  humanReview?: {
43
50
  count: number;
44
51
  totalWaitMs: number;
@@ -136,14 +143,21 @@ export interface ResultFlags {
136
143
  * one — the model did not finish; the person stopped it and the run awaits their direction). */
137
144
  haltedOnUserRejection?: boolean;
138
145
  /** the harness's STATEMENT of what the run's halt did (see `HaltConsumption`):
139
- * the loop's report that the halt's cut settled the final turn, and/or the boundary consult that
140
- * stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser`
141
- * (`haltConsumed`, halt-attribution.ts) and to slot 9.7 — the assembly never infers causation from the
146
+ * the loop's report that the halt's (or an extension's) cut settled the final turn, and/or the boundary consult that
147
+ * stopped the loop for the halt's request. This is the ONLY input to `TaskResult.haltedByUser` / `turnAbortedBy`
148
+ * (halt-attribution.ts) and to slot 9.7 — the assembly never infers causation from the
142
149
  * final's shape or from the verb's acceptance. A halt that was accepted but consumed nothing (the run
143
150
  * ended for its own reason first) leaves this empty: the original terminal stands and the seat is
144
151
  * NOT signed (the settle lane mints `task.halt_unconsumed` for it). */
145
152
  haltConsumption?: HaltConsumption;
146
153
  answerEntryIds?: readonly string[];
154
+ intake?: TaskResult["intake"];
155
+ /** What the leg's display showed of those messages, when a `classic.MessageDisplay` handler changed it (the display's own
156
+ * reading, `MessageDisplay.displayedOf`): `result` is then that text, through the same projection, and `resultDisplayedBy` names who. */
157
+ displayed?: {
158
+ readonly text: string;
159
+ readonly by: readonly string[];
160
+ };
147
161
  /** Call ids of answered-but-never-collected questions, echoed on
148
162
  * `TaskResult.strandedHumanAnswers`. Pure pass-through; empty/absent ⇒ the field is omitted. The
149
163
  * optional `onError` alert is NOT the disclosure — this mandatory result face is. */
@@ -202,9 +216,9 @@ export interface ResultFlags {
202
216
  blockedReason?: string;
203
217
  blockedDetail?: TerminalBlockedDetail;
204
218
  conflict?: boolean;
205
- /** env-tail migration F5: the request-build guard threw the irreducible-core terminal this run —
206
- * the loop folded it into a text-only failure message, so the typed code rides this flag. */
207
- gitCoreOverBudget?: boolean;
219
+ /** The request-build guard threw the irreducible-core terminal this run (the trim's core or the git frame's) — the loop
220
+ * folded it into a text-only failure message, so the typed code rides this flag. */
221
+ coreOverBudget?: boolean;
208
222
  outputInvalid?: boolean;
209
223
  /** The word the loop's last exit named (`Prepared.loopTerminalRef`), read through `loopExitFailureOf`; absent = the loop never exited. */
210
224
  loopTerminal?: LoopTerminalReason;
@@ -270,8 +284,8 @@ export interface ResultFlags {
270
284
  * landed on work or on the tail. Evaluated ONCE per leg (the terminal-adoption lane, where both facts
271
285
  * are in hand) and handed on as a value — {@link ResultFlags.answerSettled} — so the arbitration, the
272
286
  * marker gate, the hook-seat grace, the teardown attribution and the notice read the same verdict.
273
- * (A limit that is NOT a stop — a budget ceiling crossed by the last turn's own spend — is arbitrated
274
- * above slot 9 and is unaffected.)
287
+ * (A budget ceiling crossed by the last turn's own spend reads the same verdict at its own slot, above
288
+ * slot 9: an answered turn owes no further request, so the ceiling is a fact on `stats`, not a failure.)
275
289
  */
276
290
  export declare function answerSettled(final: AssistantMessage | undefined, continuationCut?: boolean): boolean;
277
291
  export declare function terminalCauseOf(final: AssistantMessage | undefined, stats: Pick<Stats, "humanReview">, flags: ResultFlags): {
@@ -286,7 +300,7 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
286
300
  * 2. degenerate → `"output.degenerate"` + `salvagedOutput` (wins over budget/timeout)
287
301
  * 3. `budgetHit` → `"limits.max_tokens_exceeded"` | `"limits.max_cost_exceeded"` (by `budgetAxis`;
288
302
  * the pre-call estimate rejection and the after-spend crossing share the code — the distinction
289
- * lives in `errorMessage`, not in a second code)
303
+ * lives in `errorMessage`, not in a second code), EXCEPT when `answerSettled` (the answering turn's own spend crossed it → 12)
290
304
  * 3.5 `suspendLoop` → `"suspend.loop"` (the re-suspend cap; deterministic root
291
305
  * cause, above `threw` because it owns the abort)
292
306
  * 4. `threw` + walltime → `"limits.max_walltime_exceeded"`
@@ -301,15 +315,16 @@ export declare function terminalCauseOf(final: AssistantMessage | undefined, sta
301
315
  * 9. `abortedLive` | stopReason aborted → `"limits.max_walltime_exceeded"` | `"limits.max_turns_exceeded"` | undefined
302
316
  * (audit A-1: hoisted ABOVE no-final — the loop exits cleanly on abort, so `final` may be a
303
317
  * normal message or absent; a plain user interrupt carries NO errorCode — switch on `status`),
304
- * EXCEPT when the aborted `final` is the bare halt's OWN cut artifact (`haltOwnsAbortedFinal`: the
305
- * loop reported the halt's cut settled the final turn — never shape inference),
318
+ * EXCEPT when the aborted `final` is an ending cut's OWN artifact (`cutOwnsAbortedFinal`: the
319
+ * loop reported the halt's, or an extension's `$.turn.abort`, cut settled the final turn — never shape inference),
306
320
  * and EXCEPT when the answer had already settled (`answerSettled`: a clean `"stop"` final, not
307
321
  * partial) — a stop landing on the run's tail cuts no work, so the run falls through to 12
308
322
  * (`completed`, the answer as `result`, no `limits.*` code for the axis; three axes, one law)
309
323
  * 9.7 halt CONSUMED (`haltConsumed(flags.haltConsumption)`) + (no `final` | the halt's own aborted
310
324
  * `final`) → status `"completed"` (a bare user halt — the verb working, not a defect; below the
311
325
  * aborts on purpose, a real abort/limit that also fired owns the terminal and the halt rides as
312
- * the pass-through seat; an accepted-but-unconsumed halt never reaches this slot)
326
+ * the pass-through seat; an accepted-but-unconsumed halt never reaches this slot); an extension's
327
+ * `$.turn.abort` that ended the final turn reaches it the same way (`endingCutConsumed`, `turnAbortedBy`)
313
328
  * 10. no `final` → status `"failed"`
314
329
  * 11. stopReason error → brain `[code]` prefix (or `"conflict"` from the storage-layer flag)
315
330
  * 11.5 the loop exited on a spent recovery budget (`loopTerminal`, read through `loopExitFailureOf`) →
@@ -1,11 +1,10 @@
1
1
  import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
2
2
  import { extractErrorCode, isProviderEchoShape, refusedTheRequest, stripErrorCodePrefix } from "../../brain/errors.js";
3
- import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
3
+ import { completedTerminalOf, loopExitFailureOf, modelOutputInvalidOfMessage, providerSentenceOf, providerVerdictOf, refusedPartOf, requestRouteOfMessage, thrownFailureOf } from "./terminal-account.js";
4
4
  import { terminalProjection } from "./terminal-projection.js";
5
- import { haltConsumed } from "./halt-attribution.js";
5
+ import { endingCutConsumed, haltConsumed, turnAbortedByOf } from "./halt-attribution.js";
6
6
  import { providerReportedModel } from "../message-utils.js";
7
- import { isErrorLike, readMember } from "../thrown-value.js";
8
- import { describeRejectedValue } from "../tool-search-setting.js";
7
+ import { readMember, thrownText } from "../thrown-value.js";
9
8
  const SALVAGE_ELIGIBLE_TERMINALS = new Set([
10
9
  "output.degenerate",
11
10
  "limits.max_tokens_exceeded",
@@ -15,14 +14,6 @@ const SALVAGE_ELIGIBLE_TERMINALS = new Set([
15
14
  "env.lifetime_expired",
16
15
  "usage.window_exhausted",
17
16
  ]);
18
- function thrownMessage(threw) {
19
- if (isErrorLike(threw)) {
20
- const m = readMember(threw, "message");
21
- if (typeof m === "string")
22
- return m;
23
- }
24
- return describeRejectedValue(threw);
25
- }
26
17
  function stripThinkTags(text) {
27
18
  let t = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
28
19
  const lower = t.toLowerCase();
@@ -45,7 +36,7 @@ export function answerSettled(final, continuationCut = false) {
45
36
  export function terminalCauseOf(final, stats, flags) {
46
37
  let terminal;
47
38
  let apiFailure;
48
- const haltOwnsAbortedFinal = flags.haltConsumption?.turnCut === "halt" &&
39
+ const cutOwnsAbortedFinal = endingCutConsumed(flags.haltConsumption) &&
49
40
  final?.stopReason === "aborted" &&
50
41
  !flags.abortedLive &&
51
42
  flags.abortedForTimeout !== true &&
@@ -59,7 +50,7 @@ export function terminalCauseOf(final, stats, flags) {
59
50
  else if (isDegenerate) {
60
51
  terminal = { kind: "failed", code: "output.degenerate", ...(final?.errorMessage !== undefined ? { message: final.errorMessage } : {}) };
61
52
  }
62
- else if (flags.budgetHit) {
53
+ else if (flags.budgetHit && flags.answerSettled !== true) {
63
54
  const axisName = flags.budgetAxis === "tokens" ? "limits.maxTokens" : "limits.maxCostUsd";
64
55
  terminal = {
65
56
  kind: "failed",
@@ -83,7 +74,7 @@ export function terminalCauseOf(final, stats, flags) {
83
74
  terminal = { kind: "failed", code: "suspend.loop", message };
84
75
  }
85
76
  else if (flags.threw) {
86
- const thrown = thrownFailureOf(flags.threw, thrownMessage(flags.threw));
77
+ const thrown = thrownFailureOf(flags.threw, thrownText(flags.threw));
87
78
  const axisCode = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : flags.conflict ? "conflict" : undefined;
88
79
  const code = axisCode ?? thrown.code;
89
80
  const detail = axisCode === undefined ? thrown.detail : undefined;
@@ -95,11 +86,11 @@ export function terminalCauseOf(final, stats, flags) {
95
86
  else if (flags.paused) {
96
87
  terminal = flags.paused;
97
88
  }
98
- else if ((flags.abortedLive || final?.stopReason === "aborted") && !haltOwnsAbortedFinal && flags.answerSettled !== true) {
89
+ else if ((flags.abortedLive || final?.stopReason === "aborted") && !cutOwnsAbortedFinal && flags.answerSettled !== true) {
99
90
  const code = flags.abortedForTimeout ? "limits.max_walltime_exceeded" : flags.abortedForTurns ? "limits.max_turns_exceeded" : undefined;
100
91
  terminal = { kind: "failed", ...(code !== undefined ? { code } : {}), message: final?.errorMessage ?? (flags.abortedForTurns ? "max turns exceeded" : "run aborted") };
101
92
  }
102
- else if ((haltConsumed(flags.haltConsumption) && (!final || haltOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
93
+ else if (((haltConsumed(flags.haltConsumption) || endingCutConsumed(flags.haltConsumption)) && (!final || cutOwnsAbortedFinal)) || (flags.haltedOnUserRejection === true && !final)) {
103
94
  terminal = { kind: "completed" };
104
95
  }
105
96
  else if (!final) {
@@ -124,7 +115,7 @@ export function terminalCauseOf(final, stats, flags) {
124
115
  code = lifted;
125
116
  message = stripErrorCodePrefix(message);
126
117
  }
127
- else if (flags.gitCoreOverBudget) {
118
+ else if (flags.coreOverBudget) {
128
119
  code = "irreducible_core_over_budget";
129
120
  messageNamed = false;
130
121
  }
@@ -139,7 +130,7 @@ export function terminalCauseOf(final, stats, flags) {
139
130
  let detail;
140
131
  if (messageNamed && apiError && typeof apiStatus === "number" && refusedTheRequest(apiStatus)) {
141
132
  const route = requestRouteOfMessage(final);
142
- detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
133
+ detail = { kind: "provider_rejected", status: apiStatus, ...(typeof apiCode === "string" && isProviderEchoShape(apiCode) ? { code: apiCode } : {}), ...providerVerdictOf(final), ...providerSentenceOf(final), ...(route !== undefined ? { route } : {}), ...refusedPartOf(errorKind, readMember(final, "refusedTool")) };
143
134
  }
144
135
  else if (messageNamed && outputInvalid !== undefined) {
145
136
  detail = { kind: "model_output_invalid", ...outputInvalid };
@@ -168,19 +159,19 @@ export function assembleResult(leg, final, stats, flags) {
168
159
  ...(stats.sideCallMicroUsd !== undefined ? { sideCallMicroUsd: stats.sideCallMicroUsd } : {}),
169
160
  };
170
161
  }
171
- const result = text;
162
+ const result = flags.displayed !== undefined ? stripThinkTags(flags.displayed.text) : text;
172
163
  let salvagedOutput;
173
164
  const { terminal, apiFailure } = terminalCauseOf(final, stats, flags);
174
165
  const { errorCode } = terminalProjection(terminal);
175
166
  if (errorCode !== undefined && SALVAGE_ELIGIBLE_TERMINALS.has(errorCode)) {
176
- salvagedOutput = text.trim() || undefined;
167
+ salvagedOutput = result.trim() || undefined;
177
168
  }
178
169
  const retryAfterMs = errorCode === "usage.window_exhausted" || errorCode === "memory.admission_required" ? flags.retryAfterMs : undefined;
179
- const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, ...publicStats } = stats;
180
- void _internalCompaction;
181
- void _internalSideCall;
170
+ const { compactionMicroUsd: _internalCompaction, sideCallMicroUsd: _internalSideCall, cacheLanes: _internalCacheLanes, ...publicStats } = stats;
171
+ void [_internalCompaction, _internalSideCall, _internalCacheLanes];
182
172
  if (flags.unpricedSpend)
183
173
  delete publicStats.costMicroUsd;
184
174
  const stampHaltedByUser = haltConsumed(flags.haltConsumption);
185
- return { taskId, ...(flags.runId !== undefined ? { runId: flags.runId } : {}), sessionId, terminal, ...(flags.model !== undefined ? { model: flags.model } : {}), ...(responseModel !== undefined ? { responseModel } : {}), result: result.trim(), ...(flags.answerEntryIds !== undefined ? { resultEntryIds: [...flags.answerEntryIds] } : {}), salvagedOutput, ...(apiFailure !== undefined ? { apiFailure } : {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.editedFiles !== undefined && flags.editedFiles.length > 0 ? { editedFiles: flags.editedFiles } : {}), ...(flags.haltedOnUserRejection === true ? { haltedOnUserRejection: true } : {}), ...(stampHaltedByUser ? { haltedByUser: true } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: [...flags.remoteEnvFailures] } : {}), ...(flags.strandedHumanAnswers !== undefined && flags.strandedHumanAnswers.length > 0 ? { strandedHumanAnswers: flags.strandedHumanAnswers } : {}), ...(flags.effectiveReadFace !== undefined ? { effectiveReadFace: flags.effectiveReadFace } : {}), ...(flags.effectiveWriteFace !== undefined ? { effectiveWriteFace: flags.effectiveWriteFace } : {}), ...(flags.effectiveReadDenyPatterns !== undefined && flags.effectiveReadDenyPatterns.length > 0 ? { effectiveReadDenyPatterns: flags.effectiveReadDenyPatterns } : {}), ...(flags.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: flags.effectiveMemoryScopes } : {}), ...(flags.placementRoot !== undefined ? { placementRoot: flags.placementRoot } : {}), ...(flags.effectiveReasoning !== undefined ? { effectiveReasoning: flags.effectiveReasoning } : {}), ...(flags.compaction !== undefined ? { compaction: flags.compaction } : {}), stats: publicStats };
175
+ const turnAbortedBy = turnAbortedByOf(flags.haltConsumption);
176
+ return { taskId, ...(flags.runId !== undefined ? { runId: flags.runId } : {}), sessionId, terminal, ...(flags.model !== undefined ? { model: flags.model } : {}), ...(responseModel !== undefined ? { responseModel } : {}), result: result.trim(), ...(flags.answerEntryIds !== undefined ? { resultEntryIds: [...flags.answerEntryIds] } : {}), ...(flags.intake !== undefined ? { intake: flags.intake } : {}), ...(flags.displayed !== undefined ? { resultDisplayedBy: [...flags.displayed.by] } : {}), salvagedOutput, ...(apiFailure !== undefined ? { apiFailure } : {}), ...(retryAfterMs !== undefined ? { retryAfterMs } : {}), ...(flags.rewindNotes !== undefined && flags.rewindNotes.length > 0 ? { rewindNotes: flags.rewindNotes } : {}), ...(flags.editedFiles !== undefined && flags.editedFiles.length > 0 ? { editedFiles: flags.editedFiles } : {}), ...(flags.haltedOnUserRejection === true ? { haltedOnUserRejection: true } : {}), ...(stampHaltedByUser ? { haltedByUser: true } : {}), ...(turnAbortedBy !== undefined ? { turnAbortedBy } : {}), ...(flags.remoteEnvFailures !== undefined && flags.remoteEnvFailures.length > 0 ? { remoteEnvFailures: [...flags.remoteEnvFailures] } : {}), ...(flags.strandedHumanAnswers !== undefined && flags.strandedHumanAnswers.length > 0 ? { strandedHumanAnswers: flags.strandedHumanAnswers } : {}), ...(flags.effectiveReadFace !== undefined ? { effectiveReadFace: flags.effectiveReadFace } : {}), ...(flags.effectiveWriteFace !== undefined ? { effectiveWriteFace: flags.effectiveWriteFace } : {}), ...(flags.effectiveReadDenyPatterns !== undefined && flags.effectiveReadDenyPatterns.length > 0 ? { effectiveReadDenyPatterns: flags.effectiveReadDenyPatterns } : {}), ...(flags.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: flags.effectiveMemoryScopes } : {}), ...(flags.placementRoot !== undefined ? { placementRoot: flags.placementRoot } : {}), ...(flags.effectiveReasoning !== undefined ? { effectiveReasoning: flags.effectiveReasoning } : {}), ...(flags.compaction !== undefined ? { compaction: flags.compaction } : {}), stats: publicStats };
186
177
  }
@@ -0,0 +1,77 @@
1
+ /**
2
+ * The run's cache-hit account: the ONE fold of a booked call's cache members onto the aggregate faces, and the ONE derivation of
3
+ * the leg's cache-hit rate from it. Both usage accounts (`main-call-account.ts`, `side-call-account.ts`) book every call through
4
+ * {@link bookCacheOperands}; nothing else reads a usage's cache members for the aggregates.
5
+ *
6
+ * Two layers, one reading each:
7
+ * - a single call's `Usage` says "not reported" by leaving `cacheRead` / `cacheWrite` ABSENT (a reported 0 is a measured 0);
8
+ * - an aggregate keeps its numbers (the counted sum, absent members adding nothing) and says what they are with marks:
9
+ * `cacheReadUnreported` / `cacheWriteUnreported` — some call did not report that member, so the sum is not a measurement of it;
10
+ * and, on a family whose input EXCLUDES the cached parts (the total is input + reads + writes), a missing cache member also
11
+ * leaves the total a lower bound, which is the existing `usageMissing` mark.
12
+ *
13
+ * The hit rate is judged per LANE (the main loop, each side-call lane): a lane is complete while every call on it stated what the
14
+ * ratio needs — a known usage (not `usageMissing`), the cache reads, and on an input-excludes-cached family the cache writes too
15
+ * (they are part of the denominator). An incomplete lane is left out of the rate whole, so one lane that does not report (a
16
+ * classifier on a gateway without the cache counts) does not erase another lane's rate, and a lane that reports only some of
17
+ * its calls (a gateway that omits a zero) is never read off its reporting calls alone. The one identity:
18
+ * `rate = (cachedTokens − Σ excluded.cachedTokens) / (totalInputTokens − Σ excluded.totalInputTokens)`.
19
+ */
20
+ import type { Usage } from "../../internal/llm.js";
21
+ import type { Stats } from "./assemble-result.js";
22
+ import type { UsageLane } from "./side-call-account.js";
23
+ import type { CacheFamily } from "./usage-accounting.js";
24
+ /** One lane's ratio operands as the account counted them, and whether every call on it stated them. */
25
+ export interface CacheLaneOperands {
26
+ cachedTokens: number;
27
+ totalInputTokens: number;
28
+ complete: boolean;
29
+ }
30
+ /** The lanes a leg booked calls on, keyed by lane, in the order each lane first booked one. */
31
+ export type CacheLanes = Partial<Record<UsageLane, CacheLaneOperands>>;
32
+ /** A lane left out of the cache-hit rate, with what it contributed to the aggregate numbers. */
33
+ export interface CacheHitExclusion {
34
+ readonly lane: UsageLane;
35
+ readonly cachedTokens: number;
36
+ readonly totalInputTokens: number;
37
+ }
38
+ /** What one booked call's usage says about its cache members. */
39
+ export interface CacheMemberMarks {
40
+ /** The call did not report its cache reads. */
41
+ readonly readUnreported: boolean;
42
+ /** The call did not report its cache writes. */
43
+ readonly writeUnreported: boolean;
44
+ /** A member the call's total is made of was not reported (input-excludes-cached family): the total is a lower bound. */
45
+ readonly totalLowerBound: boolean;
46
+ }
47
+ /** A usage a call reported, under the cache family of the model that made it. */
48
+ export interface ReportedUsage {
49
+ readonly family: CacheFamily;
50
+ readonly usage: Usage;
51
+ }
52
+ /** The marks of one call's usage (absent ⇒ the call reported nothing: every member is unreported and its total a lower bound). */
53
+ export declare function cacheMemberMarksOf(reported: ReportedUsage | undefined): CacheMemberMarks;
54
+ /**
55
+ * Book one call on `lane`: its cache marks onto the leg's stats, its ratio operands onto the lane. `reported` absent ⇒ the call —
56
+ * or a main-loop turn that booked no call — reported nothing; `usageMissing` ⇒ the call's usage is a lower bound; either way the
57
+ * lane is incomplete. `totalInputTokens` is the call's cache-inclusive input total as the account counted it. Returns the
58
+ * call's marks, for the turn's frame.
59
+ */
60
+ export declare function bookCacheOperands(stats: Stats, lane: UsageLane, reported: ReportedUsage | undefined, usageMissing: boolean, totalInputTokens: number): CacheMemberMarks;
61
+ /** A call's cache members as its `brain.call` trace row carries them: each one present only when the call reported it. */
62
+ export declare function cacheTraceMembersOf(usage: Usage): {
63
+ cacheRead?: number;
64
+ cacheWrite?: number;
65
+ };
66
+ /** The lanes left out of the rate: every incomplete lane, with its counted operands. */
67
+ export declare function cacheHitExclusionsOf(lanes: CacheLanes | undefined): CacheHitExclusion[];
68
+ /** The rate's operands by the one identity: the aggregate numbers minus what the excluded lanes contributed. */
69
+ export declare function cacheHitOperandsOf(totals: {
70
+ readonly cachedTokens: number;
71
+ readonly totalInputTokens: number;
72
+ }, excludes: readonly CacheHitExclusion[]): {
73
+ cachedTokens: number;
74
+ totalInputTokens: number;
75
+ };
76
+ /** Is the main loop's lane complete? (No main-loop call booked ⇒ there is nothing on it to judge: not complete.) */
77
+ export declare function mainCacheLaneComplete(lanes: CacheLanes | undefined): boolean;
@@ -0,0 +1,46 @@
1
+ export function cacheMemberMarksOf(reported) {
2
+ if (reported === undefined)
3
+ return { readUnreported: true, writeUnreported: true, totalLowerBound: true };
4
+ const readUnreported = reported.usage.cacheRead === undefined;
5
+ const writeUnreported = reported.usage.cacheWrite === undefined;
6
+ return { readUnreported, writeUnreported, totalLowerBound: reported.family === "input-excludes-cached" && (readUnreported || writeUnreported) };
7
+ }
8
+ export function bookCacheOperands(stats, lane, reported, usageMissing, totalInputTokens) {
9
+ const marks = cacheMemberMarksOf(reported);
10
+ if (marks.readUnreported)
11
+ stats.cacheReadUnreported = true;
12
+ if (marks.writeUnreported)
13
+ stats.cacheWriteUnreported = true;
14
+ if (marks.totalLowerBound)
15
+ stats.usageMissing = true;
16
+ const lanes = (stats.cacheLanes ??= {});
17
+ const operands = (lanes[lane] ??= { cachedTokens: 0, totalInputTokens: 0, complete: true });
18
+ operands.cachedTokens += reported?.usage.cacheRead ?? 0;
19
+ operands.totalInputTokens += totalInputTokens;
20
+ if (usageMissing || marks.readUnreported || marks.totalLowerBound)
21
+ operands.complete = false;
22
+ return marks;
23
+ }
24
+ export function cacheTraceMembersOf(usage) {
25
+ return { ...(usage.cacheRead !== undefined ? { cacheRead: usage.cacheRead } : {}), ...(usage.cacheWrite !== undefined ? { cacheWrite: usage.cacheWrite } : {}) };
26
+ }
27
+ export function cacheHitExclusionsOf(lanes) {
28
+ const out = [];
29
+ for (const [lane, operands] of Object.entries(lanes ?? {})) {
30
+ if (!operands.complete)
31
+ out.push({ lane, cachedTokens: operands.cachedTokens, totalInputTokens: operands.totalInputTokens });
32
+ }
33
+ return out;
34
+ }
35
+ export function cacheHitOperandsOf(totals, excludes) {
36
+ let cachedTokens = totals.cachedTokens;
37
+ let totalInputTokens = totals.totalInputTokens;
38
+ for (const e of excludes) {
39
+ cachedTokens -= e.cachedTokens;
40
+ totalInputTokens -= e.totalInputTokens;
41
+ }
42
+ return { cachedTokens, totalInputTokens };
43
+ }
44
+ export function mainCacheLaneComplete(lanes) {
45
+ return lanes?.main?.complete === true;
46
+ }
@@ -94,8 +94,9 @@ export interface ApprovedCallScreenInput {
94
94
  * The approved call's PreToolUse screening — the gate's own screening, its answer FOLDED UNDER THE DECIDE that approved
95
95
  * the call (the decide is the upper bound; the screen can only narrow): a deny, a failed or cancelled screening, or a
96
96
  * refused answer refuses the call in the live gate's own sentences; an ask is the question the decide already answered —
97
- * unless it demands a person and the decide was the deployment's policy (the one predicate every resume station holds a
98
- * decide against); context rides the result. Its three outlets are those — a refusal, an ask, the context: a rewrite is not
97
+ * unless it demands a person and no person answered a question carrying the hook's class (`answered`, the classes of the
98
+ * question a person answered on the row: the one reading every resume station holds an earlier answer against); context
99
+ * rides the result. Its three outlets are those — a refusal, an ask, the context: a rewrite is not
99
100
  * one. The bytes that run are the bytes the decide approved (the person's edit, or the call as shown), so an `updatedInput`
100
101
  * here is not adopted — the reference's form, where a parked answer's own input stands over the hook's. Undefined when no
101
102
  * handler hangs on `classic.PreToolUse`.
@@ -1,6 +1,6 @@
1
1
  import { createPreToolUseScreening, formatHookFeedback } from "../hooks.js";
2
2
  import { classicEventBase, dispatchClassic, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
3
- import { policyCannotAnswer } from "../real-approval.js";
3
+ import { beltUnanswered } from "../real-approval.js";
4
4
  import { decisionText } from "../tool-policy.js";
5
5
  import { rosterToolName } from "../tool-roster.js";
6
6
  import { wireOf } from "../tool-name-readings.js";
@@ -99,11 +99,12 @@ export function createToolResultStation(input) {
99
99
  }
100
100
  return undefined;
101
101
  }
102
+ const HOOK_CLASSES = Object.freeze(["hook"]);
102
103
  export function createApprovedCallScreen(input) {
103
104
  const { modBus, permissionMode, abortController, handsCwdRef, hookEnvFace, hookIdentity, preToolContexts } = input;
104
105
  if (!modBus.hasHandlers("classic.PreToolUse"))
105
106
  return undefined;
106
- return async ({ toolCallId, toolName, args, decidedBy }) => {
107
+ return async ({ toolCallId, toolName, args, answered }) => {
107
108
  const screening = createPreToolUseScreening({
108
109
  event: { toolCallId, toolName, input: {} },
109
110
  modBus,
@@ -124,8 +125,8 @@ export function createApprovedCallScreen(input) {
124
125
  const r = screened.answer;
125
126
  if (r?.action === "deny")
126
127
  return { refused: screening.deniedReason(r), ...(screened.answeredBy !== undefined ? { extension: screened.answeredBy } : {}) };
127
- if (r !== undefined && policyCannotAnswer(r, decidedBy))
128
- return { refused: `a PreToolUse hook requires a person's approval for ${subject}, and this approval was the deployment's policy — not executed` };
128
+ if (r !== undefined && beltUnanswered(r, HOOK_CLASSES, answered))
129
+ return { refused: `a PreToolUse hook requires a person's approval for ${subject}, and the approval this call had was not given to a question the hook asked — not executed; send the call again to have it asked` };
129
130
  const contexts = screened.contexts;
130
131
  return { admit: () => {
131
132
  if (contexts.length > 0)
@@ -0,0 +1,43 @@
1
+ /**
2
+ * The changed-files scan: the ONE reading of "which files this session read have moved on disk since" that every request
3
+ * the engine owes a frame to asks — the turn boundary's bundle collection and a leg's first request (a fresh run's
4
+ * first message, a resumed leg's continuation). One door, one scanner, one frame ({@link collectChangedFilesAttachment}):
5
+ * the stations differ only in WHERE the frame rides, never in what is scanned. Whether the model was already told is asked
6
+ * of the request's own view (the notice's record on its message, `request-copy-projection.ts`), never of a table here.
7
+ */
8
+ import type { TaskSpec } from "../types.js";
9
+ import type { Prepared } from "./contracts.js";
10
+ /** One path the scan found moved on disk, with the modification time it was found at. */
11
+ export type ChangedFile = {
12
+ path: string;
13
+ mtimeMs: number;
14
+ };
15
+ export interface ChangedFilesScanInput {
16
+ /** The run's `spec.attachments` — the opt-in and the `maxFiles` knob. */
17
+ cfg: TaskSpec["attachments"];
18
+ /** The leg's scanner (`Prepared.detectExternalChanges`); absent without hands. */
19
+ detect: Prepared["detectExternalChanges"];
20
+ /** The leg's frame-receipt ledger: a changed-files frame already on its way to the next request (`frameCarried`) is not scanned for again. */
21
+ ledger: Prepared["frameReceipts"];
22
+ /** A request a settlement boundary precedes — a resumed leg with calls of its suspended batch still to run — is scanned for THERE, after
23
+ * those calls ran, and answers true here: the request then owes no scan of its own, which would also hold the boundary's scan back as a frame
24
+ * already on its way. Asked only when a scan is owed. */
25
+ settlesFirst?: () => Promise<boolean>;
26
+ }
27
+ /**
28
+ * The scan this request owes, or `undefined` when it owes none: the opt-in is off, a frame is already on its way, or the leg
29
+ * has no scanner. The answer is synchronous so a request that owes nothing costs no await and, above all, ZERO fileInfo calls
30
+ * — OFF means literally nothing is stat'ed. Truthiness (not `!== undefined`): the type says `true | {maxFiles}`, but a JS
31
+ * caller passing `false` must read as OFF, never as opted-in. The array (possibly empty) is every file found changed and not
32
+ * read again — {@link collectChangedFilesAttachment} lists them all.
33
+ */
34
+ export declare function scanChangedFiles(input: ChangedFilesScanInput): Promise<ChangedFile[]> | undefined;
35
+ /**
36
+ * The receipt step of a changed-files notice, once its message is in the session: `announce` (the notice's `steering_injected`
37
+ * echo and its injected count) runs only when the request tells the model something with it — the request projection's
38
+ * own answer ({@link lastNoticeCarried}) over the session's context with the notice's message last. A scan that finds the
39
+ * same file changed and unread at every boundary mints a notice each time; the view carries each (path, modification time)
40
+ * once, and so do the shell's display and the event store. A view that cannot be read announces (the notice was minted
41
+ * to be told; the display saying more than the request is the safe side).
42
+ */
43
+ export declare function announceWhenCarried(prepared: Pick<Prepared, "session" | "harness">, announce: () => void): () => Promise<void>;
@@ -0,0 +1,34 @@
1
+ import { turnContextOptions } from "../../internal/harness.js";
2
+ import { lastNoticeCarried } from "../request-copy-projection.js";
3
+ import { frameCarried } from "./compaction-restate.js";
4
+ import { CHANGED_FILES_MAX } from "./turn-attachments.js";
5
+ const SCAN_CEILING_MS = 2_000;
6
+ export function scanChangedFiles(input) {
7
+ const { cfg, detect, ledger, settlesFirst } = input;
8
+ if (!Boolean(cfg?.changedFiles) || frameCarried(ledger, "changed_files") || detect === undefined)
9
+ return undefined;
10
+ const maxFiles = typeof cfg?.changedFiles === "object" ? (cfg.changedFiles.maxFiles ?? CHANGED_FILES_MAX) : CHANGED_FILES_MAX;
11
+ return settlesFirst === undefined ? runScan(detect, maxFiles) : settlesFirst().then((later) => (later ? [] : runScan(detect, maxFiles)));
12
+ }
13
+ export function announceWhenCarried(prepared, announce) {
14
+ return async () => {
15
+ let carried = true;
16
+ try {
17
+ carried = lastNoticeCarried((await prepared.session.buildContext(turnContextOptions(prepared.harness.getModel()))).messages);
18
+ }
19
+ catch {
20
+ }
21
+ if (carried)
22
+ announce();
23
+ };
24
+ }
25
+ async function runScan(detect, maxFiles) {
26
+ let ceiling;
27
+ const scan = await Promise.race([
28
+ detect(maxFiles),
29
+ new Promise((resolve) => {
30
+ ceiling = setTimeout(() => resolve({ changed: [] }), SCAN_CEILING_MS);
31
+ }),
32
+ ]).finally(() => clearTimeout(ceiling));
33
+ return scan.changed;
34
+ }