@xrkseek/harness 0.4.3 → 0.4.4

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 (378) hide show
  1. package/dist/index.d.ts +1 -1
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +1 -1
  4. package/dist/index.js.map +1 -1
  5. package/node_modules/@xrkseek/a2a/README.md +43 -0
  6. package/node_modules/@xrkseek/a2a/dist/client.d.ts +35 -0
  7. package/node_modules/@xrkseek/a2a/dist/client.d.ts.map +1 -0
  8. package/node_modules/@xrkseek/a2a/dist/client.js +229 -0
  9. package/node_modules/@xrkseek/a2a/dist/client.js.map +1 -0
  10. package/node_modules/@xrkseek/a2a/dist/inbound.d.ts +42 -0
  11. package/node_modules/@xrkseek/a2a/dist/inbound.d.ts.map +1 -0
  12. package/node_modules/@xrkseek/a2a/dist/inbound.js +263 -0
  13. package/node_modules/@xrkseek/a2a/dist/inbound.js.map +1 -0
  14. package/node_modules/@xrkseek/a2a/dist/index.d.ts +6 -0
  15. package/node_modules/@xrkseek/a2a/dist/index.d.ts.map +1 -0
  16. package/node_modules/@xrkseek/a2a/dist/index.js +6 -0
  17. package/node_modules/@xrkseek/a2a/dist/index.js.map +1 -0
  18. package/node_modules/@xrkseek/a2a/dist/peers.d.ts +25 -0
  19. package/node_modules/@xrkseek/a2a/dist/peers.d.ts.map +1 -0
  20. package/node_modules/@xrkseek/a2a/dist/peers.js +90 -0
  21. package/node_modules/@xrkseek/a2a/dist/peers.js.map +1 -0
  22. package/node_modules/@xrkseek/a2a/dist/protocol.d.ts +45 -0
  23. package/node_modules/@xrkseek/a2a/dist/protocol.d.ts.map +1 -0
  24. package/node_modules/@xrkseek/a2a/dist/protocol.js +172 -0
  25. package/node_modules/@xrkseek/a2a/dist/protocol.js.map +1 -0
  26. package/node_modules/@xrkseek/a2a/dist/tools.d.ts +10 -0
  27. package/node_modules/@xrkseek/a2a/dist/tools.d.ts.map +1 -0
  28. package/node_modules/@xrkseek/a2a/dist/tools.js +145 -0
  29. package/node_modules/@xrkseek/a2a/dist/tools.js.map +1 -0
  30. package/node_modules/@xrkseek/a2a/package.json +28 -0
  31. package/node_modules/@xrkseek/attachment/README.md +23 -17
  32. package/node_modules/@xrkseek/attachment/dist/image-tokens.d.ts +30 -0
  33. package/node_modules/@xrkseek/attachment/dist/image-tokens.d.ts.map +1 -0
  34. package/node_modules/@xrkseek/attachment/dist/image-tokens.js +142 -0
  35. package/node_modules/@xrkseek/attachment/dist/image-tokens.js.map +1 -0
  36. package/node_modules/@xrkseek/attachment/dist/index.d.ts +2 -0
  37. package/node_modules/@xrkseek/attachment/dist/index.d.ts.map +1 -1
  38. package/node_modules/@xrkseek/attachment/dist/index.js +2 -0
  39. package/node_modules/@xrkseek/attachment/dist/index.js.map +1 -1
  40. package/node_modules/@xrkseek/attachment/dist/request-projection.d.ts +20 -0
  41. package/node_modules/@xrkseek/attachment/dist/request-projection.d.ts.map +1 -0
  42. package/node_modules/@xrkseek/attachment/dist/request-projection.js +49 -0
  43. package/node_modules/@xrkseek/attachment/dist/request-projection.js.map +1 -0
  44. package/node_modules/@xrkseek/attachment-local/dist/request-image.d.ts +2 -11
  45. package/node_modules/@xrkseek/attachment-local/dist/request-image.d.ts.map +1 -1
  46. package/node_modules/@xrkseek/attachment-local/dist/request-image.js +3 -29
  47. package/node_modules/@xrkseek/attachment-local/dist/request-image.js.map +1 -1
  48. package/node_modules/@xrkseek/checkpoint/README.md +4 -2
  49. package/node_modules/@xrkseek/checkpoint/dist/process-git.d.ts +6 -0
  50. package/node_modules/@xrkseek/checkpoint/dist/process-git.d.ts.map +1 -1
  51. package/node_modules/@xrkseek/checkpoint/dist/process-git.js +23 -1
  52. package/node_modules/@xrkseek/checkpoint/dist/process-git.js.map +1 -1
  53. package/node_modules/@xrkseek/checkpoint/dist/store.d.ts +30 -2
  54. package/node_modules/@xrkseek/checkpoint/dist/store.d.ts.map +1 -1
  55. package/node_modules/@xrkseek/checkpoint/dist/store.js +58 -15
  56. package/node_modules/@xrkseek/checkpoint/dist/store.js.map +1 -1
  57. package/node_modules/@xrkseek/checkpoint/dist/types.d.ts +14 -4
  58. package/node_modules/@xrkseek/checkpoint/dist/types.d.ts.map +1 -1
  59. package/node_modules/@xrkseek/checkpoint/dist/types.js.map +1 -1
  60. package/node_modules/@xrkseek/checkpoint/package.json +4 -1
  61. package/node_modules/@xrkseek/context-fragments/dist/index.d.ts +14 -0
  62. package/node_modules/@xrkseek/context-fragments/dist/index.d.ts.map +1 -1
  63. package/node_modules/@xrkseek/context-fragments/dist/index.js +33 -0
  64. package/node_modules/@xrkseek/context-fragments/dist/index.js.map +1 -1
  65. package/node_modules/@xrkseek/core-agent/dist/index.d.ts +7 -0
  66. package/node_modules/@xrkseek/core-agent/dist/index.d.ts.map +1 -1
  67. package/node_modules/@xrkseek/core-agent/dist/index.js +6 -0
  68. package/node_modules/@xrkseek/core-agent/dist/index.js.map +1 -1
  69. package/node_modules/@xrkseek/core-agent-loop/dist/compaction.d.ts.map +1 -1
  70. package/node_modules/@xrkseek/core-agent-loop/dist/compaction.js +1 -0
  71. package/node_modules/@xrkseek/core-agent-loop/dist/compaction.js.map +1 -1
  72. package/node_modules/@xrkseek/core-agent-loop/dist/index.d.ts +12 -0
  73. package/node_modules/@xrkseek/core-agent-loop/dist/index.d.ts.map +1 -1
  74. package/node_modules/@xrkseek/core-agent-loop/dist/index.js +95 -50
  75. package/node_modules/@xrkseek/core-agent-loop/dist/index.js.map +1 -1
  76. package/node_modules/@xrkseek/core-session/dist/compaction.d.ts +14 -0
  77. package/node_modules/@xrkseek/core-session/dist/compaction.d.ts.map +1 -1
  78. package/node_modules/@xrkseek/core-session/dist/compaction.js +41 -1
  79. package/node_modules/@xrkseek/core-session/dist/compaction.js.map +1 -1
  80. package/node_modules/@xrkseek/core-session/dist/index.d.ts +1 -1
  81. package/node_modules/@xrkseek/core-session/dist/index.d.ts.map +1 -1
  82. package/node_modules/@xrkseek/core-session/dist/index.js +1 -1
  83. package/node_modules/@xrkseek/core-session/dist/index.js.map +1 -1
  84. package/node_modules/@xrkseek/core-session/package.json +1 -0
  85. package/node_modules/@xrkseek/core-system-prompt/dist/index.d.ts +1 -0
  86. package/node_modules/@xrkseek/core-system-prompt/dist/index.d.ts.map +1 -1
  87. package/node_modules/@xrkseek/core-system-prompt/dist/index.js +1 -0
  88. package/node_modules/@xrkseek/core-system-prompt/dist/index.js.map +1 -1
  89. package/node_modules/@xrkseek/core-system-prompt/dist/time-context.d.ts +22 -0
  90. package/node_modules/@xrkseek/core-system-prompt/dist/time-context.d.ts.map +1 -0
  91. package/node_modules/@xrkseek/core-system-prompt/dist/time-context.js +47 -0
  92. package/node_modules/@xrkseek/core-system-prompt/dist/time-context.js.map +1 -0
  93. package/node_modules/@xrkseek/core-tools/dist/definition.d.ts +14 -0
  94. package/node_modules/@xrkseek/core-tools/dist/definition.d.ts.map +1 -1
  95. package/node_modules/@xrkseek/core-tools/dist/definition.js.map +1 -1
  96. package/node_modules/@xrkseek/core-tools/dist/index.d.ts +2 -2
  97. package/node_modules/@xrkseek/core-tools/dist/index.d.ts.map +1 -1
  98. package/node_modules/@xrkseek/core-tools/dist/index.js +1 -1
  99. package/node_modules/@xrkseek/core-tools/dist/index.js.map +1 -1
  100. package/node_modules/@xrkseek/core-tools/dist/materialize.d.ts +9 -3
  101. package/node_modules/@xrkseek/core-tools/dist/materialize.d.ts.map +1 -1
  102. package/node_modules/@xrkseek/core-tools/dist/materialize.js +38 -8
  103. package/node_modules/@xrkseek/core-tools/dist/materialize.js.map +1 -1
  104. package/node_modules/@xrkseek/exec-computer-use/dist/format.d.ts +2 -0
  105. package/node_modules/@xrkseek/exec-computer-use/dist/format.d.ts.map +1 -1
  106. package/node_modules/@xrkseek/exec-computer-use/dist/format.js +4 -1
  107. package/node_modules/@xrkseek/exec-computer-use/dist/format.js.map +1 -1
  108. package/node_modules/@xrkseek/exec-environment/README.md +21 -0
  109. package/node_modules/@xrkseek/exec-environment/dist/http.d.ts +34 -0
  110. package/node_modules/@xrkseek/exec-environment/dist/http.d.ts.map +1 -0
  111. package/node_modules/@xrkseek/exec-environment/dist/http.js +259 -0
  112. package/node_modules/@xrkseek/exec-environment/dist/http.js.map +1 -0
  113. package/node_modules/@xrkseek/exec-environment/dist/index.d.ts +5 -0
  114. package/node_modules/@xrkseek/exec-environment/dist/index.d.ts.map +1 -0
  115. package/node_modules/@xrkseek/exec-environment/dist/index.js +4 -0
  116. package/node_modules/@xrkseek/exec-environment/dist/index.js.map +1 -0
  117. package/node_modules/@xrkseek/exec-environment/dist/local.d.ts +11 -0
  118. package/node_modules/@xrkseek/exec-environment/dist/local.d.ts.map +1 -0
  119. package/node_modules/@xrkseek/exec-environment/dist/local.js +30 -0
  120. package/node_modules/@xrkseek/exec-environment/dist/local.js.map +1 -0
  121. package/node_modules/@xrkseek/exec-environment/dist/resolve.d.ts +23 -0
  122. package/node_modules/@xrkseek/exec-environment/dist/resolve.d.ts.map +1 -0
  123. package/node_modules/@xrkseek/exec-environment/dist/resolve.js +39 -0
  124. package/node_modules/@xrkseek/exec-environment/dist/resolve.js.map +1 -0
  125. package/node_modules/@xrkseek/exec-environment/dist/types.d.ts +33 -0
  126. package/node_modules/@xrkseek/exec-environment/dist/types.d.ts.map +1 -0
  127. package/node_modules/@xrkseek/exec-environment/dist/types.js +9 -0
  128. package/node_modules/@xrkseek/exec-environment/dist/types.js.map +1 -0
  129. package/node_modules/@xrkseek/exec-environment/package.json +28 -0
  130. package/node_modules/@xrkseek/exec-fs/dist/index.d.ts.map +1 -1
  131. package/node_modules/@xrkseek/exec-fs/dist/index.js +1 -0
  132. package/node_modules/@xrkseek/exec-fs/dist/index.js.map +1 -1
  133. package/node_modules/@xrkseek/exec-fs/dist/present.d.ts +5 -2
  134. package/node_modules/@xrkseek/exec-fs/dist/present.d.ts.map +1 -1
  135. package/node_modules/@xrkseek/exec-fs/dist/present.js +22 -4
  136. package/node_modules/@xrkseek/exec-fs/dist/present.js.map +1 -1
  137. package/node_modules/@xrkseek/exec-image-gen/README.md +6 -4
  138. package/node_modules/@xrkseek/exec-image-gen/dist/format.d.ts.map +1 -1
  139. package/node_modules/@xrkseek/exec-image-gen/dist/format.js +6 -3
  140. package/node_modules/@xrkseek/exec-image-gen/dist/format.js.map +1 -1
  141. package/node_modules/@xrkseek/exec-image-gen/dist/index.d.ts +4 -2
  142. package/node_modules/@xrkseek/exec-image-gen/dist/index.d.ts.map +1 -1
  143. package/node_modules/@xrkseek/exec-image-gen/dist/index.js +4 -2
  144. package/node_modules/@xrkseek/exec-image-gen/dist/index.js.map +1 -1
  145. package/node_modules/@xrkseek/exec-image-gen/dist/memory.d.ts +4 -1
  146. package/node_modules/@xrkseek/exec-image-gen/dist/memory.d.ts.map +1 -1
  147. package/node_modules/@xrkseek/exec-image-gen/dist/memory.js +16 -1
  148. package/node_modules/@xrkseek/exec-image-gen/dist/memory.js.map +1 -1
  149. package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.d.ts +5 -2
  150. package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.d.ts.map +1 -1
  151. package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.js +88 -38
  152. package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.js.map +1 -1
  153. package/node_modules/@xrkseek/exec-image-gen/dist/references.d.ts +21 -0
  154. package/node_modules/@xrkseek/exec-image-gen/dist/references.d.ts.map +1 -0
  155. package/node_modules/@xrkseek/exec-image-gen/dist/references.js +145 -0
  156. package/node_modules/@xrkseek/exec-image-gen/dist/references.js.map +1 -0
  157. package/node_modules/@xrkseek/exec-image-gen/dist/schema.d.ts +15 -0
  158. package/node_modules/@xrkseek/exec-image-gen/dist/schema.d.ts.map +1 -0
  159. package/node_modules/@xrkseek/exec-image-gen/dist/schema.js +67 -0
  160. package/node_modules/@xrkseek/exec-image-gen/dist/schema.js.map +1 -0
  161. package/node_modules/@xrkseek/exec-image-gen/dist/tools.d.ts +5 -2
  162. package/node_modules/@xrkseek/exec-image-gen/dist/tools.d.ts.map +1 -1
  163. package/node_modules/@xrkseek/exec-image-gen/dist/tools.js +38 -36
  164. package/node_modules/@xrkseek/exec-image-gen/dist/tools.js.map +1 -1
  165. package/node_modules/@xrkseek/exec-image-gen/dist/types.d.ts +34 -2
  166. package/node_modules/@xrkseek/exec-image-gen/dist/types.d.ts.map +1 -1
  167. package/node_modules/@xrkseek/exec-image-gen/dist/types.js +16 -1
  168. package/node_modules/@xrkseek/exec-image-gen/dist/types.js.map +1 -1
  169. package/node_modules/@xrkseek/exec-memory/README.md +3 -2
  170. package/node_modules/@xrkseek/exec-memory/dist/index.d.ts +2 -1
  171. package/node_modules/@xrkseek/exec-memory/dist/index.d.ts.map +1 -1
  172. package/node_modules/@xrkseek/exec-memory/dist/index.js +2 -1
  173. package/node_modules/@xrkseek/exec-memory/dist/index.js.map +1 -1
  174. package/node_modules/@xrkseek/exec-memory/dist/provider.d.ts +1 -1
  175. package/node_modules/@xrkseek/exec-memory/dist/provider.d.ts.map +1 -1
  176. package/node_modules/@xrkseek/exec-memory/dist/resolve.d.ts +15 -4
  177. package/node_modules/@xrkseek/exec-memory/dist/resolve.d.ts.map +1 -1
  178. package/node_modules/@xrkseek/exec-memory/dist/resolve.js +13 -3
  179. package/node_modules/@xrkseek/exec-memory/dist/resolve.js.map +1 -1
  180. package/node_modules/@xrkseek/exec-memory/dist/sqlite.d.ts +19 -0
  181. package/node_modules/@xrkseek/exec-memory/dist/sqlite.d.ts.map +1 -0
  182. package/node_modules/@xrkseek/exec-memory/dist/sqlite.js +190 -0
  183. package/node_modules/@xrkseek/exec-memory/dist/sqlite.js.map +1 -0
  184. package/node_modules/@xrkseek/exec-memory/dist/write-path.d.ts +21 -0
  185. package/node_modules/@xrkseek/exec-memory/dist/write-path.d.ts.map +1 -1
  186. package/node_modules/@xrkseek/exec-memory/dist/write-path.js +128 -25
  187. package/node_modules/@xrkseek/exec-memory/dist/write-path.js.map +1 -1
  188. package/node_modules/@xrkseek/exec-video-gen/README.md +27 -19
  189. package/node_modules/@xrkseek/exec-video-gen/dist/catalog.d.ts +16 -0
  190. package/node_modules/@xrkseek/exec-video-gen/dist/catalog.d.ts.map +1 -0
  191. package/node_modules/@xrkseek/exec-video-gen/dist/catalog.js +90 -0
  192. package/node_modules/@xrkseek/exec-video-gen/dist/catalog.js.map +1 -0
  193. package/node_modules/@xrkseek/exec-video-gen/dist/format.d.ts.map +1 -1
  194. package/node_modules/@xrkseek/exec-video-gen/dist/format.js +3 -1
  195. package/node_modules/@xrkseek/exec-video-gen/dist/format.js.map +1 -1
  196. package/node_modules/@xrkseek/exec-video-gen/dist/index.d.ts +5 -2
  197. package/node_modules/@xrkseek/exec-video-gen/dist/index.d.ts.map +1 -1
  198. package/node_modules/@xrkseek/exec-video-gen/dist/index.js +5 -2
  199. package/node_modules/@xrkseek/exec-video-gen/dist/index.js.map +1 -1
  200. package/node_modules/@xrkseek/exec-video-gen/dist/memory.d.ts +3 -2
  201. package/node_modules/@xrkseek/exec-video-gen/dist/memory.d.ts.map +1 -1
  202. package/node_modules/@xrkseek/exec-video-gen/dist/memory.js +45 -4
  203. package/node_modules/@xrkseek/exec-video-gen/dist/memory.js.map +1 -1
  204. package/node_modules/@xrkseek/exec-video-gen/dist/openai-http.d.ts +3 -6
  205. package/node_modules/@xrkseek/exec-video-gen/dist/openai-http.d.ts.map +1 -1
  206. package/node_modules/@xrkseek/exec-video-gen/dist/openai-http.js +81 -2
  207. package/node_modules/@xrkseek/exec-video-gen/dist/openai-http.js.map +1 -1
  208. package/node_modules/@xrkseek/exec-video-gen/dist/references.d.ts +24 -0
  209. package/node_modules/@xrkseek/exec-video-gen/dist/references.d.ts.map +1 -0
  210. package/node_modules/@xrkseek/exec-video-gen/dist/references.js +151 -0
  211. package/node_modules/@xrkseek/exec-video-gen/dist/references.js.map +1 -0
  212. package/node_modules/@xrkseek/exec-video-gen/dist/schema.d.ts +15 -0
  213. package/node_modules/@xrkseek/exec-video-gen/dist/schema.d.ts.map +1 -0
  214. package/node_modules/@xrkseek/exec-video-gen/dist/schema.js +104 -0
  215. package/node_modules/@xrkseek/exec-video-gen/dist/schema.js.map +1 -0
  216. package/node_modules/@xrkseek/exec-video-gen/dist/tools.d.ts +4 -2
  217. package/node_modules/@xrkseek/exec-video-gen/dist/tools.d.ts.map +1 -1
  218. package/node_modules/@xrkseek/exec-video-gen/dist/tools.js +99 -70
  219. package/node_modules/@xrkseek/exec-video-gen/dist/tools.js.map +1 -1
  220. package/node_modules/@xrkseek/exec-video-gen/dist/types.d.ts +73 -2
  221. package/node_modules/@xrkseek/exec-video-gen/dist/types.d.ts.map +1 -1
  222. package/node_modules/@xrkseek/exec-video-gen/dist/types.js +20 -1
  223. package/node_modules/@xrkseek/exec-video-gen/dist/types.js.map +1 -1
  224. package/node_modules/@xrkseek/exec-web/README.md +2 -2
  225. package/node_modules/@xrkseek/exec-web/dist/browser-tools.d.ts +3 -0
  226. package/node_modules/@xrkseek/exec-web/dist/browser-tools.d.ts.map +1 -1
  227. package/node_modules/@xrkseek/exec-web/dist/browser-tools.js +3 -0
  228. package/node_modules/@xrkseek/exec-web/dist/browser-tools.js.map +1 -1
  229. package/node_modules/@xrkseek/exec-web/dist/browser-vault-tools.d.ts +32 -0
  230. package/node_modules/@xrkseek/exec-web/dist/browser-vault-tools.d.ts.map +1 -0
  231. package/node_modules/@xrkseek/exec-web/dist/browser-vault-tools.js +141 -0
  232. package/node_modules/@xrkseek/exec-web/dist/browser-vault-tools.js.map +1 -0
  233. package/node_modules/@xrkseek/exec-web/dist/index.d.ts +1 -0
  234. package/node_modules/@xrkseek/exec-web/dist/index.d.ts.map +1 -1
  235. package/node_modules/@xrkseek/exec-web/dist/index.js +1 -0
  236. package/node_modules/@xrkseek/exec-web/dist/index.js.map +1 -1
  237. package/node_modules/@xrkseek/llm-deepseek/dist/index.d.ts +1 -0
  238. package/node_modules/@xrkseek/llm-deepseek/dist/index.d.ts.map +1 -1
  239. package/node_modules/@xrkseek/llm-deepseek/dist/index.js +2 -1
  240. package/node_modules/@xrkseek/llm-deepseek/dist/index.js.map +1 -1
  241. package/node_modules/@xrkseek/llm-deepseek/dist/request-policy.d.ts +13 -3
  242. package/node_modules/@xrkseek/llm-deepseek/dist/request-policy.d.ts.map +1 -1
  243. package/node_modules/@xrkseek/llm-deepseek/dist/request-policy.js +27 -4
  244. package/node_modules/@xrkseek/llm-deepseek/dist/request-policy.js.map +1 -1
  245. package/node_modules/@xrkseek/preset-harness/README.md +8 -8
  246. package/node_modules/@xrkseek/preset-harness/dist/preset.d.ts +11 -1
  247. package/node_modules/@xrkseek/preset-harness/dist/preset.d.ts.map +1 -1
  248. package/node_modules/@xrkseek/preset-harness/dist/preset.js +11 -3
  249. package/node_modules/@xrkseek/preset-harness/dist/preset.js.map +1 -1
  250. package/node_modules/@xrkseek/preset-harness/dist/tsconfig.tsbuildinfo +1 -1
  251. package/node_modules/@xrkseek/preset-minimal/README.md +2 -2
  252. package/node_modules/@xrkseek/preset-minimal/dist/preset.js +1 -1
  253. package/node_modules/@xrkseek/preset-minimal/dist/preset.js.map +1 -1
  254. package/node_modules/@xrkseek/preset-minimal/dist/tsconfig.tsbuildinfo +1 -1
  255. package/node_modules/@xrkseek/preset-server/README.md +5 -5
  256. package/node_modules/@xrkseek/preset-server/dist/preset.d.ts.map +1 -1
  257. package/node_modules/@xrkseek/preset-server/dist/preset.js +3 -2
  258. package/node_modules/@xrkseek/preset-server/dist/preset.js.map +1 -1
  259. package/node_modules/@xrkseek/preset-server/dist/tsconfig.tsbuildinfo +1 -1
  260. package/node_modules/@xrkseek/protocol/dist/session-events.d.ts +9 -0
  261. package/node_modules/@xrkseek/protocol/dist/session-events.d.ts.map +1 -1
  262. package/node_modules/@xrkseek/protocol/dist/session-events.js.map +1 -1
  263. package/node_modules/@xrkseek/protocol/dist/validate.d.ts.map +1 -1
  264. package/node_modules/@xrkseek/protocol/dist/validate.js +9 -0
  265. package/node_modules/@xrkseek/protocol/dist/validate.js.map +1 -1
  266. package/node_modules/@xrkseek/server-config/dist/index.d.ts +1 -0
  267. package/node_modules/@xrkseek/server-config/dist/index.d.ts.map +1 -1
  268. package/node_modules/@xrkseek/server-config/dist/index.js +1 -0
  269. package/node_modules/@xrkseek/server-config/dist/index.js.map +1 -1
  270. package/node_modules/@xrkseek/server-config/dist/json-text.d.ts +8 -0
  271. package/node_modules/@xrkseek/server-config/dist/json-text.d.ts.map +1 -0
  272. package/node_modules/@xrkseek/server-config/dist/json-text.js +12 -0
  273. package/node_modules/@xrkseek/server-config/dist/json-text.js.map +1 -0
  274. package/node_modules/@xrkseek/server-cron/README.md +3 -2
  275. package/node_modules/@xrkseek/server-cron/dist/executions.d.ts +31 -0
  276. package/node_modules/@xrkseek/server-cron/dist/executions.d.ts.map +1 -0
  277. package/node_modules/@xrkseek/server-cron/dist/executions.js +95 -0
  278. package/node_modules/@xrkseek/server-cron/dist/executions.js.map +1 -0
  279. package/node_modules/@xrkseek/server-cron/dist/index.d.ts +1 -0
  280. package/node_modules/@xrkseek/server-cron/dist/index.d.ts.map +1 -1
  281. package/node_modules/@xrkseek/server-cron/dist/index.js +6 -0
  282. package/node_modules/@xrkseek/server-cron/dist/index.js.map +1 -1
  283. package/node_modules/@xrkseek/server-cron/dist/scheduler.d.ts +4 -0
  284. package/node_modules/@xrkseek/server-cron/dist/scheduler.d.ts.map +1 -1
  285. package/node_modules/@xrkseek/server-cron/dist/scheduler.js +33 -24
  286. package/node_modules/@xrkseek/server-cron/dist/scheduler.js.map +1 -1
  287. package/node_modules/@xrkseek/server-cron/dist/tools.d.ts.map +1 -1
  288. package/node_modules/@xrkseek/server-cron/dist/tools.js +44 -6
  289. package/node_modules/@xrkseek/server-cron/dist/tools.js.map +1 -1
  290. package/node_modules/@xrkseek/server-face/dist/dispatch.d.ts.map +1 -1
  291. package/node_modules/@xrkseek/server-face/dist/dispatch.js +2 -0
  292. package/node_modules/@xrkseek/server-face/dist/dispatch.js.map +1 -1
  293. package/node_modules/@xrkseek/server-face/dist/external-agent-runtime.d.ts +37 -2
  294. package/node_modules/@xrkseek/server-face/dist/external-agent-runtime.d.ts.map +1 -1
  295. package/node_modules/@xrkseek/server-face/dist/external-agent-runtime.js +191 -28
  296. package/node_modules/@xrkseek/server-face/dist/external-agent-runtime.js.map +1 -1
  297. package/node_modules/@xrkseek/server-face/dist/handlers/worktree.d.ts +10 -0
  298. package/node_modules/@xrkseek/server-face/dist/handlers/worktree.d.ts.map +1 -0
  299. package/node_modules/@xrkseek/server-face/dist/handlers/worktree.js +33 -0
  300. package/node_modules/@xrkseek/server-face/dist/handlers/worktree.js.map +1 -0
  301. package/node_modules/@xrkseek/server-face/dist/host-open-path.d.ts +9 -0
  302. package/node_modules/@xrkseek/server-face/dist/host-open-path.d.ts.map +1 -1
  303. package/node_modules/@xrkseek/server-face/dist/host-open-path.js +13 -7
  304. package/node_modules/@xrkseek/server-face/dist/host-open-path.js.map +1 -1
  305. package/node_modules/@xrkseek/server-face/dist/index.d.ts +2 -2
  306. package/node_modules/@xrkseek/server-face/dist/index.d.ts.map +1 -1
  307. package/node_modules/@xrkseek/server-face/dist/index.js +1 -1
  308. package/node_modules/@xrkseek/server-face/dist/index.js.map +1 -1
  309. package/node_modules/@xrkseek/server-face/dist/llm-provider-context.d.ts +2 -0
  310. package/node_modules/@xrkseek/server-face/dist/llm-provider-context.d.ts.map +1 -1
  311. package/node_modules/@xrkseek/server-face/dist/llm-provider-context.js +13 -0
  312. package/node_modules/@xrkseek/server-face/dist/llm-provider-context.js.map +1 -1
  313. package/node_modules/@xrkseek/server-face/dist/llm-resolve.d.ts.map +1 -1
  314. package/node_modules/@xrkseek/server-face/dist/llm-resolve.js +3 -1
  315. package/node_modules/@xrkseek/server-face/dist/llm-resolve.js.map +1 -1
  316. package/node_modules/@xrkseek/server-face/dist/model-catalog.d.ts +4 -0
  317. package/node_modules/@xrkseek/server-face/dist/model-catalog.d.ts.map +1 -1
  318. package/node_modules/@xrkseek/server-face/dist/model-catalog.js +24 -5
  319. package/node_modules/@xrkseek/server-face/dist/model-catalog.js.map +1 -1
  320. package/node_modules/@xrkseek/server-face/dist/presets-catalog.js +5 -5
  321. package/node_modules/@xrkseek/server-face/dist/presets-catalog.js.map +1 -1
  322. package/node_modules/@xrkseek/server-face/dist/runtime.d.ts.map +1 -1
  323. package/node_modules/@xrkseek/server-face/dist/runtime.js +14 -2
  324. package/node_modules/@xrkseek/server-face/dist/runtime.js.map +1 -1
  325. package/node_modules/@xrkseek/server-face/dist/select-session-model.d.ts.map +1 -1
  326. package/node_modules/@xrkseek/server-face/dist/select-session-model.js +8 -0
  327. package/node_modules/@xrkseek/server-face/dist/select-session-model.js.map +1 -1
  328. package/node_modules/@xrkseek/server-face/dist/session-model-store.d.ts +11 -0
  329. package/node_modules/@xrkseek/server-face/dist/session-model-store.d.ts.map +1 -0
  330. package/node_modules/@xrkseek/server-face/dist/session-model-store.js +66 -0
  331. package/node_modules/@xrkseek/server-face/dist/session-model-store.js.map +1 -0
  332. package/node_modules/@xrkseek/server-face/dist/session-status.d.ts +64 -13
  333. package/node_modules/@xrkseek/server-face/dist/session-status.d.ts.map +1 -1
  334. package/node_modules/@xrkseek/server-face/dist/session-status.js +173 -5
  335. package/node_modules/@xrkseek/server-face/dist/session-status.js.map +1 -1
  336. package/node_modules/@xrkseek/server-face/dist/settings-credentials.d.ts.map +1 -1
  337. package/node_modules/@xrkseek/server-face/dist/settings-credentials.js +4 -5
  338. package/node_modules/@xrkseek/server-face/dist/settings-credentials.js.map +1 -1
  339. package/node_modules/@xrkseek/server-face/dist/settings-schemas.d.ts.map +1 -1
  340. package/node_modules/@xrkseek/server-face/dist/settings-schemas.js +36 -4
  341. package/node_modules/@xrkseek/server-face/dist/settings-schemas.js.map +1 -1
  342. package/node_modules/@xrkseek/server-face/dist/subagent-tools.d.ts +1 -1
  343. package/node_modules/@xrkseek/server-face/dist/subagent-tools.d.ts.map +1 -1
  344. package/node_modules/@xrkseek/server-face/dist/subagent-tools.js +1 -1
  345. package/node_modules/@xrkseek/server-face/dist/subagent-tools.js.map +1 -1
  346. package/node_modules/@xrkseek/server-face/dist/workspace-checkpoint.d.ts +15 -1
  347. package/node_modules/@xrkseek/server-face/dist/workspace-checkpoint.d.ts.map +1 -1
  348. package/node_modules/@xrkseek/server-face/dist/workspace-checkpoint.js +35 -7
  349. package/node_modules/@xrkseek/server-face/dist/workspace-checkpoint.js.map +1 -1
  350. package/node_modules/@xrkseek/server-host/dist/a2a-inbound-public.d.ts +11 -0
  351. package/node_modules/@xrkseek/server-host/dist/a2a-inbound-public.d.ts.map +1 -0
  352. package/node_modules/@xrkseek/server-host/dist/a2a-inbound-public.js +22 -0
  353. package/node_modules/@xrkseek/server-host/dist/a2a-inbound-public.js.map +1 -0
  354. package/node_modules/@xrkseek/server-host/dist/index.d.ts +3 -0
  355. package/node_modules/@xrkseek/server-host/dist/index.d.ts.map +1 -1
  356. package/node_modules/@xrkseek/server-host/dist/index.js +178 -48
  357. package/node_modules/@xrkseek/server-host/dist/index.js.map +1 -1
  358. package/node_modules/@xrkseek/server-host/dist/mcp-wire.d.ts.map +1 -1
  359. package/node_modules/@xrkseek/server-host/dist/mcp-wire.js +3 -3
  360. package/node_modules/@xrkseek/server-host/dist/mcp-wire.js.map +1 -1
  361. package/node_modules/@xrkseek/server-host/package.json +2 -0
  362. package/node_modules/@xrkseek/server-http/dist/dsh-compat/embedded-vector-store.d.ts +2 -2
  363. package/node_modules/@xrkseek/server-http/dist/dsh-compat/embedded-vector-store.d.ts.map +1 -1
  364. package/node_modules/@xrkseek/server-http/dist/dsh-compat/embedded-vector-store.js +9 -4
  365. package/node_modules/@xrkseek/server-http/dist/dsh-compat/embedded-vector-store.js.map +1 -1
  366. package/node_modules/@xrkseek/server-http/dist/dsh-compat/memory-embeddings.d.ts +37 -1
  367. package/node_modules/@xrkseek/server-http/dist/dsh-compat/memory-embeddings.d.ts.map +1 -1
  368. package/node_modules/@xrkseek/server-http/dist/dsh-compat/memory-embeddings.js +125 -9
  369. package/node_modules/@xrkseek/server-http/dist/dsh-compat/memory-embeddings.js.map +1 -1
  370. package/node_modules/@xrkseek/workspace/dist/index.d.ts +1 -0
  371. package/node_modules/@xrkseek/workspace/dist/index.d.ts.map +1 -1
  372. package/node_modules/@xrkseek/workspace/dist/index.js +1 -0
  373. package/node_modules/@xrkseek/workspace/dist/index.js.map +1 -1
  374. package/node_modules/@xrkseek/workspace/dist/skill-curator.d.ts +46 -0
  375. package/node_modules/@xrkseek/workspace/dist/skill-curator.d.ts.map +1 -0
  376. package/node_modules/@xrkseek/workspace/dist/skill-curator.js +114 -0
  377. package/node_modules/@xrkseek/workspace/dist/skill-curator.js.map +1 -0
  378. package/package.json +5 -1
package/dist/index.d.ts CHANGED
@@ -24,7 +24,7 @@ export { createMinimalComposition } from "@xrkseek/preset-minimal";
24
24
  export { createHarnessComposition } from "@xrkseek/preset-harness";
25
25
  export { createServerAgentFactory, createServerComposition, } from "@xrkseek/preset-server";
26
26
  export { createWorkerCodeRuntime, createRunCodeTool, createRegistryCodeToolBridge, runCodeWithTools, } from "@xrkseek/code-runtime";
27
- export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, } from "@xrkseek/context-fragments";
27
+ export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, createGuardianReviewProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, DEFAULT_GUARDIAN_REVIEW_TEXT, } from "@xrkseek/context-fragments";
28
28
  export { createDefaultWebAccess, createWebTools, createHttpFetchProvider, WEB_SEARCH_MAX_RESULTS, } from "@xrkseek/exec-web";
29
29
  export { createDefaultLspAccess, createLspTools, createStdioLspService, LSP_PROMPT_TEXT, } from "@xrkseek/exec-lsp";
30
30
  export { createDefaultPtyAccess, createPtyTools, createTerminalSessionService, PTY_PROMPT_TEXT, } from "@xrkseek/exec-pty";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -23,7 +23,7 @@ export { createMinimalComposition } from "@xrkseek/preset-minimal";
23
23
  export { createHarnessComposition } from "@xrkseek/preset-harness";
24
24
  export { createServerAgentFactory, createServerComposition, } from "@xrkseek/preset-server";
25
25
  export { createWorkerCodeRuntime, createRunCodeTool, createRegistryCodeToolBridge, runCodeWithTools, } from "@xrkseek/code-runtime";
26
- export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, } from "@xrkseek/context-fragments";
26
+ export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, createGuardianReviewProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, DEFAULT_GUARDIAN_REVIEW_TEXT, } from "@xrkseek/context-fragments";
27
27
  export { createDefaultWebAccess, createWebTools, createHttpFetchProvider, WEB_SEARCH_MAX_RESULTS, } from "@xrkseek/exec-web";
28
28
  export { createDefaultLspAccess, createLspTools, createStdioLspService, LSP_PROMPT_TEXT, } from "@xrkseek/exec-lsp";
29
29
  export { createDefaultPtyAccess, createPtyTools, createTerminalSessionService, PTY_PROMPT_TEXT, } from "@xrkseek/exec-pty";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ # `@xrkseek/a2a`
2
+
3
+ > **读者**:集成者 · 维护者
4
+
5
+ 可选 **A2A(Agent-to-Agent)** 客户端:对标 Hermes `plugins/platforms/a2a` 的出站工具集核心——`context_id` 磁盘持久、历史召回、环路上限。
6
+
7
+ ## 能力
8
+
9
+ | 面 | 行为 |
10
+ |----|------|
11
+ | 持久 | `{XRK_HOME}/a2a_conversations/<context>.jsonl`(可用 `XRK_A2A_CONVERSATIONS_DIR`) |
12
+ | 历史 | `a2a_history(context_id)` / `loadConversation` |
13
+ | 环路 | `TurnTracker` + `XRK_A2A_MAX_PINGPONG_TURNS`(默认 5,硬顶 20) |
14
+ | 工具 | `a2a_discover` · `a2a_call` · `a2a_list` · `a2a_history` |
15
+
16
+ ## 启用
17
+
18
+ 进程插件:`extensions/a2a`(`XRK_PLUGINS_DIR=./extensions` 或 `xrkh plugin add`)。
19
+
20
+ ```bash
21
+ # 对等体
22
+ set XRK_A2A_AGENTS={"researcher":{"url":"http://127.0.0.1:9900","auth":{"token":"…"}}}
23
+ # 环路上限(可选)
24
+ set XRK_A2A_MAX_PINGPONG_TURNS=5
25
+ ```
26
+
27
+ 或写 `{XRK_HOME}/a2a_agents.json`。
28
+
29
+ ## 未做(本切片)
30
+
31
+ SSE `message/stream`、tasks CRUD / subscribe、push notifications、orchestrate、入站 → Face 会话注入 — 见 Hermes DESIGN。
32
+
33
+ ## 入站(opt-in)
34
+
35
+ `XRK_A2A_INBOUND=1` 时 Host 挂载:
36
+
37
+ | 路径 | 行为 |
38
+ |------|------|
39
+ | `GET /.well-known/agent-card.json`(兼 `agent.json`) | A2A v1.0 Agent Card |
40
+ | `POST /a2a` | JSON-RPC `message/send`(持久化 + 回声;可选 `onMessage`) |
41
+ | `GET /a2a/health` | 健康检查 |
42
+
43
+ 无 bearer / peer token 时仅环回语义可用(仍建议本机);设 `XRK_A2A_BEARER_TOKEN` 或 `XRK_A2A_PEER_TOKENS` 启用鉴权。`XRK_A2A_PUBLIC_URL` 覆盖 Card 上的 url。
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Outbound A2A client: discover + SendMessage with persistence and anti-loop.
3
+ */
4
+ import { TurnTracker } from "./protocol.js";
5
+ import { type A2aPeerMap } from "./peers.js";
6
+ export interface A2aClientOptions {
7
+ readonly env?: NodeJS.ProcessEnv;
8
+ readonly peers?: A2aPeerMap;
9
+ readonly conversationsRoot?: string;
10
+ readonly turnTracker?: TurnTracker;
11
+ /** Inject HTTP for tests. */
12
+ readonly fetch?: typeof fetch;
13
+ }
14
+ export interface A2aCallResult {
15
+ readonly ok: boolean;
16
+ readonly content: string;
17
+ readonly contextId: string;
18
+ readonly state: string;
19
+ }
20
+ export declare class A2aClient {
21
+ private readonly env;
22
+ private readonly peers;
23
+ private readonly root;
24
+ private readonly turns;
25
+ private readonly fetchImpl;
26
+ constructor(options?: A2aClientOptions);
27
+ listPeers(): A2aPeerMap;
28
+ listConversations(): string[];
29
+ history(contextId: string, limit?: number): import("./protocol.js").PersistedA2aMessage[];
30
+ discover(url: string): Promise<string>;
31
+ call(agent: string, message: string, contextId?: string): Promise<A2aCallResult>;
32
+ resetLoop(contextId: string): void;
33
+ }
34
+ export declare function createA2aClient(options?: A2aClientOptions): A2aClient;
35
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAaL,WAAW,EAGZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AA2DD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,GAAE,gBAAqB;IAQ1C,SAAS,IAAI,UAAU;IAIvB,iBAAiB,IAAI,MAAM,EAAE;IAI7B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK;IAI/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsCtC,IAAI,CACR,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,SAAK,GACb,OAAO,CAAC,aAAa,CAAC;IAqIzB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}
@@ -0,0 +1,229 @@
1
+ /**
2
+ * Outbound A2A client: discover + SendMessage with persistence and anti-loop.
3
+ */
4
+ import { extractText, listPersistedContexts, loadConversation, maxPingpongTurns, newContextId, newTaskId, persistMessage, ROLE_AGENT, ROLE_USER, STATE_INPUT_REQUIRED, STATE_REJECTED, textMessage, TurnTracker, unwrapSendMessageResponse, a2aConversationsDir, } from "./protocol.js";
5
+ import { loadA2aPeers, resolveA2aPeer, } from "./peers.js";
6
+ const DEFAULT_TIMEOUT_MS = 120_000;
7
+ function authHeaders(peer) {
8
+ const token = peer.auth?.token?.trim();
9
+ if (!token)
10
+ return {};
11
+ return { Authorization: `Bearer ${token}` };
12
+ }
13
+ async function fetchJson(url, init, fetchImpl) {
14
+ const res = await fetchImpl(url, init);
15
+ const text = await res.text();
16
+ let body = {};
17
+ if (text.trim()) {
18
+ try {
19
+ body = JSON.parse(text);
20
+ }
21
+ catch {
22
+ body = { raw: text };
23
+ }
24
+ }
25
+ if (!res.ok) {
26
+ const err = new Error(`HTTP ${res.status}`);
27
+ err.status = res.status;
28
+ err.body = body;
29
+ throw err;
30
+ }
31
+ return body;
32
+ }
33
+ function cardUrl(base) {
34
+ return `${base.replace(/\/+$/, "")}/.well-known/agent-card.json`;
35
+ }
36
+ function rpcUrl(base, card) {
37
+ const ifaces = card?.supportedInterfaces;
38
+ if (Array.isArray(ifaces)) {
39
+ for (const iface of ifaces) {
40
+ if (iface !== null &&
41
+ typeof iface === "object" &&
42
+ typeof iface.url === "string" &&
43
+ iface.url) {
44
+ return iface.url.replace(/\/+$/, "");
45
+ }
46
+ }
47
+ }
48
+ if (typeof card?.url === "string" && card.url) {
49
+ return String(card.url).replace(/\/+$/, "");
50
+ }
51
+ return base.replace(/\/+$/, "");
52
+ }
53
+ export class A2aClient {
54
+ env;
55
+ peers;
56
+ root;
57
+ turns;
58
+ fetchImpl;
59
+ constructor(options = {}) {
60
+ this.env = options.env ?? process.env;
61
+ this.peers = options.peers ?? loadA2aPeers(this.env);
62
+ this.root = options.conversationsRoot ?? a2aConversationsDir(this.env);
63
+ this.turns = options.turnTracker ?? new TurnTracker();
64
+ this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
65
+ }
66
+ listPeers() {
67
+ return this.peers;
68
+ }
69
+ listConversations() {
70
+ return listPersistedContexts({ root: this.root });
71
+ }
72
+ history(contextId, limit = 50) {
73
+ return loadConversation(contextId, limit, { root: this.root });
74
+ }
75
+ async discover(url) {
76
+ const base = url.trim();
77
+ if (!base)
78
+ return "Error: 'url' is required (e.g. http://localhost:9900).";
79
+ try {
80
+ const card = (await fetchJson(cardUrl(base), { headers: { Accept: "application/json" } }, this.fetchImpl));
81
+ const caps = card.capabilities ?? {};
82
+ const skills = Array.isArray(card.skills) ? card.skills : [];
83
+ const auth = card.security ? "yes" : "no";
84
+ const lines = [
85
+ `Agent: ${String(card.name ?? "?")}`,
86
+ `Description: ${String(card.description ?? "")}`,
87
+ `URL: ${rpcUrl(base, card)}`,
88
+ `Streaming: ${Boolean(caps.streaming)} Push: ${Boolean(caps.pushNotifications)} Auth required: ${auth}`,
89
+ `Skills (${skills.length}):`,
90
+ ];
91
+ for (const s of skills.slice(0, 20)) {
92
+ if (s !== null && typeof s === "object") {
93
+ const sk = s;
94
+ lines.push(` - ${String(sk.name ?? sk.id ?? "?")}: ${String(sk.description ?? "")}`);
95
+ }
96
+ }
97
+ return lines.join("\n");
98
+ }
99
+ catch (err) {
100
+ const status = err.status;
101
+ if (status !== undefined) {
102
+ return `Error: discovery failed — HTTP ${status} from ${base}.`;
103
+ }
104
+ return `Error: could not reach ${base} — ${err instanceof Error ? err.message : String(err)}.`;
105
+ }
106
+ }
107
+ async call(agent, message, contextId = "") {
108
+ const resolved = resolveA2aPeer(agent, this.peers);
109
+ if (!resolved) {
110
+ return {
111
+ ok: false,
112
+ content: `Error: unknown agent '${agent}'. Configure XRK_A2A_AGENTS / a2a_agents.json or pass a full http(s):// URL.`,
113
+ contextId: contextId || "",
114
+ state: "",
115
+ };
116
+ }
117
+ const ctx = contextId.trim() || newContextId();
118
+ const maxTurns = maxPingpongTurns(this.env);
119
+ const turn = this.turns.track(ctx);
120
+ if (turn > maxTurns) {
121
+ return {
122
+ ok: false,
123
+ content: `Error: anti-loop protection: context ${ctx} exceeded ${maxTurns} turns. Start a new context_id or raise XRK_A2A_MAX_PINGPONG_TURNS.`,
124
+ contextId: ctx,
125
+ state: STATE_REJECTED,
126
+ };
127
+ }
128
+ const { label, peer } = resolved;
129
+ const taskId = newTaskId();
130
+ const timeoutMs = Math.max(1_000, (peer.timeout ?? DEFAULT_TIMEOUT_MS / 1000) * 1000);
131
+ persistMessage(ctx, "user", message, taskId, { root: this.root });
132
+ let card = null;
133
+ try {
134
+ card = (await fetchJson(cardUrl(peer.url), {
135
+ headers: { Accept: "application/json", ...authHeaders(peer) },
136
+ signal: AbortSignal.timeout(Math.min(timeoutMs, 30_000)),
137
+ }, this.fetchImpl));
138
+ }
139
+ catch {
140
+ card = null;
141
+ }
142
+ const rpcBody = {
143
+ jsonrpc: "2.0",
144
+ id: taskId,
145
+ method: "SendMessage",
146
+ params: {
147
+ message: textMessage(ROLE_USER, message, ctx),
148
+ },
149
+ };
150
+ if (peer.tenant) {
151
+ rpcBody.params.tenant = peer.tenant;
152
+ }
153
+ try {
154
+ const resp = (await fetchJson(rpcUrl(peer.url, card), {
155
+ method: "POST",
156
+ headers: {
157
+ "Content-Type": "application/json",
158
+ Accept: "application/json",
159
+ ...authHeaders(peer),
160
+ },
161
+ body: JSON.stringify(rpcBody),
162
+ signal: AbortSignal.timeout(timeoutMs),
163
+ }, this.fetchImpl));
164
+ if (resp.error && typeof resp.error === "object") {
165
+ const msg = String(resp.error.message ?? resp.error);
166
+ return {
167
+ ok: false,
168
+ content: `Error: peer '${label}' returned an error: ${msg}`,
169
+ contextId: ctx,
170
+ state: "",
171
+ };
172
+ }
173
+ const payload = unwrapSendMessageResponse(resp.result);
174
+ let reply = extractText(payload);
175
+ let replyCtx = ctx;
176
+ let state = "";
177
+ if (payload !== null && typeof payload === "object") {
178
+ const rec = payload;
179
+ if (typeof rec.contextId === "string" && rec.contextId) {
180
+ replyCtx = rec.contextId;
181
+ }
182
+ const status = rec.status;
183
+ if (status !== null && typeof status === "object") {
184
+ state = String(status.state ?? "");
185
+ }
186
+ }
187
+ if (!reply)
188
+ reply = "(empty peer reply)";
189
+ persistMessage(replyCtx, "agent", reply, taskId, { root: this.root });
190
+ let body = `Peer '${label}' replied (context_id=${replyCtx}):\n${reply}`;
191
+ if (state === STATE_INPUT_REQUIRED) {
192
+ body += `\n\n(The peer needs more input — call a2a_call again with context_id '${replyCtx}'.)`;
193
+ }
194
+ return { ok: true, content: body, contextId: replyCtx, state };
195
+ }
196
+ catch (err) {
197
+ const status = err.status;
198
+ if (status === 401 || status === 403) {
199
+ return {
200
+ ok: false,
201
+ content: `Error: peer '${label}' rejected auth (HTTP ${status}). Check the configured token.`,
202
+ contextId: ctx,
203
+ state: "",
204
+ };
205
+ }
206
+ if (status === 429) {
207
+ return {
208
+ ok: false,
209
+ content: `Error: peer '${label}' rate limited us (HTTP 429). Retry later.`,
210
+ contextId: ctx,
211
+ state: "",
212
+ };
213
+ }
214
+ return {
215
+ ok: false,
216
+ content: `Error: call to '${label}' failed — ${err instanceof Error ? err.message : String(err)}.`,
217
+ contextId: ctx,
218
+ state: "",
219
+ };
220
+ }
221
+ }
222
+ resetLoop(contextId) {
223
+ this.turns.reset(contextId);
224
+ }
225
+ }
226
+ export function createA2aClient(options) {
227
+ return new A2aClient(options);
228
+ }
229
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Thin A2A inbound HTTP surface (Hermes `plugins/platforms/a2a` Agent Card +
3
+ * message/send subset). Opt-in via Host `XRK_A2A_INBOUND=1` — no Face session
4
+ * injection yet; persists peer turns and returns a completed task echo.
5
+ */
6
+ import type { IncomingMessage, ServerResponse } from "node:http";
7
+ import { TurnTracker } from "./protocol.js";
8
+ export interface A2aInboundOptions {
9
+ /** Public base URL advertised on the Agent Card (e.g. http://127.0.0.1:8787/a2a). */
10
+ readonly url: string;
11
+ readonly name?: string;
12
+ readonly description?: string;
13
+ readonly env?: NodeJS.ProcessEnv;
14
+ /** Conversations root override (tests). */
15
+ readonly conversationsRoot?: string;
16
+ readonly turnTracker?: TurnTracker;
17
+ /**
18
+ * Optional Face admit hook. When absent, message/send persists + echoes.
19
+ * Return agent reply text; throw to fail the task.
20
+ */
21
+ readonly onMessage?: (input: {
22
+ readonly text: string;
23
+ readonly contextId: string;
24
+ readonly taskId: string;
25
+ readonly peer: string;
26
+ }) => Promise<string> | string;
27
+ }
28
+ /** Parse `A2A_PEER_TOKENS=alice:tok1,bob:tok2` → name → token. */
29
+ export declare function parsePeerTokens(raw: string | undefined): ReadonlyMap<string, string>;
30
+ export declare function buildA2aAgentCard(options: {
31
+ readonly name: string;
32
+ readonly url: string;
33
+ readonly description: string;
34
+ readonly authRequired?: boolean;
35
+ }): Record<string, unknown>;
36
+ /**
37
+ * Claim A2A inbound paths. Returns true when the request was handled.
38
+ * Paths: `GET /.well-known/agent-card.json` · `GET /.well-known/agent.json` ·
39
+ * `POST /a2a` (JSON-RPC) · optional `GET /a2a/health`.
40
+ */
41
+ export declare function createA2aInboundHandler(options: A2aInboundOptions): (req: IncomingMessage, res: ServerResponse) => boolean | Promise<boolean>;
42
+ //# sourceMappingURL=inbound.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAML,WAAW,EAOZ,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAChC;AAmCD,kEAAkE;AAClE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAW7B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmC1B;AA6GD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,GACzB,CACD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,KAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAuG9B"}