@hashgraphonline/standards-agent-kit 0.2.127 → 0.2.129

package/dist/es/standards-agent-kit.es37.js

@@ -1,11 +1,31 @@
 import { z } from "zod";
 import { BaseInscriberQueryTool } from "./standards-agent-kit.es33.js";
+import { ContentResolverRegistry } from "@hashgraphonline/standards-sdk";
+import { validateHIP412Metadata } from "./standards-agent-kit.es46.js";
+import { contentRefSchema } from "./standards-agent-kit.es45.js";
+import { generateDefaultMetadata } from "./standards-agent-kit.es47.js";
 const inscribeHashinalSchema = z.object({
-  url: z.string().url().describe("The URL of the content to inscribe as Hashinal NFT"),
-  name: z.string().describe("Name of the Hashinal NFT"),
-  creator: z.string().describe("Creator account ID or name"),
-  description: z.string().describe("Description of the Hashinal NFT"),
-  type: z.string().describe('Type of NFT (e.g., "image", "video", "audio")'),
+  url: z.string().optional().describe(
+    "The URL of the content to inscribe as Hashinal NFT (use this OR contentRef)"
+  ),
+  contentRef: contentRefSchema.optional().describe(
+    'Content reference ID in format "content-ref:[id]" for already stored content (use this OR url)'
+  ),
+  base64Data: z.string().optional().describe(
+    "Base64 encoded content data (use this if neither url nor contentRef provided)"
+  ),
+  fileName: z.string().optional().describe(
+    "File name for the content (required when using base64Data or contentRef)"
+  ),
+  mimeType: z.string().optional().describe('MIME type of the content (e.g., "image/png", "image/jpeg")'),
+  name: z.string().optional().describe(
+    "Name of the Hashinal NFT (defaults to filename if not provided)"
+  ),
+  creator: z.string().optional().describe("Creator account ID or name (defaults to operator account)"),
+  description: z.string().optional().describe(
+    "Description of the Hashinal NFT (auto-generated if not provided)"
+  ),
+  type: z.string().optional().describe("Type of NFT (auto-detected from MIME type if not provided)"),
   attributes: z.array(
     z.object({
       trait_type: z.string(),
@@ -14,35 +34,61 @@ const inscribeHashinalSchema = z.object({
   ).optional().describe("NFT attributes"),
   properties: z.record(z.unknown()).optional().describe("Additional properties"),
   jsonFileURL: z.string().url().optional().describe("URL to JSON metadata file"),
+  fileStandard: z.enum(["1", "6"]).optional().default("1").describe(
+    "HCS file standard: 1 for static Hashinals (HCS-5), 6 for dynamic Hashinals (HCS-6)"
+  ),
   tags: z.array(z.string()).optional().describe("Tags to categorize the NFT"),
   chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
   waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
-  timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds for inscription (default: no timeout - waits until completion)"),
+  timeoutMs: z.number().int().positive().optional().describe(
+    "Timeout in milliseconds for inscription (default: no timeout - waits until completion)"
+  ),
   apiKey: z.string().optional().describe("API key for inscription service"),
-  quoteOnly: z.boolean().optional().default(false).describe("If true, returns a cost quote instead of executing the inscription")
+  quoteOnly: z.boolean().optional().default(false).describe(
+    "If true, returns a cost quote instead of executing the inscription"
+  )
 });
 class InscribeHashinalTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeHashinal";
-    this.description = "Inscribe content as a Hashinal NFT on the Hedera network. Set quoteOnly=true to get cost estimates without executing the inscription.";
+    this.description = "STEP 1: Inscribe content as Hashinal NFT. This tool creates the inscription and returns metadataForMinting (HRL format). CRITICAL: You MUST use the metadataForMinting field from this tool output as the metadata parameter when calling mint NFT tools. DO NOT use the original content reference for minting. This tool only inscribes - call minting tools separately after this completes. Use fileStandard=6 for dynamic Hashinals (HCS-6) or fileStandard=1 for static Hashinals (HCS-5).";
   }
   get specificInputSchema() {
     return inscribeHashinalSchema;
   }
   async executeQuery(params, _runManager) {
-    const metadata = {
-      name: params.name,
-      creator: params.creator,
-      description: params.description,
-      type: params.type,
+    if (!params.url && !params.contentRef && !params.base64Data) {
+      throw new Error(
+        "Must provide either url, contentRef, or base64Data for the Hashinal NFT content"
+      );
+    }
+    const operatorAccount = this.inscriberBuilder["hederaKit"]?.client?.operatorAccountId?.toString() || "0.0.unknown";
+    const rawMetadata = {
+      ...generateDefaultMetadata({
+        name: params.name,
+        creator: params.creator,
+        description: params.description,
+        type: params.type,
+        fileName: params.fileName,
+        mimeType: params.mimeType,
+        operatorAccount
+      }),
       attributes: params.attributes,
       properties: params.properties
     };
+    let validatedMetadata;
+    try {
+      validatedMetadata = validateHIP412Metadata(rawMetadata);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Metadata validation error: ${errorMessage}`);
+    }
     const options = {
       mode: "hashinal",
-      metadata,
+      metadata: validatedMetadata,
       jsonFileURL: params.jsonFileURL,
+      fileStandard: params.fileStandard,
       tags: params.tags,
       chunkSize: params.chunkSize,
       waitForConfirmation: params.quoteOnly ? false : params.waitForConfirmation ?? true,
@@ -52,10 +98,27 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
       network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet",
       quoteOnly: params.quoteOnly
     };
+    let inscriptionData;
+    if (params.url) {
+      inscriptionData = { type: "url", url: params.url };
+    } else if (params.contentRef || params.base64Data) {
+      const inputData = params.contentRef || params.base64Data || "";
+      const { buffer, mimeType, fileName } = await this.resolveContent(
+        inputData,
+        params.mimeType,
+        params.fileName
+      );
+      inscriptionData = {
+        type: "buffer",
+        buffer,
+        fileName: fileName || params.fileName || "hashinal-content",
+        mimeType: mimeType || params.mimeType
+      };
+    }
     if (params.quoteOnly) {
       try {
         const quote = await this.generateInscriptionQuote(
-          { type: "url", url: params.url },
+          inscriptionData,
           options
         );
         return {
@@ -85,34 +148,41 @@ Total cost: ${quote.totalCostHbar} HBAR`
       if (params.timeoutMs) {
         const timeoutPromise = new Promise((_, reject) => {
           setTimeout(
-            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
+            () => reject(
+              new Error(`Inscription timed out after ${params.timeoutMs}ms`)
+            ),
             params.timeoutMs
           );
         });
         result = await Promise.race([
-          this.inscriberBuilder.inscribe(
-            { type: "url", url: params.url },
-            options
-          ),
+          this.inscriberBuilder.inscribe(inscriptionData, options),
           timeoutPromise
         ]);
       } else {
-        result = await this.inscriberBuilder.inscribe(
-          { type: "url", url: params.url },
-          options
-        );
+        result = await this.inscriberBuilder.inscribe(inscriptionData, options);
       }
       if (result.confirmed && !result.quote) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
+        const imageTopicId = result.inscription?.topic_id;
+        const jsonTopicId = result.inscription?.jsonTopicId;
         const network = options.network || "testnet";
-        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
-        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!
-
-Transaction ID: ${result.result.transactionId}
-Topic ID: ${topicId || "N/A"}${cdnUrl ? `
-View inscription: ${cdnUrl}` : ""}
-
-The Hashinal NFT is now available.`;
+        const cdnUrl = jsonTopicId ? `https://kiloscribe.com/api/inscription-cdn/${jsonTopicId}?network=${network}` : null;
+        const fileStandard = params.fileStandard || "1";
+        const hrl = jsonTopicId ? `hcs://${fileStandard}/${jsonTopicId}` : null;
+        const standardType = fileStandard === "6" ? "Dynamic" : "Static";
+        return {
+          success: true,
+          transactionId: result.result.transactionId,
+          imageTopicId: imageTopicId || "N/A",
+          jsonTopicId: jsonTopicId || "N/A",
+          metadataForMinting: hrl,
+          hcsStandard: `hcs://${fileStandard}`,
+          fileStandard,
+          standardType,
+          message: `STEP 1 COMPLETE: ${standardType} Hashinal inscription finished! NOW FOR STEP 2: Use EXACTLY this metadata for minting: "${hrl}". DO NOT use the original content reference.`,
+          cdnUrl,
+          NEXT_STEP_INSTRUCTIONS: `Call mint NFT tool with metadata: ["${hrl}"]`,
+          WARNING: "DO NOT use content-ref for minting - only use the metadataForMinting value above"
+        };
       } else if (!result.quote && !result.confirmed) {
         return `Successfully submitted Hashinal NFT inscription to the Hedera network!
 
@@ -127,6 +197,62 @@ The inscription is processing and will be confirmed shortly.`;
       throw new Error(`Inscription failed: ${errorMessage}`);
     }
   }
+  async resolveContent(input, providedMimeType, providedFileName) {
+    const trimmedInput = input.trim();
+    const resolver = this.getContentResolver() || ContentResolverRegistry.getResolver();
+    if (!resolver) {
+      return this.handleDirectContent(
+        trimmedInput,
+        providedMimeType,
+        providedFileName
+      );
+    }
+    const referenceId = resolver.extractReferenceId(trimmedInput);
+    if (referenceId) {
+      try {
+        const resolution = await resolver.resolveReference(referenceId);
+        return {
+          buffer: resolution.content,
+          mimeType: resolution.metadata?.mimeType || providedMimeType,
+          fileName: resolution.metadata?.fileName || providedFileName,
+          wasReference: true
+        };
+      } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : "Unknown error resolving reference";
+        throw new Error(`Reference resolution failed: ${errorMsg}`);
+      }
+    }
+    return this.handleDirectContent(
+      trimmedInput,
+      providedMimeType,
+      providedFileName
+    );
+  }
+  handleDirectContent(input, providedMimeType, providedFileName) {
+    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);
+    if (isValidBase64) {
+      try {
+        const buffer2 = Buffer.from(input, "base64");
+        return {
+          buffer: buffer2,
+          mimeType: providedMimeType,
+          fileName: providedFileName,
+          wasReference: false
+        };
+      } catch (error) {
+        throw new Error(
+          "Failed to decode base64 data. Please ensure the data is properly encoded."
+        );
+      }
+    }
+    const buffer = Buffer.from(input, "utf8");
+    return {
+      buffer,
+      mimeType: providedMimeType || "text/plain",
+      fileName: providedFileName,
+      wasReference: false
+    };
+  }
 }
 export {
   InscribeHashinalTool

package/dist/es/standards-agent-kit.es37.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es37.js","sources":["../../src/tools/inscriber/InscribeHashinalTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseInscriberQueryTool } from './base-inscriber-tools';\nimport { InscriptionOptions } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/**\n * Schema for inscribing Hashinal NFT\n */\nconst inscribeHashinalSchema = z.object({\n  url: z.string().url().describe('The URL of the content to inscribe as Hashinal NFT'),\n  name: z.string().describe('Name of the Hashinal NFT'),\n  creator: z.string().describe('Creator account ID or name'),\n  description: z.string().describe('Description of the Hashinal NFT'),\n  type: z.string().describe('Type of NFT (e.g., \"image\", \"video\", \"audio\")'),\n  attributes: z\n    .array(\n      z.object({\n        trait_type: z.string(),\n        value: z.union([z.string(), z.number()]),\n      })\n    )\n    .optional()\n    .describe('NFT attributes'),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Additional properties'),\n  jsonFileURL: z\n    .string()\n    .url()\n    .optional()\n    .describe('URL to JSON metadata file'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the NFT'),\n  chunkSize: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Chunk size for large files'),\n  waitForConfirmation: z\n    .boolean()\n    .optional()\n    .describe('Whether to wait for inscription confirmation'),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),\n  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n  quoteOnly: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe('If true, returns a cost quote instead of executing the inscription'),\n});\n\n\n/**\n * Tool for inscribing Hashinal NFTs\n */\nexport class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribeHashinalSchema> {\n  name = 'inscribeHashinal';\n  description = 'Inscribe content as a Hashinal NFT on the Hedera network. Set quoteOnly=true to get cost estimates without executing the inscription.';\n\n  get specificInputSchema() {\n    return inscribeHashinalSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeHashinalSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    const metadata = {\n      name: params.name,\n      creator: params.creator,\n      description: params.description,\n      type: params.type,\n      attributes: params.attributes,\n      properties: params.properties,\n    };\n\n    const options: InscriptionOptions = {\n      mode: 'hashinal',\n      metadata,\n      jsonFileURL: params.jsonFileURL,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.quoteOnly ? false : (params.waitForConfirmation ?? true),\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',\n      quoteOnly: params.quoteOnly,\n    };\n\n    if (params.quoteOnly) {\n      try {\n        const quote = await this.generateInscriptionQuote(\n          { type: 'url', url: params.url },\n          options\n        );\n        \n        return {\n          success: true,\n          quote: {\n            totalCostHbar: quote.totalCostHbar,\n            validUntil: quote.validUntil,\n            breakdown: quote.breakdown,\n          },\n          contentInfo: {\n            url: params.url,\n            name: params.name,\n            creator: params.creator,\n            type: params.type,\n          },\n          message: `Estimated Quote for Hashinal NFT: ${params.name}\\nCreator: ${params.creator}\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : 'Failed to generate inscription quote';\n        throw new Error(`Quote generation failed: ${errorMessage}`);\n      }\n    }\n\n    try {\n      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n            params.timeoutMs\n          );\n        });\n\n        result = await Promise.race([\n          this.inscriberBuilder.inscribe(\n            { type: 'url', url: params.url },\n            options\n          ),\n          timeoutPromise\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          { type: 'url', url: params.url },\n          options\n        );\n      }\n\n      if (result.confirmed && !result.quote) {\n        const topicId = result.inscription?.topic_id || (result.result as any).topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;\n        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!\\n\\nTransaction ID: ${(result.result as any).transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe Hashinal NFT is now available.`;\n      } else if (!result.quote && !result.confirmed) {\n        return `Successfully submitted Hashinal NFT inscription to the Hedera network!\\n\\nTransaction ID: ${(result.result as any).transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      } else {\n        return 'Inscription operation completed.';\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe Hashinal NFT';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es37.js","sources":["../../src/tools/inscriber/InscribeHashinalTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseInscriberQueryTool } from './base-inscriber-tools';\nimport {\n  InscriptionOptions,\n  ContentResolverRegistry,\n} from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport { validateHIP412Metadata } from '../../validation/hip412-schemas';\nimport { contentRefSchema } from '../../validation/content-ref-schemas';\nimport { generateDefaultMetadata } from '../../utils/metadata-defaults';\n\n\n/**\n * Schema for inscribing Hashinal NFT\n */\nconst inscribeHashinalSchema = z.object({\n  url: z\n    .string()\n    .optional()\n    .describe(\n      'The URL of the content to inscribe as Hashinal NFT (use this OR contentRef)'\n    ),\n  contentRef: contentRefSchema\n    .optional()\n    .describe(\n      'Content reference ID in format \"content-ref:[id]\" for already stored content (use this OR url)'\n    ),\n  base64Data: z\n    .string()\n    .optional()\n    .describe(\n      'Base64 encoded content data (use this if neither url nor contentRef provided)'\n    ),\n  fileName: z\n    .string()\n    .optional()\n    .describe(\n      'File name for the content (required when using base64Data or contentRef)'\n    ),\n  mimeType: z\n    .string()\n    .optional()\n    .describe('MIME type of the content (e.g., \"image/png\", \"image/jpeg\")'),\n  name: z\n    .string()\n    .optional()\n    .describe(\n      'Name of the Hashinal NFT (defaults to filename if not provided)'\n    ),\n  creator: z\n    .string()\n    .optional()\n    .describe('Creator account ID or name (defaults to operator account)'),\n  description: z\n    .string()\n    .optional()\n    .describe(\n      'Description of the Hashinal NFT (auto-generated if not provided)'\n    ),\n  type: z\n    .string()\n    .optional()\n    .describe('Type of NFT (auto-detected from MIME type if not provided)'),\n  attributes: z\n    .array(\n      z.object({\n        trait_type: z.string(),\n        value: z.union([z.string(), z.number()]),\n      })\n    )\n    .optional()\n    .describe('NFT attributes'),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Additional properties'),\n  jsonFileURL: z\n    .string()\n    .url()\n    .optional()\n    .describe('URL to JSON metadata file'),\n  fileStandard: z\n    .enum(['1', '6'])\n    .optional()\n    .default('1')\n    .describe(\n      'HCS file standard: 1 for static Hashinals (HCS-5), 6 for dynamic Hashinals (HCS-6)'\n    ),\n  tags: z.array(z.string()).optional().describe('Tags to categorize the NFT'),\n  chunkSize: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Chunk size for large files'),\n  waitForConfirmation: z\n    .boolean()\n    .optional()\n    .describe('Whether to wait for inscription confirmation'),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'Timeout in milliseconds for inscription (default: no timeout - waits until completion)'\n    ),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n  quoteOnly: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      'If true, returns a cost quote instead of executing the inscription'\n    ),\n});\n\n/**\n * Tool for inscribing Hashinal NFTs\n */\nexport class InscribeHashinalTool extends BaseInscriberQueryTool<\n  typeof inscribeHashinalSchema\n> {\n  name = 'inscribeHashinal';\n  description =\n    'STEP 1: Inscribe content as Hashinal NFT. This tool creates the inscription and returns metadataForMinting (HRL format). CRITICAL: You MUST use the metadataForMinting field from this tool output as the metadata parameter when calling mint NFT tools. DO NOT use the original content reference for minting. This tool only inscribes - call minting tools separately after this completes. Use fileStandard=6 for dynamic Hashinals (HCS-6) or fileStandard=1 for static Hashinals (HCS-5).';\n\n  get specificInputSchema() {\n    return inscribeHashinalSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeHashinalSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    // Validate input - must have either url, contentRef, or base64Data\n    if (!params.url && !params.contentRef && !params.base64Data) {\n      throw new Error(\n        'Must provide either url, contentRef, or base64Data for the Hashinal NFT content'\n      );\n    }\n\n    const operatorAccount =\n      this.inscriberBuilder['hederaKit']?.client?.operatorAccountId?.toString() || '0.0.unknown';\n\n    const rawMetadata = {\n      ...generateDefaultMetadata({\n        name: params.name,\n        creator: params.creator,\n        description: params.description,\n        type: params.type,\n        fileName: params.fileName,\n        mimeType: params.mimeType,\n        operatorAccount,\n      }),\n      attributes: params.attributes,\n      properties: params.properties,\n    };\n\n    // Validate metadata against HIP-412 standard\n    let validatedMetadata;\n    try {\n      validatedMetadata = validateHIP412Metadata(rawMetadata);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      throw new Error(`Metadata validation error: ${errorMessage}`);\n    }\n\n    const options: InscriptionOptions = {\n      mode: 'hashinal',\n      metadata: validatedMetadata,\n      jsonFileURL: params.jsonFileURL,\n      fileStandard: params.fileStandard,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.quoteOnly\n        ? false\n        : params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : 'testnet',\n      quoteOnly: params.quoteOnly,\n    };\n\n    // Determine inscription data based on input type\n    let inscriptionData: any;\n\n    if (params.url) {\n      inscriptionData = { type: 'url', url: params.url };\n    } else if (params.contentRef || params.base64Data) {\n      // Handle content reference or base64 data\n      const inputData = params.contentRef || params.base64Data || '';\n      const { buffer, mimeType, fileName } = await this.resolveContent(\n        inputData,\n        params.mimeType,\n        params.fileName\n      );\n\n      inscriptionData = {\n        type: 'buffer' as const,\n        buffer,\n        fileName: fileName || params.fileName || 'hashinal-content',\n        mimeType: mimeType || params.mimeType,\n      };\n    }\n\n    if (params.quoteOnly) {\n      try {\n        const quote = await this.generateInscriptionQuote(\n          inscriptionData,\n          options\n        );\n\n        return {\n          success: true,\n          quote: {\n            totalCostHbar: quote.totalCostHbar,\n            validUntil: quote.validUntil,\n            breakdown: quote.breakdown,\n          },\n          contentInfo: {\n            url: params.url,\n            name: params.name,\n            creator: params.creator,\n            type: params.type,\n          },\n          message: `Estimated Quote for Hashinal NFT: ${params.name}\\nCreator: ${params.creator}\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error\n            ? error.message\n            : 'Failed to generate inscription quote';\n        throw new Error(`Quote generation failed: ${errorMessage}`);\n      }\n    }\n\n    try {\n      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n\n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () =>\n              reject(\n                new Error(`Inscription timed out after ${params.timeoutMs}ms`)\n              ),\n            params.timeoutMs\n          );\n        });\n\n        result = await Promise.race([\n          this.inscriberBuilder.inscribe(inscriptionData, options),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(inscriptionData, options);\n      }\n\n      if (result.confirmed && !result.quote) {\n        const imageTopicId = result.inscription?.topic_id;\n        const jsonTopicId = result.inscription?.jsonTopicId;\n        const network = options.network || 'testnet';\n\n        const cdnUrl = jsonTopicId\n          ? `https://kiloscribe.com/api/inscription-cdn/${jsonTopicId}?network=${network}`\n          : null;\n\n        const fileStandard = params.fileStandard || '1';\n        const hrl = jsonTopicId ? `hcs://${fileStandard}/${jsonTopicId}` : null;\n        const standardType = fileStandard === '6' ? 'Dynamic' : 'Static';\n\n        return {\n          success: true,\n          transactionId: (result.result as any).transactionId,\n          imageTopicId: imageTopicId || 'N/A',\n          jsonTopicId: jsonTopicId || 'N/A',\n          metadataForMinting: hrl,\n          hcsStandard: `hcs://${fileStandard}`,\n          fileStandard: fileStandard,\n          standardType: standardType,\n          message: `STEP 1 COMPLETE: ${standardType} Hashinal inscription finished! NOW FOR STEP 2: Use EXACTLY this metadata for minting: \"${hrl}\". DO NOT use the original content reference.`,\n          cdnUrl: cdnUrl,\n          NEXT_STEP_INSTRUCTIONS: `Call mint NFT tool with metadata: [\"${hrl}\"]`,\n          WARNING:\n            'DO NOT use content-ref for minting - only use the metadataForMinting value above',\n        };\n      } else if (!result.quote && !result.confirmed) {\n        return `Successfully submitted Hashinal NFT inscription to the Hedera network!\\n\\nTransaction ID: ${\n          (result.result as any).transactionId\n        }\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      } else {\n        return 'Inscription operation completed.';\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error\n          ? error.message\n          : 'Failed to inscribe Hashinal NFT';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private async resolveContent(\n    input: string,\n    providedMimeType?: string,\n    providedFileName?: string\n  ): Promise<{\n    buffer: Buffer;\n    mimeType?: string;\n    fileName?: string;\n    wasReference?: boolean;\n  }> {\n    const trimmedInput = input.trim();\n\n    const resolver =\n      this.getContentResolver() || ContentResolverRegistry.getResolver();\n\n    if (!resolver) {\n      return this.handleDirectContent(\n        trimmedInput,\n        providedMimeType,\n        providedFileName\n      );\n    }\n\n    const referenceId = resolver.extractReferenceId(trimmedInput);\n\n    if (referenceId) {\n      try {\n        const resolution = await resolver.resolveReference(referenceId);\n\n        return {\n          buffer: resolution.content,\n          mimeType: resolution.metadata?.mimeType || providedMimeType,\n          fileName: resolution.metadata?.fileName || providedFileName,\n          wasReference: true,\n        };\n      } catch (error) {\n        const errorMsg =\n          error instanceof Error\n            ? error.message\n            : 'Unknown error resolving reference';\n        throw new Error(`Reference resolution failed: ${errorMsg}`);\n      }\n    }\n\n    return this.handleDirectContent(\n      trimmedInput,\n      providedMimeType,\n      providedFileName\n    );\n  }\n\n  private handleDirectContent(\n    input: string,\n    providedMimeType?: string,\n    providedFileName?: string\n  ): {\n    buffer: Buffer;\n    mimeType?: string;\n    fileName?: string;\n    wasReference?: boolean;\n  } {\n    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);\n\n    if (isValidBase64) {\n      try {\n        const buffer = Buffer.from(input, 'base64');\n        return {\n          buffer,\n          mimeType: providedMimeType,\n          fileName: providedFileName,\n          wasReference: false,\n        };\n      } catch (error) {\n        throw new Error(\n          'Failed to decode base64 data. Please ensure the data is properly encoded.'\n        );\n      }\n    }\n\n    const buffer = Buffer.from(input, 'utf8');\n    return {\n      buffer,\n      mimeType: providedMimeType || 'text/plain',\n      fileName: providedFileName,\n      wasReference: false,\n    };\n  }\n}\n"],"names":["buffer"],"mappings":"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"}

package/dist/es/standards-agent-kit.es44.js

@@ -0,0 +1,57 @@
+import { ContentResolverRegistry } from "@hashgraphonline/standards-sdk";
+async function resolveContent(input, providedMimeType, providedFileName) {
+  const trimmedInput = input.trim();
+  const resolver = ContentResolverRegistry.getResolver();
+  if (!resolver) {
+    return handleDirectContent(
+      trimmedInput,
+      providedMimeType,
+      providedFileName
+    );
+  }
+  const referenceId = resolver.extractReferenceId(trimmedInput);
+  if (referenceId) {
+    try {
+      const resolution = await resolver.resolveReference(referenceId);
+      return {
+        buffer: resolution.content,
+        mimeType: resolution.metadata?.mimeType || providedMimeType,
+        fileName: resolution.metadata?.fileName || providedFileName,
+        wasReference: true
+      };
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : "Unknown error resolving reference";
+      throw new Error(`Reference resolution failed: ${errorMsg}`);
+    }
+  }
+  return handleDirectContent(trimmedInput, providedMimeType, providedFileName);
+}
+function handleDirectContent(input, providedMimeType, providedFileName) {
+  const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);
+  if (isValidBase64) {
+    try {
+      const buffer2 = Buffer.from(input, "base64");
+      return {
+        buffer: buffer2,
+        mimeType: providedMimeType,
+        fileName: providedFileName,
+        wasReference: false
+      };
+    } catch (error) {
+      throw new Error(
+        "Failed to decode base64 data. Please ensure the data is properly encoded."
+      );
+    }
+  }
+  const buffer = Buffer.from(input, "utf8");
+  return {
+    buffer,
+    mimeType: providedMimeType || "text/plain",
+    fileName: providedFileName,
+    wasReference: false
+  };
+}
+export {
+  resolveContent
+};
+//# sourceMappingURL=standards-agent-kit.es44.js.map

package/dist/es/standards-agent-kit.es44.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-agent-kit.es44.js","sources":["../../src/utils/content-resolver.ts"],"sourcesContent":["import { ContentResolverRegistry } from '@hashgraphonline/standards-sdk';\n\nexport interface ContentResolutionResult {\n  buffer: Buffer;\n  mimeType?: string;\n  fileName?: string;\n  wasReference?: boolean;\n}\n\n/**\n * Resolves content from various input formats (content-ref, base64, plain text)\n */\nexport async function resolveContent(\n  input: string,\n  providedMimeType?: string,\n  providedFileName?: string\n): Promise<ContentResolutionResult> {\n  const trimmedInput = input.trim();\n\n  const resolver = ContentResolverRegistry.getResolver();\n\n  if (!resolver) {\n    return handleDirectContent(\n      trimmedInput,\n      providedMimeType,\n      providedFileName\n    );\n  }\n\n  const referenceId = resolver.extractReferenceId(trimmedInput);\n\n  if (referenceId) {\n    try {\n      const resolution = await resolver.resolveReference(referenceId);\n\n      return {\n        buffer: resolution.content,\n        mimeType: resolution.metadata?.mimeType || providedMimeType,\n        fileName: resolution.metadata?.fileName || providedFileName,\n        wasReference: true,\n      };\n    } catch (error) {\n      const errorMsg =\n        error instanceof Error\n          ? error.message\n          : 'Unknown error resolving reference';\n      throw new Error(`Reference resolution failed: ${errorMsg}`);\n    }\n  }\n\n  return handleDirectContent(trimmedInput, providedMimeType, providedFileName);\n}\n\n/**\n * Handles direct content (base64 or plain text)\n */\nfunction handleDirectContent(\n  input: string,\n  providedMimeType?: string,\n  providedFileName?: string\n): ContentResolutionResult {\n  const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);\n\n  if (isValidBase64) {\n    try {\n      const buffer = Buffer.from(input, 'base64');\n      return {\n        buffer,\n        mimeType: providedMimeType,\n        fileName: providedFileName,\n        wasReference: false,\n      };\n    } catch (error) {\n      throw new Error(\n        'Failed to decode base64 data. Please ensure the data is properly encoded.'\n      );\n    }\n  }\n\n  const buffer = Buffer.from(input, 'utf8');\n  return {\n    buffer,\n    mimeType: providedMimeType || 'text/plain',\n    fileName: providedFileName,\n    wasReference: false,\n  };\n}\n"],"names":["buffer"],"mappings":";AAYA,eAAsB,eACpB,OACA,kBACA,kBACkC;AAClC,QAAM,eAAe,MAAM,KAAA;AAE3B,QAAM,WAAW,wBAAwB,YAAA;AAEzC,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,cAAc,SAAS,mBAAmB,YAAY;AAE5D,MAAI,aAAa;AACf,QAAI;AACF,YAAM,aAAa,MAAM,SAAS,iBAAiB,WAAW;AAE9D,aAAO;AAAA,QACL,QAAQ,WAAW;AAAA,QACnB,UAAU,WAAW,UAAU,YAAY;AAAA,QAC3C,UAAU,WAAW,UAAU,YAAY;AAAA,QAC3C,cAAc;AAAA,MAAA;AAAA,IAElB,SAAS,OAAO;AACd,YAAM,WACJ,iBAAiB,QACb,MAAM,UACN;AACN,YAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;AAAA,IAC5D;AAAA,EACF;AAEA,SAAO,oBAAoB,cAAc,kBAAkB,gBAAgB;AAC7E;AAKA,SAAS,oBACP,OACA,kBACA,kBACyB;AACzB,QAAM,gBAAgB,yBAAyB,KAAK,KAAK;AAEzD,MAAI,eAAe;AACjB,QAAI;AACF,YAAMA,UAAS,OAAO,KAAK,OAAO,QAAQ;AAC1C,aAAO;AAAA,QACL,QAAAA;AAAAA,QACA,UAAU;AAAA,QACV,UAAU;AAAA,QACV,cAAc;AAAA,MAAA;AAAA,IAElB,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAEA,QAAM,SAAS,OAAO,KAAK,OAAO,MAAM;AACxC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,oBAAoB;AAAA,IAC9B,UAAU;AAAA,IACV,cAAc;AAAA,EAAA;AAElB;"}

package/dist/es/standards-agent-kit.es45.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+const contentRefSchema = z.string().regex(/^content-ref:[a-fA-F0-9]{64}$/, 'Content reference must be in format "content-ref:[64-char hex]"').describe('Content reference in format "content-ref:[id]"');
+export {
+  contentRefSchema
+};
+//# sourceMappingURL=standards-agent-kit.es45.js.map

package/dist/es/standards-agent-kit.es45.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-agent-kit.es45.js","sources":["../../src/validation/content-ref-schemas.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Validates content reference format\n */\nexport const contentRefSchema = z\n  .string()\n  .regex(/^content-ref:[a-fA-F0-9]{64}$/, 'Content reference must be in format \"content-ref:[64-char hex]\"')\n  .describe('Content reference in format \"content-ref:[id]\"');\n\n/**\n * Validates content reference or returns error for dumber models\n */\nexport function validateContentRef(input: string): string {\n  try {\n    return contentRefSchema.parse(input);\n  } catch (error) {\n    throw new Error(`Invalid content reference format. Expected \"content-ref:[64-character-hash]\" but got \"${input}\"`);\n  }\n}"],"names":[],"mappings":";AAKO,MAAM,mBAAmB,EAC7B,SACA,MAAM,iCAAiC,iEAAiE,EACxG,SAAS,gDAAgD;"}

package/dist/es/standards-agent-kit.es46.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+const hip412FileSchema = z.object({
+  uri: z.string().describe("URI of the file"),
+  checksum: z.string().optional().describe("SHA-256 checksum of the file"),
+  is_default_file: z.boolean().optional().describe("Whether this is the default file"),
+  type: z.string().describe("MIME type of the file")
+});
+const hip412AttributeSchema = z.object({
+  trait_type: z.string().describe("The trait type"),
+  value: z.union([z.string(), z.number()]).describe("The trait value"),
+  display_type: z.string().optional().describe("Display type for the attribute")
+});
+const hip412MetadataSchema = z.object({
+  name: z.string().describe("Token name (required by HIP-412)"),
+  description: z.string().describe("Human readable description (required by HIP-412)"),
+  image: z.string().describe("Preview image URI (required by HIP-412)"),
+  type: z.string().describe("MIME type (required by HIP-412)"),
+  creator: z.string().optional().describe("Creator name or comma-separated names"),
+  creatorDID: z.string().optional().describe("Decentralized identifier for creator"),
+  checksum: z.string().optional().describe("SHA-256 checksum of the image"),
+  format: z.string().optional().default("HIP412@2.0.0").describe("Metadata format version"),
+  files: z.array(hip412FileSchema).optional().describe("Array of files for multi-file NFTs"),
+  attributes: z.array(hip412AttributeSchema).optional().describe("NFT attributes/traits"),
+  properties: z.record(z.unknown()).optional().describe("Additional properties")
+});
+function validateHIP412Metadata(metadata) {
+  try {
+    return hip412MetadataSchema.parse(metadata);
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      const issues = error.errors.map((err) => `${err.path.join(".")}: ${err.message}`).join("; ");
+      throw new Error(`HIP-412 metadata validation failed: ${issues}`);
+    }
+    throw error;
+  }
+}
+export {
+  hip412AttributeSchema,
+  hip412FileSchema,
+  hip412MetadataSchema,
+  validateHIP412Metadata
+};
+//# sourceMappingURL=standards-agent-kit.es46.js.map

package/dist/es/standards-agent-kit.es46.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-agent-kit.es46.js","sources":["../../src/validation/hip412-schemas.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * HIP-412 file schema for multi-file NFTs\n */\nexport const hip412FileSchema = z.object({\n  uri: z.string().describe('URI of the file'),\n  checksum: z.string().optional().describe('SHA-256 checksum of the file'),\n  is_default_file: z.boolean().optional().describe('Whether this is the default file'),\n  type: z.string().describe('MIME type of the file'),\n});\n\n/**\n * HIP-412 attribute schema for NFT traits\n */\nexport const hip412AttributeSchema = z.object({\n  trait_type: z.string().describe('The trait type'),\n  value: z.union([z.string(), z.number()]).describe('The trait value'),\n  display_type: z.string().optional().describe('Display type for the attribute'),\n});\n\n/**\n * HIP-412 compliant metadata schema for Hedera NFTs\n */\nexport const hip412MetadataSchema = z.object({\n  name: z.string().describe('Token name (required by HIP-412)'),\n  description: z.string().describe('Human readable description (required by HIP-412)'),\n  image: z.string().describe('Preview image URI (required by HIP-412)'),\n  type: z.string().describe('MIME type (required by HIP-412)'),\n  creator: z.string().optional().describe('Creator name or comma-separated names'),\n  creatorDID: z.string().optional().describe('Decentralized identifier for creator'),\n  checksum: z.string().optional().describe('SHA-256 checksum of the image'),\n  format: z.string().optional().default('HIP412@2.0.0').describe('Metadata format version'),\n  files: z.array(hip412FileSchema).optional().describe('Array of files for multi-file NFTs'),\n  attributes: z.array(hip412AttributeSchema).optional().describe('NFT attributes/traits'),\n  properties: z.record(z.unknown()).optional().describe('Additional properties'),\n});\n\n/**\n * Validates metadata against HIP-412 standard\n */\nexport function validateHIP412Metadata(metadata: any): z.infer<typeof hip412MetadataSchema> {\n  try {\n    return hip412MetadataSchema.parse(metadata);\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      const issues = error.errors.map(err => `${err.path.join('.')}: ${err.message}`).join('; ');\n      throw new Error(`HIP-412 metadata validation failed: ${issues}`);\n    }\n    throw error;\n  }\n}"],"names":[],"mappings":";AAKO,MAAM,mBAAmB,EAAE,OAAO;AAAA,EACvC,KAAK,EAAE,SAAS,SAAS,iBAAiB;AAAA,EAC1C,UAAU,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,8BAA8B;AAAA,EACvE,iBAAiB,EAAE,QAAA,EAAU,SAAA,EAAW,SAAS,kCAAkC;AAAA,EACnF,MAAM,EAAE,OAAA,EAAS,SAAS,uBAAuB;AACnD,CAAC;AAKM,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,YAAY,EAAE,SAAS,SAAS,gBAAgB;AAAA,EAChD,OAAO,EAAE,MAAM,CAAC,EAAE,OAAA,GAAU,EAAE,OAAA,CAAQ,CAAC,EAAE,SAAS,iBAAiB;AAAA,EACnE,cAAc,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,gCAAgC;AAC/E,CAAC;AAKM,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,SAAS,SAAS,kCAAkC;AAAA,EAC5D,aAAa,EAAE,SAAS,SAAS,kDAAkD;AAAA,EACnF,OAAO,EAAE,SAAS,SAAS,yCAAyC;AAAA,EACpE,MAAM,EAAE,SAAS,SAAS,iCAAiC;AAAA,EAC3D,SAAS,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,uCAAuC;AAAA,EAC/E,YAAY,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,sCAAsC;AAAA,EACjF,UAAU,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,+BAA+B;AAAA,EACxE,QAAQ,EAAE,OAAA,EAAS,SAAA,EAAW,QAAQ,cAAc,EAAE,SAAS,yBAAyB;AAAA,EACxF,OAAO,EAAE,MAAM,gBAAgB,EAAE,SAAA,EAAW,SAAS,oCAAoC;AAAA,EACzF,YAAY,EAAE,MAAM,qBAAqB,EAAE,SAAA,EAAW,SAAS,uBAAuB;AAAA,EACtF,YAAY,EAAE,OAAO,EAAE,QAAA,CAAS,EAAE,WAAW,SAAS,uBAAuB;AAC/E,CAAC;AAKM,SAAS,uBAAuB,UAAqD;AAC1F,MAAI;AACF,WAAO,qBAAqB,MAAM,QAAQ;AAAA,EAC5C,SAAS,OAAO;AACd,QAAI,iBAAiB,EAAE,UAAU;AAC/B,YAAM,SAAS,MAAM,OAAO,IAAI,CAAA,QAAO,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK,IAAI,OAAO,EAAE,EAAE,KAAK,IAAI;AACzF,YAAM,IAAI,MAAM,uCAAuC,MAAM,EAAE;AAAA,IACjE;AACA,UAAM;AAAA,EACR;AACF;"}

package/dist/es/standards-agent-kit.es47.js

@@ -0,0 +1,15 @@
+function generateDefaultMetadata(params) {
+  const defaultName = params.fileName?.replace(/\.[^/.]+$/, "") || "Hashinal NFT";
+  const defaultType = params.mimeType?.startsWith("image/") ? "image" : params.mimeType?.startsWith("video/") ? "video" : params.mimeType?.startsWith("audio/") ? "audio" : "media";
+  return {
+    name: params.name || defaultName,
+    creator: params.creator || params.operatorAccount,
+    description: params.description || `${defaultType.charAt(0).toUpperCase() + defaultType.slice(1)} NFT inscribed as Hashinal`,
+    type: params.type || defaultType,
+    image: ""
+  };
+}
+export {
+  generateDefaultMetadata
+};
+//# sourceMappingURL=standards-agent-kit.es47.js.map

package/dist/es/standards-agent-kit.es47.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-agent-kit.es47.js","sources":["../../src/utils/metadata-defaults.ts"],"sourcesContent":["/**\n * Generates default metadata for NFT inscription\n */\nexport function generateDefaultMetadata(params: {\n  name?: string;\n  creator?: string;\n  description?: string;\n  type?: string;\n  fileName?: string;\n  mimeType?: string;\n  operatorAccount: string;\n}) {\n  const defaultName = params.fileName?.replace(/\\.[^/.]+$/, '') || 'Hashinal NFT';\n  const defaultType = params.mimeType?.startsWith('image/') ? 'image' : \n                      params.mimeType?.startsWith('video/') ? 'video' :\n                      params.mimeType?.startsWith('audio/') ? 'audio' : 'media';\n\n  return {\n    name: params.name || defaultName,\n    creator: params.creator || params.operatorAccount,\n    description: params.description || `${defaultType.charAt(0).toUpperCase() + defaultType.slice(1)} NFT inscribed as Hashinal`,\n    type: params.type || defaultType,\n    image: '',\n  };\n}"],"names":[],"mappings":"AAGO,SAAS,wBAAwB,QAQrC;AACD,QAAM,cAAc,OAAO,UAAU,QAAQ,aAAa,EAAE,KAAK;AACjE,QAAM,cAAc,OAAO,UAAU,WAAW,QAAQ,IAAI,UACxC,OAAO,UAAU,WAAW,QAAQ,IAAI,UACxC,OAAO,UAAU,WAAW,QAAQ,IAAI,UAAU;AAEtE,SAAO;AAAA,IACL,MAAM,OAAO,QAAQ;AAAA,IACrB,SAAS,OAAO,WAAW,OAAO;AAAA,IAClC,aAAa,OAAO,eAAe,GAAG,YAAY,OAAO,CAAC,EAAE,YAAA,IAAgB,YAAY,MAAM,CAAC,CAAC;AAAA,IAChG,MAAM,OAAO,QAAQ;AAAA,IACrB,OAAO;AAAA,EAAA;AAEX;"}

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

@@ -2,10 +2,9 @@ import { z } from 'zod';
 import { BaseInscriberQueryTool } from './base-inscriber-tools';
 import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
 declare const inscribeFromBufferSchema: z.ZodObject<{
-    base64Data: z.ZodString;
+    base64Data: z.ZodUnion<[z.ZodString, z.ZodString]>;
     fileName: z.ZodString;
     mimeType: z.ZodOptional<z.ZodString>;
-    mode: z.ZodOptional<z.ZodEnum<["file", "hashinal"]>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     chunkSize: z.ZodOptional<z.ZodNumber>;
@@ -20,7 +19,6 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
-    mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
@@ -31,7 +29,6 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
-    mode?: "file" | "hashinal" | undefined;
     chunkSize?: number | undefined;
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
@@ -43,10 +40,9 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
     description: string;
     private config;
     get specificInputSchema(): z.ZodObject<{
-        base64Data: z.ZodString;
+        base64Data: z.ZodUnion<[z.ZodString, z.ZodString]>;
         fileName: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
-        mode: z.ZodOptional<z.ZodEnum<["file", "hashinal"]>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         chunkSize: z.ZodOptional<z.ZodNumber>;
@@ -61,7 +57,6 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
-        mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
@@ -72,7 +67,6 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
-        mode?: "file" | "hashinal" | undefined;
         chunkSize?: number | undefined;
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
@@ -84,7 +78,5 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
     private validateContent;
     private executeInscription;
     private formatInscriptionResult;
-    private resolveContent;
-    private handleDirectContent;
 }
 export {};