@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -5,14 +5,16 @@ export function describeConfigCatalog() {
5
5
  {
6
6
  key: "limits.maxTurns",
7
7
  recommended: null,
8
+ default: null,
8
9
  unit: "turns",
9
10
  kind: "budget",
10
- summary: "Per-slice turn ceiling. Unset = unbounded (design/164 retired the engine-side net): a task that needs a turn bound states one. 0 = the explicit unbounded sentinel.",
11
+ summary: "Per-slice turn ceiling. Unset = unbounded (the engine carries no default turn net): a task that needs a turn bound states one. 0 = the explicit unbounded sentinel.",
11
12
  precedence: "spec.limits.maxTurns > unset",
12
13
  },
13
14
  {
14
15
  key: "limits.maxWalltimeMs",
15
16
  recommended: null,
17
+ default: null,
16
18
  unit: "ms",
17
19
  kind: "budget",
18
20
  summary: "Per-slice ACTIVE wall-clock window for the task (suspended time does not count; a resume opens a fresh window). Unset = unbounded, which is the recommendation — bound work by tokens, not by time.",
@@ -29,6 +31,7 @@ export function describeConfigCatalog() {
29
31
  {
30
32
  key: "limits.maxCostUsd",
31
33
  recommended: null,
34
+ default: null,
32
35
  unit: "usd",
33
36
  kind: "budget",
34
37
  summary: "Per-slice spend ceiling (hard-cancels the in-flight stream by default when crossed). Unset = unbounded.",
@@ -37,6 +40,7 @@ export function describeConfigCatalog() {
37
40
  {
38
41
  key: "limits.maxTokens",
39
42
  recommended: null,
43
+ default: null,
40
44
  unit: "tokens",
41
45
  kind: "budget",
42
46
  summary: "Per-slice token budget — the PRIMARY axis. Unset = unbounded.",
@@ -46,12 +50,13 @@ export function describeConfigCatalog() {
46
50
  key: "limits.approachNotice",
47
51
  recommended: null,
48
52
  kind: "behavior",
49
- summary: "Advisory limit-approach reminders (one at ~80% of the tightest armed axis, one at ~95%). Unset = ON whenever an axis is armed; false = off; { at } overrides the thresholds.",
53
+ summary: "Advisory limit-approach sentence carried at the end of each model request once the tightest armed axis passes ~80% (converge) or ~95% (deliver now); never written to the transcript; the turn axis counts only from maxTurns 4. Unset = ON whenever an axis is armed; false = off; { at } overrides the thresholds.",
50
54
  precedence: "spec.limits.approachNotice > on-when-any-axis-armed",
51
55
  },
52
56
  {
53
57
  key: "budget.totalTokens",
54
58
  recommended: null,
59
+ default: null,
55
60
  unit: "tokens",
56
61
  kind: "budget",
57
62
  summary: "Cross-slice token allocation for resource-suspend tasks. First slice only; later slices read the frozen ledger. Unset = per-slice windows only.",
@@ -60,6 +65,7 @@ export function describeConfigCatalog() {
60
65
  {
61
66
  key: "delegation.retainTtlMs",
62
67
  recommended: RETAIN_DEFAULT_TTL_MS,
68
+ default: RETAIN_DEFAULT_TTL_MS,
63
69
  unit: "ms",
64
70
  kind: "retention",
65
71
  summary: "Retained child session TTL (settled-at based) within the parent run's retain ledger.",
@@ -68,6 +74,7 @@ export function describeConfigCatalog() {
68
74
  {
69
75
  key: "delegation.retainMax",
70
76
  recommended: RETAIN_DEFAULT_MAX,
77
+ default: RETAIN_DEFAULT_MAX,
71
78
  unit: "count",
72
79
  kind: "retention",
73
80
  summary: "Max retained children per parent run (oldest settled idle evicted beyond it).",
@@ -76,6 +83,7 @@ export function describeConfigCatalog() {
76
83
  {
77
84
  key: "session.idleTtlDays",
78
85
  recommended: SESSION_DEFAULT_TTL_DAYS,
86
+ default: SESSION_DEFAULT_TTL_DAYS,
79
87
  unit: "days",
80
88
  kind: "retention",
81
89
  summary: "Idle TTL before a cached session is evicted from the session store.",
@@ -89,20 +97,21 @@ const MAX_DECLARATION_CHARS = 200;
89
97
  const sanitizeDeclarationText = (s) => s.replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, "").slice(0, MAX_DECLARATION_CHARS);
90
98
  export function resolveEffectiveConfig(spec, ctx) {
91
99
  const l = spec.limits;
92
- const pick = (key, specVal, dflt) => specVal !== undefined ? { key, value: specVal, provenance: "spec" } : { key, value: dflt, provenance: "default" };
100
+ const defaults = new Map(describeConfigCatalog().knobs.flatMap((k) => (k.default !== undefined ? [[k.key, k.default]] : [])));
101
+ const pick = (key, specVal) => specVal !== undefined ? { key, value: specVal, provenance: "spec" } : { key, value: defaults.get(key) ?? null, provenance: "default" };
93
102
  const maxOutputTokens = l?.maxOutputTokens !== undefined
94
103
  ? { key: "limits.maxOutputTokens", value: l.maxOutputTokens, provenance: "spec" }
95
104
  : ctx?.modelMaxTokens !== undefined
96
105
  ? { key: "limits.maxOutputTokens", value: ctx.modelMaxTokens, provenance: "derived" }
97
106
  : { key: "limits.maxOutputTokens", value: null, provenance: "default" };
98
107
  const fields = [
99
- pick("limits.maxTurns", l?.maxTurns, null),
100
- pick("limits.maxWalltimeMs", l?.maxWalltimeMs, null),
108
+ pick("limits.maxTurns", l?.maxTurns),
109
+ pick("limits.maxWalltimeMs", l?.maxWalltimeMs),
101
110
  maxOutputTokens,
102
- pick("limits.maxCostUsd", l?.maxCostUsd, null),
103
- pick("limits.maxTokens", l?.maxTokens, null),
104
- pick("budget.totalTokens", spec.resourceSuspend?.totalTokens, null),
105
- pick("budget.totalBudgetUsd", spec.resourceSuspend?.totalBudgetUsd, null),
111
+ pick("limits.maxCostUsd", l?.maxCostUsd),
112
+ pick("limits.maxTokens", l?.maxTokens),
113
+ pick("budget.totalTokens", spec.resourceSuspend?.totalTokens),
114
+ pick("budget.totalBudgetUsd", spec.resourceSuspend?.totalBudgetUsd),
106
115
  ];
107
116
  for (const d of (spec.configOverrides ?? []).slice(0, MAX_OVERRIDE_DECLARATIONS)) {
108
117
  fields.push({
@@ -2,9 +2,10 @@ import type { AgentTool } from "../internal/harness-types.js";
2
2
  import { type CredentialEchoSite } from "./credential-echo.js";
3
3
  import { type PeerSeat } from "./peer-seat.js";
4
4
  import { type HostFloor } from "./host-floor.js";
5
+ import { type ProtocolRevocationLedger, type RevocationProbe } from "./protocol-revocation.js";
5
6
  import { type McpFailureFields } from "./mcp-failure.js";
6
7
  import type { A2aServerSpec, ToolEffect } from "./types.js";
7
- /** The hard per-skill description bound (ruled 2026-08-03: ~2KiB). */
8
+ /** The hard per-skill description bound (ruled 2026-08-03: ~2KiB), counted in code points — the unit every cut in the description is made in. */
8
9
  export declare const A2A_SKILL_DESCRIPTION_MAX_CHARS = 2048;
9
10
  /**
10
11
  * The safety axes carried alongside one materialized A2A tool, for `prepare-task` to fold into the SAME
@@ -56,12 +57,16 @@ export interface A2aRefreshResult extends Partial<McpFailureFields> {
56
57
  /** The peer's namespaced-name prefix — the consumer's SPLICE DOMAIN for a wholesale swap (the same
57
58
  * self-healing prefix domain the MCP refresh receipt hands out). Present on every entry. */
58
59
  prefix: string;
59
- status: "refreshed" | "failed" | "disposed";
60
+ /** `revoked`: the revocation ledger answered the peer revoked, so its card was not asked for and its tools stay as they were. */
61
+ status: "refreshed" | "failed" | "disposed" | "revoked";
60
62
  toolCount: number;
61
63
  added: string[];
62
64
  removed: string[];
63
65
  tools?: AgentTool[];
64
66
  axes?: A2aToolAxis[];
67
+ /** On a `refreshed` entry whose peer was mounted from its public card although the card offers an extended one: the same warning
68
+ * {@link MaterializedA2a.warnings} carries at the first mount (`a2a.extended_card_unavailable`). Present only when there is one. */
69
+ warnings?: Error[];
65
70
  error?: string;
66
71
  }
67
72
  /**
@@ -76,7 +81,14 @@ export interface MaterializedA2a {
76
81
  tools: AgentTool[];
77
82
  toolAxes: A2aToolAxis[];
78
83
  /** One entry per peer that could not be materialized and was SKIPPED (fail-open, design/29): the task
79
- * runs with the healthy peers' tools. The Runner forwards these to `onError(phase:"a2a")`. */
84
+ * runs with the healthy peers' tools — `code: "a2a.peer_unavailable"`, the refusal as its `cause`. A peer that DID mount adds one
85
+ * entry when its public card offers an authenticated extended card that could not be used: it is mounted from the public card —
86
+ * `code: "a2a.extended_card_unavailable"`, `reason` one of `no_credentials` (a send to the endpoint would carry nothing — no seat piece, no principal — or the
87
+ * seat did not furnish it, so the extended card was not asked for), `http_<status>` (the peer answered that status), `malformed` (it answered 2xx with something
88
+ * that is not a card: not JSON, not a JSON-RPC response, an error member, a result that is not an object) or `unreachable` (no
89
+ * answer: a transport failure, the deadline, or a send the hop judge or the endpoint judge did not make), the failure as its
90
+ * `cause` when there is one. A peer whose card does not offer one has no entry. The Runner forwards these to
91
+ * `onError(phase:"a2a")`. */
80
92
  warnings: Error[];
81
93
  /** One entry per DECLARED peer, in declaration order, ready or failed — the declaration as this materialization read it once. */
82
94
  statuses: A2aPeerStatus[];
@@ -108,4 +120,10 @@ export declare class A2aRpcError extends Error {
108
120
  * `allSettled` keeps it fail-open: one unreachable peer is a skipped peer with a warning, never a task
109
121
  * that cannot start.
110
122
  */
111
- export declare function materializeA2aTools(specs: readonly A2aServerSpec[], principal?: string, signal?: AbortSignal, hostFloor?: HostFloor, given?: PeerSeat, onCredentialEchoed?: (peer: string, where: CredentialEchoSite) => void): Promise<MaterializedA2a>;
123
+ export declare function materializeA2aTools(specs: readonly A2aServerSpec[], principal?: string, signal?: AbortSignal, hostFloor?: HostFloor, given?: PeerSeat, onCredentialEchoed?: (peer: string, where: CredentialEchoSite) => void, // once per peer: its card echoed the credentials its sends carried (the runner's notice)
124
+ revocations?: ProtocolRevocationLedger & {
125
+ onProbeFailure?: (error: unknown) => void;
126
+ }): Promise<MaterializedA2a>;
127
+ /** The runner's materialization of one leg's peers (not index-exported): the seat as the runner received it, and the leg's ONE revocation
128
+ * probe — the one its MCP materialization asks too (a broken ledger is told once per leg). */
129
+ export declare function materializeLegA2aTools(revocations: RevocationProbe | undefined, specs: readonly A2aServerSpec[], principal: string | undefined, signal: AbortSignal | undefined, hostFloor: HostFloor | undefined, peerSeat: PeerSeat | undefined, onCredentialEchoed: ((peer: string, where: CredentialEchoSite) => void) | undefined): Promise<MaterializedA2a>;
package/dist/core/a2a.js CHANGED
@@ -1,16 +1,18 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import { Type } from "typebox";
3
3
  import { A2A_TASK_STATES } from "./a2a-task-state.js";
4
- import { assertEndpointBound, carriesDeclaredHeaders, resolveProtocolHttpHeaders, underDeclaredHeaders } from "./protocol-http-auth.js";
4
+ import { assertEndpointBound, carriesDeclaredHeaders, eraseSentCredentials, resolveProtocolHttpHeaders, underDeclaredHeaders } from "./protocol-http-auth.js";
5
5
  import { carrierEcho, echoAnnouncer, erasedEcho, nameEchoes } from "./credential-echo.js";
6
- import { PeerCarrier, carriedHttpHeaders, peerSeatMissing, receivePeerSeat } from "./peer-seat.js";
6
+ import { NO_PIECES, PeerCarrier, PeerSeatFailure, carriedHttpHeaders, peerSeatMissing, receivePeerSeat } from "./peer-seat.js";
7
7
  import { fetchFollowing, hopRefusal, HOST_FLOOR_REFUSED_CODE } from "./host-floor.js";
8
+ import { ProtocolRevokedRefusal, REVOKED_PEER_CODES, libraryRevocationProbe } from "./protocol-revocation.js";
9
+ import { revokedCallResult } from "./mcp-server-link.js";
8
10
  import { classifyMcpFailure, describeHttpTransportFailure, failureFields } from "./mcp-failure.js";
9
11
  import { findNamespacePrefixCollision, mintNamespacePrefix, mintNamespacedToolName } from "./protocol-naming.js";
10
12
  import { A2A_NAMESPACE } from "./protocol-table.js";
11
13
  import { judgeEntryToolAxes, refusedDeclarer, snapshotDeclaredEntry } from "./locked-config.js";
12
- import { delimitUntrusted, inlineUntrusted } from "./untrusted-text.js";
13
- import { thrownText } from "./thrown-value.js";
14
+ import { INLINE_TRUNCATION_MARK_CODEPOINTS, delimitUntrusted, inlineUntrusted } from "./untrusted-text.js";
15
+ import { codedRefusal, thrownText } from "./thrown-value.js";
14
16
  import { boundaryFlowFace } from "./cross-boundary-taint.js";
15
17
  const A2A_REQUEST_TIMEOUT_MS = 30_000;
16
18
  const A2A_CARD_TIMEOUT_MS = 10_000;
@@ -21,17 +23,30 @@ const A2A_POLL_MAX_DELAY_MS = 5_000;
21
23
  const A2A_POLL_BACKOFF_FACTOR = 2;
22
24
  const A2A_RESPONSE_MAX_BYTES = 8 * 1024 * 1024;
23
25
  const A2A_SKILL_NAME_MAX_CHARS = 200;
24
- const A2A_SKILL_TEXT_MAX_CHARS = 1_200;
25
26
  const A2A_SKILL_TAGS_MAX_CHARS = 240;
26
27
  const A2A_SKILL_EXAMPLES_MAX_CHARS = 320;
27
28
  export const A2A_SKILL_DESCRIPTION_MAX_CHARS = 2_048;
29
+ const A2A_PEER_SKILLS_MAX = 128;
28
30
  const A2A_CARD_NAME_MAX_CHARS = 160;
29
31
  const A2A_CARD_DESCRIPTION_MAX_CHARS = 240;
30
32
  const A2A_ID_MAX_CHARS = 160;
33
+ const SKILL_HEAD_BEFORE_PEER = 'Ask the remote agent "';
34
+ const SKILL_HEAD_BETWEEN = '" to perform its "';
35
+ const SKILL_HEAD_AFTER_TITLE = '" skill.';
36
+ const SKILL_TAGS_LABEL = "Tags: ";
37
+ const SKILL_EXAMPLES_LABEL = "Examples: ";
38
+ const SKILL_TAIL = "The agent acts on its own side; its reply is returned as untrusted external data.";
39
+ const SKILL_DESCRIPTION_LINES_MAX = 5;
40
+ const SKILL_SKELETON_CHARS = SKILL_HEAD_BEFORE_PEER.length + SKILL_HEAD_BETWEEN.length + SKILL_HEAD_AFTER_TITLE.length + SKILL_TAGS_LABEL.length + SKILL_EXAMPLES_LABEL.length + SKILL_TAIL.length + (SKILL_DESCRIPTION_LINES_MAX - 1);
41
+ const cutReads = (width) => width + INLINE_TRUNCATION_MARK_CODEPOINTS;
42
+ const A2A_SKILL_TEXT_MAX_CHARS = A2A_SKILL_DESCRIPTION_MAX_CHARS -
43
+ (SKILL_SKELETON_CHARS + cutReads(A2A_ID_MAX_CHARS) + cutReads(A2A_SKILL_NAME_MAX_CHARS) + cutReads(A2A_SKILL_TAGS_MAX_CHARS) + cutReads(A2A_SKILL_EXAMPLES_MAX_CHARS)) -
44
+ INLINE_TRUNCATION_MARK_CODEPOINTS;
31
45
  const A2A_RESULT_BODY_MAX_CHARS = 100_000;
32
46
  const A2A_ERROR_TEXT_MAX_CHARS = 240;
33
47
  const A2A_RESULT_FENCE_REASON = "the peer is an agent acting on its own, so its output is worker text, not tool data";
34
48
  const A2A_CARD_PATHS = ["/.well-known/agent-card.json", "/.well-known/agent.json"];
49
+ const A2A_EXTENDED_CARD_METHOD = "agent/getAuthenticatedExtendedCard";
35
50
  const A2A_PROTOCOL_VERSION = "1.0";
36
51
  const A2A_JSONRPC_TRANSPORT = "JSONRPC";
37
52
  const A2A_ERROR_CODE_NAMES = new Map([
@@ -83,6 +98,14 @@ function safeId(v) {
83
98
  return undefined;
84
99
  return inlineUntrusted(s, A2A_ID_MAX_CHARS);
85
100
  }
101
+ function peerHopRefusal(t, url) {
102
+ if (t.revocations?.({ protocol: "a2a", peer: t.peer }) === true)
103
+ return { reason: "the peer was revoked by the operator", code: REVOKED_PEER_CODES.a2a };
104
+ return hopRefusal(url, t.floor, false);
105
+ }
106
+ function carriedBy(t, pieces) {
107
+ return carriedHttpHeaders(A2A_NAMESPACE.id, t.carrier, pieces, t.principalHeader, t.principal);
108
+ }
86
109
  const A2A_MAX_REDIRECTS = 20;
87
110
  function withRequestDeadline(outer, timeoutMs) {
88
111
  const controller = new AbortController();
@@ -153,7 +176,11 @@ async function requestJson(t, what, init) {
153
176
  const deadline = withRequestDeadline(init.signal, init.timeoutMs);
154
177
  const peerLabel = inlineUntrusted(t.peer, A2A_ID_MAX_CHARS);
155
178
  const pieces = await t.carrier.next(init.signal, init.url);
156
- const carried = carriedHttpHeaders(A2A_NAMESPACE.id, t.carrier, pieces, t.principalHeader, t.principal);
179
+ const carried = carriedBy(t, pieces);
180
+ if (init.needsCarried === true && !carriesDeclaredHeaders(carried === undefined ? undefined : { ...carried })) {
181
+ deadline.dispose();
182
+ throw new A2aNothingCarried(`a2a: ${what} on peer "${peerLabel}" is not sent — nothing this peer's sends carry (the peer seat's pieces, the principal header) would authenticate it for this destination`);
183
+ }
157
184
  assertEndpointBound(A2A_NAMESPACE.id, t.peer, init.url, t.declared, carried === undefined ? undefined : { ...carried });
158
185
  try {
159
186
  const followed = await fetchFollowing(doFetch, new URL(init.url), {
@@ -161,9 +188,13 @@ async function requestJson(t, what, init) {
161
188
  headers: underDeclaredHeaders({ accept: "application/json", "a2a-version": A2A_PROTOCOL_VERSION, ...(init.body !== undefined ? { "content-type": "application/json" } : {}) }, carried === undefined ? undefined : { ...carried }),
162
189
  ...(init.body !== undefined ? { body: init.body } : {}),
163
190
  signal: deadline.signal,
164
- }, { refusal: (url) => hopRefusal(url, t.floor, false), follows: () => !carriesDeclaredHeaders(carried === undefined ? undefined : { ...carried }), maxRedirects: A2A_MAX_REDIRECTS });
165
- if (followed.kind === "refused")
166
- throw Object.assign(new Error(`a2a: ${what} on peer "${peerLabel}" is not sent — ${followed.reason}`), { code: HOST_FLOOR_REFUSED_CODE });
191
+ }, { refusal: (url) => peerHopRefusal(t, url), follows: () => !carriesDeclaredHeaders(carried === undefined ? undefined : { ...carried }), maxRedirects: A2A_MAX_REDIRECTS });
192
+ if (followed.kind === "refused" && followed.code === REVOKED_PEER_CODES.a2a)
193
+ throw new ProtocolRevokedRefusal({ protocol: "a2a", peer: t.peer }, followed.afterSentHop);
194
+ if (followed.kind === "refused") {
195
+ const reason = eraseSentCredentials(followed.reason, Object.values(carried ?? {}));
196
+ throw codedRefusal(HOST_FLOOR_REFUSED_CODE, `a2a: ${what} on peer "${peerLabel}" is not sent — ${reason}`);
197
+ }
167
198
  if (followed.kind === "too_many")
168
199
  throw new Error(`a2a: ${what} on peer "${peerLabel}" was redirected more than ${A2A_MAX_REDIRECTS} times`);
169
200
  const res = followed.res;
@@ -188,36 +219,46 @@ async function requestJson(t, what, init) {
188
219
  deadline.dispose();
189
220
  }
190
221
  }
191
- async function jsonRpc(t, method, params, signal, timeoutMs = A2A_REQUEST_TIMEOUT_MS) {
222
+ class A2aNothingCarried extends Error {
223
+ }
224
+ class A2aBadAnswer extends Error {
225
+ status;
226
+ constructor(message, status, options) {
227
+ super(message, options);
228
+ this.status = status;
229
+ }
230
+ }
231
+ async function jsonRpc(t, method, params, signal, timeoutMs = A2A_REQUEST_TIMEOUT_MS, needsCarried = false) {
192
232
  const peerLabel = inlineUntrusted(t.peer, A2A_ID_MAX_CHARS);
193
233
  const { status, text } = await requestJson(t, method, {
194
234
  method: "POST",
195
235
  url: t.endpoint,
196
- body: JSON.stringify({ jsonrpc: "2.0", id: randomUUID(), method, params }),
236
+ body: JSON.stringify({ jsonrpc: "2.0", id: randomUUID(), method, ...(params !== undefined ? { params } : {}) }),
197
237
  timeoutMs,
238
+ ...(needsCarried ? { needsCarried } : {}),
198
239
  ...(signal !== undefined ? { signal } : {}),
199
240
  });
200
241
  if (status < 200 || status >= 300) {
201
- throw new Error(`a2a: peer "${peerLabel}" answered ${status} to ${method} instead of a JSON-RPC response`);
242
+ throw new A2aBadAnswer(`a2a: peer "${peerLabel}" answered ${status} to ${method} instead of a JSON-RPC response`, status);
202
243
  }
203
244
  let parsed;
204
245
  try {
205
246
  parsed = JSON.parse(text);
206
247
  }
207
248
  catch (err) {
208
- throw new Error(`a2a: peer "${peerLabel}" answered ${method} with a body that is not JSON`, { cause: err });
249
+ throw new A2aBadAnswer(`a2a: peer "${peerLabel}" answered ${method} with a body that is not JSON`, undefined, { cause: err });
209
250
  }
210
251
  const envelope = asRecord(parsed);
211
252
  if (envelope === undefined) {
212
- throw new Error(`a2a: peer "${peerLabel}" answered ${method} with a JSON value that is not a JSON-RPC envelope`);
253
+ throw new A2aBadAnswer(`a2a: peer "${peerLabel}" answered ${method} with a JSON value that is not a JSON-RPC envelope`);
213
254
  }
214
255
  const errorMember = asRecord(envelope["error"]);
215
256
  if (errorMember !== undefined) {
216
257
  const code = errorMember["code"];
217
- throw new A2aRpcError(t.peer, method, typeof code === "number" ? code : -32603, asString(errorMember["message"]) ?? "(no message)");
258
+ throw new A2aRpcError(t.peer, method, typeof code === "number" ? code : -32603, eraseSentCredentials(asString(errorMember["message"]) ?? "(no message)", [...t.carrier.credentials, ...t.carrier.sent]));
218
259
  }
219
260
  if (!("result" in envelope)) {
220
- throw new Error(`a2a: peer "${peerLabel}" answered ${method} with neither a result nor an error member`);
261
+ throw new A2aBadAnswer(`a2a: peer "${peerLabel}" answered ${method} with neither a result nor an error member`);
221
262
  }
222
263
  return envelope["result"];
223
264
  }
@@ -291,15 +332,46 @@ function readCard(peer, body, fallbackUrl, echo) {
291
332
  if (card === undefined) {
292
333
  throw new Error(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}" served an agent card that is not a JSON object`);
293
334
  }
335
+ const skills = readSkills(peer, card, echo);
336
+ const name = asString(card["name"]);
337
+ const nameHolds = name !== undefined && nameEchoes(name, echo, "agent_card");
338
+ const description = erasedEcho(asString(card["description"]), echo, "agent_card");
339
+ return {
340
+ ...(name !== undefined && !nameHolds ? { name: inlineUntrusted(name, A2A_CARD_NAME_MAX_CHARS) } : {}),
341
+ ...(description !== undefined ? { description: inlineUntrusted(description, A2A_CARD_DESCRIPTION_MAX_CHARS) } : {}),
342
+ endpoint: negotiateEndpoint(peer, card, fallbackUrl, echo),
343
+ skills,
344
+ extendedCard: card["supportsAuthenticatedExtendedCard"] === true,
345
+ };
346
+ }
347
+ function assertSkillCount(peer, count, whose) {
348
+ if (count <= A2A_PEER_SKILLS_MAX)
349
+ return;
350
+ throw new A2aBadAnswer(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}": ${whose} ${count} skills — this client mounts at most ${A2A_PEER_SKILLS_MAX} per peer and refuses the card rather than cut the list`);
351
+ }
352
+ function readSkills(peer, card, echo) {
353
+ const listed = card["skills"];
354
+ const entries = listed === undefined ? [] : asArray(listed);
355
+ if (entries === undefined) {
356
+ throw new A2aBadAnswer(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}": its card's skills are not a list (${listed === null ? "null" : typeof listed})`);
357
+ }
358
+ assertSkillCount(peer, entries.length, "its card lists");
294
359
  const text = (raw) => erasedEcho(raw, echo, "agent_card");
295
360
  const skills = [];
296
- for (const entry of asArray(card["skills"]) ?? []) {
361
+ const named = new Set();
362
+ for (const [index, entry] of entries.entries()) {
297
363
  const rec = asRecord(entry);
298
- if (rec === undefined)
299
- continue;
300
- const id = asString(rec["id"]);
301
- if (id === undefined || id === "" || nameEchoes(id, echo, "agent_card"))
364
+ const id = rec === undefined ? undefined : asString(rec["id"]);
365
+ if (rec === undefined || id === undefined || id === "") {
366
+ const why = rec === undefined ? "it is not an object" : id === undefined ? "it has no string id" : "its id is empty";
367
+ throw new A2aBadAnswer(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}": its card's skills list holds an entry that names no skill (entry ${index + 1}: ${why}) — an id names the skill a peer offers, and this client refuses the card rather than mount part of what it says`);
368
+ }
369
+ if (nameEchoes(id, echo, "agent_card"))
302
370
  continue;
371
+ if (named.has(id)) {
372
+ throw new A2aBadAnswer(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}": its card lists the id "${inlineUntrusted(id, A2A_SKILL_NAME_MAX_CHARS)}" more than once among its skills — ids on a card are unique, and this client refuses the card rather than choose between the entries`);
373
+ }
374
+ named.add(id);
303
375
  const tags = (asArray(rec["tags"]) ?? []).filter((v) => typeof v === "string").map((v) => text(v));
304
376
  const examples = (asArray(rec["examples"]) ?? []).filter((v) => typeof v === "string").map((v) => text(v));
305
377
  const name = text(asString(rec["name"]));
@@ -312,15 +384,7 @@ function readCard(peer, body, fallbackUrl, echo) {
312
384
  ...(examples.length > 0 ? { examples } : {}),
313
385
  });
314
386
  }
315
- const name = asString(card["name"]);
316
- const nameHolds = name !== undefined && nameEchoes(name, echo, "agent_card");
317
- const description = text(asString(card["description"]));
318
- return {
319
- ...(name !== undefined && !nameHolds ? { name: inlineUntrusted(name, A2A_CARD_NAME_MAX_CHARS) } : {}),
320
- ...(description !== undefined ? { description: inlineUntrusted(description, A2A_CARD_DESCRIPTION_MAX_CHARS) } : {}),
321
- endpoint: negotiateEndpoint(peer, card, fallbackUrl, echo),
322
- skills,
323
- };
387
+ return skills;
324
388
  }
325
389
  function a2aToolParameters() {
326
390
  return Type.Object({
@@ -331,15 +395,15 @@ function a2aToolParameters() {
331
395
  }
332
396
  function skillDescription(peerLabel, skill) {
333
397
  const lines = [];
334
- const title = skill.name !== undefined ? inlineUntrusted(skill.name, A2A_SKILL_NAME_MAX_CHARS) : skill.id;
335
- lines.push(`Ask the remote agent "${peerLabel}" to perform its "${title}" skill.`);
398
+ const title = inlineUntrusted(skill.name ?? skill.id, A2A_SKILL_NAME_MAX_CHARS);
399
+ lines.push(`${SKILL_HEAD_BEFORE_PEER}${peerLabel}${SKILL_HEAD_BETWEEN}${title}${SKILL_HEAD_AFTER_TITLE}`);
336
400
  if (skill.description !== undefined)
337
401
  lines.push(inlineUntrusted(skill.description, A2A_SKILL_TEXT_MAX_CHARS));
338
402
  if (skill.tags !== undefined)
339
- lines.push(`Tags: ${inlineUntrusted(skill.tags.join(", "), A2A_SKILL_TAGS_MAX_CHARS)}`);
403
+ lines.push(`${SKILL_TAGS_LABEL}${inlineUntrusted(skill.tags.join(", "), A2A_SKILL_TAGS_MAX_CHARS)}`);
340
404
  if (skill.examples !== undefined)
341
- lines.push(`Examples: ${inlineUntrusted(skill.examples.join(" | "), A2A_SKILL_EXAMPLES_MAX_CHARS)}`);
342
- lines.push("The agent acts on its own side; its reply is returned as untrusted external data.");
405
+ lines.push(`${SKILL_EXAMPLES_LABEL}${inlineUntrusted(skill.examples.join(" | "), A2A_SKILL_EXAMPLES_MAX_CHARS)}`);
406
+ lines.push(SKILL_TAIL);
343
407
  return lines.join("\n");
344
408
  }
345
409
  function a2aAxisFor(name, override) {
@@ -430,6 +494,21 @@ function continuationLine(taskId, contextId) {
430
494
  keys.push(`contextId ${contextId}`);
431
495
  return keys.length > 0 ? ` Continue it by calling this tool again with ${keys.join(" and ")}.` : "";
432
496
  }
497
+ function unknownOutcomeLine(taskId, contextId) {
498
+ const keys = [];
499
+ if (taskId !== undefined)
500
+ keys.push(`taskId ${taskId}`);
501
+ if (contextId !== undefined)
502
+ keys.push(`contextId ${contextId}`);
503
+ return ` Do not send the request again — it may already be done or still running, and this tool has no read-only way to ask after it${keys.length > 0 ? ` (${keys.join(" and ")})` : ""}.`;
504
+ }
505
+ function skillCallWhat(skillId) {
506
+ return `The call to skill ${inlineUntrusted(skillId, A2A_ID_MAX_CHARS)}`;
507
+ }
508
+ function revokedSkillCall(refusal, skillId, accepted) {
509
+ const answer = revokedCallResult(refusal, skillCallWhat(skillId), accepted);
510
+ return { ...answer, details: { type: "a2a", ...answer.details } };
511
+ }
433
512
  function delay(ms, signal) {
434
513
  return new Promise((resolve) => {
435
514
  const timer = setTimeout(() => {
@@ -458,7 +537,7 @@ async function awaitTaskOutcome(t, peerLabel, skillId, firstTask, signal) {
458
537
  let pollDelayMs = A2A_POLL_FIRST_DELAY_MS;
459
538
  for (;;) {
460
539
  if ("unrecognized" in observed) {
461
- throw new Error(`a2a: peer "${peerLabel}" reported task state ${JSON.stringify(inlineUntrusted(observed.unrecognized, A2A_ID_MAX_CHARS))} for skill "${inlineUntrusted(skillId, A2A_ID_MAX_CHARS)}", which is not a state this client knows. The outcome is UNKNOWN.${continuationLine(safeId(task["id"]), safeId(task["contextId"]))}`);
540
+ throw new Error(`a2a: peer "${peerLabel}" reported task state ${JSON.stringify(inlineUntrusted(observed.unrecognized, A2A_ID_MAX_CHARS))} for skill "${inlineUntrusted(skillId, A2A_ID_MAX_CHARS)}", which is not a state this client knows. The outcome is UNKNOWN.${unknownOutcomeLine(safeId(task["id"]), safeId(task["contextId"]))}`);
462
541
  }
463
542
  const state = observed.state;
464
543
  const taskId = safeId(task["id"]);
@@ -491,20 +570,23 @@ async function awaitTaskOutcome(t, peerLabel, skillId, firstTask, signal) {
491
570
  }
492
571
  const now = Date.now();
493
572
  if (now - startedAt >= A2A_CALL_TOTAL_TIMEOUT_MS) {
494
- throw new Error(`a2a: the remote agent "${peerLabel}" was still ${state} after ${Math.round((now - startedAt) / 1000)}s (ceiling ${A2A_CALL_TOTAL_TIMEOUT_MS}ms). The client stopped waiting; the agent is still acting, so treat the outcome as UNKNOWN.${continuationLine(taskId, contextId)}`);
573
+ throw new Error(`a2a: the remote agent "${peerLabel}" was still ${state} after ${Math.round((now - startedAt) / 1000)}s (ceiling ${A2A_CALL_TOTAL_TIMEOUT_MS}ms). The client stopped waiting; the agent is still acting, so treat the outcome as UNKNOWN.${unknownOutcomeLine(taskId, contextId)}`);
495
574
  }
496
575
  if (now - idleSince >= A2A_STATE_IDLE_TIMEOUT_MS) {
497
- throw new Error(`a2a: the remote agent "${peerLabel}" answered every poll but never left state ${state} for ${A2A_STATE_IDLE_TIMEOUT_MS}ms. The client stopped waiting; treat the outcome as UNKNOWN.${continuationLine(taskId, contextId)}`);
576
+ throw new Error(`a2a: the remote agent "${peerLabel}" answered every poll but never left state ${state} for ${A2A_STATE_IDLE_TIMEOUT_MS}ms. The client stopped waiting; treat the outcome as UNKNOWN.${unknownOutcomeLine(taskId, contextId)}`);
498
577
  }
499
578
  await delay(pollDelayMs, signal);
500
579
  if (signal?.aborted === true)
501
- throw new Error(`a2a: the call to "${peerLabel}" was aborted while waiting for the remote agent.${continuationLine(taskId, contextId)}`);
580
+ throw new Error(`a2a: the call to "${peerLabel}" was aborted while waiting for the remote agent.${unknownOutcomeLine(taskId, contextId)}`);
502
581
  pollDelayMs = Math.min(pollDelayMs * A2A_POLL_BACKOFF_FACTOR, A2A_POLL_MAX_DELAY_MS);
503
582
  const rawId = asString(task["id"]);
504
583
  if (rawId === undefined) {
505
584
  throw new Error(`a2a: the remote agent "${peerLabel}" returned a non-terminal task with no id, so it cannot be polled. The outcome is UNKNOWN.`);
506
585
  }
507
- const polled = asRecord(await jsonRpc(t, "tasks/get", { id: rawId }, signal));
586
+ const asked = await jsonRpc(t, "tasks/get", { id: rawId }, signal).catch((err) => (err instanceof ProtocolRevokedRefusal ? err : Promise.reject(err)));
587
+ if (asked instanceof ProtocolRevokedRefusal)
588
+ return revokedSkillCall(asked, skillId, { taskId });
589
+ const polled = asRecord(asked);
508
590
  if (polled === undefined) {
509
591
  throw new Error(`a2a: peer "${peerLabel}" answered tasks/get with something that is not a task object`);
510
592
  }
@@ -545,7 +627,9 @@ function buildSkillTool(spec, t, skill, lifecycle) {
545
627
  ...(contextId !== undefined && contextId !== "" ? { contextId } : {}),
546
628
  },
547
629
  configuration: { blocking: true },
548
- }, signal);
630
+ }, signal).catch((err) => (err instanceof ProtocolRevokedRefusal ? err : Promise.reject(err)));
631
+ if (result instanceof ProtocolRevokedRefusal)
632
+ return revokedSkillCall(result, skill.id);
549
633
  const answer = asRecord(result);
550
634
  if (answer === undefined) {
551
635
  throw new Error(`a2a: peer "${peerLabel}" answered message/send with something that is not a protocol object`);
@@ -566,6 +650,51 @@ function buildSkillTool(spec, t, skill, lifecycle) {
566
650
  },
567
651
  };
568
652
  }
653
+ function extendedCardReasonOf(err) {
654
+ if (err instanceof A2aNothingCarried || err instanceof PeerSeatFailure)
655
+ return "no_credentials";
656
+ if (err instanceof A2aBadAnswer)
657
+ return err.status !== undefined ? `http_${err.status}` : "malformed";
658
+ if (err instanceof A2aRpcError)
659
+ return "malformed";
660
+ return "unreachable";
661
+ }
662
+ function readFailure(err, detail) {
663
+ const code = err?.code;
664
+ return Object.assign(new Error(detail), { name: err instanceof Error ? err.name : "Error", ...(typeof code === "string" || typeof code === "number" ? { code } : {}) });
665
+ }
666
+ function extendedCardWarning(peer, reason, detail, cause) {
667
+ const warning = new Error(`a2a: peer "${inlineUntrusted(peer, A2A_ID_MAX_CHARS)}" is mounted from its public agent card — its authenticated extended card is unavailable (${reason}): ${detail}`, cause !== undefined ? { cause } : undefined);
668
+ warning.code = "a2a.extended_card_unavailable";
669
+ warning.reason = reason;
670
+ return warning;
671
+ }
672
+ function mergeSkillsById(base, extended) {
673
+ const named = new Map();
674
+ for (const skill of extended)
675
+ named.set(skill.id, skill);
676
+ const held = new Set(base.map((skill) => skill.id));
677
+ return [...base.map((skill) => named.get(skill.id) ?? skill), ...[...named.values()].filter((skill) => !held.has(skill.id))];
678
+ }
679
+ async function mergeExtendedCard(t, card, echo, signal) {
680
+ if (!card.extendedCard)
681
+ return { skills: card.skills, warnings: [] };
682
+ try {
683
+ const answered = asRecord(await jsonRpc(t, A2A_EXTENDED_CARD_METHOD, undefined, signal, A2A_CARD_TIMEOUT_MS, true));
684
+ if (answered === undefined) {
685
+ throw new A2aBadAnswer(`a2a: peer "${inlineUntrusted(t.peer, A2A_ID_MAX_CHARS)}" answered ${A2A_EXTENDED_CARD_METHOD} with a result that is not a JSON object`);
686
+ }
687
+ const merged = mergeSkillsById(card.skills, readSkills(t.peer, answered, echo));
688
+ assertSkillCount(t.peer, merged.length, "its extended card brings it to");
689
+ return { skills: merged, warnings: [] };
690
+ }
691
+ catch (err) {
692
+ if (signal?.aborted === true || err instanceof ProtocolRevokedRefusal)
693
+ throw err;
694
+ const detail = inlineUntrusted(thrownText(err), A2A_ERROR_TEXT_MAX_CHARS);
695
+ return { skills: card.skills, warnings: [extendedCardWarning(t.peer, extendedCardReasonOf(err), detail, readFailure(err, detail))] };
696
+ }
697
+ }
569
698
  function declaredPeerOf(declared, index) {
570
699
  let snapshot;
571
700
  try {
@@ -577,7 +706,7 @@ function declaredPeerOf(declared, index) {
577
706
  const judged = judgeEntryToolAxes(snapshot, "a2a");
578
707
  return judged.ok ? { spec: judged.entry } : { spec: snapshot, refusal: judged.error };
579
708
  }
580
- async function materializePeer(peer, principal, lifecycle, signal, floor, seat, announceEcho) {
709
+ async function materializePeer(peer, principal, lifecycle, signal, floor, seat, announceEcho, revocations) {
581
710
  if ("refusal" in peer)
582
711
  throw peer.refusal;
583
712
  const { spec } = peer;
@@ -589,14 +718,17 @@ async function materializePeer(peer, principal, lifecycle, signal, floor, seat,
589
718
  const declared = spec.cardUrl === undefined ? [spec.url] : [spec.url, spec.cardUrl];
590
719
  const identity = { protocol: "a2a", peer: spec.name, url: spec.url, ...(spec.cardUrl !== undefined ? { cardUrl: spec.cardUrl } : {}), destination: spec.url, ...(spec.credentials !== undefined ? { credentials: spec.credentials } : {}) };
591
720
  const carrier = new PeerCarrier(seat, identity, principal, "a2a", spec.principalHeader !== undefined);
592
- const asks = { carrier, principalHeader: spec.principalHeader, principal, declared, floor };
721
+ const asks = { carrier, principalHeader: spec.principalHeader, principal, declared, floor, revocations };
593
722
  const discovery = { peer: spec.name, endpoint: spec.url, ...asks };
594
- const card = readCard(spec.name, await discoverCardBody(spec, discovery, signal), spec.url, carrierEcho(carrier, (where) => announceEcho(spec.name, where)));
595
- assertEndpointBound(A2A_NAMESPACE.id, spec.name, card.endpoint, declared, carrier.last?.headers === undefined ? undefined : { ...carrier.last.headers });
723
+ const echo = carrierEcho(carrier, (where) => announceEcho(spec.name, where));
724
+ const card = readCard(spec.name, await discoverCardBody(spec, discovery, signal), spec.url, echo);
725
+ const carriedAtCard = carriedBy(discovery, carrier.last ?? NO_PIECES);
726
+ assertEndpointBound(A2A_NAMESPACE.id, spec.name, card.endpoint, declared, carriedAtCard === undefined ? undefined : { ...carriedAtCard });
596
727
  const transport = { peer: spec.name, endpoint: card.endpoint, ...asks };
728
+ const mounted = await mergeExtendedCard(transport, card, echo, signal);
597
729
  const tools = [];
598
730
  const skillAxes = [];
599
- for (const skill of card.skills) {
731
+ for (const skill of mounted.skills) {
600
732
  if (spec.allowSkills !== undefined && !spec.allowSkills.includes(skill.id))
601
733
  continue;
602
734
  const declared = declaredAxes?.[skill.id];
@@ -615,6 +747,7 @@ async function materializePeer(peer, principal, lifecycle, signal, floor, seat,
615
747
  endpoint: card.endpoint,
616
748
  toolNames: tools.map((tool) => tool.name),
617
749
  },
750
+ warnings: mounted.warnings,
618
751
  };
619
752
  }
620
753
  function asPeerWarning(spec, err) {
@@ -623,8 +756,10 @@ function asPeerWarning(spec, err) {
623
756
  warning.code = "a2a.peer_unavailable";
624
757
  return warning;
625
758
  }
626
- export async function materializeA2aTools(specs, principal, signal, hostFloor, given, onCredentialEchoed) {
627
- const peerSeat = receivePeerSeat(given, "materializeA2aTools peerSeat");
759
+ export async function materializeA2aTools(specs, principal, signal, hostFloor, given, onCredentialEchoed, revocations) {
760
+ return materializeLegA2aTools(libraryRevocationProbe(revocations, "materializeA2aTools revocations"), specs, principal, signal, hostFloor, receivePeerSeat(given, "materializeA2aTools peerSeat"), onCredentialEchoed);
761
+ }
762
+ export async function materializeLegA2aTools(revocations, specs, principal, signal, hostFloor, peerSeat, onCredentialEchoed) {
628
763
  const peers = specs.map((spec, index) => declaredPeerOf(spec, index));
629
764
  if (peers.length > 0) {
630
765
  const collision = findNamespacePrefixCollision(A2A_NAMESPACE, peers.map((p) => p.spec.name));
@@ -643,7 +778,7 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor, g
643
778
  const warnings = [];
644
779
  const statuses = [];
645
780
  const announceEcho = echoAnnouncer(onCredentialEchoed);
646
- const settled = await Promise.allSettled(peers.map((peer) => materializePeer(peer, principal, lifecycle, signal, hostFloor, peerSeat, announceEcho)));
781
+ const settled = await Promise.allSettled(peers.map((peer) => materializePeer(peer, principal, lifecycle, signal, hostFloor, peerSeat, announceEcho, revocations)));
647
782
  for (let i = 0; i < peers.length; i++) {
648
783
  const spec = peers[i].spec;
649
784
  const outcome = settled[i];
@@ -651,6 +786,7 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor, g
651
786
  tools.push(...outcome.value.tools);
652
787
  toolAxes.push(...outcome.value.axes);
653
788
  statuses.push(outcome.value.status);
789
+ warnings.push(...outcome.value.warnings);
654
790
  }
655
791
  else {
656
792
  warnings.push(asPeerWarning(spec, outcome.reason));
@@ -678,7 +814,7 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor, g
678
814
  }
679
815
  const previous = statuses.find((s) => s.name === spec.name)?.toolNames ?? [];
680
816
  try {
681
- const fresh = await materializePeer(target, principal, lifecycle, signal, hostFloor, peerSeat, announceEcho);
817
+ const fresh = await materializePeer(target, principal, lifecycle, signal, hostFloor, peerSeat, announceEcho, revocations);
682
818
  const names = fresh.tools.map((t) => t.name);
683
819
  results.push({
684
820
  peer: spec.name,
@@ -689,12 +825,17 @@ export async function materializeA2aTools(specs, principal, signal, hostFloor, g
689
825
  removed: previous.filter((n) => !names.includes(n)),
690
826
  tools: fresh.tools,
691
827
  axes: fresh.axes,
828
+ ...(fresh.warnings.length > 0 ? { warnings: fresh.warnings } : {}),
692
829
  });
693
830
  const at = statuses.findIndex((s) => s.name === spec.name);
694
831
  if (at >= 0)
695
832
  statuses[at] = fresh.status;
696
833
  }
697
834
  catch (err) {
835
+ if (err instanceof ProtocolRevokedRefusal) {
836
+ results.push({ peer: spec.name, prefix, status: "revoked", toolCount: previous.length, added: [], removed: [], error: "peer revoked by the operator — the refresh did not contact it" });
837
+ continue;
838
+ }
698
839
  results.push({
699
840
  peer: spec.name,
700
841
  prefix,
@@ -184,7 +184,9 @@ export interface SkillSpec {
184
184
  * active) to the end of that run. A host compiles a frontmatter `hooks:` table into one such registration; the engine
185
185
  * reads no hook grammar. Each hangs `classic.*` events only (any other event refuses the prepare, `config.mods_invalid`).
186
186
  * They are admitted with the leg's other registrations at its prepare (so a skill never activated still counts as a hook
187
- * the leg may run) and stay the leg's own: a delegated child neither dispatches them nor is screened by them.
187
+ * the leg may run) and stay the leg's own: a delegated child neither dispatches them nor is screened by them. The two halves of
188
+ * a skill's frontmatter go different ways at a delegation: a child captures the `allowed-tools` / `disallowed-tools` rows its
189
+ * parent holds at the spawn ({@link allowedTools}, {@link disallowedTools}) and keeps them until it ends — rows go down, hooks stay.
188
190
  */
189
191
  mods?: readonly import("./mods/classic-events.js").EngineModRegistration[];
190
192
  }