@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,6 +1,7 @@
1
1
  export class BackgroundShellError extends Error {
2
2
  code;
3
3
  cause;
4
+ refusedBy;
4
5
  constructor(code, message, cause) {
5
6
  super(message);
6
7
  this.code = code;
@@ -1,23 +1,48 @@
1
1
  /**
2
- * Two-phase prefix-cache-break detector (design/31). Each turn it records a structural fingerprint of
3
- * the prefix (system prompt / per-tool schema / tool set / model namespace) and compares the turn's
4
- * `cacheRead` against the prior warm turn; on a confirmed drop it attributes the break to a root cause
5
- * (model switch / a specific tool's drift / tool-set change / system-prefix change / server-or-TTL).
2
+ * The closed set of reasons a request's prefix may lawfully change (design/1393 §5.3). Five open a new
3
+ * epoch of the head; the sixth rewrites history without touching the head.
4
+ * - `leg_start_inputs` — a leg-start input of the head moved since the session's anchor (environment facts, memory
5
+ * tail, MCP instructions, the stable body, the tool table).
6
+ * - `tool_table` — the mounted tool table moved inside the leg (a deferred activation, a roster refresh, the
7
+ * per-request view).
8
+ * - `compaction` — a landed compaction: the history is replaced, and a center-prompt adoption moves the system.
9
+ * - `request_policy` — the request's controls moved (thinking level, output cap, retention word).
10
+ * - `model_namespace` — the serving model moved (a lane hop, a degrade switch): a different cache namespace.
11
+ * - `history_rewrite` — a request-time reducer rewrote earlier messages (a cleared tool result, a guard trim).
6
12
  *
7
- * The strict superset of the task-end "low hit-rate" heuristic: it pinpoints the BREAK TURN and names
8
- * the cause, instead of only reporting an aggregate at the end. Provider-agnostic — the only provider
9
- * input is `cacheRead` (OpenAI `cached_tokens` / Anthropic `cache_read_input_tokens`, already normalized).
10
- *
11
- * v1 is task-scoped (compares turns within one run; system/tools are stable so the high-value per-tool
12
- * attribution mostly fires on a model switch or across runs). A per-session v2 would feed a persisted
13
- * prior snapshot — the `observe` contract is already shaped for that.
13
+ * @contract prompt_cache.declaration.one_word — every in-leg change to a request's prefix is declared exactly
14
+ * once, by the seat that makes it, before the request that carries it goes out, with one word of this set; the
15
+ * detector reads the declarations only to say whether a change it located was expected, and never infers a
16
+ * reason from the change itself — a located change with no declaration is reported as undeclared.
14
17
  */
18
+ export declare const PREFIX_CHANGE_CAUSES: readonly ["leg_start_inputs", "tool_table", "compaction", "request_policy", "model_namespace", "history_rewrite"];
19
+ export type PrefixChangeCause = (typeof PREFIX_CHANGE_CAUSES)[number];
20
+ /** One declaration of a prefix change, made by the seat that changes the request. */
21
+ export interface PrefixChangeDeclaration {
22
+ cause: PrefixChangeCause;
23
+ /** `history_rewrite` only: the first message position the rewrite changed, when the reducer knows it. */
24
+ firstChangedIndex?: number;
25
+ /** `history_rewrite` only: the rewrite is a bounded deletion (clearing old tool results) — a drop it explains
26
+ * is not reported at all (the provider re-bills the cleared span once, by design). */
27
+ bounded?: true;
28
+ }
29
+ /** Where a located change sits in the request — `CacheBreakFinding["cause"]`; the order is the request's own
30
+ * (namespace, tools, system, controls, history), the residual last. */
31
+ export declare const CACHE_BREAK_CAUSES: readonly ["model-switch", "tool-schema", "tool-set", "system-prefix", "request-policy", "history-rewrite", "server-or-ttl"];
32
+ export type CacheBreakCause = (typeof CACHE_BREAK_CAUSES)[number];
15
33
  export interface CacheBreakFinding {
16
34
  turn: number;
17
35
  cacheReadBefore: number;
18
36
  cacheReadAfter: number;
19
- cause: "model-switch" | "tool-schema" | "tool-set" | "system-prefix" | "server-or-ttl";
37
+ /** Where the request changed (never why — the why is the declaration's word). */
38
+ cause: CacheBreakCause;
20
39
  detail: string;
40
+ /** The located change was declared before the request went out: a lawful epoch opening, not a defect.
41
+ * Absent on a located change ⇒ undeclared (a contract breach); never present on `server-or-ttl`. */
42
+ expected?: true;
43
+ /** The first changed position: the tool index for `tool-schema` / `tool-set`, the message index a
44
+ * `history-rewrite` declaration named. Absent when not known. */
45
+ firstChangedIndex?: number;
21
46
  }
22
47
  export interface ToolFingerprintInput {
23
48
  name: string;
@@ -29,6 +54,7 @@ export interface ToolFingerprintInput {
29
54
  * snapshot in `prepareTask` AND the per-materialization refresh in tool-disclosure (design/36): both
30
55
  * MUST derive the fingerprint the same way, or a deferred tool going placeholder→full schema would
31
56
  * be hashed inconsistently. Keep this the single source of "what counts as the cacheable tool prefix".
57
+ * The schema is the one the wire carries (`projectToolSchema`), so the prefix identity moves when those bytes do.
32
58
  */
33
59
  export declare function toolsToFingerprintInputs(tools: ReadonlyArray<{
34
60
  name: string;
@@ -37,20 +63,18 @@ export declare function toolsToFingerprintInputs(tools: ReadonlyArray<{
37
63
  }>): ToolFingerprintInput[];
38
64
  export declare class CacheBreakDetector {
39
65
  private prev;
66
+ /** The declarations made since the last observation; consumed by the next one (an observation that is skipped
67
+ * — an unknown row — consumes nothing, so a declaration is never lost while the baseline stays). */
68
+ private pending;
69
+ /** Record a declaration the next observation reads (see {@link PrefixChangeDeclaration}). */
70
+ declare(declaration: PrefixChangeDeclaration): void;
40
71
  /**
41
- * Reset the baseline. **Call ONLY after a SUCCESSFUL compaction** (design/31 red line #11): a legit
42
- * prefix shrink isn't a break, but resetting when compaction did NOT happen opens a false-negative
43
- * window (a real break right after would be missed).
44
- */
45
- notifyCompaction(): void;
46
- /**
47
- * Record this turn's fingerprint + compare cacheRead to the prior warm turn. Returns a finding on a
48
- * confirmed break. Hashes are computed here per call **by design**, taking the raw prefix rather than
49
- * pre-computed hashes. NOTE (design/36): the inputs are NOT necessarily stable within a run — deferred
50
- * tools materialize placeholder→full schema mid-task, so the caller refreshes the fingerprint at
51
- * materialization (via `toolsToFingerprintInputs`). A resulting `tool-schema`/`tool-set` finding on
52
- * that turn is EXPECTED and truthful (the cacheable prefix genuinely changed); the bug this guards
53
- * against is the opposite — a frozen fingerprint hiding that change (a false negative).
72
+ * Record this turn's fingerprint + compare it and its cacheRead to the prior observation. Returns a finding for
73
+ * an undeclared change (whether or not the cache dropped), or for a confirmed drop (expected when the located
74
+ * change was declared). Hashes are computed here per call **by design**, from the raw prefix. The inputs are NOT
75
+ * stable within a run — a deferred tool materializes placeholder→full schema mid-task, a compaction may adopt a
76
+ * new center prompt — and every such seat moves the fingerprint AND declares the change; the bug this guards
77
+ * against is a seat that moves one without the other.
54
78
  */
55
79
  observe(input: {
56
80
  turn: number;
@@ -1,5 +1,23 @@
1
+ import { projectToolSchema } from "../brain/tool-schema-projection.js";
2
+ export const PREFIX_CHANGE_CAUSES = Object.freeze([
3
+ "leg_start_inputs",
4
+ "tool_table",
5
+ "compaction",
6
+ "request_policy",
7
+ "model_namespace",
8
+ "history_rewrite",
9
+ ]);
10
+ export const CACHE_BREAK_CAUSES = Object.freeze([
11
+ "model-switch",
12
+ "tool-schema",
13
+ "tool-set",
14
+ "system-prefix",
15
+ "request-policy",
16
+ "history-rewrite",
17
+ "server-or-ttl",
18
+ ]);
1
19
  export function toolsToFingerprintInputs(tools) {
2
- return tools.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters }));
20
+ return tools.map((t) => ({ name: t.name, description: t.description, parameters: projectToolSchema(t.parameters) }));
3
21
  }
4
22
  const BREAK_REL = 0.05;
5
23
  const BREAK_ABS = 2000;
@@ -17,69 +35,106 @@ function stableStringify(v) {
17
35
  ? Object.fromEntries(Object.keys(val).sort().map((k) => [k, val[k]]))
18
36
  : val);
19
37
  }
38
+ function locateChanges(prev, snap) {
39
+ const out = [];
40
+ if (snap.modelKey !== prev.modelKey) {
41
+ out.push({ cause: "model-switch", detail: `model switched ${prev.modelKey} → ${snap.modelKey} (different cache namespace)`, declaredBy: "model_namespace" });
42
+ }
43
+ const drifted = snap.toolOrder.findIndex((name) => {
44
+ const p = prev.perToolHash.get(name);
45
+ return p !== undefined && p !== snap.perToolHash.get(name);
46
+ });
47
+ if (drifted >= 0) {
48
+ out.push({ cause: "tool-schema", detail: `tool "${snap.toolOrder[drifted]}" description/schema changed (drifting tool defs are the most common prefix breaker)`, firstChangedIndex: drifted, declaredBy: "tool_table" });
49
+ }
50
+ const firstMoved = firstDifference(prev.toolOrder, snap.toolOrder);
51
+ if (firstMoved !== undefined) {
52
+ const sameMembers = [...prev.toolOrder].sort().join(",") === [...snap.toolOrder].sort().join(",");
53
+ out.push({
54
+ cause: "tool-set",
55
+ detail: sameMembers
56
+ ? "the tool ORDER changed (same tools, different positions) — a reordered tool list is a byte-different prefix from the first moved tool onward, so the provider re-bills the whole tail"
57
+ : "the tool set changed (a tool was added or removed)",
58
+ firstChangedIndex: firstMoved,
59
+ declaredBy: "tool_table",
60
+ });
61
+ }
62
+ if (snap.systemHash !== prev.systemHash) {
63
+ out.push({ cause: "system-prefix", detail: "the system prompt prefix changed (volatile content placed up front?)", declaredBy: "compaction" });
64
+ }
65
+ return out;
66
+ }
67
+ function firstDifference(a, b) {
68
+ const n = Math.min(a.length, b.length);
69
+ for (let i = 0; i < n; i++)
70
+ if (a[i] !== b[i])
71
+ return i;
72
+ return a.length === b.length ? undefined : n;
73
+ }
20
74
  export class CacheBreakDetector {
21
75
  prev;
22
- notifyCompaction() {
23
- this.prev = undefined;
76
+ pending = [];
77
+ declare(declaration) {
78
+ this.pending.push(declaration);
24
79
  }
25
80
  observe(input) {
26
81
  const snap = {
27
82
  systemHash: fnv1a(input.systemPrompt),
28
83
  perToolHash: new Map(input.tools.map((t) => [t.name, fnv1a(`${t.name}\0${t.description}\0${stableStringify(t.parameters)}`)])),
29
- toolSetHash: fnv1a([...input.tools.map((t) => t.name)].sort().join(",")),
30
- toolOrderHash: fnv1a(input.tools.map((t) => t.name).join(",")),
84
+ toolOrder: input.tools.map((t) => t.name),
31
85
  modelKey: input.modelKey,
32
86
  cacheRead: input.cacheRead,
33
87
  at: Date.now(),
34
88
  };
35
89
  const prev = this.prev;
90
+ const declared = this.pending;
36
91
  this.prev = snap;
92
+ this.pending = [];
37
93
  if (!prev)
38
94
  return undefined;
39
95
  const before = prev.cacheRead;
40
96
  const after = input.cacheRead;
41
- if (before <= 0)
42
- return undefined;
97
+ const finding = (c, expected, suffix) => ({
98
+ turn: input.turn,
99
+ cacheReadBefore: before,
100
+ cacheReadAfter: after,
101
+ cause: c.cause,
102
+ detail: `${c.detail}${suffix}`,
103
+ ...(expected ? { expected: true } : {}),
104
+ ...(c.firstChangedIndex !== undefined ? { firstChangedIndex: c.firstChangedIndex } : {}),
105
+ });
106
+ const words = new Set(declared.map((d) => d.cause));
107
+ const located = locateChanges(prev, snap);
108
+ const undeclared = located.find((c) => !words.has(c.declaredBy));
109
+ if (undeclared !== undefined) {
110
+ return finding(undeclared, false, ` — no ${undeclared.declaredBy} declaration preceded this request (an undeclared prefix change)`);
111
+ }
43
112
  const drop = before - after;
44
- if (!(drop > BREAK_ABS && drop / before > BREAK_REL))
113
+ if (before <= 0 || !(drop > BREAK_ABS && drop / before > BREAK_REL))
45
114
  return undefined;
46
- let cause;
47
- let detail;
48
- if (snap.modelKey !== prev.modelKey) {
49
- cause = "model-switch";
50
- detail = `model switched ${prev.modelKey} → ${snap.modelKey} (different cache namespace)`;
115
+ if (located.length > 0)
116
+ return finding(located[0], true, ` — declared (${located[0].declaredBy})`);
117
+ if (words.has("request_policy")) {
118
+ return finding({ cause: "request-policy", detail: "the request's controls changed (thinking level / output cap / retention)" }, true, " — declared (request_policy)");
51
119
  }
52
- else {
53
- const changed = [...snap.perToolHash].find(([name, h]) => {
54
- const p = prev.perToolHash.get(name);
55
- return p !== undefined && p !== h;
56
- });
57
- if (changed) {
58
- cause = "tool-schema";
59
- detail = `tool "${changed[0]}" description/schema changed (drifting tool defs are the most common prefix breaker)`;
60
- }
61
- else if (snap.toolSetHash !== prev.toolSetHash) {
62
- cause = "tool-set";
63
- detail = "the tool set changed (a tool was added or removed)";
64
- }
65
- else if (snap.toolOrderHash !== prev.toolOrderHash) {
66
- cause = "tool-set";
67
- detail = "the tool ORDER changed (same tools, different positions) — a reordered tool list is a byte-different prefix from the first moved tool onward, so the provider re-bills the whole tail";
68
- }
69
- else if (snap.systemHash !== prev.systemHash) {
70
- cause = "system-prefix";
71
- detail = "the system prompt prefix changed (volatile content placed up front?)";
72
- }
73
- else {
74
- const gapMs = snap.at - prev.at;
75
- cause = "server-or-ttl";
76
- const checked = "nothing this detector fingerprints (system prefix, tool set + order, model)";
77
- detail =
78
- gapMs < SERVER_GAP_MS
79
- ? `${checked} changed and the gap was ${Math.round(gapMs / 1000)}s — most likely a server-side miss; the message history is not fingerprinted, so volatile content early in the conversation would also land here`
80
- : `${checked} changed and the gap was ${Math.round(gapMs / 60_000)}min — most likely a normal TTL expiry (cold cache)`;
81
- }
120
+ const rewrites = declared.filter((d) => d.cause === "history_rewrite" || d.cause === "compaction");
121
+ if (rewrites.length > 0) {
122
+ if (rewrites.every((d) => d.bounded === true))
123
+ return undefined;
124
+ const indices = rewrites.flatMap((d) => (d.firstChangedIndex !== undefined ? [d.firstChangedIndex] : []));
125
+ const word = rewrites.some((d) => d.cause === "compaction") ? "compaction" : "history_rewrite";
126
+ return finding({ cause: "history-rewrite", detail: "earlier messages were rewritten", ...(indices.length === rewrites.length ? { firstChangedIndex: Math.min(...indices) } : {}) }, true, ` — declared (${word})`);
82
127
  }
83
- return { turn: input.turn, cacheReadBefore: before, cacheReadAfter: after, cause, detail };
128
+ const gapMs = snap.at - prev.at;
129
+ const checked = "nothing this detector fingerprints (system prefix, tool set + order, model) changed, no rewrite was declared,";
130
+ return {
131
+ turn: input.turn,
132
+ cacheReadBefore: before,
133
+ cacheReadAfter: after,
134
+ cause: "server-or-ttl",
135
+ detail: gapMs < SERVER_GAP_MS
136
+ ? `${checked} and the gap was ${Math.round(gapMs / 1000)}s — most likely a server-side miss; the message history is not fingerprinted, so volatile content early in the conversation would also land here`
137
+ : `${checked} and the gap was ${Math.round(gapMs / 60_000)}min — most likely a normal TTL expiry (cold cache)`,
138
+ };
84
139
  }
85
140
  }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * THE one shape text the caller wrote takes in a judge's sentence: the redaction mark and its length, never the text. A value
3
+ * that is no string is named by its kind ({@link dataKind}). A caller's text can be anything a deployment put in the wrong
4
+ * field, a credential included, and the sentence travels to logs, panels and probes.
5
+ *
6
+ * Who wrote the text decides what a refusal (an error's message, a refused answer's reason, a tool result saying what was
7
+ * refused) says about it — five authors, one shape each:
8
+ * (a) the HOST or a DECLARER — a value or a key it wrote that is not the identity of what it declares: a member's value, a key
9
+ * it chose (a tool or skill name a per-tool table keys, a member the declaration does not have, a `_meta` key, a header or
10
+ * variable name a seat answered), a `RunnerDeps` or `TaskSpec` member, a setting, an environment value, a malformed list
11
+ * entry, a word outside a closed vocabulary. Shape: `callerText` — the mark and the length (a symbol: its description's).
12
+ * A refusal over a closed vocabulary lists the closed words (and may name the nearest one), never the word the caller wrote;
13
+ * (b) the IDENTITY of a declared entry — the name a declaration gives the server, peer, extension, device, agent or memory
14
+ * scope it declares, a principal, and, for an entry whose spelling is its only identity (a permission rule, a tool-list
15
+ * entry, a host pattern the floor holds), that spelling. The identity is published (the engine mints it into tool names,
16
+ * status rows and listings), so the sentence says whose: the single-line sanitized echo (`inlineUntrusted`). A listing of
17
+ * the identities a refusal could have meant (the mounted scopes, the roster) is that refusal's closed vocabulary;
18
+ * (c) the MODEL's own tool input, told back to the model it came from — a path, a command, a pattern, a URL: the sanitized
19
+ * echo, which is how the model learns what it sent;
20
+ * (d) a REMOTE party — a server's, a peer's, an adapter's, a store's or an execution environment's answer or error: its
21
+ * credentials erased first (the egress pass), then the sanitized echo — the diagnostic the person needs;
22
+ * (e) an operator LOG line or a notice's detail — the sanitized echo.
23
+ * Everything else a sentence says is the engine's own: where (the declaration's member names, a list index), why (the
24
+ * closed vocabulary, a kind, a count and its bound) and whose.
25
+ */
26
+ export declare function callerText(value: unknown): string;
27
+ /** The kind of a value, in the words a sentence uses for it: `null`, `undefined`, `an array`, `a record`, or `a <typeof>`. */
28
+ export declare function dataKind(value: unknown): string;
@@ -0,0 +1,12 @@
1
+ import { REDACTION_MARK } from "./redaction-marks.js";
2
+ export function callerText(value) {
3
+ if (typeof value === "symbol")
4
+ return `a symbol ${callerText(value.description ?? "")}`;
5
+ if (typeof value !== "string")
6
+ return dataKind(value);
7
+ const length = [...value].length;
8
+ return `${REDACTION_MARK} (${length} character${length === 1 ? "" : "s"})`;
9
+ }
10
+ export function dataKind(value) {
11
+ return value === null ? "null" : value === undefined ? "undefined" : Array.isArray(value) ? "an array" : typeof value === "object" ? "a record" : `a ${typeof value}`;
12
+ }
@@ -63,6 +63,11 @@ export declare const UNCANONICALIZABLE = "<uncanonicalizable>";
63
63
  * what the operator sees / the D-G signer signs.
64
64
  */
65
65
  export declare function boundInputHashOf(value: unknown): string;
66
+ /** The short digest the engine names an identity by: the first sixteen hex characters of the SHA-256 of `text`. The tool roster mints its
67
+ * capability identity and its own digest through it; {@link isSha16} is the one reading of the form it mints. */
68
+ export declare function sha16(text: string): string;
69
+ /** Does `value` read as a digest {@link sha16} mints — a string of exactly sixteen lowercase hex digits? */
70
+ export declare function isSha16(value: unknown): value is string;
66
71
  /**
67
72
  * THE digest an approval binds a CALL by: SHA-256 (hex) over the canonical form of the one record `{ tool, input }` — the tool's name as the
68
73
  * call spells it and the arguments in their JSON form ({@link capturedJsonOf}: a record member holding `undefined` absent), one
@@ -13,6 +13,13 @@ export const UNCANONICALIZABLE = "<uncanonicalizable>";
13
13
  export function boundInputHashOf(value) {
14
14
  return createHash("sha256").update(canonicalize(value), "utf8").digest("hex");
15
15
  }
16
+ export function sha16(text) {
17
+ return createHash("sha256").update(text).digest("hex").slice(0, 16);
18
+ }
19
+ const SHA16_SHAPE = /^[0-9a-f]{16}$/;
20
+ export function isSha16(value) {
21
+ return typeof value === "string" && SHA16_SHAPE.test(value);
22
+ }
16
23
  export function exactBoundInputHashOf(tool, input) {
17
24
  const captured = capturedJsonOf(input);
18
25
  if (!captured.ok)
@@ -138,7 +138,7 @@ export declare const FACE_CHECKPOINT_VERSION: 9;
138
138
  * `unsupported_version` (the row stays `pending`, retryable on a newer worker). */
139
139
  export declare const MAX_SUPPORTED_CHECKPOINT_VERSION: 10;
140
140
  /**
141
- * Read a checkpoint's schema version, defaulting an absent field to **legacy `0`** (a 1.67-era checkpoint
141
+ * Read a checkpoint's schema version, defaulting an absent field to **`0`** (the row of a 1.67-era checkpoint,
142
142
  * written before the field existed — it carries no `workspaceHandle`, so resuming it the v1 way is safe).
143
143
  * Compare with `<= MAX_SUPPORTED_CHECKPOINT_VERSION`, never `=== CURRENT_CHECKPOINT_VERSION` (design/49 §3).
144
144
  */
@@ -207,12 +207,22 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
207
207
  /** On `config.unknown_role` (a fresh run's terminal `detail.detail.reason`; on a resume, `detail.reason` of `checkpoint.config_refused` with `detail.code` `config.unknown_role`)
208
208
  * — a model binding or a role word the engine cannot read: a word the model catalog does not hold (`"unknown_model_ref"`), a value that is
209
209
  * no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a `modelRole` value (`"unknown_role_word"`) — or a task naming no model whose requested role and fallback chain supply none (`"no_model_for_role"`, `field` the requested role's seat). The sentence names the seat the refusal's `field` names (`roles.consolidate`, `tiers.pro`, `TaskSpec.model`). */
210
- | "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role";
210
+ | "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role"
211
+ /** On `resume.composition_mismatch` — the two arms of the one code: `"live_leg_contradicts_row"` (a resume handed a composition leg that
212
+ * differs from the one the row recorded: the composition's resume entry was handed another card's identity; the row stays pending,
213
+ * re-resume with the recorded value or none) and `"not_a_verifier_card"` (`Runner.voidVerifierPause` was handed a card whose recorded
214
+ * leg is not a verification gate's `verify` leg, or records none: nothing was settled, the row is as it was). */
215
+ | "live_leg_contradicts_row" | "not_a_verifier_card"
216
+ /** On `resume.agent_definition_mismatch` — the two arms of the one code, both pre-CAS with the row `pending`: `"live_lists_contradict_row"`
217
+ * (the delegation lane resolved the parked agent's name to a definition whose own tool lists digest differently from the lists the row
218
+ * recorded — another definition wears the name now) and `"row_records_no_lists"` (the delegation lane handed a live record but the row
219
+ * records no readable digest of its own lists — a row parked before the record existed, or one whose record cannot be read). */
220
+ | "live_lists_contradict_row" | "row_records_no_lists";
211
221
  /**
212
222
  * The codes a RESUME's pre-claim configuration screen carries as `detail.code` of a `checkpoint.config_refused` — the words prepare's
213
- * doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style,
223
+ * doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style, language,
214
224
  * approval-reach, invoked-skill, attachment, recorded-mode and tool-face doors (`config.spec_retired_key` … `config.tool_face_control`, the first
215
- * nine — `detail.reason` names the tool-face arm: {@link CheckpointErrorReason}), and every value door of the config-door phase over the
225
+ * ten — `detail.reason` names the tool-face arm: {@link CheckpointErrorReason}), and every value door of the config-door phase over the
216
226
  * re-supplied config and the deployment's deps (`configValueDoors`, the rest): the retired deps seats and caller-policy members
217
227
  * (`config.deps_retired_key`), the peer presence, the restore selector, the microCompact knob, the prompt selectors, `resumeAt` on a resume
218
228
  * (`resume_at.conflicts_resume`, `resume_at.mode_without_target` — a resume carrying `resumeAt` is refused as a conflict before its mode is
@@ -227,13 +237,32 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
227
237
  * The re-supplied config's one read (`readCallerSpec`, the read a run takes of its spec) refuses with its own two words, last in the set:
228
238
  * a member whose read throws (`config.spec_member_unreadable`) and a key the engine does not read (`config.spec_unknown_key`); its third,
229
239
  * a retired key, is `config.spec_retired_key` (first).
240
+ *
241
+ * A SUBSET of {@link CONFIG_REFUSAL_CODES}, the family's whole refusal vocabulary: the words a resume's screen can produce, held to that set at compile time.
230
242
  */
231
- export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
243
+ export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.language_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
232
244
  export type CheckpointConfigRefusalCode = (typeof CHECKPOINT_CONFIG_REFUSAL_CODES)[number];
233
245
  export declare const isCheckpointConfigRefusalCode: (word: unknown) => word is CheckpointConfigRefusalCode;
234
246
  /** The words of a {@link CheckpointError}'s optional `detail.field` (what each means: the `detail` member's doc). A CLOSED SET with one home, registered in
235
247
  * `docs/CLOSED-SETS.md`: a consumer holding a table over it is tsc-red on a new word until it places the word. */
236
248
  export type CheckpointErrorField = "boundCallId" | "boundInputHash" | "boundGrantDigest" | "answer" | "hostDecision" | "approver" | "feedback" | "outcome" | "updatedInput" | "decision" | "reason" | "taskConfig" | "deps" | "inheritedGate";
249
+ /**
250
+ * The words of a {@link CheckpointError}'s optional `detail.settler` — who settled the row when the deployment's `resumePreflight` ruled
251
+ * a resume PERMANENTLY blocked (its `terminal` verdict). The member is present on exactly those three arms of `resume.preflight_rejected`
252
+ * and absent on its retry-later arms (a deadline, a throw, an unreadable or plain refusal answer), so a host reads the settlement off the
253
+ * word instead of off the sentence. A CLOSED SET with one home, registered in `docs/CLOSED-SETS.md`: a consumer holding a table over it is
254
+ * tsc-red on a new word until it places the word.
255
+ *
256
+ * · `"this_refusal"` — this refusal's own single-shot expire settled the row (`expired`): the token is not redeemable;
257
+ * · `"concurrent_actor"` — the expire lost its race and the live row is no longer `pending`: another actor had already settled it, nothing was
258
+ * settled by this refusal, and the token is consumed;
259
+ * · `"nobody"` — the expire lost its race but the live row is `pending` again (a concurrent resolve / reopen cycle moved it): nothing was settled
260
+ * and the same token is redeemable once more — re-resume against the current state.
261
+ */
262
+ export type ResumePreflightSettler = "this_refusal" | "concurrent_actor" | "nobody";
263
+ /** The input a `checkpoint.config_refused` names in its `detail.field`: the re-supplied config, the deployment's deps, or the row's recorded gate. The three words of
264
+ * {@link CheckpointErrorField} that code carries; the one spelling of them for the resume's refusal channel (`asResumeConfigRefusal`) and the judge that asks it before the claim. */
265
+ export type ResumeConfigRefusalField = Extract<CheckpointErrorField, "taskConfig" | "deps" | "inheritedGate">;
237
266
  /** A typed checkpoint-store error so callers branch on `code` (mirrors `SessionError`). */
238
267
  export declare class CheckpointError extends Error {
239
268
  readonly code: "checkpoint.already_exists" | "checkpoint.already_resolved" | "checkpoint.not_found"
@@ -366,6 +395,12 @@ export declare class CheckpointError extends Error {
366
395
  * refusal exists to close. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the
367
396
  * original principal, or omit the field to inherit the recorded one. */
368
397
  | "resume.principal_mismatch"
398
+ /** The `resume.principal_mismatch` rung's twin on the partition: the resume config carries a NON-EMPTY `isolationScope` that
399
+ * differs from the {@link Checkpoint.isolationScope} recorded at the suspend mint. The isolation scope keys the resumed leg's
400
+ * working state (registry domain, offload namespace, scheduler, later parks), so running it in another one would move all of
401
+ * them. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the recorded value, or omit the field to inherit it.
402
+ * A row that records none (its partition was its principal) skips the check; `""` reads as absence on both sides. */
403
+ | "resume.isolation_scope_mismatch"
369
404
  /** design/380 O1③ (placement identity continuity — the `resume.principal_mismatch` rung's twin
370
405
  * on the placement axis): the resume supplied trusted internals whose EXPLICIT
371
406
  * `placementRoot` differs from the {@link CheckpointState.placementRootSessionId} recorded at
@@ -386,8 +421,18 @@ export declare class CheckpointError extends Error {
386
421
  * not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
387
422
  * re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
388
423
  * the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
389
- * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
424
+ * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
425
+ * The two arms are told apart by `detail.reason`: `live_leg_contradicts_row` / `not_a_verifier_card` ({@link CheckpointErrorReason}). */
390
426
  | "resume.composition_mismatch"
427
+ /** The own-lists twin of `resume.composition_mismatch`: the delegation lane handed trusted internals whose `ownToolLists`
428
+ * digest is not the {@link CheckpointState.ownToolLists} digest recorded at the suspend mint — the parked agent's name resolves
429
+ * now to a definition with other tool lists (a request's own definition parked under a name a built-in or deployment definition
430
+ * also carries), and continuing would run the leg on that definition's tool face. A live record beside a row that records no
431
+ * readable digest is refused too: the row cannot say which lists it ran under. Rejected PRE-CAS (the checkpoint stays `pending`);
432
+ * resume it where the name resolves to the definition it was parked under, or expire it. A resume that hands no live record (a
433
+ * host resume, a workflow leg) checks nothing. The two arms are told apart by `detail.reason`: `live_lists_contradict_row` /
434
+ * `row_records_no_lists` ({@link CheckpointErrorReason}). */
435
+ | "resume.agent_definition_mismatch"
391
436
  /** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
392
437
  * explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
393
438
  * answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
@@ -396,7 +441,9 @@ export declare class CheckpointError extends Error {
396
441
  * deployment's wait hint when it gave one — the #449 G1 carrier); the explicit `terminal` arm
397
442
  * has ALREADY settled the row out of `pending` via the single-shot `expire` CAS (reaper
398
443
  * parity) before this throw — the token is NOT redeemable, by the deployment's own permanent
399
- * verdict (a dead binding must not be redialed forever). */
444
+ * verdict (a dead binding must not be redialed forever). The permanent arm states who settled the row
445
+ * in `detail.settler` ({@link ResumePreflightSettler}: this refusal's expire, a concurrent actor, or nobody — the row
446
+ * moved and is `pending` again); the retry-later arm carries no `settler`. */
400
447
  | "resume.preflight_rejected"
401
448
  /** The resume carried a claim holder ({@link ResolveExpectation.holder}) and lost its CAS while the row is still the one it
402
449
  * validated — same scope, `pending`, the same generation — so the holder was not the deployment's current grant: nothing was
@@ -452,6 +499,9 @@ export declare class CheckpointError extends Error {
452
499
  * (`code` remains the only REQUIRED discriminant), which is exactly why the obligation to SPELL it
453
500
  * is a gate rather than a type: see the closed set's own doc. */
454
501
  reason?: CheckpointErrorReason;
502
+ /** On the permanent arms of `resume.preflight_rejected` (the deployment's `terminal` verdict) — who settled the row ({@link ResumePreflightSettler}).
503
+ * Absent on every retry-later arm of that code and on every other code. */
504
+ settler?: ResumePreflightSettler;
455
505
  /** On a `version_newer` refusal of a v10 row: the reader-requirement words the row lists that this worker lacks
456
506
  * (sorted, display only). Absent on every other arm. */
457
507
  requires?: readonly string[];
@@ -597,6 +647,12 @@ export declare class CheckpointError extends Error {
597
647
  * refusal exists to close. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the
598
648
  * original principal, or omit the field to inherit the recorded one. */
599
649
  | "resume.principal_mismatch"
650
+ /** The `resume.principal_mismatch` rung's twin on the partition: the resume config carries a NON-EMPTY `isolationScope` that
651
+ * differs from the {@link Checkpoint.isolationScope} recorded at the suspend mint. The isolation scope keys the resumed leg's
652
+ * working state (registry domain, offload namespace, scheduler, later parks), so running it in another one would move all of
653
+ * them. Rejected PRE-CAS (the checkpoint stays `pending`); re-resume with the recorded value, or omit the field to inherit it.
654
+ * A row that records none (its partition was its principal) skips the check; `""` reads as absence on both sides. */
655
+ | "resume.isolation_scope_mismatch"
600
656
  /** design/380 O1③ (placement identity continuity — the `resume.principal_mismatch` rung's twin
601
657
  * on the placement axis): the resume supplied trusted internals whose EXPLICIT
602
658
  * `placementRoot` differs from the {@link CheckpointState.placementRootSessionId} recorded at
@@ -617,8 +673,18 @@ export declare class CheckpointError extends Error {
617
673
  * not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
618
674
  * re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
619
675
  * the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
620
- * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
676
+ * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was.
677
+ * The two arms are told apart by `detail.reason`: `live_leg_contradicts_row` / `not_a_verifier_card` ({@link CheckpointErrorReason}). */
621
678
  | "resume.composition_mismatch"
679
+ /** The own-lists twin of `resume.composition_mismatch`: the delegation lane handed trusted internals whose `ownToolLists`
680
+ * digest is not the {@link CheckpointState.ownToolLists} digest recorded at the suspend mint — the parked agent's name resolves
681
+ * now to a definition with other tool lists (a request's own definition parked under a name a built-in or deployment definition
682
+ * also carries), and continuing would run the leg on that definition's tool face. A live record beside a row that records no
683
+ * readable digest is refused too: the row cannot say which lists it ran under. Rejected PRE-CAS (the checkpoint stays `pending`);
684
+ * resume it where the name resolves to the definition it was parked under, or expire it. A resume that hands no live record (a
685
+ * host resume, a workflow leg) checks nothing. The two arms are told apart by `detail.reason`: `live_lists_contradict_row` /
686
+ * `row_records_no_lists` ({@link CheckpointErrorReason}). */
687
+ | "resume.agent_definition_mismatch"
622
688
  /** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
623
689
  * explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
624
690
  * answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
@@ -627,7 +693,9 @@ export declare class CheckpointError extends Error {
627
693
  * deployment's wait hint when it gave one — the #449 G1 carrier); the explicit `terminal` arm
628
694
  * has ALREADY settled the row out of `pending` via the single-shot `expire` CAS (reaper
629
695
  * parity) before this throw — the token is NOT redeemable, by the deployment's own permanent
630
- * verdict (a dead binding must not be redialed forever). */
696
+ * verdict (a dead binding must not be redialed forever). The permanent arm states who settled the row
697
+ * in `detail.settler` ({@link ResumePreflightSettler}: this refusal's expire, a concurrent actor, or nobody — the row
698
+ * moved and is `pending` again); the retry-later arm carries no `settler`. */
631
699
  | "resume.preflight_rejected"
632
700
  /** The resume carried a claim holder ({@link ResolveExpectation.holder}) and lost its CAS while the row is still the one it
633
701
  * validated — same scope, `pending`, the same generation — so the holder was not the deployment's current grant: nothing was
@@ -683,6 +751,9 @@ export declare class CheckpointError extends Error {
683
751
  * (`code` remains the only REQUIRED discriminant), which is exactly why the obligation to SPELL it
684
752
  * is a gate rather than a type: see the closed set's own doc. */
685
753
  reason?: CheckpointErrorReason;
754
+ /** On the permanent arms of `resume.preflight_rejected` (the deployment's `terminal` verdict) — who settled the row ({@link ResumePreflightSettler}).
755
+ * Absent on every retry-later arm of that code and on every other code. */
756
+ settler?: ResumePreflightSettler;
686
757
  /** On a `version_newer` refusal of a v10 row: the reader-requirement words the row lists that this worker lacks
687
758
  * (sorted, display only). Absent on every other arm. */
688
759
  requires?: readonly string[];
@@ -73,7 +73,7 @@ export const MAX_SUPPORTED_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.requirements
73
73
  export function checkpointVersionOf(cp) {
74
74
  return cp.version ?? 0;
75
75
  }
76
- export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
76
+ export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.language_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
77
77
  export const isCheckpointConfigRefusalCode = (word) => CHECKPOINT_CONFIG_REFUSAL_CODES.some((w) => w === word);
78
78
  export class CheckpointError extends Error {
79
79
  code;
@@ -22,7 +22,14 @@ export declare function checkpointRevOf(cp: Pick<Checkpoint, "rev">): number;
22
22
  * 2-valued enum can ABA back to a prior value while the winner changed (round-2 BLOCKER fix). An absent
23
23
  * expectation opts out of the guard entirely.
24
24
  */
25
- export declare function checkpointOccMatches(cp: Checkpoint, expect?: ResolveExpectation): boolean;
25
+ export declare function checkpointOccMatches(cp: Checkpoint, expect?: Pick<ResolveExpectation, "rev">): boolean;
26
+ /**
27
+ * The generation a WON resolve gives the row it consumed: one above the generation the resolver read ({@link checkpointRevOf}), because
28
+ * every won resolve and every reopen bumps the counter by exactly one. It is the claimer's generation — the one value its compensation
29
+ * (`CheckpointStore.reopen`, `expect.rev`) carries so that only the claim that consumed the row can give it back: a delayed or foreign
30
+ * reopen finds a later generation (another resumer reopened and claimed again) and loses, instead of un-consuming a newer claim.
31
+ */
32
+ export declare function checkpointClaimRevOf(read: Pick<Checkpoint, "rev">): number;
26
33
  /**
27
34
  * The deployment's judge of a claim holder, handed to an in-tree store (`holderIsCurrent`): `true` while the grant `holder` names is
28
35
  * the current one, `false` once it is not. Exactly `true` is current; any answer that is not a boolean — a promise from an async judge
@@ -4,6 +4,9 @@ export function checkpointRevOf(cp) {
4
4
  export function checkpointOccMatches(cp, expect) {
5
5
  return expect === undefined || checkpointRevOf(cp) === expect.rev;
6
6
  }
7
+ export function checkpointClaimRevOf(read) {
8
+ return checkpointRevOf(read) + 1;
9
+ }
7
10
  export function checkpointHolderMatches(expect, holderIsCurrent) {
8
11
  if (expect?.holder === undefined)
9
12
  return true;