@hashgraphonline/conversational-agent 0.1.215 → 0.1.217

package/dist/esm/index20.js

@@ -1,293 +1,117 @@
-import { StructuredTool } from "@langchain/core/tools";
-import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-function isZodObjectLike(value) {
-  return value !== null && typeof value === "object" && "_def" in value && typeof value._def === "object" && value._def.typeName === "ZodObject" && "shape" in value._def;
-}
-class ExternalToolWrapper extends StructuredTool {
-  constructor(originalTool, config = {}) {
-    super();
-    this.originalTool = originalTool;
-    this.wrapperConfig = config;
-    this.logger = new Logger({ module: "ExternalToolWrapper" });
-    this.name = originalTool.name;
-    this.description = config.ui?.description || originalTool.description;
-    this.enhancedSchema = this.createEnhancedSchema(originalTool.schema, config);
-    this.schema = this.enhancedSchema;
-    this.logger.info(`Wrapped external tool: ${this.name}`, {
-      hasRenderConfig: !!config.renderConfig,
-      fieldConfigCount: Object.keys(config.fieldConfigs || {}).length,
-      preserveOriginal: config.preserveOriginalSchema
-    });
-  }
+class ResponseFormatter {
   /**
-   * Creates an enhanced schema with render configurations
+   * Checks if a parsed response contains HashLink block data for interactive rendering
    */
-  createEnhancedSchema(originalSchema, config) {
-    if (!isZodObjectLike(originalSchema)) {
-      this.logger.warn("Original schema is not a ZodObject, returning as-is");
-      return originalSchema;
-    }
-    try {
-      let enhancedSchema = originalSchema;
-      if (config.fieldConfigs && Object.keys(config.fieldConfigs).length > 0) {
-        enhancedSchema = this.addFieldRenderConfigs(enhancedSchema, config.fieldConfigs);
-      }
-      if (config.renderConfig) {
-        enhancedSchema = this.addToolRenderConfig(enhancedSchema, config.renderConfig);
-      }
-      return enhancedSchema;
-    } catch (error) {
-      this.logger.error("Failed to create enhanced schema:", error);
-      return originalSchema;
+  static isHashLinkResponse(parsed) {
+    if (!parsed || typeof parsed !== "object") {
+      return false;
     }
+    const responseObj = parsed;
+    return !!(responseObj.success === true && responseObj.type === "inscription" && responseObj.hashLinkBlock && typeof responseObj.hashLinkBlock === "object");
   }
   /**
-   * Adds field-level render configurations to the schema
-   */
-  addFieldRenderConfigs(schema, fieldConfigs) {
-    const originalShape = schema._def.shape();
-    const enhancedShape = {};
-    for (const [fieldName, fieldSchema] of Object.entries(originalShape)) {
-      let enhancedFieldSchema = fieldSchema;
-      if (fieldConfigs[fieldName]) {
-        enhancedFieldSchema = this.addRenderConfigToField(
-          fieldSchema,
-          fieldConfigs[fieldName]
-        );
-      }
-      enhancedShape[fieldName] = enhancedFieldSchema;
+   * Formats HashLink block response with simple text confirmation
+   * HTML template rendering is handled by HashLinkBlockRenderer component via metadata
+   */
+  static formatHashLinkResponse(parsed) {
+    const hashLinkBlock = parsed.hashLinkBlock;
+    const metadata = parsed.metadata || {};
+    const inscription = parsed.inscription || {};
+    let message = "✅ Interactive content created successfully!\n\n";
+    if (metadata.name) {
+      message += `**${metadata.name}**
+`;
     }
-    return z.object(enhancedShape);
-  }
-  /**
-   * Adds render configuration to a specific field
-   */
-  addRenderConfigToField(fieldSchema, renderConfig) {
-    const enhanced = fieldSchema.describe(
-      fieldSchema.description || renderConfig.ui?.helpText || ""
-    );
-    enhanced._renderConfig = renderConfig;
-    return enhanced;
-  }
-  /**
-   * Adds tool-level render configuration to the schema
-   */
-  addToolRenderConfig(schema, renderConfig) {
-    const enhanced = schema.describe(
-      schema.description || renderConfig.ui?.helpText || ""
-    );
-    enhanced._renderConfig = renderConfig;
-    return enhanced;
-  }
-  /**
-   * Override _call to delegate to the original tool
-   */
-  async _call(input, runManager) {
-    this.logger.debug(`Delegating call to original tool: ${this.name}`, { input });
-    const tool = this.originalTool;
-    return tool._call(input, runManager);
-  }
-}
-const renderConfigs = {
-  /**
-   * Text input field configuration
-   */
-  text: (label, placeholder, helpText) => ({
-    fieldType: "text",
-    ui: {
-      label,
-      ...placeholder && { placeholder },
-      ...helpText && { helpText }
+    if (metadata.description) {
+      message += `${metadata.description}
+
+`;
     }
-  }),
-  /**
-   * Number input field configuration
-   */
-  number: (label, min, max, placeholder) => ({
-    fieldType: "number",
-    ui: {
-      label,
-      ...placeholder && { placeholder }
-    },
-    ...min !== void 0 || max !== void 0 ? {
-      constraints: {
-        ...min !== void 0 && { min },
-        ...max !== void 0 && { max }
-      }
-    } : {}
-  }),
-  /**
-   * Select dropdown field configuration
-   */
-  select: (label, options, helpText) => ({
-    fieldType: "select",
-    ui: {
-      label,
-      ...helpText && { helpText }
-    },
-    options
-  }),
-  /**
-   * Textarea field configuration
-   */
-  textarea: (label, placeholder, maxLength) => ({
-    fieldType: "textarea",
-    ui: {
-      label,
-      ...placeholder && { placeholder }
-    },
-    ...maxLength !== void 0 ? {
-      constraints: {
-        maxLength
-      }
-    } : {}
-  }),
-  /**
-   * Checkbox field configuration
-   */
-  checkbox: (label, helpText) => ({
-    fieldType: "checkbox",
-    ui: {
-      label,
-      ...helpText && { helpText }
+    if (inscription.topicId || hashLinkBlock.attributes.topicId) {
+      message += `📍 **Topic ID:** ${inscription.topicId || hashLinkBlock.attributes.topicId}
+`;
     }
-  }),
-  /**
-   * Currency field configuration
-   */
-  currency: (label, currency = "HBAR", min, max) => ({
-    fieldType: "currency",
-    ui: {
-      label,
-      placeholder: `Amount in ${currency}`
-    },
-    ...min !== void 0 || max !== void 0 ? {
-      constraints: {
-        ...min !== void 0 && { min },
-        ...max !== void 0 && { max }
-      }
-    } : {}
-  }),
-  /**
-   * Account ID field configuration
-   */
-  accountId: (label = "Account ID") => ({
-    fieldType: "text",
-    ui: {
-      label,
-      placeholder: "0.0.123456",
-      helpText: "Hedera account ID in format 0.0.accountNum"
-    },
-    constraints: {
-      pattern: "^0\\.0\\.[0-9]+$"
+    if (inscription.hrl || hashLinkBlock.attributes.hrl) {
+      message += `🔗 **HRL:** ${inscription.hrl || hashLinkBlock.attributes.hrl}
+`;
     }
-  }),
-  /**
-   * Token ID field configuration
-   */
-  tokenId: (label = "Token ID") => ({
-    fieldType: "text",
-    ui: {
-      label,
-      placeholder: "0.0.789012",
-      helpText: "Hedera token ID in format 0.0.tokenNum"
-    },
-    constraints: {
-      pattern: "^0\\.0\\.[0-9]+$"
+    if (inscription.cdnUrl) {
+      message += `🌐 **CDN URL:** ${inscription.cdnUrl}
+`;
     }
-  }),
-  /**
-   * Private key field configuration
-   */
-  privateKey: (label = "Private Key") => ({
-    fieldType: "text",
-    ui: {
-      label,
-      placeholder: "Enter private key",
-      helpText: "DER-encoded private key as hex string"
-    },
-    constraints: {
-      minLength: 64,
-      maxLength: 128
+    if (metadata.creator) {
+      message += `👤 **Creator:** ${metadata.creator}
+`;
     }
-  })
-};
-function wrapExternalToolWithRenderConfig(tool, config = {}) {
-  return new ExternalToolWrapper(tool, config);
-}
-function wrapExternalTools(tools) {
-  return tools.map(
-    ({ tool, config = {} }) => wrapExternalToolWithRenderConfig(tool, config)
-  );
-}
-const hederaToolConfigs = {
+    message += "\n⚡ Interactive content will load below";
+    return message.trim();
+  }
   /**
-   * Standard configuration for HBAR transfer tools
+   * Checks if a parsed response is an inscription response that needs formatting
    */
-  hbarTransfer: () => ({
-    ui: {
-      label: "Transfer HBAR",
-      description: "Transfer HBAR between accounts"
-    },
-    fieldConfigs: {
-      fromAccountId: renderConfigs.accountId("From Account"),
-      toAccountId: renderConfigs.accountId("To Account"),
-      amount: renderConfigs.currency("Amount", "HBAR", 1e-8),
-      memo: renderConfigs.text("Memo", "Optional memo", "Transaction memo (optional)")
+  static isInscriptionResponse(parsed) {
+    if (!parsed || typeof parsed !== "object") {
+      return false;
     }
-  }),
+    const responseObj = parsed;
+    return !!(responseObj.success === true && responseObj.type === "inscription" && responseObj.inscription && typeof responseObj.inscription === "object");
+  }
   /**
-   * Standard configuration for token creation tools
-   */
-  tokenCreation: () => ({
-    ui: {
-      label: "Create Token",
-      description: "Create a new Hedera token"
-    },
-    fieldConfigs: {
-      treasuryAccountId: renderConfigs.accountId("Treasury Account"),
-      tokenName: renderConfigs.text("Token Name", "My Token"),
-      tokenSymbol: renderConfigs.text("Token Symbol", "MTK"),
-      maxSupply: renderConfigs.number("Max Supply", 1, Number.MAX_SAFE_INTEGER),
-      decimals: renderConfigs.number("Decimals", 0, 18),
-      memo: renderConfigs.textarea("Memo", "Token description")
+   * Formats inscription response into user-friendly message
+   */
+  static formatInscriptionResponse(parsed) {
+    const inscription = parsed.inscription;
+    const metadata = parsed.metadata || {};
+    const title = parsed.title || "Inscription Complete";
+    let message = `✅ ${title}
+
+`;
+    if (metadata.name) {
+      message += `**${metadata.name}**
+`;
     }
-  }),
-  /**
-   * Standard configuration for account creation tools
-   */
-  accountCreation: () => ({
-    ui: {
-      label: "Create Account",
-      description: "Create a new Hedera account"
-    },
-    fieldConfigs: {
-      publicKey: renderConfigs.text("Public Key", "ED25519 public key"),
-      initialBalance: renderConfigs.currency("Initial Balance", "HBAR", 0),
-      memo: renderConfigs.text("Memo", "Account memo", "Optional account memo")
+    if (metadata.description) {
+      message += `${metadata.description}
+
+`;
+    }
+    if (inscription.topicId) {
+      message += `📍 **Topic ID:** ${inscription.topicId}
+`;
+    }
+    if (inscription.hrl) {
+      message += `🔗 **HRL:** ${inscription.hrl}
+`;
+    }
+    if (inscription.cdnUrl) {
+      message += `🌐 **CDN URL:** ${inscription.cdnUrl}
+`;
+    }
+    if (metadata.creator) {
+      message += `👤 **Creator:** ${metadata.creator}
+`;
     }
-  }),
+    return message.trim();
+  }
   /**
-   * Standard configuration for smart contract tools
+   * Main formatting method that determines the best response format
    */
-  smartContract: () => ({
-    ui: {
-      label: "Smart Contract",
-      description: "Deploy or call smart contract"
-    },
-    fieldConfigs: {
-      contractId: renderConfigs.text("Contract ID", "0.0.123456"),
-      gas: renderConfigs.number("Gas Limit", 1e3, 1e6),
-      payableAmount: renderConfigs.currency("Payable Amount", "HBAR", 0)
+  static formatResponse(toolOutput) {
+    try {
+      const parsed = JSON.parse(toolOutput);
+      if (ResponseFormatter.isHashLinkResponse(parsed)) {
+        return ResponseFormatter.formatHashLinkResponse(parsed);
+      }
+      if (ResponseFormatter.isInscriptionResponse(parsed)) {
+        return ResponseFormatter.formatInscriptionResponse(parsed);
+      }
+      return toolOutput;
+    } catch {
+      return toolOutput;
     }
-  })
-};
+  }
+}
 export {
-  ExternalToolWrapper,
-  hederaToolConfigs,
-  renderConfigs,
-  wrapExternalToolWithRenderConfig,
-  wrapExternalTools
+  ResponseFormatter
 };
 //# sourceMappingURL=index20.js.map

package/dist/esm/index20.js.map

@@ -1 +1 @@
-{"version":3,"file":"index20.js","sources":["../../src/langchain/external-tool-wrapper.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport type { RenderConfigSchema } from '@hashgraphonline/standards-agent-kit';\n\n/**\n * Configuration for wrapping external tools with render configs\n */\nexport interface ExternalToolWrapperConfig {\n  renderConfig?: RenderConfigSchema;\n  fieldConfigs?: Record<string, RenderConfigSchema>;\n  ui?: {\n    label?: string;\n    description?: string;\n  };\n  preserveOriginalSchema?: boolean;\n}\n\n/**\n * Type guard to check if a value is a ZodObject\n */\nfunction isZodObjectLike(value: unknown): value is z.ZodObject<z.ZodRawShape> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    '_def' in value &&\n    typeof (value as any)._def === 'object' &&\n    (value as any)._def.typeName === 'ZodObject' &&\n    'shape' in (value as any)._def\n  );\n}\n\n/**\n * Wrapper class that adds render configs to external tools\n */\nexport class ExternalToolWrapper<\n  TSchema extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny>\n> extends StructuredTool<TSchema> {\n  private originalTool: StructuredTool<TSchema>;\n  private wrapperConfig: ExternalToolWrapperConfig;\n  private logger: Logger;\n  private enhancedSchema: TSchema;\n\n  name: string;\n  description: string;\n  schema: TSchema;\n\n  constructor(\n    originalTool: StructuredTool<TSchema>,\n    config: ExternalToolWrapperConfig = {}\n  ) {\n    super();\n    this.originalTool = originalTool;\n    this.wrapperConfig = config;\n    this.logger = new Logger({ module: 'ExternalToolWrapper' });\n\n    this.name = originalTool.name;\n    this.description = config.ui?.description || originalTool.description;\n    \n    // Create enhanced schema with render configs\n    this.enhancedSchema = this.createEnhancedSchema(originalTool.schema, config);\n    this.schema = this.enhancedSchema;\n\n    this.logger.info(`Wrapped external tool: ${this.name}`, {\n      hasRenderConfig: !!config.renderConfig,\n      fieldConfigCount: Object.keys(config.fieldConfigs || {}).length,\n      preserveOriginal: config.preserveOriginalSchema\n    });\n  }\n\n  /**\n   * Creates an enhanced schema with render configurations\n   */\n  private createEnhancedSchema(\n    originalSchema: TSchema,\n    config: ExternalToolWrapperConfig\n  ): TSchema {\n    if (!isZodObjectLike(originalSchema)) {\n      this.logger.warn('Original schema is not a ZodObject, returning as-is');\n      return originalSchema;\n    }\n\n    try {\n      // Start with the original schema\n      let enhancedSchema = originalSchema;\n\n      // Add field-level render configs\n      if (config.fieldConfigs && Object.keys(config.fieldConfigs).length > 0) {\n        enhancedSchema = this.addFieldRenderConfigs(enhancedSchema, config.fieldConfigs);\n      }\n\n      // Add tool-level render config\n      if (config.renderConfig) {\n        enhancedSchema = this.addToolRenderConfig(enhancedSchema, config.renderConfig);\n      }\n\n      return enhancedSchema;\n    } catch (error) {\n      this.logger.error('Failed to create enhanced schema:', error);\n      return originalSchema;\n    }\n  }\n\n  /**\n   * Adds field-level render configurations to the schema\n   */\n  private addFieldRenderConfigs(\n    schema: TSchema,\n    fieldConfigs: Record<string, RenderConfigSchema>\n  ): TSchema {\n    const originalShape = (schema as any)._def.shape();\n    const enhancedShape: Record<string, z.ZodTypeAny> = {};\n\n    // Copy all original fields\n    for (const [fieldName, fieldSchema] of Object.entries(originalShape)) {\n      let enhancedFieldSchema = fieldSchema as z.ZodTypeAny;\n\n      // Add render config if provided for this field\n      if (fieldConfigs[fieldName]) {\n        enhancedFieldSchema = this.addRenderConfigToField(\n          fieldSchema as z.ZodTypeAny,\n          fieldConfigs[fieldName]\n        );\n      }\n\n      enhancedShape[fieldName] = enhancedFieldSchema;\n    }\n\n    // Create new ZodObject with enhanced shape\n    return z.object(enhancedShape) as TSchema;\n  }\n\n  /**\n   * Adds render configuration to a specific field\n   */\n  private addRenderConfigToField(\n    fieldSchema: z.ZodTypeAny,\n    renderConfig: RenderConfigSchema\n  ): z.ZodTypeAny {\n    // Clone the field schema and add render config\n    const enhanced = fieldSchema.describe(\n      fieldSchema.description || renderConfig.ui?.helpText || ''\n    );\n\n    // Attach render config as a custom property\n    (enhanced as any)._renderConfig = renderConfig;\n\n    return enhanced;\n  }\n\n  /**\n   * Adds tool-level render configuration to the schema\n   */\n  private addToolRenderConfig(\n    schema: TSchema,\n    renderConfig: RenderConfigSchema\n  ): TSchema {\n    // Clone the schema and add tool-level render config\n    const enhanced = schema.describe(\n      schema.description || renderConfig.ui?.helpText || ''\n    );\n\n    // Attach render config as a custom property\n    (enhanced as any)._renderConfig = renderConfig;\n\n    return enhanced;\n  }\n\n  /**\n   * Override _call to delegate to the original tool\n   */\n  protected async _call(\n    input: z.infer<TSchema>,\n    runManager?: CallbackManagerForToolRun\n  ): Promise<string> {\n    this.logger.debug(`Delegating call to original tool: ${this.name}`, { input });\n\n    // Delegate to the original tool\n    const tool = this.originalTool as any;\n    return tool._call(input, runManager) as Promise<string>;\n  }\n}\n\n/**\n * Predefined render config helpers for common field types\n */\nexport const renderConfigs = {\n  /**\n   * Text input field configuration\n   */\n  text: (label: string, placeholder?: string, helpText?: string): RenderConfigSchema => ({\n    fieldType: 'text',\n    ui: {\n      label,\n      ...(placeholder && { placeholder }),\n      ...(helpText && { helpText })\n    }\n  }),\n\n  /**\n   * Number input field configuration\n   */\n  number: (\n    label: string,\n    min?: number,\n    max?: number,\n    placeholder?: string\n  ): RenderConfigSchema => ({\n    fieldType: 'number',\n    ui: {\n      label,\n      ...(placeholder && { placeholder })\n    },\n    ...(min !== undefined || max !== undefined ? {\n      constraints: {\n        ...(min !== undefined && { min }),\n        ...(max !== undefined && { max })\n      }\n    } : {})\n  }),\n\n  /**\n   * Select dropdown field configuration\n   */\n  select: (\n    label: string,\n    options: Array<{ value: string | number; label: string; disabled?: boolean }>,\n    helpText?: string\n  ): RenderConfigSchema => ({\n    fieldType: 'select',\n    ui: {\n      label,\n      ...(helpText && { helpText })\n    },\n    options\n  }),\n\n  /**\n   * Textarea field configuration\n   */\n  textarea: (\n    label: string,\n    placeholder?: string,\n    maxLength?: number\n  ): RenderConfigSchema => ({\n    fieldType: 'textarea',\n    ui: {\n      label,\n      ...(placeholder && { placeholder })\n    },\n    ...(maxLength !== undefined ? {\n      constraints: {\n        maxLength\n      }\n    } : {})\n  }),\n\n  /**\n   * Checkbox field configuration\n   */\n  checkbox: (label: string, helpText?: string): RenderConfigSchema => ({\n    fieldType: 'checkbox',\n    ui: {\n      label,\n      ...(helpText && { helpText })\n    }\n  }),\n\n  /**\n   * Currency field configuration\n   */\n  currency: (\n    label: string,\n    currency = 'HBAR',\n    min?: number,\n    max?: number\n  ): RenderConfigSchema => ({\n    fieldType: 'currency',\n    ui: {\n      label,\n      placeholder: `Amount in ${currency}`\n    },\n    ...(min !== undefined || max !== undefined ? {\n      constraints: {\n        ...(min !== undefined && { min }),\n        ...(max !== undefined && { max })\n      }\n    } : {})\n  }),\n\n  /**\n   * Account ID field configuration\n   */\n  accountId: (label: string = 'Account ID'): RenderConfigSchema => ({\n    fieldType: 'text',\n    ui: {\n      label,\n      placeholder: '0.0.123456',\n      helpText: 'Hedera account ID in format 0.0.accountNum'\n    },\n    constraints: {\n      pattern: '^0\\\\.0\\\\.[0-9]+$'\n    }\n  }),\n\n  /**\n   * Token ID field configuration\n   */\n  tokenId: (label: string = 'Token ID'): RenderConfigSchema => ({\n    fieldType: 'text',\n    ui: {\n      label,\n      placeholder: '0.0.789012',\n      helpText: 'Hedera token ID in format 0.0.tokenNum'\n    },\n    constraints: {\n      pattern: '^0\\\\.0\\\\.[0-9]+$'\n    }\n  }),\n\n  /**\n   * Private key field configuration\n   */\n  privateKey: (label: string = 'Private Key'): RenderConfigSchema => ({\n    fieldType: 'text',\n    ui: {\n      label,\n      placeholder: 'Enter private key',\n      helpText: 'DER-encoded private key as hex string'\n    },\n    constraints: {\n      minLength: 64,\n      maxLength: 128\n    }\n  })\n};\n\n/**\n * Wraps an external tool with render configurations\n * \n * @param tool The external StructuredTool to wrap\n * @param config Configuration for render configs and UI\n * @returns Enhanced tool with render configurations\n * \n * @example\n * ```typescript\n * import { SomeHederaTool } from 'hedera-agent-kit';\n * \n * const externalTool = new SomeHederaTool();\n * const wrappedTool = wrapExternalToolWithRenderConfig(externalTool, {\n *   renderConfig: {\n *     fieldType: 'form',\n *     ui: { label: 'Transfer HBAR', description: 'Transfer HBAR between accounts' }\n *   },\n *   fieldConfigs: {\n *     fromAccountId: renderConfigs.accountId('From Account'),\n *     toAccountId: renderConfigs.accountId('To Account'),\n *     amount: renderConfigs.currency('Amount', 'HBAR', 0.00000001),\n *     memo: renderConfigs.text('Memo', 'Optional memo', 'Transaction memo (optional)')\n *   }\n * });\n * ```\n */\nexport function wrapExternalToolWithRenderConfig<\n  TSchema extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny>\n>(\n  tool: StructuredTool<TSchema>,\n  config: ExternalToolWrapperConfig = {}\n): ExternalToolWrapper<TSchema> {\n  return new ExternalToolWrapper(tool, config);\n}\n\n/**\n * Batch wrapper for multiple external tools\n * \n * @param tools Array of tools with their configurations\n * @returns Array of wrapped tools\n * \n * @example\n * ```typescript\n * const wrappedTools = wrapExternalTools([\n *   {\n *     tool: new TransferHbarTool(),\n *     config: {\n *       fieldConfigs: {\n *         fromAccountId: renderConfigs.accountId('From Account'),\n *         toAccountId: renderConfigs.accountId('To Account'),\n *         amount: renderConfigs.currency('Amount', 'HBAR')\n *       }\n *     }\n *   },\n *   {\n *     tool: new CreateTokenTool(),\n *     config: {\n *       fieldConfigs: {\n *         treasuryAccountId: renderConfigs.accountId('Treasury Account'),\n *         tokenName: renderConfigs.text('Token Name'),\n *         tokenSymbol: renderConfigs.text('Token Symbol')\n *       }\n *     }\n *   }\n * ]);\n * ```\n */\nexport function wrapExternalTools<\n  TSchema extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny>\n>(\n  tools: Array<{\n    tool: StructuredTool<TSchema>;\n    config?: ExternalToolWrapperConfig;\n  }>\n): ExternalToolWrapper<TSchema>[] {\n  return tools.map(({ tool, config = {} }) =>\n    wrapExternalToolWithRenderConfig(tool, config)\n  );\n}\n\n/**\n * Configuration preset for common Hedera tools\n */\nexport const hederaToolConfigs = {\n  /**\n   * Standard configuration for HBAR transfer tools\n   */\n  hbarTransfer: (): ExternalToolWrapperConfig => ({\n    ui: {\n      label: 'Transfer HBAR',\n      description: 'Transfer HBAR between accounts'\n    },\n    fieldConfigs: {\n      fromAccountId: renderConfigs.accountId('From Account'),\n      toAccountId: renderConfigs.accountId('To Account'),\n      amount: renderConfigs.currency('Amount', 'HBAR', 0.00000001),\n      memo: renderConfigs.text('Memo', 'Optional memo', 'Transaction memo (optional)')\n    }\n  }),\n\n  /**\n   * Standard configuration for token creation tools\n   */\n  tokenCreation: (): ExternalToolWrapperConfig => ({\n    ui: {\n      label: 'Create Token',\n      description: 'Create a new Hedera token'\n    },\n    fieldConfigs: {\n      treasuryAccountId: renderConfigs.accountId('Treasury Account'),\n      tokenName: renderConfigs.text('Token Name', 'My Token'),\n      tokenSymbol: renderConfigs.text('Token Symbol', 'MTK'),\n      maxSupply: renderConfigs.number('Max Supply', 1, Number.MAX_SAFE_INTEGER),\n      decimals: renderConfigs.number('Decimals', 0, 18),\n      memo: renderConfigs.textarea('Memo', 'Token description')\n    }\n  }),\n\n  /**\n   * Standard configuration for account creation tools\n   */\n  accountCreation: (): ExternalToolWrapperConfig => ({\n    ui: {\n      label: 'Create Account',\n      description: 'Create a new Hedera account'\n    },\n    fieldConfigs: {\n      publicKey: renderConfigs.text('Public Key', 'ED25519 public key'),\n      initialBalance: renderConfigs.currency('Initial Balance', 'HBAR', 0),\n      memo: renderConfigs.text('Memo', 'Account memo', 'Optional account memo')\n    }\n  }),\n\n  /**\n   * Standard configuration for smart contract tools\n   */\n  smartContract: (): ExternalToolWrapperConfig => ({\n    ui: {\n      label: 'Smart Contract',\n      description: 'Deploy or call smart contract'\n    },\n    fieldConfigs: {\n      contractId: renderConfigs.text('Contract ID', '0.0.123456'),\n      gas: renderConfigs.number('Gas Limit', 1000, 1000000),\n      payableAmount: renderConfigs.currency('Payable Amount', 'HBAR', 0)\n    }\n  })\n};"],"names":[],"mappings":";;;AAsBA,SAAS,gBAAgB,OAAqD;AAC5E,SACE,UAAU,QACV,OAAO,UAAU,YACjB,UAAU,SACV,OAAQ,MAAc,SAAS,YAC9B,MAAc,KAAK,aAAa,eACjC,WAAY,MAAc;AAE9B;AAKO,MAAM,4BAEH,eAAwB;AAAA,EAUhC,YACE,cACA,SAAoC,IACpC;AACA,UAAA;AACA,SAAK,eAAe;AACpB,SAAK,gBAAgB;AACrB,SAAK,SAAS,IAAI,OAAO,EAAE,QAAQ,uBAAuB;AAE1D,SAAK,OAAO,aAAa;AACzB,SAAK,cAAc,OAAO,IAAI,eAAe,aAAa;AAG1D,SAAK,iBAAiB,KAAK,qBAAqB,aAAa,QAAQ,MAAM;AAC3E,SAAK,SAAS,KAAK;AAEnB,SAAK,OAAO,KAAK,0BAA0B,KAAK,IAAI,IAAI;AAAA,MACtD,iBAAiB,CAAC,CAAC,OAAO;AAAA,MAC1B,kBAAkB,OAAO,KAAK,OAAO,gBAAgB,CAAA,CAAE,EAAE;AAAA,MACzD,kBAAkB,OAAO;AAAA,IAAA,CAC1B;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,qBACN,gBACA,QACS;AACT,QAAI,CAAC,gBAAgB,cAAc,GAAG;AACpC,WAAK,OAAO,KAAK,qDAAqD;AACtE,aAAO;AAAA,IACT;AAEA,QAAI;AAEF,UAAI,iBAAiB;AAGrB,UAAI,OAAO,gBAAgB,OAAO,KAAK,OAAO,YAAY,EAAE,SAAS,GAAG;AACtE,yBAAiB,KAAK,sBAAsB,gBAAgB,OAAO,YAAY;AAAA,MACjF;AAGA,UAAI,OAAO,cAAc;AACvB,yBAAiB,KAAK,oBAAoB,gBAAgB,OAAO,YAAY;AAAA,MAC/E;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,qCAAqC,KAAK;AAC5D,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,sBACN,QACA,cACS;AACT,UAAM,gBAAiB,OAAe,KAAK,MAAA;AAC3C,UAAM,gBAA8C,CAAA;AAGpD,eAAW,CAAC,WAAW,WAAW,KAAK,OAAO,QAAQ,aAAa,GAAG;AACpE,UAAI,sBAAsB;AAG1B,UAAI,aAAa,SAAS,GAAG;AAC3B,8BAAsB,KAAK;AAAA,UACzB;AAAA,UACA,aAAa,SAAS;AAAA,QAAA;AAAA,MAE1B;AAEA,oBAAc,SAAS,IAAI;AAAA,IAC7B;AAGA,WAAO,EAAE,OAAO,aAAa;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKQ,uBACN,aACA,cACc;AAEd,UAAM,WAAW,YAAY;AAAA,MAC3B,YAAY,eAAe,aAAa,IAAI,YAAY;AAAA,IAAA;AAIzD,aAAiB,gBAAgB;AAElC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,oBACN,QACA,cACS;AAET,UAAM,WAAW,OAAO;AAAA,MACtB,OAAO,eAAe,aAAa,IAAI,YAAY;AAAA,IAAA;AAIpD,aAAiB,gBAAgB;AAElC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,MACd,OACA,YACiB;AACjB,SAAK,OAAO,MAAM,qCAAqC,KAAK,IAAI,IAAI,EAAE,OAAO;AAG7E,UAAM,OAAO,KAAK;AAClB,WAAO,KAAK,MAAM,OAAO,UAAU;AAAA,EACrC;AACF;AAKO,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA,EAI3B,MAAM,CAAC,OAAe,aAAsB,cAA2C;AAAA,IACrF,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,GAAI,eAAe,EAAE,YAAA;AAAA,MACrB,GAAI,YAAY,EAAE,SAAA;AAAA,IAAS;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAMF,QAAQ,CACN,OACA,KACA,KACA,iBACwB;AAAA,IACxB,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,GAAI,eAAe,EAAE,YAAA;AAAA,IAAY;AAAA,IAEnC,GAAI,QAAQ,UAAa,QAAQ,SAAY;AAAA,MAC3C,aAAa;AAAA,QACX,GAAI,QAAQ,UAAa,EAAE,IAAA;AAAA,QAC3B,GAAI,QAAQ,UAAa,EAAE,IAAA;AAAA,MAAI;AAAA,IACjC,IACE,CAAA;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAMP,QAAQ,CACN,OACA,SACA,cACwB;AAAA,IACxB,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,GAAI,YAAY,EAAE,SAAA;AAAA,IAAS;AAAA,IAE7B;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMF,UAAU,CACR,OACA,aACA,eACwB;AAAA,IACxB,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,GAAI,eAAe,EAAE,YAAA;AAAA,IAAY;AAAA,IAEnC,GAAI,cAAc,SAAY;AAAA,MAC5B,aAAa;AAAA,QACX;AAAA,MAAA;AAAA,IACF,IACE,CAAA;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAMP,UAAU,CAAC,OAAe,cAA2C;AAAA,IACnE,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,GAAI,YAAY,EAAE,SAAA;AAAA,IAAS;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAMF,UAAU,CACR,OACA,WAAW,QACX,KACA,SACwB;AAAA,IACxB,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,aAAa,aAAa,QAAQ;AAAA,IAAA;AAAA,IAEpC,GAAI,QAAQ,UAAa,QAAQ,SAAY;AAAA,MAC3C,aAAa;AAAA,QACX,GAAI,QAAQ,UAAa,EAAE,IAAA;AAAA,QAC3B,GAAI,QAAQ,UAAa,EAAE,IAAA;AAAA,MAAI;AAAA,IACjC,IACE,CAAA;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA,EAMP,WAAW,CAAC,QAAgB,kBAAsC;AAAA,IAChE,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,aAAa;AAAA,MACb,UAAU;AAAA,IAAA;AAAA,IAEZ,aAAa;AAAA,MACX,SAAS;AAAA,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAMF,SAAS,CAAC,QAAgB,gBAAoC;AAAA,IAC5D,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,aAAa;AAAA,MACb,UAAU;AAAA,IAAA;AAAA,IAEZ,aAAa;AAAA,MACX,SAAS;AAAA,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAMF,YAAY,CAAC,QAAgB,mBAAuC;AAAA,IAClE,WAAW;AAAA,IACX,IAAI;AAAA,MACF;AAAA,MACA,aAAa;AAAA,MACb,UAAU;AAAA,IAAA;AAAA,IAEZ,aAAa;AAAA,MACX,WAAW;AAAA,MACX,WAAW;AAAA,IAAA;AAAA,EACb;AAEJ;AA4BO,SAAS,iCAGd,MACA,SAAoC,IACN;AAC9B,SAAO,IAAI,oBAAoB,MAAM,MAAM;AAC7C;AAkCO,SAAS,kBAGd,OAIgC;AAChC,SAAO,MAAM;AAAA,IAAI,CAAC,EAAE,MAAM,SAAS,CAAA,EAAC,MAClC,iCAAiC,MAAM,MAAM;AAAA,EAAA;AAEjD;AAKO,MAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA,EAI/B,cAAc,OAAkC;AAAA,IAC9C,IAAI;AAAA,MACF,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,cAAc;AAAA,MACZ,eAAe,cAAc,UAAU,cAAc;AAAA,MACrD,aAAa,cAAc,UAAU,YAAY;AAAA,MACjD,QAAQ,cAAc,SAAS,UAAU,QAAQ,IAAU;AAAA,MAC3D,MAAM,cAAc,KAAK,QAAQ,iBAAiB,6BAA6B;AAAA,IAAA;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA,EAMF,eAAe,OAAkC;AAAA,IAC/C,IAAI;AAAA,MACF,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,cAAc;AAAA,MACZ,mBAAmB,cAAc,UAAU,kBAAkB;AAAA,MAC7D,WAAW,cAAc,KAAK,cAAc,UAAU;AAAA,MACtD,aAAa,cAAc,KAAK,gBAAgB,KAAK;AAAA,MACrD,WAAW,cAAc,OAAO,cAAc,GAAG,OAAO,gBAAgB;AAAA,MACxE,UAAU,cAAc,OAAO,YAAY,GAAG,EAAE;AAAA,MAChD,MAAM,cAAc,SAAS,QAAQ,mBAAmB;AAAA,IAAA;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAMF,iBAAiB,OAAkC;AAAA,IACjD,IAAI;AAAA,MACF,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,cAAc;AAAA,MACZ,WAAW,cAAc,KAAK,cAAc,oBAAoB;AAAA,MAChE,gBAAgB,cAAc,SAAS,mBAAmB,QAAQ,CAAC;AAAA,MACnE,MAAM,cAAc,KAAK,QAAQ,gBAAgB,uBAAuB;AAAA,IAAA;AAAA,EAC1E;AAAA;AAAA;AAAA;AAAA,EAMF,eAAe,OAAkC;AAAA,IAC/C,IAAI;AAAA,MACF,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,cAAc;AAAA,MACZ,YAAY,cAAc,KAAK,eAAe,YAAY;AAAA,MAC1D,KAAK,cAAc,OAAO,aAAa,KAAM,GAAO;AAAA,MACpD,eAAe,cAAc,SAAS,kBAAkB,QAAQ,CAAC;AAAA,IAAA;AAAA,EACnE;AAEJ;"}
+{"version":3,"file":"index20.js","sources":["../../src/utils/ResponseFormatter.ts"],"sourcesContent":["/**\n * HCS-12 HashLink block structure for interactive content rendering\n */\ninterface HCS12BlockResult {\n  blockId: string;\n  hashLink: string;\n  template: string;\n  attributes: Record<string, unknown>;\n}\n\n/**\n * Utility class for formatting tool responses into user-friendly messages\n */\nexport class ResponseFormatter {\n  /**\n   * Checks if a parsed response contains HashLink block data for interactive rendering\n   */\n  static isHashLinkResponse(parsed: unknown): boolean {\n    if (!parsed || typeof parsed !== 'object') {\n      return false;\n    }\n\n    const responseObj = parsed as Record<string, unknown>;\n    return !!(\n      responseObj.success === true &&\n      responseObj.type === 'inscription' &&\n      responseObj.hashLinkBlock &&\n      typeof responseObj.hashLinkBlock === 'object'\n    );\n  }\n\n  /**\n   * Formats HashLink block response with simple text confirmation\n   * HTML template rendering is handled by HashLinkBlockRenderer component via metadata\n   */\n  static formatHashLinkResponse(parsed: Record<string, unknown>): string {\n    const hashLinkBlock = parsed.hashLinkBlock as HCS12BlockResult;\n    const metadata = parsed.metadata as Record<string, unknown> || {};\n    const inscription = parsed.inscription as Record<string, unknown> || {};\n\n    let message = '✅ Interactive content created successfully!\\n\\n';\n\n    if (metadata.name) {\n      message += `**${metadata.name}**\\n`;\n    }\n\n    if (metadata.description) {\n      message += `${metadata.description}\\n\\n`;\n    }\n\n    if (inscription.topicId || hashLinkBlock.attributes.topicId) {\n      message += `📍 **Topic ID:** ${inscription.topicId || hashLinkBlock.attributes.topicId}\\n`;\n    }\n\n    if (inscription.hrl || hashLinkBlock.attributes.hrl) {\n      message += `🔗 **HRL:** ${inscription.hrl || hashLinkBlock.attributes.hrl}\\n`;\n    }\n\n    if (inscription.cdnUrl) {\n      message += `🌐 **CDN URL:** ${inscription.cdnUrl}\\n`;\n    }\n\n    if (metadata.creator) {\n      message += `👤 **Creator:** ${metadata.creator}\\n`;\n    }\n\n    message += '\\n⚡ Interactive content will load below';\n\n    return message.trim();\n  }\n\n  /**\n   * Checks if a parsed response is an inscription response that needs formatting\n   */\n  static isInscriptionResponse(parsed: unknown): boolean {\n    if (!parsed || typeof parsed !== 'object') {\n      return false;\n    }\n\n    const responseObj = parsed as Record<string, unknown>;\n    return !!(\n      responseObj.success === true &&\n      responseObj.type === 'inscription' &&\n      responseObj.inscription &&\n      typeof responseObj.inscription === 'object'\n    );\n  }\n\n  /**\n   * Formats inscription response into user-friendly message\n   */\n  static formatInscriptionResponse(parsed: Record<string, unknown>): string {\n    const inscription = parsed.inscription as Record<string, unknown>;\n    const metadata = parsed.metadata as Record<string, unknown> || {};\n    const title = parsed.title as string || 'Inscription Complete';\n\n    let message = `✅ ${title}\\n\\n`;\n\n    if (metadata.name) {\n      message += `**${metadata.name}**\\n`;\n    }\n\n    if (metadata.description) {\n      message += `${metadata.description}\\n\\n`;\n    }\n\n    if (inscription.topicId) {\n      message += `📍 **Topic ID:** ${inscription.topicId}\\n`;\n    }\n\n    if (inscription.hrl) {\n      message += `🔗 **HRL:** ${inscription.hrl}\\n`;\n    }\n\n    if (inscription.cdnUrl) {\n      message += `🌐 **CDN URL:** ${inscription.cdnUrl}\\n`;\n    }\n\n    if (metadata.creator) {\n      message += `👤 **Creator:** ${metadata.creator}\\n`;\n    }\n\n    return message.trim();\n  }\n\n  /**\n   * Main formatting method that determines the best response format\n   */\n  static formatResponse(toolOutput: string): string {\n    try {\n      const parsed = JSON.parse(toolOutput);\n      \n      if (ResponseFormatter.isHashLinkResponse(parsed)) {\n        return ResponseFormatter.formatHashLinkResponse(parsed);\n      }\n      \n      if (ResponseFormatter.isInscriptionResponse(parsed)) {\n        return ResponseFormatter.formatInscriptionResponse(parsed);\n      }\n      \n      return toolOutput;\n    } catch {\n      return toolOutput;\n    }\n  }\n}"],"names":[],"mappings":"AAaO,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAI7B,OAAO,mBAAmB,QAA0B;AAClD,QAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,aAAO;AAAA,IACT;AAEA,UAAM,cAAc;AACpB,WAAO,CAAC,EACN,YAAY,YAAY,QACxB,YAAY,SAAS,iBACrB,YAAY,iBACZ,OAAO,YAAY,kBAAkB;AAAA,EAEzC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,uBAAuB,QAAyC;AACrE,UAAM,gBAAgB,OAAO;AAC7B,UAAM,WAAW,OAAO,YAAuC,CAAA;AAC/D,UAAM,cAAc,OAAO,eAA0C,CAAA;AAErE,QAAI,UAAU;AAEd,QAAI,SAAS,MAAM;AACjB,iBAAW,KAAK,SAAS,IAAI;AAAA;AAAA,IAC/B;AAEA,QAAI,SAAS,aAAa;AACxB,iBAAW,GAAG,SAAS,WAAW;AAAA;AAAA;AAAA,IACpC;AAEA,QAAI,YAAY,WAAW,cAAc,WAAW,SAAS;AAC3D,iBAAW,oBAAoB,YAAY,WAAW,cAAc,WAAW,OAAO;AAAA;AAAA,IACxF;AAEA,QAAI,YAAY,OAAO,cAAc,WAAW,KAAK;AACnD,iBAAW,eAAe,YAAY,OAAO,cAAc,WAAW,GAAG;AAAA;AAAA,IAC3E;AAEA,QAAI,YAAY,QAAQ;AACtB,iBAAW,mBAAmB,YAAY,MAAM;AAAA;AAAA,IAClD;AAEA,QAAI,SAAS,SAAS;AACpB,iBAAW,mBAAmB,SAAS,OAAO;AAAA;AAAA,IAChD;AAEA,eAAW;AAEX,WAAO,QAAQ,KAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,sBAAsB,QAA0B;AACrD,QAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,aAAO;AAAA,IACT;AAEA,UAAM,cAAc;AACpB,WAAO,CAAC,EACN,YAAY,YAAY,QACxB,YAAY,SAAS,iBACrB,YAAY,eACZ,OAAO,YAAY,gBAAgB;AAAA,EAEvC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,0BAA0B,QAAyC;AACxE,UAAM,cAAc,OAAO;AAC3B,UAAM,WAAW,OAAO,YAAuC,CAAA;AAC/D,UAAM,QAAQ,OAAO,SAAmB;AAExC,QAAI,UAAU,KAAK,KAAK;AAAA;AAAA;AAExB,QAAI,SAAS,MAAM;AACjB,iBAAW,KAAK,SAAS,IAAI;AAAA;AAAA,IAC/B;AAEA,QAAI,SAAS,aAAa;AACxB,iBAAW,GAAG,SAAS,WAAW;AAAA;AAAA;AAAA,IACpC;AAEA,QAAI,YAAY,SAAS;AACvB,iBAAW,oBAAoB,YAAY,OAAO;AAAA;AAAA,IACpD;AAEA,QAAI,YAAY,KAAK;AACnB,iBAAW,eAAe,YAAY,GAAG;AAAA;AAAA,IAC3C;AAEA,QAAI,YAAY,QAAQ;AACtB,iBAAW,mBAAmB,YAAY,MAAM;AAAA;AAAA,IAClD;AAEA,QAAI,SAAS,SAAS;AACpB,iBAAW,mBAAmB,SAAS,OAAO;AAAA;AAAA,IAChD;AAEA,WAAO,QAAQ,KAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,eAAe,YAA4B;AAChD,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,UAAU;AAEpC,UAAI,kBAAkB,mBAAmB,MAAM,GAAG;AAChD,eAAO,kBAAkB,uBAAuB,MAAM;AAAA,MACxD;AAEA,UAAI,kBAAkB,sBAAsB,MAAM,GAAG;AACnD,eAAO,kBAAkB,0BAA0B,MAAM;AAAA,MAC3D;AAEA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;"}

package/dist/esm/index21.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AccountBuilder } from "./index30.js";
+import { AccountBuilder } from "./index33.js";
 import { BaseHederaTransactionTool } from "hedera-agent-kit";
 const HbarTransferInputSchema = z.object({
   accountId: z.string().describe('Account ID for the transfer (e.g., "0.0.xxxx").'),

package/dist/esm/index23.js

@@ -6,6 +6,20 @@ You have access to tools for:
 - Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
 - Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations
 
+*** CRITICAL NFT METADATA RULES ***
+When creating NFT inscriptions (Hashinals), NEVER auto-generate meaningless technical attributes like:
+- "File Type": "image/jpeg" (technical metadata, not valuable to collectors)
+- "Origin": "User Upload" (meaningless for NFT traits)
+- "MIME Type", "Source", "Upload Source", etc. (all technical, not collectible traits)
+
+Instead, if the user hasn't provided meaningful NFT attributes, use the form generation system to ask them for proper metadata like:
+- Rarity traits (Common, Rare, Epic, Legendary)
+- Visual attributes (Color, Style, Background, Theme)
+- Collection-specific traits (Power Level, Element, Character Type, etc.)
+- Edition information (Series, Variant, Special Edition)
+
+Quality NFT metadata enhances collectibility and value. Technical file information does not.
+
 *** IMPORTANT CONTEXT ***
 You are currently operating as agent: ${accountId} on the Hashgraph Online network
 When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}

package/dist/esm/index23.js.map

@@ -1 +1 @@
-{"version":3,"file":"index23.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hashgraph Online network\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\nRemember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAS2B,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAM1F,SAAS;AAAA;AAAA;"}
+{"version":3,"file":"index23.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n*** CRITICAL NFT METADATA RULES ***\nWhen creating NFT inscriptions (Hashinals), NEVER auto-generate meaningless technical attributes like:\n- \"File Type\": \"image/jpeg\" (technical metadata, not valuable to collectors)\n- \"Origin\": \"User Upload\" (meaningless for NFT traits)\n- \"MIME Type\", \"Source\", \"Upload Source\", etc. (all technical, not collectible traits)\n\nInstead, if the user hasn't provided meaningful NFT attributes, use the form generation system to ask them for proper metadata like:\n- Rarity traits (Common, Rare, Epic, Legendary)\n- Visual attributes (Color, Style, Background, Theme)\n- Collection-specific traits (Power Level, Element, Character Type, etc.)\n- Edition information (Series, Variant, Special Edition)\n\nQuality NFT metadata enhances collectibility and value. Technical file information does not.\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hashgraph Online network\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\nRemember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAuB2B,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAM1F,SAAS;AAAA;AAAA;"}