@hashgraphonline/standards-agent-kit 0.2.103 → 0.2.104

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

@@ -15,8 +15,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
     apiKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    base64Data: string;
     fileName: string;
+    base64Data: string;
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     mode?: "file" | "hashinal" | undefined;
@@ -25,8 +25,8 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     apiKey?: string | undefined;
     mimeType?: string | undefined;
 }, {
-    base64Data: string;
     fileName: string;
+    base64Data: string;
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     mode?: "file" | "hashinal" | undefined;
@@ -52,8 +52,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
         apiKey: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        base64Data: string;
         fileName: string;
+        base64Data: string;
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
         mode?: "file" | "hashinal" | undefined;
@@ -62,8 +62,8 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         apiKey?: string | undefined;
         mimeType?: string | undefined;
     }, {
-        base64Data: string;
         fileName: string;
+        base64Data: string;
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
         mode?: "file" | "hashinal" | undefined;

package/dist/umd/tools/inscriber/InscribeFromFileTool.d.ts

@@ -35,31 +35,9 @@ declare const inscribeFromFileSchema: z.ZodObject<{
 export declare class InscribeFromFileTool extends BaseInscriberQueryTool<typeof inscribeFromFileSchema> {
     name: string;
     description: string;
-    get specificInputSchema(): z.ZodObject<{
-        filePath: 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>;
-        waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
-        apiKey: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        filePath: string;
-        tags?: string[] | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        mode?: "file" | "hashinal" | undefined;
-        chunkSize?: number | undefined;
-        waitForConfirmation?: boolean | undefined;
-        apiKey?: string | undefined;
-    }, {
-        filePath: string;
-        tags?: string[] | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        mode?: "file" | "hashinal" | undefined;
-        chunkSize?: number | undefined;
-        waitForConfirmation?: boolean | undefined;
-        apiKey?: string | undefined;
-    }>;
+    private logger;
+    get specificInputSchema(): typeof inscribeFromFileSchema;
     protected executeQuery(params: z.infer<typeof inscribeFromFileSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
+    private getMimeType;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.103",
+  "version": "0.2.104",
   "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",

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -47,7 +47,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';
+  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.';
 
   get specificInputSchema() {
     return inscribeFromBufferSchema;
@@ -57,7 +57,22 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscri
     params: z.infer<typeof inscribeFromBufferSchema>,
     _runManager?: CallbackManagerForToolRun
   ): Promise<unknown> {
+    console.log(`[InscribeFromBufferTool] Received base64Data length: ${params.base64Data?.length || 0}`);
+    console.log(`[InscribeFromBufferTool] fileName: ${params.fileName}`);
+    console.log(`[InscribeFromBufferTool] 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.');
+    }
+
     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.');
+    }
 
     const options: InscriptionOptions = {
       mode: params.mode,

package/src/tools/inscriber/InscribeFromFileTool.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { BaseInscriberQueryTool } from './base-inscriber-tools';
-import { InscriptionOptions } from '@hashgraphonline/standards-sdk';
+import { InscriptionOptions, Logger } from '@hashgraphonline/standards-sdk';
 import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
+import * as fs from 'fs/promises';
+import * as path from 'path';
 
 /**
  * Schema for inscribing from file
@@ -30,21 +32,22 @@ const inscribeFromFileSchema = z.object({
     .boolean()
     .optional()
     .describe('Whether to wait for inscription confirmation'),
-  apiKey: z
-    .string()
-    .optional()
-    .describe('API key for inscription service'),
+  apiKey: z.string().optional().describe('API key for inscription service'),
 });
 
-
 /**
  * Tool for inscribing content from file
  */
-export class InscribeFromFileTool extends BaseInscriberQueryTool<typeof inscribeFromFileSchema> {
+export class InscribeFromFileTool extends BaseInscriberQueryTool<
+  typeof inscribeFromFileSchema
+> {
   name = 'inscribeFromFile';
-  description = 'Inscribe content from a local file to the Hedera network';
+  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.';
+  
+  private logger = new Logger({ module: 'InscribeFromFileTool' });
 
-  get specificInputSchema() {
+  get specificInputSchema(): typeof inscribeFromFileSchema {
     return inscribeFromFileSchema;
   }
 
@@ -52,6 +55,51 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<typeof inscribe
     params: z.infer<typeof inscribeFromFileSchema>,
     _runManager?: CallbackManagerForToolRun
   ): Promise<unknown> {
+    // File validation
+    let fileContent: Buffer;
+    try {
+      this.logger.info(`Checking file: ${params.filePath}`);
+      this.logger.info(`Current working directory: ${process.cwd()}`);
+
+      const stats = await fs.stat(params.filePath);
+      if (!stats.isFile()) {
+        throw new Error(`Path "${params.filePath}" is not a file`);
+      }
+
+      this.logger.info(`File size: ${stats.size} bytes`);
+
+      if (stats.size === 0) {
+        throw new Error(
+          `File "${params.filePath}" is empty. Cannot inscribe empty files.`
+        );
+      }
+
+      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.`
+        );
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes('ENOENT')) {
+          throw new Error(`File not found: "${params.filePath}"`);
+        }
+        throw error;
+      }
+      throw new Error(`Failed to read file: ${error}`);
+    }
+
+    const base64Data = fileContent.toString('base64');
+    this.logger.info(`Converted to base64: ${base64Data.length} characters`);
+
+    const fileName = path.basename(params.filePath);
+    const mimeType = this.getMimeType(fileName);
+    this.logger.info(`File: ${fileName}, MIME type: ${mimeType}`);
+
     const options: InscriptionOptions = {
       mode: params.mode,
       metadata: params.metadata,
@@ -61,33 +109,76 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<typeof inscribe
       waitMaxAttempts: 10,
       waitIntervalMs: 3000,
       apiKey: params.apiKey,
-      network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',
+      network: this.inscriberBuilder['hederaKit'].client.network
+        .toString()
+        .includes('mainnet')
+        ? 'mainnet'
+        : 'testnet',
     };
 
     try {
       const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(() => reject(new Error('Inscription timed out after 30 seconds')), 30000);
+        setTimeout(
+          () => reject(new Error('Inscription timed out after 30 seconds')),
+          30000
+        );
       });
 
-      const result = await Promise.race([
+      const result = (await Promise.race([
         this.inscriberBuilder.inscribe(
-          { type: 'file', path: params.filePath },
+          {
+            type: 'buffer',
+            buffer: Buffer.from(base64Data, 'base64'),
+            fileName,
+            mimeType,
+          },
           options
         ),
-        timeoutPromise
-      ]) as any;
+        timeoutPromise,
+      ])) as any;
 
       if (result.confirmed) {
         const topicId = result.inscription?.topic_id || result.result.topicId;
         const network = options.network || 'testnet';
-        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
-        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.`;
+        const cdnUrl = topicId
+          ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`
+          : null;
+        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.`;
       } else {
         return `Successfully submitted inscription to the Hedera network!\n\nTransaction ID: ${result.result.transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
       }
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from file';
+      const errorMessage =
+        error instanceof Error ? error.message : 'Failed to inscribe from file';
       throw new Error(`Inscription failed: ${errorMessage}`);
     }
   }
-}
+
+  private getMimeType(fileName: string): string {
+    const ext = path.extname(fileName).toLowerCase();
+    const mimeTypes: Record<string, string> = {
+      '.png': 'image/png',
+      '.jpg': 'image/jpeg',
+      '.jpeg': 'image/jpeg',
+      '.gif': 'image/gif',
+      '.webp': 'image/webp',
+      '.svg': 'image/svg+xml',
+      '.pdf': 'application/pdf',
+      '.json': 'application/json',
+      '.txt': 'text/plain',
+      '.html': 'text/html',
+      '.css': 'text/css',
+      '.js': 'application/javascript',
+      '.ts': 'application/typescript',
+      '.mp4': 'video/mp4',
+      '.mp3': 'audio/mpeg',
+      '.wav': 'audio/wav',
+      '.zip': 'application/zip',
+    };
+    return mimeTypes[ext] || 'application/octet-stream';
+  }
+}