@hashgraphonline/conversational-agent 0.2.217 → 0.2.218

package/dist/esm/index59.js

@@ -1,108 +1,187 @@
-import { BaseHederaQueryTool } from "hedera-agent-kit";
-import { z } from "zod";
-import { promisify } from "util";
-import fs from "fs";
-import { getUploadPostageBatchId, errorHasStatus, getErrorMessage, getResponseWithStructuredContent } from "./index62.js";
-import { BAD_REQUEST_STATUS } from "./index63.js";
-const UploadFolderSchema = z.object({
-  folderPath: z.string(),
-  redundancyLevel: z.number().optional(),
-  postageBatchId: z.string().optional()
-});
-class UploadFolderTool extends BaseHederaQueryTool {
-  constructor(params) {
-    const { bee, config, ...rest } = params;
-    super(rest);
-    this.name = "swarm-upload-folder";
-    this.description = `Upload a folder to Swarm.
-      folderPath: Path to the folder to upload. 
-      redundancyLevel: Redundancy level for fault tolerance (higher values provide better fault tolerance but increase storage overhead). 0 - none, 1 - medium, 2 - strong, 3 - insane, 4 - paranoid. 
-      postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;
-    this.namespace = "swarm";
-    this.specificInputSchema = UploadFolderSchema;
-    this.bee = bee;
-    this.config = config;
+import { ZodError } from "zod";
+import { Logger } from "@hashgraphonline/standards-sdk";
+class ExecutionPipeline {
+  constructor(toolRegistry, formEngine, memory, logger) {
+    this.toolRegistry = toolRegistry;
+    this.formEngine = formEngine;
+    this.memory = memory;
+    this.logger = logger || new Logger({ module: "ExecutionPipeline" });
   }
-  async executeQuery(input) {
-    const { folderPath, redundancyLevel: inputRedundancyLevel, postageBatchId: inputPostageBatchId } = input;
-    if (!folderPath) {
-      this.logger.error(
-        "Missing required parameter: folderPath."
-      );
-      throw new Error("Missing required parameter: folderPath.");
+  /**
+   * Execute a tool through the pipeline
+   */
+  async execute(toolName, input, sessionContext) {
+    const traceId = `trace-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    const startTime = Date.now();
+    const toolEntry = this.toolRegistry.getTool(toolName);
+    if (!toolEntry) {
+      throw new Error(`Tool not found in registry: ${toolName}`);
     }
-    const stats = await promisify(fs.stat)(folderPath);
-    if (!stats.isDirectory()) {
-      this.logger.error(
-        `Path is not a directory: ${folderPath}.`
+    const context = {
+      toolName,
+      input,
+      session: sessionContext || this.buildDefaultSession(),
+      memory: this.memory,
+      traceId,
+      toolEntry
+    };
+    try {
+      const shouldGenerateForm = await this.checkFormGeneration(context);
+      if (shouldGenerateForm.requiresForm && shouldGenerateForm.formMessage) {
+        return {
+          success: false,
+          output: "Form generation required",
+          requiresForm: true,
+          formMessage: shouldGenerateForm.formMessage,
+          traceId,
+          executionTime: Date.now() - startTime
+        };
+      }
+      const result = await this.executeToolDirect(context);
+      return {
+        success: true,
+        output: result,
+        traceId,
+        executionTime: Date.now() - startTime
+      };
+    } catch (error) {
+      return this.handleExecutionError(
+        error,
+        context,
+        traceId,
+        Date.now() - startTime
       );
-      throw new Error(`Path is not a directory: ${folderPath}.`);
     }
-    let postageBatchId = "";
+  }
+  /**
+   * Execute tool with validation
+   */
+  async executeWithValidation(toolName, input, sessionContext) {
+    return this.execute(toolName, input, sessionContext);
+  }
+  /**
+   * Process form submission
+   */
+  async processFormSubmission(toolName, formId, parameters, sessionContext) {
+    const traceId = `form-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    const startTime = Date.now();
     try {
-      postageBatchId = await getUploadPostageBatchId(
-        inputPostageBatchId,
-        this.bee,
-        this.config
+      const formSubmission = {
+        formId,
+        toolName,
+        parameters,
+        timestamp: Date.now()
+      };
+      const processedInput = await this.formEngine.processSubmission(
+        formSubmission
       );
+      return this.execute(toolName, processedInput, sessionContext);
     } catch (error) {
-      let errorMessage = "Upload folder failed.";
-      if (error instanceof Error) {
-        errorMessage = error.message;
-      }
-      this.logger.error(errorMessage);
-      throw new Error(errorMessage);
+      return {
+        success: false,
+        output: "Form submission processing failed",
+        error: error instanceof Error ? error.message : String(error),
+        traceId,
+        executionTime: Date.now() - startTime
+      };
     }
-    const redundancyLevel = inputRedundancyLevel;
-    const options = {};
-    if (redundancyLevel) {
-      options.redundancyLevel = redundancyLevel;
+  }
+  /**
+   * Check if form generation is required
+   */
+  async checkFormGeneration(context) {
+    const inputRecord = context.input;
+    if (inputRecord?.__fromForm === true || inputRecord?.renderForm === false) {
+      return { requiresForm: false };
     }
-    const deferred = true;
-    options.deferred = deferred;
-    let message = "Folder successfully uploaded to Swarm";
-    let tagId = void 0;
-    {
-      try {
-        const tag = await this.bee.createTag();
-        tagId = tag.uid.toString();
-        options.tag = tag.uid;
-        message = "Folder upload started in deferred mode. Use swarm-query-upload-progress to track progress.";
-      } catch (error) {
-        this.logger.error(
-          "Failed to create tag",
-          error
-        );
-        options.deferred = false;
-      }
+    if (!this.formEngine.shouldGenerateForm(context.toolEntry.tool, context.input)) {
+      return { requiresForm: false };
     }
-    let result;
-    try {
-      result = await this.bee.uploadFilesFromDirectory(
-        postageBatchId,
-        folderPath,
-        options
-      );
-    } catch (error) {
-      let errorMessage = "Unable to upload folder.";
-      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {
-        errorMessage = getErrorMessage(error);
-      }
-      this.logger.error(
-        errorMessage,
-        error
-      );
-      throw new Error(errorMessage);
+    const formMessage = await this.formEngine.generateForm(
+      context.toolName,
+      context.toolEntry.tool,
+      context.input
+    );
+    if (formMessage) {
+      return { requiresForm: true, formMessage };
+    }
+    return { requiresForm: false };
+  }
+  /**
+   * Execute tool directly
+   */
+  async executeToolDirect(context) {
+    const { toolEntry, input } = context;
+    const parameters = input || {};
+    const mergedArgs = { ...parameters, renderForm: false };
+    if (toolEntry.wrapper) {
+      return this.executeWrappedTool(toolEntry, mergedArgs);
+    }
+    return await toolEntry.tool.call(mergedArgs);
+  }
+  /**
+   * Execute wrapped tool
+   */
+  async executeWrappedTool(toolEntry, mergedArgs) {
+    const wrapper = toolEntry.wrapper;
+    if (!wrapper) {
+      throw new Error("Tool wrapper not found");
     }
-    return getResponseWithStructuredContent({
-      reference: result.reference.toString(),
-      url: this.bee.url + "/bzz/" + result.reference.toString(),
-      message,
-      tagId
+    const wrapperAsAny = wrapper;
+    if (wrapperAsAny.executeOriginal) {
+      return await wrapperAsAny.executeOriginal(mergedArgs);
+    }
+    if (wrapperAsAny.originalTool?.call) {
+      return await wrapperAsAny.originalTool.call(mergedArgs);
+    }
+    return await toolEntry.originalTool.call(mergedArgs);
+  }
+  /**
+   * Handle execution error
+   */
+  handleExecutionError(error, context, traceId, executionTime) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (error instanceof ZodError) {
+      return {
+        success: false,
+        output: "Validation error occurred",
+        error: errorMessage,
+        traceId,
+        executionTime
+      };
+    }
+    this.logger.error(`Tool execution failed: ${context.toolName}`, {
+      traceId,
+      error: errorMessage
     });
+    return {
+      success: false,
+      output: "Tool execution failed",
+      error: errorMessage,
+      traceId,
+      executionTime
+    };
+  }
+  /**
+   * Build default session context
+   */
+  buildDefaultSession() {
+    return {
+      sessionId: `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+      timestamp: Date.now()
+    };
+  }
+  /**
+   * Get statistics about the pipeline
+   */
+  getStatistics() {
+    return {
+      totalMiddleware: 0,
+      registeredMiddleware: []
+    };
   }
 }
 export {
-  UploadFolderTool
+  ExecutionPipeline
 };
 //# sourceMappingURL=index59.js.map

package/dist/esm/index59.js.map

@@ -1 +1 @@
-{"version":3,"file":"index59.js","sources":["../../src/plugins/community/swarm/tools/UploadFolderTool.ts"],"sourcesContent":["import {\r\n  BaseHederaQueryTool,\r\n  HederaAgentKit,\r\n  type GenericPluginContext,\r\n} from \"hedera-agent-kit\";\r\nimport { Bee, CollectionUploadOptions } from \"@ethersphere/bee-js\";\r\nimport { z } from \"zod\";\r\nimport { promisify } from \"util\";\r\nimport fs from \"fs\";\r\nimport {\r\n  errorHasStatus,\r\n  getErrorMessage,\r\n  getResponseWithStructuredContent,\r\n  getUploadPostageBatchId,\r\n  ToolResponse,\r\n} from \"../utils\";\r\nimport { BAD_REQUEST_STATUS } from \"../constants\";\r\nimport { SwarmConfig } from \"../config\";\r\n\r\nconst UploadFolderSchema = z.object({\r\n  folderPath: z.string(),\r\n  redundancyLevel: z.number().optional(),\r\n  postageBatchId: z.string().optional(),\r\n});\r\n\r\nexport class UploadFolderTool extends BaseHederaQueryTool<typeof UploadFolderSchema> {\r\n  name = \"swarm-upload-folder\";\r\n  description = `Upload a folder to Swarm.\r\n      folderPath: Path to the folder to upload. \r\n      redundancyLevel: Redundancy level for fault tolerance (higher values provide better fault tolerance but increase storage overhead). 0 - none, 1 - medium, 2 - strong, 3 - insane, 4 - paranoid. \r\n      postageBatchId: The postage stamp batch ID which will be used to perform the upload, if it is provided.`;\r\n  namespace = \"swarm\";\r\n  specificInputSchema = UploadFolderSchema;\r\n  bee: Bee;\r\n  config: SwarmConfig;\r\n              \r\n  constructor(params: {\r\n    hederaKit: HederaAgentKit;\r\n    config: SwarmConfig;\r\n    logger?: GenericPluginContext['logger'];\r\n    bee: Bee;\r\n  }) {\r\n    const { bee, config, ...rest } = params;\r\n    super(rest);\r\n    this.bee = bee;\r\n    this.config = config;\r\n  }\r\n  \r\n  protected async executeQuery(\r\n      input: z.infer<typeof UploadFolderSchema>\r\n  ): Promise<ToolResponse | string> {\r\n    const { folderPath, redundancyLevel: inputRedundancyLevel, postageBatchId: inputPostageBatchId } = input;\r\n\r\n    if (!folderPath) {\r\n      this.logger.error(\r\n        'Missing required parameter: folderPath.'\r\n      );\r\n\r\n      throw new Error('Missing required parameter: folderPath.');\r\n    }\r\n\r\n    // Check if folder exists\r\n    const stats = await promisify(fs.stat)(folderPath);\r\n    if (!stats.isDirectory()) {\r\n      this.logger.error(\r\n        `Path is not a directory: ${folderPath}.`\r\n      );\r\n\r\n      throw new Error(`Path is not a directory: ${folderPath}.`);\r\n    }\r\n\r\n    let postageBatchId = \"\";\r\n\r\n    try {\r\n      postageBatchId = await getUploadPostageBatchId(\r\n        inputPostageBatchId,\r\n        this.bee,\r\n        this.config,\r\n      );\r\n    } catch (error) {\r\n      let errorMessage = 'Upload folder failed.';\r\n      if (error instanceof Error) {\r\n        errorMessage = error.message;\r\n      }\r\n      this.logger.error(errorMessage);\r\n\r\n      throw new Error(errorMessage);\r\n    }\r\n    \r\n    const redundancyLevel = inputRedundancyLevel;\r\n    const options: CollectionUploadOptions = {};\r\n\r\n    if (redundancyLevel) {\r\n      options.redundancyLevel = redundancyLevel;\r\n    }\r\n\r\n    const deferred = true;\r\n    options.deferred = deferred;\r\n    let message = 'Folder successfully uploaded to Swarm';\r\n\r\n    let tagId: string | undefined = undefined;\r\n\r\n    if (deferred) {\r\n      try {\r\n        const tag = await this.bee.createTag();\r\n        tagId = tag.uid.toString();\r\n        options.tag = tag.uid;\r\n        message =\r\n          'Folder upload started in deferred mode. Use swarm-query-upload-progress to track progress.';\r\n      } catch (error) {\r\n        this.logger.error(\r\n          'Failed to create tag',\r\n          error\r\n        );\r\n        options.deferred = false;\r\n      }\r\n    }\r\n\r\n    let result;\r\n\r\n    try {\r\n      // Start the deferred upload\r\n      result = await this.bee.uploadFilesFromDirectory(\r\n        postageBatchId,\r\n        folderPath,\r\n        options\r\n      );\r\n    } catch (error) {\r\n      let errorMessage = 'Unable to upload folder.';\r\n\r\n      if (errorHasStatus(error, BAD_REQUEST_STATUS)) {\r\n        errorMessage = getErrorMessage(error);\r\n      }\r\n\r\n      this.logger.error(\r\n        errorMessage,\r\n        error\r\n      );\r\n      \r\n      throw new Error(errorMessage);\r\n    }\r\n\r\n    return getResponseWithStructuredContent({\r\n      reference: result.reference.toString(),\r\n      url: this.bee.url + \"/bzz/\" + result.reference.toString(),\r\n      message,\r\n      tagId,\r\n    });\r\n  }\r\n}\r\n"],"names":[],"mappings":";;;;;;AAmBA,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,YAAY,EAAE,OAAA;AAAA,EACd,iBAAiB,EAAE,OAAA,EAAS,SAAA;AAAA,EAC5B,gBAAgB,EAAE,OAAA,EAAS,SAAA;AAC7B,CAAC;AAEM,MAAM,yBAAyB,oBAA+C;AAAA,EAWnF,YAAY,QAKT;AACD,UAAM,EAAE,KAAK,QAAQ,GAAG,SAAS;AACjC,UAAM,IAAI;AAjBZ,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAId,SAAA,YAAY;AACZ,SAAA,sBAAsB;AAYpB,SAAK,MAAM;AACX,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAgB,aACZ,OAC8B;AAChC,UAAM,EAAE,YAAY,iBAAiB,sBAAsB,gBAAgB,wBAAwB;AAEnG,QAAI,CAAC,YAAY;AACf,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,yCAAyC;AAAA,IAC3D;AAGA,UAAM,QAAQ,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU;AACjD,QAAI,CAAC,MAAM,eAAe;AACxB,WAAK,OAAO;AAAA,QACV,4BAA4B,UAAU;AAAA,MAAA;AAGxC,YAAM,IAAI,MAAM,4BAA4B,UAAU,GAAG;AAAA,IAC3D;AAEA,QAAI,iBAAiB;AAErB,QAAI;AACF,uBAAiB,MAAM;AAAA,QACrB;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,MAAA;AAAA,IAET,SAAS,OAAO;AACd,UAAI,eAAe;AACnB,UAAI,iBAAiB,OAAO;AAC1B,uBAAe,MAAM;AAAA,MACvB;AACA,WAAK,OAAO,MAAM,YAAY;AAE9B,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,UAAM,kBAAkB;AACxB,UAAM,UAAmC,CAAA;AAEzC,QAAI,iBAAiB;AACnB,cAAQ,kBAAkB;AAAA,IAC5B;AAEA,UAAM,WAAW;AACjB,YAAQ,WAAW;AACnB,QAAI,UAAU;AAEd,QAAI,QAA4B;AAElB;AACZ,UAAI;AACF,cAAM,MAAM,MAAM,KAAK,IAAI,UAAA;AAC3B,gBAAQ,IAAI,IAAI,SAAA;AAChB,gBAAQ,MAAM,IAAI;AAClB,kBACE;AAAA,MACJ,SAAS,OAAO;AACd,aAAK,OAAO;AAAA,UACV;AAAA,UACA;AAAA,QAAA;AAEF,gBAAQ,WAAW;AAAA,MACrB;AAAA,IACF;AAEA,QAAI;AAEJ,QAAI;AAEF,eAAS,MAAM,KAAK,IAAI;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ,SAAS,OAAO;AACd,UAAI,eAAe;AAEnB,UAAI,eAAe,OAAO,kBAAkB,GAAG;AAC7C,uBAAe,gBAAgB,KAAK;AAAA,MACtC;AAEA,WAAK,OAAO;AAAA,QACV;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B;AAEA,WAAO,iCAAiC;AAAA,MACtC,WAAW,OAAO,UAAU,SAAA;AAAA,MAC5B,KAAK,KAAK,IAAI,MAAM,UAAU,OAAO,UAAU,SAAA;AAAA,MAC/C;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AACF;"}
+{"version":3,"file":"index59.js","sources":["../../src/execution/execution-pipeline.ts"],"sourcesContent":["import { ZodError } from 'zod';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport { SmartMemoryManager } from '../memory/smart-memory-manager';\nimport { FormEngine, ToolExecutionResult } from '../forms/form-engine';\nimport type { FormMessage, FormSubmission } from '../forms/types';\nimport type { ToolRegistry, ToolRegistryEntry } from '../core/tool-registry';\n\n/**\n * Session context for tool execution\n */\nexport interface SessionContext {\n  sessionId: string;\n  userId?: string;\n  timestamp: number;\n  conversationId?: string;\n}\n\n/**\n * Context passed through execution pipeline\n */\nexport interface ExecutionContext {\n  toolName: string;\n  input: unknown;\n  session: SessionContext;\n  memory: SmartMemoryManager;\n  traceId: string;\n  toolEntry: ToolRegistryEntry;\n}\n\n/**\n * Result of tool execution with metadata\n */\nexport interface ExecutionResult extends ToolExecutionResult {\n  traceId: string;\n  executionTime: number;\n}\n\n/**\n * ExecutionPipeline handles tool execution coordination\n */\nexport class ExecutionPipeline {\n  private logger: Logger;\n  private toolRegistry: ToolRegistry;\n  private formEngine: FormEngine;\n  private memory: SmartMemoryManager;\n\n  constructor(\n    toolRegistry: ToolRegistry,\n    formEngine: FormEngine,\n    memory: SmartMemoryManager,\n    logger?: Logger\n  ) {\n    this.toolRegistry = toolRegistry;\n    this.formEngine = formEngine;\n    this.memory = memory;\n    this.logger = logger || new Logger({ module: 'ExecutionPipeline' });\n  }\n\n  /**\n   * Execute a tool through the pipeline\n   */\n  async execute(\n    toolName: string,\n    input: unknown,\n    sessionContext?: SessionContext\n  ): Promise<ExecutionResult> {\n    const traceId = `trace-${Date.now()}-${Math.random()\n      .toString(36)\n      .substr(2, 9)}`;\n    const startTime = Date.now();\n\n    const toolEntry = this.toolRegistry.getTool(toolName);\n    if (!toolEntry) {\n      throw new Error(`Tool not found in registry: ${toolName}`);\n    }\n\n    const context: ExecutionContext = {\n      toolName,\n      input,\n      session: sessionContext || this.buildDefaultSession(),\n      memory: this.memory,\n      traceId,\n      toolEntry,\n    };\n\n    try {\n      const shouldGenerateForm = await this.checkFormGeneration(context);\n      if (shouldGenerateForm.requiresForm && shouldGenerateForm.formMessage) {\n        return {\n          success: false,\n          output: 'Form generation required',\n          requiresForm: true,\n          formMessage: shouldGenerateForm.formMessage,\n          traceId,\n          executionTime: Date.now() - startTime,\n        };\n      }\n\n      const result = await this.executeToolDirect(context);\n\n      return {\n        success: true,\n        output: result,\n        traceId,\n        executionTime: Date.now() - startTime,\n      };\n    } catch (error) {\n      return this.handleExecutionError(\n        error,\n        context,\n        traceId,\n        Date.now() - startTime\n      );\n    }\n  }\n\n  /**\n   * Execute tool with validation\n   */\n  async executeWithValidation(\n    toolName: string,\n    input: unknown,\n    sessionContext?: SessionContext\n  ): Promise<ExecutionResult> {\n    return this.execute(toolName, input, sessionContext);\n  }\n\n  /**\n   * Process form submission\n   */\n  async processFormSubmission(\n    toolName: string,\n    formId: string,\n    parameters: Record<string, unknown>,\n    sessionContext?: SessionContext\n  ): Promise<ExecutionResult> {\n    const traceId = `form-${Date.now()}-${Math.random()\n      .toString(36)\n      .substr(2, 9)}`;\n    const startTime = Date.now();\n\n    try {\n      const formSubmission: FormSubmission = {\n        formId,\n        toolName,\n        parameters,\n        timestamp: Date.now(),\n      };\n\n      const processedInput = await this.formEngine.processSubmission(\n        formSubmission\n      );\n\n      return this.execute(toolName, processedInput, sessionContext);\n    } catch (error) {\n      return {\n        success: false,\n        output: 'Form submission processing failed',\n        error: error instanceof Error ? error.message : String(error),\n        traceId,\n        executionTime: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Check if form generation is required\n   */\n  private async checkFormGeneration(context: ExecutionContext): Promise<{\n    requiresForm: boolean;\n    formMessage?: FormMessage;\n  }> {\n    const inputRecord = context.input as Record<string, unknown>;\n    if (inputRecord?.__fromForm === true || inputRecord?.renderForm === false) {\n      return { requiresForm: false };\n    }\n\n    if (\n      !this.formEngine.shouldGenerateForm(context.toolEntry.tool, context.input)\n    ) {\n      return { requiresForm: false };\n    }\n\n    const formMessage = await this.formEngine.generateForm(\n      context.toolName,\n      context.toolEntry.tool,\n      context.input\n    );\n\n    if (formMessage) {\n      return { requiresForm: true, formMessage };\n    }\n\n    return { requiresForm: false };\n  }\n\n  /**\n   * Execute tool directly\n   */\n  private async executeToolDirect(context: ExecutionContext): Promise<string> {\n    const { toolEntry, input } = context;\n    const parameters = (input as Record<string, unknown>) || {};\n    const mergedArgs = { ...parameters, renderForm: false };\n\n    if (toolEntry.wrapper) {\n      return this.executeWrappedTool(toolEntry, mergedArgs);\n    }\n\n    return await toolEntry.tool.call(mergedArgs);\n  }\n\n  /**\n   * Execute wrapped tool\n   */\n  private async executeWrappedTool(\n    toolEntry: ToolRegistryEntry,\n    mergedArgs: Record<string, unknown>\n  ): Promise<string> {\n    const wrapper = toolEntry.wrapper;\n    if (!wrapper) {\n      throw new Error('Tool wrapper not found');\n    }\n\n    const wrapperAsAny = wrapper as unknown as {\n      executeOriginal?: (args: Record<string, unknown>) => Promise<string>;\n      originalTool?: {\n        call?: (args: Record<string, unknown>) => Promise<string>;\n      };\n    };\n\n    if (wrapperAsAny.executeOriginal) {\n      return await wrapperAsAny.executeOriginal(mergedArgs);\n    }\n\n    if (wrapperAsAny.originalTool?.call) {\n      return await wrapperAsAny.originalTool.call(mergedArgs);\n    }\n\n    return await toolEntry.originalTool.call(mergedArgs);\n  }\n\n  /**\n   * Handle execution error\n   */\n  private handleExecutionError(\n    error: unknown,\n    context: ExecutionContext,\n    traceId: string,\n    executionTime: number\n  ): ExecutionResult {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n\n    if (error instanceof ZodError) {\n      return {\n        success: false,\n        output: 'Validation error occurred',\n        error: errorMessage,\n        traceId,\n        executionTime,\n      };\n    }\n\n    this.logger.error(`Tool execution failed: ${context.toolName}`, {\n      traceId,\n      error: errorMessage,\n    });\n\n    return {\n      success: false,\n      output: 'Tool execution failed',\n      error: errorMessage,\n      traceId,\n      executionTime,\n    };\n  }\n\n  /**\n   * Build default session context\n   */\n  private buildDefaultSession(): SessionContext {\n    return {\n      sessionId: `session-${Date.now()}-${Math.random()\n        .toString(36)\n        .substr(2, 9)}`,\n      timestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Get statistics about the pipeline\n   */\n  getStatistics(): {\n    totalMiddleware: number;\n    registeredMiddleware: string[];\n  } {\n    return {\n      totalMiddleware: 0,\n      registeredMiddleware: [],\n    };\n  }\n}\n"],"names":[],"mappings":";;AAwCO,MAAM,kBAAkB;AAAA,EAM7B,YACE,cACA,YACA,QACA,QACA;AACA,SAAK,eAAe;AACpB,SAAK,aAAa;AAClB,SAAK,SAAS;AACd,SAAK,SAAS,UAAU,IAAI,OAAO,EAAE,QAAQ,qBAAqB;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QACJ,UACA,OACA,gBAC0B;AAC1B,UAAM,UAAU,SAAS,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EACzC,SAAS,EAAE,EACX,OAAO,GAAG,CAAC,CAAC;AACf,UAAM,YAAY,KAAK,IAAA;AAEvB,UAAM,YAAY,KAAK,aAAa,QAAQ,QAAQ;AACpD,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,+BAA+B,QAAQ,EAAE;AAAA,IAC3D;AAEA,UAAM,UAA4B;AAAA,MAChC;AAAA,MACA;AAAA,MACA,SAAS,kBAAkB,KAAK,oBAAA;AAAA,MAChC,QAAQ,KAAK;AAAA,MACb;AAAA,MACA;AAAA,IAAA;AAGF,QAAI;AACF,YAAM,qBAAqB,MAAM,KAAK,oBAAoB,OAAO;AACjE,UAAI,mBAAmB,gBAAgB,mBAAmB,aAAa;AACrE,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ;AAAA,UACR,cAAc;AAAA,UACd,aAAa,mBAAmB;AAAA,UAChC;AAAA,UACA,eAAe,KAAK,QAAQ;AAAA,QAAA;AAAA,MAEhC;AAEA,YAAM,SAAS,MAAM,KAAK,kBAAkB,OAAO;AAEnD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAQ;AAAA,QACR;AAAA,QACA,eAAe,KAAK,QAAQ;AAAA,MAAA;AAAA,IAEhC,SAAS,OAAO;AACd,aAAO,KAAK;AAAA,QACV;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK,QAAQ;AAAA,MAAA;AAAA,IAEjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,sBACJ,UACA,OACA,gBAC0B;AAC1B,WAAO,KAAK,QAAQ,UAAU,OAAO,cAAc;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,sBACJ,UACA,QACA,YACA,gBAC0B;AAC1B,UAAM,UAAU,QAAQ,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EACxC,SAAS,EAAE,EACX,OAAO,GAAG,CAAC,CAAC;AACf,UAAM,YAAY,KAAK,IAAA;AAEvB,QAAI;AACF,YAAM,iBAAiC;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAW,KAAK,IAAA;AAAA,MAAI;AAGtB,YAAM,iBAAiB,MAAM,KAAK,WAAW;AAAA,QAC3C;AAAA,MAAA;AAGF,aAAO,KAAK,QAAQ,UAAU,gBAAgB,cAAc;AAAA,IAC9D,SAAS,OAAO;AACd,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC5D;AAAA,QACA,eAAe,KAAK,QAAQ;AAAA,MAAA;AAAA,IAEhC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,oBAAoB,SAG/B;AACD,UAAM,cAAc,QAAQ;AAC5B,QAAI,aAAa,eAAe,QAAQ,aAAa,eAAe,OAAO;AACzE,aAAO,EAAE,cAAc,MAAA;AAAA,IACzB;AAEA,QACE,CAAC,KAAK,WAAW,mBAAmB,QAAQ,UAAU,MAAM,QAAQ,KAAK,GACzE;AACA,aAAO,EAAE,cAAc,MAAA;AAAA,IACzB;AAEA,UAAM,cAAc,MAAM,KAAK,WAAW;AAAA,MACxC,QAAQ;AAAA,MACR,QAAQ,UAAU;AAAA,MAClB,QAAQ;AAAA,IAAA;AAGV,QAAI,aAAa;AACf,aAAO,EAAE,cAAc,MAAM,YAAA;AAAA,IAC/B;AAEA,WAAO,EAAE,cAAc,MAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,kBAAkB,SAA4C;AAC1E,UAAM,EAAE,WAAW,MAAA,IAAU;AAC7B,UAAM,aAAc,SAAqC,CAAA;AACzD,UAAM,aAAa,EAAE,GAAG,YAAY,YAAY,MAAA;AAEhD,QAAI,UAAU,SAAS;AACrB,aAAO,KAAK,mBAAmB,WAAW,UAAU;AAAA,IACtD;AAEA,WAAO,MAAM,UAAU,KAAK,KAAK,UAAU;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,mBACZ,WACA,YACiB;AACjB,UAAM,UAAU,UAAU;AAC1B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AAEA,UAAM,eAAe;AAOrB,QAAI,aAAa,iBAAiB;AAChC,aAAO,MAAM,aAAa,gBAAgB,UAAU;AAAA,IACtD;AAEA,QAAI,aAAa,cAAc,MAAM;AACnC,aAAO,MAAM,aAAa,aAAa,KAAK,UAAU;AAAA,IACxD;AAEA,WAAO,MAAM,UAAU,aAAa,KAAK,UAAU;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKQ,qBACN,OACA,SACA,SACA,eACiB;AACjB,UAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAE1E,QAAI,iBAAiB,UAAU;AAC7B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO;AAAA,QACP;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAEA,SAAK,OAAO,MAAM,0BAA0B,QAAQ,QAAQ,IAAI;AAAA,MAC9D;AAAA,MACA,OAAO;AAAA,IAAA,CACR;AAED,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA,EAKQ,sBAAsC;AAC5C,WAAO;AAAA,MACL,WAAW,WAAW,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EACtC,SAAS,EAAE,EACX,OAAO,GAAG,CAAC,CAAC;AAAA,MACf,WAAW,KAAK,IAAA;AAAA,IAAI;AAAA,EAExB;AAAA;AAAA;AAAA;AAAA,EAKA,gBAGE;AACA,WAAO;AAAA,MACL,iBAAiB;AAAA,MACjB,sBAAsB,CAAA;AAAA,IAAC;AAAA,EAE3B;AACF;"}

package/dist/esm/index6.js

@@ -1,17 +1,17 @@
 import { BasePlugin } from "hedera-agent-kit";
 import { Bee } from "@ethersphere/bee-js";
-import { ListPostageStampsTool } from "./index48.js";
-import { UploadDataTool } from "./index49.js";
-import { DownloadDataTool } from "./index50.js";
-import { CreatePostageStampTool } from "./index51.js";
-import { ExtendPostageStampTool } from "./index52.js";
-import { QueryUploadProgressTool } from "./index53.js";
-import { DownloadFilesTool } from "./index54.js";
-import { GetPostageStampTool } from "./index55.js";
-import { ReadFeedTool } from "./index56.js";
-import { UpdateFeedTool } from "./index57.js";
-import { UploadFileTool } from "./index58.js";
-import { UploadFolderTool } from "./index59.js";
+import { ListPostageStampsTool } from "./index45.js";
+import { UploadDataTool } from "./index46.js";
+import { DownloadDataTool } from "./index47.js";
+import { CreatePostageStampTool } from "./index48.js";
+import { ExtendPostageStampTool } from "./index49.js";
+import { QueryUploadProgressTool } from "./index50.js";
+import { DownloadFilesTool } from "./index51.js";
+import { GetPostageStampTool } from "./index52.js";
+import { ReadFeedTool } from "./index53.js";
+import { UpdateFeedTool } from "./index54.js";
+import { UploadFileTool } from "./index55.js";
+import { UploadFolderTool } from "./index56.js";
 class SwarmPlugin extends BasePlugin {
   constructor(config) {
     super();

package/dist/esm/index60.js

@@ -1,30 +1,10 @@
-const DEFAULT_CONTENT_REFERENCE_CONFIG = {
-  sizeThresholdBytes: 10 * 1024,
-  maxAgeMs: 60 * 60 * 1e3,
-  maxReferences: 100,
-  maxTotalStorageBytes: 100 * 1024 * 1024,
-  enableAutoCleanup: true,
-  cleanupIntervalMs: 5 * 60 * 1e3,
-  enablePersistence: false,
-  storageBackend: "memory",
-  cleanupPolicies: {
-    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
-    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
-    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
-    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
-  }
+const FIELD_PRIORITIES = {
+  ESSENTIAL: "essential",
+  COMMON: "common",
+  ADVANCED: "advanced",
+  EXPERT: "expert"
 };
-class ContentReferenceError extends Error {
-  constructor(message, type, referenceId, suggestedActions) {
-    super(message);
-    this.type = type;
-    this.referenceId = referenceId;
-    this.suggestedActions = suggestedActions;
-    this.name = "ContentReferenceError";
-  }
-}
 export {
-  ContentReferenceError,
-  DEFAULT_CONTENT_REFERENCE_CONFIG
+  FIELD_PRIORITIES
 };
 //# sourceMappingURL=index60.js.map

package/dist/esm/index60.js.map

@@ -1 +1 @@
-{"version":3,"file":"index60.js","sources":["../../src/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n *\n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState =\n  | 'active'\n  | 'expired'\n  | 'cleanup_pending'\n  | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType =\n  | 'text'\n  | 'json'\n  | 'html'\n  | 'markdown'\n  | 'binary'\n  | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource =\n  | 'mcp_tool'\n  | 'user_upload'\n  | 'agent_generated'\n  | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n\n  /** MIME type of the original content */\n  mimeType?: string;\n\n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n\n  /** When the content was originally stored */\n  createdAt: Date;\n\n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n\n  /** Source that created this content reference */\n  source: ContentSource;\n\n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n\n  /** Original filename or suggested name for the content */\n  fileName?: string;\n\n  /** Number of times this reference has been resolved */\n  accessCount: number;\n\n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n\n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough\n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n\n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n\n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n\n  /** Essential metadata for agent decision-making */\n  metadata: Pick<\n    ContentMetadata,\n    'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'\n  >;\n\n  /** When this reference was created */\n  createdAt: Date;\n\n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n\n  /** The resolved content if successful */\n  content?: Buffer;\n\n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n\n  /** Error message if resolution failed */\n  error?: string;\n\n  /** Specific error type for targeted error handling */\n  errorType?:\n    | 'not_found'\n    | 'expired'\n    | 'corrupted'\n    | 'access_denied'\n    | 'system_error';\n\n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n\n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n\n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n\n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n\n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n\n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n\n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n\n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n\n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n\n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n\n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n\n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024,\n  maxAgeMs: 60 * 60 * 1000,\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024,\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000,\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 },\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 },\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 },\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 },\n  },\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n\n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n\n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n\n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n\n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n\n  /** Average content size in bytes */\n  averageContentSize: number;\n\n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n\n  /** Storage utilization percentage */\n  storageUtilization: number;\n\n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n\n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n\n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<\n      ContentMetadata,\n      'createdAt' | 'lastAccessedAt' | 'accessCount'\n    >\n  ): Promise<ContentReference>;\n\n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(\n    referenceId: ReferenceId\n  ): Promise<ReferenceResolutionResult>;\n\n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n\n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n\n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n\n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}\n"],"names":[],"mappings":"AAuLO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"index60.js","sources":["../../src/constants/form-priorities.ts"],"sourcesContent":["/**\n * Form field priorities for progressive disclosure\n */\nexport const FIELD_PRIORITIES = {\n  ESSENTIAL: 'essential',\n  COMMON: 'common', \n  ADVANCED: 'advanced',\n  EXPERT: 'expert'\n} as const;\n\n/**\n * Form field types\n */\nexport const FORM_FIELD_TYPES = {\n  TEXT: 'text',\n  NUMBER: 'number',\n  SELECT: 'select',\n  CHECKBOX: 'checkbox',\n  TEXTAREA: 'textarea',\n  FILE: 'file',\n  ARRAY: 'array',\n  OBJECT: 'object',\n  CURRENCY: 'currency',\n  PERCENTAGE: 'percentage',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,mBAAmB;AAAA,EAC9B,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,QAAQ;AACV;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/conversational-agent",
-  "version": "0.2.217",
+  "version": "0.2.218",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
@@ -100,7 +100,7 @@
   "dependencies": {
     "@ethereumjs/wallet": "^10.0.0",
     "@ethersphere/bee-js": "^10.1.1",
-    "@hashgraph/sdk": "^2.72.0",
+    "@hashgraph/sdk": "^2.77.0",
     "@hashgraphonline/hashinal-wc": "2.0.1",
     "@hashgraphonline/standards-agent-kit": "^0.2.164",
     "@hashgraphonline/standards-sdk": "0.1.136",