@hashgraphonline/standards-agent-kit 0.2.109 → 0.2.112

package/dist/es/builders/hcs6/hcs6-builder.d.ts

@@ -0,0 +1,47 @@
+import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
+import { HCS6Client, HCS6CreateRegistryOptions, HCS6RegisterEntryOptions, HCS6QueryRegistryOptions, HCS6RegisterOptions, HCS6CreateHashinalOptions, HCS6TopicRegistrationResponse, HCS6RegistryOperationResponse, HCS6TopicRegistry, HCS6CreateHashinalResponse } from '@hashgraphonline/standards-sdk';
+/**
+ * Builder for HCS-6 operations that delegates to HCS6Client
+ */
+export declare class HCS6Builder extends BaseServiceBuilder {
+    protected hcs6Client?: HCS6Client;
+    constructor(hederaKit: HederaAgentKit);
+    /**
+     * Get or create HCS-6 client
+     */
+    protected getHCS6Client(): Promise<HCS6Client>;
+    /**
+     * Create a new HCS-6 dynamic registry
+     * Note: This executes the transaction directly via HCS6Client
+     */
+    createRegistry(options?: HCS6CreateRegistryOptions): Promise<HCS6TopicRegistrationResponse>;
+    /**
+     * Register a new dynamic hashinal entry in an HCS-6 registry
+     */
+    registerEntry(registryTopicId: string, options: HCS6RegisterEntryOptions): Promise<HCS6RegistryOperationResponse>;
+    /**
+     * Query entries from an HCS-6 registry
+     */
+    getRegistry(topicId: string, options?: HCS6QueryRegistryOptions): Promise<HCS6TopicRegistry>;
+    /**
+     * Create a complete dynamic hashinal with inscription and registry
+     */
+    createHashinal(options: HCS6CreateHashinalOptions): Promise<HCS6CreateHashinalResponse>;
+    /**
+     * Register a dynamic hashinal with combined inscription and registry creation
+     * This is the main method for creating and updating dynamic hashinals
+     */
+    register(options: HCS6RegisterOptions): Promise<HCS6CreateHashinalResponse>;
+    /**
+     * Submit a raw message to an HCS-6 topic
+     */
+    submitMessage(topicId: string, payload: any): Promise<any>;
+    /**
+     * Get topic info from mirror node
+     */
+    getTopicInfo(topicId: string): Promise<any>;
+    /**
+     * Close the HCS-6 client
+     */
+    close(): Promise<void>;
+}

package/dist/es/builders/hcs6/index.d.ts

@@ -0,0 +1 @@
+export * from './hcs6-builder';

package/dist/es/builders/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types';
 export * from './hcs10/hcs10-builder';
 export * from './hcs2/hcs2-builder';
+export * from './hcs6/hcs6-builder';
 export * from './inscriber/inscriber-builder';

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

@@ -13,12 +13,64 @@ class InscribeFromUrlTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeFromUrl";
-    this.description = "Inscribe content from a URL to the Hedera network";
+    this.description = "Inscribe content directly from a URL that points to a downloadable file (PDF, image, JSON, etc). DO NOT use this for web pages like Wikipedia, Twitter, or GitHub pages. This tool is ONLY for direct file URLs like https://example.com/document.pdf or https://api.example.com/data.json. For content you already have (from Wikipedia, MCP tools, or text), use inscribeFromBuffer instead.";
   }
   get specificInputSchema() {
     return inscribeFromUrlSchema;
   }
   async executeQuery(params, _runManager) {
+    console.log(`[DEBUG] InscribeFromUrlTool.executeQuery called with URL: ${params.url}`);
+    if (!params.url || params.url.trim() === "") {
+      throw new Error("URL cannot be empty. Please provide a valid URL.");
+    }
+    try {
+      const urlObj = new URL(params.url);
+      if (!urlObj.protocol || !urlObj.host) {
+        throw new Error("Invalid URL format. Please provide a complete URL with protocol (http/https).");
+      }
+      if (!["http:", "https:"].includes(urlObj.protocol)) {
+        throw new Error("Only HTTP and HTTPS URLs are supported for inscription.");
+      }
+    } catch (error) {
+      throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);
+    }
+    console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 1e4);
+      try {
+        const response = await fetch(params.url, {
+          method: "HEAD",
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+          throw new Error(`URL returned error status ${response.status}: ${response.statusText}. Cannot inscribe content from inaccessible URLs.`);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength && parseInt(contentLength) === 0) {
+          throw new Error("URL returns empty content (Content-Length: 0). Cannot inscribe empty content.");
+        }
+        if (contentLength && parseInt(contentLength) < 10) {
+          throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);
+        }
+        const contentType = response.headers.get("content-type");
+        console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength || "unknown"}`);
+      } catch (fetchError) {
+        clearTimeout(timeoutId);
+        throw fetchError;
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          console.log(`[InscribeFromUrlTool] Warning: URL validation timed out after 10 seconds. Proceeding with inscription attempt.`);
+        } else if (error.message.includes("URL returned error") || error.message.includes("empty content") || error.message.includes("too small")) {
+          throw error;
+        } else {
+          console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);
+        }
+      }
+    }
     const options = {
       mode: params.mode,
       metadata: params.metadata,

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es27.js","sources":["../../src/tools/inscriber/InscribeFromUrlTool.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 from URL\n */\nconst inscribeFromUrlSchema = z.object({\n  url: z.string().url().describe('The URL of the content to inscribe'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing content from URL\n */\nexport class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {\n  name = 'inscribeFromUrl';\n  description = 'Inscribe content from a URL to the Hedera network';\n\n  get specificInputSchema() {\n    return inscribeFromUrlSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromUrlSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      const timeoutPromise = new Promise((_, reject) => {\n        setTimeout(() => reject(new Error('Inscription timed out after 30 seconds')), 30000);\n      });\n\n      const result = await Promise.race([\n        this.inscriberBuilder.inscribe(\n          { type: 'url', url: params.url },\n          options\n        ),\n        timeoutPromise\n      ]) as any;\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.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 content on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,KAAK,EAAE,OAAA,EAAS,IAAA,EAAM,SAAS,oCAAoC;AAAA,EACnE,MAAM,EACH,KAAK,CAAC,QAAQ,UAAU,CAAC,EACzB,SAAA,EACA,SAAS,wCAAwC;AAAA,EACpD,UAAU,EACP,OAAO,EAAE,QAAA,CAAS,EAClB,SAAA,EACA,SAAS,uCAAuC;AAAA,EACnD,MAAM,EACH,MAAM,EAAE,OAAA,CAAQ,EAChB,SAAA,EACA,SAAS,oCAAoC;AAAA,EAChD,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,4BAA4B;AAAA,EACxC,qBAAqB,EAClB,QAAA,EACA,SAAA,EACA,SAAS,8CAA8C;AAAA,EAC1D,QAAQ,EACL,OAAA,EACA,SAAA,EACA,SAAS,iCAAiC;AAC/C,CAAC;AAMM,MAAM,4BAA4B,uBAAqD;AAAA,EAAvF,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,OAAO;AACP,SAAA,cAAc;AAAA,EAAA;AAAA,EAEd,IAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,MAAgB,aACd,QACA,aACkB;AAClB,UAAM,UAA8B;AAAA,MAClC,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,WAAW,OAAO;AAAA,MAClB,qBAAqB,OAAO,uBAAuB;AAAA,MACnD,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,SAAS,KAAK,iBAAiB,WAAW,EAAE,OAAO,QAAQ,WAAW,SAAS,SAAS,IAAI,YAAY;AAAA,IAAA;AAG1G,QAAI;AACF,YAAM,iBAAiB,IAAI,QAAQ,CAAC,GAAG,WAAW;AAChD,mBAAW,MAAM,OAAO,IAAI,MAAM,wCAAwC,CAAC,GAAG,GAAK;AAAA,MACrF,CAAC;AAED,YAAM,SAAS,MAAM,QAAQ,KAAK;AAAA,QAChC,KAAK,iBAAiB;AAAA,UACpB,EAAE,MAAM,OAAO,KAAK,OAAO,IAAA;AAAA,UAC3B;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA,CACD;AAED,UAAI,OAAO,WAAW;AACpB,cAAM,UAAU,OAAO,aAAa,YAAY,OAAO,OAAO;AAC9D,cAAM,UAAU,QAAQ,WAAW;AACnC,cAAM,SAAS,UAAU,8CAA8C,OAAO,YAAY,OAAO,KAAK;AACtG,eAAO;AAAA;AAAA,kBAA0F,OAAO,OAAO,aAAa;AAAA,YAAe,WAAW,KAAK,GAAG,SAAS;AAAA,oBAAuB,MAAM,KAAK,EAAE;AAAA;AAAA;AAAA,MAC7M,OAAO;AACL,eAAO;AAAA;AAAA,kBAAgF,OAAO,OAAO,aAAa;AAAA;AAAA;AAAA,MACpH;AAAA,IACF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU;AAC9D,YAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,IACvD;AAAA,EACF;AACF;"}
+{"version":3,"file":"standards-agent-kit.es27.js","sources":["../../src/tools/inscriber/InscribeFromUrlTool.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 from URL\n */\nconst inscribeFromUrlSchema = z.object({\n  url: z.string().url().describe('The URL of the content to inscribe'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing content from URL\n */\nexport class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {\n  name = 'inscribeFromUrl';\n  description = 'Inscribe content directly from a URL that points to a downloadable file (PDF, image, JSON, etc). DO NOT use this for web pages like Wikipedia, Twitter, or GitHub pages. This tool is ONLY for direct file URLs like https://example.com/document.pdf or https://api.example.com/data.json. For content you already have (from Wikipedia, MCP tools, or text), use inscribeFromBuffer instead.';\n\n  get specificInputSchema() {\n    return inscribeFromUrlSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromUrlSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromUrlTool.executeQuery called with URL: ${params.url}`);\n    \n    if (!params.url || params.url.trim() === '') {\n      throw new Error('URL cannot be empty. Please provide a valid URL.');\n    }\n\n    try {\n      const urlObj = new URL(params.url);\n      if (!urlObj.protocol || !urlObj.host) {\n        throw new Error('Invalid URL format. Please provide a complete URL with protocol (http/https).');\n      }\n      if (!['http:', 'https:'].includes(urlObj.protocol)) {\n        throw new Error('Only HTTP and HTTPS URLs are supported for inscription.');\n      }\n    } catch (error) {\n      throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);\n    }\n\n    console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), 10000);\n      \n      try {\n        const response = await fetch(params.url, {\n          method: 'HEAD',\n          signal: controller.signal,\n        });\n        \n        clearTimeout(timeoutId);\n        \n        if (!response.ok) {\n          throw new Error(`URL returned error status ${response.status}: ${response.statusText}. Cannot inscribe content from inaccessible URLs.`);\n        }\n\n        const contentLength = response.headers.get('content-length');\n        if (contentLength && parseInt(contentLength) === 0) {\n          throw new Error('URL returns empty content (Content-Length: 0). Cannot inscribe empty content.');\n        }\n\n        if (contentLength && parseInt(contentLength) < 10) {\n          throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);\n        }\n\n        const contentType = response.headers.get('content-type');\n        console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength || 'unknown'}`);\n      } catch (fetchError) {\n        clearTimeout(timeoutId);\n        throw fetchError;\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          console.log(`[InscribeFromUrlTool] Warning: URL validation timed out after 10 seconds. Proceeding with inscription attempt.`);\n        } else if (error.message.includes('URL returned error') || error.message.includes('empty content') || error.message.includes('too small')) {\n          throw error;\n        } else {\n          console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);\n        }\n      }\n    }\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      const timeoutPromise = new Promise((_, reject) => {\n        setTimeout(() => reject(new Error('Inscription timed out after 30 seconds')), 30000);\n      });\n\n      const result = await Promise.race([\n        this.inscriberBuilder.inscribe(\n          { type: 'url', url: params.url },\n          options\n        ),\n        timeoutPromise\n      ]) as any;\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.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 content on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":"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"}

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

@@ -3,7 +3,7 @@ import { BaseInscriberQueryTool } from "./standards-agent-kit.es26.js";
 import * as fs from "fs/promises";
 import * as path from "path";
 const inscribeFromFileSchema = z.object({
-  filePath: z.string().describe("The file path of the content to inscribe"),
+  filePath: z.string().min(1, "File path cannot be empty").describe("The file path of the content to inscribe. Must point to a valid, non-empty file."),
   mode: z.enum(["file", "hashinal"]).optional().describe("Inscription mode: file or hashinal NFT"),
   metadata: z.record(z.unknown()).optional().describe("Metadata to attach to the inscription"),
   tags: z.array(z.string()).optional().describe("Tags to categorize the inscription"),
@@ -16,7 +16,7 @@ class InscribeFromFileTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeFromFile";
-    this.description = "Inscribe content from a local file to the Hedera network using a file path. For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.";
+    this.description = "Inscribe content from a local file to the Hedera network using a file path. IMPORTANT: Only use this tool when you have a valid file path to actual content. The file must exist and contain meaningful data (minimum 10 bytes). For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.";
   }
   get specificInputSchema() {
     return inscribeFromFileSchema;
@@ -34,17 +34,40 @@ class InscribeFromFileTool extends BaseInscriberQueryTool {
       console.log(`[DEBUG] File size: ${stats.size} bytes`);
       if (stats.size === 0) {
         throw new Error(
-          `File "${params.filePath}" is empty. Cannot inscribe empty files.`
+          `File "${params.filePath}" is empty (0 bytes). Cannot inscribe empty files.`
         );
       }
+      if (stats.size < 10) {
+        throw new Error(
+          `File "${params.filePath}" is too small (${stats.size} bytes). Files must contain at least 10 bytes of meaningful content.`
+        );
+      }
+      if (stats.size > 100 * 1024 * 1024) {
+        console.log(`[InscribeFromFileTool] WARNING: Large file detected (${(stats.size / (1024 * 1024)).toFixed(2)} MB)`);
+      }
       this.logger?.info("Reading file content...");
       fileContent = await fs.readFile(params.filePath);
       this.logger?.info(`Read ${fileContent.length} bytes from file`);
       if (!fileContent || fileContent.length === 0) {
         throw new Error(
-          `File "${params.filePath}" has no content. Cannot inscribe empty files.`
+          `File "${params.filePath}" has no content after reading. Cannot inscribe empty files.`
+        );
+      }
+      if (fileContent.length < 10) {
+        throw new Error(
+          `File "${params.filePath}" content is too small (${fileContent.length} bytes). Files must contain at least 10 bytes of meaningful content.`
         );
       }
+      const fileName2 = path.basename(params.filePath);
+      const mimeType2 = this.getMimeType(fileName2);
+      if (mimeType2.startsWith("text/") || mimeType2 === "application/json") {
+        const textContent = fileContent.toString("utf8", 0, Math.min(fileContent.length, 1e3));
+        if (textContent.trim() === "") {
+          throw new Error(
+            `File "${params.filePath}" contains only whitespace or empty content. Cannot inscribe meaningless data.`
+          );
+        }
+      }
     } catch (error) {
       if (error instanceof Error) {
         if (error.message.includes("ENOENT")) {

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es28.js","sources":["../../src/tools/inscriber/InscribeFromFileTool.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';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\n\n/**\n * Schema for inscribing from file\n */\nconst inscribeFromFileSchema = z.object({\n  filePath: z.string().describe('The file path of the content to inscribe'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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)'),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n});\n\n/**\n * Tool for inscribing content from file\n */\nexport class InscribeFromFileTool extends BaseInscriberQueryTool<\n  typeof inscribeFromFileSchema\n> {\n  name = 'inscribeFromFile';\n  description =\n    'Inscribe content from a local file to the Hedera network using a file path. For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.';\n\n  get specificInputSchema(): typeof inscribeFromFileSchema {\n    return inscribeFromFileSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromFileSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);\n    \n    // File validation\n    let fileContent: Buffer;\n    try {\n      console.log(`[DEBUG] Checking file: ${params.filePath}`);\n      console.log(`[DEBUG] Current working directory: ${process.cwd()}`);\n\n      const stats = await fs.stat(params.filePath);\n      if (!stats.isFile()) {\n        throw new Error(`Path \"${params.filePath}\" is not a file`);\n      }\n\n      console.log(`[DEBUG] File size: ${stats.size} bytes`);\n\n      if (stats.size === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" is empty. Cannot inscribe empty files.`\n        );\n      }\n\n      this.logger?.info('Reading file content...');\n      fileContent = await fs.readFile(params.filePath);\n      this.logger?.info(`Read ${fileContent.length} bytes from file`);\n\n      if (!fileContent || fileContent.length === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" has no content. Cannot inscribe empty files.`\n        );\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('ENOENT')) {\n          throw new Error(`File not found: \"${params.filePath}\"`);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to read file: ${error}`);\n    }\n\n    const base64Data = fileContent.toString('base64');\n    this.logger?.info(`Converted to base64: ${base64Data.length} characters`);\n\n    const fileName = path.basename(params.filePath);\n    const mimeType = this.getMimeType(fileName);\n    this.logger?.info(`File: ${fileName}, MIME type: ${mimeType}`);\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      let result: any;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise((_, 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            {\n              type: 'buffer',\n              buffer: Buffer.from(base64Data, 'base64'),\n              fileName,\n              mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer: Buffer.from(base64Data, 'base64'),\n            fileName,\n            mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId\n          ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n          : null;\n        return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n          result.result.transactionId\n        }\\nTopic ID: ${topicId || 'N/A'}${\n          cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n        }\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Failed to inscribe from file';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private getMimeType(fileName: string): string {\n    const ext = path.extname(fileName).toLowerCase();\n    const mimeTypes: Record<string, string> = {\n      '.png': 'image/png',\n      '.jpg': 'image/jpeg',\n      '.jpeg': 'image/jpeg',\n      '.gif': 'image/gif',\n      '.webp': 'image/webp',\n      '.svg': 'image/svg+xml',\n      '.pdf': 'application/pdf',\n      '.json': 'application/json',\n      '.txt': 'text/plain',\n      '.html': 'text/html',\n      '.css': 'text/css',\n      '.js': 'application/javascript',\n      '.ts': 'application/typescript',\n      '.mp4': 'video/mp4',\n      '.mp3': 'audio/mpeg',\n      '.wav': 'audio/wav',\n      '.zip': 'application/zip',\n    };\n    return mimeTypes[ext] || 'application/octet-stream';\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es28.js","sources":["../../src/tools/inscriber/InscribeFromFileTool.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';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\n\n/**\n * Schema for inscribing from file\n */\nconst inscribeFromFileSchema = z.object({\n  filePath: z.string().min(1, 'File path cannot be empty').describe('The file path of the content to inscribe. Must point to a valid, non-empty file.'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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)'),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n});\n\n/**\n * Tool for inscribing content from file\n */\nexport class InscribeFromFileTool extends BaseInscriberQueryTool<\n  typeof inscribeFromFileSchema\n> {\n  name = 'inscribeFromFile';\n  description =\n    'Inscribe content from a local file to the Hedera network using a file path. IMPORTANT: Only use this tool when you have a valid file path to actual content. The file must exist and contain meaningful data (minimum 10 bytes). For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.';\n\n  get specificInputSchema(): typeof inscribeFromFileSchema {\n    return inscribeFromFileSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromFileSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);\n    \n    // File validation\n    let fileContent: Buffer;\n    try {\n      console.log(`[DEBUG] Checking file: ${params.filePath}`);\n      console.log(`[DEBUG] Current working directory: ${process.cwd()}`);\n\n      const stats = await fs.stat(params.filePath);\n      if (!stats.isFile()) {\n        throw new Error(`Path \"${params.filePath}\" is not a file`);\n      }\n\n      console.log(`[DEBUG] File size: ${stats.size} bytes`);\n\n      if (stats.size === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" is empty (0 bytes). Cannot inscribe empty files.`\n        );\n      }\n\n      if (stats.size < 10) {\n        throw new Error(\n          `File \"${params.filePath}\" is too small (${stats.size} bytes). Files must contain at least 10 bytes of meaningful content.`\n        );\n      }\n\n      if (stats.size > 100 * 1024 * 1024) {\n        console.log(`[InscribeFromFileTool] WARNING: Large file detected (${(stats.size / (1024 * 1024)).toFixed(2)} MB)`);\n      }\n\n      this.logger?.info('Reading file content...');\n      fileContent = await fs.readFile(params.filePath);\n      this.logger?.info(`Read ${fileContent.length} bytes from file`);\n\n      if (!fileContent || fileContent.length === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" has no content after reading. Cannot inscribe empty files.`\n        );\n      }\n\n      if (fileContent.length < 10) {\n        throw new Error(\n          `File \"${params.filePath}\" content is too small (${fileContent.length} bytes). Files must contain at least 10 bytes of meaningful content.`\n        );\n      }\n\n      const fileName = path.basename(params.filePath);\n      const mimeType = this.getMimeType(fileName);\n      if (mimeType.startsWith('text/') || mimeType === 'application/json') {\n        const textContent = fileContent.toString('utf8', 0, Math.min(fileContent.length, 1000));\n        if (textContent.trim() === '') {\n          throw new Error(\n            `File \"${params.filePath}\" contains only whitespace or empty content. Cannot inscribe meaningless data.`\n          );\n        }\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('ENOENT')) {\n          throw new Error(`File not found: \"${params.filePath}\"`);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to read file: ${error}`);\n    }\n\n    const base64Data = fileContent.toString('base64');\n    this.logger?.info(`Converted to base64: ${base64Data.length} characters`);\n\n    const fileName = path.basename(params.filePath);\n    const mimeType = this.getMimeType(fileName);\n    this.logger?.info(`File: ${fileName}, MIME type: ${mimeType}`);\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      let result: any;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise((_, 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            {\n              type: 'buffer',\n              buffer: Buffer.from(base64Data, 'base64'),\n              fileName,\n              mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer: Buffer.from(base64Data, 'base64'),\n            fileName,\n            mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId\n          ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n          : null;\n        return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n          result.result.transactionId\n        }\\nTopic ID: ${topicId || 'N/A'}${\n          cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n        }\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Failed to inscribe from file';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private getMimeType(fileName: string): string {\n    const ext = path.extname(fileName).toLowerCase();\n    const mimeTypes: Record<string, string> = {\n      '.png': 'image/png',\n      '.jpg': 'image/jpeg',\n      '.jpeg': 'image/jpeg',\n      '.gif': 'image/gif',\n      '.webp': 'image/webp',\n      '.svg': 'image/svg+xml',\n      '.pdf': 'application/pdf',\n      '.json': 'application/json',\n      '.txt': 'text/plain',\n      '.html': 'text/html',\n      '.css': 'text/css',\n      '.js': 'application/javascript',\n      '.ts': 'application/typescript',\n      '.mp4': 'video/mp4',\n      '.mp3': 'audio/mpeg',\n      '.wav': 'audio/wav',\n      '.zip': 'application/zip',\n    };\n    return mimeTypes[ext] || 'application/octet-stream';\n  }\n}\n"],"names":["fileName","mimeType"],"mappings":"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"}

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

@@ -1,8 +1,8 @@
 import { z } from "zod";
 import { BaseInscriberQueryTool } from "./standards-agent-kit.es26.js";
 const inscribeFromBufferSchema = z.object({
-  base64Data: z.string().describe("Base64 encoded content to inscribe"),
-  fileName: z.string().describe("Name for the inscribed content"),
+  base64Data: z.string().min(1, "Base64 data cannot be empty").describe("Base64 encoded content to inscribe. Must contain valid, non-empty content (minimum 10 bytes after decoding)."),
+  fileName: z.string().min(1, "File name cannot be empty").describe("Name for the inscribed content. Required for all inscriptions."),
   mimeType: z.string().optional().describe("MIME type of the content"),
   mode: z.enum(["file", "hashinal"]).optional().describe("Inscription mode: file or hashinal NFT"),
   metadata: z.record(z.unknown()).optional().describe("Metadata to attach to the inscription"),
@@ -16,7 +16,7 @@ class InscribeFromBufferTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeFromBuffer";
-    this.description = "Inscribe content from a buffer/base64 data to the Hedera network. Useful for inscribing content that has been read into memory, including files accessed through MCP filesystem tools.";
+    this.description = "Inscribe content that you already have (text, data, or files) to the Hedera network. Use this tool when you have content from: Wikipedia articles, MCP tool responses, text data, API responses, or any content you've retrieved. Convert your content to base64 first. DO NOT use inscribeFromUrl for web page content - use this tool instead after retrieving the actual content.";
   }
   get specificInputSchema() {
     return inscribeFromBufferSchema;
@@ -28,13 +28,37 @@ class InscribeFromBufferTool extends BaseInscriberQueryTool {
     console.log(`[DEBUG] Buffer tool mimeType: ${params.mimeType}`);
     if (!params.base64Data || params.base64Data.trim() === "") {
       console.log(`[InscribeFromBufferTool] ERROR: No data provided`);
-      throw new Error("No data provided. Cannot inscribe empty content.");
+      throw new Error("No data provided. Cannot inscribe empty content. Please provide valid base64 encoded data.");
+    }
+    if (!params.fileName || params.fileName.trim() === "") {
+      console.log(`[InscribeFromBufferTool] ERROR: No fileName provided`);
+      throw new Error("No fileName provided. A valid fileName is required for inscription.");
+    }
+    let buffer;
+    try {
+      buffer = Buffer.from(params.base64Data, "base64");
+    } catch (error) {
+      console.log(`[InscribeFromBufferTool] ERROR: Invalid base64 data`);
+      throw new Error("Invalid base64 data provided. Please ensure the data is properly base64 encoded.");
     }
-    const buffer = Buffer.from(params.base64Data, "base64");
     console.log(`[InscribeFromBufferTool] Buffer length after conversion: ${buffer.length}`);
     if (buffer.length === 0) {
       console.log(`[InscribeFromBufferTool] ERROR: Buffer is empty after conversion`);
-      throw new Error("Buffer is empty. Cannot inscribe empty content.");
+      throw new Error("Buffer is empty after base64 conversion. The provided data appears to be invalid or empty.");
+    }
+    if (buffer.length < 10) {
+      console.log(`[InscribeFromBufferTool] WARNING: Buffer is very small (${buffer.length} bytes)`);
+      console.log(`[InscribeFromBufferTool] Buffer content preview: ${buffer.toString("utf8", 0, Math.min(buffer.length, 50))}`);
+      throw new Error(`Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`);
+    }
+    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(params.base64Data);
+    if (!isValidBase64) {
+      console.log(`[InscribeFromBufferTool] ERROR: Invalid base64 format`);
+      throw new Error("Invalid base64 format. The data does not appear to be properly base64 encoded.");
+    }
+    if (buffer.toString("utf8", 0, Math.min(buffer.length, 100)).trim() === "") {
+      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains only whitespace or empty content`);
+      throw new Error("Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.");
     }
     const options = {
       mode: params.mode,

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es29.js","sources":["../../src/tools/inscriber/InscribeFromBufferTool.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 from buffer\n */\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z.string().describe('Base64 encoded content to inscribe'),\n  fileName: z.string().describe('Name for the inscribed content'),\n  mimeType: z\n    .string()\n    .optional()\n    .describe('MIME type of the content'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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)'),\n  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing content from buffer\n */\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {\n  name = 'inscribeFromBuffer';\n  description = 'Inscribe content from a buffer/base64 data to the Hedera network. Useful for inscribing content that has been read into memory, including files accessed through MCP filesystem tools.';\n\n  get specificInputSchema() {\n    return inscribeFromBufferSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromBufferSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromBufferTool.executeQuery called`);\n    console.log(`[DEBUG] Buffer tool received base64Data length: ${params.base64Data?.length || 0}`);\n    console.log(`[DEBUG] Buffer tool fileName: ${params.fileName}`);\n    console.log(`[DEBUG] Buffer tool mimeType: ${params.mimeType}`);\n    \n    if (!params.base64Data || params.base64Data.trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: No data provided`);\n      throw new Error('No data provided. Cannot inscribe empty content.');\n    }\n\n    const buffer = Buffer.from(params.base64Data, 'base64');\n    console.log(`[InscribeFromBufferTool] Buffer length after conversion: ${buffer.length}`);\n    \n    if (buffer.length === 0) {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer is empty after conversion`);\n      throw new Error('Buffer is empty. Cannot inscribe empty content.');\n    }\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      let result: any;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise((_, 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            {\n              type: 'buffer',\n              buffer,\n              fileName: params.fileName,\n              mimeType: params.mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer,\n            fileName: params.fileName,\n            mimeType: params.mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.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 content on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from buffer';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,YAAY,EAAE,SAAS,SAAS,oCAAoC;AAAA,EACpE,UAAU,EAAE,SAAS,SAAS,gCAAgC;AAAA,EAC9D,UAAU,EACP,OAAA,EACA,SAAA,EACA,SAAS,0BAA0B;AAAA,EACtC,MAAM,EACH,KAAK,CAAC,QAAQ,UAAU,CAAC,EACzB,SAAA,EACA,SAAS,wCAAwC;AAAA,EACpD,UAAU,EACP,OAAO,EAAE,QAAA,CAAS,EAClB,SAAA,EACA,SAAS,uCAAuC;AAAA,EACnD,MAAM,EACH,MAAM,EAAE,OAAA,CAAQ,EAChB,SAAA,EACA,SAAS,oCAAoC;AAAA,EAChD,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,4BAA4B;AAAA,EACxC,qBAAqB,EAClB,QAAA,EACA,SAAA,EACA,SAAS,8CAA8C;AAAA,EAC1D,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,+DAA+D;AAAA,EAC3E,QAAQ,EACL,OAAA,EACA,SAAA,EACA,SAAS,iCAAiC;AAC/C,CAAC;AAMM,MAAM,+BAA+B,uBAAwD;AAAA,EAA7F,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,OAAO;AACP,SAAA,cAAc;AAAA,EAAA;AAAA,EAEd,IAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,MAAgB,aACd,QACA,aACkB;AAClB,YAAQ,IAAI,oDAAoD;AAChE,YAAQ,IAAI,mDAAmD,OAAO,YAAY,UAAU,CAAC,EAAE;AAC/F,YAAQ,IAAI,iCAAiC,OAAO,QAAQ,EAAE;AAC9D,YAAQ,IAAI,iCAAiC,OAAO,QAAQ,EAAE;AAE9D,QAAI,CAAC,OAAO,cAAc,OAAO,WAAW,KAAA,MAAW,IAAI;AACzD,cAAQ,IAAI,kDAAkD;AAC9D,YAAM,IAAI,MAAM,kDAAkD;AAAA,IACpE;AAEA,UAAM,SAAS,OAAO,KAAK,OAAO,YAAY,QAAQ;AACtD,YAAQ,IAAI,4DAA4D,OAAO,MAAM,EAAE;AAEvF,QAAI,OAAO,WAAW,GAAG;AACvB,cAAQ,IAAI,kEAAkE;AAC9E,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AAEA,UAAM,UAA8B;AAAA,MAClC,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,WAAW,OAAO;AAAA,MAClB,qBAAqB,OAAO,uBAAuB;AAAA,MACnD,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,SAAS,KAAK,iBAAiB,WAAW,EAAE,OAAO,QAAQ,WAAW,SAAS,SAAS,IAAI,YAAY;AAAA,IAAA;AAG1G,QAAI;AACF,UAAI;AAEJ,UAAI,OAAO,WAAW;AACpB,cAAM,iBAAiB,IAAI,QAAQ,CAAC,GAAG,WAAW;AAChD;AAAA,YACE,MAAM,OAAO,IAAI,MAAM,+BAA+B,OAAO,SAAS,IAAI,CAAC;AAAA,YAC3E,OAAO;AAAA,UAAA;AAAA,QAEX,CAAC;AAED,iBAAS,MAAM,QAAQ,KAAK;AAAA,UAC1B,KAAK,iBAAiB;AAAA,YACpB;AAAA,cACE,MAAM;AAAA,cACN;AAAA,cACA,UAAU,OAAO;AAAA,cACjB,UAAU,OAAO;AAAA,YAAA;AAAA,YAEnB;AAAA,UAAA;AAAA,UAEF;AAAA,QAAA,CACD;AAAA,MACH,OAAO;AACL,iBAAS,MAAM,KAAK,iBAAiB;AAAA,UACnC;AAAA,YACE,MAAM;AAAA,YACN;AAAA,YACA,UAAU,OAAO;AAAA,YACjB,UAAU,OAAO;AAAA,UAAA;AAAA,UAEnB;AAAA,QAAA;AAAA,MAEJ;AAEA,UAAI,OAAO,WAAW;AACpB,cAAM,UAAU,OAAO,aAAa,YAAY,OAAO,OAAO;AAC9D,cAAM,UAAU,QAAQ,WAAW;AACnC,cAAM,SAAS,UAAU,8CAA8C,OAAO,YAAY,OAAO,KAAK;AACtG,eAAO;AAAA;AAAA,kBAA0F,OAAO,OAAO,aAAa;AAAA,YAAe,WAAW,KAAK,GAAG,SAAS;AAAA,oBAAuB,MAAM,KAAK,EAAE;AAAA;AAAA;AAAA,MAC7M,OAAO;AACL,eAAO;AAAA;AAAA,kBAAgF,OAAO,OAAO,aAAa;AAAA;AAAA;AAAA,MACpH;AAAA,IACF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU;AAC9D,YAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,IACvD;AAAA,EACF;AACF;"}
+{"version":3,"file":"standards-agent-kit.es29.js","sources":["../../src/tools/inscriber/InscribeFromBufferTool.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 from buffer\n */\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z.string().min(1, 'Base64 data cannot be empty').describe('Base64 encoded content to inscribe. Must contain valid, non-empty content (minimum 10 bytes after decoding).'),\n  fileName: z.string().min(1, 'File name cannot be empty').describe('Name for the inscribed content. Required for all inscriptions.'),\n  mimeType: z\n    .string()\n    .optional()\n    .describe('MIME type of the content'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\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)'),\n  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing content from buffer\n */\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {\n  name = 'inscribeFromBuffer';\n  description = 'Inscribe content that you already have (text, data, or files) to the Hedera network. Use this tool when you have content from: Wikipedia articles, MCP tool responses, text data, API responses, or any content you\\'ve retrieved. Convert your content to base64 first. DO NOT use inscribeFromUrl for web page content - use this tool instead after retrieving the actual content.';\n\n  get specificInputSchema() {\n    return inscribeFromBufferSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromBufferSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromBufferTool.executeQuery called`);\n    console.log(`[DEBUG] Buffer tool received base64Data length: ${params.base64Data?.length || 0}`);\n    console.log(`[DEBUG] Buffer tool fileName: ${params.fileName}`);\n    console.log(`[DEBUG] Buffer tool mimeType: ${params.mimeType}`);\n    \n    if (!params.base64Data || params.base64Data.trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: No data provided`);\n      throw new Error('No data provided. Cannot inscribe empty content. Please provide valid base64 encoded data.');\n    }\n\n    if (!params.fileName || params.fileName.trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: No fileName provided`);\n      throw new Error('No fileName provided. A valid fileName is required for inscription.');\n    }\n\n    let buffer: Buffer;\n    try {\n      buffer = Buffer.from(params.base64Data, 'base64');\n    } catch (error) {\n      console.log(`[InscribeFromBufferTool] ERROR: Invalid base64 data`);\n      throw new Error('Invalid base64 data provided. Please ensure the data is properly base64 encoded.');\n    }\n    \n    console.log(`[InscribeFromBufferTool] Buffer length after conversion: ${buffer.length}`);\n    \n    if (buffer.length === 0) {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer is empty after conversion`);\n      throw new Error('Buffer is empty after base64 conversion. The provided data appears to be invalid or empty.');\n    }\n\n    if (buffer.length < 10) {\n      console.log(`[InscribeFromBufferTool] WARNING: Buffer is very small (${buffer.length} bytes)`);\n      console.log(`[InscribeFromBufferTool] Buffer content preview: ${buffer.toString('utf8', 0, Math.min(buffer.length, 50))}`);\n      throw new Error(`Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`);\n    }\n\n    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(params.base64Data);\n    if (!isValidBase64) {\n      console.log(`[InscribeFromBufferTool] ERROR: Invalid base64 format`);\n      throw new Error('Invalid base64 format. The data does not appear to be properly base64 encoded.');\n    }\n\n    if (buffer.toString('utf8', 0, Math.min(buffer.length, 100)).trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains only whitespace or empty content`);\n      throw new Error('Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.');\n    }\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: 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    };\n\n    try {\n      let result: any;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise((_, 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            {\n              type: 'buffer',\n              buffer,\n              fileName: params.fileName,\n              mimeType: params.mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer,\n            fileName: params.fileName,\n            mimeType: params.mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.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 content on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from buffer';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":"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"}

package/dist/umd/builders/hcs6/hcs6-builder.d.ts

@@ -0,0 +1,47 @@
+import { BaseServiceBuilder, HederaAgentKit } from 'hedera-agent-kit';
+import { HCS6Client, HCS6CreateRegistryOptions, HCS6RegisterEntryOptions, HCS6QueryRegistryOptions, HCS6RegisterOptions, HCS6CreateHashinalOptions, HCS6TopicRegistrationResponse, HCS6RegistryOperationResponse, HCS6TopicRegistry, HCS6CreateHashinalResponse } from '@hashgraphonline/standards-sdk';
+/**
+ * Builder for HCS-6 operations that delegates to HCS6Client
+ */
+export declare class HCS6Builder extends BaseServiceBuilder {
+    protected hcs6Client?: HCS6Client;
+    constructor(hederaKit: HederaAgentKit);
+    /**
+     * Get or create HCS-6 client
+     */
+    protected getHCS6Client(): Promise<HCS6Client>;
+    /**
+     * Create a new HCS-6 dynamic registry
+     * Note: This executes the transaction directly via HCS6Client
+     */
+    createRegistry(options?: HCS6CreateRegistryOptions): Promise<HCS6TopicRegistrationResponse>;
+    /**
+     * Register a new dynamic hashinal entry in an HCS-6 registry
+     */
+    registerEntry(registryTopicId: string, options: HCS6RegisterEntryOptions): Promise<HCS6RegistryOperationResponse>;
+    /**
+     * Query entries from an HCS-6 registry
+     */
+    getRegistry(topicId: string, options?: HCS6QueryRegistryOptions): Promise<HCS6TopicRegistry>;
+    /**
+     * Create a complete dynamic hashinal with inscription and registry
+     */
+    createHashinal(options: HCS6CreateHashinalOptions): Promise<HCS6CreateHashinalResponse>;
+    /**
+     * Register a dynamic hashinal with combined inscription and registry creation
+     * This is the main method for creating and updating dynamic hashinals
+     */
+    register(options: HCS6RegisterOptions): Promise<HCS6CreateHashinalResponse>;
+    /**
+     * Submit a raw message to an HCS-6 topic
+     */
+    submitMessage(topicId: string, payload: any): Promise<any>;
+    /**
+     * Get topic info from mirror node
+     */
+    getTopicInfo(topicId: string): Promise<any>;
+    /**
+     * Close the HCS-6 client
+     */
+    close(): Promise<void>;
+}

package/dist/umd/builders/hcs6/index.d.ts

@@ -0,0 +1 @@
+export * from './hcs6-builder';

package/dist/umd/builders/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types';
 export * from './hcs10/hcs10-builder';
 export * from './hcs2/hcs2-builder';
+export * from './hcs6/hcs6-builder';
 export * from './inscriber/inscriber-builder';