@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,17 +1,18 @@
1
- import { createHash } from "node:crypto";
2
1
  import { types } from "node:util";
3
2
  import { Type } from "typebox";
4
3
  import { toolNameIndex } from "../internal/llm.js";
5
- import { getToolContract } from "../prompt-assembly/tool-catalog.js";
4
+ import { getToolContract, toolContractOfFace } from "../prompt-assembly/tool-catalog.js";
6
5
  import { protocolOf } from "./protocol-table.js";
7
6
  import { describeToolCatalog } from "./tool-registry.js";
7
+ import { TOOL_CATALOG_ENTRIES } from "./tool-catalog-entries.js";
8
+ import { ToolMountLedger } from "./tool-mount-plan.js";
8
9
  import { RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, RESERVED_APPROVAL_CARDS, isToolApprovalCard, TOOL_APPROVAL_CARDS, TOOL_CARD_ID_MAX_CHARS, TOOL_CONTRACT_MAX_CHARS, TOOL_FAMILIES, TOOL_KEYS_MAX, TOOL_KEY_MAX_CHARS, TOOL_MOUNT_TAGS, TOOL_WIRE_NAME_MAX_CHARS, TOOL_PATH_ABSENCES, TOOL_PATH_BASES, } from "./tool-face.js";
9
10
  import { ASK_USER_QUESTION_TOOL_NAME } from "./ask-question.js";
10
11
  import { PRESENT_PLAN_TOOL_NAME } from "./present-plan-tool.js";
11
12
  import { wireOf } from "./tool-name-readings.js";
12
13
  import { BOUNDARY_LEGS, rosterBoundaryLegs } from "./cross-boundary-taint.js";
13
14
  import { isPlainRecord, receive } from "./mods/kernel/receive.js";
14
- import { boundInputHashOf } from "./canonical-json.js";
15
+ import { boundInputHashOf, canonicalJsonStringify, sha16 } from "./canonical-json.js";
15
16
  function lit(values) {
16
17
  return Type.Union(values.map((v) => Type.Literal(v)));
17
18
  }
@@ -19,6 +20,18 @@ const Name = Type.String({ minLength: 1, maxLength: TOOL_WIRE_NAME_MAX_CHARS });
19
20
  const Short = Type.String({ maxLength: TOOL_CONTRACT_MAX_CHARS });
20
21
  const Key = Type.String({ maxLength: TOOL_KEY_MAX_CHARS });
21
22
  const Digest16 = Type.String({ minLength: 16, maxLength: 16 });
23
+ export const TOOL_ROSTER_MAX_ENTRIES = 2048;
24
+ function rosterRowCount(tools) {
25
+ const names = new Set();
26
+ for (const t of tools)
27
+ names.add(t.name);
28
+ return names.size;
29
+ }
30
+ function rosterEntryCountProblem(rows) {
31
+ if (rows <= TOOL_ROSTER_MAX_ENTRIES)
32
+ return undefined;
33
+ return `the tool roster would carry ${rows} rows; a roster carries at most ${TOOL_ROSTER_MAX_ENTRIES} (one per distinct tool name, deferred tools included) — narrow the leg's tool face (the selector / excludeTools) or split the MCP servers across legs`;
34
+ }
22
35
  export const ROSTER_SOURCES = Object.freeze(["builtin", "caller", "host", "mcp", "a2a", "external", "synthetic"]);
23
36
  export const ToolRosterRenderHints = Type.Object({
24
37
  userFacingName: Type.Optional(Type.String({ maxLength: RENDER_HINT_MAX_CHARS })),
@@ -32,6 +45,7 @@ export const ToolRosterEntry = Type.Object({
32
45
  aliases: Type.Array(Name, { uniqueItems: true }),
33
46
  source: lit(ROSTER_SOURCES),
34
47
  origin: Type.Optional(Type.Object({ peer: Name, declaredBy: Type.Optional(lit(["center", "file", "request"])) }, { additionalProperties: false })),
48
+ remoteName: Type.Optional(Name),
35
49
  contract: Type.Object({ contractId: Short, implementationRevision: Short }, { additionalProperties: false }),
36
50
  shapeDigest: Digest16,
37
51
  wireSchemaDigest: Digest16,
@@ -74,7 +88,7 @@ export const ToolRosterEntry = Type.Object({
74
88
  export const ToolRoster = Type.Object({
75
89
  schemaVersion: Type.Literal(1),
76
90
  count: Type.Integer({ minimum: 0 }),
77
- entries: Type.Array(ToolRosterEntry, { maxItems: 2048 }),
91
+ entries: Type.Array(ToolRosterEntry, { maxItems: TOOL_ROSTER_MAX_ENTRIES }),
78
92
  digest: Digest16,
79
93
  }, { additionalProperties: false });
80
94
  export const ToolRosterDelta = Type.Object({
@@ -174,6 +188,7 @@ export const ROSTER_APPROVAL_BINDING = Object.freeze({
174
188
  aliases: { unbound: "the names a call answers to are the call's own (the row's `names`); a resumed belt judges under the live names" },
175
189
  source: { identity: ["capabilityId"] },
176
190
  origin: { unbound: "the peer is the identity's (capabilityId); who declared the server is provenance no decision reads" },
191
+ remoteName: { identity: ["capabilityId"] },
177
192
  contract: { identity: ["contractId", "implementationRevision"] },
178
193
  shapeDigest: { identity: ["shapeDigest"] },
179
194
  wireSchemaDigest: { unbound: "the schema with its description prose for the model; the shape a call is validated against is the identity's (shapeDigest)" },
@@ -209,22 +224,11 @@ const DECLARATION_MEMBERS = Object.keys(ROSTER_APPROVAL_BINDING).filter((k) => R
209
224
  export function toolDeclarationDigestOf(entry) {
210
225
  return boundInputHashOf(Object.fromEntries(DECLARATION_MEMBERS.flatMap((k) => (entry[k] === undefined ? [] : [[k, entry[k]]]))));
211
226
  }
212
- function canonical(node) {
213
- if (Array.isArray(node))
214
- return `[${node.map(canonical).join(",")}]`;
215
- if (node === null || typeof node !== "object")
216
- return JSON.stringify(node) ?? "null";
217
- const keys = Object.keys(node).sort();
218
- return `{${keys.map((k) => `${JSON.stringify(k)}:${canonical(node[k])}`).join(",")}}`;
219
- }
220
- function sha16(text) {
221
- return createHash("sha256").update(text).digest("hex").slice(0, 16);
222
- }
223
227
  export function mintCapabilityId(t) {
224
- return sha16(canonical({ source: t.source, peer: t.peer, name: t.name, contractId: t.contractId }));
228
+ return sha16(canonicalJsonStringify({ source: t.source, peer: t.peer, name: t.name, contractId: t.contractId, ...(t.remote !== undefined ? { remote: t.remote } : {}) }));
225
229
  }
226
230
  export function rosterDigestOf(entries) {
227
- return sha16(canonical(entries));
231
+ return sha16(canonicalJsonStringify(entries));
228
232
  }
229
233
  const SCALAR_TYPES = new Set(["string", "number", "integer", "boolean"]);
230
234
  function schemaTypeOf(node) {
@@ -293,6 +297,7 @@ export function schemaKeyBoundProblem(schema) {
293
297
  return `the schema property ${JSON.stringify(long.slice(0, 40) + "…")} is ${long.length} characters; a roster key is at most ${TOOL_KEY_MAX_CHARS}`;
294
298
  return undefined;
295
299
  }
300
+ const NOT_IN_A_SERVER_TOOL_NAME = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]|(?! )\p{Zs}/u;
296
301
  export function rosterMemberBoundProblem(m) {
297
302
  if (typeof m.name !== "string")
298
303
  return { code: "config.tool_roster_bound", message: `tool has no string name (got ${m.name === null ? "null" : typeof m.name}); every roster row is keyed by a string \`name\`` };
@@ -305,6 +310,12 @@ export function rosterMemberBoundProblem(m) {
305
310
  return { code: "config.tool_name_too_long", message: of(over("alias", alias, TOOL_WIRE_NAME_MAX_CHARS)) };
306
311
  if (m.peer !== undefined && m.peer.length > TOOL_WIRE_NAME_MAX_CHARS)
307
312
  return { code: "config.tool_name_too_long", message: of(over("peer", m.peer, TOOL_WIRE_NAME_MAX_CHARS)) };
313
+ if (m.remoteName !== undefined && m.remoteName.length > TOOL_WIRE_NAME_MAX_CHARS)
314
+ return { code: "config.tool_name_too_long", message: of(over("server tool name", m.remoteName, TOOL_WIRE_NAME_MAX_CHARS)) };
315
+ if (m.remoteName === "")
316
+ return { code: "config.tool_roster_bound", message: of("the server lists the tool under the empty name; a roster row carries a server tool name of at least one character") };
317
+ if (m.remoteName !== undefined && NOT_IN_A_SERVER_TOOL_NAME.test(m.remoteName))
318
+ return { code: "config.tool_roster_bound", message: of("the server lists the tool under a name with a control, separator, direction or zero-width character; a roster row carries a server tool name that prints as it is spelled") };
308
319
  for (const [label, v] of [["contractId", m.contractId], ["implementationRevision", m.implementationRevision]]) {
309
320
  if (v !== undefined && v.length > TOOL_CONTRACT_MAX_CHARS)
310
321
  return { code: "config.tool_contract_too_long", message: of(over(`contract ${label}`, v, TOOL_CONTRACT_MAX_CHARS)) };
@@ -359,6 +370,24 @@ export function survivorsByName(mounted) {
359
370
  }
360
371
  export const faceOf = (t) => t;
361
372
  const protocolFolded = (source) => source === "mcp" || source === "a2a";
373
+ function catalogIdOf(name, contract) {
374
+ return TOOL_CATALOG_ENTRIES.find((e) => e.name === name && e.face.contract?.contractId === contract)?.id;
375
+ }
376
+ export function planIdentityOf(tool, source) {
377
+ const id = catalogIdOf(tool.name, toolContractOfFace(tool, "core").contractId);
378
+ return { ...(id !== undefined ? { id } : {}), source: planSourceOf(source) };
379
+ }
380
+ function planSourceOf(source) {
381
+ switch (source) {
382
+ case "builtin":
383
+ case "synthetic":
384
+ case "mcp":
385
+ case "a2a":
386
+ return source;
387
+ default:
388
+ return "scenario";
389
+ }
390
+ }
362
391
  function configError(code, message) {
363
392
  const e = new Error(message);
364
393
  e.code = code;
@@ -372,6 +401,15 @@ export class RosterBuilder {
372
401
  constructor(effects) {
373
402
  this.#effects = effects;
374
403
  }
404
+ mounts = new ToolMountLedger((t) => getToolContract(t, "core").contractId);
405
+ settleMountPlan() {
406
+ const all = [...this.#tools, ...this.#engineLane];
407
+ const members = [...survivorsByName(all).values()].map((t) => {
408
+ const meta = this.#meta.get(t);
409
+ return { name: t.name, ...planIdentityOf(t, meta?.source), mountedBy: meta?.mountedBy ?? "scenario", state: "mounted" };
410
+ });
411
+ return this.mounts.settle(all, members);
412
+ }
375
413
  get tools() {
376
414
  return this.#tools;
377
415
  }
@@ -443,6 +481,9 @@ export class RosterBuilder {
443
481
  this.#meta.set(tool, meta);
444
482
  }
445
483
  replaceDomain(prefix, fresh, meta) {
484
+ const over = rosterEntryCountProblem(rosterRowCount([...this.#tools.filter((t) => !t.name.startsWith(prefix)), ...fresh, ...this.#engineLane]));
485
+ if (over !== undefined)
486
+ throw configError("config.tool_roster_bound", over);
446
487
  let anchor = -1;
447
488
  const removed = [];
448
489
  for (let i = this.#tools.length - 1; i >= 0; i--) {
@@ -462,6 +503,9 @@ export class RosterBuilder {
462
503
  }
463
504
  snapshot(facts) {
464
505
  const all = [...this.#tools, ...this.#engineLane];
506
+ const over = rosterEntryCountProblem(rosterRowCount(all));
507
+ if (over !== undefined)
508
+ throw configError("config.tool_roster_bound", over);
465
509
  const winner = survivorsByName(all);
466
510
  const entries = [];
467
511
  const emitted = new Set();
@@ -512,7 +556,7 @@ export function rosterEngineNamesProblem(roster) {
512
556
  return undefined;
513
557
  }
514
558
  export function callerMountSource(tool) {
515
- return getToolContract(tool, "caller").origin === "core" ? "builtin" : "caller";
559
+ return toolContractOfFace(tool, "caller").origin === "core" ? "builtin" : "caller";
516
560
  }
517
561
  export function rosterCardId(source, toolName, peer, protocolTool, contractId) {
518
562
  return source === "builtin" || source === "synthetic"
@@ -528,6 +572,9 @@ export function callerCardIdOf(tool) {
528
572
  export function protocolToolOf(toolName) {
529
573
  return protocolOf(toolName)?.parse(toolName)?.tool ?? toolName;
530
574
  }
575
+ export function rosterRemoteNameOf(toolName, remote) {
576
+ return remote !== undefined && remote !== protocolToolOf(toolName) ? remote : undefined;
577
+ }
531
578
  export function boundaryLegsRefusal(toolName) {
532
579
  const named = typeof toolName === "string" ? JSON.stringify(toolName.slice(0, 128)) : `(a ${typeof toolName} name)`;
533
580
  return configError("config.tool_face_invalid", `tool ${named}: its boundaryLegs declaration is neither "per_call" nor a list of ${BOUNDARY_LEGS.join(" | ")}`);
@@ -560,6 +607,7 @@ export function mintRosterEntry(tool, meta, facts) {
560
607
  const d = getToolContract(tool, fallbackOrigin);
561
608
  const peer = meta.origin?.peer ?? null;
562
609
  const protocolTool = peer !== null ? protocolToolOf(tool.name) : tool.name;
610
+ const remoteName = rosterRemoteNameOf(tool.name, typeof tool.mcpRemoteName === "string" ? tool.mcpRemoteName : undefined);
563
611
  const cardId = rosterCardId(meta.source, tool.name, peer, protocolTool, d.contractId);
564
612
  const { keys: inputKeys } = inputKeysOf(tool.parameters);
565
613
  const declaredEffect = face.effect;
@@ -587,6 +635,7 @@ export function mintRosterEntry(tool, meta, facts) {
587
635
  name: tool.name,
588
636
  aliases: tool.aliases,
589
637
  ...(peer !== null ? { peer } : {}),
638
+ ...(remoteName !== undefined ? { remoteName } : {}),
590
639
  contractId: d.contractId,
591
640
  implementationRevision: d.implementationRevision,
592
641
  ...(typeof face.modelGate === "string" ? { modelGate: face.modelGate } : {}),
@@ -599,11 +648,12 @@ export function mintRosterEntry(tool, meta, facts) {
599
648
  aliases: [...new Set(tool.aliases ?? [])],
600
649
  source: meta.source,
601
650
  ...(meta.origin !== undefined ? { origin: { peer: meta.origin.peer, ...(meta.origin.declaredBy !== undefined ? { declaredBy: meta.origin.declaredBy } : {}) } } : {}),
651
+ ...(remoteName !== undefined ? { remoteName } : {}),
602
652
  contract: { contractId: d.contractId, implementationRevision: d.implementationRevision },
603
653
  shapeDigest: d.shapeDigest,
604
654
  wireSchemaDigest: d.wireSchemaDigest,
605
655
  cardId,
606
- capabilityId: mintCapabilityId({ source: meta.source, peer, name: tool.name, contractId: d.contractId }),
656
+ capabilityId: mintCapabilityId({ source: meta.source, peer, name: tool.name, contractId: d.contractId, remote: remoteName }),
607
657
  inputKeys,
608
658
  effect,
609
659
  effectProvenance,
@@ -706,8 +756,8 @@ export function ruleFacesFromRoster(roster) {
706
756
  };
707
757
  }
708
758
  export function diffToolRoster(prev, next) {
709
- const before = new Map(prev.entries.map((e) => [e.name, canonical(e)]));
710
- const after = new Map(next.entries.map((e) => [e.name, canonical(e)]));
759
+ const before = new Map(prev.entries.map((e) => [e.name, canonicalJsonStringify(e)]));
760
+ const after = new Map(next.entries.map((e) => [e.name, canonicalJsonStringify(e)]));
711
761
  const added = [];
712
762
  const removed = [];
713
763
  const changed = [];
@@ -1,9 +1,3 @@
1
- /**
2
- * The deferral gate's POLICY SEAT as vocabulary: the three states a deployment may declare
3
- * (`RunnerDeps.toolSearch`), the word a disclosure reports, and the ONE reader that lowers the seat to the
4
- * single number the gate compares against. Pure — no harness, no roster, no I/O. `runner/tool-defer-gate.ts`
5
- * owns the gate that consumes the number.
6
- */
7
1
  /** The default threshold percent: with no seat, the candidate set defers when its inlined size reaches this
8
2
  * percent of the model's context window. `DEFER_THRESHOLD_FRACTION` is derived from it. */
9
3
  export declare const TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT = 10;
@@ -60,9 +54,13 @@ export declare function resolveToolSearch(setting: ToolSearchSetting | undefined
60
54
  * `toString`); and `NaN` / `Infinity` — the two numbers these seats reject most — both came out as `null`,
61
55
  * the spelling of a value the caller never wrote.
62
56
  *
63
- * So: PRIMITIVES are spelled exactly (a number through `String`, which is total and keeps `NaN`, `Infinity`
64
- * and the `-0` a caller can only have written deliberately); anything else is DESCRIBED structurally — its
65
- * shape, its constructor's name and its own top-level keys, bounded. Reading those may still hit a proxy's
57
+ * So: a NUMBER, a boolean, a bigint, `null` and `undefined` are spelled exactly (a number through `String`, which is
58
+ * total and keeps `NaN`, `Infinity` and the `-0` a caller can only have written deliberately); a STRING or a symbol
59
+ * is the caller's text and takes its `callerText` shape — the redaction mark and its length, never the text (a
60
+ * deployment can put a credential in the wrong field, and this sentence travels to logs and panels); anything else
61
+ * is DESCRIBED structurally — its shape, the engine's word for its kind when its prototype is one of the built-ins
62
+ * in `BUILTIN_KINDS` (a `constructor` member or a class name is caller text and is never read as the word), and how
63
+ * many own keys it has (the keys are caller text too: counted, never spelled). Reading those may still hit a proxy's
66
64
  * traps (every read is guarded), but NOTHING a read hands back is turned into text unless it is already a
67
65
  * primitive of the expected domain — a formatting hook of the value is never what writes this sentence. A description is worth less to a reader than the value would be; a WRONG value is worth less than
68
66
  * nothing, because it sends them to fix something they did not write.
@@ -1,3 +1,19 @@
1
+ import { callerText } from "./caller-text.js";
2
+ const BUILTIN_KINDS = Object.freeze([
3
+ [Map.prototype, "Map"],
4
+ [Set.prototype, "Set"],
5
+ [WeakMap.prototype, "WeakMap"],
6
+ [WeakSet.prototype, "WeakSet"],
7
+ [Date.prototype, "Date"],
8
+ [RegExp.prototype, "RegExp"],
9
+ [Promise.prototype, "Promise"],
10
+ [Error.prototype, "Error"],
11
+ [TypeError.prototype, "TypeError"],
12
+ [RangeError.prototype, "RangeError"],
13
+ [URL.prototype, "URL"],
14
+ [ArrayBuffer.prototype, "ArrayBuffer"],
15
+ [Uint8Array.prototype, "Uint8Array"],
16
+ ]);
1
17
  export const TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT = 10;
2
18
  export const TOOL_SEARCH_INVALID_CODE = "config.tool_search_invalid";
3
19
  export const TOOL_SEARCH_POLICIES = Object.freeze(["always", "never", "auto"]);
@@ -27,7 +43,7 @@ export function resolveToolSearch(setting) {
27
43
  }
28
44
  const stray = keys.find((k) => k !== "mode" && k !== "thresholdPercent");
29
45
  if (stray !== undefined) {
30
- throw toolSearchRefusal(`unknown member ${JSON.stringify(stray)} — the object form carries mode and thresholdPercent only`);
46
+ throw toolSearchRefusal(`unknown member ${callerText(stray)} — the object form carries mode and thresholdPercent only`);
31
47
  }
32
48
  if (percent === undefined)
33
49
  return { policy: "auto", thresholdPercent: TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT, fraction: TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT / 100 };
@@ -42,9 +58,8 @@ export function describeRejectedValue(value) {
42
58
  case "bigint":
43
59
  return `${value}n`;
44
60
  case "symbol":
45
- return String(value);
46
61
  case "string":
47
- return JSON.stringify(value);
62
+ return callerText(value);
48
63
  case "number":
49
64
  return Object.is(value, -0) ? "-0" : String(value);
50
65
  case "boolean":
@@ -57,9 +72,10 @@ export function describeRejectedValue(value) {
57
72
  return String(value);
58
73
  let ctor = "";
59
74
  try {
60
- const name = value.constructor?.name;
61
- if (typeof name === "string" && name !== "" && name !== "Object" && name !== "Array")
62
- ctor = ` (${name.slice(0, 40)})`;
75
+ const proto = Object.getPrototypeOf(value);
76
+ const kind = BUILTIN_KINDS.find(([p]) => p === proto);
77
+ if (kind !== undefined)
78
+ ctor = ` (${kind[1]})`;
63
79
  }
64
80
  catch {
65
81
  }
@@ -70,7 +86,7 @@ export function describeRejectedValue(value) {
70
86
  const keys = Object.keys(value);
71
87
  if (keys.length === 0)
72
88
  return `an object${ctor} with no keys`;
73
- return `an object${ctor} with keys [${keys.slice(0, 5).map((k) => k.slice(0, 40)).join(", ")}${keys.length > 5 ? ", …" : ""}]`;
89
+ return `an object${ctor} with ${keys.length} key${keys.length === 1 ? "" : "s"}`;
74
90
  }
75
91
  catch {
76
92
  return `a value of type ${value === null ? "null" : typeof value} that cannot be described`;
@@ -713,6 +713,9 @@ export interface ToolExecuteContext {
713
713
  * (`RunInternals.rootSessionIncarnation`) and a background spawn persists it on its row, where a revival reads it back;
714
714
  * absent = unknown (a row minted before occupants, a revival of a row that recorded none). */
715
715
  rootSessionIncarnation?: string;
716
+ /** The scope that root session's box mounts in, beside its occupant by the same fixed point (`RunInternals.rootSessionScope`):
717
+ * a background spawn persists it on its row. Runner-filled, trusted; absent = none recorded. */
718
+ rootSessionScope?: string;
716
719
  /** The run's delegation tree owner seat (`RunInternals.delegationOwner`, Runner-filled): a delegation tool reads the tree's owner
717
720
  * through it for the rows it creates for a child (a placed transcript, a fork, a park's durable row) and threads it into a spawned
718
721
  * child's internals by reference — never into a revival's. */
@@ -961,8 +964,20 @@ export interface ToolExecuteContext {
961
964
  * verbatim to its child task so the end-user identity is inherited down the delegation tree (the worker
962
965
  * cannot substitute a different principal — it is not a tool argument). Undefined when the task has no
963
966
  * principal or the tool runs outside a Runner task.
967
+ *
968
+ * It names the PERSON. A tool that keys working state (a registry row it stops or lists, a background
969
+ * output it adopts, a peer address it guards) reads {@link isolationScope} instead — never this seat.
964
970
  */
965
971
  principal?: string;
972
+ /**
973
+ * The running task's ISOLATION SCOPE ({@link TaskSpec.isolationScope}, else its principal), **read-only** — the
974
+ * Runner fills it on the same trusted seat as {@link principal}, never a model / tool argument. It is the key
975
+ * of the task's working state: a tool that registers, stops, lists or guards rows scoped to the run reads it
976
+ * through `callScopeOf(ctx, opts)` (the run's value, else the tool's mounted `scope`), so a row the run wrote
977
+ * and the tool that acts on it name one bucket. Undefined when the task has neither member or the tool runs
978
+ * outside a Runner task.
979
+ */
980
+ isolationScope?: string;
966
981
  /**
967
982
  * ruled 2026-08-04 — the RUNNING task's EFFECTIVE synchronous approver (`spec.onAsk ?? deps.onAsk`,
968
983
  * the exact value this task's own gate resolves an `ask` at), Runner-filled read-only on the same
@@ -1284,14 +1299,15 @@ export interface ToolExecuteContext {
1284
1299
  decider: import("./auto-mode.js").AutoModeDecider;
1285
1300
  };
1286
1301
  /**
1287
- * design/153 §7.4 (件4) — the parent task's `durableApproval` opt-in (value copy), Runner-filled so a
1302
+ * design/153 §7.4 (件4) — the parent task's EFFECTIVE `durableApproval` opt-in (value copy: its own, or the one a
1303
+ * `forceDurableGate` entitlement synthesizes on a root leg — `effectiveDurableApprovalOf`), Runner-filled so a
1288
1304
  * delegation tool can FORWARD it into an eligible background child's spec (named non-fork child + durable
1289
1305
  * row + checkpoint store + `ensureChildSessionDurable` attested — the §7.3 park-eligibility family). With
1290
1306
  * it forwarded, a child's plain policy `ask` suspends durably and the settle watcher PARKS the row instead
1291
1307
  * of the pre-153 `unexpected.suspended` failure. Tighten-only: forwarding grants the child a PARK
1292
1308
  * capability, never a permission widening — the park's resume decision stays with the operator, and the
1293
1309
  * ancestor mandate chain (frozen at chain assembly) is unchanged by the child's own spec. Runner-filled,
1294
- * read-only, NEVER a model/tool argument. Undefined when the parent did not opt in (children keep the
1310
+ * read-only, NEVER a model/tool argument. Undefined when the parent has no effective opt-in (children keep the
1295
1311
  * pre-153 lifecycle byte-for-byte). Side effect worth noting (件4 复审): forwarding also flips the
1296
1312
  * child's `durableQuestionFace` true (a wired checkpoint store + this opt-in), so an eligible child
1297
1313
  * additionally mounts `AskUserQuestion` — a deliberate consequence (a question the child can't resolve
@@ -1325,6 +1341,14 @@ export interface ToolExecuteContext {
1325
1341
  * {@link checkpointStoreForChildren}.
1326
1342
  */
1327
1343
  taskRegistry?: import("./task-registry.js").TaskRegistry;
1344
+ /**
1345
+ * Whether the host run has committed a durable park (any gate) — read at call time. Runner-filled, read-only, NEVER a
1346
+ * model/tool argument; ABSENT when the tool runs outside a Runner task. A delegation tool's background lane reads it
1347
+ * when the host's abort reaches it: the abort a parking run stops its turn with is not a cancel of the background work
1348
+ * it owns — the run's own end decides that work's fate (each agent that can park yields, the rest are stopped), so the
1349
+ * lane leaves it to the run instead of killing the agent on the spot.
1350
+ */
1351
+ hostRunParked?: () => boolean;
1328
1352
  /**
1329
1353
  * The host run's checkpoint SCOPE, for its children — the scope this run's own parked rows land in (the one
1330
1354
  * value its prepare derived; a delegated host's is the scope ITS parent handed it, so a whole tree answers
@@ -1386,6 +1410,12 @@ export interface ToolExecuteContext {
1386
1410
  * tool holding this ctx could self-declare one, so a consumer validates `parentTaskId` against its known runs.
1387
1411
  */
1388
1412
  forwardEvent?: (event: TaskEvent) => void;
1413
+ /**
1414
+ * The host run's activity seat (`RunInternals.onSubtreeActivity`): a delegation tool threads it into each foreground child it runs, so the
1415
+ * child's — and its descendants' — tool work beats the same seat as the host's own. TRUSTED, run-scoped; absent when the run has no
1416
+ * seat. A timestamp write: it must not throw or wait.
1417
+ */
1418
+ onSubtreeActivity?: () => void;
1389
1419
  /**
1390
1420
  * Subagent steer verb (2026-07-03): the host run's opt-in SUBAGENT-STEER-HANDLE sink
1391
1421
  * (threaded from `RunInternals.onSubagentSpawn`). When present, `createSubagentTool` runs each sync
@@ -1,23 +1,12 @@
1
1
  import { Value } from "typebox/value";
2
2
  import { formatToolError, formatZodValidationError } from "./tool-errors.js";
3
- import { readMember } from "./thrown-value.js";
3
+ import { readMember, thrownMarksOf } from "./thrown-value.js";
4
4
  import { frozenToolSpec } from "./tool-spec-members.js";
5
5
  import { carryDelegationName } from "./delegation-name.js";
6
6
  import { attachEngineToolContract, attachToolContract, contractOriginOf } from "../prompt-assembly/tool-catalog.js";
7
7
  import { isCatalogContract } from "./tool-catalog-entries.js";
8
- import { types } from "node:util";
9
- import { appendOwn, dataMember, isPlainRecord, receive } from "./mods/kernel/receive.js";
10
- import { carryNotStartedReceipt } from "./delegation-not-started.js";
11
- const TOOL_DATA_MODE = Object.freeze({ accessors: "call-once", depth: Infinity, others: "copy", contain: true, wire: true, isProxy: (v) => types.isProxy(v) });
12
- function receivedData(v) {
13
- if (v === null || v === undefined || typeof v === "string" || typeof v === "number" || typeof v === "boolean")
14
- return v;
15
- const r = receive(v, TOOL_DATA_MODE);
16
- if (!r.ok)
17
- return undefined;
18
- carryNotStartedReceipt(v, r.value);
19
- return r.value;
20
- }
8
+ import { appendOwn, dataMember, isPlainRecord } from "./mods/kernel/receive.js";
9
+ import { receivedToolData } from "./tool-data-door.js";
21
10
  const CONTENT_BLOCK_FIELDS = Object.freeze({ text: ["text"], image: ["data", "mimeType"], document: ["data", "mimeType"] });
22
11
  function blockOf(element) {
23
12
  if (!isPlainRecord(element))
@@ -34,7 +23,7 @@ function blockOf(element) {
34
23
  return block;
35
24
  }
36
25
  function receivedContent(raw) {
37
- const copy = receivedData(raw);
26
+ const copy = receivedToolData(raw);
38
27
  if (!Array.isArray(copy))
39
28
  return undefined;
40
29
  const out = [];
@@ -57,7 +46,7 @@ function receiveToolReturn(ret) {
57
46
  isError: true,
58
47
  };
59
48
  }
60
- return { content: content, details: receivedData(readMember(ret, "details")), terminate: readMember(ret, "terminate") === true, isError: readMember(ret, "isError") === true };
49
+ return { content: content, details: receivedToolData(readMember(ret, "details")), terminate: readMember(ret, "terminate") === true, isError: readMember(ret, "isError") === true };
61
50
  }
62
51
  function isEmptyToolContent(content) {
63
52
  if (content.length === 0)
@@ -168,12 +157,9 @@ function buildProduct(spec, owner, options) {
168
157
  }
169
158
  catch (err) {
170
159
  const wrapped = new Error(formatToolError(err));
171
- const marks = receivedData(readMember(err, "details"));
160
+ const marks = thrownMarksOf(err);
172
161
  if (marks !== undefined)
173
162
  wrapped.details = marks;
174
- const errorKind = readMember(err, "errorKind");
175
- if (typeof errorKind === "string")
176
- wrapped.errorKind = errorKind;
177
163
  throw wrapped;
178
164
  }
179
165
  },
@@ -21,7 +21,8 @@ import type { ThinkingLevel } from "../internal/harness-types.js";
21
21
  import type { ToolManifestRow } from "../prompt-assembly/tool-catalog.js";
22
22
  import type { PromptEpochActivation, PromptIdentityLayers } from "../prompt-assembly/epoch.js";
23
23
  import type { ChainLink, SupersededOverlay } from "../prompt-assembly/overlay.js";
24
- import type { HostForm, HostRole, RendererId } from "../prompt-assembly/catalog/schema.js";
24
+ import type { HostForm, HostRole, PromptLocale, RendererId } from "../prompt-assembly/catalog/schema.js";
25
+ import type { AssertAllKeysHandled } from "./ask-origin.js";
25
26
  /** The run's prompt identity as the manifest reports it: the identity digest, its inputs, and the session record that
26
27
  * names it (the record's counter and how it came to be). */
27
28
  export interface PromptManifestIdentity {
@@ -39,10 +40,14 @@ export interface PromptManifestSelectors {
39
40
  form: HostForm;
40
41
  };
41
42
  facts: Record<string, boolean>;
43
+ /** Which rendering of the catalog the run reads (`TaskSpec.promptLocale`; absent ⇒ `canonical`). Always present. */
44
+ locale: PromptLocale;
42
45
  }
43
- /** One rendered section: where it sits, which variant and renderer made it, whose text it carries (`locale`: the
44
- * catalog's canonical text, or text an overlay author wrote), its content digest (`sha256:` unsalted for published
45
- * text, `salted:` for text carrying the task's or the run's own inputs) and its history (`chain`). */
46
+ /** One rendered section: where it sits, which variant and renderer made it, where its text comes from (`locale`, a
47
+ * source class, not a language reading: `overlay` — an overlay author's text is in force; else the run's locale when
48
+ * the section is catalog text or a renderer reported rendering a catalog message; else `canonical` — engine text
49
+ * outside the catalog or the run's own inputs), its content digest (`sha256:` unsalted for published text, `salted:`
50
+ * for text carrying the task's or the run's own inputs) and its history (`chain`). */
46
51
  export interface PromptManifestSection {
47
52
  id: string;
48
53
  band: string;
@@ -53,7 +58,7 @@ export interface PromptManifestSection {
53
58
  version: number;
54
59
  };
55
60
  chars: number;
56
- locale: "canonical" | "overlay";
61
+ locale: PromptLocale | "overlay";
57
62
  contentHash: string;
58
63
  chain: ChainLink[];
59
64
  }
@@ -66,7 +71,7 @@ export interface PromptManifestSection {
66
71
  export interface TraceMechanismsSummary {
67
72
  finalVerifyInjections?: number;
68
73
  attachmentsInjected?: number;
69
- /** design/164: how many LIMIT-APPROACH frames were injected this run (0..2). */
74
+ /** design/164: how many distinct LIMIT-APPROACH sentences a model request carried this run (0..2). */
70
75
  approachNoticesSent?: number;
71
76
  repetitionCuts?: number;
72
77
  repetitionSpared?: number;
@@ -174,6 +179,15 @@ export type TraceEvent = {
174
179
  cacheIdentity: string;
175
180
  elements: import("../prompt-assembly/turn-snapshot.js").CacheIdentityElements;
176
181
  };
182
+ /** Why the prefix moved — the declared word ({@link import("./cache-break-detector.js").PrefixChangeDeclaration});
183
+ * `leg_start_inputs` is the leg's first frame, against the session's anchor rather than an earlier request. */
184
+ cause: import("./cache-break-detector.js").PrefixChangeCause;
185
+ /** `tool_table` only: which writer moved the table. */
186
+ source?: import("../prompt-assembly/turn-snapshot.js").ToolTableSource;
187
+ /** `leg_start_inputs` only: the head segments that differ from the anchor (prompt block ids, `tools`). */
188
+ segments?: string[];
189
+ /** `tool_table` only: the first tool position whose wire face differs. */
190
+ firstChangedIndex?: number;
177
191
  ts: number;
178
192
  } | {
179
193
  /**
@@ -350,8 +364,11 @@ export type TraceEvent = {
350
364
  * cacheWrite`) — the figure `costMicroUsd` is computed from. */
351
365
  totalInputTokens: number;
352
366
  completionTokens: number;
353
- cacheRead: number;
354
- cacheWrite: number;
367
+ /** Prompt tokens this call read from the provider's prefix cache; ABSENT when the call did not report it (never a 0). */
368
+ cacheRead?: number;
369
+ /** Prompt tokens this call wrote to the provider's prefix cache; ABSENT when the call did not report it (the
370
+ * OpenAI-shaped wires never do). */
371
+ cacheWrite?: number;
355
372
  /** Wall time from the brain request to its final message. */
356
373
  latencyMs: number;
357
374
  /** Time to the first content delta (excludes thinking) — maps to OTel time_to_first_chunk (×1000). */
@@ -421,7 +438,7 @@ export type TraceEvent = {
421
438
  taskId: string;
422
439
  from: string;
423
440
  to: string;
424
- reason: "breaker_open" | "rate_limit" | "budget" | "server_error" | "last_resort";
441
+ reason: import("./model-fallbacks.js").DegradeReason;
425
442
  atTurn: number;
426
443
  ts: number;
427
444
  } | {
@@ -567,11 +584,21 @@ export type TraceEvent = {
567
584
  * The device lane's cross-boundary TAINT on a tree that executes on a target device: once when a leg is prepared on an armed
568
585
  * tree (`phase: "prepare"`; `"resume"` on a durable resume's leg), and once when this leg first lets an off-target read into the
569
586
  * tree (`"observed"`, with the call). A tree that never armed emits none. Metadata only.
587
+ *
588
+ * The frame is filed by `root` and labelled by `taskId`: `root` is the session the tree's person watches, the address a user-face
589
+ * notice of the same leg goes to (`noticeAddressOf`), so a tree's frames meet at one key whichever leg emitted them; `taskId`
590
+ * names the leg that emitted it.
570
591
  */
571
592
  kind: "permission.cross_boundary_taint";
572
593
  version: 1;
573
594
  taskId: string;
574
595
  runId: string;
596
+ /** Where the frame is filed. A top-level leg: its own session, no `occupant`. A delegated leg: the delegation tree's root
597
+ * session and, when the tree knows it, the occupant that session held when the tree was born (absent = unknown). */
598
+ root: {
599
+ sessionId: string;
600
+ occupant?: string;
601
+ };
575
602
  phase: "prepare" | "resume" | "observed";
576
603
  /** The tree's taint bits after the event. */
577
604
  taint: readonly import("./cross-boundary-taint.js").CrossBoundaryTaintBit[];
@@ -964,8 +991,9 @@ export type TraceEvent = {
964
991
  field: "requestId" | "responseModel" | "apiErrorCode";
965
992
  ts: number;
966
993
  } | {
967
- /** C10 — a `preemptSignal` fired on a task that is NOT resource-suspend-eligible: the preempt is a
968
- * documented silent no-op, but the SCHEDULER that raised it needs to know it was ignored. */
994
+ /** A `preemptSignal` this leg could not honour (it cannot suspend durably, or the suspend was refused
995
+ * without writing anything): the run keeps going. The telemetry projection of the same answer the
996
+ * deployment's error face carries; once per leg. */
969
997
  kind: "preempt.ignored";
970
998
  version: 1;
971
999
  taskId: string;
@@ -1006,3 +1034,27 @@ export type TracerHook = (e: TraceEvent) => void;
1006
1034
  * (`egressAccount`) — so a frame that carries a host's, a store's or a remote's words (a thrown text, a failure reason) needs no
1007
1035
  * remembering at its mint site. */
1008
1036
  export declare function emitTrace(tracer: TracerHook | undefined, build: () => TraceEvent): void;
1037
+ /** The kinds this build mints, one per {@link TraceEvent} arm — the union is the source, this list follows it. */
1038
+ export declare const TRACE_EVENT_KINDS: readonly ["task.start", "prompt.assembled", "prompt.snapshot_changed", "reasoning.resolved", "config.assembled", "config.additional_directory_skipped", "task.end", "turn.end", "brain.call", "tool.call", "repetition.detected", "task.degraded", "observer.notify_failed", "permission.persisted_rule_allowed", "permission.read_only_allowed", "permission.skill_allowed", "permission.allowed_tools_allowed", "permission.rule_store_unreadable", "permission.rule_sync_resurrected", "permission.rule_sync_dropped", "permission.org_snapshot_unavailable", "permission.cross_boundary_taint", "permission.sandbox_admitted", "auto_mode.classified", "brain.failover", "breaker.transition", "brain.retry", "loop.recovery", "compaction.suppressed", "compaction.unevaluable", "compaction.blocked", "compaction.failed", "compaction.mooted", "compaction.noop", "compaction.disabled", "compaction.window_config_warning", "compaction.model_fallback", "compaction.clamp_disclosure", "compaction.manual_in_finalize", "compaction.input_truncated", "compaction.phase_timings", "compaction.announce_dropped", "context.trim", "context.mc_clear", "context.mc_null", "tool_result.capped", "context.media_removed", "vision.placeholder", "brain.echo_dropped", "preempt.ignored", "review.dropped", "task.onerror_sink_failed"];
1039
+ /** Compile-time fence: `never` while the list and the union's `kind` words are the same words. */
1040
+ export type TraceEventKindsMatchTheUnion = AssertAllKeysHandled<Exclude<TraceEvent["kind"], (typeof TRACE_EVENT_KINDS)[number]> | Exclude<(typeof TRACE_EVENT_KINDS)[number], TraceEvent["kind"]>>;
1041
+ /** A word-valued member as a reader across a build boundary meets it: this build's words, or a word a later build adds. */
1042
+ type OpenWords<V> = V extends string ? (string extends V ? V : V | (string & {})) : V;
1043
+ type ReadArm<Arm> = Arm extends unknown ? {
1044
+ [K in keyof Arm]: K extends "kind" ? Arm[K] : OpenWords<Arm[K]>;
1045
+ } : never;
1046
+ /** A {@link TraceEvent} arm of a kind this build mints, as read from another build: the kind exact, every other word open. */
1047
+ export type KnownTraceRecord = ReadArm<TraceEvent>;
1048
+ /**
1049
+ * A trace record read where it may come from another build — stored and read back, or forwarded and read
1050
+ * elsewhere: an arm of a kind this build mints, or a record of a kind it does not. {@link TracerHook} keeps the
1051
+ * closed {@link TraceEvent}, since in process the record is this build's own. Its reading is `vocabulary.open`
1052
+ * (`OPEN_FACE`); branch on its arms only after {@link isKnownTraceEvent}.
1053
+ */
1054
+ export type TraceRecord = KnownTraceRecord | {
1055
+ readonly kind: string;
1056
+ readonly [member: string]: unknown;
1057
+ };
1058
+ /** Whether a record's own `kind` is one this build mints — an inherited or non-string `kind` is not. Only the kind is read. */
1059
+ export declare function isKnownTraceEvent(record: TraceRecord): record is KnownTraceRecord;
1060
+ export {};
@@ -8,3 +8,22 @@ export function emitTrace(tracer, build) {
8
8
  catch {
9
9
  }
10
10
  }
11
+ export const TRACE_EVENT_KINDS = Object.freeze([
12
+ "task.start", "prompt.assembled", "prompt.snapshot_changed", "reasoning.resolved", "config.assembled",
13
+ "config.additional_directory_skipped", "task.end", "turn.end", "brain.call", "tool.call", "repetition.detected",
14
+ "task.degraded", "observer.notify_failed", "permission.persisted_rule_allowed", "permission.read_only_allowed",
15
+ "permission.skill_allowed", "permission.allowed_tools_allowed", "permission.rule_store_unreadable",
16
+ "permission.rule_sync_resurrected", "permission.rule_sync_dropped", "permission.org_snapshot_unavailable",
17
+ "permission.cross_boundary_taint", "permission.sandbox_admitted", "auto_mode.classified", "brain.failover",
18
+ "breaker.transition", "brain.retry", "loop.recovery", "compaction.suppressed", "compaction.unevaluable",
19
+ "compaction.blocked", "compaction.failed", "compaction.mooted", "compaction.noop", "compaction.disabled",
20
+ "compaction.window_config_warning", "compaction.model_fallback", "compaction.clamp_disclosure",
21
+ "compaction.manual_in_finalize", "compaction.input_truncated", "compaction.phase_timings",
22
+ "compaction.announce_dropped", "context.trim", "context.mc_clear", "context.mc_null", "tool_result.capped",
23
+ "context.media_removed", "vision.placeholder", "brain.echo_dropped", "preempt.ignored", "review.dropped",
24
+ "task.onerror_sink_failed",
25
+ ]);
26
+ const TRACE_EVENT_KIND_SET = new Set(TRACE_EVENT_KINDS);
27
+ export function isKnownTraceEvent(record) {
28
+ return typeof record === "object" && record !== null && Object.hasOwn(record, "kind") && TRACE_EVENT_KIND_SET.has(record.kind);
29
+ }