@dcyfr/ai 1.0.0

package/dist/ai/core/telemetry-engine.js

@@ -0,0 +1,390 @@
+/**
+ * Telemetry Engine
+ *
+ * Tracks agent usage, quality metrics, costs, and performance across all AI providers.
+ * Provides data-driven insights for optimizing agent allocation and cost management.
+ *
+ * @module @dcyfr/ai/core/telemetry-engine
+ * @example
+ * ```typescript
+ * import { TelemetryEngine } from '@dcyfr/ai/core/telemetry-engine';
+ *
+ * const telemetry = new TelemetryEngine({ storage: 'memory' });
+ *
+ * // Start tracking a task
+ * const session = telemetry.startSession('claude', {
+ *   taskType: 'feature',
+ *   description: 'Implement dark mode',
+ * });
+ *
+ * // Record metrics
+ * session.recordMetric('tokenCompliance', 0.98);
+ * session.recordValidation('typescript', 'pass');
+ *
+ * // End session
+ * const result = session.end('success');
+ * ```
+ */
+import { createStorageAdapter } from '../utils/storage';
+/**
+ * Telemetry Session Manager - handles individual sessions
+ */
+export class TelemetrySessionManager {
+    session;
+    startTime;
+    storage;
+    constructor(sessionId, agent, taskType, taskDescription, storage) {
+        this.storage = storage;
+        this.startTime = Date.now();
+        this.session = {
+            sessionId,
+            agent,
+            taskType,
+            taskDescription,
+            startTime: new Date(),
+            metrics: {
+                tokenCompliance: 0,
+                testPassRate: 0,
+                lintViolations: 0,
+                typeErrors: 0,
+                executionTime: 0,
+                tokensUsed: 0,
+                filesModified: 0,
+                linesChanged: 0,
+                validations: {
+                    typescript: 'pending',
+                    eslint: 'pending',
+                    tests: 'pending',
+                    designTokens: 'pending',
+                    security: 'pending',
+                },
+            },
+            violations: [],
+            handoffs: [],
+            cost: {
+                provider: agent,
+                inputTokens: 0,
+                outputTokens: 0,
+                estimatedCost: 0,
+                currency: 'USD',
+            },
+        };
+    }
+    /**
+     * Record a metric value
+     */
+    recordMetric(metric, value) {
+        this.session.metrics[metric] = value;
+    }
+    /**
+     * Record validation status
+     */
+    recordValidation(validation, status) {
+        this.session.metrics.validations[validation] = status;
+    }
+    /**
+     * Record a violation
+     */
+    recordViolation(violation) {
+        this.session.violations.push({
+            timestamp: new Date(),
+            ...violation,
+        });
+        // Update violation counts
+        if (violation.type === 'eslint') {
+            this.session.metrics.lintViolations++;
+        }
+        else if (violation.type === 'typescript') {
+            this.session.metrics.typeErrors++;
+        }
+    }
+    /**
+     * Record a handoff to another agent
+     */
+    recordHandoff(handoff) {
+        this.session.handoffs.push({
+            timestamp: new Date(),
+            fromAgent: this.session.agent,
+            ...handoff,
+        });
+    }
+    /**
+     * Update cost estimate
+     */
+    updateCost(inputTokens, outputTokens) {
+        this.session.cost.inputTokens += inputTokens;
+        this.session.cost.outputTokens += outputTokens;
+        // Calculate cost based on provider
+        const costPerMillionTokens = this.getCostPerMillionTokens(this.session.agent);
+        const totalTokens = inputTokens + outputTokens;
+        this.session.cost.estimatedCost += (totalTokens / 1_000_000) * costPerMillionTokens;
+        // Update tokens used metric
+        this.session.metrics.tokensUsed = totalTokens;
+    }
+    getCostPerMillionTokens(agent) {
+        const costs = {
+            claude: 15, // $15 per 1M tokens (Sonnet 3.5)
+            copilot: 0.1, // Included in subscription
+            groq: 0, // Free tier
+            ollama: 0, // Local
+        };
+        return costs[agent];
+    }
+    /**
+     * End the session and return final metrics
+     */
+    async end(outcome) {
+        this.session.endTime = new Date();
+        this.session.outcome = outcome;
+        this.session.metrics.executionTime = Date.now() - this.startTime;
+        // Save to storage
+        await this.saveToStorage();
+        return this.session;
+    }
+    /**
+     * Get current session data
+     */
+    getSession() {
+        return { ...this.session };
+    }
+    async saveToStorage() {
+        try {
+            // Get existing sessions
+            const sessions = await this.storage.get('telemetry-sessions') || [];
+            // Add current session
+            sessions.push(this.session);
+            // Save back
+            await this.storage.set('telemetry-sessions', sessions);
+        }
+        catch (error) {
+            console.error('Failed to save telemetry session:', error);
+        }
+    }
+}
+/**
+ * Main Telemetry Engine
+ */
+export class TelemetryEngine {
+    activeSessions;
+    storage;
+    constructor(options) {
+        this.activeSessions = new Map();
+        // Initialize storage
+        if (options?.storage) {
+            if (typeof options.storage === 'string') {
+                this.storage = createStorageAdapter(options.storage, { basePath: options.basePath });
+            }
+            else {
+                this.storage = options.storage;
+            }
+        }
+        else {
+            this.storage = createStorageAdapter('memory');
+        }
+    }
+    /**
+     * Start a new telemetry session
+     */
+    startSession(agent, options) {
+        const sessionId = this.generateSessionId();
+        const session = new TelemetrySessionManager(sessionId, agent, options.taskType, options.description, this.storage);
+        this.activeSessions.set(sessionId, session);
+        return session;
+    }
+    /**
+     * Get an active session
+     */
+    getSession(sessionId) {
+        return this.activeSessions.get(sessionId);
+    }
+    /**
+     * End a session
+     */
+    async endSession(sessionId, outcome) {
+        const session = this.activeSessions.get(sessionId);
+        if (!session)
+            return null;
+        const result = await session.end(outcome);
+        this.activeSessions.delete(sessionId);
+        return result;
+    }
+    /**
+     * Get statistics for a specific agent
+     */
+    async getAgentStats(agent, period = '30d') {
+        const sessions = await this.getSessionsForPeriod(agent, period);
+        const totalSessions = sessions.length;
+        if (totalSessions === 0) {
+            return this.getEmptyStats(agent, period);
+        }
+        const totalTime = sessions.reduce((sum, s) => sum + s.metrics.executionTime, 0);
+        const averageSessionTime = totalTime / totalSessions;
+        const outcomes = {
+            success: sessions.filter(s => s.outcome === 'success').length,
+            escalated: sessions.filter(s => s.outcome === 'escalated').length,
+            failed: sessions.filter(s => s.outcome === 'failed').length,
+            partial: sessions.filter(s => s.outcome === 'partial').length,
+        };
+        const quality = {
+            averageTokenCompliance: sessions.reduce((sum, s) => sum + s.metrics.tokenCompliance, 0) / totalSessions,
+            averageTestPassRate: sessions.reduce((sum, s) => sum + s.metrics.testPassRate, 0) / totalSessions,
+            totalViolations: sessions.reduce((sum, s) => sum + s.violations.length, 0),
+            violationsFixed: sessions.reduce((sum, s) => sum + s.violations.filter(v => v.fixed).length, 0),
+        };
+        const performance = {
+            averageExecutionTime: averageSessionTime,
+            totalTokensUsed: sessions.reduce((sum, s) => sum + s.metrics.tokensUsed, 0),
+            averageFilesModified: sessions.reduce((sum, s) => sum + s.metrics.filesModified, 0) / totalSessions,
+        };
+        const cost = {
+            totalCost: sessions.reduce((sum, s) => sum + s.cost.estimatedCost, 0),
+            averageCostPerSession: sessions.reduce((sum, s) => sum + s.cost.estimatedCost, 0) / totalSessions,
+            costByTaskType: this.calculateCostByTaskType(sessions),
+        };
+        const taskTypes = sessions.reduce((acc, s) => {
+            acc[s.taskType] = (acc[s.taskType] || 0) + 1;
+            return acc;
+        }, {});
+        return {
+            agent,
+            period,
+            totalSessions,
+            totalTime,
+            averageSessionTime,
+            outcomes,
+            quality,
+            performance,
+            cost,
+            taskTypes,
+        };
+    }
+    /**
+     * Compare stats across all agents
+     */
+    async compareAgents(period = '30d') {
+        const agents = ['claude', 'copilot', 'groq', 'ollama'];
+        const stats = {};
+        for (const agent of agents) {
+            stats[agent] = await this.getAgentStats(agent, period);
+        }
+        const recommendations = this.generateRecommendations(stats);
+        return {
+            period,
+            agents: stats,
+            recommendations,
+        };
+    }
+    /**
+     * Get handoff patterns
+     */
+    async getHandoffPatterns(period = '30d') {
+        const sessions = await this.getAllSessionsForPeriod(period);
+        const allHandoffs = sessions.flatMap(s => s.handoffs);
+        const totalHandoffs = allHandoffs.length;
+        const byReason = allHandoffs.reduce((acc, h) => {
+            acc[h.reason] = (acc[h.reason] || 0) + 1;
+            return acc;
+        }, {});
+        const paths = {};
+        allHandoffs.forEach(h => {
+            const path = `${h.fromAgent} → ${h.toAgent}`;
+            paths[path] = (paths[path] || 0) + 1;
+        });
+        const mostCommonPath = Object.entries(paths).sort((a, b) => b[1] - a[1])[0]?.[0] || 'None';
+        const automaticVsManual = {
+            automatic: allHandoffs.filter(h => h.automatic).length,
+            manual: allHandoffs.filter(h => !h.automatic).length,
+        };
+        return {
+            totalHandoffs,
+            byReason,
+            mostCommonPath,
+            automaticVsManual,
+        };
+    }
+    generateSessionId() {
+        // Session IDs are for internal tracking only, not security-critical
+        return `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    async getSessionsForPeriod(agent, period) {
+        const allSessions = await this.storage.get('telemetry-sessions') || [];
+        const cutoffDate = this.getPeriodCutoffDate(period);
+        return allSessions.filter(s => s.agent === agent && new Date(s.startTime) >= cutoffDate);
+    }
+    async getAllSessionsForPeriod(period) {
+        const allSessions = await this.storage.get('telemetry-sessions') || [];
+        const cutoffDate = this.getPeriodCutoffDate(period);
+        return allSessions.filter(s => new Date(s.startTime) >= cutoffDate);
+    }
+    getPeriodCutoffDate(period) {
+        const now = new Date();
+        const match = period.match(/(\d+)([dhm])/);
+        if (!match)
+            return new Date(0); // All time
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case 'd':
+                return new Date(now.getTime() - value * 24 * 60 * 60 * 1000);
+            case 'h':
+                return new Date(now.getTime() - value * 60 * 60 * 1000);
+            case 'm':
+                return new Date(now.getTime() - value * 60 * 1000);
+            default:
+                return new Date(0);
+        }
+    }
+    calculateCostByTaskType(sessions) {
+        return sessions.reduce((acc, s) => {
+            acc[s.taskType] = (acc[s.taskType] || 0) + s.cost.estimatedCost;
+            return acc;
+        }, {});
+    }
+    generateRecommendations(stats) {
+        const recommendations = [];
+        // Find agents with actual data
+        const activeAgents = Object.entries(stats).filter(([, s]) => s.totalSessions > 0);
+        if (activeAgents.length === 0) {
+            return ['No sessions recorded yet. Start using the framework to get recommendations.'];
+        }
+        // Analyze quality metrics
+        const bestQuality = activeAgents.sort((a, b) => b[1].quality.averageTokenCompliance - a[1].quality.averageTokenCompliance)[0];
+        if (bestQuality) {
+            recommendations.push(`Use ${bestQuality[0]} for highest quality work (${(bestQuality[1].quality.averageTokenCompliance * 100).toFixed(1)}% token compliance)`);
+        }
+        // Analyze cost efficiency
+        const freeAgents = activeAgents.filter(([, s]) => s.cost.totalCost === 0);
+        if (freeAgents.length > 0) {
+            recommendations.push(`Use ${freeAgents.map(([agent]) => agent).join(' or ')} for cost optimization (free tier)`);
+        }
+        return recommendations;
+    }
+    getEmptyStats(agent, period) {
+        return {
+            agent,
+            period,
+            totalSessions: 0,
+            totalTime: 0,
+            averageSessionTime: 0,
+            outcomes: { success: 0, escalated: 0, failed: 0, partial: 0 },
+            quality: {
+                averageTokenCompliance: 0,
+                averageTestPassRate: 0,
+                totalViolations: 0,
+                violationsFixed: 0,
+            },
+            performance: {
+                averageExecutionTime: 0,
+                totalTokensUsed: 0,
+                averageFilesModified: 0,
+            },
+            cost: {
+                totalCost: 0,
+                averageCostPerSession: 0,
+                costByTaskType: {},
+            },
+            taskTypes: {},
+        };
+    }
+}
+//# sourceMappingURL=telemetry-engine.js.map

package/dist/ai/core/telemetry-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-engine.js","sourceRoot":"","sources":["../../../packages/ai/core/telemetry-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAqBH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,OAAO,CAAmB;IAC1B,SAAS,CAAS;IAClB,OAAO,CAAiB;IAEhC,YACE,SAAiB,EACjB,KAAgB,EAChB,QAAkB,EAClB,eAAuB,EACvB,OAAuB;QAEvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG;YACb,SAAS;YACT,KAAK;YACL,QAAQ;YACR,eAAe;YACf,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE;gBACP,eAAe,EAAE,CAAC;gBAClB,YAAY,EAAE,CAAC;gBACf,cAAc,EAAE,CAAC;gBACjB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE;oBACX,UAAU,EAAE,SAAS;oBACrB,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,SAAS;oBAChB,YAAY,EAAE,SAAS;oBACvB,QAAQ,EAAE,SAAS;iBACpB;aACF;YACD,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE;gBACJ,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,CAAC;gBAChB,QAAQ,EAAE,KAAK;aAChB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CACV,MAAmD,EACnD,KAAa;QAEb,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,UAAkB,EAClB,MAAwB;QAExB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAA6C;QAC3D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,SAAS;SACb,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QACxC,CAAC;aAAM,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAuD;QACnE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YAC7B,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,WAAmB,EAAE,YAAoB;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC;QAE/C,mCAAmC;QACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,oBAAoB,CAAC;QAEpF,4BAA4B;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,GAAG,WAAW,CAAC;IAChD,CAAC;IAEO,uBAAuB,CAAC,KAAgB;QAC9C,MAAM,KAAK,GAA8B;YACvC,MAAM,EAAE,EAAE,EAAE,iCAAiC;YAC7C,OAAO,EAAE,GAAG,EAAE,2BAA2B;YACzC,IAAI,EAAE,CAAC,EAAE,YAAY;YACrB,MAAM,EAAE,CAAC,EAAE,QAAQ;SACpB,CAAC;QACF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAoB;QAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAEjE,kBAAkB;QAClB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC;YACH,wBAAwB;YACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAqB,oBAAoB,CAAC,IAAI,EAAE,CAAC;YAExF,sBAAsB;YACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE5B,YAAY;YACZ,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,cAAc,CAAuC;IACrD,OAAO,CAAiB;IAEhC,YAAY,OAAuE;QACjF,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAEhC,qBAAqB;QACrB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CACV,KAAgB,EAChB,OAGC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,uBAAuB,CACzC,SAAS,EACT,KAAK,EACL,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,EACnB,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,OAAoB;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,KAAgB,EAAE,MAAM,GAAG,KAAK;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEhE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;QACtC,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,CAAC;QAErD,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM;YAC7D,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,MAAM;YACjE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC3D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM;SAC9D,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,sBAAsB,EACpB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,aAAa;YACjF,mBAAmB,EACjB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,aAAa;YAC9E,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,eAAe,EAAE,QAAQ,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAC1D,CAAC,CACF;SACF,CAAC;QAEF,MAAM,WAAW,GAAG;YAClB,oBAAoB,EAAE,kBAAkB;YACxC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3E,oBAAoB,EAClB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,aAAa;SAChF,CAAC;QAEF,MAAM,IAAI,GAAG;YACX,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YACrE,qBAAqB,EACnB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,aAAa;YAC5E,cAAc,EAAE,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC;SACvD,CAAC;QAEF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAC/B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACT,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7C,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA8B,CAC/B,CAAC;QAEF,OAAO;YACL,KAAK;YACL,MAAM;YACN,aAAa;YACb,SAAS;YACT,kBAAkB;YAClB,QAAQ;YACR,OAAO;YACP,WAAW;YACX,IAAI;YACJ,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,KAAK;QAChC,MAAM,MAAM,GAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpE,MAAM,KAAK,GAAkC,EAAmC,CAAC;QAEjF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAE5D,OAAO;YACL,MAAM;YACN,MAAM,EAAE,KAAK;YACb,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAM,GAAG,KAAK;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAEtD,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;QAEzC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACT,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA6C,CAC9C,CAAC;QAEF,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACtB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,MAAM,cAAc,GAClB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QAEtE,MAAM,iBAAiB,GAAG;YACxB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM;YACtD,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM;SACrD,CAAC;QAEF,OAAO;YACL,aAAa;YACb,QAAQ;YACR,cAAc;YACd,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAEO,iBAAiB;QACvB,oEAAoE;QACpE,OAAO,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,KAAgB,EAChB,MAAc;QAEd,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAqB,oBAAoB,CAAC,IAAI,EAAE,CAAC;QAC3F,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEpD,OAAO,WAAW,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,UAAU,CAC9D,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,MAAc;QAClD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAqB,oBAAoB,CAAC,IAAI,EAAE,CAAC;QAC3F,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEpD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,CAAC;IACtE,CAAC;IAEO,mBAAmB,CAAC,MAAc;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAE3C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QAE3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/D,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1D,KAAK,GAAG;gBACN,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACrD;gBACE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,QAA4B;QAC1D,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACT,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;YAChE,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA8B,CAC/B,CAAC;IACJ,CAAC;IAEO,uBAAuB,CAAC,KAAoC;QAClE,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,+BAA+B;QAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QAElF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,6EAA6E,CAAC,CAAC;QACzF,CAAC;QAED,0BAA0B;QAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CACpF,CAAC,CAAC,CAAC,CAAC;QAEL,IAAI,WAAW,EAAE,CAAC;YAChB,eAAe,CAAC,IAAI,CAClB,OAAO,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CACzI,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC;QAE1E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,eAAe,CAAC,IAAI,CAClB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,oCAAoC,CAC3F,CAAC;QACJ,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,KAAgB,EAAE,MAAc;QACpD,OAAO;YACL,KAAK;YACL,MAAM;YACN,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,kBAAkB,EAAE,CAAC;YACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;YAC7D,OAAO,EAAE;gBACP,sBAAsB,EAAE,CAAC;gBACzB,mBAAmB,EAAE,CAAC;gBACtB,eAAe,EAAE,CAAC;gBAClB,eAAe,EAAE,CAAC;aACnB;YACD,WAAW,EAAE;gBACX,oBAAoB,EAAE,CAAC;gBACvB,eAAe,EAAE,CAAC;gBAClB,oBAAoB,EAAE,CAAC;aACxB;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,CAAC;gBACZ,qBAAqB,EAAE,CAAC;gBACxB,cAAc,EAAE,EAA8B;aAC/C;YACD,SAAS,EAAE,EAA8B;SAC1C,CAAC;IACJ,CAAC;CACF"}

package/dist/ai/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DCYFR AI Framework - Main Entry Point
+ *
+ * Portable AI agent framework with plugin architecture
+ * @module @dcyfr/ai
+ */
+export { TelemetryEngine, TelemetrySessionManager } from './core/telemetry-engine';
+export { ProviderRegistry, RateLimitError, ProviderUnavailableError, type ProviderRegistryConfig, } from './core/provider-registry';
+export type { ProviderType, AgentType, TaskType, TaskOutcome, ValidationStatus, ValidationSeverity, StorageType, Plugin, PluginManifest, PluginHooks, ValidationContext, ValidationResult, ValidationViolation, StorageAdapter, FrameworkConfig, ProviderConfig, ProviderHealth, TaskContext, ExecutionResult, CostEstimate, } from './types';
+export type { TelemetrySession, TelemetryMetrics, ViolationRecord, HandoffRecord, AgentStats, ComparisonStats, HandoffPatterns, } from './types/telemetry';
+export { PluginLoader, PluginLoadError, PluginValidationError, getGlobalPluginLoader, resetGlobalPluginLoader, type PluginLoaderConfig, } from './plugins/plugin-loader';
+export { ValidationFramework, type ValidationFrameworkConfig, type ValidationGate, type ValidationReport, } from './validation/validation-framework';
+export { ConfigLoader, loadConfig, type LoaderOptions, } from './config/loader';
+export { FrameworkConfigSchema, DesignTokenConfigSchema, BarrelExportConfigSchema, PageLayoutConfigSchema, TestDataConfigSchema, PluginConfigSchema, ValidationGateConfigSchema, TelemetryConfigSchema, ProviderConfigSchema, DEFAULT_CONFIG, type DesignTokenConfig, type BarrelExportConfig, type PageLayoutConfig, type TestDataConfig, type Severity, type FailureMode, } from './config/schema';
+export { createStorageAdapter, MemoryStorageAdapter, FileStorageAdapter } from './utils/storage';
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGjG,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,21 @@
+/**
+ * DCYFR AI Framework - Main Entry Point
+ *
+ * Portable AI agent framework with plugin architecture
+ * @module @dcyfr/ai
+ */
+// Core exports
+export { TelemetryEngine, TelemetrySessionManager } from './core/telemetry-engine';
+export { ProviderRegistry, RateLimitError, ProviderUnavailableError, } from './core/provider-registry';
+// Plugin system exports
+export { PluginLoader, PluginLoadError, PluginValidationError, getGlobalPluginLoader, resetGlobalPluginLoader, } from './plugins/plugin-loader';
+// Validation framework exports
+export { ValidationFramework, } from './validation/validation-framework';
+// Configuration system exports
+export { ConfigLoader, loadConfig, } from './config/loader';
+export { FrameworkConfigSchema, DesignTokenConfigSchema, BarrelExportConfigSchema, PageLayoutConfigSchema, TestDataConfigSchema, PluginConfigSchema, ValidationGateConfigSchema, TelemetryConfigSchema, ProviderConfigSchema, DEFAULT_CONFIG, } from './config/schema';
+// Utility exports
+export { createStorageAdapter, MemoryStorageAdapter, FileStorageAdapter } from './utils/storage';
+// Version
+export const VERSION = '1.0.0';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../packages/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAqClC,wBAAwB;AACxB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC,+BAA+B;AAC/B,OAAO,EACL,mBAAmB,GAIpB,MAAM,mCAAmC,CAAC;AAE3C,+BAA+B;AAC/B,OAAO,EACL,YAAY,EACZ,UAAU,GAEX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GAOf,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEjG,UAAU;AACV,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/ai/plugins/plugin-loader.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Plugin Loader - Dynamic plugin loading and lifecycle management
+ *
+ * Handles loading, validation, and execution of plugins with manifest validation
+ * and error isolation.
+ *
+ * @module @dcyfr/ai/plugins/plugin-loader
+ * @example
+ * ```typescript
+ * import { PluginLoader } from '@dcyfr/ai/plugins/plugin-loader';
+ *
+ * const loader = new PluginLoader();
+ *
+ * // Load a plugin
+ * await loader.loadPlugin('@dcyfr/agents/design-token-validator');
+ *
+ * // Execute plugin validation
+ * const result = await loader.validateAll({
+ *   projectRoot: '/path/to/project',
+ *   files: ['src/app.ts'],
+ *   config: {},
+ * });
+ * ```
+ */
+import type { Plugin, PluginManifest, ValidationContext, ValidationResult } from '../types';
+/**
+ * Plugin load error
+ */
+export declare class PluginLoadError extends Error {
+    pluginName: string;
+    cause?: Error | undefined;
+    constructor(message: string, pluginName: string, cause?: Error | undefined);
+}
+/**
+ * Plugin validation error
+ */
+export declare class PluginValidationError extends Error {
+    pluginName: string;
+    constructor(message: string, pluginName: string);
+}
+/**
+ * Plugin loader configuration
+ */
+export interface PluginLoaderConfig {
+    autoLoad?: boolean;
+    failureMode?: 'throw' | 'warn' | 'silent';
+    timeout?: number;
+}
+/**
+ * Loaded plugin wrapper
+ */
+interface LoadedPlugin {
+    name: string;
+    manifest: PluginManifest;
+    plugin: Plugin;
+    loaded: Date;
+    enabled: boolean;
+}
+/**
+ * Plugin Loader - manages plugin lifecycle
+ */
+export declare class PluginLoader {
+    private plugins;
+    private config;
+    constructor(config?: PluginLoaderConfig);
+    /**
+     * Load a plugin by module path or object
+     */
+    loadPlugin(pluginPath: string | Plugin): Promise<void>;
+    /**
+     * Load multiple plugins
+     */
+    loadPlugins(plugins: (string | Plugin)[]): Promise<void>;
+    /**
+     * Unload a plugin
+     */
+    unloadPlugin(pluginName: string): Promise<void>;
+    /**
+     * Enable a plugin
+     */
+    enablePlugin(pluginName: string): void;
+    /**
+     * Disable a plugin
+     */
+    disablePlugin(pluginName: string): void;
+    /**
+     * Validate all enabled plugins
+     */
+    validateAll(context: ValidationContext): Promise<ValidationResult>;
+    /**
+     * Validate with specific plugins
+     */
+    validateWith(pluginNames: string[], context: ValidationContext): Promise<ValidationResult>;
+    /**
+     * Get loaded plugin info
+     */
+    getPlugin(name: string): LoadedPlugin | undefined;
+    /**
+     * Get all loaded plugins
+     */
+    getPlugins(): LoadedPlugin[];
+    /**
+     * Get plugin count
+     */
+    getPluginCount(): number;
+    /**
+     * Clear all plugins
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Validate plugin manifest
+     */
+    private validateManifest;
+    /**
+     * Execute function with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Merge multiple validation results
+     */
+    private mergeResults;
+}
+/**
+ * Get or create global plugin loader
+ */
+export declare function getGlobalPluginLoader(config?: PluginLoaderConfig): PluginLoader;
+/**
+ * Reset global plugin loader
+ */
+export declare function resetGlobalPluginLoader(): void;
+export {};
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/ai/plugins/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../packages/ai/plugins/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5F;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACJ,UAAU,EAAE,MAAM;IAAS,KAAK,CAAC,EAAE,KAAK;gBAAhE,OAAO,EAAE,MAAM,EAAS,UAAU,EAAE,MAAM,EAAS,KAAK,CAAC,EAAE,KAAK,YAAA;CAI7E;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IACV,UAAU,EAAE,MAAM;gBAA1C,OAAO,EAAE,MAAM,EAAS,UAAU,EAAE,MAAM;CAIvD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAS3C;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0D5D;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrD;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQtC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmCxE;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC;IA2C5B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;YACW,kBAAkB;IAahC;;OAEG;IACH,OAAO,CAAC,YAAY;CAwBrB;AAOD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAK/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}