@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,6 +1,6 @@
1
1
  import type { ToolSpec } from "../core/types.js";
2
2
  import { type ToolLegKind, type ToolSelector, type ToolSelectorLayer } from "../core/tool-face.js";
3
- import { type ToolNameListReading } from "../core/tool-name-list.js";
3
+ import { type ToolNameListReading, type ToolNameListSide } from "../core/tool-name-list.js";
4
4
  /**
5
5
  * The tool selector (design/38 1A, one operation since #1623): what tools a run may use, read once over the universe it can get
6
6
  * (its pool, every tool the engine mounts on it, the protocol tools it connects) at its own prepare —
@@ -39,8 +39,7 @@ export type DeniedEntryReading = {
39
39
  readonly type: string;
40
40
  };
41
41
  export declare function readDeniedEntry(entry: unknown): DeniedEntryReading;
42
- /** The two tool-name lists of a definition, and the words a sentence calls each. */
43
- export type ToolNameListSide = "allowed" | "denied";
42
+ export type { ToolNameListSide };
44
43
  /** The sentence for an entry that is not a string: it can be no tool name; the sentence names its place and its type, never its value. */
45
44
  export declare function notAStringSentence(where: string, side: ToolNameListSide, index: number, type: string): string;
46
45
  /** The sentence for a value that is not a list, or a list that cannot be read: it names the type, never the value. */
@@ -57,11 +56,6 @@ export declare function delegationListWhere(toolName: string, definitionName: st
57
56
  * serializer cannot encode, which therefore never match any evidence.
58
57
  */
59
58
  export declare function toolListsDigest(allow: readonly unknown[] | undefined, deny: readonly unknown[] | undefined): string | undefined;
60
- /**
61
- * Why a host-written tool-name list cannot be one, as a sentence — or `undefined` when it is absent (`undefined` / `null`) or a list
62
- * of strings. The one reading the judgment before the run and the spawn-time check of a tool that never went through prepare share.
63
- */
64
- export declare function toolNameListFlaw(where: string, side: ToolNameListSide, value: unknown): string | undefined;
65
59
  /**
66
60
  * What ONE tool-name list reaches — the single reading every consumer of an allowed or a denied list takes: `names` are exact
67
61
  * spellings (a tool answers to its wire name and every alias it declares); `covering` the spellings that cover a SET
@@ -94,7 +88,7 @@ export declare function namesEveryTool(entry: unknown): boolean;
94
88
  * ({@link namesEveryTool}). A value that is not a list admits NOTHING (refused before the run).
95
89
  */
96
90
  export declare function readAllowedToolList(allowTools: unknown): ToolNameListReach | undefined;
97
- /** What a denied value hides: its string entries read as {@link readDeniedEntry} reads them (an entry it reads as `unreadable` or not a string, or a value that is not a list, hides nothing here — the judgment before the run refuses each). */
91
+ /** What a denied value hides: its string entries read as {@link readDeniedEntry} reads them (an entry it reads as `unreadable` or not a string, or a value that is not a list, hides nothing here — the judgment before the run refuses each; a DEFINITION's `unreadable` entry it tells instead, and the delegation to that definition is refused). */
98
92
  export declare function readDeniedToolList(denyTools: unknown): ToolNameListReach;
99
93
  /** Does the list reach this tool — through its wire name, any alias it declares, or a protocol spelling that covers it? The one matcher. */
100
94
  export declare function listReaches(reach: ToolNameListReach, tool: {
@@ -151,4 +145,3 @@ export declare function deniedProtocolTools(layers: readonly ToolSelectorLayer[]
151
145
  export declare function toolNameAllowed(name: string, allowTools?: ReadonlyArray<string>, denyTools?: ReadonlyArray<string>): boolean;
152
146
  /** The members of a pool one allowed / denied pair admits, in pool order (a fresh array; the pool is never mutated) — the selector's own answer for a single layer. */
153
147
  export declare function resolveToolSubset<T extends UniverseTool = ToolSpec>(pool: ReadonlyArray<T>, allowTools?: ReadonlyArray<string>, denyTools?: ReadonlyArray<string>): T[];
154
- export {};
@@ -31,19 +31,6 @@ export function toolListsDigest(allow, deny) {
31
31
  const canonical = canonicalize({ allow: allow ?? null, deny: deny ?? [] });
32
32
  return canonical === UNCANONICALIZABLE ? undefined : createHash("sha256").update(canonical, "utf8").digest("hex");
33
33
  }
34
- export function toolNameListFlaw(where, side, value) {
35
- if (value === undefined || value === null)
36
- return undefined;
37
- const list = readToolNameList(value);
38
- if (list.kind !== "entries")
39
- return notAListSentence(where, side, list);
40
- for (let i = 0; i < list.entries.length; i++) {
41
- const entry = list.entries[i];
42
- if (typeof entry !== "string")
43
- return notAStringSentence(where, side, i, valueTypeLabel(entry));
44
- }
45
- return undefined;
46
- }
47
34
  export function toolNameOfEntry(entry, side) {
48
35
  const read = readDeniedEntry(entry);
49
36
  return read.kind === "name" && (side === "denied" || !read.content) ? read.name : undefined;
@@ -0,0 +1,31 @@
1
+ /**
2
+ * The verification gate's reading of whether its verifier judged on a model other than the one that made the work.
3
+ *
4
+ * The gate exists because a model grading its own work confirms its own blind spots, so the verifier is meant to be a different model
5
+ * than the implementer. The engine cannot assert that when the roles are built (an unset `verifier` role falls back to the main model,
6
+ * and a tier default or a `verifierModel` can name the same entry as well), so the gate reads it where it is known: off the two legs'
7
+ * resolved ids (`TaskResult.model`, the engine-selected `Model.id`), after the verifier leg has run. One reading, one place, whatever
8
+ * route led to the same model.
9
+ */
10
+ import type { EngineNotice } from "../core/engine-notice.js";
11
+ import type { TaskResult } from "../core/types.js";
12
+ /** The notice code of the "same model" reading. */
13
+ export declare const VERIFIER_IS_IMPLEMENTER = "verify.verifier_is_implementer";
14
+ /** The seat that produced the verifier leg's model: the call's `verifierModel`, or the `verifier` role. */
15
+ export type VerifierSeat = "verifierModel" | "roles.verifier";
16
+ /** One reading: whether the verifier leg's model differs from the judged leg's, and the verifier leg's own id (the shared one when it does not). */
17
+ export interface IndependenceReading {
18
+ independent: boolean;
19
+ model: string;
20
+ }
21
+ /**
22
+ * Whether the two legs resolved to different model ids; `undefined` when either id is not known (that is "cannot say", never
23
+ * "independent"). Mid-run degradation is not read: the ids compared are the ones each leg was selected on.
24
+ */
25
+ export declare function readIndependence(judged: Pick<TaskResult, "model">, verifier: Pick<TaskResult, "model">): IndependenceReading | undefined;
26
+ /** The notice for a verifier that ran on the implementer's model. `sessionId` is the implementation's session; empty ⇒ none to attribute. */
27
+ export declare function verifierIsImplementerNotice(input: {
28
+ model: string;
29
+ verifierSeat: VerifierSeat;
30
+ sessionId: string;
31
+ }): EngineNotice;
@@ -0,0 +1,23 @@
1
+ export const VERIFIER_IS_IMPLEMENTER = "verify.verifier_is_implementer";
2
+ function resolvedModelId(r) {
3
+ return typeof r.model === "string" && r.model !== "" ? r.model : undefined;
4
+ }
5
+ export function readIndependence(judged, verifier) {
6
+ const a = resolvedModelId(judged);
7
+ const b = resolvedModelId(verifier);
8
+ return a === undefined || b === undefined ? undefined : { independent: a !== b, model: b };
9
+ }
10
+ export function verifierIsImplementerNotice(input) {
11
+ const model = input.model.length > 80 ? `${input.model.slice(0, 80)}…` : input.model;
12
+ return {
13
+ code: VERIFIER_IS_IMPLEMENTER,
14
+ message: `The verification gate's verifier ran on the same model as the work it judged (${model}; ${input.verifierSeat} resolved to it), so the verdict is that model grading its own work ` +
15
+ `and is reported with independent: false. Pass a verifierModel, or map the verifier role, to another model. Said once per gate run.`,
16
+ detail: {
17
+ model,
18
+ verifierSeat: input.verifierSeat,
19
+ ...(input.sessionId !== "" ? { sessionId: input.sessionId } : {}),
20
+ },
21
+ ...(input.sessionId !== "" ? { sessionId: input.sessionId } : {}),
22
+ };
23
+ }
@@ -59,8 +59,10 @@ export interface VerifyConfig {
59
59
  * — an LLM grading its own work confirms its own blind spots (service[33]: a strong heterogeneous judge
60
60
  * reading the diff caught the title()/csv/base62 defects the implementer's own tests missed). The default
61
61
  * `verifier` role falling back to `default` (= the implementer) DEFEATS this — pass an explicit
62
- * heterogeneous `verifierModel`, or map a distinct `verifier` role. Decorrelation is a deployment contract,
63
- * not something this layer can assert (role→model resolution lives in the Runner).
62
+ * heterogeneous `verifierModel`, or map a distinct `verifier` role. The gate cannot choose the model for you
63
+ * (role→model resolution lives in the Runner), but it READS the outcome: a verifier that ran on the implementer's
64
+ * model id is reported as `VerificationOutcome.independent: false` and announced once per gate run
65
+ * (`verify.verifier_is_implementer`); the verification still runs.
64
66
  */
65
67
  verifierModel?: ModelRef;
66
68
  /**
@@ -166,6 +168,16 @@ export interface VerificationOutcome {
166
168
  findings: string[];
167
169
  /** Evidence (commands + output) from the final verification, if the verifier supplied it. */
168
170
  evidence?: string;
171
+ /**
172
+ * Whether the verifier of the FINAL verification ran on a model other than the one that made the work it judged — the independence
173
+ * the gate exists for. `true`: two model ids ({@link TaskResult.model} of the verifier leg and of the implementation leg it judged).
174
+ * `false`: the SAME id — the verdict is the implementer grading its own work, announced once per gate run as
175
+ * `verify.verifier_is_implementer`; the verification ran and its verdict stands, this bit is what says how far to trust it.
176
+ * **In-presence condition**: a verifier leg ran AND both legs' results carry a `model` id; absent otherwise (no verifier ran, or a
177
+ * hand-built / synthetic result with no id — "cannot say" is not "independent"). Read off the ids each leg was SELECTED on, so a
178
+ * mid-run degradation to another model is not seen.
179
+ */
180
+ independent?: boolean;
169
181
  /**
170
182
  * Total cost (micro-USD) of the VERIFIER run(s) across all rounds — the verification OVERHEAD, separate from
171
183
  * the implementation's own cost (which is the returned `TaskResult.stats`, as the verifier runs in its own
@@ -268,8 +280,8 @@ export declare function verifyCompleted(runner: RunnerSelfSeat, result: TaskResu
268
280
  * WHY THE SEAT EXISTS: these entries return a `TaskResult` and DRAIN each leg's event stream
269
281
  * internally, so the host never holds a `TaskStream` for any of them. Without this parameter a
270
282
  * deployment can observe nothing a leg did — tool beats, forwarded child progress, the resolved
271
- * workspace, the leg's own wiring manifest — only the final result. Wiring an observation sink here
272
- * (`onActivity`, `onForwardEvent`, `onWorkspaceResolved`, `onWiringManifest`) is the only way in.
283
+ * workspace, the leg's own frames (status, wiring manifest, committed rows) — only the final result. Wiring an
284
+ * observation sink here (`onActivity`, `onForwardEvent`, `onWorkspaceResolved`, `onLegFrame`) is the only way in.
273
285
  *
274
286
  * ATTRIBUTION — WEAK, and deliberately stated as such: the legs run SEQUENTIALLY (impl → verifier →
275
287
  * fix → verifier → …) with the SAME object, so a leg's beats are all delivered before the next leg
@@ -283,13 +295,13 @@ export declare function verifyCompleted(runner: RunnerSelfSeat, result: TaskResu
283
295
  * `onForwardEvent` do carry their own `sourceTaskId`, and a BACKGROUND child outlives the leg that
284
296
  * spawned it — its frames can arrive interleaved into a later leg's segment.
285
297
  *
286
- * ONE SEAT IS EXEMPT, because its frame is per-leg by construction: `onWiringManifest` fires once
287
- * per leg, at that leg's start, and this gate hands it the leg's own IDENTITY beside the manifest
288
- * (the axis, and the two readings a consumer cannot infer, are documented at the seat). That
289
- * identity is minted HERE, in the dispatch that knows it — the engine stamps none — so this seat's
290
- * consumer reads per-leg attribution instead of reconstructing it from arrival order. It is also
291
- * the one place the forwarding below is not by identity: a caller that wired that sink gets a fresh
292
- * per-dispatch copy carrying the bound sink (see `withLegIdentity`), other fields by reference.
298
+ * ONE SEAT IS EXEMPT, because its frames are per-leg by construction: `onLegFrame` is handed every
299
+ * frame a leg offers with that leg's address (its task id and session, engine facts), and this gate
300
+ * adds the leg's own LABEL (`at.leg`: `impl` / `verifier` / `fix` with the round). That label is
301
+ * minted HERE, in the dispatch that knows it — the engine stamps none — so this seat's consumer reads
302
+ * per-leg attribution instead of reconstructing it from arrival order. It is also the one place the
303
+ * forwarding below is not by identity: a caller that wired that seat gets a fresh per-dispatch copy
304
+ * carrying the bound seat (see `withLegIdentity`), other fields by reference.
293
305
  *
294
306
  * FAILURE-ISOLATED, by the same primitive as {@link VerifyConfig.onRound} /
295
307
  * {@link VerifyConfig.onVerifierPause}: the fields on this object are invoked by the ENGINE on the
@@ -6,9 +6,13 @@ import { mapNestedSuspend, isDurablePause, pauseFamily } from "./suspend-guard.j
6
6
  import { delimitUntrusted, sanitizeUntrustedText } from "../core/untrusted-text.js";
7
7
  import { createSafeNotifier } from "../core/safe-notify.js";
8
8
  import { createCumulativeStatsTracker } from "./cumulative-stats.js";
9
+ import { foldIntake, withIntake } from "../core/task-intake.js";
9
10
  import { compositionPlacement } from "./composition-placement.js";
10
11
  import { laterLegAllowance } from "./composition-allowance.js";
11
12
  import { recipeContinuationLeg } from "../core/input-author.js";
13
+ import { readIndependence, verifierIsImplementerNotice } from "./verifier-independence.js";
14
+ import { withOpeningObjective } from "../core/task-spec-members.js";
15
+ import { withLegIdentity } from "./leg-label.js";
12
16
  export const VERIFICATION_PROMPT = `You are a verification specialist. Your job is NOT to confirm the implementation works — it is to try to BREAK it.
13
17
 
14
18
  You have two documented failure patterns. First, verification avoidance: faced with a check, you find reasons not to run it — you read code, narrate what you would test, declare "PASS," and move on. Second, being seduced by the first 80%: a polished result or a passing test suite makes you inclined to pass it, not noticing the edge that crashes, the state that vanishes, the bad input that is unhandled. The first 80% is the easy part. Your entire value is in finding the last 20%.
@@ -66,6 +70,7 @@ export const VerdictSchema = Type.Object({
66
70
  });
67
71
  const VERIFY_ON_ROUND_SITE = "verify.onRound";
68
72
  const VERIFY_ON_VERIFIER_PAUSE_SITE = "verify.onVerifierPause";
73
+ const VERIFY_EMIT_NOTICE_SITE = "verify.emitNotice";
69
74
  const VERIFY_INTERNALS_ERROR_CODE = "config.verify_internals_invalid";
70
75
  function verifyInternalsError(message) {
71
76
  const e = new Error(message);
@@ -84,12 +89,6 @@ function refuseUnhonorableInternals(internals, phase) {
84
89
  `implementation leg keeps whatever it did (a consumed checkpoint stays consumed, its session stays the caller's to reclaim).`));
85
90
  }
86
91
  }
87
- function withLegIdentity(internals, leg, caller) {
88
- if (internals?.onWiringManifest === undefined)
89
- return internals;
90
- const identity = Object.freeze({ ...leg });
91
- return { ...internals, onWiringManifest: (manifest) => (caller ?? internals).onWiringManifest?.(manifest, identity) };
92
- }
93
92
  const IMPL_LEG = { kind: "impl", round: 0 };
94
93
  const GATE_RESUME_ENTRY = { door: "resumeWithVerification" };
95
94
  function fixObjective(findings) {
@@ -172,6 +171,7 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
172
171
  limits: { ...(specBase.limits?.maxWalltimeMs !== undefined ? { maxWalltimeMs: specBase.limits.maxWalltimeMs } : {}) },
173
172
  getApiKeyAndHeaders: specBase.getApiKeyAndHeaders,
174
173
  ...(specBase.principal !== undefined ? { principal: specBase.principal } : {}),
174
+ ...(specBase.isolationScope !== undefined ? { isolationScope: specBase.isolationScope } : {}),
175
175
  ...(specBase.allowTools !== undefined
176
176
  ? { allowTools: Array.isArray(specBase.allowTools) ? [...specBase.allowTools] : specBase.allowTools }
177
177
  : {}),
@@ -189,12 +189,18 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
189
189
  : {}),
190
190
  ...(specBase.clientContext !== undefined ? { clientContext: { ...specBase.clientContext } } : {}),
191
191
  ...(specBase.promptLean !== undefined ? { promptLean: specBase.promptLean } : {}),
192
+ ...(specBase.promptLocale !== undefined ? { promptLocale: specBase.promptLocale } : {}),
192
193
  signal: specBase.signal,
193
194
  };
194
195
  const v = await runner.runTask(verifierSpec, withLegIdentity(verifierLegInternals(round), { kind: "verifier", round }, internals));
195
196
  try {
196
197
  const cost = (v.stats.costMicroUsd ?? 0) + (v.stats.nested?.costMicroUsd ?? 0);
197
- return { verdict: v.structuredOutput, cost, ...(isDurablePause(v.terminal) ? { paused: { ...v, terminal: v.terminal } } : {}) };
198
+ return {
199
+ verdict: v.structuredOutput,
200
+ cost,
201
+ reading: readIndependence(impl, v),
202
+ ...(isDurablePause(v.terminal) ? { paused: { ...v, terminal: v.terminal } } : {}),
203
+ };
198
204
  }
199
205
  finally {
200
206
  if (!isDurablePause(v.terminal))
@@ -204,11 +210,13 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
204
210
  let current = result;
205
211
  const implAccount = createCumulativeStatsTracker();
206
212
  implAccount.add(result.stats);
207
- const withImplAccount = (r) => implAccount.legs > 1 ? { ...r, stats: implAccount.build(r.stats) } : r;
213
+ const implIntakes = [result.intake];
214
+ const withImplAccount = (r) => implAccount.legs > 1 ? withIntake({ ...r, stats: implAccount.build(r.stats) }, foldIntake(implIntakes)) : r;
208
215
  let outcome = { verdict: "unverified", rounds: 0, findings: [] };
209
216
  const startedAt = Date.now();
210
217
  let spend = 0;
211
218
  let verifierSpend = 0;
219
+ let announcedSameModel = false;
212
220
  for (let round = 1; round <= maxRounds; round++) {
213
221
  if (round > 1) {
214
222
  if (config.totalTimeoutMs != null && Date.now() - startedAt >= config.totalTimeoutMs)
@@ -219,6 +227,13 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
219
227
  const v = await runVerifier(current, round);
220
228
  spend += v.cost;
221
229
  verifierSpend += v.cost;
230
+ if (v.reading?.independent === false && !announcedSameModel) {
231
+ announcedSameModel = true;
232
+ const model = v.reading.model;
233
+ const verifierSeat = config.verifierModel ? "verifierModel" : "roles.verifier";
234
+ notifier.notify(() => runner.emitNotice?.(verifierIsImplementerNotice({ model, verifierSeat, sessionId: result.sessionId })), VERIFY_EMIT_NOTICE_SITE);
235
+ }
236
+ const independentFact = v.reading !== undefined ? { independent: v.reading.independent } : {};
222
237
  if (v.paused) {
223
238
  const verifierPause = {
224
239
  status: pauseFamily(v.paused.terminal),
@@ -232,6 +247,7 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
232
247
  unverifiedReason: "verifier_paused",
233
248
  rounds: round,
234
249
  findings: [],
250
+ ...independentFact,
235
251
  verifierCost: verifierSpend,
236
252
  verifierPause,
237
253
  };
@@ -248,6 +264,7 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
248
264
  rounds: round,
249
265
  findings: v.verdict?.findings ?? [],
250
266
  evidence: v.verdict?.evidence,
267
+ ...independentFact,
251
268
  verifierCost: verifierSpend,
252
269
  };
253
270
  notifier.notify(() => config.onRound?.({ round, verdict: outcome.verdict, findings: outcome.findings }), VERIFY_ON_ROUND_SITE);
@@ -266,9 +283,7 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
266
283
  }
267
284
  refuseUnhonorableInternals(internals, "before_leg");
268
285
  const fixLegSpec = {
269
- ...allowance.spec,
270
- sessionId: current.sessionId,
271
- objective: fixObjective(outcome.findings),
286
+ ...withOpeningObjective({ ...allowance.spec, sessionId: current.sessionId }, fixObjective(outcome.findings)),
272
287
  ...childClampSeats({
273
288
  ...clampSourceOf(specBase),
274
289
  readFace: foldedRootsFace ? "roots" : specBase.readFace,
@@ -279,6 +294,7 @@ async function verifyCompletedPlaced(runner, result, specBase, objective, config
279
294
  current = await runner.runTask(fixLegSpec, withLegIdentity(legInternals(), { kind: "fix", round }, internals));
280
295
  spend += (current.stats.costMicroUsd ?? 0) + (current.stats.nested?.costMicroUsd ?? 0);
281
296
  implAccount.add(current.stats);
297
+ implIntakes.push(current.intake);
282
298
  if (isDurablePause(current.terminal)) {
283
299
  return { ...mapNestedSuspend(carryFrozenPosture(withImplAccount(current)), GATE_RESUME_ENTRY), verification: outcome };
284
300
  }
@@ -300,7 +316,7 @@ export async function runWithVerification(runner, implSpec, config = {}, interna
300
316
  export async function resumeWithVerification(runner, token, outcome, taskConfig, objective, config = {}, internals) {
301
317
  refuseUnhonorableInternals(internals, "door");
302
318
  const placement = compositionPlacement(internals);
303
- const result = await runner.resume(token, outcome, taskConfig, withLegIdentity(placement.firstLeg, IMPL_LEG, internals));
319
+ const result = await runner.resume(token, outcome, taskConfig, withLegIdentity(placement.firstLeg, IMPL_LEG, internals, "resumeStream"));
304
320
  if (isDurablePause(result.terminal)) {
305
321
  return { ...mapNestedSuspend(result, GATE_RESUME_ENTRY), verification: { verdict: "unverified", unverifiedReason: pauseFamily(result.terminal), rounds: 0, findings: [] } };
306
322
  }
@@ -0,0 +1,24 @@
1
+ import type { ToolExecuteContext, ToolSpec } from "../core/types.js";
2
+ import type { SubagentToolOptions } from "./subagent.js";
3
+ /** What one leg's adoption of its yielded background agents came to: the rows it claimed and drove on, the ones it
4
+ * could not (each with why), and — when the row store could not be read at all — why (`unreadable`). */
5
+ export interface YieldedAgentAdoption {
6
+ readonly adopted: readonly string[];
7
+ readonly refused: ReadonlyArray<{
8
+ readonly id: string;
9
+ readonly why: string;
10
+ }>;
11
+ readonly unreadable?: string;
12
+ }
13
+ type Enrich = (ctx: ToolExecuteContext) => ToolExecuteContext;
14
+ /** Register a delegation tool node's adoption (the factory's own call, on the node it built; a node without a background
15
+ * lane has none). */
16
+ export declare function registerYieldAdoption(node: ToolSpec, bag: SubagentToolOptions["background"]): void;
17
+ /** A leg's one adoption step, once it is sure to run: every delegation tool on its spec continues the yielded agents this
18
+ * leg owns (see {@link adoptYieldedAgents}); what could not be continued is said once on `onError`. Never throws. */
19
+ export declare function adoptYieldedBackgroundWork(tools: ReadonlyArray<{
20
+ readonly execute: unknown;
21
+ }>, enrich: Enrich, leg: {
22
+ readonly resumed: boolean;
23
+ }, onError: (e: Error) => void): Promise<void>;
24
+ export {};
@@ -0,0 +1,84 @@
1
+ import { isolationScopeOf } from "../core/isolation-scope.js";
2
+ import { parentSpecSeatOfCtx } from "../core/parent-spec-seat.js";
3
+ import { thrownText } from "../core/thrown-value.js";
4
+ import { inlineUntrusted } from "../core/untrusted-text.js";
5
+ import { delegationRegistryOf } from "./delegation-registry-seat.js";
6
+ const yieldAdoptions = new WeakMap();
7
+ async function adoptYieldedAgents(bag, execute, enrich, leg) {
8
+ const adopted = [];
9
+ const refused = [];
10
+ let unreadable;
11
+ try {
12
+ const ctx = enrich({ toolCallId: "yield-adoption" });
13
+ const store = bag.agentStore;
14
+ const parkStore = ctx.checkpointStoreForChildren === undefined ? bag.checkpointStore : ctx.checkpointStoreForChildren === "disabled" ? undefined : ctx.checkpointStoreForChildren;
15
+ if (store === undefined || parkStore === undefined || bag.ensureChildSessionDurable === undefined || ctx.sessionId === undefined)
16
+ return { adopted, refused };
17
+ const scope = isolationScopeOf(parentSpecSeatOfCtx(ctx) ?? {}) ?? bag.scope;
18
+ const owner = ctx.taskId ?? bag.owner;
19
+ const sessionId = ctx.sessionId;
20
+ const registry = delegationRegistryOf(ctx, bag);
21
+ for (const summary of await store.listBySession(scope, sessionId, { status: "parked" })) {
22
+ if ("rowVerdict" in summary)
23
+ continue;
24
+ if (!(summary.sessionScoped ? summary.owner === sessionId : leg.resumed && summary.owner === owner))
25
+ continue;
26
+ const row = await store.get(summary.handle, scope);
27
+ if (row === null || row.status !== "parked" || row.parkedCheckpointToken === undefined)
28
+ continue;
29
+ const cp = await parkStore.get(row.parkedCheckpointToken);
30
+ if (cp === null || cp.status !== "pending" || cp.gate.kind !== "resource_limit" || cp.gate.reason !== "preempt")
31
+ continue;
32
+ const claim = await registry.claimParkedAgent({ agentStore: store, checkpointStore: parkStore }, row.handle, { owner, scope, sessionId });
33
+ if (!claim.ok) {
34
+ if (claim.reason === "store_unreachable")
35
+ refused.push({ id: row.handle, why: "the store could not be reached to claim it" });
36
+ continue;
37
+ }
38
+ const ticket = claim.ticket;
39
+ if (ticket.token !== row.parkedCheckpointToken) {
40
+ await registry.rollbackParkedClaim({ agentStore: store, checkpointStore: parkStore }, ticket).catch(() => undefined);
41
+ continue;
42
+ }
43
+ try {
44
+ const out = await execute({ description: row.description ?? "yielded agent", prompt: "continue", run_in_background: true, ...(row.agentType !== undefined ? { subagent_type: row.agentType } : {}), name: row.name, ...(row.model !== undefined ? { model: row.model } : {}) }, enrich({ toolCallId: `yield-drive-${ticket.claimId}`, reviveClaim: { row: { ...structuredClone(ticket.row), parkClaimId: ticket.claimId }, rev: ticket.reservedRev, parkedResume: { ticket, outcome: { gate: "resource_limit", decision: "continue" } } } }));
45
+ if (typeof out === "object" && out !== null && out.isError === true)
46
+ throw new Error(inlineUntrusted(JSON.stringify(out.content ?? ""), 300));
47
+ adopted.push(row.handle);
48
+ }
49
+ catch (e) {
50
+ await registry.rollbackParkedClaim({ agentStore: store, checkpointStore: parkStore }, ticket).catch(() => undefined);
51
+ refused.push({ id: row.handle, why: inlineUntrusted(thrownText(e), 300) });
52
+ }
53
+ }
54
+ }
55
+ catch (e) {
56
+ unreadable = inlineUntrusted(thrownText(e), 300);
57
+ }
58
+ return { adopted, refused, ...(unreadable !== undefined ? { unreadable } : {}) };
59
+ }
60
+ export function registerYieldAdoption(node, bag) {
61
+ if (bag !== undefined)
62
+ yieldAdoptions.set(node.execute, (enrich, leg) => adoptYieldedAgents(bag, node.execute, enrich, leg));
63
+ }
64
+ export async function adoptYieldedBackgroundWork(tools, enrich, leg, onError) {
65
+ const seen = new Set();
66
+ for (const tool of tools) {
67
+ const adopt = typeof tool.execute === "function" ? yieldAdoptions.get(tool.execute) : undefined;
68
+ if (adopt === undefined || seen.has(adopt))
69
+ continue;
70
+ seen.add(adopt);
71
+ const { refused, unreadable } = await adopt(enrich, leg);
72
+ const said = [
73
+ ...(unreadable !== undefined ? [`this leg could not look for the yielded background agents it owns — the row store answered: ${unreadable}; the next leg looks again.`] : []),
74
+ ...(refused.length > 0 ? [`this leg could not continue ${refused.length} yielded background agent(s) it owns: ${refused.map((r) => `${r.id} (${r.why})`).join("; ")} — they stay parked and the next leg tries again.`] : []),
75
+ ];
76
+ for (const sentence of said) {
77
+ try {
78
+ onError(new Error(sentence));
79
+ }
80
+ catch {
81
+ }
82
+ }
83
+ }
84
+ }
@@ -162,7 +162,7 @@ export interface CoreStatsSubset {
162
162
  nested?: {
163
163
  costMicroUsd?: number;
164
164
  };
165
- /** design/91 human-review burden (the C2 source). Absent ⇒ no approval gate was hit. */
165
+ /** design/91 human-review burden (the C2 source). Absent ⇒ no ledger was kept for the run (read as zero here). */
166
166
  humanReview?: {
167
167
  count: number;
168
168
  totalWaitMs: number;
@@ -229,7 +229,7 @@ export interface CostComponents {
229
229
  * composition done is WITHIN C1 (all µUSD, same unit); it never reaches across to C2.
230
230
  */
231
231
  export declare function deriveC1(stats: CoreStatsSubset): number;
232
- /** §2.4 — derive C2 (count, seconds) from `stats.humanReview` (design/91). Absent ⇒ no gate ⇒ (0,0). */
232
+ /** §2.4 — derive C2 (count, seconds) from `stats.humanReview` (design/91). Absent ⇒ no ledger ⇒ (0,0). */
233
233
  export declare function deriveC2(stats: CoreStatsSubset): {
234
234
  count: number;
235
235
  sec: number;
@@ -14,8 +14,10 @@ export interface AnthropicBrainConfig extends StreamEngineConfig {
14
14
  /** `max_tokens` when the call/model doesn't specify one (Anthropic requires it). Default 4096. */
15
15
  defaultMaxTokens?: number;
16
16
  /**
17
- * Insert `cache_control: {type:"ephemeral"}` prompt-cache breakpoints on the last system block and
18
- * the last tool, so the (stable) system + tools prefix is cached across requests. Default true.
17
+ * Insert `cache_control` prompt-cache breakpoints on the last system block and the last tool, so the (stable) system +
18
+ * tools prefix is cached across requests. Default true. Their lifetime is the request's retention word
19
+ * (`StreamOptions.cacheRetention`: `short` / absent ⇒ `{type:"ephemeral"}`, `long` ⇒ `{type:"ephemeral", ttl:"1h"}`); `false`
20
+ * here sends none and moves no lifetime, and a request whose word is `none` sends none whatever this says.
19
21
  */
20
22
  cacheBreakpoints?: boolean;
21
23
  /**