@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
@@ -9,6 +9,9 @@ import { mintNamespacePrefix } from "../protocol-naming.js";
9
9
  import { PROTOCOL_TABLE, protocolOf } from "../protocol-table.js";
10
10
  import { grantWildcardRefusalOf, mountedToolNames, splitNamespacedName } from "../tool-name-aliases.js";
11
11
  import { POLICY_NAME_REFUSAL_CODE, retiredToolNameNotice } from "../retired-tool-name-account.js";
12
+ import { unmatchedNameIdentity, unmatchedNameWarning, unmatchedNamesNotice } from "../unmatched-tool-names.js";
13
+ import { DEFINITION_ENTRY_CODE, DEFINITION_ENTRY_REASON, definitionEntryIdentity, definitionEntryNotice, definitionEntryWarning } from "../definition-entry-grammar.js";
14
+ import { closestName } from "../closest-name.js";
12
15
  import { projectionToolNames } from "../tool-policy.js";
13
16
  import { declaredDelegationNameOf } from "../delegation-name.js";
14
17
  import { announceDigest } from "./announce-once-ledger.js";
@@ -61,6 +64,7 @@ function childFacingUniverse(pool, declaredPeers) {
61
64
  const known = new Set([...mountedToolNames(ENGINE_TOOLS), ...pool.names]);
62
65
  return { known, peers: peersOf(known, declaredPeers), complete: pool.complete, carrierOf: (name) => (pool.names.has(name) ? "pool" : "catalog") };
63
66
  }
67
+ const NO_LISTS = Object.freeze({ deny: Object.freeze([]) });
64
68
  const DENY_LIST_NAMES_ONLY = "To block by path or command, write a deny rule in the caller's permission policy: a tool-name list only takes tool names (it narrows which tools are mounted).";
65
69
  function universeCarries(reach, entry, universe) {
66
70
  for (const name of universe.known)
@@ -94,23 +98,53 @@ const NEAR_MISS_EFFECT = {
94
98
  function nearMissRefusal(where, side, flaw, code) {
95
99
  return refused(`${where} declares tool ${inertEntryPhrase(flaw)} in its ${LIST_WORD[side]}, a spelling that reaches no tool a run mounts — ${NEAR_MISS_EFFECT[side]}. Write the name as the tool is mounted.`, code, "near_miss");
96
100
  }
97
- function grammarRefusal(where, side, flaw, code) {
98
- return refused(`${where} declares tool ${inertEntryPhrase(flaw)} in its ${LIST_WORD[side]}, a spelling no tool name can have — fix the entry. ${DENY_LIST_NAMES_ONLY}`, code, "unknown_name");
101
+ function grammarSentence(where, side, entry, consequence) {
102
+ return `${where} declares tool ${inertEntryPhrase({ entry, reason: "grammar" })} in its ${LIST_WORD[side]}, a spelling no tool name can have — ${consequence} ${DENY_LIST_NAMES_ONLY}`;
99
103
  }
100
- function readableToolNameList(where, side, value, code) {
104
+ const GRAMMAR_REFUSES_THE_RUN = "fix the entry.";
105
+ const GRAMMAR_REFUSES_THE_DEFINITION = "this agent cannot be delegated to until the entry is fixed.";
106
+ const isGrammarFlaw = (flaw) => flaw.reason === DEFINITION_ENTRY_REASON;
107
+ const isStructuralFlaw = (flaw) => flaw.reason !== DEFINITION_ENTRY_REASON;
108
+ function readToolNameListForm(where, side, value) {
101
109
  if (value === undefined || value === null)
102
- return [];
110
+ return { entries: [], flaws: [] };
103
111
  const list = readToolNameList(value);
104
112
  if (list.kind !== "entries")
105
- throw refused(notAListSentence(where, side, list), code, "not_a_list");
106
- return list.entries.map((entry, index) => {
113
+ return { entries: [], flaws: [{ reason: "not_a_list", message: notAListSentence(where, side, list) }] };
114
+ const entries = [];
115
+ const flaws = [];
116
+ list.entries.forEach((entry, index) => {
107
117
  const read = readDeniedEntry(entry);
108
118
  if (read.kind === "not_a_string")
109
- throw refused(notAStringSentence(where, side, index, read.type), code, "not_a_string");
110
- if (read.kind === "unreadable")
111
- throw grammarRefusal(where, side, { entry: read.entry, reason: "grammar" }, code);
112
- return { entry: entry, name: read.name, content: read.content };
119
+ flaws.push({ reason: "not_a_string", message: notAStringSentence(where, side, index, read.type) });
120
+ else if (read.kind === "unreadable")
121
+ flaws.push({ reason: DEFINITION_ENTRY_REASON, entry: read.entry });
122
+ else
123
+ entries.push({ entry: entry, name: read.name, content: read.content });
113
124
  });
125
+ return { entries, flaws };
126
+ }
127
+ function formRefusal(where, side, flaw, code) {
128
+ if (isStructuralFlaw(flaw))
129
+ return refused(flaw.message, code, flaw.reason);
130
+ return refused(grammarSentence(where, side, flaw.entry, GRAMMAR_REFUSES_THE_RUN), code, "unknown_name");
131
+ }
132
+ function readableToolNameList(where, side, value, code) {
133
+ const form = readToolNameListForm(where, side, value);
134
+ const first = form.flaws[0];
135
+ if (first !== undefined)
136
+ throw formRefusal(where, side, first, code);
137
+ return form.entries;
138
+ }
139
+ export function toolNameListFlaw(where, side, value, withGrammar) {
140
+ return definitionFlawOf(where, side, readToolNameListForm(where, side, value).flaws, withGrammar);
141
+ }
142
+ function definitionFlawOf(where, side, flaws, withGrammar) {
143
+ const structural = flaws.find(isStructuralFlaw);
144
+ if (structural !== undefined)
145
+ return { message: structural.message, reason: structural.reason };
146
+ const grammar = withGrammar ? flaws.find(isGrammarFlaw) : undefined;
147
+ return grammar !== undefined ? { message: grammarSentence(where, side, grammar.entry, GRAMMAR_REFUSES_THE_DEFINITION), reason: grammar.reason } : undefined;
114
148
  }
115
149
  const KEPT_ENTRY = {
116
150
  allowed: "it grants nothing today and stays in force for a tool of that name mounted later",
@@ -118,8 +152,16 @@ const KEPT_ENTRY = {
118
152
  };
119
153
  const KEPT_ENTRY_UNLISTED_POOL = "so it is kept here: the pool this delegation tool hands its child cannot be listed, and the spawned child judges the entry against its own roster (another spelling of a tool it carries refuses the child before it starts; an exact name takes effect; a name nothing answers to there stays in force for a tool of that name mounted later)";
120
154
  const PEER_WORD = { mcp: "MCP server", a2a: "A2A peer" };
121
- function judgeToolNameList(where, side, value, universe, advise, code, retired) {
122
- for (const { entry, name: toolName, content: written } of readableToolNameList(where, side, value, code)) {
155
+ function judgeToolNameList(where, side, value, universe, advise, code, retired, definition) {
156
+ const form = readToolNameListForm(where, side, value);
157
+ const refusing = definition === true ? form.flaws.find(isStructuralFlaw) : form.flaws[0];
158
+ if (refusing !== undefined)
159
+ throw formRefusal(where, side, refusing, code);
160
+ const first = form.flaws.find(isGrammarFlaw);
161
+ if (first !== undefined) {
162
+ advise(definitionEntryWarning(grammarSentence(where, side, first.entry, GRAMMAR_REFUSES_THE_DEFINITION), { where: inlineUntrusted(where, 160), side, entry: inlineUntrusted(first.entry, 120), identity: JSON.stringify([where, side, first.entry]) }));
163
+ }
164
+ for (const { entry, name: toolName, content: written } of form.entries) {
123
165
  if (toolName === "*" && !written)
124
166
  continue;
125
167
  const name = side === "denied" || !written ? toolName : entry;
@@ -152,11 +194,26 @@ function judgeToolNameList(where, side, value, universe, advise, code, retired)
152
194
  const phrase = flaw !== undefined ? inertEntryPhrase(flaw) : renderListEntry(entry);
153
195
  const undeclared = split !== undefined && split.peer !== "" && !split.peer.includes("*") && !universe.peers.has(mintNamespacePrefix(split.ns, split.peer));
154
196
  const why = undeclared ? `no ${PEER_WORD[split.ns.id]} named "${inlineUntrusted(split.peer, 80)}" is declared for this task` : universe.complete ? "no tool of this task answers to that name" : "no tool this run can list answers to that name";
155
- advise(new Error(`${where} declares tool ${phrase} in its ${LIST_WORD[side]}: ${why}, ${universe.complete ? `so ${KEPT_ENTRY[side]}` : KEPT_ENTRY_UNLISTED_POOL}. If the name is misspelt, fix the entry.`));
197
+ const near = flaw?.currentName === undefined ? closestName(toolName, universe.known) : undefined;
198
+ const nearest = near !== undefined && near !== toolName ? near : undefined;
199
+ const hint = nearest !== undefined ? ` The nearest name ${universe.complete ? "a tool of this task answers to" : "a tool this run can list answers to"} is "${inlineUntrusted(nearest, 80)}".` : "";
200
+ advise(unmatchedNameWarning(`${where} declares tool ${phrase} in its ${LIST_WORD[side]}: ${why}, ${universe.complete ? `so ${KEPT_ENTRY[side]}` : KEPT_ENTRY_UNLISTED_POOL}. If the name is misspelt, fix the entry.${hint}`, {
201
+ where: inlineUntrusted(where, 160),
202
+ side,
203
+ entry: inlineUntrusted(entry, 120),
204
+ identity: JSON.stringify([where, side, entry]),
205
+ ...(nearest !== undefined ? { nearest: inlineUntrusted(nearest, 80) } : {}),
206
+ }));
156
207
  }
157
208
  }
158
- export function deniedToolNamesOf(where, value) {
159
- return readableToolNameList(where, "denied", value, "config.agent.unknown_tool").map((read) => read.name);
209
+ export function workflowAgentTypeWhere(agentType) {
210
+ return `workflow agentType "${inlineUntrusted(agentType, 80)}"`;
211
+ }
212
+ export function refuseUnusableDefinition(agentType, lists) {
213
+ const where = workflowAgentTypeWhere(agentType);
214
+ const flaw = toolNameListFlaw(where, "allowed", lists.allowTools, true) ?? toolNameListFlaw(where, "denied", lists.denyTools, true);
215
+ if (flaw !== undefined)
216
+ throw refused(flaw.message, DEFINITION_ENTRY_CODE, flaw.reason);
160
217
  }
161
218
  function inheritedListsWhere(ceilings, i) {
162
219
  const up = ceilings - 1 - i;
@@ -192,32 +249,42 @@ export function readToolSelector(input) {
192
249
  });
193
250
  return compileToolSelector(read, input.legs);
194
251
  }
195
- function ownToolListsFlaw(value) {
252
+ function readOwnToolListsRecord(value) {
196
253
  try {
197
254
  if (typeof value !== "object" || value === null || Array.isArray(value))
198
- return `a value that is ${valueTypeLabel(value)}, not a tool name with an agent definition name and the digest of the lists it wrote`;
255
+ return { flaw: `a value that is ${valueTypeLabel(value)}, not a tool name with an agent definition name and the digest of the lists it wrote` };
199
256
  const { toolName, definition, lists } = value;
200
257
  if (typeof toolName !== "string" || toolName.length === 0)
201
- return `a tool whose name is ${typeof toolName === "string" ? "empty" : `a value that is ${valueTypeLabel(toolName)}`}, not a tool name`;
258
+ return { flaw: `a tool whose name is ${typeof toolName === "string" ? "empty" : `a value that is ${valueTypeLabel(toolName)}`}, not a tool name` };
202
259
  const problem = callerToolNameProblem(toolName);
203
260
  if (problem !== undefined)
204
- return `a tool whose name is not one a caller tool can carry (${problem})`;
261
+ return { flaw: `a tool whose name is not one a caller tool can carry (${problem})` };
205
262
  if (definition !== undefined && typeof definition !== "string")
206
- return `an agent definition whose name is a value that is ${valueTypeLabel(definition)}, not a name`;
263
+ return { flaw: `an agent definition whose name is a value that is ${valueTypeLabel(definition)}, not a name` };
207
264
  if (definition === "")
208
- return "an agent definition whose name is empty, not a name";
265
+ return { flaw: "an agent definition whose name is empty, not a name" };
209
266
  if (lists === undefined)
210
- return "a record with no digest of the lists it wrote";
267
+ return { flaw: "a record with no digest of the lists it wrote" };
211
268
  if (typeof lists !== "string")
212
- return `a digest of the lists it wrote that is a value that is ${valueTypeLabel(lists)}, not a digest`;
269
+ return { flaw: `a digest of the lists it wrote that is a value that is ${valueTypeLabel(lists)}, not a digest` };
213
270
  if (lists.length === 0)
214
- return "a digest of the lists it wrote that is empty, not a digest";
215
- return undefined;
271
+ return { flaw: "a digest of the lists it wrote that is empty, not a digest" };
272
+ return { lists };
216
273
  }
217
274
  catch {
218
- return "a value that cannot be read";
275
+ return { flaw: "a value that cannot be read" };
219
276
  }
220
277
  }
278
+ function ownToolListsFlaw(value) {
279
+ const read = readOwnToolListsRecord(value);
280
+ return "flaw" in read ? read.flaw : undefined;
281
+ }
282
+ export function ownToolListsDigestOf(value) {
283
+ if (value === undefined)
284
+ return undefined;
285
+ const read = readOwnToolListsRecord(value);
286
+ return "lists" in read ? read.lists : undefined;
287
+ }
221
288
  export function persistedToolNamesRefusal(ceiling, chain, ownLists) {
222
289
  const pending = "refused before the claim (the checkpoint stays pending): finish it on a worker of the engine that parked it, or expire it and run the work again";
223
290
  const ownFlaw = ownLists === undefined ? undefined : ownToolListsFlaw(ownLists);
@@ -290,36 +357,69 @@ export function judgeRunToolLists(input) {
290
357
  catch {
291
358
  }
292
359
  };
360
+ const authorWarnings = [];
361
+ const adviseAuthor = (err) => {
362
+ advise(err);
363
+ authorWarnings.push(err);
364
+ };
365
+ const tellOnce = (code, identity, deliver) => {
366
+ try {
367
+ onceLedger.oncePerSession(announceDigest(`${code}:user`, identity), deliver);
368
+ }
369
+ catch {
370
+ }
371
+ };
372
+ const tellAuthors = () => {
373
+ for (const warning of authorWarnings) {
374
+ const unmatched = unmatchedNamesNotice(warning, sessionId);
375
+ const unmatchedKey = unmatchedNameIdentity(warning);
376
+ if (unmatched !== undefined && unmatchedKey !== undefined)
377
+ tellOnce(unmatched.code, unmatchedKey, () => deliverEngineNotice(input.onNotice, unmatched));
378
+ const grammar = definitionEntryNotice(warning, sessionId);
379
+ const grammarKey = definitionEntryIdentity(warning);
380
+ if (grammar !== undefined && grammarKey !== undefined)
381
+ tellOnce(grammar.code, grammarKey, () => deliverEngineNotice(input.onNotice, grammar));
382
+ }
383
+ };
293
384
  const ownWhere = ownListsWhereOf(input.ownBy);
294
385
  const selector = input.selector;
295
- const denied = deniedProtocolTools(selector.layers, input.legs);
296
- if (denied.length > 0) {
297
- const names = [...new Set(denied.map((h) => `"${h.name}"`))];
386
+ const definitionAt = input.definition !== undefined ? selector.layers.length - 2 : -1;
387
+ const definitionLayer = selector.layers[definitionAt];
388
+ const definitionWhere = input.definition !== undefined ? workflowAgentTypeWhere(input.definition.agentType) : undefined;
389
+ const denied = deniedProtocolTools(selector.layers.filter((_, i) => i !== definitionAt), input.legs);
390
+ const deniedByDefinition = definitionLayer !== undefined ? deniedProtocolTools([definitionLayer, NO_LISTS], input.legs) : [];
391
+ if (denied.length > 0 || deniedByDefinition.length > 0) {
392
+ const names = [...new Set([...denied, ...deniedByDefinition].map((h) => `"${h.name}"`))];
298
393
  const one = names.length === 1;
299
- const deniedBy = (own, whose) => {
300
- const hits = denied.filter((h) => h.own === own).map((h) => `"${h.name}"`);
301
- return hits.length > 0 ? [`${whose} denies ${one ? "it" : hits.join(", ")}`] : [];
394
+ const deniedBy = (from, own, whose) => {
395
+ const hits = from.filter((h) => h.own === own).map((h) => `"${h.name}"`);
396
+ return hits.length > 0 && whose !== undefined ? [`${whose} denies ${one ? "it" : hits.join(", ")}`] : [];
302
397
  };
303
- const by = [...deniedBy(true, ownWhere ?? "this run's own excludeTools"), ...deniedBy(false, "an inherited list (the spawning run's excludeTools, or one it inherits)")];
398
+ const by = [...deniedBy(denied, true, ownWhere ?? "this run's own excludeTools"), ...deniedBy(deniedByDefinition, false, definitionWhere), ...deniedBy(denied, false, "an inherited list (the spawning run's excludeTools, or one it inherits)")];
304
399
  throw refused(`This kind of leg (${input.legs.join(", ")}) relies on ${names.join(", ")}, but ${by.join(" and ")} — the leg cannot work without ${one ? "it" : "them"}. Remove the entry from the list that names it.`, "config.tool_face_control", "protocol_denied");
305
400
  }
306
401
  const pool = delegationPoolReading(spec.tools ?? [], valveLeaves(spec, selector));
307
402
  const mounted = mountedToolNames([...tools, ...(spec.tools ?? [])]);
308
403
  const withOwnServers = (servers) => servers === undefined || servers.length === 0 ? input.declaredPeers : { ...input.declaredPeers, mcp: [...(input.declaredPeers.mcp ?? []), ...servers] };
309
404
  const definitionServers = [...(spec.agents ?? []).flatMap((d) => d.mcp ?? []), ...pool.tools.flatMap((t) => (t.agentToolFaces ?? []).flatMap((f) => f.servers ?? []))];
405
+ const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
310
406
  if (!input.judgedUpstream) {
311
- const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
312
407
  const own = [["allowed", input.own.allow], ["denied", input.own.exclude]];
313
408
  const silent = () => undefined;
314
409
  const told = input.toldUpstream === true;
410
+ const ownAdvise = told ? silent : ownWhere === undefined ? adviseAuthor : advise;
315
411
  for (const [side, value] of own)
316
- judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root, told ? silent : advise, "config.tool_face_control", told ? silent : retire);
412
+ judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root, ownAdvise, "config.tool_face_control", told ? silent : retire);
413
+ }
414
+ if (definitionLayer !== undefined && definitionWhere !== undefined) {
415
+ judgeToolNameList(definitionWhere, "allowed", definitionLayer.allow, root, advise, "config.agent.unknown_tool", undefined, true);
416
+ judgeToolNameList(definitionWhere, "denied", definitionLayer.deny, root, advise, "config.agent.unknown_tool", retire, true);
317
417
  }
318
418
  const childUniverses = (servers) => pool.tools.length > 0 ? pool.tools.map((t) => childFacingUniverse(poolOf([t]), withOwnServers(servers))) : [childFacingUniverse(poolOf([]), withOwnServers(servers))];
319
419
  for (const def of spec.agents ?? []) {
320
420
  for (const universe of childUniverses(def.mcp)) {
321
- judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe, advise, "config.agent.unknown_tool");
322
- judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe, advise, "config.agent.unknown_tool", retire);
421
+ judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe, adviseAuthor, "config.agent.unknown_tool", undefined, true);
422
+ judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe, adviseAuthor, "config.agent.unknown_tool", retire, true);
323
423
  }
324
424
  }
325
425
  const replaced = new Set((spec.agents ?? []).map((d) => d.name));
@@ -329,13 +429,14 @@ export function judgeRunToolLists(input) {
329
429
  if (face.authored === true && !replaced.has(face.name)) {
330
430
  const faceWhere = delegationListWhere(t.name, face.name);
331
431
  const faceUniverse = childFacingUniverse(poolOf([t]), withOwnServers(face.servers));
332
- judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool");
333
- judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool", retire);
432
+ judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool", undefined, true);
433
+ judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool", retire, true);
334
434
  }
335
435
  }
336
436
  judgeToolNameList(delegationListWhere(t.name, undefined), "allowed", t.agentToolLevelAllowTools, universe, advise, "config.agent.unknown_tool");
337
437
  judgeToolNameList(delegationListWhere(t.name, undefined), "denied", t.agentToolLevelDenyTools, universe, advise, "config.agent.unknown_tool", retire);
338
438
  }
439
+ tellAuthors();
339
440
  if (retiredLeftOut.length > 0) {
340
441
  const notice = retiredToolNameNotice("task_selector", retiredLeftOut, sessionId);
341
442
  const whole = [...new Set(retiredLeftOut.map((e) => `${e.field}\u0000${e.entry}\u0000${e.source ?? ""}`))].sort();
@@ -40,3 +40,9 @@ export declare class TeardownLegTimeoutError extends Error {
40
40
  * arm it could not previously keep.
41
41
  */
42
42
  export declare function settleTeardownLeg(leg: () => Promise<unknown> | unknown, label: string, report?: (err: Error) => void): Promise<void>;
43
+ /**
44
+ * The same bound for a leg whose ANSWER the caller needs (a worktree settle says `pruned` or `kept`): the leg's value, its
45
+ * own throw, or a {@link TeardownLegTimeoutError} when it has not settled within the bound — the caller decides what each
46
+ * means. {@link settleTeardownLeg} is this race with every outcome routed to a report; one bound, one race.
47
+ */
48
+ export declare function raceTeardownLeg<T>(leg: () => Promise<T> | T, label: string): Promise<T>;
@@ -15,14 +15,8 @@ export class TeardownLegTimeoutError extends Error {
15
15
  }
16
16
  }
17
17
  export async function settleTeardownLeg(leg, label, report) {
18
- let timer;
19
18
  try {
20
- await Promise.race([
21
- Promise.resolve().then(leg),
22
- new Promise((_, reject) => {
23
- timer = setTimeout(() => reject(new TeardownLegTimeoutError(label, teardownLegBudgetMs)), teardownLegBudgetMs);
24
- }),
25
- ]);
19
+ await raceTeardownLeg(leg, label);
26
20
  }
27
21
  catch (e) {
28
22
  try {
@@ -31,6 +25,17 @@ export async function settleTeardownLeg(leg, label, report) {
31
25
  catch {
32
26
  }
33
27
  }
28
+ }
29
+ export async function raceTeardownLeg(leg, label) {
30
+ let timer;
31
+ try {
32
+ return await Promise.race([
33
+ Promise.resolve().then(leg),
34
+ new Promise((_, reject) => {
35
+ timer = setTimeout(() => reject(new TeardownLegTimeoutError(label, teardownLegBudgetMs)), teardownLegBudgetMs);
36
+ }),
37
+ ]);
38
+ }
34
39
  finally {
35
40
  if (timer !== undefined)
36
41
  clearTimeout(timer);
@@ -22,6 +22,8 @@ export declare function loopExitFailureOf(reason: LoopTerminalReason | undefined
22
22
  * admitted only as a word of its closed set (a host Brain mints this message too); the reset instant only beside a
23
23
  * condition. Absent members stay absent. */
24
24
  export declare function providerVerdictOf(final: AssistantMessage): Pick<ProviderRejected, "providerCondition" | "providerConditionSource" | "providerResetAtMs">;
25
+ /** The terminal message's provider sentence, admitted through the one pass over a remote's words (a host Brain mints this message too); absent when it states none. */
26
+ export declare function providerSentenceOf(final: AssistantMessage): Pick<ProviderRejected, "providerMessage">;
25
27
  /** The part of the request the terminal message's refusal named, from the message's `errorKind` and `refusedTool` as the
26
28
  * terminal read them (each once): the kind admitted only as a word of `REFUSED_REQUEST_PARTS`, a tool-schema refusal only
27
29
  * with its tool (a non-empty string), else no account. */
@@ -1,5 +1,6 @@
1
1
  import { MODEL_OUTPUT_INVALID_CAUSES } from "../../internal/llm.js";
2
2
  import { isProviderEchoShape } from "../../brain/errors.js";
3
+ import { admittedProviderMessage } from "../../brain/provider-message.js";
3
4
  import { isProviderCondition, isProviderConditionSource } from "../../brain/provider-dialect.js";
4
5
  import { admittedRequestRoute } from "../../brain/request-route.js";
5
6
  import { REFUSED_REQUEST_PARTS } from "../terminal-cause.js";
@@ -13,7 +14,7 @@ const LOOP_EXIT_FAILURE = {
13
14
  aborted_before_stream: undefined,
14
15
  assistant_error: undefined,
15
16
  stop_requested: undefined,
16
- malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be parsed (retry also failed)." },
17
+ malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be run: it kept arriving unparseable or naming the same missing tool (retry also failed)." },
17
18
  truncated_output_exhausted: { code: "model.truncated_output_exhausted", message: "The model's response exceeded the output token maximum (continuing also failed)." },
18
19
  };
19
20
  export function loopExitFailureOf(reason) {
@@ -27,6 +28,10 @@ export function providerVerdictOf(final) {
27
28
  const resetAtMs = readMember(final, "providerResetAtMs");
28
29
  return { providerCondition: condition, providerConditionSource: source, ...(typeof resetAtMs === "number" && Number.isFinite(resetAtMs) ? { providerResetAtMs: resetAtMs } : {}) };
29
30
  }
31
+ export function providerSentenceOf(final) {
32
+ const sentence = admittedProviderMessage(readMember(final, "providerMessage"));
33
+ return sentence === undefined ? {} : { providerMessage: sentence };
34
+ }
30
35
  const REFUSED_REQUEST_PART_SET = new Set(REFUSED_REQUEST_PARTS);
31
36
  export function refusedPartOf(errorKind, refusedTool) {
32
37
  if (!REFUSED_REQUEST_PART_SET.has(errorKind))
@@ -3,6 +3,7 @@ import { Value } from "typebox/value";
3
3
  import { defineTool, errorResult } from "../tools.js";
4
4
  import { formatZodValidationError, truncateError } from "../tool-errors.js";
5
5
  import { mountRuleFace, toolFace } from "../tool-catalog-entries.js";
6
+ import { projectToolSchema } from "../../brain/tool-schema-projection.js";
6
7
  export const TOOL_SEARCH_NAME = "ToolSearch";
7
8
  export const TOOL_SEARCH_DEFAULT_MAX_RESULTS = 5;
8
9
  const MAX_QUERY_RESULTS = 25;
@@ -27,7 +28,7 @@ export function buildDeferredRegistry(deferred, tools) {
27
28
  function renderSchemaForModel(schema) {
28
29
  let json;
29
30
  try {
30
- json = JSON.stringify(schema);
31
+ json = JSON.stringify(projectToolSchema(schema));
31
32
  }
32
33
  catch {
33
34
  return undefined;
@@ -55,7 +55,7 @@ export function toolEndBodyFrom(result, isError, leg, gate, gatedCallIdOfRun) {
55
55
  ...(gate !== undefined ? { gate } : {}),
56
56
  };
57
57
  }
58
- const startFrameOf = (o, recovered) => ({ type: "tool_start", toolCallId: o.toolCallId, toolName: o.spelledName, ...(o.label !== undefined ? { label: o.label } : {}), args: o.args, ...(recovered ? { recovered: true } : {}), ...(o.requestedBy !== undefined ? { requestedBy: o.requestedBy } : {}) });
58
+ const startFrameOf = (o, recovered) => ({ type: "tool_start", toolCallId: o.toolCallId, toolName: o.spelledName, ...(o.label !== undefined ? { label: o.label } : {}), args: o.args, ...(recovered ? { recovered: true } : {}), ...(o.requestedBy !== undefined ? { requestedBy: o.requestedBy } : {}), ...(o.resumesCheckpoint !== undefined ? { resumesCheckpoint: o.resumesCheckpoint } : {}) });
59
59
  export function announceToolCall(table, start, frames) {
60
60
  table.open(start);
61
61
  frames.push(startFrameOf(start, false));
@@ -76,7 +76,9 @@ export function emitSettled(table, start, end, frames) {
76
76
  isError,
77
77
  ...toolEndBodyFrom(end.result, isError, frames, gate, end.gatedCallIdOfRun),
78
78
  ...(gate?.disposition.kind === "denied" && occ.wireName !== undefined ? { wireName: occ.wireName } : {}),
79
+ ...(gate?.disposition.kind === "denied" && occ.finalInput !== undefined ? { refusedInput: occ.finalInput } : {}),
79
80
  ...(notExecuted ? { notExecuted: true } : {}), ...(occ.answeredInPlaceBy !== undefined ? { answeredBy: occ.answeredInPlaceBy } : {}), ...(occ.requestedBy !== undefined ? { requestedBy: occ.requestedBy } : {}),
81
+ ...(occ.resumesCheckpoint !== undefined ? { resumesCheckpoint: occ.resumesCheckpoint } : {}),
80
82
  ...(occ.rewrite !== undefined && !neverRan ? { rewrite: occ.rewrite } : {}),
81
83
  });
82
84
  return { ...(gate !== undefined ? { gate } : {}), isError, ...(notExecuted ? { notExecuted: true } : {}) };
@@ -16,7 +16,7 @@
16
16
  * materialization entrance; the specs this file consumes carry that reader's copy, never the caller's object.
17
17
  */
18
18
  import type { AgentTool } from "../../internal/harness-types.js";
19
- import { type McpServerSpec } from "../mcp-server-spec.js";
19
+ import type { McpServerSpec } from "../mcp-server-spec.js";
20
20
  import { type ToolApprovalCard } from "../tool-face.js";
21
21
  import { type EngineNotice } from "../engine-notice.js";
22
22
  /** The keys each specialised approval card needs on the call (the SHELL owns the
@@ -1,4 +1,4 @@
1
- import { callerText } from "../mcp-server-spec.js";
1
+ import { callerText } from "../caller-text.js";
2
2
  import { MCP_NAMESPACE } from "../protocol-table.js";
3
3
  import { mintNamespacePrefix } from "../protocol-naming.js";
4
4
  import { RESERVED_APPROVAL_CARDS, TOOL_APPROVAL_CARDS, TOOL_FAMILIES, TOOL_PATH_ABSENCES, TOOL_PATH_ACCESSES, TOOL_PATH_BASES, RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, TOOL_KEY_MAX_CHARS, } from "../tool-face.js";
@@ -10,10 +10,13 @@
10
10
  * to its executor: the resumed leg right before it runs the tool body itself, a live leg at the gate's allow
11
11
  * exit — the loop starts the body after it and the runner does not observe that moment) → `settled` or
12
12
  * `interrupted`. A call that closes still `announced` was never let go: whatever the tool's body did, this call
13
- * did not do it (`refusedBeforeRelease`, `tool-not-executed.ts`). Leaving a terminal state is an engine defect and throws;
13
+ * did not do it (`refusedBeforeRelease`, `tool-not-executed.ts`). The release is also the call's RUNNING origin
14
+ * (`releasedAt`): the nearest moment to the body's start the runner observes, and the one the progress lane counts
15
+ * from — an announced call is waiting on its gate, not running. Leaving a terminal state is an engine defect and throws;
14
16
  * - the WAIT ON A PERSON, re-entrant: every ask put to the person's seat for this call counts one entry and one
15
17
  * exit (several rounds of one gate pass, a confirmation asked during the execution) — a count, never a bit,
16
- * because the waits nest and overlap;
18
+ * because the waits nest and overlap — and, beside it, every auto-mode classification of the call in flight, the
19
+ * same count shape. The two counts are the one gate-phase fact the frames read ({@link gatePhaseOf});
17
20
  * - the GATE ROUNDS: one record per gate exit for this call, and one more when a station AFTER the gate refuses
18
21
  * it (the shell read admission that re-establishes what the gate judged, a resumed leg's belts). The latest
19
22
  * record is the call's disposition: a refusal after the gate is a refusal, never a tool failure under an
@@ -21,9 +24,12 @@
21
24
  *
22
25
  * WHAT IS NOT HERE: frames, clocks of a lane, the deny observer. This module is the record and its transitions;
23
26
  * the projections read it. A durable park that crosses legs is two occurrences on two tables (the parking leg's,
24
- * the resumed leg's), joined by the checkpoint row the resumed leg was opened from — never by a field here.
27
+ * the resumed leg's), joined by the checkpoint row the resumed leg was opened from: the resumed leg's occurrence for
28
+ * the held call names that row ({@link OccurrenceStart.resumesCheckpoint}) and both of its frames carry the name — the
29
+ * one join a consumer reads, minted where the resumed leg opens the held call.
25
30
  */
26
31
  import type { DeniedBy, GateOutcome } from "../gate-outcome.js";
32
+ import type { ToolGatePhase } from "../task-event.js";
27
33
  import { type GateExitFacts } from "./gate-exit.js";
28
34
  /** The one clock the occurrence's heartbeat facts are stamped on. MONOTONIC for the reason the progress lane
29
35
  * states: every reading is subtracted from another, and a wall-clock step backwards would silence the beat. A
@@ -45,6 +51,9 @@ export interface OccurrenceStart {
45
51
  readonly args: unknown;
46
52
  /** An extension's own call (`$.tool.call`): who asked for it — the frames carry it. Absent for a call a model message carried. */
47
53
  readonly requestedBy?: import("../task-event.js").ExtensionRequester;
54
+ /** The held call a resumed leg runs: the id of the checkpoint row it was opened from — the frames carry it
55
+ * (`tool_start.resumesCheckpoint`). Absent on every other call, and on a held call whose row carries no id. */
56
+ readonly resumesCheckpoint?: string;
48
57
  }
49
58
  /** The record, as its readers see it. Written only through {@link ToolOccurrenceTable}. */
50
59
  export interface ToolOccurrence extends OccurrenceStart {
@@ -53,18 +62,25 @@ export interface ToolOccurrence extends OccurrenceStart {
53
62
  readonly life: OccurrenceLife;
54
63
  /** How many asks put to the person for this call are open right now. */
55
64
  readonly awaitingUser: number;
65
+ /** How many auto-mode classifications of this call are in flight right now (the leg's own classifier, or an ancestor's
66
+ * frozen one judging it). */
67
+ readonly classifying: number;
56
68
  /** One outcome per gate exit, plus one per refusal after the gate; the last one is the call's disposition. */
57
69
  readonly gateRounds: readonly GateOutcome[];
58
70
  /** The input the latest gate exit decided on, as a FROZEN snapshot (absent when no gate saw the call). */
59
71
  readonly finalInput?: unknown;
60
72
  /** The call's start frame is out on this leg. */
61
73
  readonly startEmitted: boolean;
62
- /** When the call was announced, on {@link occurrenceClock} — the heartbeat's elapsed origin. */
63
- readonly startedAt: number;
64
- /** The last moment anything was heard from the call (a frame for it, or its return from a wait on the person). */
74
+ /** When the engine let the call go, on {@link occurrenceClock} — the progress clock's one origin. Absent until the
75
+ * call is released: a call still at its gate is not running, so the lane counts no running time for it (a frame
76
+ * minted for it reads elapsed 0). Written once, by {@link ToolOccurrenceTable.release}. */
77
+ readonly releasedAt?: number;
78
+ /** The last moment anything was heard from the call (its release, a frame for it, or its return from a wait on the
79
+ * person). */
65
80
  readonly lastHeardAt: number;
66
- /** The heartbeat covers it. Cleared when the loop leaves the call behind at a turn end with no end of its own:
67
- * the record stays (a later settlement must still know its start frame went out) but no beat describes it. */
81
+ /** The heartbeat covers it. Cleared when the loop leaves the call behind at a turn end with no
82
+ * end of its own: the record stays (a later settlement must still know its start frame went out) but no beat
83
+ * describes it. */
68
84
  readonly beating: boolean;
69
85
  /** An extension at `tool.call` answered for the call in place of its body — its result, or its refusal — and named here:
70
86
  * the body was never called (positive evidence the call did not run). Absent: no station answered in its place. */
@@ -88,7 +104,9 @@ export interface ToolOccurrenceTable {
88
104
  ensure(start: OccurrenceStart): ToolOccurrence;
89
105
  /** The call's start frame is out. */
90
106
  noteStartEmitted(toolCallId: string): void;
91
- /** The engine lets the call go to its executor — the one transition into `released`, whichever leg makes it. */
107
+ /** The engine lets the call go to its executor — the one transition into `released`, whichever leg makes it. It also
108
+ * starts the call's progress clock and its silence clock: whatever came before (the gate, a person's answer) is not
109
+ * time the call spent running. */
92
110
  release(toolCallId: string): void;
93
111
  /** A gate exit for this call: its record and the input it decided on (frozen by the gate's exit). */
94
112
  gateRound(toolCallId: string, outcome: GateOutcome, finalInput?: unknown, rewrite?: import("../task-event.js").ToolInputRewrite): void;
@@ -108,6 +126,10 @@ export interface ToolOccurrenceTable {
108
126
  * settles, either way. Returns `ask`'s own value, so the asker awaits exactly what it awaited before; a synchronous
109
127
  * answer (or anything that is not a promise) was no wait at all. */
110
128
  whileAwaitingUser<T>(toolCallId: string, ask: () => T): T;
129
+ /** The same bracket around a classification of this call: its {@link ToolOccurrence.classifying} count rises before
130
+ * `judge` dispatches and lowers when the verdict settles, either way. The silence clock is untouched — a classification
131
+ * is the engine's own work on the call, and the heartbeat keeps covering it. */
132
+ whileClassifying<T>(toolCallId: string, judge: () => T): T;
111
133
  /** A frame for the call went out: its silence clock restarts. */
112
134
  heard(toolCallId: string): void;
113
135
  /** The call ended: it leaves the table and the record is returned for the end projection. */
@@ -117,4 +139,7 @@ export interface ToolOccurrenceTable {
117
139
  /** Called whenever an attempt opens (the heartbeat arms its timer). One listener — the leg's one lane. */
118
140
  onOpen(listener: () => void): void;
119
141
  }
142
+ /** Who holds the call at its gate right now (`tool_progress.gate`): a classification in flight answers `classifier`, else an
143
+ * open ask to the person answers `approval`, else nothing holds it. The one reading of the two counts. */
144
+ export declare function gatePhaseOf(occ: ToolOccurrence): ToolGatePhase | undefined;
120
145
  export declare function createToolOccurrenceTable(): ToolOccurrenceTable;
@@ -1,6 +1,13 @@
1
1
  import { mintGateOutcome } from "./gate-exit.js";
2
2
  export const occurrenceClock = () => (typeof performance !== "undefined" ? performance.now() : Date.now());
3
3
  const TERMINAL = { announced: false, released: false, settled: true, interrupted: true };
4
+ export function gatePhaseOf(occ) {
5
+ if (occ.classifying > 0)
6
+ return "classifier";
7
+ if (occ.awaitingUser > 0)
8
+ return "approval";
9
+ return undefined;
10
+ }
4
11
  export function createToolOccurrenceTable() {
5
12
  const byId = new Map();
6
13
  const attempts = new Map();
@@ -22,12 +29,13 @@ export function createToolOccurrenceTable() {
22
29
  ...(start.label !== undefined ? { label: start.label } : {}),
23
30
  args: start.args,
24
31
  ...(start.requestedBy !== undefined ? { requestedBy: start.requestedBy } : {}),
32
+ ...(start.resumesCheckpoint !== undefined ? { resumesCheckpoint: start.resumesCheckpoint } : {}),
25
33
  attempt,
26
34
  life: "announced",
27
35
  awaitingUser: 0,
36
+ classifying: 0,
28
37
  gateRounds: [],
29
38
  startEmitted: false,
30
- startedAt: now,
31
39
  lastHeardAt: now,
32
40
  beating: true,
33
41
  };
@@ -36,11 +44,11 @@ export function createToolOccurrenceTable() {
36
44
  listener?.();
37
45
  return occ;
38
46
  };
39
- const awaitUser = (toolCallId) => {
47
+ const hold = (toolCallId, count) => {
40
48
  const occ = byId.get(toolCallId);
41
49
  if (occ === undefined)
42
50
  return () => { };
43
- occ.awaitingUser += 1;
51
+ occ[count] += 1;
44
52
  let returned = false;
45
53
  return () => {
46
54
  if (returned)
@@ -48,29 +56,31 @@ export function createToolOccurrenceTable() {
48
56
  returned = true;
49
57
  if (byId.get(toolCallId) !== occ)
50
58
  return;
51
- occ.awaitingUser -= 1;
52
- if (occ.awaitingUser === 0)
59
+ occ[count] -= 1;
60
+ if (count === "awaitingUser" && occ.awaitingUser === 0)
53
61
  occ.lastHeardAt = occurrenceClock();
54
62
  };
55
63
  };
64
+ const bracket = (release, held) => {
65
+ let value;
66
+ try {
67
+ value = held();
68
+ }
69
+ catch (err) {
70
+ release();
71
+ throw err;
72
+ }
73
+ if (value instanceof Promise)
74
+ value.then(release, release);
75
+ else
76
+ release();
77
+ return value;
78
+ };
79
+ const awaitUser = (toolCallId) => hold(toolCallId, "awaitingUser");
56
80
  return {
57
81
  awaitUser,
58
- whileAwaitingUser(toolCallId, ask) {
59
- const resumeFromUser = awaitUser(toolCallId);
60
- let answer;
61
- try {
62
- answer = ask();
63
- }
64
- catch (err) {
65
- resumeFromUser();
66
- throw err;
67
- }
68
- if (answer instanceof Promise)
69
- answer.then(resumeFromUser, resumeFromUser);
70
- else
71
- resumeFromUser();
72
- return answer;
73
- },
82
+ whileAwaitingUser: (toolCallId, ask) => bracket(awaitUser(toolCallId), ask),
83
+ whileClassifying: (toolCallId, judge) => bracket(hold(toolCallId, "classifying"), judge),
74
84
  get: (toolCallId) => byId.get(toolCallId),
75
85
  live: () => [...byId.values()],
76
86
  open,
@@ -83,6 +93,7 @@ export function createToolOccurrenceTable() {
83
93
  if (occ.life !== "announced")
84
94
  throw new Error(`tool occurrence: call "${toolCallId}" (attempt ${occ.attempt}) cannot be released from "${occ.life}"`);
85
95
  occ.life = "released";
96
+ occ.releasedAt = occ.lastHeardAt = occurrenceClock();
86
97
  },
87
98
  gateRound(toolCallId, outcome, finalInput, rewrite) {
88
99
  const occ = held(toolCallId, "a gate round");