@hashgraphonline/standards-agent-kit 0.2.131 → 0.2.132

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 (214) hide show
  1. package/dist/cjs/builders/inscriber/inscriber-builder.d.ts +36 -5
  2. package/dist/cjs/index.d.ts +2 -0
  3. package/dist/cjs/interfaces/FormValidatable.d.ts +45 -0
  4. package/dist/cjs/interfaces/index.d.ts +1 -0
  5. package/dist/cjs/lib/index.d.ts +1 -0
  6. package/dist/cjs/lib/zod-render/__tests__/withRender.test.d.ts +1 -0
  7. package/dist/cjs/lib/zod-render/config-extractor.d.ts +71 -0
  8. package/dist/cjs/lib/zod-render/index.d.ts +6 -0
  9. package/dist/cjs/lib/zod-render/schema-extension.d.ts +102 -0
  10. package/dist/cjs/lib/zod-render/types.d.ts +286 -0
  11. package/dist/cjs/standards-agent-kit.cjs +1 -1
  12. package/dist/cjs/standards-agent-kit.cjs.map +1 -1
  13. package/dist/cjs/tools/hcs10/natural-language-mapper.d.ts +6 -1
  14. package/dist/cjs/tools/hcs2/CreateRegistryTool.d.ts +1 -16
  15. package/dist/cjs/tools/hcs2/DeleteEntryTool.d.ts +1 -13
  16. package/dist/cjs/tools/hcs2/RegisterEntryTool.d.ts +1 -16
  17. package/dist/cjs/tools/hcs2/UpdateEntryTool.d.ts +1 -19
  18. package/dist/cjs/tools/hcs6/CreateDynamicRegistryTool.d.ts +1 -10
  19. package/dist/cjs/tools/hedera/HederaCreateNftTool.d.ts +72 -0
  20. package/dist/cjs/tools/hedera/index.d.ts +1 -0
  21. package/dist/cjs/tools/index.d.ts +1 -0
  22. package/dist/cjs/tools/inscriber/InscribeHashinalTool.d.ts +42 -132
  23. package/dist/cjs/tools/inscriber/RetrieveInscriptionTool.d.ts +20 -1
  24. package/dist/cjs/types/inscription-response.d.ts +172 -0
  25. package/dist/cjs/validation/hip412-schemas.d.ts +1 -1
  26. package/dist/es/builders/inscriber/inscriber-builder.d.ts +36 -5
  27. package/dist/es/index.d.ts +2 -0
  28. package/dist/es/interfaces/FormValidatable.d.ts +45 -0
  29. package/dist/es/interfaces/index.d.ts +1 -0
  30. package/dist/es/lib/index.d.ts +1 -0
  31. package/dist/es/lib/zod-render/__tests__/withRender.test.d.ts +1 -0
  32. package/dist/es/lib/zod-render/config-extractor.d.ts +71 -0
  33. package/dist/es/lib/zod-render/index.d.ts +6 -0
  34. package/dist/es/lib/zod-render/schema-extension.d.ts +102 -0
  35. package/dist/es/lib/zod-render/types.d.ts +286 -0
  36. package/dist/es/standards-agent-kit.es.js +6248 -44
  37. package/dist/es/standards-agent-kit.es.js.map +1 -1
  38. package/dist/es/tools/hcs10/natural-language-mapper.d.ts +6 -1
  39. package/dist/es/tools/hcs2/CreateRegistryTool.d.ts +1 -16
  40. package/dist/es/tools/hcs2/DeleteEntryTool.d.ts +1 -13
  41. package/dist/es/tools/hcs2/RegisterEntryTool.d.ts +1 -16
  42. package/dist/es/tools/hcs2/UpdateEntryTool.d.ts +1 -19
  43. package/dist/es/tools/hcs6/CreateDynamicRegistryTool.d.ts +1 -10
  44. package/dist/es/tools/hedera/HederaCreateNftTool.d.ts +72 -0
  45. package/dist/es/tools/hedera/index.d.ts +1 -0
  46. package/dist/es/tools/index.d.ts +1 -0
  47. package/dist/es/tools/inscriber/InscribeHashinalTool.d.ts +42 -132
  48. package/dist/es/tools/inscriber/RetrieveInscriptionTool.d.ts +20 -1
  49. package/dist/es/types/inscription-response.d.ts +172 -0
  50. package/dist/es/validation/hip412-schemas.d.ts +1 -1
  51. package/dist/umd/builders/inscriber/inscriber-builder.d.ts +36 -5
  52. package/dist/umd/index.d.ts +2 -0
  53. package/dist/umd/interfaces/FormValidatable.d.ts +45 -0
  54. package/dist/umd/interfaces/index.d.ts +1 -0
  55. package/dist/umd/lib/index.d.ts +1 -0
  56. package/dist/umd/lib/zod-render/__tests__/withRender.test.d.ts +1 -0
  57. package/dist/umd/lib/zod-render/config-extractor.d.ts +71 -0
  58. package/dist/umd/lib/zod-render/index.d.ts +6 -0
  59. package/dist/umd/lib/zod-render/schema-extension.d.ts +102 -0
  60. package/dist/umd/lib/zod-render/types.d.ts +286 -0
  61. package/dist/umd/standards-agent-kit.umd.js +1 -1
  62. package/dist/umd/standards-agent-kit.umd.js.map +1 -1
  63. package/dist/umd/tools/hcs10/natural-language-mapper.d.ts +6 -1
  64. package/dist/umd/tools/hcs2/CreateRegistryTool.d.ts +1 -16
  65. package/dist/umd/tools/hcs2/DeleteEntryTool.d.ts +1 -13
  66. package/dist/umd/tools/hcs2/RegisterEntryTool.d.ts +1 -16
  67. package/dist/umd/tools/hcs2/UpdateEntryTool.d.ts +1 -19
  68. package/dist/umd/tools/hcs6/CreateDynamicRegistryTool.d.ts +1 -10
  69. package/dist/umd/tools/hedera/HederaCreateNftTool.d.ts +72 -0
  70. package/dist/umd/tools/hedera/index.d.ts +1 -0
  71. package/dist/umd/tools/index.d.ts +1 -0
  72. package/dist/umd/tools/inscriber/InscribeHashinalTool.d.ts +42 -132
  73. package/dist/umd/tools/inscriber/RetrieveInscriptionTool.d.ts +20 -1
  74. package/dist/umd/types/inscription-response.d.ts +172 -0
  75. package/dist/umd/validation/hip412-schemas.d.ts +1 -1
  76. package/package.json +29 -32
  77. package/src/builders/inscriber/inscriber-builder.ts +42 -6
  78. package/src/hcs10/HCS10Client.ts +2 -5
  79. package/src/hcs10/types.ts +1 -15
  80. package/src/index.ts +2 -0
  81. package/src/init/init.ts +7 -10
  82. package/src/interfaces/FormValidatable.ts +57 -0
  83. package/src/interfaces/index.ts +1 -0
  84. package/src/lib/index.ts +1 -0
  85. package/src/lib/zod-render/__tests__/withRender.test.ts +205 -0
  86. package/src/lib/zod-render/config-extractor.ts +443 -0
  87. package/src/lib/zod-render/index.ts +42 -0
  88. package/src/lib/zod-render/schema-extension.ts +612 -0
  89. package/src/lib/zod-render/types.ts +333 -0
  90. package/src/plugins/PluginInterface.ts +1 -2
  91. package/src/plugins/PluginRegistry.ts +1 -1
  92. package/src/plugins/hedera/HbarPricePlugin.ts +1 -1
  93. package/src/plugins/weather/index.ts +15 -4
  94. package/src/state/open-convai-state.ts +1 -11
  95. package/src/tools/hcs10/FindRegistrationsTool.ts +1 -1
  96. package/src/tools/hcs10/RegisterAgentTool.ts +3 -3
  97. package/src/tools/hcs10/SendMessageToConnectionTool.ts +4 -1
  98. package/src/tools/hcs10/natural-language-mapper.ts +35 -53
  99. package/src/tools/hcs2/CreateRegistryTool.ts +1 -1
  100. package/src/tools/hcs2/DeleteEntryTool.ts +1 -1
  101. package/src/tools/hcs2/RegisterEntryTool.ts +1 -1
  102. package/src/tools/hcs2/UpdateEntryTool.ts +1 -1
  103. package/src/tools/hcs6/CreateDynamicRegistryTool.ts +2 -2
  104. package/src/tools/hcs6/QueryDynamicRegistryTool.ts +1 -1
  105. package/src/tools/hcs6/RegisterDynamicHashinalTool.ts +1 -1
  106. package/src/tools/hcs6/UpdateDynamicHashinalTool.ts +2 -2
  107. package/src/tools/hedera/HederaCreateNftTool.ts +294 -0
  108. package/src/tools/hedera/index.ts +1 -0
  109. package/src/tools/index.ts +2 -1
  110. package/src/tools/inscriber/InscribeFromFileTool.ts +2 -11
  111. package/src/tools/inscriber/InscribeFromUrlTool.ts +15 -19
  112. package/src/tools/inscriber/InscribeHashinalTool.ts +594 -153
  113. package/src/tools/inscriber/RetrieveInscriptionTool.ts +34 -12
  114. package/src/tools/inscriber/base-inscriber-tools.ts +2 -24
  115. package/src/types/content-resolver.ts +3 -3
  116. package/src/types/inscription-response.ts +234 -0
  117. package/src/utils/Encryption.ts +1 -1
  118. package/src/utils/HederaClient.ts +1 -2
  119. package/src/utils/metadata-defaults.ts +15 -4
  120. package/src/utils/state-tools.ts +1 -2
  121. package/src/validation/content-ref-schemas.ts +2 -2
  122. package/src/validation/hip412-schemas.ts +1 -1
  123. package/dist/es/standards-agent-kit.es10.js +0 -89
  124. package/dist/es/standards-agent-kit.es10.js.map +0 -1
  125. package/dist/es/standards-agent-kit.es11.js +0 -40
  126. package/dist/es/standards-agent-kit.es11.js.map +0 -1
  127. package/dist/es/standards-agent-kit.es12.js +0 -40
  128. package/dist/es/standards-agent-kit.es12.js.map +0 -1
  129. package/dist/es/standards-agent-kit.es13.js +0 -50
  130. package/dist/es/standards-agent-kit.es13.js.map +0 -1
  131. package/dist/es/standards-agent-kit.es14.js +0 -60
  132. package/dist/es/standards-agent-kit.es14.js.map +0 -1
  133. package/dist/es/standards-agent-kit.es15.js +0 -72
  134. package/dist/es/standards-agent-kit.es15.js.map +0 -1
  135. package/dist/es/standards-agent-kit.es16.js +0 -35
  136. package/dist/es/standards-agent-kit.es16.js.map +0 -1
  137. package/dist/es/standards-agent-kit.es17.js +0 -35
  138. package/dist/es/standards-agent-kit.es17.js.map +0 -1
  139. package/dist/es/standards-agent-kit.es18.js +0 -45
  140. package/dist/es/standards-agent-kit.es18.js.map +0 -1
  141. package/dist/es/standards-agent-kit.es19.js +0 -21
  142. package/dist/es/standards-agent-kit.es19.js.map +0 -1
  143. package/dist/es/standards-agent-kit.es2.js +0 -25
  144. package/dist/es/standards-agent-kit.es2.js.map +0 -1
  145. package/dist/es/standards-agent-kit.es20.js +0 -160
  146. package/dist/es/standards-agent-kit.es20.js.map +0 -1
  147. package/dist/es/standards-agent-kit.es21.js +0 -32
  148. package/dist/es/standards-agent-kit.es21.js.map +0 -1
  149. package/dist/es/standards-agent-kit.es22.js +0 -46
  150. package/dist/es/standards-agent-kit.es22.js.map +0 -1
  151. package/dist/es/standards-agent-kit.es23.js +0 -48
  152. package/dist/es/standards-agent-kit.es23.js.map +0 -1
  153. package/dist/es/standards-agent-kit.es24.js +0 -51
  154. package/dist/es/standards-agent-kit.es24.js.map +0 -1
  155. package/dist/es/standards-agent-kit.es25.js +0 -45
  156. package/dist/es/standards-agent-kit.es25.js.map +0 -1
  157. package/dist/es/standards-agent-kit.es26.js +0 -48
  158. package/dist/es/standards-agent-kit.es26.js.map +0 -1
  159. package/dist/es/standards-agent-kit.es27.js +0 -45
  160. package/dist/es/standards-agent-kit.es27.js.map +0 -1
  161. package/dist/es/standards-agent-kit.es28.js +0 -32
  162. package/dist/es/standards-agent-kit.es28.js.map +0 -1
  163. package/dist/es/standards-agent-kit.es29.js +0 -35
  164. package/dist/es/standards-agent-kit.es29.js.map +0 -1
  165. package/dist/es/standards-agent-kit.es3.js +0 -1572
  166. package/dist/es/standards-agent-kit.es3.js.map +0 -1
  167. package/dist/es/standards-agent-kit.es30.js +0 -48
  168. package/dist/es/standards-agent-kit.es30.js.map +0 -1
  169. package/dist/es/standards-agent-kit.es31.js +0 -46
  170. package/dist/es/standards-agent-kit.es31.js.map +0 -1
  171. package/dist/es/standards-agent-kit.es32.js +0 -48
  172. package/dist/es/standards-agent-kit.es32.js.map +0 -1
  173. package/dist/es/standards-agent-kit.es33.js +0 -90
  174. package/dist/es/standards-agent-kit.es33.js.map +0 -1
  175. package/dist/es/standards-agent-kit.es34.js +0 -245
  176. package/dist/es/standards-agent-kit.es34.js.map +0 -1
  177. package/dist/es/standards-agent-kit.es35.js +0 -229
  178. package/dist/es/standards-agent-kit.es35.js.map +0 -1
  179. package/dist/es/standards-agent-kit.es36.js +0 -187
  180. package/dist/es/standards-agent-kit.es36.js.map +0 -1
  181. package/dist/es/standards-agent-kit.es37.js +0 -260
  182. package/dist/es/standards-agent-kit.es37.js.map +0 -1
  183. package/dist/es/standards-agent-kit.es38.js +0 -45
  184. package/dist/es/standards-agent-kit.es38.js.map +0 -1
  185. package/dist/es/standards-agent-kit.es39.js +0 -249
  186. package/dist/es/standards-agent-kit.es39.js.map +0 -1
  187. package/dist/es/standards-agent-kit.es4.js +0 -95
  188. package/dist/es/standards-agent-kit.es4.js.map +0 -1
  189. package/dist/es/standards-agent-kit.es40.js +0 -141
  190. package/dist/es/standards-agent-kit.es40.js.map +0 -1
  191. package/dist/es/standards-agent-kit.es41.js +0 -33
  192. package/dist/es/standards-agent-kit.es41.js.map +0 -1
  193. package/dist/es/standards-agent-kit.es42.js +0 -28
  194. package/dist/es/standards-agent-kit.es42.js.map +0 -1
  195. package/dist/es/standards-agent-kit.es43.js +0 -7
  196. package/dist/es/standards-agent-kit.es43.js.map +0 -1
  197. package/dist/es/standards-agent-kit.es44.js +0 -57
  198. package/dist/es/standards-agent-kit.es44.js.map +0 -1
  199. package/dist/es/standards-agent-kit.es45.js +0 -6
  200. package/dist/es/standards-agent-kit.es45.js.map +0 -1
  201. package/dist/es/standards-agent-kit.es46.js +0 -43
  202. package/dist/es/standards-agent-kit.es46.js.map +0 -1
  203. package/dist/es/standards-agent-kit.es47.js +0 -15
  204. package/dist/es/standards-agent-kit.es47.js.map +0 -1
  205. package/dist/es/standards-agent-kit.es5.js +0 -113
  206. package/dist/es/standards-agent-kit.es5.js.map +0 -1
  207. package/dist/es/standards-agent-kit.es6.js +0 -56
  208. package/dist/es/standards-agent-kit.es6.js.map +0 -1
  209. package/dist/es/standards-agent-kit.es7.js +0 -332
  210. package/dist/es/standards-agent-kit.es7.js.map +0 -1
  211. package/dist/es/standards-agent-kit.es8.js +0 -32
  212. package/dist/es/standards-agent-kit.es8.js.map +0 -1
  213. package/dist/es/standards-agent-kit.es9.js +0 -240
  214. package/dist/es/standards-agent-kit.es9.js.map +0 -1
@@ -1,4 +1,8 @@
1
1
  import { AIAgentCapability } from '@hashgraphonline/standards-sdk';
2
+ /**
3
+ * Valid input types for parsing tags or capabilities
4
+ */
5
+ type ParseInput = string | number[] | string[] | AIAgentCapability[];
2
6
  /**
3
7
  * Maps natural language terms to AIAgentCapability enum values
4
8
  */
@@ -11,9 +15,10 @@ export declare class NaturalLanguageMapper {
11
15
  /**
12
16
  * Parse tags/capabilities from various input formats
13
17
  */
14
- static parseTagsOrCapabilities(input: any): AIAgentCapability[];
18
+ static parseTagsOrCapabilities(input: ParseInput): AIAgentCapability[];
15
19
  /**
16
20
  * Convert capability enum to human-readable name
17
21
  */
18
22
  static getCapabilityName(capability: AIAgentCapability): string;
19
23
  }
24
+ export {};
@@ -27,22 +27,7 @@ declare const createRegistrySchema: z.ZodObject<{
27
27
  export declare class CreateRegistryTool extends BaseHCS2QueryTool<typeof createRegistrySchema> {
28
28
  name: string;
29
29
  description: string;
30
- get specificInputSchema(): z.ZodObject<{
31
- registryType: z.ZodOptional<z.ZodNativeEnum<typeof HCS2RegistryType>>;
32
- ttl: z.ZodOptional<z.ZodNumber>;
33
- adminKey: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
34
- submitKey: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
35
- }, "strip", z.ZodTypeAny, {
36
- registryType?: HCS2RegistryType | undefined;
37
- ttl?: number | undefined;
38
- adminKey?: string | boolean | undefined;
39
- submitKey?: string | boolean | undefined;
40
- }, {
41
- registryType?: HCS2RegistryType | undefined;
42
- ttl?: number | undefined;
43
- adminKey?: string | boolean | undefined;
44
- submitKey?: string | boolean | undefined;
45
- }>;
30
+ get specificInputSchema(): typeof createRegistrySchema;
46
31
  protected executeQuery(params: z.infer<typeof createRegistrySchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
47
32
  }
48
33
  export {};
@@ -23,19 +23,7 @@ declare const deleteEntrySchema: z.ZodObject<{
23
23
  export declare class DeleteEntryTool extends BaseHCS2QueryTool<typeof deleteEntrySchema> {
24
24
  name: string;
25
25
  description: string;
26
- get specificInputSchema(): z.ZodObject<{
27
- registryTopicId: z.ZodString;
28
- uid: z.ZodString;
29
- memo: z.ZodOptional<z.ZodString>;
30
- }, "strip", z.ZodTypeAny, {
31
- uid: string;
32
- registryTopicId: string;
33
- memo?: string | undefined;
34
- }, {
35
- uid: string;
36
- registryTopicId: string;
37
- memo?: string | undefined;
38
- }>;
26
+ get specificInputSchema(): typeof deleteEntrySchema;
39
27
  protected executeQuery(params: z.infer<typeof deleteEntrySchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
40
28
  }
41
29
  export {};
@@ -26,22 +26,7 @@ declare const registerEntrySchema: z.ZodObject<{
26
26
  export declare class RegisterEntryTool extends BaseHCS2QueryTool<typeof registerEntrySchema> {
27
27
  name: string;
28
28
  description: string;
29
- get specificInputSchema(): z.ZodObject<{
30
- registryTopicId: z.ZodString;
31
- targetTopicId: z.ZodString;
32
- metadata: z.ZodOptional<z.ZodString>;
33
- memo: z.ZodOptional<z.ZodString>;
34
- }, "strip", z.ZodTypeAny, {
35
- registryTopicId: string;
36
- targetTopicId: string;
37
- metadata?: string | undefined;
38
- memo?: string | undefined;
39
- }, {
40
- registryTopicId: string;
41
- targetTopicId: string;
42
- metadata?: string | undefined;
43
- memo?: string | undefined;
44
- }>;
29
+ get specificInputSchema(): typeof registerEntrySchema;
45
30
  protected executeQuery(params: z.infer<typeof registerEntrySchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
46
31
  }
47
32
  export {};
@@ -29,25 +29,7 @@ declare const updateEntrySchema: z.ZodObject<{
29
29
  export declare class UpdateEntryTool extends BaseHCS2QueryTool<typeof updateEntrySchema> {
30
30
  name: string;
31
31
  description: string;
32
- get specificInputSchema(): z.ZodObject<{
33
- registryTopicId: z.ZodString;
34
- targetTopicId: z.ZodString;
35
- uid: z.ZodString;
36
- metadata: z.ZodOptional<z.ZodString>;
37
- memo: z.ZodOptional<z.ZodString>;
38
- }, "strip", z.ZodTypeAny, {
39
- uid: string;
40
- registryTopicId: string;
41
- targetTopicId: string;
42
- metadata?: string | undefined;
43
- memo?: string | undefined;
44
- }, {
45
- uid: string;
46
- registryTopicId: string;
47
- targetTopicId: string;
48
- metadata?: string | undefined;
49
- memo?: string | undefined;
50
- }>;
32
+ get specificInputSchema(): typeof updateEntrySchema;
51
33
  protected executeQuery(params: z.infer<typeof updateEntrySchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
52
34
  }
53
35
  export {};
@@ -22,16 +22,7 @@ export type CreateDynamicRegistryInput = z.infer<typeof CreateDynamicRegistrySch
22
22
  export declare class CreateDynamicRegistryTool extends BaseHCS6QueryTool<typeof CreateDynamicRegistrySchema> {
23
23
  name: string;
24
24
  description: string;
25
- get specificInputSchema(): z.ZodObject<{
26
- ttl: z.ZodDefault<z.ZodNumber>;
27
- submitKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
28
- }, "strip", z.ZodTypeAny, {
29
- ttl: number;
30
- submitKey?: string | boolean | undefined;
31
- }, {
32
- ttl?: number | undefined;
33
- submitKey?: string | boolean | undefined;
34
- }>;
25
+ get specificInputSchema(): typeof CreateDynamicRegistrySchema;
35
26
  constructor(params: HCS6QueryToolParams);
36
27
  protected executeQuery(params: CreateDynamicRegistryInput, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
37
28
  }
@@ -0,0 +1,72 @@
1
+ import { z } from 'zod';
2
+ import { BaseHederaTransactionTool, BaseServiceBuilder } from 'hedera-agent-kit';
3
+ /**
4
+ * Enhanced NFT creation schema with render configurations
5
+ */
6
+ export declare const HederaCreateNftSchema: import('../..').ZodSchemaWithRender<{
7
+ tokenName: string;
8
+ memo?: string | undefined;
9
+ adminKey?: string | undefined;
10
+ tokenSymbol?: string | undefined;
11
+ treasuryAccountId?: string | undefined;
12
+ kycKey?: string | undefined;
13
+ freezeKey?: string | undefined;
14
+ wipeKey?: string | undefined;
15
+ supplyKey?: string | undefined;
16
+ feeScheduleKey?: string | undefined;
17
+ pauseKey?: string | undefined;
18
+ autoRenewAccountId?: string | undefined;
19
+ autoRenewPeriod?: number | undefined;
20
+ freezeDefault?: boolean | undefined;
21
+ supplyType?: "FINITE" | "INFINITE" | undefined;
22
+ maxSupply?: string | number | undefined;
23
+ customFees?: ({
24
+ type: "FIXED" | "FIXED_FEE";
25
+ amount: string | number;
26
+ feeCollectorAccountId?: string | undefined;
27
+ denominatingTokenId?: string | undefined;
28
+ } | {
29
+ type: "FRACTIONAL" | "FRACTIONAL_FEE";
30
+ numerator: number;
31
+ denominator: number;
32
+ feeCollectorAccountId?: string | undefined;
33
+ minAmount?: string | number | undefined;
34
+ maxAmount?: string | number | undefined;
35
+ assessmentMethodInclusive?: boolean | undefined;
36
+ } | {
37
+ type: "ROYALTY" | "ROYALTY_FEE";
38
+ numerator: number;
39
+ denominator: number;
40
+ feeCollectorAccountId?: string | undefined;
41
+ fallbackFee?: {
42
+ amount: string | number;
43
+ feeCollectorAccountId?: string | undefined;
44
+ denominatingTokenId?: string | undefined;
45
+ } | undefined;
46
+ })[] | undefined;
47
+ }>;
48
+ /**
49
+ * Hedera Create NFT Tool with enhanced render configurations for form generation
50
+ */
51
+ export declare class HederaCreateNftTool extends BaseHederaTransactionTool<any> {
52
+ name: string;
53
+ description: string;
54
+ specificInputSchema: any;
55
+ namespace: string;
56
+ /**
57
+ * Returns the service builder for HTS operations
58
+ */
59
+ protected getServiceBuilder(): BaseServiceBuilder;
60
+ /**
61
+ * Calls the builder method to create the NFT collection
62
+ */
63
+ protected callBuilderMethod(builder: BaseServiceBuilder, specificArgs: z.infer<typeof HederaCreateNftSchema>): Promise<void>;
64
+ /**
65
+ * Provides helpful notes for specific field values
66
+ */
67
+ protected getNoteForKey(key: string, schemaDefaultValue: unknown, actualValue: unknown): string | undefined;
68
+ /**
69
+ * Validates the configuration before execution
70
+ */
71
+ protected validateInput(args: z.infer<typeof HederaCreateNftSchema>): Promise<void>;
72
+ }
@@ -0,0 +1 @@
1
+ export { HederaCreateNftTool, HederaCreateNftSchema } from './HederaCreateNftTool';
@@ -2,3 +2,4 @@ export * from './hcs10';
2
2
  export * from './hcs2';
3
3
  export * from './hcs6';
4
4
  export * from './inscriber';
5
+ export * from './hedera';
@@ -1,62 +1,12 @@
1
1
  import { z } from 'zod';
2
2
  import { BaseInscriberQueryTool } from './base-inscriber-tools';
3
3
  import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
4
+ import { InscriptionResponse } from '../../types/inscription-response';
5
+ import { FormValidatable } from '../../interfaces/FormValidatable';
4
6
  /**
5
7
  * Schema for inscribing Hashinal NFT
6
8
  */
7
- declare const inscribeHashinalSchema: z.ZodObject<{
8
- url: z.ZodOptional<z.ZodString>;
9
- contentRef: z.ZodOptional<z.ZodString>;
10
- base64Data: z.ZodOptional<z.ZodString>;
11
- fileName: z.ZodOptional<z.ZodString>;
12
- mimeType: z.ZodOptional<z.ZodString>;
13
- name: z.ZodOptional<z.ZodString>;
14
- creator: z.ZodOptional<z.ZodString>;
15
- description: z.ZodOptional<z.ZodString>;
16
- type: z.ZodOptional<z.ZodString>;
17
- attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
18
- trait_type: z.ZodString;
19
- value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
20
- }, "strip", z.ZodTypeAny, {
21
- value: string | number;
22
- trait_type: string;
23
- }, {
24
- value: string | number;
25
- trait_type: string;
26
- }>, "many">>;
27
- properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
28
- jsonFileURL: z.ZodOptional<z.ZodString>;
29
- fileStandard: z.ZodDefault<z.ZodOptional<z.ZodEnum<["1", "6"]>>>;
30
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
31
- chunkSize: z.ZodOptional<z.ZodNumber>;
32
- waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
33
- timeoutMs: z.ZodOptional<z.ZodNumber>;
34
- apiKey: z.ZodOptional<z.ZodString>;
35
- quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
36
- }, "strip", z.ZodTypeAny, {
37
- quoteOnly: boolean;
38
- fileStandard: "1" | "6";
39
- url?: string | undefined;
40
- type?: string | undefined;
41
- name?: string | undefined;
42
- description?: string | undefined;
43
- tags?: string[] | undefined;
44
- creator?: string | undefined;
45
- properties?: Record<string, unknown> | undefined;
46
- mimeType?: string | undefined;
47
- chunkSize?: number | undefined;
48
- waitForConfirmation?: boolean | undefined;
49
- timeoutMs?: number | undefined;
50
- apiKey?: string | undefined;
51
- fileName?: string | undefined;
52
- base64Data?: string | undefined;
53
- attributes?: {
54
- value: string | number;
55
- trait_type: string;
56
- }[] | undefined;
57
- contentRef?: string | undefined;
58
- jsonFileURL?: string | undefined;
59
- }, {
9
+ declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
60
10
  url?: string | undefined;
61
11
  type?: string | undefined;
62
12
  name?: string | undefined;
@@ -68,7 +18,6 @@ declare const inscribeHashinalSchema: z.ZodObject<{
68
18
  chunkSize?: number | undefined;
69
19
  waitForConfirmation?: boolean | undefined;
70
20
  timeoutMs?: number | undefined;
71
- apiKey?: string | undefined;
72
21
  quoteOnly?: boolean | undefined;
73
22
  fileName?: string | undefined;
74
23
  base64Data?: string | undefined;
@@ -79,91 +28,52 @@ declare const inscribeHashinalSchema: z.ZodObject<{
79
28
  contentRef?: string | undefined;
80
29
  jsonFileURL?: string | undefined;
81
30
  fileStandard?: "1" | "6" | undefined;
31
+ withHashLinkBlocks?: boolean | undefined;
32
+ renderForm?: boolean | undefined;
82
33
  }>;
83
34
  /**
84
35
  * Tool for inscribing Hashinal NFTs
85
36
  */
86
- export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribeHashinalSchema> {
37
+ export declare class InscribeHashinalTool extends BaseInscriberQueryTool implements FormValidatable {
87
38
  name: string;
88
39
  description: string;
89
- get specificInputSchema(): z.ZodObject<{
90
- url: z.ZodOptional<z.ZodString>;
91
- contentRef: z.ZodOptional<z.ZodString>;
92
- base64Data: z.ZodOptional<z.ZodString>;
93
- fileName: z.ZodOptional<z.ZodString>;
94
- mimeType: z.ZodOptional<z.ZodString>;
95
- name: z.ZodOptional<z.ZodString>;
96
- creator: z.ZodOptional<z.ZodString>;
97
- description: z.ZodOptional<z.ZodString>;
98
- type: z.ZodOptional<z.ZodString>;
99
- attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
100
- trait_type: z.ZodString;
101
- value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
102
- }, "strip", z.ZodTypeAny, {
103
- value: string | number;
104
- trait_type: string;
105
- }, {
106
- value: string | number;
107
- trait_type: string;
108
- }>, "many">>;
109
- properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
110
- jsonFileURL: z.ZodOptional<z.ZodString>;
111
- fileStandard: z.ZodDefault<z.ZodOptional<z.ZodEnum<["1", "6"]>>>;
112
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
113
- chunkSize: z.ZodOptional<z.ZodNumber>;
114
- waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
115
- timeoutMs: z.ZodOptional<z.ZodNumber>;
116
- apiKey: z.ZodOptional<z.ZodString>;
117
- quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
118
- }, "strip", z.ZodTypeAny, {
119
- quoteOnly: boolean;
120
- fileStandard: "1" | "6";
121
- url?: string | undefined;
122
- type?: string | undefined;
123
- name?: string | undefined;
124
- description?: string | undefined;
125
- tags?: string[] | undefined;
126
- creator?: string | undefined;
127
- properties?: Record<string, unknown> | undefined;
128
- mimeType?: string | undefined;
129
- chunkSize?: number | undefined;
130
- waitForConfirmation?: boolean | undefined;
131
- timeoutMs?: number | undefined;
132
- apiKey?: string | undefined;
133
- fileName?: string | undefined;
134
- base64Data?: string | undefined;
135
- attributes?: {
136
- value: string | number;
137
- trait_type: string;
138
- }[] | undefined;
139
- contentRef?: string | undefined;
140
- jsonFileURL?: string | undefined;
141
- }, {
142
- url?: string | undefined;
143
- type?: string | undefined;
144
- name?: string | undefined;
145
- description?: string | undefined;
146
- tags?: string[] | undefined;
147
- creator?: string | undefined;
148
- properties?: Record<string, unknown> | undefined;
149
- mimeType?: string | undefined;
150
- chunkSize?: number | undefined;
151
- waitForConfirmation?: boolean | undefined;
152
- timeoutMs?: number | undefined;
153
- apiKey?: string | undefined;
154
- quoteOnly?: boolean | undefined;
155
- fileName?: string | undefined;
156
- base64Data?: string | undefined;
157
- attributes?: {
158
- value: string | number;
159
- trait_type: string;
160
- }[] | undefined;
161
- contentRef?: string | undefined;
162
- jsonFileURL?: string | undefined;
163
- fileStandard?: "1" | "6" | undefined;
164
- }>;
165
- protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
40
+ get specificInputSchema(): z.ZodObject<z.ZodRawShape>;
41
+ private _schemaWithRenderConfig?;
42
+ get schema(): z.ZodObject<z.ZodRawShape>;
43
+ /**
44
+ * Implementation of FormValidatable interface
45
+ * Determines if a form should be generated for the given input
46
+ */
47
+ shouldGenerateForm(input: unknown): boolean;
48
+ /**
49
+ * Implementation of FormValidatable interface
50
+ * Returns the focused schema for form generation
51
+ */
52
+ getFormSchema(): z.ZodObject<z.ZodRawShape>;
53
+ /**
54
+ * Implementation of FormValidatable interface
55
+ * Validates metadata quality and provides detailed feedback
56
+ */
57
+ validateMetadataQuality(input: unknown): {
58
+ needsForm: boolean;
59
+ reason: string;
60
+ };
61
+ protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<InscriptionResponse>;
62
+ /**
63
+ * Creates HashLink block reference for inscription display
64
+ */
65
+ private createHashLinkBlock;
166
66
  private resolveContent;
167
67
  private handleDirectContent;
68
+ /**
69
+ * Implementation of FormValidatable interface
70
+ * Returns essential fields that should always be shown in forms
71
+ */
72
+ getEssentialFields(): string[];
73
+ /**
74
+ * Implementation of FormValidatable interface
75
+ * Determines if a field value should be considered empty for this tool
76
+ */
77
+ isFieldEmpty(fieldName: string, value: unknown): boolean;
168
78
  }
169
79
  export {};
@@ -14,6 +14,25 @@ declare const retrieveInscriptionSchema: z.ZodObject<{
14
14
  transactionId: string;
15
15
  apiKey?: string | undefined;
16
16
  }>;
17
+ /**
18
+ * Type definition for inscription retrieval result
19
+ */
20
+ interface InscriptionRetrievalResult {
21
+ inscriptionId?: string;
22
+ transactionId: string;
23
+ topicId?: string;
24
+ status?: string;
25
+ holderId?: string;
26
+ metadata?: unknown;
27
+ tags?: unknown;
28
+ mode?: string;
29
+ chunks?: unknown;
30
+ createdAt?: string;
31
+ completedAt?: string;
32
+ fileUrl?: string;
33
+ mimeType?: string;
34
+ fileSize?: number;
35
+ }
17
36
  /**
18
37
  * Tool for retrieving inscriptions
19
38
  */
@@ -30,6 +49,6 @@ export declare class RetrieveInscriptionTool extends BaseInscriberQueryTool<type
30
49
  transactionId: string;
31
50
  apiKey?: string | undefined;
32
51
  }>;
33
- protected executeQuery(params: z.infer<typeof retrieveInscriptionSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
52
+ protected executeQuery(params: z.infer<typeof retrieveInscriptionSchema>, _runManager?: CallbackManagerForToolRun): Promise<InscriptionRetrievalResult>;
34
53
  }
35
54
  export {};
@@ -0,0 +1,172 @@
1
+ /**
2
+ * Structured response interface for inscription tools
3
+ * Provides a consistent, user-friendly format for inscription results
4
+ */
5
+ export interface InscriptionSuccessResponse {
6
+ success: true;
7
+ type: 'inscription';
8
+ title: string;
9
+ message: string;
10
+ inscription: {
11
+ /** The HRL (Hashinal Reference Link) for minting - e.g., "hcs://1/0.0.123456" */
12
+ hrl: string;
13
+ /** Topic ID where the inscription was stored */
14
+ topicId: string;
15
+ /** Type of Hashinal - Static (HCS-5) or Dynamic (HCS-6) */
16
+ standard: 'Static' | 'Dynamic';
17
+ /** CDN URL for direct access to the inscribed content */
18
+ cdnUrl?: string;
19
+ /** Transaction ID of the inscription */
20
+ transactionId?: string;
21
+ };
22
+ metadata: {
23
+ /** Name/title of the inscribed content */
24
+ name?: string;
25
+ /** Creator of the content */
26
+ creator?: string;
27
+ /** Description of the content */
28
+ description?: string;
29
+ /** Content type (image, text, etc.) */
30
+ type?: string;
31
+ /** Additional attributes */
32
+ attributes?: Array<{
33
+ trait_type: string;
34
+ value: string | number;
35
+ }>;
36
+ };
37
+ nextSteps: {
38
+ /** Primary action the user should take next */
39
+ primary: string;
40
+ /** Additional context or options */
41
+ context?: string;
42
+ /** Specific metadata value to use for minting */
43
+ mintingMetadata: string;
44
+ };
45
+ /** HashLink block data (only present when withHashLinkBlocks=true) */
46
+ hashLinkBlock?: {
47
+ /** Block topic ID on HCS */
48
+ blockId: string;
49
+ /** HashLink reference to the block */
50
+ hashLink: string;
51
+ /** Template topic ID */
52
+ template: string;
53
+ /** Block attributes for rendering */
54
+ attributes: BlockAttributes;
55
+ };
56
+ }
57
+ export interface InscriptionQuoteResponse {
58
+ success: true;
59
+ type: 'quote';
60
+ title: string;
61
+ message: string;
62
+ quote: {
63
+ /** Total cost in HBAR */
64
+ totalCostHbar: string;
65
+ /** When the quote expires */
66
+ validUntil: string;
67
+ /** Cost breakdown details */
68
+ breakdown?: CostBreakdown;
69
+ };
70
+ content: {
71
+ /** Name of the content to be inscribed */
72
+ name?: string;
73
+ /** Creator of the content */
74
+ creator?: string;
75
+ /** Type of content */
76
+ type?: string;
77
+ };
78
+ }
79
+ export interface InscriptionErrorResponse {
80
+ success: false;
81
+ type: 'error';
82
+ title: string;
83
+ message: string;
84
+ error: {
85
+ /** Error code for programmatic handling */
86
+ code: string;
87
+ /** Detailed error message */
88
+ details: string;
89
+ /** Suggestions for fixing the error */
90
+ suggestions?: string[];
91
+ };
92
+ }
93
+ export type InscriptionResponse = InscriptionSuccessResponse | InscriptionQuoteResponse | InscriptionErrorResponse;
94
+ /**
95
+ * Helper function to create a successful inscription response
96
+ */
97
+ export declare function createInscriptionSuccess(params: {
98
+ hrl: string;
99
+ topicId: string;
100
+ standard: 'Static' | 'Dynamic';
101
+ cdnUrl?: string;
102
+ transactionId?: string;
103
+ metadata: {
104
+ name?: string;
105
+ creator?: string;
106
+ description?: string;
107
+ type?: string;
108
+ attributes?: Array<{
109
+ trait_type: string;
110
+ value: string | number;
111
+ }>;
112
+ };
113
+ }): InscriptionSuccessResponse;
114
+ /**
115
+ * Block attributes for HashLink rendering
116
+ */
117
+ interface BlockAttributes {
118
+ /** Display name */
119
+ name?: string;
120
+ /** Description text */
121
+ description?: string;
122
+ /** Image URL */
123
+ image?: string;
124
+ /** Content type */
125
+ contentType?: string;
126
+ /** Size in bytes */
127
+ size?: number;
128
+ /** Custom metadata */
129
+ metadata?: Record<string, string | number | boolean>;
130
+ }
131
+ /**
132
+ * Transfer details in cost breakdown
133
+ */
134
+ interface TransferDetails {
135
+ to: string;
136
+ amount: string;
137
+ description: string;
138
+ }
139
+ /**
140
+ * Cost breakdown details for inscription quote
141
+ */
142
+ interface CostBreakdown {
143
+ transfers: TransferDetails[];
144
+ baseFee?: number;
145
+ sizeFee?: number;
146
+ networkFee?: number;
147
+ serviceFee?: number;
148
+ totalFee?: number;
149
+ currency?: string;
150
+ }
151
+ /**
152
+ * Helper function to create a quote response
153
+ */
154
+ export declare function createInscriptionQuote(params: {
155
+ totalCostHbar: string;
156
+ validUntil: string;
157
+ breakdown?: CostBreakdown;
158
+ content: {
159
+ name?: string;
160
+ creator?: string;
161
+ type?: string;
162
+ };
163
+ }): InscriptionQuoteResponse;
164
+ /**
165
+ * Helper function to create an error response
166
+ */
167
+ export declare function createInscriptionError(params: {
168
+ code: string;
169
+ details: string;
170
+ suggestions?: string[];
171
+ }): InscriptionErrorResponse;
172
+ export {};
@@ -122,4 +122,4 @@ export declare const hip412MetadataSchema: z.ZodObject<{
122
122
  /**
123
123
  * Validates metadata against HIP-412 standard
124
124
  */
125
- export declare function validateHIP412Metadata(metadata: any): z.infer<typeof hip412MetadataSchema>;
125
+ export declare function validateHIP412Metadata(metadata: unknown): z.infer<typeof hip412MetadataSchema>;