@hashgraphonline/standards-agent-kit 0.2.121 → 0.2.123

package/dist/umd/tools/hcs6/CreateDynamicRegistryTool.d.ts

@@ -7,15 +7,12 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  */
 declare const CreateDynamicRegistrySchema: z.ZodObject<{
     ttl: z.ZodDefault<z.ZodNumber>;
-    adminKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
     submitKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
 }, "strip", z.ZodTypeAny, {
     ttl: number;
-    adminKey?: string | boolean | undefined;
     submitKey?: string | boolean | undefined;
 }, {
     ttl?: number | undefined;
-    adminKey?: string | boolean | undefined;
     submitKey?: string | boolean | undefined;
 }>;
 export type CreateDynamicRegistryInput = z.infer<typeof CreateDynamicRegistrySchema>;
@@ -27,15 +24,12 @@ export declare class CreateDynamicRegistryTool extends BaseHCS6QueryTool<typeof
     description: string;
     get specificInputSchema(): z.ZodObject<{
         ttl: z.ZodDefault<z.ZodNumber>;
-        adminKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
         submitKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
     }, "strip", z.ZodTypeAny, {
         ttl: number;
-        adminKey?: string | boolean | undefined;
         submitKey?: string | boolean | undefined;
     }, {
         ttl?: number | undefined;
-        adminKey?: string | boolean | undefined;
         submitKey?: string | boolean | undefined;
     }>;
     constructor(params: HCS6QueryToolParams);

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.121",
+  "version": "0.2.123",
   "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,6 +21,33 @@
     "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",
@@ -63,7 +90,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.69.0",
-    "@hashgraphonline/standards-sdk": "file:.yalc/@hashgraphonline/standards-sdk",
+    "@hashgraphonline/standards-sdk": "^0.0.180",
     "@langchain/community": "^0.3.49",
     "@langchain/core": "^0.3.66",
     "@langchain/openai": "^0.6.3",
@@ -101,28 +128,5 @@
     "vite-plugin-node-polyfills": "^0.23.0",
     "vite-plugin-string-replace": "^1.1.3"
   },
-  "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",
-    "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"
-  }
-}
+  "packageManager": "pnpm@10.11.1+sha512.e519b9f7639869dc8d5c3c5dfef73b3f091094b0a006d7317353c72b124e80e1afd429732e28705ad6bfa1ee879c1fce46c128ccebd3192101f43dd67c667912"
+}

package/src/builders/hcs6/hcs6-builder.ts

@@ -32,7 +32,7 @@ export class HCS6Builder extends BaseServiceBuilder {
     if (!this.hcs6Client) {
       const operatorId = this.hederaKit.signer.getAccountId().toString();
       const operatorPrivateKey = this.hederaKit.signer?.getOperatorPrivateKey()
-        ? this.hederaKit.signer.getOperatorPrivateKey().toStringRaw()
+        ? this.hederaKit.signer.getOperatorPrivateKey().toString()
         : '';
 
       const network = this.hederaKit.client.network;
@@ -59,7 +59,11 @@ export class HCS6Builder extends BaseServiceBuilder {
     options: HCS6CreateRegistryOptions = {}
   ): Promise<HCS6TopicRegistrationResponse> {
     const client = await this.getHCS6Client();
-    return await client.createRegistry(options);
+    const sanitized = { ...options };
+    if ('adminKey' in sanitized) {
+      delete (sanitized as any).adminKey;
+    }
+    return await client.createRegistry(sanitized);
   }
 
   /**
@@ -91,7 +95,19 @@ export class HCS6Builder extends BaseServiceBuilder {
     options: HCS6CreateHashinalOptions
   ): Promise<HCS6CreateHashinalResponse> {
     const client = await this.getHCS6Client();
-    return await client.createHashinal(options);
+    const metadata = {
+      name: options.metadata?.name || 'Dynamic Hashinal',
+      creator:
+        options.metadata?.creator || this.hederaKit.signer.getAccountId().toString(),
+      description: options.metadata?.description || 'Dynamic hashinal metadata',
+      type: options.metadata?.type || 'json',
+      ...options.metadata,
+    } as Record<string, unknown>;
+
+    return await client.createHashinal({
+      ...options,
+      metadata,
+    });
   }
 
   /**
@@ -102,7 +118,20 @@ export class HCS6Builder extends BaseServiceBuilder {
     options: HCS6RegisterOptions
   ): Promise<HCS6CreateHashinalResponse> {
     const client = await this.getHCS6Client();
-    return await client.register(options);
+    const metadata = {
+      name: options.metadata?.name || 'Dynamic Hashinal',
+      creator:
+        options.metadata?.creator || this.hederaKit.signer.getAccountId().toString(),
+      description:
+        options.metadata?.description || 'Dynamic hashinal registration',
+      type: options.metadata?.type || 'json',
+      ...options.metadata,
+    } as Record<string, unknown>;
+
+    return await client.register({
+      ...options,
+      metadata,
+    });
   }
 
   /**

package/src/tools/hcs6/CreateDynamicRegistryTool.ts

@@ -7,14 +7,13 @@ import { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';
  * Schema for creating a dynamic hashinal registry
  */
 const CreateDynamicRegistrySchema = z.object({
-  ttl: z.number()
+  ttl: z
+    .number()
     .min(3600)
     .default(86400)
     .describe('Time-to-live in seconds (minimum 3600 seconds/1 hour)'),
-  adminKey: z.union([z.boolean(), z.string()])
-    .optional()
-    .describe('Admin key for the registry topic. Can be boolean (use operator key) or a public key string'),
-  submitKey: z.union([z.boolean(), z.string()])
+  submitKey: z
+    .union([z.boolean(), z.string()])
     .optional()
     .describe('Submit key for the registry topic. Can be boolean (use operator key) or a public key string'),
 });
@@ -42,7 +41,6 @@ export class CreateDynamicRegistryTool extends BaseHCS6QueryTool<typeof CreateDy
   ): Promise<unknown> {
     const result = await this.hcs6Builder.createRegistry({
       ttl: params.ttl,
-      adminKey: params.adminKey,
       submitKey: params.submitKey,
     });
 

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\nQuote valid until: ${new Date(quote.validUntil).toLocaleString()}`,
+        };
+      } 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

@@ -39,6 +39,11 @@ 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 +54,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;
@@ -61,7 +66,6 @@ export class InscribeFromFileTool extends BaseInscriberQueryTool<
   ): Promise<unknown> {
     console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);
     
-    // File validation
     let fileContent: Buffer;
     try {
       console.log(`[DEBUG] Checking file: ${params.filePath}`);
@@ -138,7 +142,7 @@ 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,10 +151,45 @@ 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\nQuote valid until: ${new Date(quote.validUntil).toLocaleString()}`,
+        };
+      } 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) => {
@@ -184,19 +223,22 @@ 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 =