@hashgraphonline/standards-agent-kit 0.2.134 → 0.2.135

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es51.js","sources":["../../src/types/inscription-response.ts"],"sourcesContent":["/**\n * Structured response interface for inscription tools\n * Provides a consistent, user-friendly format for inscription results\n */\n\nexport interface InscriptionSuccessResponse {\n  success: true;\n  type: 'inscription';\n  title: string;\n  message: string;\n  inscription: {\n    /** The HRL (Hashinal Reference Link) for minting - e.g., \"hcs://1/0.0.123456\" */\n    hrl: string;\n    /** Topic ID where the inscription was stored */\n    topicId: string;\n    /** Type of Hashinal - Static (HCS-5) or Dynamic (HCS-6) */\n    standard: 'Static' | 'Dynamic';\n    /** CDN URL for direct access to the inscribed content */\n    cdnUrl?: string;\n    /** Transaction ID of the inscription */\n    transactionId?: string;\n  };\n  metadata: {\n    /** Name/title of the inscribed content */\n    name?: string;\n    /** Creator of the content */\n    creator?: string;\n    /** Description of the content */\n    description?: string;\n    /** Content type (image, text, etc.) */\n    type?: string;\n    /** Additional attributes */\n    attributes?: Array<{ trait_type: string; value: string | number }>;\n  };\n  nextSteps: {\n    /** Primary action the user should take next */\n    primary: string;\n    /** Additional context or options */\n    context?: string;\n    /** Specific metadata value to use for minting */\n    mintingMetadata: string;\n  };\n  /** HashLink block data (only present when withHashLinkBlocks=true) */\n  hashLinkBlock?: {\n    /** Block topic ID on HCS */\n    blockId: string;\n    /** HashLink reference to the block */\n    hashLink: string;\n    /** Template topic ID */\n    template: string;\n    /** Block attributes for rendering */\n    attributes: BlockAttributes;\n  };\n}\n\nexport interface InscriptionQuoteResponse {\n  success: true;\n  type: 'quote';\n  title: string;\n  message: string;\n  quote: {\n    /** Total cost in HBAR */\n    totalCostHbar: string;\n    /** When the quote expires */\n    validUntil: string;\n    /** Cost breakdown details */\n    breakdown?: CostBreakdown;\n  };\n  content: {\n    /** Name of the content to be inscribed */\n    name?: string;\n    /** Creator of the content */\n    creator?: string;\n    /** Type of content */\n    type?: string;\n  };\n}\n\nexport interface InscriptionErrorResponse {\n  success: false;\n  type: 'error';\n  title: string;\n  message: string;\n  error: {\n    /** Error code for programmatic handling */\n    code: string;\n    /** Detailed error message */\n    details: string;\n    /** Suggestions for fixing the error */\n    suggestions?: string[];\n  };\n}\n\nexport type InscriptionResponse =\n  | InscriptionSuccessResponse\n  | InscriptionQuoteResponse\n  | InscriptionErrorResponse;\n\n/**\n * Helper function to create a successful inscription response\n */\nexport function createInscriptionSuccess(params: {\n  hrl: string;\n  topicId: string;\n  standard: 'Static' | 'Dynamic';\n  cdnUrl?: string;\n  transactionId?: string;\n  metadata: {\n    name?: string;\n    creator?: string;\n    description?: string;\n    type?: string;\n    attributes?: Array<{ trait_type: string; value: string | number }>;\n  };\n}): InscriptionSuccessResponse {\n  const { hrl, topicId, standard, cdnUrl, transactionId, metadata } = params;\n\n  return {\n    success: true,\n    type: 'inscription',\n    title: `${standard} Hashinal Inscription Complete`,\n    message: `Successfully inscribed \"${\n      metadata.name || 'your content'\n    }\" as a ${standard} Hashinal. The content is now ready for NFT minting.`,\n    inscription: {\n      hrl,\n      topicId,\n      standard,\n      cdnUrl,\n      transactionId,\n    },\n    metadata,\n    nextSteps: {\n      primary: 'Use the HRL below as metadata when minting your NFT',\n      context:\n        'The HRL (Hedera Resource Locator) is the standardized way to reference your inscribed content in NFT metadata.',\n      mintingMetadata: hrl,\n    },\n  };\n}\n\n/**\n * Block attributes for HashLink rendering\n */\ninterface BlockAttributes {\n  /** Display name */\n  name?: string;\n  /** Description text */\n  description?: string;\n  /** Image URL */\n  image?: string;\n  /** Content type */\n  contentType?: string;\n  /** Size in bytes */\n  size?: number;\n  /** Custom metadata */\n  metadata?: Record<string, string | number | boolean>;\n}\n\n/**\n * Transfer details in cost breakdown\n */\ninterface TransferDetails {\n  to: string;\n  amount: string;\n  description: string;\n}\n\n/**\n * Cost breakdown details for inscription quote\n */\ninterface CostBreakdown {\n  transfers: TransferDetails[];\n  baseFee?: number;\n  sizeFee?: number;\n  networkFee?: number;\n  serviceFee?: number;\n  totalFee?: number;\n  currency?: string;\n}\n\n/**\n * Helper function to create a quote response\n */\nexport function createInscriptionQuote(params: {\n  totalCostHbar: string;\n  validUntil: string;\n  breakdown?: CostBreakdown;\n  content: {\n    name?: string;\n    creator?: string;\n    type?: string;\n  };\n}): InscriptionQuoteResponse {\n  const { totalCostHbar, validUntil, breakdown, content } = params;\n\n  return {\n    success: true,\n    type: 'quote',\n    title: 'Inscription Cost Quote',\n    message: `Estimated cost to inscribe \"${\n      content.name || 'your content'\n    }\" is ${totalCostHbar} HBAR.`,\n    quote: {\n      totalCostHbar,\n      validUntil,\n      breakdown,\n    },\n    content,\n  };\n}\n\n/**\n * Helper function to create an error response\n */\nexport function createInscriptionError(params: {\n  code: string;\n  details: string;\n  suggestions?: string[];\n}): InscriptionErrorResponse {\n  const { code, details, suggestions } = params;\n\n  return {\n    success: false,\n    type: 'error',\n    title: 'Inscription Failed',\n    message: `Unable to complete inscription: ${details}`,\n    error: {\n      code,\n      details,\n      suggestions,\n    },\n  };\n}\n"],"names":[],"mappings":"AAqGO,SAAS,yBAAyB,QAaV;AAC7B,QAAM,EAAE,KAAK,SAAS,UAAU,QAAQ,eAAe,aAAa;AAEpE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO,GAAG,QAAQ;AAAA,IAClB,SAAS,2BACP,SAAS,QAAQ,cACnB,UAAU,QAAQ;AAAA,IAClB,aAAa;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,IAEF;AAAA,IACA,WAAW;AAAA,MACT,SAAS;AAAA,MACT,SACE;AAAA,MACF,iBAAiB;AAAA,IAAA;AAAA,EACnB;AAEJ;AA6CO,SAAS,uBAAuB,QASV;AAC3B,QAAM,EAAE,eAAe,YAAY,WAAW,YAAY;AAE1D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS,+BACP,QAAQ,QAAQ,cAClB,QAAQ,aAAa;AAAA,IACrB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,IAEF;AAAA,EAAA;AAEJ;AAKO,SAAS,uBAAuB,QAIV;AAC3B,QAAM,EAAE,MAAM,SAAS,YAAA,IAAgB;AAEvC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS,mCAAmC,OAAO;AAAA,IACnD,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"standards-agent-kit.es51.js","sources":["../../src/types/inscription-response.ts"],"sourcesContent":["/**\n * Structured response interface for inscription tools\n * Provides a consistent, user-friendly format for inscription results\n */\n\nexport interface InscriptionSuccessResponse {\n  success: true;\n  type: 'inscription';\n  title: string;\n  message: string;\n  inscription: {\n    /** The HRL (Hashinal Reference Link) for minting - e.g., \"hcs://1/0.0.123456\" */\n    hrl: string;\n    /** Topic ID where the inscription was stored */\n    topicId: string;\n    /** Type of Hashinal - Static (HCS-5) or Dynamic (HCS-6) */\n    standard: 'Static' | 'Dynamic';\n    /** CDN URL for direct access to the inscribed content */\n    cdnUrl?: string;\n    /** Transaction ID of the inscription */\n    transactionId?: string;\n  };\n  metadata: {\n    /** Name/title of the inscribed content */\n    name?: string;\n    /** Creator of the content */\n    creator?: string;\n    /** Description of the content */\n    description?: string;\n    /** Content type (image, text, etc.) */\n    type?: string;\n    /** Additional attributes */\n    attributes?: Array<{ trait_type: string; value: string | number }>;\n  };\n  nextSteps: {\n    /** Primary action the user should take next */\n    primary: string;\n    /** Additional context or options */\n    context?: string;\n    /** Specific metadata value to use for minting */\n    mintingMetadata: string;\n  };\n  /** HashLink block data (only present when withHashLinkBlocks=true) */\n  hashLinkBlock?: {\n    /** Block topic ID on HCS */\n    blockId: string;\n    /** HashLink reference to the block */\n    hashLink: string;\n    /** Template topic ID */\n    template: string;\n    /** Block attributes for rendering */\n    attributes: BlockAttributes;\n  };\n}\n\nexport interface InscriptionQuoteResponse {\n  success: true;\n  type: 'quote';\n  title: string;\n  message: string;\n  quote: {\n    /** Total cost in HBAR */\n    totalCostHbar: string;\n    /** When the quote expires */\n    validUntil: string;\n    /** Cost breakdown details */\n    breakdown?: CostBreakdown;\n  };\n  content: {\n    /** Name of the content to be inscribed */\n    name?: string;\n    /** Creator of the content */\n    creator?: string;\n    /** Type of content */\n    type?: string;\n  };\n}\n\nexport interface InscriptionErrorResponse {\n  success: false;\n  type: 'error';\n  title: string;\n  message: string;\n  error: {\n    /** Error code for programmatic handling */\n    code: string;\n    /** Detailed error message */\n    details: string;\n    /** Suggestions for fixing the error */\n    suggestions?: string[];\n  };\n}\n\nexport type InscriptionResponse =\n  | InscriptionSuccessResponse\n  | InscriptionQuoteResponse\n  | InscriptionErrorResponse;\n\n/**\n * Helper function to create a successful inscription response\n */\nexport function createInscriptionSuccess(params: {\n  hrl: string;\n  topicId: string;\n  standard: 'Static' | 'Dynamic';\n  cdnUrl?: string;\n  transactionId?: string;\n  metadata: {\n    name?: string;\n    creator?: string;\n    description?: string;\n    type?: string;\n    attributes?: Array<{ trait_type: string; value: string | number }>;\n  };\n}): InscriptionSuccessResponse {\n  const { hrl, topicId, standard, cdnUrl, transactionId, metadata } = params;\n\n  return {\n    success: true,\n    type: 'inscription',\n    title: `${standard} Hashinal Inscription Complete`,\n    message: `Successfully inscribed \"${\n      metadata.name || 'your content'\n    }\" as a ${standard} Hashinal. The content is now ready for NFT minting.`,\n    inscription: {\n      hrl,\n      topicId,\n      standard,\n      cdnUrl,\n      transactionId,\n    },\n    metadata,\n    nextSteps: {\n      primary: 'CRITICAL: When minting NFTs, use ONLY the mintingMetadata value as a single string in the metadata array. Do NOT create JSON objects.',\n      context:\n        'The metadata parameter for minting should be exactly: [\"' + hrl + '\"] - just the HRL string in an array, nothing else.',\n      mintingMetadata: hrl,\n    },\n  };\n}\n\n/**\n * Block attributes for HashLink rendering\n */\ninterface BlockAttributes {\n  /** Display name */\n  name?: string;\n  /** Description text */\n  description?: string;\n  /** Image URL */\n  image?: string;\n  /** Content type */\n  contentType?: string;\n  /** Size in bytes */\n  size?: number;\n  /** Custom metadata */\n  metadata?: Record<string, string | number | boolean>;\n}\n\n/**\n * Transfer details in cost breakdown\n */\ninterface TransferDetails {\n  to: string;\n  amount: string;\n  description: string;\n}\n\n/**\n * Cost breakdown details for inscription quote\n */\ninterface CostBreakdown {\n  transfers: TransferDetails[];\n  baseFee?: number;\n  sizeFee?: number;\n  networkFee?: number;\n  serviceFee?: number;\n  totalFee?: number;\n  currency?: string;\n}\n\n/**\n * Helper function to create a quote response\n */\nexport function createInscriptionQuote(params: {\n  totalCostHbar: string;\n  validUntil: string;\n  breakdown?: CostBreakdown;\n  content: {\n    name?: string;\n    creator?: string;\n    type?: string;\n  };\n}): InscriptionQuoteResponse {\n  const { totalCostHbar, validUntil, breakdown, content } = params;\n\n  return {\n    success: true,\n    type: 'quote',\n    title: 'Inscription Cost Quote',\n    message: `Estimated cost to inscribe \"${\n      content.name || 'your content'\n    }\" is ${totalCostHbar} HBAR.`,\n    quote: {\n      totalCostHbar,\n      validUntil,\n      breakdown,\n    },\n    content,\n  };\n}\n\n/**\n * Helper function to create an error response\n */\nexport function createInscriptionError(params: {\n  code: string;\n  details: string;\n  suggestions?: string[];\n}): InscriptionErrorResponse {\n  const { code, details, suggestions } = params;\n\n  return {\n    success: false,\n    type: 'error',\n    title: 'Inscription Failed',\n    message: `Unable to complete inscription: ${details}`,\n    error: {\n      code,\n      details,\n      suggestions,\n    },\n  };\n}\n"],"names":[],"mappings":"AAqGO,SAAS,yBAAyB,QAaV;AAC7B,QAAM,EAAE,KAAK,SAAS,UAAU,QAAQ,eAAe,aAAa;AAEpE,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO,GAAG,QAAQ;AAAA,IAClB,SAAS,2BACP,SAAS,QAAQ,cACnB,UAAU,QAAQ;AAAA,IAClB,aAAa;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,IAEF;AAAA,IACA,WAAW;AAAA,MACT,SAAS;AAAA,MACT,SACE,6DAA6D,MAAM;AAAA,MACrE,iBAAiB;AAAA,IAAA;AAAA,EACnB;AAEJ;AA6CO,SAAS,uBAAuB,QASV;AAC3B,QAAM,EAAE,eAAe,YAAY,WAAW,YAAY;AAE1D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS,+BACP,QAAQ,QAAQ,cAClB,QAAQ,aAAa;AAAA,IACrB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,IAEF;AAAA,EAAA;AAEJ;AAKO,SAAS,uBAAuB,QAIV;AAC3B,QAAM,EAAE,MAAM,SAAS,YAAA,IAAgB;AAEvC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS,mCAAmC,OAAO;AAAA,IACnD,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/es/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>;

package/dist/es/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