@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,8 +1,10 @@
1
1
  import type { PromptEpochDescriptor } from "../../prompt-assembly/epoch.js";
2
- import type { DocumentContent, ImageContent, Model, SimpleStreamOptions, TextContent, Transport } from "../llm/index.js";
2
+ import type { AssistantMessage, DocumentContent, ImageContent, Model, SimpleStreamOptions, TextContent, Transport } from "../llm/index.js";
3
3
  import type { AfterToolCallResult, AgentEvent, AgentMessage, AgentTool, BeforeToolCallResult, QueueMode, ThinkingLevel } from "../loop/types.js";
4
4
  import type { AgentCoreRuntimeDeps } from "../loop/runtime-deps.js";
5
5
  import type { SecretEnvFinding } from "../../core/secret-env.js";
6
+ import type { CommandSandboxInstruction, ConfinementRefusal } from "../../core/command-sandbox.js";
7
+ import type { SessionRepoRowCells } from "../session/row-cells.js";
6
8
  /** Result of a fallible operation. Expected failures are returned as `ok: false` instead of thrown. */
7
9
  export type Result<TValue, TError> = {
8
10
  ok: true;
@@ -71,8 +73,6 @@ export interface AgentHarnessStreamOptions {
71
73
  headers?: Record<string, string>;
72
74
  /** Provider metadata forwarded with requests. */
73
75
  metadata?: SimpleStreamOptions["metadata"];
74
- /** Provider cache retention hint. */
75
- cacheRetention?: SimpleStreamOptions["cacheRetention"];
76
76
  }
77
77
  /** Per-request stream option patch returned by provider hooks. */
78
78
  export interface AgentHarnessStreamOptionsPatch extends Omit<Partial<AgentHarnessStreamOptions>, "headers" | "metadata"> {
@@ -196,7 +196,22 @@ export type ExecutionErrorCode = "aborted" | "timeout"
196
196
  * 2026-07-13 contract above; the Bash dead-cwd diagnosis hangs off it) and `suspended` claims a paused
197
197
  * workspace this arm does not have. Spelling note: landed per design/380's arm (b); the device lane's
198
198
  * wire-word mapping may re-spell at the server's wire freeze. */
199
- | "target_unavailable" | "unknown";
199
+ | "target_unavailable"
200
+ /** The target judged the command by its OWN policy before starting it and said no (a path, argument or permission verdict a device
201
+ * adapter reads off the target's answer: already exists, invalid, is a directory, permission denied, precondition failed): the
202
+ * command NEVER STARTED, nothing ran and no effect landed, and — the verdict being a function of the command and the working
203
+ * directory, not of time — the same command from the same directory is refused the same way. The honest word for an explicit
204
+ * refusal that would otherwise fold into `"unknown"`, whose model-visible sentence says the outcome could not be determined and
205
+ * to verify effects (so the model issues a check that cannot help, and a run in an asking mode shows the person a card for it).
206
+ * Not `target_unavailable` (the target is gone; a retry is safe once it is back), not `spawn_error` (the OS-level spawn failed:
207
+ * dead cwd, missing binary), not `suspended` (a paused workspace). A refusal that is really about the working directory
208
+ * (gone, or no longer a directory) still ends at the Bash tool's dead-cwd diagnosis. */
209
+ | "refused"
210
+ /** The start's confinement could not be had, so the command NEVER STARTED: an entry of its sandbox boundary
211
+ * ({@link ExecutionEnvExecOptions.sandbox}) or a row of its byte floor ({@link ExecutionEnvExecOptions.readFloor}) the
212
+ * environment cannot keep, or a sandbox that cannot start at all — {@link ExecutionError.refusedBy} says which. The ONE word
213
+ * for "refused rather than run with less confinement than the start carries"; not `spawn_error` (the OS-level spawn failed). */
214
+ | "sandbox_unavailable" | "unknown";
200
215
  /** Error returned by {@link ExecutionEnv.exec}. */
201
216
  export declare class ExecutionError extends Error {
202
217
  /** Backend-independent error code. */
@@ -215,6 +230,10 @@ export declare class ExecutionError extends Error {
215
230
  partialStderr?: string;
216
231
  /** `liveness_no_output` only: the silence window (whole seconds) that cut the command — the env's bound, never the requested budget; absent = not stated. */
217
232
  noOutputSec?: number;
233
+ /** `sandbox_unavailable` only: `"this_call"` — an entry of THIS start's confinement cannot be kept (a start with another
234
+ * boundary or floor may still run); `"environment"` — the sandbox itself cannot start, so no start can. Absent ⇒ read as
235
+ * `"environment"` (a refusal that cannot tell reads the stricter way). */
236
+ refusedBy?: ConfinementRefusal;
218
237
  constructor(code: ExecutionErrorCode, message: string, cause?: Error, partial?: {
219
238
  stdout?: string;
220
239
  stderr?: string;
@@ -243,6 +262,11 @@ export declare class AgentHarnessError extends Error {
243
262
  code: AgentHarnessErrorCode;
244
263
  constructor(code: AgentHarnessErrorCode, message: string, cause?: Error);
245
264
  }
265
+ /** A prompt that opens its turn on the input queued for it found none queued once the turn-open hooks had run. Refused before
266
+ * the run starts: no message is written and no model request is made. */
267
+ export declare class NothingQueuedError extends AgentHarnessError {
268
+ constructor();
269
+ }
246
270
  /**
247
271
  * The PERSISTED placement tuple of a session created into a placement partition (subagent
248
272
  * transcript persistence — the durable half of the delegation continuation contract). Written ONCE
@@ -349,6 +373,11 @@ export interface ExecutionEnvExecOptions {
349
373
  /** VENDORED EDIT (the byte floor) — the read-deny table this start judges with ({@link ReadFloor}): a call's own pinned table, else the run's; every start a run makes carries it, whether or not its output reaches the model.
350
374
  * What its processes OPEN is the environment's to keep ({@link ExecutionEnvCapabilities.keepsReadFloor}). Absent ⇔ the table holds no row, or the start is no run's (`runExecGate`, the oracle's isolation probe). */
351
375
  readFloor?: ReadFloor;
376
+ /** The OS sandbox this start runs in ({@link CommandSandboxInstruction}): the start runs with every entry of its boundary
377
+ * kept — beside every row of `readFloor` — or does not start (`sandbox_unavailable`); never kept in part, never started
378
+ * without it. Carried only to an environment that declares {@link ExecutionEnvCapabilities.commandSandbox}, only by a start
379
+ * a model-written command makes in a run that requires the sandbox. Absent ⇒ the start runs as it always did. */
380
+ sandbox?: CommandSandboxInstruction;
352
381
  }
353
382
  /** The read-deny table one command start carries ({@link ExecutionEnvExecOptions.readFloor}); what an environment keeps of it is INTEGRATION-CORE §11.1.
354
383
  * Path semantics: a path is judged as spelled, never resolved (a hard link is another path; a symbolic link is resolved where the environment opens it). Pinned at the start: a floor with an `id` judges with that start's table for its processes' life. Exec is no read: a `#!` line's bytes, a self-printing binary (KNOWN-LIMITS KL-3190-a). */
@@ -392,8 +421,12 @@ export interface FileSystem {
392
421
  maxLines?: number;
393
422
  abortSignal?: AbortSignal;
394
423
  }): Promise<Result<string[], FileError>>;
395
- /** Read a binary file. */
396
- readBinaryFile(path: string, abortSignal?: AbortSignal): Promise<Result<Uint8Array, FileError>>;
424
+ /** Read a binary file. `maxBytes` (optional, a non-negative whole number): the read stops at that many bytes — a longer file is
425
+ * answered as its first `maxBytes` bytes and no more is read or held, so a caller that must know a file is past a cap asks for the
426
+ * cap plus one and judges the length it was answered. Absent ⇒ the whole file (the answer before the parameter existed). Any other
427
+ * value (negative, `NaN`, not whole, not a number) is refused (`invalid`), never read as "no limit". An environment that does not
428
+ * read the parameter answers the whole file: a caller judges the length it was answered, never the parameter it passed. */
429
+ readBinaryFile(path: string, abortSignal?: AbortSignal, maxBytes?: number): Promise<Result<Uint8Array, FileError>>;
397
430
  /** Create or overwrite a file, creating parent directories when supported. Implementation note
398
431
  * (RB-221): the Node env replaces the file as a WHOLE (same-directory staging + fsync +
399
432
  * rename; `aborted` ⇒ target untouched), falling back to an in-place rewrite where rename cannot
@@ -517,7 +550,7 @@ export interface Shell {
517
550
  *
518
551
  * Every key is REQUIRED and has no default reading: for each one, either answer an absent value could be given is
519
552
  * wrong for some environment, so an adapter states it. A value that is absent, not a boolean, or cannot be received (a
520
- * throwing getter, a Proxy — a JS adapter's block) — and a member outside the eight keys — is announced once per run at
553
+ * throwing getter, a Proxy — a JS adapter's block) — and a member outside the nine keys — is announced once per run at
521
554
  * the admission point (`config.execution_env_capability_invalid`, `detail.key` naming it, or `capabilities` for a block
522
555
  * that is no object or cannot be received), and each reader takes that key's SAFE side, written beside the readers
523
556
  * (`UNDECLARED_CAPABILITY_READING`, `src/core/remote-env.ts`). Every key is read through its one reader there.
@@ -614,6 +647,14 @@ export interface ExecutionEnvCapabilities {
614
647
  * at prepare when the deployment sets `RunnerDeps.readDenyFloorRequired`. `StubExecutionEnv` declares `true`:
615
648
  * it refuses every start, so no byte can be read through it. Undeclared ⇒ `false`. Read through `keepsReadFloor`. */
616
649
  readonly keepsReadFloor: boolean;
650
+ /** True iff this environment keeps a command start inside the OS sandbox the start carries
651
+ * ({@link ExecutionEnvExecOptions.sandbox}): every entry of its boundary, its byte floor's rows beside them, kept for every
652
+ * program the command runs — or the start is refused (`sandbox_unavailable`, naming the entry), never run with fewer. A run
653
+ * that requires the sandbox (`TaskSpec.sandbox.enabled`) runs its model-written commands in it only here; elsewhere it is
654
+ * refused at prepare, or — when the task sets `failIfUnavailable: false` — announced (`config.command_sandbox_unavailable`)
655
+ * and run unsandboxed. `false` for an environment that has no such sandbox (`NodeExecutionEnv`, an SSH host, a device).
656
+ * `StubExecutionEnv` declares `true`: it refuses every start. Undeclared ⇒ `false`. Read through `providesCommandSandbox`. */
657
+ readonly commandSandbox: boolean;
617
658
  }
618
659
  /** Filesystem and process execution environment used by the harness. */
619
660
  export interface ExecutionEnv extends FileSystem, Shell {
@@ -785,7 +826,16 @@ export interface AnnouncedListingSnapshot {
785
826
  mcpFailed?: AnnouncedMcpFailure[];
786
827
  advisories?: string[];
787
828
  advisor?: AnnouncedAdvisorState;
829
+ language?: AnnouncedLanguageState;
830
+ }
831
+ /** What the model was told about the reply language (`TaskSpec.language`), and in which SEGMENT (the advisor arm's reading):
832
+ * `value` is the language stated, `null` the cleared preference. A record from another segment reads as nothing told. */
833
+ export interface AnnouncedLanguageState {
834
+ value: string | null;
835
+ segment: string | null;
788
836
  }
837
+ /** The language seat's bound — the reference's own (`string().max(256)`) — and the record's, so a stated language is recordable. */
838
+ export declare const ANNOUNCED_LANGUAGE_MAX_CHARS = 256;
789
839
  /** What the model was told about the advisor tool, and in which SEGMENT of the conversation — the id of the branch's
790
840
  * latest compaction entry when the telling was delivered, `null` before any. A record from another segment reads as
791
841
  * nothing told: a compaction summarized the telling away. */
@@ -801,6 +851,7 @@ export interface AnnouncedListingSnapshotInput {
801
851
  mcpFailed?: ReadonlyArray<AnnouncedMcpFailure>;
802
852
  advisories?: readonly string[];
803
853
  advisor?: Readonly<AnnouncedAdvisorState>;
854
+ language?: Readonly<AnnouncedLanguageState>;
804
855
  }
805
856
  /**
806
857
  * REF-D3/D4 merge target: the active EnterWorktree session (M22 live-CC anchor —
@@ -1114,10 +1165,12 @@ export interface SessionMetadata {
1114
1165
  export type SessionRow<TMetadata extends SessionMetadata = SessionMetadata> = TMetadata & {
1115
1166
  readonly lastActiveAt?: number;
1116
1167
  };
1117
- /** One row's owner, occupant (`undefined` = unknown) and active leaf (`null` = none), read in ONE read so the three answer for one row generation. */
1168
+ /** One row's owner, occupant (absent = unknown) and active leaf (`null` = none), read in ONE read so the three answer for one row generation.
1169
+ * A head the bundled repos build names no `incarnation` key when the row's occupant is unknown (a host-held row, a row that predates the
1170
+ * cell): the key is present only with a token, so "present" and "defined" are one reading. */
1118
1171
  export interface SessionHead {
1119
1172
  readonly owner: string | null;
1120
- readonly incarnation: string | undefined;
1173
+ readonly incarnation?: string | undefined;
1121
1174
  readonly leafId: string | null;
1122
1175
  }
1123
1176
  /** Where a log stood when read: its entry count and last entry id (`null` = empty). Every append adds an id the log never held, so an
@@ -1129,11 +1182,13 @@ export interface SessionLogMark {
1129
1182
  /** What a conditional write of a session row expects of the row, judged by the repo INSIDE the write's own step (`sessionRowMatches`); a
1130
1183
  * miss is refused `SessionError("conflict")` with nothing written, as the leaf CAS refuses a stale append. It is the row as a read of it
1131
1184
  * answered: `row` = that read's owner and occupant cell (a {@link SessionHead} serves; `null` = no row), `log` (when the log binds) = the
1132
- * log's mark as read — a replacement judged against the log binds it, a deletion owed to the occupant does not. */
1185
+ * log's mark as read — a replacement judged against the log binds it, a deletion owed to the occupant does not. A repo whose host holds
1186
+ * the occupant cells ({@link SessionRepoRowCells} `"host"`) judges the owner and the log, and refuses an expectation naming an
1187
+ * occupant (a `TypeError`): its host's store judges that one. */
1133
1188
  export interface SessionRowExpectation {
1134
1189
  readonly row: {
1135
1190
  readonly owner: string | null;
1136
- readonly incarnation: string | undefined;
1191
+ readonly incarnation?: string | undefined;
1137
1192
  } | null;
1138
1193
  readonly log?: SessionLogMark;
1139
1194
  }
@@ -1307,6 +1362,9 @@ export interface SessionForkOptions {
1307
1362
  id?: string;
1308
1363
  }
1309
1364
  export interface SessionRepo<TMetadata extends SessionMetadata = SessionMetadata, TCreateOptions extends SessionCreateOptions = SessionCreateOptions, TListOptions = void> {
1365
+ /** Who holds this repo's rows' occupant cells ({@link SessionRepoRowCells}); absent reads as `"engine"` — the repo does. A repo whose
1366
+ * host holds them (`"host"`) writes and hands out neither cell, and `TtlSessionStore` refuses it (that layer has no occupant source). */
1367
+ readonly rowCells?: SessionRepoRowCells;
1310
1368
  create(options: TCreateOptions): Promise<Session<TMetadata>>;
1311
1369
  open(metadata: TMetadata): Promise<Session<TMetadata>>;
1312
1370
  /** Every ordinary row (placed rows are not listed), each with the newest write the repo holds for it ({@link SessionRow}), in no
@@ -1319,6 +1377,12 @@ export interface SessionRepo<TMetadata extends SessionMetadata = SessionMetadata
1319
1377
  * removal's own step and on a miss — no row, another generation, or (when the log binds) another log — removes nothing and refuses
1320
1378
  * `SessionError("conflict")` ({@link readRow}: which repos judge it). */
1321
1379
  delete(metadata: TMetadata, expect?: SessionRowExpectation): Promise<void>;
1380
+ /** Remove the row only while its head cannot be read: in the removal's own step the repo reads the head, and only a read refused
1381
+ * `SessionError("corrupt_session")` removes the row and its whole log and answers `true`; a readable row or no row removes nothing and
1382
+ * answers `false`; any other fault of that read rejects with it, nothing removed. It reads neither owner nor occupant (an unreadable
1383
+ * row has none to name). Optional: a repo whose rows cannot be unreadable has none, and `TtlSessionStore` then offers no
1384
+ * `deleteUnreadable`. */
1385
+ deleteUnreadable?(sessionId: string): Promise<boolean>;
1322
1386
  /** A fork is a NEW row: `options.id` equal to the source's id is refused (`invalid_fork_target`) — onto its source it would mint a new occupant over the source's own transcript. */
1323
1387
  fork(source: TMetadata, options: SessionForkOptions & TCreateOptions): Promise<Session<TMetadata>>;
1324
1388
  /**
@@ -1431,6 +1495,8 @@ export interface TurnBoundaryEvent {
1431
1495
  model: Model;
1432
1496
  /** The loop's continuation fact, as defined at {@link import("../loop/types.js").PrepareNextTurnContext.continues}. */
1433
1497
  continues: boolean;
1498
+ /** The assistant message that completed the turn just ended (the loop's `PrepareNextTurnContext.message`). */
1499
+ message: AssistantMessage;
1434
1500
  }
1435
1501
  export interface BeforeProviderRequestEvent {
1436
1502
  type: "before_provider_request";
@@ -1678,6 +1744,9 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
1678
1744
  text: string;
1679
1745
  cacheControlBoundary: boolean;
1680
1746
  }>;
1747
+ /** The locale of the engine's own texts this leg sends (`TaskSpec.promptLocale`; absent ⇒ canonical). Static per leg;
1748
+ * every context the harness builds carries it (`AgentContext.promptLocale`). */
1749
+ promptLocale?: import("../../prompt-assembly/catalog/schema.js").RenderedLocale;
1681
1750
  getApiKeyAndHeaders?: (model: Model) => Promise<{
1682
1751
  apiKey: string;
1683
1752
  headers?: Record<string, string>;
@@ -1732,10 +1801,12 @@ export interface AgentHarnessOptions<TSkill extends Skill = Skill, TPromptTempla
1732
1801
  imageProcessor?: import("../loop/types.js").AgentLoopConfig["imageProcessor"];
1733
1802
  /** Loop-config pass-through — see `AgentLoopConfig.onImageUnprocessed` (an image that goes on unprocessed over the soft target). */
1734
1803
  onImageUnprocessed?: import("../loop/types.js").AgentLoopConfig["onImageUnprocessed"];
1804
+ /** Loop-config pass-through — see `AgentLoopConfig.toolResultBytes` (where the tool-result seat keeps bytes it refused for their size). */
1805
+ toolResultBytes?: import("../loop/types.js").AgentLoopConfig["toolResultBytes"];
1735
1806
  /**
1736
1807
  * design/131 (拍): per-task resilience intent flags, forwarded to every provider
1737
- * call (`StreamOptions.resilience`) so the deployment's decorator stack (degrading / failover /
1738
- * breaker) can stand aside for this task. Absent ⇒ today's behavior.
1808
+ * call (`StreamOptions.resilience`) so the engine's model lane and the deployment's decorator stack
1809
+ * (failover / breaker) can stand aside for this task. Absent ⇒ today's behavior.
1739
1810
  */
1740
1811
  resilience?: import("../llm/types.js").ResilienceOptions;
1741
1812
  /** design/120 P1: parallel-batch tool concurrency cap forwarded to the loop (default 10). */
@@ -34,6 +34,7 @@ export class ExecutionError extends Error {
34
34
  partialStdout;
35
35
  partialStderr;
36
36
  noOutputSec;
37
+ refusedBy;
37
38
  constructor(code, message, cause, partial, noOutputSec) {
38
39
  super(message, cause === undefined ? undefined : { cause });
39
40
  this.name = "ExecutionError";
@@ -73,6 +74,13 @@ export class AgentHarnessError extends Error {
73
74
  this.code = code;
74
75
  }
75
76
  }
77
+ export class NothingQueuedError extends AgentHarnessError {
78
+ constructor() {
79
+ super("invalid_state", "the prompt opens its turn on the input queued for it, and none was queued");
80
+ this.name = "NothingQueuedError";
81
+ }
82
+ }
83
+ export const ANNOUNCED_LANGUAGE_MAX_CHARS = 256;
76
84
  export const REMINDER_MARK_MAX_CHARS = 64;
77
85
  export function normalizeReminderMark(v) {
78
86
  if (typeof v !== "object" || v === null)
@@ -334,7 +342,18 @@ export function normalizeAnnouncedListing(v) {
334
342
  return (state === "announced" || state === "withdrawn") && segmentOk ? { state, segment: segment } : null;
335
343
  };
336
344
  const advisor = advisorArm(src.advisor);
337
- if (agents === null || skills === null || models === null || mcpFailed === null || advisories === null || advisor === null)
345
+ const languageArm = (a) => {
346
+ if (a === undefined)
347
+ return undefined;
348
+ if (typeof a !== "object" || a === null)
349
+ return null;
350
+ const { value, segment } = a;
351
+ const valueOk = value === null || (typeof value === "string" && value.length > 0 && value.length <= ANNOUNCED_LANGUAGE_MAX_CHARS);
352
+ const segmentOk = segment === null || (typeof segment === "string" && segment.length <= ANNOUNCED_LISTING_MAX_NAME_CHARS);
353
+ return valueOk && segmentOk ? { value: value, segment: segment } : null;
354
+ };
355
+ const language = languageArm(src.language);
356
+ if (agents === null || skills === null || models === null || mcpFailed === null || advisories === null || advisor === null || language === null)
338
357
  return undefined;
339
358
  return {
340
359
  ...(agents !== undefined ? { agents } : {}),
@@ -343,5 +362,6 @@ export function normalizeAnnouncedListing(v) {
343
362
  ...(mcpFailed !== undefined ? { mcpFailed } : {}),
344
363
  ...(advisories !== undefined ? { advisories } : {}),
345
364
  ...(advisor !== undefined ? { advisor } : {}),
365
+ ...(language !== undefined ? { language } : {}),
346
366
  };
347
367
  }
@@ -116,6 +116,10 @@ export interface ToolTurnView {
116
116
  /** The request view — the input array itself when {@link repairs} is empty. */
117
117
  readonly messages: Message[];
118
118
  readonly repairs: readonly ToolTurnRepair[];
119
+ /** Each result of {@link messages} that folds two or more recorded results into one, and the results it folds, in
120
+ * order — a reader that judges a recorded result by its own record (its `details`, which the fold keeps only for the
121
+ * first) reads the parts here; their contents stand in the fold in this order, joined by {@link SECOND_RESULT_SEPARATOR}. */
122
+ readonly folds: ReadonlyMap<Message, readonly Message[]>;
119
123
  }
120
124
  /** The text standing between two results recorded for one call when the view folds them into one. */
121
125
  export declare const SECOND_RESULT_SEPARATOR = "[another result was recorded for this same call:]";
@@ -82,6 +82,7 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
82
82
  });
83
83
  const repairs = [];
84
84
  const out = [];
85
+ const folds = new Map();
85
86
  messages.forEach((m, i) => {
86
87
  if (ownerOf.has(i) || orphans.has(i))
87
88
  return;
@@ -118,7 +119,11 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
118
119
  for (const [id, at] of recorded) {
119
120
  const real = at.filter((r) => !isInterruptedClose(messages[r]));
120
121
  const chosen = real.length > 0 ? real : at.slice(0, 1);
121
- sent.set(id, chosen.map((r) => messages[r]).reduce(foldResults));
122
+ const parts = chosen.map((r) => messages[r]);
123
+ const folded = parts.reduce(foldResults);
124
+ if (parts.length > 1)
125
+ folds.set(folded, parts);
126
+ sent.set(id, folded);
122
127
  if (anchor[chosen[0]] !== i)
123
128
  late.push(id);
124
129
  if (at.length > 1)
@@ -139,7 +144,7 @@ export function ensureToolTurnInvariants(messages, priorMessages) {
139
144
  });
140
145
  if (orphans.size > 0)
141
146
  repairs.push({ form: "orphan_result", toolCallIds: [...new Set([...orphans].map((i) => messages[i].toolCallId))] });
142
- return repairs.length === 0 ? { messages, repairs } : { messages: out, repairs };
147
+ return repairs.length === 0 ? { messages, repairs, folds } : { messages: out, repairs, folds };
143
148
  }
144
149
  function foldResults(first, second) {
145
150
  return { ...first, content: [...first.content, { type: "text", text: SECOND_RESULT_SEPARATOR }, ...second.content], isError: first.isError && second.isError };
@@ -5,7 +5,7 @@ import type { ProviderCondition, ProviderConditionSource } from "../../brain/pro
5
5
  import type { RequestRoute, RouteCarrierBag, RouteCredentialSource } from "../../brain/request-route.js";
6
6
  export type { RouteCredentialSource } from "../../brain/request-route.js";
7
7
  import type { ModelOutputInvalidCause } from "./tool-turns.js";
8
- import type { PromptTraitName, TraitCondition } from "../../prompt-assembly/catalog/schema.js";
8
+ import type { PromptTraitName, RenderedLocale, TraitCondition } from "../../prompt-assembly/catalog/schema.js";
9
9
  export type KnownApi = "openai-completions" | "mistral-conversations" | "openai-responses" | "azure-openai-responses" | "openai-chatgpt-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "google-vertex";
10
10
  export type Api = KnownApi | (string & {});
11
11
  export type KnownImagesApi = "openrouter-images";
@@ -23,7 +23,12 @@ export type ImagesProvider = string;
23
23
  export type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
24
24
  export type ModelThinkingLevel = "off" | ThinkingLevel;
25
25
  export type ThinkingLevelMap = Partial<Record<ModelThinkingLevel, string | null>>;
26
- export type CacheRetention = "none" | "short" | "long";
26
+ /** The prompt-cache retention words, the one list the deployment seat (`RunnerDeps.cacheRetention`) and the Anthropic mint judge
27
+ * by: `short` = the provider's default cache lifetime, `long` = its extended one, `none` = no prompt-cache breakpoint. */
28
+ export declare const CACHE_RETENTION_WORDS: readonly ["none", "short", "long"];
29
+ export type CacheRetention = (typeof CACHE_RETENTION_WORDS)[number];
30
+ /** Whether a value is one of the retention words. */
31
+ export declare function isCacheRetention(value: unknown): value is CacheRetention;
27
32
  export type Transport = "sse" | "websocket" | "websocket-cached" | "auto";
28
33
  export type MaybePromise<T> = T | Promise<T>;
29
34
  export interface ProviderResponse {
@@ -73,8 +78,10 @@ export interface StreamOptions {
73
78
  */
74
79
  transport?: Transport;
75
80
  /**
76
- * Prompt cache retention preference. Providers map this to their supported values.
77
- * Default: "short".
81
+ * Prompt cache retention ({@link CACHE_RETENTION_WORDS}); absent ⇒ `"short"`. Only the Anthropic brain maps it — `short`: its
82
+ * breakpoints as today (`{type:"ephemeral"}`); `long`: `ttl:"1h"` (a cache write billed 2×, not 1.25×); `none`: no breakpoint;
83
+ * any other value is refused (`config.invalid_argument`). The OpenAI and Open Responses brains send no retention parameter. A
84
+ * Runner writes a set `RunnerDeps.cacheRetention` here on every call of its Brain seat, over the call's own value; nothing else does.
78
85
  */
79
86
  cacheRetention?: CacheRetention;
80
87
  /**
@@ -259,9 +266,15 @@ export interface ToolCall {
259
266
  export interface Usage {
260
267
  input: number;
261
268
  output: number;
262
- cacheRead: number;
263
- cacheWrite: number;
269
+ /** Prompt tokens served from the provider's prefix cache; absent — not 0 — when unreported (a reported 0 is a measured 0). */
270
+ cacheRead?: number;
271
+ /** Prompt tokens written to the provider's prefix cache, at either lifetime; absent — not 0 — when unreported (the OpenAI shapes never report it). */
272
+ cacheWrite?: number;
273
+ /** A SUBSET of `cacheWrite` written at the one-hour lifetime; absent — not 0 — when the provider did not state the split, never added to the writes. */
274
+ cacheWriteLong?: number;
264
275
  totalTokens: number;
276
+ /** A SUBSET of `output` the provider spent reasoning (not in `totalTokens`, not priced); absent — not 0 — when unreported; a count beyond `output` is not recorded and the turn is `usageMissing`. */
277
+ reasoning?: number;
265
278
  cost: {
266
279
  input: number;
267
280
  output: number;
@@ -358,6 +371,13 @@ export interface UserMessage {
358
371
  engineMinted?: true;
359
372
  /** #1036 — this frame's injection-queue dedup key, with `provenance:"engine-note"`; OPAQUE (equality only), the DURABLE half of frame identity. */
360
373
  engineNoteKey?: string;
374
+ /**
375
+ * The changed-files notices this message carries ({@link ChangedFilesNotice}): a request carries each listed
376
+ * (path, modification time) once — the earliest notice of it in the request's view — and leaves out a notice whose every
377
+ * file an earlier one in the view lists. Absent = no notice, or one written before the record existed (sent as written).
378
+ * Read through {@link changedFilesNoticesOf} only. Same additive / never-on-the-wire posture as the fields above.
379
+ */
380
+ changedFilesNotices?: ReadonlyArray<ChangedFilesNotice>;
361
381
  /**
362
382
  * [c209-C] R3 收口 — the "visible but not the user" THIRD state. This message is an
363
383
  * ENGINE-INJECTED note whose CONTENT the model must read (LSP `<new-diagnostics>` blocks,
@@ -399,14 +419,16 @@ export interface UserMessage {
399
419
  runOrigin?: import("../../core/run-origin.js").RunOrigin;
400
420
  /**
401
421
  * The DELIVERY RECORD of a user-attachment frame: this message is the engine-minted frame carrying one attachment
402
- * the user declared on the human message it follows, or one file a landed compaction re-read
403
- * (`origin: "compaction_restore"`, after the compaction entry) — it always rides with `provenance:"engine-note"`. The one
404
- * source of "what was delivered": read-state commit and rebuild, the `human_input` projection, the receipt, the
422
+ * the user declared on the human message it follows, one file a landed compaction re-read (`origin: "compaction_restore"`,
423
+ * after the compaction entry) or one instruction file (`origin`) — it always rides with `provenance:"engine-note"`. The
424
+ * one source of "what was delivered": read-state commit and rebuild, the `human_input` projection, the receipt, the
405
425
  * derived views, compaction cut points and `resumeAt` read this record, never the frame's text. Metadata only —
406
426
  * never sent to a provider (brains rebuild wire messages field by field; {@link stripEngineMetadata} strips it for a
407
427
  * custom Brain); the session import door strips it (an imported frame is an ordinary engine note).
408
428
  */
409
429
  attachment?: UserMessageAttachment;
430
+ /** The attachments an engine-minted turn-boundary bundle message carries, in text order: per attachment its `source` and `chars` ({@link import("../../core/attachment-source.js").BundledAttachment}); present iff the message is `engineMinted` and bundled at least one; metadata only (never sent to a provider), kept by the import door in its canonical shape only; NOT {@link UserMessage.attachment}. */
431
+ attachments?: ReadonlyArray<import("../../core/attachment-source.js").BundledAttachment>;
410
432
  /** {@link RowRewrittenBy} */
411
433
  rewrittenBy?: RowRewrittenBy;
412
434
  }
@@ -420,8 +442,11 @@ export type RowRewrittenBy = readonly string[];
420
442
  export type UserAttachmentKind = "text" | "notebook" | "image" | "pdf" | "directory" | "client_text" | "client_image";
421
443
  /** Who held the bytes: the engine read a path in its workspace, or the host supplied text / an image. */
422
444
  export type UserAttachmentSupply = "path" | "content_text" | "content_image";
423
- /** What reached the model of the attachment's contents (the Read layer's outcome words). */
424
- export type UserAttachmentOutcome = "attached" | "partial" | "unchanged" | "not_attached";
445
+ /** What the engine delivered of the attachment's contents (the Read layer's outcome words). `attached` = the frame holds
446
+ * them: a request carries them as the frame's data, or — when it already carries the same contents earlier — as the
447
+ * sentence that they are not repeated beside that earlier copy, or — when its core cannot hold them — as the sentence
448
+ * that they are not included. */
449
+ export type UserAttachmentOutcome = "attached" | "partial" | "not_attached";
425
450
  /** The read-state entry a path attachment's delivery committed (the Read layer's observation, verbatim). */
426
451
  export interface UserAttachmentObservation {
427
452
  readonly key: string;
@@ -435,6 +460,7 @@ export interface UserAttachmentObservation {
435
460
  readonly end: number;
436
461
  };
437
462
  };
463
+ readonly stampedAt?: number;
438
464
  }
439
465
  /** See {@link UserMessage.attachment}. */
440
466
  export interface UserMessageAttachment {
@@ -442,8 +468,9 @@ export interface UserMessageAttachment {
442
468
  * ({@link origin}), the id of the one compaction restore it belongs to. */
443
469
  readonly inputId: string;
444
470
  /** `compaction_restore`: the engine minted this frame itself after a compaction landed, re-reading a file the
445
- * conversation had read (`ordinal` / `count` among the files that restore re-read). Absent: the user declared it. */
446
- readonly origin?: "compaction_restore";
471
+ * conversation had read (`ordinal` / `count` among the files that restore re-read); `project_instructions` / `nested_memory`:
472
+ * an instruction file of the task root / of an accessed directory or a deployment's rule (among one load's). Absent: the user's. */
473
+ readonly origin?: "compaction_restore" | "nested_memory" | "project_instructions";
447
474
  /** 1-based position among that input's declared attachments, and how many it declared. */
448
475
  readonly ordinal: number;
449
476
  readonly count: number;
@@ -455,6 +482,9 @@ export interface UserMessageAttachment {
455
482
  readonly label: string;
456
483
  /** Present on a path attachment whose delivery recorded read state. */
457
484
  readonly observation?: UserAttachmentObservation;
485
+ /** An instruction frame that withdraws a file delivered earlier (removed, or holding nothing now): the file's canonical key.
486
+ * No data; its delivery and a replay delete that key's read-state entry while an instruction frame recorded it. */
487
+ readonly withdraws?: string;
458
488
  /** `[start, end)` indices into the message's `content` of the data the attachment delivered (the file's own blocks,
459
489
  * or the engine's refusal sentence); the engine's marked sentences and the label line sit outside it. */
460
490
  readonly dataBlocks: {
@@ -570,6 +600,8 @@ export interface AssistantMessage {
570
600
  providerConditionSource?: ProviderConditionSource;
571
601
  /** With `quota_exhausted` whose evidence stated it: when the quota lifts (wall-clock epoch ms). */
572
602
  providerResetAtMs?: number;
603
+ /** The provider's own sentence for the failure ({@link BrainStatus.providerMessage}); on a 4xx also `terminal.detail.providerMessage`. Absent for a plain-text, torn, unended or empty body and for an in-band frame. */
604
+ providerMessage?: string;
573
605
  /** The failing request's route as its brain stated it ({@link RequestRoute}; never a key value or a URL); on a 4xx also
574
606
  * `terminal.detail.route`. PRESENCE: beside {@link isApiErrorMessage} on an engine-minted provider failure whose
575
607
  * committed request stated one; absent on success, an abort, a refusal minted before any request was built. */
@@ -687,10 +719,27 @@ export interface AssistantMessage {
687
719
  * the 2-downgrade stop-loss. Additive — absent everywhere else (incl. the dynamicCut shape).
688
720
  */
689
721
  staticReasoningCut?: true;
722
+ /**
723
+ * The extension that answered this turn in the model's place (a `prompt.submit` handler's `{ reply }`): the row is
724
+ * that answer — no model was called for it, so it carries no model account (its `usage` is a known zero, never
725
+ * flagged missing) and `model` / `provider` / `api` name the leg's model, not who wrote it. PRESENCE: set only on a
726
+ * row the engine minted from such an answer; absent on every row a model wrote. Kept on the stored row; never on a
727
+ * provider payload ({@link stripEngineMetadata}).
728
+ */
729
+ answeredBy?: string;
690
730
  /** {@link RowRewrittenBy} */
691
731
  rewrittenBy?: RowRewrittenBy;
692
732
  timestamp: number;
693
733
  }
734
+ /** Whether a row is an answer an extension gave in the model's place ({@link AssistantMessage.answeredBy}) — the one
735
+ * reading every account keyed on "did this turn call a model" reads. */
736
+ export declare function answeredWithoutModel<M extends {
737
+ readonly role: string;
738
+ readonly answeredBy?: unknown;
739
+ }>(m: M): m is M & {
740
+ readonly role: "assistant";
741
+ readonly answeredBy: string;
742
+ };
694
743
  export interface ToolResultMessage<TDetails = unknown> {
695
744
  role: "toolResult";
696
745
  toolCallId: string;
@@ -703,13 +752,37 @@ export interface ToolResultMessage<TDetails = unknown> {
703
752
  timestamp: number;
704
753
  }
705
754
  export type Message = UserMessage | AssistantMessage | ToolResultMessage;
755
+ /** One changed-files notice block on a user-lane message, in the coordinate of {@link UserMessage.engineSegments}
756
+ * (`[start, end)` UTF-16 offsets into the message's flattened text content): the block, and each file it lists — the
757
+ * (path, modification time) the model is told about — with the range of its list line (its leading line break included,
758
+ * so cutting the range leaves the list well formed). */
759
+ export interface ChangedFilesNotice {
760
+ readonly start: number;
761
+ readonly end: number;
762
+ readonly files: ReadonlyArray<{
763
+ readonly path: string;
764
+ readonly mtimeMs: number;
765
+ readonly start: number;
766
+ readonly end: number;
767
+ }>;
768
+ }
769
+ /** The message's flattened text (its text blocks in order) — the coordinate engine ranges index. */
770
+ export declare function flattenedUserText(content: UserMessage["content"]): string;
771
+ /**
772
+ * The well-formed changed-files notices of a user-lane message, or `undefined` — the one reader of
773
+ * {@link UserMessage.changedFilesNotices}. Every range must lie in the flattened text, notices ascending and disjoint, each
774
+ * file's line inside its notice, ascending and disjoint; one malformed entry voids the whole field (the notices are then
775
+ * carried as written — the conservative direction, as for {@link UserMessage.engineSegments}).
776
+ */
777
+ export declare function changedFilesNoticesOf(m: unknown): ReadonlyArray<ChangedFilesNotice> | undefined;
706
778
  /**
707
779
  * RB-3 (stage S4 carry): strip the engine-provenance metadata fields from user messages before
708
- * serializing a Context to an external wire. The eight fields (`enginePrefixChars`/`engineSegments`/
709
- * `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`runOrigin`) are INTERNAL coordination between the engine's
710
- * minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
711
- * multiplayer attribution, attachment delivery, run attribution) — they must never reach a provider payload; so is
712
- * {@link RowRewrittenBy}, on every role. The built-in brains construct
780
+ * serializing a Context to an external wire. The ten fields (`enginePrefixChars`/`engineSegments`/
781
+ * `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`attachments`/`runOrigin`/`changedFilesNotices`) are INTERNAL coordination
782
+ * between the engine's minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
783
+ * multiplayer attribution, attachment delivery, run attribution, the request's notice projection) — they must never reach a
784
+ * provider payload; so is
785
+ * {@link RowRewrittenBy}, on every role, and {@link AssistantMessage.answeredBy}. The built-in brains construct
713
786
  * their own wire shapes and are immune; a CUSTOM Brain that whole-object-serializes messages
714
787
  * (`JSON.stringify(context.messages)`) would leak them — run the array through this projection first.
715
788
  */
@@ -771,6 +844,8 @@ export interface Context {
771
844
  }>;
772
845
  messages: Message[];
773
846
  tools?: Tool[];
847
+ /** The locale an adapter renders its own texts in (an image provenance line); `TaskSpec.promptLocale`, absent ⇒ canonical. */
848
+ promptLocale?: RenderedLocale;
774
849
  }
775
850
  /**
776
851
  * Event protocol for AssistantMessageEventStream.
@@ -886,7 +961,7 @@ export interface AssistantMessageEventStreamLike extends AsyncIterable<Assistant
886
961
  * {@link OpenAIResponsesCompat}, and now gated by `gate:field-liveness`).
887
962
  */
888
963
  export interface OpenAICompletionsCompat {
889
- /** Whether the provider supports `reasoning_effort`. Default: auto-detected from URL. */
964
+ /** Whether the provider supports `reasoning_effort`. Absent = supported; only an explicit `false` sends no effort value. */
890
965
  supportsReasoningEffort?: boolean;
891
966
  /**
892
967
  * Which `reasoning_effort` tiers this endpoint accepts. Absent → the conservative default
@@ -901,7 +976,7 @@ export interface OpenAICompletionsCompat {
901
976
  * OpenAI-compatible endpoints accept. Declare explicitly to override the inference
902
977
  * (design/119 #3; see `inferMaxTokensField` in brain/openai). */
903
978
  maxTokensField?: "max_completion_tokens" | "max_tokens";
904
- /** Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled. Default: auto-detected from URL. */
979
+ /** Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled. Absent = not required; only an explicit `true` adds the field. */
905
980
  requiresReasoningContentOnAssistantMessages?: boolean;
906
981
  /** Format for reasoning/thinking parameter. "openai" uses reasoning_effort, "openrouter" uses reasoning: { effort }, "deepseek" uses thinking: { type } plus reasoning_effort, "together" uses reasoning: { enabled } plus reasoning_effort when supported, "zai" uses top-level enable_thinking: boolean, "qwen" uses top-level enable_thinking: boolean, and "qwen-chat-template" uses chat_template_kwargs.enable_thinking. Default: "openai". */
907
982
  thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
@@ -997,10 +1072,19 @@ export interface Model<TApi extends Api = Api> {
997
1072
  *
998
1073
  * It is the REQUESTED tier, read exactly as a request's own: the per-endpoint clamp (`resolveReasoning` /
999
1074
  * `reasoningEffortLevels`) still bounds it — a stock-OpenAI endpoint clamps `max`→`high` — and a model that does
1000
- * not hold `reasoning` carries none of it. A value that is not one of the seven tiers is refused where the model
1075
+ * not hold `reasoning` carries no enabling tier. A value that is not one of the seven tiers is refused where the model
1001
1076
  * is received (the model door, `config.unknown_role` / `not_a_model_ref`), never read as absence.
1002
1077
  */
1003
1078
  defaultThinking?: ModelThinkingLevel;
1079
+ /**
1080
+ * The catalog words (≤ 3, in order) a request for this model falls back to when it fails before its first content for a
1081
+ * reason the deployment's gate admits (`RunnerDeps.modelFallback`); each hop is served by the deployment's own Brain, and
1082
+ * once content has streamed that stream is the answer. A CATALOG member: the catalog door (`new Runner` / `swapDeps`)
1083
+ * refuses a word the catalog does not hold, a word naming this entry (object or `id`), a repeat and a fourth word, and the
1084
+ * model door refuses the member on any other Model object — both `config.model_fallback_invalid`; the chain is flat (a
1085
+ * hop's own `fallbacks` are not walked). An element that is not a non-empty string is `config.unknown_role` / `not_a_model_ref`.
1086
+ */
1087
+ fallbacks?: readonly string[];
1004
1088
  /**
1005
1089
  * Maps OpenClaw thinking levels to provider/model-specific values.
1006
1090
  * Missing keys use provider defaults. null marks a level as unsupported.
@@ -1013,6 +1097,7 @@ export interface Model<TApi extends Api = Api> {
1013
1097
  output: number;
1014
1098
  cacheRead: number;
1015
1099
  cacheWrite: number;
1100
+ cacheWriteLong?: number;
1016
1101
  };
1017
1102
  contextWindow: number;
1018
1103
  /**
@@ -1070,7 +1155,7 @@ export interface Model<TApi extends Api = Api> {
1070
1155
  * `["lean_prompt"]`. A name that is none of these refuses the task (`config.prompt_trait_unknown`).
1071
1156
  */
1072
1157
  promptTraits?: readonly PromptTraitName[];
1073
- /** Compatibility overrides for OpenAI-compatible APIs. If not set, auto-detected from baseUrl. */
1158
+ /** Compatibility overrides for OpenAI-compatible APIs. A member left unset takes its own default; nothing is read off `baseUrl`. */
1074
1159
  compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
1075
1160
  }
1076
1161
  export interface ImagesModel<TApi extends ImagesApi = ImagesApi> extends Omit<Model, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
@@ -1109,8 +1194,10 @@ export interface RoutePairingConfig {
1109
1194
  * - `"paired"` — deployment credential on the deployment's own root (declared, or the lane default).
1110
1195
  * - `"keyless"` — no credential anywhere; nothing to protect. */
1111
1196
  export type RoutePairingPosture = "per-model" | "paired" | "keyless";
1112
- /** Machine codes an adjudication refusal carries (minted here, forwarded verbatim by consumers). */
1113
- export type RouteRefusalCode = "route.credential_mismatch" | "route.credential_missing" | "route.credential_origin_mismatch" | "route.credential_answer_conflict";
1197
+ /** Machine codes an adjudication refusal carries (minted here, forwarded verbatim by consumers). `config.protocol_plaintext_credentials`
1198
+ * is the one word shared with the protocol chains: a request carrying a credential to an endpoint it would reach in the clear across
1199
+ * a network (`crossesNetworkInClear`) — the same question and the same code wherever a credential is sent. */
1200
+ export type RouteRefusalCode = "route.credential_mismatch" | "route.credential_missing" | "route.credential_origin_mismatch" | "route.credential_answer_conflict" | "config.protocol_plaintext_credentials";
1114
1201
  /** The structured account of a refusal — the two halves and the fix, every URL a DISPLAY spelling. */
1115
1202
  export interface RouteRefusalDetail {
1116
1203
  modelId: string;