@hashgraphonline/conversational-agent 0.2.216 → 0.2.218

package/dist/esm/index14.js

@@ -1,104 +1,267 @@
-const MCPServers = {
-  /**
-   * Filesystem server for file operations
-   */
-  filesystem: (path) => ({
-    name: "filesystem",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-filesystem", path],
-    transport: "stdio",
-    autoConnect: true,
-    additionalContext: "This server provides access to files and directories in the current working directory.",
-    toolDescriptions: {
-      list_directory: 'Use this tool when users ask about files in the "current directory" or "working directory".',
-      read_file: "Use this tool when users ask to see or check files in the current directory."
-    }
-  }),
+import { Logger } from "@hashgraphonline/standards-sdk";
+class FieldGuidanceRegistry {
+  constructor() {
+    this.configurations = [];
+    this.providers = [];
+    this.registerOrderCounter = 0;
+    this.logger = new Logger({ module: "FieldGuidanceRegistry" });
+  }
   /**
-   * GitHub server for repository operations
+   * Register field guidance for a specific tool
    */
-  github: (token) => ({
-    name: "github",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-github"],
-    ...token && { env: { GITHUB_TOKEN: token } },
-    transport: "stdio",
-    autoConnect: true
-  }),
+  registerToolConfiguration(config) {
+    this.configurations.push(config);
+  }
   /**
-   * Slack server for messaging operations
+   * Register a provider for dynamic field/global guidance
    */
-  slack: (token) => ({
-    name: "slack",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-slack"],
-    env: { SLACK_TOKEN: token },
-    transport: "stdio",
-    autoConnect: true
-  }),
+  registerToolProvider(toolPattern, provider, options) {
+    const id = options?.id ?? `provider-${this.providers.length + 1}`;
+    const priority = options?.priority ?? 0;
+    if (this.providers.some((p) => p.id === id)) {
+      this.logger.error("Duplicate provider id", { id });
+      throw new Error("DUPLICATE_PROVIDER_ID");
+    }
+    this.providers.push({
+      id,
+      priority,
+      pattern: toolPattern,
+      provider,
+      order: this.registerOrderCounter++
+    });
+    return id;
+  }
+  /** Unregister a provider by id */
+  unregisterProvider(id) {
+    this.providers = this.providers.filter((p) => p.id !== id);
+  }
+  /** List registered providers */
+  listProviders() {
+    return this.providers.map(({ id, priority, pattern }) => ({
+      id,
+      priority,
+      pattern
+    }));
+  }
   /**
-   * Google Drive server for document operations
+   * Get field guidance for a specific tool and field
    */
-  googleDrive: (credentials) => ({
-    name: "google-drive",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-google-drive"],
-    env: { GOOGLE_CREDENTIALS: credentials },
-    transport: "stdio",
-    autoConnect: true
-  }),
+  getFieldGuidance(toolName, fieldName) {
+    if (process.env.CA_FORM_GUIDANCE_ENABLED === "false") {
+      return null;
+    }
+    for (const config of this.configurations) {
+      const matches = typeof config.toolPattern === "string" ? toolName.toLowerCase().includes(config.toolPattern.toLowerCase()) : config.toolPattern.test(toolName);
+      if (matches && config.fields[fieldName]) {
+        const staticGuidance = config.fields[fieldName];
+        const providers2 = this.pickMatchingProviders(toolName);
+        if (providers2.length === 0) return staticGuidance;
+        let merged = { ...staticGuidance };
+        for (const p of [...providers2].reverse()) {
+          const fromProvider = this.safeGetFieldGuidance(
+            p,
+            fieldName,
+            toolName
+          );
+          if (fromProvider) {
+            merged = this.mergeGuidance(merged, fromProvider);
+          }
+        }
+        return merged;
+      }
+    }
+    const providers = this.pickMatchingProviders(toolName);
+    if (providers.length > 0) {
+      let merged = {};
+      for (const p of [...providers].reverse()) {
+        const g = this.safeGetFieldGuidance(p, fieldName, toolName);
+        if (g) merged = this.mergeGuidance(merged, g);
+      }
+      return Object.keys(merged).length > 0 ? merged : null;
+    }
+    return null;
+  }
   /**
-   * PostgreSQL server for database operations
+   * Get global guidance for a tool
    */
-  postgres: (connectionString) => ({
-    name: "postgres",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-postgres", connectionString],
-    transport: "stdio",
-    autoConnect: true
-  }),
+  getGlobalGuidance(toolName) {
+    if (process.env.CA_FORM_GUIDANCE_ENABLED === "false") {
+      return null;
+    }
+    for (const config of this.configurations) {
+      const matches = typeof config.toolPattern === "string" ? toolName.toLowerCase().includes(config.toolPattern.toLowerCase()) : config.toolPattern.test(toolName);
+      if (matches && config.globalGuidance) {
+        const base = config.globalGuidance;
+        const providers2 = this.pickMatchingProviders(toolName);
+        if (providers2.length === 0) return base;
+        let mergedWarnings = base.warnings;
+        let mergedQuality = base.qualityStandards;
+        for (const p of [...providers2].reverse()) {
+          const fromProvider = this.safeGetGlobalGuidance(p, toolName);
+          if (fromProvider) {
+            mergedWarnings = fromProvider.warnings ?? mergedWarnings;
+            mergedQuality = fromProvider.qualityStandards ?? mergedQuality;
+          }
+        }
+        const result = {};
+        if (mergedWarnings !== void 0) result.warnings = mergedWarnings;
+        if (mergedQuality !== void 0)
+          result.qualityStandards = mergedQuality;
+        return result;
+      }
+    }
+    const providers = this.pickMatchingProviders(toolName);
+    if (providers.length > 0) {
+      let mergedWarnings;
+      let mergedQuality;
+      for (const p of [...providers].reverse()) {
+        const g = this.safeGetGlobalGuidance(p, toolName);
+        if (g) {
+          mergedWarnings = g.warnings ?? mergedWarnings;
+          mergedQuality = g.qualityStandards ?? mergedQuality;
+        }
+      }
+      const result = {};
+      if (mergedWarnings !== void 0) result.warnings = mergedWarnings;
+      if (mergedQuality !== void 0) result.qualityStandards = mergedQuality;
+      return Object.keys(result).length > 0 ? result : null;
+    }
+    return null;
+  }
   /**
-   * SQLite server for database operations
+   * Validate field value against guidance rules
    */
-  sqlite: (dbPath) => ({
-    name: "sqlite",
-    command: "npx",
-    args: ["-y", "@modelcontextprotocol/server-sqlite", dbPath],
-    transport: "stdio",
-    autoConnect: true
-  }),
+  validateFieldValue(toolName, fieldName, value) {
+    const guidance = this.getFieldGuidance(toolName, fieldName);
+    const warnings = [];
+    const errors = [];
+    if (!guidance || typeof value !== "string") {
+      return { isValid: true, warnings, errors };
+    }
+    if (guidance.warnings) {
+      for (const warning of guidance.warnings) {
+        if (warning.pattern.test(value)) {
+          warnings.push(warning.message);
+        }
+      }
+    }
+    if (guidance.validationRules) {
+      const { rejectPatterns, qualityChecks } = guidance.validationRules;
+      if (rejectPatterns) {
+        for (const reject of rejectPatterns) {
+          if (reject.pattern.test(value)) {
+            errors.push(`Rejected: ${reject.reason}`);
+          }
+        }
+      }
+      if (qualityChecks) {
+        if (qualityChecks.forbidTechnicalTerms) {
+          const lowerValue = value.toLowerCase();
+          for (const term of qualityChecks.forbidTechnicalTerms) {
+            if (lowerValue.includes(term.toLowerCase())) {
+              errors.push(
+                `Avoid technical terms like "${term}" in NFT metadata`
+              );
+            }
+          }
+        }
+        if (qualityChecks.requireSpecificTerms) {
+          const lowerValue = value.toLowerCase();
+          const hasRequired = qualityChecks.requireSpecificTerms.some(
+            (term) => lowerValue.includes(term.toLowerCase())
+          );
+          if (!hasRequired) {
+            warnings.push(
+              `Consider including terms like: ${qualityChecks.requireSpecificTerms.join(
+                ", "
+              )}`
+            );
+          }
+        }
+        if (qualityChecks.minNonTechnicalWords) {
+          const words = value.split(/\s+/).filter((word) => word.length > 2);
+          if (words.length < qualityChecks.minNonTechnicalWords) {
+            warnings.push(
+              `Consider providing more descriptive content (at least ${qualityChecks.minNonTechnicalWords} meaningful words)`
+            );
+          }
+        }
+      }
+    }
+    return {
+      isValid: errors.length === 0,
+      warnings,
+      errors
+    };
+  }
   /**
-   * Custom server configuration
+   * Clear all configurations (useful for testing)
    */
-  custom: (config) => config
-};
-function validateServerConfig(config) {
-  const errors = [];
-  if (!config.name) {
-    errors.push("Server name is required");
+  clear() {
+    this.configurations = [];
+    this.providers = [];
+    this.registerOrderCounter = 0;
+  }
+  /** Choose matching provider by priority then last-in wins */
+  pickMatchingProviders(toolName) {
+    const matches = this.providers.filter(
+      (p) => typeof p.pattern === "string" ? toolName.toLowerCase().includes(p.pattern.toLowerCase()) : p.pattern.test(toolName)
+    );
+    const sorted = matches.sort((a, b) => {
+      if (b.priority !== a.priority) return b.priority - a.priority;
+      return b.order - a.order;
+    });
+    return sorted.map((m) => ({
+      id: m.id,
+      provider: m.provider,
+      priority: m.priority,
+      order: m.order
+    }));
   }
-  if (!config.command) {
-    errors.push("Server command is required");
+  safeGetFieldGuidance(winner, fieldName, toolName) {
+    try {
+      return winner.provider.getFieldGuidance(fieldName, { toolName }) ?? null;
+    } catch (err) {
+      this.logger.warn("Provider getFieldGuidance failed", {
+        id: winner.id,
+        err
+      });
+      return null;
+    }
   }
-  if (!config.args || !Array.isArray(config.args)) {
-    errors.push("Server args must be an array");
+  safeGetGlobalGuidance(winner, toolName) {
+    try {
+      return winner.provider.getGlobalGuidance?.(toolName) ?? null;
+    } catch (err) {
+      this.logger.warn("Provider getGlobalGuidance failed", {
+        id: winner.id,
+        err
+      });
+      return null;
+    }
   }
-  if (config.transport && !["stdio", "http", "websocket"].includes(config.transport)) {
-    errors.push("Invalid transport type. Must be stdio, http, or websocket");
+  mergeGuidance(base, over) {
+    const out = {};
+    const suggestions = over.suggestions ?? base.suggestions;
+    if (suggestions !== void 0) out.suggestions = suggestions;
+    const predefinedOptions = over.predefinedOptions ?? base.predefinedOptions;
+    if (predefinedOptions !== void 0)
+      out.predefinedOptions = predefinedOptions;
+    const warnings = over.warnings ?? base.warnings;
+    if (warnings !== void 0) out.warnings = warnings;
+    const validationRules = over.validationRules ?? base.validationRules;
+    if (validationRules !== void 0) out.validationRules = validationRules;
+    const fieldTypeOverride = over.fieldTypeOverride ?? base.fieldTypeOverride;
+    if (fieldTypeOverride !== void 0)
+      out.fieldTypeOverride = fieldTypeOverride;
+    const contextualHelpText = over.contextualHelpText ?? base.contextualHelpText;
+    if (contextualHelpText !== void 0)
+      out.contextualHelpText = contextualHelpText;
+    return out;
   }
-  return errors;
-}
-function createMCPConfig(servers, autoConnect = true) {
-  return {
-    mcpServers: servers.map((server) => ({
-      ...server,
-      autoConnect: server.autoConnect ?? autoConnect
-    }))
-  };
 }
+const fieldGuidanceRegistry = new FieldGuidanceRegistry();
 export {
-  MCPServers,
-  createMCPConfig,
-  validateServerConfig
+  fieldGuidanceRegistry
 };
 //# sourceMappingURL=index14.js.map

package/dist/esm/index14.js.map

@@ -1 +1 @@
-{"version":3,"file":"index14.js","sources":["../../src/mcp/helpers.ts"],"sourcesContent":["import type { MCPServerConfig } from './types';\n\n/**\n * Common MCP server configurations for easy setup\n */\nexport const MCPServers = {\n  /**\n   * Filesystem server for file operations\n   */\n  filesystem: (path: string): MCPServerConfig => ({\n    name: 'filesystem',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-filesystem', path],\n    transport: 'stdio',\n    autoConnect: true,\n    additionalContext: 'This server provides access to files and directories in the current working directory.',\n    toolDescriptions: {\n      list_directory: 'Use this tool when users ask about files in the \"current directory\" or \"working directory\".',\n      read_file: 'Use this tool when users ask to see or check files in the current directory.',\n    },\n  }),\n\n  /**\n   * GitHub server for repository operations\n   */\n  github: (token?: string): MCPServerConfig => ({\n    name: 'github',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-github'],\n    ...(token && { env: { GITHUB_TOKEN: token } }),\n    transport: 'stdio',\n    autoConnect: true,\n  }),\n\n  /**\n   * Slack server for messaging operations\n   */\n  slack: (token: string): MCPServerConfig => ({\n    name: 'slack',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-slack'],\n    env: { SLACK_TOKEN: token },\n    transport: 'stdio',\n    autoConnect: true,\n  }),\n\n  /**\n   * Google Drive server for document operations\n   */\n  googleDrive: (credentials: string): MCPServerConfig => ({\n    name: 'google-drive',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-google-drive'],\n    env: { GOOGLE_CREDENTIALS: credentials },\n    transport: 'stdio',\n    autoConnect: true,\n  }),\n\n  /**\n   * PostgreSQL server for database operations\n   */\n  postgres: (connectionString: string): MCPServerConfig => ({\n    name: 'postgres',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-postgres', connectionString],\n    transport: 'stdio',\n    autoConnect: true,\n  }),\n\n  /**\n   * SQLite server for database operations\n   */\n  sqlite: (dbPath: string): MCPServerConfig => ({\n    name: 'sqlite',\n    command: 'npx',\n    args: ['-y', '@modelcontextprotocol/server-sqlite', dbPath],\n    transport: 'stdio',\n    autoConnect: true,\n  }),\n\n  /**\n   * Custom server configuration\n   */\n  custom: (config: MCPServerConfig): MCPServerConfig => config,\n};\n\n/**\n * Validate MCP server configuration\n */\nexport function validateServerConfig(config: MCPServerConfig): string[] {\n  const errors: string[] = [];\n\n  if (!config.name) {\n    errors.push('Server name is required');\n  }\n\n  if (!config.command) {\n    errors.push('Server command is required');\n  }\n\n  if (!config.args || !Array.isArray(config.args)) {\n    errors.push('Server args must be an array');\n  }\n\n  if (config.transport && !['stdio', 'http', 'websocket'].includes(config.transport)) {\n    errors.push('Invalid transport type. Must be stdio, http, or websocket');\n  }\n\n  return errors;\n}\n\n/**\n * Create a typed MCP configuration for ConversationalAgent\n */\nexport function createMCPConfig(servers: MCPServerConfig[], autoConnect = true): { mcpServers: MCPServerConfig[] } {\n  return {\n    mcpServers: servers.map(server => ({\n      ...server,\n      autoConnect: server.autoConnect ?? autoConnect,\n    })),\n  };\n}"],"names":[],"mappings":"AAKO,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA,EAIxB,YAAY,CAAC,UAAmC;AAAA,IAC9C,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,2CAA2C,IAAI;AAAA,IAC5D,WAAW;AAAA,IACX,aAAa;AAAA,IACb,mBAAmB;AAAA,IACnB,kBAAkB;AAAA,MAChB,gBAAgB;AAAA,MAChB,WAAW;AAAA,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA,EAMF,QAAQ,CAAC,WAAqC;AAAA,IAC5C,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,qCAAqC;AAAA,IAClD,GAAI,SAAS,EAAE,KAAK,EAAE,cAAc,QAAM;AAAA,IAC1C,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMf,OAAO,CAAC,WAAoC;AAAA,IAC1C,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,oCAAoC;AAAA,IACjD,KAAK,EAAE,aAAa,MAAA;AAAA,IACpB,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMf,aAAa,CAAC,iBAA0C;AAAA,IACtD,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,2CAA2C;AAAA,IACxD,KAAK,EAAE,oBAAoB,YAAA;AAAA,IAC3B,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMf,UAAU,CAAC,sBAA+C;AAAA,IACxD,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,yCAAyC,gBAAgB;AAAA,IACtE,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMf,QAAQ,CAAC,YAAqC;AAAA,IAC5C,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM,CAAC,MAAM,uCAAuC,MAAM;AAAA,IAC1D,WAAW;AAAA,IACX,aAAa;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMf,QAAQ,CAAC,WAA6C;AACxD;AAKO,SAAS,qBAAqB,QAAmC;AACtE,QAAM,SAAmB,CAAA;AAEzB,MAAI,CAAC,OAAO,MAAM;AAChB,WAAO,KAAK,yBAAyB;AAAA,EACvC;AAEA,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO,KAAK,4BAA4B;AAAA,EAC1C;AAEA,MAAI,CAAC,OAAO,QAAQ,CAAC,MAAM,QAAQ,OAAO,IAAI,GAAG;AAC/C,WAAO,KAAK,8BAA8B;AAAA,EAC5C;AAEA,MAAI,OAAO,aAAa,CAAC,CAAC,SAAS,QAAQ,WAAW,EAAE,SAAS,OAAO,SAAS,GAAG;AAClF,WAAO,KAAK,2DAA2D;AAAA,EACzE;AAEA,SAAO;AACT;AAKO,SAAS,gBAAgB,SAA4B,cAAc,MAAyC;AACjH,SAAO;AAAA,IACL,YAAY,QAAQ,IAAI,CAAA,YAAW;AAAA,MACjC,GAAG;AAAA,MACH,aAAa,OAAO,eAAe;AAAA,IAAA,EACnC;AAAA,EAAA;AAEN;"}
+{"version":3,"file":"index14.js","sources":["../../src/forms/field-guidance-registry.ts"],"sourcesContent":["import type { FormFieldType, FieldOption } from './types';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Field guidance configuration for providing contextual help and suggestions\n */\nexport interface FieldGuidance {\n  /**\n   * Suggestions to show as placeholder or examples\n   */\n  suggestions?: string[];\n\n  /**\n   * Predefined options for select fields\n   */\n  predefinedOptions?: FieldOption[];\n\n  /**\n   * Warning messages for specific patterns to avoid\n   */\n  warnings?: {\n    pattern: RegExp;\n    message: string;\n  }[];\n\n  /**\n   * Validation rules specific to the field context\n   */\n  validationRules?: {\n    /**\n     * Patterns that should be rejected\n     */\n    rejectPatterns?: {\n      pattern: RegExp;\n      reason: string;\n    }[];\n\n    /**\n     * Minimum quality requirements\n     */\n    qualityChecks?: {\n      minNonTechnicalWords?: number;\n      requireSpecificTerms?: string[];\n      forbidTechnicalTerms?: string[];\n    };\n  };\n\n  /**\n   * Field type override for specific contexts\n   */\n  fieldTypeOverride?: FormFieldType;\n\n  /**\n   * Help text specific to the tool context\n   */\n  contextualHelpText?: string;\n}\n\n/**\n * Tool-specific field configurations\n */\nexport interface ToolFieldConfiguration {\n  /**\n   * Tool name or pattern to match\n   */\n  toolPattern: string | RegExp;\n\n  /**\n   * Field-specific guidance\n   */\n  fields: Record<string, FieldGuidance>;\n\n  /**\n   * Global guidance for all fields in this tool\n   */\n  globalGuidance?: {\n    /**\n     * General warnings to show\n     */\n    warnings?: string[];\n\n    /**\n     * Quality standards for this tool\n     */\n    qualityStandards?: string[];\n  };\n}\n\n/**\n * Registry for field guidance configurations\n */\nclass FieldGuidanceRegistry {\n  private configurations: ToolFieldConfiguration[] = [];\n  private providers: Array<{\n    id: string;\n    priority: number;\n    pattern: string | RegExp;\n    provider: FieldGuidanceProvider;\n    order: number;\n  }> = [];\n  private registerOrderCounter = 0;\n  private logger: Logger;\n\n  constructor() {\n    this.logger = new Logger({ module: 'FieldGuidanceRegistry' });\n  }\n\n  /**\n   * Register field guidance for a specific tool\n   */\n  registerToolConfiguration(config: ToolFieldConfiguration): void {\n    this.configurations.push(config);\n  }\n\n  /**\n   * Register a provider for dynamic field/global guidance\n   */\n  registerToolProvider(\n    toolPattern: string | RegExp,\n    provider: FieldGuidanceProvider,\n    options?: { id?: string; priority?: number }\n  ): string {\n    const id = options?.id ?? `provider-${this.providers.length + 1}`;\n    const priority = options?.priority ?? 0;\n    if (this.providers.some((p) => p.id === id)) {\n      this.logger.error('Duplicate provider id', { id });\n      throw new Error('DUPLICATE_PROVIDER_ID');\n    }\n    this.providers.push({\n      id,\n      priority,\n      pattern: toolPattern,\n      provider,\n      order: this.registerOrderCounter++,\n    });\n    return id;\n  }\n\n  /** Unregister a provider by id */\n  unregisterProvider(id: string): void {\n    this.providers = this.providers.filter((p) => p.id !== id);\n  }\n\n  /** List registered providers */\n  listProviders(): Array<{\n    id: string;\n    priority: number;\n    pattern: string | RegExp;\n  }> {\n    return this.providers.map(({ id, priority, pattern }) => ({\n      id,\n      priority,\n      pattern,\n    }));\n  }\n\n  /**\n   * Get field guidance for a specific tool and field\n   */\n  getFieldGuidance(toolName: string, fieldName: string): FieldGuidance | null {\n    if (process.env.CA_FORM_GUIDANCE_ENABLED === 'false') {\n      return null;\n    }\n    for (const config of this.configurations) {\n      const matches =\n        typeof config.toolPattern === 'string'\n          ? toolName.toLowerCase().includes(config.toolPattern.toLowerCase())\n          : config.toolPattern.test(toolName);\n\n      if (matches && config.fields[fieldName]) {\n        const staticGuidance = config.fields[fieldName];\n        const providers = this.pickMatchingProviders(toolName);\n        if (providers.length === 0) return staticGuidance;\n        let merged: FieldGuidance = { ...staticGuidance };\n        for (const p of [...providers].reverse()) {\n          const fromProvider = this.safeGetFieldGuidance(\n            p,\n            fieldName,\n            toolName\n          );\n          if (fromProvider) {\n            merged = this.mergeGuidance(merged, fromProvider);\n          }\n        }\n        return merged;\n      }\n    }\n    const providers = this.pickMatchingProviders(toolName);\n    if (providers.length > 0) {\n      let merged: FieldGuidance = {};\n      for (const p of [...providers].reverse()) {\n        const g = this.safeGetFieldGuidance(p, fieldName, toolName);\n        if (g) merged = this.mergeGuidance(merged, g);\n      }\n      return Object.keys(merged).length > 0 ? merged : null;\n    }\n    return null;\n  }\n\n  /**\n   * Get global guidance for a tool\n   */\n  getGlobalGuidance(\n    toolName: string\n  ): ToolFieldConfiguration['globalGuidance'] | null {\n    if (process.env.CA_FORM_GUIDANCE_ENABLED === 'false') {\n      return null;\n    }\n    for (const config of this.configurations) {\n      const matches =\n        typeof config.toolPattern === 'string'\n          ? toolName.toLowerCase().includes(config.toolPattern.toLowerCase())\n          : config.toolPattern.test(toolName);\n\n      if (matches && config.globalGuidance) {\n        const base = config.globalGuidance;\n        const providers = this.pickMatchingProviders(toolName);\n        if (providers.length === 0) return base;\n        let mergedWarnings: string[] | undefined = base.warnings;\n        let mergedQuality: string[] | undefined = base.qualityStandards;\n        for (const p of [...providers].reverse()) {\n          const fromProvider = this.safeGetGlobalGuidance(p, toolName);\n          if (fromProvider) {\n            mergedWarnings = fromProvider.warnings ?? mergedWarnings;\n            mergedQuality = fromProvider.qualityStandards ?? mergedQuality;\n          }\n        }\n        const result: NonNullable<ToolFieldConfiguration['globalGuidance']> =\n          {};\n        if (mergedWarnings !== undefined) result.warnings = mergedWarnings;\n        if (mergedQuality !== undefined)\n          result.qualityStandards = mergedQuality;\n        return result;\n      }\n    }\n    const providers = this.pickMatchingProviders(toolName);\n    if (providers.length > 0) {\n      let mergedWarnings: string[] | undefined;\n      let mergedQuality: string[] | undefined;\n      for (const p of [...providers].reverse()) {\n        const g = this.safeGetGlobalGuidance(p, toolName);\n        if (g) {\n          mergedWarnings = g.warnings ?? mergedWarnings;\n          mergedQuality = g.qualityStandards ?? mergedQuality;\n        }\n      }\n      const result: NonNullable<ToolFieldConfiguration['globalGuidance']> = {};\n      if (mergedWarnings !== undefined) result.warnings = mergedWarnings;\n      if (mergedQuality !== undefined) result.qualityStandards = mergedQuality;\n      return Object.keys(result).length > 0 ? result : null;\n    }\n    return null;\n  }\n\n  /**\n   * Validate field value against guidance rules\n   */\n  validateFieldValue(\n    toolName: string,\n    fieldName: string,\n    value: unknown\n  ): {\n    isValid: boolean;\n    warnings: string[];\n    errors: string[];\n  } {\n    const guidance = this.getFieldGuidance(toolName, fieldName);\n    const warnings: string[] = [];\n    const errors: string[] = [];\n\n    if (!guidance || typeof value !== 'string') {\n      return { isValid: true, warnings, errors };\n    }\n\n    if (guidance.warnings) {\n      for (const warning of guidance.warnings) {\n        if (warning.pattern.test(value)) {\n          warnings.push(warning.message);\n        }\n      }\n    }\n\n    if (guidance.validationRules) {\n      const { rejectPatterns, qualityChecks } = guidance.validationRules;\n\n      if (rejectPatterns) {\n        for (const reject of rejectPatterns) {\n          if (reject.pattern.test(value)) {\n            errors.push(`Rejected: ${reject.reason}`);\n          }\n        }\n      }\n\n      if (qualityChecks) {\n        if (qualityChecks.forbidTechnicalTerms) {\n          const lowerValue = value.toLowerCase();\n          for (const term of qualityChecks.forbidTechnicalTerms) {\n            if (lowerValue.includes(term.toLowerCase())) {\n              errors.push(\n                `Avoid technical terms like \"${term}\" in NFT metadata`\n              );\n            }\n          }\n        }\n\n        if (qualityChecks.requireSpecificTerms) {\n          const lowerValue = value.toLowerCase();\n          const hasRequired = qualityChecks.requireSpecificTerms.some((term) =>\n            lowerValue.includes(term.toLowerCase())\n          );\n          if (!hasRequired) {\n            warnings.push(\n              `Consider including terms like: ${qualityChecks.requireSpecificTerms.join(\n                ', '\n              )}`\n            );\n          }\n        }\n\n        if (qualityChecks.minNonTechnicalWords) {\n          const words = value.split(/\\s+/).filter((word) => word.length > 2);\n          if (words.length < qualityChecks.minNonTechnicalWords) {\n            warnings.push(\n              `Consider providing more descriptive content (at least ${qualityChecks.minNonTechnicalWords} meaningful words)`\n            );\n          }\n        }\n      }\n    }\n\n    return {\n      isValid: errors.length === 0,\n      warnings,\n      errors,\n    };\n  }\n\n  /**\n   * Clear all configurations (useful for testing)\n   */\n  clear(): void {\n    this.configurations = [];\n    this.providers = [];\n    this.registerOrderCounter = 0;\n  }\n\n  /** Choose matching provider by priority then last-in wins */\n  private pickMatchingProviders(toolName: string): Array<{\n    id: string;\n    provider: FieldGuidanceProvider;\n    priority: number;\n    order: number;\n  }> {\n    const matches = this.providers.filter((p) =>\n      typeof p.pattern === 'string'\n        ? toolName.toLowerCase().includes((p.pattern as string).toLowerCase())\n        : (p.pattern as RegExp).test(toolName)\n    );\n    const sorted = matches.sort((a, b) => {\n      if (b.priority !== a.priority) return b.priority - a.priority;\n      return b.order - a.order; // last-in wins when equal priority\n    });\n    return sorted.map((m) => ({\n      id: m.id,\n      provider: m.provider,\n      priority: m.priority,\n      order: m.order,\n    }));\n  }\n\n  private safeGetFieldGuidance(\n    winner: { id: string; provider: FieldGuidanceProvider },\n    fieldName: string,\n    toolName: string\n  ): FieldGuidance | null {\n    try {\n      return winner.provider.getFieldGuidance(fieldName, { toolName }) ?? null;\n    } catch (err) {\n      this.logger.warn('Provider getFieldGuidance failed', {\n        id: winner.id,\n        err,\n      });\n      return null;\n    }\n  }\n\n  private safeGetGlobalGuidance(\n    winner: { id: string; provider: FieldGuidanceProvider },\n    toolName: string\n  ): ToolFieldConfiguration['globalGuidance'] | null {\n    try {\n      return winner.provider.getGlobalGuidance?.(toolName) ?? null;\n    } catch (err) {\n      this.logger.warn('Provider getGlobalGuidance failed', {\n        id: winner.id,\n        err,\n      });\n      return null;\n    }\n  }\n\n  private mergeGuidance(\n    base: FieldGuidance,\n    over: FieldGuidance\n  ): FieldGuidance {\n    const out: FieldGuidance = {};\n    const suggestions = over.suggestions ?? base.suggestions;\n    if (suggestions !== undefined) out.suggestions = suggestions;\n    const predefinedOptions = over.predefinedOptions ?? base.predefinedOptions;\n    if (predefinedOptions !== undefined)\n      out.predefinedOptions = predefinedOptions;\n    const warnings = over.warnings ?? base.warnings;\n    if (warnings !== undefined) out.warnings = warnings;\n    const validationRules = over.validationRules ?? base.validationRules;\n    if (validationRules !== undefined) out.validationRules = validationRules;\n    const fieldTypeOverride = over.fieldTypeOverride ?? base.fieldTypeOverride;\n    if (fieldTypeOverride !== undefined)\n      out.fieldTypeOverride = fieldTypeOverride;\n    const contextualHelpText =\n      over.contextualHelpText ?? base.contextualHelpText;\n    if (contextualHelpText !== undefined)\n      out.contextualHelpText = contextualHelpText;\n    return out;\n  }\n}\n\nexport const fieldGuidanceRegistry = new FieldGuidanceRegistry();\n\n/**\n * Provider interface (optional, for dynamic guidance)\n */\nexport interface FieldGuidanceProvider {\n  getFieldGuidance(\n    fieldName: string,\n    ctx: { toolName: string }\n  ): FieldGuidance | null;\n  getGlobalGuidance?(\n    toolName: string\n  ): ToolFieldConfiguration['globalGuidance'] | null;\n}\n"],"names":["providers"],"mappings":"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"}