@hashgraphonline/standards-agent-kit 0.2.134 → 0.2.136

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

@@ -37,6 +37,7 @@ declare const inscribeHashinalSchema: import('../..').ZodSchemaWithRender<{
 export declare class InscribeHashinalTool extends BaseInscriberQueryTool implements FormValidatable {
     name: string;
     description: string;
+    getEntityResolutionPreferences(): Record<string, string>;
     get specificInputSchema(): z.ZodObject<z.ZodRawShape>;
     private _schemaWithRenderConfig?;
     get schema(): z.ZodObject<z.ZodRawShape>;
@@ -50,14 +51,6 @@ export declare class InscribeHashinalTool extends BaseInscriberQueryTool impleme
      * Returns the focused schema for form generation
      */
     getFormSchema(): z.ZodObject<z.ZodRawShape>;
-    /**
-     * Implementation of FormValidatable interface
-     * Validates metadata quality and provides detailed feedback
-     */
-    validateMetadataQuality(input: unknown): {
-        needsForm: boolean;
-        reason: string;
-    };
     protected executeQuery(params: z.infer<typeof inscribeHashinalSchema>, _runManager?: CallbackManagerForToolRun): Promise<InscriptionResponse>;
     /**
      * Creates HashLink block configuration for Hashinal inscriptions.

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

@@ -4,12 +4,22 @@ import { InscriberTransactionToolParams, InscriberQueryToolParams } from './insc
 import { ContentResolverInterface } from '../../types/content-resolver';
 import { InscriptionInput, InscriptionOptions, QuoteResult } from '@hashgraphonline/standards-sdk';
 import { z } from 'zod';
+/**
+ * Event emitted when an entity is created during inscription
+ */
+export interface EntityCreationEvent {
+    entityId: string;
+    entityName: string;
+    entityType: string;
+    transactionId?: string;
+}
 /**
  * Base class for Inscriber transaction tools
  */
 export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny> = z.ZodObject<z.ZodRawShape>> extends BaseHederaTransactionTool<T> {
     protected inscriberBuilder: InscriberBuilder;
     protected contentResolver: ContentResolverInterface | null;
+    protected onEntityCreated?: (event: EntityCreationEvent) => void;
     namespace: "inscriber";
     constructor(params: InscriberTransactionToolParams);
     /**
@@ -20,6 +30,10 @@ export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Set entity creation handler for automatic entity storage
+     */
+    setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void;
     /**
      * Generate a quote for an inscription without executing it
      * @param input - The inscription input data
@@ -34,6 +48,7 @@ export declare abstract class BaseInscriberTransactionTool<T extends z.ZodObject
 export declare abstract class BaseInscriberQueryTool<T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny> = z.ZodObject<z.ZodRawShape>> extends BaseHederaQueryTool<T> {
     protected inscriberBuilder: InscriberBuilder;
     protected contentResolver: ContentResolverInterface | null;
+    protected onEntityCreated?: (event: EntityCreationEvent) => void;
     namespace: "inscriber";
     constructor(params: InscriberQueryToolParams);
     /**
@@ -44,6 +59,10 @@ export declare abstract class BaseInscriberQueryTool<T extends z.ZodObject<z.Zod
      * Get content resolver with fallback to registry
      */
     protected getContentResolver(): ContentResolverInterface | null;
+    /**
+     * Set entity creation handler for automatic entity storage
+     */
+    setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void;
     /**
      * Generate a quote for an inscription without executing it
      * @param input - The inscription input data

package/dist/es/interfaces/FormValidatable.d.ts

@@ -16,28 +16,19 @@ export interface FormValidatable {
      */
     getFormSchema(): z.ZodSchema;
     /**
-     * Optional method to validate metadata quality and provide detailed feedback
-     * @param input The input data to analyze
-     * @returns Object indicating if form is needed and the reason
-     */
-    validateMetadataQuality?(input: unknown): {
-        needsForm: boolean;
-        reason: string;
-    };
-    /**
-     * Optional method to define which fields are essential for this tool
+     * Defines which fields are essential for this tool
      * Essential fields are always shown in forms even if marked as optional
      * @returns Array of field names that are essential for user experience
      */
-    getEssentialFields?(): string[];
+    getEssentialFields(): string[];
     /**
-     * Optional method to determine if a field value should be considered empty
+     * Determines if a field value should be considered empty
      * Allows tools to define custom empty logic for their specific data types
      * @param fieldName The name of the field
      * @param value The value to check
      * @returns true if the field should be considered empty
      */
-    isFieldEmpty?(fieldName: string, value: unknown): boolean;
+    isFieldEmpty(fieldName: string, value: unknown): boolean;
 }
 /**
  * Type guard to check if a tool implements FormValidatable

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

@@ -18,6 +18,12 @@ class BaseInscriberTransactionTool extends BaseHederaTransactionTool {
   getContentResolver() {
     return this.contentResolver;
   }
+  /**
+   * Set entity creation handler for automatic entity storage
+   */
+  setEntityCreationHandler(handler) {
+    this.onEntityCreated = handler;
+  }
   /**
    * Generate a quote for an inscription without executing it
    * @param input - The inscription input data
@@ -58,6 +64,12 @@ class BaseInscriberQueryTool extends BaseHederaQueryTool {
   getContentResolver() {
     return this.contentResolver;
   }
+  /**
+   * Set entity creation handler for automatic entity storage
+   */
+  setEntityCreationHandler(handler) {
+    this.onEntityCreated = handler;
+  }
   /**
    * Generate a quote for an inscription without executing it
    * @param input - The inscription input data

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

@@ -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 {\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 network = this.inscriberBuilder['hederaKit'].client.network;\n    const networkType = network.toString().includes('mainnet')\n      ? 'mainnet'\n      : 'testnet';\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 network = this.inscriberBuilder['hederaKit'].client.network;\n    const networkType = network.toString().includes('mainnet')\n      ? 'mainnet'\n      : 'testnet';\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;AACtB,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAEJ,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;AACtB,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAEJ,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;"}
+{"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 * Event emitted when an entity is created during inscription\n */\nexport interface EntityCreationEvent {\n  entityId: string;\n  entityName: string;\n  entityType: string;\n  transactionId?: string;\n}\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  protected onEntityCreated?: (event: EntityCreationEvent) => void;\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   * Set entity creation handler for automatic entity storage\n   */\n  setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void {\n    this.onEntityCreated = handler;\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 network = this.inscriberBuilder['hederaKit'].client.network;\n    const networkType = network.toString().includes('mainnet')\n      ? 'mainnet'\n      : 'testnet';\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  protected onEntityCreated?: (event: EntityCreationEvent) => void;\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   * Set entity creation handler for automatic entity storage\n   */\n  setEntityCreationHandler(handler: (event: EntityCreationEvent) => void): void {\n    this.onEntityCreated = handler;\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 network = this.inscriberBuilder['hederaKit'].client.network;\n    const networkType = network.toString().includes('mainnet')\n      ? 'mainnet'\n      : 'testnet';\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":";AA+BO,MAAe,qCAMZ,0BAA6B;AAAA,EAMrC,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,EAKA,yBAAyB,SAAqD;AAC5E,SAAK,kBAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAgB,yBACd,OACA,SACsB;AACtB,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAEJ,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,EAM/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,EAKA,yBAAyB,SAAqD;AAC5E,SAAK,kBAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAgB,yBACd,OACA,SACsB;AACtB,UAAM,UAAU,KAAK,iBAAiB,WAAW,EAAE,OAAO;AAC1D,UAAM,cAAc,QAAQ,SAAA,EAAW,SAAS,SAAS,IACrD,YACA;AAEJ,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

@@ -155,8 +155,8 @@ class InscribeFromUrlTool extends BaseInscriberQueryTool {
       tags: params.tags,
       chunkSize: params.chunkSize,
       waitForConfirmation: params.quoteOnly ? false : params.waitForConfirmation ?? true,
-      waitMaxAttempts: 10,
-      waitIntervalMs: 3e3,
+      waitMaxAttempts: 60,
+      waitIntervalMs: 5e3,
       apiKey: params.apiKey,
       network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet",
       quoteOnly: params.quoteOnly

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

@@ -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, Logger } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\nconst logger = new Logger({ module: 'InscribeFromUrlTool' });\n\n/**\n * Schema for inscribing from URL\n */\nconst inscribeFromUrlSchema = z.object({\n  url: z\n    .string()\n    .url()\n    .describe(\n      '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    ),\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(\n      'Timeout in milliseconds for inscription (default: no timeout - waits until completion)'\n    ),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n  quoteOnly: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      '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<\n  typeof inscribeFromUrlSchema\n> {\n  name = 'inscribeFromUrl';\n  description =\n    '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    logger.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(\n          'Invalid URL format. Please provide a complete URL with protocol (http/https).'\n        );\n      }\n      if (!['http:', 'https:'].includes(urlObj.protocol)) {\n        throw new Error(\n          'Only HTTP and HTTPS URLs are supported for inscription.'\n        );\n      }\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        error.message.includes('Cannot inscribe content from')\n      ) {\n        throw error;\n      }\n      throw new Error(\n        `Invalid URL: ${params.url}. Please provide a valid URL.`\n      );\n    }\n\n    logger.info('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(\n            `URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`\n          );\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 (\n          webPageContentTypes.some((type) =>\n            contentType.toLowerCase().includes(type)\n          )\n        ) {\n          throw new Error(\n            `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\n        if (contentLength && parseInt(contentLength) === 0) {\n          throw new Error(\n            'URL returns empty content (Content-Length: 0). Cannot inscribe empty content.'\n          );\n        }\n\n        if (contentLength && parseInt(contentLength) < 10) {\n          throw new Error(\n            `URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`\n          );\n        }\n\n        if (!contentType || contentType === 'application/octet-stream') {\n          logger.info('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) {\n\n              const buffer = await getResponse.arrayBuffer();\n              const bytes = new Uint8Array(buffer);\n              const text = new TextDecoder('utf-8', { fatal: false }).decode(\n                bytes.slice(0, 512)\n              );\n\n              if (\n                text.toLowerCase().includes('<!doctype html') ||\n                text.toLowerCase().includes('<html') ||\n                text.match(/<meta\\s+[^>]*>/i) ||\n                text.match(/<title>/i)\n              ) {\n                throw new Error(\n                  `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            }\n          } catch (getError) {\n            clearTimeout(getTimeoutId);\n            if (\n              getError instanceof Error &&\n              getError.message.includes('HTML content')\n            ) {\n              throw getError;\n            }\n            logger.warn(\n              `Could not perform partial GET validation: ${\n                getError instanceof Error ? getError.message : 'Unknown error'\n              }`\n            );\n          }\n        }\n\n        logger.info(\n          `URL validation passed. Content-Type: ${contentType}, Content-Length: ${\n            contentLength || 'unknown'\n          }`\n        );\n      } catch (fetchError) {\n        clearTimeout(timeoutId);\n        throw fetchError;\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          logger.warn(\n            'URL validation timed out after 10 seconds. Proceeding with inscription attempt.'\n          );\n        } else if (\n          error.message.includes('URL returned error') ||\n          error.message.includes('empty content') ||\n          error.message.includes('too small') ||\n          error.message.includes('HTML')\n        ) {\n          throw error;\n        } else {\n          logger.warn(\n            `Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`\n          );\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\n        ? false\n        : params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : '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: `Estimated Quote for URL: ${params.url}\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error\n            ? error.message\n            : '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            () =>\n              reject(\n                new Error(`Inscription timed out after ${params.timeoutMs}ms`)\n              ),\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 =\n          result.inscription?.topic_id || (result.result as any).topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId\n          ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n          : null;\n        return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n          (result.result as any).transactionId\n        }\\nTopic ID: ${topicId || 'N/A'}${\n          cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n        }\\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: ${\n          (result.result as any).transactionId\n        }\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      } else {\n        return 'Inscription operation completed.';\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Failed to inscribe from URL';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"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, Logger } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\nconst logger = new Logger({ module: 'InscribeFromUrlTool' });\n\n/**\n * Schema for inscribing from URL\n */\nconst inscribeFromUrlSchema = z.object({\n  url: z\n    .string()\n    .url()\n    .describe(\n      '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    ),\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(\n      'Timeout in milliseconds for inscription (default: no timeout - waits until completion)'\n    ),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n  quoteOnly: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      '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<\n  typeof inscribeFromUrlSchema\n> {\n  name = 'inscribeFromUrl';\n  description =\n    '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    logger.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(\n          'Invalid URL format. Please provide a complete URL with protocol (http/https).'\n        );\n      }\n      if (!['http:', 'https:'].includes(urlObj.protocol)) {\n        throw new Error(\n          'Only HTTP and HTTPS URLs are supported for inscription.'\n        );\n      }\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        error.message.includes('Cannot inscribe content from')\n      ) {\n        throw error;\n      }\n      throw new Error(\n        `Invalid URL: ${params.url}. Please provide a valid URL.`\n      );\n    }\n\n    logger.info('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(\n            `URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`\n          );\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 (\n          webPageContentTypes.some((type) =>\n            contentType.toLowerCase().includes(type)\n          )\n        ) {\n          throw new Error(\n            `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\n        if (contentLength && parseInt(contentLength) === 0) {\n          throw new Error(\n            'URL returns empty content (Content-Length: 0). Cannot inscribe empty content.'\n          );\n        }\n\n        if (contentLength && parseInt(contentLength) < 10) {\n          throw new Error(\n            `URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`\n          );\n        }\n\n        if (!contentType || contentType === 'application/octet-stream') {\n          logger.info('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) {\n\n              const buffer = await getResponse.arrayBuffer();\n              const bytes = new Uint8Array(buffer);\n              const text = new TextDecoder('utf-8', { fatal: false }).decode(\n                bytes.slice(0, 512)\n              );\n\n              if (\n                text.toLowerCase().includes('<!doctype html') ||\n                text.toLowerCase().includes('<html') ||\n                text.match(/<meta\\s+[^>]*>/i) ||\n                text.match(/<title>/i)\n              ) {\n                throw new Error(\n                  `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            }\n          } catch (getError) {\n            clearTimeout(getTimeoutId);\n            if (\n              getError instanceof Error &&\n              getError.message.includes('HTML content')\n            ) {\n              throw getError;\n            }\n            logger.warn(\n              `Could not perform partial GET validation: ${\n                getError instanceof Error ? getError.message : 'Unknown error'\n              }`\n            );\n          }\n        }\n\n        logger.info(\n          `URL validation passed. Content-Type: ${contentType}, Content-Length: ${\n            contentLength || 'unknown'\n          }`\n        );\n      } catch (fetchError) {\n        clearTimeout(timeoutId);\n        throw fetchError;\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          logger.warn(\n            'URL validation timed out after 10 seconds. Proceeding with inscription attempt.'\n          );\n        } else if (\n          error.message.includes('URL returned error') ||\n          error.message.includes('empty content') ||\n          error.message.includes('too small') ||\n          error.message.includes('HTML')\n        ) {\n          throw error;\n        } else {\n          logger.warn(\n            `Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`\n          );\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\n        ? false\n        : params.waitForConfirmation ?? true,\n      waitMaxAttempts: 60,\n      waitIntervalMs: 5000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : '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: `Estimated Quote for URL: ${params.url}\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error\n            ? error.message\n            : '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            () =>\n              reject(\n                new Error(`Inscription timed out after ${params.timeoutMs}ms`)\n              ),\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 =\n          result.inscription?.topic_id || (result.result as any).topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId\n          ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n          : null;\n        return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n          (result.result as any).transactionId\n        }\\nTopic ID: ${topicId || 'N/A'}${\n          cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n        }\\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: ${\n          (result.result as any).transactionId\n        }\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      } else {\n        return 'Inscription operation completed.';\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Failed to inscribe from URL';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/es/standards-agent-kit.es36.js

@@ -42,8 +42,8 @@ class InscribeFromBufferTool extends BaseInscriberQueryTool {
       tags: params.tags,
       chunkSize: params.chunkSize,
       waitForConfirmation: params.quoteOnly ? false : params.waitForConfirmation ?? true,
-      waitMaxAttempts: 10,
-      waitIntervalMs: 3e3,
+      waitMaxAttempts: 60,
+      waitIntervalMs: 5e3,
       apiKey: params.apiKey,
       network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet",
       quoteOnly: params.quoteOnly

package/dist/es/standards-agent-kit.es36.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es36.js","sources":["../../src/tools/inscriber/InscribeFromBufferTool.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';\nimport { resolveContent } from '../../utils/content-resolver';\nimport { contentRefSchema } from '../../validation/content-ref-schemas';\nimport { loadConfig } from '../../config/ContentReferenceConfig';\n\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z.union([z.string(), contentRefSchema])\n    .describe('Content to inscribe as base64 data, plain text, or content reference'),\n  fileName: z.string().min(1).describe('Name for the inscribed content'),\n  mimeType: z.string().optional().describe('MIME type of the content'),\n  metadata: z.record(z.unknown()).optional().describe('Metadata to attach'),\n  tags: z.array(z.string()).optional().describe('Tags to categorize the inscription'),\n  chunkSize: z.number().int().positive().optional().describe('Chunk size for large files'),\n  waitForConfirmation: z.boolean().optional().describe('Wait for inscription confirmation'),\n  timeoutMs: z.number().int().positive().optional().describe('Timeout in milliseconds'),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n  quoteOnly: z.boolean().optional().default(false).describe('Return cost quote only'),\n});\n\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<\n  typeof inscribeFromBufferSchema\n> {\n  name = 'inscribeFromBuffer';\n  description =\n    'Use ONLY for inscribing regular files or content (NOT for NFT/Hashinal inscriptions). When user says \"inscribe it\" after you showed search results or other content WITHOUT mentioning NFT/hashinal, 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. NEVER use this for Hashinal NFTs - always use InscribeHashinalTool instead when user mentions hashinal, NFT, dynamic, or minting.';\n\n  private config = loadConfig();\n\n  get specificInputSchema() {\n    return inscribeFromBufferSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromBufferSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    this.validateInput(params);\n\n    const resolvedContent = await resolveContent(\n      params.base64Data,\n      params.mimeType,\n      params.fileName\n    );\n\n    this.validateContent(resolvedContent.buffer);\n\n    const buffer = resolvedContent.buffer;\n    const resolvedMimeType = resolvedContent.mimeType || params.mimeType;\n    const resolvedFileName = resolvedContent.fileName || params.fileName;\n\n    const options: InscriptionOptions = {\n      mode: 'file',\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.quoteOnly\n        ? false\n        : params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : 'testnet',\n      quoteOnly: params.quoteOnly,\n    };\n\n    if (params.quoteOnly) {\n      try {\n        const quote = await this.generateInscriptionQuote(\n          {\n            type: 'buffer',\n            buffer,\n            fileName: resolvedFileName,\n            mimeType: resolvedMimeType,\n          },\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            fileName: resolvedFileName,\n            mimeType: resolvedMimeType,\n            sizeBytes: buffer.length,\n          },\n          message: `Estimated Quote for buffer content: ${resolvedFileName} (${(\n            buffer.length / 1024\n          ).toFixed(2)} KB)\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error\n            ? error.message\n            : 'Failed to generate inscription quote';\n        throw new Error(`Quote generation failed: ${errorMessage}`);\n      }\n    }\n\n    try {\n      const result = await this.executeInscription(\n        buffer,\n        resolvedFileName,\n        resolvedMimeType,\n        options,\n        params.timeoutMs\n      );\n      return this.formatInscriptionResult(result, options);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error\n          ? error.message\n          : 'Failed to inscribe from buffer';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private validateInput(\n    params: z.infer<typeof inscribeFromBufferSchema>\n  ): void {\n    if (!params.base64Data || params.base64Data.trim() === '') {\n      throw new Error(\n        'No data provided. Cannot inscribe empty content. Please provide valid content, plain text, base64 encoded data, or a content reference ID.'\n      );\n    }\n\n    if (!params.fileName || params.fileName.trim() === '') {\n      throw new Error(\n        'No fileName provided. A valid fileName is required for inscription.'\n      );\n    }\n  }\n\n  private validateContent(buffer: Buffer): void {\n    if (buffer.length === 0) {\n      throw new Error(\n        'Buffer is empty after conversion. The provided data appears to be invalid or empty.'\n      );\n    }\n\n    if (buffer.length > this.config.maxInscriptionSize) {\n      const maxSizeKB = Math.round(this.config.maxInscriptionSize / 1024);\n      const bufferSizeKB = Math.round(buffer.length / 1024);\n      throw new Error(\n        `Content is too large for inscription (${bufferSizeKB}KB, max ${maxSizeKB}KB). Please summarize or extract key information before inscribing.`\n      );\n    }\n\n    if (buffer.length < this.config.minContentSize) {\n      throw new Error(\n        `Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`\n      );\n    }\n\n    if (\n      buffer.toString('utf8', 0, Math.min(buffer.length, 100)).trim() === ''\n    ) {\n      throw new Error(\n        'Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.'\n      );\n    }\n\n    const contentStr = buffer.toString('utf8');\n    const emptyHtmlPattern = /<a\\s+href=[\"'][^\"']+[\"']\\s*>\\s*<\\/a>/i;\n    const hasOnlyEmptyLinks =\n      emptyHtmlPattern.test(contentStr) &&\n      contentStr.replace(/<[^>]+>/g, '').trim().length < 50;\n\n    if (hasOnlyEmptyLinks) {\n      throw new Error(\n        'Buffer contains empty HTML with only links and no actual content. When inscribing content from external sources, use the actual article text you retrieved, not empty HTML with links.'\n      );\n    }\n  }\n\n  private async executeInscription(\n    buffer: Buffer,\n    fileName: string,\n    mimeType: string | undefined,\n    options: InscriptionOptions,\n    timeoutMs?: number\n  ): Promise<Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>> {\n    const inscriptionData = {\n      type: 'buffer' as const,\n      buffer,\n      fileName,\n      mimeType,\n    };\n\n    if (timeoutMs) {\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        setTimeout(\n          () => reject(new Error(`Inscription timed out after ${timeoutMs}ms`)),\n          timeoutMs\n        );\n      });\n\n      return Promise.race([\n        this.inscriberBuilder.inscribe(inscriptionData, options),\n        timeoutPromise,\n      ]);\n    }\n\n    return this.inscriberBuilder.inscribe(inscriptionData, options);\n  }\n\n  private formatInscriptionResult(\n    result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>,\n    options: InscriptionOptions\n  ): string {\n    if (result.confirmed && !result.quote) {\n      const topicId =\n        result.inscription?.topic_id || (result.result as any).topicId;\n      const network = options.network || 'testnet';\n      const cdnUrl = topicId\n        ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n        : null;\n      return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n        (result.result as any).transactionId\n      }\\nTopic ID: ${topicId || 'N/A'}${\n        cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n      }\\n\\nThe inscription is now available.`;\n    }\n\n    if (!result.quote && !result.confirmed) {\n      return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${\n        (result.result as any).transactionId\n      }\\n\\nThe inscription is processing and will be confirmed shortly.`;\n    }\n\n    return 'Inscription operation completed.';\n  }\n\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es36.js","sources":["../../src/tools/inscriber/InscribeFromBufferTool.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';\nimport { resolveContent } from '../../utils/content-resolver';\nimport { contentRefSchema } from '../../validation/content-ref-schemas';\nimport { loadConfig } from '../../config/ContentReferenceConfig';\n\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z.union([z.string(), contentRefSchema])\n    .describe('Content to inscribe as base64 data, plain text, or content reference'),\n  fileName: z.string().min(1).describe('Name for the inscribed content'),\n  mimeType: z.string().optional().describe('MIME type of the content'),\n  metadata: z.record(z.unknown()).optional().describe('Metadata to attach'),\n  tags: z.array(z.string()).optional().describe('Tags to categorize the inscription'),\n  chunkSize: z.number().int().positive().optional().describe('Chunk size for large files'),\n  waitForConfirmation: z.boolean().optional().describe('Wait for inscription confirmation'),\n  timeoutMs: z.number().int().positive().optional().describe('Timeout in milliseconds'),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n  quoteOnly: z.boolean().optional().default(false).describe('Return cost quote only'),\n});\n\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<\n  typeof inscribeFromBufferSchema\n> {\n  name = 'inscribeFromBuffer';\n  description =\n    'Use ONLY for inscribing regular files or content (NOT for NFT/Hashinal inscriptions). When user says \"inscribe it\" after you showed search results or other content WITHOUT mentioning NFT/hashinal, 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. NEVER use this for Hashinal NFTs - always use InscribeHashinalTool instead when user mentions hashinal, NFT, dynamic, or minting.';\n\n  private config = loadConfig();\n\n  get specificInputSchema() {\n    return inscribeFromBufferSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromBufferSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    this.validateInput(params);\n\n    const resolvedContent = await resolveContent(\n      params.base64Data,\n      params.mimeType,\n      params.fileName\n    );\n\n    this.validateContent(resolvedContent.buffer);\n\n    const buffer = resolvedContent.buffer;\n    const resolvedMimeType = resolvedContent.mimeType || params.mimeType;\n    const resolvedFileName = resolvedContent.fileName || params.fileName;\n\n    const options: InscriptionOptions = {\n      mode: 'file',\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.quoteOnly\n        ? false\n        : params.waitForConfirmation ?? true,\n      waitMaxAttempts: 60,\n      waitIntervalMs: 5000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : 'testnet',\n      quoteOnly: params.quoteOnly,\n    };\n\n    if (params.quoteOnly) {\n      try {\n        const quote = await this.generateInscriptionQuote(\n          {\n            type: 'buffer',\n            buffer,\n            fileName: resolvedFileName,\n            mimeType: resolvedMimeType,\n          },\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            fileName: resolvedFileName,\n            mimeType: resolvedMimeType,\n            sizeBytes: buffer.length,\n          },\n          message: `Estimated Quote for buffer content: ${resolvedFileName} (${(\n            buffer.length / 1024\n          ).toFixed(2)} KB)\\nTotal cost: ${quote.totalCostHbar} HBAR`,\n        };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error\n            ? error.message\n            : 'Failed to generate inscription quote';\n        throw new Error(`Quote generation failed: ${errorMessage}`);\n      }\n    }\n\n    try {\n      const result = await this.executeInscription(\n        buffer,\n        resolvedFileName,\n        resolvedMimeType,\n        options,\n        params.timeoutMs\n      );\n      return this.formatInscriptionResult(result, options);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error\n          ? error.message\n          : 'Failed to inscribe from buffer';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private validateInput(\n    params: z.infer<typeof inscribeFromBufferSchema>\n  ): void {\n    if (!params.base64Data || params.base64Data.trim() === '') {\n      throw new Error(\n        'No data provided. Cannot inscribe empty content. Please provide valid content, plain text, base64 encoded data, or a content reference ID.'\n      );\n    }\n\n    if (!params.fileName || params.fileName.trim() === '') {\n      throw new Error(\n        'No fileName provided. A valid fileName is required for inscription.'\n      );\n    }\n  }\n\n  private validateContent(buffer: Buffer): void {\n    if (buffer.length === 0) {\n      throw new Error(\n        'Buffer is empty after conversion. The provided data appears to be invalid or empty.'\n      );\n    }\n\n    if (buffer.length > this.config.maxInscriptionSize) {\n      const maxSizeKB = Math.round(this.config.maxInscriptionSize / 1024);\n      const bufferSizeKB = Math.round(buffer.length / 1024);\n      throw new Error(\n        `Content is too large for inscription (${bufferSizeKB}KB, max ${maxSizeKB}KB). Please summarize or extract key information before inscribing.`\n      );\n    }\n\n    if (buffer.length < this.config.minContentSize) {\n      throw new Error(\n        `Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`\n      );\n    }\n\n    if (\n      buffer.toString('utf8', 0, Math.min(buffer.length, 100)).trim() === ''\n    ) {\n      throw new Error(\n        'Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.'\n      );\n    }\n\n    const contentStr = buffer.toString('utf8');\n    const emptyHtmlPattern = /<a\\s+href=[\"'][^\"']+[\"']\\s*>\\s*<\\/a>/i;\n    const hasOnlyEmptyLinks =\n      emptyHtmlPattern.test(contentStr) &&\n      contentStr.replace(/<[^>]+>/g, '').trim().length < 50;\n\n    if (hasOnlyEmptyLinks) {\n      throw new Error(\n        'Buffer contains empty HTML with only links and no actual content. When inscribing content from external sources, use the actual article text you retrieved, not empty HTML with links.'\n      );\n    }\n  }\n\n  private async executeInscription(\n    buffer: Buffer,\n    fileName: string,\n    mimeType: string | undefined,\n    options: InscriptionOptions,\n    timeoutMs?: number\n  ): Promise<Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>> {\n    const inscriptionData = {\n      type: 'buffer' as const,\n      buffer,\n      fileName,\n      mimeType,\n    };\n\n    if (timeoutMs) {\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        setTimeout(\n          () => reject(new Error(`Inscription timed out after ${timeoutMs}ms`)),\n          timeoutMs\n        );\n      });\n\n      return Promise.race([\n        this.inscriberBuilder.inscribe(inscriptionData, options),\n        timeoutPromise,\n      ]);\n    }\n\n    return this.inscriberBuilder.inscribe(inscriptionData, options);\n  }\n\n  private formatInscriptionResult(\n    result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>,\n    options: InscriptionOptions\n  ): string {\n    if (result.confirmed && !result.quote) {\n      const topicId =\n        result.inscription?.topic_id || (result.result as any).topicId;\n      const network = options.network || 'testnet';\n      const cdnUrl = topicId\n        ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}`\n        : null;\n      return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${\n        (result.result as any).transactionId\n      }\\nTopic ID: ${topicId || 'N/A'}${\n        cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n      }\\n\\nThe inscription is now available.`;\n    }\n\n    if (!result.quote && !result.confirmed) {\n      return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${\n        (result.result as any).transactionId\n      }\\n\\nThe inscription is processing and will be confirmed shortly.`;\n    }\n\n    return 'Inscription operation completed.';\n  }\n\n}\n"],"names":[],"mappings":";;;;;AAQA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,YAAY,EAAE,MAAM,CAAC,EAAE,OAAA,GAAU,gBAAgB,CAAC,EAC/C,SAAS,sEAAsE;AAAA,EAClF,UAAU,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,SAAS,gCAAgC;AAAA,EACrE,UAAU,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,0BAA0B;AAAA,EACnE,UAAU,EAAE,OAAO,EAAE,QAAA,CAAS,EAAE,SAAA,EAAW,SAAS,oBAAoB;AAAA,EACxE,MAAM,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA,EAAW,SAAS,oCAAoC;AAAA,EAClF,WAAW,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA,EAAW,SAAA,EAAW,SAAS,4BAA4B;AAAA,EACvF,qBAAqB,EAAE,QAAA,EAAU,SAAA,EAAW,SAAS,mCAAmC;AAAA,EACxF,WAAW,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA,EAAW,SAAA,EAAW,SAAS,yBAAyB;AAAA,EACpF,QAAQ,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,iCAAiC;AAAA,EACxE,WAAW,EAAE,UAAU,SAAA,EAAW,QAAQ,KAAK,EAAE,SAAS,wBAAwB;AACpF,CAAC;AAEM,MAAM,+BAA+B,uBAE1C;AAAA,EAFK,cAAA;AAAA,UAAA,GAAA,SAAA;AAGL,SAAA,OAAO;AACP,SAAA,cACE;AAEF,SAAQ,SAAS,WAAA;AAAA,EAAW;AAAA,EAE5B,IAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,MAAgB,aACd,QACA,aACkB;AAClB,SAAK,cAAc,MAAM;AAEzB,UAAM,kBAAkB,MAAM;AAAA,MAC5B,OAAO;AAAA,MACP,OAAO;AAAA,MACP,OAAO;AAAA,IAAA;AAGT,SAAK,gBAAgB,gBAAgB,MAAM;AAE3C,UAAM,SAAS,gBAAgB;AAC/B,UAAM,mBAAmB,gBAAgB,YAAY,OAAO;AAC5D,UAAM,mBAAmB,gBAAgB,YAAY,OAAO;AAE5D,UAAM,UAA8B;AAAA,MAClC,MAAM;AAAA,MACN,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,WAAW,OAAO;AAAA,MAClB,qBAAqB,OAAO,YACxB,QACA,OAAO,uBAAuB;AAAA,MAClC,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,SAAS,KAAK,iBAAiB,WAAW,EAAE,OAAO,QAChD,SAAA,EACA,SAAS,SAAS,IACjB,YACA;AAAA,MACJ,WAAW,OAAO;AAAA,IAAA;AAGpB,QAAI,OAAO,WAAW;AACpB,UAAI;AACF,cAAM,QAAQ,MAAM,KAAK;AAAA,UACvB;AAAA,YACE,MAAM;AAAA,YACN;AAAA,YACA,UAAU;AAAA,YACV,UAAU;AAAA,UAAA;AAAA,UAEZ;AAAA,QAAA;AAGF,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,YACL,eAAe,MAAM;AAAA,YACrB,YAAY,MAAM;AAAA,YAClB,WAAW,MAAM;AAAA,UAAA;AAAA,UAEnB,aAAa;AAAA,YACX,UAAU;AAAA,YACV,UAAU;AAAA,YACV,WAAW,OAAO;AAAA,UAAA;AAAA,UAEpB,SAAS,uCAAuC,gBAAgB,MAC9D,OAAO,SAAS,MAChB,QAAQ,CAAC,CAAC;AAAA,cAAqB,MAAM,aAAa;AAAA,QAAA;AAAA,MAExD,SAAS,OAAO;AACd,cAAM,eACJ,iBAAiB,QACb,MAAM,UACN;AACN,cAAM,IAAI,MAAM,4BAA4B,YAAY,EAAE;AAAA,MAC5D;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK;AAAA,QACxB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAO;AAAA,MAAA;AAET,aAAO,KAAK,wBAAwB,QAAQ,OAAO;AAAA,IACrD,SAAS,OAAO;AACd,YAAM,eACJ,iBAAiB,QACb,MAAM,UACN;AACN,YAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,IACvD;AAAA,EACF;AAAA,EAEQ,cACN,QACM;AACN,QAAI,CAAC,OAAO,cAAc,OAAO,WAAW,KAAA,MAAW,IAAI;AACzD,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,CAAC,OAAO,YAAY,OAAO,SAAS,KAAA,MAAW,IAAI;AACrD,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAAA,EAEQ,gBAAgB,QAAsB;AAC5C,QAAI,OAAO,WAAW,GAAG;AACvB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,OAAO,SAAS,KAAK,OAAO,oBAAoB;AAClD,YAAM,YAAY,KAAK,MAAM,KAAK,OAAO,qBAAqB,IAAI;AAClE,YAAM,eAAe,KAAK,MAAM,OAAO,SAAS,IAAI;AACpD,YAAM,IAAI;AAAA,QACR,yCAAyC,YAAY,WAAW,SAAS;AAAA,MAAA;AAAA,IAE7E;AAEA,QAAI,OAAO,SAAS,KAAK,OAAO,gBAAgB;AAC9C,YAAM,IAAI;AAAA,QACR,gCAAgC,OAAO,MAAM;AAAA,MAAA;AAAA,IAEjD;AAEA,QACE,OAAO,SAAS,QAAQ,GAAG,KAAK,IAAI,OAAO,QAAQ,GAAG,CAAC,EAAE,KAAA,MAAW,IACpE;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,aAAa,OAAO,SAAS,MAAM;AACzC,UAAM,mBAAmB;AACzB,UAAM,oBACJ,iBAAiB,KAAK,UAAU,KAChC,WAAW,QAAQ,YAAY,EAAE,EAAE,KAAA,EAAO,SAAS;AAErD,QAAI,mBAAmB;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAAA,EAEA,MAAc,mBACZ,QACA,UACA,UACA,SACA,WACqE;AACrE,UAAM,kBAAkB;AAAA,MACtB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,QAAI,WAAW;AACb,YAAM,iBAAiB,IAAI,QAAe,CAAC,GAAG,WAAW;AACvD;AAAA,UACE,MAAM,OAAO,IAAI,MAAM,+BAA+B,SAAS,IAAI,CAAC;AAAA,UACpE;AAAA,QAAA;AAAA,MAEJ,CAAC;AAED,aAAO,QAAQ,KAAK;AAAA,QAClB,KAAK,iBAAiB,SAAS,iBAAiB,OAAO;AAAA,QACvD;AAAA,MAAA,CACD;AAAA,IACH;AAEA,WAAO,KAAK,iBAAiB,SAAS,iBAAiB,OAAO;AAAA,EAChE;AAAA,EAEQ,wBACN,QACA,SACQ;AACR,QAAI,OAAO,aAAa,CAAC,OAAO,OAAO;AACrC,YAAM,UACJ,OAAO,aAAa,YAAa,OAAO,OAAe;AACzD,YAAM,UAAU,QAAQ,WAAW;AACnC,YAAM,SAAS,UACX,8CAA8C,OAAO,YAAY,OAAO,KACxE;AACJ,aAAO;AAAA;AAAA,kBACJ,OAAO,OAAe,aACzB;AAAA,YAAe,WAAW,KAAK,GAC7B,SAAS;AAAA,oBAAuB,MAAM,KAAK,EAC7C;AAAA;AAAA;AAAA,IACF;AAEA,QAAI,CAAC,OAAO,SAAS,CAAC,OAAO,WAAW;AACtC,aAAO;AAAA;AAAA,kBACJ,OAAO,OAAe,aACzB;AAAA;AAAA;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEF;"}

package/dist/es/standards-agent-kit.es37.js

@@ -19,7 +19,7 @@ const HASHLINK_BLOCK_CONFIG = {
   }
 };
 function getHashLinkBlockId(network) {
-  const config = HASHLINK_BLOCK_CONFIG[network];
+  const config = network === "mainnet" ? HASHLINK_BLOCK_CONFIG.mainnet : HASHLINK_BLOCK_CONFIG.testnet;
   if (!config || config.blockId === "0.0.TBD") {
     return HASHLINK_BLOCK_CONFIG.testnet;
   }
@@ -96,6 +96,16 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
     this.name = "inscribeHashinal";
     this.description = "Tool for inscribing Hashinal NFTs. CRITICAL: When user provides content (url/contentRef/base64Data), call with ONLY the content parameters - DO NOT auto-generate name, description, creator, or attributes. A form will be automatically shown to collect metadata from the user. Only include metadata parameters if the user explicitly provided them in their message.";
   }
+  // Declare entity resolution preferences to preserve user-specified literal fields
+  getEntityResolutionPreferences() {
+    return {
+      name: "literal",
+      description: "literal",
+      creator: "literal",
+      attributes: "literal",
+      properties: "literal"
+    };
+  }
   get specificInputSchema() {
     const baseSchema = inscribeHashinalSchema._def?.schema || inscribeHashinalSchema;
     return baseSchema;
@@ -185,12 +195,7 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
               value: z.union([z.string(), z.number()]).describe('Trait value (e.g., "Epic", "Blue", 85)')
             })
           )
-        ).withRender(
-          renderConfigs.array(
-            "NFT Attributes",
-            "Attribute"
-          )
-        ).optional().describe("Collectible traits and characteristics."),
+        ).withRender(renderConfigs.array("NFT Attributes", "Attribute")).optional().describe("Collectible traits and characteristics."),
         type: z.string().optional().describe(
           'Category or genre of the NFT (e.g., "Digital Art", "Photography", "Collectible Card)'
         )
@@ -204,24 +209,6 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
     });
     return focusedSchema;
   }
-  /**
-   * Implementation of FormValidatable interface
-   * Validates metadata quality and provides detailed feedback
-   */
-  validateMetadataQuality(input) {
-    const inputObj = input;
-    const hasRequiredMetadata = !!(inputObj.name && inputObj.description && inputObj.creator);
-    if (!hasRequiredMetadata) {
-      return {
-        needsForm: true,
-        reason: "Missing essential metadata (name, description, creator) for NFT creation"
-      };
-    }
-    return {
-      needsForm: false,
-      reason: "All required metadata fields present"
-    };
-  }
   async executeQuery(params, _runManager) {
     if (!params.url && !params.contentRef && !params.base64Data) {
       return createInscriptionError({
@@ -271,7 +258,7 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
       tags: params.tags,
       chunkSize: params.chunkSize,
       waitForConfirmation: params.quoteOnly ? false : params.waitForConfirmation ?? true,
-      waitMaxAttempts: 30,
+      waitMaxAttempts: 60,
       waitIntervalMs: 5e3,
       network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet",
       quoteOnly: params.quoteOnly
@@ -374,6 +361,12 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
             attributes: params.attributes
           }
         });
+        this.onEntityCreated?.({
+          entityId: jsonTopicId || imageTopicId || "unknown",
+          entityName: params.name || "Unnamed Inscription",
+          entityType: "topicId",
+          transactionId: result.result?.transactionId
+        });
         if (params.withHashLinkBlocks) {
           try {
             const blockData = await this.createHashLinkBlock(
@@ -413,6 +406,12 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
                 attributes: params.attributes
               }
             });
+            this.onEntityCreated?.({
+              entityId: jsonTopicId || imageTopicId || "unknown",
+              entityName: params.name || "Unnamed Inscription",
+              entityType: "topicId",
+              transactionId: result.result?.transactionId
+            });
             if (params.withHashLinkBlocks) {
               try {
                 const blockData = await this.createHashLinkBlock(