@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
@@ -3,10 +3,12 @@
3
3
  * restore: the file-history phase's restore seat (`prepare-file-history.ts`, a `restoreFiles` / `rewindFilesTo` run)
4
4
  * and the out-of-run rewind (`rewind-files.ts`, `Runner.rewindFiles`). A rewind outside a run is therefore the same
5
5
  * history operation as the one a run performs, refused with the same codes and sentences, and handing the paths it
6
- * moved to the same read-state channel.
6
+ * moved to the same read-state channel. The person's half of "this turn has no boundary" when the capture failed
7
+ * ({@link boundaryUnrecordedNotice}) is the same fact said at the run instead of at the rewind, so it lives here too.
7
8
  */
8
9
  import type { ExecutionEnv } from "../../internal/harness.js";
9
- import type { FileHistoryRestoreResult, FileHistoryStore, RewindFilesResult } from "../file-history-store.js";
10
+ import type { EngineNotice } from "../types.js";
11
+ import type { FileHistoryError, FileHistoryRestoreResult, FileHistoryStore, RewindFilesResult } from "../file-history-store.js";
10
12
  import type { SessionReadFileStates } from "./session-read-file-states.js";
11
13
  /** A restore outcome a seat may accept: the ledger, with `failed` (the operation could not run) already refused —
12
14
  * the out-of-run rewind's answer carries exactly this. */
@@ -43,3 +45,15 @@ export declare function fileHistoryRestoreLedgerLine(r: FileHistoryRestoreResult
43
45
  export declare function noBoundaryRefusal(target: string, sessionId: string, preview?: boolean): Error & {
44
46
  code?: string;
45
47
  };
48
+ /**
49
+ * The person's half of a boundary capture that failed (`rewind.boundary_unrecorded`, audience `user`): the turn goes on, and a
50
+ * rewind to its entry will meet {@link noBoundaryRefusal}. Minted by the boundary seat where it discloses the same failure on
51
+ * `onError` (`{ phase: "rewind" }`), so the two are one fact. `detail: { sessionId, entryId, cause }` — `entryId` is the row a
52
+ * rewind would name, `cause` the store's code from the closed set (`FILE_HISTORY_ERROR_CODES`; `aborted` for the capture's
53
+ * time fence); never the store's message, never a path. Said once per failed capture, which is at most once per run.
54
+ */
55
+ export declare function boundaryUnrecordedNotice(input: {
56
+ sessionId: string;
57
+ entryId: string;
58
+ cause: FileHistoryError["code"];
59
+ }): EngineNotice;
@@ -27,6 +27,14 @@ export function noBoundaryRefusal(target, sessionId, preview = false) {
27
27
  e.code = "rewind_snapshot.unresolvable";
28
28
  return e;
29
29
  }
30
+ export function boundaryUnrecordedNotice(input) {
31
+ const why = input.cause === "aborted" ? "saving it did not finish in time" : "the file-history store could not save it";
32
+ return {
33
+ code: "rewind.boundary_unrecorded",
34
+ message: `The files' state at the start of this turn was not recorded (${why}), so this turn cannot be rewound to; the turn itself goes on.`,
35
+ detail: { sessionId: input.sessionId, entryId: input.entryId, cause: input.cause },
36
+ };
37
+ }
30
38
  function restoredAbsPathsOf(restored, root) {
31
39
  const out = [];
32
40
  for (const key of [...restored.filesChanged, ...restored.failed.map((f) => f.path)]) {
@@ -37,7 +45,7 @@ function restoredAbsPathsOf(restored, root) {
37
45
  return out;
38
46
  }
39
47
  function rewindRefusalTail() {
40
- return `Boundaries are keyed by a turn's INITIAL entry and exist only for turns that recorded history (a RunnerDeps.fileHistoryStore wired, capture on, and the run's file history not disabled); a boundary from the retired whole-tree snapshot era is not restorable by this seat, and reaped boundaries have none.`;
48
+ return `Boundaries are keyed by the entry of the person's input that opened a turn (an engine entry ahead of it, such as a task notification, has none) and exist only for turns that recorded history (a RunnerDeps.fileHistoryStore wired, capture on, and the run's file history not disabled); a boundary from the retired whole-tree snapshot era is not restorable by this seat, and reaped boundaries have none.`;
41
49
  }
42
50
  function beforeWithoutBoundaryRefusal(target, sessionId) {
43
51
  const e = new Error(`rewind-files: entry "${target}" has no file-history boundary on session "${sessionId}" — a before-restore needs the target's own boundary and never crosses into an earlier turn, so the working tree was NOT rewound. ${rewindRefusalTail()}`);
@@ -25,18 +25,21 @@ import type { RefusalEcho } from "../refusal-echo.js";
25
25
  import { type ClassifierDenyCause, type DeniedBy, type GateOutcome, type ModeRefusal, type ModeRelease, type Settlement } from "../gate-outcome.js";
26
26
  import type { AllowRuleClearance } from "../allow-rule-shadow.js";
27
27
  import type { AutoModeClassifierRound } from "../auto-mode.js";
28
- import { type Arbitration, type AskClassification, type AskFace, type AskOrigin, type AskOriginFacts } from "../ask-origin.js";
28
+ import { type Arbitration, type AskClass, type AskClassification, type AskFace, type AskOrigin, type AskOriginFacts } from "../ask-origin.js";
29
29
  import { type PermissionResult, type ResolvedAsk, type ToolCallRequest } from "../tool-policy.js";
30
30
  import { type RewriteAccount } from "../rewrite-rejudge.js";
31
31
  import type { SafeNotifier } from "../safe-notify.js";
32
32
  import type { PermissionDeniedPayload, PreToolUseResult, ToolGateInput, ToolGateResult } from "../hooks.js";
33
33
  /** The ask a gate pass settled, as the gate captured it at its resolution site: the settlement the
34
34
  * resolver composed and the origin word the ask carried. Both or neither (invariant I1). `licensed` is the engine record's
35
- * digest of the bytes the settlement licensed: the allow exit keeps a settlement only for the bytes that run. */
35
+ * digest of the bytes the settlement licensed: the allow exit keeps a settlement only for the bytes that run. `classes` is the
36
+ * record's class set of the question the settlement answered — copied with `licensed` from the same record (the answer group
37
+ * travels as one); absent on a record that carries none. */
36
38
  export interface SettledAsk {
37
39
  settlement: Settlement;
38
40
  origin: AskOrigin;
39
41
  licensed?: string;
42
+ classes?: readonly AskClass[];
40
43
  }
41
44
  /** The facts a gate pass hands the mint. `deniedBy` is present exactly when the pass refused; `cause` only
42
45
  * beside it, when the refusing round was a classifier round that did not rule (the station's attestation,
@@ -86,13 +89,23 @@ export declare function directDeny(deniedBy: Exclude<DeniedBy, "ask_resolution">
86
89
  * without such a record settled nothing the engine can attribute: a deny is recorded as the resolver's
87
90
  * out-of-contract refusal (`approver_contract`), an allow on a real-approval ask is refused, a plain allow
88
91
  * is a posture allow; a resolution still carrying the retired `settlement` member is refused loudly;
89
- * - the LATEST resolution wins (a re-check refusal replaces the first approval; a re-approval renews it);
92
+ * - the LATEST resolution wins the RECORD (a re-check refusal replaces the first approval; a re-approval renews it);
93
+ * - a person's yes stands for the question it answered while the bytes it licensed are the bytes that run: what the allow
94
+ * exit holds an obligation against is the classes of EVERY person's yes of this pass that licenses those bytes
95
+ * ({@link SettlementLedger.answered}) — so a later answer to another question about the same bytes (a policy's re-check
96
+ * that asked its own approver, the edited bytes' new question) adds its question's classes and takes none away;
90
97
  * - a SURVIVING ask supersedes any settlement read off an earlier decision (a tighten minted a new
91
- * question; whoever resolves it settles it afresh).
98
+ * question; whoever resolves it settles it afresh) — the person's yeses with it.
92
99
  */
93
100
  export interface SettlementLedger {
94
101
  /** The ask this pass consumed, or undefined when no ask was settled (a direct deny, a plain allow). */
95
102
  readonly settled: SettledAsk | undefined;
103
+ /** The classes of the questions a PERSON said yes to on this pass, over the bytes their answers licensed: the union of the
104
+ * class sets of every settlement of a person's that is no refusal ({@link SETTLEMENT_IS_HUMAN}, read here for the records of
105
+ * both writers), each kept only while its license covers the bytes that run ({@link keepForBytes}); undefined when no such
106
+ * yes carried a class — a policy's or a configuration's answer, no settled ask, a record that carried no classes. What the
107
+ * allow exit holds a cross-boundary obligation against. */
108
+ readonly answered: readonly AskClass[] | undefined;
96
109
  /** An engine-composed settlement the gate itself minted (the unshown content ask's refusal). */
97
110
  set(settled: SettledAsk): void;
98
111
  /** Record an ask's resolution; returns the resolution the gate goes on with (the resolver's, or the engine's refusal). */
@@ -104,7 +117,7 @@ export interface SettlementLedger {
104
117
  deniedBy?: DeniedBy;
105
118
  };
106
119
  /** The allow exit: the bytes that RUN are decided — a settlement licensed for other bytes leaves the record (the call runs
107
- * unattributed). */
120
+ * unattributed), and a person's yes licensed for other bytes leaves {@link answered}. */
108
121
  keepForBytes(runs: unknown): void;
109
122
  /** A deny's recorded classifier CAUSE for this call (an inherited station's `unavailable` / `parse_error` outcome). */
110
123
  causeOf(decision: PermissionResult): ClassifierDenyCause | undefined;
@@ -1,5 +1,5 @@
1
1
  import { DENIED_BY_MAY_ECHO, screenGateOutcome, SETTLEMENT_IS_REFUSAL } from "../gate-outcome.js";
2
- import { askFaceOf, classifyAsk, headlessApprovalRemedy, unresolvedAskDenialMessage, unresolvedAskQuestionOf } from "../ask-origin.js";
2
+ import { ASK_CLASSES, askFaceOf, classifyAsk, headlessApprovalRemedy, unresolvedAskDenialMessage, unresolvedAskQuestionOf } from "../ask-origin.js";
3
3
  import { wireOf } from "../tool-name-readings.js";
4
4
  import { isProtectedWrite } from "../tool-registry.js";
5
5
  import { attestationOf, decisionText, foldHookAsk, licenseCovers } from "../tool-policy.js";
@@ -9,6 +9,7 @@ import { argsAsTheToolReads } from "../effective-path-target.js";
9
9
  import { rewriteRecordOf } from "../rewrite-rejudge.js";
10
10
  import { askUnresolvableRemedySeat } from "../ask-unresolvable-notice.js";
11
11
  import { inlineUntrusted } from "../untrusted-text.js";
12
+ import { notRecordedMark } from "../redaction-marks.js";
12
13
  import { formatHookFeedback } from "../reminder-mint.js";
13
14
  import { types } from "node:util";
14
15
  import { receive } from "../mods/kernel/receive.js";
@@ -65,17 +66,27 @@ const SETTLEMENT_IS_HUMAN = {
65
66
  policy_refused: false,
66
67
  task_aborted: false,
67
68
  };
68
- const licensedOf = (r) => (r.inputDigest !== undefined ? { licensed: r.inputDigest } : {});
69
+ const answerGroupOf = (r) => ({ ...(r.inputDigest !== undefined ? { licensed: r.inputDigest } : {}), ...(r.classes !== undefined ? { classes: r.classes } : {}) });
69
70
  const sameClasses = (a, b) => a === undefined || b === undefined ? a === b : a.length === b.length && a.every((c, i) => c === b[i]);
70
71
  export function createSettlementLedger(call) {
71
72
  let settled;
73
+ let yeses = [];
74
+ const write = (next) => {
75
+ settled = next;
76
+ if (SETTLEMENT_IS_HUMAN[next.settlement.kind] && !SETTLEMENT_IS_REFUSAL[next.settlement.kind])
77
+ yeses.push(next);
78
+ };
72
79
  const contractRefusal = (origin) => ({ settlement: { kind: "approver_contract", who: { party: "none" }, when: Date.now() }, origin });
73
80
  return {
74
81
  get settled() {
75
82
  return settled;
76
83
  },
84
+ get answered() {
85
+ const held = new Set(yeses.flatMap((y) => y.classes ?? []));
86
+ return held.size > 0 ? ASK_CLASSES.filter((c) => held.has(c)) : undefined;
87
+ },
77
88
  set(next) {
78
- settled = next;
89
+ write(next);
79
90
  },
80
91
  fromResolved(resolved, asked, req) {
81
92
  const record = attestationOf(resolved, call);
@@ -87,7 +98,7 @@ export function createSettlementLedger(call) {
87
98
  }
88
99
  const origin = asked.origin;
89
100
  const refused = (message, by) => {
90
- settled = by;
101
+ write(by);
91
102
  return { action: "deny", message, decisionReason: "mode" };
92
103
  };
93
104
  if (retired) {
@@ -106,7 +117,7 @@ export function createSettlementLedger(call) {
106
117
  if (asked.requiresRealApproval === true && !SETTLEMENT_IS_HUMAN[answer.kind]) {
107
118
  return refused(`approval required for "${call.toolName}" — this ask requires real approval; the resolution's engine record names an answer that is not a person's ("${answer.kind}") — denied fail-closed: ${asked.message ?? ""}`, contractRefusal(origin));
108
119
  }
109
- settled = { settlement: answer, origin, ...licensedOf(record) };
120
+ write({ settlement: answer, origin, ...answerGroupOf(record) });
110
121
  return resolved;
111
122
  }
112
123
  if (asked.requiresRealApproval === true) {
@@ -117,16 +128,16 @@ export function createSettlementLedger(call) {
117
128
  }
118
129
  if (resolved.action !== "deny")
119
130
  return resolved;
120
- settled = refusal !== undefined ? { settlement: refusal, origin } : contractRefusal(origin);
131
+ write(refusal !== undefined ? { settlement: refusal, origin } : contractRefusal(origin));
121
132
  return resolved;
122
133
  },
123
134
  fromDecision(decision) {
124
135
  if (decision.action === "ask")
125
136
  return { decision };
126
137
  const record = attestationOf(decision, call);
127
- const answer = record?.settlement !== undefined && record.origin !== undefined ? { settlement: record.settlement, origin: record.origin, ...licensedOf(record) } : undefined;
138
+ const answer = record?.settlement !== undefined && record.origin !== undefined ? { settlement: record.settlement, origin: record.origin, ...answerGroupOf(record) } : undefined;
128
139
  if (answer !== undefined)
129
- settled = answer;
140
+ write(answer);
130
141
  const refusal = answer !== undefined && SETTLEMENT_IS_REFUSAL[answer.settlement.kind];
131
142
  if (decision.action === "allow") {
132
143
  if (!refusal)
@@ -138,6 +149,7 @@ export function createSettlementLedger(call) {
138
149
  keepForBytes(runs) {
139
150
  if (settled !== undefined && !licenseCovers(settled.licensed, call.toolName, runs))
140
151
  settled = undefined;
152
+ yeses = yeses.filter((y) => licenseCovers(y.licensed, call.toolName, runs));
141
153
  },
142
154
  causeOf(decision) {
143
155
  return decision.action === "deny" ? attestationOf(decision, call)?.classifierCause : undefined;
@@ -147,6 +159,7 @@ export function createSettlementLedger(call) {
147
159
  },
148
160
  supersede() {
149
161
  settled = undefined;
162
+ yeses = [];
150
163
  },
151
164
  };
152
165
  }
@@ -188,7 +201,7 @@ export function frozenInputSnapshot(input) {
188
201
  Object.defineProperty(holder, last, { value: notRecorded(input, fault), enumerable: true, writable: true, configurable: true });
189
202
  }
190
203
  for (const [holder, markers] of symbolMarkers) {
191
- let key = "[not recorded: symbol-keyed members]";
204
+ let key = notRecordedMark("symbol-keyed members");
192
205
  while (Object.hasOwn(holder, key))
193
206
  key += "'";
194
207
  Object.defineProperty(holder, key, { value: markers, enumerable: true, writable: true, configurable: true });
@@ -206,7 +219,7 @@ function freezeRecord(record) {
206
219
  }
207
220
  return record;
208
221
  }
209
- const notRecorded = (input, fault) => `[not recorded: ${describeBindingFault(input, fault)}]`;
222
+ const notRecorded = (input, fault) => notRecordedMark(describeBindingFault(input, fault));
210
223
  function memberAt(value, path) {
211
224
  let at = value;
212
225
  for (const key of path)
@@ -310,7 +323,7 @@ export async function exitGate(pass) {
310
323
  const foldCause = attestationOf(pass.decision, { toolCallId, toolName })?.unresolvableCause;
311
324
  const unresolvable = foldCause ?? unresolvableCauseOfSettlement(gate);
312
325
  const tableSeat = unresolvable !== undefined ? askUnresolvableRemedySeat(unresolvable) : undefined;
313
- const remedySeat = tableSeat === "absent" && input.askSeatForm === "declared_none" && pass.askClassification?.classes.has("content_question") !== true ? "declared_none" : tableSeat;
326
+ const remedySeat = tableSeat === "absent" && input.askSeatForm === "declared_none" && pass.askClassification?.classes.has("content_question") !== true ? "declared_none" : tableSeat === "unavailable" && input.askSeatForm === "policy_callback" ? "policy" : tableSeat;
314
327
  const bindingRefusal = attestationOf(pass.decision, { toolCallId, toolName })?.bindingRefusal;
315
328
  const headless = bindingRefusal !== undefined ? undefined : remedySeat !== undefined ? headlessApprovalRemedy({ mode: input.permissionMode?.(), classification: foldCause !== undefined ? ancestorUnresolvedClassification(pass.req) : pass.askClassification, approverSeat: remedySeat, coveredWrite: isProtectedWrite(pass.req), ...(pass.shellUnplacedOptions !== undefined ? { unplacedOptions: pass.shellUnplacedOptions } : {}) }) : undefined;
316
329
  const remedy = headless?.sentence;
@@ -348,12 +361,10 @@ export async function exitGate(pass) {
348
361
  pass.currentInput = argsAsTheToolReads(pass.req, rw);
349
362
  }
350
363
  ledger.keepForBytes(pass.currentInput);
351
- const crossBoundary = await input.crossBoundaryCheck?.exit({ toolName, args: pass.currentInput, toolCallId }, ledger.settled?.settlement.who.party === "person" ? "person" : "policy");
364
+ const crossBoundary = await input.crossBoundaryCheck?.exit({ toolName, args: pass.currentInput, toolCallId }, ledger.answered);
352
365
  if (crossBoundary !== undefined) {
353
366
  pass.decision = { action: "deny", message: crossBoundary.message, decisionReason: "safety" };
354
- pass.deniedBy = crossBoundary.kind === "unconfirmed" ? "ask_resolution" : "policy";
355
- if (crossBoundary.kind === "unconfirmed")
356
- ledger.set({ settlement: { kind: "blanket_allow_refused", who: { party: "none" }, when: Date.now() }, origin: ledger.settled?.origin ?? "safety_tighten" });
367
+ pass.deniedBy = "policy";
357
368
  return exitGate(pass);
358
369
  }
359
370
  const release = pass.arbitration?.kind === "released" ? pass.arbitration : (() => { if (ledger.settled !== undefined)
@@ -1,3 +1,4 @@
1
+ import { type RequestCoreRef, type RequestSize } from "../context-guard.js";
1
2
  import type { AgentMessage, ExecutionEnv, GitAnnouncementKind, ReadFloor, SessionTreeEntry } from "../../internal/harness-types.js";
2
3
  /** Bound into the hash domain: bump when the frame's wording/structure changes so the upgraded
3
4
  * renderer re-announces on its first leg instead of being suppressed by a pre-upgrade hash. */
@@ -111,11 +112,6 @@ export interface GitStatusLaneRef {
111
112
  /** Wired by the run loop once its queue exists: re-assert the current frame (compaction landing
112
113
  * + boundary retry both call this). */
113
114
  reassert?: () => Promise<void>;
114
- /** F5 — the typed terminal's surface bridge: the loop converts a
115
- * context-hook throw into a failure MESSAGE (text only), so the thrown `code` never reaches
116
- * result assembly on its own. Set alongside the throw; the run loop lifts it into
117
- * `TaskResult.errorCode`. */
118
- terminalCode?: "irreducible_core_over_budget";
119
115
  /** F4 — the receipt's mirror write, PARKED instead of fired: a
120
116
  * fire-and-forget CAS append from inside the message_end walk can race the loop's own next
121
117
  * transcript append and fail the CRITICAL write with a conflict. The run loop flushes this at
@@ -160,21 +156,43 @@ export declare function probeGitStatusLane(args: {
160
156
  readFloor?: () => ReadFloor | undefined;
161
157
  onDegrade: (reason: string) => void;
162
158
  }): Promise<GitStatusLaneRef>;
159
+ /** The frame the request guard protects on the run's requests, read off the lane's slot: the wrapped segment and — a full
160
+ * frame with a degraded rendering — its one substitution. Absent: no frame is protected. The one reading of the slot for
161
+ * the request build ({@link applyGitFrameGuard}) and for the objective's window check, which prices a first request
162
+ * that carries no new frame (the snapshot unchanged) with the earlier carrier the slot was re-seeded with. */
163
+ export declare function protectedGitFrameOf(ref: GitStatusLaneRef): {
164
+ protectedText: string;
165
+ substitute?: {
166
+ find: string;
167
+ replace: string;
168
+ };
169
+ } | undefined;
163
170
  /**
164
171
  * Request-build half of the trim protection (extracted from prepareTask's context handler under the
165
172
  * same D-7 ratchet): wraps {@link protectGitFrame} with the lane ref's state — the substitution
166
173
  * pair, the one-shot disclosure latch and the pending re-announcement on the first shrink — and
167
- * converts the over-budget verdict into the LOUD typed terminal (`irreducible_core_over_budget`),
168
- * never a pretended trim success. Returns the (possibly re-inserted / shrunk) request view.
174
+ * converts the over-budget verdict into the LOUD typed terminal (`irreducible_core_over_budget`,
175
+ * minted on the request's core ref by {@link coreOverBudgetTerminal}), never a pretended trim
176
+ * success. Returns the (possibly re-inserted / shrunk) request view, and — when `held` is given —
177
+ * the request's whole core in it, which the request-build handler judges.
169
178
  */
170
179
  export declare function applyGitFrameGuard(args: {
171
180
  before: AgentMessage[];
172
181
  trimmed: AgentMessage[];
173
182
  budgetTokens: number;
174
183
  ref: GitStatusLaneRef;
184
+ coreRef: RequestCoreRef;
175
185
  charsPerToken?: number;
186
+ /** The rows the trim holds, when the request was over the line (the frame is then part of a larger core —
187
+ * {@link protectGitFrame}); the returned `core` is that whole core in the returned view. */
188
+ held?: (m: AgentMessage) => boolean;
189
+ /** What a message of the trimmed view costs as the request sends it ({@link RequestSize}); absent ⇒ structural. */
190
+ sizeOf?: RequestSize;
176
191
  onDegrade: (message: string) => void;
177
- }): AgentMessage[];
192
+ }): {
193
+ messages: AgentMessage[];
194
+ core?: number;
195
+ };
178
196
  /**
179
197
  * The transcript-side classifier of engine
180
198
  * git frames. The mirror plane is a CACHE of "which frame is newest"; the TRANSCRIPT is the truth,
@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
2
2
  import { GIT_SNAPSHOT_CC_PREAMBLE, buildGitSnapshot } from "../../prompts/default.js";
3
3
  import { inlineUntrusted } from "../untrusted-text.js";
4
4
  import { openSystemReminder } from "../reminder-mint.js";
5
- import { engineRegionCovers, protectGitFrame } from "../context-guard.js";
5
+ import { coreOverBudgetTerminal, engineRegionCovers, protectGitFrame } from "../context-guard.js";
6
6
  import { gitFrameContextVisible } from "../../internal/harness.js";
7
7
  import { thrownText } from "../thrown-value.js";
8
8
  export const GIT_STATUS_FRAME_FORMAT_VERSION = 1;
@@ -131,17 +131,22 @@ export async function probeGitStatusLane(args) {
131
131
  });
132
132
  return ref;
133
133
  }
134
- export function applyGitFrameGuard(args) {
135
- const { before, trimmed, budgetTokens, ref, charsPerToken, onDegrade } = args;
134
+ export function protectedGitFrameOf(ref) {
136
135
  if (ref.protectedText === undefined)
137
- return trimmed;
138
- const guarded = protectGitFrame(before, trimmed, budgetTokens, {
136
+ return undefined;
137
+ return {
139
138
  protectedText: ref.protectedText,
140
139
  ...(ref.frame?.kind === "full" && ref.frame.shrunk !== undefined && ref.wrappedShrink !== undefined ? { substitute: ref.wrappedShrink } : {}),
141
- }, charsPerToken);
140
+ };
141
+ }
142
+ export function applyGitFrameGuard(args) {
143
+ const { before, trimmed, budgetTokens, ref, coreRef, charsPerToken, held, sizeOf, onDegrade } = args;
144
+ const frame = protectedGitFrameOf(ref);
145
+ if (frame === undefined)
146
+ return { messages: trimmed };
147
+ const guarded = protectGitFrame(before, trimmed, budgetTokens, frame, charsPerToken, held, sizeOf);
142
148
  if (guarded.action === "over_budget") {
143
- ref.terminalCode = "irreducible_core_over_budget";
144
- throw Object.assign(new Error("irreducible core over budget: the compaction summary plus the git status frame alone exceed the request budget — no trim can produce an honest request"), { code: "irreducible_core_over_budget" });
149
+ throw coreOverBudgetTerminal(coreRef, "the compaction summary plus the git status frame");
145
150
  }
146
151
  if (guarded.action === "shrunk" && !ref.overBudgetShrunk) {
147
152
  ref.overBudgetShrunk = true;
@@ -149,7 +154,7 @@ export function applyGitFrameGuard(args) {
149
154
  ref.announced = { ...ref.announced, pending: true };
150
155
  onDegrade("git status frame degraded under budget pressure: the full snapshot no longer fits the request budget — requests carry the branch+dirty residual; the degraded view will be re-announced");
151
156
  }
152
- return guarded.messages;
157
+ return { messages: guarded.messages, ...(guarded.core !== undefined ? { core: guarded.core } : {}) };
153
158
  }
154
159
  export function newestEngineGitFrame(branch, mark) {
155
160
  const heads = [`${openSystemReminder(undefined)}\n${GIT_STATUS_FRAME_PREAMBLE}`, ...(mark !== undefined ? [`${openSystemReminder(mark)}\n${GIT_STATUS_FRAME_PREAMBLE}`] : [])];
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Halt attribution, the consumer half: the ONE predicate that turns the harness's
3
- * consumption statement ({@link HaltConsumption}) into the result's `haltedByUser` seat, and the disclosure
4
- * for the halt that was accepted but never consumed. Both readers of the statement live here so the law
5
- * has one spelling: signed ⇔ consumed; unconsumed ⇔ absent + `task.halt_unconsumed`.
3
+ * consumption statement ({@link HaltConsumption}) into the result's `haltedByUser` / `turnAbortedBy` seats, and the
4
+ * disclosure for an ending request (the halt's, an extension's cut) that was accepted but never consumed. Both readers of
5
+ * the statement live here so the law has one spelling: signed ⇔ consumed; unconsumed ⇔ absent + `task.halt_unconsumed`.
6
6
  */
7
7
  import type { HaltConsumption } from "../../internal/harness.js";
8
8
  import { type RunnerDeps } from "../types.js";
@@ -13,7 +13,16 @@ import { type RunnerDeps } from "../types.js";
13
13
  * own reason is not consumed and never signs (fail-closed: rather absent than guessed).
14
14
  */
15
15
  export declare function haltConsumed(c: HaltConsumption | undefined): boolean;
16
- export interface UnconsumedHaltDisclosureInput {
16
+ /**
17
+ * The run's last turn settled as a cut that ENDS a turn by request — the halt's, or an extension's `$.turn.abort`
18
+ * (the loop's report, stamped at the seat's abort). A steer-now cut never qualifies: that run went on with the steer, and
19
+ * a later turn's opening clears the statement anyway. The result reads its `final` as that cut's artifact, not an abort.
20
+ */
21
+ export declare function endingCutConsumed(c: HaltConsumption | undefined): boolean;
22
+ /** The registration whose `$.turn.abort` ended the run's last turn (`TaskResult.turnAbortedBy`) — present only when that
23
+ * cut was consumed, the same law as `haltedByUser`: signed ⇔ consumed. */
24
+ export declare function turnAbortedByOf(c: HaltConsumption | undefined): string | undefined;
25
+ export interface UnconsumedEndingDisclosureInput {
17
26
  /** The verb's acceptance fact (`loopLatch.userHalted`): a halt was latched on this run. */
18
27
  accepted: boolean;
19
28
  /** The harness's statement, read after the prompt settled. */
@@ -25,12 +34,20 @@ export interface UnconsumedHaltDisclosureInput {
25
34
  taskId: string;
26
35
  }
27
36
  /**
28
- * The ACCEPTED-but-UNCONSUMED halt: the verb latched the stop (and may have cut a seat), but the run ended for
29
- * its own reason before the machinery consumed it — no settlement took the halt's cut as its cause and no
30
- * boundary consult stopped the loop for it (a brain minting its own `aborted` final, a natural completion past
31
- * the final commit point, an approval park whose commit won the race). The result reads the run's own terminal
32
- * without `haltedByUser`; this notice is the halt's trace — the same code the verb mints on its own arm (a halt
33
- * refused by an already-owned ending), one fact with one spelling, the two mint points disjoint: the verb arm mints
34
- * only while NO halt has been accepted on the run; once one was, this arm alone speaks. One per such run. Returns whether it was minted.
37
+ * The ACCEPTED-but-UNCONSUMED ending request — one law for the two sources that ask to END a turn (the ones
38
+ * {@link endingCutConsumed} reads): a request the run accepted whose ending the machinery never took up gets one
39
+ * `task.halt_unconsumed` notice, `detail.source` naming whose request it was, and the result's seat for that source stays
40
+ * absent. What consumes each:
41
+ * · the halt (`source: "halt"`) — its cut settled a turn OR a boundary consult stopped the loop for it
42
+ * ({@link haltConsumed}). Accepted (the verb latched the stop, and may have cut a seat) and neither: the run ended for
43
+ * its own reason (a brain minting its own `aborted` final, a natural completion past the final commit point, an
44
+ * approval park whose commit won the race). One per such run. The verb mints the same code on its own arm (a halt
45
+ * refused by an already-owned ending), one fact with one spelling, the two mint points disjoint: the verb arm mints
46
+ * only while NO halt has been accepted on the run; once one was, this arm alone speaks.
47
+ * · an extension's `$.turn.abort` (`source: "extension"`, with `extension` and `turn`) — a settlement took ITS cut as its
48
+ * turn's cause. Each accepted cut that none did gets one: the turn had already settled as its own outcome (the
49
+ * request's end was delivered before the cut, so the turn ended as an answer), or the run's own ending won.
50
+ * A steer-now's cut asks to redirect, not to end — its steer rides the next boundary either way — and has no arm here.
51
+ * Returns whether anything was minted.
35
52
  */
36
- export declare function discloseUnconsumedHalt(input: UnconsumedHaltDisclosureInput): boolean;
53
+ export declare function discloseUnconsumedEndings(input: UnconsumedEndingDisclosureInput): boolean;
@@ -3,15 +3,42 @@ import { deliverEngineNotice } from "../types.js";
3
3
  export function haltConsumed(c) {
4
4
  return c?.turnCut === "halt" || c?.boundaryStop?.sources.includes("halt") === true;
5
5
  }
6
- export function discloseUnconsumedHalt(input) {
7
- if (!input.accepted || haltConsumed(input.consumption))
8
- return false;
9
- deliverEngineNotice(input.onNotice, {
10
- code: "task.halt_unconsumed",
11
- message: "a user halt was accepted, but the run ended for its own reason before the halt stopped or cut anything: " +
12
- "no turn was settled as its cut and no boundary stopped for it — the run's own ending stands, and the result " +
13
- "will not carry haltedByUser for this halt.",
14
- detail: { sessionId: input.sessionId, runId: input.runId, ...legNoticeTaskId(input) },
15
- });
16
- return true;
6
+ export function endingCutConsumed(c) {
7
+ return c?.turnCut === "halt" || c?.turnCut === "extension";
8
+ }
9
+ export function turnAbortedByOf(c) {
10
+ return c?.turnCut === "extension" ? c.turnCutBy : undefined;
11
+ }
12
+ export function discloseUnconsumedEndings(input) {
13
+ let minted = false;
14
+ if (input.accepted && !haltConsumed(input.consumption)) {
15
+ deliverEngineNotice(input.onNotice, {
16
+ code: "task.halt_unconsumed",
17
+ message: "a user halt was accepted, but the run ended for its own reason before the halt stopped or cut anything: " +
18
+ "no turn was settled as its cut and no boundary stopped for it — the run's own ending stands, and the result " +
19
+ "will not carry haltedByUser for this halt.",
20
+ detail: { source: "halt", sessionId: input.sessionId, runId: input.runId, ...legNoticeTaskId(input) },
21
+ });
22
+ minted = true;
23
+ }
24
+ for (const cut of input.consumption?.unconsumedCuts ?? []) {
25
+ if (cut.source !== "extension")
26
+ continue;
27
+ deliverEngineNotice(input.onNotice, {
28
+ code: "task.halt_unconsumed",
29
+ message: `the extension "${cut.by ?? ""}" asked to end model turn ${cut.turn ?? "?"} and the cut was accepted, but nothing ` +
30
+ "settled that turn as its cut: the turn had already ended on its own outcome, or the run's own ending won — that " +
31
+ "outcome stands, and the result will not carry turnAbortedBy for this cut.",
32
+ detail: {
33
+ source: "extension",
34
+ ...(cut.by !== undefined ? { extension: cut.by } : {}),
35
+ ...(cut.turn !== undefined ? { turn: cut.turn } : {}),
36
+ sessionId: input.sessionId,
37
+ runId: input.runId,
38
+ ...legNoticeTaskId(input),
39
+ },
40
+ });
41
+ minted = true;
42
+ }
43
+ return minted;
17
44
  }
@@ -1,4 +1,5 @@
1
1
  import { hopRefusal } from "../host-floor.js";
2
+ import { callerText } from "../caller-text.js";
2
3
  import { firstUnprocessedOverTarget, IMAGE_ADMISSION, sniffImageMime } from "../image-admission.js";
3
4
  import { resolveImageProcessor } from "../image-downsample.js";
4
5
  import { admitInlineImage } from "./inline-image.js";
@@ -8,10 +9,10 @@ export function defaultImageUrlGuard(raw, floor) {
8
9
  u = new URL(raw);
9
10
  }
10
11
  catch {
11
- throw new Error(`invalid image url: ${raw}`);
12
+ throw new Error(`invalid image url: ${callerText(raw)}`);
12
13
  }
13
14
  if (u.protocol !== "https:") {
14
- throw new Error(`image url must be https (got "${u.protocol}")`);
15
+ throw new Error(`image url must be https (got ${callerText(u.protocol)})`);
15
16
  }
16
17
  const refused = hopRefusal(u, floor, true);
17
18
  if (refused !== undefined)
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The zero-value constructor of {@link RunState}, the run loop's ONE shared mutable record (seven groups,
3
- * sixty fields; its writers are the run loop's three top-level machines, see the interface's own doc in
3
+ * sixty-four fields; its writers are the run loop's three top-level machines, see the interface's own doc in
4
4
  * contracts.ts). The driver mints one per run leg and hands it to every machine as a `borrowed-mutable`
5
5
  * seat; nothing here reads or writes host state, so the skeleton is machinery, not a phase.
6
6
  *
@@ -1,11 +1,11 @@
1
1
  export function createRunState() {
2
2
  return {
3
- telemetry: { cacheFamily: "input-excludes-cached", pricing: { inputPer1M: 0, outputPer1M: 0 }, pricingConfigured: true, unpricedSpend: false, tracer: undefined, taskId: "", runId: "", taskStart: 0, taskStartMonotonic: 0, cacheBreakReported: false },
4
- degrade: { degradeToModel: undefined, degraded: undefined, outputErrorStreak: 0, outputInvalid: false, recordDegraded: () => { } },
3
+ telemetry: { requestedModel: undefined, cacheFamily: "input-excludes-cached", pricing: { inputPer1M: 0, outputPer1M: 0 }, pricingConfigured: true, unpricedSpend: false, tracer: undefined, taskId: "", runId: "", taskStart: 0, taskStartMonotonic: 0, cacheBreakReported: false },
4
+ degrade: { degradeToModel: undefined, degraded: undefined, budgetSwitched: false, outputErrorStreak: 0, outputInvalid: false, recordDegraded: () => { }, priceOf: () => ({ pricing: { inputPer1M: 0, outputPer1M: 0 }, pricingConfigured: false, cacheFamily: "input-excludes-cached" }), fallbackSeat: { observe: () => { } } },
5
5
  limits: { turnsExceeded: false, budgetHit: undefined, budgetAxis: undefined, platformTerminal: undefined, outputRetryCap: 0, effectiveMaxTurns: undefined },
6
6
  budget: { remainingMicroUsd: undefined, maxCostMicroUsd: undefined, remainingTokens: undefined, maxTokensWindow: undefined, overBudget: () => undefined, streamCancel: false, callOutputChars: 0, lastStreamBudgetCheck: 0, projectedOverBudget: () => undefined },
7
- turn: { callStartAt: undefined, firstTokenAt: undefined, turnUsage: undefined, turnUsageMissing: false, turnStopReason: undefined, turnResponseModel: undefined, toolBatch: [] },
7
+ turn: { callStartAt: undefined, firstTokenAt: undefined, turnUsage: undefined, turnUsageMissing: false, turnCacheMarks: {}, turnStopReason: undefined, turnResponseModel: undefined, toolBatch: [] },
8
8
  counters: { approachNoticesSent: 0, walltimeSyncBackstopFired: false, compactionFloor: 0, trimForceBackoff: false, compactionPasses: 0, repetitionCuts: 0, repetitionSpared: 0, repetitionEvents: [], REPETITION_EVENTS_CAP: 0, preemptIgnoredReported: false, wroteThisRun: false, finalVerifyInjections: 0, groundingSignalPreR9: false, groundingSignalPostR9: false, cadenceTurns: 0 },
9
- attach: { attachmentsCfg: undefined, agentListingOn: false, skillsListingOn: false, attachState: undefined, dateState: undefined, instrProbe: undefined, instrState: undefined, sizeGuidelineState: undefined, attachmentsInjected: 0 },
9
+ attach: { attachmentsCfg: undefined, agentListingOn: false, skillsListingOn: false, attachState: undefined, dateState: undefined, sizeGuidelineState: undefined, attachmentsInjected: 0 },
10
10
  };
11
11
  }
@@ -0,0 +1,66 @@
1
+ /**
2
+ * The LANGUAGE seat (`TaskSpec.language`): the language the person's shell has their reply preference set to, stated to the
3
+ * model in the reference's own `# Language` attachment (Claude Code 2.1.316 `Pio` / `wSt`, cli316.js:269324-269326) and never
4
+ * in the system prompt. A leg's seat holds what its first request owes, judged against what the model was told in the
5
+ * conversation's CURRENT segment (the announced record's `language` arm — the reference compares against the transcript's
6
+ * last `language` attachment, `s0e` over `Yde`, cli316.js:269326 / :272682): a language declared and a different one (or
7
+ * none) told ⇒ the full text for the declared one; none declared and a language told ⇒ the cleared sentence; every other
8
+ * pair owes nothing. A compaction inside the leg restates the declared language right after it lands (the reference's
9
+ * `vSt`, cli316.js:269326) and records it for the new segment, so the next leg judges against what the model now holds.
10
+ *
11
+ * Stated only on the person's own agents: a root leg and a named teammate. An ordinary delegated child reads no language
12
+ * seat (the reference's `tPr`, cli316.js:272682: main and teammate agents, never a plain subagent). Model lane only — no
13
+ * `steering_injected` echo (the advisor instructions' and the posture's lane).
14
+ *
15
+ * The seat is the reply language, not the engine's text: `TaskSpec.promptLocale` renders the engine's own texts and never
16
+ * sets a reply language; neither seat is read from the other.
17
+ */
18
+ import { type AnnouncedLanguageState } from "../../internal/harness.js";
19
+ import type { SessionTreeEntry } from "../../internal/harness-types.js";
20
+ import type { MaybeCompactOptions } from "../auto-compaction.js";
21
+ import type { Prepared } from "./contracts.js";
22
+ import { type ToldSeat } from "./conversation-segment.js";
23
+ /** The longest language the seat admits — the reference's own bound (its setting's schema is `string().max(256)`:
24
+ * `S3` (cli316.js:269323), over `OO` (cli316.js:260502)), counted in UTF-16 units as that schema counts. */
25
+ export declare const LANGUAGE_MAX = 256;
26
+ /** The reference's sentence when the preference is cleared: `wSt` (cli316.js:269324) given `null`. */
27
+ export declare const LANGUAGE_CLEARED = "The language preference was cleared. Match the user's language.";
28
+ /** The `# Language` attachment's text, byte for byte the reference's (`Pio`, cli316.js:269324-269326). The language is the
29
+ * deployment's declaration (caller-trusted); it is held to one neutralized line, as the output style's name is. */
30
+ export declare function renderLanguageInstructions(language: string): string;
31
+ /** The seat's door: the declared language, or `undefined` when the seat is absent. Every bad value is refused by name
32
+ * (`config.language_invalid`), never ignored — a preference the deployment believes it declared must not run as none:
33
+ * a value that is not a string, a blank string, a string longer than {@link LANGUAGE_MAX}. */
34
+ export declare function screenLanguageSeat(seat: unknown): string | undefined;
35
+ /** The frame a leg owes, from what the model was told in this segment (`null` = told the preference was cleared, `undefined`
36
+ * = nothing told) and the declared language; `value` is what the model has been told once the frame is delivered. */
37
+ export declare function languageFrame(told: string | null | undefined, declared: string | undefined): {
38
+ body: string;
39
+ value: string | null;
40
+ } | undefined;
41
+ /** A leg's language seat: the told seat (the frame its first request owes, the segment that was judged in) and the declared
42
+ * language (what a compaction restates). */
43
+ export interface LanguageSeat extends ToldSeat<string | null> {
44
+ readonly declared: string | undefined;
45
+ }
46
+ /** The leg's seat, or `undefined` when the leg states no language (an ordinary delegated child) or there is nothing to tell
47
+ * and nothing told. An unreadable branch never withholds: a declared language is stated (a duplicate at worst) and, with none
48
+ * declared, a recorded one is cleared; such a leg records nothing. */
49
+ export declare function prepareLanguageSeat(input: {
50
+ declared: string | undefined;
51
+ personAgent: boolean;
52
+ told: AnnouncedLanguageState | undefined;
53
+ session: {
54
+ getBranch(): Promise<ReadonlyArray<SessionTreeEntry>>;
55
+ };
56
+ }): Promise<LanguageSeat | undefined>;
57
+ /** The owed frame as one engine-marked reminder — what a fresh leg's first message and a resumed leg's continuation both carry. */
58
+ export declare function languageFrameText(prepared: Pick<Prepared, "languageSeat" | "reminderMark">): string | undefined;
59
+ type RecordSeats = Pick<Prepared, "languageSeat" | "announcedListingsRef" | "frameReceipts">;
60
+ /** Register the owed frame's receipt on the message that carries it (`text`, its exact first text block): what the model was
61
+ * told is recorded only once that message is in the transcript. Nothing owed ⇒ nothing registered. */
62
+ export declare function registerLanguageReceipt(prepared: RecordSeats, text: string): void;
63
+ /** The seat's COMPACTION arm, on a leg that declares a language: the told seat's one restate (`restateToldSeat`) of the declared
64
+ * text — nothing is appended while the leg's own pending frame is that text, and the record moves to the new segment. */
65
+ export declare function languageRestateOption(prepared: RecordSeats & Pick<Prepared, "reminderMark" | "session" | "admitRows" | "batchHaltRef" | "postureFrameRef" | "announcedSnapshotRecovered">): Pick<MaybeCompactOptions, "languageRestate">;
66
+ export {};