@artinet/sdk 0.5.5 → 0.5.6

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 (622) hide show
  1. package/CHANGELOG.md +106 -20
  2. package/README.md +471 -214
  3. package/dist/client/a2a-client.js +6 -1
  4. package/dist/client/a2a-client.js.map +1 -1
  5. package/dist/index.js +3 -2
  6. package/dist/index.js.map +1 -1
  7. package/dist/server/express/errors.js +51 -0
  8. package/dist/server/express/errors.js.map +1 -0
  9. package/dist/server/express/index.js +4 -0
  10. package/dist/server/express/index.js.map +1 -0
  11. package/dist/server/express/middeware.js +116 -0
  12. package/dist/server/express/middeware.js.map +1 -0
  13. package/dist/server/express/server.js +80 -0
  14. package/dist/server/express/server.js.map +1 -0
  15. package/dist/server/index.js +1 -7
  16. package/dist/server/index.js.map +1 -1
  17. package/dist/services/a2a/factory/builder.js +392 -0
  18. package/dist/services/a2a/factory/builder.js.map +1 -0
  19. package/dist/services/a2a/factory/context.js +151 -0
  20. package/dist/services/a2a/factory/context.js.map +1 -0
  21. package/dist/services/a2a/factory/event.js +182 -0
  22. package/dist/services/a2a/factory/event.js.map +1 -0
  23. package/dist/services/a2a/factory/index.js +6 -0
  24. package/dist/services/a2a/factory/index.js.map +1 -0
  25. package/dist/services/a2a/factory/method.js +15 -0
  26. package/dist/services/a2a/factory/method.js.map +1 -0
  27. package/dist/services/a2a/factory/service.js +12 -0
  28. package/dist/services/a2a/factory/service.js.map +1 -0
  29. package/dist/services/a2a/helpers/index.js +2 -0
  30. package/dist/services/a2a/helpers/index.js.map +1 -0
  31. package/dist/services/a2a/helpers/part.js +47 -0
  32. package/dist/services/a2a/helpers/part.js.map +1 -0
  33. package/dist/services/a2a/index.js +5 -1
  34. package/dist/services/a2a/index.js.map +1 -1
  35. package/dist/services/a2a/managers/cancellation.js +17 -0
  36. package/dist/services/a2a/managers/cancellation.js.map +1 -0
  37. package/dist/services/a2a/managers/connection.js +17 -0
  38. package/dist/services/a2a/managers/connection.js.map +1 -0
  39. package/dist/services/a2a/managers/context.js +17 -0
  40. package/dist/services/a2a/managers/context.js.map +1 -0
  41. package/dist/services/a2a/managers/index.js +6 -0
  42. package/dist/services/a2a/managers/index.js.map +1 -0
  43. package/dist/services/a2a/managers/task.js +17 -0
  44. package/dist/services/a2a/managers/task.js.map +1 -0
  45. package/dist/services/a2a/methods/cancel-task.js +47 -0
  46. package/dist/services/a2a/methods/cancel-task.js.map +1 -0
  47. package/dist/services/a2a/methods/get-task.js +15 -0
  48. package/dist/services/a2a/methods/get-task.js.map +1 -0
  49. package/dist/services/a2a/methods/index.js +6 -0
  50. package/dist/services/a2a/methods/index.js.map +1 -0
  51. package/dist/services/a2a/methods/resubscribe-task.js +77 -0
  52. package/dist/services/a2a/methods/resubscribe-task.js.map +1 -0
  53. package/dist/services/a2a/methods/send-message.js +20 -0
  54. package/dist/services/a2a/methods/send-message.js.map +1 -0
  55. package/dist/services/a2a/methods/stream-message.js +39 -0
  56. package/dist/services/a2a/methods/stream-message.js.map +1 -0
  57. package/dist/services/a2a/service.js +88 -239
  58. package/dist/services/a2a/service.js.map +1 -1
  59. package/dist/services/a2a/state/index.js +4 -0
  60. package/dist/services/a2a/state/index.js.map +1 -0
  61. package/dist/services/a2a/state/load.js +43 -0
  62. package/dist/services/a2a/state/load.js.map +1 -0
  63. package/dist/services/a2a/state/process.js +14 -0
  64. package/dist/services/a2a/state/process.js.map +1 -0
  65. package/dist/services/a2a/state/update/artifact.js +40 -0
  66. package/dist/services/a2a/state/update/artifact.js.map +1 -0
  67. package/dist/services/a2a/state/update/index.js +3 -0
  68. package/dist/services/a2a/state/update/index.js.map +1 -0
  69. package/dist/{server/lib/update/base.js → services/a2a/state/update/update.js} +23 -9
  70. package/dist/services/a2a/state/update/update.js.map +1 -0
  71. package/dist/services/core/execution/execute.js +26 -0
  72. package/dist/services/core/execution/execute.js.map +1 -0
  73. package/dist/services/core/execution/index.js +2 -0
  74. package/dist/services/core/execution/index.js.map +1 -0
  75. package/dist/services/core/index.js +3 -0
  76. package/dist/services/core/index.js.map +1 -0
  77. package/dist/services/core/managers/command.js +95 -0
  78. package/dist/services/core/managers/command.js.map +1 -0
  79. package/dist/services/core/managers/event.js +57 -0
  80. package/dist/services/core/managers/event.js.map +1 -0
  81. package/dist/services/core/managers/index.js +4 -0
  82. package/dist/services/core/managers/index.js.map +1 -0
  83. package/dist/services/core/managers/stream.js +78 -0
  84. package/dist/services/core/managers/stream.js.map +1 -0
  85. package/dist/services/index.js +2 -1
  86. package/dist/services/index.js.map +1 -1
  87. package/dist/transport/index.js +1 -1
  88. package/dist/transport/index.js.map +1 -1
  89. package/dist/transport/rpc/parser.js +13 -5
  90. package/dist/transport/rpc/parser.js.map +1 -1
  91. package/dist/transport/rpc/rpc-client.js +10 -2
  92. package/dist/transport/rpc/rpc-client.js.map +1 -1
  93. package/dist/transport/streaming/event-stream.js +5 -1
  94. package/dist/transport/streaming/event-stream.js.map +1 -1
  95. package/dist/transport/trpc/a2a/factory/index.js +2 -0
  96. package/dist/transport/trpc/a2a/factory/index.js.map +1 -0
  97. package/dist/transport/trpc/a2a/factory/router.js +17 -0
  98. package/dist/transport/trpc/a2a/factory/router.js.map +1 -0
  99. package/dist/transport/trpc/a2a/index.js +4 -0
  100. package/dist/transport/trpc/a2a/index.js.map +1 -0
  101. package/dist/transport/trpc/a2a/routes/index.js +4 -0
  102. package/dist/transport/trpc/a2a/routes/index.js.map +1 -0
  103. package/dist/transport/trpc/a2a/routes/info.js +10 -0
  104. package/dist/transport/trpc/a2a/routes/info.js.map +1 -0
  105. package/dist/transport/trpc/a2a/routes/message/index.js +2 -0
  106. package/dist/transport/trpc/a2a/routes/message/index.js.map +1 -0
  107. package/dist/transport/trpc/a2a/routes/message/route.js +38 -0
  108. package/dist/transport/trpc/a2a/routes/message/route.js.map +1 -0
  109. package/dist/transport/trpc/a2a/routes/tasks/index.js +2 -0
  110. package/dist/transport/trpc/a2a/routes/tasks/index.js.map +1 -0
  111. package/dist/transport/trpc/a2a/routes/tasks/route.js +71 -0
  112. package/dist/transport/trpc/a2a/routes/tasks/route.js.map +1 -0
  113. package/dist/transport/trpc/a2a/trpc.js +36 -0
  114. package/dist/transport/trpc/a2a/trpc.js.map +1 -0
  115. package/dist/transport/trpc/index.js +2 -0
  116. package/dist/transport/trpc/index.js.map +1 -0
  117. package/dist/types/client/a2a-client.d.ts +5 -1
  118. package/dist/types/client/a2a-client.d.ts.map +1 -1
  119. package/dist/types/ext.js +11 -0
  120. package/dist/types/ext.js.map +1 -0
  121. package/dist/types/index.d.ts +3 -2
  122. package/dist/types/index.d.ts.map +1 -1
  123. package/dist/types/index.js +3 -4
  124. package/dist/types/index.js.map +1 -1
  125. package/dist/types/interfaces/client.js +6 -0
  126. package/dist/types/interfaces/client.js.map +1 -0
  127. package/dist/types/interfaces/index.js +4 -0
  128. package/dist/types/interfaces/index.js.map +1 -0
  129. package/dist/types/interfaces/services/a2a/builder.js +2 -0
  130. package/dist/types/interfaces/services/a2a/builder.js.map +1 -0
  131. package/dist/types/interfaces/services/a2a/context.js +6 -0
  132. package/dist/types/interfaces/services/a2a/context.js.map +1 -0
  133. package/dist/types/interfaces/services/a2a/engine.js +6 -0
  134. package/dist/types/interfaces/services/a2a/engine.js.map +1 -0
  135. package/dist/types/interfaces/services/a2a/index.js +6 -0
  136. package/dist/types/interfaces/services/a2a/index.js.map +1 -0
  137. package/dist/types/interfaces/services/a2a/legacy.js +6 -0
  138. package/dist/types/interfaces/services/a2a/legacy.js.map +1 -0
  139. package/dist/types/interfaces/services/a2a/service.js +6 -0
  140. package/dist/types/interfaces/services/a2a/service.js.map +1 -0
  141. package/dist/types/interfaces/services/core/context/command.js +6 -0
  142. package/dist/types/interfaces/services/core/context/command.js.map +1 -0
  143. package/dist/types/interfaces/services/core/context/context.js +6 -0
  144. package/dist/types/interfaces/services/core/context/context.js.map +1 -0
  145. package/dist/types/interfaces/services/core/context/index.js +4 -0
  146. package/dist/types/interfaces/services/core/context/index.js.map +1 -0
  147. package/dist/types/interfaces/services/core/context/types.js +6 -0
  148. package/dist/types/interfaces/services/core/context/types.js.map +1 -0
  149. package/dist/types/interfaces/services/core/execution/engine.js +6 -0
  150. package/dist/types/interfaces/services/core/execution/engine.js.map +1 -0
  151. package/dist/types/interfaces/services/core/execution/environment.js +6 -0
  152. package/dist/types/interfaces/services/core/execution/environment.js.map +1 -0
  153. package/dist/types/interfaces/services/core/execution/execute.js +6 -0
  154. package/dist/types/interfaces/services/core/execution/execute.js.map +1 -0
  155. package/dist/types/interfaces/services/core/execution/index.js +4 -0
  156. package/dist/types/interfaces/services/core/execution/index.js.map +1 -0
  157. package/dist/types/interfaces/services/core/index.js +5 -0
  158. package/dist/types/interfaces/services/core/index.js.map +1 -0
  159. package/dist/types/interfaces/services/core/managers/cancellation.js +6 -0
  160. package/dist/types/interfaces/services/core/managers/cancellation.js.map +1 -0
  161. package/dist/types/interfaces/services/core/managers/connection.js +6 -0
  162. package/dist/types/interfaces/services/core/managers/connection.js.map +1 -0
  163. package/dist/types/interfaces/services/core/managers/context.js +6 -0
  164. package/dist/types/interfaces/services/core/managers/context.js.map +1 -0
  165. package/dist/types/interfaces/services/core/managers/event.js +6 -0
  166. package/dist/types/interfaces/services/core/managers/event.js.map +1 -0
  167. package/dist/types/interfaces/services/core/managers/index.js +7 -0
  168. package/dist/types/interfaces/services/core/managers/index.js.map +1 -0
  169. package/dist/types/interfaces/services/core/managers/stream.js +6 -0
  170. package/dist/types/interfaces/services/core/managers/stream.js.map +1 -0
  171. package/dist/types/interfaces/services/core/managers/task.js +2 -0
  172. package/dist/types/interfaces/services/core/managers/task.js.map +1 -0
  173. package/dist/types/interfaces/services/core/service.js +6 -0
  174. package/dist/types/interfaces/services/core/service.js.map +1 -0
  175. package/dist/types/interfaces/services/index.js +4 -0
  176. package/dist/types/interfaces/services/index.js.map +1 -0
  177. package/dist/types/{services → interfaces/services}/protocol.js +4 -0
  178. package/dist/types/interfaces/services/protocol.js.map +1 -0
  179. package/dist/types/interfaces/storage.js +6 -0
  180. package/dist/types/interfaces/storage.js.map +1 -0
  181. package/dist/types/schemas/a2a/agent.js +319 -0
  182. package/dist/types/schemas/a2a/agent.js.map +1 -0
  183. package/dist/types/schemas/a2a/auth.js +274 -0
  184. package/dist/types/schemas/a2a/auth.js.map +1 -0
  185. package/dist/types/schemas/a2a/error.js +119 -0
  186. package/dist/types/schemas/a2a/error.js.map +1 -1
  187. package/dist/types/schemas/a2a/index.js +8 -4
  188. package/dist/types/schemas/a2a/index.js.map +1 -1
  189. package/dist/types/schemas/a2a/kind.js +21 -0
  190. package/dist/types/schemas/a2a/kind.js.map +1 -0
  191. package/dist/types/schemas/a2a/message.js +130 -1
  192. package/dist/types/schemas/a2a/message.js.map +1 -1
  193. package/dist/types/schemas/a2a/notification.js +202 -1
  194. package/dist/types/schemas/a2a/notification.js.map +1 -1
  195. package/dist/types/schemas/a2a/parameters.js +241 -1
  196. package/dist/types/schemas/a2a/parameters.js.map +1 -1
  197. package/dist/types/schemas/a2a/protocol.js +60 -0
  198. package/dist/types/schemas/a2a/protocol.js.map +1 -0
  199. package/dist/types/schemas/a2a/rpc.js +126 -1
  200. package/dist/types/schemas/a2a/rpc.js.map +1 -1
  201. package/dist/types/schemas/a2a/task.js +131 -12
  202. package/dist/types/schemas/a2a/task.js.map +1 -1
  203. package/dist/types/schemas/a2a/transport.js +28 -0
  204. package/dist/types/schemas/a2a/transport.js.map +1 -0
  205. package/dist/types/schemas/deployment/index.js +3 -0
  206. package/dist/types/schemas/deployment/index.js.map +1 -0
  207. package/dist/types/schemas/deployment/proxy.js +6 -0
  208. package/dist/types/schemas/deployment/proxy.js.map +1 -0
  209. package/dist/types/schemas/deployment/request.js +88 -0
  210. package/dist/types/schemas/deployment/request.js.map +1 -0
  211. package/dist/types/schemas/index.js +1 -0
  212. package/dist/types/schemas/index.js.map +1 -1
  213. package/dist/types/server/express/errors.d.ts +10 -0
  214. package/dist/types/server/express/errors.d.ts.map +1 -0
  215. package/dist/types/server/express/index.d.ts +4 -0
  216. package/dist/types/server/express/index.d.ts.map +1 -0
  217. package/dist/types/server/express/middeware.d.ts +8 -0
  218. package/dist/types/server/express/middeware.d.ts.map +1 -0
  219. package/dist/types/server/express/server.d.ts +71 -0
  220. package/dist/types/server/express/server.d.ts.map +1 -0
  221. package/dist/types/server/index.d.ts +1 -7
  222. package/dist/types/server/index.d.ts.map +1 -1
  223. package/dist/types/services/a2a/factory/builder.d.ts +352 -0
  224. package/dist/types/services/a2a/factory/builder.d.ts.map +1 -0
  225. package/dist/types/services/a2a/factory/context.d.ts +133 -0
  226. package/dist/types/services/a2a/factory/context.d.ts.map +1 -0
  227. package/dist/types/services/a2a/factory/event.d.ts +59 -0
  228. package/dist/types/services/a2a/factory/event.d.ts.map +1 -0
  229. package/dist/types/services/a2a/factory/index.d.ts +6 -0
  230. package/dist/types/services/a2a/factory/index.d.ts.map +1 -0
  231. package/dist/types/services/a2a/factory/method.d.ts +7 -0
  232. package/dist/types/services/a2a/factory/method.d.ts.map +1 -0
  233. package/dist/types/services/a2a/factory/service.d.ts +10 -0
  234. package/dist/types/services/a2a/factory/service.d.ts.map +1 -0
  235. package/dist/types/services/a2a/helpers/index.d.ts +2 -0
  236. package/dist/types/services/a2a/helpers/index.d.ts.map +1 -0
  237. package/dist/types/services/a2a/helpers/part.d.ts +49 -0
  238. package/dist/types/services/a2a/helpers/part.d.ts.map +1 -0
  239. package/dist/types/services/a2a/index.d.ts +5 -1
  240. package/dist/types/services/a2a/index.d.ts.map +1 -1
  241. package/dist/types/services/a2a/managers/cancellation.d.ts +12 -0
  242. package/dist/types/services/a2a/managers/cancellation.d.ts.map +1 -0
  243. package/dist/types/services/a2a/managers/connection.d.ts +12 -0
  244. package/dist/types/services/a2a/managers/connection.d.ts.map +1 -0
  245. package/dist/types/services/a2a/managers/context.d.ts +12 -0
  246. package/dist/types/services/a2a/managers/context.d.ts.map +1 -0
  247. package/dist/types/services/a2a/managers/index.d.ts +6 -0
  248. package/dist/types/services/a2a/managers/index.d.ts.map +1 -0
  249. package/dist/types/services/a2a/managers/task.d.ts +12 -0
  250. package/dist/types/services/a2a/managers/task.d.ts.map +1 -0
  251. package/dist/types/services/a2a/methods/cancel-task.d.ts +8 -0
  252. package/dist/types/services/a2a/methods/cancel-task.d.ts.map +1 -0
  253. package/dist/types/services/a2a/methods/get-task.d.ts +113 -0
  254. package/dist/types/services/a2a/methods/get-task.d.ts.map +1 -0
  255. package/dist/types/services/a2a/methods/index.d.ts +6 -0
  256. package/dist/types/services/a2a/methods/index.d.ts.map +1 -0
  257. package/dist/types/services/a2a/methods/resubscribe-task.d.ts +8 -0
  258. package/dist/types/services/a2a/methods/resubscribe-task.d.ts.map +1 -0
  259. package/dist/types/services/a2a/methods/send-message.d.ts +8 -0
  260. package/dist/types/services/a2a/methods/send-message.d.ts.map +1 -0
  261. package/dist/types/services/a2a/methods/stream-message.d.ts +9 -0
  262. package/dist/types/services/a2a/methods/stream-message.d.ts.map +1 -0
  263. package/dist/types/services/a2a/service.d.ts +375 -41
  264. package/dist/types/services/a2a/service.d.ts.map +1 -1
  265. package/dist/types/services/a2a/state/index.d.ts +4 -0
  266. package/dist/types/services/a2a/state/index.d.ts.map +1 -0
  267. package/dist/types/services/a2a/state/load.d.ts +15 -0
  268. package/dist/types/services/a2a/state/load.d.ts.map +1 -0
  269. package/dist/types/services/a2a/state/process.d.ts +8 -0
  270. package/dist/types/services/a2a/state/process.d.ts.map +1 -0
  271. package/dist/types/services/a2a/state/update/artifact.d.ts +11 -0
  272. package/dist/types/services/a2a/state/update/artifact.d.ts.map +1 -0
  273. package/dist/types/services/a2a/state/update/index.d.ts +3 -0
  274. package/dist/types/services/a2a/state/update/index.d.ts.map +1 -0
  275. package/dist/types/services/a2a/state/update/update.d.ts +24 -0
  276. package/dist/types/services/a2a/state/update/update.d.ts.map +1 -0
  277. package/dist/types/services/core/execution/execute.d.ts +7 -0
  278. package/dist/types/services/core/execution/execute.d.ts.map +1 -0
  279. package/dist/types/services/core/execution/index.d.ts +2 -0
  280. package/dist/types/services/core/execution/index.d.ts.map +1 -0
  281. package/dist/types/services/core/index.d.ts +3 -0
  282. package/dist/types/services/core/index.d.ts.map +1 -0
  283. package/dist/types/services/core/managers/command.d.ts +40 -0
  284. package/dist/types/services/core/managers/command.d.ts.map +1 -0
  285. package/dist/types/services/core/managers/event.d.ts +19 -0
  286. package/dist/types/services/core/managers/event.d.ts.map +1 -0
  287. package/dist/types/services/core/managers/index.d.ts +4 -0
  288. package/dist/types/services/core/managers/index.d.ts.map +1 -0
  289. package/dist/types/services/core/managers/stream.d.ts +21 -0
  290. package/dist/types/services/core/managers/stream.d.ts.map +1 -0
  291. package/dist/types/services/index.d.ts +2 -1
  292. package/dist/types/services/index.d.ts.map +1 -1
  293. package/dist/types/transport/index.d.ts +1 -1
  294. package/dist/types/transport/index.d.ts.map +1 -1
  295. package/dist/types/transport/rpc/parser.d.ts +5 -1
  296. package/dist/types/transport/rpc/parser.d.ts.map +1 -1
  297. package/dist/types/transport/rpc/rpc-client.d.ts +5 -1
  298. package/dist/types/transport/rpc/rpc-client.d.ts.map +1 -1
  299. package/dist/types/transport/streaming/event-stream.d.ts +5 -1
  300. package/dist/types/transport/streaming/event-stream.d.ts.map +1 -1
  301. package/dist/types/transport/trpc/a2a/factory/index.d.ts +2 -0
  302. package/dist/types/transport/trpc/a2a/factory/index.d.ts.map +1 -0
  303. package/dist/types/transport/trpc/a2a/factory/router.d.ts +2631 -0
  304. package/dist/types/transport/trpc/a2a/factory/router.d.ts.map +1 -0
  305. package/dist/types/transport/trpc/a2a/index.d.ts +4 -0
  306. package/dist/types/transport/trpc/a2a/index.d.ts.map +1 -0
  307. package/dist/types/transport/trpc/a2a/routes/index.d.ts +4 -0
  308. package/dist/types/transport/trpc/a2a/routes/index.d.ts.map +1 -0
  309. package/dist/types/transport/trpc/a2a/routes/info.d.ts +102 -0
  310. package/dist/types/transport/trpc/a2a/routes/info.d.ts.map +1 -0
  311. package/dist/types/transport/trpc/a2a/routes/message/index.d.ts +2 -0
  312. package/dist/types/transport/trpc/a2a/routes/message/index.d.ts.map +1 -0
  313. package/dist/types/transport/trpc/a2a/routes/message/route.d.ts +523 -0
  314. package/dist/types/transport/trpc/a2a/routes/message/route.d.ts.map +1 -0
  315. package/dist/types/transport/trpc/a2a/routes/tasks/index.d.ts +2 -0
  316. package/dist/types/transport/trpc/a2a/routes/tasks/index.d.ts.map +1 -0
  317. package/dist/types/transport/trpc/a2a/routes/tasks/route.d.ts +646 -0
  318. package/dist/types/transport/trpc/a2a/routes/tasks/route.d.ts.map +1 -0
  319. package/dist/types/transport/trpc/a2a/trpc.d.ts +272 -0
  320. package/dist/types/transport/trpc/a2a/trpc.d.ts.map +1 -0
  321. package/dist/types/transport/trpc/index.d.ts +2 -0
  322. package/dist/types/transport/trpc/index.d.ts.map +1 -0
  323. package/dist/types/types/ext.d.ts +14 -0
  324. package/dist/types/types/ext.d.ts.map +1 -0
  325. package/dist/types/types/index.d.ts +3 -4
  326. package/dist/types/types/index.d.ts.map +1 -1
  327. package/dist/types/types/{client.d.ts → interfaces/client.d.ts} +7 -2
  328. package/dist/types/types/interfaces/client.d.ts.map +1 -0
  329. package/dist/types/types/interfaces/index.d.ts +4 -0
  330. package/dist/types/types/interfaces/index.d.ts.map +1 -0
  331. package/dist/types/types/interfaces/services/a2a/builder.d.ts +33 -0
  332. package/dist/types/types/interfaces/services/a2a/builder.d.ts.map +1 -0
  333. package/dist/types/types/interfaces/services/a2a/context.d.ts +163 -0
  334. package/dist/types/types/interfaces/services/a2a/context.d.ts.map +1 -0
  335. package/dist/types/types/interfaces/services/a2a/engine.d.ts +8 -0
  336. package/dist/types/types/interfaces/services/a2a/engine.d.ts.map +1 -0
  337. package/dist/types/types/interfaces/services/a2a/index.d.ts +6 -0
  338. package/dist/types/types/interfaces/services/a2a/index.d.ts.map +1 -0
  339. package/dist/types/types/interfaces/services/a2a/legacy.d.ts +90 -0
  340. package/dist/types/types/interfaces/services/a2a/legacy.d.ts.map +1 -0
  341. package/dist/types/types/interfaces/services/a2a/service.d.ts +409 -0
  342. package/dist/types/types/interfaces/services/a2a/service.d.ts.map +1 -0
  343. package/dist/types/types/interfaces/services/core/context/command.d.ts +26 -0
  344. package/dist/types/types/interfaces/services/core/context/command.d.ts.map +1 -0
  345. package/dist/types/types/interfaces/services/core/context/context.d.ts +208 -0
  346. package/dist/types/types/interfaces/services/core/context/context.d.ts.map +1 -0
  347. package/dist/types/types/interfaces/services/core/context/index.d.ts +4 -0
  348. package/dist/types/types/interfaces/services/core/context/index.d.ts.map +1 -0
  349. package/dist/types/types/interfaces/services/core/context/types.d.ts +12 -0
  350. package/dist/types/types/interfaces/services/core/context/types.d.ts.map +1 -0
  351. package/dist/types/types/interfaces/services/core/execution/engine.d.ts +107 -0
  352. package/dist/types/types/interfaces/services/core/execution/engine.d.ts.map +1 -0
  353. package/dist/types/types/interfaces/services/core/execution/environment.d.ts +12 -0
  354. package/dist/types/types/interfaces/services/core/execution/environment.d.ts.map +1 -0
  355. package/dist/types/types/interfaces/services/core/execution/execute.d.ts +8 -0
  356. package/dist/types/types/interfaces/services/core/execution/execute.d.ts.map +1 -0
  357. package/dist/types/types/interfaces/services/core/execution/index.d.ts +4 -0
  358. package/dist/types/types/interfaces/services/core/execution/index.d.ts.map +1 -0
  359. package/dist/types/types/interfaces/services/core/index.d.ts +5 -0
  360. package/dist/types/types/interfaces/services/core/index.d.ts.map +1 -0
  361. package/dist/types/types/interfaces/services/core/managers/cancellation.d.ts +10 -0
  362. package/dist/types/types/interfaces/services/core/managers/cancellation.d.ts.map +1 -0
  363. package/dist/types/types/interfaces/services/core/managers/connection.d.ts +10 -0
  364. package/dist/types/types/interfaces/services/core/managers/connection.d.ts.map +1 -0
  365. package/dist/types/types/interfaces/services/core/managers/context.d.ts +18 -0
  366. package/dist/types/types/interfaces/services/core/managers/context.d.ts.map +1 -0
  367. package/dist/types/types/interfaces/services/core/managers/event.d.ts +329 -0
  368. package/dist/types/types/interfaces/services/core/managers/event.d.ts.map +1 -0
  369. package/dist/types/types/interfaces/services/core/managers/index.d.ts +7 -0
  370. package/dist/types/types/interfaces/services/core/managers/index.d.ts.map +1 -0
  371. package/dist/types/types/interfaces/services/core/managers/stream.d.ts +218 -0
  372. package/dist/types/types/interfaces/services/core/managers/stream.d.ts.map +1 -0
  373. package/dist/types/types/interfaces/services/core/managers/task.d.ts +10 -0
  374. package/dist/types/types/interfaces/services/core/managers/task.d.ts.map +1 -0
  375. package/dist/types/types/interfaces/services/core/service.d.ts +116 -0
  376. package/dist/types/types/interfaces/services/core/service.d.ts.map +1 -0
  377. package/dist/types/types/interfaces/services/index.d.ts +4 -0
  378. package/dist/types/types/interfaces/services/index.d.ts.map +1 -0
  379. package/dist/types/types/{services → interfaces/services}/protocol.d.ts +4 -0
  380. package/dist/types/types/interfaces/services/protocol.d.ts.map +1 -0
  381. package/dist/types/types/interfaces/storage.d.ts +9 -0
  382. package/dist/types/types/interfaces/storage.d.ts.map +1 -0
  383. package/dist/types/types/schemas/a2a/agent.d.ts +509 -0
  384. package/dist/types/types/schemas/a2a/agent.d.ts.map +1 -0
  385. package/dist/types/types/schemas/a2a/auth.d.ts +285 -0
  386. package/dist/types/types/schemas/a2a/auth.d.ts.map +1 -0
  387. package/dist/types/types/schemas/a2a/error.d.ts +133 -27
  388. package/dist/types/types/schemas/a2a/error.d.ts.map +1 -1
  389. package/dist/types/types/schemas/a2a/index.d.ts +8 -216
  390. package/dist/types/types/schemas/a2a/index.d.ts.map +1 -1
  391. package/dist/types/types/schemas/a2a/kind.d.ts +28 -0
  392. package/dist/types/types/schemas/a2a/kind.d.ts.map +1 -0
  393. package/dist/types/types/schemas/a2a/message.d.ts +2549 -69
  394. package/dist/types/types/schemas/a2a/message.d.ts.map +1 -1
  395. package/dist/types/types/schemas/a2a/notification.d.ts +321 -70
  396. package/dist/types/types/schemas/a2a/notification.d.ts.map +1 -1
  397. package/dist/types/types/schemas/a2a/parameters.d.ts +287 -167
  398. package/dist/types/types/schemas/a2a/parameters.d.ts.map +1 -1
  399. package/dist/types/types/schemas/a2a/protocol.d.ts +3207 -0
  400. package/dist/types/types/schemas/a2a/protocol.d.ts.map +1 -0
  401. package/dist/types/types/schemas/a2a/rpc.d.ts +42 -89
  402. package/dist/types/types/schemas/a2a/rpc.d.ts.map +1 -1
  403. package/dist/types/types/schemas/a2a/task.d.ts +1460 -214
  404. package/dist/types/types/schemas/a2a/task.d.ts.map +1 -1
  405. package/dist/types/types/schemas/a2a/transport.d.ts +28 -0
  406. package/dist/types/types/schemas/a2a/transport.d.ts.map +1 -0
  407. package/dist/types/types/schemas/deployment/index.d.ts +3 -0
  408. package/dist/types/types/schemas/deployment/index.d.ts.map +1 -0
  409. package/dist/types/types/{proxy.d.ts → schemas/deployment/proxy.d.ts} +6 -2
  410. package/dist/types/types/schemas/deployment/proxy.d.ts.map +1 -0
  411. package/dist/types/types/schemas/deployment/request.d.ts +508 -0
  412. package/dist/types/types/schemas/deployment/request.d.ts.map +1 -0
  413. package/dist/types/types/utils/index.d.ts +2 -0
  414. package/dist/types/types/utils/index.d.ts.map +1 -0
  415. package/dist/types/types/{transform.d.ts → utils/transform.d.ts} +4 -0
  416. package/dist/types/types/utils/transform.d.ts.map +1 -0
  417. package/dist/types/utils/api/register.d.ts +4 -0
  418. package/dist/types/utils/api/register.d.ts.map +1 -1
  419. package/dist/types/utils/common/constants.d.ts +8 -4
  420. package/dist/types/utils/common/constants.d.ts.map +1 -1
  421. package/dist/types/utils/common/errors.d.ts +6 -12
  422. package/dist/types/utils/common/errors.d.ts.map +1 -1
  423. package/dist/types/utils/common/utils.d.ts +4 -14
  424. package/dist/types/utils/common/utils.d.ts.map +1 -1
  425. package/dist/types/utils/common/zAsyncIterable.d.ts +23 -0
  426. package/dist/types/utils/common/zAsyncIterable.d.ts.map +1 -0
  427. package/dist/types/utils/deployment/agents.d.ts +5 -1
  428. package/dist/types/utils/deployment/agents.d.ts.map +1 -1
  429. package/dist/types/utils/deployment/bundler.d.ts +4 -0
  430. package/dist/types/utils/deployment/bundler.d.ts.map +1 -1
  431. package/dist/types/utils/deployment/full-deployment.d.ts +12 -2
  432. package/dist/types/utils/deployment/full-deployment.d.ts.map +1 -1
  433. package/dist/types/utils/deployment/index.d.ts +5 -0
  434. package/dist/types/utils/deployment/index.d.ts.map +1 -0
  435. package/dist/types/utils/deployment/task-wrapper.d.ts +6 -2
  436. package/dist/types/utils/deployment/task-wrapper.d.ts.map +1 -1
  437. package/dist/types/utils/deployment/test-deployment.d.ts +7 -2
  438. package/dist/types/utils/deployment/test-deployment.d.ts.map +1 -1
  439. package/dist/types/utils/index.d.ts +4 -6
  440. package/dist/types/utils/index.d.ts.map +1 -1
  441. package/dist/types/utils/index.js +2 -0
  442. package/dist/types/utils/index.js.map +1 -0
  443. package/dist/types/utils/logging/index.d.ts +3 -0
  444. package/dist/types/utils/logging/index.d.ts.map +1 -0
  445. package/dist/types/utils/logging/log.d.ts +4 -0
  446. package/dist/types/utils/logging/log.d.ts.map +1 -1
  447. package/dist/types/utils/logging/logger.d.ts +4 -0
  448. package/dist/types/utils/logging/logger.d.ts.map +1 -1
  449. package/dist/types/{server/lib → utils}/storage/file.d.ts +9 -4
  450. package/dist/types/utils/storage/file.d.ts.map +1 -0
  451. package/dist/types/{server/lib → utils}/storage/memory.d.ts +9 -4
  452. package/dist/types/utils/storage/memory.d.ts.map +1 -0
  453. package/dist/types/{transform.js → utils/transform.js} +2 -1
  454. package/dist/types/utils/transform.js.map +1 -0
  455. package/dist/utils/api/register.js +4 -0
  456. package/dist/utils/api/register.js.map +1 -1
  457. package/dist/utils/common/constants.js +20 -11
  458. package/dist/utils/common/constants.js.map +1 -1
  459. package/dist/utils/common/errors.js +7 -40
  460. package/dist/utils/common/errors.js.map +1 -1
  461. package/dist/utils/common/utils.js +4 -46
  462. package/dist/utils/common/utils.js.map +1 -1
  463. package/dist/utils/common/zAsyncIterable.js +40 -0
  464. package/dist/utils/common/zAsyncIterable.js.map +1 -0
  465. package/dist/utils/deployment/agents.js +4 -0
  466. package/dist/utils/deployment/agents.js.map +1 -1
  467. package/dist/utils/deployment/bundler.js +4 -0
  468. package/dist/utils/deployment/bundler.js.map +1 -1
  469. package/dist/utils/deployment/full-deployment.js +6 -2
  470. package/dist/utils/deployment/full-deployment.js.map +1 -1
  471. package/dist/utils/deployment/index.js +5 -0
  472. package/dist/utils/deployment/index.js.map +1 -0
  473. package/dist/utils/deployment/task-wrapper.js +4 -0
  474. package/dist/utils/deployment/task-wrapper.js.map +1 -1
  475. package/dist/utils/deployment/test-deployment.js +15 -7
  476. package/dist/utils/deployment/test-deployment.js.map +1 -1
  477. package/dist/utils/index.js +10 -6
  478. package/dist/utils/index.js.map +1 -1
  479. package/dist/utils/logging/index.js +3 -0
  480. package/dist/utils/logging/index.js.map +1 -0
  481. package/dist/utils/logging/log.js +4 -0
  482. package/dist/utils/logging/log.js.map +1 -1
  483. package/dist/utils/logging/logger.js +13 -0
  484. package/dist/utils/logging/logger.js.map +1 -1
  485. package/dist/{server/lib → utils}/storage/file.js +17 -6
  486. package/dist/utils/storage/file.js.map +1 -0
  487. package/dist/{server/lib → utils}/storage/memory.js +15 -5
  488. package/dist/utils/storage/memory.js.map +1 -0
  489. package/package.json +16 -5
  490. package/dist/server/a2a-server.js +0 -237
  491. package/dist/server/a2a-server.js.map +0 -1
  492. package/dist/server/interfaces/params.js +0 -3
  493. package/dist/server/interfaces/params.js.map +0 -1
  494. package/dist/server/interfaces/server.js +0 -2
  495. package/dist/server/interfaces/server.js.map +0 -1
  496. package/dist/server/interfaces/store.js +0 -18
  497. package/dist/server/interfaces/store.js.map +0 -1
  498. package/dist/server/lib/express-server.js +0 -252
  499. package/dist/server/lib/express-server.js.map +0 -1
  500. package/dist/server/lib/json-middleware.js +0 -3
  501. package/dist/server/lib/json-middleware.js.map +0 -1
  502. package/dist/server/lib/middleware/a2a-methods.js +0 -140
  503. package/dist/server/lib/middleware/a2a-methods.js.map +0 -1
  504. package/dist/server/lib/middleware/factory.js +0 -59
  505. package/dist/server/lib/middleware/factory.js.map +0 -1
  506. package/dist/server/lib/state.js +0 -80
  507. package/dist/server/lib/state.js.map +0 -1
  508. package/dist/server/lib/storage/file.js.map +0 -1
  509. package/dist/server/lib/storage/memory.js.map +0 -1
  510. package/dist/server/lib/update/base.js.map +0 -1
  511. package/dist/services/a2a/repository.js +0 -160
  512. package/dist/services/a2a/repository.js.map +0 -1
  513. package/dist/services/manager.js +0 -61
  514. package/dist/services/manager.js.map +0 -1
  515. package/dist/services/mcp/index.js +0 -2
  516. package/dist/services/mcp/index.js.map +0 -1
  517. package/dist/services/mcp/service.js +0 -75
  518. package/dist/services/mcp/service.js.map +0 -1
  519. package/dist/transport/streaming/stream.js +0 -111
  520. package/dist/transport/streaming/stream.js.map +0 -1
  521. package/dist/types/client.js +0 -2
  522. package/dist/types/client.js.map +0 -1
  523. package/dist/types/express.js +0 -2
  524. package/dist/types/express.js.map +0 -1
  525. package/dist/types/extended-schema.js +0 -7
  526. package/dist/types/extended-schema.js.map +0 -1
  527. package/dist/types/proxy.js +0 -2
  528. package/dist/types/proxy.js.map +0 -1
  529. package/dist/types/schemas/a2a/auth/auth.js +0 -2
  530. package/dist/types/schemas/a2a/auth/auth.js.map +0 -1
  531. package/dist/types/schemas/a2a/auth/base.js +0 -2
  532. package/dist/types/schemas/a2a/auth/base.js.map +0 -1
  533. package/dist/types/schemas/a2a/auth/index.js +0 -4
  534. package/dist/types/schemas/a2a/auth/index.js.map +0 -1
  535. package/dist/types/schemas/a2a/auth/oauth.js +0 -2
  536. package/dist/types/schemas/a2a/auth/oauth.js.map +0 -1
  537. package/dist/types/schemas/a2a/ref.js +0 -25
  538. package/dist/types/schemas/a2a/ref.js.map +0 -1
  539. package/dist/types/server/a2a-server.d.ts +0 -145
  540. package/dist/types/server/a2a-server.d.ts.map +0 -1
  541. package/dist/types/server/interfaces/params.d.ts +0 -109
  542. package/dist/types/server/interfaces/params.d.ts.map +0 -1
  543. package/dist/types/server/interfaces/server.d.ts +0 -35
  544. package/dist/types/server/interfaces/server.d.ts.map +0 -1
  545. package/dist/types/server/interfaces/store.d.ts +0 -35
  546. package/dist/types/server/interfaces/store.d.ts.map +0 -1
  547. package/dist/types/server/lib/express-server.d.ts +0 -59
  548. package/dist/types/server/lib/express-server.d.ts.map +0 -1
  549. package/dist/types/server/lib/json-middleware.d.ts +0 -3
  550. package/dist/types/server/lib/json-middleware.d.ts.map +0 -1
  551. package/dist/types/server/lib/middleware/a2a-methods.d.ts +0 -7
  552. package/dist/types/server/lib/middleware/a2a-methods.d.ts.map +0 -1
  553. package/dist/types/server/lib/middleware/factory.d.ts +0 -12
  554. package/dist/types/server/lib/middleware/factory.d.ts.map +0 -1
  555. package/dist/types/server/lib/state.d.ts +0 -20
  556. package/dist/types/server/lib/state.d.ts.map +0 -1
  557. package/dist/types/server/lib/storage/file.d.ts.map +0 -1
  558. package/dist/types/server/lib/storage/memory.d.ts.map +0 -1
  559. package/dist/types/server/lib/update/base.d.ts +0 -21
  560. package/dist/types/server/lib/update/base.d.ts.map +0 -1
  561. package/dist/types/services/a2a/repository.d.ts +0 -77
  562. package/dist/types/services/a2a/repository.d.ts.map +0 -1
  563. package/dist/types/services/a2a/repository.js +0 -2
  564. package/dist/types/services/a2a/repository.js.map +0 -1
  565. package/dist/types/services/a2a/service.js +0 -2
  566. package/dist/types/services/a2a/service.js.map +0 -1
  567. package/dist/types/services/context.js +0 -29
  568. package/dist/types/services/context.js.map +0 -1
  569. package/dist/types/services/dispatcher.js +0 -33
  570. package/dist/types/services/dispatcher.js.map +0 -1
  571. package/dist/types/services/index.js +0 -9
  572. package/dist/types/services/index.js.map +0 -1
  573. package/dist/types/services/manager.d.ts +0 -44
  574. package/dist/types/services/manager.d.ts.map +0 -1
  575. package/dist/types/services/manager.js +0 -2
  576. package/dist/types/services/manager.js.map +0 -1
  577. package/dist/types/services/mcp/index.d.ts +0 -2
  578. package/dist/types/services/mcp/index.d.ts.map +0 -1
  579. package/dist/types/services/mcp/service.d.ts +0 -30
  580. package/dist/types/services/mcp/service.d.ts.map +0 -1
  581. package/dist/types/services/mcp/service.js +0 -8
  582. package/dist/types/services/mcp/service.js.map +0 -1
  583. package/dist/types/services/protocol.js.map +0 -1
  584. package/dist/types/services/service.js +0 -2
  585. package/dist/types/services/service.js.map +0 -1
  586. package/dist/types/transform.js.map +0 -1
  587. package/dist/types/transport/streaming/stream.d.ts +0 -42
  588. package/dist/types/transport/streaming/stream.d.ts.map +0 -1
  589. package/dist/types/types/client.d.ts.map +0 -1
  590. package/dist/types/types/express.d.ts +0 -66
  591. package/dist/types/types/express.d.ts.map +0 -1
  592. package/dist/types/types/extended-schema.d.ts +0 -174
  593. package/dist/types/types/extended-schema.d.ts.map +0 -1
  594. package/dist/types/types/proxy.d.ts.map +0 -1
  595. package/dist/types/types/schemas/a2a/auth/auth.d.ts +0 -80
  596. package/dist/types/types/schemas/a2a/auth/auth.d.ts.map +0 -1
  597. package/dist/types/types/schemas/a2a/auth/base.d.ts +0 -16
  598. package/dist/types/types/schemas/a2a/auth/base.d.ts.map +0 -1
  599. package/dist/types/types/schemas/a2a/auth/index.d.ts +0 -4
  600. package/dist/types/types/schemas/a2a/auth/index.d.ts.map +0 -1
  601. package/dist/types/types/schemas/a2a/auth/oauth.d.ts +0 -124
  602. package/dist/types/types/schemas/a2a/auth/oauth.d.ts.map +0 -1
  603. package/dist/types/types/schemas/a2a/ref.d.ts +0 -2057
  604. package/dist/types/types/schemas/a2a/ref.d.ts.map +0 -1
  605. package/dist/types/types/services/a2a/repository.d.ts +0 -85
  606. package/dist/types/types/services/a2a/repository.d.ts.map +0 -1
  607. package/dist/types/types/services/a2a/service.d.ts +0 -29
  608. package/dist/types/types/services/a2a/service.d.ts.map +0 -1
  609. package/dist/types/types/services/context.d.ts +0 -167
  610. package/dist/types/types/services/context.d.ts.map +0 -1
  611. package/dist/types/types/services/dispatcher.d.ts +0 -20
  612. package/dist/types/types/services/dispatcher.d.ts.map +0 -1
  613. package/dist/types/types/services/index.d.ts +0 -9
  614. package/dist/types/types/services/index.d.ts.map +0 -1
  615. package/dist/types/types/services/manager.d.ts +0 -42
  616. package/dist/types/types/services/manager.d.ts.map +0 -1
  617. package/dist/types/types/services/mcp/service.d.ts +0 -57
  618. package/dist/types/types/services/mcp/service.d.ts.map +0 -1
  619. package/dist/types/types/services/protocol.d.ts.map +0 -1
  620. package/dist/types/types/services/service.d.ts +0 -35
  621. package/dist/types/types/services/service.d.ts.map +0 -1
  622. package/dist/types/types/transform.d.ts.map +0 -1
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ /**
6
+ * @fileoverview Core Context Interface Definition
7
+ *
8
+ * This module defines the CoreContext interface, which serves as the central
9
+ * execution environment for all command processing. The context encapsulates
10
+ * the command, state management, event handling, and cancellation mechanisms
11
+ * required for execution engine operations.
12
+ *
13
+ * @module CoreContext
14
+ * @version 1.0.0
15
+ * @since 0.5.6
16
+ * @author The Artinet Project
17
+ */
18
+ import { EventManagerInterface } from "../managers/event.js";
19
+ import { CoreCommand, CoreState, CoreUpdate } from "./types.js";
20
+ import { ReceiveCommandProxyInterface } from "./command.js";
21
+ /**
22
+ * Core execution context interface that provide the complete environment for command execution.
23
+ *
24
+ * The CoreContext serves as the primary execution environment passed to execution engines.
25
+ * It encapsulates all the necessary components for command processing, including the command
26
+ * itself, state management, event handling, and cancellation signals. This design enables
27
+ * execution engines to be stateless functions that receive everything they need through
28
+ * the context parameter.
29
+ *
30
+ * The context is designed to support "Context Engineering" - the practice of carefully
31
+ * constructing execution environments that contain all necessary information and capabilities
32
+ * for effective command processing. As the system evolves, the context becomes increasingly
33
+ * important for enabling sophisticated execution patterns.
34
+ *
35
+ * @template TCommand - The command type, must extend CoreCommand
36
+ * @template TState - The state type, must extend CoreState
37
+ * @template TUpdate - The update type, must extend CoreUpdate
38
+ *
39
+ * @example
40
+ * ```typescript
41
+ * // Using context in an execution engine
42
+ * const myEngine: ExecutionEngine<MyCommand, MyState, MyUpdate> = async function* (context) {
43
+ * const { command, State, events, signal, isCancelled } = context;
44
+ *
45
+ * // Get current state
46
+ * const currentState = State();
47
+ *
48
+ * // Check for cancellation
49
+ * if (isCancelled() || signal.aborted) {
50
+ * yield { type: 'cancelled' };
51
+ * return;
52
+ * }
53
+ *
54
+ * // Process command
55
+ * const result = await processCommand(command);
56
+ *
57
+ * // Emit events and yield updates
58
+ * events.emit('progress', { progress: 0.5 });
59
+ * yield { type: 'progress', progress: 0.5, data: result };
60
+ * };
61
+ * ```
62
+ *
63
+ * @example
64
+ * ```typescript
65
+ * // Creating and using a context
66
+ * const context: CoreContext<MyCommand, MyState, MyUpdate> = {
67
+ * contextId: 'execution-123',
68
+ * command: createCommandProxy(myCommand),
69
+ * events: createEventManager(),
70
+ * signal: abortController.signal,
71
+ * isCancelled: () => abortController.signal.aborted,
72
+ * State: () => getCurrentState()
73
+ * };
74
+ *
75
+ * // Execute with context
76
+ * for await (const update of myEngine(context)) {
77
+ * console.log('Update:', update);
78
+ * }
79
+ * ```
80
+ *
81
+ * @remarks
82
+ * **Design Philosophy:**
83
+ * The context represents a shift toward functional execution patterns where execution
84
+ * engines are pure functions that receive all necessary dependencies through the
85
+ * context parameter. This approach enables:
86
+ *
87
+ * - **Testability**: Easy to mock and test individual components
88
+ * - **Composability**: Different engines can work with the same context interface
89
+ * - **Flexibility**: Context can be enhanced without changing engine signatures
90
+ * - **Debugging**: Complete execution environment is visible and traceable
91
+ *
92
+ * **Context Engineering:**
93
+ * As mentioned in the original note, Context Engineering is becoming increasingly
94
+ * important. This involves carefully designing contexts that provide the right
95
+ * level of abstraction and capability for specific execution scenarios.
96
+ *
97
+ * @public
98
+ * @since 0.5.6
99
+ */
100
+ export interface CoreContext<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> {
101
+ /**
102
+ * Unique identifier for this execution context.
103
+ *
104
+ * This ID is used throughout the system to track and correlate execution
105
+ * activities, logs, and state updates with specific command executions.
106
+ *
107
+ * @example
108
+ * ```typescript
109
+ * console.log(`Starting execution: ${context.contextId}`);
110
+ * loggerService.info(`[${context.contextId}] Processing command`);
111
+ * ```
112
+ */
113
+ readonly contextId: string;
114
+ /**
115
+ * Command proxy interface providing access to the command being executed.
116
+ *
117
+ * The command proxy wraps the original command and may provide additional
118
+ * functionality such as validation, logging, or transformation. It allows
119
+ * execution engines to access command data in a controlled manner.
120
+ *
121
+ * @example
122
+ * ```typescript
123
+ * const { command } = context;
124
+ *
125
+ * // Access command properties
126
+ * const userId = command.metadata?.userId;
127
+ * const taskType = command.type;
128
+ * const parameters = command.params;
129
+ *
130
+ * // Use command data in processing
131
+ * const result = await processTask(taskType, parameters, userId);
132
+ * ```
133
+ */
134
+ command: ReceiveCommandProxyInterface<TCommand>;
135
+ /**
136
+ * Function to check if the execution has been cancelled.
137
+ *
138
+ * This function provides a convenient way to check cancellation status
139
+ * throughout execution. It may aggregate multiple cancellation sources
140
+ * including abort signals, service-level cancellation, and timeout conditions.
141
+ *
142
+ * @returns True if the execution should be cancelled, false otherwise
143
+ *
144
+ * @example
145
+ * ```typescript
146
+ * // Check before expensive operations
147
+ * if (context.isCancelled()) {
148
+ * yield { type: 'cancelled', reason: 'User cancellation' };
149
+ * return;
150
+ * }
151
+ *
152
+ * // Check in processing loops
153
+ * for (const item of largeDataSet) {
154
+ * if (context.isCancelled()) break;
155
+ * await processItem(item);
156
+ * }
157
+ * ```
158
+ */
159
+ readonly isCancelled: () => boolean;
160
+ /**
161
+ * Abort signal for cancellation handling.
162
+ *
163
+ * This standard AbortSignal provides a way to handle cancellation in a
164
+ * platform-standard manner. It can be passed to fetch requests, timeouts,
165
+ * and other async operations that support cancellation.
166
+ */
167
+ readonly signal: AbortSignal;
168
+ /**
169
+ * Event manager for handling execution lifecycle events.
170
+ *
171
+ * The event manager provides event emission and subscription capabilities
172
+ * for execution lifecycle events. It handles state transitions, error
173
+ * scenarios, and completion notifications.
174
+ *
175
+ * @example
176
+ * ```typescript
177
+ * const { events } = context;
178
+ *
179
+ * // Listen for events
180
+ * events.on('update', (state, update) => {
181
+ * console.log('State updated:', state);
182
+ * });
183
+ *
184
+ * // Handle errors
185
+ * events.on('error', (error, state) => {
186
+ * console.error('Execution error:', error);
187
+ * });
188
+ * ```
189
+ */
190
+ readonly events: EventManagerInterface<TCommand, TState, TUpdate>;
191
+ /**
192
+ * Function to get the current execution state.
193
+ *
194
+ * This function provides access to the current state of the execution.
195
+ * The state represents the accumulated result of all updates processed
196
+ * so far and serves as the foundation for decision-making in execution engines.
197
+ *
198
+ * @returns The current execution state
199
+ *
200
+ * @example
201
+ * ```typescript
202
+ * // Get current state for decision making
203
+ * const currentState = context.State();
204
+ * ```
205
+ */
206
+ readonly State: () => TState;
207
+ }
208
+ //# sourceMappingURL=context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/context/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,SAAS,SAAS,GAAG,SAAS,EACpC,OAAO,SAAS,UAAU,GAAG,UAAU;IAEvC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAElE;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;CAC9B"}
@@ -0,0 +1,4 @@
1
+ export * from "./command.js";
2
+ export * from "./context.js";
3
+ export * from "./types.js";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ /**
6
+ * We're starting with simple base types for the core context.
7
+ * The base types will expand as we determine what is common across all services.
8
+ */
9
+ export type CoreCommand<TCommand extends object = object> = TCommand;
10
+ export type CoreState<TState extends {} = {}> = TState;
11
+ export type CoreUpdate<TUpdate = unknown> = TUpdate;
12
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/context/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AAEH,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;AAErE,MAAM,MAAM,SAAS,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,IAAI,MAAM,CAAC;AAEvD,MAAM,MAAM,UAAU,CAAC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC"}
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ /**
6
+ * @fileoverview Core Execution Engine Type Definition
7
+ *
8
+ * This module defines the fundamental execution engine type that serves as the
9
+ * foundation for all command processing in the core service framework. Execution
10
+ * engines are responsible for transforming commands into streams of updates.
11
+ *
12
+ * @module CoreExecutionEngine
13
+ * @version 1.0.0
14
+ * @since 0.5.6
15
+ * @author The Artinet Project
16
+ */
17
+ import { CoreCommand, CoreContext, CoreState, CoreUpdate } from "../context/index.js";
18
+ /**
19
+ * Core execution engine function signature.
20
+ *
21
+ * An ExecutionEngine is a function that accepts a CoreContext and returns an
22
+ * AsyncGenerator yielding updates. This pattern enables streaming execution
23
+ * where commands can produce multiple updates over time, supporting both
24
+ * real-time processing and long-running operations.
25
+ *
26
+ * The engine receives a complete execution context containing the command to
27
+ * execute, current state, event management, and cancellation signals. It
28
+ * processes the command and yields updates as execution progresses, allowing
29
+ * consumers to receive real-time feedback about execution status.
30
+ *
31
+ * @template TCommand - The command type, must extend CoreCommand
32
+ * @template TState - The state type, must extend CoreState
33
+ * @template TUpdate - The update type, must extend CoreUpdate
34
+ *
35
+ * @param context - The execution context containing command, state, and environment
36
+ * @returns AsyncGenerator that yields updates during execution
37
+ *
38
+ * @example
39
+ * ```typescript
40
+ * // Simple execution engine that processes a command
41
+ * const simpleEngine: ExecutionEngine<MyCommand, MyState, MyUpdate> = async function* (context) {
42
+ * const { command, State } = context;
43
+ *
44
+ * // Yield progress update
45
+ * yield {
46
+ * type: 'progress',
47
+ * message: 'Starting execution...',
48
+ * progress: 0
49
+ * };
50
+ *
51
+ * // Process command
52
+ * const result = await processCommand(command);
53
+ *
54
+ * // Yield intermediate results
55
+ * yield {
56
+ * type: 'data',
57
+ * data: result.intermediateData,
58
+ * progress: 0.5
59
+ * };
60
+ *
61
+ * // Complete processing
62
+ * const finalResult = await finalizeResult(result);
63
+ *
64
+ * // Yield final update
65
+ * yield {
66
+ * type: 'complete',
67
+ * data: finalResult,
68
+ * progress: 1.0
69
+ * };
70
+ * };
71
+ * ```
72
+ *
73
+ * @example
74
+ * ```typescript
75
+ * // Execution engine with error handling and cancellation
76
+ * const robustEngine: ExecutionEngine = async function* (context) {
77
+ * const { command, signal, isCancelled } = context;
78
+ *
79
+ * try {
80
+ * for (let i = 0; i < command.steps.length; i++) {
81
+ * // Check for cancellation
82
+ * if (isCancelled() || signal.aborted) {
83
+ * yield { type: 'cancelled', step: i };
84
+ * return;
85
+ * }
86
+ *
87
+ * // Process step
88
+ * const stepResult = await processStep(command.steps[i]);
89
+ *
90
+ * yield {
91
+ * type: 'step-complete',
92
+ * step: i,
93
+ * result: stepResult,
94
+ * progress: (i + 1) / command.steps.length
95
+ * };
96
+ * }
97
+ * } catch (error) {
98
+ * yield { type: 'error', error: error.message };
99
+ * }
100
+ * };
101
+ * ```
102
+ *
103
+ * @public
104
+ * @since 0.5.6
105
+ */
106
+ export type ExecutionEngine<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> = (context: CoreContext<TCommand, TState, TUpdate>) => AsyncGenerator<TUpdate, void, unknown>;
107
+ //# sourceMappingURL=engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/execution/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AACH,MAAM,MAAM,eAAe,CACzB,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,SAAS,SAAS,GAAG,SAAS,EACpC,OAAO,SAAS,UAAU,GAAG,UAAU,IACrC,CACF,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAC5C,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ import { CoreCommand, CoreState, CoreUpdate } from "../context/index.js";
6
+ import { ServiceInterface } from "../service.js";
7
+ import { ExecutionEngine } from "./engine.js";
8
+ export interface ExecutionEnvironment<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> {
9
+ service: ServiceInterface<TCommand, TState, TUpdate>;
10
+ engine?: ExecutionEngine<TCommand, TState, TUpdate>;
11
+ }
12
+ //# sourceMappingURL=environment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/execution/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,oBAAoB,CACnC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,SAAS,SAAS,GAAG,SAAS,EACpC,OAAO,SAAS,UAAU,GAAG,UAAU;IAEvC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACrD"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ import { CoreContext, CoreCommand, CoreState, CoreUpdate } from "../context/index.js";
6
+ import { ExecutionEngine } from "./engine.js";
7
+ export type ExecuteFunction<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> = (engine: ExecutionEngine<TCommand, TState, TUpdate>, context: CoreContext<TCommand, TState, TUpdate>) => Promise<void>;
8
+ //# sourceMappingURL=execute.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/execution/execute.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,eAAe,CACzB,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,SAAS,SAAS,GAAG,SAAS,EACpC,OAAO,SAAS,UAAU,GAAG,UAAU,IACrC,CACF,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAClD,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAC5C,OAAO,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ export * from "./engine.js";
2
+ export * from "./environment.js";
3
+ export * from "./execute.js";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/execution/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from "./context/index.js";
2
+ export * from "./execution/index.js";
3
+ export * from "./managers/index.js";
4
+ export * from "./service.js";
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/types/interfaces/services/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ export interface CancellationManagerInterface {
6
+ addCancellation(id: string): void;
7
+ removeCancellation(id: string): void;
8
+ isCancelled(id: string): boolean;
9
+ }
10
+ //# sourceMappingURL=cancellation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/managers/cancellation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,4BAA4B;IAC3C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ export interface ConnectionManagerInterface {
6
+ addConnection(id: string): void;
7
+ removeConnection(id: string): void;
8
+ isConnected(id: string): boolean;
9
+ }
10
+ //# sourceMappingURL=connection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/managers/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Copyright 2025 The Artinet Project
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ import { CoreCommand, CoreState, CoreContext, CoreUpdate } from "../context/index.js";
6
+ /**
7
+ * @description The context manager interface.
8
+ * @type {ContextManagerInterface<TCommand, TState>}
9
+ * @note This will become an increasingly important part of the system as Context Engineering becomes more important.
10
+ * currently it is used to store & retrieve contexts from storage but greater degrees of control may be needed.
11
+ * ex. forking/merging contexts, forwarding contexts to other services, nesting contexts, etc.
12
+ */
13
+ export interface ContextManagerInterface<TCommand extends CoreCommand = CoreCommand, TState extends CoreState = CoreState, TUpdate extends CoreUpdate = CoreUpdate> {
14
+ getContext: (id: string) => CoreContext<TCommand, TState, TUpdate> | undefined;
15
+ setContext: (id: string, context: CoreContext<TCommand, TState, TUpdate>) => void;
16
+ deleteContext: (id: string) => void;
17
+ }
18
+ //# sourceMappingURL=context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../../src/types/interfaces/services/core/managers/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,SAAS,SAAS,GAAG,SAAS,EACpC,OAAO,SAAS,UAAU,GAAG,UAAU;IAEvC,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,KACP,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAC5C,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC"}