@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
@@ -73,6 +73,20 @@ export interface EngineNotice {
73
73
  * answered `{ refuse }` on `plugin.register`, or failed while judging it (fail-closed). The run goes on without it.
74
74
  * Audience `user` (the seat is in `detail`). Once per refused registration per run. `detail: { name, seat, tier,
75
75
  * provenance?, refusedBy, reason, sessionId }` (`seat` ∈ `deployment` / `task`; `provenance` as the host gave it, absent when none).
76
+ * - `"mods.display_withheld"` — an answer for a window of an assistant message's display did not stand: its `classic.MessageDisplay`
77
+ * handler threw, answered a form the station cannot take, or the window was not answered within its own 10 s (counted from when
78
+ * its text settled, a dispatch slot's wait included). The handler is skipped (the ones below it answer in its place) and the window
79
+ * shows what the answers that stood left of it (a deadline skips every handler not yet answered) — the model's text when none did; the stored message and the model's view are
80
+ * unchanged. Audience `user`. Once per failing handler per window, said when the window is released. `detail: { messageId, turn, index, final, cause, registration?,
81
+ * sessionId }` (`cause` ∈ `threw` / `timeout` / `violation` / `reentry` / `deadline` / `fault`; `registration` names the failing
82
+ * extension, absent on `deadline` (the window's time ran out) and on `fault` (the engine's own failure to raise it)). A caller's stop says nothing.
83
+ * - `"mods.stop_ended"` — a `classic.Stop` / `classic.SubagentStop` answer carrying `end` closed the stop point: the run was not pushed
84
+ * back there (the answer's `block` and contexts, and the other seat's, were not fed to the model; the model is not told). It closes
85
+ * that stop point only — a one-shot submission still waits for what its lane is owed, and a later stop point asks again. Audience
86
+ * `user`. Once per stop point it closed. `detail: { event, registration, seat, reason?, sessionId, sourceSessionId?, agentId?, runId }`
87
+ * (`event` ∈ `classic.Stop` / `classic.SubagentStop`; `registration` the extension whose handler's answer carried `end` — an answer no
88
+ * registration produced carries none; `seat` ∈ `deployment` / `task`; `reason` the `end` text, bounded, absent when blank; the address
89
+ * keys are the leg notice's: a delegated leg's notice goes to its tree's root session and names the leg). A cancelled run says nothing.
76
90
  * - `"skills.listing_truncated"` — the `<skills>` disclosure block did not fit its byte budget, so
77
91
  * at least one skill is listed without its description (`nameOnly`) or, in the pathological case,
78
92
  * not listed at all (`dropped`); the `Skill` tool still serves every one of them. Audience
@@ -99,10 +113,18 @@ export interface EngineNotice {
99
113
  * an MCP server, a host tool, an engine tool or a `tool_result` hook's replacement) whose bytes the tool-result
100
114
  * seat's admission refused: not a base64 payload, a media type outside the closed set, over the cap, bytes
101
115
  * without the claimed type's signature, or bytes no processor could bring within the reject edge (or whose header
102
- * states no size). Each such block already stands in the result as a text placeholder naming
103
- * the tool and the refusal (never the bytes), so the model, `tool_end.output` and the transcript read that; this is
104
- * the operator's account. ONCE PER CALL. `detail: { toolName, toolCallId, refused: [{ type, reason, bytes, limit?,
105
- * width?, height?, mimeType? }], sessionId, runId }` — closed-set words, counts and a media type only when it can be one.
116
+ * states no size). Each such block already stands in the result as a text placeholder naming the tool and the refusal
117
+ * (never the bytes), so the model, `tool_end.output` and the transcript read that; this is the operator's account. A
118
+ * block refused for its SIZE (`raw_too_large`, `dimensions_too_large`, `base64_too_large`) has its bytes kept in the
119
+ * run's tool-result store and its placeholder names the `ref`, or why they were not kept (`notKept`: `no_byte_store` |
120
+ * `over_limit` | `store_failed`; the store's error text in `saveError`, this account only). ONCE PER CALL.
121
+ * `detail: { toolName, toolCallId, refused: [{ type, reason, bytes, limit?, width?, height?, mimeType?, ref?, notKept?,
122
+ * saveError? }], sessionId, runId }` — closed-set words, counts, a media type only when it can be one (≤ 100 characters).
123
+ * - `"tool_result.media_persisted"` — an MCP tool call or resource read whose server sent binary content that is not
124
+ * media the model reads (an audio block, a resource blob of a type outside the admission's image and document sets):
125
+ * its bytes were kept in the run's tool-result store and the result carries a line naming each one's ref in place of
126
+ * the bytes (or why it was not kept). ONCE PER CALL (or read). `detail: { server, toolName, toolCallId, kept: [{ bytes,
127
+ * mimeType?, ref | notKept (+ saveError) }], sessionId, runId }`.
106
128
  * - `"config.image_processor_unavailable"` — an image went to the model as it was, over the image admission's soft
107
129
  * target (`IMAGE_ADMISSION.soft.targetBytes`), because the run has no image processor (`RunnerDeps.imageProcessor`
108
130
  * is `false`, or sharp did not resolve). ONCE PER RUN, at the first such image wherever it entered (a tool's result,
@@ -129,6 +151,21 @@ export interface EngineNotice {
129
151
  * above the break and its side branches). Counts and entry ids only, never a record's words. ONCE PER PREPARED LEG for a whole branch,
130
152
  * once per break for a broken one (and then the whole-branch form is not said), at the first read that met it — said when the acquire
131
153
  * has settled on the attempt that holds, so an attempt that lost a write race and was run again is not described.
154
+ * - `"rewind.boundary_unrecorded"` — the file-history boundary of this turn was not recorded (the store answered a failure, or the
155
+ * capture did not finish within its 30 s fence): the turn goes on, and a rewind to its entry will refuse
156
+ * `rewind_snapshot.unresolvable`. Minted by the boundary seat where it hands the same failure to `onError` (`{ phase: "rewind" }`,
157
+ * the operator's half), so the two are one fact. Audience `user`. `detail: { sessionId, entryId, cause }` — `entryId` is the row
158
+ * of the person's input the boundary was for, `cause` the store's code (`FILE_HISTORY_ERROR_CODES`; `aborted` for the fence); never
159
+ * the store's message, never a path. ONCE PER FAILED CAPTURE, at most once per run.
160
+ * - `"verify.verifier_is_implementer"` (`src/agents/verifier-independence.ts`) — the verification gate's verifier leg answered on the
161
+ * SAME resolved model id as the implementation leg it judged (`TaskResult.model` of the two: an unset `verifier` role falling back to
162
+ * the main model, a tier default that names the same entry, or a `verifierModel` that is the implementer's own), so the verdict is a
163
+ * model grading its own work and the outcome says `VerificationOutcome.independent: false`. The verification runs and its verdict
164
+ * stands — the notice and that bit are the disclosure. Said only when BOTH ids are known (a result that carries no `model` reads as
165
+ * "cannot say", not as independent); a mid-run degradation is not read (the compared ids are the engine-selected ones). ONCE PER GATE
166
+ * RUN, at the first verifier leg that read so. Audience `user`; `detail: { model, verifierSeat, sessionId? }` — `model` the
167
+ * shared id (bounded at 80), `verifierSeat` is `verifierModel` (the call named it) or `roles.verifier` (the role resolved it);
168
+ * `sessionId` (also lifted to the top level) is the implementation's session, absent when the result carries none.
132
169
  * - `"workflow.governance_key_stripped"` (#235) — the fields of an LLM-authored workflow `agent(spec)`
133
170
  * that did NOT cross the governed default-deny whitelist: an unrecognized/control-plane field, or a
134
171
  * `readFace` value that is not the containment-tightening one. The spawn PROCEEDS on the deployment
@@ -172,16 +209,16 @@ export interface EngineNotice {
172
209
  * `writeScope` absent ⇔ a read-only layering. Minted at the DECLARATION rather than at the
173
210
  * mount (the declaration is already the fact, and a mount that later fails must not swallow
174
211
  * it). Dedup unit: once per prepared leg.
175
- * - `"mcp.revocation_probe_failed"` (design/338) — the deployment's `mcpRevocations.isRevoked`
176
- * probe threw; MCP dispatch FAILS OPEN (revocation is a tightening face) and this announces
177
- * once per materialization (a resume re-materializes and may announce again).
212
+ * - `"protocol.revocation_probe_failed"` (design/338) — the `protocolRevocations.revoked` probe threw or answered a
213
+ * non-boolean; MCP and A2A requests FAIL OPEN (revocation tightens) and this announces once per prepared leg,
214
+ * whichever protocol asked first (a resume prepares again and may announce again).
178
215
  * `detail: { message, runId }` — still no sessionId (a deployment wiring fact, not
179
- * session-attributed); `runId` (#499) makes the once-per-materialization claim CHECKABLE without
180
- * attributing the line to a conversation, an opaque invocation id saying which materialization
216
+ * session-attributed); `runId` (#499) makes the once-per-leg claim CHECKABLE without
217
+ * attributing the line to a conversation, an opaque invocation id saying which leg
181
218
  * rather than whose. `"operator"` audience by
182
219
  * its explicit {@link NOTICE_AUDIENCE} row (#433 made the registry total over the catalog —
183
220
  * no engine-minted code is audience-defaulted any more). The refusal itself
184
- * (`mcp.server_revoked`) is a tool RESULT code, not a notice.
221
+ * (`mcp.server_revoked` / `a2a.peer_revoked`) is a tool RESULT code, not a notice.
185
222
  * - `"mcp.server_redialed"` — a host asked this run to RE-DIAL one MCP server (the run
186
223
  * handle's `reconnectMcpServer` verb) and this is what came of it. `detail: { server, outcome,
187
224
  * added, removed, reason?, sessionId, runId }` — `outcome` is the result's own three-word answer
@@ -205,6 +242,14 @@ export interface EngineNotice {
205
242
  * authorize; `sessionId` REQUIRED at the mint. Dedup unit: once per (leg, server) — a resume is a new
206
243
  * leg and may announce again. A deployment that waits for the authorization keys on this notice; the
207
244
  * leg itself does not park on it.
245
+ * - `"mcp.server_unavailable"` — an MCP server the leg could not reach (it failed to connect or to list its tools) and so SKIPPED: the
246
+ * run goes on with the tools of the servers that did connect, and this server's are missing from it. The person's half of the SAME
247
+ * warning the operator reads on `onError` (`{ phase: "mcp" }`, code `mcp.server_unavailable`): derived at the Runner's drain of the
248
+ * materialization's warning lane from the warning object itself, so the two are one fact; the wiring manifest's `mcp` row and the
249
+ * materialization's `statuses` already read `failed` and are not touched. `detail: { server, sessionId, runId }` — `server` is the
250
+ * declared entry's name, never the failure's text, a URL, a command or a path. A server whose dial failed `unauthorized` is NOT told
251
+ * here — `mcp.authorization_required` is its notice. `"user"` audience; `sessionId` REQUIRED at the mint. Dedup unit: once per
252
+ * (leg, server) — a later leg whose dial fails again is a new fact; a consumer folding per session would hide a second server's.
208
253
  * - `"mcp.credential_echoed"` — a protocol peer (an MCP server, an A2A peer) echoed a credential its
209
254
  * connection's requests carried into what it said about itself: an MCP server's `serverInfo`, its
210
255
  * instructions or its tool listing, an A2A peer's agent card. The engine reads that account through
@@ -412,9 +457,18 @@ export interface EngineNotice {
412
457
  * refused at every prepare. Never minted for `default` (the main model's seat: an unknown word there is still refused,
413
458
  * `config.unknown_role` / `unknown_model_ref`) nor `classifier` (its own stand-in and its own line, `classifier.role_defaulted`).
414
459
  * Named once per SESSION per (seat, word), whether or not a read of this leg reaches the seat; root legs only. Audience
415
- * `operator`; `detail: { seat, role, model, reason: "unknown_model_ref", fallback, sessionId, runId? }` — `seat` the
460
+ * `user` (the default answers where the named model was meant to; the fix stays the operator's), always session-attributed; `detail: { seat, role, model, reason: "unknown_model_ref", fallback, sessionId, runId? }` — `seat` the
416
461
  * `roles.<role>` the refusal would have named, `model` the word written there (bounded at 80), `fallback` the roles the seat's
417
462
  * chain would reach, nearest first.
463
+ * - `"model.fallback"` (#3567; `src/core/runner/model-fallback-seat.ts`) — a model request walked its `Model.fallbacks`
464
+ * chain: a fallback model answered (`outcome: "served"`) or none could (`"exhausted"`, the request ending with the requested
465
+ * model's own failure). Read off the answer's marker where the run books each answer — the main loop (`lane: "main"`) and
466
+ * the side-call book (`compaction` / `classifier` / `mod` / `advisor`); a call outside a leg's book announces nothing.
467
+ * ONCE PER LEG PER (from, to, reason, outcome). Audience `user`; `detail: { from, to, reason, outcome, chain, skipped?, lane,
468
+ * fromWindow?, toWindow?, sessionId, runId? }` — `chain` the hops tried after `from`, `skipped` the hops the deployment Brain's
469
+ * route judgment refused before sending (`{ model, code? }`, chain order), the windows the models' `contextWindow`. A walk that
470
+ * began and sent no hop (every later hop's route refused) is announced too — `exhausted`, `chain: []`, `skipped`, and no `to` /
471
+ * `toWindow` (no hop was tried; the answer, its marker-less message and `TaskResult.degraded` stay the requested model's own).
418
472
  * - `"context.tool_turn_repaired"` (#1224) — a provider request was built from a transcript that breaks the
419
473
  * tool-turn law, and the request view restored it (`engine/llm/tool-turns.ts`; the transcript is never
420
474
  * rewritten): a block after an assistant's tool calls moved ahead of them (`trailing_text`), a result recorded
@@ -448,6 +502,21 @@ export interface EngineNotice {
448
502
  * refusal's record stands in sends it so (`engine/llm/rejected-images.ts`; MCP and A2A tools only, at most 8 per such
449
503
  * transcript; a compaction that summarizes the record away returns the schema until the provider refuses it again).
450
504
  * The model can still call the tool. Audience `user`; `detail: { tool, sessionId, runId }`. ONCE PER REFUSAL.
505
+ * - `"context.messages_omitted"` (#1822) — the request's guard trim, the last resort after compaction declined, failed
506
+ * or did not get the request under its guard, left the OLDEST messages out of what the model sees (the model reads
507
+ * a line saying earlier messages were omitted; the session keeps every message). Audience `user`;
508
+ * `detail: { omitted, sessionId, runId }`, `omitted` = how many messages that request left out. ONCE PER TRIMMED
509
+ * STRETCH: told on the first trimmed request a context hook handed on, silent while the requests after it stay
510
+ * trimmed, said again only after a request that fit (a provisional view the in-turn compaction replaced says
511
+ * nothing). A shell that renders a compaction failure as "the context was not shrunk" reads this code for that
512
+ * request: the context the model saw WAS shrunk, by omission.
513
+ * - `"instructions.withheld"` — an instruction file (today: of a directory the run accessed, the family
514
+ * `NESTED_MEMORY_LANE.declaration` names) was not loaded because the model could not Read it: none of it reached the model.
515
+ * Audience `user`; `detail: { path, reason, sessionId, runId }`, `reason` closed (`INSTRUCTIONS_WITHHELD_REASONS`:
516
+ * `rule_denied`, `outside_roots`, `approval_required`, `admission_unknown`, `target_moved`). ONCE PER SESSION per
517
+ * (path, reason), across runs; a delegated leg records it and says nothing. A file that exists but cannot be read
518
+ * (an I/O error, not text, past the read bound) is the operator's line instead (`onError` phase `degraded`,
519
+ * classification `attachment-read`), once per session per path.
451
520
  * - `"task.tool_turn_incomplete"` (#1230) — the person's line for a tool turn the model was handed incomplete, beside
452
521
  * the note the model itself reads. `detail.cause` (closed `TOOL_TURN_INCOMPLETE_CAUSES`): `truncated` — calls whose
453
522
  * arguments were cut before they parsed, dropped (they did not run); `unnamed` — calls that arrived with no tool
@@ -517,11 +586,21 @@ export interface EngineNotice {
517
586
  * `RunnerDeps.readDenyFloorRequired` turns it into (the prepare then fails with the same code); never minted for an
518
587
  * empty table or an environment that keeps the floor (the Stub of a run without hands keeps it by refusing every
519
588
  * start). Once per run — each delegated child on its own environment — and once per construction of a library-direct
520
- * band that compiles its own table; `detail: { rowCount, sessionId?, runId? }` (the two ids on a run's notice).
589
+ * band that compiles its own table. Audience `user` (the session's own reads can reach a forbidden file's bytes; the way out stays the operator's); `detail: { rowCount, sessionId?, runId? }` — both ids on a run's notice, neither on a library-direct band's (no session).
521
590
  * - `"config.read_floor_confinement_unavailable"` — a Node environment was asked to confine its starts to the floor
522
591
  * (`readFloorConfinement: "os"`) and this host cannot (not macOS, or the seatbelt base does not apply here): the
523
592
  * environment declares it does not keep the floor, and the run's own judgment (`config.read_deny_floor_unkept`)
524
593
  * follows. Once per construction, at construction; `detail: { reason }`.
594
+ * - `"config.inherit_env_declared_late"` — a Node environment's `inheritEnv` list names a variable that a process-level
595
+ * own-credential declaration (`declareWithheldEnv`) made after the environment was built now withholds: every shell
596
+ * child the environment would start is refused, the command's failure carrying the same sentence. Said once per
597
+ * environment, at the first refused start (a read of the environment announces nothing); audience `operator` (the
598
+ * order of two wiring steps the deployment owns); `detail: { index, name }` — the entry, never a value.
599
+ * - `"config.command_sandbox_unavailable"` — the task requires a command sandbox (`TaskSpec.sandbox.enabled`) with
600
+ * `failIfUnavailable: false`, and its execution environment keeps none (`capabilities.commandSandbox` is not true): the
601
+ * run proceeds and its commands run unsandboxed. Under `failIfUnavailable` (its default) the prepare fails with the same
602
+ * code instead. Once per run, at prepare. Audience `user` (the person asked for the sandbox and does not have it);
603
+ * `detail: { reason, sessionId?, runId? }`.
525
604
  * - `"config.secret_env_scrubbed"` (#1081) — the D1 fail-closed `scrub` policy, or the deployment's
526
605
  * own credentials (`declareWithheldEnv`: a declared name, or a value equal to a declared or engine-held
527
606
  * credential value), withheld one or more keys from a spawned child's environment (a tool's shell, an
@@ -533,9 +612,10 @@ export interface EngineNotice {
533
612
  * - `"inherit_env.names_withheld"` (#1963) — the same fact for the person whose run drives a tool shell: the variables
534
613
  * of the engine's environment that shell does not receive (`ExecutionEnv.withheldEnv`), the scrub's half (the run's
535
614
  * `inheritEnv` hands them on) and the engine's own credentials (no policy does). Audience `user`. Read as each
536
- * call to the engine's own shell tool starts on a root leg (the answer can grow during a run: a credential the engine
615
+ * call to the engine's own shell tool starts, on every leg (the answer can grow during a run: a credential the engine
537
616
  * takes in when it first routes a model is withheld from the next child); once per SESSION per name set (the
538
- * session's announced record). `detail: { state, names?, ownCredentials?, sessionId, runId? }` — `state` `"withheld"`
617
+ * session's announced record). A delegated leg's goes to the delegation tree's root session and names the leg
618
+ * (`sourceSessionId`, `agentId?`, #3650). `detail: { state, names?, ownCredentials?, sessionId, sourceSessionId?, agentId?, runId? }` — `state` `"withheld"`
539
619
  * carries the operator row's split (names only, never a value); `"unknown"` (the environment answered `"unknown"`)
540
620
  * carries no names and says the engine could not determine them.
541
621
  * - `"config.credential_not_withheld"` (#1816) — a credential value the engine was handed (a brain's key or credential
@@ -621,8 +701,23 @@ export interface EngineNotice {
621
701
  * `detail: { layer, entries: [{ field, entry, layer, guidance, source? }], total, sessionId }` — `layer` ∈ `caller_policy` / `session_rules` /
622
702
  * `ancestor_session_rules` / `task_selector` (a task's tool-name lists) / `skill_table` (a skill's `disallowed-tools`; `source` names the list's
623
703
  * owner), `field` ∈ `deny` / `ask`, `guidance` the retirement table's own line, `entries` unique by (field, entry, source) in scan order (at most 32), `total` every one.
704
+ * - `"config.toolpolicy.unmatched_names"` — a tool-name list the REQUEST's own seats wrote (a delegation definition's `allowTools` /
705
+ * `denyTools` in `TaskSpec.agents`, the run's own `allowTools` / `excludeTools`) holds a name no tool of the list's universe answers to
706
+ * (a misspelt name, a server this task does not declare). The entry is kept as written and the run goes on; this says so, because the
707
+ * person who wrote it believes the name guards or grants a tool. Audience `user`. One code, two faces: the operator reads the same
708
+ * sentence on `onError` (`phase: "config"`, the same `code`) — and ONLY there when the list is the deployment's (a delegation tool's
709
+ * own lists, a deployment's tool policy: the policy name audit's advisory carries the code on that channel alone). Once per session
710
+ * per entry. `detail: { where, side, entry, nearest?, sessionId }` — `where` names whose list it is, `side` ∈ `allowed` / `denied`,
711
+ * `entry` the name as written, `nearest` the nearest name a tool of the universe answers to when one is within two edits.
712
+ * - `"config.agent.unknown_tool"` — an entry of a DEFINITION's `allowTools` / `denyTools` that no tool name can be (`"Bash("`, `"a b"`,
713
+ * `""`, `"a b(x)"`: the rule syntax reads no name in it). The run goes on; the definition cannot be delegated to until the entry is
714
+ * fixed — the delegation to it is refused with this same code (`details: { error, reason: "grammar" }`), where it is used. Audience
715
+ * `user`: the person who wrote the definition believes the entry bounds the agent. One code, two faces: the operator reads the same
716
+ * sentence on `onError` (`phase: "config"`, the same `code`, `detail.reason`) — and ONLY there when the definition is one a
717
+ * delegation tool the deployment mounted carries. Once per session per list, naming its first such entry. `detail: { where, side, entry, reason: "grammar", sessionId }`.
624
718
  * - `"config.durable_gate_unavailable"` — a durable-approval MANDATE is in force on a leg with NO
625
- * checkpoint store: the per-principal `forceDurableGate` entitlement, or the task's own
719
+ * park facility (no checkpoint store; or, for the entitlement, a delegated leg that cannot be resumed — `cause` below):
720
+ * the per-principal `forceDurableGate` entitlement, or the task's own
626
721
  * `durableApproval` opt-in with no live approver seat (`durableMandateSourceOf`, the predicate the
627
722
  * leg's children inherit). A mandate with no park facility cannot be honored: no ask of the leg can suspend, so each one resolves on the LIVE
628
723
  * chain — a live approver / question face answers in-stream, and with none the ask is denied
@@ -633,9 +728,12 @@ export interface EngineNotice {
633
728
  * it through the sink as always). Once per prepared task leg — a resume or a delegated child
634
729
  * is its own leg and says so again; `detail: { sessionId, runId, principal?, cause, source,
635
730
  * liveApprover, liveQuestionFace }` — `source` is `"force_durable_gate"` or `"durable_approval"`
636
- * (which mandate is unhonored; the recovery differs); `cause` is `"no_deployment_store"` (the deployment wired none) or
731
+ * (which mandate is unhonored; the recovery differs); `cause` is `"no_deployment_store"` (the deployment wired none),
637
732
  * `"task_store_disabled"` (`TaskSpec.checkpointStore: "disabled"`, the per-run off switch, on a leg
638
- * whose deployment may well have a store: the fix is the task's); `liveApprover` /
733
+ * whose deployment may well have a store: the fix is the task's), or `"leg_not_resumable"` (a store, but the entitlement binds a
734
+ * DELEGATED leg its parent forwarded no durable approval to — a synchronous or fork child, a background child whose lane cannot
735
+ * park. Such a leg parks no ask and nothing answers in its place: every permission ask is refused without consulting the
736
+ * approver, a question is refused, not shown — unlike the two store causes, whose asks resolve on the live chain); `liveApprover` /
639
737
  * `liveQuestionFace`: whether a live seat will EFFECTIVELY answer the leg's permission asks /
640
738
  * questions in-stream (a delegated child under an inherited content mandate reads `false`
641
739
  * even with a face wired — the marker withholds the question), or the fail-closed deny will.
@@ -683,8 +781,8 @@ export interface EngineNotice {
683
781
  *
684
782
  * - `"task.turn_interrupted"` (design/373) — a running turn was ACTUALLY CUT at a manufactured
685
783
  * boundary: the in-flight provider stream / tool batch was aborted (finished tool calls keep
686
- * their real results, never-started ones settle as paired interrupted results, the interruption
687
- * marker lands). **TWO mint lanes, one code** — the CUT is lane-independent, so it is one fact
784
+ * their real results, never-started ones settle as paired results; the interruption marker
785
+ * line lands on the bare-halt lane only). **THREE mint lanes, one code** — the CUT is lane-independent, so it is one fact
688
786
  * with one spelling, and `detail.cause` is the arm discriminator (a consumer that must tell
689
787
  * them apart reads that key; one that only cares "a turn was cut" reads neither):
690
788
  * · the STEER-NOW lane (design/373) — a caller-provenance steer with `priority: "now"` cut
@@ -704,7 +802,15 @@ export interface EngineNotice {
704
802
  * ending, no `haltedByUser`, plus a `task.halt_unconsumed`); the notice stands beside that
705
803
  * terminal without contradiction, because a seat really was cut — `haltedByUser` answers
706
804
  * the other question (was the halt CONSUMED), see that seat.
707
- * In both lanes: one notice per REAL cut (a `now` that found nothing in flight or whose frame
805
+ * · the EXTENSION lane (a mod's `$.turn.abort({ turn })`) — an extension ended the running model
806
+ * turn and the run goes on at the ordinary turn boundary (a queued follow-up opens the next
807
+ * turn, else the stop gate is asked, else the run completes carrying {@link TaskResult.turnAbortedBy}).
808
+ * `detail: { cause: "extension_abort", extension, turn, sessionId, runId, taskId }` — `extension`
809
+ * is the registration that asked, `turn` the turn number it ended; no `inputId`, no `actorId`. The notice
810
+ * rides the cut's ACCEPTANCE: a cut that lands after the request's end was delivered but before the loop
811
+ * obtained its final is accepted and announced, yet the turn still ends as its answer — that cut is then
812
+ * disclosed by `task.halt_unconsumed` (`detail.source: "extension"`) at the result's settlement.
813
+ * In every lane: one notice per REAL cut (a `now` that found nothing in flight or whose frame
708
814
  * already rode the imminent boundary, and a halt with nothing in flight, announce nothing — no
709
815
  * false interrupt claims); `runId` is the INVOCATION that was cut; every cut turn counts toward
710
816
  * `maxTurns`, so an interrupt storm's cost is bounded and each of its cuts is on the record.
@@ -727,9 +833,16 @@ export interface EngineNotice {
727
833
  * for it (a brain minting its own `aborted` final beside a late halt, a natural completion the halt
728
834
  * arrived too late to prevent, an approval park whose commit won the race and whose abort owned the
729
835
  * ending); once per such run, at the result's settlement. Either way the notice is the halt's trace
730
- * beside the verb receipt. `detail: { sessionId, runId, taskId }` — `runId` is the run whose ending
836
+ * beside the verb receipt. `detail: { source: "halt", sessionId, runId, taskId }` — `runId` is the run whose ending
731
837
  * the halt failed to claim. Audience `"user"`. A REFUSED halt (typed `steering.not_running` throw)
732
838
  * mints nothing: the refusal itself is the loud answer.
839
+ * The same code is the trace of the OTHER request that asks to end a turn — an extension's `$.turn.abort` whose cut
840
+ * was ACCEPTED (`task.turn_interrupted` was announced) but that no settlement took as its turn's cause: the turn had
841
+ * already ended on its own outcome (its request's end was delivered before the cut, so it ends as an answer), or
842
+ * the run's own ending won. The result does NOT carry `turnAbortedBy` for it. One per such cut, at the result's
843
+ * settlement (the settle arm). `detail: { source: "extension", extension, turn, sessionId, runId, taskId }` —
844
+ * `extension` and `turn` are the cut's own (the ones its `task.turn_interrupted` carried). `detail.source`
845
+ * (`"halt" | "extension"`) names whose request it was; a steer-now's cut asks to redirect, not to end, and has none.
733
846
  *
734
847
  * - `"task.late_approval"` (design/384 slice 1) — a synchronous ask approval was NOT CONSUMED:
735
848
  * a run or turn interrupt released the wait (the `resolveAsk` race arm detached the approver's
@@ -746,7 +859,7 @@ export interface EngineNotice {
746
859
  * forward it on its own wire.
747
860
  *
748
861
  * - `"task.interrupt_unconsumed"` — a HARD stop ({@link TaskStream.interrupt}, the task's `signal`,
749
- * the walltime or the turns limit) landed AFTER the run's last turn had already given its answer
862
+ * the walltime or the turns limit, the budget gate) landed AFTER the run's last turn had already given its answer
750
863
  * (`stopReason:"stop"`, not partial, and no steer / follow-up of the person's still pending — a
751
864
  * queued continuation makes that "stop" work in progress, and a stop that cuts it stays the
752
865
  * ordinary abort with its undrained-input account) and before the loop's end — what it aborted was the run's
@@ -754,11 +867,11 @@ export interface EngineNotice {
754
867
  * answer stands: the run ends `completed` with it as `result`, no `[Request interrupted by user]`
755
868
  * marker is written and no `limits.*` terminal is minted for the axis that fired; this notice is
756
869
  * the stop's only trace. Minted once per such run, after the terminal arbitration (so it never
757
- * claims a completed ending the terminal did not give — a budget ceiling crossed by the last
758
- * turn's own spend still fails the run and mints nothing here); `detail: { sessionId, runId,
870
+ * claims a completed ending the terminal did not give); `detail: { sessionId, runId,
759
871
  * taskId, origin }` with `origin` ∈ `"interrupt"` (the verb) | `"walltime"` | `"turns"` |
872
+ * `"budget"` (the budget gate's stop on an answering turn; the spend is on `stats`) |
760
873
  * `"signal"` (every other run-level abort: the task's own `signal`, a parent's cancel, a
761
- * `destroy()`, a refused preempt — the leg names the three it can tell apart and files the rest
874
+ * `destroy()`, a refused preempt — the leg names the four it can tell apart and files the rest
762
875
  * here). Audience `"user"`. A stop that arrives AFTER the loop's end but before `done` aborted no
763
876
  * live loop and mints nothing here: it is answered, the end-of-task compaction pass does not run past
764
877
  * it (cut in flight — `compaction_outcome{mooted, reason:"cancelled"}` — or never started), and the
@@ -773,6 +886,14 @@ export interface EngineNotice {
773
886
  * `not_a_string` | `no_candidate` | `mismatch` | `unresolvable` | `resolves_elsewhere` | `admits_artifact_store`
774
887
  * (the directory contains the wired local artifact store, lies inside it or is it) | `no_read_roots`. Once per
775
888
  * answered ask. Audience `"user"`.
889
+ * - `"approval.approver_defect"` (`src/core/runner/approver-defect-announcer.ts`, `approverDefectAnnouncer`; minted by the four stations that put an
890
+ * ask to an approver) — the approver THREW, or ANSWERED outside its contract (an answer that is not `true` / `false` /
891
+ * `"unavailable"` / the `{allow}` object, or an object the seam refuses: a reason that is no string, an attribution or a
892
+ * `decidedVia` it cannot read), and the call it was asked about was denied fail-closed — the tool did not run. The model reads that
893
+ * denial as it reads any other; this tells the one who wired the seat that the seat is broken.
894
+ * `detail: { toolName, toolCallId, cause, seat, sessionId, runId, taskId }` — `cause` ∈ `threw` / `out_of_contract`; `seat` ∈
895
+ * `policy` (an approver the deployment declared a policy, `asPolicyApprover`) / `approver` (any other); never the thrown text or the
896
+ * answer (the denial the model reads names them). Once per denied ask. Audience `"operator"`: the defect is the deployment's code.
776
897
  *
777
898
  * - `"checkpoint.execution_outcome_unrecorded"` — the resumed leg's pending-call resolver disposed
778
899
  * the decided action (executed it, delivered the refusal, or vetoed the person's yes) and filed
@@ -963,6 +1084,13 @@ export interface EngineNotice {
963
1084
  * failures of a switch the person is still trying to throw.
964
1085
  * Read the run's own outcome (or the verb's rejection) to tell the two apart; this code alone
965
1086
  * does not say whether anything stopped.
1087
+ * - `"memory.mount_failed"` — a memory store that was asked for did not mount for this run (the memory phase's fail-open
1088
+ * arm: the task runs without its memory). Minted under the guard that mints the run's `memoryless` / `mount-failed`
1089
+ * observation, so the two are one fact; the operator's half is `onError` (`{ phase: "memory" }`), this is the person's.
1090
+ * `detail: { sessionId, scopes, cause }` — `scopes` is what the task asked to mount (the whole span failed), `cause` the
1091
+ * refusal's own code when it is a member of `STORE_FORM_REFUSAL_CODES`, else `"unclassified"`; never the thrown text, never a
1092
+ * path. Audience `"user"`. Dedup unit: once per SESSION — key `(code, detail.sessionId)`; the phase mints once per leg whose
1093
+ * mount failed. The model's half is the memory band's writes-unavailable notice, said only where the roster cannot persist.
966
1094
  * - `"memory.consolidation_incomplete"` (design/376, LLM consolidation driver) — a driver run
967
1095
  * settled without reaching the fixpoint: `detail` names the stop reason (the closed
968
1096
  * `ConsolidationRunStopReason` set), cycles done, and the residue (write-failure or
@@ -1077,9 +1205,9 @@ export interface EngineNotice {
1077
1205
  * is the one sentence naming the caller-side change that would have let the call run, as the tool text carries it (for arguments
1078
1206
  * no approval can be bound to, the binding's own sentence: the remedy's approver half would not let them run). Audience `"user"`: the refused
1079
1207
  * work is the session user's own; the operator hears it through the sink like every code.
1080
- * - `"delegation.resume_lane_missing"` (#3334) — a parked agent resumed by a lane-less drive in a process holding no park of it:
1081
- * its completion takes the mount's sink, settling no waiting submission elsewhere; the resume proceeds. Once per drive, at
1082
- * the consume, to the process default seat. `detail: { taskId, rootSessionId? }`. Audience `"operator"`.
1208
+ * - `"delegation.resume_lane_missing"` (#3334) — a parked agent resumed by a lane-less drive whose task registry holds no park of it: its completion is routed to its
1209
+ * tree's root session — its live run on the drive's runner, else its durable box (`detail.path: "box"`) — or, where the root has no durable box (the sentence names why),
1210
+ * the mount's sink; a submission waiting on it elsewhere is not settled by it. Once per drive, at the consume, to the process default seat. `detail: { taskId, rootSessionId?, path? }`. Audience `"operator"`.
1083
1211
  * - `"delegation.delivery_discarded"` (#3431) — a frame (a background task's completion, a monitor event, a child's message)
1084
1212
  * addressed to an earlier occupant of a session id — the id deleted and created again, by another principal or the same
1085
1213
  * one — was discarded instead of delivered to the occupant the id holds now. Once per frame, by the Runner's per-session
@@ -1115,7 +1243,7 @@ export interface EngineNotice {
1115
1243
  * throw rendered twice keeps one id, two refusals sharing a code/scope/message get two. Omitted
1116
1244
  * (never fabricated) when the caller composes the line with no error in hand.
1117
1245
  *
1118
- * The four SERVER-minted rows ({@link NOTICE_MINTER} `"server"`) — catalogued so their audience and detail shape
1246
+ * The five SERVER-minted rows ({@link NOTICE_MINTER} `"server"`) — catalogued so their audience and detail shape
1119
1247
  * are read here like every other row; this engine never mints them. A server forwards them through the same sink.
1120
1248
  * - `"permission.entry_mode_clamped"` — the permission mode the caller requested was clamped by the deployment's
1121
1249
  * entry floor BEFORE the run reached this engine (the server's own clamp, through this package's
@@ -1124,10 +1252,6 @@ export interface EngineNotice {
1124
1252
  * `config.permission_mode_unavailable`, never this row. Audience `"user"`; `detail: { requested, effective,
1125
1253
  * ceiling, sessionId }` — `requested` the caller's word, `effective` the word the run starts under, `ceiling`
1126
1254
  * the floor that clamped it; no run id — the clamp happens at intake, before any run exists. Once per run.
1127
- * - `"instructions.source_changed"` — the project instruction file this run injects is not the one the same
1128
- * session's previous run injected (a file added, removed or renamed). Audience `"user"`; `detail: { previous,
1129
- * current, sessionId }` — `previous` / `current` are chain-member relative paths, `null` = that run had none.
1130
- * No `runId`. Once per run.
1131
1255
  * - `"memory.layer_locked_legacy"` — a memory layer an older engine left without its owner-write bit was found at
1132
1256
  * boot; deletes in it will fail until the operator restores the bit. Audience `"operator"`; `detail: { layers,
1133
1257
  * remedy }` — layer directory names and the one command. No session. Once per boot.
@@ -1140,6 +1264,13 @@ export interface EngineNotice {
1140
1264
  * per-leg dedup folds the two into one line); `proxyInUse` present only when that request went through a proxy,
1141
1265
  * its value the variable's name (`HTTP_PROXY` or `HTTPS_PROXY`), never the proxy address. No `runId`. Once per
1142
1266
  * leg per target.
1267
+ * - `"model.context_window_assumed"` — a model the catalog gives no `contextWindow` for ran on an assumed window the serving layer chose before the run reached this engine. Audience `"user"`; `detail: { model, assumedContextWindow, sessionId }` — the model's name and the window the run was sized on; no `runId`.
1268
+ * - `"config.store_ephemeral"` (#3952) — the deployment declared this engine's session and checkpoint stores
1269
+ * process-local: parking and resume hold only within the serving process. Present only when the deployment's
1270
+ * store declares itself ephemeral; this package reads no such declaration and mints no such notice. Audience
1271
+ * `"user"` — the person's parked work and later resume are what the declaration bounds, and the remedy (a
1272
+ * durable store) stays the deployment's; `detail.sessionId` names the session. The sentence the person reads and
1273
+ * how often it is told are the server's; this engine only catalogues the code.
1143
1274
  *
1144
1275
  * Deliberately NOT a notice family: brain retry/reconnect liveness (a rate limit, a 5xx, a
1145
1276
  * transient network failure being retried). Those are per-attempt liveness frames with their own
@@ -0,0 +1,25 @@
1
+ /** The mode of every file the engine creates to hold its own data: owner read/write only. */
2
+ export declare const PRIVATE_FILE_MODE = 384;
3
+ /**
4
+ * The one way the engine opens a file it will fill and then publish under another name: a NEW file, owner-only. `open(2)`
5
+ * applies a mode only to a file it creates, so a truncating open (`"w"`) of a name that is already there keeps that file's
6
+ * old mode and its inode, and the rename that publishes it hands both to the official name. Two shapes of write need two
7
+ * spellings, and no third:
8
+ * - a temp file that is renamed or linked onto its target — {@link openExclusiveTemp}, below;
9
+ * - a file whose name is fixed and sits in a directory this very call just created (a lock's owner token, a staged tree) —
10
+ * `openSync(path, "wx", PRIVATE_FILE_MODE)`: a directory made a moment ago holds nothing, so `wx` cannot meet a
11
+ * leftover, and a planted name is refused rather than written through.
12
+ * Anything that opens a file for writing, with a mode, and neither of these, is the defect this module exists to prevent.
13
+ */
14
+ /**
15
+ * Open a NEW temp file named `<stem>.<pid>.<random>.tmp` for writing, and say which name it got. The open is
16
+ * `O_CREAT | O_EXCL`, so it never reuses a file that is already there. A name already taken is skipped for a fresh one,
17
+ * never opened, truncated or removed — whatever stands there is not ours to touch. After {@link TEMP_OPEN_ATTEMPTS} taken
18
+ * names the open throws a plain `Error` carrying the last `EEXIST` as its `cause`: deliberately not an `EEXIST` itself,
19
+ * because a caller that publishes with `link` answers an `EEXIST` of its own for "the target is already there", and must
20
+ * not read an exhausted temp namespace as a published blob.
21
+ */
22
+ export declare function openExclusiveTemp(stem: string): {
23
+ fd: number;
24
+ path: string;
25
+ };
@@ -0,0 +1,19 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { constants as FS, openSync } from "node:fs";
3
+ export const PRIVATE_FILE_MODE = 0o600;
4
+ const TEMP_OPEN_ATTEMPTS = 8;
5
+ export function openExclusiveTemp(stem) {
6
+ let lastExists;
7
+ for (let attempt = 0; attempt < TEMP_OPEN_ATTEMPTS; attempt++) {
8
+ const path = `${stem}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
9
+ try {
10
+ return { fd: openSync(path, FS.O_CREAT | FS.O_EXCL | FS.O_WRONLY, PRIVATE_FILE_MODE), path };
11
+ }
12
+ catch (err) {
13
+ if (err.code !== "EEXIST")
14
+ throw err;
15
+ lastExists = err;
16
+ }
17
+ }
18
+ throw new Error(`file store: no unused temp file name for ${stem} after ${TEMP_OPEN_ATTEMPTS} attempts`, { cause: lastExists });
19
+ }
@@ -0,0 +1,112 @@
1
+ /**
2
+ * The current state of a write's target, on the approval card that asks for the write.
3
+ *
4
+ * THE RULE (one sentence): a write tool's approval card carries what its target holds now exactly when the model's own `Read`
5
+ * of that path, issued now, would be served; otherwise the card says why it has none. No read floor of its own, no read path
6
+ * of its own: the read is the Read tool's — the run's served-read judge (the synthetic `Read` probe with every ask held, so a
7
+ * read anyone would first be asked about is not served, carrying what the live gate stamps on the model's own `Read` — the
8
+ * face the run's roster gives `Read` and the leg's facts — so a policy judges the probe as it judges the model's own `Read`;
9
+ * a roster with no `Read` serves no read at all), then the Read tool's own text read on the execution lane,
10
+ * its final resolution held to the file the judgment named. Nothing about the read is recorded: the card's read never
11
+ * stands for the model having read the file (a later `Write` of a file the model never read is still refused).
12
+ *
13
+ * WHICH CARDS: a tool whose roster row writes a file on the execution environment ({@link existingTargetCovers}) — the
14
+ * write family, a path target that is not read-only, the environment leg. Every card in that scope carries the member;
15
+ * a card outside it never does.
16
+ *
17
+ * THE STATES:
18
+ * text — the target's text, as the Read tool's text lane decodes it (byte-order mark removed, CRLF folded to LF) —
19
+ * the coordinate the write tool's own result reports the old contents in;
20
+ * absent — nothing is at the path (said only after the judgment and the resolution allowed the read: a refused path
21
+ * never tells whether it exists);
22
+ * withheld — `oversize` (past {@link EXISTING_TARGET_READ_CAP}, by the stat or by the bytes read; never cut short),
23
+ * `not_text` (a directory, a binary file, a body that is not UTF-8 or a truncated UTF-16 body),
24
+ * `read_refused` (the resolution, or a judgment layer, refuses the read or would first ask someone about it,
25
+ * or the run's roster has no `Read`),
26
+ * `unavailable` (no reader on this lane, a layer that could not answer, the judgment landing on another file,
27
+ * the stat or the read failing, the wait ending first).
28
+ *
29
+ * WHEN: ONE read per ask. The live ask reads only when a person's seat will answer the card ({@link readsCardTarget}: a seat
30
+ * that answers, not a policy approver's — a policy seat renders no card — and not answering the ask from its declared class
31
+ * table); the durable park reads only when no lane of
32
+ * the same ask read before it, before the run lets go of its environment, and keeps the answer on the parked row (a resumed
33
+ * run never reads again). A park after the live card answered `unavailable` carries the live card's member as read
34
+ * ({@link cardTargetFor}; "the same arguments" is the approval binding's reading — {@link exactBoundInputHashOf} — so a
35
+ * park whose arguments went through the stored JSON form is still the same ask's arguments). A card is the target as of
36
+ * the ask: the file may change before the approved write runs.
37
+ */
38
+ import { type ToolRoster, type ToolRosterEntry } from "./tool-roster.js";
39
+ import type { SyntheticServedReadJudge } from "./synthetic-read-verdict.js";
40
+ import { type OnAsk } from "./tool-policy.js";
41
+ import type { AskClass } from "./ask-origin.js";
42
+ import type { ModelFileReader } from "../tools/fs/fs-read.js";
43
+ /** The card member's three shapes. */
44
+ export declare const EXISTING_TARGET_KINDS: readonly ["text", "absent", "withheld"];
45
+ export type ExistingTargetKind = (typeof EXISTING_TARGET_KINDS)[number];
46
+ /** Why a card in scope carries no text. */
47
+ export declare const EXISTING_TARGET_WITHHELD_REASONS: readonly ["oversize", "not_text", "read_refused", "unavailable"];
48
+ export type ExistingTargetWithheldReason = (typeof EXISTING_TARGET_WITHHELD_REASONS)[number];
49
+ export type ExistingTarget = {
50
+ readonly kind: "text";
51
+ readonly text: string;
52
+ } | {
53
+ readonly kind: "absent";
54
+ } | {
55
+ readonly kind: "withheld";
56
+ readonly why: ExistingTargetWithheldReason;
57
+ };
58
+ /** The most bytes a card's read takes from its target; a larger target is `withheld` / `oversize`. */
59
+ export declare const EXISTING_TARGET_READ_CAP = 262144;
60
+ /** The served-read judge's probe face (probe id `approval-card-visibility-probe`). */
61
+ export declare const EXISTING_TARGET_PROBE_FACE = "approval-card";
62
+ /** Whether a roster row's card carries the member: it writes a file on the execution environment. Read off the row's own
63
+ * declarations, never a list of names. */
64
+ export declare function existingTargetCovers(row: Pick<ToolRosterEntry, "family" | "pathTarget" | "boundaryLegs"> | undefined): boolean;
65
+ /** What a lane reads a card's target with: the run's served-read judge (it stamps the leg's facts on its probe) and the
66
+ * lane's file reader. */
67
+ export interface ExistingTargetSource {
68
+ readonly judge: SyntheticServedReadJudge;
69
+ readonly reader: Pick<ModelFileReader, "readText">;
70
+ }
71
+ /** What one ask's lane read: the arguments it read the target of (and their approval binding), and the member it got. */
72
+ interface TargetRead {
73
+ readonly args: unknown;
74
+ readonly binding: string | undefined;
75
+ readonly member: {
76
+ readonly existingTarget?: ExistingTarget;
77
+ };
78
+ }
79
+ /** The run's source, filled once the run's judge exists (empty on a lane with no reader), and what each ask's lanes read. */
80
+ export interface ExistingTargetSeat {
81
+ current: ExistingTargetSource | undefined;
82
+ /** The member an ask's lane read, by the ask's request object: a later lane of the same ask over the same arguments
83
+ * carries it instead of reading again. */
84
+ readonly read: WeakMap<object, TargetRead>;
85
+ }
86
+ /** A run's seat, its source not yet filled. */
87
+ export declare function createExistingTargetSeat(): ExistingTargetSeat;
88
+ /** Whether a live ask's seat reads its card's target: a seat that answers the card, is not a policy approver's
89
+ * ({@link import("./tool-policy.js").asPolicyApprover} — a policy seat renders no card), and does not answer this ask from
90
+ * its declared class table ({@link import("./tool-policy.js").declareClassAnswers} — the resolver answers a covered ask
91
+ * without calling the seat, so no card is rendered). `classes` is the class set the request to the seat carries. */
92
+ export declare function readsCardTarget(onAsk: OnAsk | undefined, classes: readonly AskClass[] | undefined): boolean;
93
+ /**
94
+ * The member one lane puts on one ask's card: what an earlier lane of the same ask (`ask`, its request object) read over the
95
+ * same arguments (the same object, or the same approval binding); else, when `reads`, one read (recorded for the ask's later
96
+ * lanes); else the member of a card nobody read.
97
+ */
98
+ export declare function cardTargetFor(seat: ExistingTargetSeat, roster: ToolRoster | undefined, ask: {
99
+ readonly toolName: string;
100
+ }, args: unknown, reads: boolean, signal?: AbortSignal): Promise<{
101
+ existingTarget?: ExistingTarget;
102
+ }>;
103
+ /**
104
+ * The member the card of `toolName`'s call carries, as a spread: `{}` for a card out of scope (its row on `roster`, by
105
+ * {@link existingTargetCovers}); `withheld` / `unavailable` with no source (a lane that has no reader, or a caller that does
106
+ * not read); `withheld` / `read_refused` when the roster has no `Read`. One wait bounds the judgment and the read together
107
+ * — the judgment's own budget; the call's signal ends it sooner. Never throws.
108
+ */
109
+ export declare function existingTargetOf(roster: ToolRoster | undefined, toolName: string, args: unknown, source: ExistingTargetSource | undefined, signal?: AbortSignal): Promise<{
110
+ existingTarget?: ExistingTarget;
111
+ }>;
112
+ export {};