@hashgraphonline/standards-agent-kit 0.2.124 → 0.2.127

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.124",
+  "version": "0.2.127",
   "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",
@@ -21,33 +21,6 @@
     "LICENSE",
     "README.md"
   ],
-  "scripts": {
-    "clean": "rimraf dist",
-    "build:es": "BUILD_FORMAT=es vite build",
-    "build:cjs": "BUILD_FORMAT=cjs vite build",
-    "build:umd": "BUILD_FORMAT=umd vite build",
-    "build": "pnpm run clean && pnpm run build:es && pnpm run build:cjs && pnpm run build:umd",
-    "test": "jest",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "prepare": "pnpm run build",
-    "prepublishOnly": "pnpm run build",
-    "release": "pnpm publish --access public",
-    "release:canary": "pnpm run prepublishOnly && pnpm publish --tag canary --access public",
-    "version:canary": "pnpm version prerelease --preid canary --no-git-tag-version",
-    "publish:canary": "pnpm run version:canary && pnpm run release:canary",
-    "demo:cli": "tsx examples/cli-demo.ts",
-    "demo:interactive": "tsx examples/interactive-demo.ts",
-    "demo:langchain": "tsx examples/langchain-demo.ts",
-    "demo:plugin": "tsx examples/plugin-system-example.ts",
-    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
-    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
-    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
-    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
-    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
-    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
-    "typecheck": "tsc --noEmit"
-  },
   "keywords": [
     "hedera",
     "hcs10",
@@ -128,5 +101,29 @@
     "vite-plugin-node-polyfills": "^0.23.0",
     "vite-plugin-string-replace": "^1.1.3"
   },
-  "packageManager": "pnpm@10.11.1+sha512.e519b9f7639869dc8d5c3c5dfef73b3f091094b0a006d7317353c72b124e80e1afd429732e28705ad6bfa1ee879c1fce46c128ccebd3192101f43dd67c667912"
-}
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:es": "BUILD_FORMAT=es vite build",
+    "build:cjs": "BUILD_FORMAT=cjs vite build",
+    "build:umd": "BUILD_FORMAT=umd vite build",
+    "build": "pnpm run clean && pnpm run build:es && pnpm run build:cjs && pnpm run build:umd",
+    "test": "jest",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "release": "pnpm publish --access public",
+    "release:canary": "pnpm run prepublishOnly && pnpm publish --tag canary --access public",
+    "version:canary": "pnpm version prerelease --preid canary --no-git-tag-version",
+    "publish:canary": "pnpm run version:canary && pnpm run release:canary",
+    "demo:cli": "tsx examples/cli-demo.ts",
+    "demo:interactive": "tsx examples/interactive-demo.ts",
+    "demo:langchain": "tsx examples/langchain-demo.ts",
+    "demo:plugin": "tsx examples/plugin-system-example.ts",
+    "demo:plugin:weather": "tsx examples/plugins/weather/index.ts",
+    "demo:plugin:defi": "tsx examples/plugins/defi/index.ts",
+    "demo:plugin:openconvai": "tsx examples/openconvai-plugin-example.ts",
+    "demo:inscription-quotes": "tsx examples/inscription-quote-demo.ts",
+    "standards-agent:start": "tsx examples/standards-expert/cli.ts -- start",
+    "standards-agent:process-docs": "tsx examples/standards-expert/cli.ts -- process-docs --all-repos",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -126,7 +126,7 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
             mimeType: resolvedMimeType,
             sizeBytes: buffer.length,
           },
-          message: `Quote generated for buffer content: ${resolvedFileName} (${(buffer.length / 1024).toFixed(2)} KB)\nTotal cost: ${quote.totalCostHbar} HBAR`,
+          message: `Estimated Quote for buffer content: ${resolvedFileName} (${(buffer.length / 1024).toFixed(2)} KB)\nTotal cost: ${quote.totalCostHbar} HBAR`,
         };
       } catch (error) {
         const errorMessage =
@@ -135,16 +135,13 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
       }
     }
 
-    const timeoutMs =
-      params.timeoutMs || (options.waitForConfirmation ? 60000 : undefined);
-
     try {
       const result = await this.executeInscription(
         buffer,
         resolvedFileName,
         resolvedMimeType,
         options,
-        timeoutMs
+        params.timeoutMs
       );
       return this.formatInscriptionResult(result, options);
     } catch (error) {

package/src/tools/inscriber/InscribeFromFileTool.ts

@@ -199,7 +199,7 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
             sizeBytes: fileContent.length,
             filePath: params.filePath,
           },
-          message: `Quote generated for file: ${fileName} (${(
+          message: `Estimated Quote for file: ${fileName} (${(
             fileContent.length / 1024
           ).toFixed(2)} KB)\nTotal cost: ${
             quote.totalCostHbar

package/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -7,7 +7,12 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  * Schema for inscribing from URL
  */
 const inscribeFromUrlSchema = z.object({
-  url: z.string().url().describe('ONLY direct file download URLs with file extensions (.pdf, .jpg, .png, .json, .zip). NEVER use for web pages, articles, or when you already have content to inscribe.'),
+  url: z
+    .string()
+    .url()
+    .describe(
+      'ONLY direct file download URLs with file extensions (.pdf, .jpg, .png, .json, .zip). NEVER use for web pages, articles, or when you already have content to inscribe.'
+    ),
   mode: z
     .enum(['file', 'hashinal'])
     .optional()
@@ -35,25 +40,28 @@ const inscribeFromUrlSchema = z.object({
     .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'),
+    .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'),
+    .describe(
+      'If true, returns a cost quote instead of executing the inscription'
+    ),
 });
 
-
 /**
  * Tool for inscribing content from URL
  */
-export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {
+export class InscribeFromUrlTool extends BaseInscriberQueryTool<
+  typeof inscribeFromUrlSchema
+> {
   name = 'inscribeFromUrl';
-  description = 'ONLY for direct FILE DOWNLOAD URLs ending with file extensions (.pdf, .jpg, .png, .json, .zip). NEVER use for web pages, articles, or ANY HTML content - it WILL FAIL. If you have already retrieved content from any source (including MCP tools), you MUST use inscribeFromBuffer instead. This tool downloads files from URLs - it does NOT inscribe content you already have. When asked to "inscribe it" after retrieving content, ALWAYS use inscribeFromBuffer with the actual content. Set quoteOnly=true to get cost estimates without executing the inscription.';
+  description =
+    'ONLY for direct FILE DOWNLOAD URLs ending with file extensions (.pdf, .jpg, .png, .json, .zip). NEVER use for web pages, articles, or ANY HTML content - it WILL FAIL. If you have already retrieved content from any source (including MCP tools), you MUST use inscribeFromBuffer instead. This tool downloads files from URLs - it does NOT inscribe content you already have. When asked to "inscribe it" after retrieving content, ALWAYS use inscribeFromBuffer with the actual content. Set quoteOnly=true to get cost estimates without executing the inscription.';
 
   get specificInputSchema() {
     return inscribeFromUrlSchema;
@@ -63,8 +71,10 @@ 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}`);
-    
+    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.');
     }
@@ -72,95 +82,137 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
     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).');
+        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.');
+        throw new Error(
+          'Only HTTP and HTTPS URLs are supported for inscription.'
+        );
       }
-      
     } catch (error) {
-      if (error instanceof Error && error.message.includes('Cannot inscribe content from')) {
+      if (
+        error instanceof Error &&
+        error.message.includes('Cannot inscribe content from')
+      ) {
         throw error;
       }
-      throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);
+      throw new Error(
+        `Invalid URL: ${params.url}. Please provide a valid URL.`
+      );
     }
 
-    console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);
+    console.log(
+      `[InscribeFromUrlTool] Validating URL content before inscription...`
+    );
     try {
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), 10000);
-      
+
       try {
         const headResponse = await fetch(params.url, {
           method: 'HEAD',
           signal: controller.signal,
         });
-        
+
         clearTimeout(timeoutId);
-        
+
         if (!headResponse.ok) {
-          throw new Error(`URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`);
+          throw new Error(
+            `URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`
+          );
         }
 
         const contentType = headResponse.headers.get('content-type') || '';
         const contentLength = headResponse.headers.get('content-length');
-        
+
         const webPageContentTypes = [
           'text/html',
           'application/xhtml+xml',
-          'text/xml'
+          'text/xml',
         ];
-        
-        if (webPageContentTypes.some(type => contentType.toLowerCase().includes(type))) {
-          throw new Error(`URL returns HTML/web page content (Content-Type: ${contentType}). This tool only works with direct file URLs (PDFs, images, JSON, etc.). For web page content, first retrieve the content using the appropriate MCP tool or web scraper, then use inscribeFromBuffer to inscribe it.`);
+
+        if (
+          webPageContentTypes.some((type) =>
+            contentType.toLowerCase().includes(type)
+          )
+        ) {
+          throw new Error(
+            `URL returns HTML/web page content (Content-Type: ${contentType}). This tool only works with direct file URLs (PDFs, images, JSON, etc.). For web page content, first retrieve the content using the appropriate MCP tool or web scraper, then use inscribeFromBuffer to inscribe it.`
+          );
         }
-        
+
         if (contentLength && parseInt(contentLength) === 0) {
-          throw new Error('URL returns empty content (Content-Length: 0). Cannot inscribe empty content.');
+          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.`);
+          throw new Error(
+            `URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`
+          );
         }
-        
+
         if (!contentType || contentType === 'application/octet-stream') {
-          console.log(`[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`);
-          
+          console.log(
+            `[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`
+          );
+
           const getController = new AbortController();
           const getTimeoutId = setTimeout(() => getController.abort(), 5000);
-          
+
           try {
             const getResponse = await fetch(params.url, {
               signal: getController.signal,
               headers: {
-                'Range': 'bytes=0-1023' // Get first 1KB
-              }
+                Range: 'bytes=0-1023', // Get first 1KB
+              },
             });
-            
+
             clearTimeout(getTimeoutId);
-            
-            if (getResponse.ok || getResponse.status === 206) { // 206 is partial content
+
+            if (getResponse.ok || getResponse.status === 206) {
+              // 206 is partial content
               const buffer = await getResponse.arrayBuffer();
               const bytes = new Uint8Array(buffer);
-              const text = new TextDecoder('utf-8', { fatal: false }).decode(bytes.slice(0, 512));
-              
-              if (text.toLowerCase().includes('<!doctype html') || 
-                  text.toLowerCase().includes('<html') ||
-                  text.match(/<meta\s+[^>]*>/i) ||
-                  text.match(/<title>/i)) {
-                throw new Error(`URL returns HTML content. This tool only works with direct file URLs. For web page content, first retrieve it using the appropriate tool, then use inscribeFromBuffer.`);
+              const text = new TextDecoder('utf-8', { fatal: false }).decode(
+                bytes.slice(0, 512)
+              );
+
+              if (
+                text.toLowerCase().includes('<!doctype html') ||
+                text.toLowerCase().includes('<html') ||
+                text.match(/<meta\s+[^>]*>/i) ||
+                text.match(/<title>/i)
+              ) {
+                throw new Error(
+                  `URL returns HTML content. This tool only works with direct file URLs. For web page content, first retrieve it using the appropriate tool, then use inscribeFromBuffer.`
+                );
               }
             }
           } catch (getError) {
             clearTimeout(getTimeoutId);
-            if (getError instanceof Error && getError.message.includes('HTML content')) {
+            if (
+              getError instanceof Error &&
+              getError.message.includes('HTML content')
+            ) {
               throw getError;
             }
-            console.log(`[InscribeFromUrlTool] Could not perform partial GET validation: ${getError instanceof Error ? getError.message : 'Unknown error'}`);
+            console.log(
+              `[InscribeFromUrlTool] Could not perform partial GET validation: ${
+                getError instanceof Error ? getError.message : 'Unknown error'
+              }`
+            );
           }
         }
 
-        console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength || 'unknown'}`);
+        console.log(
+          `[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${
+            contentLength || 'unknown'
+          }`
+        );
       } catch (fetchError) {
         clearTimeout(timeoutId);
         throw fetchError;
@@ -168,11 +220,20 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
     } 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') || error.message.includes('HTML')) {
+          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') ||
+          error.message.includes('HTML')
+        ) {
           throw error;
         } else {
-          console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);
+          console.log(
+            `[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`
+          );
         }
       }
     }
@@ -182,11 +243,17 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
       metadata: params.metadata,
       tags: params.tags,
       chunkSize: params.chunkSize,
-      waitForConfirmation: params.quoteOnly ? false : (params.waitForConfirmation ?? true),
+      waitForConfirmation: params.quoteOnly
+        ? false
+        : params.waitForConfirmation ?? true,
       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',
       quoteOnly: params.quoteOnly,
     };
 
@@ -196,7 +263,7 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
           { type: 'url', url: params.url },
           options
         );
-        
+
         return {
           success: true,
           quote: {
@@ -207,22 +274,27 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
           contentInfo: {
             url: params.url,
           },
-          message: `Quote generated for URL: ${params.url}\nTotal cost: ${quote.totalCostHbar} HBAR`,
+          message: `Estimated Quote for URL: ${params.url}\nTotal cost: ${quote.totalCostHbar} HBAR`,
         };
       } catch (error) {
         const errorMessage =
-          error instanceof Error ? error.message : 'Failed to generate inscription quote';
+          error instanceof Error
+            ? error.message
+            : 'Failed to generate inscription quote';
         throw new Error(`Quote generation failed: ${errorMessage}`);
       }
     }
 
     try {
       let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;
-      
+
       if (params.timeoutMs) {
         const timeoutPromise = new Promise<never>((_, reject) => {
           setTimeout(
-            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
+            () =>
+              reject(
+                new Error(`Inscription timed out after ${params.timeoutMs}ms`)
+              ),
             params.timeoutMs
           );
         });
@@ -232,7 +304,7 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
             { type: 'url', url: params.url },
             options
           ),
-          timeoutPromise
+          timeoutPromise,
         ]);
       } else {
         result = await this.inscriberBuilder.inscribe(
@@ -242,18 +314,28 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
       }
 
       if (result.confirmed && !result.quote) {
-        const topicId = result.inscription?.topic_id || (result.result as any).topicId;
+        const topicId =
+          result.inscription?.topic_id || (result.result as any).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 as any).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 as any).transactionId
+        }\nTopic ID: ${topicId || 'N/A'}${
+          cdnUrl ? `\nView inscription: ${cdnUrl}` : ''
+        }\n\nThe inscription is now available.`;
       } else if (!result.quote && !result.confirmed) {
-        return `Successfully submitted inscription to the Hedera network!\n\nTransaction ID: ${(result.result as any).transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
+        return `Successfully submitted inscription to the Hedera network!\n\nTransaction ID: ${
+          (result.result as any).transactionId
+        }\n\nThe inscription is processing and will be confirmed shortly.`;
       } else {
         return 'Inscription operation completed.';
       }
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';
+      const errorMessage =
+        error instanceof Error ? error.message : 'Failed to inscribe from URL';
       throw new Error(`Inscription failed: ${errorMessage}`);
     }
   }
-}
+}

package/src/tools/inscriber/InscribeHashinalTool.ts

@@ -120,7 +120,7 @@ export class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribe
             creator: params.creator,
             type: params.type,
           },
-          message: `Quote generated for Hashinal NFT: ${params.name}\nCreator: ${params.creator}\nTotal cost: ${quote.totalCostHbar} HBAR`,
+          message: `Estimated Quote for Hashinal NFT: ${params.name}\nCreator: ${params.creator}\nTotal cost: ${quote.totalCostHbar} HBAR`,
         };
       } catch (error) {
         const errorMessage =