@hashgraphonline/standards-agent-kit 0.0.37 → 0.2.0

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 (251) hide show
  1. package/dist/cjs/builders/hcs10/hcs10-builder.d.ts +262 -0
  2. package/dist/cjs/builders/index.d.ts +2 -0
  3. package/dist/cjs/builders/types.d.ts +10 -0
  4. package/dist/cjs/index.d.ts +3 -1
  5. package/dist/cjs/init/init.d.ts +21 -22
  6. package/dist/cjs/plugins/PluginInterface.d.ts +4 -80
  7. package/dist/cjs/plugins/PluginRegistry.d.ts +1 -47
  8. package/dist/cjs/plugins/defi/index.d.ts +7 -4
  9. package/dist/cjs/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  10. package/dist/cjs/plugins/index.d.ts +0 -5
  11. package/dist/cjs/plugins/weather/index.d.ts +6 -5
  12. package/dist/cjs/standards-agent-kit.cjs +1 -1
  13. package/dist/cjs/standards-agent-kit.cjs.map +1 -1
  14. package/dist/cjs/state/state-types.d.ts +8 -8
  15. package/dist/cjs/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  16. package/dist/cjs/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  17. package/dist/cjs/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  18. package/dist/cjs/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  19. package/dist/cjs/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  20. package/dist/cjs/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  21. package/dist/cjs/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  22. package/dist/cjs/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  23. package/dist/cjs/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  24. package/dist/cjs/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  25. package/dist/cjs/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  26. package/dist/cjs/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  27. package/dist/cjs/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  28. package/dist/cjs/tools/hcs10/index.d.ts +13 -0
  29. package/dist/cjs/tools/index.d.ts +1 -13
  30. package/dist/es/builders/hcs10/hcs10-builder.d.ts +262 -0
  31. package/dist/es/builders/index.d.ts +2 -0
  32. package/dist/es/builders/types.d.ts +10 -0
  33. package/dist/es/index.d.ts +3 -1
  34. package/dist/es/init/init.d.ts +21 -22
  35. package/dist/es/plugins/PluginInterface.d.ts +4 -80
  36. package/dist/es/plugins/PluginRegistry.d.ts +1 -47
  37. package/dist/es/plugins/defi/index.d.ts +7 -4
  38. package/dist/es/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  39. package/dist/es/plugins/index.d.ts +0 -5
  40. package/dist/es/plugins/weather/index.d.ts +6 -5
  41. package/dist/es/standards-agent-kit.es.js +10 -18
  42. package/dist/es/standards-agent-kit.es.js.map +1 -1
  43. package/dist/es/standards-agent-kit.es10.js +29 -76
  44. package/dist/es/standards-agent-kit.es10.js.map +1 -1
  45. package/dist/es/standards-agent-kit.es11.js +61 -384
  46. package/dist/es/standards-agent-kit.es11.js.map +1 -1
  47. package/dist/es/standards-agent-kit.es12.js +22 -190
  48. package/dist/es/standards-agent-kit.es12.js.map +1 -1
  49. package/dist/es/standards-agent-kit.es13.js +26 -138
  50. package/dist/es/standards-agent-kit.es13.js.map +1 -1
  51. package/dist/es/standards-agent-kit.es14.js +35 -59
  52. package/dist/es/standards-agent-kit.es14.js.map +1 -1
  53. package/dist/es/standards-agent-kit.es15.js +11 -117
  54. package/dist/es/standards-agent-kit.es15.js.map +1 -1
  55. package/dist/es/standards-agent-kit.es16.js +1 -1
  56. package/dist/es/standards-agent-kit.es16.js.map +1 -1
  57. package/dist/es/standards-agent-kit.es17.js +63 -46
  58. package/dist/es/standards-agent-kit.es17.js.map +1 -1
  59. package/dist/es/standards-agent-kit.es18.js +25 -74
  60. package/dist/es/standards-agent-kit.es18.js.map +1 -1
  61. package/dist/es/standards-agent-kit.es19.js +22 -13
  62. package/dist/es/standards-agent-kit.es19.js.map +1 -1
  63. package/dist/es/standards-agent-kit.es2.js +1381 -188
  64. package/dist/es/standards-agent-kit.es2.js.map +1 -1
  65. package/dist/es/standards-agent-kit.es20.js +3 -67
  66. package/dist/es/standards-agent-kit.es20.js.map +1 -1
  67. package/dist/es/standards-agent-kit.es3.js +285 -347
  68. package/dist/es/standards-agent-kit.es3.js.map +1 -1
  69. package/dist/es/standards-agent-kit.es4.js +22 -74
  70. package/dist/es/standards-agent-kit.es4.js.map +1 -1
  71. package/dist/es/standards-agent-kit.es5.js +127 -154
  72. package/dist/es/standards-agent-kit.es5.js.map +1 -1
  73. package/dist/es/standards-agent-kit.es6.js +21 -88
  74. package/dist/es/standards-agent-kit.es6.js.map +1 -1
  75. package/dist/es/standards-agent-kit.es7.js +28 -86
  76. package/dist/es/standards-agent-kit.es7.js.map +1 -1
  77. package/dist/es/standards-agent-kit.es8.js +27 -100
  78. package/dist/es/standards-agent-kit.es8.js.map +1 -1
  79. package/dist/es/standards-agent-kit.es9.js +35 -117
  80. package/dist/es/standards-agent-kit.es9.js.map +1 -1
  81. package/dist/es/state/state-types.d.ts +8 -8
  82. package/dist/es/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  83. package/dist/es/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  84. package/dist/es/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  85. package/dist/es/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  86. package/dist/es/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  87. package/dist/es/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  88. package/dist/es/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  89. package/dist/es/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  90. package/dist/es/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  91. package/dist/es/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  92. package/dist/es/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  93. package/dist/es/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  94. package/dist/es/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  95. package/dist/es/tools/hcs10/index.d.ts +13 -0
  96. package/dist/es/tools/index.d.ts +1 -13
  97. package/dist/umd/builders/hcs10/hcs10-builder.d.ts +262 -0
  98. package/dist/umd/builders/index.d.ts +2 -0
  99. package/dist/umd/builders/types.d.ts +10 -0
  100. package/dist/umd/index.d.ts +3 -1
  101. package/dist/umd/init/init.d.ts +21 -22
  102. package/dist/umd/plugins/PluginInterface.d.ts +4 -80
  103. package/dist/umd/plugins/PluginRegistry.d.ts +1 -47
  104. package/dist/umd/plugins/defi/index.d.ts +7 -4
  105. package/dist/umd/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  106. package/dist/umd/plugins/index.d.ts +0 -5
  107. package/dist/umd/plugins/weather/index.d.ts +6 -5
  108. package/dist/umd/standards-agent-kit.umd.js +1 -164
  109. package/dist/umd/standards-agent-kit.umd.js.map +1 -1
  110. package/dist/umd/state/state-types.d.ts +8 -8
  111. package/dist/umd/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  112. package/dist/umd/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  113. package/dist/umd/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  114. package/dist/umd/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  115. package/dist/umd/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  116. package/dist/umd/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  117. package/dist/umd/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  118. package/dist/umd/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  119. package/dist/umd/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  120. package/dist/umd/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  121. package/dist/umd/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  122. package/dist/umd/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  123. package/dist/umd/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  124. package/dist/umd/tools/hcs10/index.d.ts +13 -0
  125. package/dist/umd/tools/index.d.ts +1 -13
  126. package/package.json +41 -41
  127. package/src/builders/hcs10/hcs10-builder.ts +2108 -0
  128. package/src/builders/index.ts +2 -0
  129. package/src/builders/types.ts +11 -0
  130. package/src/hcs10/HCS10Client.ts +3 -2
  131. package/src/index.ts +4 -2
  132. package/src/init/init.ts +85 -63
  133. package/src/plugins/PluginInterface.ts +15 -94
  134. package/src/plugins/PluginRegistry.ts +2 -98
  135. package/src/plugins/defi/index.ts +31 -118
  136. package/src/plugins/hedera/HbarPricePlugin.ts +19 -100
  137. package/src/plugins/index.ts +0 -5
  138. package/src/plugins/weather/index.ts +56 -40
  139. package/src/state/state-types.ts +9 -11
  140. package/src/tools/hcs10/AcceptConnectionRequestTool.ts +56 -0
  141. package/src/tools/hcs10/CheckMessagesTool.ts +73 -0
  142. package/src/tools/hcs10/ConnectionMonitorTool.ts +111 -0
  143. package/src/tools/hcs10/FindRegistrationsTool.ts +64 -0
  144. package/src/tools/hcs10/InitiateConnectionTool.ts +66 -0
  145. package/src/tools/hcs10/ListConnectionsTool.ts +58 -0
  146. package/src/tools/hcs10/ListUnapprovedConnectionRequestsTool.ts +26 -0
  147. package/src/tools/hcs10/ManageConnectionRequestsTool.ts +48 -0
  148. package/src/tools/hcs10/RegisterAgentTool.ts +213 -0
  149. package/src/tools/hcs10/RetrieveProfileTool.ts +61 -0
  150. package/src/tools/hcs10/SendMessageToConnectionTool.ts +45 -0
  151. package/src/tools/hcs10/base-hcs10-tools.ts +65 -0
  152. package/src/tools/hcs10/hcs10-tool-params.ts +21 -0
  153. package/src/tools/hcs10/index.ts +13 -0
  154. package/src/tools/index.ts +2 -13
  155. package/src/utils/HederaClient.ts +2 -2
  156. package/src/utils/ensure-agent-has-hbar.ts +3 -4
  157. package/dist/cjs/agents/index.d.ts +0 -0
  158. package/dist/cjs/plugins/BasePlugin.d.ts +0 -28
  159. package/dist/cjs/plugins/GenericPlugin.d.ts +0 -17
  160. package/dist/cjs/plugins/HCS10Plugin.d.ts +0 -13
  161. package/dist/cjs/plugins/PluginLoader.d.ts +0 -38
  162. package/dist/cjs/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  163. package/dist/cjs/plugins/openconvai/index.d.ts +0 -1
  164. package/dist/cjs/tools/AcceptConnectionRequestTool.d.ts +0 -33
  165. package/dist/cjs/tools/CheckMessagesTool.d.ts +0 -34
  166. package/dist/cjs/tools/ConnectionMonitorTool.d.ts +0 -100
  167. package/dist/cjs/tools/ConnectionTool.d.ts +0 -40
  168. package/dist/cjs/tools/FindRegistrationsTool.d.ts +0 -28
  169. package/dist/cjs/tools/InitiateConnectionTool.d.ts +0 -30
  170. package/dist/cjs/tools/ListConnectionsTool.d.ts +0 -33
  171. package/dist/cjs/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  172. package/dist/cjs/tools/ManageConnectionRequestsTool.d.ts +0 -38
  173. package/dist/cjs/tools/RegisterAgentTool.d.ts +0 -188
  174. package/dist/cjs/tools/RetrieveProfileTool.d.ts +0 -34
  175. package/dist/cjs/tools/SendMessageToConnectionTool.d.ts +0 -34
  176. package/dist/cjs/tools/SendMessageTool.d.ts +0 -40
  177. package/dist/es/agents/index.d.ts +0 -0
  178. package/dist/es/plugins/BasePlugin.d.ts +0 -28
  179. package/dist/es/plugins/GenericPlugin.d.ts +0 -17
  180. package/dist/es/plugins/HCS10Plugin.d.ts +0 -13
  181. package/dist/es/plugins/PluginLoader.d.ts +0 -38
  182. package/dist/es/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  183. package/dist/es/plugins/openconvai/index.d.ts +0 -1
  184. package/dist/es/standards-agent-kit.es21.js +0 -92
  185. package/dist/es/standards-agent-kit.es21.js.map +0 -1
  186. package/dist/es/standards-agent-kit.es22.js +0 -7
  187. package/dist/es/standards-agent-kit.es22.js.map +0 -1
  188. package/dist/es/standards-agent-kit.es23.js +0 -106
  189. package/dist/es/standards-agent-kit.es23.js.map +0 -1
  190. package/dist/es/standards-agent-kit.es24.js +0 -7
  191. package/dist/es/standards-agent-kit.es24.js.map +0 -1
  192. package/dist/es/standards-agent-kit.es25.js +0 -7
  193. package/dist/es/standards-agent-kit.es25.js.map +0 -1
  194. package/dist/es/standards-agent-kit.es26.js +0 -85
  195. package/dist/es/standards-agent-kit.es26.js.map +0 -1
  196. package/dist/es/standards-agent-kit.es27.js +0 -28
  197. package/dist/es/standards-agent-kit.es27.js.map +0 -1
  198. package/dist/es/tools/AcceptConnectionRequestTool.d.ts +0 -33
  199. package/dist/es/tools/CheckMessagesTool.d.ts +0 -34
  200. package/dist/es/tools/ConnectionMonitorTool.d.ts +0 -100
  201. package/dist/es/tools/ConnectionTool.d.ts +0 -40
  202. package/dist/es/tools/FindRegistrationsTool.d.ts +0 -28
  203. package/dist/es/tools/InitiateConnectionTool.d.ts +0 -30
  204. package/dist/es/tools/ListConnectionsTool.d.ts +0 -33
  205. package/dist/es/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  206. package/dist/es/tools/ManageConnectionRequestsTool.d.ts +0 -38
  207. package/dist/es/tools/RegisterAgentTool.d.ts +0 -188
  208. package/dist/es/tools/RetrieveProfileTool.d.ts +0 -34
  209. package/dist/es/tools/SendMessageToConnectionTool.d.ts +0 -34
  210. package/dist/es/tools/SendMessageTool.d.ts +0 -40
  211. package/dist/umd/agents/index.d.ts +0 -0
  212. package/dist/umd/plugins/BasePlugin.d.ts +0 -28
  213. package/dist/umd/plugins/GenericPlugin.d.ts +0 -17
  214. package/dist/umd/plugins/HCS10Plugin.d.ts +0 -13
  215. package/dist/umd/plugins/PluginLoader.d.ts +0 -38
  216. package/dist/umd/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  217. package/dist/umd/plugins/openconvai/index.d.ts +0 -1
  218. package/dist/umd/tools/AcceptConnectionRequestTool.d.ts +0 -33
  219. package/dist/umd/tools/CheckMessagesTool.d.ts +0 -34
  220. package/dist/umd/tools/ConnectionMonitorTool.d.ts +0 -100
  221. package/dist/umd/tools/ConnectionTool.d.ts +0 -40
  222. package/dist/umd/tools/FindRegistrationsTool.d.ts +0 -28
  223. package/dist/umd/tools/InitiateConnectionTool.d.ts +0 -30
  224. package/dist/umd/tools/ListConnectionsTool.d.ts +0 -33
  225. package/dist/umd/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  226. package/dist/umd/tools/ManageConnectionRequestsTool.d.ts +0 -38
  227. package/dist/umd/tools/RegisterAgentTool.d.ts +0 -188
  228. package/dist/umd/tools/RetrieveProfileTool.d.ts +0 -34
  229. package/dist/umd/tools/SendMessageToConnectionTool.d.ts +0 -34
  230. package/dist/umd/tools/SendMessageTool.d.ts +0 -40
  231. package/src/agents/index.ts +0 -1
  232. package/src/plugins/BasePlugin.ts +0 -37
  233. package/src/plugins/GenericPlugin.ts +0 -19
  234. package/src/plugins/HCS10Plugin.ts +0 -14
  235. package/src/plugins/PluginLoader.ts +0 -121
  236. package/src/plugins/README.md +0 -113
  237. package/src/plugins/openconvai/OpenConvAIPlugin.ts +0 -124
  238. package/src/plugins/openconvai/index.ts +0 -1
  239. package/src/tools/AcceptConnectionRequestTool.ts +0 -196
  240. package/src/tools/CheckMessagesTool.ts +0 -194
  241. package/src/tools/ConnectionMonitorTool.ts +0 -550
  242. package/src/tools/ConnectionTool.ts +0 -231
  243. package/src/tools/FindRegistrationsTool.ts +0 -114
  244. package/src/tools/InitiateConnectionTool.ts +0 -137
  245. package/src/tools/ListConnectionsTool.ts +0 -158
  246. package/src/tools/ListUnapprovedConnectionRequestsTool.ts +0 -173
  247. package/src/tools/ManageConnectionRequestsTool.ts +0 -275
  248. package/src/tools/RegisterAgentTool.ts +0 -590
  249. package/src/tools/RetrieveProfileTool.ts +0 -94
  250. package/src/tools/SendMessageToConnectionTool.ts +0 -142
  251. package/src/tools/SendMessageTool.ts +0 -116
@@ -0,0 +1,218 @@
1
+ import { AIAgentCapability } from '@hashgraphonline/standards-sdk';
2
+ import { z } from 'zod';
3
+ import { BaseServiceBuilder } from 'hedera-agent-kit';
4
+ import { BaseHCS10TransactionTool } from './base-hcs10-tools';
5
+ import { HCS10TransactionToolParams } from './hcs10-tool-params';
6
+ declare const RegisterAgentZodSchema: z.ZodObject<{
7
+ name: z.ZodString;
8
+ description: z.ZodOptional<z.ZodString>;
9
+ alias: z.ZodOptional<z.ZodString>;
10
+ type: z.ZodOptional<z.ZodEnum<["autonomous", "manual"]>>;
11
+ model: z.ZodOptional<z.ZodString>;
12
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">>;
13
+ creator: z.ZodOptional<z.ZodString>;
14
+ socials: z.ZodOptional<z.ZodRecord<z.ZodEnum<["twitter", "github", "discord", "telegram", "linkedin", "youtube", "website", "x"]>, z.ZodString>>;
15
+ properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
16
+ profilePicture: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
17
+ url: z.ZodOptional<z.ZodString>;
18
+ path: z.ZodOptional<z.ZodString>;
19
+ filename: z.ZodOptional<z.ZodString>;
20
+ }, "strip", z.ZodTypeAny, {
21
+ filename?: string | undefined;
22
+ url?: string | undefined;
23
+ path?: string | undefined;
24
+ }, {
25
+ filename?: string | undefined;
26
+ url?: string | undefined;
27
+ path?: string | undefined;
28
+ }>]>>;
29
+ existingProfilePictureTopicId: z.ZodOptional<z.ZodString>;
30
+ initialBalance: z.ZodOptional<z.ZodNumber>;
31
+ userAccountId: z.ZodOptional<z.ZodString>;
32
+ hbarFee: z.ZodOptional<z.ZodNumber>;
33
+ tokenFees: z.ZodOptional<z.ZodArray<z.ZodObject<{
34
+ amount: z.ZodNumber;
35
+ tokenId: z.ZodString;
36
+ }, "strip", z.ZodTypeAny, {
37
+ amount: number;
38
+ tokenId: string;
39
+ }, {
40
+ amount: number;
41
+ tokenId: string;
42
+ }>, "many">>;
43
+ exemptAccountIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
44
+ setAsCurrent: z.ZodOptional<z.ZodBoolean>;
45
+ persistence: z.ZodOptional<z.ZodObject<{
46
+ prefix: z.ZodOptional<z.ZodString>;
47
+ }, "strip", z.ZodTypeAny, {
48
+ prefix?: string | undefined;
49
+ }, {
50
+ prefix?: string | undefined;
51
+ }>>;
52
+ }, "strip", z.ZodTypeAny, {
53
+ name: string;
54
+ tokenFees?: {
55
+ amount: number;
56
+ tokenId: string;
57
+ }[] | undefined;
58
+ exemptAccountIds?: string[] | undefined;
59
+ type?: "autonomous" | "manual" | undefined;
60
+ description?: string | undefined;
61
+ alias?: string | undefined;
62
+ model?: string | undefined;
63
+ capabilities?: AIAgentCapability[] | undefined;
64
+ creator?: string | undefined;
65
+ socials?: Partial<Record<"twitter" | "github" | "discord" | "telegram" | "linkedin" | "youtube" | "website" | "x", string>> | undefined;
66
+ properties?: Record<string, unknown> | undefined;
67
+ profilePicture?: string | {
68
+ filename?: string | undefined;
69
+ url?: string | undefined;
70
+ path?: string | undefined;
71
+ } | undefined;
72
+ existingProfilePictureTopicId?: string | undefined;
73
+ initialBalance?: number | undefined;
74
+ userAccountId?: string | undefined;
75
+ hbarFee?: number | undefined;
76
+ setAsCurrent?: boolean | undefined;
77
+ persistence?: {
78
+ prefix?: string | undefined;
79
+ } | undefined;
80
+ }, {
81
+ name: string;
82
+ tokenFees?: {
83
+ amount: number;
84
+ tokenId: string;
85
+ }[] | undefined;
86
+ exemptAccountIds?: string[] | undefined;
87
+ type?: "autonomous" | "manual" | undefined;
88
+ description?: string | undefined;
89
+ alias?: string | undefined;
90
+ model?: string | undefined;
91
+ capabilities?: AIAgentCapability[] | undefined;
92
+ creator?: string | undefined;
93
+ socials?: Partial<Record<"twitter" | "github" | "discord" | "telegram" | "linkedin" | "youtube" | "website" | "x", string>> | undefined;
94
+ properties?: Record<string, unknown> | undefined;
95
+ profilePicture?: string | {
96
+ filename?: string | undefined;
97
+ url?: string | undefined;
98
+ path?: string | undefined;
99
+ } | undefined;
100
+ existingProfilePictureTopicId?: string | undefined;
101
+ initialBalance?: number | undefined;
102
+ userAccountId?: string | undefined;
103
+ hbarFee?: number | undefined;
104
+ setAsCurrent?: boolean | undefined;
105
+ persistence?: {
106
+ prefix?: string | undefined;
107
+ } | undefined;
108
+ }>;
109
+ export declare class RegisterAgentTool extends BaseHCS10TransactionTool<typeof RegisterAgentZodSchema> {
110
+ name: string;
111
+ description: string;
112
+ specificInputSchema: z.ZodObject<{
113
+ name: z.ZodString;
114
+ description: z.ZodOptional<z.ZodString>;
115
+ alias: z.ZodOptional<z.ZodString>;
116
+ type: z.ZodOptional<z.ZodEnum<["autonomous", "manual"]>>;
117
+ model: z.ZodOptional<z.ZodString>;
118
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof AIAgentCapability>, "many">>;
119
+ creator: z.ZodOptional<z.ZodString>;
120
+ socials: z.ZodOptional<z.ZodRecord<z.ZodEnum<["twitter", "github", "discord", "telegram", "linkedin", "youtube", "website", "x"]>, z.ZodString>>;
121
+ properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
122
+ profilePicture: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
123
+ url: z.ZodOptional<z.ZodString>;
124
+ path: z.ZodOptional<z.ZodString>;
125
+ filename: z.ZodOptional<z.ZodString>;
126
+ }, "strip", z.ZodTypeAny, {
127
+ filename?: string | undefined;
128
+ url?: string | undefined;
129
+ path?: string | undefined;
130
+ }, {
131
+ filename?: string | undefined;
132
+ url?: string | undefined;
133
+ path?: string | undefined;
134
+ }>]>>;
135
+ existingProfilePictureTopicId: z.ZodOptional<z.ZodString>;
136
+ initialBalance: z.ZodOptional<z.ZodNumber>;
137
+ userAccountId: z.ZodOptional<z.ZodString>;
138
+ hbarFee: z.ZodOptional<z.ZodNumber>;
139
+ tokenFees: z.ZodOptional<z.ZodArray<z.ZodObject<{
140
+ amount: z.ZodNumber;
141
+ tokenId: z.ZodString;
142
+ }, "strip", z.ZodTypeAny, {
143
+ amount: number;
144
+ tokenId: string;
145
+ }, {
146
+ amount: number;
147
+ tokenId: string;
148
+ }>, "many">>;
149
+ exemptAccountIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
150
+ setAsCurrent: z.ZodOptional<z.ZodBoolean>;
151
+ persistence: z.ZodOptional<z.ZodObject<{
152
+ prefix: z.ZodOptional<z.ZodString>;
153
+ }, "strip", z.ZodTypeAny, {
154
+ prefix?: string | undefined;
155
+ }, {
156
+ prefix?: string | undefined;
157
+ }>>;
158
+ }, "strip", z.ZodTypeAny, {
159
+ name: string;
160
+ tokenFees?: {
161
+ amount: number;
162
+ tokenId: string;
163
+ }[] | undefined;
164
+ exemptAccountIds?: string[] | undefined;
165
+ type?: "autonomous" | "manual" | undefined;
166
+ description?: string | undefined;
167
+ alias?: string | undefined;
168
+ model?: string | undefined;
169
+ capabilities?: AIAgentCapability[] | undefined;
170
+ creator?: string | undefined;
171
+ socials?: Partial<Record<"twitter" | "github" | "discord" | "telegram" | "linkedin" | "youtube" | "website" | "x", string>> | undefined;
172
+ properties?: Record<string, unknown> | undefined;
173
+ profilePicture?: string | {
174
+ filename?: string | undefined;
175
+ url?: string | undefined;
176
+ path?: string | undefined;
177
+ } | undefined;
178
+ existingProfilePictureTopicId?: string | undefined;
179
+ initialBalance?: number | undefined;
180
+ userAccountId?: string | undefined;
181
+ hbarFee?: number | undefined;
182
+ setAsCurrent?: boolean | undefined;
183
+ persistence?: {
184
+ prefix?: string | undefined;
185
+ } | undefined;
186
+ }, {
187
+ name: string;
188
+ tokenFees?: {
189
+ amount: number;
190
+ tokenId: string;
191
+ }[] | undefined;
192
+ exemptAccountIds?: string[] | undefined;
193
+ type?: "autonomous" | "manual" | undefined;
194
+ description?: string | undefined;
195
+ alias?: string | undefined;
196
+ model?: string | undefined;
197
+ capabilities?: AIAgentCapability[] | undefined;
198
+ creator?: string | undefined;
199
+ socials?: Partial<Record<"twitter" | "github" | "discord" | "telegram" | "linkedin" | "youtube" | "website" | "x", string>> | undefined;
200
+ properties?: Record<string, unknown> | undefined;
201
+ profilePicture?: string | {
202
+ filename?: string | undefined;
203
+ url?: string | undefined;
204
+ path?: string | undefined;
205
+ } | undefined;
206
+ existingProfilePictureTopicId?: string | undefined;
207
+ initialBalance?: number | undefined;
208
+ userAccountId?: string | undefined;
209
+ hbarFee?: number | undefined;
210
+ setAsCurrent?: boolean | undefined;
211
+ persistence?: {
212
+ prefix?: string | undefined;
213
+ } | undefined;
214
+ }>;
215
+ constructor(params: HCS10TransactionToolParams);
216
+ protected callBuilderMethod(builder: BaseServiceBuilder, specificArgs: z.infer<typeof RegisterAgentZodSchema>): Promise<void>;
217
+ }
218
+ export {};
@@ -0,0 +1,33 @@
1
+ import { z } from 'zod';
2
+ import { BaseHCS10QueryTool } from './base-hcs10-tools';
3
+ import { HCS10QueryToolParams } from './hcs10-tool-params';
4
+ declare const RetrieveProfileZodSchema: z.ZodObject<{
5
+ accountId: z.ZodString;
6
+ disableCache: z.ZodOptional<z.ZodBoolean>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ accountId: string;
9
+ disableCache?: boolean | undefined;
10
+ }, {
11
+ accountId: string;
12
+ disableCache?: boolean | undefined;
13
+ }>;
14
+ /**
15
+ * Tool to retrieve detailed profile information for a specific HCS-10 agent
16
+ */
17
+ export declare class RetrieveProfileTool extends BaseHCS10QueryTool<typeof RetrieveProfileZodSchema> {
18
+ name: string;
19
+ description: string;
20
+ specificInputSchema: z.ZodObject<{
21
+ accountId: z.ZodString;
22
+ disableCache: z.ZodOptional<z.ZodBoolean>;
23
+ }, "strip", z.ZodTypeAny, {
24
+ accountId: string;
25
+ disableCache?: boolean | undefined;
26
+ }, {
27
+ accountId: string;
28
+ disableCache?: boolean | undefined;
29
+ }>;
30
+ constructor(params: HCS10QueryToolParams);
31
+ protected executeQuery({ accountId, disableCache, }: z.infer<typeof RetrieveProfileZodSchema>): Promise<unknown>;
32
+ }
33
+ export {};
@@ -0,0 +1,40 @@
1
+ import { z } from 'zod';
2
+ import { BaseHCS10TransactionTool } from './base-hcs10-tools';
3
+ import { HCS10TransactionToolParams } from './hcs10-tool-params';
4
+ import { BaseServiceBuilder } from 'hedera-agent-kit';
5
+ declare const SendMessageToConnectionZodSchema: z.ZodObject<{
6
+ targetIdentifier: z.ZodString;
7
+ message: z.ZodString;
8
+ disableMonitoring: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
9
+ }, "strip", z.ZodTypeAny, {
10
+ message: string;
11
+ targetIdentifier: string;
12
+ disableMonitoring: boolean;
13
+ }, {
14
+ message: string;
15
+ targetIdentifier: string;
16
+ disableMonitoring?: boolean | undefined;
17
+ }>;
18
+ /**
19
+ * A tool to send a message to an agent over an established HCS-10 connection.
20
+ */
21
+ export declare class SendMessageToConnectionTool extends BaseHCS10TransactionTool<typeof SendMessageToConnectionZodSchema> {
22
+ name: string;
23
+ description: string;
24
+ specificInputSchema: z.ZodObject<{
25
+ targetIdentifier: z.ZodString;
26
+ message: z.ZodString;
27
+ disableMonitoring: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
28
+ }, "strip", z.ZodTypeAny, {
29
+ message: string;
30
+ targetIdentifier: string;
31
+ disableMonitoring: boolean;
32
+ }, {
33
+ message: string;
34
+ targetIdentifier: string;
35
+ disableMonitoring?: boolean | undefined;
36
+ }>;
37
+ constructor(params: HCS10TransactionToolParams);
38
+ protected callBuilderMethod(builder: BaseServiceBuilder, specificArgs: z.infer<typeof SendMessageToConnectionZodSchema>): Promise<void>;
39
+ }
40
+ export {};
@@ -0,0 +1,28 @@
1
+ import { BaseHederaTransactionTool, BaseHederaQueryTool, BaseServiceBuilder } from 'hedera-agent-kit';
2
+ import { HCS10Builder } from '../../builders/hcs10/hcs10-builder';
3
+ import { HCS10TransactionToolParams, HCS10QueryToolParams } from './hcs10-tool-params';
4
+ import { z } from 'zod';
5
+ /**
6
+ * Base class for HCS10 transaction tools
7
+ */
8
+ export declare abstract class BaseHCS10TransactionTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny> = z.ZodObject<z.ZodRawShape>> extends BaseHederaTransactionTool<T> {
9
+ protected hcs10Builder: HCS10Builder;
10
+ namespace: "hcs10";
11
+ constructor(params: HCS10TransactionToolParams);
12
+ /**
13
+ * Override to return the HCS10Builder
14
+ */
15
+ protected getServiceBuilder(): BaseServiceBuilder;
16
+ }
17
+ /**
18
+ * Base class for HCS10 query tools
19
+ */
20
+ export declare abstract class BaseHCS10QueryTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, Record<string, unknown>, Record<string, unknown>> = z.ZodObject<z.ZodRawShape>> extends BaseHederaQueryTool<T> {
21
+ protected hcs10Builder: HCS10Builder;
22
+ namespace: "hcs10";
23
+ constructor(params: HCS10QueryToolParams);
24
+ /**
25
+ * Override to return the HCS10Builder
26
+ */
27
+ protected getServiceBuilder(): BaseServiceBuilder;
28
+ }
@@ -0,0 +1,18 @@
1
+ import { HederaAgentKit, BasePluginContext } from 'hedera-agent-kit';
2
+ import { HCS10Builder } from '../../builders/hcs10/hcs10-builder';
3
+ /**
4
+ * Parameters for HCS10 transaction tools
5
+ */
6
+ export interface HCS10TransactionToolParams {
7
+ hederaKit: HederaAgentKit;
8
+ hcs10Builder: HCS10Builder;
9
+ logger?: BasePluginContext['logger'];
10
+ }
11
+ /**
12
+ * Parameters for HCS10 query tools
13
+ */
14
+ export interface HCS10QueryToolParams {
15
+ hederaKit: HederaAgentKit;
16
+ hcs10Builder: HCS10Builder;
17
+ logger?: BasePluginContext['logger'];
18
+ }
@@ -0,0 +1,13 @@
1
+ export * from './base-hcs10-tools';
2
+ export * from './hcs10-tool-params';
3
+ export * from './RegisterAgentTool';
4
+ export * from './SendMessageToConnectionTool';
5
+ export * from './InitiateConnectionTool';
6
+ export * from './ListConnectionsTool';
7
+ export * from './CheckMessagesTool';
8
+ export * from './FindRegistrationsTool';
9
+ export * from './ConnectionMonitorTool';
10
+ export * from './ManageConnectionRequestsTool';
11
+ export * from './AcceptConnectionRequestTool';
12
+ export * from './RetrieveProfileTool';
13
+ export * from './ListUnapprovedConnectionRequestsTool';
@@ -1,13 +1 @@
1
- export * from './RegisterAgentTool';
2
- export * from './SendMessageTool';
3
- export * from './ConnectionTool';
4
- export * from './SendMessageToConnectionTool';
5
- export * from './InitiateConnectionTool';
6
- export * from './ListConnectionsTool';
7
- export * from './CheckMessagesTool';
8
- export * from './FindRegistrationsTool';
9
- export * from './ConnectionMonitorTool';
10
- export * from './ManageConnectionRequestsTool';
11
- export * from './AcceptConnectionRequestTool';
12
- export * from './RetrieveProfileTool';
13
- export * from './ListUnapprovedConnectionRequestsTool';
1
+ export * from './hcs10';
@@ -0,0 +1,262 @@
1
+ import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
2
+ import { PrivateKey, TransactionReceipt } from '@hashgraph/sdk';
3
+ import { IStateManager } from '../../state/state-types';
4
+ import { ExecuteResult } from '../types';
5
+ import { FeeConfigBuilderInterface, HCS10Client, ProfileResponse as SDKProfileResponse, HCSMessage, LogLevel, HandleConnectionRequestResponse } from '@hashgraphonline/standards-sdk';
6
+ /**
7
+ * Message response with timestamp
8
+ */
9
+ export interface HCSMessageWithTimestamp extends Omit<HCSMessage, 'op'> {
10
+ timestamp: number;
11
+ data?: string;
12
+ sequence_number: number;
13
+ op?: HCSMessage['op'] | string;
14
+ operator_id?: string;
15
+ created?: Date;
16
+ m?: string;
17
+ }
18
+ /**
19
+ * Network type for HCS-10
20
+ */
21
+ export type StandardNetworkType = 'mainnet' | 'testnet';
22
+ /**
23
+ * Parameters for agent registration
24
+ */
25
+ export interface RegisterAgentParams {
26
+ name: string;
27
+ bio?: string;
28
+ alias?: string;
29
+ type?: 'autonomous' | 'manual';
30
+ model?: string;
31
+ capabilities?: number[];
32
+ creator?: string;
33
+ socials?: Record<string, string>;
34
+ properties?: Record<string, unknown>;
35
+ profilePicture?: string | {
36
+ url?: string;
37
+ path?: string;
38
+ filename?: string;
39
+ };
40
+ existingProfilePictureTopicId?: string;
41
+ initialBalance?: number;
42
+ userAccountId?: string;
43
+ hbarFee?: number;
44
+ tokenFees?: Array<{
45
+ amount: number;
46
+ tokenId: string;
47
+ }>;
48
+ exemptAccountIds?: string[];
49
+ }
50
+ /**
51
+ * Parameters for initiating a connection
52
+ */
53
+ export interface InitiateConnectionParams {
54
+ targetAccountId: string;
55
+ disableMonitor?: boolean;
56
+ memo?: string;
57
+ }
58
+ /**
59
+ * Parameters for accepting a connection request
60
+ */
61
+ export interface AcceptConnectionParams {
62
+ requestKey: string;
63
+ hbarFee?: number | undefined;
64
+ exemptAccountIds?: string[] | undefined;
65
+ }
66
+ /**
67
+ * Parameters for sending a message
68
+ */
69
+ export interface SendMessageParams {
70
+ topicId: string;
71
+ message: string;
72
+ disableMonitoring?: boolean;
73
+ }
74
+ /**
75
+ * Parameters for sending a message to a connected account
76
+ */
77
+ export interface SendMessageToConnectionParams {
78
+ targetIdentifier: string;
79
+ message: string;
80
+ disableMonitoring?: boolean;
81
+ }
82
+ /**
83
+ * HCS10Builder facilitates HCS-10 protocol operations for agent communication
84
+ * This builder incorporates all HCS10Client functionality directly
85
+ */
86
+ export declare class HCS10Builder extends BaseServiceBuilder {
87
+ private standardClient;
88
+ private stateManager;
89
+ private executeResult?;
90
+ private useEncryption;
91
+ private guardedRegistryBaseUrl;
92
+ private network;
93
+ private sdkLogger;
94
+ constructor(hederaKit: HederaAgentKit, stateManager?: IStateManager, options?: {
95
+ useEncryption?: boolean;
96
+ registryUrl?: string;
97
+ logLevel?: LogLevel;
98
+ });
99
+ /**
100
+ * Get the operator account ID
101
+ */
102
+ getOperatorId(): string;
103
+ /**
104
+ * Get the network type
105
+ */
106
+ getNetwork(): StandardNetworkType;
107
+ /**
108
+ * Get account and signer information
109
+ */
110
+ getAccountAndSigner(): {
111
+ accountId: string;
112
+ signer: PrivateKey;
113
+ };
114
+ /**
115
+ * Get the inbound topic ID for the current operator
116
+ */
117
+ getInboundTopicId(): Promise<string>;
118
+ /**
119
+ * Get agent profile
120
+ */
121
+ getAgentProfile(accountId: string): Promise<SDKProfileResponse>;
122
+ /**
123
+ * Submit connection request
124
+ */
125
+ submitConnectionRequest(inboundTopicId: string, memo: string): Promise<TransactionReceipt>;
126
+ /**
127
+ * Handle connection request
128
+ */
129
+ handleConnectionRequest(inboundTopicId: string, requestingAccountId: string, connectionRequestId: number, feeConfig?: FeeConfigBuilderInterface): Promise<HandleConnectionRequestResponse>;
130
+ /**
131
+ * Send message to a topic
132
+ */
133
+ sendMessage(topicId: string, data: string, memo?: string): Promise<{
134
+ sequenceNumber: number | undefined;
135
+ receipt: TransactionReceipt;
136
+ transactionId: string | undefined;
137
+ }>;
138
+ /**
139
+ * Get messages from a topic
140
+ */
141
+ getMessages(topicId: string): Promise<{
142
+ messages: HCSMessageWithTimestamp[];
143
+ }>;
144
+ /**
145
+ * Get message stream from a topic
146
+ */
147
+ getMessageStream(topicId: string): Promise<{
148
+ messages: HCSMessage[];
149
+ }>;
150
+ /**
151
+ * Get message content
152
+ */
153
+ getMessageContent(inscriptionIdOrData: string): Promise<string>;
154
+ /**
155
+ * Get the standard client instance (for compatibility)
156
+ */
157
+ getStandardClient(): HCS10Client;
158
+ /**
159
+ * Load profile picture from URL or file path
160
+ */
161
+ private loadProfilePicture;
162
+ /**
163
+ * Create and register an agent
164
+ */
165
+ private createAndRegisterAgent;
166
+ /**
167
+ * Register a new HCS-10 agent
168
+ * Note: This performs multiple transactions and requires directExecution mode
169
+ */
170
+ registerAgent(params: RegisterAgentParams): Promise<this>;
171
+ /**
172
+ * Initiate a connection to another agent
173
+ */
174
+ initiateConnection(params: InitiateConnectionParams): Promise<this>;
175
+ /**
176
+ * Accept a connection request
177
+ * Note: This performs multiple transactions and requires directExecution mode
178
+ */
179
+ acceptConnection(params: AcceptConnectionParams): Promise<this>;
180
+ /**
181
+ * Send a message using HCS (for operations that need direct topic access)
182
+ */
183
+ sendHCS10Message(params: SendMessageParams): Promise<this>;
184
+ /**
185
+ * Send a message to a connected account with optional response monitoring
186
+ */
187
+ sendMessageToConnection(params: SendMessageToConnectionParams): Promise<this>;
188
+ /**
189
+ * Monitor responses on a topic after sending a message
190
+ */
191
+ private monitorResponses;
192
+ /**
193
+ * Start passive monitoring for incoming connection requests
194
+ * This method monitors continuously in the background
195
+ */
196
+ startPassiveConnectionMonitoring(): Promise<this>;
197
+ /**
198
+ * Monitor for incoming connection requests
199
+ */
200
+ monitorConnections(params: {
201
+ acceptAll?: boolean;
202
+ targetAccountId?: string;
203
+ monitorDurationSeconds?: number;
204
+ hbarFees?: Array<{
205
+ amount: number;
206
+ collectorAccount?: string;
207
+ }>;
208
+ tokenFees?: Array<{
209
+ amount: number;
210
+ tokenId: string;
211
+ collectorAccount?: string;
212
+ }>;
213
+ exemptAccountIds?: string[];
214
+ defaultCollectorAccount?: string;
215
+ }): Promise<this>;
216
+ /**
217
+ * Manage connection requests (list, view, or reject)
218
+ */
219
+ manageConnectionRequests(params: {
220
+ action: 'list' | 'view' | 'reject';
221
+ requestKey?: string;
222
+ }): Promise<this>;
223
+ /**
224
+ * List unapproved connection requests
225
+ */
226
+ listUnapprovedConnectionRequests(): Promise<this>;
227
+ /**
228
+ * List connections with enhanced details
229
+ */
230
+ listConnections(params?: {
231
+ includeDetails?: boolean;
232
+ showPending?: boolean;
233
+ }): Promise<this>;
234
+ private formatConnection;
235
+ private getEnhancedConnections;
236
+ /**
237
+ * Check messages on a connection
238
+ */
239
+ checkMessages(params: {
240
+ targetIdentifier: string;
241
+ fetchLatest?: boolean;
242
+ lastMessagesCount?: number;
243
+ }): Promise<this>;
244
+ /**
245
+ * Find registrations using the configured registry
246
+ */
247
+ findRegistrations(params: {
248
+ accountId?: string;
249
+ tags?: number[];
250
+ }): Promise<this>;
251
+ /**
252
+ * Retrieve detailed profile information for an agent
253
+ */
254
+ retrieveProfile(params: {
255
+ accountId: string;
256
+ disableCache?: boolean;
257
+ }): Promise<this>;
258
+ /**
259
+ * Override execute to return stored HCS10 operation results
260
+ */
261
+ execute(): Promise<ExecuteResult>;
262
+ }
@@ -0,0 +1,2 @@
1
+ export * from './types';
2
+ export * from './hcs10/hcs10-builder';
@@ -0,0 +1,10 @@
1
+ import { TransactionReceipt } from '@hashgraph/sdk';
2
+ export interface ExecuteResult {
3
+ success: boolean;
4
+ receipt?: TransactionReceipt;
5
+ scheduleId?: string;
6
+ error?: string;
7
+ transactionId?: string | undefined;
8
+ rawResult?: unknown;
9
+ notes?: string[];
10
+ }
@@ -1,5 +1,7 @@
1
- export * from './hcs10';
2
1
  export * from './tools';
3
2
  export * from './state';
4
3
  export * from './init';
5
4
  export * from './plugins';
5
+ export { HCS10Builder } from './builders';
6
+ export type { ExecuteResult } from './builders';
7
+ export { HCS10Client } from './hcs10';