@sema-agent/core 7.66.1 → 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 (899) hide show
  1. package/CHANGELOG.md +3483 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +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.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,410 @@
1
+ import { createHash } from "node:crypto";
2
+ import { changedFilesNoticesOf, SECOND_RESULT_SEPARATOR, userAttachmentOf } from "../internal/llm.js";
3
+ import { MARKED_BLOCK_AFTER_DATA, mintSystemReminder, openSystemReminder } from "./reminder-mint.js";
4
+ import { isCleared } from "./context-edit.js";
5
+ import { pathConfinableWriteToolNames } from "./tool-registry.js";
6
+ import { writeTargetPath } from "../tools/fs/safety.js";
7
+ import { seededFileUnchangedReminder } from "../tools/fs/fs-shared.js";
8
+ export const READ_TOOL_NAMES = new Set(["read", "Read", "read_file"]);
9
+ const sha256 = (text) => createHash("sha256").update(text, "utf8").digest("hex");
10
+ const isRecord = (v) => typeof v === "object" && v !== null;
11
+ const textOf = (content) => {
12
+ if (typeof content === "string")
13
+ return content;
14
+ if (!Array.isArray(content))
15
+ return undefined;
16
+ const items = content;
17
+ let out = "";
18
+ for (const b of items) {
19
+ if (!isRecord(b) || b.type !== "text" || typeof b.text !== "string")
20
+ return undefined;
21
+ out += b.text;
22
+ }
23
+ return out;
24
+ };
25
+ const RETIRED_READ_STUB = /^\[([\s\S]+): unchanged since you last read it \(lines (\d+)-(\d+) of (\d+)\); content omitted to save context\]$/;
26
+ const BARE_OPEN = openSystemReminder(undefined);
27
+ const [SEEDED_HEAD = "", SEEDED_TAIL = ""] = seededFileUnchangedReminder("\u0000", undefined).split("\u0000");
28
+ function retiredSeededPath(text) {
29
+ const body = SEEDED_HEAD.slice(BARE_OPEN.length);
30
+ const at = text.indexOf(body);
31
+ if (at <= 0 || !text.endsWith(SEEDED_TAIL))
32
+ return undefined;
33
+ const open = text.slice(0, at);
34
+ const mark = /^ mark="([^"]*)">$/.exec(open.slice(BARE_OPEN.length - 1))?.[1];
35
+ if (open !== BARE_OPEN && (mark === undefined || open !== openSystemReminder(mark)))
36
+ return undefined;
37
+ const path = text.slice(at + body.length, text.length - SEEDED_TAIL.length);
38
+ return path.length > 0 ? path : undefined;
39
+ }
40
+ export function isRetiredDedupStub(m) {
41
+ return retiredOf(m) !== undefined;
42
+ }
43
+ function retiredOf(m) {
44
+ if (!isRecord(m))
45
+ return undefined;
46
+ const frame = userAttachmentOf(m);
47
+ if (frame !== undefined) {
48
+ const outcome = frame.outcome;
49
+ return outcome === "unchanged" ? { carrier: "frame", attachment: frame, retired: true } : undefined;
50
+ }
51
+ if (m.role !== "toolResult" || m.isError === true || isCleared(m))
52
+ return undefined;
53
+ const details = m.details;
54
+ if (isRecord(details) && details.type === "file_unchanged") {
55
+ const file = isRecord(details.file) ? details.file : {};
56
+ const filePath = typeof file.filePath === "string" ? file.filePath : "the file";
57
+ const start = file.startLine, end = file.endLine, total = file.totalLines;
58
+ const window = typeof start === "number" && typeof end === "number" && typeof total === "number" ? { start, end, total } : undefined;
59
+ return { carrier: "read", filePath, ...(window !== undefined ? { window } : {}), retired: true };
60
+ }
61
+ if (typeof m.toolName !== "string" || !READ_TOOL_NAMES.has(m.toolName))
62
+ return undefined;
63
+ if (isRecord(details) && typeof details.type === "string")
64
+ return undefined;
65
+ const text = textOf(m.content);
66
+ if (text === undefined)
67
+ return undefined;
68
+ const plain = RETIRED_READ_STUB.exec(text);
69
+ if (plain !== null)
70
+ return { carrier: "read", filePath: plain[1], window: { start: Number(plain[2]), end: Number(plain[3]), total: Number(plain[4]) }, retired: true };
71
+ const seeded = retiredSeededPath(text);
72
+ if (seeded !== undefined)
73
+ return { carrier: "read", filePath: seeded, retired: true };
74
+ return undefined;
75
+ }
76
+ const identities = new WeakMap();
77
+ function copyOf(m) {
78
+ if (!isRecord(m))
79
+ return undefined;
80
+ const memo = identities.get(m);
81
+ if (memo !== undefined)
82
+ return memo ?? undefined;
83
+ const copy = mintCopy(m);
84
+ identities.set(m, copy ?? null);
85
+ return copy;
86
+ }
87
+ function mintCopy(m) {
88
+ const frame = userAttachmentOf(m);
89
+ if (frame !== undefined) {
90
+ const obs = frame.observation;
91
+ if (obs === undefined || frame.supply !== "path" || (frame.kind !== "text" && frame.kind !== "notebook"))
92
+ return undefined;
93
+ if (frame.outcome !== "attached" || obs.entry.isPartialView === true || obs.entry.totalLines <= 0)
94
+ return undefined;
95
+ if (frame.dataBlocks.end <= frame.dataBlocks.start)
96
+ return undefined;
97
+ const view = obs.entry.view;
98
+ const whole = obs.entry.truncated === false;
99
+ const identity = frame.kind === "notebook" ? `nbf:${obs.entry.hash}` : whole ? `w:${obs.entry.hash}` : `fr:${obs.entry.hash}:${view?.start ?? 0}-${view?.end ?? 0}`;
100
+ return { carrier: "frame", attachment: frame, identity, paths: [frame.label, obs.key], ...(whole && frame.kind === "text" ? { wholeHash: obs.entry.hash } : {}) };
101
+ }
102
+ if (m.role !== "toolResult" || m.isError === true || typeof m.toolName !== "string" || !READ_TOOL_NAMES.has(m.toolName))
103
+ return undefined;
104
+ if (isCleared(m))
105
+ return undefined;
106
+ const details = m.details;
107
+ if (!isRecord(details) || !isRecord(details.file) || typeof details.file.filePath !== "string")
108
+ return undefined;
109
+ const file = details.file;
110
+ const filePath = details.file.filePath;
111
+ if (details.type === "text") {
112
+ const content = file.content, start = file.startLine, numLines = file.numLines, total = file.totalLines;
113
+ if (typeof content !== "string" || typeof start !== "number" || typeof numLines !== "number" || typeof total !== "number")
114
+ return undefined;
115
+ if (file.truncatedByTokenCap === true || total <= 0 || numLines <= 0)
116
+ return undefined;
117
+ const end = start + numLines - 1;
118
+ const hash = sha256(content);
119
+ const whole = start === 1 && end === total;
120
+ return { carrier: "read", filePath, window: { start, end, total }, identity: whole ? `w:${hash}` : `rr:${hash}:${start}-${end}:${total}`, paths: [filePath], ...(whole ? { wholeHash: hash } : {}) };
121
+ }
122
+ if (details.type === "notebook") {
123
+ if (!Array.isArray(file.cells) || file.cells.length === 0)
124
+ return undefined;
125
+ return { carrier: "read", filePath, identity: `nbr:${sha256(JSON.stringify(m.content))}`, paths: [filePath] };
126
+ }
127
+ return undefined;
128
+ }
129
+ function deliveryOf(m) {
130
+ return copyOf(m) ?? retiredOf(m);
131
+ }
132
+ const baseName = (p) => p.split(/[\\/]/).pop() ?? p;
133
+ function writtenNames(m) {
134
+ const withdrawn = userAttachmentOf(m)?.withdraws;
135
+ if (withdrawn !== undefined)
136
+ return [baseName(withdrawn)];
137
+ if (!isRecord(m) || m.role !== "assistant" || !Array.isArray(m.content))
138
+ return [];
139
+ const writers = pathConfinableWriteToolNames();
140
+ const blocks = m.content;
141
+ const out = [];
142
+ for (const b of blocks) {
143
+ if (!isRecord(b) || b.type !== "toolCall" || typeof b.name !== "string" || !writers.has(b.name))
144
+ continue;
145
+ const target = writeTargetPath({ toolName: b.name, args: b.arguments });
146
+ if (target !== undefined)
147
+ out.push(baseName(target));
148
+ }
149
+ return out;
150
+ }
151
+ class CopyWalk {
152
+ input;
153
+ heads = new Map();
154
+ seedBroken = new Set();
155
+ told = new Set();
156
+ constructor(input) {
157
+ this.input = input;
158
+ }
159
+ toldBefore(f) {
160
+ const key = `${f.mtimeMs}\u0000${f.path}`;
161
+ if (this.told.has(key))
162
+ return true;
163
+ this.told.add(key);
164
+ return false;
165
+ }
166
+ write(names) {
167
+ if (names.length === 0)
168
+ return;
169
+ const hit = new Set(names);
170
+ for (const [identity, list] of this.heads) {
171
+ const kept = list.filter((h) => ![...h.paths].some((p) => hit.has(baseName(p))));
172
+ if (kept.length === 0)
173
+ this.heads.delete(identity);
174
+ else
175
+ this.heads.set(identity, kept);
176
+ }
177
+ for (const n of names)
178
+ this.seedBroken.add(`name:${n}`);
179
+ }
180
+ decide(d) {
181
+ if ("retired" in d)
182
+ return "pointer";
183
+ const seeded = seededKeyOf(d, this.input.seeded);
184
+ if (seeded !== undefined && !this.seedBroken.has(seeded) && !this.seedBroken.has(`name:${baseName(seeded)}`))
185
+ return "seeded";
186
+ for (const key of this.input.seeded?.keys() ?? [])
187
+ if (d.paths.some((p) => sameFile(p, key)) && this.input.seeded?.get(key) !== d.wholeHash)
188
+ this.seedBroken.add(key);
189
+ const list = this.heads.get(d.identity) ?? [];
190
+ const head = list.find((h) => d.paths.some((p) => h.paths.has(p)));
191
+ if (head !== undefined) {
192
+ for (const p of d.paths)
193
+ head.paths.add(p);
194
+ return head.pointer ? "pointer" : "not_repeated";
195
+ }
196
+ const pointer = this.input.degraded?.has(d.identity) === true;
197
+ this.heads.set(d.identity, [...list, { paths: new Set(d.paths), pointer }]);
198
+ return pointer ? "pointer" : "contents";
199
+ }
200
+ }
201
+ const sameFile = (spelling, key) => spelling === key || baseName(spelling) === baseName(key);
202
+ function seededKeyOf(d, seeded) {
203
+ if (seeded === undefined || d.wholeHash === undefined)
204
+ return undefined;
205
+ for (const [key, hash] of seeded)
206
+ if (hash === d.wholeHash && d.paths.some((p) => sameFile(p, key)))
207
+ return key;
208
+ return undefined;
209
+ }
210
+ function readSentence(d, rendering, input) {
211
+ const r = d;
212
+ if (rendering === "seeded")
213
+ return seededFileUnchangedReminder(seededKeyOf(d, input.seeded) ?? r.filePath, input.mark);
214
+ const w = r.window;
215
+ if (rendering === "not_repeated") {
216
+ return w !== undefined
217
+ ? `[${r.filePath}: unchanged since you last read it (lines ${w.start}-${w.end} of ${w.total}); content omitted to save context]`
218
+ : `[${r.filePath}: unchanged since you last read it (the whole notebook); content omitted to save context]`;
219
+ }
220
+ return w !== undefined
221
+ ? `[${r.filePath}: lines ${w.start}-${w.end} of ${w.total} — contents not included in this result; read the file again if you need them]`
222
+ : `[${r.filePath}: contents not included in this result; read the file again if you need them]`;
223
+ }
224
+ function frameSentence(rendering) {
225
+ switch (rendering) {
226
+ case "not_repeated":
227
+ return "The file has not changed since you last read it, so its contents are not repeated.";
228
+ case "seeded":
229
+ return "This file is already in your context and has not changed, so its contents are not repeated.";
230
+ case "pointer":
231
+ return "Its contents are not included with this message. Use the Read tool if you need them.";
232
+ }
233
+ }
234
+ function renderFrame(m, a, rendering, input) {
235
+ const blocks = Array.isArray(m.content) ? m.content : [];
236
+ const head = blocks.slice(0, a.dataBlocks.start);
237
+ const closing = blocks.length > a.dataBlocks.end ? blocks.slice(-1) : [];
238
+ const sentence = { type: "text", text: `${MARKED_BLOCK_AFTER_DATA}${mintSystemReminder(frameSentence(rendering), input.mark)}` };
239
+ return Object.assign({}, m, { content: [...head, sentence, ...closing] });
240
+ }
241
+ export function projectRequestView(view, input = {}) {
242
+ const walk = new CopyWalk(input);
243
+ let out;
244
+ view.forEach((m, i) => {
245
+ walk.write(writtenNames(m));
246
+ const rendered = renderOne(m, walk, input);
247
+ if (rendered !== m)
248
+ (out ??= view.slice())[i] = rendered;
249
+ });
250
+ if (out === undefined)
251
+ return view;
252
+ const sent = out;
253
+ sent.forEach((m, i) => {
254
+ if (m !== undefined)
255
+ return;
256
+ const before = sent.slice(0, i).findLast((x) => x !== undefined);
257
+ const after = sent.slice(i + 1).find((x) => x !== undefined);
258
+ if (before !== undefined && messageRole(before) === "assistant" && (after === undefined || messageRole(after) === "assistant"))
259
+ sent[i] = view[i];
260
+ });
261
+ return sent;
262
+ }
263
+ const messageRole = (m) => (isRecord(m) ? m.role : undefined);
264
+ export function projectRequestCopies(view, input = {}) {
265
+ const sent = projectRequestView(view, input);
266
+ return sent === view ? view : sent.filter((m) => m !== undefined);
267
+ }
268
+ function renderOne(m, walk, input) {
269
+ if (!isRecord(m))
270
+ return m;
271
+ const notices = changedFilesNoticesOf(m);
272
+ if (notices !== undefined)
273
+ return renderNotices(m, notices, walk);
274
+ const parts = input.folds?.get(m);
275
+ if (parts !== undefined && m.role === "toolResult") {
276
+ const segments = parts.map((p) => {
277
+ const d = deliveryOf(p);
278
+ const rendering = d === undefined ? "contents" : walk.decide(d);
279
+ const own = isRecord(p) && Array.isArray(p.content) ? p.content : [];
280
+ return rendering === "contents" || d === undefined ? own : [{ type: "text", text: readSentence(d, rendering, input) }];
281
+ });
282
+ if (parts.every((p, i) => segments[i] === (isRecord(p) && Array.isArray(p.content) ? p.content : undefined)))
283
+ return m;
284
+ const content = segments.flatMap((s, i) => (i === 0 ? [...s] : [{ type: "text", text: SECOND_RESULT_SEPARATOR }, ...s]));
285
+ return Object.assign({}, m, { content });
286
+ }
287
+ const d = deliveryOf(m);
288
+ if (d === undefined)
289
+ return m;
290
+ const rendering = walk.decide(d);
291
+ if (rendering === "contents")
292
+ return m;
293
+ if (d.carrier === "frame")
294
+ return renderFrame(m, d.attachment, rendering, input);
295
+ return Object.assign({}, m, { content: [{ type: "text", text: readSentence(d, rendering, input) }], details: undefined });
296
+ }
297
+ const NOTICE_SEPARATOR_MAX = 2;
298
+ const untoldFilesOf = (n, walk) => n.files.filter((f) => !walk.toldBefore(f));
299
+ export function lastNoticeCarried(view) {
300
+ const last = view.at(-1);
301
+ if (last === undefined || changedFilesNoticesOf(last) === undefined)
302
+ return true;
303
+ const walk = new CopyWalk({});
304
+ let untold = false;
305
+ for (const m of view) {
306
+ const notices = changedFilesNoticesOf(m);
307
+ if (notices !== undefined)
308
+ untold = notices.map((n) => untoldFilesOf(n, walk).length > 0).includes(true);
309
+ }
310
+ return untold || projectRequestView(view)[view.length - 1] === last;
311
+ }
312
+ function renderNotices(m, notices, walk) {
313
+ const content = m.content;
314
+ if (typeof content !== "string" && !Array.isArray(content))
315
+ return m;
316
+ const parts = typeof content === "string" ? [] : content;
317
+ const text = typeof content === "string" ? content : parts.map((b) => (isRecord(b) && b.type === "text" && typeof b.text === "string" ? b.text : "")).join("");
318
+ const cuts = [];
319
+ for (const n of notices) {
320
+ const untold = untoldFilesOf(n, walk);
321
+ const told = n.files.filter((f) => !untold.includes(f));
322
+ if (told.length === 0)
323
+ continue;
324
+ if (told.length < n.files.length) {
325
+ for (const f of told)
326
+ cuts.push([f.start, f.end]);
327
+ continue;
328
+ }
329
+ let start = n.start, end = n.end;
330
+ const after = /^\n*/.exec(text.slice(end, end + NOTICE_SEPARATOR_MAX))[0].length;
331
+ if (after > 0)
332
+ end += after;
333
+ else
334
+ start -= /\n*$/.exec(text.slice(Math.max(0, start - NOTICE_SEPARATOR_MAX), start))[0].length;
335
+ cuts.push([start, end]);
336
+ }
337
+ if (cuts.length === 0)
338
+ return m;
339
+ const cutOut = (s, at) => {
340
+ let kept = "", from = 0;
341
+ for (const [a, b] of cuts) {
342
+ const lo = Math.max(a - at, 0), hi = Math.min(b - at, s.length);
343
+ if (hi <= lo)
344
+ continue;
345
+ kept += s.slice(from, Math.max(from, lo));
346
+ from = Math.max(from, hi);
347
+ }
348
+ return kept + s.slice(from);
349
+ };
350
+ const moved = (pos) => pos - cuts.reduce((n, [a, b]) => n + Math.max(0, Math.min(b, pos) - a), 0);
351
+ const ranges = movedEngineRanges(m, moved);
352
+ if (typeof content === "string") {
353
+ const left = cutOut(content, 0);
354
+ return left.trim().length === 0 ? undefined : Object.assign({}, m, { content: left, ...ranges });
355
+ }
356
+ let at = 0;
357
+ const blocks = [];
358
+ for (const b of parts) {
359
+ if (!isRecord(b) || b.type !== "text" || typeof b.text !== "string") {
360
+ blocks.push(b);
361
+ continue;
362
+ }
363
+ const left = cutOut(b.text, at);
364
+ at += b.text.length;
365
+ if (left.length > 0)
366
+ blocks.push(left === b.text ? b : { ...b, text: left });
367
+ }
368
+ const said = blocks.some((b) => !isRecord(b) || b.type !== "text" || (typeof b.text === "string" && b.text.trim().length > 0));
369
+ return said ? Object.assign({}, m, { content: blocks, ...ranges }) : undefined;
370
+ }
371
+ function movedEngineRanges(m, moved) {
372
+ const out = { changedFilesNotices: undefined };
373
+ if (typeof m.enginePrefixChars === "number" && Number.isInteger(m.enginePrefixChars)) {
374
+ const chars = moved(m.enginePrefixChars);
375
+ out.enginePrefixChars = chars > 0 ? chars : undefined;
376
+ }
377
+ if (Array.isArray(m.engineSegments)) {
378
+ const segments = m.engineSegments;
379
+ const ranges = [];
380
+ for (const s of segments)
381
+ if (isRecord(s) && typeof s.start === "number" && typeof s.end === "number" && Number.isInteger(s.start) && Number.isInteger(s.end))
382
+ ranges.push({ start: s.start, end: s.end });
383
+ if (ranges.length === segments.length) {
384
+ const left = ranges.flatMap((r) => {
385
+ const start = moved(r.start), end = moved(r.end);
386
+ return end > start ? [{ start, end }] : [];
387
+ });
388
+ out.engineSegments = left.length > 0 ? left : undefined;
389
+ }
390
+ }
391
+ return out;
392
+ }
393
+ export function copyIdentityOf(m) {
394
+ return copyOf(m)?.identity;
395
+ }
396
+ export function chooseDegraded(core, fits) {
397
+ const order = [];
398
+ for (const m of core) {
399
+ const id = copyIdentityOf(m);
400
+ if (id !== undefined && !order.includes(id))
401
+ order.push(id);
402
+ }
403
+ const degraded = new Set(order);
404
+ for (let i = order.length - 1; i >= 0; i--) {
405
+ degraded.delete(order[i]);
406
+ if (!fits(degraded))
407
+ degraded.add(order[i]);
408
+ }
409
+ return degraded;
410
+ }
@@ -0,0 +1,69 @@
1
+ /**
2
+ * The resume's CONFIG JUDGE — the rungs of the resume ladder that refuse a re-supplied config (or the deployment's deps, or a recorded
3
+ * name list) the way prepare would refuse it after the claim, and the one question that asks them all before anything is written.
4
+ *
5
+ * Every refusal here leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`: `checkpoint.config_refused`, the sentence prepare
6
+ * gives, prepare's code as `detail.code`, the input that carries it as `detail.field`, the arm as `detail.reason`). The ladder (admission,
7
+ * checkpoint screen, internals-and-config) calls these functions at the stations it always entered them at, so the order of its refusals is
8
+ * unchanged; {@link resumeConfigVerdictOf} runs the same functions in the same relative order over the same inputs, answers the first
9
+ * `checkpoint.config_refused` as a value, and writes nothing — `Runner.judgeResumeConfig` is its public seat. One set of rungs, one order:
10
+ * a host that asks first and writes after cannot be told something the claim path would not say.
11
+ *
12
+ * What it answers is the CONFIG question only. The row's own refusals (its version, its requirements, its recorded words) are the row's
13
+ * verdict (`checkpointRowRefusal`), which the ladder reads before these rungs; a refusal that is not a config refusal (an outcome the gate
14
+ * does not take, a principal that contradicts the row, a lost claim) is not this judge's to give.
15
+ */
16
+ import { type Checkpoint, type CheckpointStore } from "./checkpoint-store.js";
17
+ import type { CheckpointConfigRefusalCode, CheckpointErrorReason, ResumeConfigRefusalField } from "./checkpoint-features.js";
18
+ import type { SessionStore } from "./session.js";
19
+ import type { RunnerDeps } from "./types.js";
20
+ import type { ResumeTaskConfig, RunInternals } from "./runner/contracts.js";
21
+ /** What a host asks before it writes: the pending row, the config the resume would be handed, the trusted internals it would be handed. */
22
+ export interface ResumeConfigQuestion {
23
+ /** The pending row the resume would redeem (the host's own read of the token). The rungs that compare the config with the row read it: the names the row recorded, the isolation scope it was parked in. Required: a question without the row would pass those rungs unasked. */
24
+ readonly row: Checkpoint;
25
+ /** The `taskConfig` the resume would be handed, as the host would hand it. */
26
+ readonly taskConfig: ResumeTaskConfig;
27
+ /** The trusted `internals` the resume would be handed (its `holder`, `toolCeiling`, `ownToolLists`, inherited parent constraints), when it would be handed any. */
28
+ readonly internals?: RunInternals;
29
+ }
30
+ /**
31
+ * The answer: the config would not be refused, or the refusal the resume would give — `code`, `field` and `reason` are the resume's
32
+ * `checkpoint.config_refused` `detail.code`, `detail.field` and `detail.reason`, `message` its sentence (prepare's own).
33
+ */
34
+ export type ResumeConfigVerdict = {
35
+ readonly ok: true;
36
+ } | {
37
+ readonly ok: false;
38
+ readonly code: CheckpointConfigRefusalCode;
39
+ readonly field: ResumeConfigRefusalField;
40
+ readonly reason?: CheckpointErrorReason;
41
+ readonly message: string;
42
+ };
43
+ /** Rung 1 — the caller's config is a record, read ONCE into the snapshot every later rung and the resumed leg read (own data; the skills' lists detached). Refuses by the resume's one channel. */
44
+ export declare function readResumeConfig(taskConfig: ResumeTaskConfig): ResumeTaskConfig;
45
+ /** The trusted internals bag as the ladder reads it after the seat door's one read of it (`readLegInternals`): the composition leg copied by its one reading, the one member the ladder validates by its members. What every later rung and the resumed leg read, and what a host's question is judged over. */
46
+ export declare function snapshotResumeInternals(internals: RunInternals | undefined): RunInternals | undefined;
47
+ /** Rung 2 — the checkpoint store this resume redeems against (`undefined` for the `"disabled"` spelling); a seat the engine cannot accept leaves by the one channel, at the seat that named it. */
48
+ export declare function resolveResumeStore(config: ResumeTaskConfig, deps: RunnerDeps): CheckpointStore | undefined;
49
+ /** Rung 4 — the tool names a resume is bound by: the row's recorded ceiling and own lists (each when the leg runs under it, i.e. the internals supply no live one), then the roster the resume hands. */
50
+ export declare function refuseRecordedAndMountedToolNames(cp: Checkpoint, internals: RunInternals | undefined, tools: unknown): void;
51
+ /** Rung 5 — a retired member of an inherited constraint this resume is handed refuses by the same channel as the caller policies' same word, so the row stays pending. */
52
+ export declare function refuseRetiredInheritedConstraints(internals: RunInternals | undefined): void;
53
+ /** Rung 6 — the checkpoint scopes the config declares must follow the isolation scope the leg will run in. Asked only where the config names none and the row records one: the leg then inherits the row's, and that pair exists only after the inheritance (a config that names its own was judged by its door). `row` / `supplied` are the two values the caller already read (`|| undefined`). */
54
+ export declare function refuseScopesOffInheritedIsolationScope(row: string | undefined, supplied: string | undefined, config: Pick<ResumeTaskConfig, "durableApproval" | "resourceSuspend">): void;
55
+ /**
56
+ * Would a resume with this config be refused at the config rungs, before the claim? Runs {@link readResumeConfig}, {@link resolveResumeStore},
57
+ * `refuseResumeDoors`, {@link refuseRecordedAndMountedToolNames}, {@link refuseRetiredInheritedConstraints} and
58
+ * {@link refuseScopesOffInheritedIsolationScope} in the order the ladder reaches them, over the deps and the session store the Runner holds; the first
59
+ * `checkpoint.config_refused` is the answer. Pure: it reads the question's values and the seats' declarations and calls no store, no sink and no
60
+ * factory; the row stays as it is. A throw that is none of the channel's refusals leaves as it was thrown, exactly as the resume leaves it.
61
+ * The config bag is read once, and the internals are read through the seat door's one read of the bag (`readLegInternals`, then
62
+ * {@link snapshotResumeInternals}), as a resume reads them: a bag whose read throws is refused by the door's own sentence
63
+ * (`config.invalid_argument`) before any rung, as the resume refuses it; a bag that answers differently the next time it is read (an
64
+ * accessor) is a bag this verdict cannot vouch for.
65
+ */
66
+ export declare function resumeConfigVerdictOf(question: ResumeConfigQuestion, seats: {
67
+ readonly deps: RunnerDeps;
68
+ readonly sessions: SessionStore;
69
+ }): ResumeConfigVerdict;
@@ -0,0 +1,78 @@
1
+ import { CheckpointError, resolveCheckpointStore } from "./checkpoint-store.js";
2
+ import { asResumeConfigRefusal } from "./mode-policy.js";
3
+ import { readCallerSpec } from "./task-spec-members.js";
4
+ import { detachSkillLists } from "./skill-grant.js";
5
+ import { compositionLegRecord } from "./runner/checkpoint-scope.js";
6
+ import { readLegInternals } from "./runner/leg-frame.js";
7
+ import { assertCheckpointScopesFollowIsolationScope, assertResumeConfigRecord, checkpointStoreSeat, limitConfigError, refuseResumeDoors } from "./runner/prepare-config-doors.js";
8
+ import { refusePersistedToolNames, refuseRenamedDelegationMounts } from "./runner/sub-agent-deny-lists.js";
9
+ import { assertNoRetiredInheritedConstraints } from "./runner/retired-runner-deps.js";
10
+ export function readResumeConfig(taskConfig) {
11
+ asResumeConfigRefusal("taskConfig", () => assertResumeConfigRecord(taskConfig));
12
+ const configRead = readCallerSpec(taskConfig);
13
+ asResumeConfigRefusal("taskConfig", () => { if (configRead.refusal !== undefined)
14
+ throw configRead.refusal; });
15
+ return { ...configRead.spec, ...(Array.isArray(configRead.spec.skills) ? { skills: detachSkillLists(configRead.spec.skills) } : {}) };
16
+ }
17
+ export function snapshotResumeInternals(internals) {
18
+ return internals?.compositionLeg !== undefined ? { ...internals, compositionLeg: compositionLegRecord(internals.compositionLeg) } : internals;
19
+ }
20
+ export function resolveResumeStore(config, deps) {
21
+ return asResumeConfigRefusal(checkpointStoreSeat(config), () => resolveCheckpointStore(config, deps));
22
+ }
23
+ export function refuseRecordedAndMountedToolNames(cp, internals, tools) {
24
+ asResumeConfigRefusal("inheritedGate", () => refusePersistedToolNames((internals?.toolCeiling ?? undefined) === undefined ? cp.state.toolCeiling : undefined, undefined, (internals?.ownToolLists ?? undefined) === undefined ? cp.state.ownToolLists : undefined));
25
+ asResumeConfigRefusal("taskConfig", () => refuseRenamedDelegationMounts(tools));
26
+ }
27
+ export function refuseRetiredInheritedConstraints(internals) {
28
+ asResumeConfigRefusal("deps", () => assertNoRetiredInheritedConstraints(internals));
29
+ }
30
+ export function refuseScopesOffInheritedIsolationScope(row, supplied, config) {
31
+ if (supplied !== undefined || row === undefined)
32
+ return;
33
+ asResumeConfigRefusal("taskConfig", () => assertCheckpointScopesFollowIsolationScope({ isolationScope: row, durableApproval: config.durableApproval, resourceSuspend: config.resourceSuspend }));
34
+ }
35
+ function verdictOfRefusal(e) {
36
+ const { field, code, reason } = e.detail ?? {};
37
+ if (code === undefined || (field !== "taskConfig" && field !== "deps" && field !== "inheritedGate"))
38
+ return undefined;
39
+ return { ok: false, code, field, ...(reason !== undefined ? { reason } : {}), message: e.message };
40
+ }
41
+ function questionDefect(question) {
42
+ const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
43
+ if (!isRecord(question))
44
+ return `the question must be an object (got ${question === null ? "null" : Array.isArray(question) ? "an array" : typeof question})`;
45
+ const { row, internals } = question;
46
+ if (!isRecord(row))
47
+ return `question.row must be the pending checkpoint row (got ${row === null ? "null" : Array.isArray(row) ? "an array" : typeof row})`;
48
+ if (!isRecord(row.state))
49
+ return "question.row carries no `state` object — it is not a checkpoint row";
50
+ if (internals !== undefined && !isRecord(internals))
51
+ return `question.internals must be an object when given (got ${internals === null ? "null" : Array.isArray(internals) ? "an array" : typeof internals})`;
52
+ return undefined;
53
+ }
54
+ export function resumeConfigVerdictOf(question, seats) {
55
+ const defect = questionDefect(question);
56
+ if (defect !== undefined)
57
+ throw limitConfigError("config.invalid_argument", `judgeResumeConfig: ${defect} — the question names the pending row, the config and the internals the resume would be handed; a question that does not read is refused, never answered "ok".`);
58
+ const { row } = question;
59
+ try {
60
+ const bag = question.internals !== undefined ? readLegInternals(question.internals, "resumeStream") : undefined;
61
+ const supplied = readResumeConfig(question.taskConfig);
62
+ const internals = snapshotResumeInternals(bag);
63
+ resolveResumeStore(supplied, seats.deps);
64
+ const config = refuseResumeDoors(supplied, seats.deps, seats.sessions, internals?.holder);
65
+ refuseRecordedAndMountedToolNames(row, internals, config.tools);
66
+ refuseRetiredInheritedConstraints(internals);
67
+ refuseScopesOffInheritedIsolationScope(row.isolationScope || undefined, config.isolationScope || undefined, config);
68
+ return { ok: true };
69
+ }
70
+ catch (e) {
71
+ if (e instanceof CheckpointError && e.code === "checkpoint.config_refused") {
72
+ const verdict = verdictOfRefusal(e);
73
+ if (verdict !== undefined)
74
+ return verdict;
75
+ }
76
+ throw e;
77
+ }
78
+ }
@@ -24,6 +24,7 @@
24
24
  * unsafe payload, an input the constraints refuse): correct the decision and resubmit.
25
25
  */
26
26
  import type { AssertAllKeysHandled } from "./ask-origin.js";
27
+ import type { Checkpoint, CheckpointStore, CheckpointToken } from "./checkpoint-store.js";
27
28
  import type { TerminalFailureDetail } from "./terminal-cause.js";
28
29
  /**
29
30
  * design/80 D-1: why a consumed checkpoint was {@link import("./checkpoint-store.js").CheckpointStore.reopen | reopened}
@@ -89,8 +90,8 @@ export declare function reopenReasonOf(cause: ResumeStartupCause | undefined): R
89
90
  * What happened to a claimed row whose approved action never started — the one closed outcome every exit of such a leg reports
90
91
  * (the thrown-prepare backstop, the returned-leg settle, the post-claim abort): `reopened` under a reason (the row is pending again),
91
92
  * `declined` (the store's `reopen` answered `false`: the row is no longer the resolved row this leg claimed — missing, expired, its
92
- * decided action already disposed, or pending again — which the boolean does not say), `unknown` (the reopen threw: the write may have
93
- * committed and only its acknowledgement been lost, so the row's state cannot be proven from here).
93
+ * decided action already disposed, or pending again — which the boolean does not say), `unknown` (the reopen threw and the row does not
94
+ * show that it landed: the write may have committed and only its acknowledgement been lost, so the row's state cannot be proven from here).
94
95
  */
95
96
  export type UnstartedRow = {
96
97
  readonly kind: "reopened";
@@ -104,9 +105,18 @@ export type UnstartedRow = {
104
105
  /**
105
106
  * THE compensation of a claimed leg whose approved action never started: the claim's reversal (`reopen`, bound to the row) asked once,
106
107
  * under `reason`, and read into {@link UnstartedRow} — its answer, never a code sniffed off whatever it threw (a store's own error may
107
- * carry any code, and a throw after a committed write is not a refusal). Every exit calls it; none re-reads the outcome another way.
108
+ * carry any code, and a throw after a committed write is not a refusal). A reopen that threw is not an answer, so the row is asked
109
+ * (`claimedRowPending`, bound to the same row): only a row that shows the reopen landed is `reopened`. Any other reading — the row still
110
+ * claimed, claimed again by another resumer, gone, or unreadable — proves nothing about what this reopen did, and stays `unknown`.
111
+ * Every exit calls it; none re-reads the outcome another way.
108
112
  */
109
- export declare function compensateUnstarted(reopen: (reason: ReopenReason) => Promise<"reopened" | "declined">, reason: ReopenReason): Promise<UnstartedRow>;
113
+ export declare function compensateUnstarted(reopen: (reason: ReopenReason) => Promise<"reopened" | "declined">, reason: ReopenReason, claimedRowPending: () => Promise<boolean>): Promise<UnstartedRow>;
114
+ /**
115
+ * The row read {@link compensateUnstarted} asks after a reopen that threw, bound to the row the leg claimed: `true` only when the row
116
+ * reads `pending` at a generation past the one the claim won at (`claimed` is the row as the resume read it, before its claim) — the
117
+ * reopen having landed. A pending row at the claim's own generation is a read older than the claim, and proves nothing.
118
+ */
119
+ export declare function claimedRowPendingOf(store: Pick<CheckpointStore, "get">, token: CheckpointToken, claimed: Pick<Checkpoint, "rev">): () => Promise<boolean>;
110
120
  /** The sentence for {@link UnstartedRow} — one per outcome, the same on every exit; the exit puts its own lead before it. */
111
121
  export declare function unstartedRowSentence(row: UnstartedRow): string;
112
122
  export {};
@@ -1,3 +1,4 @@
1
+ import { checkpointRevOf } from "./checkpoint-generation.js";
1
2
  import { egressThrownText } from "./untrusted-egress.js";
2
3
  export const REOPEN_REASONS = Object.freeze(["env_failed", "tool_unavailable", "constraint_rejected", "config_refused"]);
3
4
  export const RESUME_STARTUP_CAUSES = Object.freeze(["environment", "session_gone", "transcript_corrupt", "tool_unavailable", "configuration", "decision_rejected"]);
@@ -13,6 +14,7 @@ const CAUSE_OF_CODE = new Map([
13
14
  ["resume.parent_constraint_missing", "configuration"],
14
15
  ["resume.parent_constraint_mismatch", "configuration"],
15
16
  ["revive.policy_floor_unreadable", "configuration"],
17
+ ["resume.agent_definition_mismatch", "configuration"],
16
18
  ["checkpoint.gate_mismatch", "decision_rejected"],
17
19
  ["checkpoint.invalid_outcome", "decision_rejected"],
18
20
  ["resume.constraint_rejected", "decision_rejected"],
@@ -46,14 +48,22 @@ const REOPEN_REASON_OF_CAUSE = {
46
48
  export function reopenReasonOf(cause) {
47
49
  return cause === undefined ? "env_failed" : REOPEN_REASON_OF_CAUSE[cause];
48
50
  }
49
- export async function compensateUnstarted(reopen, reason) {
51
+ export async function compensateUnstarted(reopen, reason, claimedRowPending) {
50
52
  try {
51
53
  return (await reopen(reason)) === "reopened" ? { kind: "reopened", reason } : { kind: "declined" };
52
54
  }
53
55
  catch (thrown) {
54
- return { kind: "unknown", thrown };
56
+ const landed = await claimedRowPending().then((pending) => pending, () => false);
57
+ return landed ? { kind: "reopened", reason } : { kind: "unknown", thrown };
55
58
  }
56
59
  }
60
+ export function claimedRowPendingOf(store, token, claimed) {
61
+ const claimedRev = checkpointRevOf(claimed);
62
+ return async () => {
63
+ const row = await store.get(token);
64
+ return row !== null && row.status === "pending" && checkpointRevOf(row) > claimedRev;
65
+ };
66
+ }
57
67
  export function unstartedRowSentence(row) {
58
68
  switch (row.kind) {
59
69
  case "reopened":
@@ -1,8 +1,9 @@
1
1
  import { receiveMembers } from "./own-property-receipt.js";
2
+ import { describeRejectedValue } from "./tool-search-setting.js";
2
3
  const AGE_KNOBS = ["maxAgeMs", "staleRunningMaxAgeMs"];
3
4
  const COUNT_KNOBS = ["keep", "maxEntries"];
4
5
  export function refuseRetentionPolicy(label, knob, value, requirement) {
5
- const e = new Error(`${label}: ${knob} must be ${requirement} (got ${typeof value === "string" ? JSON.stringify(value) : String(value)}) — a retention bound that cannot be evaluated silently decides what to delete instead of bounding it`);
6
+ const e = new Error(`${label}: ${knob} must be ${requirement} (got ${describeRejectedValue(value)}) — a retention bound that cannot be evaluated silently decides what to delete instead of bounding it`);
6
7
  e.code = "config.retention_policy_invalid";
7
8
  throw e;
8
9
  }