@hashgraphonline/conversational-agent 0.2.103 → 0.2.106

package/dist/esm/index45.js.map

@@ -1 +1 @@
-{"version":3,"file":"index45.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":"index45.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/index46.js

@@ -0,0 +1,30 @@
+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 {
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
+};
+//# sourceMappingURL=index46.js.map

package/dist/esm/index46.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index46.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/index47.js

@@ -0,0 +1,95 @@
+import { TransferTransaction, AccountId, Hbar } from "@hashgraph/sdk";
+import BigNumber from "bignumber.js";
+import { BaseServiceBuilder } from "hedera-agent-kit";
+class AccountBuilder extends BaseServiceBuilder {
+  constructor(hederaKit) {
+    super(hederaKit);
+  }
+  /**
+   * Transfers HBAR between accounts with proper decimal handling
+   */
+  transferHbar(params, isUserInitiated = true) {
+    this.clearNotes();
+    const transaction = new TransferTransaction();
+    if (!params.transfers || params.transfers.length === 0) {
+      throw new Error("HbarTransferParams must include at least one transfer.");
+    }
+    let netZeroInTinybars = new BigNumber(0);
+    let userTransferProcessedForScheduling = false;
+    if (isUserInitiated && this.kit.userAccountId && this.kit.operationalMode === "provideBytes" && params.transfers.length === 1) {
+      const receiverTransfer = params.transfers[0];
+      const amountValue = typeof receiverTransfer.amount === "string" || typeof receiverTransfer.amount === "number" ? receiverTransfer.amount : receiverTransfer.amount.toString();
+      const amountBigNum = new BigNumber(amountValue);
+      if (amountBigNum.isPositive()) {
+        const recipientAccountId = typeof receiverTransfer.accountId === "string" ? AccountId.fromString(receiverTransfer.accountId) : receiverTransfer.accountId;
+        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
+        const sdkHbarAmount = Hbar.fromString(roundedAmount);
+        this.logger.info(
+          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${this.kit.userAccountId} to ${recipientAccountId.toString()}`
+        );
+        this.addNote(
+          `Configured HBAR transfer from your account (${this.kit.userAccountId}) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`
+        );
+        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);
+        transaction.addHbarTransfer(
+          AccountId.fromString(this.kit.userAccountId),
+          sdkHbarAmount.negated()
+        );
+        userTransferProcessedForScheduling = true;
+      }
+    }
+    if (!userTransferProcessedForScheduling) {
+      const processedTransfers = [];
+      for (const transferInput of params.transfers) {
+        const accountId = typeof transferInput.accountId === "string" ? AccountId.fromString(transferInput.accountId) : transferInput.accountId;
+        const amountValue = typeof transferInput.amount === "string" || typeof transferInput.amount === "number" ? transferInput.amount : transferInput.amount.toString();
+        const amountBigNum = new BigNumber(amountValue);
+        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
+        this.logger.info(
+          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`
+        );
+        const sdkHbarAmount = Hbar.fromString(roundedAmount);
+        processedTransfers.push({
+          accountId,
+          amount: amountBigNum,
+          hbar: sdkHbarAmount
+        });
+        const tinybarsContribution = sdkHbarAmount.toTinybars();
+        netZeroInTinybars = netZeroInTinybars.plus(
+          tinybarsContribution.toString()
+        );
+      }
+      if (!netZeroInTinybars.isZero()) {
+        this.logger.warn(
+          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`
+        );
+        if (processedTransfers.length > 0) {
+          const lastTransfer = processedTransfers[processedTransfers.length - 1];
+          const adjustment = netZeroInTinybars.dividedBy(-1e8);
+          const adjustedAmount = lastTransfer.amount.plus(adjustment);
+          const adjustedRounded = adjustedAmount.toFixed(8, BigNumber.ROUND_DOWN);
+          lastTransfer.hbar = Hbar.fromString(adjustedRounded);
+          this.logger.info(
+            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`
+          );
+        }
+      }
+      for (const transfer of processedTransfers) {
+        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);
+      }
+    }
+    if (typeof params.memo !== "undefined") {
+      if (params.memo === null) {
+        this.logger.warn("Received null for memo in transferHbar.");
+      } else {
+        transaction.setTransactionMemo(params.memo);
+      }
+    }
+    this.setCurrentTransaction(transaction);
+    return this;
+  }
+}
+export {
+  AccountBuilder
+};
+//# sourceMappingURL=index47.js.map

package/dist/esm/index47.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index47.js","sources":["../../src/plugins/hbar/AccountBuilder.ts"],"sourcesContent":["import {\n  AccountId,\n  Hbar,\n  TransferTransaction,\n} from '@hashgraph/sdk';\nimport BigNumber from 'bignumber.js';\nimport { HederaAgentKit, BaseServiceBuilder } from 'hedera-agent-kit';\nimport { HbarTransferParams } from './types';\n\n/**\n * Custom AccountBuilder that properly handles HBAR decimal conversion\n */\nexport class AccountBuilder extends BaseServiceBuilder {\n  constructor(hederaKit: HederaAgentKit) {\n    super(hederaKit);\n  }\n\n  /**\n   * Transfers HBAR between accounts with proper decimal handling\n   */\n  public transferHbar(\n    params: HbarTransferParams,\n    isUserInitiated: boolean = true\n  ): this {\n    this.clearNotes();\n    const transaction = new TransferTransaction();\n    \n    if (!params.transfers || params.transfers.length === 0) {\n      throw new Error('HbarTransferParams must include at least one transfer.');\n    }\n\n    let netZeroInTinybars = new BigNumber(0);\n    let userTransferProcessedForScheduling = false;\n\n    if (\n      isUserInitiated &&\n      this.kit.userAccountId &&\n      (this.kit.operationalMode as string) === 'provideBytes' &&\n      params.transfers.length === 1\n    ) {\n      const receiverTransfer = params.transfers[0];\n      const amountValue =\n        typeof receiverTransfer.amount === 'string' ||\n        typeof receiverTransfer.amount === 'number'\n          ? receiverTransfer.amount\n          : receiverTransfer.amount.toString();\n\n      const amountBigNum = new BigNumber(amountValue);\n\n      if (amountBigNum.isPositive()) {\n        const recipientAccountId =\n          typeof receiverTransfer.accountId === 'string'\n            ? AccountId.fromString(receiverTransfer.accountId)\n            : receiverTransfer.accountId;\n\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n\n        this.logger.info(\n          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${\n            this.kit.userAccountId\n          } to ${recipientAccountId.toString()}`\n        );\n        \n        this.addNote(\n          `Configured HBAR transfer from your account (${\n            this.kit.userAccountId\n          }) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`\n        );\n\n        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);\n        transaction.addHbarTransfer(\n          AccountId.fromString(this.kit.userAccountId),\n          sdkHbarAmount.negated()\n        );\n\n        userTransferProcessedForScheduling = true;\n      }\n    }\n\n    if (!userTransferProcessedForScheduling) {\n      const processedTransfers: Array<{\n        accountId: AccountId;\n        amount: BigNumber;\n        hbar: Hbar;\n      }> = [];\n      \n      for (const transferInput of params.transfers) {\n        const accountId =\n          typeof transferInput.accountId === 'string'\n            ? AccountId.fromString(transferInput.accountId)\n            : transferInput.accountId;\n\n        const amountValue =\n          typeof transferInput.amount === 'string' ||\n          typeof transferInput.amount === 'number'\n            ? transferInput.amount\n            : transferInput.amount.toString();\n\n        const amountBigNum = new BigNumber(amountValue);\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n        \n        this.logger.info(\n          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`\n        );\n\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n        processedTransfers.push({\n          accountId,\n          amount: amountBigNum,\n          hbar: sdkHbarAmount\n        });\n\n        const tinybarsContribution = sdkHbarAmount.toTinybars();\n        netZeroInTinybars = netZeroInTinybars.plus(\n          tinybarsContribution.toString()\n        );\n      }\n\n      if (!netZeroInTinybars.isZero()) {\n        this.logger.warn(\n          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`\n        );\n        \n        if (processedTransfers.length > 0) {\n          const lastTransfer = processedTransfers[processedTransfers.length - 1];\n          const adjustment = netZeroInTinybars.dividedBy(-100000000);\n          const adjustedAmount = lastTransfer.amount.plus(adjustment);\n          const adjustedRounded = adjustedAmount.toFixed(8, BigNumber.ROUND_DOWN);\n          lastTransfer.hbar = Hbar.fromString(adjustedRounded);\n          \n          this.logger.info(\n            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`\n          );\n        }\n      }\n      \n      for (const transfer of processedTransfers) {\n        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);\n      }\n    }\n\n    if (typeof params.memo !== 'undefined') {\n      if (params.memo === null) {\n        this.logger.warn('Received null for memo in transferHbar.');\n      } else {\n        transaction.setTransactionMemo(params.memo);\n      }\n    }\n\n    this.setCurrentTransaction(transaction);\n    return this;\n  }\n}"],"names":[],"mappings":"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"}

package/dist/esm/index5.js

@@ -1,6 +1,6 @@
 import { BasePlugin, HederaAirdropTokenTool } from "hedera-agent-kit";
-import { TransferHbarTool } from "./index36.js";
-import { AirdropToolWrapper } from "./index37.js";
+import { TransferHbarTool } from "./index37.js";
+import { AirdropToolWrapper } from "./index38.js";
 class HbarPlugin extends BasePlugin {
   constructor() {
     super(...arguments);

package/dist/esm/index6.js

@@ -1,17 +1,18 @@
 import { ServerSigner, getAllHederaCorePlugins } from "hedera-agent-kit";
 import { Logger } from "@hashgraphonline/standards-sdk";
 import { createAgent } from "./index8.js";
+import { BrowserSigner } from "./index39.js";
 import { LangChainProvider } from "./index9.js";
 import { ChatOpenAI } from "@langchain/openai";
-import OpenAI from "openai";
 import { ChatAnthropic } from "@langchain/anthropic";
 import { SystemMessage, HumanMessage, AIMessage } from "@langchain/core/messages";
 import { HCS10Plugin } from "./index2.js";
 import { HCS2Plugin } from "./index3.js";
 import { InscribePlugin } from "./index4.js";
+import { getWalletBridgeProvider } from "./index36.js";
+import { OpenConvaiState, InscriberBuilder } from "@hashgraphonline/standards-agent-kit";
 import { HbarPlugin } from "./index5.js";
-import { OpenConvaiState } from "@hashgraphonline/standards-agent-kit";
-import { getSystemMessage } from "./index38.js";
+import { getSystemMessage } from "./index40.js";
 import { ContentStoreManager } from "./index24.js";
 import { SmartMemoryManager } from "./index18.js";
 import "./index19.js";
@@ -19,7 +20,14 @@ import "./index20.js";
 import "./index21.js";
 import "crypto";
 import { createEntityTools } from "./index34.js";
+import { ParameterService } from "./index29.js";
+import { FormatConverterRegistry } from "./index25.js";
+import { TopicIdToHrlConverter } from "./index27.js";
+import { StringNormalizationConverter } from "./index28.js";
 const DEFAULT_MODEL_NAME = "gpt-4o";
+const DEFAULT_OPENAI_MODEL = "gpt-4o-mini";
+const DEFAULT_OPENROUTER_MODEL = "openai/gpt-4o-mini";
+const DEFAULT_CLAUDE_MODEL = "claude-3-7-sonnet-latest";
 const DEFAULT_TEMPERATURE = 0.1;
 const DEFAULT_NETWORK = "testnet";
 const DEFAULT_OPERATIONAL_MODE = "autonomous";
@@ -46,7 +54,16 @@ const _ConversationalAgent = class _ConversationalAgent {
       );
       this.logger.info("Entity memory initialized");
       const provider = options.entityMemoryProvider || options.llmProvider || "openai";
-      const modelName = options.entityMemoryModelName || (provider === "anthropic" ? "claude-3-7-sonnet-latest" : provider === "openrouter" ? "openai/gpt-4o-mini" : "gpt-4o-mini");
+      let modelName = options.entityMemoryModelName;
+      if (!modelName) {
+        if (provider === "anthropic") {
+          modelName = DEFAULT_CLAUDE_MODEL;
+        } else if (provider === "openrouter") {
+          modelName = DEFAULT_OPENROUTER_MODEL;
+        } else {
+          modelName = DEFAULT_OPENAI_MODEL;
+        }
+      }
       let resolverLLM;
       if (provider === "anthropic") {
         resolverLLM = new ChatAnthropic({
@@ -57,19 +74,17 @@ const _ConversationalAgent = class _ConversationalAgent {
       } else if (provider === "openrouter") {
         const baseURL = options.openRouterBaseURL || "https://openrouter.ai/api/v1";
         const apiKey = options.openRouterApiKey || options.openAIApiKey;
-        const client = new OpenAI({
-          apiKey,
-          baseURL,
-          defaultHeaders: {
-            Referer: process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
-          }
-        });
         resolverLLM = new ChatOpenAI({
-          client,
+          apiKey,
           model: modelName,
-          temperature: 0
+          temperature: 0,
+          configuration: {
+            baseURL,
+            defaultHeaders: {
+              "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
+              "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
+            }
+          }
         });
       } else {
         resolverLLM = new ChatOpenAI({
@@ -98,41 +113,108 @@ const _ConversationalAgent = class _ConversationalAgent {
     } = this.options;
     this.validateOptions(accountId, privateKey);
     try {
-      const serverSigner = new ServerSigner(
-        accountId,
-        privateKey,
-        network
-      );
+      const opMode = this.options.operationalMode || DEFAULT_OPERATIONAL_MODE;
+      const bytesMode = opMode !== "autonomous";
+      let signer;
+      try {
+        const IB = InscriberBuilder;
+        if (typeof IB.setPreferWalletOnly === "function") {
+          IB.setPreferWalletOnly(bytesMode);
+        }
+      } catch (e) {
+        this.logger.warn("Failed to set wallet-only preference", e);
+      }
+      if (!bytesMode) {
+        signer = new ServerSigner(accountId, privateKey, network);
+      } else {
+        const chain = String(network || "testnet") === "mainnet" ? "mainnet" : "testnet";
+        const effectiveAccount = this.options.userAccountId || accountId;
+        signer = new BrowserSigner(effectiveAccount, chain, this.options.walletExecutor);
+      }
+      this.logger.info("Signer configured", {
+        operationalMode: opMode,
+        bytesMode,
+        signerClass: Object.getPrototypeOf(signer)?.constructor?.name || "unknown"
+      });
+      try {
+        const bridge = getWalletBridgeProvider();
+        if (bridge) {
+          const IB = InscriberBuilder;
+          if (typeof IB.setWalletInfoResolver === "function") {
+            IB.setWalletInfoResolver(async () => {
+              const status = await bridge.status();
+              if (status.connected && status.accountId && status.network) {
+                return { accountId: status.accountId, network: status.network };
+              }
+              return null;
+            });
+          }
+          if (typeof IB.setWalletExecutor === "function") {
+            IB.setWalletExecutor(async (base64, network2) => {
+              return await bridge.executeBytes(base64, network2);
+            });
+          }
+          if (typeof IB.setStartInscriptionDelegate === "function" && bridge.startInscription) {
+            IB.setStartInscriptionDelegate(async (request, network2) => {
+              return await bridge.startInscription(request, network2);
+            });
+          }
+          try {
+            const sak = await import("@hashgraphonline/standards-agent-kit");
+            const reg = sak?.SignerProviderRegistry;
+            if (reg) {
+              reg.setWalletInfoResolver(async () => {
+                const status = await bridge.status();
+                if (status.connected && status.accountId && status.network) {
+                  return { accountId: status.accountId, network: status.network };
+                }
+                return null;
+              });
+              reg.setWalletExecutor(async (base64, network2) => {
+                return await bridge.executeBytes(base64, network2);
+              });
+              if (typeof bridge.startHCS === "function") {
+                reg.setStartHCSDelegate(async (op, request, network2) => {
+                  return await bridge.startHCS(op, request, network2);
+                });
+              }
+              reg.setPreferWalletOnly(!!bytesMode);
+            }
+          } catch (sakWireErr) {
+            this.logger.warn("Failed to wire SAK SignerProviderRegistry wallet delegates", sakWireErr);
+          }
+        }
+      } catch (e) {
+        this.logger.warn("Failed to register wallet bridge providers", e);
+      }
       let llm;
       let providerInfo = { provider: llmProvider };
       if (llmProvider === "anthropic") {
         llm = new ChatAnthropic({
           apiKey: openAIApiKey,
-          model: openAIModelName || "claude-3-7-sonnet-latest",
+          model: openAIModelName || DEFAULT_CLAUDE_MODEL,
           temperature: DEFAULT_TEMPERATURE
         });
         providerInfo = {
           ...providerInfo,
-          model: openAIModelName || "claude-3-7-sonnet-latest",
+          model: openAIModelName || DEFAULT_CLAUDE_MODEL,
           keyPresent: !!openAIApiKey
         };
       } else if (llmProvider === "openrouter") {
         const baseURL = this.options.openRouterBaseURL || "https://openrouter.ai/api/v1";
         const apiKey = this.options.openRouterApiKey || openAIApiKey;
         const modelName = openAIModelName || "anthropic/claude-3-haiku-20240307";
-        const client = new OpenAI({
-          apiKey,
-          baseURL,
-          defaultHeaders: {
-            Referer: process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
-          }
-        });
         llm = new ChatOpenAI({
-          client,
+          apiKey,
           model: modelName,
-          temperature: DEFAULT_TEMPERATURE
+          temperature: DEFAULT_TEMPERATURE,
+          configuration: {
+            baseURL,
+            defaultHeaders: {
+              "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
+              "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
+            }
+          }
         });
         providerInfo = {
           ...providerInfo,
@@ -141,16 +223,16 @@ const _ConversationalAgent = class _ConversationalAgent {
           keyPresent: !!apiKey
         };
       } else {
-        const modelName = openAIModelName || "gpt-4o-mini";
-        const isGPT5Model = modelName.toLowerCase().includes("gpt-5") || modelName.toLowerCase().includes("gpt5");
+        const modelName2 = openAIModelName || DEFAULT_OPENAI_MODEL;
+        const isGPT5Model = modelName2.toLowerCase().includes("gpt-5") || modelName2.toLowerCase().includes("gpt5");
         llm = new ChatOpenAI({
           apiKey: openAIApiKey,
-          model: modelName,
+          model: modelName2,
           ...isGPT5Model ? { temperature: 1 } : { temperature: DEFAULT_TEMPERATURE }
         });
         providerInfo = {
           ...providerInfo,
-          model: modelName,
+          model: modelName2,
           keyPresent: !!openAIApiKey
         };
       }
@@ -158,7 +240,7 @@ const _ConversationalAgent = class _ConversationalAgent {
       this.logger.info("Preparing plugins...");
       const allPlugins = this.preparePlugins();
       this.logger.info("Creating agent config...");
-      const agentConfig = this.createAgentConfig(serverSigner, llm, allPlugins);
+      const agentConfig = this.createAgentConfig(signer, llm, allPlugins);
       this.logger.info("Creating agent...");
       this.agent = createAgent(agentConfig);
       this.logger.info("Agent created");
@@ -176,6 +258,26 @@ const _ConversationalAgent = class _ConversationalAgent {
       this.logger.info("agent.boot() completed");
       this.logger.info("🔥 agent.boot() completed");
       if (this.agent) {
+        try {
+          const registry = new FormatConverterRegistry();
+          registry.register(new TopicIdToHrlConverter());
+          registry.register(new StringNormalizationConverter());
+          const paramService = new ParameterService(
+            registry,
+            this.options.network || "testnet"
+          );
+          paramService.attachToAgent(this.agent, {
+            getEntities: async () => this.memoryManager?.getEntityAssociations() || []
+          });
+          this.logger.info(
+            "Parameter preprocessing callback attached (internal)"
+          );
+        } catch (e) {
+          this.logger.warn(
+            "Failed to attach internal parameter preprocessing callback",
+            e
+          );
+        }
         const cfg = agentConfig;
         cfg.filtering = cfg.filtering || {};
         const originalPredicate = cfg.filtering.toolPredicate;
@@ -302,22 +404,27 @@ const _ConversationalAgent = class _ConversationalAgent {
    * @throws {Error} If required fields are missing
    */
   validateOptions(accountId, privateKey) {
-    if (!accountId || !privateKey) {
-      throw new Error("Account ID and private key are required");
+    const opMode = this.options.operationalMode || DEFAULT_OPERATIONAL_MODE;
+    const bytesMode = opMode !== "autonomous";
+    if (!accountId) {
+      throw new Error("Account ID is required");
+    }
+    if (!privateKey && !bytesMode) {
+      throw new Error("Private key is required in autonomous mode");
     }
     if (typeof accountId !== "string") {
       throw new Error(
         `Account ID must be a string, received ${typeof accountId}`
       );
     }
-    if (typeof privateKey !== "string") {
+    if (!bytesMode && typeof privateKey !== "string") {
       throw new Error(
         `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(
           privateKey
         )}`
       );
     }
-    if (privateKey.length < 10) {
+    if (!bytesMode && typeof privateKey === "string" && privateKey.length < 10) {
       throw new Error("Private key appears to be invalid (too short)");
     }
   }
@@ -347,12 +454,12 @@ const _ConversationalAgent = class _ConversationalAgent {
   /**
    * Creates the agent configuration object.
    *
-   * @param serverSigner - The server signer instance
+   * @param signer - The signer instance
    * @param llm - The language model instance
    * @param allPlugins - Array of plugins to use
    * @returns Configuration object for creating the agent
    */
-  createAgentConfig(serverSigner, llm, allPlugins) {
+  createAgentConfig(signer, llm, allPlugins) {
     const {
       operationalMode = DEFAULT_OPERATIONAL_MODE,
       userAccountId,
@@ -366,7 +473,7 @@ const _ConversationalAgent = class _ConversationalAgent {
     } = this.options;
     return {
       framework: "langchain",
-      signer: serverSigner,
+      signer,
       execution: {
         mode: operationalMode === "autonomous" ? "direct" : "bytes",
         operationalMode,
@@ -579,7 +686,7 @@ const _ConversationalAgent = class _ConversationalAgent {
       }
       if (typeof response === "string") {
         const match = response.match(
-          /transaction[\s\w]*ID[\s:"]*([0-9a-fA-F@\.\-]+)/i
+          /transaction[\s\w]*ID[\s:"]*([0-9a-fA-F@._-]+)/i
         );
         return match ? match[1] : void 0;
       }