@hashgraphonline/standards-agent-kit 0.0.38 → 0.2.1

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 (252) hide show
  1. package/README.md +137 -170
  2. package/dist/cjs/builders/hcs10/hcs10-builder.d.ts +262 -0
  3. package/dist/cjs/builders/index.d.ts +2 -0
  4. package/dist/cjs/builders/types.d.ts +10 -0
  5. package/dist/cjs/index.d.ts +3 -1
  6. package/dist/cjs/init/init.d.ts +21 -22
  7. package/dist/cjs/plugins/PluginInterface.d.ts +4 -80
  8. package/dist/cjs/plugins/PluginRegistry.d.ts +1 -47
  9. package/dist/cjs/plugins/defi/index.d.ts +7 -4
  10. package/dist/cjs/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  11. package/dist/cjs/plugins/index.d.ts +0 -5
  12. package/dist/cjs/plugins/weather/index.d.ts +6 -5
  13. package/dist/cjs/standards-agent-kit.cjs +1 -1
  14. package/dist/cjs/standards-agent-kit.cjs.map +1 -1
  15. package/dist/cjs/state/state-types.d.ts +8 -8
  16. package/dist/cjs/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  17. package/dist/cjs/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  18. package/dist/cjs/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  19. package/dist/cjs/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  20. package/dist/cjs/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  21. package/dist/cjs/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  22. package/dist/cjs/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  23. package/dist/cjs/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  24. package/dist/cjs/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  25. package/dist/cjs/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  26. package/dist/cjs/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  27. package/dist/cjs/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  28. package/dist/cjs/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  29. package/dist/cjs/tools/hcs10/index.d.ts +13 -0
  30. package/dist/cjs/tools/index.d.ts +1 -13
  31. package/dist/es/builders/hcs10/hcs10-builder.d.ts +262 -0
  32. package/dist/es/builders/index.d.ts +2 -0
  33. package/dist/es/builders/types.d.ts +10 -0
  34. package/dist/es/index.d.ts +3 -1
  35. package/dist/es/init/init.d.ts +21 -22
  36. package/dist/es/plugins/PluginInterface.d.ts +4 -80
  37. package/dist/es/plugins/PluginRegistry.d.ts +1 -47
  38. package/dist/es/plugins/defi/index.d.ts +7 -4
  39. package/dist/es/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  40. package/dist/es/plugins/index.d.ts +0 -5
  41. package/dist/es/plugins/weather/index.d.ts +6 -5
  42. package/dist/es/standards-agent-kit.es.js +10 -18
  43. package/dist/es/standards-agent-kit.es.js.map +1 -1
  44. package/dist/es/standards-agent-kit.es10.js +29 -76
  45. package/dist/es/standards-agent-kit.es10.js.map +1 -1
  46. package/dist/es/standards-agent-kit.es11.js +61 -384
  47. package/dist/es/standards-agent-kit.es11.js.map +1 -1
  48. package/dist/es/standards-agent-kit.es12.js +22 -190
  49. package/dist/es/standards-agent-kit.es12.js.map +1 -1
  50. package/dist/es/standards-agent-kit.es13.js +26 -138
  51. package/dist/es/standards-agent-kit.es13.js.map +1 -1
  52. package/dist/es/standards-agent-kit.es14.js +35 -59
  53. package/dist/es/standards-agent-kit.es14.js.map +1 -1
  54. package/dist/es/standards-agent-kit.es15.js +11 -117
  55. package/dist/es/standards-agent-kit.es15.js.map +1 -1
  56. package/dist/es/standards-agent-kit.es16.js +1 -1
  57. package/dist/es/standards-agent-kit.es16.js.map +1 -1
  58. package/dist/es/standards-agent-kit.es17.js +63 -46
  59. package/dist/es/standards-agent-kit.es17.js.map +1 -1
  60. package/dist/es/standards-agent-kit.es18.js +25 -74
  61. package/dist/es/standards-agent-kit.es18.js.map +1 -1
  62. package/dist/es/standards-agent-kit.es19.js +22 -13
  63. package/dist/es/standards-agent-kit.es19.js.map +1 -1
  64. package/dist/es/standards-agent-kit.es2.js +1381 -188
  65. package/dist/es/standards-agent-kit.es2.js.map +1 -1
  66. package/dist/es/standards-agent-kit.es20.js +3 -67
  67. package/dist/es/standards-agent-kit.es20.js.map +1 -1
  68. package/dist/es/standards-agent-kit.es3.js +285 -347
  69. package/dist/es/standards-agent-kit.es3.js.map +1 -1
  70. package/dist/es/standards-agent-kit.es4.js +22 -74
  71. package/dist/es/standards-agent-kit.es4.js.map +1 -1
  72. package/dist/es/standards-agent-kit.es5.js +127 -154
  73. package/dist/es/standards-agent-kit.es5.js.map +1 -1
  74. package/dist/es/standards-agent-kit.es6.js +21 -88
  75. package/dist/es/standards-agent-kit.es6.js.map +1 -1
  76. package/dist/es/standards-agent-kit.es7.js +28 -86
  77. package/dist/es/standards-agent-kit.es7.js.map +1 -1
  78. package/dist/es/standards-agent-kit.es8.js +27 -100
  79. package/dist/es/standards-agent-kit.es8.js.map +1 -1
  80. package/dist/es/standards-agent-kit.es9.js +35 -117
  81. package/dist/es/standards-agent-kit.es9.js.map +1 -1
  82. package/dist/es/state/state-types.d.ts +8 -8
  83. package/dist/es/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  84. package/dist/es/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  85. package/dist/es/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  86. package/dist/es/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  87. package/dist/es/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  88. package/dist/es/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  89. package/dist/es/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  90. package/dist/es/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  91. package/dist/es/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  92. package/dist/es/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  93. package/dist/es/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  94. package/dist/es/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  95. package/dist/es/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  96. package/dist/es/tools/hcs10/index.d.ts +13 -0
  97. package/dist/es/tools/index.d.ts +1 -13
  98. package/dist/umd/builders/hcs10/hcs10-builder.d.ts +262 -0
  99. package/dist/umd/builders/index.d.ts +2 -0
  100. package/dist/umd/builders/types.d.ts +10 -0
  101. package/dist/umd/index.d.ts +3 -1
  102. package/dist/umd/init/init.d.ts +21 -22
  103. package/dist/umd/plugins/PluginInterface.d.ts +4 -80
  104. package/dist/umd/plugins/PluginRegistry.d.ts +1 -47
  105. package/dist/umd/plugins/defi/index.d.ts +7 -4
  106. package/dist/umd/plugins/hedera/HbarPricePlugin.d.ts +7 -35
  107. package/dist/umd/plugins/index.d.ts +0 -5
  108. package/dist/umd/plugins/weather/index.d.ts +6 -5
  109. package/dist/umd/standards-agent-kit.umd.js +1 -194
  110. package/dist/umd/standards-agent-kit.umd.js.map +1 -1
  111. package/dist/umd/state/state-types.d.ts +8 -8
  112. package/dist/umd/tools/hcs10/AcceptConnectionRequestTool.d.ts +40 -0
  113. package/dist/umd/tools/hcs10/CheckMessagesTool.d.ts +40 -0
  114. package/dist/umd/tools/hcs10/ConnectionMonitorTool.d.ts +134 -0
  115. package/dist/umd/tools/hcs10/FindRegistrationsTool.d.ts +34 -0
  116. package/dist/umd/tools/hcs10/InitiateConnectionTool.d.ts +43 -0
  117. package/dist/umd/tools/hcs10/ListConnectionsTool.d.ts +34 -0
  118. package/dist/umd/tools/hcs10/ListUnapprovedConnectionRequestsTool.d.ts +15 -0
  119. package/dist/umd/tools/hcs10/ManageConnectionRequestsTool.d.ts +34 -0
  120. package/dist/umd/tools/hcs10/RegisterAgentTool.d.ts +218 -0
  121. package/dist/umd/tools/hcs10/RetrieveProfileTool.d.ts +33 -0
  122. package/dist/umd/tools/hcs10/SendMessageToConnectionTool.d.ts +40 -0
  123. package/dist/umd/tools/hcs10/base-hcs10-tools.d.ts +28 -0
  124. package/dist/umd/tools/hcs10/hcs10-tool-params.d.ts +18 -0
  125. package/dist/umd/tools/hcs10/index.d.ts +13 -0
  126. package/dist/umd/tools/index.d.ts +1 -13
  127. package/package.json +40 -37
  128. package/src/builders/hcs10/hcs10-builder.ts +2108 -0
  129. package/src/builders/index.ts +2 -0
  130. package/src/builders/types.ts +11 -0
  131. package/src/hcs10/HCS10Client.ts +3 -2
  132. package/src/index.ts +4 -2
  133. package/src/init/init.ts +85 -63
  134. package/src/plugins/PluginInterface.ts +15 -94
  135. package/src/plugins/PluginRegistry.ts +2 -98
  136. package/src/plugins/defi/index.ts +30 -117
  137. package/src/plugins/hedera/HbarPricePlugin.ts +19 -100
  138. package/src/plugins/index.ts +0 -5
  139. package/src/plugins/weather/index.ts +56 -40
  140. package/src/state/state-types.ts +9 -11
  141. package/src/tools/hcs10/AcceptConnectionRequestTool.ts +56 -0
  142. package/src/tools/hcs10/CheckMessagesTool.ts +73 -0
  143. package/src/tools/hcs10/ConnectionMonitorTool.ts +111 -0
  144. package/src/tools/hcs10/FindRegistrationsTool.ts +64 -0
  145. package/src/tools/hcs10/InitiateConnectionTool.ts +66 -0
  146. package/src/tools/hcs10/ListConnectionsTool.ts +58 -0
  147. package/src/tools/hcs10/ListUnapprovedConnectionRequestsTool.ts +26 -0
  148. package/src/tools/hcs10/ManageConnectionRequestsTool.ts +48 -0
  149. package/src/tools/hcs10/RegisterAgentTool.ts +213 -0
  150. package/src/tools/hcs10/RetrieveProfileTool.ts +61 -0
  151. package/src/tools/hcs10/SendMessageToConnectionTool.ts +45 -0
  152. package/src/tools/hcs10/base-hcs10-tools.ts +65 -0
  153. package/src/tools/hcs10/hcs10-tool-params.ts +21 -0
  154. package/src/tools/hcs10/index.ts +13 -0
  155. package/src/tools/index.ts +2 -13
  156. package/src/utils/HederaClient.ts +2 -2
  157. package/src/utils/ensure-agent-has-hbar.ts +3 -4
  158. package/dist/cjs/agents/index.d.ts +0 -0
  159. package/dist/cjs/plugins/BasePlugin.d.ts +0 -28
  160. package/dist/cjs/plugins/GenericPlugin.d.ts +0 -17
  161. package/dist/cjs/plugins/HCS10Plugin.d.ts +0 -13
  162. package/dist/cjs/plugins/PluginLoader.d.ts +0 -38
  163. package/dist/cjs/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  164. package/dist/cjs/plugins/openconvai/index.d.ts +0 -1
  165. package/dist/cjs/tools/AcceptConnectionRequestTool.d.ts +0 -33
  166. package/dist/cjs/tools/CheckMessagesTool.d.ts +0 -34
  167. package/dist/cjs/tools/ConnectionMonitorTool.d.ts +0 -100
  168. package/dist/cjs/tools/ConnectionTool.d.ts +0 -40
  169. package/dist/cjs/tools/FindRegistrationsTool.d.ts +0 -28
  170. package/dist/cjs/tools/InitiateConnectionTool.d.ts +0 -30
  171. package/dist/cjs/tools/ListConnectionsTool.d.ts +0 -33
  172. package/dist/cjs/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  173. package/dist/cjs/tools/ManageConnectionRequestsTool.d.ts +0 -38
  174. package/dist/cjs/tools/RegisterAgentTool.d.ts +0 -188
  175. package/dist/cjs/tools/RetrieveProfileTool.d.ts +0 -34
  176. package/dist/cjs/tools/SendMessageToConnectionTool.d.ts +0 -34
  177. package/dist/cjs/tools/SendMessageTool.d.ts +0 -40
  178. package/dist/es/agents/index.d.ts +0 -0
  179. package/dist/es/plugins/BasePlugin.d.ts +0 -28
  180. package/dist/es/plugins/GenericPlugin.d.ts +0 -17
  181. package/dist/es/plugins/HCS10Plugin.d.ts +0 -13
  182. package/dist/es/plugins/PluginLoader.d.ts +0 -38
  183. package/dist/es/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  184. package/dist/es/plugins/openconvai/index.d.ts +0 -1
  185. package/dist/es/standards-agent-kit.es21.js +0 -92
  186. package/dist/es/standards-agent-kit.es21.js.map +0 -1
  187. package/dist/es/standards-agent-kit.es22.js +0 -7
  188. package/dist/es/standards-agent-kit.es22.js.map +0 -1
  189. package/dist/es/standards-agent-kit.es23.js +0 -106
  190. package/dist/es/standards-agent-kit.es23.js.map +0 -1
  191. package/dist/es/standards-agent-kit.es24.js +0 -7
  192. package/dist/es/standards-agent-kit.es24.js.map +0 -1
  193. package/dist/es/standards-agent-kit.es25.js +0 -7
  194. package/dist/es/standards-agent-kit.es25.js.map +0 -1
  195. package/dist/es/standards-agent-kit.es26.js +0 -85
  196. package/dist/es/standards-agent-kit.es26.js.map +0 -1
  197. package/dist/es/standards-agent-kit.es27.js +0 -28
  198. package/dist/es/standards-agent-kit.es27.js.map +0 -1
  199. package/dist/es/tools/AcceptConnectionRequestTool.d.ts +0 -33
  200. package/dist/es/tools/CheckMessagesTool.d.ts +0 -34
  201. package/dist/es/tools/ConnectionMonitorTool.d.ts +0 -100
  202. package/dist/es/tools/ConnectionTool.d.ts +0 -40
  203. package/dist/es/tools/FindRegistrationsTool.d.ts +0 -28
  204. package/dist/es/tools/InitiateConnectionTool.d.ts +0 -30
  205. package/dist/es/tools/ListConnectionsTool.d.ts +0 -33
  206. package/dist/es/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  207. package/dist/es/tools/ManageConnectionRequestsTool.d.ts +0 -38
  208. package/dist/es/tools/RegisterAgentTool.d.ts +0 -188
  209. package/dist/es/tools/RetrieveProfileTool.d.ts +0 -34
  210. package/dist/es/tools/SendMessageToConnectionTool.d.ts +0 -34
  211. package/dist/es/tools/SendMessageTool.d.ts +0 -40
  212. package/dist/umd/agents/index.d.ts +0 -0
  213. package/dist/umd/plugins/BasePlugin.d.ts +0 -28
  214. package/dist/umd/plugins/GenericPlugin.d.ts +0 -17
  215. package/dist/umd/plugins/HCS10Plugin.d.ts +0 -13
  216. package/dist/umd/plugins/PluginLoader.d.ts +0 -38
  217. package/dist/umd/plugins/openconvai/OpenConvAIPlugin.d.ts +0 -23
  218. package/dist/umd/plugins/openconvai/index.d.ts +0 -1
  219. package/dist/umd/tools/AcceptConnectionRequestTool.d.ts +0 -33
  220. package/dist/umd/tools/CheckMessagesTool.d.ts +0 -34
  221. package/dist/umd/tools/ConnectionMonitorTool.d.ts +0 -100
  222. package/dist/umd/tools/ConnectionTool.d.ts +0 -40
  223. package/dist/umd/tools/FindRegistrationsTool.d.ts +0 -28
  224. package/dist/umd/tools/InitiateConnectionTool.d.ts +0 -30
  225. package/dist/umd/tools/ListConnectionsTool.d.ts +0 -33
  226. package/dist/umd/tools/ListUnapprovedConnectionRequestsTool.d.ts +0 -41
  227. package/dist/umd/tools/ManageConnectionRequestsTool.d.ts +0 -38
  228. package/dist/umd/tools/RegisterAgentTool.d.ts +0 -188
  229. package/dist/umd/tools/RetrieveProfileTool.d.ts +0 -34
  230. package/dist/umd/tools/SendMessageToConnectionTool.d.ts +0 -34
  231. package/dist/umd/tools/SendMessageTool.d.ts +0 -40
  232. package/src/agents/index.ts +0 -1
  233. package/src/plugins/BasePlugin.ts +0 -37
  234. package/src/plugins/GenericPlugin.ts +0 -19
  235. package/src/plugins/HCS10Plugin.ts +0 -14
  236. package/src/plugins/PluginLoader.ts +0 -121
  237. package/src/plugins/README.md +0 -113
  238. package/src/plugins/openconvai/OpenConvAIPlugin.ts +0 -124
  239. package/src/plugins/openconvai/index.ts +0 -1
  240. package/src/tools/AcceptConnectionRequestTool.ts +0 -196
  241. package/src/tools/CheckMessagesTool.ts +0 -194
  242. package/src/tools/ConnectionMonitorTool.ts +0 -550
  243. package/src/tools/ConnectionTool.ts +0 -231
  244. package/src/tools/FindRegistrationsTool.ts +0 -114
  245. package/src/tools/InitiateConnectionTool.ts +0 -137
  246. package/src/tools/ListConnectionsTool.ts +0 -158
  247. package/src/tools/ListUnapprovedConnectionRequestsTool.ts +0 -173
  248. package/src/tools/ManageConnectionRequestsTool.ts +0 -275
  249. package/src/tools/RegisterAgentTool.ts +0 -590
  250. package/src/tools/RetrieveProfileTool.ts +0 -94
  251. package/src/tools/SendMessageToConnectionTool.ts +0 -142
  252. 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';