observability-toolkit 1.8.5 → 2.1.0

package/dist/lib/audit/verification-events.js

@@ -0,0 +1,175 @@
+/**
+ * Human Verification Event Tracking for EU AI Act Compliance
+ *
+ * Implements event schema and recording for human oversight verification
+ * per EU AI Act Article 12(3)(d).
+ *
+ * @see https://eur-lex.europa.eu/eli/reg/2024/1689/oj
+ */
+import { z } from 'zod';
+import { SessionIdSchema, TraceIdSchema } from '../core/shared-schemas.js';
+import { join, dirname } from 'path';
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { createLogger } from '../core/logger.js';
+import { MAX_RETURNED_VERIFICATIONS, HOOKS_TELEMETRY_DIR, DEFAULT_ALLOWED_BASES } from '../core/constants.js';
+import { getDateString, streamJsonlWithValidation, listFiles, parseDateFromFilename } from '../core/file-utils.js';
+const logger = createLogger('verification');
+/** Valid verification types for runtime validation */
+export const VALID_VERIFICATION_TYPES = [
+    'approval',
+    'rejection',
+    'override',
+    'review',
+];
+/**
+ * Zod schema for human verification events
+ */
+export const humanVerificationEventSchema = z.object({
+    timestamp: z.iso.datetime().describe('ISO 8601 timestamp'),
+    sessionId: SessionIdSchema.describe('Claude Code session ID'),
+    traceId: TraceIdSchema.optional().describe('Associated trace ID'),
+    verificationType: z.enum(['approval', 'rejection', 'override', 'review']).describe('Verification action type'),
+    verifierId: z.string().optional().describe('Verifier identifier'),
+    originalOutput: z.string().optional().describe('Original AI output'),
+    verifiedOutput: z.string().optional().describe('Human-verified output'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata'),
+});
+/**
+ * Get the verifications directory path
+ */
+export function getVerificationsDir(telemetryDir = HOOKS_TELEMETRY_DIR) {
+    return join(telemetryDir, 'verifications');
+}
+/**
+ * Get the verification file path for a given date
+ */
+export function getVerificationFilePath(date = new Date(), telemetryDir = HOOKS_TELEMETRY_DIR) {
+    const dateStr = getDateString(date);
+    return join(getVerificationsDir(telemetryDir), `${dateStr}.jsonl`);
+}
+/**
+ * Validate a verification type
+ */
+export function isValidVerificationType(type) {
+    return typeof type === 'string' && VALID_VERIFICATION_TYPES.includes(type);
+}
+/**
+ * Record a human verification event.
+ * Logs via structured logger and stores to JSONL file.
+ *
+ * @param event - Verification event data (timestamp will be added automatically)
+ * @param telemetryDir - Optional telemetry directory (for testing)
+ * @throws Error if verificationType is invalid
+ *
+ * @example
+ * ```typescript
+ * recordVerification({
+ *   sessionId: 'a8a71f9f-58de-4733-b912-d677b14f1575',
+ *   verificationType: 'approval',
+ *   verifierId: 'user-001',
+ * });
+ * ```
+ */
+export function recordVerification(event, telemetryDir = HOOKS_TELEMETRY_DIR) {
+    // Validate verification type
+    if (!isValidVerificationType(event.verificationType)) {
+        throw new Error(`Invalid verificationType: '${event.verificationType}'. ` +
+            `Must be one of: ${VALID_VERIFICATION_TYPES.join(', ')}`);
+    }
+    // Validate required fields
+    if (!event.sessionId || typeof event.sessionId !== 'string' || event.sessionId.trim().length === 0) {
+        throw new Error('sessionId is required and must be a non-empty string');
+    }
+    const fullEvent = {
+        ...event,
+        timestamp: new Date().toISOString(),
+    };
+    // Log for immediate audit trail
+    logger.info('Human verification recorded', {
+        sessionId: fullEvent.sessionId,
+        verificationType: fullEvent.verificationType,
+        verifierId: fullEvent.verifierId,
+        traceId: fullEvent.traceId,
+    });
+    // Store to JSONL
+    appendVerificationEvent(fullEvent, telemetryDir);
+}
+/**
+ * Append a verification event to the JSONL file
+ */
+function appendVerificationEvent(event, telemetryDir) {
+    const filePath = getVerificationFilePath(new Date(), telemetryDir);
+    const dir = dirname(filePath);
+    // Ensure directory exists
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Append event as JSONL
+    const line = JSON.stringify(event) + '\n';
+    appendFileSync(filePath, line, 'utf-8');
+}
+/**
+ * Get verification files within date range
+ */
+function getVerificationFiles(telemetryDir, startDate, endDate) {
+    const dir = getVerificationsDir(telemetryDir);
+    // Include telemetryDir itself so custom dirs (e.g. test temp dirs) are permitted (CR-H2)
+    const allowedBases = [...DEFAULT_ALLOWED_BASES, telemetryDir];
+    const files = listFiles(dir, /^\d{4}-\d{2}-\d{2}\.jsonl$/, allowedBases);
+    if (!startDate && !endDate) {
+        // Default to today only
+        const today = getDateString();
+        return files.filter(f => {
+            const date = parseDateFromFilename(f);
+            return date === today;
+        });
+    }
+    return files.filter(f => {
+        const date = parseDateFromFilename(f);
+        if (!date)
+            return false;
+        if (startDate && date < startDate)
+            return false;
+        if (endDate && date > endDate)
+            return false;
+        return true;
+    });
+}
+/**
+ * Query verification events from JSONL files
+ *
+ * @param options - Query options
+ * @param telemetryDir - Optional telemetry directory (for testing)
+ * @returns Array of matching verification events
+ *
+ * @example
+ * ```typescript
+ * const events = await queryVerifications({
+ *   sessionId: 'a8a71f9f-58de-4733-b912-d677b14f1575',
+ *   startDate: '2026-01-01',
+ *   endDate: '2026-01-31',
+ * });
+ * ```
+ */
+export async function queryVerifications(options, telemetryDir = HOOKS_TELEMETRY_DIR) {
+    const files = getVerificationFiles(telemetryDir, options.startDate, options.endDate);
+    const results = [];
+    const limit = options.limit || MAX_RETURNED_VERIFICATIONS;
+    for (const file of files) {
+        for await (const event of streamJsonlWithValidation(file, humanVerificationEventSchema)) {
+            // Apply filters
+            if (options.sessionId && event.sessionId !== options.sessionId)
+                continue;
+            if (options.traceId && event.traceId !== options.traceId)
+                continue;
+            if (options.verificationType && event.verificationType !== options.verificationType)
+                continue;
+            results.push(event);
+            if (results.length >= limit) {
+                return results;
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=verification-events.js.map

package/dist/lib/audit/verification-events.js.map

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

package/dist/lib/audit/verification-events.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for human verification event tracking
+ */
+export {};
+//# sourceMappingURL=verification-events.test.d.ts.map

package/dist/lib/audit/verification-events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-events.test.d.ts","sourceRoot":"","sources":["../../../src/lib/audit/verification-events.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/audit/verification-events.test.js

@@ -0,0 +1,197 @@
+/**
+ * Tests for human verification event tracking
+ */
+import { describe, it, beforeEach, afterEach } from 'vitest';
+import assert from 'node:assert';
+import { existsSync, rmSync, mkdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { COUNT_FIVE, COUNT_TEN, COUNT_TWO, RANDOM_STRING_RADIX, RANDOM_SUFFIX_START, } from '../../test-helpers/test-constants.js';
+import { testTraceId } from '../../test-helpers/test-data-builders.js';
+import { recordVerification, queryVerifications, isValidVerificationType, VALID_VERIFICATION_TYPES, getVerificationFilePath, getVerificationsDir, } from './verification-events.js';
+const INVALID_NON_STRING_VERIFICATION_TYPE = 123;
+describe('verification-events', () => {
+    let testDir;
+    beforeEach(() => {
+        // Create a unique temp directory for each test
+        testDir = join(tmpdir(), `obs-toolkit-test-${Date.now()}-${Math.random().toString(RANDOM_STRING_RADIX).slice(RANDOM_SUFFIX_START)}`);
+        mkdirSync(testDir, { recursive: true });
+    });
+    afterEach(() => {
+        // Clean up test directory
+        if (testDir && existsSync(testDir)) {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    describe('isValidVerificationType', () => {
+        it('should return true for valid verification types', () => {
+            for (const type of VALID_VERIFICATION_TYPES) {
+                assert.strictEqual(isValidVerificationType(type), true, `${type} should be valid`);
+            }
+        });
+        it('should return false for invalid types', () => {
+            assert.strictEqual(isValidVerificationType('invalid'), false);
+            assert.strictEqual(isValidVerificationType(''), false);
+            assert.strictEqual(isValidVerificationType(null), false);
+            assert.strictEqual(isValidVerificationType(undefined), false);
+            assert.strictEqual(isValidVerificationType(INVALID_NON_STRING_VERIFICATION_TYPE), false);
+        });
+    });
+    describe('getVerificationsDir', () => {
+        it('should return verifications subdirectory of telemetry dir', () => {
+            const dir = getVerificationsDir('/test/telemetry');
+            assert.strictEqual(dir, '/test/telemetry/verifications');
+        });
+    });
+    describe('getVerificationFilePath', () => {
+        it('should return path with date-based filename', () => {
+            const date = new Date('2026-01-31T12:00:00Z');
+            const path = getVerificationFilePath(date, '/test/telemetry');
+            assert.strictEqual(path, '/test/telemetry/verifications/2026-01-31.jsonl');
+        });
+    });
+    describe('recordVerification', () => {
+        it('should record event with all fields', () => {
+            const event = {
+                sessionId: 'sess-123',
+                traceId: testTraceId(1),
+                verificationType: 'approval',
+                verifierId: 'user-001',
+                originalOutput: 'AI output',
+                verifiedOutput: 'Corrected output',
+                metadata: { custom: 'data' },
+            };
+            recordVerification(event, testDir);
+            // Verify file was created
+            const verificationsDir = getVerificationsDir(testDir);
+            assert.ok(existsSync(verificationsDir), 'verifications directory should exist');
+            // Read and parse the file
+            const filePath = getVerificationFilePath(new Date(), testDir);
+            const content = readFileSync(filePath, 'utf-8').trim();
+            const recorded = JSON.parse(content);
+            assert.strictEqual(recorded.sessionId, 'sess-123');
+            assert.strictEqual(recorded.traceId, testTraceId(1));
+            assert.strictEqual(recorded.verificationType, 'approval');
+            assert.strictEqual(recorded.verifierId, 'user-001');
+            assert.strictEqual(recorded.originalOutput, 'AI output');
+            assert.strictEqual(recorded.verifiedOutput, 'Corrected output');
+            assert.deepStrictEqual(recorded.metadata, { custom: 'data' });
+            assert.ok(recorded.timestamp, 'should have timestamp');
+        });
+        it('should record event with minimal fields', () => {
+            recordVerification({
+                sessionId: 'sess-minimal',
+                verificationType: 'review',
+            }, testDir);
+            const filePath = getVerificationFilePath(new Date(), testDir);
+            const content = readFileSync(filePath, 'utf-8').trim();
+            const recorded = JSON.parse(content);
+            assert.strictEqual(recorded.sessionId, 'sess-minimal');
+            assert.strictEqual(recorded.verificationType, 'review');
+            assert.ok(recorded.timestamp);
+            assert.strictEqual(recorded.traceId, undefined);
+            assert.strictEqual(recorded.verifierId, undefined);
+        });
+        it('should reject invalid verification type', () => {
+            assert.throws(() => recordVerification({
+                sessionId: 'sess-123',
+                verificationType: 'invalid',
+            }, testDir), /Invalid verificationType.*invalid.*Must be one of/);
+        });
+        it('should reject missing sessionId', () => {
+            assert.throws(() => recordVerification({
+                sessionId: '',
+                verificationType: 'approval',
+            }, testDir), /sessionId is required/);
+        });
+        it('should record all four verification types', () => {
+            const types = ['approval', 'rejection', 'override', 'review'];
+            for (const type of types) {
+                recordVerification({
+                    sessionId: `sess-${type}`,
+                    verificationType: type,
+                }, testDir);
+            }
+            // Verify all were recorded
+            const filePath = getVerificationFilePath(new Date(), testDir);
+            const lines = readFileSync(filePath, 'utf-8').trim().split('\n');
+            assert.strictEqual(lines.length, types.length);
+            const recordedTypes = lines.map(line => JSON.parse(line).verificationType);
+            assert.deepStrictEqual(recordedTypes.sort(), types.sort());
+        });
+    });
+    describe('queryVerifications', () => {
+        it('should return empty array when no events exist', async () => {
+            const results = await queryVerifications({}, testDir);
+            assert.deepStrictEqual(results, []);
+        });
+        it('should query by session ID', async () => {
+            // Record events for different sessions
+            recordVerification({ sessionId: 'sess-A', verificationType: 'approval' }, testDir);
+            recordVerification({ sessionId: 'sess-B', verificationType: 'rejection' }, testDir);
+            recordVerification({ sessionId: 'sess-A', verificationType: 'review' }, testDir);
+            const results = await queryVerifications({ sessionId: 'sess-A' }, testDir);
+            assert.strictEqual(results.length, COUNT_TWO);
+            assert.ok(results.every(r => r.sessionId === 'sess-A'));
+        });
+        it('should query by verification type', async () => {
+            recordVerification({ sessionId: 'sess-1', verificationType: 'approval' }, testDir);
+            recordVerification({ sessionId: 'sess-2', verificationType: 'rejection' }, testDir);
+            recordVerification({ sessionId: 'sess-3', verificationType: 'approval' }, testDir);
+            const results = await queryVerifications({ verificationType: 'approval' }, testDir);
+            assert.strictEqual(results.length, COUNT_TWO);
+            assert.ok(results.every(r => r.verificationType === 'approval'));
+        });
+        it('should query by trace ID', async () => {
+            recordVerification({ sessionId: 'sess-1', verificationType: 'approval', traceId: testTraceId(10) }, testDir);
+            recordVerification({ sessionId: 'sess-2', verificationType: 'rejection', traceId: testTraceId(11) }, testDir);
+            recordVerification({ sessionId: 'sess-3', verificationType: 'review', traceId: testTraceId(10) }, testDir);
+            const results = await queryVerifications({ traceId: testTraceId(10) }, testDir);
+            assert.strictEqual(results.length, COUNT_TWO);
+            assert.ok(results.every(r => r.traceId === testTraceId(10)));
+        });
+        it('should respect limit parameter', async () => {
+            // Record 10 events
+            for (let i = 0; i < COUNT_TEN; i++) {
+                recordVerification({ sessionId: `sess-${i}`, verificationType: 'approval' }, testDir);
+            }
+            const results = await queryVerifications({ limit: COUNT_FIVE }, testDir);
+            assert.strictEqual(results.length, COUNT_FIVE);
+        });
+        it('should combine multiple filters', async () => {
+            recordVerification({ sessionId: 'sess-A', verificationType: 'approval', traceId: testTraceId(20) }, testDir);
+            recordVerification({ sessionId: 'sess-A', verificationType: 'rejection', traceId: testTraceId(20) }, testDir);
+            recordVerification({ sessionId: 'sess-B', verificationType: 'approval', traceId: testTraceId(20) }, testDir);
+            recordVerification({ sessionId: 'sess-A', verificationType: 'approval', traceId: testTraceId(21) }, testDir);
+            const results = await queryVerifications({
+                sessionId: 'sess-A',
+                verificationType: 'approval',
+            }, testDir);
+            assert.strictEqual(results.length, COUNT_TWO);
+            assert.ok(results.every(r => r.sessionId === 'sess-A' && r.verificationType === 'approval'));
+        });
+        it('should handle default limit of 50', async () => {
+            // Default limit should be 50
+            const results = await queryVerifications({}, testDir);
+            // Even though empty, verify the query completes
+            assert.ok(Array.isArray(results));
+        });
+    });
+    describe('VALID_VERIFICATION_TYPES', () => {
+        it('should contain all four types', () => {
+            const expectedTypes = ['approval', 'rejection', 'override', 'review'];
+            assert.strictEqual(VALID_VERIFICATION_TYPES.length, expectedTypes.length);
+            assert.ok(VALID_VERIFICATION_TYPES.includes('approval'));
+            assert.ok(VALID_VERIFICATION_TYPES.includes('rejection'));
+            assert.ok(VALID_VERIFICATION_TYPES.includes('override'));
+            assert.ok(VALID_VERIFICATION_TYPES.includes('review'));
+        });
+        it('should be readonly at TypeScript level', () => {
+            // TypeScript enforces readonly at compile time
+            // At runtime, we just verify the expected values
+            const types = [...VALID_VERIFICATION_TYPES];
+            assert.deepStrictEqual(types.sort(), ['approval', 'override', 'rejection', 'review']);
+        });
+    });
+});
+//# sourceMappingURL=verification-events.test.js.map

package/dist/lib/audit/verification-events.test.js.map

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

package/dist/lib/core/constants-models.d.ts

@@ -0,0 +1,90 @@
+export declare const GEMINI_WINDOW_SIZE = 1000000;
+export declare const CONTEXT_WINDOW_SIZE = 200000;
+export declare const OPENAI_WINDOW_SIZE_LARGE = 200000;
+export declare const PERPLEXITY_WINDOW_SIZE = 200000;
+export declare const OPENAI_WINDOW_SIZE = 128000;
+export declare const COHERE_WINDOW_SIZE = 128000;
+export declare const MISTRAL_WINDOW_SIZE = 128000;
+export declare const LLAMA_WINDOW_SIZE = 128000;
+export declare const PERPLEXITY_SONAR_WINDOW_SIZE = 128000;
+export declare const OPENAI_WINDOW_SIZE_SMALL = 16385;
+export declare const OPENAI_WINDOW_SIZE_EX_SMALL = 8192;
+export declare const LLAMA_WINDOW_MIXTRAL_SIZE = 32768;
+export declare const GEMINI_WINDOW_SIZE_SMALL = 32760;
+export declare const MISTRAL_MEDIUM_WINDOW_SIZE = 32000;
+export declare const COHERE_COMMAND_WINDOW_SIZE = 4096;
+export declare const LLAMA_WINDOW_SIZE_SMALL = 8192;
+/**
+ * Per-model context window sizes (tokens).
+ * Used by obs_context_stats and obs_token_budget for utilization calculations.
+ *
+ * Sources (verified 2026-03-02):
+ * - Anthropic: https://platform.claude.com/docs/en/build-with-claude/context-windows
+ * - OpenAI: https://openai.com/index/gpt-4-1/
+ * - Google: https://docs.cloud.google.com/vertex-ai/generative-ai/docs/models/gemini/2-0-flash
+ * - Mistral: https://mistral.ai/pricing
+ */
+export declare const MODEL_CONTEXT_WINDOWS: Record<string, number>;
+/**
+ * Look up context window size for a model, with fallback to CONTEXT_WINDOW_SIZE.
+ * Supports partial model name matching (e.g. 'claude-opus' matches 'claude-opus-4-6').
+ */
+export declare function getContextWindowSize(model: string): number;
+/** R7: Context utilization alert thresholds (fraction 0-1) */
+export declare const CONTEXT_ALERT_THRESHOLDS: {
+    readonly WARNING: 0.7;
+    readonly CRITICAL: 0.8;
+    readonly EXCEEDED: 0.95;
+};
+export declare const TOKENS_PER_CHAR = 0.25;
+/** API pricing divisor (cost per million tokens) */
+export declare const TOKENS_PER_MILLION = 1000000;
+/**
+ * Model pricing metadata for staleness detection
+ */
+export declare const MODEL_PRICING_METADATA: {
+    /** ISO date when pricing was last updated */
+    readonly lastUpdated: "2026-02-14";
+    /** Days after which pricing is considered stale */
+    readonly staleThresholdDays: 90;
+    /** Pricing sources for verification */
+    readonly sources: {
+        readonly anthropic: "https://www.anthropic.com/pricing";
+        readonly openai: "https://openai.com/pricing";
+        readonly google: "https://ai.google.dev/pricing";
+        readonly mistral: "https://mistral.ai/pricing";
+        readonly cohere: "https://cohere.com/pricing";
+        readonly groq: "https://groq.com/pricing";
+        readonly together: "https://www.together.ai/pricing";
+        readonly perplexity: "https://www.perplexity.ai/pricing";
+    };
+};
+/**
+ * Check if pricing data is stale (>90 days old)
+ * @returns { isStale: boolean, daysSinceUpdate: number }
+ */
+export declare function checkPricingStaleness(): {
+    isStale: boolean;
+    daysSinceUpdate: number;
+};
+/**
+ * Model pricing per 1M tokens (as of Feb 2026)
+ *
+ * Pricing sources:
+ * - Anthropic: https://www.anthropic.com/pricing
+ * - OpenAI: https://openai.com/pricing
+ * - Google: https://ai.google.dev/pricing
+ * - Mistral: https://mistral.ai/pricing
+ * - Cohere: https://cohere.com/pricing
+ *
+ * Note: Pricing changes frequently. These are approximate values for cost estimation.
+ * For batch API pricing, multiply by 0.5 (50% discount typically).
+ *
+ * @see MODEL_PRICING_METADATA.lastUpdated for when this data was last verified
+ */
+export declare const MODEL_PRICING: Record<string, {
+    input: number;
+    output: number;
+    provider: string;
+}>;
+//# sourceMappingURL=constants-models.d.ts.map

package/dist/lib/core/constants-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-models.d.ts","sourceRoot":"","sources":["../../../src/lib/core/constants-models.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,UAAc,CAAC;AAC9C,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAC3C,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAC3C,eAAO,MAAM,iBAAiB,SAAU,CAAC;AACzC,eAAO,MAAM,4BAA4B,SAAU,CAAC;AACpD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AACjD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAChD,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2DxD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED,8DAA8D;AAC9D,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAGX,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,UAAc,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,6CAA6C;;IAE7C,mDAAmD;;IAEnD,uCAAuC;;;;;;;;;;;CAW/B,CAAC;AAEX;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAQrF;AAID;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAwD7F,CAAC"}