observability-toolkit 2.0.0 → 2.1.0

package/dist/tools/audit-trail.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Audit trail tool for EU AI Act compliance
+ *
+ * Provides three actions:
+ * - query: Search audit records with filters
+ * - report: Generate compliance report (Articles 12, 13, 19)
+ * - verify: Verify hash chain integrity
+ *
+ * @see EU AI Act Articles 12, 13, 19
+ */
+import { z } from 'zod';
+import { type AuditRecord, type AuditQueryOptions } from '../lib/audit/audit-record.js';
+export declare const auditTrailSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    startDate: z.ZodOptional<z.ZodISODate>;
+    endDate: z.ZodOptional<z.ZodISODate>;
+    evaluationName: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    action: z.ZodEnum<{
+        query: "query";
+        report: "report";
+        verify: "verify";
+    }>;
+    category: z.ZodOptional<z.ZodEnum<{
+        verification: "verification";
+        trace: "trace";
+        system: "system";
+        evaluation: "evaluation";
+    }>>;
+}, z.core.$strip>;
+export type AuditTrailInput = z.input<typeof auditTrailSchema>;
+export interface AuditTrailOptions {
+    queryFn?: (options: AuditQueryOptions) => Promise<AuditRecord[]>;
+}
+/**
+ * Audit trail handler — dispatches to query, report, or verify.
+ */
+export declare const auditTrail: (rawInput: {
+    action: "query" | "report" | "verify";
+    limit?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    evaluationName?: string | undefined;
+    traceId?: string | undefined;
+    sessionId?: string | undefined;
+    category?: "verification" | "trace" | "system" | "evaluation" | undefined;
+}, injectedOptions?: AuditTrailOptions | undefined) => Promise<{
+    action: string;
+    count: number;
+    summary: {
+        byCategory: Record<string, number>;
+    };
+    records: {
+        id: string;
+        timestamp: string;
+        category: "verification" | "trace" | "system" | "evaluation";
+        sessionId: string;
+        traceId: string | undefined;
+        evaluationName: string | undefined;
+        evaluationScore: number | undefined;
+        evaluator: string | undefined;
+        verificationType: string | undefined;
+        model: string | undefined;
+        contentHash: string;
+    }[];
+} | {
+    generatedAt: string;
+    reportingPeriod: {
+        startDate: string;
+        endDate: string;
+    };
+    retention: import("../lib/audit/retention-guard.js").RetentionStatus;
+    auditRecordCount: number;
+    chainIntegrity: import("../lib/audit/audit-record.js").ChainIntegrityResult;
+    coverage: import("../lib/audit/compliance-report.js").CoverageSummary;
+    checks: import("../lib/audit/compliance-report.js").ComplianceCheckItem[];
+    overallStatus: import("../lib/audit/compliance-report.js").ComplianceStatus;
+    action: string;
+    count?: undefined;
+    summary?: undefined;
+    records?: undefined;
+} | {
+    error?: string | undefined;
+    brokenAt?: number | undefined;
+    action: string;
+    recordCount: number;
+    chainValid: boolean;
+    count?: undefined;
+    summary?: undefined;
+    records?: undefined;
+}>;
+export declare const auditTrailTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        startDate: z.ZodOptional<z.ZodISODate>;
+        endDate: z.ZodOptional<z.ZodISODate>;
+        evaluationName: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        action: z.ZodEnum<{
+            query: "query";
+            report: "report";
+            verify: "verify";
+        }>;
+        category: z.ZodOptional<z.ZodEnum<{
+            verification: "verification";
+            trace: "trace";
+            system: "system";
+            evaluation: "evaluation";
+        }>>;
+    }, z.core.$strip>;
+    handler: (rawInput: {
+        action: "query" | "report" | "verify";
+        limit?: number | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+        evaluationName?: string | undefined;
+        traceId?: string | undefined;
+        sessionId?: string | undefined;
+        category?: "verification" | "trace" | "system" | "evaluation" | undefined;
+    }, injectedOptions?: AuditTrailOptions | undefined) => Promise<{
+        action: string;
+        count: number;
+        summary: {
+            byCategory: Record<string, number>;
+        };
+        records: {
+            id: string;
+            timestamp: string;
+            category: "verification" | "trace" | "system" | "evaluation";
+            sessionId: string;
+            traceId: string | undefined;
+            evaluationName: string | undefined;
+            evaluationScore: number | undefined;
+            evaluator: string | undefined;
+            verificationType: string | undefined;
+            model: string | undefined;
+            contentHash: string;
+        }[];
+    } | {
+        generatedAt: string;
+        reportingPeriod: {
+            startDate: string;
+            endDate: string;
+        };
+        retention: import("../lib/audit/retention-guard.js").RetentionStatus;
+        auditRecordCount: number;
+        chainIntegrity: import("../lib/audit/audit-record.js").ChainIntegrityResult;
+        coverage: import("../lib/audit/compliance-report.js").CoverageSummary;
+        checks: import("../lib/audit/compliance-report.js").ComplianceCheckItem[];
+        overallStatus: import("../lib/audit/compliance-report.js").ComplianceStatus;
+        action: string;
+        count?: undefined;
+        summary?: undefined;
+        records?: undefined;
+    } | {
+        error?: string | undefined;
+        brokenAt?: number | undefined;
+        action: string;
+        recordCount: number;
+        chainValid: boolean;
+        count?: undefined;
+        summary?: undefined;
+        records?: undefined;
+    }>;
+};
+//# sourceMappingURL=audit-trail.d.ts.map

package/dist/tools/audit-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.d.ts","sourceRoot":"","sources":["../../src/tools/audit-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AActC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;iBAW3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAClE;AAaD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyErB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK1B,CAAC"}

package/dist/tools/audit-trail.js

@@ -0,0 +1,109 @@
+/**
+ * Audit trail tool for EU AI Act compliance
+ *
+ * Provides three actions:
+ * - query: Search audit records with filters
+ * - report: Generate compliance report (Articles 12, 13, 19)
+ * - verify: Verify hash chain integrity
+ *
+ * @see EU AI Act Articles 12, 13, 19
+ */
+import { z } from 'zod';
+import { queryAuditRecords, verifyChainIntegrity, } from '../lib/audit/audit-record.js';
+import { generateComplianceReport } from '../lib/audit/compliance-report.js';
+import { dateRangeSchema, paginationSchema, sessionSchema, traceIdSchema, } from '../lib/core/shared-schemas.js';
+import { MAX_NAME_LENGTH, MAX_RETURNED_AUDIT_RECORDS } from '../lib/core/constants.js';
+import { validateCommonInputs, wrapValidationErrors, } from '../lib/core/input-validator.js';
+export const auditTrailSchema = z.object({
+    action: z.enum(['query', 'report', 'verify']).describe('Action: query audit records, generate compliance report, or verify chain integrity'),
+    category: z.enum(['trace', 'evaluation', 'verification', 'system']).optional()
+        .describe('Filter by record category (query/verify only)'),
+    ...sessionSchema,
+    ...traceIdSchema,
+    evaluationName: z.string().max(MAX_NAME_LENGTH).optional().describe('Filter by evaluation name (query only)'),
+    ...dateRangeSchema,
+    ...paginationSchema,
+});
+/**
+ * Build summary from audit records grouped by category.
+ */
+function buildCategorySummary(records) {
+    const summary = {};
+    for (const record of records) {
+        summary[record.category] = (summary[record.category] || 0) + 1;
+    }
+    return summary;
+}
+/**
+ * Audit trail handler — dispatches to query, report, or verify.
+ */
+export const auditTrail = wrapValidationErrors(async (rawInput, injectedOptions) => {
+    const input = auditTrailSchema.parse(rawInput);
+    const { limit: validatedLimit } = validateCommonInputs(input);
+    const queryFn = injectedOptions?.queryFn ?? queryAuditRecords;
+    switch (input.action) {
+        case 'query': {
+            const options = {
+                category: input.category,
+                sessionId: input.sessionId,
+                traceId: input.traceId,
+                evaluationName: input.evaluationName,
+                startDate: input.startDate,
+                endDate: input.endDate,
+                limit: validatedLimit,
+            };
+            const records = await queryFn(options);
+            const summary = buildCategorySummary(records);
+            return {
+                action: 'query',
+                count: records.length,
+                summary: { byCategory: summary },
+                records: records.slice(0, MAX_RETURNED_AUDIT_RECORDS).map(r => ({
+                    id: r.id,
+                    timestamp: r.timestamp,
+                    category: r.category,
+                    sessionId: r.sessionId,
+                    traceId: r.traceId,
+                    evaluationName: r.evaluationName,
+                    evaluationScore: r.evaluationScore,
+                    evaluator: r.evaluator,
+                    verificationType: r.verificationType,
+                    model: r.model,
+                    contentHash: r.contentHash,
+                })),
+            };
+        }
+        case 'report': {
+            const report = await generateComplianceReport({
+                startDate: input.startDate,
+                endDate: input.endDate,
+            });
+            return { action: 'report', ...report };
+        }
+        case 'verify': {
+            const options = {
+                category: input.category,
+                sessionId: input.sessionId,
+                startDate: input.startDate,
+                endDate: input.endDate,
+                limit: 10000,
+            };
+            const records = await queryFn(options);
+            const result = verifyChainIntegrity(records);
+            return {
+                action: 'verify',
+                recordCount: result.recordCount,
+                chainValid: result.valid,
+                ...(result.brokenAt !== undefined && { brokenAt: result.brokenAt }),
+                ...(result.error && { error: result.error }),
+            };
+        }
+    }
+});
+export const auditTrailTool = {
+    name: 'obs_audit_trail',
+    description: 'Query audit records, generate EU AI Act compliance reports, or verify hash chain integrity. Actions: query (search records), report (Articles 12/13/19 compliance), verify (chain integrity).',
+    inputSchema: auditTrailSchema,
+    handler: auditTrail,
+};
+//# sourceMappingURL=audit-trail.js.map

package/dist/tools/audit-trail.js.map

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

package/dist/tools/audit-trail.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for audit-trail tool
+ */
+export {};
+//# sourceMappingURL=audit-trail.test.d.ts.map

package/dist/tools/audit-trail.test.d.ts.map

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

package/dist/tools/audit-trail.test.js

@@ -0,0 +1,122 @@
+/**
+ * Tests for audit-trail tool
+ */
+import { describe, it } from 'vitest';
+import assert from 'node:assert';
+import { auditTrail, auditTrailSchema, auditTrailTool, } from './audit-trail.js';
+import { DEFAULT_LIMIT } from '../lib/core/input-validator.js';
+import { testTraceId } from '../test-helpers/test-data-builders.js';
+// ---------- test constants ----------
+const HASH_LENGTH = 64;
+const EXPECTED_RECORD_COUNT = 2;
+/** Create a mock audit record for testing */
+function mockAuditRecord(overrides = {}) {
+    return {
+        id: 'test-id-1',
+        timestamp: '2026-03-01T12:00:00Z',
+        category: 'trace',
+        sessionId: 'sess-1',
+        contentHash: 'a'.repeat(HASH_LENGTH),
+        previousHash: '0'.repeat(HASH_LENGTH),
+        ...overrides,
+    };
+}
+/** Create a mock query function */
+function mockQueryFn(records) {
+    return async (_options) => records;
+}
+void describe('auditTrail', () => {
+    void describe('schema validation', () => {
+        void it('should require action field', () => {
+            assert.throws(() => {
+                auditTrailSchema.parse({});
+            });
+        });
+        void it('should accept query action with defaults', () => {
+            const result = auditTrailSchema.parse({ action: 'query' });
+            assert.strictEqual(result.action, 'query');
+            assert.strictEqual(result.limit, DEFAULT_LIMIT);
+        });
+        void it('should accept report action', () => {
+            const result = auditTrailSchema.parse({ action: 'report' });
+            assert.strictEqual(result.action, 'report');
+        });
+        void it('should accept verify action', () => {
+            const result = auditTrailSchema.parse({ action: 'verify' });
+            assert.strictEqual(result.action, 'verify');
+        });
+        void it('should reject invalid action', () => {
+            assert.throws(() => {
+                auditTrailSchema.parse({ action: 'invalid' });
+            });
+        });
+        void it('should accept all optional filters', () => {
+            const result = auditTrailSchema.parse({
+                action: 'query',
+                category: 'evaluation',
+                sessionId: 'sess-1',
+                traceId: testTraceId(1),
+                evaluationName: 'relevance',
+                startDate: '2026-01-01',
+                endDate: '2026-03-01',
+                limit: 100,
+            });
+            assert.strictEqual(result.category, 'evaluation');
+            assert.strictEqual(result.sessionId, 'sess-1');
+            assert.strictEqual(result.traceId, testTraceId(1));
+            assert.strictEqual(result.evaluationName, 'relevance');
+        });
+        void it('should enforce max limit of 1000', () => {
+            assert.throws(() => {
+                auditTrailSchema.parse({ action: 'query', limit: 1001 });
+            });
+        });
+    });
+    void describe('query action', () => {
+        void it('should return records with summary', async () => {
+            const records = [
+                mockAuditRecord({ category: 'trace' }),
+                mockAuditRecord({ id: 'test-2', category: 'evaluation', evaluationName: 'relevance' }),
+            ];
+            const options = { queryFn: mockQueryFn(records) };
+            const result = await auditTrail({ action: 'query' }, options);
+            assert.strictEqual(result.action, 'query');
+            assert.strictEqual(result.count, EXPECTED_RECORD_COUNT);
+            assert.strictEqual(result.summary.byCategory.trace, 1);
+            assert.strictEqual(result.summary.byCategory.evaluation, 1);
+            assert.strictEqual(result.records.length, EXPECTED_RECORD_COUNT);
+        });
+        void it('should return empty results for no records', async () => {
+            const options = { queryFn: mockQueryFn([]) };
+            const result = await auditTrail({ action: 'query' }, options);
+            assert.strictEqual(result.count, 0);
+            assert.strictEqual(result.records.length, 0);
+        });
+    });
+    void describe('verify action', () => {
+        void it('should return valid for properly chained records', async () => {
+            // Build a valid chain manually
+            // Verify tool response shape with empty records
+            const options = { queryFn: mockQueryFn([]) };
+            const result = await auditTrail({ action: 'verify' }, options);
+            assert.strictEqual(result.action, 'verify');
+            assert.strictEqual(result.recordCount, 0);
+            assert.strictEqual(result.chainValid, true);
+        });
+    });
+    void describe('tool definition', () => {
+        void it('should have correct name', () => {
+            assert.strictEqual(auditTrailTool.name, 'obs_audit_trail');
+        });
+        void it('should have description', () => {
+            assert.ok(auditTrailTool.description.length > 0);
+        });
+        void it('should have handler function', () => {
+            assert.strictEqual(typeof auditTrailTool.handler, 'function');
+        });
+        void it('should have inputSchema', () => {
+            assert.ok(auditTrailTool.inputSchema);
+        });
+    });
+});
+//# sourceMappingURL=audit-trail.test.js.map

package/dist/tools/audit-trail.test.js.map

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

package/dist/tools/context-stats.d.ts

@@ -6,17 +6,9 @@ export declare const contextStatsSchema: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodString>;
     includeBreakdown: z.ZodDefault<z.ZodBoolean>;
     includeCost: z.ZodDefault<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    includeBreakdown: boolean;
-    includeCost: boolean;
-    sessionId?: string | undefined;
-}, {
-    sessionId?: string | undefined;
-    includeBreakdown?: boolean | undefined;
-    includeCost?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 export type ContextStatsInput = z.input<typeof contextStatsSchema>;
-export declare function contextStats(rawInput: ContextStatsInput): Promise<{
+type ContextResult = {
     sessionId: string;
     project: string;
     model?: string;
@@ -54,7 +46,8 @@ export declare function contextStats(rawInput: ContextStatsInput): Promise<{
             sessionCount: number;
         }>;
     };
-} | {
+};
+export declare function contextStats(rawInput: ContextStatsInput): Promise<ContextResult | {
     error: string;
     sessionId?: undefined;
 } | {
@@ -68,15 +61,8 @@ export declare const contextStatsTool: {
         sessionId: z.ZodOptional<z.ZodString>;
         includeBreakdown: z.ZodDefault<z.ZodBoolean>;
         includeCost: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        includeBreakdown: boolean;
-        includeCost: boolean;
-        sessionId?: string | undefined;
-    }, {
-        sessionId?: string | undefined;
-        includeBreakdown?: boolean | undefined;
-        includeCost?: boolean | undefined;
-    }>;
+    }, z.core.$strip>;
     handler: typeof contextStats;
 };
+export {};
 //# sourceMappingURL=context-stats.d.ts.map

package/dist/tools/context-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-stats.d.ts","sourceRoot":"","sources":["../../src/tools/context-stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAsJnE,wBAAsB,YAAY,CAAC,QAAQ,EAAE,iBAAiB;eAqC/C,MAAM;aACR,MAAM;YACP,MAAM;aACL;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;YACO;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB;cACS,MAAM;WACT;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;gBAC7D;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf;cACS;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9E;;;;;;;GAiEJ;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAK5B,CAAC"}
+{"version":3,"file":"context-stats.d.ts","sourceRoot":"","sources":["../../src/tools/context-stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BjB,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAyKnE,KAAK,aAAa,GAAG;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IACnG,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,SAAS,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,OAAO,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC3I,CAAC;AA4DF,wBAAsB,YAAY,CAAC,QAAQ,EAAE,iBAAiB;;;;;;GAsB7D;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;CAK5B,CAAC"}