@hashgraphonline/conversational-agent 0.1.219 → 0.1.220

package/dist/esm/index41.js

@@ -1,30 +1,187 @@
-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 }
+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" });
   }
-};
-class ContentReferenceError extends Error {
-  constructor(message, type, referenceId, suggestedActions) {
-    super(message);
-    this.type = type;
-    this.referenceId = referenceId;
-    this.suggestedActions = suggestedActions;
-    this.name = "ContentReferenceError";
+  /**
+   * 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 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
+      );
+    }
+  }
+  /**
+   * 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 {
+      const formSubmission = {
+        formId,
+        toolName,
+        parameters,
+        timestamp: Date.now()
+      };
+      const processedInput = await this.formEngine.processSubmission(
+        formSubmission
+      );
+      return this.execute(toolName, processedInput, sessionContext);
+    } catch (error) {
+      return {
+        success: false,
+        output: "Form submission processing failed",
+        error: error instanceof Error ? error.message : String(error),
+        traceId,
+        executionTime: Date.now() - startTime
+      };
+    }
+  }
+  /**
+   * Check if form generation is required
+   */
+  async checkFormGeneration(context) {
+    const inputRecord = context.input;
+    if (inputRecord?.__fromForm === true || inputRecord?.renderForm === false) {
+      return { requiresForm: false };
+    }
+    if (!this.formEngine.shouldGenerateForm(context.toolEntry.tool, context.input)) {
+      return { requiresForm: false };
+    }
+    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");
+    }
+    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 {
-  ContentReferenceError,
-  DEFAULT_CONTENT_REFERENCE_CONFIG
+  ExecutionPipeline
 };
 //# sourceMappingURL=index41.js.map

package/dist/esm/index41.js.map

@@ -1 +1 @@
-{"version":3,"file":"index41.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":"index41.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":"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"}

package/dist/esm/index42.js

@@ -1,10 +1,30 @@
-const FIELD_PRIORITIES = {
-  ESSENTIAL: "essential",
-  COMMON: "common",
-  ADVANCED: "advanced",
-  EXPERT: "expert"
+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 }
+  }
 };
+class ContentReferenceError extends Error {
+  constructor(message, type, referenceId, suggestedActions) {
+    super(message);
+    this.type = type;
+    this.referenceId = referenceId;
+    this.suggestedActions = suggestedActions;
+    this.name = "ContentReferenceError";
+  }
+}
 export {
-  FIELD_PRIORITIES
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
 };
 //# sourceMappingURL=index42.js.map

package/dist/esm/index42.js.map

@@ -1 +1 @@
-{"version":3,"file":"index42.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;"}
+{"version":3,"file":"index42.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;"}

package/dist/esm/index6.js

@@ -209,10 +209,6 @@ const _ConversationalAgent = class _ConversationalAgent {
     if (!this.agent) {
       throw new Error(_ConversationalAgent.NOT_INITIALIZED_ERROR);
     }
-    const internalAgent = this.agent;
-    if (!internalAgent.processFormSubmission || typeof internalAgent.processFormSubmission !== "function") {
-      throw new Error("processFormSubmission not available on internal agent");
-    }
     try {
       this.logger.info("Processing form submission:", {
         formId: submission.formId,
@@ -220,7 +216,7 @@ const _ConversationalAgent = class _ConversationalAgent {
         parameterKeys: Object.keys(submission.parameters || {}),
         hasContext: !!submission.context
       });
-      const response = await internalAgent.processFormSubmission(submission);
+      const response = await this.agent.processFormSubmission(submission);
       this.logger.info("Form submission processed successfully");
       return response;
     } catch (error) {

package/dist/esm/index6.js.map

@@ -1 +1 @@
-{"version":3,"file":"index6.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  getAllHederaCorePlugins,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport { Logger, type NetworkType } from '@hashgraphonline/standards-sdk';\nimport { createAgent } from './agent-factory';\nimport { LangChainProvider } from './providers';\nimport type { ChatResponse, ConversationContext } from './base-agent';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { ChatAnthropic } from '@langchain/anthropic';\nimport {\n  HumanMessage,\n  AIMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';\nimport { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';\nimport { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';\nimport { InscribePlugin } from './plugins/inscribe/InscribePlugin';\nimport { HbarPlugin } from './plugins/hbar/HbarPlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport { getSystemMessage } from './config/system-message';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\nimport { ContentStoreManager } from './services/content-store-manager';\nimport { SmartMemoryManager, type SmartMemoryConfig } from './memory';\nimport {\n  createEntityTools,\n  ResolveEntitiesTool,\n  ExtractEntitiesTool,\n} from './tools/entity-resolver-tool';\nimport type { FormSubmission } from './forms/types';\n\nexport type ToolDescriptor = {\n  name: string;\n  namespace?: string;\n};\n\nexport type ChatHistoryItem = {\n  type: 'human' | 'ai' | 'system';\n  content: string;\n};\n\nexport type AgentInstance = ReturnType<typeof createAgent>;\n\nexport type MirrorNetwork = 'testnet' | 'mainnet' | 'previewnet';\n\nconst DEFAULT_MODEL_NAME = 'gpt-4o';\nconst DEFAULT_TEMPERATURE = 0.1;\nconst DEFAULT_NETWORK = 'testnet';\nconst DEFAULT_OPERATIONAL_MODE: AgentOperationalMode = 'autonomous';\n\nexport interface ConversationalAgentOptions {\n  accountId: string;\n  privateKey: string;\n  network?: NetworkType;\n  openAIApiKey: string;\n  openAIModelName?: string;\n  llmProvider?: 'openai' | 'anthropic';\n  verbose?: boolean;\n  operationalMode?: AgentOperationalMode;\n  userAccountId?: string;\n  customSystemMessagePreamble?: string;\n  customSystemMessagePostamble?: string;\n  additionalPlugins?: BasePlugin[];\n  stateManager?: IStateManager;\n  scheduleUserTransactionsInBytesMode?: boolean;\n  mirrorNodeConfig?: MirrorNodeConfig;\n  disableLogging?: boolean;\n  enabledPlugins?: string[];\n  toolFilter?: (tool: { name: string; namespace?: string }) => boolean;\n  mcpServers?: MCPServerConfig[];\n\n  /** Enable automatic entity memory functionality (default: true) */\n  entityMemoryEnabled?: boolean;\n\n  /** Configuration for entity memory system */\n  entityMemoryConfig?: SmartMemoryConfig;\n}\n\n/**\n * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,\n * which includes the OpenConvAIPlugin and the OpenConvaiState by default.\n * If you want to use a different plugin or state manager, you can pass them in the options.\n * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.\n *\n * @param options - The options for the ConversationalAgent.\n * @returns A new instance of the ConversationalAgent class.\n */\nexport class ConversationalAgent {\n  private static readonly NOT_INITIALIZED_ERROR = 'Agent not initialized. Call initialize() first.';\n  protected agent?: AgentInstance;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public hbarPlugin: HbarPlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  public logger: Logger;\n  public contentStoreManager?: ContentStoreManager;\n  public memoryManager?: SmartMemoryManager | undefined;\n  private entityTools?: {\n    resolveEntities: ResolveEntitiesTool;\n    extractEntities: ExtractEntitiesTool;\n  };\n\n  constructor(options: ConversationalAgentOptions) {\n    this.options = options;\n    this.stateManager = options.stateManager || new OpenConvaiState();\n    this.hcs10Plugin = new HCS10Plugin();\n    this.hcs2Plugin = new HCS2Plugin();\n    this.inscribePlugin = new InscribePlugin();\n    this.hbarPlugin = new HbarPlugin();\n    this.logger = new Logger({\n      module: 'ConversationalAgent',\n      silent: options.disableLogging || false,\n    });\n\n    if (this.options.entityMemoryEnabled !== false) {\n      if (!options.openAIApiKey) {\n        throw new Error(\n          'OpenAI API key is required when entity memory is enabled'\n        );\n      }\n\n      this.memoryManager = new SmartMemoryManager(\n        this.options.entityMemoryConfig\n      );\n      this.logger.info('Entity memory initialized');\n\n      this.entityTools = createEntityTools(options.openAIApiKey, 'gpt-4o-mini');\n      this.logger.info('LLM-based entity resolver tools initialized');\n    }\n  }\n\n  /**\n   * Initialize the conversational agent with Hedera Hashgraph connection and AI configuration\n   * @throws {Error} If account ID or private key is missing\n   * @throws {Error} If initialization fails\n   */\n  async initialize(): Promise<void> {\n    const {\n      accountId,\n      privateKey,\n      network = DEFAULT_NETWORK,\n      openAIApiKey,\n      openAIModelName = DEFAULT_MODEL_NAME,\n      llmProvider = 'openai',\n    } = this.options;\n\n    this.validateOptions(accountId, privateKey);\n\n    try {\n      const serverSigner = new ServerSigner(\n        accountId!,\n        privateKey!,\n        network as MirrorNetwork\n      );\n\n      let llm: ChatOpenAI | ChatAnthropic;\n      if (llmProvider === 'anthropic') {\n        llm = new ChatAnthropic({\n          apiKey: openAIApiKey,\n          modelName: openAIModelName || 'claude-3-5-sonnet-20241022',\n          temperature: DEFAULT_TEMPERATURE,\n        });\n      } else {\n        const modelName = openAIModelName || 'gpt-4o-mini';\n        const isGPT5Model =\n          modelName.toLowerCase().includes('gpt-5') ||\n          modelName.toLowerCase().includes('gpt5');\n        llm = new ChatOpenAI({\n          apiKey: openAIApiKey,\n          modelName: openAIModelName,\n          ...(isGPT5Model\n            ? { temperature: 1 }\n            : { temperature: DEFAULT_TEMPERATURE }),\n        });\n      }\n\n      this.logger.info('Preparing plugins...');\n      const allPlugins = this.preparePlugins();\n      this.logger.info('Creating agent config...');\n      const agentConfig = this.createAgentConfig(serverSigner, llm, allPlugins);\n\n      this.logger.info('Creating agent...');\n      this.agent = createAgent(agentConfig);\n      this.logger.info('Agent created');\n\n      this.logger.info('Configuring HCS10 plugin...');\n      this.configureHCS10Plugin(allPlugins);\n      this.logger.info('HCS10 plugin configured');\n\n      this.contentStoreManager = new ContentStoreManager();\n      await this.contentStoreManager.initialize();\n      this.logger.info(\n        'ContentStoreManager initialized for content reference support'\n      );\n\n      this.logger.info('About to call agent.boot()');\n      this.logger.info('🔥 About to call agent.boot()');\n      await this.agent.boot();\n      this.logger.info('agent.boot() completed');\n      this.logger.info('🔥 agent.boot() completed');\n\n      if (this.agent) {\n        const cfg = agentConfig;\n        cfg.filtering = cfg.filtering || {};\n        const originalPredicate = cfg.filtering.toolPredicate as\n          | ((t: ToolDescriptor) => boolean)\n          | undefined;\n        const userPredicate = this.options.toolFilter;\n        cfg.filtering.toolPredicate = (tool: ToolDescriptor): boolean => {\n          if (tool && tool.name === 'hedera-account-transfer-hbar') {\n            return false;\n          }\n          if (tool && tool.name === 'hedera-hts-airdrop-token') {\n            return false;\n          }\n          if (originalPredicate && !originalPredicate(tool)) {\n            return false;\n          }\n          if (userPredicate && !userPredicate(tool)) {\n            return false;\n          }\n          return true;\n        };\n      }\n\n      if (this.options.mcpServers && this.options.mcpServers.length > 0) {\n        this.connectMCP();\n      }\n    } catch (error) {\n      this.logger.error('Failed to initialize ConversationalAgent:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the HCS-10 plugin instance\n   * @returns {HCS10Plugin} The HCS-10 plugin instance\n   */\n  getPlugin(): HCS10Plugin {\n    return this.hcs10Plugin;\n  }\n\n  /**\n   * Get the state manager instance\n   * @returns {IStateManager} The state manager instance\n   */\n  getStateManager(): IStateManager {\n    return this.stateManager;\n  }\n\n  /**\n   * Get the underlying agent instance\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getAgent(): ReturnType<typeof createAgent> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n    return this.agent;\n  }\n\n  /**\n   * Get the conversational agent instance (alias for getAgent)\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getConversationalAgent(): ReturnType<typeof createAgent> {\n    return this.getAgent();\n  }\n\n  /**\n   * Process a message through the conversational agent\n   * @param {string} message - The message to process\n   * @param {Array<{type: 'human' | 'ai'; content: string}>} chatHistory - Previous chat history\n   * @returns {Promise<ChatResponse>} The agent's response\n   * @throws {Error} If agent is not initialized\n   */\n  async processMessage(\n    message: string,\n    chatHistory: ChatHistoryItem[] = []\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error('Agent not initialized. Call initialize() first.');\n    }\n\n    try {\n      const resolvedMessage = message;\n\n      const messages = chatHistory.map((msg) => {\n        const content = msg.content;\n        if (msg.type === 'system') {\n          return new SystemMessage(content);\n        }\n        return msg.type === 'human'\n          ? new HumanMessage(content)\n          : new AIMessage(content);\n      });\n\n      const context: ConversationContext = { messages };\n      const response = await this.agent.chat(resolvedMessage, context);\n\n      if (\n        this.memoryManager &&\n        this.options.operationalMode !== 'returnBytes'\n      ) {\n        await this.extractAndStoreEntities(response, message);\n      }\n\n      this.logger.info('Message processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing message:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Process form submission through the conversational agent\n   * @param {FormSubmission} submission - The form submission data\n   * @returns {Promise<ChatResponse>} The agent's response after processing the form\n   * @throws {Error} If agent is not initialized or doesn't support form processing\n   */\n  async processFormSubmission(\n    submission: FormSubmission\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n\n    const internalAgent = this.agent as {\n      processFormSubmission?: (\n        submission: FormSubmission\n      ) => Promise<ChatResponse>;\n    };\n    if (\n      !internalAgent.processFormSubmission ||\n      typeof internalAgent.processFormSubmission !== 'function'\n    ) {\n      throw new Error('processFormSubmission not available on internal agent');\n    }\n\n    try {\n      this.logger.info('Processing form submission:', {\n        formId: submission.formId,\n        toolName: submission.toolName,\n        parameterKeys: Object.keys(submission.parameters || {}),\n        hasContext: !!submission.context,\n      });\n      const response = await internalAgent.processFormSubmission(submission);\n      this.logger.info('Form submission processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing form submission:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Validates initialization options and throws if required fields are missing.\n   *\n   * @param accountId - The Hedera account ID\n   * @param privateKey - The private key for the account\n   * @throws {Error} If required fields are missing\n   */\n  private validateOptions(accountId?: string, privateKey?: string): void {\n    if (!accountId || !privateKey) {\n      throw new Error('Account ID and private key are required');\n    }\n\n    if (typeof accountId !== 'string') {\n      throw new Error(\n        `Account ID must be a string, received ${typeof accountId}`\n      );\n    }\n\n    if (typeof privateKey !== 'string') {\n      throw new Error(\n        `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(\n          privateKey\n        )}`\n      );\n    }\n\n    if (privateKey.length < 10) {\n      throw new Error('Private key appears to be invalid (too short)');\n    }\n  }\n\n  /**\n   * Prepares the list of plugins to use based on configuration.\n   *\n   * @returns Array of plugins to initialize with the agent\n   */\n  private preparePlugins(): BasePlugin[] {\n    const { additionalPlugins = [], enabledPlugins } = this.options;\n\n    const standardPlugins = [\n      this.hcs10Plugin,\n      this.hcs2Plugin,\n      this.inscribePlugin,\n      this.hbarPlugin,\n    ];\n\n    const corePlugins = getAllHederaCorePlugins();\n\n    if (enabledPlugins) {\n      const enabledSet = new Set(enabledPlugins);\n      const filteredPlugins = [...standardPlugins, ...corePlugins].filter(\n        (plugin) => enabledSet.has(plugin.id)\n      );\n      return [...filteredPlugins, ...additionalPlugins];\n    }\n\n    return [...standardPlugins, ...corePlugins, ...additionalPlugins];\n  }\n\n  /**\n   * Creates the agent configuration object.\n   *\n   * @param serverSigner - The server signer instance\n   * @param llm - The language model instance\n   * @param allPlugins - Array of plugins to use\n   * @returns Configuration object for creating the agent\n   */\n  private createAgentConfig(\n    serverSigner: ServerSigner,\n    llm: ChatOpenAI | ChatAnthropic,\n    allPlugins: BasePlugin[]\n  ): Parameters<typeof createAgent>[0] {\n    const {\n      operationalMode = DEFAULT_OPERATIONAL_MODE,\n      userAccountId,\n      scheduleUserTransactionsInBytesMode,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      verbose = false,\n      mirrorNodeConfig,\n      disableLogging,\n      accountId = '',\n    } = this.options;\n\n    return {\n      framework: 'langchain',\n      signer: serverSigner,\n      execution: {\n        mode: operationalMode === 'autonomous' ? 'direct' : 'bytes',\n        operationalMode: operationalMode,\n        ...(userAccountId && { userAccountId }),\n        ...(scheduleUserTransactionsInBytesMode !== undefined && {\n          scheduleUserTransactionsInBytesMode:\n            scheduleUserTransactionsInBytesMode,\n          scheduleUserTransactions: scheduleUserTransactionsInBytesMode,\n        }),\n      },\n      ai: {\n        provider: new LangChainProvider(llm),\n        temperature: DEFAULT_TEMPERATURE,\n      },\n      filtering: {\n        toolPredicate: (tool: ToolDescriptor): boolean => {\n          if (tool.name === 'hedera-account-transfer-hbar') return false;\n          if (this.options.toolFilter && !this.options.toolFilter(tool)) {\n            return false;\n          }\n          return true;\n        },\n      },\n      messaging: {\n        systemPreamble:\n          customSystemMessagePreamble || getSystemMessage(accountId),\n        ...(customSystemMessagePostamble && {\n          systemPostamble: customSystemMessagePostamble,\n        }),\n        conciseMode: true,\n      },\n      extensions: {\n        plugins: allPlugins,\n        ...(mirrorNodeConfig && {\n          mirrorConfig: mirrorNodeConfig as Record<string, unknown>,\n        }),\n      },\n      ...(this.options.mcpServers && {\n        mcp: {\n          servers: this.options.mcpServers,\n          autoConnect: false,\n        },\n      }),\n      debug: {\n        verbose,\n        silent: disableLogging ?? false,\n      },\n    };\n  }\n\n  /**\n   * Configures the HCS-10 plugin with the state manager.\n   *\n   * @param allPlugins - Array of all plugins\n   */\n  private configureHCS10Plugin(allPlugins: BasePlugin[]): void {\n    const hcs10 = allPlugins.find((p) => p.id === 'hcs-10');\n    if (hcs10) {\n      (\n        hcs10 as BasePlugin & { appConfig?: Record<string, unknown> }\n      ).appConfig = {\n        stateManager: this.stateManager,\n      };\n    }\n  }\n\n  /**\n   * Create a ConversationalAgent with specific plugins enabled\n   */\n  private static withPlugins(\n    options: ConversationalAgentOptions,\n    plugins: string[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: plugins,\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled\n   */\n  static withHTS(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hts-token']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-2 tools enabled\n   */\n  static withHCS2(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-2']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-10 tools enabled\n   */\n  static withHCS10(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only inscription tools enabled\n   */\n  static withInscribe(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only account management tools enabled\n   */\n  static withAccount(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['account']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only file service tools enabled\n   */\n  static withFileService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['file-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only consensus service tools enabled\n   */\n  static withConsensusService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['consensus-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only smart contract tools enabled\n   */\n  static withSmartContract(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['smart-contract']);\n  }\n\n  /**\n   * Create a ConversationalAgent with all HCS standards plugins\n   */\n  static withAllStandards(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10', 'hcs-2', 'inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)\n   */\n  static minimal(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, []);\n  }\n\n  /**\n   * Create a ConversationalAgent with MCP servers configured\n   */\n  static withMCP(\n    options: ConversationalAgentOptions,\n    mcpServers: MCPServerConfig[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      mcpServers,\n    });\n  }\n\n  /**\n   * Extract and store entities from agent responses\n   * @param response - Agent response containing potential entity information\n   * @param originalMessage - Original user message for context\n   */\n  private async extractAndStoreEntities(\n    response: unknown,\n    originalMessage: string\n  ): Promise<void> {\n    if (!this.memoryManager || !this.entityTools) {\n      return;\n    }\n\n    try {\n      this.logger.info('Starting LLM-based entity extraction');\n\n      const responseText = this.extractResponseText(response);\n\n      const entitiesJson = await this.entityTools.extractEntities.call({\n        response: responseText,\n        userMessage: originalMessage,\n      });\n\n      try {\n        const entities = JSON.parse(entitiesJson);\n\n        for (const entity of entities) {\n          if (\n            entity &&\n            typeof entity === 'object' &&\n            'name' in entity &&\n            'type' in entity &&\n            'id' in entity\n          ) {\n            this.logger.info(\n              `Storing entity: ${entity.name} (${entity.type}) -> ${entity.id}`\n            );\n\n            const transactionId = this.extractTransactionId(response);\n            const idStr = String(entity.id);\n            const isHederaId = /^0\\.0\\.[0-9]+$/.test(idStr);\n            if (!isHederaId) {\n              this.logger.warn('Skipping non-ID entity from extraction', {\n                id: idStr,\n                name: String(entity.name),\n                type: String(entity.type),\n              });\n            } else {\n              this.memoryManager.storeEntityAssociation(\n                idStr,\n                String(entity.name),\n                String(entity.type),\n                transactionId\n              );\n            }\n          }\n        }\n\n        if (entities.length > 0) {\n          this.logger.info(\n            `Stored ${entities.length} entities via LLM extraction`\n          );\n        } else {\n          this.logger.info('No entities found in response via LLM extraction');\n        }\n      } catch (parseError) {\n        this.logger.error(\n          'Failed to parse extracted entities JSON:',\n          parseError\n        );\n        throw parseError;\n      }\n    } catch (error) {\n      this.logger.error('Entity extraction failed:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Extract transaction ID from response if available\n   * @param response - Transaction response\n   * @returns Transaction ID or undefined\n   */\n  private extractTransactionId(response: unknown): string | undefined {\n    try {\n      if (\n        typeof response === 'object' &&\n        response &&\n        'transactionId' in response\n      ) {\n        const responseWithTxId = response as { transactionId?: unknown };\n        return typeof responseWithTxId.transactionId === 'string'\n          ? responseWithTxId.transactionId\n          : undefined;\n      }\n      if (typeof response === 'string') {\n        const match = response.match(\n          /transaction[\\s\\w]*ID[\\s:\"]*([0-9a-fA-F@\\.\\-]+)/i\n        );\n        return match ? match[1] : undefined;\n      }\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Connect to MCP servers asynchronously\n   * @private\n   */\n  private connectMCP(): void {\n    if (!this.agent || !this.options.mcpServers) {\n      return;\n    }\n\n    this.agent\n      .connectMCPServers()\n      .catch((e) => {\n        this.logger.error('Failed to connect MCP servers:', e);\n      })\n      .then(() => {\n        this.logger.info('MCP servers connected successfully');\n      });\n  }\n\n  /**\n   * Get MCP connection status for all servers\n   * @returns {Map<string, MCPConnectionStatus>} Connection status map\n   */\n  getMCPConnectionStatus(): Map<string, MCPConnectionStatus> {\n    if (this.agent) {\n      return this.agent.getMCPConnectionStatus();\n    }\n    return new Map();\n  }\n\n  /**\n   * Check if a specific MCP server is connected\n   * @param {string} serverName - Name of the server to check\n   * @returns {boolean} True if connected, false otherwise\n   */\n  isMCPServerConnected(serverName: string): boolean {\n    if (this.agent) {\n      const statusMap = this.agent.getMCPConnectionStatus();\n      const status = statusMap.get(serverName);\n      return status?.connected ?? false;\n    }\n    return false;\n  }\n\n  /**\n   * Clean up resources\n   */\n  async cleanup(): Promise<void> {\n    try {\n      this.logger.info('Cleaning up ConversationalAgent...');\n\n      if (this.memoryManager) {\n        try {\n          this.memoryManager.dispose();\n          this.logger.info('Memory manager cleaned up successfully');\n        } catch (error) {\n          this.logger.warn('Error cleaning up memory manager:', error);\n        }\n        this.memoryManager = undefined;\n      }\n\n      if (this.contentStoreManager) {\n        await this.contentStoreManager.dispose();\n        this.logger.info('ContentStoreManager cleaned up');\n      }\n\n      this.logger.info('ConversationalAgent cleanup completed');\n    } catch (error) {\n      this.logger.error('Error during cleanup:', error);\n    }\n  }\n\n  private extractResponseText(response: unknown): string {\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (response && typeof response === 'object' && 'output' in response) {\n      const responseWithOutput = response as { output: unknown };\n      return String(responseWithOutput.output);\n    }\n\n    return JSON.stringify(response);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index6.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  getAllHederaCorePlugins,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport { Logger, type NetworkType } from '@hashgraphonline/standards-sdk';\nimport { createAgent } from './agent-factory';\nimport { LangChainProvider } from './providers';\nimport type { ChatResponse, ConversationContext } from './base-agent';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { ChatAnthropic } from '@langchain/anthropic';\nimport {\n  HumanMessage,\n  AIMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';\nimport { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';\nimport { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';\nimport { InscribePlugin } from './plugins/inscribe/InscribePlugin';\nimport { HbarPlugin } from './plugins/hbar/HbarPlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport { getSystemMessage } from './config/system-message';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\nimport { ContentStoreManager } from './services/content-store-manager';\nimport { SmartMemoryManager, type SmartMemoryConfig } from './memory';\nimport {\n  createEntityTools,\n  ResolveEntitiesTool,\n  ExtractEntitiesTool,\n} from './tools/entity-resolver-tool';\nimport type { FormSubmission } from './forms/types';\n\nexport type ToolDescriptor = {\n  name: string;\n  namespace?: string;\n};\n\nexport type ChatHistoryItem = {\n  type: 'human' | 'ai' | 'system';\n  content: string;\n};\n\nexport type AgentInstance = ReturnType<typeof createAgent>;\n\nexport type MirrorNetwork = 'testnet' | 'mainnet' | 'previewnet';\n\nconst DEFAULT_MODEL_NAME = 'gpt-4o';\nconst DEFAULT_TEMPERATURE = 0.1;\nconst DEFAULT_NETWORK = 'testnet';\nconst DEFAULT_OPERATIONAL_MODE: AgentOperationalMode = 'autonomous';\n\nexport interface ConversationalAgentOptions {\n  accountId: string;\n  privateKey: string;\n  network?: NetworkType;\n  openAIApiKey: string;\n  openAIModelName?: string;\n  llmProvider?: 'openai' | 'anthropic';\n  verbose?: boolean;\n  operationalMode?: AgentOperationalMode;\n  userAccountId?: string;\n  customSystemMessagePreamble?: string;\n  customSystemMessagePostamble?: string;\n  additionalPlugins?: BasePlugin[];\n  stateManager?: IStateManager;\n  scheduleUserTransactionsInBytesMode?: boolean;\n  mirrorNodeConfig?: MirrorNodeConfig;\n  disableLogging?: boolean;\n  enabledPlugins?: string[];\n  toolFilter?: (tool: { name: string; namespace?: string }) => boolean;\n  mcpServers?: MCPServerConfig[];\n\n  /** Enable automatic entity memory functionality (default: true) */\n  entityMemoryEnabled?: boolean;\n\n  /** Configuration for entity memory system */\n  entityMemoryConfig?: SmartMemoryConfig;\n}\n\n/**\n * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,\n * which includes the OpenConvAIPlugin and the OpenConvaiState by default.\n * If you want to use a different plugin or state manager, you can pass them in the options.\n * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.\n *\n * @param options - The options for the ConversationalAgent.\n * @returns A new instance of the ConversationalAgent class.\n */\nexport class ConversationalAgent {\n  private static readonly NOT_INITIALIZED_ERROR =\n    'Agent not initialized. Call initialize() first.';\n  protected agent?: AgentInstance;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public hbarPlugin: HbarPlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  public logger: Logger;\n  public contentStoreManager?: ContentStoreManager;\n  public memoryManager?: SmartMemoryManager | undefined;\n  private entityTools?: {\n    resolveEntities: ResolveEntitiesTool;\n    extractEntities: ExtractEntitiesTool;\n  };\n\n  constructor(options: ConversationalAgentOptions) {\n    this.options = options;\n    this.stateManager = options.stateManager || new OpenConvaiState();\n    this.hcs10Plugin = new HCS10Plugin();\n    this.hcs2Plugin = new HCS2Plugin();\n    this.inscribePlugin = new InscribePlugin();\n    this.hbarPlugin = new HbarPlugin();\n    this.logger = new Logger({\n      module: 'ConversationalAgent',\n      silent: options.disableLogging || false,\n    });\n\n    if (this.options.entityMemoryEnabled !== false) {\n      if (!options.openAIApiKey) {\n        throw new Error(\n          'OpenAI API key is required when entity memory is enabled'\n        );\n      }\n\n      this.memoryManager = new SmartMemoryManager(\n        this.options.entityMemoryConfig\n      );\n      this.logger.info('Entity memory initialized');\n\n      this.entityTools = createEntityTools(options.openAIApiKey, 'gpt-4o-mini');\n      this.logger.info('LLM-based entity resolver tools initialized');\n    }\n  }\n\n  /**\n   * Initialize the conversational agent with Hedera Hashgraph connection and AI configuration\n   * @throws {Error} If account ID or private key is missing\n   * @throws {Error} If initialization fails\n   */\n  async initialize(): Promise<void> {\n    const {\n      accountId,\n      privateKey,\n      network = DEFAULT_NETWORK,\n      openAIApiKey,\n      openAIModelName = DEFAULT_MODEL_NAME,\n      llmProvider = 'openai',\n    } = this.options;\n\n    this.validateOptions(accountId, privateKey);\n\n    try {\n      const serverSigner = new ServerSigner(\n        accountId!,\n        privateKey!,\n        network as MirrorNetwork\n      );\n\n      let llm: ChatOpenAI | ChatAnthropic;\n      if (llmProvider === 'anthropic') {\n        llm = new ChatAnthropic({\n          apiKey: openAIApiKey,\n          modelName: openAIModelName || 'claude-3-5-sonnet-20241022',\n          temperature: DEFAULT_TEMPERATURE,\n        });\n      } else {\n        const modelName = openAIModelName || 'gpt-4o-mini';\n        const isGPT5Model =\n          modelName.toLowerCase().includes('gpt-5') ||\n          modelName.toLowerCase().includes('gpt5');\n        llm = new ChatOpenAI({\n          apiKey: openAIApiKey,\n          modelName: openAIModelName,\n          ...(isGPT5Model\n            ? { temperature: 1 }\n            : { temperature: DEFAULT_TEMPERATURE }),\n        });\n      }\n\n      this.logger.info('Preparing plugins...');\n      const allPlugins = this.preparePlugins();\n      this.logger.info('Creating agent config...');\n      const agentConfig = this.createAgentConfig(serverSigner, llm, allPlugins);\n\n      this.logger.info('Creating agent...');\n      this.agent = createAgent(agentConfig);\n      this.logger.info('Agent created');\n\n      this.logger.info('Configuring HCS10 plugin...');\n      this.configureHCS10Plugin(allPlugins);\n      this.logger.info('HCS10 plugin configured');\n\n      this.contentStoreManager = new ContentStoreManager();\n      await this.contentStoreManager.initialize();\n      this.logger.info(\n        'ContentStoreManager initialized for content reference support'\n      );\n\n      this.logger.info('About to call agent.boot()');\n      this.logger.info('🔥 About to call agent.boot()');\n      await this.agent.boot();\n      this.logger.info('agent.boot() completed');\n      this.logger.info('🔥 agent.boot() completed');\n\n      if (this.agent) {\n        const cfg = agentConfig;\n        cfg.filtering = cfg.filtering || {};\n        const originalPredicate = cfg.filtering.toolPredicate as\n          | ((t: ToolDescriptor) => boolean)\n          | undefined;\n        const userPredicate = this.options.toolFilter;\n        cfg.filtering.toolPredicate = (tool: ToolDescriptor): boolean => {\n          if (tool && tool.name === 'hedera-account-transfer-hbar') {\n            return false;\n          }\n          if (tool && tool.name === 'hedera-hts-airdrop-token') {\n            return false;\n          }\n          if (originalPredicate && !originalPredicate(tool)) {\n            return false;\n          }\n          if (userPredicate && !userPredicate(tool)) {\n            return false;\n          }\n          return true;\n        };\n      }\n\n      if (this.options.mcpServers && this.options.mcpServers.length > 0) {\n        this.connectMCP();\n      }\n    } catch (error) {\n      this.logger.error('Failed to initialize ConversationalAgent:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the HCS-10 plugin instance\n   * @returns {HCS10Plugin} The HCS-10 plugin instance\n   */\n  getPlugin(): HCS10Plugin {\n    return this.hcs10Plugin;\n  }\n\n  /**\n   * Get the state manager instance\n   * @returns {IStateManager} The state manager instance\n   */\n  getStateManager(): IStateManager {\n    return this.stateManager;\n  }\n\n  /**\n   * Get the underlying agent instance\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getAgent(): ReturnType<typeof createAgent> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n    return this.agent;\n  }\n\n  /**\n   * Get the conversational agent instance (alias for getAgent)\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getConversationalAgent(): ReturnType<typeof createAgent> {\n    return this.getAgent();\n  }\n\n  /**\n   * Process a message through the conversational agent\n   * @param {string} message - The message to process\n   * @param {Array<{type: 'human' | 'ai'; content: string}>} chatHistory - Previous chat history\n   * @returns {Promise<ChatResponse>} The agent's response\n   * @throws {Error} If agent is not initialized\n   */\n  async processMessage(\n    message: string,\n    chatHistory: ChatHistoryItem[] = []\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error('Agent not initialized. Call initialize() first.');\n    }\n\n    try {\n      const resolvedMessage = message;\n\n      const messages = chatHistory.map((msg) => {\n        const content = msg.content;\n        if (msg.type === 'system') {\n          return new SystemMessage(content);\n        }\n        return msg.type === 'human'\n          ? new HumanMessage(content)\n          : new AIMessage(content);\n      });\n\n      const context: ConversationContext = { messages };\n      const response = await this.agent.chat(resolvedMessage, context);\n\n      if (\n        this.memoryManager &&\n        this.options.operationalMode !== 'returnBytes'\n      ) {\n        await this.extractAndStoreEntities(response, message);\n      }\n\n      this.logger.info('Message processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing message:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Process form submission through the conversational agent\n   * @param {FormSubmission} submission - The form submission data\n   * @returns {Promise<ChatResponse>} The agent's response after processing the form\n   * @throws {Error} If agent is not initialized or doesn't support form processing\n   */\n  async processFormSubmission(\n    submission: FormSubmission\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n\n    try {\n      this.logger.info('Processing form submission:', {\n        formId: submission.formId,\n        toolName: submission.toolName,\n        parameterKeys: Object.keys(submission.parameters || {}),\n        hasContext: !!submission.context,\n      });\n      const response = await this.agent.processFormSubmission(submission);\n      this.logger.info('Form submission processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing form submission:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Validates initialization options and throws if required fields are missing.\n   *\n   * @param accountId - The Hedera account ID\n   * @param privateKey - The private key for the account\n   * @throws {Error} If required fields are missing\n   */\n  private validateOptions(accountId?: string, privateKey?: string): void {\n    if (!accountId || !privateKey) {\n      throw new Error('Account ID and private key are required');\n    }\n\n    if (typeof accountId !== 'string') {\n      throw new Error(\n        `Account ID must be a string, received ${typeof accountId}`\n      );\n    }\n\n    if (typeof privateKey !== 'string') {\n      throw new Error(\n        `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(\n          privateKey\n        )}`\n      );\n    }\n\n    if (privateKey.length < 10) {\n      throw new Error('Private key appears to be invalid (too short)');\n    }\n  }\n\n  /**\n   * Prepares the list of plugins to use based on configuration.\n   *\n   * @returns Array of plugins to initialize with the agent\n   */\n  private preparePlugins(): BasePlugin[] {\n    const { additionalPlugins = [], enabledPlugins } = this.options;\n\n    const standardPlugins = [\n      this.hcs10Plugin,\n      this.hcs2Plugin,\n      this.inscribePlugin,\n      this.hbarPlugin,\n    ];\n\n    const corePlugins = getAllHederaCorePlugins();\n\n    if (enabledPlugins) {\n      const enabledSet = new Set(enabledPlugins);\n      const filteredPlugins = [...standardPlugins, ...corePlugins].filter(\n        (plugin) => enabledSet.has(plugin.id)\n      );\n      return [...filteredPlugins, ...additionalPlugins];\n    }\n\n    return [...standardPlugins, ...corePlugins, ...additionalPlugins];\n  }\n\n  /**\n   * Creates the agent configuration object.\n   *\n   * @param serverSigner - The server signer instance\n   * @param llm - The language model instance\n   * @param allPlugins - Array of plugins to use\n   * @returns Configuration object for creating the agent\n   */\n  private createAgentConfig(\n    serverSigner: ServerSigner,\n    llm: ChatOpenAI | ChatAnthropic,\n    allPlugins: BasePlugin[]\n  ): Parameters<typeof createAgent>[0] {\n    const {\n      operationalMode = DEFAULT_OPERATIONAL_MODE,\n      userAccountId,\n      scheduleUserTransactionsInBytesMode,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      verbose = false,\n      mirrorNodeConfig,\n      disableLogging,\n      accountId = '',\n    } = this.options;\n\n    return {\n      framework: 'langchain',\n      signer: serverSigner,\n      execution: {\n        mode: operationalMode === 'autonomous' ? 'direct' : 'bytes',\n        operationalMode: operationalMode,\n        ...(userAccountId && { userAccountId }),\n        ...(scheduleUserTransactionsInBytesMode !== undefined && {\n          scheduleUserTransactionsInBytesMode:\n            scheduleUserTransactionsInBytesMode,\n          scheduleUserTransactions: scheduleUserTransactionsInBytesMode,\n        }),\n      },\n      ai: {\n        provider: new LangChainProvider(llm),\n        temperature: DEFAULT_TEMPERATURE,\n      },\n      filtering: {\n        toolPredicate: (tool: ToolDescriptor): boolean => {\n          if (tool.name === 'hedera-account-transfer-hbar') return false;\n          if (this.options.toolFilter && !this.options.toolFilter(tool)) {\n            return false;\n          }\n          return true;\n        },\n      },\n      messaging: {\n        systemPreamble:\n          customSystemMessagePreamble || getSystemMessage(accountId),\n        ...(customSystemMessagePostamble && {\n          systemPostamble: customSystemMessagePostamble,\n        }),\n        conciseMode: true,\n      },\n      extensions: {\n        plugins: allPlugins,\n        ...(mirrorNodeConfig && {\n          mirrorConfig: mirrorNodeConfig as Record<string, unknown>,\n        }),\n      },\n      ...(this.options.mcpServers && {\n        mcp: {\n          servers: this.options.mcpServers,\n          autoConnect: false,\n        },\n      }),\n      debug: {\n        verbose,\n        silent: disableLogging ?? false,\n      },\n    };\n  }\n\n  /**\n   * Configures the HCS-10 plugin with the state manager.\n   *\n   * @param allPlugins - Array of all plugins\n   */\n  private configureHCS10Plugin(allPlugins: BasePlugin[]): void {\n    const hcs10 = allPlugins.find((p) => p.id === 'hcs-10');\n    if (hcs10) {\n      (\n        hcs10 as BasePlugin & { appConfig?: Record<string, unknown> }\n      ).appConfig = {\n        stateManager: this.stateManager,\n      };\n    }\n  }\n\n  /**\n   * Create a ConversationalAgent with specific plugins enabled\n   */\n  private static withPlugins(\n    options: ConversationalAgentOptions,\n    plugins: string[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: plugins,\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled\n   */\n  static withHTS(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hts-token']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-2 tools enabled\n   */\n  static withHCS2(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-2']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-10 tools enabled\n   */\n  static withHCS10(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only inscription tools enabled\n   */\n  static withInscribe(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only account management tools enabled\n   */\n  static withAccount(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['account']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only file service tools enabled\n   */\n  static withFileService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['file-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only consensus service tools enabled\n   */\n  static withConsensusService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['consensus-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only smart contract tools enabled\n   */\n  static withSmartContract(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['smart-contract']);\n  }\n\n  /**\n   * Create a ConversationalAgent with all HCS standards plugins\n   */\n  static withAllStandards(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10', 'hcs-2', 'inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)\n   */\n  static minimal(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, []);\n  }\n\n  /**\n   * Create a ConversationalAgent with MCP servers configured\n   */\n  static withMCP(\n    options: ConversationalAgentOptions,\n    mcpServers: MCPServerConfig[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      mcpServers,\n    });\n  }\n\n  /**\n   * Extract and store entities from agent responses\n   * @param response - Agent response containing potential entity information\n   * @param originalMessage - Original user message for context\n   */\n  private async extractAndStoreEntities(\n    response: unknown,\n    originalMessage: string\n  ): Promise<void> {\n    if (!this.memoryManager || !this.entityTools) {\n      return;\n    }\n\n    try {\n      this.logger.info('Starting LLM-based entity extraction');\n\n      const responseText = this.extractResponseText(response);\n\n      const entitiesJson = await this.entityTools.extractEntities.call({\n        response: responseText,\n        userMessage: originalMessage,\n      });\n\n      try {\n        const entities = JSON.parse(entitiesJson);\n\n        for (const entity of entities) {\n          if (\n            entity &&\n            typeof entity === 'object' &&\n            'name' in entity &&\n            'type' in entity &&\n            'id' in entity\n          ) {\n            this.logger.info(\n              `Storing entity: ${entity.name} (${entity.type}) -> ${entity.id}`\n            );\n\n            const transactionId = this.extractTransactionId(response);\n            const idStr = String(entity.id);\n            const isHederaId = /^0\\.0\\.[0-9]+$/.test(idStr);\n            if (!isHederaId) {\n              this.logger.warn('Skipping non-ID entity from extraction', {\n                id: idStr,\n                name: String(entity.name),\n                type: String(entity.type),\n              });\n            } else {\n              this.memoryManager.storeEntityAssociation(\n                idStr,\n                String(entity.name),\n                String(entity.type),\n                transactionId\n              );\n            }\n          }\n        }\n\n        if (entities.length > 0) {\n          this.logger.info(\n            `Stored ${entities.length} entities via LLM extraction`\n          );\n        } else {\n          this.logger.info('No entities found in response via LLM extraction');\n        }\n      } catch (parseError) {\n        this.logger.error(\n          'Failed to parse extracted entities JSON:',\n          parseError\n        );\n        throw parseError;\n      }\n    } catch (error) {\n      this.logger.error('Entity extraction failed:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Extract transaction ID from response if available\n   * @param response - Transaction response\n   * @returns Transaction ID or undefined\n   */\n  private extractTransactionId(response: unknown): string | undefined {\n    try {\n      if (\n        typeof response === 'object' &&\n        response &&\n        'transactionId' in response\n      ) {\n        const responseWithTxId = response as { transactionId?: unknown };\n        return typeof responseWithTxId.transactionId === 'string'\n          ? responseWithTxId.transactionId\n          : undefined;\n      }\n      if (typeof response === 'string') {\n        const match = response.match(\n          /transaction[\\s\\w]*ID[\\s:\"]*([0-9a-fA-F@\\.\\-]+)/i\n        );\n        return match ? match[1] : undefined;\n      }\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Connect to MCP servers asynchronously\n   * @private\n   */\n  private connectMCP(): void {\n    if (!this.agent || !this.options.mcpServers) {\n      return;\n    }\n\n    this.agent\n      .connectMCPServers()\n      .catch((e) => {\n        this.logger.error('Failed to connect MCP servers:', e);\n      })\n      .then(() => {\n        this.logger.info('MCP servers connected successfully');\n      });\n  }\n\n  /**\n   * Get MCP connection status for all servers\n   * @returns {Map<string, MCPConnectionStatus>} Connection status map\n   */\n  getMCPConnectionStatus(): Map<string, MCPConnectionStatus> {\n    if (this.agent) {\n      return this.agent.getMCPConnectionStatus();\n    }\n    return new Map();\n  }\n\n  /**\n   * Check if a specific MCP server is connected\n   * @param {string} serverName - Name of the server to check\n   * @returns {boolean} True if connected, false otherwise\n   */\n  isMCPServerConnected(serverName: string): boolean {\n    if (this.agent) {\n      const statusMap = this.agent.getMCPConnectionStatus();\n      const status = statusMap.get(serverName);\n      return status?.connected ?? false;\n    }\n    return false;\n  }\n\n  /**\n   * Clean up resources\n   */\n  async cleanup(): Promise<void> {\n    try {\n      this.logger.info('Cleaning up ConversationalAgent...');\n\n      if (this.memoryManager) {\n        try {\n          this.memoryManager.dispose();\n          this.logger.info('Memory manager cleaned up successfully');\n        } catch (error) {\n          this.logger.warn('Error cleaning up memory manager:', error);\n        }\n        this.memoryManager = undefined;\n      }\n\n      if (this.contentStoreManager) {\n        await this.contentStoreManager.dispose();\n        this.logger.info('ContentStoreManager cleaned up');\n      }\n\n      this.logger.info('ConversationalAgent cleanup completed');\n    } catch (error) {\n      this.logger.error('Error during cleanup:', error);\n    }\n  }\n\n  private extractResponseText(response: unknown): string {\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (response && typeof response === 'object' && 'output' in response) {\n      const responseWithOutput = response as { output: unknown };\n      return String(responseWithOutput.output);\n    }\n\n    return JSON.stringify(response);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index7.js.map

@@ -1 +1 @@
-{"version":3,"file":"index7.js","sources":["../../src/base-agent.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport type { TransactionReceipt } from '@hashgraph/sdk';\nimport {\n  HederaAgentKit,\n  ServerSigner,\n  TokenUsageCallbackHandler,\n  TokenUsage,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport type { CostCalculation } from 'hedera-agent-kit';\nimport type { AIProvider, VercelAIProvider, BAMLProvider } from './providers';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\n\nexport interface ToolFilterConfig {\n  namespaceWhitelist?: string[];\n  toolBlacklist?: string[];\n  toolPredicate?: (tool: StructuredTool) => boolean;\n}\n\nexport type ExecutionMode = 'direct' | 'bytes';\nexport type OperationalMode = 'autonomous' | 'returnBytes';\n\nexport interface HederaAgentConfiguration {\n  signer: ServerSigner;\n  execution?: {\n    mode?: ExecutionMode;\n    operationalMode?: OperationalMode;\n    userAccountId?: string;\n    scheduleUserTransactions?: boolean;\n    scheduleUserTransactionsInBytesMode?: boolean;\n  };\n  ai?: {\n    provider?: AIProvider;\n    llm?: unknown;\n    apiKey?: string;\n    modelName?: string;\n    temperature?: number;\n  };\n  filtering?: ToolFilterConfig;\n  messaging?: {\n    systemPreamble?: string;\n    systemPostamble?: string;\n    conciseMode?: boolean;\n  };\n  extensions?: {\n    plugins?: BasePlugin[];\n    mirrorConfig?: Record<string, unknown>;\n    modelCapability?: string;\n  };\n  mcp?: {\n    servers?: MCPServerConfig[];\n    autoConnect?: boolean;\n  };\n  debug?: {\n    verbose?: boolean;\n    silent?: boolean;\n  };\n}\n\nexport interface ConversationContext {\n  messages: BaseMessage[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ChatResponse {\n  output: string;\n  message?: string;\n  transactionBytes?: string;\n  receipt?: TransactionReceipt | object;\n  scheduleId?: string;\n  transactionId?: string;\n  notes?: string[];\n  error?: string;\n  intermediateSteps?: unknown;\n  rawToolOutput?: unknown;\n  tokenUsage?: TokenUsage;\n  cost?: CostCalculation;\n  metadata?: Record<string, unknown>;\n  tool_calls?: Array<{\n    id: string;\n    name: string;\n    args: Record<string, unknown>;\n    output?: string;\n  }>;\n  formMessage?: unknown;\n  requiresForm?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface UsageStats extends TokenUsage {\n  cost: CostCalculation;\n}\n\nexport abstract class BaseAgent {\n  protected logger: Logger;\n  protected agentKit: HederaAgentKit | undefined;\n  protected tools: StructuredTool[] = [];\n  protected initialized = false;\n  protected tokenTracker: TokenUsageCallbackHandler | undefined;\n\n  constructor(protected config: HederaAgentConfiguration) {\n    this.logger = new Logger({\n      module: 'BaseAgent',\n      silent: config.debug?.silent || false,\n    });\n  }\n\n  abstract boot(): Promise<void>;\n  abstract chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse>;\n  abstract shutdown(): Promise<void>;\n  abstract switchMode(mode: OperationalMode): void;\n  abstract getUsageStats(): UsageStats;\n  abstract getUsageLog(): UsageStats[];\n  abstract clearUsageStats(): void;\n  abstract connectMCPServers(): Promise<void>;\n  abstract getMCPConnectionStatus(): Map<string, MCPConnectionStatus>;\n\n  public getCore(): HederaAgentKit | undefined {\n    return this.agentKit;\n  }\n\n  protected filterTools(tools: StructuredTool[]): StructuredTool[] {\n    let filtered = [...tools];\n    const filter = this.config.filtering;\n\n    if (!filter) return filtered;\n\n    if (filter.namespaceWhitelist?.length) {\n      filtered = filtered.filter((tool) => {\n        const namespace = (tool as StructuredTool & { namespace?: string })\n          .namespace;\n        return !namespace || filter.namespaceWhitelist!.includes(namespace);\n      });\n    }\n\n    if (filter.toolBlacklist?.length) {\n      filtered = filtered.filter(\n        (tool) => !filter.toolBlacklist!.includes(tool.name)\n      );\n    }\n\n    if (filter.toolPredicate) {\n      filtered = filtered.filter(filter.toolPredicate);\n    }\n\n    this.logger.debug(`Filtered tools: ${tools.length} → ${filtered.length}`);\n    return filtered;\n  }\n\n  protected buildSystemPrompt(): string {\n    const parts: string[] = [];\n    const operatorId = this.config.signer.getAccountId().toString();\n    const userAccId = this.config.execution?.userAccountId;\n\n    if (this.config.messaging?.systemPreamble) {\n      parts.push(this.config.messaging.systemPreamble);\n    }\n\n    parts.push(\n      `You are a helpful Hedera assistant. Your primary operator account is ${operatorId}. ` +\n        `You have tools to interact with the Hedera Hashgraph. ` +\n        `When using any tool, provide all necessary parameters as defined by that tool's schema and description.`\n    );\n\n    parts.push(\n      `\\nMETADATA QUALITY PRINCIPLES: When collecting user input for metadata creation across any tool:` +\n        `\\n• Prioritize meaningful, valuable content over technical file information` +\n        `\\n• Focus on attributes that add value for end users and collectors` +\n        `\\n• Avoid auto-generating meaningless technical attributes as user-facing metadata` +\n        `\\n• When fields are missing or inadequate, use forms to collect quality metadata` +\n        `\\n• Encourage descriptive names, collectible traits, and storytelling elements`\n    );\n\n    if (userAccId) {\n      parts.push(\n        `The user you are assisting has a personal Hedera account ID: ${userAccId}. ` +\n          `IMPORTANT: When the user says things like \"I want to send HBAR\" or \"transfer my tokens\", you MUST use ${userAccId} as the sender/from account. ` +\n          `For example, if user says \"I want to send 2 HBAR to 0.0.800\", you must set up a transfer where ${userAccId} sends the HBAR, not your operator account.`\n      );\n    }\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    if (operationalMode === 'autonomous') {\n      parts.push(\n        `\\nOPERATIONAL MODE: 'autonomous'. Your goal is to execute transactions directly using your tools. ` +\n          `Your account ${operatorId} will be the payer for these transactions. ` +\n          `Even if the user's account (${\n            userAccId || 'a specified account'\n          }) is the actor in the transaction body (e.g., sender of HBAR), ` +\n          `you (the agent with operator ${operatorId}) are still executing and paying. For HBAR transfers, ensure the amounts in the 'transfers' array sum to zero (as per tool schema), balancing with your operator account if necessary.`\n      );\n    } else {\n      if (\n        this.config.execution?.scheduleUserTransactionsInBytesMode &&\n        userAccId\n      ) {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes' with scheduled transactions for user actions. ` +\n            `When a user asks for a transaction to be prepared (e.g., creating a token, topic, transferring assets for them to sign, etc), ` +\n            `you MUST default to creating a Scheduled Transaction using the appropriate tool with the metaOption 'schedule: true'. ` +\n            `The user (with account ID ${userAccId}) will be the one to ultimately pay for and (if needed) sign the inner transaction. ` +\n            `Your operator account (${operatorId}) will pay for creating the schedule entity itself. ` +\n            `You MUST return the ScheduleId and details of the scheduled operation in a structured JSON format with these fields: success, op, schedule_id, description, payer_account_id_scheduled_tx, and scheduled_transaction_details.`\n        );\n      } else {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes'. Your goal is to provide transaction bytes when possible. ` +\n            `When a user asks for a transaction to be prepared (e.g., for them to sign, or for scheduling without the default scheduling flow), ` +\n            `you MUST call the appropriate tool. ` +\n            `IMPORTANT: Only use metaOption 'returnBytes: true' for tools that explicitly support it (like HBAR transfers, token operations). ` +\n            `Many tools (inscriptions, HCS-2, HCS-20, etc.) do NOT support returnBytes and will execute directly - this is expected behavior. ` +\n            `For tools without returnBytes support, simply call them with their standard parameters. ` +\n            `If you need raw bytes for the user to sign for their own account ${\n              userAccId || 'if specified'\n            }, ensure the tool constructs the transaction body accordingly when returnBytes IS supported.`\n        );\n      }\n    }\n\n    if (this.config.messaging?.conciseMode !== false) {\n      parts.push(\n        '\\nAlways be concise. If the tool provides a JSON string as its primary output (especially in returnBytes mode), make your accompanying text brief. If the tool does not provide JSON output or an error occurs, your narrative becomes primary; if notes were generated by the tool in such cases, append them to your textual response.'\n      );\n    }\n\n    if (this.config.messaging?.systemPostamble) {\n      parts.push(this.config.messaging.systemPostamble);\n    }\n\n    return parts.join('\\n');\n  }\n\n  isReady(): boolean {\n    return this.initialized;\n  }\n}\n\nexport type { AIProvider, VercelAIProvider, BAMLProvider };\n"],"names":[],"mappings":";AA+FO,MAAe,UAAU;AAAA,EAO9B,YAAsB,QAAkC;AAAlC,SAAA,SAAA;AAJtB,SAAU,QAA0B,CAAA;AACpC,SAAU,cAAc;AAItB,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,QAAQ,OAAO,OAAO,UAAU;AAAA,IAAA,CACjC;AAAA,EACH;AAAA,EAeO,UAAsC;AAC3C,WAAO,KAAK;AAAA,EACd;AAAA,EAEU,YAAY,OAA2C;AAC/D,QAAI,WAAW,CAAC,GAAG,KAAK;AACxB,UAAM,SAAS,KAAK,OAAO;AAE3B,QAAI,CAAC,OAAQ,QAAO;AAEpB,QAAI,OAAO,oBAAoB,QAAQ;AACrC,iBAAW,SAAS,OAAO,CAAC,SAAS;AACnC,cAAM,YAAa,KAChB;AACH,eAAO,CAAC,aAAa,OAAO,mBAAoB,SAAS,SAAS;AAAA,MACpE,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,eAAe,QAAQ;AAChC,iBAAW,SAAS;AAAA,QAClB,CAAC,SAAS,CAAC,OAAO,cAAe,SAAS,KAAK,IAAI;AAAA,MAAA;AAAA,IAEvD;AAEA,QAAI,OAAO,eAAe;AACxB,iBAAW,SAAS,OAAO,OAAO,aAAa;AAAA,IACjD;AAEA,SAAK,OAAO,MAAM,mBAAmB,MAAM,MAAM,MAAM,SAAS,MAAM,EAAE;AACxE,WAAO;AAAA,EACT;AAAA,EAEU,oBAA4B;AACpC,UAAM,QAAkB,CAAA;AACxB,UAAM,aAAa,KAAK,OAAO,OAAO,aAAA,EAAe,SAAA;AACrD,UAAM,YAAY,KAAK,OAAO,WAAW;AAEzC,QAAI,KAAK,OAAO,WAAW,gBAAgB;AACzC,YAAM,KAAK,KAAK,OAAO,UAAU,cAAc;AAAA,IACjD;AAEA,UAAM;AAAA,MACJ,wEAAwE,UAAU;AAAA,IAAA;AAKpF,UAAM;AAAA,MACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAA;AAQF,QAAI,WAAW;AACb,YAAM;AAAA,QACJ,gEAAgE,SAAS,2GACkC,SAAS,+HAChB,SAAS;AAAA,MAAA;AAAA,IAEjH;AAEA,UAAM,kBACJ,KAAK,OAAO,WAAW,mBAAmB;AAC5C,QAAI,oBAAoB,cAAc;AACpC,YAAM;AAAA,QACJ;AAAA,+GACkB,UAAU,0EAExB,aAAa,qBACf,+FACgC,UAAU;AAAA,MAAA;AAAA,IAEhD,OAAO;AACL,UACE,KAAK,OAAO,WAAW,uCACvB,WACA;AACA,cAAM;AAAA,UACJ;AAAA,8VAG+B,SAAS,8GACZ,UAAU;AAAA,QAAA;AAAA,MAG1C,OAAO;AACL,cAAM;AAAA,UACJ;AAAA,8pBAOI,aAAa,cACf;AAAA,QAAA;AAAA,MAEN;AAAA,IACF;AAEA,QAAI,KAAK,OAAO,WAAW,gBAAgB,OAAO;AAChD,YAAM;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,KAAK,OAAO,WAAW,iBAAiB;AAC1C,YAAM,KAAK,KAAK,OAAO,UAAU,eAAe;AAAA,IAClD;AAEA,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AACF;"}
+{"version":3,"file":"index7.js","sources":["../../src/base-agent.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport type { TransactionReceipt } from '@hashgraph/sdk';\nimport {\n  HederaAgentKit,\n  ServerSigner,\n  TokenUsageCallbackHandler,\n  TokenUsage,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport type { CostCalculation } from 'hedera-agent-kit';\nimport type { AIProvider, VercelAIProvider, BAMLProvider } from './providers';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\nimport type { FormSubmission } from './forms/types';\n\nexport interface ToolFilterConfig {\n  namespaceWhitelist?: string[];\n  toolBlacklist?: string[];\n  toolPredicate?: (tool: StructuredTool) => boolean;\n}\n\nexport type ExecutionMode = 'direct' | 'bytes';\nexport type OperationalMode = 'autonomous' | 'returnBytes';\n\nexport interface HederaAgentConfiguration {\n  signer: ServerSigner;\n  execution?: {\n    mode?: ExecutionMode;\n    operationalMode?: OperationalMode;\n    userAccountId?: string;\n    scheduleUserTransactions?: boolean;\n    scheduleUserTransactionsInBytesMode?: boolean;\n  };\n  ai?: {\n    provider?: AIProvider;\n    llm?: unknown;\n    apiKey?: string;\n    modelName?: string;\n    temperature?: number;\n  };\n  filtering?: ToolFilterConfig;\n  messaging?: {\n    systemPreamble?: string;\n    systemPostamble?: string;\n    conciseMode?: boolean;\n  };\n  extensions?: {\n    plugins?: BasePlugin[];\n    mirrorConfig?: Record<string, unknown>;\n    modelCapability?: string;\n  };\n  mcp?: {\n    servers?: MCPServerConfig[];\n    autoConnect?: boolean;\n  };\n  debug?: {\n    verbose?: boolean;\n    silent?: boolean;\n  };\n}\n\nexport interface ConversationContext {\n  messages: BaseMessage[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ChatResponse {\n  output: string;\n  message?: string;\n  transactionBytes?: string;\n  receipt?: TransactionReceipt | object;\n  scheduleId?: string;\n  transactionId?: string;\n  notes?: string[];\n  error?: string;\n  intermediateSteps?: unknown;\n  rawToolOutput?: unknown;\n  tokenUsage?: TokenUsage;\n  cost?: CostCalculation;\n  metadata?: Record<string, unknown>;\n  tool_calls?: Array<{\n    id: string;\n    name: string;\n    args: Record<string, unknown>;\n    output?: string;\n  }>;\n  formMessage?: unknown;\n  requiresForm?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface UsageStats extends TokenUsage {\n  cost: CostCalculation;\n}\n\nexport abstract class BaseAgent {\n  protected logger: Logger;\n  protected agentKit: HederaAgentKit | undefined;\n  protected tools: StructuredTool[] = [];\n  protected initialized = false;\n  protected tokenTracker: TokenUsageCallbackHandler | undefined;\n\n  constructor(protected config: HederaAgentConfiguration) {\n    this.logger = new Logger({\n      module: 'BaseAgent',\n      silent: config.debug?.silent || false,\n    });\n  }\n\n  abstract boot(): Promise<void>;\n  abstract chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse>;\n  abstract processFormSubmission(\n    submission: FormSubmission\n  ): Promise<ChatResponse>;\n  abstract shutdown(): Promise<void>;\n  abstract switchMode(mode: OperationalMode): void;\n  abstract getUsageStats(): UsageStats;\n  abstract getUsageLog(): UsageStats[];\n  abstract clearUsageStats(): void;\n  abstract connectMCPServers(): Promise<void>;\n  abstract getMCPConnectionStatus(): Map<string, MCPConnectionStatus>;\n\n  public getCore(): HederaAgentKit | undefined {\n    return this.agentKit;\n  }\n\n  protected filterTools(tools: StructuredTool[]): StructuredTool[] {\n    let filtered = [...tools];\n    const filter = this.config.filtering;\n\n    if (!filter) return filtered;\n\n    if (filter.namespaceWhitelist?.length) {\n      filtered = filtered.filter((tool) => {\n        const namespace = (tool as StructuredTool & { namespace?: string })\n          .namespace;\n        return !namespace || filter.namespaceWhitelist!.includes(namespace);\n      });\n    }\n\n    if (filter.toolBlacklist?.length) {\n      filtered = filtered.filter(\n        (tool) => !filter.toolBlacklist!.includes(tool.name)\n      );\n    }\n\n    if (filter.toolPredicate) {\n      filtered = filtered.filter(filter.toolPredicate);\n    }\n\n    this.logger.debug(`Filtered tools: ${tools.length} → ${filtered.length}`);\n    return filtered;\n  }\n\n  protected buildSystemPrompt(): string {\n    const parts: string[] = [];\n    const operatorId = this.config.signer.getAccountId().toString();\n    const userAccId = this.config.execution?.userAccountId;\n\n    if (this.config.messaging?.systemPreamble) {\n      parts.push(this.config.messaging.systemPreamble);\n    }\n\n    parts.push(\n      `You are a helpful Hedera assistant. Your primary operator account is ${operatorId}. ` +\n        `You have tools to interact with the Hedera Hashgraph. ` +\n        `When using any tool, provide all necessary parameters as defined by that tool's schema and description.`\n    );\n\n    parts.push(\n      `\\nMETADATA QUALITY PRINCIPLES: When collecting user input for metadata creation across any tool:` +\n        `\\n• Prioritize meaningful, valuable content over technical file information` +\n        `\\n• Focus on attributes that add value for end users and collectors` +\n        `\\n• Avoid auto-generating meaningless technical attributes as user-facing metadata` +\n        `\\n• When fields are missing or inadequate, use forms to collect quality metadata` +\n        `\\n• Encourage descriptive names, collectible traits, and storytelling elements`\n    );\n\n    if (userAccId) {\n      parts.push(\n        `The user you are assisting has a personal Hedera account ID: ${userAccId}. ` +\n          `IMPORTANT: When the user says things like \"I want to send HBAR\" or \"transfer my tokens\", you MUST use ${userAccId} as the sender/from account. ` +\n          `For example, if user says \"I want to send 2 HBAR to 0.0.800\", you must set up a transfer where ${userAccId} sends the HBAR, not your operator account.`\n      );\n    }\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    if (operationalMode === 'autonomous') {\n      parts.push(\n        `\\nOPERATIONAL MODE: 'autonomous'. Your goal is to execute transactions directly using your tools. ` +\n          `Your account ${operatorId} will be the payer for these transactions. ` +\n          `Even if the user's account (${\n            userAccId || 'a specified account'\n          }) is the actor in the transaction body (e.g., sender of HBAR), ` +\n          `you (the agent with operator ${operatorId}) are still executing and paying. For HBAR transfers, ensure the amounts in the 'transfers' array sum to zero (as per tool schema), balancing with your operator account if necessary.`\n      );\n    } else {\n      if (\n        this.config.execution?.scheduleUserTransactionsInBytesMode &&\n        userAccId\n      ) {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes' with scheduled transactions for user actions. ` +\n            `When a user asks for a transaction to be prepared (e.g., creating a token, topic, transferring assets for them to sign, etc), ` +\n            `you MUST default to creating a Scheduled Transaction using the appropriate tool with the metaOption 'schedule: true'. ` +\n            `The user (with account ID ${userAccId}) will be the one to ultimately pay for and (if needed) sign the inner transaction. ` +\n            `Your operator account (${operatorId}) will pay for creating the schedule entity itself. ` +\n            `You MUST return the ScheduleId and details of the scheduled operation in a structured JSON format with these fields: success, op, schedule_id, description, payer_account_id_scheduled_tx, and scheduled_transaction_details.`\n        );\n      } else {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes'. Your goal is to provide transaction bytes when possible. ` +\n            `When a user asks for a transaction to be prepared (e.g., for them to sign, or for scheduling without the default scheduling flow), ` +\n            `you MUST call the appropriate tool. ` +\n            `IMPORTANT: Only use metaOption 'returnBytes: true' for tools that explicitly support it (like HBAR transfers, token operations). ` +\n            `Many tools (inscriptions, HCS-2, HCS-20, etc.) do NOT support returnBytes and will execute directly - this is expected behavior. ` +\n            `For tools without returnBytes support, simply call them with their standard parameters. ` +\n            `If you need raw bytes for the user to sign for their own account ${\n              userAccId || 'if specified'\n            }, ensure the tool constructs the transaction body accordingly when returnBytes IS supported.`\n        );\n      }\n    }\n\n    if (this.config.messaging?.conciseMode !== false) {\n      parts.push(\n        '\\nAlways be concise. If the tool provides a JSON string as its primary output (especially in returnBytes mode), make your accompanying text brief. If the tool does not provide JSON output or an error occurs, your narrative becomes primary; if notes were generated by the tool in such cases, append them to your textual response.'\n      );\n    }\n\n    if (this.config.messaging?.systemPostamble) {\n      parts.push(this.config.messaging.systemPostamble);\n    }\n\n    return parts.join('\\n');\n  }\n\n  isReady(): boolean {\n    return this.initialized;\n  }\n}\n\nexport type { AIProvider, VercelAIProvider, BAMLProvider };\n"],"names":[],"mappings":";AAgGO,MAAe,UAAU;AAAA,EAO9B,YAAsB,QAAkC;AAAlC,SAAA,SAAA;AAJtB,SAAU,QAA0B,CAAA;AACpC,SAAU,cAAc;AAItB,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,QAAQ,OAAO,OAAO,UAAU;AAAA,IAAA,CACjC;AAAA,EACH;AAAA,EAkBO,UAAsC;AAC3C,WAAO,KAAK;AAAA,EACd;AAAA,EAEU,YAAY,OAA2C;AAC/D,QAAI,WAAW,CAAC,GAAG,KAAK;AACxB,UAAM,SAAS,KAAK,OAAO;AAE3B,QAAI,CAAC,OAAQ,QAAO;AAEpB,QAAI,OAAO,oBAAoB,QAAQ;AACrC,iBAAW,SAAS,OAAO,CAAC,SAAS;AACnC,cAAM,YAAa,KAChB;AACH,eAAO,CAAC,aAAa,OAAO,mBAAoB,SAAS,SAAS;AAAA,MACpE,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,eAAe,QAAQ;AAChC,iBAAW,SAAS;AAAA,QAClB,CAAC,SAAS,CAAC,OAAO,cAAe,SAAS,KAAK,IAAI;AAAA,MAAA;AAAA,IAEvD;AAEA,QAAI,OAAO,eAAe;AACxB,iBAAW,SAAS,OAAO,OAAO,aAAa;AAAA,IACjD;AAEA,SAAK,OAAO,MAAM,mBAAmB,MAAM,MAAM,MAAM,SAAS,MAAM,EAAE;AACxE,WAAO;AAAA,EACT;AAAA,EAEU,oBAA4B;AACpC,UAAM,QAAkB,CAAA;AACxB,UAAM,aAAa,KAAK,OAAO,OAAO,aAAA,EAAe,SAAA;AACrD,UAAM,YAAY,KAAK,OAAO,WAAW;AAEzC,QAAI,KAAK,OAAO,WAAW,gBAAgB;AACzC,YAAM,KAAK,KAAK,OAAO,UAAU,cAAc;AAAA,IACjD;AAEA,UAAM;AAAA,MACJ,wEAAwE,UAAU;AAAA,IAAA;AAKpF,UAAM;AAAA,MACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAA;AAQF,QAAI,WAAW;AACb,YAAM;AAAA,QACJ,gEAAgE,SAAS,2GACkC,SAAS,+HAChB,SAAS;AAAA,MAAA;AAAA,IAEjH;AAEA,UAAM,kBACJ,KAAK,OAAO,WAAW,mBAAmB;AAC5C,QAAI,oBAAoB,cAAc;AACpC,YAAM;AAAA,QACJ;AAAA,+GACkB,UAAU,0EAExB,aAAa,qBACf,+FACgC,UAAU;AAAA,MAAA;AAAA,IAEhD,OAAO;AACL,UACE,KAAK,OAAO,WAAW,uCACvB,WACA;AACA,cAAM;AAAA,UACJ;AAAA,8VAG+B,SAAS,8GACZ,UAAU;AAAA,QAAA;AAAA,MAG1C,OAAO;AACL,cAAM;AAAA,UACJ;AAAA,8pBAOI,aAAa,cACf;AAAA,QAAA;AAAA,MAEN;AAAA,IACF;AAEA,QAAI,KAAK,OAAO,WAAW,gBAAgB,OAAO;AAChD,YAAM;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,KAAK,OAAO,WAAW,iBAAiB;AAC1C,YAAM,KAAK,KAAK,OAAO,UAAU,eAAe;AAAA,IAClD;AAEA,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AACF;"}

package/dist/types/base-agent.d.ts

@@ -5,6 +5,7 @@ import { HederaAgentKit, ServerSigner, TokenUsageCallbackHandler, TokenUsage, Ba
 import { AIProvider, VercelAIProvider, BAMLProvider } from './providers';
 import { Logger } from '@hashgraphonline/standards-sdk';
 import { MCPServerConfig, MCPConnectionStatus } from './mcp/types';
+import { FormSubmission } from './forms/types';
 
 export interface ToolFilterConfig {
     namespaceWhitelist?: string[];
@@ -90,6 +91,7 @@ export declare abstract class BaseAgent {
     constructor(config: HederaAgentConfiguration);
     abstract boot(): Promise<void>;
     abstract chat(message: string, context?: ConversationContext): Promise<ChatResponse>;
+    abstract processFormSubmission(submission: FormSubmission): Promise<ChatResponse>;
     abstract shutdown(): Promise<void>;
     abstract switchMode(mode: OperationalMode): void;
     abstract getUsageStats(): UsageStats;

package/dist/types/langchain/form-aware-agent-executor.d.ts

@@ -5,15 +5,18 @@ import { ChainValues } from '@langchain/core/utils/types';
 import { CallbackManagerForChainRun } from '@langchain/core/callbacks/manager';
 import { RunnableConfig } from '@langchain/core/runnables';
 
+interface ToolWithOriginal {
+    originalTool?: {
+        call?: (args: Record<string, unknown>) => Promise<string>;
+    };
+}
 interface PendingFormData {
     toolName: string;
     originalInput: unknown;
     originalToolInput?: unknown;
     schema: unknown;
     toolRef?: ToolInterface | undefined;
-    originalToolRef?: {
-        call?: (args: Record<string, unknown>) => Promise<string>;
-    } | undefined;
+    originalToolRef?: ToolWithOriginal['originalTool'];
 }
 /**
  * Parameter preprocessing callback interface