@dcyfr/ai 1.0.4 → 2.1.1

package/dist/ai/src/performance-profiler.js

@@ -0,0 +1,475 @@
+/**
+ * Performance Profiler and Optimization Manager
+ * TLP:CLEAR
+ *
+ * Comprehensive performance profiling, monitoring, and optimization
+ * system for DCYFR integration workflows. Provides real-time metrics,
+ * bottleneck identification, and automatic optimization recommendations.
+ *
+ * @version 1.0.0
+ * @date 2026-02-15
+ * @module dcyfr-ai/performance-profiler
+ */
+import { EventEmitter } from 'events';
+import { performance } from 'perf_hooks';
+/**
+ * Performance Profiler and Optimization Manager
+ *
+ * Comprehensive performance monitoring and optimization system providing
+ * real-time metrics, bottleneck detection, and optimization recommendations.
+ */
+export class PerformanceProfiler extends EventEmitter {
+    config;
+    metrics = new Map();
+    benchmarks = new Map();
+    bottlenecks = new Map();
+    recommendations = new Map();
+    activeTimers = new Map();
+    monitoringInterval;
+    memoryBaseline = 0;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            enableRealTimeMonitoring: true,
+            monitoringInterval: 5000, // 5 seconds
+            enableBottleneckDetection: true,
+            baselines: {},
+            memoryProfiling: {
+                enabled: true,
+                sampleInterval: 1000,
+                trackAllocations: true,
+            },
+            cpuProfiling: {
+                enabled: true,
+                sampleInterval: 100,
+            },
+            enableOptimizationRecommendations: true,
+            alerts: {
+                enabled: true,
+                thresholds: {
+                    memoryUsage: 0.8, // 80% of available memory
+                    cpuUsage: 0.9, // 90% CPU usage
+                    responseTime: 5000, // 5 second response time
+                },
+            },
+            ...config,
+        };
+        this.memoryBaseline = this.getMemoryUsage();
+        if (this.config.enableRealTimeMonitoring) {
+            this.startMonitoring();
+        }
+    }
+    /**
+     * Start performance timer
+     */
+    startTimer(operation) {
+        const timerId = `${operation}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        this.activeTimers.set(timerId, performance.now());
+        this.emit('timer_started', { timerId, operation });
+        return timerId;
+    }
+    /**
+     * End performance timer and record metric
+     */
+    endTimer(timerId, context) {
+        const startTime = this.activeTimers.get(timerId);
+        if (!startTime) {
+            throw new Error(`Timer not found: ${timerId}`);
+        }
+        const endTime = performance.now();
+        const executionTime = endTime - startTime;
+        this.activeTimers.delete(timerId);
+        const metric = {
+            id: `timing-${timerId}`,
+            name: timerId.split('-')[0],
+            value: executionTime,
+            unit: 'ms',
+            category: 'timing',
+            timestamp: new Date(),
+            context,
+        };
+        this.recordMetric(metric);
+        this.emit('timer_ended', { timerId, executionTime, context });
+        return executionTime;
+    }
+    /**
+     * Record performance metric
+     */
+    recordMetric(metric) {
+        const categoryMetrics = this.metrics.get(metric.category) || [];
+        categoryMetrics.push(metric);
+        // Keep only last 1000 metrics per category for memory efficiency
+        if (categoryMetrics.length > 1000) {
+            categoryMetrics.splice(0, categoryMetrics.length - 1000);
+        }
+        this.metrics.set(metric.category, categoryMetrics);
+        // Check for alerts
+        if (this.config.alerts.enabled) {
+            this.checkPerformanceAlerts(metric);
+        }
+        // Check for bottlenecks
+        if (this.config.enableBottleneckDetection) {
+            this.detectBottlenecks(metric);
+        }
+        this.emit('metric_recorded', metric);
+    }
+    /**
+     * Run performance benchmark
+     */
+    async benchmark(operation, fn, parameters, iterations = 1) {
+        const benchmarkId = `bench-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        let result;
+        let totalExecutionTime = 0;
+        let totalMemoryDelta = 0;
+        for (let i = 0; i < iterations; i++) {
+            const memoryBefore = this.getMemoryUsage();
+            const startTime = performance.now();
+            if (i === 0) {
+                // Only capture result from first iteration
+                result = await fn();
+            }
+            else {
+                await fn();
+            }
+            const endTime = performance.now();
+            const memoryAfter = this.getMemoryUsage();
+            totalExecutionTime += endTime - startTime;
+            totalMemoryDelta += memoryAfter - memoryBefore;
+        }
+        const avgExecutionTime = totalExecutionTime / iterations;
+        const avgMemoryDelta = totalMemoryDelta / iterations;
+        const throughput = iterations / (totalExecutionTime / 1000); // ops per second
+        const benchmark = {
+            benchmarkId,
+            operation,
+            executionTime: avgExecutionTime,
+            memoryBefore: this.memoryBaseline,
+            memoryAfter: this.getMemoryUsage(),
+            memoryDelta: avgMemoryDelta,
+            throughput,
+            parameters,
+            completedAt: new Date(),
+        };
+        // Store benchmark result
+        const operationBenchmarks = this.benchmarks.get(operation) || [];
+        operationBenchmarks.push(benchmark);
+        this.benchmarks.set(operation, operationBenchmarks);
+        this.emit('benchmark_completed', benchmark);
+        return { result: result, benchmark };
+    }
+    /**
+     * Get current memory usage in bytes
+     */
+    getMemoryUsage() {
+        if (typeof process !== 'undefined' && process.memoryUsage) {
+            return process.memoryUsage().heapUsed;
+        }
+        return 0; // Browser environment fallback
+    }
+    /**
+     * Start real-time monitoring
+     */
+    startMonitoring() {
+        this.monitoringInterval = setInterval(() => {
+            this.collectSystemMetrics();
+        }, this.config.monitoringInterval);
+    }
+    /**
+     * Collect system-wide performance metrics
+     */
+    collectSystemMetrics() {
+        const memoryUsage = this.getMemoryUsage();
+        const memoryMetric = {
+            id: `memory-${Date.now()}`,
+            name: 'memory_usage',
+            value: memoryUsage,
+            unit: 'bytes',
+            category: 'memory',
+            timestamp: new Date(),
+        };
+        this.recordMetric(memoryMetric);
+        // Record active timers count
+        const timersMetric = {
+            id: `timers-${Date.now()}`,
+            name: 'active_timers',
+            value: this.activeTimers.size,
+            unit: 'count',
+            category: 'resource',
+            timestamp: new Date(),
+        };
+        this.recordMetric(timersMetric);
+    }
+    /**
+     * Check for performance alerts
+     */
+    checkPerformanceAlerts(metric) {
+        const thresholds = this.config.alerts.thresholds;
+        if (metric.name === 'memory_usage' && metric.unit === 'bytes') {
+            const memoryThreshold = thresholds.memoryUsage * (1024 * 1024 * 1024); // Convert to bytes
+            if (metric.value > memoryThreshold) {
+                this.emit('performance_alert', {
+                    type: 'memory_exceeded',
+                    metric,
+                    threshold: memoryThreshold,
+                    severity: 'high',
+                });
+            }
+        }
+        if (metric.category === 'timing' && metric.unit === 'ms') {
+            if (metric.value > thresholds.responseTime) {
+                this.emit('performance_alert', {
+                    type: 'slow_response',
+                    metric,
+                    threshold: thresholds.responseTime,
+                    severity: 'medium',
+                });
+            }
+        }
+    }
+    /**
+     * Detect performance bottlenecks
+     */
+    detectBottlenecks(metric) {
+        const baseline = this.config.baselines[metric.name];
+        if (!baseline)
+            return;
+        const performanceImpact = (metric.value - baseline) / baseline;
+        if (performanceImpact > 0.5) { // 50% slower than baseline
+            const bottleneck = {
+                id: `bottleneck-${metric.name}-${Date.now()}`,
+                component: metric.name,
+                severity: Math.min(10, Math.floor(performanceImpact * 10)),
+                type: this.categorizeBottleneckType(metric),
+                performanceImpact,
+                recommendations: this.generateBottleneckRecommendations(metric, performanceImpact),
+                detectedAt: new Date(),
+                metrics: [metric],
+            };
+            this.bottlenecks.set(bottleneck.id, bottleneck);
+            this.emit('bottleneck_detected', bottleneck);
+            if (this.config.enableOptimizationRecommendations) {
+                this.generateOptimizationRecommendations(bottleneck);
+            }
+        }
+    }
+    /**
+     * Categorize bottleneck type based on metric
+     */
+    categorizeBottleneckType(metric) {
+        if (metric.category === 'memory')
+            return 'memory';
+        if (metric.category === 'timing' && metric.name.includes('network'))
+            return 'network';
+        if (metric.category === 'timing' && metric.name.includes('io'))
+            return 'io';
+        if (metric.category === 'timing')
+            return 'cpu';
+        if (metric.category === 'resource')
+            return 'concurrency';
+        return 'algorithm';
+    }
+    /**
+     * Generate bottleneck-specific recommendations
+     */
+    generateBottleneckRecommendations(metric, impact) {
+        const recommendations = [];
+        if (metric.category === 'timing') {
+            if (impact > 2) {
+                recommendations.push('Consider implementing caching for frequently accessed data');
+                recommendations.push('Evaluate algorithm complexity and optimize if possible');
+            }
+            if (impact > 1) {
+                recommendations.push('Implement batching for bulk operations');
+                recommendations.push('Consider parallelization opportunities');
+            }
+        }
+        if (metric.category === 'memory') {
+            recommendations.push('Review memory allocation patterns');
+            recommendations.push('Implement object pooling for frequently created objects');
+            recommendations.push('Add garbage collection optimization');
+        }
+        return recommendations;
+    }
+    /**
+     * Generate optimization recommendations
+     */
+    generateOptimizationRecommendations(bottleneck) {
+        const recommendation = {
+            id: `opt-${bottleneck.id}`,
+            target: bottleneck.component,
+            type: this.getRecommendationType(bottleneck.type),
+            priority: bottleneck.severity,
+            expectedImprovement: {
+                metric: bottleneck.component,
+                currentValue: bottleneck.metrics[0]?.value || 0,
+                targetValue: (bottleneck.metrics[0]?.value || 0) * (1 - Math.min(0.5, bottleneck.performanceImpact / 2)),
+                improvementPercent: Math.min(50, bottleneck.performanceImpact * 50),
+            },
+            complexity: this.estimateImplementationComplexity(bottleneck.type),
+            description: `Optimize ${bottleneck.component} to address ${bottleneck.type} bottleneck`,
+            implementationSteps: bottleneck.recommendations,
+            generatedAt: new Date(),
+        };
+        this.recommendations.set(recommendation.id, recommendation);
+        this.emit('optimization_recommendation', recommendation);
+    }
+    /**
+     * Get recommendation type based on bottleneck type
+     */
+    getRecommendationType(bottleneckType) {
+        const mapping = {
+            cpu: 'algorithm',
+            memory: 'resource',
+            io: 'caching',
+            network: 'caching',
+            concurrency: 'parallelization',
+            algorithm: 'algorithm',
+        };
+        return mapping[bottleneckType] || 'configuration';
+    }
+    /**
+     * Estimate implementation complexity
+     */
+    estimateImplementationComplexity(bottleneckType) {
+        const complexity = {
+            cpu: 3,
+            memory: 3,
+            io: 2,
+            network: 2,
+            concurrency: 5,
+            algorithm: 4,
+        };
+        return complexity[bottleneckType] || 3;
+    }
+    /**
+     * Get performance metrics summary
+     */
+    getMetricsSummary() {
+        const totalMetrics = Array.from(this.metrics.values()).reduce((sum, metrics) => sum + metrics.length, 0);
+        const categories = {};
+        for (const [category, metrics] of this.metrics.entries()) {
+            categories[category] = metrics.length;
+        }
+        return {
+            totalMetrics,
+            categories,
+            recentAlerts: 0, // Would track alerts from event emissions
+            activeBottlenecks: this.bottlenecks.size,
+            pendingRecommendations: this.recommendations.size,
+        };
+    }
+    /**
+     * Get benchmark results for operation
+     */
+    getBenchmarkResults(operation) {
+        if (operation) {
+            return this.benchmarks.get(operation) || [];
+        }
+        return Array.from(this.benchmarks.values()).flat();
+    }
+    /**
+     * Get performance bottlenecks
+     */
+    getBottlenecks() {
+        return Array.from(this.bottlenecks.values());
+    }
+    /**
+     * Get optimization recommendations
+     */
+    getRecommendations(priorityFilter) {
+        const recommendations = Array.from(this.recommendations.values());
+        if (priorityFilter !== undefined) {
+            return recommendations.filter(rec => rec.priority >= priorityFilter);
+        }
+        return recommendations.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Clear performance data
+     */
+    clearData(categories) {
+        if (categories) {
+            for (const category of categories) {
+                this.metrics.delete(category);
+            }
+        }
+        else {
+            this.metrics.clear();
+            this.benchmarks.clear();
+            this.bottlenecks.clear();
+            this.recommendations.clear();
+        }
+        this.emit('data_cleared', { categories });
+    }
+    /**
+     * Export performance data
+     */
+    exportData() {
+        return {
+            metrics: Object.fromEntries(this.metrics),
+            benchmarks: Object.fromEntries(this.benchmarks),
+            bottlenecks: Array.from(this.bottlenecks.values()),
+            recommendations: Array.from(this.recommendations.values()),
+            summary: this.getMetricsSummary(),
+        };
+    }
+    /**
+     * Shutdown profiler
+     */
+    shutdown() {
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+        }
+        this.activeTimers.clear();
+        this.removeAllListeners();
+        this.emit('shutdown_complete');
+    }
+}
+/**
+ * Global performance profiler instance
+ */
+let globalProfiler = null;
+/**
+ * Get or create global performance profiler instance
+ */
+export function getGlobalProfiler(config) {
+    if (!globalProfiler) {
+        globalProfiler = new PerformanceProfiler(config);
+    }
+    return globalProfiler;
+}
+/**
+ * Performance profiling decorator for class methods
+ */
+export function profileMethod(operation) {
+    return function (target, propertyName, descriptor) {
+        const method = descriptor.value;
+        const profiler = getGlobalProfiler();
+        descriptor.value = async function (...args) {
+            const operationName = operation || `${target.constructor.name}.${propertyName}`;
+            const timerId = profiler.startTimer(operationName);
+            try {
+                const result = await method.apply(this, args);
+                return result;
+            }
+            finally {
+                profiler.endTimer(timerId, { args: args.length });
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Performance profiling function wrapper
+ */
+export async function profileFunction(operation, fn, profiler) {
+    const activeProfiler = profiler || getGlobalProfiler();
+    const timerId = activeProfiler.startTimer(operation);
+    try {
+        return await fn();
+    }
+    finally {
+        activeProfiler.endTimer(timerId);
+    }
+}
+export default PerformanceProfiler;
+//# sourceMappingURL=performance-profiler.js.map

package/dist/ai/src/performance-profiler.js.map

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

package/dist/ai/src/personas/hooks/before-llm-call.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview BeforeLLMCallHook — injects resolved brand voice and agent
+ * persona prefix into the system prompt before each LLM call.
+ * @module @dcyfr/ai/personas/hooks/before-llm-call
+ * @license MIT
+ */
+import type { AgentPersona, ResolvedVoice, VoiceResolverOptions } from '../types';
+/**
+ * Input context passed to a BeforeLLMCallHook.
+ */
+export interface BeforeLLMCallInput {
+    /**
+     * Current system prompt (may be empty string)
+     */
+    systemPrompt: string;
+    /**
+     * Agent name to resolve persona for (e.g., 'dcyfr-engineer')
+     */
+    agentName?: string;
+    /**
+     * Pre-loaded persona (skips persona loading if provided)
+     */
+    persona?: AgentPersona;
+    /**
+     * Additional context string (e.g., conversation topic, task type)
+     */
+    context?: string;
+}
+/**
+ * Output returned by a BeforeLLMCallHook.
+ */
+export interface BeforeLLMCallOutput {
+    /**
+     * Modified system prompt with voice prefix injected
+     */
+    systemPrompt: string;
+    /**
+     * The voice that was resolved and applied
+     */
+    resolvedVoice: ResolvedVoice;
+    /**
+     * Whether the hook was skipped (enabled: false or error)
+     */
+    skipped: boolean;
+}
+/**
+ * Configuration for the BeforeLLMCallHook
+ */
+export interface BeforeLLMCallHookConfig {
+    /**
+     * Enable or disable the hook (default: true)
+     */
+    enabled?: boolean;
+    /**
+     * Voice resolver options (tone, verbosity, etc.)
+     */
+    voiceOptions?: VoiceResolverOptions;
+    /**
+     * Separator between injected prefix and existing system prompt
+     * (default: '\n\n')
+     */
+    separator?: string;
+    /**
+     * Placement: prepend (default) or append the voice prefix
+     */
+    placement?: 'prepend' | 'append';
+}
+/**
+ * Interface for before-LLM-call hooks.
+ * Implement this to create custom pre-call transformations.
+ */
+export interface BeforeLLMCallHook {
+    readonly name: string;
+    execute(input: BeforeLLMCallInput): BeforeLLMCallOutput | Promise<BeforeLLMCallOutput>;
+}
+/**
+ * Brand voice injection hook. Resolves the agent persona and prepends (or
+ * appends) the voice system prefix to the system prompt.
+ *
+ * @example
+ * ```typescript
+ * const hook = createBrandVoiceHook({ enabled: true, voiceOptions: { verbosity: 2 } });
+ * const { systemPrompt } = hook.execute({ agentName: 'dcyfr-engineer', systemPrompt: '' });
+ * ```
+ */
+export declare class BrandVoiceHook implements BeforeLLMCallHook {
+    readonly name = "brand-voice-inject";
+    private readonly config;
+    constructor(config?: BeforeLLMCallHookConfig);
+    execute(input: BeforeLLMCallInput): BeforeLLMCallOutput;
+}
+/**
+ * Creates a BrandVoiceHook with the given configuration.
+ */
+export declare function createBrandVoiceHook(config?: BeforeLLMCallHookConfig): BrandVoiceHook;
+//# sourceMappingURL=before-llm-call.d.ts.map

package/dist/ai/src/personas/hooks/before-llm-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-llm-call.d.ts","sourceRoot":"","sources":["../../../../../packages/ai/src/personas/hooks/before-llm-call.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAQlF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxF;AAMD;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,wBAAwB;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAE/C,MAAM,GAAE,uBAA4B;IAShD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB;CA0CxD;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,cAAc,CAErF"}

package/dist/ai/src/personas/hooks/before-llm-call.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview BeforeLLMCallHook — injects resolved brand voice and agent
+ * persona prefix into the system prompt before each LLM call.
+ * @module @dcyfr/ai/personas/hooks/before-llm-call
+ * @license MIT
+ */
+import { loadPersona } from '../persona-loader.js';
+import { resolveVoice } from '../voice-resolver.js';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Brand voice injection hook. Resolves the agent persona and prepends (or
+ * appends) the voice system prefix to the system prompt.
+ *
+ * @example
+ * ```typescript
+ * const hook = createBrandVoiceHook({ enabled: true, voiceOptions: { verbosity: 2 } });
+ * const { systemPrompt } = hook.execute({ agentName: 'dcyfr-engineer', systemPrompt: '' });
+ * ```
+ */
+export class BrandVoiceHook {
+    name = 'brand-voice-inject';
+    config;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            voiceOptions: config.voiceOptions ?? {},
+            separator: config.separator ?? '\n\n',
+            placement: config.placement ?? 'prepend',
+        };
+    }
+    execute(input) {
+        if (!this.config.enabled) {
+            const fallbackPersona = input.persona ?? {
+                name: input.agentName ?? 'unknown',
+                title: 'Agent',
+                role: '',
+                capabilities: [],
+                voice_tone: null,
+            };
+            return {
+                systemPrompt: input.systemPrompt,
+                resolvedVoice: resolveVoice(fallbackPersona, { enabled: false }),
+                skipped: true,
+            };
+        }
+        // Load or use provided persona
+        const persona = input.persona ?? loadPersona(input.agentName ?? 'default').persona;
+        // Resolve voice
+        const resolvedVoice = resolveVoice(persona, this.config.voiceOptions);
+        // Inject prefix
+        let systemPrompt;
+        if (!resolvedVoice.systemPrefix) {
+            systemPrompt = input.systemPrompt;
+        }
+        else if (this.config.placement === 'append') {
+            systemPrompt = [input.systemPrompt, resolvedVoice.systemPrefix]
+                .filter(Boolean)
+                .join(this.config.separator);
+        }
+        else {
+            systemPrompt = [resolvedVoice.systemPrefix, input.systemPrompt]
+                .filter(Boolean)
+                .join(this.config.separator);
+        }
+        return {
+            systemPrompt,
+            resolvedVoice,
+            skipped: false,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a BrandVoiceHook with the given configuration.
+ */
+export function createBrandVoiceHook(config) {
+    return new BrandVoiceHook(config);
+}
+//# sourceMappingURL=before-llm-call.js.map

package/dist/ai/src/personas/hooks/before-llm-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-llm-call.js","sourceRoot":"","sources":["../../../../../packages/ai/src/personas/hooks/before-llm-call.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA0FjD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,oBAAoB,CAAC;IAEpB,MAAM,CAAoC;IAE3D,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;YACvC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;YACrC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;SACzC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAyB;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,IAAI;gBACvC,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;gBAClC,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,EAAE;gBACR,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,IAAI;aACjB,CAAC;YACF,OAAO;gBACL,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,aAAa,EAAE,YAAY,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBAChE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC;QAEnF,gBAAgB;QAChB,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAEtE,gBAAgB;QAChB,IAAI,YAAoB,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;YAChC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACpC,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,YAAY,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC;iBAC5D,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC;iBAC5D,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,YAAY;YACZ,aAAa;YACb,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}