@hashgraphonline/standards-agent-kit 0.2.127 → 0.2.129

package/dist/es/tools/inscriber/InscribeHashinalTool.d.ts

@@ -5,11 +5,15 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  * Schema for inscribing Hashinal NFT
  */
 declare const inscribeHashinalSchema: z.ZodObject<{
-    url: z.ZodString;
-    name: z.ZodString;
-    creator: z.ZodString;
-    description: z.ZodString;
-    type: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    contentRef: z.ZodOptional<z.ZodString>;
+    base64Data: z.ZodOptional<z.ZodString>;
+    fileName: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    creator: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
     attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
         trait_type: z.ZodString;
         value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -22,6 +26,7 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     }>, "many">>;
     properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     jsonFileURL: z.ZodOptional<z.ZodString>;
+    fileStandard: z.ZodDefault<z.ZodOptional<z.ZodEnum<["1", "6"]>>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     chunkSize: z.ZodOptional<z.ZodNumber>;
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
@@ -29,41 +34,51 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;
     quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    url: string;
-    type: string;
-    name: string;
-    description: string;
-    creator: string;
     quoteOnly: boolean;
+    fileStandard: "1" | "6";
+    url?: string | undefined;
+    type?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     tags?: string[] | undefined;
+    creator?: string | undefined;
     properties?: Record<string, unknown> | undefined;
+    mimeType?: string | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
+    fileName?: string | undefined;
+    base64Data?: string | undefined;
     attributes?: {
         value: string | number;
         trait_type: string;
     }[] | undefined;
+    contentRef?: string | undefined;
     jsonFileURL?: string | undefined;
 }, {
-    url: string;
-    type: string;
-    name: string;
-    description: string;
-    creator: string;
+    url?: string | undefined;
+    type?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
     tags?: string[] | undefined;
+    creator?: string | undefined;
     properties?: Record<string, unknown> | undefined;
+    mimeType?: string | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
     quoteOnly?: boolean | undefined;
+    fileName?: string | undefined;
+    base64Data?: string | undefined;
     attributes?: {
         value: string | number;
         trait_type: string;
     }[] | undefined;
+    contentRef?: string | undefined;
     jsonFileURL?: string | undefined;
+    fileStandard?: "1" | "6" | undefined;
 }>;
 /**
  * Tool for inscribing Hashinal NFTs
@@ -72,11 +87,15 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
     name: string;
     description: string;
     get specificInputSchema(): z.ZodObject<{
-        url: z.ZodString;
-        name: z.ZodString;
-        creator: z.ZodString;
-        description: z.ZodString;
-        type: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        contentRef: z.ZodOptional<z.ZodString>;
+        base64Data: z.ZodOptional<z.ZodString>;
+        fileName: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        creator: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
         attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
             trait_type: z.ZodString;
             value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -89,6 +108,7 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         }>, "many">>;
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         jsonFileURL: z.ZodOptional<z.ZodString>;
+        fileStandard: z.ZodDefault<z.ZodOptional<z.ZodEnum<["1", "6"]>>>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         chunkSize: z.ZodOptional<z.ZodNumber>;
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
@@ -96,42 +116,54 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         apiKey: z.ZodOptional<z.ZodString>;
         quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
-        url: string;
-        type: string;
-        name: string;
-        description: string;
-        creator: string;
         quoteOnly: boolean;
+        fileStandard: "1" | "6";
+        url?: string | undefined;
+        type?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
         tags?: string[] | undefined;
+        creator?: string | undefined;
         properties?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
         apiKey?: string | undefined;
+        fileName?: string | undefined;
+        base64Data?: string | undefined;
         attributes?: {
             value: string | number;
             trait_type: string;
         }[] | undefined;
+        contentRef?: string | undefined;
         jsonFileURL?: string | undefined;
     }, {
-        url: string;
-        type: string;
-        name: string;
-        description: string;
-        creator: string;
+        url?: string | undefined;
+        type?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
         tags?: string[] | undefined;
+        creator?: string | undefined;
         properties?: Record<string, unknown> | undefined;
+        mimeType?: string | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
         apiKey?: string | undefined;
         quoteOnly?: boolean | undefined;
+        fileName?: string | undefined;
+        base64Data?: string | undefined;
         attributes?: {
             value: string | number;
             trait_type: string;
         }[] | undefined;
+        contentRef?: string | undefined;
         jsonFileURL?: string | undefined;
+        fileStandard?: "1" | "6" | undefined;
     }>;
     protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
+    private resolveContent;
+    private handleDirectContent;
 }
 export {};

package/dist/es/utils/content-resolver.d.ts

@@ -0,0 +1,10 @@
+export interface ContentResolutionResult {
+    buffer: Buffer;
+    mimeType?: string;
+    fileName?: string;
+    wasReference?: boolean;
+}
+/**
+ * Resolves content from various input formats (content-ref, base64, plain text)
+ */
+export declare function resolveContent(input: string, providedMimeType?: string, providedFileName?: string): Promise<ContentResolutionResult>;

package/dist/es/utils/metadata-defaults.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generates default metadata for NFT inscription
+ */
+export declare function generateDefaultMetadata(params: {
+    name?: string;
+    creator?: string;
+    description?: string;
+    type?: string;
+    fileName?: string;
+    mimeType?: string;
+    operatorAccount: string;
+}): {
+    name: string;
+    creator: string;
+    description: string;
+    type: string;
+    image: string;
+};

package/dist/es/validation/content-ref-schemas.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Validates content reference format
+ */
+export declare const contentRefSchema: z.ZodString;
+/**
+ * Validates content reference or returns error for dumber models
+ */
+export declare function validateContentRef(input: string): string;

package/dist/es/validation/hip412-schemas.d.ts

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+/**
+ * HIP-412 file schema for multi-file NFTs
+ */
+export declare const hip412FileSchema: z.ZodObject<{
+    uri: z.ZodString;
+    checksum: z.ZodOptional<z.ZodString>;
+    is_default_file: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    uri: string;
+    checksum?: string | undefined;
+    is_default_file?: boolean | undefined;
+}, {
+    type: string;
+    uri: string;
+    checksum?: string | undefined;
+    is_default_file?: boolean | undefined;
+}>;
+/**
+ * HIP-412 attribute schema for NFT traits
+ */
+export declare const hip412AttributeSchema: z.ZodObject<{
+    trait_type: z.ZodString;
+    value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    display_type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string | number;
+    trait_type: string;
+    display_type?: string | undefined;
+}, {
+    value: string | number;
+    trait_type: string;
+    display_type?: string | undefined;
+}>;
+/**
+ * HIP-412 compliant metadata schema for Hedera NFTs
+ */
+export declare const hip412MetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    image: z.ZodString;
+    type: z.ZodString;
+    creator: z.ZodOptional<z.ZodString>;
+    creatorDID: z.ZodOptional<z.ZodString>;
+    checksum: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        checksum: z.ZodOptional<z.ZodString>;
+        is_default_file: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        uri: string;
+        checksum?: string | undefined;
+        is_default_file?: boolean | undefined;
+    }, {
+        type: string;
+        uri: string;
+        checksum?: string | undefined;
+        is_default_file?: boolean | undefined;
+    }>, "many">>;
+    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        trait_type: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number;
+        trait_type: string;
+        display_type?: string | undefined;
+    }, {
+        value: string | number;
+        trait_type: string;
+        display_type?: string | undefined;
+    }>, "many">>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    image: string;
+    name: string;
+    description: string;
+    format: string;
+    creator?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+    checksum?: string | undefined;
+    creatorDID?: string | undefined;
+    files?: {
+        type: string;
+        uri: string;
+        checksum?: string | undefined;
+        is_default_file?: boolean | undefined;
+    }[] | undefined;
+    attributes?: {
+        value: string | number;
+        trait_type: string;
+        display_type?: string | undefined;
+    }[] | undefined;
+}, {
+    type: string;
+    image: string;
+    name: string;
+    description: string;
+    creator?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+    checksum?: string | undefined;
+    creatorDID?: string | undefined;
+    format?: string | undefined;
+    files?: {
+        type: string;
+        uri: string;
+        checksum?: string | undefined;
+        is_default_file?: boolean | undefined;
+    }[] | undefined;
+    attributes?: {
+        value: string | number;
+        trait_type: string;
+        display_type?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Validates metadata against HIP-412 standard
+ */
+export declare function validateHIP412Metadata(metadata: any): z.infer<typeof hip412MetadataSchema>;