@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
@@ -10,6 +10,7 @@ import type { ActorAssertion, UserAttachmentKind, UserAttachmentOutcome } from "
10
10
  import type { TaskResult } from "./task-result.js";
11
11
  import type { TaskNotificationPayload } from "./task-notification.js";
12
12
  import type { ProviderCondition, ProviderConditionSource } from "../brain/provider-dialect.js";
13
+ import type { AttachmentSource } from "./attachment-source.js";
13
14
  /**
14
15
  * Identity fields carried by every CONTENT event of a task stream (design/99 §E2 — lightweight message
15
16
  * identity). Both are OPTIONAL and ADDITIVE; a consumer that ignores them is unchanged.
@@ -120,6 +121,12 @@ export type BrainRetryErrClass = "connect_refused" | "transport" | "stall" | "ra
120
121
  * main model standing in behind it): a side call beside the person's turn, never the turn itself.
121
122
  */
122
123
  export type BrainStatusSeat = "classifier";
124
+ /**
125
+ * WHO holds a tool call at its gate — the closed set behind `tool_progress.gate`. The classifier word IS the
126
+ * {@link BrainStatusSeat} word (one definition, read in two places): `classifier` = an auto-mode classification of the call
127
+ * is in flight; `approval` = a question about the call is put to a person (an approval card, a content question).
128
+ */
129
+ export type ToolGatePhase = BrainStatusSeat | "approval";
123
130
  /** design/99 §E3/§E10 — the payload of a {@link TaskEvent} `status` event (and the brain→runner signal). */
124
131
  export interface BrainStatus {
125
132
  phase: BrainStatusPhase;
@@ -242,6 +249,17 @@ export interface BrainStatus {
242
249
  /** Which evidence {@link providerCondition} rests on (`unified_header` / `provider_code` / `status`). Present
243
250
  * exactly when it is. */
244
251
  providerConditionSource?: ProviderConditionSource;
252
+ /**
253
+ * What the provider said about the response being retried, in its own sentence — the error envelope's `error.message`, after the one pass
254
+ * over a remote's words (the request's declared values and credential shapes masked, a URL or a multi-segment path withheld, one line, at most
255
+ * 240 code points). The same member, the same pass and the same bound as `terminal.detail.providerMessage`.
256
+ *
257
+ * PRESENCE — beside {@link providerCondition}, when the failed attempt's body was read and parsed as a provider envelope that states a sentence:
258
+ * a 429 and any other retried 4xx. ABSENT where the ladder decides without reading the body (a 5xx, 408, 409), on a plain-text, torn, unended
259
+ * or empty body, and on every frame {@link providerCondition} is absent from. Absence says the provider stated no trusted sentence — never an
260
+ * empty string.
261
+ */
262
+ providerMessage?: string;
245
263
  /**
246
264
  * WHOSE model call this frame is about ({@link BrainStatusSeat}), on every phase — a 429 backoff, a reconnect, a
247
265
  * `circuit_open` fast-fail or a first-token wait all describe ONE call, and the person watching needs to know it is not their
@@ -251,6 +269,14 @@ export interface BrainStatus {
251
269
  * main loop" — never as "unknown". Additive and optional: a consumer that never reads it renders every frame as before.
252
270
  */
253
271
  seat?: BrainStatusSeat;
272
+ /**
273
+ * @contract status.tool_call_id — the tool call the {@link seat}'s model call is judging, the same id as that call's
274
+ * `tool_start` / `tool_progress` / `tool_end`: present exactly on a frame that names `seat: "classifier"`, since every
275
+ * classification is asked about one gated call. Absent on the run's own turn's frames. A classification that answers
276
+ * before any liveness frame is due reports none — a frame's absence is never evidence that no classifier ran (the call's
277
+ * `tool_end.gate` is that record).
278
+ */
279
+ toolCallId?: string;
254
280
  }
255
281
  /**
256
282
  * design/97 CORE-8 (③): one lightweight TOOL-ACTIVITY beat surfaced from a running task, for a per-agent live
@@ -384,6 +410,14 @@ export type TaskEvent = ({
384
410
  /** An extension's own call (`$.tool.call`): who asked for it. Absent on every call a model message carried. The call is
385
411
  * not part of the conversation — no tool-result message follows it into the transcript. */
386
412
  requestedBy?: ExtensionRequester;
413
+ /**
414
+ * @contract tool_start.resumesCheckpoint — on the held call a resumed leg runs: the id of the checkpoint row the leg
415
+ * was opened from, the id the parking leg's paused terminal (`terminal.checkpointId`) and the row itself carry. It is the one join between the parking
416
+ * leg's frames for the call and the resumed leg's, minted once where the resumed leg opens the held call, and the
417
+ * paired `tool_end` carries the same id. Absent on every other call (a live leg's calls, the resumed leg's later calls,
418
+ * an interrupted run's reconcile closing a call at a later process start), and on a held call whose row carries no id.
419
+ */
420
+ resumesCheckpoint?: string;
387
421
  } & TaskEventIdentity) | ({
388
422
  /**
389
423
  * A LIVENESS TICK for a tool call that is still running. Emitted on the run's own queue between this
@@ -397,9 +431,9 @@ export type TaskEvent = ({
397
431
  *
398
432
  * @contract tool_progress.cadence — AT MOST one frame per second per tool call, enforced at the mint over
399
433
  * ALL producers rather than inside each one (a producer's own timer is a sampling clock, not the contract),
400
- * and a call's first frame is never earlier than one interval after it entered execution. A call that
401
- * finishes inside one interval emits NO frame at all — this frame's absence is never evidence that a call
402
- * did not run, and a consumer must not expect one per `tool_start`.
434
+ * and a call's first frame is never earlier than one interval after that call was first announced to the lane (its gate
435
+ * entry or its first frame). A call that finishes inside one interval emits NO frame at all — this frame's absence is never
436
+ * evidence that a call did not run, and a consumer must not expect one per `tool_start`.
403
437
  *
404
438
  * @contract tool_progress.ephemeral — LIVE ONLY, like `task_progress`/`status`: core never persists this
405
439
  * frame (no session-tree entry, no checkpoint state, no resume replay), and a resumed leg re-ticks from
@@ -414,9 +448,9 @@ export type TaskEvent = ({
414
448
  toolCallId: string;
415
449
  /** The running tool's name (the `tool_start` value verbatim). */
416
450
  toolName: string;
417
- /** Whole seconds this tool call has been running, floored and MONOTONIC across its frames. ONE ORIGIN per
418
- * call, stamped by the mint rather than by whichever producer emitted — the call's entry into execution,
419
- * earlier than a shell command's spawn. It does NOT equal the `tool_end` duration. */
451
+ /** Whole seconds since the engine released the call into execution, floored and MONOTONIC across its frames;
452
+ * 0 while it waits at its gate. ONE ORIGIN per call, stamped by the mint rather than by whichever producer
453
+ * emitted — the release, earlier than a shell command's spawn. It does NOT equal the `tool_end` duration. */
420
454
  elapsedTimeSeconds: number;
421
455
  /**
422
456
  * The TAIL of what the command has written so far (stdout and stderr interleaved in arrival order),
@@ -439,6 +473,18 @@ export type TaskEvent = ({
439
473
  /** Bytes observed in the command's output so far, counted BEFORE the tail bound, so it keeps
440
474
  * growing after {@link output} stops being able to. Rides iff {@link output} does. */
441
475
  totalBytes?: number;
476
+ /**
477
+ * @contract tool_progress.gate — WHO holds the call at its gate when the frame is minted ({@link ToolGatePhase}):
478
+ * `classifier` while an auto-mode classification of the call is in flight (the leg's own classifier, or an ancestor's
479
+ * frozen one judging it), `approval` while a question about it is put to a person. Absent when nothing holds it at the
480
+ * gate — before the gate, between two gate rounds, after its release to the executor. Read off the call's one
481
+ * occurrence record at the mint, so a heartbeat and a producer's tick say the same. Two absences follow from the
482
+ * laws above and say nothing: a classification that answers inside one interval leaves no frame naming it (the call's
483
+ * `tool_end.gate` is the record that it ran), and while EVERY call in flight waits on the person nothing is beaten, so
484
+ * `approval` rides only a frame minted while some other call is working. The classification's own model-call
485
+ * liveness is the `status` frame naming this call (`status.toolCallId`).
486
+ */
487
+ gate?: ToolGatePhase;
442
488
  } & TaskEventIdentity) | ({
443
489
  type: "tool_end";
444
490
  toolCallId: string;
@@ -478,7 +524,7 @@ export type TaskEvent = ({
478
524
  output?: unknown;
479
525
  /**
480
526
  * design/116 (b) — the tool's CC-shaped `toolUseResult` facts (`details.type` ∈ the known card
481
- * set: edit/create/update/bash/text/grep/glob/notebook-edit/notebook/file_unchanged/mcp/image/
527
+ * set: edit/create/update/bash/text/grep/glob/notebook-edit/notebook/mcp/image/
482
528
  * document/worktree/todo/task/task-list/task-stop/agent/fork/workflow-run/web-fetch/
483
529
  * web-search/cron-create/cron-delete/cron-list/tool-search/repo-map/monitor-start/
484
530
  * enter-plan-mode/exit-plan-mode/report-findings/schedule-wakeup/send-message/agent-transcript/
@@ -540,7 +586,10 @@ export type TaskEvent = ({
540
586
  * this call because a durable gate parked the batch — the "Operation aborted" family), and, for a
541
587
  * failed MCP tool call, the MCP failure class — see {@link import("./mcp-failure.js").McpFailure.kind}
542
588
  * for the words (the same closed set the per-server status and the wiring manifest's `mcp[]` carry;
543
- * this frame only transports it). Additive: absent on error frames minted before this field
589
+ * this frame only transports it), and the `config.*` refusal an engine seat throws out of a tool body (the parent-seat,
590
+ * retired-member, registry-seat, checkpoint-store, skill-activation and host-floor refusals, minted by `codedRefusal` — a
591
+ * platform error's own code is never lifted). A delegation tool's failure (the Agent family, spawn and fork): the child's
592
+ * failure code, when it is an engine word, else the kind its thrower declared. Additive: absent on error frames minted before this field
544
593
  * existed, and on error results whose details carry no string discriminator under either name.
545
594
  */
546
595
  errorCode?: string;
@@ -619,6 +668,16 @@ export type TaskEvent = ({
619
668
  * station did not know the roster name.
620
669
  */
621
670
  wireName?: string;
671
+ /**
672
+ * @contract tool_end.refusedInput — on a REFUSED call's frame only (`gate.disposition.kind === "denied"`): the
673
+ * arguments the refusal was ruled over, as the call's latest gate exit recorded them (after any rewrite the call
674
+ * took on its way in) — the frozen record a deny exit hands the deny observer its copy of, and, on a call refused
675
+ * after its gate let it go with a rewrite, the very record that frame's `rewrite.input` carries; never a second
676
+ * capture. So a refusals list shows what was refused without joining it back to the start frame, whose `args` are
677
+ * the model's bytes before any rewrite. UNTRUSTED RAW like `tool_start.args`: a consumer MUST redact before
678
+ * persisting or forwarding. Absent on every other frame, and on a refused frame no gate exit recorded an input for.
679
+ */
680
+ refusedInput?: unknown;
622
681
  /**
623
682
  * @contract tool_end.notExecuted — `true` when the engine has POSITIVE evidence this call never executed:
624
683
  * the loop closed it without running it (a sibling settled by a halted batch, a call a turn interrupt
@@ -665,6 +724,8 @@ export type TaskEvent = ({
665
724
  rewrite?: ToolInputRewrite;
666
725
  /** The same member as the paired `tool_start`'s: an extension's own call, and who asked for it. */
667
726
  requestedBy?: ExtensionRequester;
727
+ /** The same member as the paired `tool_start`'s: `tool_start.resumesCheckpoint`. */
728
+ resumesCheckpoint?: string;
668
729
  /**
669
730
  * design/99 §E1 — `true` exactly when {@link output} is not the content the tool returned: text was cut at the cap
670
731
  * (the string, or the block at the cut, carries the marker; the stream's later blocks left), a media block was
@@ -755,6 +816,14 @@ export type TaskEvent = ({
755
816
  * request; `stats` under-counts it honestly rather than polluting the single-source accounting
756
817
  * with an estimate). Absent on a measured turn (never `false`). */
757
818
  usageMissing?: true;
819
+ /** Present (`true`) when some model call of this turn did not report its cache reads: `usage.cacheReadTokens` is then the
820
+ * counted sum (an unreported count adds nothing), not a measurement — UNKNOWN, never a 0% hit. Where the provider's
821
+ * input excludes the cached parts the turn's total is then a lower bound too, and `usageMissing` rides beside it. Absent
822
+ * ⇔ every call of the turn reported its cache reads. */
823
+ cacheReadUnreported?: true;
824
+ /** Present (`true`) when some model call of this turn did not report its cache writes (the OpenAI-shaped wires never do):
825
+ * `usage.cacheWriteTokens` is then the counted sum, not a measurement. Same law as {@link cacheReadUnreported}. */
826
+ cacheWriteUnreported?: true;
758
827
  /** TB telemetry B1: the NORMALIZED finish reason of the turn's LAST model call —
759
828
  * the engine's `AssistantMessage.stopReason` (`StopReason`: `"stop"`/`"length"`/`"toolUse"`/
760
829
  * `"error"`/`"aborted"`). This is post-normalization: e.g. Anthropic `end_turn`/`stop_sequence`
@@ -772,6 +841,11 @@ export type TaskEvent = ({
772
841
  * ONE reading, not two, as on the reference mismatch latch, also written only for a disagreeing pair.
773
842
  * A mismatch is additionally announced once per leg per pair as `route.response_model_mismatch`. */
774
843
  responseModel?: string;
844
+ /** The extension (its registration name) whose `prompt.submit` handler answered this turn with `{ reply }`, so
845
+ * no model request was made: `usage` is a known zero (no `usageMissing` beside it — nothing was served), the
846
+ * reply is the turn's assistant text, and the session row carries the same name (`AssistantMessage.answeredBy`).
847
+ * Absent on every turn a model answered. */
848
+ answeredBy?: string;
775
849
  } & TaskEventIdentity) | ({
776
850
  /** design/99 MF-18: a compaction boundary (or, since design/119 #1, mid-turn when the prompt-too-long recovery force-compacts between a failed request and its retry). `trigger` = what caused it: `"auto"` (the context-threshold
777
851
  * auto-compaction), `"manual"` (the `TaskStream.compact` / `/compact` path), or `"forced"` (RB-398-b
@@ -779,7 +853,11 @@ export type TaskEvent = ({
779
853
  * hook layer's `PreCompactContext.trigger` always had this third state and the wire now carries the
780
854
  * SAME value the hooks saw instead of flattening it to `"auto"`. Additive value space — a consumer
781
855
  * switching on auto/manual keeps its exact old behavior). `tokensBefore` = the
782
- * pre-compaction context size. CC parity = `SDKCompactBoundary{trigger, pre_tokens, preserved_segment}`. */
856
+ * pre-compaction size of the HISTORY the summary replaced (the cut planner's estimate over the branch's
857
+ * messages, usage-anchored when the branch carries a fresh anchor; no fixed-prompt term) — DIAGNOSTIC, NOT
858
+ * paired with {@link tokensAfter} (that one is structural + the fixed prompt overhead, so `tokensBefore 344`
859
+ * beside `tokensAfter 30600` is two coordinates, not a pass that grew the context); read {@link freedTokens}.
860
+ * CC parity = `SDKCompactBoundary{trigger, pre_tokens, preserved_segment}`. */
783
861
  type: "compacted";
784
862
  trigger: "auto" | "manual" | "forced";
785
863
  /** The pass this frame CONCLUDES — the value the pass's `compaction_started` frame carried. A landing is
@@ -826,12 +904,21 @@ export type TaskEvent = ({
826
904
  * cards under the compaction divider from this. `chars` = the characters of the file's data the frame
827
905
  * delivered (the line-numbered contents — the share itself counts the file's own text); `truncated` = the frame
828
906
  * holds a partial view. A file the restore named but did not send (too large, refused, gone, a PDF reference)
829
- * is not listed. Absent when the feature is off or nothing was delivered. */
907
+ * is not listed here — {@link restoreOutcomes} records it. Absent when the feature is off or nothing was delivered. */
830
908
  attachedFiles?: Array<{
831
909
  path: string;
832
910
  chars: number;
833
911
  truncated: boolean;
834
912
  }>;
913
+ /** What became of each file this compaction's restore re-read: one record per restore frame, frame order — the same
914
+ * record, by the same projection, as {@link HumanInputAttachment} on `human_input.attachments` (`label` = the path;
915
+ * `outcome` one of `USER_ATTACHMENT_OUTCOMES`; `reason` one of the refusal words, `too_large_to_restore` among them for a
916
+ * file over its share). Unlike `human_input`'s it is a delivery result: a frame the transcript did not take is
917
+ * `not_attached`. A PDF is a reference (`kind: "pdf"`, `attached`, as on `human_input`: its size and page count, no
918
+ * contents — which is why `attachedFiles` does not list it). A file the context the summary leaves still shows gets
919
+ * no frame and no record. Absent when the
920
+ * restore is off, minted no frame, or failed outright (an operator line, `onError` phase `degraded`, says why). */
921
+ restoreOutcomes?: HumanInputAttachment[];
835
922
  /** design/145 §3 (additive): this compaction's summary call FELL BACK from the independent
836
923
  * `compactionModel` to the main model — the small window would have truncated more than
837
924
  * `compaction.clampTolerance` of the conversation. Mirror of `compaction.model_fallback`. */
@@ -873,7 +960,11 @@ export type TaskEvent = ({
873
960
  * - `"noop"` — the pass ran but found nothing to compact (no valid cut point/empty history).
874
961
  * - `"disabled"` — a requested pass (`trigger:"manual"`) was refused because the `manualCompact`
875
962
  * seat is off, or the rapid-refill breaker disabled compaction mid-task (`reason` says so; the
876
- * trigger is the landing pass's). The `trigger` names the seat: a `"manual"` frame is the
963
+ * trigger is the landing pass's), or a pass the engine would start was not attempted because the fixed
964
+ * request prefix alone is at or past its line — `reason` starts `window_below_overhead:` and carries the
965
+ * prefix, the threshold, the window, the reserve and the smallest usable window (prefix + reserve); ONCE
966
+ * PER TASK, on the trigger of the first pass that met it, and every later non-`force` pass of the task
967
+ * (and of later tasks, while the prefix stays that large) is judged the same and not attempted. The `trigger` names the seat: a `"manual"` frame is the
877
968
  * `manualCompact` seat's, never the `autoCompact` seat's. A seat that is statically off does NOT
878
969
  * produce one of these per boundary for the passes the engine would start (that would be
879
970
  * per-boundary noise about a static configuration, not a state change).
@@ -890,6 +981,10 @@ export type TaskEvent = ({
890
981
  trigger: "auto" | "manual" | "forced";
891
982
  /** Optional human-readable detail (mirrors the trace frame's reason where one exists). */
892
983
  reason?: string;
984
+ /** A `failed` frame's machine cause, a word of `COMPACTION_FAILURE_CAUSES` (`leaf_moved`: another writer moved the session's
985
+ * leaf while the pass ran and the summary landed nowhere), present when the failure has one — on every lane that fails a pass.
986
+ * Absent on every other outcome and on a failure the set has no word for; read the word, never the `reason`'s text. */
987
+ cause?: import("./auto-compaction.js").CompactionFailureCause;
893
988
  /** The pass this frame CONCLUDES — the value its `compaction_started` frame carried. Present exactly when a
894
989
  * start was announced for the pass this frame ends, which makes it `failed` or `mooted` (a pass that ran its
895
990
  * summary call and did not land, or was cut while it ran). Absent on every outcome of a pass that never
@@ -953,9 +1048,18 @@ export type TaskEvent = ({
953
1048
  * at every delivery (a leg's first turn, a resumed leg's continuation, each continuing boundary).
954
1049
  * The permission-posture frames (planning / bypass / auto, and their exits) are model-lane only and have no
955
1050
  * echo; the retired `plan_mode` member was the echo of the opt-in planning reminder they replaced.
1051
+ *
1052
+ * `nested_memory` (additive member): an instruction file of a directory the run accessed (or a rule the deployment
1053
+ * supplied for an accessed path; the family `NESTED_MEMORY_LANE.declaration` names) reached the model — one event per file, at
1054
+ * the receipt of the frame that carried it; `preview` is the file's path (the rule's name), never its contents.
1055
+ * `project_instructions` (additive member): the same for an instruction file of the task root's own level (the session's
1056
+ * instructions, read by the same lane). Either word, a frame that WITHDREW a file delivered earlier (removed since, or
1057
+ * holding nothing now) echoes with its path and the words `(withdrawn: it no longer applies)`. The retired
1058
+ * `instructions_change` member was the echo of a deployment-probed hash notice about the session's instruction file;
1059
+ * the lane now sends the whole changed file, or its withdrawal.
956
1060
  */
957
1061
  type: "steering_injected";
958
- source: "limit_approach" | "todo_reminder" | "task_reminder" | "tool_search_usage_reminder" | "changed_files" | "output_style" | "date_change" | "instructions_change" | "workflow_size_guideline_change" | "budget_usd" | "total_tokens_reminder" | "background_tasks" | "tools_delta" | "mcp_unavailable" | "agent_listing" | "skills_listing" | "mcp_instructions" | "mcp_dropped_tools" | "final_verification" | "git_status";
1062
+ source: AttachmentSource | "limit_approach" | "final_verification" | "git_status" | "nested_memory" | "project_instructions";
959
1063
  preview: string;
960
1064
  } & TaskEventIdentity) | ({
961
1065
  /**
@@ -1006,6 +1110,30 @@ export type TaskEvent = ({
1006
1110
  role: "user" | "assistant" | "toolResult";
1007
1111
  /** Present iff `role === "toolResult"`: the exact join key to the `tool_start`/`tool_end` already rendered. */
1008
1112
  toolCallId?: string;
1113
+ /** Present iff `role === "user"`: what this row is — `"human_input"` (a person's or a relay's input, accounted for by a
1114
+ * `human_input` frame), `"attachment"` (a frame for one of that input's declared attachments, trailing its message),
1115
+ * `"interruption_marker"` (the engine's own line that the run was interrupted) or `"queued_note"` (any other engine-minted
1116
+ * user-lane row: a task notification, a boundary steer, the git frame). A consumer anchors on it and on `inputId`, never on
1117
+ * stream order. */
1118
+ origin?: import("./user-row-origin.js").UserRowOrigin;
1119
+ /** Present only with `origin === "human_input"` or `"attachment"`: the `human_input.inputId` of the input this row IS (or, for
1120
+ * an attachment frame, belongs to) — the same key, so the frame and its row join by key. A `human_input` row is one per key;
1121
+ * the objective's attachment frames carry the objective's key under `origin: "attachment"`, which tells them apart.
1122
+ *
1123
+ * A resume's continuation is ONE message merging every parked steer with the wake message. No `continuation` carrier exists
1124
+ * (a `human_input` frame's carrier is `steer` or `wake`), so that row is `origin: "human_input"` carrying the WAKE message's
1125
+ * key — the wake carrier's own, never a merged steer's — and has no key when the resume has no wake message (a continuation of
1126
+ * parked steers alone). The merged steers have no row of their own: each joins only through its own `delivery: "applied"` frame. A
1127
+ * continuation that carries neither a parked steer nor a wake message — only the approving person's words, which no `human_input`
1128
+ * frame accounts for — is a `queued_note`. */
1129
+ inputId?: string;
1130
+ /** Present only with `origin === "queued_note"`, on the row of a task notification: the frame's durable key — the one key
1131
+ * the frame was handed to the model under, whichever road it took (the live lane, or the redelivery at a run's turn open of
1132
+ * a frame parked while the session sat idle). It is the key the row's transcript entry carries and the one
1133
+ * `taskNotificationDedupKey` (root export) reads off the `task_notification` frame's payload, so a consumer joins the frame to
1134
+ * the row that brought it to the model by this key, never by stream order. A boundary steer, the
1135
+ * git frame and every other queued note carry none. */
1136
+ noteKey?: string;
1009
1137
  } & TaskEventIdentity) | ({
1010
1138
  /**
1011
1139
  * design/171 §5.5/§6.2 — the human-input LIFECYCLE arm: one frame per human input this run
@@ -1046,7 +1174,7 @@ export type TaskEvent = ({
1046
1174
  principal?: string;
1047
1175
  /** The persisted session-tree entry the input landed as, WHEN the emitter knows it (a
1048
1176
  * serving layer replaying the ledger); the core's live emissions precede the commit and
1049
- * omit it — consumers there join via `message_committed` + stream order. */
1177
+ * omit it — consumers there join by key: the `message_committed` row with `origin: "human_input"` and this `inputId`. */
1050
1178
  entryId?: string;
1051
1179
  /** Present only on the `"applied"` frame of an objective that declared attachments: per attachment, in order, what
1052
1180
  * the engine read for it and will send (`outcome`) — an admission result, not a delivery. Each attachment is
@@ -1185,10 +1313,10 @@ export type TaskEvent = ({
1185
1313
  *
1186
1314
  * Present on every tick from a run that HAS a fleet row: `"background_agent"` for a background
1187
1315
  * delegation child (its registry `a*` row) and `"workflow"` for a workflow-spawned agent (its
1188
- * `wa*` read-face row) — the latter alongside, not in place of, {@link workflowRunId}, which
1316
+ * `wa*` read-face row, framed only to a wired child-event sink) — the latter alongside, not in place of, {@link workflowRunId}, which
1189
1317
  * names the owning RUN while this names the KIND. ABSENT is a fact, not missing data: a
1190
- * SYNCHRONOUS delegated child has no fleet row at all. Additive — tolerate absence, and never
1191
- * read absence as "not an agent".
1318
+ * SYNCHRONOUS delegated child has no registry identity (INTEGRATION-CORE §1.6a) — the one gap is a delegated child's
1319
+ * checkpoint a host redeems without the lane's internals (KL-3824-a). Additive — tolerate absence, never read it as "not an agent".
1192
1320
  */
1193
1321
  taskType?: DelegationTaskType;
1194
1322
  /**
@@ -1298,7 +1426,7 @@ export type TaskEvent = ({
1298
1426
  * `repository` = the repository's root; `root` = which declared root lives there; `baseSha` = the commit the session's
1299
1427
  * code starts from. `dir` / `name` / `branch` / `baseRef` (present together) = the session's own tree of that
1300
1428
  * repository — with `root: "taskRoot"`, this leg's `root` is the task root's place in it. `source` = the declared
1301
- * code source for that repository. ABSENT = the session declared no workspace. */
1429
+ * code source for that repository. ABSENT = the session declared no workspace, or this leg sent `workspace: null`. */
1302
1430
  session?: ReadonlyArray<{
1303
1431
  repository: string;
1304
1432
  root: "taskRoot" | {
@@ -1315,6 +1443,21 @@ export type TaskEvent = ({
1315
1443
  ref?: string;
1316
1444
  };
1317
1445
  }>;
1446
+ /** The declaration the session's checkout was opened under, normalized (present with `session`): the value every later leg
1447
+ * sends as `TaskSpec.workspace` — it screens to itself. The record judges each leg; this is what to send, not a verdict. */
1448
+ declaration?: {
1449
+ isolation?: "worktree";
1450
+ baseRef?: "fresh" | "head";
1451
+ name?: string;
1452
+ sources?: ReadonlyArray<{
1453
+ root: "taskRoot" | {
1454
+ directory: string;
1455
+ };
1456
+ remote: string;
1457
+ sha: string;
1458
+ ref?: string;
1459
+ }>;
1460
+ };
1318
1461
  /** This leg's project identity, decided ONCE at leg start and fixed for the leg: `marker` = the checkout's
1319
1462
  * `.sema/project` (a `TaskSpec.projectId`, when given, equals it); `declared` = `TaskSpec.projectId` in a checkout
1320
1463
  * that carries no marker. ABSENT = no marker and no declaration, or the marker could not be read (the deployment's
@@ -1382,13 +1525,22 @@ export type TaskEvent = ({
1382
1525
  export type HumanInputEvent = Extract<TaskEvent, {
1383
1526
  type: "human_input";
1384
1527
  }>;
1385
- /** One attachment on a `human_input` frame: its position, the kind the engine found (absent when the read was refused
1386
- * before the kind was known), what reached the model of its contents, and the path or name it was declared with. */
1528
+ /** One attachment frame's record: its position, the kind the engine found (absent when the read was refused before the
1529
+ * kind was known), what reached the model of its contents, and the path or name it was declared with (a restored file's
1530
+ * path). The record of a person's attachment on `human_input.attachments`, and of a compaction restore's frame on
1531
+ * `compacted.restoreOutcomes`. */
1387
1532
  export interface HumanInputAttachment {
1388
1533
  readonly ordinal: number;
1389
1534
  readonly kind?: UserAttachmentKind;
1390
1535
  readonly outcome: UserAttachmentOutcome;
1391
1536
  readonly label: string;
1537
+ /** Why the contents were not attached, when the engine's own frame says so: one word of the table the frame's notes read
1538
+ * (`import("./user-attachment.js").ATTACHMENT_REFUSAL_REASONS` — `cannot_bind`, `rule_denied`, `approval_required`,
1539
+ * `admission_unknown`, `target_moved`, and `too_large_to_restore`, which only a compaction restore's record states).
1540
+ * Present only on a `not_attached` attachment whose frame carries one of those notes;
1541
+ * absent on every attachment that reached the model, and on a refusal that says nothing of the kind (a read refusal given as
1542
+ * data, an extension's decline — see {@link declinedBy} —, a host image that did not admit). A display and audit fact; it decides nothing. */
1543
+ readonly reason?: import("./user-attachment.js").AttachmentRefusalReason;
1392
1544
  /** The extension of the leg that refused this attachment at its `prompt.mention` station, by its registration name — the same author
1393
1545
  * type {@link ExtensionRequester} and {@link RewriteAuthor} record elsewhere. Present only on a `not_attached` attachment whose refusal
1394
1546
  * the dispatch names: an extension's `{ deny }` / `{ type: null }` answer, or an extension whose handler failed (threw, ran past its
@@ -0,0 +1,26 @@
1
+ /**
2
+ * `TaskResult.intake` — whether a call's own input was taken into its conversation.
3
+ *
4
+ * One mint: the commit of the leg's prompt message (its prompt receipt, fired at the same append that publishes the
5
+ * row's `message_committed { role: "user" }` frame). {@link intakeOfCommit} is the reading of that commit; the run body
6
+ * publishes it on its backstop carrier, so the settled result and the failure backstop answer from the same record.
7
+ * {@link foldIntake} is the one projection a composition (verification gate, cascade, repair loop) applies to the legs
8
+ * it dispatched — never a second read of the store, never `stats.turns`.
9
+ */
10
+ import type { TaskResult } from "./task-result.js";
11
+ export type TaskIntake = NonNullable<TaskResult["intake"]>;
12
+ /**
13
+ * The intake fact of one committed prompt message. The entry id is the session store's answer for the append: only a
14
+ * non-empty string is an address (the same reading of a usable key a stored record hands over); anything else leaves the
15
+ * fact unknown rather than naming an entry nobody can find.
16
+ */
17
+ export declare function intakeOfCommit(sessionId: string, entryId: unknown): TaskIntake | undefined;
18
+ /**
19
+ * The intake of a composition, over the legs it dispatched in dispatch order: the first leg that took the input in;
20
+ * when none did, `{ committed: false }` if every leg said so and `undefined` (unknown) if any leg's account was unknown.
21
+ * A composition that dispatched no leg took nothing in.
22
+ */
23
+ export declare function foldIntake(legs: ReadonlyArray<unknown>): TaskIntake | undefined;
24
+ /** `result` with its `intake` member replaced by `intake` (dropped when unknown) — a composition's result carries its own
25
+ * fold, never the last leg's fact by spread. */
26
+ export declare function withIntake(result: TaskResult, intake: TaskIntake | undefined): TaskResult;
@@ -0,0 +1,31 @@
1
+ import { readMember } from "./thrown-value.js";
2
+ import { usableInputId } from "./user-row-origin.js";
3
+ export function intakeOfCommit(sessionId, entryId) {
4
+ const id = usableInputId(entryId);
5
+ return id === undefined ? undefined : { committed: true, sessionId, entryId: id };
6
+ }
7
+ function legIntake(value) {
8
+ const committed = readMember(value, "committed");
9
+ if (committed === false)
10
+ return { committed: false };
11
+ if (committed !== true)
12
+ return undefined;
13
+ const sessionId = readMember(value, "sessionId");
14
+ const entryId = usableInputId(readMember(value, "entryId"));
15
+ return typeof sessionId === "string" && sessionId !== "" && entryId !== undefined ? { committed: true, sessionId, entryId } : undefined;
16
+ }
17
+ export function foldIntake(legs) {
18
+ let unknown = false;
19
+ for (const leg of legs) {
20
+ const read = legIntake(leg);
21
+ if (read === undefined)
22
+ unknown = true;
23
+ else if (read.committed)
24
+ return read;
25
+ }
26
+ return unknown ? undefined : { committed: false };
27
+ }
28
+ export function withIntake(result, intake) {
29
+ const { intake: _leg, ...rest } = result;
30
+ return intake === undefined ? rest : { ...rest, intake };
31
+ }
@@ -69,11 +69,13 @@ export interface TaskLimits {
69
69
  */
70
70
  maxOutputTokens?: number;
71
71
  /**
72
- * design/164 — the LIMIT-APPROACH notice. While any of `maxTokens`/`maxCostUsd`/`maxTurns` is armed,
73
- * the engine injects at most two one-shot reminders at turn boundaries: one when the highest axis
74
- * ratio crosses the first threshold ("start converging"), one when it crosses the second ("deliver
75
- * now"). Both are advisory prompt frames — they never stop the run, and they never fire on a
76
- * resource-suspend task (a slice boundary is not a delivery deadline).
72
+ * design/164 — the LIMIT-APPROACH notice. While any of `maxTokens`/`maxCostUsd`/`maxTurns`/`maxWalltimeMs` is
73
+ * armed, every model request after the tightest axis crosses a threshold carries ONE sentence at its end: the
74
+ * first threshold's ("start converging") or, once the second is crossed, the second's ("deliver now") —
75
+ * chosen by the threshold crossed, so a first reading already past the second threshold is "deliver now".
76
+ * The sentence is request-only: it is never written to the transcript and never makes a request of its own.
77
+ * Advisory — it never stops the run, and it never fires on a resource-suspend task (a slice boundary is not
78
+ * a delivery deadline). The turn axis takes part only for a declared `maxTurns` of 4 or more.
77
79
  *
78
80
  * Default ON whenever an axis is armed; `false` switches it off. `{ at: [first, second] }` overrides
79
81
  * the thresholds (each a fraction in `(0, 1]`, first ≤ second).
@@ -90,7 +92,7 @@ export interface TaskLimits {
90
92
  * stretch the remaining budget — accepting lower quality instead of stopping at the ceiling. One-way
91
93
  * (never switches back); sets `TaskResult.degraded = { …, reason: "budget" }`. Requires
92
94
  * {@link maxCostUsd} (the fraction is of it); ignored otherwise. This is the proactive, Runner-level
93
- * complement to the reactive brain-level `createDegradingBrain` (rate_limit / breaker-open).
95
+ * complement to the reactive model lane (a catalog entry's `fallbacks` chain, walked per request).
94
96
  */
95
97
  degrade?: {
96
98
  to: ModelRef;