@robota-sdk/agent-core 3.0.0-beta.1

package/dist/interfaces/workflow-converter.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Workflow Converter Interface
+ *
+ * Defines the contract for all workflow converters in the Robota SDK.
+ * Follows Interface Segregation Principle by providing minimal, focused interface.
+ *
+ * @template TInput - Input workflow data type
+ * @template TOutput - Output workflow data type
+ */
+import type { ILogger } from '../utils/logger';
+import type { TConfigValue, TMetadata, TMetadataValue, TUniversalValue } from './types';
+/**
+ * Workflow configuration - uses base type for cross-converter compatibility
+ * Step 1: ❌ Can't assign number/boolean to config value type directly (index signature conflict)
+ * Step 2: ✅ TConfigValue already includes primitive types (number, boolean)
+ * Step 3: ✅ Fix index signature to allow optional properties
+ * Step 4: ✅ Use proper intersection type for compatibility
+ */
+export interface IWorkflowConfig {
+    timeout?: number;
+    retries?: number;
+    validateInput?: boolean;
+    validateOutput?: boolean;
+    [key: string]: TConfigValue | undefined;
+}
+/**
+ * Workflow metadata - uses base type for cross-converter compatibility
+ * Step 1: ❌ Can't assign Date/number/string to metadata value type directly (index signature conflict)
+ * Step 2: ✅ TMetadataValue already includes Date, primitive types
+ * Step 3: ✅ Fix index signature to allow optional properties
+ * Step 4: ✅ Use proper intersection type for compatibility
+ */
+export interface IWorkflowMetadata {
+    convertedAt?: Date;
+    processingTime?: number;
+    executionId?: string;
+    [key: string]: TMetadataValue | undefined;
+}
+/**
+ * Base workflow data constraint with flexible typing
+ * All workflow data must extend this interface for type safety
+ */
+export interface IWorkflowData {
+    readonly __workflowType?: string;
+    [key: string]: TUniversalValue | undefined;
+}
+/**
+ * Conversion options for workflow transformations
+ * Step 1: ❌ Can't assign IWorkflowConversionOptions to metadata value type (missing index signature)
+ * Step 2: ✅ Add index signature to make it compatible with MetadataValue
+ * Step 3: ✅ Maintain type safety while allowing metadata storage
+ * Step 4: ✅ Use MetadataValue compatibility for dynamic properties
+ */
+export interface IWorkflowConversionOptions {
+    /** Include debug information in output */
+    includeDebug?: boolean;
+    /** Validate input before conversion */
+    validateInput?: boolean;
+    /** Validate output after conversion */
+    validateOutput?: boolean;
+    /** Custom logger for conversion process */
+    logger?: ILogger;
+    /** Additional metadata to include */
+    metadata?: IWorkflowMetadata;
+    /** Platform-specific options */
+    platformOptions?: IWorkflowConfig;
+    /** Additional dynamic options compatible with TUniversalValue */
+    [key: string]: TUniversalValue | ILogger | IWorkflowMetadata | IWorkflowConfig | undefined;
+}
+/**
+ * Conversion result with metadata and validation info
+ */
+export interface IWorkflowConversionResult<TOutput> {
+    /** Converted workflow data */
+    data: TOutput;
+    /** Conversion success status */
+    success: boolean;
+    /** Validation errors (if any) */
+    errors: string[];
+    /** Validation warnings (if any) */
+    warnings: string[];
+    /** Conversion metadata */
+    metadata: IWorkflowConversionResultMetadata;
+}
+/**
+ * Workflow conversion metadata.
+ *
+ * IMPORTANT:
+ * - Do NOT intersect this object with `TMetadata`.
+ * - `TMetadata` has an index signature with a restricted value axis (`TMetadataValue`),
+ *   which would force every property on this object to be assignable to `TMetadataValue`.
+ * - Keep structured fields here, and store additional key/value pairs under `extensions`.
+ */
+export interface IWorkflowConversionResultMetadata {
+    /** Conversion timestamp */
+    convertedAt: Date;
+    /** Processing time in milliseconds */
+    processingTime: number;
+    /** Input data statistics */
+    inputStats: {
+        nodeCount: number;
+        edgeCount: number;
+    };
+    /** Output data statistics */
+    outputStats: {
+        nodeCount: number;
+        edgeCount: number;
+    };
+    /** Converter name */
+    converter: string;
+    /** Converter version */
+    version: string;
+    /** Conversion options (optional, typically gated by includeDebug) */
+    options?: IWorkflowConversionOptions;
+    /**
+     * Additional key/value metadata (SSOT axis).
+     * Use this for dynamic metadata, not top-level ad-hoc fields.
+     */
+    extensions?: TMetadata;
+}
+/**
+ * Workflow Converter Interface
+ *
+ * Core interface for converting between different workflow representations.
+ * All workflow converters must implement this interface.
+ *
+ * @template TInput - Input workflow data type
+ * @template TOutput - Output workflow data type
+ */
+export interface IWorkflowConverter<TInput extends IWorkflowData, TOutput extends IWorkflowData> {
+    /** Converter name for identification */
+    readonly name: string;
+    /** Converter version */
+    readonly version: string;
+    /** Source format that this converter accepts */
+    readonly sourceFormat: string;
+    /** Target format that this converter produces */
+    readonly targetFormat: string;
+    /**
+     * Convert workflow data from input format to output format
+     *
+     * @param input - Input workflow data
+     * @param options - Conversion options
+     * @returns Promise resolving to conversion result
+     */
+    convert(input: TInput, options?: IWorkflowConversionOptions): Promise<IWorkflowConversionResult<TOutput>>;
+    /**
+     * Validate input data before conversion
+     *
+     * @param input - Input workflow data
+     * @returns Promise resolving to validation result
+     */
+    validateInput(input: TInput): Promise<{
+        isValid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Validate output data after conversion
+     *
+     * @param output - Output workflow data
+     * @returns Promise resolving to validation result
+     */
+    validateOutput(output: TOutput): Promise<{
+        isValid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Check if this converter supports the given input format
+     *
+     * @param input - Input data to check
+     * @returns True if converter can handle this input
+     */
+    canConvert(input: IWorkflowData): input is TInput;
+    /**
+     * Get conversion statistics and metrics
+     *
+     * @returns Converter performance metrics
+     */
+    getStats(): {
+        totalConversions: number;
+        successfulConversions: number;
+        failedConversions: number;
+        averageProcessingTime: number;
+        lastConversionAt?: Date;
+    };
+    /**
+     * Reset converter statistics
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=workflow-converter.d.ts.map

package/dist/interfaces/workflow-converter.d.ts.map

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

package/dist/interfaces/workflow-converter.js

@@ -0,0 +1,11 @@
+/**
+ * Workflow Converter Interface
+ *
+ * Defines the contract for all workflow converters in the Robota SDK.
+ * Follows Interface Segregation Principle by providing minimal, focused interface.
+ *
+ * @template TInput - Input workflow data type
+ * @template TOutput - Output workflow data type
+ */
+export {};
+//# sourceMappingURL=workflow-converter.js.map

package/dist/interfaces/workflow-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-converter.js","sourceRoot":"","sources":["../../src/interfaces/workflow-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/interfaces/workflow-validator.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Workflow Validator Interface
+ *
+ * Defines the contract for workflow validation systems in the Robota SDK.
+ * Follows Single Responsibility Principle by focusing only on validation logic.
+ */
+import type { ILogger } from '../utils/logger';
+import type { IWorkflowData, IWorkflowConfig, IWorkflowMetadata } from './workflow-converter';
+/**
+ * Validation severity levels
+ */
+export declare enum ValidationSeverity {
+    ERROR = "error",
+    WARNING = "warning",
+    INFO = "info"
+}
+/**
+ * Individual validation issue
+ */
+export interface IValidationIssue {
+    /** Unique identifier for this issue */
+    id: string;
+    /** Issue severity level */
+    severity: ValidationSeverity;
+    /** Human-readable message */
+    message: string;
+    /** Technical details or suggestion */
+    details?: string;
+    /** Location where issue was found */
+    location?: {
+        nodeId?: string;
+        edgeId?: string;
+        field?: string;
+        line?: number;
+        column?: number;
+    };
+    /** Rule that triggered this issue */
+    rule: string;
+    /** Suggested fix (if available) */
+    suggestedFix?: {
+        description: string;
+        action: 'modify' | 'remove' | 'add';
+        target?: IWorkflowConfig;
+    };
+    /** Timestamp when issue was detected */
+    detectedAt: Date;
+}
+/**
+ * Validation options
+ */
+export interface IValidationOptions {
+    /** Validation strictness level */
+    strict?: boolean;
+    /** Skip specific validation rules */
+    skipRules?: string[];
+    /** Include only specific validation rules */
+    includeRules?: string[];
+    /** Maximum number of errors to collect */
+    maxErrors?: number;
+    /** Include warnings in results */
+    includeWarnings?: boolean;
+    /** Include info messages in results */
+    includeInfo?: boolean;
+    /** Custom logger for validation process */
+    logger?: ILogger;
+    /** Additional validation context */
+    context?: IWorkflowMetadata;
+    /** Enable auto-recovery suggestions */
+    enableAutoRecovery?: boolean;
+}
+/**
+ * Validation result
+ */
+export interface IValidationResult {
+    /** Overall validation success status */
+    isValid: boolean;
+    /** All validation issues found */
+    issues: IValidationIssue[];
+    /** Summary by severity */
+    summary: {
+        errorCount: number;
+        warningCount: number;
+        infoCount: number;
+        totalIssues: number;
+    };
+    /** Validation metadata */
+    metadata: {
+        /** Validation timestamp */
+        validatedAt: Date;
+        /** Processing time in milliseconds */
+        processingTime: number;
+        /** Validator used */
+        validator: string;
+        /** Validation rules applied */
+        rulesApplied: string[];
+        /** Data statistics */
+        dataStats: Record<string, string | number | boolean>;
+        /** Version */
+        version?: string;
+        /** Options */
+        options?: string | number | boolean | string[] | Date;
+        /** Additional metrics */
+        [key: string]: string | number | boolean | Date | string[] | Record<string, string | number | boolean> | undefined;
+    };
+    /** Auto-recovery suggestions (if enabled) */
+    recoveryOptions?: Array<{
+        description: string;
+        confidence: number;
+        action: () => Promise<IWorkflowConfig>;
+    }>;
+}
+/**
+ * Workflow Validator Interface
+ *
+ * Core interface for validating workflow data structures.
+ * All workflow validators must implement this interface.
+ *
+ * @template TWorkflowData - Type of workflow data to validate
+ */
+export interface IWorkflowValidator<TWorkflowData extends IWorkflowData> {
+    /** Validator name for identification */
+    readonly name: string;
+    /** Validator version */
+    readonly version: string;
+    /** Data format that this validator handles */
+    readonly dataFormat: string;
+    /** Available validation rules */
+    readonly availableRules: string[];
+    /**
+     * Validate workflow data
+     *
+     * @param data - Workflow data to validate
+     * @param options - Validation options
+     * @returns Promise resolving to validation result
+     */
+    validate(data: TWorkflowData, options?: IValidationOptions): Promise<IValidationResult>;
+    /**
+     * Validate specific aspect of workflow data
+     *
+     * @param data - Workflow data to validate
+     * @param rule - Specific rule to apply
+     * @param options - Validation options
+     * @returns Promise resolving to validation result for this rule
+     */
+    validateRule(data: TWorkflowData, rule: string, options?: IValidationOptions): Promise<IValidationResult>;
+    /**
+     * Check if validator can handle the given data format
+     *
+     * @param data - Data to check
+     * @returns True if validator can handle this data
+     */
+    canValidate(data: IWorkflowData): data is TWorkflowData;
+    /**
+     * Get available validation rules with descriptions
+     *
+     * @returns Map of rule names to descriptions
+     */
+    getRuleDescriptions(): Map<string, {
+        description: string;
+        severity: ValidationSeverity;
+        category: string;
+        enabled: boolean;
+    }>;
+    /**
+     * Enable or disable specific validation rules
+     *
+     * @param rules - Map of rule names to enabled status
+     */
+    configureRules(rules: Map<string, boolean>): void;
+    /**
+     * Perform automatic recovery for validation issues
+     *
+     * @param data - Original workflow data
+     * @param issues - Validation issues to recover from
+     * @returns Promise resolving to recovered data and recovery result
+     */
+    autoRecover(data: TWorkflowData, issues: IValidationIssue[]): Promise<{
+        recoveredData: TWorkflowData;
+        recoveryResult: {
+            success: boolean;
+            issuesFixed: IValidationIssue[];
+            remainingIssues: IValidationIssue[];
+            appliedFixes: string[];
+        };
+    }>;
+    /**
+     * Get validator statistics and metrics
+     *
+     * @returns Validator performance metrics
+     */
+    getStats(): {
+        totalValidations: number;
+        successfulValidations: number;
+        failedValidations: number;
+        averageProcessingTime: number;
+        averageIssueCount: number;
+        mostCommonIssues: Array<{
+            rule: string;
+            count: number;
+            severity: ValidationSeverity;
+        }>;
+        lastValidationAt?: Date;
+    };
+    /**
+     * Reset validator statistics
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=workflow-validator.d.ts.map

package/dist/interfaces/workflow-validator.d.ts.map

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

package/dist/interfaces/workflow-validator.js

@@ -0,0 +1,16 @@
+/**
+ * Workflow Validator Interface
+ *
+ * Defines the contract for workflow validation systems in the Robota SDK.
+ * Follows Single Responsibility Principle by focusing only on validation logic.
+ */
+/**
+ * Validation severity levels
+ */
+export var ValidationSeverity;
+(function (ValidationSeverity) {
+    ValidationSeverity["ERROR"] = "error";
+    ValidationSeverity["WARNING"] = "warning";
+    ValidationSeverity["INFO"] = "info";
+})(ValidationSeverity || (ValidationSeverity = {}));
+//# sourceMappingURL=workflow-validator.js.map

package/dist/interfaces/workflow-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validator.js","sourceRoot":"","sources":["../../src/interfaces/workflow-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,qCAAe,CAAA;IACf,yCAAmB,CAAA;IACnB,mCAAa,CAAA;AACjB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

package/dist/managers/agent-factory.d.ts

@@ -0,0 +1,132 @@
+import { IAgent, IAgentConfig, IAgentTemplate } from '../interfaces/agent';
+import { type ITemplateApplicationResult } from './agent-templates';
+/**
+ * Configuration options for AgentFactory
+ */
+export interface IAgentFactoryOptions {
+    /** Default model to use if not specified in config */
+    defaultModel?: string;
+    /** Default provider to use if not specified in config */
+    defaultProvider?: string;
+    /** Maximum number of concurrent agents */
+    maxConcurrentAgents?: number;
+    /** Default system message for agents */
+    defaultSystemMessage?: string;
+    /** Enable strict configuration validation */
+    strictValidation?: boolean;
+}
+/**
+ * Agent creation statistics
+ */
+export interface IAgentCreationStats {
+    /** Total number of agents created */
+    totalCreated: number;
+    /** Number of currently active agents */
+    activeCount: number;
+    /** Number of agents created from templates */
+    fromTemplates: number;
+    /** Number of custom configured agents */
+    customConfigured: number;
+    /** Template vs custom creation ratio (fromTemplates / totalCreated) */
+    templateUsageRatio: number;
+}
+/**
+ * Agent lifecycle events
+ */
+export interface IAgentLifecycleEvents {
+    /** Called before agent creation */
+    beforeCreate?: (config: IAgentConfig) => Promise<void> | void;
+    /** Called after successful agent creation */
+    afterCreate?: (agent: IAgent<IAgentConfig>, config: IAgentConfig) => Promise<void> | void;
+    /** Called when agent creation fails */
+    onCreateError?: (error: Error, config: IAgentConfig) => Promise<void> | void;
+    /** Called when agent is destroyed */
+    onDestroy?: (agentId: string) => Promise<void> | void;
+}
+/**
+ * Agent Factory for creating and managing agents
+ * Instance-based for isolated agent factory management
+ */
+export declare class AgentFactory {
+    private agentTemplates;
+    private initialized;
+    private logger;
+    private options;
+    private activeAgents;
+    private creationStats;
+    private lifecycleEvents;
+    constructor(options?: IAgentFactoryOptions, lifecycleEvents?: IAgentLifecycleEvents);
+    /**
+     * Initialize the factory
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create a new agent instance
+     */
+    createAgent(AgentClass: new (config: IAgentConfig) => IAgent<IAgentConfig>, config: Partial<IAgentConfig>, fromTemplate?: boolean): Promise<IAgent<IAgentConfig>>;
+    /**
+     * Create agent from template
+     */
+    createFromTemplate(AgentClass: new (config: IAgentConfig) => IAgent<IAgentConfig>, templateId: string, overrides?: Partial<IAgentConfig>): Promise<IAgent<IAgentConfig>>;
+    /**
+     * Register a template
+     */
+    registerTemplate(template: IAgentTemplate): void;
+    /**
+     * Unregister a template
+     */
+    unregisterTemplate(templateId: string): boolean;
+    /**
+     * Get all templates
+     */
+    getTemplates(): IAgentTemplate[];
+    /**
+     * Get template by ID
+     */
+    getTemplate(templateId: string): IAgentTemplate | undefined;
+    /**
+     * Find templates by criteria
+     */
+    findTemplates(criteria: {
+        category?: string;
+        tags?: string[];
+        provider?: string;
+        model?: string;
+    }): IAgentTemplate[];
+    /**
+     * Apply template to configuration
+     */
+    applyTemplate(template: IAgentTemplate, overrides?: Partial<IAgentConfig>): ITemplateApplicationResult;
+    /**
+     * Destroy an agent
+     */
+    destroyAgent(agentId: string): Promise<boolean>;
+    /**
+     * Get creation statistics
+     */
+    getCreationStats(): IAgentCreationStats;
+    /**
+     * Get all active agents
+     */
+    getActiveAgents(): Map<string, IAgent<IAgentConfig>>;
+    /**
+     * Validate agent configuration
+     */
+    validateConfiguration(config: Partial<IAgentConfig>): {
+        isValid: boolean;
+        errors: string[];
+    };
+    /**
+     * Apply default configuration values
+     */
+    private applyDefaults;
+    /**
+     * Generate unique agent ID
+     */
+    private generateAgentId;
+    /**
+     * Update creation statistics
+     */
+    private updateCreationStats;
+}
+//# sourceMappingURL=agent-factory.d.ts.map

package/dist/managers/agent-factory.d.ts.map

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