@hashgraphonline/standards-agent-kit 0.2.119 → 0.2.121

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

@@ -1,75 +1,87 @@
 import { z } from "zod";
-import { BaseInscriberQueryTool } from "./standards-agent-kit.es32.js";
-const inscribeFromBufferSchema = z.object({
-  base64Data: z.string().min(1, "Data cannot be empty").describe('The FULL content to inscribe as plain text or base64. When asked to "inscribe it" after retrieving content, pass ALL the content you retrieved here as plain text - NOT a summary, NOT URLs, NOT truncated. Example: if you fetched Wikipedia articles, pass the complete article text you received.'),
-  fileName: z.string().min(1, "File name cannot be empty").describe("Name for the inscribed content. Required for all inscriptions."),
-  mimeType: z.string().optional().describe("MIME type of the content"),
+import { BaseInscriberQueryTool } from "./standards-agent-kit.es33.js";
+import * as fs from "fs/promises";
+import * as path from "path";
+const inscribeFromFileSchema = z.object({
+  filePath: z.string().min(1, "File path cannot be empty").describe("The file path of the content to inscribe. Must point to a valid, non-empty file."),
   mode: z.enum(["file", "hashinal"]).optional().describe("Inscription mode: file or hashinal NFT"),
   metadata: z.record(z.unknown()).optional().describe("Metadata to attach to the inscription"),
   tags: z.array(z.string()).optional().describe("Tags to categorize the inscription"),
   chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
   waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
-  timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds for inscription (default: no timeout - waits until completion)"),
+  timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds for inscription (default: no timeout)"),
   apiKey: z.string().optional().describe("API key for inscription service")
 });
-class InscribeFromBufferTool extends BaseInscriberQueryTool {
+class InscribeFromFileTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
-    this.name = "inscribeFromBuffer";
-    this.description = 'PRIMARY inscription tool for ANY content you have already retrieved. USE THIS when asked to "inscribe it" after fetching content from MCP tools, search results, or any text data. Pass THE FULL CONTENT as plain text in base64Data field - the tool accepts both plain text and base64. CRITICAL: Pass the COMPLETE content you retrieved, NOT a summary or truncated version. Example: If you fetched Wikipedia articles with full text, pass ALL that text here as plain text.';
+    this.name = "inscribeFromFile";
+    this.description = "Inscribe content from a local file to the Hedera network using a file path. IMPORTANT: Only use this tool when you have a valid file path to actual content. The file must exist and contain meaningful data (minimum 10 bytes). For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.";
   }
   get specificInputSchema() {
-    return inscribeFromBufferSchema;
+    return inscribeFromFileSchema;
   }
   async executeQuery(params, _runManager) {
-    console.log(`[DEBUG] InscribeFromBufferTool.executeQuery called`);
-    console.log(`[DEBUG] Buffer tool received base64Data length: ${params.base64Data?.length || 0}`);
-    console.log(`[DEBUG] Buffer tool fileName: ${params.fileName}`);
-    console.log(`[DEBUG] Buffer tool mimeType: ${params.mimeType}`);
-    if (!params.base64Data || params.base64Data.trim() === "") {
-      console.log(`[InscribeFromBufferTool] ERROR: No data provided`);
-      throw new Error("No data provided. Cannot inscribe empty content. Please provide valid base64 encoded data.");
-    }
-    if (!params.fileName || params.fileName.trim() === "") {
-      console.log(`[InscribeFromBufferTool] ERROR: No fileName provided`);
-      throw new Error("No fileName provided. A valid fileName is required for inscription.");
-    }
-    let buffer;
-    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(params.base64Data);
-    if (isValidBase64) {
-      try {
-        buffer = Buffer.from(params.base64Data, "base64");
-        console.log(`[InscribeFromBufferTool] Successfully decoded base64 data`);
-      } catch (error) {
-        console.log(`[InscribeFromBufferTool] ERROR: Failed to decode base64`);
-        throw new Error("Failed to decode base64 data. Please ensure the data is properly encoded.");
+    console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);
+    let fileContent;
+    try {
+      console.log(`[DEBUG] Checking file: ${params.filePath}`);
+      console.log(`[DEBUG] Current working directory: ${process.cwd()}`);
+      const stats = await fs.stat(params.filePath);
+      if (!stats.isFile()) {
+        throw new Error(`Path "${params.filePath}" is not a file`);
       }
-    } else {
-      console.log(`[InscribeFromBufferTool] WARNING: Data is not base64 encoded, treating as plain text`);
-      buffer = Buffer.from(params.base64Data, "utf8");
-      console.log(`[InscribeFromBufferTool] Converted plain text to buffer`);
-    }
-    console.log(`[InscribeFromBufferTool] Buffer length after conversion: ${buffer.length}`);
-    if (buffer.length === 0) {
-      console.log(`[InscribeFromBufferTool] ERROR: Buffer is empty after conversion`);
-      throw new Error("Buffer is empty after conversion. The provided data appears to be invalid or empty.");
-    }
-    if (buffer.length < 10) {
-      console.log(`[InscribeFromBufferTool] WARNING: Buffer is very small (${buffer.length} bytes)`);
-      console.log(`[InscribeFromBufferTool] Buffer content preview: ${buffer.toString("utf8", 0, Math.min(buffer.length, 50))}`);
-      throw new Error(`Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`);
-    }
-    if (buffer.toString("utf8", 0, Math.min(buffer.length, 100)).trim() === "") {
-      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains only whitespace or empty content`);
-      throw new Error("Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.");
-    }
-    const contentStr = buffer.toString("utf8");
-    const emptyHtmlPattern = /<a\s+href=["'][^"']+["']\s*>\s*<\/a>/i;
-    const hasOnlyEmptyLinks = emptyHtmlPattern.test(contentStr) && contentStr.replace(/<[^>]+>/g, "").trim().length < 50;
-    if (hasOnlyEmptyLinks) {
-      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains empty HTML with just links and no content`);
-      throw new Error("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.");
+      console.log(`[DEBUG] File size: ${stats.size} bytes`);
+      if (stats.size === 0) {
+        throw new Error(
+          `File "${params.filePath}" is empty (0 bytes). Cannot inscribe empty files.`
+        );
+      }
+      if (stats.size < 10) {
+        throw new Error(
+          `File "${params.filePath}" is too small (${stats.size} bytes). Files must contain at least 10 bytes of meaningful content.`
+        );
+      }
+      if (stats.size > 100 * 1024 * 1024) {
+        console.log(`[InscribeFromFileTool] WARNING: Large file detected (${(stats.size / (1024 * 1024)).toFixed(2)} MB)`);
+      }
+      this.logger?.info("Reading file content...");
+      fileContent = await fs.readFile(params.filePath);
+      this.logger?.info(`Read ${fileContent.length} bytes from file`);
+      if (!fileContent || fileContent.length === 0) {
+        throw new Error(
+          `File "${params.filePath}" has no content after reading. Cannot inscribe empty files.`
+        );
+      }
+      if (fileContent.length < 10) {
+        throw new Error(
+          `File "${params.filePath}" content is too small (${fileContent.length} bytes). Files must contain at least 10 bytes of meaningful content.`
+        );
+      }
+      const fileName2 = path.basename(params.filePath);
+      const mimeType2 = this.getMimeType(fileName2);
+      if (mimeType2.startsWith("text/") || mimeType2 === "application/json") {
+        const textContent = fileContent.toString("utf8", 0, Math.min(fileContent.length, 1e3));
+        if (textContent.trim() === "") {
+          throw new Error(
+            `File "${params.filePath}" contains only whitespace or empty content. Cannot inscribe meaningless data.`
+          );
+        }
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.message.includes("ENOENT")) {
+          throw new Error(`File not found: "${params.filePath}"`);
+        }
+        throw error;
+      }
+      throw new Error(`Failed to read file: ${error}`);
     }
+    const base64Data = fileContent.toString("base64");
+    this.logger?.info(`Converted to base64: ${base64Data.length} characters`);
+    const fileName = path.basename(params.filePath);
+    const mimeType = this.getMimeType(fileName);
+    this.logger?.info(`File: ${fileName}, MIME type: ${mimeType}`);
     const options = {
       mode: params.mode,
       metadata: params.metadata,
@@ -94,9 +106,9 @@ class InscribeFromBufferTool extends BaseInscriberQueryTool {
           this.inscriberBuilder.inscribe(
             {
               type: "buffer",
-              buffer,
-              fileName: params.fileName,
-              mimeType: params.mimeType
+              buffer: Buffer.from(base64Data, "base64"),
+              fileName,
+              mimeType
             },
             options
           ),
@@ -106,9 +118,9 @@ class InscribeFromBufferTool extends BaseInscriberQueryTool {
         result = await this.inscriberBuilder.inscribe(
           {
             type: "buffer",
-            buffer,
-            fileName: params.fileName,
-            mimeType: params.mimeType
+            buffer: Buffer.from(base64Data, "base64"),
+            fileName,
+            mimeType
           },
           options
         );
@@ -132,12 +144,35 @@ Transaction ID: ${result.result.transactionId}
 The inscription is processing and will be confirmed shortly.`;
       }
     } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "Failed to inscribe from buffer";
+      const errorMessage = error instanceof Error ? error.message : "Failed to inscribe from file";
       throw new Error(`Inscription failed: ${errorMessage}`);
     }
   }
+  getMimeType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    const mimeTypes = {
+      ".png": "image/png",
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".svg": "image/svg+xml",
+      ".pdf": "application/pdf",
+      ".json": "application/json",
+      ".txt": "text/plain",
+      ".html": "text/html",
+      ".css": "text/css",
+      ".js": "application/javascript",
+      ".ts": "application/typescript",
+      ".mp4": "video/mp4",
+      ".mp3": "audio/mpeg",
+      ".wav": "audio/wav",
+      ".zip": "application/zip"
+    };
+    return mimeTypes[ext] || "application/octet-stream";
+  }
 }
 export {
-  InscribeFromBufferTool
+  InscribeFromFileTool
 };
 //# sourceMappingURL=standards-agent-kit.es35.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es35.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';\n\n/**\n * Schema for inscribing from buffer\n */\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z.string().min(1, 'Data cannot be empty').describe('The FULL content to inscribe as plain text or base64. When asked to \"inscribe it\" after retrieving content, pass ALL the content you retrieved here as plain text - NOT a summary, NOT URLs, NOT truncated. Example: if you fetched Wikipedia articles, pass the complete article text you received.'),\n  fileName: z.string().min(1, 'File name cannot be empty').describe('Name for the inscribed content. Required for all inscriptions.'),\n  mimeType: z\n    .string()\n    .optional()\n    .describe('MIME type of the content'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\n  chunkSize: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Chunk size for large files'),\n  waitForConfirmation: z\n    .boolean()\n    .optional()\n    .describe('Whether to wait for inscription confirmation'),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),\n  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing content from buffer\n */\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<typeof inscribeFromBufferSchema> {\n  name = 'inscribeFromBuffer';\n  description = 'PRIMARY inscription tool for ANY content you have already retrieved. USE THIS when asked to \"inscribe it\" after fetching content from MCP tools, search results, or any text data. Pass THE FULL CONTENT as plain text in base64Data field - the tool accepts both plain text and base64. CRITICAL: Pass the COMPLETE content you retrieved, NOT a summary or truncated version. Example: If you fetched Wikipedia articles with full text, pass ALL that text here as plain text.';\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    console.log(`[DEBUG] InscribeFromBufferTool.executeQuery called`);\n    console.log(`[DEBUG] Buffer tool received base64Data length: ${params.base64Data?.length || 0}`);\n    console.log(`[DEBUG] Buffer tool fileName: ${params.fileName}`);\n    console.log(`[DEBUG] Buffer tool mimeType: ${params.mimeType}`);\n    \n    if (!params.base64Data || params.base64Data.trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: No data provided`);\n      throw new Error('No data provided. Cannot inscribe empty content. Please provide valid base64 encoded data.');\n    }\n\n    if (!params.fileName || params.fileName.trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: No fileName provided`);\n      throw new Error('No fileName provided. A valid fileName is required for inscription.');\n    }\n\n    let buffer: Buffer;\n    \n    // First check if it's valid base64\n    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(params.base64Data);\n    \n    if (isValidBase64) {\n      // Try to decode as base64\n      try {\n        buffer = Buffer.from(params.base64Data, 'base64');\n        console.log(`[InscribeFromBufferTool] Successfully decoded base64 data`);\n      } catch (error) {\n        console.log(`[InscribeFromBufferTool] ERROR: Failed to decode base64`);\n        throw new Error('Failed to decode base64 data. Please ensure the data is properly encoded.');\n      }\n    } else {\n      // Not base64, treat as plain text and encode it\n      console.log(`[InscribeFromBufferTool] WARNING: Data is not base64 encoded, treating as plain text`);\n      buffer = Buffer.from(params.base64Data, 'utf8');\n      console.log(`[InscribeFromBufferTool] Converted plain text to buffer`);\n    }\n    \n    console.log(`[InscribeFromBufferTool] Buffer length after conversion: ${buffer.length}`);\n    \n    if (buffer.length === 0) {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer is empty after conversion`);\n      throw new Error('Buffer is empty after conversion. The provided data appears to be invalid or empty.');\n    }\n\n    if (buffer.length < 10) {\n      console.log(`[InscribeFromBufferTool] WARNING: Buffer is very small (${buffer.length} bytes)`);\n      console.log(`[InscribeFromBufferTool] Buffer content preview: ${buffer.toString('utf8', 0, Math.min(buffer.length, 50))}`);\n      throw new Error(`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    if (buffer.toString('utf8', 0, Math.min(buffer.length, 100)).trim() === '') {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains only whitespace or empty content`);\n      throw new Error('Buffer contains only whitespace or empty content. Cannot inscribe meaningless data.');\n    }\n\n    // Check for empty HTML pattern (just links with no content)\n    const contentStr = buffer.toString('utf8');\n    const emptyHtmlPattern = /<a\\s+href=[\"'][^\"']+[\"']\\s*>\\s*<\\/a>/i;\n    const hasOnlyEmptyLinks = emptyHtmlPattern.test(contentStr) && \n                              contentStr.replace(/<[^>]+>/g, '').trim().length < 50;\n    \n    if (hasOnlyEmptyLinks) {\n      console.log(`[InscribeFromBufferTool] ERROR: Buffer contains empty HTML with just links and no content`);\n      throw new Error('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    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',\n    };\n\n    try {\n      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n            params.timeoutMs\n          );\n        });\n\n        result = await Promise.race([\n          this.inscriberBuilder.inscribe(\n            {\n              type: 'buffer',\n              buffer,\n              fileName: params.fileName,\n              mimeType: params.mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer,\n            fileName: params.fileName,\n            mimeType: params.mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;\n        return `Successfully inscribed and confirmed content on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe from buffer';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es35.js","sources":["../../src/tools/inscriber/InscribeFromFileTool.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 * as fs from 'fs/promises';\nimport * as path from 'path';\n\n/**\n * Schema for inscribing from file\n */\nconst inscribeFromFileSchema = z.object({\n  filePath: z.string().min(1, 'File path cannot be empty').describe('The file path of the content to inscribe. Must point to a valid, non-empty file.'),\n  mode: z\n    .enum(['file', 'hashinal'])\n    .optional()\n    .describe('Inscription mode: file or hashinal NFT'),\n  metadata: z\n    .record(z.unknown())\n    .optional()\n    .describe('Metadata to attach to the inscription'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the inscription'),\n  chunkSize: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Chunk size for large files'),\n  waitForConfirmation: z\n    .boolean()\n    .optional()\n    .describe('Whether to wait for inscription confirmation'),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Timeout in milliseconds for inscription (default: no timeout)'),\n  apiKey: z.string().optional().describe('API key for inscription service'),\n});\n\n/**\n * Tool for inscribing content from file\n */\nexport class InscribeFromFileTool extends BaseInscriberQueryTool<\n  typeof inscribeFromFileSchema\n> {\n  name = 'inscribeFromFile';\n  description =\n    'Inscribe content from a local file to the Hedera network using a file path. IMPORTANT: Only use this tool when you have a valid file path to actual content. The file must exist and contain meaningful data (minimum 10 bytes). For files accessed through MCP filesystem tools, consider reading the file content first and using inscribeFromBuffer instead.';\n\n  get specificInputSchema(): typeof inscribeFromFileSchema {\n    return inscribeFromFileSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeFromFileSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    console.log(`[DEBUG] InscribeFromFileTool.executeQuery called with: ${params.filePath}`);\n    \n    // File validation\n    let fileContent: Buffer;\n    try {\n      console.log(`[DEBUG] Checking file: ${params.filePath}`);\n      console.log(`[DEBUG] Current working directory: ${process.cwd()}`);\n\n      const stats = await fs.stat(params.filePath);\n      if (!stats.isFile()) {\n        throw new Error(`Path \"${params.filePath}\" is not a file`);\n      }\n\n      console.log(`[DEBUG] File size: ${stats.size} bytes`);\n\n      if (stats.size === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" is empty (0 bytes). Cannot inscribe empty files.`\n        );\n      }\n\n      if (stats.size < 10) {\n        throw new Error(\n          `File \"${params.filePath}\" is too small (${stats.size} bytes). Files must contain at least 10 bytes of meaningful content.`\n        );\n      }\n\n      if (stats.size > 100 * 1024 * 1024) {\n        console.log(`[InscribeFromFileTool] WARNING: Large file detected (${(stats.size / (1024 * 1024)).toFixed(2)} MB)`);\n      }\n\n      this.logger?.info('Reading file content...');\n      fileContent = await fs.readFile(params.filePath);\n      this.logger?.info(`Read ${fileContent.length} bytes from file`);\n\n      if (!fileContent || fileContent.length === 0) {\n        throw new Error(\n          `File \"${params.filePath}\" has no content after reading. Cannot inscribe empty files.`\n        );\n      }\n\n      if (fileContent.length < 10) {\n        throw new Error(\n          `File \"${params.filePath}\" content is too small (${fileContent.length} bytes). Files must contain at least 10 bytes of meaningful content.`\n        );\n      }\n\n      const fileName = path.basename(params.filePath);\n      const mimeType = this.getMimeType(fileName);\n      if (mimeType.startsWith('text/') || mimeType === 'application/json') {\n        const textContent = fileContent.toString('utf8', 0, Math.min(fileContent.length, 1000));\n        if (textContent.trim() === '') {\n          throw new Error(\n            `File \"${params.filePath}\" contains only whitespace or empty content. Cannot inscribe meaningless data.`\n          );\n        }\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.message.includes('ENOENT')) {\n          throw new Error(`File not found: \"${params.filePath}\"`);\n        }\n        throw error;\n      }\n      throw new Error(`Failed to read file: ${error}`);\n    }\n\n    const base64Data = fileContent.toString('base64');\n    this.logger?.info(`Converted to base64: ${base64Data.length} characters`);\n\n    const fileName = path.basename(params.filePath);\n    const mimeType = this.getMimeType(fileName);\n    this.logger?.info(`File: ${fileName}, MIME type: ${mimeType}`);\n\n    const options: InscriptionOptions = {\n      mode: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : 'testnet',\n    };\n\n    try {\n      let result: any;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise((_, reject) => {\n          setTimeout(\n            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n            params.timeoutMs\n          );\n        });\n\n        result = await Promise.race([\n          this.inscriberBuilder.inscribe(\n            {\n              type: 'buffer',\n              buffer: Buffer.from(base64Data, 'base64'),\n              fileName,\n              mimeType,\n            },\n            options\n          ),\n          timeoutPromise,\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          {\n            type: 'buffer',\n            buffer: Buffer.from(base64Data, 'base64'),\n            fileName,\n            mimeType,\n          },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId\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.transactionId\n        }\\nTopic ID: ${topicId || 'N/A'}${\n          cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n        }\\n\\nThe inscription is now available.`;\n      } else {\n        return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Failed to inscribe from file';\n      throw new Error(`Inscription failed: ${errorMessage}`);\n    }\n  }\n\n  private getMimeType(fileName: string): string {\n    const ext = path.extname(fileName).toLowerCase();\n    const mimeTypes: Record<string, string> = {\n      '.png': 'image/png',\n      '.jpg': 'image/jpeg',\n      '.jpeg': 'image/jpeg',\n      '.gif': 'image/gif',\n      '.webp': 'image/webp',\n      '.svg': 'image/svg+xml',\n      '.pdf': 'application/pdf',\n      '.json': 'application/json',\n      '.txt': 'text/plain',\n      '.html': 'text/html',\n      '.css': 'text/css',\n      '.js': 'application/javascript',\n      '.ts': 'application/typescript',\n      '.mp4': 'video/mp4',\n      '.mp3': 'audio/mpeg',\n      '.wav': 'audio/wav',\n      '.zip': 'application/zip',\n    };\n    return mimeTypes[ext] || 'application/octet-stream';\n  }\n}\n"],"names":["fileName","mimeType"],"mappings":";;;;AAUA,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,UAAU,EAAE,SAAS,IAAI,GAAG,2BAA2B,EAAE,SAAS,kFAAkF;AAAA,EACpJ,MAAM,EACH,KAAK,CAAC,QAAQ,UAAU,CAAC,EACzB,SAAA,EACA,SAAS,wCAAwC;AAAA,EACpD,UAAU,EACP,OAAO,EAAE,QAAA,CAAS,EAClB,SAAA,EACA,SAAS,uCAAuC;AAAA,EACnD,MAAM,EACH,MAAM,EAAE,OAAA,CAAQ,EAChB,SAAA,EACA,SAAS,oCAAoC;AAAA,EAChD,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,4BAA4B;AAAA,EACxC,qBAAqB,EAClB,QAAA,EACA,SAAA,EACA,SAAS,8CAA8C;AAAA,EAC1D,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,+DAA+D;AAAA,EAC3E,QAAQ,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,iCAAiC;AAC1E,CAAC;AAKM,MAAM,6BAA6B,uBAExC;AAAA,EAFK,cAAA;AAAA,UAAA,GAAA,SAAA;AAGL,SAAA,OAAO;AACP,SAAA,cACE;AAAA,EAAA;AAAA,EAEF,IAAI,sBAAqD;AACvD,WAAO;AAAA,EACT;AAAA,EAEA,MAAgB,aACd,QACA,aACkB;AAClB,YAAQ,IAAI,0DAA0D,OAAO,QAAQ,EAAE;AAGvF,QAAI;AACJ,QAAI;AACF,cAAQ,IAAI,0BAA0B,OAAO,QAAQ,EAAE;AACvD,cAAQ,IAAI,sCAAsC,QAAQ,IAAA,CAAK,EAAE;AAEjE,YAAM,QAAQ,MAAM,GAAG,KAAK,OAAO,QAAQ;AAC3C,UAAI,CAAC,MAAM,UAAU;AACnB,cAAM,IAAI,MAAM,SAAS,OAAO,QAAQ,iBAAiB;AAAA,MAC3D;AAEA,cAAQ,IAAI,sBAAsB,MAAM,IAAI,QAAQ;AAEpD,UAAI,MAAM,SAAS,GAAG;AACpB,cAAM,IAAI;AAAA,UACR,SAAS,OAAO,QAAQ;AAAA,QAAA;AAAA,MAE5B;AAEA,UAAI,MAAM,OAAO,IAAI;AACnB,cAAM,IAAI;AAAA,UACR,SAAS,OAAO,QAAQ,mBAAmB,MAAM,IAAI;AAAA,QAAA;AAAA,MAEzD;AAEA,UAAI,MAAM,OAAO,MAAM,OAAO,MAAM;AAClC,gBAAQ,IAAI,yDAAyD,MAAM,QAAQ,OAAO,OAAO,QAAQ,CAAC,CAAC,MAAM;AAAA,MACnH;AAEA,WAAK,QAAQ,KAAK,yBAAyB;AAC3C,oBAAc,MAAM,GAAG,SAAS,OAAO,QAAQ;AAC/C,WAAK,QAAQ,KAAK,QAAQ,YAAY,MAAM,kBAAkB;AAE9D,UAAI,CAAC,eAAe,YAAY,WAAW,GAAG;AAC5C,cAAM,IAAI;AAAA,UACR,SAAS,OAAO,QAAQ;AAAA,QAAA;AAAA,MAE5B;AAEA,UAAI,YAAY,SAAS,IAAI;AAC3B,cAAM,IAAI;AAAA,UACR,SAAS,OAAO,QAAQ,2BAA2B,YAAY,MAAM;AAAA,QAAA;AAAA,MAEzE;AAEA,YAAMA,YAAW,KAAK,SAAS,OAAO,QAAQ;AAC9C,YAAMC,YAAW,KAAK,YAAYD,SAAQ;AAC1C,UAAIC,UAAS,WAAW,OAAO,KAAKA,cAAa,oBAAoB;AACnE,cAAM,cAAc,YAAY,SAAS,QAAQ,GAAG,KAAK,IAAI,YAAY,QAAQ,GAAI,CAAC;AACtF,YAAI,YAAY,KAAA,MAAW,IAAI;AAC7B,gBAAM,IAAI;AAAA,YACR,SAAS,OAAO,QAAQ;AAAA,UAAA;AAAA,QAE5B;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,UAAI,iBAAiB,OAAO;AAC1B,YAAI,MAAM,QAAQ,SAAS,QAAQ,GAAG;AACpC,gBAAM,IAAI,MAAM,oBAAoB,OAAO,QAAQ,GAAG;AAAA,QACxD;AACA,cAAM;AAAA,MACR;AACA,YAAM,IAAI,MAAM,wBAAwB,KAAK,EAAE;AAAA,IACjD;AAEA,UAAM,aAAa,YAAY,SAAS,QAAQ;AAChD,SAAK,QAAQ,KAAK,wBAAwB,WAAW,MAAM,aAAa;AAExE,UAAM,WAAW,KAAK,SAAS,OAAO,QAAQ;AAC9C,UAAM,WAAW,KAAK,YAAY,QAAQ;AAC1C,SAAK,QAAQ,KAAK,SAAS,QAAQ,gBAAgB,QAAQ,EAAE;AAE7D,UAAM,UAA8B;AAAA,MAClC,MAAM,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,WAAW,OAAO;AAAA,MAClB,qBAAqB,OAAO,uBAAuB;AAAA,MACnD,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,SAAS,KAAK,iBAAiB,WAAW,EAAE,OAAO,QAChD,WACA,SAAS,SAAS,IACjB,YACA;AAAA,IAAA;AAGN,QAAI;AACF,UAAI;AAEJ,UAAI,OAAO,WAAW;AACpB,cAAM,iBAAiB,IAAI,QAAQ,CAAC,GAAG,WAAW;AAChD;AAAA,YACE,MAAM,OAAO,IAAI,MAAM,+BAA+B,OAAO,SAAS,IAAI,CAAC;AAAA,YAC3E,OAAO;AAAA,UAAA;AAAA,QAEX,CAAC;AAED,iBAAS,MAAM,QAAQ,KAAK;AAAA,UAC1B,KAAK,iBAAiB;AAAA,YACpB;AAAA,cACE,MAAM;AAAA,cACN,QAAQ,OAAO,KAAK,YAAY,QAAQ;AAAA,cACxC;AAAA,cACA;AAAA,YAAA;AAAA,YAEF;AAAA,UAAA;AAAA,UAEF;AAAA,QAAA,CACD;AAAA,MACH,OAAO;AACL,iBAAS,MAAM,KAAK,iBAAiB;AAAA,UACnC;AAAA,YACE,MAAM;AAAA,YACN,QAAQ,OAAO,KAAK,YAAY,QAAQ;AAAA,YACxC;AAAA,YACA;AAAA,UAAA;AAAA,UAEF;AAAA,QAAA;AAAA,MAEJ;AAEA,UAAI,OAAO,WAAW;AACpB,cAAM,UAAU,OAAO,aAAa,YAAY,OAAO,OAAO;AAC9D,cAAM,UAAU,QAAQ,WAAW;AACnC,cAAM,SAAS,UACX,8CAA8C,OAAO,YAAY,OAAO,KACxE;AACJ,eAAO;AAAA;AAAA,kBACL,OAAO,OAAO,aAChB;AAAA,YAAe,WAAW,KAAK,GAC7B,SAAS;AAAA,oBAAuB,MAAM,KAAK,EAC7C;AAAA;AAAA;AAAA,MACF,OAAO;AACL,eAAO;AAAA;AAAA,kBAAgF,OAAO,OAAO,aAAa;AAAA;AAAA;AAAA,MACpH;AAAA,IACF,SAAS,OAAO;AACd,YAAM,eACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,YAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,IACvD;AAAA,EACF;AAAA,EAEQ,YAAY,UAA0B;AAC5C,UAAM,MAAM,KAAK,QAAQ,QAAQ,EAAE,YAAA;AACnC,UAAM,YAAoC;AAAA,MACxC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,IAAA;AAEV,WAAO,UAAU,GAAG,KAAK;AAAA,EAC3B;AACF;"}

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

@@ -1,47 +1,47 @@
 import { z } from "zod";
-import { BaseInscriberQueryTool } from "./standards-agent-kit.es32.js";
-const inscribeHashinalSchema = z.object({
-  url: z.string().url().describe("The URL of the content to inscribe as Hashinal NFT"),
-  name: z.string().describe("Name of the Hashinal NFT"),
-  creator: z.string().describe("Creator account ID or name"),
-  description: z.string().describe("Description of the Hashinal NFT"),
-  type: z.string().describe('Type of NFT (e.g., "image", "video", "audio")'),
-  attributes: z.array(
-    z.object({
-      trait_type: z.string(),
-      value: z.union([z.string(), z.number()])
-    })
-  ).optional().describe("NFT attributes"),
-  properties: z.record(z.unknown()).optional().describe("Additional properties"),
-  jsonFileURL: z.string().url().optional().describe("URL to JSON metadata file"),
-  tags: z.array(z.string()).optional().describe("Tags to categorize the NFT"),
+import { BaseInscriberQueryTool } from "./standards-agent-kit.es33.js";
+import { ContentResolverRegistry } from "@hashgraphonline/standards-sdk";
+import { loadConfig } from "./standards-agent-kit.es2.js";
+const inscribeFromBufferSchema = z.object({
+  base64Data: z.string().min(1, "Data cannot be empty").describe(
+    'The content to inscribe. Accept BOTH plain text AND base64. Also accepts content reference IDs in format "content-ref:[id]". When user says "inscribe it" or "inscribe the content", use the EXACT content from your previous message or from MCP tool results. DO NOT generate new content. DO NOT create repetitive text. Pass the actual search results or other retrieved content EXACTLY as you received it.'
+  ),
+  fileName: z.string().min(1, "File name cannot be empty").describe("Name for the inscribed content. Required for all inscriptions."),
+  mimeType: z.string().optional().describe("MIME type of the content"),
+  mode: z.enum(["file", "hashinal"]).optional().describe("Inscription mode: file or hashinal NFT"),
+  metadata: z.record(z.unknown()).optional().describe("Metadata to attach to the inscription"),
+  tags: z.array(z.string()).optional().describe("Tags to categorize the inscription"),
   chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
   waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
-  timeoutMs: z.number().int().positive().optional().describe("Timeout in milliseconds for inscription (default: no timeout - waits until completion)"),
+  timeoutMs: z.number().int().positive().optional().describe(
+    "Timeout in milliseconds for inscription (default: no timeout - waits until completion)"
+  ),
   apiKey: z.string().optional().describe("API key for inscription service")
 });
-class InscribeHashinalTool extends BaseInscriberQueryTool {
+class InscribeFromBufferTool extends BaseInscriberQueryTool {
   constructor() {
     super(...arguments);
-    this.name = "inscribeHashinal";
-    this.description = "Inscribe content as a Hashinal NFT on the Hedera network";
+    this.name = "inscribeFromBuffer";
+    this.description = 'Inscribe content that you have already retrieved or displayed. When user says "inscribe it" after you showed search results or other content, use THIS tool. The base64Data field accepts PLAIN TEXT (not just base64) and content reference IDs in format "content-ref:[id]". Pass the EXACT content from your previous response or MCP tool output. DO NOT generate new content or create repetitive text. Content references are automatically resolved to the original content for inscription.';
+    this.config = loadConfig();
   }
   get specificInputSchema() {
-    return inscribeHashinalSchema;
+    return inscribeFromBufferSchema;
   }
   async executeQuery(params, _runManager) {
-    const metadata = {
-      name: params.name,
-      creator: params.creator,
-      description: params.description,
-      type: params.type,
-      attributes: params.attributes,
-      properties: params.properties
-    };
+    this.validateInput(params);
+    const resolvedContent = await this.resolveContent(
+      params.base64Data,
+      params.mimeType,
+      params.fileName
+    );
+    this.validateContent(resolvedContent.buffer);
+    const buffer = resolvedContent.buffer;
+    const resolvedMimeType = resolvedContent.mimeType || params.mimeType;
+    const resolvedFileName = resolvedContent.fileName || params.fileName;
     const options = {
-      mode: "hashinal",
-      metadata,
-      jsonFileURL: params.jsonFileURL,
+      mode: params.mode,
+      metadata: params.metadata,
       tags: params.tags,
       chunkSize: params.chunkSize,
       waitForConfirmation: params.waitForConfirmation ?? true,
@@ -50,53 +50,155 @@ class InscribeHashinalTool extends BaseInscriberQueryTool {
       apiKey: params.apiKey,
       network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet"
     };
+    const timeoutMs = params.timeoutMs || (options.waitForConfirmation ? 6e4 : void 0);
     try {
-      let result;
-      if (params.timeoutMs) {
-        const timeoutPromise = new Promise((_, reject) => {
-          setTimeout(
-            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),
-            params.timeoutMs
-          );
-        });
-        result = await Promise.race([
-          this.inscriberBuilder.inscribe(
-            { type: "url", url: params.url },
-            options
-          ),
-          timeoutPromise
-        ]);
-      } else {
-        result = await this.inscriberBuilder.inscribe(
-          { type: "url", url: params.url },
-          options
+      const result = await this.executeInscription(
+        buffer,
+        resolvedFileName,
+        resolvedMimeType,
+        options,
+        timeoutMs
+      );
+      return this.formatInscriptionResult(result, options);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Failed to inscribe from buffer";
+      throw new Error(`Inscription failed: ${errorMessage}`);
+    }
+  }
+  validateInput(params) {
+    if (!params.base64Data || params.base64Data.trim() === "") {
+      throw new Error(
+        "No data provided. Cannot inscribe empty content. Please provide valid content, plain text, base64 encoded data, or a content reference ID."
+      );
+    }
+    if (!params.fileName || params.fileName.trim() === "") {
+      throw new Error(
+        "No fileName provided. A valid fileName is required for inscription."
+      );
+    }
+  }
+  validateContent(buffer) {
+    if (buffer.length === 0) {
+      throw new Error(
+        "Buffer is empty after conversion. The provided data appears to be invalid or empty."
+      );
+    }
+    if (buffer.length > this.config.maxInscriptionSize) {
+      const maxSizeKB = Math.round(this.config.maxInscriptionSize / 1024);
+      const bufferSizeKB = Math.round(buffer.length / 1024);
+      throw new Error(
+        `Content is too large for inscription (${bufferSizeKB}KB, max ${maxSizeKB}KB). Please summarize or extract key information before inscribing.`
+      );
+    }
+    if (buffer.length < this.config.minContentSize) {
+      throw new Error(
+        `Buffer content is too small (${buffer.length} bytes). This may indicate empty or invalid content. Please verify the source data contains actual content.`
+      );
+    }
+    if (buffer.toString("utf8", 0, Math.min(buffer.length, 100)).trim() === "") {
+      throw new Error(
+        "Buffer contains only whitespace or empty content. Cannot inscribe meaningless data."
+      );
+    }
+    const contentStr = buffer.toString("utf8");
+    const emptyHtmlPattern = /<a\s+href=["'][^"']+["']\s*>\s*<\/a>/i;
+    const hasOnlyEmptyLinks = emptyHtmlPattern.test(contentStr) && contentStr.replace(/<[^>]+>/g, "").trim().length < 50;
+    if (hasOnlyEmptyLinks) {
+      throw new Error(
+        "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."
+      );
+    }
+  }
+  async executeInscription(buffer, fileName, mimeType, options, timeoutMs) {
+    const inscriptionData = {
+      type: "buffer",
+      buffer,
+      fileName,
+      mimeType
+    };
+    if (timeoutMs) {
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(
+          () => reject(new Error(`Inscription timed out after ${timeoutMs}ms`)),
+          timeoutMs
         );
-      }
-      if (result.confirmed) {
-        const topicId = result.inscription?.topic_id || result.result.topicId;
-        const network = options.network || "testnet";
-        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
-        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!
+      });
+      return Promise.race([
+        this.inscriberBuilder.inscribe(inscriptionData, options),
+        timeoutPromise
+      ]);
+    }
+    return this.inscriberBuilder.inscribe(inscriptionData, options);
+  }
+  formatInscriptionResult(result, options) {
+    if (result.confirmed) {
+      const topicId = result.inscription?.topic_id || result.result.topicId;
+      const network = options.network || "testnet";
+      const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
+      return `Successfully inscribed and confirmed content on the Hedera network!
 
 Transaction ID: ${result.result.transactionId}
 Topic ID: ${topicId || "N/A"}${cdnUrl ? `
 View inscription: ${cdnUrl}` : ""}
 
-The Hashinal NFT is now available.`;
-      } else {
-        return `Successfully submitted Hashinal NFT inscription to the Hedera network!
+The inscription is now available.`;
+    }
+    return `Successfully submitted inscription to the Hedera network!
 
 Transaction ID: ${result.result.transactionId}
 
 The inscription is processing and will be confirmed shortly.`;
+  }
+  async resolveContent(input, providedMimeType, providedFileName) {
+    const trimmedInput = input.trim();
+    const resolver = this.getContentResolver() || ContentResolverRegistry.getResolver();
+    if (!resolver) {
+      return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);
+    }
+    const referenceId = resolver.extractReferenceId(trimmedInput);
+    if (referenceId) {
+      try {
+        const resolution = await resolver.resolveReference(referenceId);
+        return {
+          buffer: resolution.content,
+          mimeType: resolution.metadata?.mimeType || providedMimeType,
+          fileName: resolution.metadata?.fileName || providedFileName,
+          wasReference: true
+        };
+      } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : "Unknown error resolving reference";
+        throw new Error(`Reference resolution failed: ${errorMsg}`);
       }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "Failed to inscribe Hashinal NFT";
-      throw new Error(`Inscription failed: ${errorMessage}`);
     }
+    return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);
+  }
+  handleDirectContent(input, providedMimeType, providedFileName) {
+    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);
+    if (isValidBase64) {
+      try {
+        const buffer2 = Buffer.from(input, "base64");
+        return {
+          buffer: buffer2,
+          mimeType: providedMimeType,
+          fileName: providedFileName,
+          wasReference: false
+        };
+      } catch (error) {
+        throw new Error(
+          "Failed to decode base64 data. Please ensure the data is properly encoded."
+        );
+      }
+    }
+    const buffer = Buffer.from(input, "utf8");
+    return {
+      buffer,
+      mimeType: providedMimeType || "text/plain",
+      fileName: providedFileName,
+      wasReference: false
+    };
   }
 }
 export {
-  InscribeHashinalTool
+  InscribeFromBufferTool
 };
 //# sourceMappingURL=standards-agent-kit.es36.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es36.js","sources":["../../src/tools/inscriber/InscribeHashinalTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseInscriberQueryTool } from './base-inscriber-tools';\nimport { InscriptionOptions } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\n\n/**\n * Schema for inscribing Hashinal NFT\n */\nconst inscribeHashinalSchema = z.object({\n  url: z.string().url().describe('The URL of the content to inscribe as Hashinal NFT'),\n  name: z.string().describe('Name of the Hashinal NFT'),\n  creator: z.string().describe('Creator account ID or name'),\n  description: z.string().describe('Description of the Hashinal NFT'),\n  type: z.string().describe('Type of NFT (e.g., \"image\", \"video\", \"audio\")'),\n  attributes: z\n    .array(\n      z.object({\n        trait_type: z.string(),\n        value: z.union([z.string(), z.number()]),\n      })\n    )\n    .optional()\n    .describe('NFT attributes'),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Additional properties'),\n  jsonFileURL: z\n    .string()\n    .url()\n    .optional()\n    .describe('URL to JSON metadata file'),\n  tags: z\n    .array(z.string())\n    .optional()\n    .describe('Tags to categorize the NFT'),\n  chunkSize: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Chunk size for large files'),\n  waitForConfirmation: z\n    .boolean()\n    .optional()\n    .describe('Whether to wait for inscription confirmation'),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Timeout in milliseconds for inscription (default: no timeout - waits until completion)'),\n  apiKey: z\n    .string()\n    .optional()\n    .describe('API key for inscription service'),\n});\n\n\n/**\n * Tool for inscribing Hashinal NFTs\n */\nexport class InscribeHashinalTool extends BaseInscriberQueryTool<typeof inscribeHashinalSchema> {\n  name = 'inscribeHashinal';\n  description = 'Inscribe content as a Hashinal NFT on the Hedera network';\n\n  get specificInputSchema() {\n    return inscribeHashinalSchema;\n  }\n\n  protected async executeQuery(\n    params: z.infer<typeof inscribeHashinalSchema>,\n    _runManager?: CallbackManagerForToolRun\n  ): Promise<unknown> {\n    const metadata = {\n      name: params.name,\n      creator: params.creator,\n      description: params.description,\n      type: params.type,\n      attributes: params.attributes,\n      properties: params.properties,\n    };\n\n    const options: InscriptionOptions = {\n      mode: 'hashinal',\n      metadata,\n      jsonFileURL: params.jsonFileURL,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network.toString().includes('mainnet') ? 'mainnet' : 'testnet',\n    };\n\n    try {\n      let result: Awaited<ReturnType<typeof this.inscriberBuilder.inscribe>>;\n      \n      if (params.timeoutMs) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () => reject(new Error(`Inscription timed out after ${params.timeoutMs}ms`)),\n            params.timeoutMs\n          );\n        });\n\n        result = await Promise.race([\n          this.inscriberBuilder.inscribe(\n            { type: 'url', url: params.url },\n            options\n          ),\n          timeoutPromise\n        ]);\n      } else {\n        result = await this.inscriberBuilder.inscribe(\n          { type: 'url', url: params.url },\n          options\n        );\n      }\n\n      if (result.confirmed) {\n        const topicId = result.inscription?.topic_id || result.result.topicId;\n        const network = options.network || 'testnet';\n        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;\n        return `Successfully inscribed and confirmed Hashinal NFT on the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\nTopic ID: ${topicId || 'N/A'}${cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''}\\n\\nThe Hashinal NFT is now available.`;\n      } else {\n        return `Successfully submitted Hashinal NFT inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : 'Failed to inscribe Hashinal NFT';\n      throw new Error(`Inscription failed: ${errorMessage}`);\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, ContentResolverRegistry } from '@hashgraphonline/standards-sdk';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport { loadConfig } from '../../config/ContentReferenceConfig';\n\nconst inscribeFromBufferSchema = z.object({\n  base64Data: z\n    .string()\n    .min(1, 'Data cannot be empty')\n    .describe(\n      'The content to inscribe. Accept BOTH plain text AND base64. Also accepts content reference IDs in format \"content-ref:[id]\". When user says \"inscribe it\" or \"inscribe the content\", use the EXACT content from your previous message or from MCP tool results. DO NOT generate new content. DO NOT create repetitive text. Pass the actual search results or other retrieved content EXACTLY as you received it.'\n    ),\n  fileName: z\n    .string()\n    .min(1, 'File name cannot be empty')\n    .describe('Name for the inscribed content. Required for all inscriptions.'),\n  mimeType: z.string().optional().describe('MIME type of the content'),\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});\n\nexport class InscribeFromBufferTool extends BaseInscriberQueryTool<\n  typeof inscribeFromBufferSchema\n> {\n  name = 'inscribeFromBuffer';\n  description =\n    'Inscribe content that you have already retrieved or displayed. When user says \"inscribe it\" after you showed search results or other content, use THIS tool. The base64Data field accepts PLAIN TEXT (not just base64) and content reference IDs in format \"content-ref:[id]\". Pass the EXACT content from your previous response or MCP tool output. DO NOT generate new content or create repetitive text. Content references are automatically resolved to the original content for inscription.';\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 this.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: params.mode,\n      metadata: params.metadata,\n      tags: params.tags,\n      chunkSize: params.chunkSize,\n      waitForConfirmation: params.waitForConfirmation ?? true,\n      waitMaxAttempts: 10,\n      waitIntervalMs: 3000,\n      apiKey: params.apiKey,\n      network: this.inscriberBuilder['hederaKit'].client.network\n        .toString()\n        .includes('mainnet')\n        ? 'mainnet'\n        : 'testnet',\n    };\n\n    const timeoutMs =\n      params.timeoutMs || (options.waitForConfirmation ? 60000 : undefined);\n\n    try {\n      const result = await this.executeInscription(\n        buffer,\n        resolvedFileName,\n        resolvedMimeType,\n        options,\n        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) {\n      const topicId = result.inscription?.topic_id || result.result.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.transactionId\n      }\\nTopic ID: ${topicId || 'N/A'}${\n        cdnUrl ? `\\nView inscription: ${cdnUrl}` : ''\n      }\\n\\nThe inscription is now available.`;\n    }\n\n    return `Successfully submitted inscription to the Hedera network!\\n\\nTransaction ID: ${result.result.transactionId}\\n\\nThe inscription is processing and will be confirmed shortly.`;\n  }\n\n  private async resolveContent(\n    input: string,\n    providedMimeType?: string,\n    providedFileName?: string\n  ): Promise<{\n    buffer: Buffer;\n    mimeType?: string;\n    fileName?: string;\n    wasReference?: boolean;\n  }> {\n    const trimmedInput = input.trim();\n    \n    // Try to get resolver from either injected dependency or registry\n    const resolver = this.getContentResolver() || ContentResolverRegistry.getResolver();\n    \n    if (!resolver) {\n      // No resolver available, handle content directly\n      return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);\n    }\n    \n    const referenceId = resolver.extractReferenceId(trimmedInput);\n\n    if (referenceId) {\n      try {\n        const resolution = await resolver.resolveReference(referenceId);\n\n        return {\n          buffer: resolution.content,\n          mimeType: resolution.metadata?.mimeType || providedMimeType,\n          fileName: resolution.metadata?.fileName || providedFileName,\n          wasReference: true,\n        };\n      } catch (error) {\n        const errorMsg =\n          error instanceof Error\n            ? error.message\n            : 'Unknown error resolving reference';\n        throw new Error(`Reference resolution failed: ${errorMsg}`);\n      }\n    }\n\n    // No reference found, handle as direct content\n    return this.handleDirectContent(trimmedInput, providedMimeType, providedFileName);\n  }\n\n  private handleDirectContent(\n    input: string,\n    providedMimeType?: string,\n    providedFileName?: string\n  ): {\n    buffer: Buffer;\n    mimeType?: string;\n    fileName?: string;\n    wasReference?: boolean;\n  } {\n    const isValidBase64 = /^[A-Za-z0-9+/]*={0,2}$/.test(input);\n\n    if (isValidBase64) {\n      try {\n        const buffer = Buffer.from(input, 'base64');\n        return {\n          buffer,\n          mimeType: providedMimeType,\n          fileName: providedFileName,\n          wasReference: false,\n        };\n      } catch (error) {\n        throw new Error(\n          'Failed to decode base64 data. Please ensure the data is properly encoded.'\n        );\n      }\n    }\n\n    const buffer = Buffer.from(input, 'utf8');\n    return {\n      buffer,\n      mimeType: providedMimeType || 'text/plain',\n      fileName: providedFileName,\n      wasReference: false,\n    };\n  }\n}\n"],"names":["buffer"],"mappings":";;;;AAMA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,YAAY,EACT,OAAA,EACA,IAAI,GAAG,sBAAsB,EAC7B;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,UAAU,EACP,SACA,IAAI,GAAG,2BAA2B,EAClC,SAAS,gEAAgE;AAAA,EAC5E,UAAU,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,0BAA0B;AAAA,EACnE,MAAM,EACH,KAAK,CAAC,QAAQ,UAAU,CAAC,EACzB,SAAA,EACA,SAAS,wCAAwC;AAAA,EACpD,UAAU,EACP,OAAO,EAAE,QAAA,CAAS,EAClB,SAAA,EACA,SAAS,uCAAuC;AAAA,EACnD,MAAM,EACH,MAAM,EAAE,OAAA,CAAQ,EAChB,SAAA,EACA,SAAS,oCAAoC;AAAA,EAChD,WAAW,EACR,OAAA,EACA,IAAA,EACA,SAAA,EACA,SAAA,EACA,SAAS,4BAA4B;AAAA,EACxC,qBAAqB,EAClB,QAAA,EACA,SAAA,EACA,SAAS,8CAA8C;AAAA,EAC1D,WAAW,EACR,SACA,MACA,SAAA,EACA,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,QAAQ,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,iCAAiC;AAC1E,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,KAAK;AAAA,MACjC,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,OAAO;AAAA,MACb,UAAU,OAAO;AAAA,MACjB,MAAM,OAAO;AAAA,MACb,WAAW,OAAO;AAAA,MAClB,qBAAqB,OAAO,uBAAuB;AAAA,MACnD,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,SAAS,KAAK,iBAAiB,WAAW,EAAE,OAAO,QAChD,WACA,SAAS,SAAS,IACjB,YACA;AAAA,IAAA;AAGN,UAAM,YACJ,OAAO,cAAc,QAAQ,sBAAsB,MAAQ;AAE7D,QAAI;AACF,YAAM,SAAS,MAAM,KAAK;AAAA,QACxB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAEF,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,WAAW;AACpB,YAAM,UAAU,OAAO,aAAa,YAAY,OAAO,OAAO;AAC9D,YAAM,UAAU,QAAQ,WAAW;AACnC,YAAM,SAAS,UACX,8CAA8C,OAAO,YAAY,OAAO,KACxE;AACJ,aAAO;AAAA;AAAA,kBACL,OAAO,OAAO,aAChB;AAAA,YAAe,WAAW,KAAK,GAC7B,SAAS;AAAA,oBAAuB,MAAM,KAAK,EAC7C;AAAA;AAAA;AAAA,IACF;AAEA,WAAO;AAAA;AAAA,kBAAgF,OAAO,OAAO,aAAa;AAAA;AAAA;AAAA,EACpH;AAAA,EAEA,MAAc,eACZ,OACA,kBACA,kBAMC;AACD,UAAM,eAAe,MAAM,KAAA;AAG3B,UAAM,WAAW,KAAK,mBAAA,KAAwB,wBAAwB,YAAA;AAEtE,QAAI,CAAC,UAAU;AAEb,aAAO,KAAK,oBAAoB,cAAc,kBAAkB,gBAAgB;AAAA,IAClF;AAEA,UAAM,cAAc,SAAS,mBAAmB,YAAY;AAE5D,QAAI,aAAa;AACf,UAAI;AACF,cAAM,aAAa,MAAM,SAAS,iBAAiB,WAAW;AAE9D,eAAO;AAAA,UACL,QAAQ,WAAW;AAAA,UACnB,UAAU,WAAW,UAAU,YAAY;AAAA,UAC3C,UAAU,WAAW,UAAU,YAAY;AAAA,UAC3C,cAAc;AAAA,QAAA;AAAA,MAElB,SAAS,OAAO;AACd,cAAM,WACJ,iBAAiB,QACb,MAAM,UACN;AACN,cAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;AAAA,MAC5D;AAAA,IACF;AAGA,WAAO,KAAK,oBAAoB,cAAc,kBAAkB,gBAAgB;AAAA,EAClF;AAAA,EAEQ,oBACN,OACA,kBACA,kBAMA;AACA,UAAM,gBAAgB,yBAAyB,KAAK,KAAK;AAEzD,QAAI,eAAe;AACjB,UAAI;AACF,cAAMA,UAAS,OAAO,KAAK,OAAO,QAAQ;AAC1C,eAAO;AAAA,UACL,QAAAA;AAAAA,UACA,UAAU;AAAA,UACV,UAAU;AAAA,UACV,cAAc;AAAA,QAAA;AAAA,MAElB,SAAS,OAAO;AACd,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AAAA,IACF;AAEA,UAAM,SAAS,OAAO,KAAK,OAAO,MAAM;AACxC,WAAO;AAAA,MACL;AAAA,MACA,UAAU,oBAAoB;AAAA,MAC9B,UAAU;AAAA,MACV,cAAc;AAAA,IAAA;AAAA,EAElB;AACF;"}