@artinet/sdk 0.5.12 → 0.5.14

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 (480) hide show
  1. package/README.md +40 -81
  2. package/dist/client/a2a-client.d.ts +16 -7
  3. package/dist/client/a2a-client.js +25 -14
  4. package/dist/client/index.d.ts +0 -1
  5. package/dist/client/index.js +0 -1
  6. package/dist/index.d.ts +0 -1
  7. package/dist/index.js +0 -1
  8. package/dist/server/express/errors.d.ts +0 -1
  9. package/dist/server/express/errors.js +0 -1
  10. package/dist/server/express/index.d.ts +0 -1
  11. package/dist/server/express/index.js +0 -1
  12. package/dist/server/express/middeware.d.ts +0 -1
  13. package/dist/server/express/middeware.js +0 -1
  14. package/dist/server/express/server.d.ts +0 -1
  15. package/dist/server/express/server.js +0 -1
  16. package/dist/server/index.d.ts +0 -1
  17. package/dist/server/index.js +0 -1
  18. package/dist/services/a2a/factory/builder.d.ts +0 -1
  19. package/dist/services/a2a/factory/builder.js +0 -1
  20. package/dist/services/a2a/factory/context.d.ts +0 -1
  21. package/dist/services/a2a/factory/context.js +0 -1
  22. package/dist/services/a2a/factory/event.d.ts +0 -1
  23. package/dist/services/a2a/factory/event.js +0 -1
  24. package/dist/services/a2a/factory/index.d.ts +0 -1
  25. package/dist/services/a2a/factory/index.js +0 -1
  26. package/dist/services/a2a/factory/method.d.ts +0 -1
  27. package/dist/services/a2a/factory/method.js +0 -1
  28. package/dist/services/a2a/factory/service.d.ts +0 -1
  29. package/dist/services/a2a/factory/service.js +0 -1
  30. package/dist/services/a2a/helpers/content.d.ts +0 -1
  31. package/dist/services/a2a/helpers/content.js +0 -1
  32. package/dist/services/a2a/helpers/index.d.ts +1 -1
  33. package/dist/services/a2a/helpers/index.js +1 -1
  34. package/dist/services/a2a/helpers/message-builder.d.ts +12 -0
  35. package/dist/services/a2a/helpers/message-builder.js +61 -0
  36. package/dist/services/a2a/helpers/part.d.ts +0 -1
  37. package/dist/services/a2a/helpers/part.js +0 -1
  38. package/dist/services/a2a/index.d.ts +0 -1
  39. package/dist/services/a2a/index.js +0 -1
  40. package/dist/services/a2a/managers/cancellation.d.ts +0 -1
  41. package/dist/services/a2a/managers/cancellation.js +0 -1
  42. package/dist/services/a2a/managers/connection.d.ts +0 -1
  43. package/dist/services/a2a/managers/connection.js +0 -1
  44. package/dist/services/a2a/managers/context.d.ts +0 -1
  45. package/dist/services/a2a/managers/context.js +0 -1
  46. package/dist/services/a2a/managers/index.d.ts +0 -1
  47. package/dist/services/a2a/managers/index.js +0 -1
  48. package/dist/services/a2a/managers/task.d.ts +0 -1
  49. package/dist/services/a2a/managers/task.js +0 -1
  50. package/dist/services/a2a/methods/cancel-task.d.ts +0 -1
  51. package/dist/services/a2a/methods/cancel-task.js +0 -1
  52. package/dist/services/a2a/methods/get-task.d.ts +0 -1
  53. package/dist/services/a2a/methods/get-task.js +0 -1
  54. package/dist/services/a2a/methods/index.d.ts +0 -1
  55. package/dist/services/a2a/methods/index.js +0 -1
  56. package/dist/services/a2a/methods/resubscribe-task.d.ts +0 -1
  57. package/dist/services/a2a/methods/resubscribe-task.js +0 -1
  58. package/dist/services/a2a/methods/send-message.d.ts +0 -1
  59. package/dist/services/a2a/methods/send-message.js +0 -1
  60. package/dist/services/a2a/methods/stream-message.d.ts +0 -1
  61. package/dist/services/a2a/methods/stream-message.js +0 -1
  62. package/dist/services/a2a/service.d.ts +2 -3
  63. package/dist/services/a2a/service.js +3 -3
  64. package/dist/services/a2a/state/index.d.ts +0 -1
  65. package/dist/services/a2a/state/index.js +0 -1
  66. package/dist/services/a2a/state/load.d.ts +0 -1
  67. package/dist/services/a2a/state/load.js +2 -1
  68. package/dist/services/a2a/state/process.d.ts +0 -1
  69. package/dist/services/a2a/state/process.js +0 -1
  70. package/dist/services/a2a/state/update/artifact.d.ts +0 -1
  71. package/dist/services/a2a/state/update/artifact.js +0 -1
  72. package/dist/services/a2a/state/update/index.d.ts +0 -1
  73. package/dist/services/a2a/state/update/index.js +0 -1
  74. package/dist/services/a2a/state/update/update.d.ts +0 -1
  75. package/dist/services/a2a/state/update/update.js +0 -1
  76. package/dist/services/core/execution/execute.d.ts +0 -1
  77. package/dist/services/core/execution/execute.js +0 -1
  78. package/dist/services/core/execution/index.d.ts +0 -1
  79. package/dist/services/core/execution/index.js +0 -1
  80. package/dist/services/core/index.d.ts +0 -1
  81. package/dist/services/core/index.js +0 -1
  82. package/dist/services/core/managers/command.d.ts +0 -1
  83. package/dist/services/core/managers/command.js +0 -1
  84. package/dist/services/core/managers/event.d.ts +0 -1
  85. package/dist/services/core/managers/event.js +0 -1
  86. package/dist/services/core/managers/index.d.ts +0 -1
  87. package/dist/services/core/managers/index.js +0 -1
  88. package/dist/services/core/managers/stream.d.ts +0 -1
  89. package/dist/services/core/managers/stream.js +0 -1
  90. package/dist/services/index.d.ts +0 -1
  91. package/dist/services/index.js +0 -1
  92. package/dist/services/mcp/index.d.ts +0 -1
  93. package/dist/services/mcp/index.js +0 -1
  94. package/dist/services/mcp/service.d.ts +0 -1
  95. package/dist/services/mcp/service.js +0 -1
  96. package/dist/transport/index.d.ts +0 -1
  97. package/dist/transport/index.js +0 -1
  98. package/dist/transport/rpc/parser.d.ts +0 -1
  99. package/dist/transport/rpc/parser.js +0 -1
  100. package/dist/transport/rpc/rpc-client.d.ts +0 -1
  101. package/dist/transport/rpc/rpc-client.js +0 -1
  102. package/dist/transport/streaming/event-stream.d.ts +0 -1
  103. package/dist/transport/streaming/event-stream.js +0 -1
  104. package/dist/transport/trpc/a2a/factory/index.d.ts +0 -1
  105. package/dist/transport/trpc/a2a/factory/index.js +0 -1
  106. package/dist/transport/trpc/a2a/factory/router.d.ts +0 -1
  107. package/dist/transport/trpc/a2a/factory/router.js +0 -1
  108. package/dist/transport/trpc/a2a/index.d.ts +0 -1
  109. package/dist/transport/trpc/a2a/index.js +0 -1
  110. package/dist/transport/trpc/a2a/routes/index.d.ts +0 -1
  111. package/dist/transport/trpc/a2a/routes/index.js +0 -1
  112. package/dist/transport/trpc/a2a/routes/info.d.ts +0 -1
  113. package/dist/transport/trpc/a2a/routes/info.js +0 -1
  114. package/dist/transport/trpc/a2a/routes/message/index.d.ts +0 -1
  115. package/dist/transport/trpc/a2a/routes/message/index.js +0 -1
  116. package/dist/transport/trpc/a2a/routes/message/route.d.ts +0 -1
  117. package/dist/transport/trpc/a2a/routes/message/route.js +0 -1
  118. package/dist/transport/trpc/a2a/routes/tasks/index.d.ts +0 -1
  119. package/dist/transport/trpc/a2a/routes/tasks/index.js +0 -1
  120. package/dist/transport/trpc/a2a/routes/tasks/route.d.ts +0 -1
  121. package/dist/transport/trpc/a2a/routes/tasks/route.js +0 -1
  122. package/dist/transport/trpc/a2a/trpc.d.ts +0 -1
  123. package/dist/transport/trpc/a2a/trpc.js +0 -1
  124. package/dist/transport/trpc/index.d.ts +0 -1
  125. package/dist/transport/trpc/index.js +0 -1
  126. package/dist/types/ext.d.ts +0 -1
  127. package/dist/types/ext.js +0 -1
  128. package/dist/types/index.d.ts +0 -1
  129. package/dist/types/index.js +0 -1
  130. package/dist/types/interfaces/client.d.ts +2 -3
  131. package/dist/types/interfaces/client.js +0 -1
  132. package/dist/types/interfaces/index.d.ts +0 -1
  133. package/dist/types/interfaces/index.js +0 -1
  134. package/dist/types/interfaces/services/a2a/builder.d.ts +0 -1
  135. package/dist/types/interfaces/services/a2a/builder.js +0 -1
  136. package/dist/types/interfaces/services/a2a/context.d.ts +0 -1
  137. package/dist/types/interfaces/services/a2a/context.js +0 -1
  138. package/dist/types/interfaces/services/a2a/engine.d.ts +0 -1
  139. package/dist/types/interfaces/services/a2a/engine.js +0 -1
  140. package/dist/types/interfaces/services/a2a/index.d.ts +0 -1
  141. package/dist/types/interfaces/services/a2a/index.js +0 -1
  142. package/dist/types/interfaces/services/a2a/legacy.d.ts +0 -1
  143. package/dist/types/interfaces/services/a2a/legacy.js +0 -1
  144. package/dist/types/interfaces/services/a2a/service.d.ts +0 -1
  145. package/dist/types/interfaces/services/a2a/service.js +0 -1
  146. package/dist/types/interfaces/services/core/context/command.d.ts +0 -1
  147. package/dist/types/interfaces/services/core/context/command.js +0 -1
  148. package/dist/types/interfaces/services/core/context/context.d.ts +0 -1
  149. package/dist/types/interfaces/services/core/context/context.js +0 -1
  150. package/dist/types/interfaces/services/core/context/index.d.ts +0 -1
  151. package/dist/types/interfaces/services/core/context/index.js +0 -1
  152. package/dist/types/interfaces/services/core/context/types.d.ts +0 -1
  153. package/dist/types/interfaces/services/core/context/types.js +0 -1
  154. package/dist/types/interfaces/services/core/execution/engine.d.ts +0 -1
  155. package/dist/types/interfaces/services/core/execution/engine.js +0 -1
  156. package/dist/types/interfaces/services/core/execution/environment.d.ts +0 -1
  157. package/dist/types/interfaces/services/core/execution/environment.js +0 -1
  158. package/dist/types/interfaces/services/core/execution/execute.d.ts +0 -1
  159. package/dist/types/interfaces/services/core/execution/execute.js +0 -1
  160. package/dist/types/interfaces/services/core/execution/index.d.ts +0 -1
  161. package/dist/types/interfaces/services/core/execution/index.js +0 -1
  162. package/dist/types/interfaces/services/core/index.d.ts +0 -1
  163. package/dist/types/interfaces/services/core/index.js +0 -1
  164. package/dist/types/interfaces/services/core/managers/cancellation.d.ts +0 -1
  165. package/dist/types/interfaces/services/core/managers/cancellation.js +0 -1
  166. package/dist/types/interfaces/services/core/managers/connection.d.ts +0 -1
  167. package/dist/types/interfaces/services/core/managers/connection.js +0 -1
  168. package/dist/types/interfaces/services/core/managers/context.d.ts +0 -1
  169. package/dist/types/interfaces/services/core/managers/context.js +0 -1
  170. package/dist/types/interfaces/services/core/managers/event.d.ts +0 -1
  171. package/dist/types/interfaces/services/core/managers/event.js +0 -1
  172. package/dist/types/interfaces/services/core/managers/index.d.ts +0 -1
  173. package/dist/types/interfaces/services/core/managers/index.js +0 -1
  174. package/dist/types/interfaces/services/core/managers/stream.d.ts +0 -1
  175. package/dist/types/interfaces/services/core/managers/stream.js +0 -1
  176. package/dist/types/interfaces/services/core/managers/task.d.ts +0 -1
  177. package/dist/types/interfaces/services/core/managers/task.js +0 -1
  178. package/dist/types/interfaces/services/core/service.d.ts +0 -1
  179. package/dist/types/interfaces/services/core/service.js +0 -1
  180. package/dist/types/interfaces/services/index.d.ts +0 -1
  181. package/dist/types/interfaces/services/index.js +0 -1
  182. package/dist/types/interfaces/services/mcp/index.d.ts +0 -1
  183. package/dist/types/interfaces/services/mcp/index.js +0 -1
  184. package/dist/types/interfaces/services/mcp/service.d.ts +0 -1
  185. package/dist/types/interfaces/services/mcp/service.js +0 -1
  186. package/dist/types/interfaces/services/protocol.d.ts +0 -1
  187. package/dist/types/interfaces/services/protocol.js +0 -1
  188. package/dist/types/interfaces/storage.d.ts +0 -1
  189. package/dist/types/interfaces/storage.js +0 -1
  190. package/dist/types/schemas/a2a/agent.d.ts +0 -1
  191. package/dist/types/schemas/a2a/agent.js +0 -1
  192. package/dist/types/schemas/a2a/auth.d.ts +0 -1
  193. package/dist/types/schemas/a2a/auth.js +0 -1
  194. package/dist/types/schemas/a2a/error.d.ts +0 -1
  195. package/dist/types/schemas/a2a/error.js +0 -1
  196. package/dist/types/schemas/a2a/index.d.ts +0 -1
  197. package/dist/types/schemas/a2a/index.js +0 -1
  198. package/dist/types/schemas/a2a/kind.d.ts +0 -1
  199. package/dist/types/schemas/a2a/kind.js +0 -1
  200. package/dist/types/schemas/a2a/message.d.ts +0 -1
  201. package/dist/types/schemas/a2a/message.js +0 -1
  202. package/dist/types/schemas/a2a/notification.d.ts +0 -1
  203. package/dist/types/schemas/a2a/notification.js +0 -1
  204. package/dist/types/schemas/a2a/parameters.d.ts +0 -1
  205. package/dist/types/schemas/a2a/parameters.js +0 -1
  206. package/dist/types/schemas/a2a/protocol.d.ts +0 -1
  207. package/dist/types/schemas/a2a/protocol.js +0 -1
  208. package/dist/types/schemas/a2a/rpc.d.ts +0 -1
  209. package/dist/types/schemas/a2a/rpc.js +0 -1
  210. package/dist/types/schemas/a2a/task.d.ts +0 -1
  211. package/dist/types/schemas/a2a/task.js +0 -1
  212. package/dist/types/schemas/a2a/transport.d.ts +0 -1
  213. package/dist/types/schemas/a2a/transport.js +0 -1
  214. package/dist/types/schemas/index.d.ts +0 -1
  215. package/dist/types/schemas/index.js +0 -1
  216. package/dist/types/utils/index.d.ts +0 -1
  217. package/dist/types/utils/index.js +0 -1
  218. package/dist/types/utils/transform.d.ts +0 -1
  219. package/dist/types/utils/transform.js +0 -1
  220. package/dist/utils/common/constants.d.ts +6 -5
  221. package/dist/utils/common/constants.js +15 -27
  222. package/dist/utils/common/errors.d.ts +0 -1
  223. package/dist/utils/common/errors.js +0 -1
  224. package/dist/utils/common/utils.d.ts +0 -1
  225. package/dist/utils/common/utils.js +0 -1
  226. package/dist/utils/common/zAsyncIterable-v3.d.ts +0 -1
  227. package/dist/utils/common/zAsyncIterable-v3.js +0 -1
  228. package/dist/utils/common/zAsyncIterable.d.ts +0 -1
  229. package/dist/utils/common/zAsyncIterable.js +0 -1
  230. package/dist/utils/index.d.ts +0 -1
  231. package/dist/utils/index.js +0 -1
  232. package/dist/utils/logging/index.d.ts +0 -1
  233. package/dist/utils/logging/index.js +0 -1
  234. package/dist/utils/logging/log.d.ts +0 -1
  235. package/dist/utils/logging/log.js +0 -1
  236. package/dist/utils/logging/logger.d.ts +0 -1
  237. package/dist/utils/logging/logger.js +0 -1
  238. package/dist/utils/storage/file.d.ts +0 -1
  239. package/dist/utils/storage/file.js +0 -1
  240. package/dist/utils/storage/memory.d.ts +0 -1
  241. package/dist/utils/storage/memory.js +0 -1
  242. package/package.json +3 -2
  243. package/dist/client/a2a-client.d.ts.map +0 -1
  244. package/dist/client/a2a-client.js.map +0 -1
  245. package/dist/client/index.d.ts.map +0 -1
  246. package/dist/client/index.js.map +0 -1
  247. package/dist/index.d.ts.map +0 -1
  248. package/dist/index.js.map +0 -1
  249. package/dist/server/express/errors.d.ts.map +0 -1
  250. package/dist/server/express/errors.js.map +0 -1
  251. package/dist/server/express/index.d.ts.map +0 -1
  252. package/dist/server/express/index.js.map +0 -1
  253. package/dist/server/express/middeware.d.ts.map +0 -1
  254. package/dist/server/express/middeware.js.map +0 -1
  255. package/dist/server/express/server.d.ts.map +0 -1
  256. package/dist/server/express/server.js.map +0 -1
  257. package/dist/server/index.d.ts.map +0 -1
  258. package/dist/server/index.js.map +0 -1
  259. package/dist/services/a2a/factory/builder.d.ts.map +0 -1
  260. package/dist/services/a2a/factory/builder.js.map +0 -1
  261. package/dist/services/a2a/factory/context.d.ts.map +0 -1
  262. package/dist/services/a2a/factory/context.js.map +0 -1
  263. package/dist/services/a2a/factory/event.d.ts.map +0 -1
  264. package/dist/services/a2a/factory/event.js.map +0 -1
  265. package/dist/services/a2a/factory/index.d.ts.map +0 -1
  266. package/dist/services/a2a/factory/index.js.map +0 -1
  267. package/dist/services/a2a/factory/method.d.ts.map +0 -1
  268. package/dist/services/a2a/factory/method.js.map +0 -1
  269. package/dist/services/a2a/factory/service.d.ts.map +0 -1
  270. package/dist/services/a2a/factory/service.js.map +0 -1
  271. package/dist/services/a2a/helpers/content.d.ts.map +0 -1
  272. package/dist/services/a2a/helpers/content.js.map +0 -1
  273. package/dist/services/a2a/helpers/index.d.ts.map +0 -1
  274. package/dist/services/a2a/helpers/index.js.map +0 -1
  275. package/dist/services/a2a/helpers/part.d.ts.map +0 -1
  276. package/dist/services/a2a/helpers/part.js.map +0 -1
  277. package/dist/services/a2a/index.d.ts.map +0 -1
  278. package/dist/services/a2a/index.js.map +0 -1
  279. package/dist/services/a2a/managers/cancellation.d.ts.map +0 -1
  280. package/dist/services/a2a/managers/cancellation.js.map +0 -1
  281. package/dist/services/a2a/managers/connection.d.ts.map +0 -1
  282. package/dist/services/a2a/managers/connection.js.map +0 -1
  283. package/dist/services/a2a/managers/context.d.ts.map +0 -1
  284. package/dist/services/a2a/managers/context.js.map +0 -1
  285. package/dist/services/a2a/managers/index.d.ts.map +0 -1
  286. package/dist/services/a2a/managers/index.js.map +0 -1
  287. package/dist/services/a2a/managers/task.d.ts.map +0 -1
  288. package/dist/services/a2a/managers/task.js.map +0 -1
  289. package/dist/services/a2a/methods/cancel-task.d.ts.map +0 -1
  290. package/dist/services/a2a/methods/cancel-task.js.map +0 -1
  291. package/dist/services/a2a/methods/get-task.d.ts.map +0 -1
  292. package/dist/services/a2a/methods/get-task.js.map +0 -1
  293. package/dist/services/a2a/methods/index.d.ts.map +0 -1
  294. package/dist/services/a2a/methods/index.js.map +0 -1
  295. package/dist/services/a2a/methods/resubscribe-task.d.ts.map +0 -1
  296. package/dist/services/a2a/methods/resubscribe-task.js.map +0 -1
  297. package/dist/services/a2a/methods/send-message.d.ts.map +0 -1
  298. package/dist/services/a2a/methods/send-message.js.map +0 -1
  299. package/dist/services/a2a/methods/stream-message.d.ts.map +0 -1
  300. package/dist/services/a2a/methods/stream-message.js.map +0 -1
  301. package/dist/services/a2a/service.d.ts.map +0 -1
  302. package/dist/services/a2a/service.js.map +0 -1
  303. package/dist/services/a2a/state/index.d.ts.map +0 -1
  304. package/dist/services/a2a/state/index.js.map +0 -1
  305. package/dist/services/a2a/state/load.d.ts.map +0 -1
  306. package/dist/services/a2a/state/load.js.map +0 -1
  307. package/dist/services/a2a/state/process.d.ts.map +0 -1
  308. package/dist/services/a2a/state/process.js.map +0 -1
  309. package/dist/services/a2a/state/update/artifact.d.ts.map +0 -1
  310. package/dist/services/a2a/state/update/artifact.js.map +0 -1
  311. package/dist/services/a2a/state/update/index.d.ts.map +0 -1
  312. package/dist/services/a2a/state/update/index.js.map +0 -1
  313. package/dist/services/a2a/state/update/update.d.ts.map +0 -1
  314. package/dist/services/a2a/state/update/update.js.map +0 -1
  315. package/dist/services/core/execution/execute.d.ts.map +0 -1
  316. package/dist/services/core/execution/execute.js.map +0 -1
  317. package/dist/services/core/execution/index.d.ts.map +0 -1
  318. package/dist/services/core/execution/index.js.map +0 -1
  319. package/dist/services/core/index.d.ts.map +0 -1
  320. package/dist/services/core/index.js.map +0 -1
  321. package/dist/services/core/managers/command.d.ts.map +0 -1
  322. package/dist/services/core/managers/command.js.map +0 -1
  323. package/dist/services/core/managers/event.d.ts.map +0 -1
  324. package/dist/services/core/managers/event.js.map +0 -1
  325. package/dist/services/core/managers/index.d.ts.map +0 -1
  326. package/dist/services/core/managers/index.js.map +0 -1
  327. package/dist/services/core/managers/stream.d.ts.map +0 -1
  328. package/dist/services/core/managers/stream.js.map +0 -1
  329. package/dist/services/index.d.ts.map +0 -1
  330. package/dist/services/index.js.map +0 -1
  331. package/dist/services/mcp/index.d.ts.map +0 -1
  332. package/dist/services/mcp/index.js.map +0 -1
  333. package/dist/services/mcp/service.d.ts.map +0 -1
  334. package/dist/services/mcp/service.js.map +0 -1
  335. package/dist/transport/index.d.ts.map +0 -1
  336. package/dist/transport/index.js.map +0 -1
  337. package/dist/transport/rpc/parser.d.ts.map +0 -1
  338. package/dist/transport/rpc/parser.js.map +0 -1
  339. package/dist/transport/rpc/rpc-client.d.ts.map +0 -1
  340. package/dist/transport/rpc/rpc-client.js.map +0 -1
  341. package/dist/transport/streaming/event-stream.d.ts.map +0 -1
  342. package/dist/transport/streaming/event-stream.js.map +0 -1
  343. package/dist/transport/trpc/a2a/factory/index.d.ts.map +0 -1
  344. package/dist/transport/trpc/a2a/factory/index.js.map +0 -1
  345. package/dist/transport/trpc/a2a/factory/router.d.ts.map +0 -1
  346. package/dist/transport/trpc/a2a/factory/router.js.map +0 -1
  347. package/dist/transport/trpc/a2a/index.d.ts.map +0 -1
  348. package/dist/transport/trpc/a2a/index.js.map +0 -1
  349. package/dist/transport/trpc/a2a/routes/index.d.ts.map +0 -1
  350. package/dist/transport/trpc/a2a/routes/index.js.map +0 -1
  351. package/dist/transport/trpc/a2a/routes/info.d.ts.map +0 -1
  352. package/dist/transport/trpc/a2a/routes/info.js.map +0 -1
  353. package/dist/transport/trpc/a2a/routes/message/index.d.ts.map +0 -1
  354. package/dist/transport/trpc/a2a/routes/message/index.js.map +0 -1
  355. package/dist/transport/trpc/a2a/routes/message/route.d.ts.map +0 -1
  356. package/dist/transport/trpc/a2a/routes/message/route.js.map +0 -1
  357. package/dist/transport/trpc/a2a/routes/tasks/index.d.ts.map +0 -1
  358. package/dist/transport/trpc/a2a/routes/tasks/index.js.map +0 -1
  359. package/dist/transport/trpc/a2a/routes/tasks/route.d.ts.map +0 -1
  360. package/dist/transport/trpc/a2a/routes/tasks/route.js.map +0 -1
  361. package/dist/transport/trpc/a2a/trpc.d.ts.map +0 -1
  362. package/dist/transport/trpc/a2a/trpc.js.map +0 -1
  363. package/dist/transport/trpc/index.d.ts.map +0 -1
  364. package/dist/transport/trpc/index.js.map +0 -1
  365. package/dist/types/ext.d.ts.map +0 -1
  366. package/dist/types/ext.js.map +0 -1
  367. package/dist/types/index.d.ts.map +0 -1
  368. package/dist/types/index.js.map +0 -1
  369. package/dist/types/interfaces/client.d.ts.map +0 -1
  370. package/dist/types/interfaces/client.js.map +0 -1
  371. package/dist/types/interfaces/index.d.ts.map +0 -1
  372. package/dist/types/interfaces/index.js.map +0 -1
  373. package/dist/types/interfaces/services/a2a/builder.d.ts.map +0 -1
  374. package/dist/types/interfaces/services/a2a/builder.js.map +0 -1
  375. package/dist/types/interfaces/services/a2a/context.d.ts.map +0 -1
  376. package/dist/types/interfaces/services/a2a/context.js.map +0 -1
  377. package/dist/types/interfaces/services/a2a/engine.d.ts.map +0 -1
  378. package/dist/types/interfaces/services/a2a/engine.js.map +0 -1
  379. package/dist/types/interfaces/services/a2a/index.d.ts.map +0 -1
  380. package/dist/types/interfaces/services/a2a/index.js.map +0 -1
  381. package/dist/types/interfaces/services/a2a/legacy.d.ts.map +0 -1
  382. package/dist/types/interfaces/services/a2a/legacy.js.map +0 -1
  383. package/dist/types/interfaces/services/a2a/service.d.ts.map +0 -1
  384. package/dist/types/interfaces/services/a2a/service.js.map +0 -1
  385. package/dist/types/interfaces/services/core/context/command.d.ts.map +0 -1
  386. package/dist/types/interfaces/services/core/context/command.js.map +0 -1
  387. package/dist/types/interfaces/services/core/context/context.d.ts.map +0 -1
  388. package/dist/types/interfaces/services/core/context/context.js.map +0 -1
  389. package/dist/types/interfaces/services/core/context/index.d.ts.map +0 -1
  390. package/dist/types/interfaces/services/core/context/index.js.map +0 -1
  391. package/dist/types/interfaces/services/core/context/types.d.ts.map +0 -1
  392. package/dist/types/interfaces/services/core/context/types.js.map +0 -1
  393. package/dist/types/interfaces/services/core/execution/engine.d.ts.map +0 -1
  394. package/dist/types/interfaces/services/core/execution/engine.js.map +0 -1
  395. package/dist/types/interfaces/services/core/execution/environment.d.ts.map +0 -1
  396. package/dist/types/interfaces/services/core/execution/environment.js.map +0 -1
  397. package/dist/types/interfaces/services/core/execution/execute.d.ts.map +0 -1
  398. package/dist/types/interfaces/services/core/execution/execute.js.map +0 -1
  399. package/dist/types/interfaces/services/core/execution/index.d.ts.map +0 -1
  400. package/dist/types/interfaces/services/core/execution/index.js.map +0 -1
  401. package/dist/types/interfaces/services/core/index.d.ts.map +0 -1
  402. package/dist/types/interfaces/services/core/index.js.map +0 -1
  403. package/dist/types/interfaces/services/core/managers/cancellation.d.ts.map +0 -1
  404. package/dist/types/interfaces/services/core/managers/cancellation.js.map +0 -1
  405. package/dist/types/interfaces/services/core/managers/connection.d.ts.map +0 -1
  406. package/dist/types/interfaces/services/core/managers/connection.js.map +0 -1
  407. package/dist/types/interfaces/services/core/managers/context.d.ts.map +0 -1
  408. package/dist/types/interfaces/services/core/managers/context.js.map +0 -1
  409. package/dist/types/interfaces/services/core/managers/event.d.ts.map +0 -1
  410. package/dist/types/interfaces/services/core/managers/event.js.map +0 -1
  411. package/dist/types/interfaces/services/core/managers/index.d.ts.map +0 -1
  412. package/dist/types/interfaces/services/core/managers/index.js.map +0 -1
  413. package/dist/types/interfaces/services/core/managers/stream.d.ts.map +0 -1
  414. package/dist/types/interfaces/services/core/managers/stream.js.map +0 -1
  415. package/dist/types/interfaces/services/core/managers/task.d.ts.map +0 -1
  416. package/dist/types/interfaces/services/core/managers/task.js.map +0 -1
  417. package/dist/types/interfaces/services/core/service.d.ts.map +0 -1
  418. package/dist/types/interfaces/services/core/service.js.map +0 -1
  419. package/dist/types/interfaces/services/index.d.ts.map +0 -1
  420. package/dist/types/interfaces/services/index.js.map +0 -1
  421. package/dist/types/interfaces/services/mcp/index.d.ts.map +0 -1
  422. package/dist/types/interfaces/services/mcp/index.js.map +0 -1
  423. package/dist/types/interfaces/services/mcp/service.d.ts.map +0 -1
  424. package/dist/types/interfaces/services/mcp/service.js.map +0 -1
  425. package/dist/types/interfaces/services/protocol.d.ts.map +0 -1
  426. package/dist/types/interfaces/services/protocol.js.map +0 -1
  427. package/dist/types/interfaces/storage.d.ts.map +0 -1
  428. package/dist/types/interfaces/storage.js.map +0 -1
  429. package/dist/types/schemas/a2a/agent.d.ts.map +0 -1
  430. package/dist/types/schemas/a2a/agent.js.map +0 -1
  431. package/dist/types/schemas/a2a/auth.d.ts.map +0 -1
  432. package/dist/types/schemas/a2a/auth.js.map +0 -1
  433. package/dist/types/schemas/a2a/error.d.ts.map +0 -1
  434. package/dist/types/schemas/a2a/error.js.map +0 -1
  435. package/dist/types/schemas/a2a/index.d.ts.map +0 -1
  436. package/dist/types/schemas/a2a/index.js.map +0 -1
  437. package/dist/types/schemas/a2a/kind.d.ts.map +0 -1
  438. package/dist/types/schemas/a2a/kind.js.map +0 -1
  439. package/dist/types/schemas/a2a/message.d.ts.map +0 -1
  440. package/dist/types/schemas/a2a/message.js.map +0 -1
  441. package/dist/types/schemas/a2a/notification.d.ts.map +0 -1
  442. package/dist/types/schemas/a2a/notification.js.map +0 -1
  443. package/dist/types/schemas/a2a/parameters.d.ts.map +0 -1
  444. package/dist/types/schemas/a2a/parameters.js.map +0 -1
  445. package/dist/types/schemas/a2a/protocol.d.ts.map +0 -1
  446. package/dist/types/schemas/a2a/protocol.js.map +0 -1
  447. package/dist/types/schemas/a2a/rpc.d.ts.map +0 -1
  448. package/dist/types/schemas/a2a/rpc.js.map +0 -1
  449. package/dist/types/schemas/a2a/task.d.ts.map +0 -1
  450. package/dist/types/schemas/a2a/task.js.map +0 -1
  451. package/dist/types/schemas/a2a/transport.d.ts.map +0 -1
  452. package/dist/types/schemas/a2a/transport.js.map +0 -1
  453. package/dist/types/schemas/index.d.ts.map +0 -1
  454. package/dist/types/schemas/index.js.map +0 -1
  455. package/dist/types/utils/index.d.ts.map +0 -1
  456. package/dist/types/utils/index.js.map +0 -1
  457. package/dist/types/utils/transform.d.ts.map +0 -1
  458. package/dist/types/utils/transform.js.map +0 -1
  459. package/dist/utils/common/constants.d.ts.map +0 -1
  460. package/dist/utils/common/constants.js.map +0 -1
  461. package/dist/utils/common/errors.d.ts.map +0 -1
  462. package/dist/utils/common/errors.js.map +0 -1
  463. package/dist/utils/common/utils.d.ts.map +0 -1
  464. package/dist/utils/common/utils.js.map +0 -1
  465. package/dist/utils/common/zAsyncIterable-v3.d.ts.map +0 -1
  466. package/dist/utils/common/zAsyncIterable-v3.js.map +0 -1
  467. package/dist/utils/common/zAsyncIterable.d.ts.map +0 -1
  468. package/dist/utils/common/zAsyncIterable.js.map +0 -1
  469. package/dist/utils/index.d.ts.map +0 -1
  470. package/dist/utils/index.js.map +0 -1
  471. package/dist/utils/logging/index.d.ts.map +0 -1
  472. package/dist/utils/logging/index.js.map +0 -1
  473. package/dist/utils/logging/log.d.ts.map +0 -1
  474. package/dist/utils/logging/log.js.map +0 -1
  475. package/dist/utils/logging/logger.d.ts.map +0 -1
  476. package/dist/utils/logging/logger.js.map +0 -1
  477. package/dist/utils/storage/file.d.ts.map +0 -1
  478. package/dist/utils/storage/file.js.map +0 -1
  479. package/dist/utils/storage/memory.d.ts.map +0 -1
  480. package/dist/utils/storage/memory.js.map +0 -1
package/README.md CHANGED
@@ -6,13 +6,17 @@
6
6
  [![GitHub stars](https://img.shields.io/github/stars/the-artinet-project/artinet-sdk?style=social)](https://github.com/the-artinet-project/artinet-sdk/stargazers)
7
7
  [![Discord](https://dcbadge.limes.pink/api/server/DaxzSchmmX?style=flat)](https://discord.gg/DaxzSchmmX)
8
8
 
9
- <!-- [![Coverage Status](https://coveralls.io/repos/github/the-artinet-project/artinet-sdk/badge.svg?branch=main)](https://coveralls.io/github/the-artinet-project/artinet-sdk?branch=main) -->
9
+ # artinet-sdk
10
10
 
11
- # artinet SDK
11
+ Give your AI agent the power to communicate with any other agent, no matter the framework.
12
12
 
13
- The artinet SDK is a TypeScript library designed for Agentic Communication. It's written for [node.js](https://nodejs.org/) and aims to simplify the creation of interoperable AI agents. Learn more at [the artinet project](https://artinet.io/).
13
+ The artinet-sdk is a TypeScript library that adds a standardized, interoperable communication layer to your agents.
14
14
 
15
- This SDK leverages a service-oriented architecture for building AI agents allowing developers to easily create agents as simple processes or seamlessly embed them within a dedicated server.
15
+ ## Features
16
+
17
+ - **Easy To Use:** The AgentBuilder lets you quickly create an Agent2Agent API, while handling all of the communication complexity.
18
+ - **No Vendor Lock-In:** Create agents that can communicate with other agents across frameworks and ecosystems with just a few lines of code.
19
+ - **Flexible Design:** Everything you need to build collaborative agents while remaining modular enough for advanced configuration.
16
20
 
17
21
  ## Quick Start
18
22
 
@@ -26,10 +30,10 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
26
30
 
27
31
  ## Table of Contents
28
32
 
29
- - [artinet SDK](#artinet-sdk)
33
+ - [artinet-sdk](#artinet-sdk)
34
+ - [Features](#features)
30
35
  - [Quick Start](#quick-start)
31
36
  - [Table of Contents](#table-of-contents)
32
- - [Features](#features)
33
37
  - [Installation](#installation)
34
38
  - [Requirements](#requirements)
35
39
  - [Example](#example)
@@ -62,14 +66,9 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
62
66
  - AgentBuilder now prefers the contextId & taskId from the calling context.
63
67
  - In a future release the following packages will be set as peer dependancies to reduce the size of the build: `@modelcontextprotocol/sdk`, `@trpc/server`, `cors`, `express`
64
68
  - The `history` object from `TaskAndHistory` is deprecated and no longer being updated. Use `Task.history` instead.
65
- - The A2AClient now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
66
-
67
- ## Features
68
-
69
- - **Modular Design:** Everything you need to get started building collaborative agents while remaining flexible enough for advanced configuration.
70
- - **Express Style Agent API:** Similar to scaffolding an Express Server, you can use the AgentBuilder to create an Agent2Agent API.
71
- - Then wrap it in an actual Express Server with the `createAgentServer()` function. It handles all of the transport-layer complexity, adds A2A <-> JSON-RPC middleware, and manages Server-Sent Events (SSE) automatically.
72
- - **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
69
+ - The `A2AClient` now checks `/.well-known/agent-card.json` as a opposed to `/.well-known/agent.json` in-line with the A2A spec.
70
+ - The `A2AClient` now uses uses the `AgentCard`.url if an `AgentCard` has been successfully retrieved, else it will default to the `baseUrl`.
71
+ - The examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent).
73
72
 
74
73
  ## Installation
75
74
 
@@ -98,36 +97,29 @@ A basic A2A server and client interaction (For simple agents see the [AgentBuild
98
97
  import {
99
98
  createAgentServer,
100
99
  AgentBuilder,
101
- TaskandHistory
100
+ Task
102
101
  } from "@artinet/sdk";
103
102
 
104
- //Define your Agents Behaviour
105
- const quickAgentEngine: AgentEngine = AgentBuilder()
103
+ // Create an agent server
104
+ const { app, agent } = createAgentServer({
105
+ agent: AgentBuilder()
106
106
  .text(async ({ content: userInput, context }) => {
107
- const task: TaskandHistory = context.State();
107
+ const task: Task = context.State().task;
108
108
  ...
109
109
  return `You said: ${userInput}`;
110
110
  })
111
- .createAgentEngine();
112
-
113
- // Create an agent server
114
- const { app, agent } = createAgentServer({
115
- agent: {
116
- engine: quickAgentEngine,
111
+ .createAgent({
117
112
  agentCard: {
118
113
  name: "QuickStart Agent",
114
+ description: "A simple agent that echoes the user's message",
119
115
  url: "http://localhost:4000/a2a",
120
116
  version: "0.1.0",
121
117
  capabilities: { streaming: true },
122
118
  skills: [{ id: "echo", name: "Echo Skill" }],
123
119
  ...
124
120
  },
125
- tasks: new TaskManager(),
126
- ...
127
- },
128
- basePath: "/a2a",
129
- agentCardPath: "/.well-known/agent-card.json"
130
- ...
121
+ }),
122
+ basePath: "/a2a"
131
123
  });
132
124
 
133
125
  app.listen(4000, () => {
@@ -143,15 +135,7 @@ import { A2AClient, TaskStatusUpdateEvent } from "@artinet/sdk";
143
135
  async function runClient() {
144
136
  const client = new A2AClient("http://localhost:4000/a2a");
145
137
 
146
- const message = {
147
- messageId: "test-message-id",
148
- kind: "message",
149
- role: "user",
150
- parts: [{ kind: "text", text: "Hello World!" }],
151
- ...
152
- };
153
-
154
- const stream = client.sendStreamingMessage({ message });
138
+ const stream = client.sendStreamingMessage("Hello World!");
155
139
 
156
140
  for await (const update of stream) {
157
141
  // process the updates
@@ -180,26 +164,16 @@ Interact with A2A-compliant agents using the `A2AClient`. See `examples/` for mo
180
164
  Send a message using `message/send`.
181
165
 
182
166
  ```typescript
183
- import { A2AClient, Message } from "@artinet/sdk";
167
+ import { A2AClient, Task } from "@artinet/sdk";
184
168
 
185
- async function runBasicTask() {
186
- const client = new A2AClient("https://your-a2a-server.com/a2a");
187
- const message: Message = {
188
- messageId: "test-message",
189
- kind: "message",
190
- role: "user",
191
- parts: [{ kind: "text", text: "What is the capital of France?" }],
192
- ...
193
- };
169
+ const client = new A2AClient("https://your-a2a-server.com/a2a");
194
170
 
195
- const task = await client.sendMessage({ message });
196
- console.log("Task Completed:", task);
197
- }
171
+ const task: Task = await client.sendMessage("What is the capital of France?");
198
172
  ```
199
173
 
200
174
  #### Streaming Updates
201
175
 
202
- Receive real-time updates via SSE using `message/stream` (recommended).
176
+ Receive real-time updates via SSE using `message/stream`.
203
177
 
204
178
  ```typescript
205
179
  import {
@@ -211,15 +185,8 @@ import {
211
185
 
212
186
  async function runStreamingTask() {
213
187
  const client = new A2AClient("https://your-a2a-server.com/a2a");
214
- const message: Message = {
215
- role: "user",
216
- parts: [{ kind: "text", text: "Tell me a short story." }],
217
- ...
218
- };
219
188
 
220
- const stream = client.sendStreamingMessage({
221
- message,
222
- });
189
+ const stream = client.sendStreamingMessage("Tell me a short story.");
223
190
 
224
191
  for await (const update of stream) {
225
192
  if ((update as TaskStatusUpdateEvent).status) {
@@ -261,12 +228,12 @@ The SDK provides a variety of options for creating complex ([AgentEngines](#agen
261
228
 
262
229
  ##### AgentBuilder
263
230
 
264
- **Option 1: Using the AgentBuilder (Recommended for Simple Workflows)**
231
+ **Option 1: Using the AgentBuilder (Recommended)**
265
232
 
266
233
  For simple agents with one or more processing steps, use the `AgentBuilder` pattern:
267
234
 
268
235
  ```typescript
269
- import { createAgentServer, AgentBuilder, TaskManager } from "@artinet/sdk";
236
+ import { createAgentServer, AgentBuilder } from "@artinet/sdk";
270
237
 
271
238
  //create a simple agent
272
239
  const simpleAgent = AgentBuilder().text(() => "hello world!");
@@ -306,7 +273,6 @@ const { app, agent } = createAgentServer({
306
273
  capabilities: { streaming: true },
307
274
  skills: [{ id: "multi-processor", name: "Multi-Step Processor" }],
308
275
  },
309
- tasks: new TaskManager(),
310
276
  }),
311
277
  basePath: "/a2a",
312
278
  });
@@ -334,7 +300,6 @@ import {
334
300
  createAgentServer,
335
301
  Context,
336
302
  AgentEngine,
337
- TaskManager,
338
303
  } from "@artinet/sdk";
339
304
 
340
305
  const myAgent: AgentEngine = async function* (context: Context) {
@@ -378,7 +343,6 @@ const { app, agent } = createAgentServer({
378
343
  skills: [{ id: "processor", name: "Text Processor" }],
379
344
  ...
380
345
  },
381
- tasks: new TaskManager(),
382
346
  },
383
347
  basePath: "/a2a",
384
348
  agentCardPath: "/.well-known/agent-card.json",
@@ -435,7 +399,7 @@ const agent = createAgent({
435
399
  },
436
400
  });
437
401
 
438
- const result = await agent.sendMessage({
402
+ const resultPromise = agent.sendMessage({
439
403
  contextId: "123"
440
404
  ...
441
405
  });
@@ -448,7 +412,7 @@ currentContext.events.on("complete", () {
448
412
  //errors thrown here will be triggered in the original context
449
413
  });
450
414
 
451
- //stream new commands into a running context
415
+ // Advanced: stream new commands into a running context
452
416
  (currentContext.command as SendCommandInterface<Command>).send({
453
417
  ...
454
418
  });
@@ -468,7 +432,7 @@ The EventManager supports the following event types:
468
432
 
469
433
  #### Persistent Storage
470
434
 
471
- For storage, use our out of the box storage providers like `FileStore`. Or implement the `Store` interface to create your own.
435
+ For Task storage, use one our simple storage providers like `FileStore`. Or implement the `Store` interface to create your own.
472
436
 
473
437
  ```typescript
474
438
  import path from "path";
@@ -497,7 +461,7 @@ const { app, agent } = createAgentServer({
497
461
 
498
462
  #### Advanced Server Customization
499
463
 
500
- Our new architecture provides multiple ways to customize your agent server:
464
+ Our architecture provides multiple ways to customize your agent server:
501
465
 
502
466
  **1. Using `createAgentServer`:**
503
467
  Easily spin up an A2A Express app `createAgentServer()`:
@@ -525,12 +489,12 @@ app.use("/custom", (req, res, next) => {
525
489
 
526
490
  ```
527
491
 
528
- **2. Use the JSON-RPC Middleware:**
492
+ **2. Using our JSON-RPC Middleware:**
529
493
  Directly import our preconfigured JSON-RPC middleware:
530
494
 
531
495
  ```typescript
532
496
  import express from "express";
533
- import { createAgent, jsonRPCMiddleware, errorHandler, InMemoryTaskStore } from "@artinet/sdk";
497
+ import { createAgent, jsonRPCMiddleware, errorHandler } from "@artinet/sdk";
534
498
 
535
499
  const customApp = express();
536
500
 
@@ -539,14 +503,13 @@ const agent = createAgent({
539
503
  agentCard: {
540
504
  ...
541
505
  },
542
- tasks: new InMemoryTaskStore(),
543
506
  });
544
507
 
545
508
  customApp.use("/auth", yourAuthMiddleware);
546
509
  customApp.use("/metrics", yourMetricsMiddleware);
547
510
  customApp.use(express.json());
548
511
 
549
- // Add the A2A middleware
512
+ // Add A2A middleware
550
513
  customApp.post("/", async (req, res, next) => {
551
514
  return await jsonRPCMiddleware(agent, req, res, next);
552
515
  });
@@ -565,6 +528,7 @@ const server = customApp.listen(3000, () => {
565
528
  ```
566
529
 
567
530
  **3. Using Custom Transport Layers:**
531
+
568
532
  Use our preconfigured TRPC router, or create your own integration with WebSockets & other protocols:
569
533
 
570
534
  ```typescript
@@ -574,6 +538,7 @@ const agentRouter = createAgentRouter();
574
538
  ```
575
539
 
576
540
  **Use the Agent:**
541
+
577
542
  Directly invoke the agent to use it locally:
578
543
 
579
544
  ```typescript
@@ -584,7 +549,6 @@ const agent = createAgent({
584
549
  agentCard: {
585
550
  ...
586
551
  },
587
- tasks: new InMemoryTaskStore(),
588
552
  });
589
553
 
590
554
  // Wrap these calls in your desired transport logic
@@ -679,7 +643,7 @@ const result = await client.callTool({
679
643
  - `cancel-task`: Cancel a running task
680
644
  - `agent://card`: Retrieve the AgentCard
681
645
  - `send-streaming-message`, `task-resubscribe` & `push-notifications` etc are currently not supported by default.
682
- - Leverage the A2A Zod Schemas to implement them manually.
646
+ - Leverage the A2A Zod Schemas to manually implement your own tools.
683
647
 
684
648
  ## Contributing
685
649
 
@@ -694,8 +658,3 @@ This project is licensed under the Apache License 2.0 - see the `LICENSE` file f
694
658
  ## Acknowledgements
695
659
 
696
660
  This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google-a2a/A2A).
697
-
698
- Libraries used include:
699
-
700
- - [Express.js](https://expressjs.com/) for the server framework.
701
- - [EventSource Parser](https://github.com/rexxars/eventsource-parser) for SSE streaming.
@@ -13,10 +13,20 @@ export declare class A2AClient implements Client {
13
13
  private cachedAgentCard;
14
14
  private customHeaders;
15
15
  private fallbackPath;
16
+ private agentUrl;
16
17
  /**
17
18
  * Creates a new A2AClient instance.
18
19
  * @param baseUrl The base URL for the A2A server.
19
20
  * @param headers Optional custom headers to include in all requests.
21
+ * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
22
+ * @example
23
+ * const client = new A2AClient("http://localhost:4000/a2a");
24
+ * const card = await client.agentCard();
25
+ * console.log(card);
26
+ * @example
27
+ * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
28
+ * const card = await client.agentCard();
29
+ * console.log(card);
20
30
  */
21
31
  constructor(baseUrl: URL | string, headers?: Record<string, string>, fallbackPath?: string);
22
32
  /**
@@ -31,11 +41,11 @@ export declare class A2AClient implements Client {
31
41
  */
32
42
  refreshAgentCard(): Promise<AgentCard>;
33
43
  /**
34
- * Sends a task request to the agent (non-streaming).
44
+ * Sends a Message to an agent server.
35
45
  * @param params The parameters for the message/send method.
36
- * @returns A promise resolving to the Task object or null.
46
+ * @returns A promise resolving to Message/Task response from the agent server or null.
37
47
  */
38
- sendMessage(params: MessageSendParams): Promise<Message | Task | null>;
48
+ sendMessage(params: MessageSendParams | string): Promise<Message | Task | null>;
39
49
  /**
40
50
  * @deprecated Use sendMessage instead.
41
51
  * Sends a task request to the agent (non-streaming).
@@ -44,11 +54,11 @@ export declare class A2AClient implements Client {
44
54
  */
45
55
  sendTask(params: MessageSendParams): Promise<Message | Task | null>;
46
56
  /**
47
- * Sends a task and returns a subscription to status and artifact updates.
57
+ * Sends a Message and returns a stream of status and artifact updates.
48
58
  * @param params Task parameters for the request
49
- * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
59
+ * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
50
60
  */
51
- sendStreamingMessage(params: MessageSendParams): AsyncIterable<UpdateEvent>;
61
+ sendStreamingMessage(params: MessageSendParams | string): AsyncIterable<UpdateEvent>;
52
62
  /**
53
63
  * @deprecated Use sendStreamingMessage instead.
54
64
  * Sends a task and returns a subscription to status and artifact updates.
@@ -113,4 +123,3 @@ export declare class A2AClient implements Client {
113
123
  */
114
124
  clearHeaders(): void;
115
125
  }
116
- //# sourceMappingURL=a2a-client.d.ts.map
@@ -5,6 +5,7 @@
5
5
  import { executeJsonRpcRequest, executeGetRequest, executeStreamEvents, } from "../transport/index.js";
6
6
  import { INTERNAL_ERROR } from "../utils/index.js";
7
7
  import { logError } from "../utils/logging/index.js";
8
+ import { createMessageSendParams } from "../services/a2a/helpers/message-builder.js";
8
9
  /**
9
10
  * A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
10
11
  * It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.
@@ -14,15 +15,26 @@ export class A2AClient {
14
15
  cachedAgentCard = null;
15
16
  customHeaders = {};
16
17
  fallbackPath;
18
+ agentUrl;
17
19
  /**
18
20
  * Creates a new A2AClient instance.
19
21
  * @param baseUrl The base URL for the A2A server.
20
22
  * @param headers Optional custom headers to include in all requests.
23
+ * @param fallbackPath Optional fallback path to use if the agent card is not found at the base URL.
24
+ * @example
25
+ * const client = new A2AClient("http://localhost:4000/a2a");
26
+ * const card = await client.agentCard();
27
+ * console.log(card);
28
+ * @example
29
+ * const client = new A2AClient("http://localhost:4000/a2a", {}, "/agent-card");
30
+ * const card = await client.agentCard();
31
+ * console.log(card);
21
32
  */
22
33
  constructor(baseUrl, headers = {}, fallbackPath) {
23
34
  this.baseUrl = typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl;
24
35
  this.customHeaders = headers;
25
36
  this.fallbackPath = fallbackPath ?? "/agent-card";
37
+ this.agentUrl = this.baseUrl;
26
38
  }
27
39
  /**
28
40
  * Retrieves the AgentCard from the A2A server.
@@ -45,7 +57,6 @@ export class A2AClient {
45
57
  throw new Error("No agent card found");
46
58
  }
47
59
  this.cachedAgentCard = card;
48
- return this.cachedAgentCard;
49
60
  }
50
61
  catch (error) {
51
62
  const fallbackUrl = new URL(this.fallbackPath, this.baseUrl);
@@ -56,13 +67,14 @@ export class A2AClient {
56
67
  throw new Error("No fallback agent card found");
57
68
  }
58
69
  this.cachedAgentCard = fallbackCard;
59
- return this.cachedAgentCard;
60
70
  }
61
71
  }
62
72
  catch (error) {
63
73
  logError("A2AClient:agentCard", "Failed to fetch or parse agent card:", error);
64
74
  throw INTERNAL_ERROR(`Could not retrieve agent card: ${error instanceof Error ? error.message : String(error)}`);
65
75
  }
76
+ this.agentUrl = new URL(this.cachedAgentCard.url, this.baseUrl);
77
+ return this.cachedAgentCard;
66
78
  }
67
79
  /**
68
80
  * Refreshes the cached AgentCard by fetching it again from the server.
@@ -73,12 +85,12 @@ export class A2AClient {
73
85
  return this.agentCard();
74
86
  }
75
87
  /**
76
- * Sends a task request to the agent (non-streaming).
88
+ * Sends a Message to an agent server.
77
89
  * @param params The parameters for the message/send method.
78
- * @returns A promise resolving to the Task object or null.
90
+ * @returns A promise resolving to Message/Task response from the agent server or null.
79
91
  */
80
92
  async sendMessage(params) {
81
- return await executeJsonRpcRequest(this.baseUrl, "message/send", params, this.customHeaders);
93
+ return await executeJsonRpcRequest(this.agentUrl, "message/send", createMessageSendParams(params), this.customHeaders);
82
94
  }
83
95
  /**
84
96
  * @deprecated Use sendMessage instead.
@@ -90,12 +102,12 @@ export class A2AClient {
90
102
  return await this.sendMessage(params);
91
103
  }
92
104
  /**
93
- * Sends a task and returns a subscription to status and artifact updates.
105
+ * Sends a Message and returns a stream of status and artifact updates.
94
106
  * @param params Task parameters for the request
95
- * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
107
+ * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
96
108
  */
97
109
  sendStreamingMessage(params) {
98
- return executeStreamEvents(this.baseUrl, "message/stream", params, this.customHeaders);
110
+ return executeStreamEvents(this.agentUrl, "message/stream", createMessageSendParams(params), this.customHeaders);
99
111
  }
100
112
  /**
101
113
  * @deprecated Use sendStreamingMessage instead.
@@ -112,7 +124,7 @@ export class A2AClient {
112
124
  * @returns A promise resolving to the Task object or null.
113
125
  */
114
126
  async getTask(params) {
115
- return await executeJsonRpcRequest(this.baseUrl, "tasks/get", params, this.customHeaders);
127
+ return await executeJsonRpcRequest(this.agentUrl, "tasks/get", params, this.customHeaders);
116
128
  }
117
129
  /**
118
130
  * Cancels a currently running task.
@@ -120,7 +132,7 @@ export class A2AClient {
120
132
  * @returns A promise resolving to the updated Task object (usually canceled state) or null.
121
133
  */
122
134
  async cancelTask(params) {
123
- return await executeJsonRpcRequest(this.baseUrl, "tasks/cancel", params, this.customHeaders);
135
+ return await executeJsonRpcRequest(this.agentUrl, "tasks/cancel", params, this.customHeaders);
124
136
  }
125
137
  /**
126
138
  * Sets or updates the push notification config for a task.
@@ -128,7 +140,7 @@ export class A2AClient {
128
140
  * @returns A promise resolving to the confirmed TaskPushNotificationConfig or null.
129
141
  */
130
142
  async setTaskPushNotification(params) {
131
- return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
143
+ return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/set", params, this.customHeaders);
132
144
  }
133
145
  /**
134
146
  * Retrieves the currently configured push notification config for a task.
@@ -136,7 +148,7 @@ export class A2AClient {
136
148
  * @returns A promise resolving to the TaskPushNotificationConfig or null.
137
149
  */
138
150
  async getTaskPushNotification(params) {
139
- return await executeJsonRpcRequest(this.baseUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
151
+ return await executeJsonRpcRequest(this.agentUrl, "tasks/pushNotificationConfig/get", params, this.customHeaders);
140
152
  }
141
153
  /**
142
154
  * Resubscribes to an existing task's update stream.
@@ -144,7 +156,7 @@ export class A2AClient {
144
156
  * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
145
157
  */
146
158
  resubscribeTask(params) {
147
- return executeStreamEvents(this.baseUrl, "tasks/resubscribe", params, this.customHeaders);
159
+ return executeStreamEvents(this.agentUrl, "tasks/resubscribe", params, this.customHeaders);
148
160
  }
149
161
  /**
150
162
  * Checks if the server supports a specific capability based on the agent card.
@@ -202,4 +214,3 @@ export class A2AClient {
202
214
  this.customHeaders = {};
203
215
  }
204
216
  }
205
- //# sourceMappingURL=a2a-client.js.map
@@ -1,2 +1 @@
1
1
  export * from "./a2a-client.js";
2
- //# sourceMappingURL=index.d.ts.map
@@ -1,2 +1 @@
1
1
  export * from "./a2a-client.js";
2
- //# sourceMappingURL=index.js.map
package/dist/index.d.ts CHANGED
@@ -4,4 +4,3 @@ export * from "./server/index.js";
4
4
  export * from "./services/index.js";
5
5
  export * from "./transport/index.js";
6
6
  export * from "./utils/index.js";
7
- //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -4,4 +4,3 @@ export * from "./server/index.js";
4
4
  export * from "./services/index.js";
5
5
  export * from "./transport/index.js";
6
6
  export * from "./utils/index.js";
7
- //# sourceMappingURL=index.js.map
@@ -7,4 +7,3 @@ import { type ErrorRequestHandler } from "express";
7
7
  * Express error handler middleware.
8
8
  */
9
9
  export declare const errorHandler: ErrorRequestHandler;
10
- //# sourceMappingURL=errors.d.ts.map
@@ -48,4 +48,3 @@ export const errorHandler = (err, req, res, _) => {
48
48
  res.end();
49
49
  }
50
50
  };
51
- //# sourceMappingURL=errors.js.map
@@ -1,4 +1,3 @@
1
1
  export * from "./server.js";
2
2
  export * from "./middeware.js";
3
3
  export * from "./errors.js";
4
- //# sourceMappingURL=index.d.ts.map
@@ -1,4 +1,3 @@
1
1
  export * from "./server.js";
2
2
  export * from "./middeware.js";
3
3
  export * from "./errors.js";
4
- //# sourceMappingURL=index.js.map
@@ -5,4 +5,3 @@
5
5
  import { NextFunction, Request, Response } from "express";
6
6
  import { A2AServiceInterface } from "../../types/index.js";
7
7
  export declare function jsonRPCMiddleware(service: A2AServiceInterface, req: Request, res: Response, next: NextFunction): Promise<void>;
8
- //# sourceMappingURL=middeware.d.ts.map
@@ -113,4 +113,3 @@ export async function jsonRPCMiddleware(service, req, res, next) {
113
113
  return next(error);
114
114
  }
115
115
  }
116
- //# sourceMappingURL=middeware.js.map
@@ -68,4 +68,3 @@ export declare function createAgentServer(params: ServerParams & {
68
68
  }, import("../../types/index.js").TaskAndHistory, import("../../types/index.js").UpdateEvent>;
69
69
  };
70
70
  export type ExpressAgentServer = ReturnType<typeof createAgentServer>;
71
- //# sourceMappingURL=server.d.ts.map
@@ -77,4 +77,3 @@ export function createAgentServer(params) {
77
77
  */
78
78
  return { app, agent: agentInstance };
79
79
  }
80
- //# sourceMappingURL=server.js.map
@@ -1,2 +1 @@
1
1
  export * from "./express/index.js";
2
- //# sourceMappingURL=index.d.ts.map
@@ -1,2 +1 @@
1
1
  export * from "./express/index.js";
2
- //# sourceMappingURL=index.js.map
@@ -349,4 +349,3 @@ export declare const AgentBuilder: () => EngineBuilder<{
349
349
  */
350
350
  export declare function createAgentExecutor(stepsList: StepWithKind[]): AgentEngine;
351
351
  export {};
352
- //# sourceMappingURL=builder.d.ts.map
@@ -392,4 +392,3 @@ export function createAgentExecutor(stepsList) {
392
392
  yield task;
393
393
  };
394
394
  }
395
- //# sourceMappingURL=builder.js.map
@@ -130,4 +130,3 @@ export declare function createCommandChannel<TCommand extends Command = Command>
130
130
  * @since 0.5.6
131
131
  */
132
132
  export declare function createContext<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(request: TCommand, service: A2AServiceInterface<TCommand, TState, TUpdate>, contextManager: ContextManagerInterface<TCommand, TState, TUpdate>, abortSignal?: AbortSignal, contextId?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): Context<TCommand, TState, TUpdate>;
133
- //# sourceMappingURL=context.d.ts.map
@@ -148,4 +148,3 @@ export function createContext(request, service, contextManager, abortSignal = ne
148
148
  contextManager.setContext(contextId, context);
149
149
  return context;
150
150
  }
151
- //# sourceMappingURL=context.js.map
@@ -56,4 +56,3 @@ import { Command, State, Update, A2AServiceInterface, EventManagerOptions } from
56
56
  * @since 0.5.6
57
57
  */
58
58
  export declare function createEventManager<TCommand extends Command = Command, TState extends State = State, TUpdate extends Update = Update>(service: A2AServiceInterface<TCommand, TState, TUpdate>, id?: string, eventOverrides?: EventManagerOptions<TCommand, TState, TUpdate>): EventManager<TCommand, TState, TUpdate>;
59
- //# sourceMappingURL=event.d.ts.map
@@ -175,4 +175,3 @@ export function createEventManager(service, id, eventOverrides) {
175
175
  ...eventOverrides, // Override options take precedence over defaults
176
176
  });
177
177
  }
178
- //# sourceMappingURL=event.js.map
@@ -3,4 +3,3 @@ export * from "./builder.js";
3
3
  export * from "./event.js";
4
4
  export * from "./method.js";
5
5
  export * from "./service.js";
6
- //# sourceMappingURL=index.d.ts.map
@@ -3,4 +3,3 @@ export * from "./builder.js";
3
3
  export * from "./event.js";
4
4
  export * from "./method.js";
5
5
  export * from "./service.js";
6
- //# sourceMappingURL=index.js.map
@@ -4,4 +4,3 @@
4
4
  */
5
5
  import { MethodOptions } from "../../../types/index.js";
6
6
  export declare function createMethods(methods?: Partial<MethodOptions>): MethodOptions;
7
- //# sourceMappingURL=method.d.ts.map
@@ -12,4 +12,3 @@ export function createMethods(methods) {
12
12
  resubscribe: methods?.resubscribe ?? resubscribe,
13
13
  };
14
14
  }
15
- //# sourceMappingURL=method.js.map
@@ -7,4 +7,3 @@ import { A2AService } from "../service.js";
7
7
  export declare function createService(params: FactoryParams): A2AService;
8
8
  export declare const createAgent: typeof createService;
9
9
  export type AgentImpl = ReturnType<typeof createAgent>;
10
- //# sourceMappingURL=service.d.ts.map
@@ -9,4 +9,3 @@ export function createService(params) {
9
9
  return new A2AService(params.agentCard, params.engine, params.contexts ?? new ContextManager(), params.connections ?? new ConnectionManager(), params.cancellations ?? new CancellationManager(), params.tasks ?? new TaskManager(), createMethods(params.methods), params.events);
10
10
  }
11
11
  export const createAgent = createService;
12
- //# sourceMappingURL=service.js.map