@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
@@ -60,6 +60,13 @@ export declare function frameMidTurnUserInput(projected: string): string;
60
60
  * A blank text passes through untouched (the harness's empty-injection no-op), like the person's frame.
61
61
  */
62
62
  export declare function frameExtensionInput(name: string | undefined, projected: string): string;
63
+ /** The frame a person's words are delivered in (the author table's `person` frame): the speaker envelope, inside the trusted
64
+ * caller's reminder or the mid-turn frame. The live steer lane mints it; so does the resume of a parked steer, of the message a
65
+ * wake carries, and of a parked steer an extension already answered — that input's row is the frame it was taken in. `source` is
66
+ * the carrier the words arrived on, or `system` when their sender said it wrote them itself: such a text is its sender's own,
67
+ * so it gets neither the speaker label nor the person's mid-turn frame. `trusted` is the other question (may it ride the
68
+ * reminder?) and is read the same either way. */
69
+ export declare function personSteerFrame(text: string, actor: ActorAssertion | undefined, trusted: boolean, reminderMark: string, source: "steer" | "wake" | "system"): string;
63
70
  /**
64
71
  * Render the speaker envelope for one human-input frame. Pure; see the module contract above.
65
72
  * Call BEFORE any trust framing (`formatHookFeedback` / `delimitUntrusted`) so the label stays
@@ -1,27 +1,35 @@
1
1
  import { snapshotActorAssertion } from "../internal/llm.js";
2
2
  import { uuidv7 } from "../internal/harness.js";
3
+ import { isBlankInput } from "./input-author.js";
3
4
  import { inlineUntrusted } from "./untrusted-text.js";
5
+ import { formatHookFeedback } from "./reminder-mint.js";
4
6
  import { attrEscape, EXTERNAL_SOURCE_MAX } from "./task-notification.js";
5
7
  const MID_TURN_USER_INPUT_HEAD = "The user sent a new message while you were working:\n";
6
8
  const MID_TURN_USER_INPUT_TAIL = "\n\nThis is how a message sent mid-turn is surfaced: within the turn that is still running, often " +
7
9
  "alongside the next tool result, rather than as a separate conversation turn. Address the message " +
8
10
  "above as you continue this turn.";
9
11
  export function frameMidTurnUserInput(projected) {
10
- if (projected.trim().length === 0)
12
+ if (isBlankInput(projected))
11
13
  return projected;
12
14
  return `${MID_TURN_USER_INPUT_HEAD}${projected}${MID_TURN_USER_INPUT_TAIL}`;
13
15
  }
14
16
  const EXTENSION_INPUT_TAIL = "\n\nThis is how a prompt an extension submits is surfaced: between turns, starting this turn in the user's place. Address " +
15
17
  "the message above.";
16
18
  export function frameExtensionInput(name, projected) {
17
- if (projected.trim().length === 0)
19
+ if (isBlankInput(projected))
18
20
  return projected;
19
21
  return `${name !== undefined ? `The extension "${name}"` : "An extension"} sent a message:\n${projected}${EXTENSION_INPUT_TAIL}`;
20
22
  }
23
+ export function personSteerFrame(text, actor, trusted, reminderMark, source) {
24
+ const projected = projectHumanInput({ text, actor, source });
25
+ if (trusted)
26
+ return formatHookFeedback(projected, reminderMark);
27
+ return source === "system" ? projected : frameMidTurnUserInput(projected);
28
+ }
21
29
  export function projectHumanInput(frame) {
22
30
  if (frame.actor === undefined || frame.source === "system")
23
31
  return frame.text;
24
- if (frame.text.trim().length === 0)
32
+ if (isBlankInput(frame.text))
25
33
  return frame.text;
26
34
  const label = attrEscape(inlineUntrusted(frame.actor.id, EXTERNAL_SOURCE_MAX));
27
35
  const mark = frame.actor.hostAsserted ? "" : " (unverified)";
@@ -1,6 +1,7 @@
1
1
  import type { DocumentContent, ImageContent } from "../internal/llm.js";
2
2
  import type { ImageDimensions, ImageDownsampler } from "./image-downsample.js";
3
3
  import type { MediaBlock } from "./media-byte-cap.js";
4
+ import { type BytesNotKeptReason, type ToolResultBytesKeeper } from "./tool-result-bytes.js";
4
5
  /** Max raw size sent whole as a document block (CC `PDF_TARGET_RAW_SIZE`). */
5
6
  export declare const PDF_TARGET_RAW_SIZE: number;
6
7
  /**
@@ -171,7 +172,9 @@ export declare function admitDocumentBytes(bytes: Uint8Array, claimedMime: strin
171
172
  export type MediaRefusalReason = "undecodable" | "mime_unsupported" | "raw_too_large" | "magic_mismatch" | "dimensions_unreadable" | "dimensions_too_large" | "base64_too_large";
172
173
  /** One media block the seat refused: its type, the refusal, its decoded size, the bound it exceeded (the raw-byte cap for
173
174
  * `raw_too_large`, the reject edge for `dimensions_too_large` — with the size its header states —, the base64 length
174
- * limit for `base64_too_large`), and its media type when it can be one. */
175
+ * limit for `base64_too_large`), and its media type when it can be one. A refusal for size also says under which ref of the
176
+ * run's tool-result store its bytes were kept (`ref`), or why they were not (`notKept`, with the store's own error text in
177
+ * `saveError` when the store refused them); no other refusal carries any of the three. */
175
178
  export interface ToolResultMediaRefusal {
176
179
  type: MediaBlock["type"];
177
180
  reason: MediaRefusalReason;
@@ -180,6 +183,9 @@ export interface ToolResultMediaRefusal {
180
183
  width?: number;
181
184
  height?: number;
182
185
  mimeType?: string;
186
+ ref?: string;
187
+ notKept?: BytesNotKeptReason;
188
+ saveError?: string;
183
189
  }
184
190
  /** What the seat made of one result's content: every media block rebuilt from its checked bytes or replaced, in its slot,
185
191
  * by its placeholder; and the refusals. */
@@ -187,6 +193,11 @@ export interface ToolResultMediaAdmission {
187
193
  content: unknown[];
188
194
  refused: ToolResultMediaRefusal[];
189
195
  }
196
+ /** The media block a claimed type names, read off the admission's own sets (exactly: no parameter, lowercase) — `image` for
197
+ * one of the four image types, `document` for `application/pdf`, `undefined` for any other value. A carrier that holds
198
+ * bytes under a claimed type and no block type (an MCP resource blob) reads its block here, so what it builds is judged by
199
+ * the same sets that judge it. */
200
+ export declare function mediaBlockTypeOf(mime: unknown): MediaBlock["type"] | undefined;
190
201
  /** The media type a block claims — its `type`, read once, when that is a media type — or `undefined` for any other value. */
191
202
  export declare function claimedMediaType(block: unknown): MediaBlock["type"] | undefined;
192
203
  /**
@@ -206,11 +217,12 @@ export declare function toolResultMediaBlocks(content: unknown): unknown[] | und
206
217
  /**
207
218
  * The tool-result seat's admission over blocks {@link toolResultMediaBlocks} read: each media block admitted with the run's
208
219
  * `processor` — rebuilt from the bytes it checked (an image a carrier already brought within the target and the frame passes
209
- * unchanged), or replaced in its slot by a placeholder naming `toolName` and the refusal.
220
+ * unchanged), or replaced in its slot by a placeholder naming `toolName` and the refusal (and, for a refusal for size, the
221
+ * ref `keep` kept its bytes under, or why they were not kept — no `keep` keeps nothing).
210
222
  */
211
- export declare function admitToolResultMediaBlocks(blocks: readonly unknown[], toolName: string, processor: ImageDownsampler | "none"): Promise<ToolResultMediaAdmission>;
223
+ export declare function admitToolResultMediaBlocks(blocks: readonly unknown[], toolName: string, processor: ImageDownsampler | "none", keep?: ToolResultBytesKeeper): Promise<ToolResultMediaAdmission>;
212
224
  /**
213
225
  * The tool-result seat over one executed call's content with a processor in hand: {@link toolResultMediaBlocks}, then
214
226
  * {@link admitToolResultMediaBlocks} — `undefined` when no block claims a media type (nothing is awaited).
215
227
  */
216
- export declare function admitToolResultMedia(content: unknown, toolName: string, processor: ImageDownsampler | "none"): Promise<ToolResultMediaAdmission> | undefined;
228
+ export declare function admitToolResultMedia(content: unknown, toolName: string, processor: ImageDownsampler | "none", keep?: ToolResultBytesKeeper): Promise<ToolResultMediaAdmission> | undefined;
@@ -1,4 +1,5 @@
1
1
  import { createHash } from "node:crypto";
2
+ import { keepBytesWith, mediaTypeEcho } from "./tool-result-bytes.js";
2
3
  import { readMember } from "./thrown-value.js";
3
4
  import { describeRejectedValue } from "./tool-search-setting.js";
4
5
  export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
@@ -199,8 +200,13 @@ export function admitDocumentBytes(bytes, claimedMime) {
199
200
  return { ok: false, reason: "magic_mismatch", rawBytes };
200
201
  return { ok: true, block: { type: "document", data: Buffer.from(bytes).toString("base64"), mimeType: claimedMime }, originalSize: rawBytes };
201
202
  }
202
- const mediaTypeEcho = (mime) => typeof mime === "string" && /^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$/.test(mime) ? mime : undefined;
203
203
  const ADMITTED_FOR = { image: ADMITTED_IMAGE_MIME_TYPES, document: ADMITTED_DOCUMENT_MIME_TYPES };
204
+ export function mediaBlockTypeOf(mime) {
205
+ if (typeof mime !== "string")
206
+ return undefined;
207
+ return Object.keys(ADMITTED_FOR).find((type) => ADMITTED_FOR[type].includes(mime));
208
+ }
209
+ const KEPT_FOR_SIZE = new Set(["raw_too_large", "dimensions_too_large", "base64_too_large"]);
204
210
  const REFUSAL_CLAUSE = {
205
211
  undecodable: () => "it carried no base64 payload",
206
212
  mime_unsupported: (r) => `${r.mimeType ?? "its media type"} is not a ${r.type} type the model accepts (${ADMITTED_FOR[r.type].join(", ")})`,
@@ -210,9 +216,9 @@ const REFUSAL_CLAUSE = {
210
216
  dimensions_too_large: (r) => unprocessedSizeClause({ reason: "dimensions_too_large", width: r.width, height: r.height, limit: r.limit }),
211
217
  base64_too_large: (r) => `its base64 encoding exceeds the ${r.limit}-character provider limit (${r.bytes} bytes)`,
212
218
  };
213
- const placeholderOf = (toolName, r) => ({
219
+ const placeholderOf = (toolName, r, keptClause) => ({
214
220
  type: "text",
215
- text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
221
+ text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})${keptClause !== undefined ? `; ${keptClause}` : ""}]`,
216
222
  });
217
223
  const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
218
224
  export function claimedMediaType(block) {
@@ -220,7 +226,7 @@ export function claimedMediaType(block) {
220
226
  return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
221
227
  }
222
228
  const claimsMedia = (block) => claimedMediaType(block) !== undefined;
223
- async function admitBlock(block, processor) {
229
+ async function admitBlock(block, processor, keep) {
224
230
  const type = claimedMediaType(block);
225
231
  if (type === undefined)
226
232
  return { block };
@@ -233,8 +239,9 @@ async function admitBlock(block, processor) {
233
239
  if (typeof data !== "string")
234
240
  return refusal("undecodable", 0);
235
241
  let a;
242
+ let bytes;
236
243
  try {
237
- const bytes = Buffer.from(data, "base64");
244
+ bytes = Buffer.from(data, "base64");
238
245
  const claimed = typeof mime === "string" ? mime : "";
239
246
  a = type === "image" ? await admitImageBytes(bytes, claimed, processor) : admitDocumentBytes(bytes, claimed);
240
247
  }
@@ -243,13 +250,18 @@ async function admitBlock(block, processor) {
243
250
  }
244
251
  if (a.ok)
245
252
  return { block: a.block };
246
- if (a.reason === "raw_too_large")
247
- return refusal(a.reason, a.rawBytes, a.cap);
248
- if (a.reason === "dimensions_too_large")
249
- return refusal(a.reason, a.rawBytes, a.limit, { width: a.width, height: a.height });
250
- if (a.reason === "base64_too_large")
251
- return refusal(a.reason, a.rawBytes, IMAGE_ADMISSION.hard.imageBase64Chars);
252
- return refusal(a.reason, a.rawBytes);
253
+ const refused = a.reason === "raw_too_large"
254
+ ? refusal(a.reason, a.rawBytes, a.cap)
255
+ : a.reason === "dimensions_too_large"
256
+ ? refusal(a.reason, a.rawBytes, a.limit, { width: a.width, height: a.height })
257
+ : a.reason === "base64_too_large"
258
+ ? refusal(a.reason, a.rawBytes, IMAGE_ADMISSION.hard.imageBase64Chars)
259
+ : refusal(a.reason, a.rawBytes);
260
+ if (!KEPT_FOR_SIZE.has(refused.refusal.reason))
261
+ return refused;
262
+ const { kept, clause } = await keepBytesWith(keep, bytes, mime);
263
+ const where = "ref" in kept ? { ref: kept.ref } : { notKept: kept.notKept, ...(kept.notKept === "store_failed" ? { saveError: kept.saveError } : {}) };
264
+ return { refusal: { ...refused.refusal, ...where }, keptClause: clause };
253
265
  }
254
266
  export function firstUnprocessedOverTarget(blocks, processor) {
255
267
  if (processor !== "none")
@@ -277,22 +289,22 @@ export function toolResultMediaBlocks(content) {
277
289
  return undefined;
278
290
  }
279
291
  }
280
- export async function admitToolResultMediaBlocks(blocks, toolName, processor) {
292
+ export async function admitToolResultMediaBlocks(blocks, toolName, processor, keep) {
281
293
  const refused = [];
282
294
  const out = [];
283
295
  for (const b of blocks) {
284
- const r = await admitBlock(b, processor);
296
+ const r = await admitBlock(b, processor, keep);
285
297
  if ("block" in r) {
286
298
  out.push(r.block);
287
299
  }
288
300
  else {
289
301
  refused.push(r.refusal);
290
- out.push(placeholderOf(toolName, r.refusal));
302
+ out.push(placeholderOf(toolName, r.refusal, r.keptClause));
291
303
  }
292
304
  }
293
305
  return { content: out, refused };
294
306
  }
295
- export function admitToolResultMedia(content, toolName, processor) {
307
+ export function admitToolResultMedia(content, toolName, processor, keep) {
296
308
  const blocks = toolResultMediaBlocks(content);
297
- return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor);
309
+ return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor, keep);
298
310
  }
@@ -5,6 +5,45 @@ export declare const INPUT_AUTHORS: readonly ["operator", "parent_model", "workf
5
5
  export type InputAuthor = (typeof INPUT_AUTHORS)[number];
6
6
  /** Membership test for {@link InputAuthor}. */
7
7
  export declare function isInputAuthor(v: unknown): v is InputAuthor;
8
+ /**
9
+ * Does this input text say nothing? The ONE reading of "empty" on the input path: the harness's no-op for an empty injection,
10
+ * the steer verb's own bookkeeping of it, the three frames' blank passthrough and `$.prompt.submit`'s door all ask this, so the
11
+ * person's steer and an extension's prompt are never judged by two definitions. A text is blank when it holds only whitespace
12
+ * (`\s`) and control characters (`\p{Cc}`: C0, DEL, C1) — a text with any other code point says something, whatever else
13
+ * surrounds it (a zero-width or format character included: only control characters and whitespace are read as nothing).
14
+ */
15
+ export declare function isBlankInput(text: string): boolean;
16
+ /**
17
+ * HRD-APV-4: the char cap on a steering text — the last persisted, model-facing string on a checkpoint row that had none
18
+ * (`validatePendingSteer` enforces it on a parked operator steer, a parked reply's answer and entered text meet it, and a live
19
+ * `{ reply }` at the prompt screen's door meets the same one: {@link steeringTextDefect}).
20
+ *
21
+ * Sized as an INSTRUCTION budget, not a preview budget: the siblings above cap echo-only projections at
22
+ * 200/512 chars, while a steer is prose a human wrote for the model to act on and is re-delivered on
23
+ * every resume of the checkpoint. 16k chars (~4k tokens) holds any realistic operator instruction and
24
+ * still bounds the durable row and the per-resume context cost. Exported (from the checkpoint store's module as before) so a BFF
25
+ * can validate before it calls `CheckpointStore.setPendingSteer` rather than discovering the reject at persist time.
26
+ */
27
+ export declare const MAX_PENDING_STEER_CHARS = 16000;
28
+ /** The C0/DEL control-character class every persisted steering string is rejected on — ONE pattern home
29
+ * for the text half and the actor labels (the in-memory backend stores a NUL fine, Postgres text/jsonb
30
+ * refuses it, so a steer that persisted on one backend would fail on the other). Ordinary `\t`/`\n`/`\r`
31
+ * whitespace is deliberately allowed. */
32
+ export declare const STEERING_CONTROL_CHARS_RE: RegExp;
33
+ /** Why a steering text may not be persisted or entered: it carries a system-reminder break-out tag, a control character, or is
34
+ * longer than {@link MAX_PENDING_STEER_CHARS}. */
35
+ export type SteeringTextDefect = "break_out_tag" | "control_chars" | "too_long";
36
+ /**
37
+ * THE judgment of a steering text's content — the text half every persisted steering string meets (`validatePendingSteer`'s
38
+ * text and a parked reply's answer and entered text) and a live `{ reply }` meets at the prompt screen's door: the same payload
39
+ * is accepted or refused the same way whether the leg is running or parked. The first defect in the order the persist-time
40
+ * checks run: a break-out tag (the canonical neutralizer changes the text IFF it carries one), a C0 / DEL control character
41
+ * (ordinary `\t` `\n` `\r` allowed), a length over the bound. `undefined` = none. Blankness ({@link isBlankInput}) and type are
42
+ * the caller's. Format characters (bidi marks, zero-width) are not defects: only control characters, the break-out tag and the bound.
43
+ */
44
+ export declare function steeringTextDefect(text: string): SteeringTextDefect | undefined;
45
+ /** The defect as a clause a refusal sentence reads ("a reply that contains …"). */
46
+ export declare function steeringTextDefectClause(defect: SteeringTextDefect): string;
8
47
  /** An author as read: a member of the set, or `unknown` for anything else. */
9
48
  export type InputAuthorReading = InputAuthor | "unknown";
10
49
  /** The one reader: a member reads as itself, anything else (`undefined` included) as `unknown`. */
@@ -57,9 +96,12 @@ export interface AuthoredRelayCall {
57
96
  readonly signal?: AbortSignal;
58
97
  }
59
98
  /** The relay's answer, decided when the input is taken (never when it is read): the text that entered the leg — the caller's,
60
- * or the prompt screen's rewrite of it — or why it did not enter. */
99
+ * or the prompt screen's rewrite of it —, the answer the prompt screen already gave it (`replied`: it entered, and the turn it
100
+ * opens is that answer, no model asked), or why it did not enter. */
61
101
  export type AuthoredRelayAnswer = {
62
102
  readonly entered: string;
103
+ } | {
104
+ readonly replied: string;
63
105
  } | {
64
106
  readonly drop: string;
65
107
  };
@@ -1,9 +1,28 @@
1
1
  import { describeRejectedValue } from "./tool-search-setting.js";
2
+ import { sanitizeUntrustedText } from "./untrusted-text.js";
2
3
  export const INPUT_AUTHORS = Object.freeze(["operator", "parent_model", "workflow", "peer", "observer", "engine", "extension"]);
3
4
  const INPUT_AUTHOR_SET = new Set(INPUT_AUTHORS);
4
5
  export function isInputAuthor(v) {
5
6
  return INPUT_AUTHOR_SET.has(v);
6
7
  }
8
+ const SAYS_NOTHING = /^[\s\p{Cc}]*$/u;
9
+ export function isBlankInput(text) {
10
+ return SAYS_NOTHING.test(text);
11
+ }
12
+ export const MAX_PENDING_STEER_CHARS = 16_000;
13
+ export const STEERING_CONTROL_CHARS_RE = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/;
14
+ export function steeringTextDefect(text) {
15
+ if (sanitizeUntrustedText(text) !== text)
16
+ return "break_out_tag";
17
+ if (STEERING_CONTROL_CHARS_RE.test(text))
18
+ return "control_chars";
19
+ if (text.length > MAX_PENDING_STEER_CHARS)
20
+ return "too_long";
21
+ return undefined;
22
+ }
23
+ export function steeringTextDefectClause(defect) {
24
+ return defect === "break_out_tag" ? "contains a system-reminder break-out tag" : defect === "control_chars" ? "contains control characters" : `is longer than ${MAX_PENDING_STEER_CHARS} characters`;
25
+ }
7
26
  export function readInputAuthor(raw) {
8
27
  return isInputAuthor(raw) ? raw : "unknown";
9
28
  }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * The ONE reading of a task's ISOLATION SCOPE ({@link import("./task-spec.js").TaskSpec.isolationScope}): the member when it is set,
3
+ * else the principal. Every face that keys a run's working state on "which scope of this person's work" reads it here — the registry
4
+ * domain, the offload namespace, the checkpoint scope's last rung, the scheduler's keys, the delegation tree's domain, the MCP
5
+ * connection pool — and every face that keys on the PERSON keeps reading the principal.
6
+ *
7
+ * `||`, not `??`: the empty string is absence wearing clothes (the principal's own discipline, and the checkpoint scope's), so a blank
8
+ * member falls to the principal, and a task without the member answers its principal VERBATIM — the empty string included — which is
9
+ * exactly what each of those faces read before the member existed.
10
+ *
11
+ * Import-free: the tool modules reach it without pulling the runner in.
12
+ */
13
+ /** The holder of the two identity members: a task spec, a spec seat, a resume config, a scheduler context. */
14
+ export interface IsolationScopeHolder {
15
+ readonly isolationScope?: string;
16
+ readonly principal?: string;
17
+ }
18
+ /** The isolation scope of `holder`: its member when set, else its principal (possibly `undefined`, possibly `""`). */
19
+ export declare function isolationScopeOf(holder: IsolationScopeHolder): string | undefined;
20
+ /**
21
+ * The isolation-scope member a parked row RECORDS, spread into the row: present only when the task set one that differs from its
22
+ * principal — the one case the principal alone does not restate. A row that records it carries a reader requirement (a reader that
23
+ * cannot read it would resume the leg in the principal's scope); every other row stays exactly the row it was.
24
+ */
25
+ export declare function isolationScopeRecordOf(holder: IsolationScopeHolder): {
26
+ isolationScope?: string;
27
+ };
28
+ /**
29
+ * The scope a registry-facing tool acts in: the running task's isolation scope the Runner put on the tool's context, else the scope
30
+ * the tool was mounted with. The context's `principal` is the person and is never read here — a tool handed a context outside a
31
+ * Runner task names its scope on `isolationScope` (or mounts with one).
32
+ *
33
+ * `??`, not `||`: the context's value is a RESOLVED scope — what {@link isolationScopeOf} answered for the task — and is carried as handed,
34
+ * the empty string included (a task whose principal is the empty string has always keyed its state under it, and its mounted scope is the
35
+ * same string). The `||` above reads a member INPUT, where the empty string is absence wearing clothes; the two are different quantities.
36
+ */
37
+ export declare function callScopeOf(ctx: {
38
+ readonly isolationScope?: string;
39
+ } | undefined, mounted: {
40
+ readonly scope?: string;
41
+ }): string | undefined;
@@ -0,0 +1,10 @@
1
+ export function isolationScopeOf(holder) {
2
+ return holder.isolationScope || holder.principal;
3
+ }
4
+ export function isolationScopeRecordOf(holder) {
5
+ const own = holder.isolationScope || undefined;
6
+ return own !== undefined && own !== (holder.principal || undefined) ? { isolationScope: own } : {};
7
+ }
8
+ export function callScopeOf(ctx, mounted) {
9
+ return ctx?.isolationScope ?? mounted.scope;
10
+ }
@@ -0,0 +1,11 @@
1
+ /**
2
+ * The JSON Schema keywords whose VALUE is a subschema position, and in which form — the one table every walk over a
3
+ * schema reads to know where a subschema can sit (the MCP payload sanitizer, the tool-schema wire projection). A keyword
4
+ * absent here holds data, never a schema: a walk leaves that subtree byte-exact.
5
+ *
6
+ * - `"properties"` — an object from a NAME (a parameter, a `$defs` id) to a subschema.
7
+ * - `"schemaMap"` — an object from a key that is DATA (today `patternProperties`' regular expressions) to a subschema.
8
+ * - `"schema"` — a subschema, or an array of subschemas.
9
+ */
10
+ export type JsonSchemaSubschemaSeat = "properties" | "schemaMap" | "schema";
11
+ export declare const JSON_SCHEMA_SUBSCHEMA_SEATS: ReadonlyMap<string, JsonSchemaSubschemaSeat>;
@@ -0,0 +1,5 @@
1
+ export const JSON_SCHEMA_SUBSCHEMA_SEATS = new Map([
2
+ ...["properties", "definitions", "$defs", "dependentSchemas"].map((k) => [k, "properties"]),
3
+ ...["patternProperties"].map((k) => [k, "schemaMap"]),
4
+ ...["items", "prefixItems", "additionalItems", "additionalProperties", "unevaluatedItems", "unevaluatedProperties", "contains", "propertyNames", "contentSchema", "not", "if", "then", "else", "allOf", "anyOf", "oneOf"].map((k) => [k, "schema"]),
5
+ ]);
@@ -4,14 +4,15 @@
4
4
  * mods layer).
5
5
  */
6
6
  import type { HookInvocationIdentity } from "./hooks.js";
7
- import type { SessionAddress } from "./task-notification.js";
7
+ import type { EngineNotice } from "./engine-notice.js";
8
+ import type { NoticeDestinationJudge, SessionAddress } from "./task-notification.js";
8
9
  import type { AskSourceIdentity } from "./tool-policy.js";
9
10
  /**
10
11
  * The id a delegated leg's events carry as `agentId`: the leg's task id ({@link legTaskIdOf}) — for a background child, the
11
12
  * registry task id its spawner registered it under (the string its row, launch card, notifications, `TaskStop` and
12
- * `SendMessage` use); a foreground child has no row, so it is its session id. A top-level leg carries none. It reads two facts of
13
- * the leg's identity, so a face minted before the leg's hook envelope (the ask source) asks it with the same two, and a parked
14
- * row's summary asks it with the two the row records.
13
+ * `SendMessage` use); a foreground child has no registry identity (INTEGRATION-CORE §1.6a), so it is its session id. A
14
+ * top-level leg carries none. It reads two facts of the leg's identity, so a face minted before the leg's hook envelope (the
15
+ * ask source) asks it with the same two, and a parked row's summary asks it with the two the row records.
15
16
  */
16
17
  export declare function agentIdOf(identity: Pick<HookInvocationIdentity, "taskId" | "isDelegatedChild"> | undefined): string | undefined;
17
18
  /** A leg's task id — the row a delegation lane runs it as (`internals.rowTaskId`), else its host's `spec.taskId`, else its
@@ -27,6 +28,37 @@ export declare function legTaskIdOf(spec: {
27
28
  }, internals: {
28
29
  readonly rowTaskId?: string | undefined;
29
30
  } | undefined, sessionId: string | undefined): string | undefined;
31
+ /** The members of the SYNCHRONOUS-CHILD BLOCK a parked row records beside its identity, in the spelling of the run internals they are read from
32
+ * ({@link import("./runner/contracts.js").RunInternals}): the spawning run's session and task, and the delegation tree's root session with
33
+ * the occupant of its row. One tuple, so the mint, the resume's restore, the row's member-shape table and the summary all name the same four. */
34
+ export declare const SYNC_CHILD_BLOCK_MEMBERS: readonly ["parentSessionId", "parentTaskId", "rootSessionId", "rootSessionIncarnation"];
35
+ export type SyncChildBlock = {
36
+ readonly [K in (typeof SYNC_CHILD_BLOCK_MEMBERS)[number]]?: string;
37
+ };
38
+ /**
39
+ * The block a SYNCHRONOUS child's park rows record: {@link SYNC_CHILD_BLOCK_MEMBERS}, each only when it is a non-blank string — ONE
40
+ * predicate, ONE mint, read at prepare and stamped on every row the leg parks (approval, `resource_limit`, `plan_review`). A synchronous
41
+ * child is a delegated leg that is neither a registry row (`rowTaskId` absent: a background child's parent and root are the key and the
42
+ * columns of its registry record) nor a workflow agent (`delegationTaskType` absent: a workflow's agent is a delegated leg with no row too,
43
+ * but it has no synchronous parent to answer to): the one leg whose parked row is the only place a consumer can read where it came from.
44
+ * A root run has no parent — its rows carry none of the four. On a resumed leg a member the live internals carry none of (a host resume
45
+ * hands the leg none) is read from the parked row's own record (`recorded`): the row holds the answer once, a resume reads it and never
46
+ * re-derives it. Pure over the leg's facts.
47
+ */
48
+ export declare function syncChildBlockOf(leg: {
49
+ readonly isDelegatedChild: boolean;
50
+ readonly internals: ({
51
+ readonly rowTaskId?: string | undefined;
52
+ readonly delegationTaskType?: string | undefined;
53
+ } & SyncChildBlock) | undefined;
54
+ /** The parked row's own copy on a resumed leg. */
55
+ readonly recorded?: SyncChildBlock | undefined;
56
+ }): {
57
+ [K in (typeof SYNC_CHILD_BLOCK_MEMBERS)[number]]?: string;
58
+ };
59
+ /** The block a parked row recorded ({@link SYNC_CHILD_BLOCK_MEMBERS}, each only as a non-blank string), or `undefined` when it recorded none —
60
+ * what a resumed leg hands the park mint as {@link syncChildBlockOf}'s `recorded`. */
61
+ export declare function recordedSyncChildBlock(row: SyncChildBlock): SyncChildBlock | undefined;
30
62
  /** The facts a leg's ask source is minted from — all the leg's own, read once its session and task id are minted. */
31
63
  export interface AskSourceFacts {
32
64
  /** The leg's end-user principal (its spec's). */
@@ -88,9 +120,25 @@ export interface NoticeRoute {
88
120
  * at depth ≥ 2 has no host leg of its own to read it on) and carries the delegated leg's session and agent id — the shape a
89
121
  * subagent's permission denial takes upstream (the top-level session id plus the agent id). The root is a session address
90
122
  * like every other destination: its id and its occupant (`internals.rootSessionIncarnation`), so a notice of a tree whose
91
- * root was deleted and created again is not delivered to the root's later occupant.
123
+ * root was deleted and created again is not delivered to the root's later occupant. The id is read as the run's internals carry
124
+ * it — a non-empty string or absent (`readRootOccupant` refuses a run whose root id is anything else) — so it is asked nothing here.
92
125
  */
93
126
  export declare function noticeAddressOf(askSource: AskSourceIdentity, root: {
94
127
  readonly rootSessionId?: string;
95
128
  readonly rootSessionIncarnation?: string;
96
129
  } | undefined): NoticeRoute;
130
+ /** A leg's user-face notice seat: where its notices go ({@link NoticeRoute}) and the admission every one is delivered under. */
131
+ export interface LegNotice {
132
+ readonly route: NoticeRoute;
133
+ /** Judged against the tree's root occupant (below); absent for a top-level leg and for a leg prepared outside a Runner. */
134
+ readonly admission: ((notice: EngineNotice) => boolean) | undefined;
135
+ }
136
+ /**
137
+ * The leg's one notice seat, minted ONCE at prepare beside the ask source (`Prepared.legNotice`): every seat that tells the
138
+ * person something about this leg — the gate's stations, the shell's withheld-variables line — reads this address and this
139
+ * admission, so a delegated leg's notice is never addressed one way here and another way there.
140
+ */
141
+ export declare function mintLegNotice(askSource: AskSourceIdentity, root: {
142
+ readonly rootSessionId?: string;
143
+ readonly rootSessionIncarnation?: string;
144
+ } | undefined, judge: NoticeDestinationJudge | undefined): LegNotice;
@@ -4,6 +4,27 @@ export function agentIdOf(identity) {
4
4
  export function legTaskIdOf(spec, internals, sessionId) {
5
5
  return internals?.rowTaskId ?? spec.taskId ?? sessionId;
6
6
  }
7
+ export const SYNC_CHILD_BLOCK_MEMBERS = Object.freeze(["parentSessionId", "parentTaskId", "rootSessionId", "rootSessionIncarnation"]);
8
+ export function syncChildBlockOf(leg) {
9
+ if (!leg.isDelegatedChild || leg.internals?.rowTaskId !== undefined || leg.internals?.delegationTaskType !== undefined)
10
+ return {};
11
+ const block = {};
12
+ for (const name of SYNC_CHILD_BLOCK_MEMBERS) {
13
+ const value = leg.internals?.[name] ?? leg.recorded?.[name];
14
+ if (typeof value === "string" && value.trim() !== "")
15
+ block[name] = value;
16
+ }
17
+ return block;
18
+ }
19
+ export function recordedSyncChildBlock(row) {
20
+ const block = {};
21
+ for (const name of SYNC_CHILD_BLOCK_MEMBERS) {
22
+ const value = row[name];
23
+ if (typeof value === "string" && value.trim() !== "")
24
+ block[name] = value;
25
+ }
26
+ return Object.keys(block).length > 0 ? block : undefined;
27
+ }
7
28
  export function mintAskSourceIdentity(leg) {
8
29
  const agentId = agentIdOf({ taskId: leg.taskId, isDelegatedChild: leg.isDelegatedChild });
9
30
  const sourceAgentName = leg.internals?.explicitAgentName ?? leg.internals?.agentName;
@@ -22,7 +43,17 @@ export function noticeAddressOf(askSource, root) {
22
43
  throw new TypeError("noticeAddressOf: the leg's ask source carries no session");
23
44
  if (askSource.isDelegatedChild !== true)
24
45
  return { address: { sessionId: own } };
25
- const rootId = root?.rootSessionId !== undefined && root.rootSessionId.length > 0 ? root.rootSessionId : undefined;
46
+ const rootId = root?.rootSessionId;
26
47
  const address = { sessionId: rootId ?? own, sourceSessionId: own, ...(askSource.agentId !== undefined ? { agentId: askSource.agentId } : {}) };
27
48
  return rootId !== undefined && rootId !== own ? { address, destination: { sessionId: rootId, occupant: root?.rootSessionIncarnation } } : { address };
28
49
  }
50
+ function legNoticeAdmission(route, judge) {
51
+ const { address, destination } = route;
52
+ if (destination === undefined || judge === undefined)
53
+ return undefined;
54
+ return (notice) => judge(destination, { taskId: address.agentId ?? address.sourceSessionId ?? address.sessionId, taskType: notice.code }) !== true;
55
+ }
56
+ export function mintLegNotice(askSource, root, judge) {
57
+ const route = noticeAddressOf(askSource, root);
58
+ return Object.freeze({ route, admission: legNoticeAdmission(route, judge) });
59
+ }
@@ -152,6 +152,17 @@ export declare function refusedDeclarer(refusal: unknown): string | undefined;
152
152
  * read the same way; `at` is the surface the entry sits on, which only decides what the refusal calls the declarer.
153
153
  */
154
154
  export declare function snapshotDeclaredEntry<E extends McpServerSpec | A2aServerSpec>(entry: E, at: ToolAxesSurface): E;
155
+ /** What every question about ONE snapshot MCP entry answers: the entry (carrying the reader's own copy of whatever was judged) or the coded
156
+ * refusal that names the server and the member. The one answer shape of {@link judgeMcpEntryDeclarations} and of each leg it runs. */
157
+ export type McpEntryJudgment = {
158
+ ok: true;
159
+ entry: McpServerSpec;
160
+ } | {
161
+ ok: false;
162
+ error: Error & {
163
+ code: string;
164
+ };
165
+ };
155
166
  /**
156
167
  * The `toolAxes` question for ONE snapshot entry of either surface (`at`: an MCP server, an A2A peer) — asked by the preparation door (a
157
168
  * refusal ends the prepare) and by each materialization entrance (a refusal fails that server's or that peer's dial), so there is one
@@ -178,29 +189,20 @@ export declare function judgeEntryToolAxes<E extends McpServerSpec | A2aServerSp
178
189
  * frozen copy in place of the declaration (an empty record declares nothing and leaves no key); `ok: false` carries the coded refusal
179
190
  * (`config.tool_face_invalid`) naming the server, the tool and the member.
180
191
  */
181
- export declare function judgeEntryToolFaces(copy: McpServerSpec): {
182
- ok: true;
183
- entry: McpServerSpec;
184
- } | {
185
- ok: false;
186
- error: Error & {
187
- code: string;
188
- };
189
- };
192
+ export declare function judgeEntryToolFaces(copy: McpServerSpec): McpEntryJudgment;
190
193
  /**
191
194
  * The `sessionMetaKey` question for ONE snapshot MCP entry — asked by the door and the materialization entrance like its siblings, through
192
195
  * the one judge ({@link judgeSessionMetaKey}); a key that cannot ride refuses under `config.invalid_argument`, naming the server and the key.
193
196
  * The entry is unchanged (a string is already the engine's own copy).
194
197
  */
195
- export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
196
- ok: true;
197
- entry: McpServerSpec;
198
- } | {
199
- ok: false;
200
- error: Error & {
201
- code: string;
202
- };
203
- };
198
+ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): McpEntryJudgment;
199
+ /**
200
+ * The reserved-name question for ONE snapshot MCP entry, asked after its `toolAxes` and `toolFaces` were read: a declaration keyed by a
201
+ * reserved face word ({@link MCP_FACE_WORDS}) names a face of the server, never a tool — no tool of the server is ever mounted under that
202
+ * name, so the declaration could never be in force. Each face refuses through its own leg's one mint (`toolAxes` the generic
203
+ * `config.invalid_argument`, `toolFaces` its `config.tool_face_invalid`), naming the server and the word.
204
+ */
205
+ export declare function judgeEntryReservedKeys(copy: McpServerSpec): McpEntryJudgment;
204
206
  /**
205
207
  * The host-transport question for ONE snapshot MCP entry: a `{ kind: "host" }` transport carries no member beyond its kind (its host seat
206
208
  * carries its own pieces — a reference, a principal header, a command or a url would be declared and never in force), and its server
@@ -208,25 +210,18 @@ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
208
210
  * host's own interface, and the engine advertises no elicitation for it). Either refuses under
209
211
  * `config.invalid_argument`, naming the server and the member. Any other entry is unchanged.
210
212
  */
211
- export declare function judgeEntryHostTransport(copy: McpServerSpec): {
212
- ok: true;
213
- entry: McpServerSpec;
214
- } | {
215
- ok: false;
216
- error: Error & {
217
- code: string;
218
- };
219
- };
220
- /** Everything a snapshot MCP entry declares beyond its plain data, judged: its `toolAxes` ({@link judgeEntryToolAxes}), its `toolFaces` ({@link judgeEntryToolFaces}), its `sessionMetaKey` ({@link judgeEntrySessionMetaKey}), its host transport ({@link judgeEntryHostTransport}). */
221
- export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): {
222
- ok: true;
223
- entry: McpServerSpec;
224
- } | {
225
- ok: false;
226
- error: Error & {
227
- code: string;
228
- };
229
- };
213
+ export declare function judgeEntryHostTransport(copy: McpServerSpec): McpEntryJudgment;
214
+ /**
215
+ * Everything a snapshot MCP entry declares beyond its plain data, judged: its `toolAxes` ({@link judgeEntryToolAxes}), its `toolFaces`
216
+ * ({@link judgeEntryToolFaces}), the keys of both against the reserved face words ({@link judgeEntryReservedKeys}), its `sessionMetaKey`
217
+ * ({@link judgeEntrySessionMetaKey}), its host transport ({@link judgeEntryHostTransport}) — in that order, the first refusal is the answer.
218
+ *
219
+ * The one judge of an entry's declarations, and the one a caller outside the engine asks (a request door, a resume reader): a part of it (the host
220
+ * transport alone) would leave the other three unasked. A `{ kind: "host" }` row answers `ok: true` carrying the entry when its transport carries its
221
+ * kind alone and the server does not opt in to `elicitation`; otherwise `ok: false` with the coded refusal (`config.invalid_argument`) naming the
222
+ * server and the member. A row of any other transport is judged on the other three declarations only.
223
+ */
224
+ export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): McpEntryJudgment;
230
225
  /** One received thing: what the receipt read, or the refusal it raised — kept, raised by the door where it would have been raised. */
231
226
  export type Received<T> = {
232
227
  readonly read: T;
@@ -271,7 +266,7 @@ export declare function snapshotAndValidateMcpEntries(declared: unknown, where?:
271
266
  * screen calls this same function (`enter` naming each refusal's seat) and hands the leg its judged copies
272
267
  * of the lists THIS resume handed (the row records none), so the leg's prepare judges engine-owned plain data and dials what was judged.
273
268
  */
274
- export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: RunnerDeps, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
269
+ export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: Pick<RunnerDeps, "lockedConfig" | "toolPolicy" | "basePolicyForResumeEdit" | "peerSeat">, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
275
270
  /**
276
271
  * The two caller policies a prepare resolves to: the task's own seat over the deployment's, or the deployment's alone
277
272
  * under a `toolPolicy` lock — one resolution, read by the preflight above (which a resume enters before its claim).