@hashgraphonline/standards-agent-kit 0.2.122 → 0.2.124

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

@@ -12,7 +12,9 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
+    quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
+    quoteOnly: boolean;
     fileName: string;
     base64Data: string;
     tags?: string[] | undefined;
@@ -34,6 +36,7 @@ declare const inscribeFromBufferSchema: z.ZodObject<{
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
+    quoteOnly?: boolean | undefined;
 }>;
 export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {
     name: string;
@@ -50,7 +53,9 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         apiKey: z.ZodOptional<z.ZodString>;
+        quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
+        quoteOnly: boolean;
         fileName: string;
         base64Data: string;
         tags?: string[] | undefined;
@@ -72,6 +77,7 @@ export declare class InscribeFromBufferTool extends BaseInscriberQueryTool<typeo
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
         apiKey?: string | undefined;
+        quoteOnly?: boolean | undefined;
     }>;
     protected executeQuery(params: z.infer<typeof inscribeFromBufferSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
     private validateInput;

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

@@ -13,7 +13,9 @@ declare const inscribeFromFileSchema: z.ZodObject<{
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
+    quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
+    quoteOnly: boolean;
     filePath: string;
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -31,6 +33,7 @@ declare const inscribeFromFileSchema: z.ZodObject<{
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
+    quoteOnly?: boolean | undefined;
 }>;
 /**
  * Tool for inscribing content from file

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

@@ -13,8 +13,10 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
+    quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
+    quoteOnly: boolean;
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     mode?: "file" | "hashinal" | undefined;
@@ -31,6 +33,7 @@ declare const inscribeFromUrlSchema: z.ZodObject<{
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
+    quoteOnly?: boolean | undefined;
 }>;
 /**
  * Tool for inscribing content from URL
@@ -47,8 +50,10 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         apiKey: z.ZodOptional<z.ZodString>;
+        quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         url: string;
+        quoteOnly: boolean;
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
         mode?: "file" | "hashinal" | undefined;
@@ -65,6 +70,7 @@ export declare class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof i
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
         apiKey?: string | undefined;
+        quoteOnly?: boolean | undefined;
     }>;
     protected executeQuery(params: z.infer<typeof inscribeFromUrlSchema>, _runManager?: CallbackManagerForToolRun): Promise<unknown>;
 }

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

@@ -27,12 +27,14 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
+    quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     type: string;
     name: string;
     description: string;
     creator: string;
+    quoteOnly: boolean;
     tags?: string[] | undefined;
     properties?: Record<string, unknown> | undefined;
     chunkSize?: number | undefined;
@@ -56,6 +58,7 @@ declare const inscribeHashinalSchema: z.ZodObject<{
     waitForConfirmation?: boolean | undefined;
     timeoutMs?: number | undefined;
     apiKey?: string | undefined;
+    quoteOnly?: boolean | undefined;
     attributes?: {
         value: string | number;
         trait_type: string;
@@ -91,12 +94,14 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         waitForConfirmation: z.ZodOptional<z.ZodBoolean>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         apiKey: z.ZodOptional<z.ZodString>;
+        quoteOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         url: string;
         type: string;
         name: string;
         description: string;
         creator: string;
+        quoteOnly: boolean;
         tags?: string[] | undefined;
         properties?: Record<string, unknown> | undefined;
         chunkSize?: number | undefined;
@@ -120,6 +125,7 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool<typeof
         waitForConfirmation?: boolean | undefined;
         timeoutMs?: number | undefined;
         apiKey?: string | undefined;
+        quoteOnly?: boolean | undefined;
         attributes?: {
             value: string | number;
             trait_type: string;

package/dist/umd/tools/inscriber/base-inscriber-tools.d.ts

@@ -2,6 +2,7 @@ import { BaseHederaTransactionTool, BaseHederaQueryTool, BaseServiceBuilder } fr
 import { InscriberBuilder } from '../../builders/inscriber/inscriber-builder';
 import { InscriberTransactionToolParams, InscriberQueryToolParams } from './inscriber-tool-params';
 import { ContentResolverInterface } from '../../types/content-resolver';
+import { InscriptionInput, InscriptionOptions, QuoteResult } from '@hashgraphonline/standards-sdk';
 import { z } from 'zod';
 /**
  * Base class for Inscriber transaction tools
@@ -19,6 +20,13 @@ export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Generate a quote for an inscription without executing it
+     * @param input - The inscription input data
+     * @param options - Inscription options
+     * @returns Promise containing the quote result
+     */
+    protected generateInscriptionQuote(input: InscriptionInput, options: InscriptionOptions): Promise<QuoteResult>;
 }
 /**
  * Base class for Inscriber query tools
@@ -36,4 +44,11 @@ export declare abstract class BaseInscriberQueryTool<T extends z.ZodObject<z.Zod
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Generate a quote for an inscription without executing it
+     * @param input - The inscription input data
+     * @param options - Inscription options
+     * @returns Promise containing the quote result
+     */
+    protected generateInscriptionQuote(input: InscriptionInput, options: InscriptionOptions): Promise<QuoteResult>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.122",
+  "version": "0.2.124",
   "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",
@@ -43,6 +43,7 @@
     "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"
@@ -89,7 +90,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.69.0",
-    "@hashgraphonline/standards-sdk": "0.0.170",
+    "@hashgraphonline/standards-sdk": "^0.0.180",
     "@langchain/community": "^0.3.49",
     "@langchain/core": "^0.3.66",
     "@langchain/openai": "^0.6.3",

package/src/tools/inscriber/InscribeFromBufferTool.ts

@@ -47,6 +47,11 @@ const inscribeFromBufferSchema = z.object({
       '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'),
 });
 
 export class InscribeFromBufferTool extends BaseInscriberQueryTool<
@@ -54,7 +59,7 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
 > {
   name = 'inscribeFromBuffer';
   description =
-    'Inscribe content that you have already retrieved or displayed. When user says "inscribe it" after you showed search results or other content, use THIS tool. The base64Data field accepts PLAIN TEXT (not just base64) and content reference IDs in format "content-ref:[id]". Pass the EXACT content from your previous response or MCP tool output. DO NOT generate new content or create repetitive text. Content references are automatically resolved to the original content for inscription.';
+    'Inscribe content that you have already retrieved or displayed. When user says "inscribe it" after you showed search results or other content, use THIS tool. The base64Data field accepts PLAIN TEXT (not just base64) and content reference IDs in format "content-ref:[id]". Pass the EXACT content from your previous response or MCP tool output. DO NOT generate new content or create repetitive text. Content references are automatically resolved to the original content for inscription. Set quoteOnly=true to get cost estimates without executing the inscription.';
 
   private config = loadConfig();
 
@@ -85,7 +90,7 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
       metadata: params.metadata,
       tags: params.tags,
       chunkSize: params.chunkSize,
-      waitForConfirmation: params.waitForConfirmation ?? true,
+      waitForConfirmation: params.quoteOnly ? false : (params.waitForConfirmation ?? true),
       waitMaxAttempts: 10,
       waitIntervalMs: 3000,
       apiKey: params.apiKey,
@@ -94,8 +99,42 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
         .includes('mainnet')
         ? 'mainnet'
         : 'testnet',
+      quoteOnly: params.quoteOnly,
     };
 
+    if (params.quoteOnly) {
+      try {
+        const quote = await this.generateInscriptionQuote(
+          {
+            type: 'buffer',
+            buffer,
+            fileName: resolvedFileName,
+            mimeType: resolvedMimeType,
+          },
+          options
+        );
+        
+        return {
+          success: true,
+          quote: {
+            totalCostHbar: quote.totalCostHbar,
+            validUntil: quote.validUntil,
+            breakdown: quote.breakdown,
+          },
+          contentInfo: {
+            fileName: resolvedFileName,
+            mimeType: resolvedMimeType,
+            sizeBytes: buffer.length,
+          },
+          message: `Quote generated for buffer content: ${resolvedFileName} (${(buffer.length / 1024).toFixed(2)} KB)\nTotal cost: ${quote.totalCostHbar} HBAR`,
+        };
+      } catch (error) {
+        const errorMessage =
+          error instanceof Error ? error.message : 'Failed to generate inscription quote';
+        throw new Error(`Quote generation failed: ${errorMessage}`);
+      }
+    }
+
     const timeoutMs =
       params.timeoutMs || (options.waitForConfirmation ? 60000 : undefined);
 
@@ -210,20 +249,24 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
     result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>,
     options: InscriptionOptions
   ): string {
-    if (result.confirmed) {
-      const topicId = result.inscription?.topic_id || result.result.topicId;
+    if (result.confirmed && !result.quote) {
+      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.transactionId
+        (result.result as any).transactionId
       }\nTopic ID: ${topicId || 'N/A'}${
         cdnUrl ? `\nView inscription: ${cdnUrl}` : ''
       }\n\nThe inscription is now available.`;
     }
 
-    return `Successfully submitted inscription to the Hedera network!\n\nTransaction ID: ${result.result.transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
+    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 'Inscription operation completed.';
   }
 
   private async resolveContent(
@@ -238,11 +281,9 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
   }> {
     const trimmedInput = input.trim();
     
-    // Try to get resolver from either injected dependency or registry
     const resolver = this.getContentResolver() || ContentResolverRegistry.getResolver();
     
     if (!resolver) {
-      // No resolver available, handle content directly
       return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);
     }
     
@@ -267,7 +308,6 @@ export class InscribeFromBufferTool extends BaseInscriberQueryTool<
       }
     }
 
-    // No reference found, handle as direct content
     return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);
   }
 

package/src/tools/inscriber/InscribeFromFileTool.ts

@@ -9,7 +9,12 @@ import * as path from 'path';
  * Schema for inscribing from file
  */
 const inscribeFromFileSchema = z.object({
-  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.'),
+  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()
@@ -39,6 +44,13 @@ const inscribeFromFileSchema = z.object({
     .optional()
     .describe('Timeout in milliseconds for inscription (default: no timeout)'),
   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'
+    ),
 });
 
 /**
@@ -49,7 +61,7 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
 > {
   name = 'inscribeFromFile';
   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.';
+    '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. Set quoteOnly=true to get cost estimates without executing the inscription.';
 
   get specificInputSchema(): typeof inscribeFromFileSchema {
     return inscribeFromFileSchema;
@@ -59,9 +71,10 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
     params: z.infer<typeof inscribeFromFileSchema>,
     _runManager?: CallbackManagerForToolRun
   ): Promise<unknown> {
-    console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);
-    
-    // File validation
+    console.log(
+      `[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`
+    );
+
     let fileContent: Buffer;
     try {
       console.log(`[DEBUG] Checking file: ${params.filePath}`);
@@ -87,7 +100,12 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
       }
 
       if (stats.size > 100 * 1024 * 1024) {
-        console.log(`[InscribeFromFileTool] WARNING: Large file detected (${(stats.size / (1024 * 1024)).toFixed(2)} MB)`);
+        console.log(
+          `[InscribeFromFileTool] WARNING: Large file detected (${(
+            stats.size /
+            (1024 * 1024)
+          ).toFixed(2)} MB)`
+        );
       }
 
       this.logger?.info('Reading file content...');
@@ -109,7 +127,11 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
       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));
+        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.`
@@ -138,7 +160,9 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
       metadata: params.metadata,
       tags: params.tags,
       chunkSize: params.chunkSize,
-      waitForConfirmation: params.waitForConfirmation ?? true,
+      waitForConfirmation: params.quoteOnly
+        ? false
+        : params.waitForConfirmation ?? true,
       waitMaxAttempts: 10,
       waitIntervalMs: 3000,
       apiKey: params.apiKey,
@@ -147,15 +171,59 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
         .includes('mainnet')
         ? 'mainnet'
         : 'testnet',
+      quoteOnly: params.quoteOnly,
     };
 
+    if (params.quoteOnly) {
+      try {
+        const quote = await this.generateInscriptionQuote(
+          {
+            type: 'buffer',
+            buffer: Buffer.from(base64Data, 'base64'),
+            fileName,
+            mimeType,
+          },
+          options
+        );
+
+        return {
+          success: true,
+          quote: {
+            totalCostHbar: quote.totalCostHbar,
+            validUntil: quote.validUntil,
+            breakdown: quote.breakdown,
+          },
+          contentInfo: {
+            fileName,
+            mimeType,
+            sizeBytes: fileContent.length,
+            filePath: params.filePath,
+          },
+          message: `Quote generated for file: ${fileName} (${(
+            fileContent.length / 1024
+          ).toFixed(2)} KB)\nTotal cost: ${
+            quote.totalCostHbar
+          } HBAR`,
+        };
+      } catch (error) {
+        const errorMessage =
+          error instanceof Error
+            ? error.message
+            : 'Failed to generate inscription quote';
+        throw new Error(`Quote generation failed: ${errorMessage}`);
+      }
+    }
+
     try {
-      let result: any;
-      
+      let result: unknown;
+
       if (params.timeoutMs) {
         const timeoutPromise = new Promise((_, reject) => {
           setTimeout(
-            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
+            () =>
+              reject(
+                new Error(`Inscription timed out after ${params.timeoutMs}ms`)
+              ),
             params.timeoutMs
           );
         });
@@ -184,19 +252,24 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
         );
       }
 
-      if (result.confirmed) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
+      const inscriptionResult = result as any;
+      if (inscriptionResult.confirmed && !inscriptionResult.quote) {
+        const topicId =
+          inscriptionResult.inscription?.topic_id ||
+          inscriptionResult.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
+          inscriptionResult.result.transactionId
         }\nTopic ID: ${topicId || 'N/A'}${
           cdnUrl ? `\nView inscription: ${cdnUrl}` : ''
         }\n\nThe inscription is now available.`;
+      } else if (!inscriptionResult.quote && !inscriptionResult.confirmed) {
+        return `Successfully submitted inscription to the Hedera network!\n\nTransaction ID: ${inscriptionResult.result.transactionId}\n\nThe inscription is processing and will be confirmed shortly.`;
       } 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.`;
+        return 'Inscription operation completed.';
       }
     } catch (error) {
       const errorMessage =

package/src/tools/inscriber/InscribeFromUrlTool.ts

@@ -40,6 +40,11 @@ const inscribeFromUrlSchema = z.object({
     .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'),
 });
 
 
@@ -48,7 +53,7 @@ const inscribeFromUrlSchema = z.object({
  */
 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.';
+  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;
@@ -86,7 +91,6 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
       const timeoutId = setTimeout(() => controller.abort(), 10000);
       
       try {
-        // First try HEAD request
         const headResponse = await fetch(params.url, {
           method: 'HEAD',
           signal: controller.signal,
@@ -101,7 +105,6 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
         const contentType = headResponse.headers.get('content-type') || '';
         const contentLength = headResponse.headers.get('content-length');
         
-        // Check if content type indicates HTML/web page
         const webPageContentTypes = [
           'text/html',
           'application/xhtml+xml',
@@ -120,7 +123,6 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
           throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);
         }
         
-        // If HEAD doesn't provide content-type, do a partial GET to check
         if (!contentType || contentType === 'application/octet-stream') {
           console.log(`[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`);
           
@@ -142,7 +144,6 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
               const bytes = new Uint8Array(buffer);
               const text = new TextDecoder('utf-8', { fatal: false }).decode(bytes.slice(0, 512));
               
-              // Check if it looks like HTML
               if (text.toLowerCase().includes('<!doctype html') || 
                   text.toLowerCase().includes('<html') ||
                   text.match(/<meta\s+[^>]*>/i) ||
@@ -155,7 +156,6 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
             if (getError instanceof Error && getError.message.includes('HTML content')) {
               throw getError;
             }
-            // If partial GET fails, continue anyway
             console.log(`[InscribeFromUrlTool] Could not perform partial GET validation: ${getError instanceof Error ? getError.message : 'Unknown error'}`);
           }
         }
@@ -182,13 +182,40 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
       metadata: params.metadata,
       tags: params.tags,
       chunkSize: params.chunkSize,
-      waitForConfirmation: 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',
+      quoteOnly: params.quoteOnly,
     };
 
+    if (params.quoteOnly) {
+      try {
+        const quote = await this.generateInscriptionQuote(
+          { type: 'url', url: params.url },
+          options
+        );
+        
+        return {
+          success: true,
+          quote: {
+            totalCostHbar: quote.totalCostHbar,
+            validUntil: quote.validUntil,
+            breakdown: quote.breakdown,
+          },
+          contentInfo: {
+            url: params.url,
+          },
+          message: `Quote generated for URL: ${params.url}\nTotal cost: ${quote.totalCostHbar} HBAR`,
+        };
+      } catch (error) {
+        const errorMessage =
+          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>>;
       
@@ -214,13 +241,15 @@ export class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeF
         );
       }
 
-      if (result.confirmed) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
+      if (result.confirmed && !result.quote) {
+        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.transactionId}\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\nView inscription: ${cdnUrl}` : ''}\n\nThe inscription is now available.`;
+        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.`;
       } 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.`;
+        return 'Inscription operation completed.';
       }
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';