@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,5 +1,6 @@
1
1
  import { PROMPT_SCREEN_STATIONS } from "./stations.js";
2
2
  import { extensionWords } from "../untrusted-egress.js";
3
+ import { isBlankInput } from "../input-author.js";
3
4
  const ARGUMENT = "text";
4
5
  export function createPromptSubmitEntry(ref) {
5
6
  return async (args, ctx) => {
@@ -9,7 +10,7 @@ export function createPromptSubmitEntry(ref) {
9
10
  if (extra !== undefined)
10
11
  throw new TypeError(refused(`takes { text }; "${extensionWords(extra, 40)}" is not one`));
11
12
  const text = args[ARGUMENT];
12
- if (typeof text !== "string" || text.trim() === "")
13
+ if (typeof text !== "string" || isBlankInput(text))
13
14
  throw new TypeError(refused("no { text } (a non-empty string)"));
14
15
  const seat = ref?.seat;
15
16
  const handlers = ctx.frames.filter((f) => f.kind === "handler");
@@ -19,6 +20,8 @@ export function createPromptSubmitEntry(ref) {
19
20
  if (seat === undefined)
20
21
  return Object.freeze({ drop: "no running leg takes a prompt here" });
21
22
  const answer = await seat.relay("extension", text, { frames: ctx.frames, origin: ctx.origin, extension: by, priority: "later", signal: ctx.signal });
22
- return "entered" in answer ? Object.freeze({ text: answer.entered }) : Object.freeze({ drop: answer.drop });
23
+ if ("entered" in answer)
24
+ return Object.freeze({ text: answer.entered });
25
+ return "replied" in answer ? Object.freeze({ reply: answer.replied }) : Object.freeze({ drop: answer.drop });
23
26
  };
24
27
  }
@@ -70,8 +70,8 @@ export declare function doorOf(row: AgentMessage): SessionAppendDoor;
70
70
  /** `$.session.turns()`: how many prompts a branch holds from its people — its message rows whose door ({@link doorOf}) is
71
71
  * `prompt`. A steer is the engine's note on the person's behalf (`provenance: "engine-note"`), so it is not one. */
72
72
  export declare function promptCountOf(branch: ReadonlyArray<SessionTreeEntry>): number;
73
- /** A row's maker, from its typed facts: the model, the tool that answered, the host (a prompt, an attachment the host
74
- * declared), else the engine. */
73
+ /** A row's maker, from its typed facts: the model (or the extension that answered the turn in its place), the tool that
74
+ * answered, the host (a prompt, an attachment the host declared), else the engine. */
75
75
  export declare function originOf(row: AgentMessage): SessionAppendOrigin;
76
76
  /** What the leg binds the seat to once its bus is admitted. */
77
77
  export interface RowSeatBinding {
@@ -1,3 +1,4 @@
1
+ import { answeredWithoutModel } from "../../internal/llm.js";
1
2
  import { noteHostRewrite } from "../frame-settlement.js";
2
3
  import { describeThrown } from "../tool-policy.js";
3
4
  import { extensionWords } from "../untrusted-egress.js";
@@ -34,7 +35,7 @@ const ENGINE = Object.freeze({ kind: "engine" });
34
35
  export function originOf(row) {
35
36
  switch (row.role) {
36
37
  case "assistant":
37
- return Object.freeze({ kind: "model", model: row.model });
38
+ return answeredWithoutModel(row) ? Object.freeze({ kind: "plugin", name: row.answeredBy }) : Object.freeze({ kind: "model", model: row.model });
38
39
  case "toolResult":
39
40
  return Object.freeze({ kind: "tool", tool: row.toolName });
40
41
  case "user":
@@ -154,10 +154,10 @@ export function createCompactStation() {
154
154
  const by = ctx.origin.plugin;
155
155
  const w = windows.getStore();
156
156
  const direct = ctx.frames.length >= 2 && ctx.frames.at(-1)?.kind === "dollar" && ctx.frames.slice(0, -1).every((f) => f.kind === "handler");
157
+ if (w !== undefined && !w.open)
158
+ return refuseCall(by, "called after the turn.complete dispatch it was made in had ended; the conversation compacts between turns, so call it from turn.complete or later");
157
159
  if (w === undefined || !direct)
158
160
  return refuseCall(by, "not called from a turn.complete handler; the conversation compacts between turns, so call it from turn.complete or later");
159
- if (!w.open)
160
- return refuseCall(by, "called after the turn.complete dispatch it was made in had ended; the conversation compacts between turns, so call it from turn.complete or later");
161
161
  if (w.running !== undefined)
162
162
  return refuseCall(by, "a compaction is already running at this boundary");
163
163
  const running = w.pass({ ...(instructions !== undefined ? { instructions } : {}), requestedBy: Object.freeze({ kind: "extension", name: by }), call: ctx });
@@ -14,8 +14,9 @@ import { type SourcedOverlay } from "../../prompt-assembly/overlay.js";
14
14
  import type { BandId } from "../../prompt-assembly/catalog/schema.js";
15
15
  import type { ModFrame, ModParticipant } from "./kernel/dispatch.js";
16
16
  import type { ModOrigin } from "./kernel/index.js";
17
- import type { InputAuthor } from "../input-author.js";
18
- import { type EngineDollar, type ModelCompleteRequest, type ModelCompleteResult, type ModSeatView, type SessionUsage, type SessionVersion } from "./dollar.js";
17
+ import { type InputAuthor } from "../input-author.js";
18
+ import type { SystemInjectionPriority } from "../task-notification.js";
19
+ import { type EngineDollar, type ModelCompleteRequest, type ModelCompleteResult, type ModSeatView, type SessionUsage, type SessionVersion, type TurnAbortRef, type TurnAbortVerdict } from "./dollar.js";
19
20
  import type { SkillSpec } from "../agent-definition.js";
20
21
  import { type SkillScopes } from "./spec-seats.js";
21
22
  /**
@@ -43,10 +44,14 @@ export interface LegEvents {
43
44
  readonly start?: "classic.SubagentStart";
44
45
  /** The event it raises when it would otherwise end. */
45
46
  readonly stop: "classic.Stop" | "classic.SubagentStop";
47
+ /** The event it raises on each window of an assistant message it shows — present on a top-level leg only (a delegated leg's
48
+ * stream is its parent's progress view, not a display of its own). */
49
+ readonly display?: "classic.MessageDisplay";
46
50
  }
47
51
  /**
48
- * Both ends of a leg, from the delegation fact alone (a child resumed from its checkpoint keeps it): a delegated leg opens on
49
- * `classic.SubagentStart` and ends on `classic.SubagentStop`, any other opens on nothing and ends on `classic.Stop`. Not the leg
52
+ * Both ends of a leg and its display, from the delegation fact alone (a child resumed from its checkpoint keeps it): a delegated
53
+ * leg opens on `classic.SubagentStart`, ends on `classic.SubagentStop` and shows nothing of its own; any other opens on nothing,
54
+ * ends on `classic.Stop` and raises `classic.MessageDisplay` over what it shows. Not the leg
50
55
  * kind (a resumed leg's kind reads `"resume"` whoever it runs as), and not who wrote the objective: whether an input passes
51
56
  * the prompt screen is the input's own fact, its author's row (`isScreened`, input-author.ts) — a delegator's words are judged
52
57
  * at the delegator's gate (`classic.PreToolUse` on the delegating call), an operator's resume of a child is screened.
@@ -90,14 +95,19 @@ export declare function chainJudges(bus: LegModBus): boolean;
90
95
  export type InstallationAskSettlement = (ask: Extract<PermissionResult, {
91
96
  action: "ask";
92
97
  }>, call: ToolCallRequest, signal: AbortSignal | undefined) => Promise<PermissionResult>;
98
+ /** The question an installation's settlement floated on an EARLIER look at the call, as it stands over a later look that does not ask: a bare allow on rewritten bytes never lifts it, only that installation's approver answering over the bytes in front of it does; undefined when it marked nothing. */
99
+ export type InstallationStandingQuestion = (call: ToolCallRequest) => Extract<PermissionResult, {
100
+ action: "ask";
101
+ }> | undefined;
93
102
  /** An inherited installation as a leg's gate raises its judging events on it (`classic.PreToolUse` at phase 1, `tool.check` at the
94
103
  * verdict read): the bus that mounted that chain, which of its handlers judge here, the capability face of the environment it was
95
- * installed against (the `env` of its `classic.PreToolUse` e), and how its question is settled. */
104
+ * installed against (the `env` of its `classic.PreToolUse` e), how its question is settled, and the question it deferred standing. */
96
105
  export interface InheritedInstallation {
97
106
  readonly bus: LegModBus;
98
107
  readonly judges: (p: ModParticipant) => boolean;
99
108
  readonly env?: HookEnvCapabilities;
100
109
  readonly settle: InstallationAskSettlement;
110
+ readonly standing?: InstallationStandingQuestion;
101
111
  }
102
112
  /** An inherited chain entry as its installation identity reads it (the installation is absent on a caller-policy entry). */
103
113
  export interface InstallationEntry {
@@ -152,12 +162,12 @@ export declare function chainEntryFault(entries: ReadonlyArray<{
152
162
  * a handler's answer depends on the chain it sits in (an outer handler may answer without calling `next`, or rule on what an
153
163
  * inner one answered), so a registration the leg also mounts in a chain of its own judges again inside the ancestor's chain (a
154
164
  * second judgment, never a lost one). Each carries the environment face its installation was installed against (`envOf`) and
155
- * its entry's settlement of a question (`settleOf`): an installation's `ask`, on either event, goes to the regime it froze.
165
+ * its entry's settlement of a question (`settleOf`: an installation's `ask`, on either event, goes to the regime it froze) and the question it deferred on an earlier look (`standingOf`, left standing by a later look that does not ask).
156
166
  * Observe handlers never take part. A chain with a malformed entry is refused (`config.mods_invalid`, {@link chainEntryFault}).
157
167
  */
158
168
  export declare function inheritedInstallations<E extends InstallationEntry & {
159
169
  readonly policy?: object;
160
- }>(entries: readonly E[], standsIn: (pc: E) => boolean, envOf: (pc: E) => HookEnvCapabilities | undefined, settleOf: (pc: E) => InstallationAskSettlement): readonly InheritedInstallation[];
170
+ }>(entries: readonly E[], standsIn: (pc: E) => boolean, envOf: (pc: E) => HookEnvCapabilities | undefined, settleOf: (pc: E) => InstallationAskSettlement, standingOf?: (pc: E) => InstallationStandingQuestion): readonly InheritedInstallation[];
161
171
  /** The members every classic `e` of a leg carries: the identity envelope, the delegated leg's `agentId`, the leg's observed mode. */
162
172
  export declare function classicEventBase(identity: HookInvocationIdentity | undefined, permissionMode?: PermissionMode): ClassicEventBase;
163
173
  /**
@@ -192,9 +202,9 @@ export declare function stringMembersOf<M extends string>(answer: unknown, membe
192
202
  };
193
203
  /** The clause a fail-closed station puts in its sentence for the handler that failed it: `crashed (extension "x" threw boom)`
194
204
  * — what it did, who it is and the bus's reason. */
195
- export declare function failedHandlerClause(f: Extract<ModDispatchOutcome, {
205
+ export declare function failedHandlerClause(f: Pick<Extract<ModDispatchOutcome, {
196
206
  kind: "failed";
197
- }>): string;
207
+ }>, "registration" | "cause" | "reason">): string;
198
208
  /** The clause without the bus's reason, `crashed (extension "x")`: for a sentence in place of a result the handler saw (its
199
209
  * reason may quote that result; the reason is said on the report sink). */
200
210
  export declare function failedHandlerName(f: Extract<ModDispatchOutcome, {
@@ -215,26 +225,36 @@ export declare function observePermissionDenied(input: {
215
225
  }): Promise<void>;
216
226
  /** What a prompt's screen came to, as the four entrances read it: `text` is what the entrance delivers (the prompt as it
217
227
  * came, or as `prompt.submit` handed it on — `rewrittenBy` then names who changed it, in the order they did); `block` the
218
- * refusal (a `prompt.submit` drop, or `classic.UserPromptSubmit`'s block). */
228
+ * refusal (a `prompt.submit` drop, or `classic.UserPromptSubmit`'s block); `reply` the answer an extension gave in the
229
+ * model's place where the entrance takes one ({@link PROMPT_ENTRANCES}): `text` enters, its turn answered by `reply`. */
219
230
  export type PromptScreen = {
220
231
  readonly kind: "answered";
221
232
  readonly text: string;
222
233
  readonly rewrittenBy?: readonly string[];
223
234
  readonly block?: string;
235
+ readonly reply?: {
236
+ readonly text: string;
237
+ readonly by: string;
238
+ };
224
239
  readonly additionalContext?: string;
225
240
  } | Extract<ModDispatchOutcome, {
226
241
  kind: "failed";
227
242
  }> | {
228
243
  readonly kind: "aborted";
229
244
  };
230
- /** Who changed a text a chain carried, read off the chain as it runs (a station's `checkHandOn` and `checkAnswer` feed it). */
245
+ /** Why a changed text may not stand, as the sentence the refused handler is told, or `undefined` when it may. */
246
+ export type TextRefusal = (text: string) => string | undefined;
247
+ /** Who changed a text a chain carried, read off the chain as it runs (a station's `checkHandOn` and `checkAnswer` feed it). A
248
+ * station that judges a change passes its `refuse`: a refused change is named by no one and moves nothing, so what the chain
249
+ * carries is still the text the last accepted change left — the retry of a refused text (a `.catch` handing it on again) is a
250
+ * change again, and is refused again. */
231
251
  export interface TextChanges {
232
252
  /** A handler handed `text` on (down): it changed the text when that differs from what the previous hand-on (or the
233
- * original) carried. */
234
- handedOn(by: string, text: string): void;
253
+ * original) carried. `undefined` — taken (a change or none); a sentence — the change `refuse` refused. */
254
+ handedOn(by: string, text: string, refuse?: TextRefusal): string | undefined;
235
255
  /** A handler answered `text` (up): it changed the text when that differs from what its `next` answered (`below`) or, when
236
- * it answered without one, from the text it was handed. */
237
- answered(by: string, text: string, handed: string, below: string | undefined): void;
256
+ * it answered without one, from the text it was handed. `undefined` — taken; a sentence — the change `refuse` refused. */
257
+ answered(by: string, text: string, handed: string, below: string | undefined, refuse?: TextRefusal): string | undefined;
238
258
  /** The handlers that changed the text, in the order they did (down before up), each named once. */
239
259
  rewrittenBy(): readonly string[];
240
260
  }
@@ -264,9 +284,11 @@ export declare function promptScreenDeclaredBy(registrations: readonly {
264
284
  readonly events: readonly string[];
265
285
  };
266
286
  }[]): boolean;
267
- /** A screened input as the screen raises it: its author as judged, and for an extension's prompt the caller and its `$` call. */
287
+ /** A screened input as the screen raises it: its author as judged, the tier a steer is taken at (its `priority`, defaulted —
288
+ * what decides whether the steer entrance takes a reply), and for an extension's prompt the caller and its `$` call. */
268
289
  export interface PromptScreenInput {
269
290
  readonly author: InputAuthor;
291
+ readonly tier?: SystemInjectionPriority;
270
292
  readonly extension?: string;
271
293
  readonly raisedUnder?: RaisedUnder;
272
294
  }
@@ -365,6 +387,8 @@ export interface LegFacadeSeats {
365
387
  turns(): Promise<number>;
366
388
  usage(): SessionUsage;
367
389
  version(): SessionVersion;
390
+ /** `$.turn.abort`'s seat ({@link ModSeatView.turn}). */
391
+ turnAbort(turn: number, by: string): TurnAbortVerdict;
368
392
  now(): number;
369
393
  tools(): readonly string[];
370
394
  agents(): readonly string[];
@@ -397,6 +421,9 @@ export interface LegMods {
397
421
  readonly report: (err: Error) => void;
398
422
  /** Bind the engine facade once the leg is prepared. Until then a `$` call throws, naming the method. */
399
423
  bindFacade(seats: LegFacadeSeats): void;
424
+ /** End the bus's lifetime (the leg stopped): its timers are cancelled and a `$` call made after its handler settled is
425
+ * refused from here. Its owner calls it on every way out of the leg; a second call does nothing. */
426
+ end(): void;
400
427
  }
401
428
  /**
402
429
  * Admit the leg's bus: both seats (`RunnerDeps.mods`, `TaskSpec.mods`), screened and put to `plugin.register`.
@@ -415,7 +442,7 @@ export declare function admitLegMods(input: {
415
442
  }): Promise<LegMods>;
416
443
  /** What a leg hands {@link legFacadeSeats}: the seats it already has. */
417
444
  export interface LegFacadeInput {
418
- readonly deps: Pick<RunnerDeps, "brain" | "models" | "now">;
445
+ readonly deps: Pick<RunnerDeps, "brain" | "modelFallback" | "cacheRetention" | "models" | "now">;
419
446
  readonly spec: Pick<TaskSpec, "getApiKeyAndHeaders">;
420
447
  readonly sessionId: string;
421
448
  readonly model: Model;
@@ -435,6 +462,8 @@ export interface LegFacadeInput {
435
462
  readonly turns: () => Promise<number>;
436
463
  /** The leg's measurement seat (`measureSession` writes it at each turn boundary). */
437
464
  readonly measure: SessionMeasureSeat;
465
+ /** The leg's `$.turn.abort` seat, filled by the run ({@link TurnAbortRef}). */
466
+ readonly turnAbort: TurnAbortRef;
438
467
  readonly activeTools: ReadonlySet<string>;
439
468
  readonly agentListing: {
440
469
  readonly entries: ReadonlyArray<{
@@ -473,7 +502,8 @@ export declare function legFacadeSeats(input: LegFacadeInput): LegFacadeSeats;
473
502
  * A chain admitted outside any leg — what a host rebuilds to re-supply an inherited screening entry on a fresh Runner
474
503
  * (a cross-process resume hands back `{ installation: await admitModChain(…), hookEnv, …regime }` over the same
475
504
  * registrations). The same admission a leg runs (both seats, `plugin.register`); no leg exists, so its `$` facade is never
476
- * bound and a `$` call throws. Handler failures go to `onError` (absent ⇒ unreported). Its chain identity is recorded as a
505
+ * bound and a `$` call throws, and its lifetime has ended from the start: a timer is refused, and so is a `$` call made after
506
+ * its handler settled. Handler failures go to `onError` (absent ⇒ unreported). Its chain identity is recorded as a
477
507
  * leg's is ({@link chainOfBus}), so an entry carrying it is read by what it mounted.
478
508
  */
479
509
  export declare function admitModChain(seats: {
@@ -9,11 +9,14 @@ import { agentIdOf } from "../leg-identity.js";
9
9
  import { admitMods, expandOnSide } from "./kernel/index.js";
10
10
  import { legBusOf } from "./extension-call.js";
11
11
  import { validateOverlay } from "../../prompt-assembly/overlay.js";
12
+ import { isBlankInput, steeringTextDefect, steeringTextDefectClause } from "../input-author.js";
12
13
  import { modsInvalid } from "./kernel/registration.js";
13
14
  import { isPlainRecord } from "./kernel/receive.js";
15
+ import { NEXT_IN_FLIGHT } from "./kernel/site-rules.js";
14
16
  import { engineMethodBottoms } from "./dollar.js";
15
17
  import { modSeatsOf, modsReportToOnError, registrationRefusedNotice } from "./host.js";
16
18
  import { scopedLegBus, skillScopeRecord, skillSeatsOf, standingBus } from "./spec-seats.js";
19
+ import { modelLaneBrainOf } from "../runner/model-lane-seat.js";
17
20
  export const ENGINE_CORE_ANSWER = Object.freeze({});
18
21
  export function engineCore() {
19
22
  return ENGINE_CORE_ANSWER;
@@ -24,7 +27,7 @@ export function seatHears(binding, event) {
24
27
  export function legNoticeTaskId(leg) {
25
28
  return { taskId: leg.taskId };
26
29
  }
27
- const TOP_LEVEL_LEG = Object.freeze({ stop: "classic.Stop" });
30
+ const TOP_LEVEL_LEG = Object.freeze({ stop: "classic.Stop", display: "classic.MessageDisplay" });
28
31
  const DELEGATED_LEG = Object.freeze({ start: "classic.SubagentStart", stop: "classic.SubagentStop" });
29
32
  export function legEventsOf(identity) {
30
33
  return identity?.isDelegatedChild === true ? DELEGATED_LEG : TOP_LEVEL_LEG;
@@ -101,7 +104,7 @@ export function chainEntryFault(entries) {
101
104
  return undefined;
102
105
  }
103
106
  const judges = (p) => judgesCall(p);
104
- export function inheritedInstallations(entries, standsIn, envOf, settleOf) {
107
+ export function inheritedInstallations(entries, standsIn, envOf, settleOf, standingOf) {
105
108
  const fault = chainEntryFault(entries);
106
109
  if (fault !== undefined)
107
110
  throw modsInvalid(fault);
@@ -111,7 +114,7 @@ export function inheritedInstallations(entries, standsIn, envOf, settleOf) {
111
114
  if (bus === undefined || standsIn(pc) || !chainJudges(bus))
112
115
  continue;
113
116
  const env = envOf(pc);
114
- installations.push(Object.freeze({ bus, judges, ...(env !== undefined ? { env } : {}), settle: settleOf(pc) }));
117
+ installations.push(Object.freeze({ bus, judges, ...(env !== undefined ? { env } : {}), settle: settleOf(pc), ...(standingOf !== undefined ? { standing: standingOf(pc) } : {}) }));
115
118
  }
116
119
  return Object.freeze(installations);
117
120
  }
@@ -210,14 +213,24 @@ export function textChanges(original) {
210
213
  };
211
214
  let before = original;
212
215
  return {
213
- handedOn: (by, text) => {
214
- if (text !== before)
215
- note(by);
216
+ handedOn: (by, text, refuse) => {
217
+ if (text === before)
218
+ return undefined;
219
+ const refusal = refuse?.(text);
220
+ if (refusal !== undefined)
221
+ return refusal;
222
+ note(by);
216
223
  before = text;
224
+ return undefined;
217
225
  },
218
- answered: (by, text, handed, below) => {
219
- if (text !== (below ?? handed))
220
- note(by);
226
+ answered: (by, text, handed, below, refuse) => {
227
+ if (text === (below ?? handed))
228
+ return undefined;
229
+ const refusal = refuse?.(text);
230
+ if (refusal !== undefined)
231
+ return refusal;
232
+ note(by);
233
+ return undefined;
221
234
  },
222
235
  rewrittenBy: () => Object.freeze([...changers]),
223
236
  };
@@ -244,7 +257,30 @@ export function promptScreenDeclaredBy(registrations) {
244
257
  }
245
258
  return promptScreenHeard((station) => selected.has(station));
246
259
  }
247
- const PROMPT_SUBMIT_FORM = "prompt.submit takes { text } (a string) or { drop: <reason> }";
260
+ const PROMPT_ENTRANCES = Object.freeze({
261
+ objective: Object.freeze({ replyable: "always", steering: false }),
262
+ steer: Object.freeze({ replyable: "later", steering: true }),
263
+ resume_message: Object.freeze({ replyable: "never", steering: true }),
264
+ followUp: Object.freeze({ replyable: "never", steering: true }),
265
+ parked_redelivery: Object.freeze({ replyable: "never", steering: true }),
266
+ system: Object.freeze({ replyable: "later", steering: true }),
267
+ });
268
+ function entranceOf(source) {
269
+ return typeof source === "string" && Object.hasOwn(PROMPT_ENTRANCES, source) ? PROMPT_ENTRANCES[source] : undefined;
270
+ }
271
+ function entranceReplyable(source, tier) {
272
+ const row = entranceOf(source)?.replyable;
273
+ return row === "always" || (row === "later" && tier === "later");
274
+ }
275
+ function changedTextClause(source, text) {
276
+ if (entranceOf(source)?.steering !== true)
277
+ return undefined;
278
+ const defect = steeringTextDefect(text);
279
+ if (defect !== undefined)
280
+ return steeringTextDefectClause(defect);
281
+ return isBlankInput(text) ? "says nothing (only whitespace and control characters; answer { drop: <reason> } to refuse an input)" : undefined;
282
+ }
283
+ const PROMPT_SUBMIT_FORM = "prompt.submit takes { text } (a string), { reply } (a non-empty string, where e.replyable is true) or { drop: <reason> }";
248
284
  function readSubmitAnswer(a) {
249
285
  if (!isPlainRecord(a))
250
286
  return { why: PROMPT_SUBMIT_FORM };
@@ -253,27 +289,41 @@ function readSubmitAnswer(a) {
253
289
  const r = a["drop"];
254
290
  return typeof r === "string" && r.trim() !== "" ? { drop: r } : { why: "a drop that is not a reason (a non-empty string)" };
255
291
  }
292
+ if (keys.length === 1 && keys[0] === "reply") {
293
+ const r = a["reply"];
294
+ if (typeof r !== "string" || isBlankInput(r))
295
+ return { why: "a reply that is not a non-empty string" };
296
+ const defect = steeringTextDefect(r);
297
+ return defect === undefined ? { reply: r } : { why: `a reply that ${steeringTextDefectClause(defect)}` };
298
+ }
256
299
  if (keys.length === 1 && keys[0] === "text") {
257
300
  const t = a["text"];
258
301
  return typeof t === "string" ? { text: t } : { why: "a text that is not a string" };
259
302
  }
260
303
  return { why: PROMPT_SUBMIT_FORM };
261
304
  }
262
- const PROMPT_SUBMIT_RANKS = Object.freeze({ of: (a) => (isPlainRecord(a) && Object.hasOwn(a, "drop") ? 1 : 0), top: 1 });
305
+ const PROMPT_SUBMIT_RANKS = Object.freeze({
306
+ of: (a) => (!isPlainRecord(a) ? 0 : Object.hasOwn(a, "drop") ? 2 : Object.hasOwn(a, "reply") ? 1 : 0),
307
+ top: 2,
308
+ });
263
309
  const OPERATOR_SCREEN = Object.freeze({ author: "operator" });
264
310
  export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN) {
265
311
  if (!promptScreenHasHandlers(bus))
266
312
  return undefined;
267
313
  const { prompt, ...classicFacts } = e;
268
- const facts = { ...classicFacts, author: input.author, ...(input.extension !== undefined ? { extension: input.extension } : {}) };
314
+ const replyable = entranceReplyable(e.source, input.tier);
315
+ const facts = { ...classicFacts, author: input.author, ...(input.extension !== undefined ? { extension: input.extension } : {}), replyable };
269
316
  const raisedUnder = input.raisedUnder;
270
317
  const changes = textChanges(prompt);
318
+ const refusedWith = (lead) => (text) => {
319
+ const clause = changedTextClause(e.source, text);
320
+ return clause === undefined ? undefined : `${lead} ${clause}`;
321
+ };
271
322
  const checkHandOn = (handed, by) => {
272
323
  const t = handed["text"];
273
324
  if (typeof t !== "string")
274
325
  return "next() handed on a text that is not a string";
275
- changes.handedOn(by.plugin, t);
276
- return undefined;
326
+ return changes.handedOn(by.plugin, t, refusedWith("next() handed on a text that"));
277
327
  };
278
328
  const seen = {};
279
329
  const bottom = async (handed) => {
@@ -285,13 +335,25 @@ export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN)
285
335
  return Object.freeze({ text });
286
336
  return Object.freeze({ drop: classic.kind === "answered" ? classic.block : "the classic.UserPromptSubmit screen did not clear the prompt" });
287
337
  };
338
+ const replyEnters = new WeakMap();
288
339
  const checkAnswer = (a, handed, by, below) => {
289
340
  const read = readSubmitAnswer(a);
290
341
  if ("why" in read)
291
342
  return read.why;
343
+ if ("reply" in read && !replyable)
344
+ return `answered { reply } at the ${e.source} entrance, which takes none (e.replyable is false): answer { text } or { drop }`;
345
+ const last = below.length > 0 ? below[below.length - 1] : undefined;
346
+ if ("reply" in read && below.includes(NEXT_IN_FLIGHT))
347
+ return "answered { reply } while its next(e) still ran — the text the input enters as was not settled";
348
+ const up = last !== undefined ? readSubmitAnswer(last) : undefined;
292
349
  if ("text" in read) {
293
- const up = below.length > 0 ? readSubmitAnswer(below[below.length - 1]) : undefined;
294
- changes.answered(by.plugin, read.text, handed["text"], up !== undefined && "text" in up ? up.text : undefined);
350
+ const refused = changes.answered(by.plugin, read.text, handed["text"], up !== undefined && "text" in up ? up.text : undefined, refusedWith("a text that"));
351
+ if (refused !== undefined)
352
+ return refused;
353
+ }
354
+ if ("reply" in read && isPlainRecord(a)) {
355
+ const carried = up !== undefined && "reply" in up && isPlainRecord(last) ? replyEnters.get(last) : undefined;
356
+ replyEnters.set(a, carried ?? (up !== undefined && "text" in up ? up.text : handed["text"]));
295
357
  }
296
358
  return undefined;
297
359
  };
@@ -314,6 +376,12 @@ export async function screenUserPrompt(bus, e, signal, input = OPERATOR_SCREEN)
314
376
  return { kind: "answered", text: prompt, block: read.drop };
315
377
  if ("why" in read)
316
378
  return { kind: "failed", registration: by, cause: "violation", reason: read.why, skipped: [] };
379
+ if ("reply" in read) {
380
+ const entered = isPlainRecord(outcome.answer) ? replyEnters.get(outcome.answer) : undefined;
381
+ if (entered === undefined)
382
+ return { kind: "failed", registration: "engine", cause: "threw", reason: "a reply the screen did not judge", skipped: [] };
383
+ return { kind: "answered", text: entered, ...(entered !== prompt ? { rewrittenBy: changes.rewrittenBy() } : {}), reply: { text: read.reply, by }, ...context };
384
+ }
317
385
  if (read.text === prompt)
318
386
  return { kind: "answered", text: prompt, ...context };
319
387
  return { kind: "answered", text: read.text, rewrittenBy: changes.rewrittenBy(), ...context };
@@ -511,6 +579,7 @@ function lateView() {
511
579
  usage: () => need("session.usage").usage(),
512
580
  version: () => need("session.version").version(),
513
581
  },
582
+ turn: { abort: (turn, by) => need("turn.abort").turnAbort(turn, by) },
514
583
  now: () => need("clock.now").now(),
515
584
  tools: () => need("tool.list").tools(),
516
585
  agents: () => need("agent.list").agents(),
@@ -536,7 +605,15 @@ export async function admitLegMods(input) {
536
605
  const skillSeats = skillSeatsOf(input.skills);
537
606
  const admitted = skillSeats.registrations.length === 0 ? seats : { ...seats, task: [...(seats.task ?? []), ...skillSeats.registrations] };
538
607
  const report = modsReportToOnError(input.deps.onError, input.sessionId);
539
- const kernelBus = await admitMods({ side: "engine", seats: admitted, bottoms: engineMethodBottoms(late.view), entries: late.entries, report, describeThrown, isProxy: types.isProxy });
608
+ const life = new AbortController();
609
+ let kernelBus;
610
+ try {
611
+ kernelBus = await admitMods({ side: "engine", seats: admitted, bottoms: engineMethodBottoms(late.view), entries: late.entries, report, describeThrown, isProxy: types.isProxy, lifetime: life.signal });
612
+ }
613
+ catch (err) {
614
+ life.abort(new Error("the leg's admission failed"));
615
+ throw err;
616
+ }
540
617
  const skillScopes = skillScopeRecord(skillSeats.owners, input.reopenedSkills);
541
618
  const bus = legBusOf(scopedLegBus(kernelBus, skillScopes), report);
542
619
  const standing = standingBus(bus, skillScopes);
@@ -547,7 +624,7 @@ export async function admitLegMods(input) {
547
624
  const chain = recordAdmittedChain(bus, seats);
548
625
  if (standing !== bus)
549
626
  ADMITTED_CHAINS.set(standing, chain);
550
- return { bus, standing, chain, skillScopes, report, bindFacade: late.bind };
627
+ return { bus, standing, chain, skillScopes, report, bindFacade: late.bind, end: () => life.abort(new Error("the leg stopped")) };
551
628
  }
552
629
  async function agentRowsOf(seat, agentId) {
553
630
  const refused = (why) => new Error(`session.messages: agent ${agentId}: ${why}`);
@@ -570,11 +647,12 @@ async function agentRowsOf(seat, agentId) {
570
647
  }
571
648
  return branch.flatMap((e) => (e.type === "message" ? [e.message] : []));
572
649
  }
650
+ const NO_REQUEST_RUNNING = Object.freeze({ kind: "none" });
573
651
  function replyText(reply) {
574
652
  return reply.content.flatMap((c) => (c.type === "text" ? [c.text] : [])).join("");
575
653
  }
576
654
  export function legFacadeSeats(input) {
577
- const runtime = brainToRuntime(input.deps.brain);
655
+ const runtime = brainToRuntime(modelLaneBrainOf(input.deps));
578
656
  const answeredBy = new Map();
579
657
  const byUsage = new WeakMap();
580
658
  return {
@@ -610,6 +688,7 @@ export function legFacadeSeats(input) {
610
688
  turns: () => input.turns(),
611
689
  usage: () => Object.freeze(input.measure.context !== undefined ? { context: input.measure.context } : {}),
612
690
  version: () => Object.freeze({ version: engineVersion() }),
691
+ turnAbort: (turn, by) => input.turnAbort.seat?.(turn, by) ?? NO_REQUEST_RUNNING,
613
692
  now: () => (input.deps.now ?? Date.now)(),
614
693
  tools: () => [...input.activeTools],
615
694
  agents: () => (input.agentListing?.entries ?? []).map((e) => e.name),
@@ -635,7 +714,9 @@ export async function admitModChain(seats, onError) {
635
714
  },
636
715
  describeThrown,
637
716
  isProxy: types.isProxy,
717
+ lifetime: OUTSIDE_ANY_LEG,
638
718
  });
639
719
  recordAdmittedChain(bus, seats);
640
720
  return bus;
641
721
  }
722
+ const OUTSIDE_ANY_LEG = AbortSignal.abort(new Error("admitted outside any leg"));
@@ -0,0 +1,23 @@
1
+ /**
2
+ * The answer of a `classic.Stop` / `classic.SubagentStop` handler, read ONE way wherever it is read: by the engine's stop
3
+ * station when it folds the two seats' answers, and by a handler folding its own answer with what `next` answered in its
4
+ * seat. The members are read as the station's answer check reads them ({@link stringMembersOf}): a string member stands
5
+ * (an empty one included), a member of any other type is absent.
6
+ */
7
+ import type { StopHookResult } from "../hooks.js";
8
+ /** The members a Stop answer is read for; the station's answer check refuses a non-string one. */
9
+ export declare const STOP_ANSWER_MEMBERS: readonly ["block", "additionalContext", "end"];
10
+ /** A Stop answer's members as the engine reads them. */
11
+ export declare function readStopAnswer(answer: unknown): StopHookResult;
12
+ /**
13
+ * Whether a Stop answer decides its stop point on its own: it asks to end (`end` present, empty or not) or it pushes back
14
+ * with a non-empty `block`. Context alone is advice, never a decision.
15
+ */
16
+ export declare function stopAnswerDecides(answer: StopHookResult | undefined): boolean;
17
+ /**
18
+ * Fold two Stop answers, `outer` the more trusted one (across seats: the deployment's; within a seat: the handler's own,
19
+ * `inner` what `next` answered). An answer carrying `end` ends the stop point: the fold carries `end` alone, its reason the
20
+ * first one present (`outer`'s, then `inner`'s). Otherwise the fold carries the first non-empty `block` and the non-empty
21
+ * contexts in order, joined by a blank line; an empty fold lets the run end as an empty answer does.
22
+ */
23
+ export declare function mergeStopAnswers(outer: StopHookResult | undefined, inner: StopHookResult | undefined): StopHookResult;
@@ -0,0 +1,20 @@
1
+ import { stringMembersOf } from "./stations.js";
2
+ export const STOP_ANSWER_MEMBERS = Object.freeze(["block", "additionalContext", "end"]);
3
+ export function readStopAnswer(answer) {
4
+ return stringMembersOf(answer, STOP_ANSWER_MEMBERS);
5
+ }
6
+ const nonEmpty = (s) => s !== undefined && s.length > 0;
7
+ export function stopAnswerDecides(answer) {
8
+ const a = readStopAnswer(answer);
9
+ return a.end !== undefined || nonEmpty(a.block);
10
+ }
11
+ export function mergeStopAnswers(outer, inner) {
12
+ const o = readStopAnswer(outer);
13
+ const i = readStopAnswer(inner);
14
+ const end = o.end ?? i.end;
15
+ if (end !== undefined)
16
+ return { end };
17
+ const block = [o.block, i.block].find(nonEmpty);
18
+ const context = [o.additionalContext, i.additionalContext].filter(nonEmpty).join("\n\n");
19
+ return { ...(block !== undefined ? { block } : {}), ...(context.length > 0 ? { additionalContext: context } : {}) };
20
+ }
@@ -12,9 +12,27 @@ import type { ToolContentOrigin } from "./tool-spec.js";
12
12
  import type { McpConnectionPool } from "./mcp-connection-pool.js";
13
13
  import type { McpHostSeat } from "./mcp-host-seat.js";
14
14
  import type { McpInstructionsEntry } from "./prompt-section-seat.js";
15
- /** The two names a server's `allowTools` carries to let the cross-server resource readers reach its resources (a server whose allowlist omits one is left out of that reader). */
15
+ /**
16
+ * The reserved names of a server's `allowTools`: each names a FACE of the server — a kind of read the engine makes of it — and never a
17
+ * tool. `list_resources` / `read_resource` open the server to the cross-server resource readers (the model's resource tools and the host's
18
+ * `listResources` / `readResource`), `list_resource_templates` to the host's template listing, `list_prompts` / `get_prompt` to the host's
19
+ * prompt ports. The one law, read by {@link faceAllowed}: no list ⇒ every face open; a list (even `[]`) ⇒ only the faces it names. Every
20
+ * other string in the list is a tool name. A server's own tool listed under one of these names is not mounted (the intake's drop lane says
21
+ * so on both faces), and a `toolAxes` / `toolFaces` declaration keyed by one is refused at the entry's judge: the key could never name a tool.
22
+ */
16
23
  export declare const MCP_RESOURCE_LIST_ALLOW = "list_resources";
17
24
  export declare const MCP_RESOURCE_READ_ALLOW = "read_resource";
25
+ export declare const MCP_RESOURCE_TEMPLATE_LIST_ALLOW = "list_resource_templates";
26
+ export declare const MCP_PROMPT_LIST_ALLOW = "list_prompts";
27
+ export declare const MCP_PROMPT_GET_ALLOW = "get_prompt";
28
+ export declare const MCP_FACE_WORDS: readonly ["list_resources", "read_resource", "list_resource_templates", "list_prompts", "get_prompt"];
29
+ export type McpFaceWord = (typeof MCP_FACE_WORDS)[number];
30
+ /** Is `name` one of the reserved face words ({@link MCP_FACE_WORDS})? Such a name is never a tool's. */
31
+ export declare function isMcpFaceWord(name: unknown): name is McpFaceWord;
32
+ /** The one judge of whether a server's `allowTools` opens `face` ({@link MCP_FACE_WORDS}): absent ⇒ open; present ⇒ open iff it names it. */
33
+ export declare function faceAllowed(allowTools: readonly string[] | undefined, face: McpFaceWord): boolean;
34
+ /** The drop reason of a server tool listed under a reserved face word ({@link MCP_FACE_WORDS}). */
35
+ export declare const MCP_FACE_WORD_DROP_REASON = "its name is one of the reserved MCP face words an allowTools list uses for a kind of read (list_resources, read_resource, list_resource_templates, list_prompts, get_prompt), never a tool, so the tool is not mounted";
18
36
  /** The canonical names of the resource tools (the trio: list-all / read-one / list-under-a-directory). They belong to no one server: each aggregates the resources of every connected server that advertises them. */
19
37
  export declare const LIST_MCP_RESOURCES = "ListMcpResourcesTool";
20
38
  export declare const READ_MCP_RESOURCE = "ReadMcpResourceTool";
@@ -51,16 +69,25 @@ export interface InstructionsLane {
51
69
  }
52
70
  /** Are this server's instructions in the model's context now? */
53
71
  export declare function instructionsTold(lane: InstructionsLane, server: string): boolean;
72
+ /**
73
+ * THE judge of the add lane: is this connection's entry the text the model holds, or is about to hold (an unread copy of it is queued)? A server never
74
+ * told, one whose disconnect line is queued (the model is being told the text no longer applies), and one holding or awaiting another text or author
75
+ * are all "no". Every caller that would queue an entry — a re-dial's reconcile and a roster change's settle — asks it through {@link tellInstructions}.
76
+ */
77
+ export declare function instructionsUnchanged(lane: InstructionsLane, entry: McpInstructionsEntry): boolean;
54
78
  /** A dial's default: the server's instructions are taught (a materialization alone takes every entry it returns as taught, until a run states its block). */
55
- export declare function toldOnDial(lane: InstructionsLane, server: string): void;
56
- /** The run's start: the stable block is what the model is told. A removal already queued for a server outside the block names instructions the model
57
- * never held, so it is withdrawn; a server inside the block with a removal queued is not in context (the frame will retract it). */
58
- export declare function toldAtStart(lane: InstructionsLane, servers: ReadonlySet<string>): void;
59
- /** Take this server's unread adds off the lane; a first copy that never reached the model leaves the ledger with it. */
79
+ export declare function toldOnDial(lane: InstructionsLane, entry: McpInstructionsEntry): void;
80
+ /** The run's start: the stable block (`taught`) is what the model is told. A removal already queued for a server outside the block names instructions the
81
+ * model never held, so it is withdrawn; a server inside the block with a removal queued is not told (the frame will retract it), the block's text is
82
+ * kept for a re-dial that withdraws the removal. */
83
+ export declare function toldAtStart(lane: InstructionsLane, taught: ReadonlyArray<McpInstructionsEntry>): void;
84
+ /** Take this server's unread adds off the lane; a first copy that never reached the model leaves the ledger with it, a supersede leaves the model the text it holds. */
60
85
  export declare function withdrawInstructionAdds(lane: InstructionsLane, server: string): void;
61
- /** Queue this server's current text (superseding an unread copy). In context already ⇒ stays so; otherwise a first copy, queued. */
86
+ /** Queue this server's current text unless the model holds (or is about to hold) exactly it. A different unread copy is superseded: the newest text
87
+ * is the one queued, and when the newest is the text the model already holds, the stale unread copy is simply withdrawn. */
62
88
  export declare function tellInstructions(lane: InstructionsLane, entry: McpInstructionsEntry): void;
63
- /** The server's connection is gone: unread adds are withdrawn, and the model is told its instructions no longer apply only if it holds them. */
89
+ /** The server's connection is gone: unread adds are withdrawn, and the model is told its instructions no longer apply only if it holds them
90
+ * (the text stays on the ledger until that line is delivered, for a re-dial that withdraws it). */
64
91
  export declare function retractInstructions(lane: InstructionsLane, server: string): void;
65
92
  /** A re-dial that connected: a retraction still unread never reached the model, so it is withdrawn and the text the model holds stands. */
66
93
  export declare function unretractInstructions(lane: InstructionsLane, server: string): void;
@@ -94,6 +121,19 @@ interface RosterEntry {
94
121
  * differently. Handed a server's own listing it answers what the server offers, which is not a mount count.
95
122
  */
96
123
  export declare function toolNamesOfServer(names: Iterable<string>, serverName: string): string[];
124
+ /**
125
+ * The tool cells of a connected server's manifest row, off ONE read of the roster: `toolCount` is how many names {@link toolNamesOfServer}
126
+ * answers, `toolNames` the first `max` of them that are wire names (in the roster's order) — present iff there is one — and
127
+ * `toolNamesTruncated: true` iff the list is short of the count (over `max`, or a held name that is not listable); never `false`. A wire
128
+ * name is the provider's tool-name charset and length — the fixed point of the mint's own fold ({@link normalizeNameSegment}), so there is
129
+ * no second pattern to keep in step — and a held name outside it is counted and not listed, because a roster is host-fed and a listing is
130
+ * read by a person.
131
+ */
132
+ export declare function toolFieldsOfServer(rosterNames: Iterable<string>, serverName: string, max: number): {
133
+ toolCount: number;
134
+ toolNames?: string[];
135
+ toolNamesTruncated?: true;
136
+ };
97
137
  /**
98
138
  * Read the run's MCP surface off its roster. `declared` is the run's frozen server declarations; `aggregateNames` the names of the
99
139
  * tools its materialization minted that no server owns. A tool is a server's when its wire name sits under the server's prefix