@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,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';
@@ -1,22 +1,21 @@
1
- import { HCS10Client, StandardNetworkType } from '../hcs10/HCS10Client';
2
- import { RegisterAgentTool } from '../tools/RegisterAgentTool';
3
- import { SendMessageTool } from '../tools/SendMessageTool';
4
- import { ConnectionTool } from '../tools/ConnectionTool';
1
+ import { HederaAgentKit } from 'hedera-agent-kit';
2
+ import { HCS10Builder } from '../builders/hcs10/hcs10-builder';
3
+ import { RegisterAgentTool } from '../tools/hcs10/RegisterAgentTool';
4
+ import { FindRegistrationsTool } from '../tools/hcs10/FindRegistrationsTool';
5
+ import { InitiateConnectionTool } from '../tools/hcs10/InitiateConnectionTool';
6
+ import { ListConnectionsTool } from '../tools/hcs10/ListConnectionsTool';
7
+ import { SendMessageToConnectionTool } from '../tools/hcs10/SendMessageToConnectionTool';
8
+ import { CheckMessagesTool } from '../tools/hcs10/CheckMessagesTool';
9
+ import { ConnectionMonitorTool } from '../tools/hcs10/ConnectionMonitorTool';
10
+ import { ManageConnectionRequestsTool } from '../tools/hcs10/ManageConnectionRequestsTool';
11
+ import { AcceptConnectionRequestTool } from '../tools/hcs10/AcceptConnectionRequestTool';
12
+ import { RetrieveProfileTool } from '../tools/hcs10/RetrieveProfileTool';
13
+ import { ListUnapprovedConnectionRequestsTool } from '../tools/hcs10/ListUnapprovedConnectionRequestsTool';
5
14
  import { IStateManager } from '../state/state-types';
6
- import { FindRegistrationsTool } from '../tools/FindRegistrationsTool';
7
- import { InitiateConnectionTool } from '../tools/InitiateConnectionTool';
8
- import { ListConnectionsTool } from '../tools/ListConnectionsTool';
9
- import { SendMessageToConnectionTool } from '../tools/SendMessageToConnectionTool';
10
- import { CheckMessagesTool } from '../tools/CheckMessagesTool';
11
- import { ConnectionMonitorTool } from '../tools/ConnectionMonitorTool';
12
- import { ManageConnectionRequestsTool } from '../tools/ManageConnectionRequestsTool';
13
- import { AcceptConnectionRequestTool } from '../tools/AcceptConnectionRequestTool';
14
- import { RetrieveProfileTool } from '../tools/RetrieveProfileTool';
15
- import { ListUnapprovedConnectionRequestsTool } from '../tools/ListUnapprovedConnectionRequestsTool';
16
15
  export interface HCS10ClientConfig {
17
16
  operatorId?: string;
18
17
  operatorKey?: string;
19
- network?: StandardNetworkType;
18
+ network?: 'mainnet' | 'testnet';
20
19
  useEncryption?: boolean;
21
20
  registryUrl?: string;
22
21
  logLevel?: 'debug' | 'info' | 'warn' | 'error';
@@ -38,8 +37,6 @@ export interface HCS10Tools {
38
37
  listConnectionsTool: ListConnectionsTool;
39
38
  sendMessageToConnectionTool: SendMessageToConnectionTool;
40
39
  checkMessagesTool: CheckMessagesTool;
41
- sendMessageTool: SendMessageTool;
42
- connectionTool: ConnectionTool;
43
40
  connectionMonitorTool: ConnectionMonitorTool;
44
41
  manageConnectionRequestsTool: ManageConnectionRequestsTool;
45
42
  acceptConnectionRequestTool: AcceptConnectionRequestTool;
@@ -49,11 +46,13 @@ export interface HCS10Tools {
49
46
  * Initializes the HCS10 client and returns pre-registered LangChain tools.
50
47
  *
51
48
  * @param options - Initialization options
52
- * @returns Object containing hcs10Client and requested tools
49
+ * @returns Object containing hederaKit, hcs10Builder and requested tools
53
50
  */
54
- export declare const initializeStandardsAgentKit: (options?: HCS10InitializationOptions) => {
55
- hcs10Client: HCS10Client;
56
- monitoringClient?: HCS10Client;
51
+ export declare const initializeStandardsAgentKit: (options?: HCS10InitializationOptions) => Promise<{
52
+ hederaKit: HederaAgentKit;
53
+ hcs10Builder: HCS10Builder;
54
+ monitoringHederaKit?: HederaAgentKit;
55
+ monitoringHcs10Builder?: HCS10Builder;
57
56
  tools: Partial<HCS10Tools>;
58
57
  stateManager: IStateManager;
59
- };
58
+ }>;
@@ -1,49 +1,12 @@
1
- import { StructuredTool } from '@langchain/core/tools';
2
1
  import { HCS10Client } from '../hcs10/HCS10Client';
3
2
  import { IStateManager } from '../state/state-types';
4
- import { Logger } from '@hashgraphonline/standards-sdk';
5
- /**
6
- * Basic client interface required by plugins
7
- */
8
- export interface IPluginClient {
9
- getNetwork(): string;
10
- }
11
- /**
12
- * Basic state manager interface required by plugins
13
- */
14
- export interface IPluginStateManager {
15
- getCurrentAgent?(): unknown;
16
- }
17
- /**
18
- * Base context provided to all plugins during initialization
19
- */
20
- export interface BasePluginContext {
21
- /**
22
- * Logger instance
23
- */
24
- logger: Logger;
25
- /**
26
- * Configuration options
27
- */
28
- config: Record<string, unknown>;
29
- }
30
- /**
31
- * Context provided to platform-agnostic plugins during initialization
32
- */
33
- export interface GenericPluginContext extends BasePluginContext {
34
- /**
35
- * Generic client interface
36
- */
37
- client: IPluginClient;
38
- /**
39
- * Optional generic state manager
40
- */
41
- stateManager?: IPluginStateManager;
42
- }
3
+ import { BasePluginContext } from 'hedera-agent-kit';
4
+ export { BasePlugin } from 'hedera-agent-kit';
5
+ export type { IPlugin, BasePluginContext, GenericPluginContext, PluginContext, IPluginClient, IPluginStateManager, HederaTool, } from 'hedera-agent-kit';
43
6
  /**
44
7
  * Context provided to HCS10-specific plugins during initialization
45
8
  */
46
- export interface PluginContext extends BasePluginContext {
9
+ export interface HCS10PluginContext extends BasePluginContext {
47
10
  /**
48
11
  * The HCS10Client instance
49
12
  */
@@ -53,42 +16,3 @@ export interface PluginContext extends BasePluginContext {
53
16
  */
54
17
  stateManager?: IStateManager;
55
18
  }
56
- /**
57
- * Standard interface that all plugins must implement
58
- */
59
- export interface IPlugin<T extends BasePluginContext = BasePluginContext> {
60
- /**
61
- * Unique identifier for the plugin
62
- */
63
- id: string;
64
- /**
65
- * Human-readable name of the plugin
66
- */
67
- name: string;
68
- /**
69
- * Description of what the plugin does
70
- */
71
- description: string;
72
- /**
73
- * Version of the plugin
74
- */
75
- version: string;
76
- /**
77
- * Author of the plugin
78
- */
79
- author: string;
80
- /**
81
- * Initialize the plugin with the provided context
82
- * @param context The context containing shared resources
83
- */
84
- initialize(context: T): Promise<void>;
85
- /**
86
- * Get the tools provided by this plugin
87
- * @returns Array of tools provided by this plugin
88
- */
89
- getTools(): StructuredTool[];
90
- /**
91
- * Clean up resources when the plugin is unloaded
92
- */
93
- cleanup?(): Promise<void>;
94
- }
@@ -1,47 +1 @@
1
- import { IPlugin, PluginContext } from './PluginInterface';
2
- import { StructuredTool } from '@langchain/core/tools';
3
- /**
4
- * Registry for managing plugins in the Standards Agent Kit
5
- */
6
- export declare class PluginRegistry {
7
- private plugins;
8
- private context;
9
- private logger;
10
- /**
11
- * Creates a new PluginRegistry instance
12
- * @param context The context to provide to plugins during initialization
13
- */
14
- constructor(context: PluginContext);
15
- /**
16
- * Register a plugin with the registry
17
- * @param plugin The plugin to register
18
- * @throws Error if a plugin with the same ID is already registered
19
- */
20
- registerPlugin(plugin: IPlugin): Promise<void>;
21
- /**
22
- * Get a plugin by ID
23
- * @param id The ID of the plugin to retrieve
24
- * @returns The plugin, or undefined if not found
25
- */
26
- getPlugin(id: string): IPlugin | undefined;
27
- /**
28
- * Get all registered plugins
29
- * @returns Array of all registered plugins
30
- */
31
- getAllPlugins(): IPlugin[];
32
- /**
33
- * Get all tools from all registered plugins
34
- * @returns Array of all tools provided by registered plugins
35
- */
36
- getAllTools(): StructuredTool[];
37
- /**
38
- * Unregister a plugin
39
- * @param id The ID of the plugin to unregister
40
- * @returns true if the plugin was unregistered, false if it wasn't found
41
- */
42
- unregisterPlugin(id: string): Promise<boolean>;
43
- /**
44
- * Unregister all plugins
45
- */
46
- unregisterAllPlugins(): Promise<void>;
47
- }
1
+ export { PluginRegistry } from 'hedera-agent-kit';
@@ -1,13 +1,16 @@
1
- import { HCS10Plugin } from '../../../src/plugins/HCS10Plugin';
2
- import { StructuredTool } from '@langchain/core/tools';
1
+ import { BasePlugin, GenericPluginContext, HederaTool } from 'hedera-agent-kit';
3
2
  /**
4
3
  * DeFi Integration Plugin for the Standards Agent Kit
4
+ * Uses built-in Hedera token tools from hedera-agent-kit
5
5
  */
6
- export default class DeFiPlugin extends HCS10Plugin {
6
+ export default class DeFiPlugin extends BasePlugin<GenericPluginContext> {
7
7
  id: string;
8
8
  name: string;
9
9
  description: string;
10
10
  version: string;
11
11
  author: string;
12
- getTools(): StructuredTool[];
12
+ private tools;
13
+ initialize(context: GenericPluginContext): Promise<void>;
14
+ private initializeTools;
15
+ getTools(): HederaTool[];
13
16
  }