@auxiora/runtime 1.10.1 → 1.10.6

package/dist/__tests__/telemetry-wiring.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry-wiring.test.d.ts.map

package/dist/__tests__/telemetry-wiring.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-wiring.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/telemetry-wiring.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/telemetry-wiring.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect, vi } from 'vitest';
+import { wireTelemetry } from '../telemetry-wiring.js';
+describe('wireTelemetry', () => {
+    it('records completed jobs to telemetry tracker', () => {
+        const tracker = { recordJob: vi.fn() };
+        const emitter = { on: vi.fn() };
+        wireTelemetry(emitter, tracker);
+        const completedHandler = emitter.on.mock.calls.find((c) => c[0] === 'job:completed');
+        expect(completedHandler).toBeTruthy();
+        completedHandler[1]({
+            job: { id: 'j1', type: 'behavior', status: 'completed', createdAt: Date.now() - 5000, completedAt: Date.now() },
+            result: {},
+        });
+        expect(tracker.recordJob).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'behavior',
+            success: true,
+            jobId: 'j1',
+        }));
+    });
+    it('records failed jobs to telemetry tracker', () => {
+        const tracker = { recordJob: vi.fn() };
+        const emitter = { on: vi.fn() };
+        wireTelemetry(emitter, tracker);
+        const failedHandler = emitter.on.mock.calls.find((c) => c[0] === 'job:failed');
+        failedHandler[1]({
+            job: { id: 'j2', type: 'react', status: 'failed', createdAt: Date.now() - 1000, completedAt: Date.now() },
+            error: new Error('timeout'),
+        });
+        expect(tracker.recordJob).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'react',
+            success: false,
+            jobId: 'j2',
+            error: 'timeout',
+        }));
+    });
+    it('records dead jobs with default message when no error provided', () => {
+        const tracker = { recordJob: vi.fn() };
+        const emitter = { on: vi.fn() };
+        wireTelemetry(emitter, tracker);
+        const deadHandler = emitter.on.mock.calls.find((c) => c[0] === 'job:dead');
+        deadHandler[1]({
+            job: { id: 'j3', type: 'workflow', status: 'dead', createdAt: Date.now() - 2000, completedAt: Date.now() },
+        });
+        expect(tracker.recordJob).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'workflow',
+            success: false,
+            jobId: 'j3',
+            error: 'dead letter',
+        }));
+    });
+    it('registers listeners for all three event types', () => {
+        const tracker = { recordJob: vi.fn() };
+        const emitter = { on: vi.fn() };
+        wireTelemetry(emitter, tracker);
+        const events = emitter.on.mock.calls.map((c) => c[0]);
+        expect(events).toContain('job:completed');
+        expect(events).toContain('job:failed');
+        expect(events).toContain('job:dead');
+    });
+});
+//# sourceMappingURL=telemetry-wiring.test.js.map

package/dist/__tests__/telemetry-wiring.test.js.map

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

package/dist/confidence.d.ts

@@ -0,0 +1,46 @@
+export type ConfidenceLevel = 'low' | 'medium' | 'high';
+export type KnowledgeSource = 'user_data' | 'inference' | 'generation' | 'tool_result' | 'search_result';
+export interface ConfidenceSignal {
+    /** What type of signal this is */
+    source: KnowledgeSource;
+    /** Confidence from this signal (0-1) */
+    confidence: number;
+    /** Description of the evidence */
+    evidence: string;
+}
+export interface ConfidenceAssessment {
+    /** Overall confidence level */
+    level: ConfidenceLevel;
+    /** Numeric score (0-1) */
+    score: number;
+    /** Human-readable explanation */
+    explanation: string;
+    /** Individual signals that contributed */
+    signals: ConfidenceSignal[];
+    /** Source breakdown: what percentage of the response came from each source type */
+    sourceBreakdown: Record<KnowledgeSource, number>;
+    /** Uncertainty markers for display */
+    uncertaintyMarkers: UncertaintyMarker[];
+}
+export interface UncertaintyMarker {
+    /** The response segment this applies to */
+    segmentHint: string;
+    /** What kind of knowledge this is */
+    source: KnowledgeSource;
+    /** Human-readable label */
+    label: string;
+}
+export declare class ConfidenceAssessor {
+    /**
+     * Assess confidence for a response based on available signals.
+     */
+    assess(signals: ConfidenceSignal[]): ConfidenceAssessment;
+    /** Quick assessment for a fully-generated response with no grounding */
+    assessGenerated(): ConfidenceAssessment;
+    /** Convert a numeric score to a level */
+    scoreToLevel(score: number): ConfidenceLevel;
+    private buildMarkers;
+    private buildExplanation;
+    private defaultAssessment;
+}
+//# sourceMappingURL=confidence.d.ts.map

package/dist/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../src/confidence.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,eAAe,CAAC;AAEzG,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACjD,sCAAsC;IACtC,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,oBAAoB;IAoDzD,wEAAwE;IACxE,eAAe,IAAI,oBAAoB;IAQvC,yCAAyC;IACzC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAM5C,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/confidence.js

@@ -0,0 +1,112 @@
+import { getLogger } from '@auxiora/logger';
+const logger = getLogger('runtime:confidence');
+export class ConfidenceAssessor {
+    /**
+     * Assess confidence for a response based on available signals.
+     */
+    assess(signals) {
+        if (signals.length === 0) {
+            return this.defaultAssessment();
+        }
+        // Weighted average: user_data and tool_result weigh more than generation
+        const weights = {
+            user_data: 1.5,
+            tool_result: 1.3,
+            search_result: 1.2,
+            inference: 0.8,
+            generation: 0.5,
+        };
+        let weightedSum = 0;
+        let totalWeight = 0;
+        const sourceCounts = {};
+        for (const signal of signals) {
+            const weight = weights[signal.source] ?? 1;
+            weightedSum += signal.confidence * weight;
+            totalWeight += weight;
+            sourceCounts[signal.source] = (sourceCounts[signal.source] ?? 0) + 1;
+        }
+        const score = totalWeight > 0 ? weightedSum / totalWeight : 0.5;
+        const level = this.scoreToLevel(score);
+        // Build source breakdown (percentage)
+        const sourceBreakdown = {};
+        for (const [source, count] of Object.entries(sourceCounts)) {
+            sourceBreakdown[source] = count / signals.length;
+        }
+        // Build uncertainty markers
+        const markers = this.buildMarkers(signals);
+        // Build explanation
+        const explanation = this.buildExplanation(level, score, signals);
+        logger.debug('Confidence assessed', { level, score: score.toFixed(2), signalCount: signals.length });
+        return {
+            level,
+            score: Math.round(score * 100) / 100,
+            explanation,
+            signals,
+            sourceBreakdown: sourceBreakdown,
+            uncertaintyMarkers: markers,
+        };
+    }
+    /** Quick assessment for a fully-generated response with no grounding */
+    assessGenerated() {
+        return this.assess([{
+                source: 'generation',
+                confidence: 0.5,
+                evidence: 'Response generated from model knowledge',
+            }]);
+    }
+    /** Convert a numeric score to a level */
+    scoreToLevel(score) {
+        if (score >= 0.7)
+            return 'high';
+        if (score >= 0.4)
+            return 'medium';
+        return 'low';
+    }
+    buildMarkers(signals) {
+        const markers = [];
+        const sourceLabels = {
+            user_data: 'Based on your data',
+            inference: 'Inferred from context',
+            generation: 'AI generated',
+            tool_result: 'From tool output',
+            search_result: 'From web search',
+        };
+        // Group by source type and create one marker per type
+        const seen = new Set();
+        for (const signal of signals) {
+            if (seen.has(signal.source))
+                continue;
+            seen.add(signal.source);
+            markers.push({
+                segmentHint: signal.evidence,
+                source: signal.source,
+                label: sourceLabels[signal.source] ?? signal.source,
+            });
+        }
+        return markers;
+    }
+    buildExplanation(level, score, signals) {
+        const pct = Math.round(score * 100);
+        const sources = [...new Set(signals.map(s => s.source))];
+        const sourceStr = sources.join(', ');
+        switch (level) {
+            case 'high':
+                return `High confidence (${pct}%) — grounded in ${sourceStr}`;
+            case 'medium':
+                return `Medium confidence (${pct}%) — partially grounded in ${sourceStr}`;
+            case 'low':
+                return `Low confidence (${pct}%) — mostly generated, limited grounding`;
+        }
+    }
+    defaultAssessment() {
+        return {
+            level: 'low',
+            score: 0.5,
+            explanation: 'No confidence signals available',
+            signals: [],
+            sourceBreakdown: {},
+            uncertaintyMarkers: [],
+        };
+    }
+}
+//# sourceMappingURL=confidence.js.map

package/dist/confidence.js.map

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

package/dist/enrichment/__tests__/integration.test.js

@@ -3,6 +3,7 @@ import { EnrichmentPipeline } from '../pipeline.js';
 import { MemoryStage } from '../stages/memory-stage.js';
 import { ArchitectStage } from '../stages/architect-stage.js';
 import { SelfAwarenessStage } from '../stages/self-awareness-stage.js';
+import { TelemetryStage } from '../stages/telemetry-stage.js';
 function makeCtx(overrides = {}) {
     return {
         basePrompt: 'You are Auxiora.',
@@ -65,6 +66,15 @@ describe('EnrichmentPipeline integration', () => {
         expect(result.prompt).toContain('[Security Expert Mode]');
         expect(result.prompt).toContain('[Dynamic Self-Awareness]');
     });
+    it('includes telemetry warnings in enriched prompt when tools are flagged', async () => {
+        const pipeline = new EnrichmentPipeline();
+        pipeline.addStage(new TelemetryStage(() => [
+            { tool: 'provider.complete', totalCalls: 20, successRate: 0.3, lastError: 'rate limited' },
+        ]));
+        const result = await pipeline.run(makeCtx());
+        expect(result.prompt).toContain('[Operational Telemetry]');
+        expect(result.metadata.stages).toContain('telemetry');
+    });
     it('skips architect stage for non-architect personality', async () => {
         const pipeline = new EnrichmentPipeline();
         const architect = { generatePrompt: vi.fn(), getTraitMix: vi.fn() };

package/dist/enrichment/__tests__/integration.test.js.map

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

package/dist/enrichment/__tests__/telemetry-stage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry-stage.test.d.ts.map

package/dist/enrichment/__tests__/telemetry-stage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stage.test.d.ts","sourceRoot":"","sources":["../../../src/enrichment/__tests__/telemetry-stage.test.ts"],"names":[],"mappings":""}

package/dist/enrichment/__tests__/telemetry-stage.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect } from 'vitest';
+import { TelemetryStage } from '../stages/telemetry-stage.js';
+function makeCtx(overrides) {
+    return {
+        basePrompt: 'You are Auxiora.',
+        userMessage: 'hello',
+        history: [],
+        channelType: 'webchat',
+        chatId: 'c1',
+        sessionId: 's1',
+        userId: 'u1',
+        toolsUsed: [],
+        config: {},
+        ...overrides,
+    };
+}
+describe('TelemetryStage', () => {
+    it('has order 50 (before all other stages)', () => {
+        const stage = new TelemetryStage(() => []);
+        expect(stage.order).toBe(50);
+        expect(stage.name).toBe('telemetry');
+    });
+    it('appends nothing when no flagged tools', async () => {
+        const stage = new TelemetryStage(() => []);
+        const result = await stage.enrich(makeCtx(), 'base prompt');
+        expect(result.prompt).toBe('base prompt');
+    });
+    it('appends warning section when a tool is flagged', async () => {
+        const flagged = [
+            { tool: 'provider.complete', totalCalls: 20, successRate: 0.4, lastError: 'rate limited' },
+        ];
+        const stage = new TelemetryStage(() => flagged);
+        // Must call enabled() first to cache stats
+        stage.enabled(makeCtx());
+        const result = await stage.enrich(makeCtx(), 'base prompt');
+        expect(result.prompt).toContain('[Operational Telemetry]');
+        expect(result.prompt).toContain('provider.complete');
+        expect(result.prompt).toContain('40%');
+        expect(result.prompt).toContain('rate limited');
+    });
+    it('includes metadata with flagged tool names', async () => {
+        const flagged = [
+            { tool: 'memory.search', totalCalls: 10, successRate: 0.3, lastError: 'timeout' },
+        ];
+        const stage = new TelemetryStage(() => flagged);
+        stage.enabled(makeCtx());
+        const result = await stage.enrich(makeCtx(), 'base');
+        expect(result.metadata?.flaggedTools).toContain('memory.search');
+    });
+    it('is disabled when getter returns empty array', () => {
+        const stage = new TelemetryStage(() => []);
+        expect(stage.enabled(makeCtx())).toBe(false);
+    });
+    it('is enabled when there are flagged tools', () => {
+        const stage = new TelemetryStage(() => [
+            { tool: 'x', totalCalls: 10, successRate: 0.3, lastError: '' },
+        ]);
+        expect(stage.enabled(makeCtx())).toBe(true);
+    });
+});
+//# sourceMappingURL=telemetry-stage.test.js.map

package/dist/enrichment/__tests__/telemetry-stage.test.js.map

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

package/dist/enrichment/index.d.ts

@@ -5,4 +5,9 @@ export { ModeStage } from './stages/mode-stage.js';
 export { ArchitectStage } from './stages/architect-stage.js';
 export { SelfAwarenessStage } from './stages/self-awareness-stage.js';
 export { ModelIdentityStage } from './stages/model-identity-stage.js';
+export { GroupContextStage } from './stages/group-context-stage.js';
+export { TelemetryStage } from './stages/telemetry-stage.js';
+export type { TelemetryStatsLike } from './stages/telemetry-stage.js';
+export { LearningStage } from './stages/learning-stage.js';
+export type { LearningLike } from './stages/learning-stage.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/enrichment/index.js

@@ -4,4 +4,7 @@ export { ModeStage } from './stages/mode-stage.js';
 export { ArchitectStage } from './stages/architect-stage.js';
 export { SelfAwarenessStage } from './stages/self-awareness-stage.js';
 export { ModelIdentityStage } from './stages/model-identity-stage.js';
+export { GroupContextStage } from './stages/group-context-stage.js';
+export { TelemetryStage } from './stages/telemetry-stage.js';
+export { LearningStage } from './stages/learning-stage.js';
 //# sourceMappingURL=index.js.map

package/dist/enrichment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/enrichment/stages/group-context-stage.d.ts

@@ -0,0 +1,8 @@
+import type { EnrichmentContext, EnrichmentStage, StageResult } from '../types.js';
+export declare class GroupContextStage implements EnrichmentStage {
+    readonly name = "group-context";
+    readonly order = 150;
+    enabled(ctx: EnrichmentContext): boolean;
+    enrich(ctx: EnrichmentContext, currentPrompt: string): Promise<StageResult>;
+}
+//# sourceMappingURL=group-context-stage.d.ts.map

package/dist/enrichment/stages/group-context-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-context-stage.d.ts","sourceRoot":"","sources":["../../../src/enrichment/stages/group-context-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnF,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,KAAK,OAAO;IAErB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO;IAIlC,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAsBlF"}

package/dist/enrichment/stages/group-context-stage.js

@@ -0,0 +1,24 @@
+export class GroupContextStage {
+    name = 'group-context';
+    order = 150;
+    enabled(ctx) {
+        return ctx.groupContext?.isGroup === true;
+    }
+    async enrich(ctx, currentPrompt) {
+        const parts = ['You are in a group chat'];
+        if (ctx.groupContext?.groupName) {
+            parts[0] += ` called "${ctx.groupContext.groupName}"`;
+        }
+        if (ctx.groupContext?.participantCount) {
+            parts.push(`with ~${ctx.groupContext.participantCount} participants`);
+        }
+        const instruction = [parts.join(' ') + '.'];
+        if (ctx.senderName) {
+            instruction.push(`The current speaker is ${ctx.senderName}. Address them by name.`);
+        }
+        instruction.push('Keep responses concise — group chats move fast.');
+        const section = '\n\n[Group Context]\n' + instruction.join(' ');
+        return { prompt: currentPrompt + section };
+    }
+}
+//# sourceMappingURL=group-context-stage.js.map

package/dist/enrichment/stages/group-context-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-context-stage.js","sourceRoot":"","sources":["../../../src/enrichment/stages/group-context-stage.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,eAAe,CAAC;IACvB,KAAK,GAAG,GAAG,CAAC;IAErB,OAAO,CAAC,GAAsB;QAC5B,OAAO,GAAG,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAsB,EAAE,aAAqB;QACxD,MAAM,KAAK,GAAa,CAAC,yBAAyB,CAAC,CAAC;QAEpD,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,GAAG,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC;QACxD,CAAC;QAED,IAAI,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,YAAY,CAAC,gBAAgB,eAAe,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QAE5C,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,UAAU,yBAAyB,CAAC,CAAC;QACtF,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,uBAAuB,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/enrichment/stages/learning-stage.d.ts

@@ -0,0 +1,17 @@
+import type { EnrichmentContext, EnrichmentStage, StageResult } from '../types.js';
+/** Structural type — avoids importing @auxiora/telemetry directly */
+export interface LearningLike {
+    readonly content: string;
+    readonly category: string;
+    readonly occurrences: number;
+}
+export declare class LearningStage implements EnrichmentStage {
+    private readonly getRecentLearnings;
+    readonly name = "learning";
+    readonly order = 55;
+    private cachedLearnings;
+    constructor(getRecentLearnings: () => LearningLike[]);
+    enabled(_ctx: EnrichmentContext): boolean;
+    enrich(_ctx: EnrichmentContext, currentPrompt: string): Promise<StageResult>;
+}
+//# sourceMappingURL=learning-stage.d.ts.map

package/dist/enrichment/stages/learning-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-stage.d.ts","sourceRoot":"","sources":["../../../src/enrichment/stages/learning-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnF,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,aAAc,YAAW,eAAe;IAOjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IANrC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,KAAK,MAAM;IAEpB,OAAO,CAAC,eAAe,CAAsB;gBAG1B,kBAAkB,EAAE,MAAM,YAAY,EAAE;IAG3D,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO;IAKnC,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA2BnF"}

package/dist/enrichment/stages/learning-stage.js

@@ -0,0 +1,37 @@
+export class LearningStage {
+    getRecentLearnings;
+    name = 'learning';
+    order = 55;
+    cachedLearnings = [];
+    constructor(getRecentLearnings) {
+        this.getRecentLearnings = getRecentLearnings;
+    }
+    enabled(_ctx) {
+        this.cachedLearnings = this.getRecentLearnings();
+        return this.cachedLearnings.length > 0;
+    }
+    async enrich(_ctx, currentPrompt) {
+        const learnings = this.cachedLearnings.length > 0
+            ? this.cachedLearnings
+            : this.getRecentLearnings();
+        if (learnings.length === 0) {
+            return { prompt: currentPrompt };
+        }
+        const lines = ['[Learned Patterns]', 'Insights from previous tasks:'];
+        for (const l of learnings) {
+            let line = `- [${l.category}] ${l.content}`;
+            if (l.occurrences > 1) {
+                line += ` (seen ${l.occurrences}x)`;
+            }
+            lines.push(line);
+        }
+        lines.push('Apply these insights where relevant.');
+        lines.push('');
+        const section = lines.join('\n');
+        return {
+            prompt: currentPrompt + '\n\n' + section,
+            metadata: { learningCount: learnings.length },
+        };
+    }
+}
+//# sourceMappingURL=learning-stage.js.map

package/dist/enrichment/stages/learning-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-stage.js","sourceRoot":"","sources":["../../../src/enrichment/stages/learning-stage.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,aAAa;IAOL;IANV,IAAI,GAAG,UAAU,CAAC;IAClB,KAAK,GAAG,EAAE,CAAC;IAEZ,eAAe,GAAmB,EAAE,CAAC;IAE7C,YACmB,kBAAwC;QAAxC,uBAAkB,GAAlB,kBAAkB,CAAsB;IACxD,CAAC;IAEJ,OAAO,CAAC,IAAuB;QAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAuB,EAAE,aAAqB;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YAC/C,CAAC,CAAC,IAAI,CAAC,eAAe;YACtB,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE9B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,oBAAoB,EAAE,+BAA+B,CAAC,CAAC;QACtE,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5C,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,IAAI,UAAU,CAAC,CAAC,WAAW,IAAI,CAAC;YACtC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO;YACL,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO;YACxC,QAAQ,EAAE,EAAE,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE;SAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/enrichment/stages/telemetry-stage.d.ts

@@ -0,0 +1,18 @@
+import type { EnrichmentContext, EnrichmentStage, StageResult } from '../types.js';
+/** Structural type — avoids importing @auxiora/telemetry directly */
+export interface TelemetryStatsLike {
+    readonly tool: string;
+    readonly totalCalls: number;
+    readonly successRate: number;
+    readonly lastError: string;
+}
+export declare class TelemetryStage implements EnrichmentStage {
+    private readonly getFlaggedTools;
+    readonly name = "telemetry";
+    readonly order = 50;
+    private cachedStats;
+    constructor(getFlaggedTools: () => TelemetryStatsLike[]);
+    enabled(_ctx: EnrichmentContext): boolean;
+    enrich(_ctx: EnrichmentContext, currentPrompt: string): Promise<StageResult>;
+}
+//# sourceMappingURL=telemetry-stage.d.ts.map

package/dist/enrichment/stages/telemetry-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stage.d.ts","sourceRoot":"","sources":["../../../src/enrichment/stages/telemetry-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnF,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,cAAe,YAAW,eAAe;IAOlD,OAAO,CAAC,QAAQ,CAAC,eAAe;IANlC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,KAAK,MAAM;IAEpB,OAAO,CAAC,WAAW,CAA4B;gBAG5B,eAAe,EAAE,MAAM,kBAAkB,EAAE;IAG9D,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO;IAKnC,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA4BnF"}

package/dist/enrichment/stages/telemetry-stage.js

@@ -0,0 +1,39 @@
+export class TelemetryStage {
+    getFlaggedTools;
+    name = 'telemetry';
+    order = 50;
+    cachedStats = [];
+    constructor(getFlaggedTools) {
+        this.getFlaggedTools = getFlaggedTools;
+    }
+    enabled(_ctx) {
+        this.cachedStats = this.getFlaggedTools();
+        return this.cachedStats.length > 0;
+    }
+    async enrich(_ctx, currentPrompt) {
+        // Self-contained: re-fetch if enabled() wasn't called (defensive)
+        const stats = this.cachedStats.length > 0 ? this.cachedStats : this.getFlaggedTools();
+        if (stats.length === 0) {
+            return { prompt: currentPrompt };
+        }
+        const lines = ['[Operational Telemetry]', 'The following tools have degraded performance:'];
+        for (const s of stats) {
+            const pct = Math.round(s.successRate * 100);
+            let line = `- ${s.tool}: ${pct}% success rate (${s.totalCalls} calls)`;
+            if (s.lastError) {
+                line += ` — last error: ${s.lastError.slice(0, 150)}`;
+            }
+            lines.push(line);
+        }
+        lines.push('Consider alternative approaches if these tools fail.');
+        lines.push('');
+        const section = lines.join('\n');
+        return {
+            prompt: currentPrompt + '\n\n' + section,
+            metadata: {
+                flaggedTools: stats.map(s => s.tool),
+            },
+        };
+    }
+}
+//# sourceMappingURL=telemetry-stage.js.map

package/dist/enrichment/stages/telemetry-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stage.js","sourceRoot":"","sources":["../../../src/enrichment/stages/telemetry-stage.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,cAAc;IAON;IANV,IAAI,GAAG,WAAW,CAAC;IACnB,KAAK,GAAG,EAAE,CAAC;IAEZ,WAAW,GAAyB,EAAE,CAAC;IAE/C,YACmB,eAA2C;QAA3C,oBAAe,GAAf,eAAe,CAA4B;IAC3D,CAAC;IAEJ,OAAO,CAAC,IAAuB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAuB,EAAE,aAAqB;QACzD,kEAAkE;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QACtF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,yBAAyB,EAAE,gDAAgD,CAAC,CAAC;QAC5F,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;YAC5C,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,mBAAmB,CAAC,CAAC,UAAU,SAAS,CAAC;YACvE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAChB,IAAI,IAAI,kBAAkB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACxD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO;YACL,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO;YACxC,QAAQ,EAAE;gBACR,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACrC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/enrichment/types.d.ts

@@ -15,6 +15,12 @@ export interface EnrichmentContext {
         success: boolean;
     }>;
     readonly config: Config;
+    readonly senderName?: string;
+    readonly groupContext?: {
+        readonly isGroup: boolean;
+        readonly groupName?: string;
+        readonly participantCount?: number;
+    };
 }
 export interface StageResult {
     readonly prompt: string;

package/dist/enrichment/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/enrichment/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;QACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/enrichment/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;QACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;CACH"}