@artinet/sdk 0.5.11 → 0.5.13

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 +46 -84
  2. package/dist/client/a2a-client.d.ts +6 -7
  3. package/dist/client/a2a-client.js +8 -8
  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 +3 -4
  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 +1 -5
  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 +24 -21
  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 +37 -9
  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 +7 -7
  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 +4 -2
  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 +4 -3
  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)
@@ -51,7 +55,7 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
51
55
  - [License](#license)
52
56
  - [Acknowledgements](#acknowledgements)
53
57
 
54
- **Breaking Changes in v0.5.8**
58
+ **Breaking Changes since v0.5.8**
55
59
 
56
60
  - Pino has been removed and replaced with console for better portability and is set to silent by default.
57
61
  - The default handler for streamMessage no longer automatically emits an initial `submitted` and `working` event.
@@ -61,13 +65,9 @@ It has [serveral template projects](https://github.com/the-artinet-project/creat
61
65
  - AgentBuilder now returns a unique messageId for each status update instead of the original user provided messageId.
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
-
65
- ## Features
66
-
67
- - **Modular Design:** Everything you need to get started building collaborative agents while remaining flexible enough for advanced configuration.
68
- - **Express Style Agent API:** Similar to scaffolding an Express Server, you can use the AgentBuilder to create an Agent2Agent API.
69
- - 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.
70
- - **Protocol Compliance:** Implements the complete A2A specification (v0.3.0) with support for any kind of transport layer (tRPC, WebSockets, etc).
68
+ - The `history` object from `TaskAndHistory` is deprecated and no longer being updated. Use `Task.history` instead.
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 examples folder will be removed in favor of [`create-agent`](https://github.com/the-artinet-project/create-agent)
71
71
 
72
72
  ## Installation
73
73
 
@@ -77,7 +77,9 @@ npm install @artinet/sdk
77
77
 
78
78
  ## Requirements
79
79
 
80
- - Node.js (v22.0.0 or higher recommended)
80
+ - [Node.js](https://nodejs.org/en/download) 18.9.1
81
+ - Recommended: 20 || ≥ 22
82
+
81
83
  <!--
82
84
 
83
85
  ## Documentation
@@ -93,37 +95,30 @@ A basic A2A server and client interaction (For simple agents see the [AgentBuild
93
95
  ```typescript
94
96
  import {
95
97
  createAgentServer,
96
- AgentBuilder
98
+ AgentBuilder,
99
+ Task
97
100
  } from "@artinet/sdk";
98
101
 
99
- //Define your Agents Behaviour
100
- const quickAgentEngine: AgentEngine = AgentBuilder()
101
- .text(async ({ content, context }) => {
102
- const task = context.State();
102
+ // Create an agent server
103
+ const { app, agent } = createAgentServer({
104
+ agent: AgentBuilder()
105
+ .text(async ({ content: userInput, context }) => {
106
+ const task: Task = context.State().task;
103
107
  ...
104
- const userInput = content;
105
108
  return `You said: ${userInput}`;
106
109
  })
107
- .createAgentEngine();
108
-
109
- // Create an agent server
110
- const { app, agent } = createAgentServer({
111
- agent: {
112
- engine: quickAgentEngine,
110
+ .createAgent({
113
111
  agentCard: {
114
112
  name: "QuickStart Agent",
113
+ description: "A simple agent that echoes the user's message",
115
114
  url: "http://localhost:4000/a2a",
116
115
  version: "0.1.0",
117
116
  capabilities: { streaming: true },
118
117
  skills: [{ id: "echo", name: "Echo Skill" }],
119
118
  ...
120
119
  },
121
- tasks: new TaskManager(),
122
- ...
123
- },
124
- basePath: "/a2a",
125
- agentCardPath: "/.well-known/agent.json"
126
- ...
120
+ }),
121
+ basePath: "/a2a"
127
122
  });
128
123
 
129
124
  app.listen(4000, () => {
@@ -139,15 +134,7 @@ import { A2AClient, TaskStatusUpdateEvent } from "@artinet/sdk";
139
134
  async function runClient() {
140
135
  const client = new A2AClient("http://localhost:4000/a2a");
141
136
 
142
- const message = {
143
- messageId: "test-message-id",
144
- kind: "message",
145
- role: "user",
146
- parts: [{ kind: "text", text: "Hello World!" }],
147
- ...
148
- };
149
-
150
- const stream = client.sendStreamingMessage({ message });
137
+ const stream = client.sendStreamingMessage("Hello World!");
151
138
 
152
139
  for await (const update of stream) {
153
140
  // process the updates
@@ -176,26 +163,16 @@ Interact with A2A-compliant agents using the `A2AClient`. See `examples/` for mo
176
163
  Send a message using `message/send`.
177
164
 
178
165
  ```typescript
179
- import { A2AClient, Message } from "@artinet/sdk";
166
+ import { A2AClient, Task } from "@artinet/sdk";
180
167
 
181
- async function runBasicTask() {
182
- const client = new A2AClient("https://your-a2a-server.com/a2a");
183
- const message: Message = {
184
- messageId: "test-message",
185
- kind: "message",
186
- role: "user",
187
- parts: [{ kind: "text", text: "What is the capital of France?" }],
188
- ...
189
- };
168
+ const client = new A2AClient("https://your-a2a-server.com/a2a");
190
169
 
191
- const task = await client.sendMessage({ message });
192
- console.log("Task Completed:", task);
193
- }
170
+ const task: Task = await client.sendMessage("What is the capital of France?");
194
171
  ```
195
172
 
196
173
  #### Streaming Updates
197
174
 
198
- Receive real-time updates via SSE using `message/stream` (recommended).
175
+ Receive real-time updates via SSE using `message/stream`.
199
176
 
200
177
  ```typescript
201
178
  import {
@@ -207,15 +184,8 @@ import {
207
184
 
208
185
  async function runStreamingTask() {
209
186
  const client = new A2AClient("https://your-a2a-server.com/a2a");
210
- const message: Message = {
211
- role: "user",
212
- parts: [{ kind: "text", text: "Tell me a short story." }],
213
- ...
214
- };
215
187
 
216
- const stream = client.sendStreamingMessage({
217
- message,
218
- });
188
+ const stream = client.sendStreamingMessage("Tell me a short story.");
219
189
 
220
190
  for await (const update of stream) {
221
191
  if ((update as TaskStatusUpdateEvent).status) {
@@ -257,12 +227,12 @@ The SDK provides a variety of options for creating complex ([AgentEngines](#agen
257
227
 
258
228
  ##### AgentBuilder
259
229
 
260
- **Option 1: Using the AgentBuilder (Recommended for Simple Workflows)**
230
+ **Option 1: Using the AgentBuilder (Recommended)**
261
231
 
262
232
  For simple agents with one or more processing steps, use the `AgentBuilder` pattern:
263
233
 
264
234
  ```typescript
265
- import { createAgentServer, AgentBuilder, TaskManager } from "@artinet/sdk";
235
+ import { createAgentServer, AgentBuilder } from "@artinet/sdk";
266
236
 
267
237
  //create a simple agent
268
238
  const simpleAgent = AgentBuilder().text(() => "hello world!");
@@ -302,7 +272,6 @@ const { app, agent } = createAgentServer({
302
272
  capabilities: { streaming: true },
303
273
  skills: [{ id: "multi-processor", name: "Multi-Step Processor" }],
304
274
  },
305
- tasks: new TaskManager(),
306
275
  }),
307
276
  basePath: "/a2a",
308
277
  });
@@ -330,7 +299,6 @@ import {
330
299
  createAgentServer,
331
300
  Context,
332
301
  AgentEngine,
333
- TaskManager,
334
302
  } from "@artinet/sdk";
335
303
 
336
304
  const myAgent: AgentEngine = async function* (context: Context) {
@@ -374,7 +342,6 @@ const { app, agent } = createAgentServer({
374
342
  skills: [{ id: "processor", name: "Text Processor" }],
375
343
  ...
376
344
  },
377
- tasks: new TaskManager(),
378
345
  },
379
346
  basePath: "/a2a",
380
347
  agentCardPath: "/.well-known/agent-card.json",
@@ -431,7 +398,7 @@ const agent = createAgent({
431
398
  },
432
399
  });
433
400
 
434
- const result = await agent.sendMessage({
401
+ const resultPromise = agent.sendMessage({
435
402
  contextId: "123"
436
403
  ...
437
404
  });
@@ -444,7 +411,7 @@ currentContext.events.on("complete", () {
444
411
  //errors thrown here will be triggered in the original context
445
412
  });
446
413
 
447
- //stream new commands into a running context
414
+ // Advanced: stream new commands into a running context
448
415
  (currentContext.command as SendCommandInterface<Command>).send({
449
416
  ...
450
417
  });
@@ -464,7 +431,7 @@ The EventManager supports the following event types:
464
431
 
465
432
  #### Persistent Storage
466
433
 
467
- For storage, use our out of the box storage providers like `FileStore`. Or implement the `Store` interface to create your own.
434
+ For Task storage, use one our simple storage providers like `FileStore`. Or implement the `Store` interface to create your own.
468
435
 
469
436
  ```typescript
470
437
  import path from "path";
@@ -493,7 +460,7 @@ const { app, agent } = createAgentServer({
493
460
 
494
461
  #### Advanced Server Customization
495
462
 
496
- Our new architecture provides multiple ways to customize your agent server:
463
+ Our architecture provides multiple ways to customize your agent server:
497
464
 
498
465
  **1. Using `createAgentServer`:**
499
466
  Easily spin up an A2A Express app `createAgentServer()`:
@@ -521,12 +488,12 @@ app.use("/custom", (req, res, next) => {
521
488
 
522
489
  ```
523
490
 
524
- **2. Use the JSON-RPC Middleware:**
491
+ **2. Using our JSON-RPC Middleware:**
525
492
  Directly import our preconfigured JSON-RPC middleware:
526
493
 
527
494
  ```typescript
528
495
  import express from "express";
529
- import { createAgent, jsonRPCMiddleware, errorHandler, InMemoryTaskStore } from "@artinet/sdk";
496
+ import { createAgent, jsonRPCMiddleware, errorHandler } from "@artinet/sdk";
530
497
 
531
498
  const customApp = express();
532
499
 
@@ -535,14 +502,13 @@ const agent = createAgent({
535
502
  agentCard: {
536
503
  ...
537
504
  },
538
- tasks: new InMemoryTaskStore(),
539
505
  });
540
506
 
541
507
  customApp.use("/auth", yourAuthMiddleware);
542
508
  customApp.use("/metrics", yourMetricsMiddleware);
543
509
  customApp.use(express.json());
544
510
 
545
- // Add the A2A middleware
511
+ // Add A2A middleware
546
512
  customApp.post("/", async (req, res, next) => {
547
513
  return await jsonRPCMiddleware(agent, req, res, next);
548
514
  });
@@ -561,6 +527,7 @@ const server = customApp.listen(3000, () => {
561
527
  ```
562
528
 
563
529
  **3. Using Custom Transport Layers:**
530
+
564
531
  Use our preconfigured TRPC router, or create your own integration with WebSockets & other protocols:
565
532
 
566
533
  ```typescript
@@ -570,6 +537,7 @@ const agentRouter = createAgentRouter();
570
537
  ```
571
538
 
572
539
  **Use the Agent:**
540
+
573
541
  Directly invoke the agent to use it locally:
574
542
 
575
543
  ```typescript
@@ -580,7 +548,6 @@ const agent = createAgent({
580
548
  agentCard: {
581
549
  ...
582
550
  },
583
- tasks: new InMemoryTaskStore(),
584
551
  });
585
552
 
586
553
  // Wrap these calls in your desired transport logic
@@ -675,7 +642,7 @@ const result = await client.callTool({
675
642
  - `cancel-task`: Cancel a running task
676
643
  - `agent://card`: Retrieve the AgentCard
677
644
  - `send-streaming-message`, `task-resubscribe` & `push-notifications` etc are currently not supported by default.
678
- - Leverage the A2A Zod Schemas to implement them manually.
645
+ - Leverage the A2A Zod Schemas to manually implement your own tools.
679
646
 
680
647
  ## Contributing
681
648
 
@@ -690,8 +657,3 @@ This project is licensed under the Apache License 2.0 - see the `LICENSE` file f
690
657
  ## Acknowledgements
691
658
 
692
659
  This SDK builds upon the concepts and specifications of the [Agent2Agent (A2A) Protocol](https://github.com/google-a2a/A2A).
693
-
694
- Libraries used include:
695
-
696
- - [Express.js](https://expressjs.com/) for the server framework.
697
- - [EventSource Parser](https://github.com/rexxars/eventsource-parser) for SSE streaming.
@@ -31,11 +31,11 @@ export declare class A2AClient implements Client {
31
31
  */
32
32
  refreshAgentCard(): Promise<AgentCard>;
33
33
  /**
34
- * Sends a task request to the agent (non-streaming).
34
+ * Sends a Message to an agent server.
35
35
  * @param params The parameters for the message/send method.
36
- * @returns A promise resolving to the Task object or null.
36
+ * @returns A promise resolving to Message/Task response from the agent server or null.
37
37
  */
38
- sendMessage(params: MessageSendParams): Promise<Message | Task | null>;
38
+ sendMessage(params: MessageSendParams | string): Promise<Message | Task | null>;
39
39
  /**
40
40
  * @deprecated Use sendMessage instead.
41
41
  * Sends a task request to the agent (non-streaming).
@@ -44,11 +44,11 @@ export declare class A2AClient implements Client {
44
44
  */
45
45
  sendTask(params: MessageSendParams): Promise<Message | Task | null>;
46
46
  /**
47
- * Sends a task and returns a subscription to status and artifact updates.
47
+ * Sends a Message and returns a stream of status and artifact updates.
48
48
  * @param params Task parameters for the request
49
- * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
49
+ * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
50
50
  */
51
- sendStreamingMessage(params: MessageSendParams): AsyncIterable<UpdateEvent>;
51
+ sendStreamingMessage(params: MessageSendParams | string): AsyncIterable<UpdateEvent>;
52
52
  /**
53
53
  * @deprecated Use sendStreamingMessage instead.
54
54
  * Sends a task and returns a subscription to status and artifact updates.
@@ -113,4 +113,3 @@ export declare class A2AClient implements Client {
113
113
  */
114
114
  clearHeaders(): void;
115
115
  }
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.
@@ -34,7 +35,7 @@ export class A2AClient {
34
35
  return this.cachedAgentCard;
35
36
  }
36
37
  // Standard location for agent cards
37
- const wellKnownUrl = new URL("/.well-known/agent.json", this.baseUrl);
38
+ const wellKnownUrl = new URL("/.well-known/agent-card.json", this.baseUrl);
38
39
  try {
39
40
  try {
40
41
  if (!URL.canParse(wellKnownUrl)) {
@@ -73,12 +74,12 @@ export class A2AClient {
73
74
  return this.agentCard();
74
75
  }
75
76
  /**
76
- * Sends a task request to the agent (non-streaming).
77
+ * Sends a Message to an agent server.
77
78
  * @param params The parameters for the message/send method.
78
- * @returns A promise resolving to the Task object or null.
79
+ * @returns A promise resolving to Message/Task response from the agent server or null.
79
80
  */
80
81
  async sendMessage(params) {
81
- return await executeJsonRpcRequest(this.baseUrl, "message/send", params, this.customHeaders);
82
+ return await executeJsonRpcRequest(this.baseUrl, "message/send", createMessageSendParams(params), this.customHeaders);
82
83
  }
83
84
  /**
84
85
  * @deprecated Use sendMessage instead.
@@ -90,12 +91,12 @@ export class A2AClient {
90
91
  return await this.sendMessage(params);
91
92
  }
92
93
  /**
93
- * Sends a task and returns a subscription to status and artifact updates.
94
+ * Sends a Message and returns a stream of status and artifact updates.
94
95
  * @param params Task parameters for the request
95
- * @returns An AsyncIterable that yields TaskStatusUpdateEvent or TaskArtifactUpdateEvent payloads.
96
+ * @returns An AsyncIterable that yields TaskStatusUpdateEvent/TaskArtifactUpdateEvent/Task/Message payloads.
96
97
  */
97
98
  sendStreamingMessage(params) {
98
- return executeStreamEvents(this.baseUrl, "message/stream", params, this.customHeaders);
99
+ return executeStreamEvents(this.baseUrl, "message/stream", createMessageSendParams(params), this.customHeaders);
99
100
  }
100
101
  /**
101
102
  * @deprecated Use sendStreamingMessage instead.
@@ -202,4 +203,3 @@ export class A2AClient {
202
203
  this.customHeaders = {};
203
204
  }
204
205
  }
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
@@ -117,7 +117,7 @@ export function createEventManager(service, id, eventOverrides) {
117
117
  task: current.task,
118
118
  userMessage: current.task?.status?.message ?? {},
119
119
  isCancelled: () => service.isCancelled(localContextId),
120
- history: current.history ?? current.task?.history ?? [],
120
+ history: [], //deprecating history
121
121
  },
122
122
  current: current,
123
123
  update: cancelUpdate,
@@ -134,7 +134,7 @@ export function createEventManager(service, id, eventOverrides) {
134
134
  task: current.task,
135
135
  userMessage: current.task?.status?.message ?? {},
136
136
  isCancelled: () => service.isCancelled(contextId),
137
- history: current.history ?? current.task?.history ?? [],
137
+ history: [], //deprecating history
138
138
  },
139
139
  current: current,
140
140
  update: update,
@@ -159,7 +159,7 @@ export function createEventManager(service, id, eventOverrides) {
159
159
  task: current.task,
160
160
  userMessage: current.task?.status?.message ?? {},
161
161
  isCancelled: () => service.isCancelled(contextId),
162
- history: current.history ?? current.task?.history ?? [],
162
+ history: [], //deprecating history
163
163
  },
164
164
  current: current,
165
165
  update: failedUpdate,
@@ -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
@@ -9,4 +9,3 @@ import { UpdateEvent } from "../../../types/index.js";
9
9
  * @returns The content of the input event.
10
10
  */
11
11
  export declare function getContent(input: UpdateEvent): string | undefined;
12
- //# sourceMappingURL=content.d.ts.map
@@ -16,4 +16,3 @@ export function getContent(input) {
16
16
  parts.data.map((data) => JSON.stringify(data)).join("\n") ??
17
17
  undefined);
18
18
  }
19
- //# sourceMappingURL=content.js.map
@@ -1,3 +1,3 @@
1
1
  export * from "./part.js";
2
2
  export * from "./content.js";
3
- //# sourceMappingURL=index.d.ts.map
3
+ export * from "./message-builder.js";
@@ -1,3 +1,3 @@
1
1
  export * from "./part.js";
2
2
  export * from "./content.js";
3
- //# sourceMappingURL=index.js.map
3
+ export * from "./message-builder.js";
@@ -0,0 +1,12 @@
1
+ import { MessageSendParams, Message as MessageType, MessageSendConfiguration } from "../../../types/index.js";
2
+ export declare class MessageBuilder {
3
+ message: MessageType;
4
+ constructor(message?: Partial<MessageType>);
5
+ valueOf(): MessageType;
6
+ }
7
+ export declare class MessageSendConfigurationBuilder {
8
+ configuration: MessageSendConfiguration;
9
+ constructor(configuration?: Partial<MessageSendConfiguration>);
10
+ valueOf(): MessageSendConfiguration;
11
+ }
12
+ export declare const createMessageSendParams: (messageSendParams: Partial<MessageSendParams> | string) => MessageSendParams;