@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/domain-utils.js

@@ -0,0 +1,143 @@
+/**
+ * Utility functions for domain extraction and validation
+ */
+/**
+ * Extracts domain from various input formats
+ *
+ * @param input - Input string that may contain a domain, URL, or email
+ * @returns Extracted domain or null if no valid domain found
+ * @example
+ * ```typescript
+ * extractDomain("https://example.com/path") // Returns "example.com"
+ * extractDomain("john@example.com") // Returns "example.com"
+ * extractDomain("example.com") // Returns "example.com"
+ * extractDomain("company name") // Returns null
+ * ```
+ */
+export function extractDomain(input) {
+    if (!input || typeof input !== 'string') {
+        return null;
+    }
+    // Clean up input
+    const cleanInput = input.trim().toLowerCase();
+    // Check for email format
+    const emailMatch = cleanInput.match(/^[^\s@]+@([^\s@]+\.[^\s@]+)$/);
+    if (emailMatch) {
+        return emailMatch[1];
+    }
+    // Check for URL format
+    try {
+        const url = new URL(cleanInput.startsWith('http') ? cleanInput : `https://${cleanInput}`);
+        const hostname = url.hostname;
+        // Validate that hostname looks like a domain
+        if (isValidDomain(hostname)) {
+            return normalizeDomain(hostname);
+        }
+    }
+    catch {
+        // Not a valid URL, continue with other checks
+    }
+    // Check if input is already a domain
+    if (isValidDomain(cleanInput)) {
+        return normalizeDomain(cleanInput);
+    }
+    // Try to extract domain from text that might contain a domain
+    const domainPattern = /(?:https?:\/\/)?(?:www\.)?([a-zA-Z0-9-]+\.[a-zA-Z]{2,})/;
+    const match = cleanInput.match(domainPattern);
+    if (match && isValidDomain(match[1])) {
+        return normalizeDomain(match[1]);
+    }
+    return null;
+}
+/**
+ * Validates if a string is a valid domain format
+ *
+ * @param domain - Domain string to validate
+ * @returns True if domain appears valid
+ */
+export function isValidDomain(domain) {
+    if (!domain || typeof domain !== 'string') {
+        return false;
+    }
+    // Basic domain validation
+    const domainRegex = /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}$/;
+    return domainRegex.test(domain) && domain.length <= 253;
+}
+/**
+ * Normalizes domain for consistent matching
+ *
+ * @param domain - Domain to normalize
+ * @returns Normalized domain
+ */
+export function normalizeDomain(domain) {
+    if (!domain) {
+        return '';
+    }
+    return domain
+        .trim()
+        .toLowerCase()
+        .replace(/^www\./, '');
+}
+/**
+ * Checks if a query likely contains a domain
+ *
+ * @param query - Search query to analyze
+ * @returns True if query appears to contain domain information
+ */
+export function hasDomainIndicators(query) {
+    if (!query) {
+        return false;
+    }
+    const indicators = [
+        /\.(com|org|net|edu|gov|mil|io|co|ai|tech|app|dev|xyz)/i,
+        /@[a-zA-Z0-9-]+\./,
+        /https?:\/\//,
+        /www\./,
+    ];
+    return indicators.some((pattern) => pattern.test(query));
+}
+/**
+ * Extracts multiple potential domains from a query
+ *
+ * @param query - Query that may contain multiple domains
+ * @returns Array of extracted domains
+ */
+export function extractAllDomains(query) {
+    if (!query) {
+        return [];
+    }
+    const domains = [];
+    // Extract email domains
+    const emailMatches = query.match(/[^\s@]+@([^\s@]+\.[^\s@]+)/g);
+    if (emailMatches) {
+        emailMatches.forEach((email) => {
+            const domain = extractDomain(email);
+            if (domain) {
+                domains.push(domain);
+            }
+        });
+    }
+    // Extract URL domains
+    const urlMatches = query.match(/https?:\/\/[^\s]+/g);
+    if (urlMatches) {
+        urlMatches.forEach((url) => {
+            const domain = extractDomain(url);
+            if (domain) {
+                domains.push(domain);
+            }
+        });
+    }
+    // Extract standalone domains (including subdomains)
+    const domainMatches = query.match(/(?:^|\s|,)([a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*\.[a-zA-Z]{2,})(?=\s|,|$)/g);
+    if (domainMatches) {
+        domainMatches.forEach((match) => {
+            const domain = extractDomain(match.trim().replace(/^[,\s]+/, ''));
+            if (domain) {
+                domains.push(domain);
+            }
+        });
+    }
+    // Remove duplicates and normalize
+    return Array.from(new Set(domains.map(normalizeDomain)));
+}
+//# sourceMappingURL=domain-utils.js.map

package/dist/utils/domain-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-utils.js","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/dynamic-import.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Utility for dynamically importing ES modules
+ *
+ * This module provides a wrapper around the dynamic import() function to make it easier to
+ * work with ES modules in a Node.js environment that may be transitioning from CommonJS.
+ * It helps address common compatibility issues that arise when mixing module systems,
+ * such as "require is not defined in ES module scope" errors.
+ *
+ * Use cases:
+ * 1. Loading modules at runtime based on configuration
+ * 2. Conditional loading of modules to improve startup performance
+ * 3. Handling imports that may not be available in all environments
+ * 4. Supporting both CommonJS and ES module imports in the same codebase
+ */
+/**
+ * Dynamically imports a module in an environment-agnostic way
+ *
+ * This function wraps the standard dynamic import() with error handling and logging.
+ * It can be used to load both ES modules and CommonJS modules in an ES module context.
+ *
+ * @param moduleName - Name of the module to import (e.g., 'handlebars', './config.js')
+ * @returns Promise resolving to the imported module
+ * @throws Error if the module cannot be imported
+ *
+ * @example
+ * // Load a module dynamically
+ * const handlebars = await dynamicImport('handlebars');
+ *
+ * // Use with destructuring
+ * const { compile, registerHelper } = await dynamicImport('handlebars');
+ */
+export declare function dynamicImport(moduleName: string): Promise<unknown>;
+//# sourceMappingURL=dynamic-import.d.ts.map

package/dist/utils/dynamic-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-import.d.ts","sourceRoot":"","sources":["../../src/utils/dynamic-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBxE"}

package/dist/utils/dynamic-import.js

@@ -0,0 +1,42 @@
+/**
+ * Utility for dynamically importing ES modules
+ *
+ * This module provides a wrapper around the dynamic import() function to make it easier to
+ * work with ES modules in a Node.js environment that may be transitioning from CommonJS.
+ * It helps address common compatibility issues that arise when mixing module systems,
+ * such as "require is not defined in ES module scope" errors.
+ *
+ * Use cases:
+ * 1. Loading modules at runtime based on configuration
+ * 2. Conditional loading of modules to improve startup performance
+ * 3. Handling imports that may not be available in all environments
+ * 4. Supporting both CommonJS and ES module imports in the same codebase
+ */
+import { error, OperationType } from './logger.js';
+/**
+ * Dynamically imports a module in an environment-agnostic way
+ *
+ * This function wraps the standard dynamic import() with error handling and logging.
+ * It can be used to load both ES modules and CommonJS modules in an ES module context.
+ *
+ * @param moduleName - Name of the module to import (e.g., 'handlebars', './config.js')
+ * @returns Promise resolving to the imported module
+ * @throws Error if the module cannot be imported
+ *
+ * @example
+ * // Load a module dynamically
+ * const handlebars = await dynamicImport('handlebars');
+ *
+ * // Use with destructuring
+ * const { compile, registerHelper } = await dynamicImport('handlebars');
+ */
+export async function dynamicImport(moduleName) {
+    try {
+        return await import(moduleName);
+    }
+    catch (importError) {
+        error('utils/dynamic-import', `Error importing module ${moduleName}`, importError, { moduleName }, 'dynamicImport', OperationType.SYSTEM);
+        throw new Error(`Failed to import module "${moduleName}": ${importError?.message || 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=dynamic-import.js.map

package/dist/utils/dynamic-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-import.js","sourceRoot":"","sources":["../../src/utils/dynamic-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,WAAoB,EAAE,CAAC;QAC9B,KAAK,CACH,sBAAsB,EACtB,0BAA0B,UAAU,EAAE,EACtC,WAAW,EACX,EAAE,UAAU,EAAE,EACd,eAAe,EACf,aAAa,CAAC,MAAM,CACrB,CAAC;QACF,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,MACnC,WAAqB,EAAE,OAAO,IAAI,eACrC,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/enhanced-validation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Enhanced validation utilities for Attio API field validation
+ * Provides comprehensive validation based on Attio attribute metadata
+ */
+import { ValidationResult } from './validation.js';
+/**
+ * Enhanced validation result with detailed error information
+ */
+export interface EnhancedValidationResult extends ValidationResult {
+    warnings: string[];
+    readOnlyFields?: string[];
+    missingFields?: string[];
+    invalidFields?: string[];
+    error?: string;
+}
+/**
+ * Enhanced error response with actionable information
+ */
+export interface EnhancedErrorResponse {
+    error: string;
+    warnings: string[];
+    operation: string;
+    suggestions?: string[];
+    invalidFields?: string[];
+    missingFields?: string[];
+}
+/**
+ * Validate read-only fields against provided data
+ */
+export declare function validateReadOnlyFields(data: Record<string, unknown>, readOnlyFields: string[]): EnhancedValidationResult;
+/**
+ * Validate field existence for required fields
+ */
+export declare function validateFieldExistence(data: Record<string, unknown>, requiredFields: string[]): EnhancedValidationResult;
+/**
+ * Validate select field values against allowed options
+ */
+export declare function validateSelectField(value: unknown, options: string[], fieldName?: string): EnhancedValidationResult;
+/**
+ * Comprehensive record field validation using Attio metadata
+ */
+export declare function validateRecordFields(resourceType: string, data: Record<string, unknown>, isUpdate: boolean): Promise<EnhancedValidationResult>;
+/**
+ * Create enhanced error response with actionable suggestions
+ */
+export declare function createEnhancedErrorResponse(validation: EnhancedValidationResult, operation: string): EnhancedErrorResponse;
+//# sourceMappingURL=enhanced-validation.d.ts.map

package/dist/utils/enhanced-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-validation.d.ts","sourceRoot":"","sources":["../../src/utils/enhanced-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EAAE,GACvB,wBAAwB,CAkB1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EAAE,GACvB,wBAAwB,CAmB1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,wBAAwB,CAiC1B;AA2FD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,wBAAwB,CAAC,CAwGnC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CA2CvB"}

package/dist/utils/enhanced-validation.js

@@ -0,0 +1,254 @@
+/**
+ * Enhanced validation utilities for Attio API field validation
+ * Provides comprehensive validation based on Attio attribute metadata
+ */
+import { getObjectAttributeMetadata, getFieldValidationRules, } from '../api/attribute-types.js';
+/**
+ * Validate read-only fields against provided data
+ */
+export function validateReadOnlyFields(data, readOnlyFields) {
+    const errors = [];
+    const warnings = [];
+    const violatedFields = [];
+    for (const field of readOnlyFields) {
+        if (field in data && data[field] !== undefined) {
+            errors.push(`Field '${field}' is read-only and cannot be modified`);
+            violatedFields.push(field);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        readOnlyFields: violatedFields,
+    };
+}
+/**
+ * Validate field existence for required fields
+ */
+export function validateFieldExistence(data, requiredFields) {
+    const errors = [];
+    const warnings = [];
+    const missing = [];
+    for (const field of requiredFields) {
+        const value = data[field];
+        if (value === undefined || value === null || value === '') {
+            errors.push(`Required field '${field}' is missing or empty`);
+            missing.push(field);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        missingFields: missing,
+    };
+}
+/**
+ * Validate select field values against allowed options
+ */
+export function validateSelectField(value, options, fieldName) {
+    const errors = [];
+    const warnings = [];
+    const fieldLabel = fieldName || 'field';
+    if (value === undefined || value === null) {
+        return { isValid: true, errors, warnings };
+    }
+    // Handle array values (multiselect)
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (typeof item === 'string' && !options.includes(item)) {
+                errors.push(`Invalid option '${item}' for ${fieldLabel}. Valid options: ${options.join(', ')}`);
+            }
+        }
+    }
+    else if (typeof value === 'string' && !options.includes(value)) {
+        errors.push(`Invalid option '${value}' for ${fieldLabel}. Valid options: ${options.join(', ')}`);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate field type and format
+ */
+async function validateFieldType(fieldName, value, rules) {
+    const errors = [];
+    const warnings = [];
+    if (value === undefined || value === null) {
+        if (rules.required) {
+            errors.push(`Required field '${fieldName}' cannot be null or undefined`);
+        }
+        return { isValid: errors.length === 0, errors, warnings };
+    }
+    // Type validation
+    switch (rules.type) {
+        case 'string':
+            if (typeof value !== 'string') {
+                errors.push(`Field '${fieldName}' must be a string, got ${typeof value}`);
+            }
+            break;
+        case 'number':
+            if (typeof value !== 'number' || isNaN(value)) {
+                errors.push(`Field '${fieldName}' must be a valid number`);
+            }
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                errors.push(`Field '${fieldName}' must be a boolean`);
+            }
+            break;
+        case 'array':
+            if (!Array.isArray(value)) {
+                errors.push(`Field '${fieldName}' must be an array`);
+            }
+            break;
+        case 'object':
+            if (typeof value !== 'object' || Array.isArray(value)) {
+                errors.push(`Field '${fieldName}' must be an object`);
+            }
+            break;
+    }
+    // Pattern validation (email, URL, phone)
+    if (rules.pattern && typeof value === 'string') {
+        const regex = new RegExp(rules.pattern);
+        if (!regex.test(value)) {
+            switch (rules.pattern) {
+                case '^[^@]+@[^@]+\\.[^@]+$':
+                    errors.push(`Field '${fieldName}' must be a valid email address`);
+                    break;
+                case '^https?://':
+                    errors.push(`Field '${fieldName}' must be a valid URL starting with http:// or https://`);
+                    break;
+                case '^\\+?[0-9-()\\s]+$':
+                    errors.push(`Field '${fieldName}' must be a valid phone number`);
+                    break;
+                default:
+                    errors.push(`Field '${fieldName}' does not match required format`);
+            }
+        }
+    }
+    // Enum validation for select fields
+    if (rules.enum && rules.enum.length > 0) {
+        const selectValidation = validateSelectField(value, rules.enum.map(String), fieldName);
+        errors.push(...selectValidation.errors);
+        warnings.push(...selectValidation.warnings);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Comprehensive record field validation using Attio metadata
+ */
+export async function validateRecordFields(resourceType, data, isUpdate) {
+    const errors = [];
+    const warnings = [];
+    const invalidFields = [];
+    const missingFields = [];
+    const readOnlyFields = [];
+    try {
+        // Get attribute metadata for the resource type
+        const attributeMetadata = await getObjectAttributeMetadata(resourceType);
+        if (attributeMetadata.size === 0) {
+            warnings.push(`No attribute metadata found for resource type '${resourceType}'. Validation may be incomplete.`);
+        }
+        // Validate each field in the data
+        for (const [fieldName, value] of Object.entries(data)) {
+            const metadata = attributeMetadata.get(fieldName);
+            if (!metadata) {
+                // For tasks, provide specific guidance about invalid fields (Issue #417)
+                if (resourceType === 'tasks') {
+                    errors.push(`Field '${fieldName}' is not recognized for tasks. Valid task fields are: content, status, due_date, assignee_id, record_id`);
+                    invalidFields.push(fieldName);
+                }
+                else {
+                    warnings.push(`Field '${fieldName}' is not recognized for resource type '${resourceType}'`);
+                }
+                continue;
+            }
+            // Check if field is writable
+            if (metadata.is_writable === false) {
+                errors.push(`Field '${fieldName}' is read-only and cannot be modified`);
+                readOnlyFields.push(fieldName);
+                invalidFields.push(fieldName);
+                continue;
+            }
+            // Get validation rules for this field
+            try {
+                const validationRules = await getFieldValidationRules(resourceType, fieldName);
+                // Validate field type and format
+                const typeValidation = await validateFieldType(fieldName, value, validationRules);
+                errors.push(...typeValidation.errors);
+                warnings.push(...typeValidation.warnings);
+                if (!typeValidation.isValid) {
+                    invalidFields.push(fieldName);
+                }
+            }
+            catch (ruleError) {
+                warnings.push(`Could not get validation rules for field '${fieldName}': ${ruleError instanceof Error ? ruleError.message : 'Unknown error'}`);
+            }
+        }
+        // For create operations, check required fields
+        if (!isUpdate) {
+            const requiredFields = [];
+            for (const [fieldName, metadata] of Array.from(attributeMetadata)) {
+                if (metadata.is_required && metadata.is_writable !== false) {
+                    requiredFields.push(fieldName);
+                }
+            }
+            const requiredFieldValidation = validateFieldExistence(data, requiredFields);
+            errors.push(...requiredFieldValidation.errors);
+            warnings.push(...requiredFieldValidation.warnings);
+            missingFields.push(...(requiredFieldValidation.missingFields || []));
+        }
+    }
+    catch (metadataError) {
+        const errorMessage = metadataError instanceof Error ? metadataError.message : 'Unknown error';
+        errors.push(`Failed to validate fields: ${errorMessage}`);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        readOnlyFields,
+        missingFields,
+        invalidFields,
+    };
+}
+/**
+ * Create enhanced error response with actionable suggestions
+ */
+export function createEnhancedErrorResponse(validation, operation) {
+    const suggestions = [];
+    // Generate helpful suggestions based on validation errors
+    if (validation.missingFields && validation.missingFields.length > 0) {
+        suggestions.push(`Add required fields: ${validation.missingFields.join(', ')}`);
+    }
+    if (validation.readOnlyFields && validation.readOnlyFields.length > 0) {
+        suggestions.push(`Remove read-only fields: ${validation.readOnlyFields.join(', ')}`);
+    }
+    if (validation.invalidFields && validation.invalidFields.length > 0) {
+        suggestions.push(`Fix invalid field values for: ${validation.invalidFields.join(', ')}`);
+    }
+    // Add operation-specific suggestions
+    if (operation === 'create-record' && validation.missingFields?.length) {
+        suggestions.push('Ensure all required fields have values before creating a record');
+    }
+    if (operation === 'update-record' && validation.readOnlyFields?.length) {
+        suggestions.push('Use separate calls to update read-only fields if they support it, or remove them from the update');
+    }
+    return {
+        error: validation.errors.join('; '),
+        warnings: validation.warnings,
+        operation,
+        suggestions: suggestions.length > 0 ? suggestions : undefined,
+        invalidFields: validation.invalidFields,
+        missingFields: validation.missingFields,
+    };
+}
+//# sourceMappingURL=enhanced-validation.js.map

package/dist/utils/enhanced-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-validation.js","sourceRoot":"","sources":["../../src/utils/enhanced-validation.ts"],"names":[],"mappings":"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"}

package/dist/utils/error-detection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Explicit error detection utilities for MCP responses
+ *
+ * Provides precise error detection logic to avoid false positives
+ * from string-based heuristics and empty/false responses that
+ * are actually valid success states.
+ */
+export interface ErrorAnalysis {
+    isError: boolean;
+    reason?: 'null_or_undefined_result' | 'empty_response' | 'explicit_success_false' | 'meaningful_error_object' | 'meaningful_error_string' | 'errors_array_has_items' | 'api_error_array' | 'empty_array';
+}
+/**
+ * Compute error status with explicit detection logic only
+ *
+ * Avoids false positives by only flagging:
+ * - Null/undefined results
+ * - Explicit success: false
+ * - Meaningful error objects with messages
+ * - Non-empty error strings
+ * - Error arrays with actual error items
+ *
+ * @param result - Result object to analyze
+ * @param opts - Optional context for tool-specific logic
+ * @returns Error analysis with explicit reasoning
+ */
+export declare function computeErrorWithContext(result: unknown, opts?: {
+    toolName?: string;
+    httpStatus?: number;
+}): ErrorAnalysis;
+/**
+ * Check if a result should have empty error fields removed
+ *
+ * @param result - Result to clean
+ * @returns Cleaned result without empty error indicators
+ */
+export declare function cleanEmptyErrorFields(result: unknown): unknown;
+//# sourceMappingURL=error-detection.d.ts.map

package/dist/utils/error-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-detection.d.ts","sourceRoot":"","sources":["../../src/utils/error-detection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EACH,0BAA0B,GAC1B,gBAAgB,GAChB,wBAAwB,GACxB,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,iBAAiB,GACjB,aAAa,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,aAAa,CA2If;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAsB9D"}