npm - @hashgraphonline/standards-agent-kit - Versions diffs - 0.2.121 → 0.2.123 - Mend

@hashgraphonline/standards-agent-kit 0.2.121 → 0.2.123

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (44) hide show

package/dist/cjs/tools/hcs6/CreateDynamicRegistryTool.d.ts CHANGED Viewed

@@ -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/cjs/tools/inscriber/InscribeFromBufferTool.d.ts CHANGED Viewed

@@ -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/cjs/tools/inscriber/InscribeFromFileTool.d.ts CHANGED Viewed

@@ -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/cjs/tools/inscriber/InscribeFromUrlTool.d.ts CHANGED Viewed

@@ -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/cjs/tools/inscriber/InscribeHashinalTool.d.ts CHANGED Viewed

@@ -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/cjs/tools/inscriber/base-inscriber-tools.d.ts CHANGED Viewed

@@ -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/dist/es/standards-agent-kit.es29.js CHANGED Viewed

@@ -2,7 +2,6 @@ import { z } from "zod";
 import { BaseHCS6QueryTool } from "./standards-agent-kit.es28.js";
 const CreateDynamicRegistrySchema = z.object({
   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()]).optional().describe("Submit key for the registry topic. Can be boolean (use operator key) or a public key string")
 });
 class CreateDynamicRegistryTool extends BaseHCS6QueryTool {
@@ -17,7 +16,6 @@ class CreateDynamicRegistryTool extends BaseHCS6QueryTool {
   async executeQuery(params, _runManager) {
     const result = await this.hcs6Builder.createRegistry({
       ttl: params.ttl,
-      adminKey: params.adminKey,
       submitKey: params.submitKey
     });
     if (!result.success) {

package/dist/es/standards-agent-kit.es29.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"standards-agent-kit.es29.js","sources":["../../src/tools/hcs6/CreateDynamicRegistryTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS6QueryTool } from './base-hcs6-tools';\nimport { HCS6QueryToolParams } from './hcs6-tool-params';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/*\n Schema for creating a dynamic hashinal registry\n /\nconst CreateDynamicRegistrySchema = z.object({\n ttl: z.number()\n .min(3600)\n .default(86400)\n .describe('Time-to-live in seconds (minimum 3600 seconds/1 hour)'),\n ~~adminKey~~: z~~.union([z.boolean(), z.string()])~~\n .~~optional()\n .describe('Admin key for the registry topic. Can be boolean (use operator key) or a public key string'),\n submitKey: z.~~union([z.boolean(), z.string()])\n .optional()\n .describe('Submit key for the registry topic. Can be boolean (use operator key) or a public key string'),\n});\n\nexport type CreateDynamicRegistryInput = z.infer<typeof CreateDynamicRegistrySchema>;\n\n/\n Tool for creating HCS-6 dynamic registries\n */\nexport class CreateDynamicRegistryTool extends BaseHCS6QueryTool<typeof CreateDynamicRegistrySchema> {\n name = 'createDynamicRegistry';\n description = 'Create a new HCS-6 dynamic registry for managing evolving content';\n \n get specificInputSchema() {\n return CreateDynamicRegistrySchema;\n }\n\n constructor(params: HCS6QueryToolParams) {\n super(params);\n }\n\n protected async executeQuery(\n params: CreateDynamicRegistryInput,\n _runManager?: CallbackManagerForToolRun\n ): Promise<unknown> {\n const result = await this.hcs6Builder.createRegistry({\n ttl: params.ttl,\n ~~adminKey: params.adminKey,\n~~ submitKey: params.submitKey,\n });\n\n if (!result.success) {\n throw new Error(result.error \|\| 'Failed to create dynamic registry');\n }\n\n return `Successfully created HCS-6 dynamic registry!\\n\\nTopic ID: ${result.topicId}\\nTTL: ${params.ttl} seconds\\n\\nYou can now register dynamic hashinals to this registry using the topic ID.`;\n }\n}"],"names":[],"mappings":";;AAQA,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,KAAK,~~EAAE~~,OAAA,~~EACJ~~,IAAI,IAAI,EACR,QAAQ,KAAK,EACb,SAAS,uDAAuD;AAAA,EACnE,~~UAAU,EAAE,MAAM,CAAC,EAAE,QAAA,GAAW,EAAE,OAAA,CAAQ,CAAC,EACxC,SAAA,EACA,SAAS,4FAA4F;AAAA,EACxG,~~WAAW,~~EAAE~~,MAAM,CAAC,EAAE,QAAA,GAAW,EAAE,OAAA,CAAQ,CAAC,~~EACzC~~,SAAA,EACA,SAAS,6FAA6F;AAC3G,CAAC;AAOM,MAAM,kCAAkC,kBAAsD;AAAA,EAQnG,YAAY,QAA6B;AACvC,UAAM,MAAM;AARd,SAAA,OAAO;AACP,SAAA,cAAc;AAAA,EAQd;AAAA,EANA,IAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAAA,EAMA,MAAgB,aACd,QACA,aACkB;AAClB,UAAM,SAAS,MAAM,KAAK,YAAY,eAAe;AAAA,MACnD,KAAK,OAAO;AAAA,MACZ,~~UAAU,OAAO;AAAA,MACjB,~~WAAW,OAAO;AAAA,IAAA,CACnB;AAED,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI,MAAM,OAAO,SAAS,mCAAmC;AAAA,IACrE;AAEA,WAAO;AAAA;AAAA,YAA6D,OAAO,OAAO;AAAA,OAAU,OAAO,GAAG;AAAA;AAAA;AAAA,EACxG;AACF;"}
1	+ {"version":3,"file":"standards-agent-kit.es29.js","sources":["../../src/tools/hcs6/CreateDynamicRegistryTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS6QueryTool } from './base-hcs6-tools';\nimport { HCS6QueryToolParams } from './hcs6-tool-params';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/*\n Schema for creating a dynamic hashinal registry\n /\nconst CreateDynamicRegistrySchema = z.object({\n ttl: z\n .number()\n .min(3600)\n .default(86400)\n .describe('Time-to-live in seconds (minimum 3600 seconds/1 hour)'),\n submitKey: z\n .union([z.boolean(), z.string()])\n .optional()\n .describe('Submit key for the registry topic. Can be boolean (use operator key) or a public key string'),\n});\n\nexport type CreateDynamicRegistryInput = z.infer<typeof CreateDynamicRegistrySchema>;\n\n/\n Tool for creating HCS-6 dynamic registries\n */\nexport class CreateDynamicRegistryTool extends BaseHCS6QueryTool<typeof CreateDynamicRegistrySchema> {\n name = 'createDynamicRegistry';\n description = 'Create a new HCS-6 dynamic registry for managing evolving content';\n \n get specificInputSchema() {\n return CreateDynamicRegistrySchema;\n }\n\n constructor(params: HCS6QueryToolParams) {\n super(params);\n }\n\n protected async executeQuery(\n params: CreateDynamicRegistryInput,\n _runManager?: CallbackManagerForToolRun\n ): Promise<unknown> {\n const result = await this.hcs6Builder.createRegistry({\n ttl: params.ttl,\n submitKey: params.submitKey,\n });\n\n if (!result.success) {\n throw new Error(result.error \|\| 'Failed to create dynamic registry');\n }\n\n return `Successfully created HCS-6 dynamic registry!\\n\\nTopic ID: ${result.topicId}\\nTTL: ${params.ttl} seconds\\n\\nYou can now register dynamic hashinals to this registry using the topic ID.`;\n }\n}"],"names":[],"mappings":";;AAQA,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,KAAK,EACF,OAAA,EACA,IAAI,IAAI,EACR,QAAQ,KAAK,EACb,SAAS,uDAAuD;AAAA,EACnE,WAAW,EACR,MAAM,CAAC,EAAE,QAAA,GAAW,EAAE,OAAA,CAAQ,CAAC,EAC/B,SAAA,EACA,SAAS,6FAA6F;AAC3G,CAAC;AAOM,MAAM,kCAAkC,kBAAsD;AAAA,EAQnG,YAAY,QAA6B;AACvC,UAAM,MAAM;AARd,SAAA,OAAO;AACP,SAAA,cAAc;AAAA,EAQd;AAAA,EANA,IAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAAA,EAMA,MAAgB,aACd,QACA,aACkB;AAClB,UAAM,SAAS,MAAM,KAAK,YAAY,eAAe;AAAA,MACnD,KAAK,OAAO;AAAA,MACZ,WAAW,OAAO;AAAA,IAAA,CACnB;AAED,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI,MAAM,OAAO,SAAS,mCAAmC;AAAA,IACrE;AAEA,WAAO;AAAA;AAAA,YAA6D,OAAO,OAAO;AAAA,OAAU,OAAO,GAAG;AAAA;AAAA;AAAA,EACxG;AACF;"}

package/dist/es/standards-agent-kit.es33.js CHANGED Viewed

@@ -18,6 +18,28 @@ class BaseInscriberTransactionTool extends BaseHederaTransactionTool {
   getContentResolver() {
     return this.contentResolver;
   }
+  /**
+   * 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
+   */
+  async generateInscriptionQuote(input, options) {
+    this.inscriberBuilder["hederaKit"].signer.getAccountId().toString();
+    this.inscriberBuilder["hederaKit"].signer?.getOperatorPrivateKey() ? this.inscriberBuilder["hederaKit"].signer.getOperatorPrivateKey().toStringRaw() : "";
+    const network = this.inscriberBuilder["hederaKit"].client.network;
+    const networkType = network.toString().includes("mainnet") ? "mainnet" : "testnet";
+    const quoteOptions = {
+      ...options,
+      quoteOnly: true,
+      network: networkType
+    };
+    const result = await this.inscriberBuilder.inscribe(input, quoteOptions);
+    if (!result.quote || result.confirmed) {
+      throw new Error("Failed to generate quote - unexpected response type");
+    }
+    return result.result;
+  }
 }
 class BaseInscriberQueryTool extends BaseHederaQueryTool {
   constructor(params) {
@@ -38,6 +60,28 @@ class BaseInscriberQueryTool extends BaseHederaQueryTool {
   getContentResolver() {
     return this.contentResolver;
   }
+  /**
+   * 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
+   */
+  async generateInscriptionQuote(input, options) {
+    this.inscriberBuilder["hederaKit"].signer.getAccountId().toString();
+    this.inscriberBuilder["hederaKit"].signer?.getOperatorPrivateKey() ? this.inscriberBuilder["hederaKit"].signer.getOperatorPrivateKey().toStringRaw() : "";
+    const network = this.inscriberBuilder["hederaKit"].client.network;
+    const networkType = network.toString().includes("mainnet") ? "mainnet" : "testnet";
+    const quoteOptions = {
+      ...options,
+      quoteOnly: true,
+      network: networkType
+    };
+    const result = await this.inscriberBuilder.inscribe(input, quoteOptions);
+    if (!result.quote || result.confirmed) {
+      throw new Error("Failed to generate quote - unexpected response type");
+    }
+    return result.result;
+  }
 }
 export {
   BaseInscriberQueryTool,

package/dist/es/standards-agent-kit.es33.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"standards-agent-kit.es33.js","sources":["../../src/tools/inscriber/base-inscriber-tools.ts"],"sourcesContent":["import {\n BaseHederaTransactionTool,\n BaseHederaQueryTool,\n BaseServiceBuilder,\n} from 'hedera-agent-kit';\nimport { InscriberBuilder } from '../../builders/inscriber/inscriber-builder';\nimport {\n InscriberTransactionToolParams,\n InscriberQueryToolParams,\n} from './inscriber-tool-params';\nimport type { ContentResolverInterface } from '../../types/content-resolver';\nimport { z } from 'zod';\n\n/*\n Base class for Inscriber transaction tools\n /\nexport abstract class BaseInscriberTransactionTool<\n T extends z.ZodObject<\n z.ZodRawShape,\n z.UnknownKeysParam,\n z.ZodTypeAny\n > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaTransactionTool<T> {\n protected inscriberBuilder: InscriberBuilder;\n protected contentResolver: ContentResolverInterface \| null;\n namespace = 'inscriber' as const;\n\n constructor(params: InscriberTransactionToolParams) {\n super(params);\n this.inscriberBuilder = params.inscriberBuilder;\n this.contentResolver = params.contentResolver \|\| null;\n }\n\n /\n Override to return the InscriberBuilder\n /\n protected getServiceBuilder(): BaseServiceBuilder {\n return this.inscriberBuilder;\n }\n\n /\n Get content resolver with fallback to registry\n /\n protected getContentResolver(): ContentResolverInterface \| null {\n return this.contentResolver;\n }\n}\n\n/\n Base class for Inscriber query tools\n /\nexport abstract class BaseInscriberQueryTool<\n T extends z.ZodObject<\n z.ZodRawShape,\n z.UnknownKeysParam,\n z.ZodTypeAny\n > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaQueryTool<T> {\n protected inscriberBuilder: InscriberBuilder;\n protected contentResolver: ContentResolverInterface \| null;\n namespace = 'inscriber' as const;\n\n constructor(params: InscriberQueryToolParams) {\n super(params);\n this.inscriberBuilder = params.inscriberBuilder;\n this.contentResolver = params.contentResolver \|\| null;\n }\n\n /\n Override to return the InscriberBuilder\n /\n protected getServiceBuilder(): BaseServiceBuilder {\n return this.inscriberBuilder;\n }\n\n /\n Get content resolver with fallback to registry\n */\n protected getContentResolver(): ContentResolverInterface \| null {\n return this.contentResolver;\n }\n}"],"names":[],"mappings":";~~AAgBO~~,MAAe,qCAMZ,0BAA6B;AAAA,EAKrC,YAAY,QAAwC;AAClD,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAC/B,SAAK,kBAAkB,OAAO,mBAAmB;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKU,qBAAsD;AAC9D,WAAO,KAAK;AAAA,EACd;AACF;AAKO,MAAe,+BAMZ,oBAAuB;AAAA,EAK/B,YAAY,QAAkC;AAC5C,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAC/B,SAAK,kBAAkB,OAAO,mBAAmB;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKU,qBAAsD;AAC9D,WAAO,KAAK;AAAA,EACd;AACF;"}
1	+ {"version":3,"file":"standards-agent-kit.es33.js","sources":["../../src/tools/inscriber/base-inscriber-tools.ts"],"sourcesContent":["import {\n BaseHederaTransactionTool,\n BaseHederaQueryTool,\n BaseServiceBuilder,\n} from 'hedera-agent-kit';\nimport { InscriberBuilder } from '../../builders/inscriber/inscriber-builder';\nimport {\n InscriberTransactionToolParams,\n InscriberQueryToolParams,\n} from './inscriber-tool-params';\nimport type { ContentResolverInterface } from '../../types/content-resolver';\nimport {\n InscriptionInput,\n InscriptionOptions,\n QuoteResult,\n} from '@hashgraphonline/standards-sdk';\nimport { z } from 'zod';\n\n/*\n Base class for Inscriber transaction tools\n /\nexport abstract class BaseInscriberTransactionTool<\n T extends z.ZodObject<\n z.ZodRawShape,\n z.UnknownKeysParam,\n z.ZodTypeAny\n > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaTransactionTool<T> {\n protected inscriberBuilder: InscriberBuilder;\n protected contentResolver: ContentResolverInterface \| null;\n namespace = 'inscriber' as const;\n\n constructor(params: InscriberTransactionToolParams) {\n super(params);\n this.inscriberBuilder = params.inscriberBuilder;\n this.contentResolver = params.contentResolver \|\| null;\n }\n\n /\n Override to return the InscriberBuilder\n /\n protected getServiceBuilder(): BaseServiceBuilder {\n return this.inscriberBuilder;\n }\n\n /\n Get content resolver with fallback to registry\n /\n protected getContentResolver(): ContentResolverInterface \| null {\n return this.contentResolver;\n }\n\n /\n Generate a quote for an inscription without executing it\n * @param input - The inscription input data\n * @param options - Inscription options\n * @returns Promise containing the quote result\n /\n protected async generateInscriptionQuote(\n input: InscriptionInput,\n options: InscriptionOptions\n ): Promise<QuoteResult> {\n const operatorId = this.inscriberBuilder['hederaKit'].signer.getAccountId().toString();\n const operatorPrivateKey = this.inscriberBuilder['hederaKit'].signer?.getOperatorPrivateKey()\n ? this.inscriberBuilder['hederaKit'].signer.getOperatorPrivateKey().toStringRaw()\n : '';\n\n const network = this.inscriberBuilder['hederaKit'].client.network;\n const networkType = network.toString().includes('mainnet')\n ? 'mainnet'\n : 'testnet';\n\n const clientConfig = {\n accountId: operatorId,\n privateKey: operatorPrivateKey,\n network: networkType as 'mainnet' \| 'testnet',\n };\n\n const quoteOptions = {\n ...options,\n quoteOnly: true,\n network: networkType as 'mainnet' \| 'testnet',\n };\n\n const result = await this.inscriberBuilder.inscribe(input, quoteOptions);\n \n if (!result.quote \|\| result.confirmed) {\n throw new Error('Failed to generate quote - unexpected response type');\n }\n\n return result.result as QuoteResult;\n }\n}\n\n/\n Base class for Inscriber query tools\n /\nexport abstract class BaseInscriberQueryTool<\n T extends z.ZodObject<\n z.ZodRawShape,\n z.UnknownKeysParam,\n z.ZodTypeAny\n > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaQueryTool<T> {\n protected inscriberBuilder: InscriberBuilder;\n protected contentResolver: ContentResolverInterface \| null;\n namespace = 'inscriber' as const;\n\n constructor(params: InscriberQueryToolParams) {\n super(params);\n this.inscriberBuilder = params.inscriberBuilder;\n this.contentResolver = params.contentResolver \|\| null;\n }\n\n /\n Override to return the InscriberBuilder\n /\n protected getServiceBuilder(): BaseServiceBuilder {\n return this.inscriberBuilder;\n }\n\n /\n Get content resolver with fallback to registry\n /\n protected getContentResolver(): ContentResolverInterface \| null {\n return this.contentResolver;\n }\n\n /\n Generate a quote for an inscription without executing it\n * @param input - The inscription input data\n * @param options - Inscription options\n * @returns Promise containing the quote result\n */\n protected async generateInscriptionQuote(\n input: InscriptionInput,\n options: InscriptionOptions\n ): Promise<QuoteResult> {\n const operatorId = this.inscriberBuilder['hederaKit'].signer.getAccountId().toString();\n const operatorPrivateKey = this.inscriberBuilder['hederaKit'].signer?.getOperatorPrivateKey()\n ? this.inscriberBuilder['hederaKit'].signer.getOperatorPrivateKey().toStringRaw()\n : '';\n\n const network = this.inscriberBuilder['hederaKit'].client.network;\n const networkType = network.toString().includes('mainnet')\n ? 'mainnet'\n : 'testnet';\n\n const clientConfig = {\n accountId: operatorId,\n privateKey: operatorPrivateKey,\n network: networkType as 'mainnet' \| 'testnet',\n };\n\n const quoteOptions = {\n ...options,\n quoteOnly: true,\n network: networkType as 'mainnet' \| 'testnet',\n };\n\n const result = await this.inscriberBuilder.inscribe(input, quoteOptions);\n \n if (!result.quote \|\| result.confirmed) {\n throw new Error('Failed to generate quote - unexpected response type');\n }\n\n return result.result as QuoteResult;\n }\n}"],"names":[],"mappings":";AAqBO,MAAe,qCAMZ,0BAA6B;AAAA,EAKrC,YAAY,QAAwC;AAClD,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAC/B,SAAK,kBAAkB,OAAO,mBAAmB;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKU,qBAAsD;AAC9D,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAgB,yBACd,OACA,SACsB;AACH,SAAK,iBAAiB,WAAW,EAAE,OAAO,aAAA,EAAe,SAAA;AACjD,SAAK,iBAAiB,WAAW,EAAE,QAAQ,sBAAA,IAClE,KAAK,iBAAiB,WAAW,EAAE,OAAO,sBAAA,EAAwB,gBAClE;AAEJ,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAQJ,UAAM,eAAe;AAAA,MACnB,GAAG;AAAA,MACH,WAAW;AAAA,MACX,SAAS;AAAA,IAAA;AAGX,UAAM,SAAS,MAAM,KAAK,iBAAiB,SAAS,OAAO,YAAY;AAEvE,QAAI,CAAC,OAAO,SAAS,OAAO,WAAW;AACrC,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,WAAO,OAAO;AAAA,EAChB;AACF;AAKO,MAAe,+BAMZ,oBAAuB;AAAA,EAK/B,YAAY,QAAkC;AAC5C,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAC/B,SAAK,kBAAkB,OAAO,mBAAmB;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKU,qBAAsD;AAC9D,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAgB,yBACd,OACA,SACsB;AACH,SAAK,iBAAiB,WAAW,EAAE,OAAO,aAAA,EAAe,SAAA;AACjD,SAAK,iBAAiB,WAAW,EAAE,QAAQ,sBAAA,IAClE,KAAK,iBAAiB,WAAW,EAAE,OAAO,sBAAA,EAAwB,gBAClE;AAEJ,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAQJ,UAAM,eAAe;AAAA,MACnB,GAAG;AAAA,MACH,WAAW;AAAA,MACX,SAAS;AAAA,IAAA;AAGX,UAAM,SAAS,MAAM,KAAK,iBAAiB,SAAS,OAAO,YAAY;AAEvE,QAAI,CAAC,OAAO,SAAS,OAAO,WAAW;AACrC,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,WAAO,OAAO;AAAA,EAChB;AACF;"}

package/dist/es/standards-agent-kit.es34.js CHANGED Viewed

@@ -8,13 +8,14 @@ const inscribeFromUrlSchema = z.object({
   chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
   waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
   timeoutMs: z.number().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")
+  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")
 });
 class InscribeFromUrlTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeFromUrl";
-    this.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.';
+    this.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;
@@ -117,12 +118,38 @@ class InscribeFromUrlTool 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: 3e3,
       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
     };
+    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}
+Total cost: ${quote.totalCostHbar} HBAR
+Quote 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;
       if (params.timeoutMs) {
@@ -145,7 +172,7 @@ class InscribeFromUrlTool extends BaseInscriberQueryTool {
           options
         );
       }
-      if (result.confirmed) {
+      if (result.confirmed && !result.quote) {
         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;
@@ -156,12 +183,14 @@ Topic ID: ${topicId || "N/A"}${cdnUrl ? `
 View inscription: ${cdnUrl}` : ""}
 The inscription is now available.`;
-      } else {
+      } else if (!result.quote && !result.confirmed) {
         return `Successfully submitted inscription to the Hedera network!
 Transaction ID: ${result.result.transactionId}
 The 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";

package/dist/es/standards-agent-kit.es34.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"standards-agent-kit.es34.js","sources":["../../src/tools/inscriber/InscribeFromUrlTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseInscriberQueryTool } from './base-inscriber-tools';\nimport { InscriptionOptions } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/*\n Schema for inscribing from URL\n /\nconst inscribeFromUrlSchema = z.object({\n 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.'),\n mode: z\n .enum(['file', 'hashinal'])\n .optional()\n .describe('Inscription mode: file or hashinal NFT'),\n metadata: z\n .record(z.unknown())\n .optional()\n .describe('Metadata to attach to the inscription'),\n tags: z\n .array(z.string())\n .optional()\n .describe('Tags to categorize the inscription'),\n chunkSize: z\n .number()\n .int()\n .positive()\n .optional()\n .describe('Chunk size for large files'),\n waitForConfirmation: z\n .boolean()\n .optional()\n .describe('Whether to wait for inscription confirmation'),\n timeoutMs: z\n .number()\n .int()\n .positive()\n .optional()\n .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),\n apiKey: z\n .string()\n .optional()\n .describe('API key for inscription service'),\n});\n\n\n/\n Tool for inscribing content from URL\n /\nexport class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {\n name = 'inscribeFromUrl';\n 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.';\n\n get specificInputSchema() {\n return inscribeFromUrlSchema;\n }\n\n protected async executeQuery(\n params: z.infer<typeof inscribeFromUrlSchema>,\n _runManager?: CallbackManagerForToolRun\n ): Promise<unknown> {\n console.log(`[DEBUG] InscribeFromUrlTool.executeQuery called with URL: ${params.url}`);\n \n if (!params.url \|\| params.url.trim() === '') {\n throw new Error('URL cannot be empty. Please provide a valid URL.');\n }\n\n try {\n const urlObj = new URL(params.url);\n if (!urlObj.protocol \|\| !urlObj.host) {\n throw new Error('Invalid URL format. Please provide a complete URL with protocol (http/https).');\n }\n if (!['http:', 'https:'].includes(urlObj.protocol)) {\n throw new Error('Only HTTP and HTTPS URLs are supported for inscription.');\n }\n \n } catch (error) {\n if (error instanceof Error && error.message.includes('Cannot inscribe content from')) {\n throw error;\n }\n throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);\n }\n\n console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);\n try {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n \n try {\n // First try HEAD request\n const headResponse = await fetch(params.url, {\n method: 'HEAD',\n signal: controller.signal,\n });\n \n clearTimeout(timeoutId);\n \n if (!headResponse.ok) {\n throw new Error(`URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`);\n }\n\n const contentType = headResponse.headers.get('content-type') \|\| '';\n const contentLength = headResponse.headers.get('content-length');\n \n // Check if content type indicates HTML/web page\n const webPageContentTypes = [\n 'text/html',\n 'application/xhtml+xml',\n 'text/xml'\n ];\n \n if (webPageContentTypes.some(type => contentType.toLowerCase().includes(type))) {\n 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.`);\n }\n \n if (contentLength && parseInt(contentLength) === 0) {\n throw new Error('URL returns empty content (Content-Length: 0). Cannot inscribe empty content.');\n }\n\n if (contentLength && parseInt(contentLength) < 10) {\n throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);\n }\n \n // If HEAD doesn't provide content-type, do a partial GET to check\n if (!contentType \|\| contentType === 'application/octet-stream') {\n console.log(`[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`);\n \n const getController = new AbortController();\n const getTimeoutId = setTimeout(() => getController.abort(), 5000);\n \n try {\n const getResponse = await fetch(params.url, {\n signal: getController.signal,\n headers: {\n 'Range': 'bytes=0-1023' // Get first 1KB\n }\n });\n \n clearTimeout(getTimeoutId);\n \n if (getResponse.ok \|\| getResponse.status === 206) { // 206 is partial content\n const buffer = await getResponse.arrayBuffer();\n const bytes = new Uint8Array(buffer);\n const text = new TextDecoder('utf-8', { fatal: false }).decode(bytes.slice(0, 512));\n \n // Check if it looks like HTML\n if (text.toLowerCase().includes('<!doctype html') \|\| \n text.toLowerCase().includes('<html') \|\|\n text.match(/<meta\\s+[^>]>/i) \|\|\n text.match(/<title>/i)) {\n 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.`);\n }\n }\n } catch (getError) {\n clearTimeout(getTimeoutId);\n if (getError instanceof Error && getError.message.includes('HTML content')) {\n throw getError;\n }\n // If partial GET fails, continue anyway\n console.log(`[InscribeFromUrlTool] Could not perform partial GET validation: ${getError instanceof Error ? getError.message : 'Unknown error'}`);\n }\n }\n\n console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength \|\| 'unknown'}`);\n } catch (fetchError) {\n clearTimeout(timeoutId);\n throw fetchError;\n }\n } catch (error) {\n if (error instanceof Error) {\n if (error.name === 'AbortError') {\n console.log(`[InscribeFromUrlTool] Warning: URL validation timed out after 10 seconds. Proceeding with inscription attempt.`);\n } else if (error.message.includes('URL returned error') \|\| error.message.includes('empty content') \|\| error.message.includes('too small') \|\| error.message.includes('HTML')) {\n throw error;\n } else {\n console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);\n }\n }\n }\n\n const options: InscriptionOptions = {\n mode: params.mode,\n metadata: params.metadata,\n tags: params.tags,\n chunkSize: params.chunkSize,\n waitForConfirmation: params.waitForConfirmation ?? true,\n waitMaxAttempts: 10,\n waitIntervalMs: 3000,\n apiKey: params.apiKey,\n network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',\n };\n\n try {\n let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n \n if (params.timeoutMs) {\n const timeoutPromise = new Promise<never>((_, reject) => {\n setTimeout(\n () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n params.timeoutMs\n );\n });\n\n result = await Promise.race([\n this.inscriberBuilder.inscribe(\n { type: 'url', url: params.url },\n options\n ),\n timeoutPromise\n ]);\n } else {\n result = await this.inscriberBuilder.inscribe(\n { type: 'url', url: params.url },\n options\n );\n }\n\n if (result.confirmed) {\n const topicId = result.inscription?.topic_id \|\| result.result.topicId;\n const network = options.network \|\| 'testnet';\n const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;\n 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.`;\n } else {\n return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n }\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';\n throw new Error(`Inscription failed: ${errorMessage}`);\n }\n }\n}"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"standards-agent-kit.es34.js","sources":["../../src/tools/inscriber/InscribeFromUrlTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseInscriberQueryTool } from './base-inscriber-tools';\nimport { InscriptionOptions } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/*\n Schema for inscribing from URL\n /\nconst inscribeFromUrlSchema = z.object({\n 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.'),\n mode: z\n .enum(['file', 'hashinal'])\n .optional()\n .describe('Inscription mode: file or hashinal NFT'),\n metadata: z\n .record(z.unknown())\n .optional()\n .describe('Metadata to attach to the inscription'),\n tags: z\n .array(z.string())\n .optional()\n .describe('Tags to categorize the inscription'),\n chunkSize: z\n .number()\n .int()\n .positive()\n .optional()\n .describe('Chunk size for large files'),\n waitForConfirmation: z\n .boolean()\n .optional()\n .describe('Whether to wait for inscription confirmation'),\n timeoutMs: z\n .number()\n .int()\n .positive()\n .optional()\n .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),\n apiKey: z\n .string()\n .optional()\n .describe('API key for inscription service'),\n quoteOnly: z\n .boolean()\n .optional()\n .default(false)\n .describe('If true, returns a cost quote instead of executing the inscription'),\n});\n\n\n/\n Tool for inscribing content from URL\n /\nexport class InscribeFromUrlTool extends BaseInscriberQueryTool<typeof inscribeFromUrlSchema> {\n name = 'inscribeFromUrl';\n 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.';\n\n get specificInputSchema() {\n return inscribeFromUrlSchema;\n }\n\n protected async executeQuery(\n params: z.infer<typeof inscribeFromUrlSchema>,\n _runManager?: CallbackManagerForToolRun\n ): Promise<unknown> {\n console.log(`[DEBUG] InscribeFromUrlTool.executeQuery called with URL: ${params.url}`);\n \n if (!params.url \|\| params.url.trim() === '') {\n throw new Error('URL cannot be empty. Please provide a valid URL.');\n }\n\n try {\n const urlObj = new URL(params.url);\n if (!urlObj.protocol \|\| !urlObj.host) {\n throw new Error('Invalid URL format. Please provide a complete URL with protocol (http/https).');\n }\n if (!['http:', 'https:'].includes(urlObj.protocol)) {\n throw new Error('Only HTTP and HTTPS URLs are supported for inscription.');\n }\n \n } catch (error) {\n if (error instanceof Error && error.message.includes('Cannot inscribe content from')) {\n throw error;\n }\n throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);\n }\n\n console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);\n try {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), 10000);\n \n try {\n const headResponse = await fetch(params.url, {\n method: 'HEAD',\n signal: controller.signal,\n });\n \n clearTimeout(timeoutId);\n \n if (!headResponse.ok) {\n throw new Error(`URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`);\n }\n\n const contentType = headResponse.headers.get('content-type') \|\| '';\n const contentLength = headResponse.headers.get('content-length');\n \n const webPageContentTypes = [\n 'text/html',\n 'application/xhtml+xml',\n 'text/xml'\n ];\n \n if (webPageContentTypes.some(type => contentType.toLowerCase().includes(type))) {\n 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.`);\n }\n \n if (contentLength && parseInt(contentLength) === 0) {\n throw new Error('URL returns empty content (Content-Length: 0). Cannot inscribe empty content.');\n }\n\n if (contentLength && parseInt(contentLength) < 10) {\n throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);\n }\n \n if (!contentType \|\| contentType === 'application/octet-stream') {\n console.log(`[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`);\n \n const getController = new AbortController();\n const getTimeoutId = setTimeout(() => getController.abort(), 5000);\n \n try {\n const getResponse = await fetch(params.url, {\n signal: getController.signal,\n headers: {\n 'Range': 'bytes=0-1023' // Get first 1KB\n }\n });\n \n clearTimeout(getTimeoutId);\n \n if (getResponse.ok \|\| getResponse.status === 206) { // 206 is partial content\n const buffer = await getResponse.arrayBuffer();\n const bytes = new Uint8Array(buffer);\n const text = new TextDecoder('utf-8', { fatal: false }).decode(bytes.slice(0, 512));\n \n if (text.toLowerCase().includes('<!doctype html') \|\| \n text.toLowerCase().includes('<html') \|\|\n text.match(/<meta\\s+[^>]>/i) \|\|\n text.match(/<title>/i)) {\n 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.`);\n }\n }\n } catch (getError) {\n clearTimeout(getTimeoutId);\n if (getError instanceof Error && getError.message.includes('HTML content')) {\n throw getError;\n }\n console.log(`[InscribeFromUrlTool] Could not perform partial GET validation: ${getError instanceof Error ? getError.message : 'Unknown error'}`);\n }\n }\n\n console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength \|\| 'unknown'}`);\n } catch (fetchError) {\n clearTimeout(timeoutId);\n throw fetchError;\n }\n } catch (error) {\n if (error instanceof Error) {\n if (error.name === 'AbortError') {\n console.log(`[InscribeFromUrlTool] Warning: URL validation timed out after 10 seconds. Proceeding with inscription attempt.`);\n } else if (error.message.includes('URL returned error') \|\| error.message.includes('empty content') \|\| error.message.includes('too small') \|\| error.message.includes('HTML')) {\n throw error;\n } else {\n console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);\n }\n }\n }\n\n const options: InscriptionOptions = {\n mode: params.mode,\n metadata: params.metadata,\n tags: params.tags,\n chunkSize: params.chunkSize,\n waitForConfirmation: params.quoteOnly ? false : (params.waitForConfirmation ?? true),\n waitMaxAttempts: 10,\n waitIntervalMs: 3000,\n apiKey: params.apiKey,\n network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',\n quoteOnly: params.quoteOnly,\n };\n\n if (params.quoteOnly) {\n try {\n const quote = await this.generateInscriptionQuote(\n { type: 'url', url: params.url },\n options\n );\n \n return {\n success: true,\n quote: {\n totalCostHbar: quote.totalCostHbar,\n validUntil: quote.validUntil,\n breakdown: quote.breakdown,\n },\n contentInfo: {\n url: params.url,\n },\n message: `Quote generated for URL: ${params.url}\\nTotal cost: ${quote.totalCostHbar} HBAR\\nQuote valid until: ${new Date(quote.validUntil).toLocaleString()}`,\n };\n } catch (error) {\n const errorMessage =\n error instanceof Error ? error.message : 'Failed to generate inscription quote';\n throw new Error(`Quote generation failed: ${errorMessage}`);\n }\n }\n\n try {\n let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n \n if (params.timeoutMs) {\n const timeoutPromise = new Promise<never>((_, reject) => {\n setTimeout(\n () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n params.timeoutMs\n );\n });\n\n result = await Promise.race([\n this.inscriberBuilder.inscribe(\n { type: 'url', url: params.url },\n options\n ),\n timeoutPromise\n ]);\n } else {\n result = await this.inscriberBuilder.inscribe(\n { type: 'url', url: params.url },\n options\n );\n }\n\n if (result.confirmed && !result.quote) {\n const topicId = result.inscription?.topic_id \|\| (result.result as any).topicId;\n const network = options.network \|\| 'testnet';\n const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;\n 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.`;\n } else if (!result.quote && !result.confirmed) {\n 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.`;\n } else {\n return 'Inscription operation completed.';\n }\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from URL';\n throw new Error(`Inscription failed: ${errorMessage}`);\n }\n }\n}"],"names":[],"mappings":"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"}

package/dist/es/standards-agent-kit.es35.js CHANGED Viewed

@@ -10,13 +10,14 @@ const inscribeFromFileSchema = z.object({
   chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
   waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
   timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds for inscription (default: no timeout)"),
-  apiKey: z.string().optional().describe("API key for inscription service")
+  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")
 });
 class InscribeFromFileTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
     this.name = "inscribeFromFile";
-    this.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.";
+    this.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. Set quoteOnly=true to get cost estimates without executing the inscription.";
   }
   get specificInputSchema() {
     return inscribeFromFileSchema;
@@ -87,12 +88,46 @@ 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: 3e3,
       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
     };
+    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)
+Total cost: ${quote.totalCostHbar} HBAR
+Quote 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;
       if (params.timeoutMs) {
@@ -125,23 +160,26 @@ class InscribeFromFileTool extends BaseInscriberQueryTool {
           options
         );
       }
-      if (result.confirmed) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
+      const inscriptionResult = result;
+      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!
-Transaction ID: ${result.result.transactionId}
+Transaction ID: ${inscriptionResult.result.transactionId}
 Topic ID: ${topicId || "N/A"}${cdnUrl ? `
 View inscription: ${cdnUrl}` : ""}
 The inscription is now available.`;
-      } else {
+      } else if (!inscriptionResult.quote && !inscriptionResult.confirmed) {
         return `Successfully submitted inscription to the Hedera network!
-Transaction ID: ${result.result.transactionId}
+Transaction ID: ${inscriptionResult.result.transactionId}
 The 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 file";