@hashgraphonline/conversational-agent 0.1.220 → 0.1.221

package/dist/esm/index21.js

@@ -1,5 +1,5 @@
 import { ReferenceIdGenerator } from "./index22.js";
-import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index42.js";
+import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index39.js";
 const _ContentStorage = class _ContentStorage {
   constructor(maxStorage = _ContentStorage.DEFAULT_MAX_STORAGE, referenceConfig) {
     this.messages = [];

package/dist/esm/index31.js

@@ -8,11 +8,11 @@ import { MCPClientManager } from "./index15.js";
 import { convertMCPToolToLangChain } from "./index17.js";
 import { SmartMemoryManager } from "./index18.js";
 import { ResponseFormatter } from "./index33.js";
-import { ERROR_MESSAGES } from "./index39.js";
+import { ERROR_MESSAGES } from "./index40.js";
 import "./index37.js";
 import { SystemMessage, AIMessage, HumanMessage } from "@langchain/core/messages";
-import { ToolRegistry } from "./index40.js";
-import { ExecutionPipeline } from "./index41.js";
+import { ToolRegistry } from "./index41.js";
+import { ExecutionPipeline } from "./index42.js";
 import { FormEngine } from "./index11.js";
 function hasHashLinkBlock(metadata) {
   if (!metadata || typeof metadata !== "object") {

package/dist/esm/index39.js

@@ -1,8 +1,30 @@
-const ERROR_MESSAGES = {
-  TOO_MANY_REQUESTS: "Too many requests. Please wait a moment and try again.",
-  RATE_LIMITED: "I'm receiving too many requests right now. Please wait a moment and try again."
+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 {
-  ERROR_MESSAGES
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
 };
 //# sourceMappingURL=index39.js.map

package/dist/esm/index39.js.map

@@ -1 +1 @@
-{"version":3,"file":"index39.js","sources":["../../src/constants/messages.ts"],"sourcesContent":["/**\n * Common error messages and user feedback strings\n */\nexport const ERROR_MESSAGES = {\n  TOO_MANY_REQUESTS: 'Too many requests. Please wait a moment and try again.',\n  RATE_LIMITED: \"I'm receiving too many requests right now. Please wait a moment and try again.\",\n  SYSTEM_ERROR: 'System error occurred',\n  INVALID_INPUT: 'Invalid input provided',\n  NETWORK_ERROR: 'Network error occurred',\n} as const;\n\n/**\n * Common success and status messages\n */\nexport const STATUS_MESSAGES = {\n  OPERATION_SUCCESSFUL: 'Operation completed successfully',\n  PROCESSING: 'Processing your request...',\n  READY: 'Ready to process requests',\n  INITIALIZING: 'Initializing...',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,iBAAiB;AAAA,EAC5B,mBAAmB;AAAA,EACnB,cAAc;AAIhB;"}
+{"version":3,"file":"index39.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/index40.js

@@ -1,258 +1,8 @@
-import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-import { wrapToolWithFormValidation } from "./index30.js";
-import { FormGenerator } from "./index10.js";
-import { isFormValidatable } from "@hashgraphonline/standards-agent-kit";
-class ToolRegistry {
-  constructor(logger) {
-    this.tools = /* @__PURE__ */ new Map();
-    this.formGenerator = new FormGenerator();
-    this.logger = logger || new Logger({ module: "ToolRegistry" });
-  }
-  /**
-   * Register a tool with the registry
-   */
-  registerTool(tool, options = {}) {
-    const capabilities = this.analyzeToolCapabilities(tool);
-    const metadata = {
-      name: tool.name,
-      version: "1.0.0",
-      category: options.metadata?.category || "core",
-      description: tool.description,
-      capabilities,
-      dependencies: [],
-      schema: tool.schema,
-      ...options.metadata
-    };
-    try {
-      if (!metadata.entityResolutionPreferences) {
-        const schemaRecord = tool.schema;
-        const rawPrefs = schemaRecord && typeof schemaRecord === "object" && schemaRecord["_entityResolutionPreferences"];
-        if (rawPrefs && typeof rawPrefs === "object") {
-          metadata.entityResolutionPreferences = rawPrefs;
-        }
-      }
-    } catch {
-    }
-    try {
-      const schemaRecord = tool.schema;
-      const schemaDef = schemaRecord && schemaRecord._def;
-      if (schemaDef?.typeName === "ZodObject") {
-        const shape = typeof schemaDef.shape === "function" ? schemaDef.shape?.() || {} : schemaDef.shape || {};
-        const metadataField = shape["metadata"];
-        const isStringArray = !!metadataField && metadataField._def?.typeName === "ZodArray" && metadataField._def?.type?._def?.typeName === "ZodString";
-        if (isStringArray && typeof tool.description === "string") {
-          if (!metadata.entityResolutionPreferences) {
-            metadata.entityResolutionPreferences = {
-              inscription: "hrl"
-            };
-          }
-          const note = " NOTE: When referencing inscriptions or media, provide canonical Hashlink Resource Locators (e.g., hcs://<standard>/<topicId>) rather than external URLs or embedded JSON.";
-          if (!tool.description.includes("Hashlink Resource Locators")) {
-            tool.description = `${tool.description}${note}`;
-          }
-        }
-      }
-    } catch {
-    }
-    let finalTool = tool;
-    let wrapper;
-    if (this.shouldWrapTool(tool, capabilities, options)) {
-      wrapper = wrapToolWithFormValidation(
-        tool,
-        this.formGenerator,
-        {
-          requireAllFields: false,
-          skipFields: ["metaOptions"],
-          ...options.wrapperConfig
-        }
-      );
-      finalTool = wrapper;
-    }
-    try {
-      if (metadata.entityResolutionPreferences) {
-        finalTool["entityResolutionPreferences"] = metadata.entityResolutionPreferences;
-      }
-    } catch {
-    }
-    const entry = {
-      tool: finalTool,
-      metadata,
-      wrapper,
-      originalTool: tool
-    };
-    this.tools.set(tool.name, entry);
-  }
-  /**
-   * Get a tool by name
-   */
-  getTool(name) {
-    return this.tools.get(name) || null;
-  }
-  /**
-   * Get tools by capability
-   */
-  getToolsByCapability(capability, value) {
-    const results = [];
-    for (const entry of this.tools.values()) {
-      if (value !== void 0) {
-        if (entry.metadata.capabilities[capability] === value) {
-          results.push(entry);
-        }
-      } else if (entry.metadata.capabilities[capability]) {
-        results.push(entry);
-      }
-    }
-    return results;
-  }
-  /**
-   * Get tools by query
-   */
-  getToolsByQuery(query) {
-    const results = [];
-    for (const entry of this.tools.values()) {
-      let matches = true;
-      if (query.name && entry.metadata.name !== query.name) {
-        matches = false;
-      }
-      if (query.category && entry.metadata.category !== query.category) {
-        matches = false;
-      }
-      if (query.capabilities) {
-        for (const [key, value] of Object.entries(query.capabilities)) {
-          if (entry.metadata.capabilities[key] !== value) {
-            matches = false;
-            break;
-          }
-        }
-      }
-      if (matches) {
-        results.push(entry);
-      }
-    }
-    return results;
-  }
-  /**
-   * Get all registered tools
-   */
-  getAllTools() {
-    return Array.from(this.tools.values()).map((entry) => entry.tool);
-  }
-  /**
-   * Get all registry entries
-   */
-  getAllRegistryEntries() {
-    return Array.from(this.tools.values());
-  }
-  /**
-   * Get all tool names
-   */
-  getToolNames() {
-    return Array.from(this.tools.keys());
-  }
-  /**
-   * Check if a tool is registered
-   */
-  hasTool(name) {
-    return this.tools.has(name);
-  }
-  /**
-   * Unregister a tool
-   */
-  unregisterTool(name) {
-    return this.tools.delete(name);
-  }
-  /**
-   * Clear all tools
-   */
-  clear() {
-    this.tools.clear();
-  }
-  /**
-   * Analyze tool capabilities
-   */
-  analyzeToolCapabilities(tool) {
-    const implementsFormValidatable = isFormValidatable(tool);
-    const hasRenderConfig = this.hasRenderConfig(tool);
-    const isZodObjectLike = this.isZodObjectLike(tool.schema);
-    const supportsFormValidation = implementsFormValidatable || hasRenderConfig;
-    const requiresWrapper = supportsFormValidation && isZodObjectLike;
-    let priority = "medium";
-    let category = "core";
-    if (supportsFormValidation && requiresWrapper) {
-      priority = "critical";
-    } else if (supportsFormValidation) {
-      priority = "high";
-    } else if (tool.description?.toLowerCase().includes("query") || tool.description?.toLowerCase().includes("search")) {
-      priority = "low";
-    }
-    const toolAsAny = tool;
-    if (tool.constructor.name.includes("MCP") || toolAsAny.isMCPTool) {
-      category = "mcp";
-    } else if (toolAsAny.isExtension || tool.constructor.name.includes("Extension")) {
-      category = "extension";
-    }
-    return {
-      supportsFormValidation,
-      requiresWrapper,
-      priority,
-      category
-    };
-  }
-  /**
-   * Check if tool has render configuration
-   */
-  hasRenderConfig(tool) {
-    const schema = tool.schema;
-    return !!(schema && schema._renderConfig);
-  }
-  /**
-   * Determine if tool should be wrapped
-   */
-  shouldWrapTool(tool, capabilities, options) {
-    if (options.skipWrapper) {
-      return false;
-    }
-    if (options.forceWrapper) {
-      return true;
-    }
-    return capabilities.requiresWrapper;
-  }
-  /**
-   * Check if schema is ZodObject-like
-   */
-  isZodObjectLike(schema) {
-    if (!schema || typeof schema !== "object") {
-      return false;
-    }
-    const schemaRecord = schema;
-    const schemaDef = schemaRecord._def;
-    return schema instanceof z.ZodObject || schemaDef?.typeName === "ZodObject" || "shape" in schemaRecord && typeof schemaRecord.shape === "object";
-  }
-  /**
-   * Get statistics about the registry
-   */
-  getStatistics() {
-    const stats = {
-      totalTools: this.tools.size,
-      wrappedTools: 0,
-      unwrappedTools: 0,
-      categoryCounts: { core: 0, extension: 0, mcp: 0 },
-      priorityCounts: { low: 0, medium: 0, high: 0, critical: 0 }
-    };
-    for (const entry of this.tools.values()) {
-      if (entry.wrapper) {
-        stats.wrappedTools++;
-      } else {
-        stats.unwrappedTools++;
-      }
-      stats.categoryCounts[entry.metadata.category]++;
-      stats.priorityCounts[entry.metadata.capabilities.priority]++;
-    }
-    return stats;
-  }
-}
+const ERROR_MESSAGES = {
+  TOO_MANY_REQUESTS: "Too many requests. Please wait a moment and try again.",
+  RATE_LIMITED: "I'm receiving too many requests right now. Please wait a moment and try again."
+};
 export {
-  ToolRegistry
+  ERROR_MESSAGES
 };
 //# sourceMappingURL=index40.js.map

package/dist/esm/index40.js.map

@@ -1 +1 @@
-{"version":3,"file":"index40.js","sources":["../../src/core/tool-registry.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport {\n  FormValidatingToolWrapper,\n  wrapToolWithFormValidation,\n} from '../langchain/form-validating-tool-wrapper';\nimport { FormGenerator } from '../forms/form-generator';\nimport { isFormValidatable } from '@hashgraphonline/standards-agent-kit';\n\n/**\n * Tool capabilities configuration for registry entries\n */\nexport interface ToolCapabilities {\n  supportsFormValidation: boolean;\n  requiresWrapper: boolean;\n  priority: 'low' | 'medium' | 'high' | 'critical';\n  category: 'core' | 'extension' | 'mcp';\n}\n\n/**\n * Entity resolution format preferences for tools\n */\nexport interface EntityResolutionPreferences {\n  inscription?: 'hrl' | 'topicId' | 'metadata' | 'any';\n  token?: 'tokenId' | 'address' | 'symbol' | 'any';\n  nft?: 'serialNumber' | 'metadata' | 'hrl' | 'any';\n  account?: 'accountId' | 'alias' | 'evmAddress' | 'any';\n}\n\n/**\n * Tool metadata for comprehensive tool information\n */\nexport interface ToolMetadata {\n  name: string;\n  version: string;\n  category: ToolCapabilities['category'];\n  description: string;\n  capabilities: ToolCapabilities;\n  dependencies: string[];\n  schema: unknown;\n  entityResolutionPreferences?: EntityResolutionPreferences;\n}\n\n/**\n * Registry entry containing tool instance and metadata\n */\nexport interface ToolRegistryEntry {\n  tool: StructuredTool;\n  metadata: ToolMetadata;\n  wrapper?: FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>> | undefined;\n  originalTool: StructuredTool;\n}\n\n/**\n * Options for tool registration\n */\nexport interface ToolRegistrationOptions {\n  forceWrapper?: boolean;\n  skipWrapper?: boolean;\n  wrapperConfig?: {\n    requireAllFields?: boolean;\n    skipFields?: string[];\n  };\n  metadata?: Partial<ToolMetadata>;\n}\n\n/**\n * Query interface for finding tools\n */\nexport interface ToolQuery {\n  name?: string;\n  category?: ToolMetadata['category'];\n  capabilities?: Partial<ToolCapabilities>;\n}\n\n/**\n * Centralized tool registry for managing tool lifecycle\n */\nexport class ToolRegistry {\n  private tools = new Map<string, ToolRegistryEntry>();\n  private formGenerator: FormGenerator;\n  private logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.formGenerator = new FormGenerator();\n    this.logger = logger || new Logger({ module: 'ToolRegistry' });\n  }\n\n  /**\n   * Register a tool with the registry\n   */\n  registerTool(\n    tool: StructuredTool,\n    options: ToolRegistrationOptions = {}\n  ): void {\n    const capabilities = this.analyzeToolCapabilities(tool);\n    const metadata: ToolMetadata = {\n      name: tool.name,\n      version: '1.0.0',\n      category: options.metadata?.category || 'core',\n      description: tool.description,\n      capabilities,\n      dependencies: [],\n      schema: tool.schema,\n      ...options.metadata,\n    };\n\n    try {\n      if (!metadata.entityResolutionPreferences) {\n        const schemaRecord = tool.schema as unknown as Record<string, unknown>;\n        const rawPrefs =\n          schemaRecord &&\n          typeof schemaRecord === 'object' &&\n          (schemaRecord as Record<string, unknown>)[\n            '_entityResolutionPreferences'\n          ];\n        if (rawPrefs && typeof rawPrefs === 'object') {\n          metadata.entityResolutionPreferences = rawPrefs as unknown as EntityResolutionPreferences;\n        }\n      }\n    } catch {\n    }\n\n    try {\n      const schemaRecord = tool.schema as unknown as Record<string, unknown>;\n      const schemaDef = (schemaRecord && (schemaRecord as Record<string, unknown>)._def) as\n        | { typeName?: string; shape?: unknown }\n        | undefined;\n      if (schemaDef?.typeName === 'ZodObject') {\n        const shape: Record<string, unknown> =\n          typeof (schemaDef as { shape?: () => Record<string, unknown> }).shape === 'function'\n            ? ((schemaDef as { shape: () => Record<string, unknown> }).shape?.() || {})\n            : ((schemaDef as { shape?: Record<string, unknown> }).shape || {});\n\n        const metadataField = shape['metadata'] as\n          | { _def?: { typeName?: string; type?: { _def?: { typeName?: string } } } }\n          | undefined;\n        const isStringArray =\n          !!metadataField &&\n          metadataField._def?.typeName === 'ZodArray' &&\n          metadataField._def?.type?._def?.typeName === 'ZodString';\n\n        if (isStringArray && typeof tool.description === 'string') {\n          if (!metadata.entityResolutionPreferences) {\n            metadata.entityResolutionPreferences = {\n              inscription: 'hrl',\n            } as EntityResolutionPreferences;\n          }\n          const note =\n            ' NOTE: When referencing inscriptions or media, provide canonical Hashlink Resource Locators (e.g., hcs://<standard>/<topicId>) rather than external URLs or embedded JSON.';\n          if (!tool.description.includes('Hashlink Resource Locators')) {\n            (tool as unknown as { description: string }).description = `${tool.description}${note}`;\n          }\n        }\n      }\n    } catch {}\n\n    let finalTool: StructuredTool = tool;\n    let wrapper:\n      | FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>>\n      | undefined;\n\n    if (this.shouldWrapTool(tool, capabilities, options)) {\n      wrapper = wrapToolWithFormValidation(\n        tool as StructuredTool<z.ZodObject<z.ZodRawShape>>,\n        this.formGenerator,\n        {\n          requireAllFields: false,\n          skipFields: ['metaOptions'],\n          ...options.wrapperConfig,\n        }\n      ) as FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>>;\n      finalTool = wrapper as StructuredTool;\n    }\n\n    try {\n      if (metadata.entityResolutionPreferences) {\n        (finalTool as unknown as Record<string, unknown>)[\n          'entityResolutionPreferences'\n        ] = metadata.entityResolutionPreferences;\n      }\n    } catch {\n    }\n\n    const entry: ToolRegistryEntry = {\n      tool: finalTool,\n      metadata,\n      wrapper,\n      originalTool: tool,\n    };\n\n    this.tools.set(tool.name, entry);\n  }\n\n  /**\n   * Get a tool by name\n   */\n  getTool(name: string): ToolRegistryEntry | null {\n    return this.tools.get(name) || null;\n  }\n\n  /**\n   * Get tools by capability\n   */\n  getToolsByCapability(\n    capability: keyof ToolCapabilities,\n    value?: unknown\n  ): ToolRegistryEntry[] {\n    const results: ToolRegistryEntry[] = [];\n\n    for (const entry of this.tools.values()) {\n      if (value !== undefined) {\n        if (entry.metadata.capabilities[capability] === value) {\n          results.push(entry);\n        }\n      } else if (entry.metadata.capabilities[capability]) {\n        results.push(entry);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get tools by query\n   */\n  getToolsByQuery(query: ToolQuery): ToolRegistryEntry[] {\n    const results: ToolRegistryEntry[] = [];\n\n    for (const entry of this.tools.values()) {\n      let matches = true;\n\n      if (query.name && entry.metadata.name !== query.name) {\n        matches = false;\n      }\n\n      if (query.category && entry.metadata.category !== query.category) {\n        matches = false;\n      }\n\n      if (query.capabilities) {\n        for (const [key, value] of Object.entries(query.capabilities)) {\n          if (\n            entry.metadata.capabilities[key as keyof ToolCapabilities] !== value\n          ) {\n            matches = false;\n            break;\n          }\n        }\n      }\n\n      if (matches) {\n        results.push(entry);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get all registered tools\n   */\n  getAllTools(): StructuredTool[] {\n    return Array.from(this.tools.values()).map((entry) => entry.tool);\n  }\n\n  /**\n   * Get all registry entries\n   */\n  getAllRegistryEntries(): ToolRegistryEntry[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all tool names\n   */\n  getToolNames(): string[] {\n    return Array.from(this.tools.keys());\n  }\n\n  /**\n   * Check if a tool is registered\n   */\n  hasTool(name: string): boolean {\n    return this.tools.has(name);\n  }\n\n  /**\n   * Unregister a tool\n   */\n  unregisterTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n\n  /**\n   * Clear all tools\n   */\n  clear(): void {\n    this.tools.clear();\n  }\n\n  /**\n   * Analyze tool capabilities\n   */\n  private analyzeToolCapabilities(tool: StructuredTool): ToolCapabilities {\n    const implementsFormValidatable = isFormValidatable(tool);\n    const hasRenderConfig = this.hasRenderConfig(tool);\n    const isZodObjectLike = this.isZodObjectLike(tool.schema);\n\n    const supportsFormValidation = implementsFormValidatable || hasRenderConfig;\n    const requiresWrapper = supportsFormValidation && isZodObjectLike;\n\n    let priority: ToolCapabilities['priority'] = 'medium';\n    let category: ToolCapabilities['category'] = 'core';\n\n    if (supportsFormValidation && requiresWrapper) {\n      priority = 'critical';\n    } else if (supportsFormValidation) {\n      priority = 'high';\n    } else if (\n      tool.description?.toLowerCase().includes('query') ||\n      tool.description?.toLowerCase().includes('search')\n    ) {\n      priority = 'low';\n    }\n\n    const toolAsAny = tool as unknown as Record<string, unknown>;\n    if (tool.constructor.name.includes('MCP') || toolAsAny.isMCPTool) {\n      category = 'mcp';\n    } else if (\n      toolAsAny.isExtension ||\n      tool.constructor.name.includes('Extension')\n    ) {\n      category = 'extension';\n    }\n\n    return {\n      supportsFormValidation,\n      requiresWrapper,\n      priority,\n      category,\n    };\n  }\n\n  /**\n   * Check if tool has render configuration\n   */\n  private hasRenderConfig(tool: StructuredTool): boolean {\n    const schema = tool.schema as Record<string, unknown>;\n    return !!(schema && schema._renderConfig);\n  }\n\n  /**\n   * Determine if tool should be wrapped\n   */\n  private shouldWrapTool(\n    tool: StructuredTool,\n    capabilities: ToolCapabilities,\n    options: ToolRegistrationOptions\n  ): boolean {\n    if (options.skipWrapper) {\n      return false;\n    }\n\n    if (options.forceWrapper) {\n      return true;\n    }\n\n    return capabilities.requiresWrapper;\n  }\n\n  /**\n   * Check if schema is ZodObject-like\n   */\n  private isZodObjectLike(schema: unknown): boolean {\n    if (!schema || typeof schema !== 'object') {\n      return false;\n    }\n\n    const schemaRecord = schema as Record<string, unknown>;\n    const schemaDef = schemaRecord._def as Record<string, unknown> | undefined;\n\n    return (\n      schema instanceof z.ZodObject ||\n      schemaDef?.typeName === 'ZodObject' ||\n      ('shape' in schemaRecord && typeof schemaRecord.shape === 'object')\n    );\n  }\n\n  /**\n   * Get statistics about the registry\n   */\n  getStatistics(): {\n    totalTools: number;\n    wrappedTools: number;\n    unwrappedTools: number;\n    categoryCounts: Record<ToolCapabilities['category'], number>;\n    priorityCounts: Record<ToolCapabilities['priority'], number>;\n  } {\n    const stats = {\n      totalTools: this.tools.size,\n      wrappedTools: 0,\n      unwrappedTools: 0,\n      categoryCounts: { core: 0, extension: 0, mcp: 0 } as Record<\n        ToolCapabilities['category'],\n        number\n      >,\n      priorityCounts: { low: 0, medium: 0, high: 0, critical: 0 } as Record<\n        ToolCapabilities['priority'],\n        number\n      >,\n    };\n\n    for (const entry of this.tools.values()) {\n      if (entry.wrapper) {\n        stats.wrappedTools++;\n      } else {\n        stats.unwrappedTools++;\n      }\n\n      stats.categoryCounts[entry.metadata.category]++;\n      stats.priorityCounts[entry.metadata.capabilities.priority]++;\n    }\n\n    return stats;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index40.js","sources":["../../src/constants/messages.ts"],"sourcesContent":["/**\n * Common error messages and user feedback strings\n */\nexport const ERROR_MESSAGES = {\n  TOO_MANY_REQUESTS: 'Too many requests. Please wait a moment and try again.',\n  RATE_LIMITED: \"I'm receiving too many requests right now. Please wait a moment and try again.\",\n  SYSTEM_ERROR: 'System error occurred',\n  INVALID_INPUT: 'Invalid input provided',\n  NETWORK_ERROR: 'Network error occurred',\n} as const;\n\n/**\n * Common success and status messages\n */\nexport const STATUS_MESSAGES = {\n  OPERATION_SUCCESSFUL: 'Operation completed successfully',\n  PROCESSING: 'Processing your request...',\n  READY: 'Ready to process requests',\n  INITIALIZING: 'Initializing...',\n} as const;"],"names":[],"mappings":"AAGO,MAAM,iBAAiB;AAAA,EAC5B,mBAAmB;AAAA,EACnB,cAAc;AAIhB;"}

package/dist/esm/index41.js

@@ -1,187 +1,258 @@
-import { ZodError } from "zod";
+import { z } 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" });
+import { wrapToolWithFormValidation } from "./index30.js";
+import { FormGenerator } from "./index10.js";
+import { isFormValidatable } from "@hashgraphonline/standards-agent-kit";
+class ToolRegistry {
+  constructor(logger) {
+    this.tools = /* @__PURE__ */ new Map();
+    this.formGenerator = new FormGenerator();
+    this.logger = logger || new Logger({ module: "ToolRegistry" });
   }
   /**
-   * Execute a tool through the pipeline
+   * Register a tool with the registry
    */
-  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
+  registerTool(tool, options = {}) {
+    const capabilities = this.analyzeToolCapabilities(tool);
+    const metadata = {
+      name: tool.name,
+      version: "1.0.0",
+      category: options.metadata?.category || "core",
+      description: tool.description,
+      capabilities,
+      dependencies: [],
+      schema: tool.schema,
+      ...options.metadata
     };
     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
-        };
+      if (!metadata.entityResolutionPreferences) {
+        const schemaRecord = tool.schema;
+        const rawPrefs = schemaRecord && typeof schemaRecord === "object" && schemaRecord["_entityResolutionPreferences"];
+        if (rawPrefs && typeof rawPrefs === "object") {
+          metadata.entityResolutionPreferences = rawPrefs;
+        }
+      }
+    } catch {
+    }
+    try {
+      const schemaRecord = tool.schema;
+      const schemaDef = schemaRecord && schemaRecord._def;
+      if (schemaDef?.typeName === "ZodObject") {
+        const shape = typeof schemaDef.shape === "function" ? schemaDef.shape?.() || {} : schemaDef.shape || {};
+        const metadataField = shape["metadata"];
+        const isStringArray = !!metadataField && metadataField._def?.typeName === "ZodArray" && metadataField._def?.type?._def?.typeName === "ZodString";
+        if (isStringArray && typeof tool.description === "string") {
+          if (!metadata.entityResolutionPreferences) {
+            metadata.entityResolutionPreferences = {
+              inscription: "hrl"
+            };
+          }
+          const note = " NOTE: When referencing inscriptions or media, provide canonical Hashlink Resource Locators (e.g., hcs://<standard>/<topicId>) rather than external URLs or embedded JSON.";
+          if (!tool.description.includes("Hashlink Resource Locators")) {
+            tool.description = `${tool.description}${note}`;
+          }
+        }
       }
-      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
+    } catch {
+    }
+    let finalTool = tool;
+    let wrapper;
+    if (this.shouldWrapTool(tool, capabilities, options)) {
+      wrapper = wrapToolWithFormValidation(
+        tool,
+        this.formGenerator,
+        {
+          requireAllFields: false,
+          skipFields: ["metaOptions"],
+          ...options.wrapperConfig
+        }
       );
+      finalTool = wrapper;
     }
+    try {
+      if (metadata.entityResolutionPreferences) {
+        finalTool["entityResolutionPreferences"] = metadata.entityResolutionPreferences;
+      }
+    } catch {
+    }
+    const entry = {
+      tool: finalTool,
+      metadata,
+      wrapper,
+      originalTool: tool
+    };
+    this.tools.set(tool.name, entry);
   }
   /**
-   * Execute tool with validation
+   * Get a tool by name
    */
-  async executeWithValidation(toolName, input, sessionContext) {
-    return this.execute(toolName, input, sessionContext);
+  getTool(name) {
+    return this.tools.get(name) || null;
   }
   /**
-   * Process form submission
+   * Get tools by capability
    */
-  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
-      };
+  getToolsByCapability(capability, value) {
+    const results = [];
+    for (const entry of this.tools.values()) {
+      if (value !== void 0) {
+        if (entry.metadata.capabilities[capability] === value) {
+          results.push(entry);
+        }
+      } else if (entry.metadata.capabilities[capability]) {
+        results.push(entry);
+      }
     }
+    return results;
   }
   /**
-   * Check if form generation is required
+   * Get tools by query
    */
-  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 };
+  getToolsByQuery(query) {
+    const results = [];
+    for (const entry of this.tools.values()) {
+      let matches = true;
+      if (query.name && entry.metadata.name !== query.name) {
+        matches = false;
+      }
+      if (query.category && entry.metadata.category !== query.category) {
+        matches = false;
+      }
+      if (query.capabilities) {
+        for (const [key, value] of Object.entries(query.capabilities)) {
+          if (entry.metadata.capabilities[key] !== value) {
+            matches = false;
+            break;
+          }
+        }
+      }
+      if (matches) {
+        results.push(entry);
+      }
     }
-    return { requiresForm: false };
+    return results;
   }
   /**
-   * Execute tool directly
+   * Get all registered tools
    */
-  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);
+  getAllTools() {
+    return Array.from(this.tools.values()).map((entry) => entry.tool);
   }
   /**
-   * Execute wrapped tool
+   * Get all registry entries
    */
-  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);
+  getAllRegistryEntries() {
+    return Array.from(this.tools.values());
+  }
+  /**
+   * Get all tool names
+   */
+  getToolNames() {
+    return Array.from(this.tools.keys());
   }
   /**
-   * Handle execution error
+   * Check if a tool is registered
    */
-  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
-      };
+  hasTool(name) {
+    return this.tools.has(name);
+  }
+  /**
+   * Unregister a tool
+   */
+  unregisterTool(name) {
+    return this.tools.delete(name);
+  }
+  /**
+   * Clear all tools
+   */
+  clear() {
+    this.tools.clear();
+  }
+  /**
+   * Analyze tool capabilities
+   */
+  analyzeToolCapabilities(tool) {
+    const implementsFormValidatable = isFormValidatable(tool);
+    const hasRenderConfig = this.hasRenderConfig(tool);
+    const isZodObjectLike = this.isZodObjectLike(tool.schema);
+    const supportsFormValidation = implementsFormValidatable || hasRenderConfig;
+    const requiresWrapper = supportsFormValidation && isZodObjectLike;
+    let priority = "medium";
+    let category = "core";
+    if (supportsFormValidation && requiresWrapper) {
+      priority = "critical";
+    } else if (supportsFormValidation) {
+      priority = "high";
+    } else if (tool.description?.toLowerCase().includes("query") || tool.description?.toLowerCase().includes("search")) {
+      priority = "low";
+    }
+    const toolAsAny = tool;
+    if (tool.constructor.name.includes("MCP") || toolAsAny.isMCPTool) {
+      category = "mcp";
+    } else if (toolAsAny.isExtension || tool.constructor.name.includes("Extension")) {
+      category = "extension";
     }
-    this.logger.error(`Tool execution failed: ${context.toolName}`, {
-      traceId,
-      error: errorMessage
-    });
     return {
-      success: false,
-      output: "Tool execution failed",
-      error: errorMessage,
-      traceId,
-      executionTime
+      supportsFormValidation,
+      requiresWrapper,
+      priority,
+      category
     };
   }
   /**
-   * Build default session context
+   * Check if tool has render configuration
    */
-  buildDefaultSession() {
-    return {
-      sessionId: `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-      timestamp: Date.now()
-    };
+  hasRenderConfig(tool) {
+    const schema = tool.schema;
+    return !!(schema && schema._renderConfig);
   }
   /**
-   * Get statistics about the pipeline
+   * Determine if tool should be wrapped
+   */
+  shouldWrapTool(tool, capabilities, options) {
+    if (options.skipWrapper) {
+      return false;
+    }
+    if (options.forceWrapper) {
+      return true;
+    }
+    return capabilities.requiresWrapper;
+  }
+  /**
+   * Check if schema is ZodObject-like
+   */
+  isZodObjectLike(schema) {
+    if (!schema || typeof schema !== "object") {
+      return false;
+    }
+    const schemaRecord = schema;
+    const schemaDef = schemaRecord._def;
+    return schema instanceof z.ZodObject || schemaDef?.typeName === "ZodObject" || "shape" in schemaRecord && typeof schemaRecord.shape === "object";
+  }
+  /**
+   * Get statistics about the registry
    */
   getStatistics() {
-    return {
-      totalMiddleware: 0,
-      registeredMiddleware: []
+    const stats = {
+      totalTools: this.tools.size,
+      wrappedTools: 0,
+      unwrappedTools: 0,
+      categoryCounts: { core: 0, extension: 0, mcp: 0 },
+      priorityCounts: { low: 0, medium: 0, high: 0, critical: 0 }
     };
+    for (const entry of this.tools.values()) {
+      if (entry.wrapper) {
+        stats.wrappedTools++;
+      } else {
+        stats.unwrappedTools++;
+      }
+      stats.categoryCounts[entry.metadata.category]++;
+      stats.priorityCounts[entry.metadata.capabilities.priority]++;
+    }
+    return stats;
   }
 }
 export {
-  ExecutionPipeline
+  ToolRegistry
 };
 //# sourceMappingURL=index41.js.map

package/dist/esm/index41.js.map

@@ -1 +1 @@
-{"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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"}
+{"version":3,"file":"index41.js","sources":["../../src/core/tool-registry.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport {\n  FormValidatingToolWrapper,\n  wrapToolWithFormValidation,\n} from '../langchain/form-validating-tool-wrapper';\nimport { FormGenerator } from '../forms/form-generator';\nimport { isFormValidatable } from '@hashgraphonline/standards-agent-kit';\n\n/**\n * Tool capabilities configuration for registry entries\n */\nexport interface ToolCapabilities {\n  supportsFormValidation: boolean;\n  requiresWrapper: boolean;\n  priority: 'low' | 'medium' | 'high' | 'critical';\n  category: 'core' | 'extension' | 'mcp';\n}\n\n/**\n * Entity resolution format preferences for tools\n */\nexport interface EntityResolutionPreferences {\n  inscription?: 'hrl' | 'topicId' | 'metadata' | 'any';\n  token?: 'tokenId' | 'address' | 'symbol' | 'any';\n  nft?: 'serialNumber' | 'metadata' | 'hrl' | 'any';\n  account?: 'accountId' | 'alias' | 'evmAddress' | 'any';\n}\n\n/**\n * Tool metadata for comprehensive tool information\n */\nexport interface ToolMetadata {\n  name: string;\n  version: string;\n  category: ToolCapabilities['category'];\n  description: string;\n  capabilities: ToolCapabilities;\n  dependencies: string[];\n  schema: unknown;\n  entityResolutionPreferences?: EntityResolutionPreferences;\n}\n\n/**\n * Registry entry containing tool instance and metadata\n */\nexport interface ToolRegistryEntry {\n  tool: StructuredTool;\n  metadata: ToolMetadata;\n  wrapper?: FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>> | undefined;\n  originalTool: StructuredTool;\n}\n\n/**\n * Options for tool registration\n */\nexport interface ToolRegistrationOptions {\n  forceWrapper?: boolean;\n  skipWrapper?: boolean;\n  wrapperConfig?: {\n    requireAllFields?: boolean;\n    skipFields?: string[];\n  };\n  metadata?: Partial<ToolMetadata>;\n}\n\n/**\n * Query interface for finding tools\n */\nexport interface ToolQuery {\n  name?: string;\n  category?: ToolMetadata['category'];\n  capabilities?: Partial<ToolCapabilities>;\n}\n\n/**\n * Centralized tool registry for managing tool lifecycle\n */\nexport class ToolRegistry {\n  private tools = new Map<string, ToolRegistryEntry>();\n  private formGenerator: FormGenerator;\n  private logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.formGenerator = new FormGenerator();\n    this.logger = logger || new Logger({ module: 'ToolRegistry' });\n  }\n\n  /**\n   * Register a tool with the registry\n   */\n  registerTool(\n    tool: StructuredTool,\n    options: ToolRegistrationOptions = {}\n  ): void {\n    const capabilities = this.analyzeToolCapabilities(tool);\n    const metadata: ToolMetadata = {\n      name: tool.name,\n      version: '1.0.0',\n      category: options.metadata?.category || 'core',\n      description: tool.description,\n      capabilities,\n      dependencies: [],\n      schema: tool.schema,\n      ...options.metadata,\n    };\n\n    try {\n      if (!metadata.entityResolutionPreferences) {\n        const schemaRecord = tool.schema as unknown as Record<string, unknown>;\n        const rawPrefs =\n          schemaRecord &&\n          typeof schemaRecord === 'object' &&\n          (schemaRecord as Record<string, unknown>)[\n            '_entityResolutionPreferences'\n          ];\n        if (rawPrefs && typeof rawPrefs === 'object') {\n          metadata.entityResolutionPreferences = rawPrefs as unknown as EntityResolutionPreferences;\n        }\n      }\n    } catch {\n    }\n\n    try {\n      const schemaRecord = tool.schema as unknown as Record<string, unknown>;\n      const schemaDef = (schemaRecord && (schemaRecord as Record<string, unknown>)._def) as\n        | { typeName?: string; shape?: unknown }\n        | undefined;\n      if (schemaDef?.typeName === 'ZodObject') {\n        const shape: Record<string, unknown> =\n          typeof (schemaDef as { shape?: () => Record<string, unknown> }).shape === 'function'\n            ? ((schemaDef as { shape: () => Record<string, unknown> }).shape?.() || {})\n            : ((schemaDef as { shape?: Record<string, unknown> }).shape || {});\n\n        const metadataField = shape['metadata'] as\n          | { _def?: { typeName?: string; type?: { _def?: { typeName?: string } } } }\n          | undefined;\n        const isStringArray =\n          !!metadataField &&\n          metadataField._def?.typeName === 'ZodArray' &&\n          metadataField._def?.type?._def?.typeName === 'ZodString';\n\n        if (isStringArray && typeof tool.description === 'string') {\n          if (!metadata.entityResolutionPreferences) {\n            metadata.entityResolutionPreferences = {\n              inscription: 'hrl',\n            } as EntityResolutionPreferences;\n          }\n          const note =\n            ' NOTE: When referencing inscriptions or media, provide canonical Hashlink Resource Locators (e.g., hcs://<standard>/<topicId>) rather than external URLs or embedded JSON.';\n          if (!tool.description.includes('Hashlink Resource Locators')) {\n            (tool as unknown as { description: string }).description = `${tool.description}${note}`;\n          }\n        }\n      }\n    } catch {}\n\n    let finalTool: StructuredTool = tool;\n    let wrapper:\n      | FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>>\n      | undefined;\n\n    if (this.shouldWrapTool(tool, capabilities, options)) {\n      wrapper = wrapToolWithFormValidation(\n        tool as StructuredTool<z.ZodObject<z.ZodRawShape>>,\n        this.formGenerator,\n        {\n          requireAllFields: false,\n          skipFields: ['metaOptions'],\n          ...options.wrapperConfig,\n        }\n      ) as FormValidatingToolWrapper<z.ZodObject<z.ZodRawShape>>;\n      finalTool = wrapper as StructuredTool;\n    }\n\n    try {\n      if (metadata.entityResolutionPreferences) {\n        (finalTool as unknown as Record<string, unknown>)[\n          'entityResolutionPreferences'\n        ] = metadata.entityResolutionPreferences;\n      }\n    } catch {\n    }\n\n    const entry: ToolRegistryEntry = {\n      tool: finalTool,\n      metadata,\n      wrapper,\n      originalTool: tool,\n    };\n\n    this.tools.set(tool.name, entry);\n  }\n\n  /**\n   * Get a tool by name\n   */\n  getTool(name: string): ToolRegistryEntry | null {\n    return this.tools.get(name) || null;\n  }\n\n  /**\n   * Get tools by capability\n   */\n  getToolsByCapability(\n    capability: keyof ToolCapabilities,\n    value?: unknown\n  ): ToolRegistryEntry[] {\n    const results: ToolRegistryEntry[] = [];\n\n    for (const entry of this.tools.values()) {\n      if (value !== undefined) {\n        if (entry.metadata.capabilities[capability] === value) {\n          results.push(entry);\n        }\n      } else if (entry.metadata.capabilities[capability]) {\n        results.push(entry);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get tools by query\n   */\n  getToolsByQuery(query: ToolQuery): ToolRegistryEntry[] {\n    const results: ToolRegistryEntry[] = [];\n\n    for (const entry of this.tools.values()) {\n      let matches = true;\n\n      if (query.name && entry.metadata.name !== query.name) {\n        matches = false;\n      }\n\n      if (query.category && entry.metadata.category !== query.category) {\n        matches = false;\n      }\n\n      if (query.capabilities) {\n        for (const [key, value] of Object.entries(query.capabilities)) {\n          if (\n            entry.metadata.capabilities[key as keyof ToolCapabilities] !== value\n          ) {\n            matches = false;\n            break;\n          }\n        }\n      }\n\n      if (matches) {\n        results.push(entry);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get all registered tools\n   */\n  getAllTools(): StructuredTool[] {\n    return Array.from(this.tools.values()).map((entry) => entry.tool);\n  }\n\n  /**\n   * Get all registry entries\n   */\n  getAllRegistryEntries(): ToolRegistryEntry[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get all tool names\n   */\n  getToolNames(): string[] {\n    return Array.from(this.tools.keys());\n  }\n\n  /**\n   * Check if a tool is registered\n   */\n  hasTool(name: string): boolean {\n    return this.tools.has(name);\n  }\n\n  /**\n   * Unregister a tool\n   */\n  unregisterTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n\n  /**\n   * Clear all tools\n   */\n  clear(): void {\n    this.tools.clear();\n  }\n\n  /**\n   * Analyze tool capabilities\n   */\n  private analyzeToolCapabilities(tool: StructuredTool): ToolCapabilities {\n    const implementsFormValidatable = isFormValidatable(tool);\n    const hasRenderConfig = this.hasRenderConfig(tool);\n    const isZodObjectLike = this.isZodObjectLike(tool.schema);\n\n    const supportsFormValidation = implementsFormValidatable || hasRenderConfig;\n    const requiresWrapper = supportsFormValidation && isZodObjectLike;\n\n    let priority: ToolCapabilities['priority'] = 'medium';\n    let category: ToolCapabilities['category'] = 'core';\n\n    if (supportsFormValidation && requiresWrapper) {\n      priority = 'critical';\n    } else if (supportsFormValidation) {\n      priority = 'high';\n    } else if (\n      tool.description?.toLowerCase().includes('query') ||\n      tool.description?.toLowerCase().includes('search')\n    ) {\n      priority = 'low';\n    }\n\n    const toolAsAny = tool as unknown as Record<string, unknown>;\n    if (tool.constructor.name.includes('MCP') || toolAsAny.isMCPTool) {\n      category = 'mcp';\n    } else if (\n      toolAsAny.isExtension ||\n      tool.constructor.name.includes('Extension')\n    ) {\n      category = 'extension';\n    }\n\n    return {\n      supportsFormValidation,\n      requiresWrapper,\n      priority,\n      category,\n    };\n  }\n\n  /**\n   * Check if tool has render configuration\n   */\n  private hasRenderConfig(tool: StructuredTool): boolean {\n    const schema = tool.schema as Record<string, unknown>;\n    return !!(schema && schema._renderConfig);\n  }\n\n  /**\n   * Determine if tool should be wrapped\n   */\n  private shouldWrapTool(\n    tool: StructuredTool,\n    capabilities: ToolCapabilities,\n    options: ToolRegistrationOptions\n  ): boolean {\n    if (options.skipWrapper) {\n      return false;\n    }\n\n    if (options.forceWrapper) {\n      return true;\n    }\n\n    return capabilities.requiresWrapper;\n  }\n\n  /**\n   * Check if schema is ZodObject-like\n   */\n  private isZodObjectLike(schema: unknown): boolean {\n    if (!schema || typeof schema !== 'object') {\n      return false;\n    }\n\n    const schemaRecord = schema as Record<string, unknown>;\n    const schemaDef = schemaRecord._def as Record<string, unknown> | undefined;\n\n    return (\n      schema instanceof z.ZodObject ||\n      schemaDef?.typeName === 'ZodObject' ||\n      ('shape' in schemaRecord && typeof schemaRecord.shape === 'object')\n    );\n  }\n\n  /**\n   * Get statistics about the registry\n   */\n  getStatistics(): {\n    totalTools: number;\n    wrappedTools: number;\n    unwrappedTools: number;\n    categoryCounts: Record<ToolCapabilities['category'], number>;\n    priorityCounts: Record<ToolCapabilities['priority'], number>;\n  } {\n    const stats = {\n      totalTools: this.tools.size,\n      wrappedTools: 0,\n      unwrappedTools: 0,\n      categoryCounts: { core: 0, extension: 0, mcp: 0 } as Record<\n        ToolCapabilities['category'],\n        number\n      >,\n      priorityCounts: { low: 0, medium: 0, high: 0, critical: 0 } as Record<\n        ToolCapabilities['priority'],\n        number\n      >,\n    };\n\n    for (const entry of this.tools.values()) {\n      if (entry.wrapper) {\n        stats.wrappedTools++;\n      } else {\n        stats.unwrappedTools++;\n      }\n\n      stats.categoryCounts[entry.metadata.category]++;\n      stats.priorityCounts[entry.metadata.capabilities.priority]++;\n    }\n\n    return stats;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index42.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=index42.js.map

package/dist/esm/index42.js.map

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

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/conversational-agent",
-  "version": "0.1.220",
+  "version": "0.1.221",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
@@ -98,15 +98,14 @@
     "@hashgraphonline/standards-agent-kit": "0.2.135",
     "@hashgraphonline/standards-sdk": "0.0.187",
     "@langchain/anthropic": "^0.3.26",
-    "@langchain/core": "^0.3.71",
-    "@langchain/openai": "^0.6.7",
-    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@langchain/core": "^0.3.72",
+    "@langchain/openai": "^0.6.9",
+    "@modelcontextprotocol/sdk": "^1.17.4",
     "axios": "^1.11.0",
     "bignumber.js": "^9.3.1",
-    "electron-log": "^5.4.2",
     "ethers": "^6.15.0",
     "hedera-agent-kit": "^2.0.3",
-    "langchain": "^0.3.30",
+    "langchain": "^0.3.31",
     "tiktoken": "^1.0.22",
     "zod": "^3.25.0",
     "zod-to-json-schema": "^3.24.6"