@tiangong-lca/tidas-sdk 0.1.20 → 0.1.21

package/dist/core/config/GlobalConfig.d.ts

@@ -0,0 +1,60 @@
+import { ValidationConfig, ValidationMode } from './ValidationConfig';
+/**
+ * Global configuration for TIDAS SDK
+ */
+declare class TidasGlobalConfig {
+    private _defaultValidationConfig;
+    /**
+     * Get the current default validation configuration
+     */
+    getDefaultValidationConfig(): ValidationConfig;
+    /**
+     * Set the default validation mode globally
+     */
+    setDefaultValidationMode(mode: ValidationMode): void;
+    /**
+     * Set the complete default validation configuration
+     */
+    setDefaultValidationConfig(config: Partial<ValidationConfig>): void;
+    /**
+     * Reset to default configuration
+     */
+    resetToDefaults(): void;
+    /**
+     * Load configuration from environment variables
+     */
+    loadFromEnvironment(): void;
+}
+/**
+ * Global configuration instance
+ */
+export declare const globalConfig: TidasGlobalConfig;
+/**
+ * Convenience functions for global configuration
+ */
+/**
+ * Set global validation mode
+ */
+export declare function setGlobalValidationMode(mode: ValidationMode): void;
+/**
+ * Get current global validation mode
+ */
+export declare function getGlobalValidationMode(): ValidationMode;
+/**
+ * Set global validation configuration
+ */
+export declare function setGlobalValidationConfig(config: Partial<ValidationConfig>): void;
+/**
+ * Get current global validation configuration
+ */
+export declare function getGlobalValidationConfig(): ValidationConfig;
+/**
+ * Reset global configuration to defaults
+ */
+export declare function resetGlobalConfig(): void;
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfigFromEnvironment(): void;
+export {};
+//# sourceMappingURL=GlobalConfig.d.ts.map

package/dist/core/config/GlobalConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalConfig.d.ts","sourceRoot":"","sources":["../../../src/core/config/GlobalConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAA6B,MAAM,oBAAoB,CAAC;AAEjG;;GAEG;AACH,cAAM,iBAAiB;IACrB,OAAO,CAAC,wBAAwB,CAAsD;IAEtF;;OAEG;IACH,0BAA0B,IAAI,gBAAgB;IAI9C;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIpD;;OAEG;IACH,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAOnE;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,mBAAmB,IAAI,IAAI;CAgB5B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,mBAA0B,CAAC;AAEpD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAExD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAEjF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,gBAAgB,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/core/config/GlobalConfig.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalConfig = void 0;
+exports.setGlobalValidationMode = setGlobalValidationMode;
+exports.getGlobalValidationMode = getGlobalValidationMode;
+exports.setGlobalValidationConfig = setGlobalValidationConfig;
+exports.getGlobalValidationConfig = getGlobalValidationConfig;
+exports.resetGlobalConfig = resetGlobalConfig;
+exports.loadConfigFromEnvironment = loadConfigFromEnvironment;
+const ValidationConfig_1 = require("./ValidationConfig");
+/**
+ * Global configuration for TIDAS SDK
+ */
+class TidasGlobalConfig {
+    constructor() {
+        this._defaultValidationConfig = { ...ValidationConfig_1.DEFAULT_VALIDATION_CONFIG };
+    }
+    /**
+     * Get the current default validation configuration
+     */
+    getDefaultValidationConfig() {
+        return { ...this._defaultValidationConfig };
+    }
+    /**
+     * Set the default validation mode globally
+     */
+    setDefaultValidationMode(mode) {
+        this._defaultValidationConfig.mode = mode;
+    }
+    /**
+     * Set the complete default validation configuration
+     */
+    setDefaultValidationConfig(config) {
+        this._defaultValidationConfig = {
+            ...this._defaultValidationConfig,
+            ...config
+        };
+    }
+    /**
+     * Reset to default configuration
+     */
+    resetToDefaults() {
+        this._defaultValidationConfig = { ...ValidationConfig_1.DEFAULT_VALIDATION_CONFIG };
+    }
+    /**
+     * Load configuration from environment variables
+     */
+    loadFromEnvironment() {
+        const envMode = process.env.TIDAS_VALIDATION_MODE;
+        if (envMode && ['strict', 'weak', 'ignore'].includes(envMode)) {
+            this._defaultValidationConfig.mode = envMode;
+        }
+        const envThrowOnError = process.env.TIDAS_THROW_ON_ERROR;
+        if (envThrowOnError !== undefined) {
+            this._defaultValidationConfig.throwOnError = envThrowOnError === 'true';
+        }
+        const envIncludeWarnings = process.env.TIDAS_INCLUDE_WARNINGS;
+        if (envIncludeWarnings !== undefined) {
+            this._defaultValidationConfig.includeWarnings = envIncludeWarnings === 'true';
+        }
+    }
+}
+/**
+ * Global configuration instance
+ */
+exports.globalConfig = new TidasGlobalConfig();
+/**
+ * Convenience functions for global configuration
+ */
+/**
+ * Set global validation mode
+ */
+function setGlobalValidationMode(mode) {
+    exports.globalConfig.setDefaultValidationMode(mode);
+}
+/**
+ * Get current global validation mode
+ */
+function getGlobalValidationMode() {
+    return exports.globalConfig.getDefaultValidationConfig().mode;
+}
+/**
+ * Set global validation configuration
+ */
+function setGlobalValidationConfig(config) {
+    exports.globalConfig.setDefaultValidationConfig(config);
+}
+/**
+ * Get current global validation configuration
+ */
+function getGlobalValidationConfig() {
+    return exports.globalConfig.getDefaultValidationConfig();
+}
+/**
+ * Reset global configuration to defaults
+ */
+function resetGlobalConfig() {
+    exports.globalConfig.resetToDefaults();
+}
+/**
+ * Load configuration from environment variables
+ */
+function loadConfigFromEnvironment() {
+    exports.globalConfig.loadFromEnvironment();
+}
+// Auto-load from environment on module initialization
+if (typeof process !== 'undefined' && process.env) {
+    loadConfigFromEnvironment();
+}
+//# sourceMappingURL=GlobalConfig.js.map

package/dist/core/config/GlobalConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalConfig.js","sourceRoot":"","sources":["../../../src/core/config/GlobalConfig.ts"],"names":[],"mappings":";;;AAwEA,0DAEC;AAKD,0DAEC;AAKD,8DAEC;AAKD,8DAEC;AAKD,8CAEC;AAKD,8DAEC;AA7GD,yDAAiG;AAEjG;;GAEG;AACH,MAAM,iBAAiB;IAAvB;QACU,6BAAwB,GAAqB,EAAE,GAAG,4CAAyB,EAAE,CAAC;IAoDxF,CAAC;IAlDC;;OAEG;IACH,0BAA0B;QACxB,OAAO,EAAE,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,IAAoB;QAC3C,IAAI,CAAC,wBAAwB,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,0BAA0B,CAAC,MAAiC;QAC1D,IAAI,CAAC,wBAAwB,GAAG;YAC9B,GAAG,IAAI,CAAC,wBAAwB;YAChC,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,wBAAwB,GAAG,EAAE,GAAG,4CAAyB,EAAE,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAuC,CAAC;QACpE,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,wBAAwB,CAAC,IAAI,GAAG,OAAO,CAAC;QAC/C,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACzD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,wBAAwB,CAAC,YAAY,GAAG,eAAe,KAAK,MAAM,CAAC;QAC1E,CAAC;QAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC9D,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,wBAAwB,CAAC,eAAe,GAAG,kBAAkB,KAAK,MAAM,CAAC;QAChF,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACU,QAAA,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEpD;;GAEG;AAEH;;GAEG;AACH,SAAgB,uBAAuB,CAAC,IAAoB;IAC1D,oBAAY,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,OAAO,oBAAY,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,MAAiC;IACzE,oBAAY,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB;IACvC,OAAO,oBAAY,CAAC,0BAA0B,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,oBAAY,CAAC,eAAe,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB;IACvC,oBAAY,CAAC,mBAAmB,EAAE,CAAC;AACrC,CAAC;AAED,sDAAsD;AACtD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClD,yBAAyB,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/config/ValidationConfig.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+/**
+ * Validation mode types
+ */
+export type ValidationMode = 'strict' | 'weak' | 'ignore';
+/**
+ * Validation configuration interface
+ */
+export interface ValidationConfig {
+    mode: ValidationMode;
+    throwOnError?: boolean;
+    includeWarnings?: boolean;
+}
+/**
+ * Validation warning interface
+ */
+export interface ValidationWarning {
+    path: string[];
+    message: string;
+    code: string;
+    severity: 'low' | 'medium' | 'high';
+}
+/**
+ * Enhanced validation result type
+ */
+export type EnhancedValidationResult<T> = {
+    success: true;
+    data: T;
+    warnings?: ValidationWarning[];
+    mode: ValidationMode;
+} | {
+    success: false;
+    error: z.ZodError;
+    warnings?: ValidationWarning[];
+    mode: ValidationMode;
+};
+/**
+ * Error severity classification
+ */
+export declare enum ErrorSeverity {
+    CRITICAL = "critical",
+    WARNING = "warning",
+    INFO = "info"
+}
+/**
+ * Validation utilities class
+ */
+export declare class ValidationUtils {
+    /**
+     * Categorize Zod error by severity
+     */
+    static categorizeError(error: z.ZodIssue): ErrorSeverity;
+    /**
+     * Convert Zod issue to validation warning
+     */
+    static issueToWarning(issue: z.ZodIssue): ValidationWarning;
+    /**
+     * Perform weak validation that returns warnings instead of errors
+     */
+    static performWeakValidation<T>(schema: z.ZodSchema<T>, data: any, config: ValidationConfig): EnhancedValidationResult<T>;
+    /**
+     * Perform validation based on mode
+     */
+    static performValidation<T>(schema: z.ZodSchema<T>, data: any, config: ValidationConfig): EnhancedValidationResult<T>;
+}
+/**
+ * Default validation configuration
+ */
+export declare const DEFAULT_VALIDATION_CONFIG: ValidationConfig;
+//# sourceMappingURL=ValidationConfig.d.ts.map

package/dist/core/config/ValidationConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationConfig.d.ts","sourceRoot":"","sources":["../../../src/core/config/ValidationConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,IAAI,EAAE,cAAc,CAAC;CACtB,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,oBAAY,aAAa;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAaD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,aAAa;IAkCxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,iBAAiB;IAY3D;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,EAC5B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAAC,CAAC,CAAC;IA6C9B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAAC,CAAC,CAAC;CAiC/B;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAIvC,CAAC"}

package/dist/core/config/ValidationConfig.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_VALIDATION_CONFIG = exports.ValidationUtils = exports.ErrorSeverity = void 0;
+const zod_1 = require("zod");
+/**
+ * Error severity classification
+ */
+var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["CRITICAL"] = "critical";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["INFO"] = "info";
+})(ErrorSeverity || (exports.ErrorSeverity = ErrorSeverity = {}));
+/**
+ * Critical error patterns that should always cause validation failure
+ */
+const CRITICAL_ERROR_PATTERNS = [
+    'Required',
+    'Expected string, received undefined',
+    'Expected number, received undefined',
+    'Expected object, received undefined',
+    'Expected array, received undefined',
+];
+/**
+ * Validation utilities class
+ */
+class ValidationUtils {
+    /**
+     * Categorize Zod error by severity
+     */
+    static categorizeError(error) {
+        const message = error.message;
+        // Check for critical patterns
+        for (const pattern of CRITICAL_ERROR_PATTERNS) {
+            if (message.includes(pattern)) {
+                return ErrorSeverity.CRITICAL;
+            }
+        }
+        // Type-specific categorization
+        switch (error.code) {
+            case 'invalid_type':
+                // If input is undefined for required field, it's critical
+                if (error.input === undefined) {
+                    return ErrorSeverity.CRITICAL;
+                }
+                return ErrorSeverity.WARNING;
+            case 'too_small':
+            case 'too_big':
+                return ErrorSeverity.WARNING;
+            case 'invalid_value':
+                return ErrorSeverity.WARNING;
+            case 'unrecognized_keys':
+                return ErrorSeverity.INFO;
+            default:
+                return ErrorSeverity.WARNING;
+        }
+    }
+    /**
+     * Convert Zod issue to validation warning
+     */
+    static issueToWarning(issue) {
+        const severity = this.categorizeError(issue);
+        return {
+            path: issue.path.map(p => String(p)),
+            message: issue.message,
+            code: issue.code,
+            severity: severity === ErrorSeverity.CRITICAL ? 'high' :
+                severity === ErrorSeverity.WARNING ? 'medium' : 'low'
+        };
+    }
+    /**
+     * Perform weak validation that returns warnings instead of errors
+     */
+    static performWeakValidation(schema, data, config) {
+        const result = schema.safeParse(data);
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data,
+                mode: config.mode
+            };
+        }
+        // Categorize errors
+        const criticalErrors = [];
+        const warnings = [];
+        for (const issue of result.error.issues) {
+            const severity = this.categorizeError(issue);
+            if (severity === ErrorSeverity.CRITICAL) {
+                criticalErrors.push(issue);
+            }
+            else {
+                warnings.push(this.issueToWarning(issue));
+            }
+        }
+        // If there are critical errors, validation fails
+        if (criticalErrors.length > 0) {
+            const criticalError = new zod_1.z.ZodError(criticalErrors);
+            return {
+                success: false,
+                error: criticalError,
+                warnings: config.includeWarnings ? warnings : undefined,
+                mode: config.mode
+            };
+        }
+        // No critical errors - weak validation passes with warnings
+        return {
+            success: true,
+            data: data, // Accept data as-is for weak validation
+            warnings: config.includeWarnings ? warnings : undefined,
+            mode: config.mode
+        };
+    }
+    /**
+     * Perform validation based on mode
+     */
+    static performValidation(schema, data, config) {
+        switch (config.mode) {
+            case 'strict': {
+                const strictResult = schema.safeParse(data);
+                if (strictResult.success) {
+                    return {
+                        success: true,
+                        data: strictResult.data,
+                        mode: config.mode
+                    };
+                }
+                else {
+                    return {
+                        success: false,
+                        error: strictResult.error,
+                        mode: config.mode
+                    };
+                }
+            }
+            case 'weak':
+                return this.performWeakValidation(schema, data, config);
+            case 'ignore':
+                return {
+                    success: true,
+                    data: data,
+                    mode: config.mode
+                };
+            default:
+                throw new Error(`Unknown validation mode: ${config.mode}`);
+        }
+    }
+}
+exports.ValidationUtils = ValidationUtils;
+/**
+ * Default validation configuration
+ */
+exports.DEFAULT_VALIDATION_CONFIG = {
+    mode: 'strict',
+    throwOnError: false,
+    includeWarnings: true
+};
+//# sourceMappingURL=ValidationConfig.js.map

package/dist/core/config/ValidationConfig.js.map

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

package/dist/core/copilot/ai.d.ts

@@ -0,0 +1,150 @@
+import { ChatOpenAI } from '@langchain/openai';
+import { Schema } from '../../utils/object-utils';
+/**
+ * Model configuration object
+ * @param model - The model to use
+ * @param apiKey - The API key to use
+ * @param baseURL - The base URL to use
+ */
+export type ModelConfig = {
+    model?: string;
+    apiKey?: string;
+    baseURL?: string;
+};
+declare function getModel(modelConfig: ModelConfig): Promise<ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>>;
+/**
+ * Custom extractor
+ *
+ * Extracts JSON content from a string where
+ * JSON is embedded between ```json and ``` tags.
+ */
+declare const extractJson: (output: any, schema: Schema, returnSingle?: boolean) => any;
+declare function fixJsonDataWithAI(data: any, originalData: any, modelConfig?: ModelConfig): Promise<any>;
+/**
+ * Extracts valid JSON data from AI response with retry mechanism
+ * Combines extractJson and fixJsonDataWithAI functions to ensure the extracted data
+ * matches the original data structure
+ *
+ * @param data - The AI response or data containing JSON
+ * @param originalData - The original data structure to match
+ * @param schema - The schema to validate against
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @returns The extracted and validated JSON data
+ */
+export declare function extractValidJsonWithRetry(data: any, originalData: any, schema?: Schema, maxRetries?: number): Promise<any>;
+/**
+ * Suggests improvements to data based on TIDAS methodology rules.
+ *
+ * This function uses AI to analyze the provided data against TIDAS methodology rules
+ * and suggests optimized content that better complies with the methodology requirements.
+ * The function ensures that the data structure remains unchanged while improving the content.
+ *
+ * @param data - The original data object to be improved. Can be any JSON-serializable object
+ *               such as process names, descriptions, or other TIDAS/ILCD data elements.
+ * @param methodology - The methodology rules to apply. Can be:
+ *                      - A complete methodology object loaded from YAML
+ *                      - A specific rule object extracted using getRuleFromMethodologyByPath
+ *                      - A custom rule object with description and rules properties
+ * @param modelConfig - The configuration for the AI model. Can be:
+ *                      - A complete model configuration object
+ *                      - A custom model configuration object with model, apiKey, and baseURL properties
+ * @returns Promise<any> - The improved data with the same structure as the input but with
+ *                        optimized content that better complies with the methodology.
+ *                        The returned data is guaranteed to match the original schema.
+ *
+ * @example
+ * ```typescript
+ * // Example 1: Improve a process name using specific rules
+ * const nameData = [{ '@xml:lang': 'en', '#text': 'Process 1' }];
+ * const rule = getRuleFromMethodologyByPath(methodology, 'processDataSet.processInformation.dataSetInformation.name.baseName');
+ * const improvedName = await suggest(nameData, rule);
+ * // Returns: [{ '@xml:lang': 'en', '#text': 'Production of Product A using Technology X' }]
+ *
+ * // Example 2: Improve data using full methodology
+ * const processData = { name: 'test', description: 'simple desc' };
+ * const improvedData = await suggest(processData, fullMethodology);
+ * // Returns data with improved names and descriptions
+ * ```
+ *
+ * @throws {Error} If the AI model fails to generate valid JSON
+ * @throws {Error} If the OpenAI API is not configured properly
+ */
+declare function suggest(data: any, methodology: any, modelConfig?: ModelConfig): Promise<any>;
+/**
+ * Reviews data against TIDAS methodology rules and provides structured feedback.
+ *
+ * This function uses AI to analyze the provided data against TIDAS methodology rules
+ * and provides a review with comments and a compliance score. Unlike the suggest function
+ * which modifies data, this function only provides assessment and feedback.
+ *
+ * @param data - The data object to be reviewed. Can be any JSON-serializable object
+ *               such as process names, descriptions, or other TIDAS/ILCD data elements.
+ * @param methodology - The methodology rules to evaluate against. Can be:
+ *                      - A complete methodology object loaded from YAML
+ *                      - A specific rule object extracted using getRuleFromMethodologyByPath
+ *                      - A custom rule object with description and rules properties
+ * @param modelConfig - The configuration for the AI model. Can be:
+ *                      - A complete model configuration object
+ *                      - A custom model configuration object with model, apiKey, and baseURL properties
+ * @returns Promise<{review_comment: string, review_score: number}> - A structured review containing:
+ *                        - review_comment: Detailed feedback on compliance and suggestions for improvement
+ *                        - review_score: A numerical score from 0-100 indicating compliance level
+ *
+ * @example
+ * ```typescript
+ * // Example 1: Review a process name against specific rules
+ * const nameData = [{ '@xml:lang': 'en', '#text': 'Process 1' }];
+ * const rule = getRuleFromMethodologyByPath(methodology, 'processDataSet.processInformation.dataSetInformation.name.baseName');
+ * const review = await reviewData(nameData, rule);
+ * // Returns: {
+ * //   review_comment: "The process name 'Process 1' is too generic. It should include specific information about...",
+ * //   review_score: 45
+ * // }
+ *
+ * // Example 2: Review complete process data
+ * const processData = { name: 'test', description: 'simple desc' };
+ * const review = await reviewData(processData, fullMethodology);
+ * // Returns comprehensive review with score
+ * ```
+ *
+ * @throws {Error} If the AI model fails to generate valid structured output
+ * @throws {Error} If the OpenAI API is not configured properly
+ */
+declare function reviewData(data: any, methodology: any, modelConfig?: ModelConfig): Promise<{
+    review_comment: string;
+    review_score: number;
+}>;
+/**
+ * Suggests improvements for an entire object based on all applicable methodology rules.
+ *
+ * This function analyzes a complete data object against all relevant methodology rules,
+ * applies AI suggestions to each applicable field, and returns a new object with improvements.
+ *
+ * @param data - The complete data object to improve (TidasEntity or plain object)
+ * @param methodologyType - The type of methodology to use:
+ *                         - A string key for available methodologies (e.g., 'processes', 'flows')
+ *                         - A methodology object already loaded
+ * @param options - Optional configuration:
+ *                 - parallelRequests: Number of parallel AI requests (default: 1)
+ *                 - skipPaths: Array of paths to skip
+ *                 - maxRetries: Maximum retries per rule (default: 1)
+ * @returns Promise<any> - Improved data object with the same structure as input
+ *
+ * @example
+ * ```typescript
+ * // Example: Improve an entire Process object
+ * const process = createProcess();
+ * process.processDataSet.processInformation.dataSetInformation['common:UUID'] = 'test-123';
+ * const improvedData = await suggestEntireObject(process, 'processes');
+ *
+ * // Create a new Process with improved data
+ * const improvedProcess = createProcess();
+ * Object.assign(improvedProcess, improvedData);
+ * ```
+ */
+export declare function suggestEntireObject(data: any, methodologyType: string | Record<string, any>, options?: {
+    skipPaths?: string[];
+    maxRetries?: number;
+}): Promise<any>;
+export { extractJson, fixJsonDataWithAI, suggest, reviewData, getModel };
+//# sourceMappingURL=ai.d.ts.map

package/dist/core/copilot/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/core/copilot/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAGL,MAAM,EACP,MAAM,0BAA0B,CAAC;AASlC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iBAAe,QAAQ,CAAC,WAAW,EAAE,WAAW,0EAS/C;AAED;;;;;GAKG;AACH,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,EAAE,QAAQ,MAAM,EAAE,sBAAmB,KAAG,GA4CvE,CAAC;AAEF,iBAAe,iBAAiB,CAC9B,IAAI,EAAE,GAAG,EACT,YAAY,EAAE,GAAG,EACjB,WAAW,CAAC,EAAE,WAAW,gBA+B1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,GAAG,EACT,YAAY,EAAE,GAAG,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,GAAG,CAAC,CAwEd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,iBAAe,OAAO,CACpB,IAAI,EAAE,GAAG,EACT,WAAW,EAAE,GAAG,EAChB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,GAAG,CAAC,CAsDd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAe,UAAU,CACvB,IAAI,EAAE,GAAG,EACT,WAAW,EAAE,GAAG,EAChB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAqI3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,GAAG,CAAC,CA8Jd;AAGD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC"}