@hashgraphonline/standards-agent-kit 0.2.108 → 0.2.110

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.108",
+  "version": "0.2.110",
   "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
   "type": "module",
   "main": "./dist/cjs/standards-agent-kit.cjs",
@@ -89,7 +89,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.69.0",
-    "@hashgraphonline/standards-sdk": "0.0.162",
+    "@hashgraphonline/standards-sdk": "0.0.165",
     "@langchain/community": "^0.3.49",
     "@langchain/core": "^0.3.66",
     "@langchain/openai": "^0.6.3",

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -7,8 +7,8 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  * Schema for inscribing from buffer
  */
 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()
@@ -53,7 +53,7 @@ const inscribeFromBufferSchema = z.object({
  */
 export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {
   name = 'inscribeFromBuffer';
-  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.';
+  description = 'Inscribe content from a buffer/base64 data to the Hedera network. IMPORTANT: Only use this tool when you have actual content to inscribe. The base64Data must contain valid, non-empty content (minimum 10 bytes). Useful for inscribing content that has been read into memory, including files accessed through MCP filesystem tools. Always verify the content exists and is meaningful before attempting inscription.';
 
   get specificInputSchema() {
     return inscribeFromBufferSchema;
@@ -70,15 +70,44 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscri
     
     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.');
     }
 
-    const buffer = Buffer.from(params.base64Data, 'base64');
+    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: 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.');
+    }
+    
     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: InscriptionOptions = {

package/src/tools/inscriber/InscribeFromFileTool.ts

@@ -9,7 +9,7 @@ import * as path from 'path';
  * Schema for inscribing from file
  */
 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()
@@ -49,7 +49,7 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
 > {
   name = 'inscribeFromFile';
   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.';
+    '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(): typeof inscribeFromFileSchema {
     return inscribeFromFileSchema;
@@ -76,19 +76,46 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
 
       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 fileName = path.basename(params.filePath);
+      const mimeType = this.getMimeType(fileName);
+      if (mimeType.startsWith('text/') || mimeType === 'application/json') {
+        const textContent = fileContent.toString('utf8', 0, Math.min(fileContent.length, 1000));
+        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/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -42,7 +42,7 @@ const inscribeFromUrlSchema = z.object({
  */
 export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {
   name = 'inscribeFromUrl';
-  description = 'Inscribe content from a URL to the Hedera network';
+  description = 'Inscribe content from a URL to the Hedera network. IMPORTANT: Only use this tool when you have a valid URL pointing to actual content. The URL must be accessible and return meaningful data. The tool will validate that the content exists and is not empty before inscription.';
 
   get specificInputSchema() {
     return inscribeFromUrlSchema;
@@ -52,6 +52,68 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
     params: z.infer<typeof inscribeFromUrlSchema>,
     _runManager?: CallbackManagerForToolRun
   ): Promise<unknown> {
+    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(), 10000);
+      
+      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: InscriptionOptions = {
       mode: params.mode,
       metadata: params.metadata,