@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,10 +1,11 @@
1
- import { CheckpointError, type CheckpointErrorReason } from "./checkpoint-features.js";
1
+ import { CheckpointError, type CheckpointConfigRefusalCode, type CheckpointErrorField, type CheckpointErrorReason } from "./checkpoint-features.js";
2
2
  import type { GateOutcome, HostDecisionFacts } from "./gate-outcome.js";
3
3
  import { type ExecutionOutcomeRecordWord } from "./checkpoint-execution-record.js";
4
4
  import { type HolderJudge } from "./checkpoint-generation.js";
5
5
  import { type CheckpointPause } from "./pause-registry.js";
6
6
  import { type CheckpointDeleteGuard, type CheckpointOverdueCursor, type CheckpointOverdueQuery, type CheckpointPage, type CheckpointRowRead, type CheckpointSessionCursor, type CheckpointSessionQuery } from "./checkpoint-queries.js";
7
7
  import type { SystemInjectionPriority } from "./task-notification.js";
8
+ import { type SteerSource } from "./steer-replay.js";
8
9
  import type { QuestionAnswer } from "./ask-question.js";
9
10
  import type { ReadEntry } from "../tools/fs/safety.js";
10
11
  import type { RepairBundle } from "../agents/repair-loop.js";
@@ -14,6 +15,8 @@ import type { NestedUsageAccum, PermissionMode, ShellGateDoctrine, TaskResult }
14
15
  import type { ActiveWorktreeSession, AgentMessage } from "../internal/harness-types.js";
15
16
  import type { ReopenReason } from "./resume-startup-cause.js";
16
17
  import { type RetentionDeclaration } from "./retention.js";
18
+ import { MAX_PENDING_STEER_CHARS } from "./input-author.js";
19
+ export { MAX_PENDING_STEER_CHARS };
17
20
  export { BINDING_CHECKPOINT_VERSION, CHECKPOINT_CONFIG_REFUSAL_CODES, CHECKPOINT_FEATURES, CheckpointError, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, encodeAtFidelity, F012_CHECKPOINT_VERSION, FACE_CHECKPOINT_VERSION, isCheckpointConfigRefusalCode, isPlainRecord, MAX_SUPPORTED_CHECKPOINT_VERSION, normalizeProbeCause, ORG_ADMISSION_CHECKPOINT_VERSION, REAL_APPROVAL_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, safeDataValue, TOKEN_CHECKPOINT_VERSION, type CheckpointConfigRefusalCode, type CheckpointErrorField, type CheckpointErrorReason, type CheckpointFeature, type CheckpointFeatureRow, } from "./checkpoint-features.js";
18
21
  /**
19
22
  * design/45 — the **durable-checkpoint** primitive: cross-process / resumable `suspend`/`resume`.
@@ -70,19 +73,22 @@ export declare function mintCheckpointId(): string;
70
73
  *
71
74
  * **Consumers pinning the old closed set**: `"budget"` is gone — a switch on it now falls through.
72
75
  *
73
- * design/164 件四/件五 added two more members, and they are a DIFFERENT CLASS from the task axes above:
74
- * `"env_lifetime"` (the execution environment's platform lifetime is about to expire) and
75
- * `"usage_window"` (a deployment-level usage-governance window is exhausted) are EXTERNAL causes — the
76
- * task did not choose them and cannot avoid them by asking for less. They therefore suspend on the
77
- * INFRASTRUCTURE eligibility alone (checkpoint store + non-volatile offload + remote/no owned env),
78
- * without the `TaskSpec.resourceSuspend` opt-in the task axes require. When several causes land on one
79
- * turn boundary the attribution order is
80
- * `preempt > env_lifetime > usage_window > budget_tokens > budget_cost > turns > walltime`
81
- * (external causes above self-chosen allowances; preempt keeps the top seat it always had).
82
- * `"preempt"` is a scheduler's yield (`spec.preemptSignal`), not a limit, riding the same suspend: its resume continues the work.
76
+ * Three members are a DIFFERENT CLASS from the task axes above — the EXTERNAL causes ({@link PlatformLimitReason}):
77
+ * `"preempt"` (a scheduler's yield, `TaskSpec.preemptSignal` — not a limit, its resume continues the work),
78
+ * `"usage_window"` (a deployment-level usage-governance window is exhausted) and `"env_lifetime"` (the
79
+ * execution environment's platform lifetime is about to expire). The task did not choose them and cannot
80
+ * avoid them by asking for less, so they suspend on the INFRASTRUCTURE eligibility alone (checkpoint store +
81
+ * non-volatile offload + remote/no owned env), without the `TaskSpec.resourceSuspend` opt-in the task axes
82
+ * require. When several causes land on one turn boundary the attribution order is
83
+ * `preempt > usage_window > env_lifetime > budget_tokens > budget_cost > turns > walltime`
84
+ * (external causes above self-chosen allowances; an explicit scheduler decision above an inferred one; a
85
+ * window above a dying environment because only the window carries a wait the caller can act on).
86
+ * What each external cause falls back to when the suspend cannot be written differs, and is the turn
87
+ * boundary's one table: `preempt` continues the run and says so once (a yield is a request, not a stop),
88
+ * `usage_window` / `env_lifetime` stop it loudly with their own terminal codes.
83
89
  *
84
90
  * **Consumers pinning the closed set again**: a `switch` that was exhaustive over the five 5.x members
85
- * now falls through on these two.
91
+ * now falls through on `env_lifetime` / `usage_window`.
86
92
  */
87
93
  export type ResourceLimitReason = "budget_tokens" | "budget_cost" | "walltime" | "turns" | "preempt" | "env_lifetime" | "usage_window";
88
94
  /**
@@ -91,8 +97,12 @@ export type ResourceLimitReason = "budget_tokens" | "budget_cost" | "walltime" |
91
97
  * of the parent union so the two can never drift into disagreeing about what "external" means, and so a
92
98
  * seam that may only be reached by an external cause (the infrastructure-only suspend lane) cannot be
93
99
  * handed a task-axis reason by mistake.
100
+ *
101
+ * **Consumers pinning the closed set**: `"preempt"` joined (it used to suspend through the task-axis lane
102
+ * behind the `resourceSuspend` opt-in). It never yields a platform terminal code — its fallback is to keep
103
+ * running — so an exhaustive `switch` adds an arm that produces no stop.
94
104
  */
95
- export type PlatformLimitReason = Extract<ResourceLimitReason, "env_lifetime" | "usage_window">;
105
+ export type PlatformLimitReason = Extract<ResourceLimitReason, "preempt" | "usage_window" | "env_lifetime">;
96
106
  /**
97
107
  * design/80 D-2: which SAFETY axis of THIS call caused an `ask` to mint an {@link CheckpointGate}
98
108
  * `irreversible_ask`. Derived by the gate (`safetyAxisOf`) from the tool's static marks plus the engine's own
@@ -270,17 +280,6 @@ export declare function riskSeverity(axes: unknown): 1 | 2 | 3 | 4 | 5 | undefin
270
280
  * `tool_approval` pendingAction's `args` (`JSON.stringify`-ed). Caps the `listByScope` payload size; over-cap
271
281
  * is truncated with a trailing `…`. Bounded raw (NOT neutralized) — redaction is the consumer's job (echo-only). */
272
282
  export declare const MAX_TOOL_INPUT_PREVIEW_CHARS = 512;
273
- /**
274
- * HRD-APV-4: the char cap {@link validatePendingSteer} enforces on a parked operator steer — the last
275
- * persisted, model-facing string on a checkpoint row that had none.
276
- *
277
- * Sized as an INSTRUCTION budget, not a preview budget: the siblings above cap echo-only projections at
278
- * 200/512 chars, while a steer is prose a human wrote for the model to act on and is re-delivered on
279
- * every resume of the checkpoint. 16k chars (~4k tokens) holds any realistic operator instruction and
280
- * still bounds the durable row and the per-resume context cost. Exported so a BFF can validate before it
281
- * calls {@link CheckpointStore.setPendingSteer} rather than discovering the reject at persist time.
282
- */
283
- export declare const MAX_PENDING_STEER_CHARS = 16000;
284
283
  /**
285
284
  * design/171 §6.3 — the BYTE budget the whole parked-steer queue must fit inside, measured on its JSON
286
285
  * serialization (the form every backend actually persists).
@@ -304,7 +303,19 @@ export declare const MAX_PENDING_STEER_ENTRIES: number;
304
303
  * loud rejection instead of having its new field silently dropped on the parked leg. Consumers (other
305
304
  * repos' backends) read it to assert they round-trip every field rather than hand-listing their own copy.
306
305
  */
307
- export declare const PENDING_STEER_FROZEN_FIELDS: readonly ["text", "trusted", "actor", "seq", "inputId", "priority", "runOrigin"];
306
+ export declare const PENDING_STEER_FROZEN_FIELDS: readonly ["text", "trusted", "actor", "seq", "inputId", "priority", "runOrigin", "reply", "source"];
307
+ /**
308
+ * The answer a parked steer was already given (`prompt.submit`'s `{ reply }` to a `later` steer, before the pause took it):
309
+ * the resume lands it as a turn of its own — the input row, then this answer — instead of handing the input to a model, and
310
+ * does not screen it again. `text` is the answer, `by` the registration that gave it, `entered` the text the input entered as
311
+ * when the screen rewrote it (absent ⇒ the entry's own `text`). The engine writes it when a pause carries such a steer; the
312
+ * classic screen's `additionalContext` is not carried with it.
313
+ */
314
+ export interface PendingSteerReply {
315
+ text: string;
316
+ by: string;
317
+ entered?: string;
318
+ }
308
319
  /**
309
320
  * design/171 §6.1 — WHO a piece of human input came from, as an attribution label. ONE definition:
310
321
  * the shape lives at its layering-legal home (`engine/llm/types.ts`, where `UserMessage.actor`
@@ -341,6 +352,14 @@ export interface PendingSteerEntry {
341
352
  /** What brought this input, when its host says so ({@link import("./run-origin.js").RunOrigin}): its `human_input` frame
342
353
  * reports it, and the newest input a wake hands over states the woken leg's word with it. Attribution only; absent = the host said nothing. */
343
354
  runOrigin?: import("./run-origin.js").RunOrigin;
355
+ /** The answer this input was already given ({@link PendingSteerReply}): a resume lands such an entry as the answered `later`
356
+ * steer it was taken as — at the resumed leg's would-otherwise-stop seat, after the continuation's work — not inside the
357
+ * continuation that carries the queue's other entries. */
358
+ reply?: PendingSteerReply;
359
+ /** Who the sender says wrote it ({@link SteerSource}; absent reads as `"steer"`): a resume delivers a `"system"` entry as the
360
+ * sender's own text — no speaker label, no person's mid-turn frame — and names it `system` on its `human_input` frame and
361
+ * on the redelivery screen's `e.source`, as the live verb does. */
362
+ source?: SteerSource;
344
363
  }
345
364
  /** design/171 §6.3 — the caller-supplied half of a {@link PendingSteerEntry}: everything except `seq`,
346
365
  * which only the store may mint. `inputId` is optional on the way in (minted when absent). */
@@ -351,6 +370,11 @@ export interface PendingSteerInput {
351
370
  inputId?: string;
352
371
  priority?: SystemInjectionPriority;
353
372
  runOrigin?: import("./run-origin.js").RunOrigin;
373
+ /** Written by the engine's park of an answered steer ({@link PendingSteerReply}); a host relaying a caller's statement writes
374
+ * only the caller's own fields. */
375
+ reply?: PendingSteerReply;
376
+ /** Who the sender says wrote it ({@link SteerSource}), carried as the sender stated it; absent reads as `"steer"`. */
377
+ source?: SteerSource;
354
378
  }
355
379
  /**
356
380
  * design/80 §D-E: build the DETERMINISTIC, REDACTED {@link RiskDescriptor} for an escalation checkpoint at
@@ -375,7 +399,7 @@ export interface PendingSteerInput {
375
399
  * TWO SEATS ARE DELIBERATELY NOT IN THE FAMILY: `probeCause` and `probeReason` carry a documented
376
400
  * SAME-VALUE contract with their synchronous `AskRequest` twins (their docs say so verbatim), so
377
401
  * changing their bytes here alone would break that cross-face contract — they keep the shared
378
- * `inlineUntrusted`/`normalizeProbeCause` treatment (a residual their docs disclose). NEVER dumps full
402
+ * `inlineUntrusted`/`normalizeProbeCause` treatment their twins read, so both faces move together. NEVER dumps full
379
403
  * args / env / secrets — only a bash command string or a short `name=value` digest of the SHOWN args.
380
404
  *
381
405
  * `summary` for a shell gate = the `command` string (capped 200 cp); otherwise a `name=value` digest of the
@@ -745,6 +769,15 @@ export type PendingAction = {
745
769
  * THIS row's fidelity-projected args snapshot, so it can honestly differ from the synchronous
746
770
  * face on a shape-changing backend — exactly as {@link hasBidiControls} can. */
747
771
  previewWithheld?: "oversize" | "unavailable";
772
+ /** (additive; no checkpoint-version bump — the {@link previewWithheld} precedent above) — the PARK twin of
773
+ * `AskRequest.existingTarget`: what the write's target held for this ask — the live card's member when the live card
774
+ * read it (a card answered `unavailable`, then parked), else read by the parking run before it released its
775
+ * environment — under the live ask's one rule (present on every row of a tool whose roster row writes a file on the
776
+ * execution environment; `text` exactly when the model's own `Read` of the path would have been served). One read per
777
+ * ask. A SNAPSHOT as of the ask — the approved write may meet a changed file. NEVER read by the resume path (a resumed run
778
+ * does not read the target again) and not projected to the summary; the text is the target's own bytes, unredacted —
779
+ * a store or inbox that forwards it owns its redaction. */
780
+ existingTarget?: import("./existing-target.js").ExistingTarget;
748
781
  /** design/179 §4, re-formed by design/375 §3.1/§3.3 (BREAKING — replaces the retired
749
782
  * `ruleSuggestions` seat; a pre-375 inbox reading a new row simply finds no offers and renders
750
783
  * no "don't ask again" option, fail toward asking) — the persistable allow-rule OFFERS this
@@ -834,14 +867,27 @@ export type PendingAction = {
834
867
  * class exactly as a synchronous `onAsk` does. Written by the park mint only as a well-formed pair with
835
868
  * {@link classes} (both or neither). A row parked by an engine before this member existed reads ABSENT
836
869
  * (unclassified), and a resume does not fill it in: a seat answering by class treats absence as a class it will
837
- * not answer. Display / seat metadata — no gate, CAS or resume path reads it. */
870
+ * not answer. Display / seat metadata — no gate, CAS or resume path reads it (the resumed call reads {@link classes}). */
838
871
  askClass?: import("./ask-origin.js").AskClass;
839
872
  /** The PARK twin of `AskRequest.classes`: every class of the parked ask, in `ASK_CLASSES` order
840
- * (`classes[0] === askClass`). Present exactly when {@link askClass} is. */
873
+ * (`classes[0] === askClass`). Present exactly when {@link askClass} is. Read by the resumed call: on a PERSON's decide it
874
+ * is the class set of the question that person answered, and the obligations the call meets after the decide — the
875
+ * cross-boundary exit (`cross_boundary`), the org's and the PreToolUse hook's current question (`org_rule` / `hook`), an
876
+ * edit's re-check (its own classes) — stand on that answer only when this set carries their classes. A row without it
877
+ * answers none of them: an obligation it does not answer refuses the decide. A host store round-trips it with the row. */
841
878
  classes?: readonly import("./ask-origin.js").AskClass[];
842
879
  /** The PARK twin of `AskRequest.askReasons` (the synchronous card's value, through the park's one carry): written only as a
843
880
  * list of well-formed entries; a row parked before it reads ABSENT. Display metadata — no gate, CAS or resume path reads it. */
844
881
  askReasons?: readonly import("./ask-origin.js").AskReason[];
882
+ /** The PARK twin of `AskRequest.message` (the synchronous card's question, through the park's one carry): control
883
+ * characters neutralized and past 16KiB replaced by an account naming the size; a row parked before it reads ABSENT.
884
+ * **UNTRUSTED, ADVISORY** display metadata — no gate, CAS or resume path reads it. */
885
+ cardMessage?: string;
886
+ /** The PARK twin of `AskRequest.matchedAskRule` (off the same disclosure mint as {@link cardMessage}): the written ask rule
887
+ * this row's card stands for, as written; present only when the decision stamped a non-empty string. **UNTRUSTED**
888
+ * display metadata — no gate, CAS or resume path reads it. The card and the row spell the two values differently on
889
+ * purpose: a row member's name is read nowhere but at its own mint. */
890
+ cardAskRule?: string;
845
891
  /**
846
892
  * design/80 D-1 §2 (slice 1a.2): the server-minted **opaque** boundInputHash of {@link toolName} with {@link args} — a SHA-256 (hex)
847
893
  * via {@link import("./canonical-json.js").exactBoundInputHashOf}, computed ONCE here at suspend-mint and persisted on the row, which says
@@ -861,7 +907,7 @@ export type PendingAction = {
861
907
  * design/388 §2.5 boundary ② (B18; additive — no checkpoint-version bump, the `previewWithheld`
862
908
  * precedent: an optional group an older reader ignores): the IDENTITY of the row the park minted
863
909
  * this action against, read off the leg's tool roster at the suspend station — `capabilityId`
864
- * (engine-minted over {source, peer, name, contractId}), `contractId`, `shapeDigest`,
910
+ * (engine-minted over {source, peer, name, contractId, remote?}), `contractId`, `shapeDigest`,
865
911
  * `implementationRevision`. With the face below they are the TOOL member of the row's approval object
866
912
  * (`judgeApprovalObject`): an identity member that differs from the same-name row on the resuming leg is a replacement
867
913
  * wearing the name (`resume.tool_contract_mismatch`, a reopen); a face or declaration that differs vetoes the call
@@ -914,7 +960,8 @@ export type PendingAction = {
914
960
  *
915
961
  * - JUDGED AT THE PARK MINT over THIS ROW's materialized payload: the fidelity-projected `args`
916
962
  * snapshot (the bytes a human approves and a resume executes) plus the row's own `preview`
917
- * projection. The row's bit describes the row's bytes — on a shape-narrowing backend (a Map key
963
+ * projection and the row's `existingTarget` — the one card scan the synchronous face runs
964
+ * ({@link import("./tool-policy.js").cardCarriesBidiControls}). The row's bit describes the row's bytes — on a shape-narrowing backend (a Map key
918
965
  * under a JSON codec) a marker the synchronous face detected can be GONE from the row, and the
919
966
  * honest bit for the row is then ABSENT: the inbox renders the row's snapshot, and the bit
920
967
  * agrees with what it renders. The two faces coincide whenever the projection is shape-preserving.
@@ -1631,8 +1678,25 @@ export interface CheckpointRow {
1631
1678
  token: CheckpointToken;
1632
1679
  /** Non-secret stable identity ({@link mintCheckpointId}) — the display/correlation twin of
1633
1680
  * the secret `token` (identification vs capability, separate axes). Present on every row minted
1634
- * since its introduction; absent ⇒ legacy row (read compatibly, no backfill). */
1681
+ * since its introduction; absent ⇒ legacy row (read compatibly, no backfill). It is the row's one question identity, and the
1682
+ * join key to the card the row came from: the card's `AskRequest.checkpointId` is this value exactly when the approver answered
1683
+ * `"unavailable"` and the row parks the bytes that answer was bound to (otherwise the row mints its own, {@link import("./runner/deferred-ask.js").parkedAskIdentity}). */
1635
1684
  checkpointId?: string;
1685
+ /** THE SYNCHRONOUS-CHILD BLOCK — four members ({@link parentSessionId}, {@link parentTaskId}, {@link rootSessionId}, {@link rootSessionIncarnation}),
1686
+ * written by ONE predicate at ONE mint ({@link import("./leg-identity.js").syncChildBlockOf}) onto every row a synchronous child parks, and
1687
+ * absent from a root run's row, a background agent's, a workflow agent's and a row an earlier engine parked. They name where the parked leg
1688
+ * came from, in the spelling of the run internals they are read from. ECHO-ONLY: no gate / CAS / resume path decides on them.
1689
+ * The session the parked leg was spawned by ({@link import("./runner/contracts.js").RunInternals.parentSessionId}). */
1690
+ parentSessionId?: string;
1691
+ /** The task the parked leg's parent ran as, ONLY when the leg is a synchronous child ({@link import("./contracts.js").RunInternals.parentTaskId}) —
1692
+ * written beside {@link parentSessionId}, from the same leg facts. */
1693
+ parentTaskId?: string;
1694
+ /** The ROOT host session of the leg's delegation tree ({@link import("./runner/contracts.js").RunInternals.rootSessionId}) — the anchor a
1695
+ * consumer addresses the tree's owner by when the immediate parent is no longer running. Part of the block ({@link parentSessionId}). */
1696
+ rootSessionId?: string;
1697
+ /** The occupant of {@link rootSessionId}'s row as the tree's root run acquired it ({@link import("./runner/contracts.js").RunInternals.rootSessionIncarnation}) —
1698
+ * the other half of the root anchor's address. Part of the block; absent when the root run recorded none. */
1699
+ rootSessionIncarnation?: string;
1636
1700
  /**
1637
1701
  * Schema version of this checkpoint (design/49 v1.5), FROZEN at the `requirements` row's 10: every live mint
1638
1702
  * stamps 10 beside {@link requires}, and a segment added later adds a word there, never a number here. A v≤9 row
@@ -1714,8 +1778,10 @@ export interface CheckpointRow {
1714
1778
  * carried forward across resume→re-suspend (like {@link suspendCount} / {@link resourceLedger}) so a
1715
1779
  * multi-leg suspend/resume chain reports the WHOLE human-review burden, not just the last leg's. It holds
1716
1780
  * the gates resolved up to and including the suspend BEFORE this one — the latency for THIS suspend is added
1717
- * by the resume that wakes it (`now() − suspendedAt`). Absent ⇒ no prior human-review time (a first suspend
1718
- * with no earlier synchronous asks). Budget-EXCLUDED side observable — never a cost/gate input.
1781
+ * by the resume that wakes it (`now() − suspendedAt`). Every row the engine mints carries it, `count: 0` on a
1782
+ * chain no gate waited on a person in yet ({@link import("./task-result.js").TaskResult.stats}`.humanReview`, one
1783
+ * shape); absent only on a row an older engine minted, which a resume reads as zero. Budget-EXCLUDED side
1784
+ * observable — never a cost/gate input.
1719
1785
  */
1720
1786
  humanReview?: {
1721
1787
  count: number;
@@ -1740,10 +1806,12 @@ export interface CheckpointRow {
1740
1806
  */
1741
1807
  reopenReason?: ReopenReason;
1742
1808
  /**
1743
- * design/80 D-1 (atomicity fix, round-2 BLOCKER): a **monotonic revision counter** bumped by EVERY
1809
+ * design/80 D-1 (atomicity fix, round-2 BLOCKER): a **monotonic revision counter** bumped by exactly one by EVERY
1744
1810
  * {@link CheckpointStore.resolve} (won) and {@link CheckpointStore.reopen}. It is the optimistic-concurrency
1745
1811
  * key ({@link ResolveExpectation}): a resume reads it at `get()` and `resolve` requires the live `rev` to
1746
- * still equal it, so any resolve/reopen cycle landing in the get→resolve window loses the CAS (fail-closed).
1812
+ * still equal it, so any resolve/reopen cycle landing in the get→resolve window loses the CAS (fail-closed). The claim's
1813
+ * compensation reads the same key: the generation a won resolve produced is one above the one it read
1814
+ * (`checkpointClaimRevOf`), and `reopen` carrying it gives back only that claim's row.
1747
1815
  * Unlike the 2-valued `reopenReason`, it cannot ABA back to a prior value. Absent ⇒ legacy `0` (a checkpoint
1748
1816
  * minted before this field; treated as never mutated) — read it through {@link checkpointRevOf}.
1749
1817
  */
@@ -1762,7 +1830,7 @@ export interface CheckpointRow {
1762
1830
  * so this is NOT a global "never forgeable" run id — aggregation only aggregates delegated workers, where it
1763
1831
  * holds. **ECHO-ONLY triage metadata, NEVER a gate input:** no gate / CAS / winner / resume-validation path
1764
1832
  * reads it (a contract-test pins this). A row that carries it requires `source_session` (an older engine
1765
- * refuses it). Absent ⇒ a non-ask gate, or a row an earlier engine parked (it named the member `sourceTaskId`).
1833
+ * refuses it). Present exactly on an ask-origin row (`tool_approval` / `plan_review`), stamped since 7.61.0; absent on a non-ask gate (`resource_limit` / `needs_review` / `task_done`: no ask is behind them, the engine's `resource_limit` mint stamps none) and on a row an earlier engine parked (it named the member `sourceTaskId`); a consumer reads it on an ask-origin row only (INTEGRATION-CORE §1.6a).
1766
1834
  */
1767
1835
  sourceSessionId?: string;
1768
1836
  /**
@@ -1784,6 +1852,19 @@ export interface CheckpointRow {
1784
1852
  * guard's window form and add its own presence invariant — a lattice-wide change, not a stamp.
1785
1853
  */
1786
1854
  principal?: string;
1855
+ /**
1856
+ * The issuing task's {@link import("./types.js").TaskSpec.isolationScope} — the partition of the person's work this
1857
+ * row is working state of — stamped beside {@link principal} at the same mints, and only when it is present and
1858
+ * differs from the principal (a row without it reads its partition as its principal, so the common shape records
1859
+ * nothing new). Like `principal` it is never a gate / CAS / winner input; the RESUME ENTRY reads it the same way:
1860
+ * a resume config that omits `isolationScope` inherits this value, and one carrying a DIFFERENT non-empty value is
1861
+ * refused pre-CAS (`resume.isolation_scope_mismatch`). Unlike `principal` it IS gated: the row's requirement words
1862
+ * name it (`isolation_scope`), so a worker that cannot read the member refuses the row instead of resuming it in the
1863
+ * person's bucket. A member holding `undefined` is no member: the stamp writes the row without the key, the row judge
1864
+ * and both resume readers read the VALUE, and a store of JSON fidelity (the file twin) never holds the key — no reader
1865
+ * tells "written as undefined" from "absent".
1866
+ */
1867
+ isolationScope?: string;
1787
1868
  /**
1788
1869
  * design/153 §7.4 (1.389.0, RB-42②③): the VERBATIM `TaskSpec.durableApproval` opt-in in force at this
1789
1870
  * APPROVAL suspend's mint — the engine-recorded provenance of "this task was durable-approval armed, with
@@ -1858,7 +1939,11 @@ export interface CheckpointIndexFacts {
1858
1939
  readonly hasBidiControls: true | null;
1859
1940
  }
1860
1941
  /** Derive a row's {@link CheckpointIndexFacts}. Pure: reads no clock, writes nothing; the approval card is read
1861
- * through {@link parkedApprovalCardOf} (the one card reading), the tool fields only off a `tool_approval` action. */
1942
+ * through {@link parkedApprovalCardOf} (the one card reading), the tool fields only off a `tool_approval` action.
1943
+ * Refuses (`config.invalid_argument`, naming the member) a row whose `gate` or `pendingAction` is not an object of plain data —
1944
+ * absent, `null`, a scalar, a list, or a record that is an accessor, a Proxy or of another prototype — instead of throwing a bare
1945
+ * `TypeError` from one read or deriving columns from a scalar's missing members; a gate or pending action of a kind this engine does
1946
+ * not know is still derived (its words are kept for a later engine to read). */
1862
1947
  export declare function checkpointIndexFacts(cp: Checkpoint): CheckpointIndexFacts;
1863
1948
  /**
1864
1949
  * The ONE reading of {@link PendingAction} `plan_review.requestedByCallId` — the id of the call that asked for a plan
@@ -1878,6 +1963,11 @@ export declare function planReviewRequesterOf(pendingAction: PendingAction): str
1878
1963
  * eight, never the row's token).
1879
1964
  * - `damaged`: this engine does not resume these bytes; `code` / `reason` are the resume's refusal, `sentence` its fixed
1880
1965
  * engine sentence (the resume's error `message` starts with it and goes on with the row's own diagnostic).
1966
+ * `field` and `blockedBy` are the refusal's own `detail.field` and `detail.code` (the verdict's `code` is the error's), same words, same
1967
+ * types, present exactly when the refusal states them: the recorded-word arms (a row whose `inheritedGate`, run origin or frozen tool
1968
+ * names this engine does not read: `checkpoint.config_refused`, `field` `"inheritedGate"`, `blockedBy` the word a fresh run of the same
1969
+ * bad value reports — `config.permission_mode_invalid`, `config.run_origin_invalid` or `config.tool_face_control`). Every other arm —
1970
+ * named by its `reason`, or by its `code` where it has none — omits both.
1881
1971
  * A consumer that meets a `kind` it does not know reads it as not `ok`.
1882
1972
  */
1883
1973
  export type CheckpointRowVerdict = {
@@ -1886,6 +1976,8 @@ export type CheckpointRowVerdict = {
1886
1976
  readonly kind: "lacking" | "damaged";
1887
1977
  readonly code: CheckpointError["code"];
1888
1978
  readonly reason?: CheckpointErrorReason;
1979
+ readonly field?: CheckpointErrorField;
1980
+ readonly blockedBy?: CheckpointConfigRefusalCode;
1889
1981
  readonly requires?: readonly string[];
1890
1982
  readonly sentence: string;
1891
1983
  };
@@ -1911,6 +2003,13 @@ export interface CheckpointSummary {
1911
2003
  rowVerdict: CheckpointRowVerdict;
1912
2004
  /** Non-secret stable identity ({@link Checkpoint.checkpointId}) — absent on legacy rows. */
1913
2005
  checkpointId?: string;
2006
+ /** The synchronous-child block of the row ({@link Checkpoint.parentSessionId} and its three companions): the session and task that spawned
2007
+ * the parked leg and the delegation tree's root session with its occupant — each OMITTED when the row records none (a root run's,
2008
+ * a background agent's or a workflow agent's row, a row an earlier engine parked). */
2009
+ parentSessionId?: string;
2010
+ parentTaskId?: string;
2011
+ rootSessionId?: string;
2012
+ rootSessionIncarnation?: string;
1914
2013
  /** The suspended task / session id ({@link Checkpoint.sessionId}). */
1915
2014
  sessionId: string;
1916
2015
  /** The multi-tenant scope this checkpoint lives in ({@link Checkpoint.scope}) — always equal to the query's. */
@@ -1935,7 +2034,7 @@ export interface CheckpointSummary {
1935
2034
  deadline?: number;
1936
2035
  /** design S1d (source-tag): the issuing worker's session id ({@link Checkpoint.sourceSessionId}) — projected so
1937
2036
  * a supervisor inbox attributes each pending checkpoint to its worker in ONE `listByScope` call (no N+1
1938
- * `getCheckpoint`). ECHO-ONLY display/triage; absent on a non-ask gate and on a row an earlier engine parked. */
2037
+ * `getCheckpoint`). ECHO-ONLY display/triage; present exactly on an ask-origin row (`tool_approval` / `plan_review`), absent on a non-ask gate and on a row an earlier engine parked ({@link Checkpoint.sourceSessionId}). */
1939
2038
  sourceSessionId?: string;
1940
2039
  /** The parked leg's agent id when it is a delegated child (the parked twin of {@link import("./tool-policy.js").AskRequest}.agentId),
1941
2040
  * derived from the row by the live ask's predicate — nothing more is stored: its registry row ({@link CheckpointState.rowTaskId}) when
@@ -2062,6 +2161,14 @@ export interface CheckpointSummary {
2062
2161
  * value is a member of the closed set ({@link import("./ask-origin.js").isAskOrigin}) — a bad value
2063
2162
  * reads as absent, never as a word. OMITTED when the row carries none (a pre-existing row). */
2064
2163
  origin?: import("./ask-origin.js").AskOrigin;
2164
+ /** The row's `PendingAction.tool_approval.askReasons` (the live card's entries: who asked, in its own words), for the same one-call
2165
+ * reason — present ⇔ the row carries a list of well-formed entries ({@link import("./ask-origin.js").receiveAskReasons}: one malformed
2166
+ * entry publishes none), a fresh copy; OMITTED otherwise. **UNTRUSTED** display text; ECHO-ONLY. */
2167
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
2168
+ /** The row's `PendingAction.tool_approval.cardMessage` (the card's question as the row keeps it), for the same one-call reason —
2169
+ * present ⇔ the row holds a non-empty string, read through the screen the row's mint takes ({@link approvalMessageOf}); OMITTED
2170
+ * otherwise. **UNTRUSTED, ADVISORY** display text; ECHO-ONLY. */
2171
+ cardMessage?: string;
2065
2172
  /** What opened the leg that parked this row — the row's `state.runOrigin` (`"scheduled"`: the deployment's scheduler, not a
2066
2173
  * person submitting just now), for every gate kind, so an inbox shows it in the one listing call. Echoed only as a member of
2067
2174
  * {@link import("./run-origin.js").RUN_ORIGINS} (the resume's screen refuses any other value loudly; this projection never
@@ -2311,8 +2418,16 @@ export interface CheckpointStore {
2311
2418
  * file — see {@link CheckpointRow.executionOutcome} — and reopening it would either re-run an action that
2312
2419
  * already ran or re-decide one already refused. Answers `false` like every other predicate miss; the
2313
2420
  * reasons and the winner are untouched.
2421
+ *
2422
+ * **Only the claimer's generation is reopened ({@link ResolveExpectation.rev}, the claim's inverse):** a caller that passes `expect`
2423
+ * gets the row back only if its live `rev` still equals `expect.rev` — the generation its own won resolve produced (one above the
2424
+ * one it read, `checkpointClaimRevOf`) — judged in the SAME atomic step as the flip, by the same predicate the resolve's OCC arm
2425
+ * reads (`checkpointOccMatches`). Any resolve or reopen since then moved the counter, so a delayed or foreign reopen finds a
2426
+ * generation that is not its claim's and answers `false` with the row untouched (it never un-consumes a newer resumer's claim).
2427
+ * Omit `expect` (a direct store caller) → no generation precondition, as before. A store that does not judge it reopens whatever
2428
+ * generation it holds; the kit's reopen case holds every backend to the judgement.
2314
2429
  */
2315
- reopen(token: CheckpointToken, scope: string, reason: ReopenReason): Promise<boolean>;
2430
+ reopen(token: CheckpointToken, scope: string, reason: ReopenReason, expect?: Pick<ResolveExpectation, "rev">): Promise<boolean>;
2316
2431
  /**
2317
2432
  * Record how the DECIDED action was finally disposed on the resumed leg — the {@link GateOutcome} its
2318
2433
  * `tool_end` frame carried (see {@link CheckpointRow.executionOutcome} for what the record means and why
@@ -2503,6 +2618,14 @@ export interface CheckpointStore {
2503
2618
  /** Delete the checkpoint rows of one session that exist when the call starts, in any status, when the guard admits it
2504
2619
  * ({@link CheckpointDeleteGuard}); answers the count. Present exactly when the store can judge the guard (a session head read). */
2505
2620
  deleteSessionCheckpoints?(sessionId: string, guard: CheckpointDeleteGuard): Promise<number>;
2621
+ /**
2622
+ * The operator's delete of the checkpoint rows of one session whose head cannot be read: the rows that exist when the call starts,
2623
+ * in any status, deleted exactly when the session head read is refused `corrupt_session` (a readable head or no head answers 0 and
2624
+ * deletes nothing; any other fault of the read rejects and deletes nothing). Never an owner's request and never called by an automatic
2625
+ * path; placement is not read. Runs before the session store's `deleteUnreadable` of the same id, which removes the head it judged.
2626
+ * A session id that is not a non-empty string is refused (`config.invalid_argument`). Present exactly when `deleteSessionCheckpoints` is.
2627
+ */
2628
+ deleteUnreadableSessionCheckpoints?(sessionId: string): Promise<number>;
2506
2629
  }
2507
2630
  /**
2508
2631
  * The SINGLE resolution of "which CheckpointStore does this run use" (ruled 2026-08-04; re-homed
@@ -2649,9 +2772,11 @@ export declare class InMemoryCheckpointStore implements CheckpointStore {
2649
2772
  private readonly disclose;
2650
2773
  private readonly holderIsCurrent;
2651
2774
  readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
2775
+ readonly deleteUnreadableSessionCheckpoints?: (sessionId: string) => Promise<number>;
2652
2776
  /** `disclose` is the listing projections' own seat ({@link summarizeCheckpoint}'s and the listing faces'): this store has no
2653
2777
  * path, so it forwards each sentence for a row read past a damage, called synchronously by the listing that read it.
2654
- * `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by; `holderIsCurrent` ({@link HolderJudge}), a resolve's `expect.holder`. */
2778
+ * `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by, and what
2779
+ * {@link CheckpointStore.deleteUnreadableSessionCheckpoints} judges unreadability by; `holderIsCurrent` ({@link HolderJudge}), a resolve's `expect.holder`. */
2655
2780
  constructor(options?: {
2656
2781
  disclose?: (sentence: string) => void;
2657
2782
  sessionHeadOf?: (sessionId: string) => Promise<{
@@ -2711,7 +2836,7 @@ export declare class InMemoryCheckpointStore implements CheckpointStore {
2711
2836
  * cleanly: the consumer's presence probe then keeps the two-step path, hooks intact.) */
2712
2837
  claimTerminal(token: CheckpointToken, scope: string, intent: TerminalClaimIntent): Promise<TerminalClaimOutcome>;
2713
2838
  recordExecutionOutcome(token: CheckpointToken, scope: string, gate: GateOutcome): Promise<ExecutionOutcomeRecordWord>;
2714
- reopen(token: CheckpointToken, scope: string, reason: ReopenReason): Promise<boolean>;
2839
+ reopen(token: CheckpointToken, scope: string, reason: ReopenReason, expect?: Pick<ResolveExpectation, "rev">): Promise<boolean>;
2715
2840
  setPendingSteer(token: CheckpointToken, scope: string, steer: PendingSteerInput): Promise<boolean>;
2716
2841
  expire(token: CheckpointToken, scope: string): Promise<boolean>;
2717
2842
  reap(scope: string, cutoff: number): Promise<number>;