observability-toolkit 1.8.4 → 2.0.0

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

@@ -0,0 +1,100 @@
+/**
+ * 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
+ */
+/**
+ * Types of human verification actions
+ */
+export type VerificationType = 'approval' | 'rejection' | 'override' | 'review';
+/** Valid verification types for runtime validation */
+export declare const VALID_VERIFICATION_TYPES: readonly VerificationType[];
+/**
+ * Human verification event schema
+ */
+export interface HumanVerificationEvent {
+    /** ISO 8601 timestamp of the verification */
+    timestamp: string;
+    /** Claude Code session ID */
+    sessionId: string;
+    /** Associated trace ID for correlation */
+    traceId?: string;
+    /** Type of verification action */
+    verificationType: VerificationType;
+    /** Anonymous or pseudonymized identifier for the verifier */
+    verifierId?: string;
+    /** Original AI output (optional, for override) */
+    originalOutput?: string;
+    /** Human-verified output (optional, for override) */
+    verifiedOutput?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for querying verification events
+ */
+export interface VerificationQueryOptions {
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by trace ID */
+    traceId?: string;
+    /** Filter by verification type */
+    verificationType?: VerificationType;
+    /** Start date (YYYY-MM-DD) */
+    startDate?: string;
+    /** End date (YYYY-MM-DD) */
+    endDate?: string;
+    /** Maximum results to return */
+    limit?: number;
+}
+/**
+ * Get the verifications directory path
+ */
+export declare function getVerificationsDir(telemetryDir?: string): string;
+/**
+ * Get the verification file path for a given date
+ */
+export declare function getVerificationFilePath(date?: Date, telemetryDir?: string): string;
+/**
+ * Validate a verification type
+ */
+export declare function isValidVerificationType(type: unknown): type is VerificationType;
+/**
+ * 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 declare function recordVerification(event: Omit<HumanVerificationEvent, 'timestamp'>, telemetryDir?: string): void;
+/**
+ * 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 declare function queryVerifications(options: VerificationQueryOptions, telemetryDir?: string): Promise<HumanVerificationEvent[]>;
+//# sourceMappingURL=verification-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verification-events.d.ts","sourceRoot":"","sources":["../../src/lib/verification-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhF,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAK/D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,GAAE,MAAsB,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,IAAiB,EAAE,YAAY,GAAE,MAAsB,GAAG,MAAM,CAG7G;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAE/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,EAChD,YAAY,GAAE,MAAsB,GACnC,IAAI,CA6BN;AAgDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,wBAAwB,EACjC,YAAY,GAAE,MAAsB,GACnC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA0BnC"}

package/dist/lib/verification-events.js

@@ -0,0 +1,162 @@
+/**
+ * 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 { join, dirname } from 'path';
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { createLogger } from './logger.js';
+import { TELEMETRY_DIR } from './constants.js';
+import { getDateString, streamJsonl, listFiles, parseDateFromFilename } from './file-utils.js';
+const logger = createLogger('verification');
+/** Valid verification types for runtime validation */
+export const VALID_VERIFICATION_TYPES = [
+    'approval',
+    'rejection',
+    'override',
+    'review',
+];
+/**
+ * Get the verifications directory path
+ */
+export function getVerificationsDir(telemetryDir = TELEMETRY_DIR) {
+    return join(telemetryDir, 'verifications');
+}
+/**
+ * Get the verification file path for a given date
+ */
+export function getVerificationFilePath(date = new Date(), telemetryDir = 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 = 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);
+    const files = listFiles(dir, /^\d{4}-\d{2}-\d{2}\.jsonl$/);
+    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 = TELEMETRY_DIR) {
+    const files = getVerificationFiles(telemetryDir, options.startDate, options.endDate);
+    const results = [];
+    const limit = options.limit || 50;
+    for (const file of files) {
+        for await (const event of streamJsonl(file)) {
+            // Validate event has required fields
+            if (!event.timestamp || !event.sessionId || !event.verificationType) {
+                continue;
+            }
+            // 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/verification-events.js.map

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

package/dist/lib/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/verification-events.test.d.ts.map

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

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

@@ -0,0 +1,193 @@
+/**
+ * Tests for human verification event tracking
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { existsSync, rmSync, mkdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { recordVerification, queryVerifications, isValidVerificationType, VALID_VERIFICATION_TYPES, getVerificationFilePath, getVerificationsDir, } from './verification-events.js';
+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(36).slice(2)}`);
+        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(123), 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: 'trace-456',
+                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, 'trace-456');
+            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, 4);
+            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, 2);
+            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, 2);
+            assert.ok(results.every(r => r.verificationType === 'approval'));
+        });
+        it('should query by trace ID', async () => {
+            recordVerification({ sessionId: 'sess-1', verificationType: 'approval', traceId: 'trace-X' }, testDir);
+            recordVerification({ sessionId: 'sess-2', verificationType: 'rejection', traceId: 'trace-Y' }, testDir);
+            recordVerification({ sessionId: 'sess-3', verificationType: 'review', traceId: 'trace-X' }, testDir);
+            const results = await queryVerifications({ traceId: 'trace-X' }, testDir);
+            assert.strictEqual(results.length, 2);
+            assert.ok(results.every(r => r.traceId === 'trace-X'));
+        });
+        it('should respect limit parameter', async () => {
+            // Record 10 events
+            for (let i = 0; i < 10; i++) {
+                recordVerification({ sessionId: `sess-${i}`, verificationType: 'approval' }, testDir);
+            }
+            const results = await queryVerifications({ limit: 5 }, testDir);
+            assert.strictEqual(results.length, 5);
+        });
+        it('should combine multiple filters', async () => {
+            recordVerification({ sessionId: 'sess-A', verificationType: 'approval', traceId: 'trace-1' }, testDir);
+            recordVerification({ sessionId: 'sess-A', verificationType: 'rejection', traceId: 'trace-1' }, testDir);
+            recordVerification({ sessionId: 'sess-B', verificationType: 'approval', traceId: 'trace-1' }, testDir);
+            recordVerification({ sessionId: 'sess-A', verificationType: 'approval', traceId: 'trace-2' }, testDir);
+            const results = await queryVerifications({
+                sessionId: 'sess-A',
+                verificationType: 'approval',
+            }, testDir);
+            assert.strictEqual(results.length, 2);
+            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', () => {
+            assert.strictEqual(VALID_VERIFICATION_TYPES.length, 4);
+            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/verification-events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-events.test.js","sourceRoot":"","sources":["../../src/lib/verification-events.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAElC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,GAAG,EAAE;QACd,+CAA+C;QAC/C,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClG,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,0BAA0B;QAC1B,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,KAAK,MAAM,IAAI,IAAI,wBAAwB,EAAE,CAAC;gBAC5C,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,kBAAkB,CAAC,CAAC;YACrF,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,GAAG,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;YACnD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,gDAAgD,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,KAAK,GAAG;gBACZ,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,WAAW;gBACpB,gBAAgB,EAAE,UAA8B;gBAChD,UAAU,EAAE,UAAU;gBACtB,cAAc,EAAE,WAAW;gBAC3B,cAAc,EAAE,kBAAkB;gBAClC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B,CAAC;YAEF,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAEnC,0BAA0B;YAC1B,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,sCAAsC,CAAC,CAAC;YAEhF,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA2B,CAAC;YAE/D,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACnD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAClD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACpD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACzD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAChE,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9D,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,kBAAkB,CAAC;gBACjB,SAAS,EAAE,cAAc;gBACzB,gBAAgB,EAAE,QAAQ;aAC3B,EAAE,OAAO,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA2B,CAAC;YAE/D,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACvD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;YACxD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC9B,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAChD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,kBAAkB,CAAC;gBACvB,SAAS,EAAE,UAAU;gBACrB,gBAAgB,EAAE,SAA6B;aAChD,EAAE,OAAO,CAAC,EACX,mDAAmD,CACpD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,kBAAkB,CAAC;gBACvB,SAAS,EAAE,EAAE;gBACb,gBAAgB,EAAE,UAAU;aAC7B,EAAE,OAAO,CAAC,EACX,uBAAuB,CACxB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,KAAK,GAAuB,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAElF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,kBAAkB,CAAC;oBACjB,SAAS,EAAE,QAAQ,IAAI,EAAE;oBACzB,gBAAgB,EAAE,IAAI;iBACvB,EAAE,OAAO,CAAC,CAAC;YACd,CAAC;YAED,2BAA2B;YAC3B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAEpC,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC3E,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,uCAAuC;YACvC,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YACnF,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YACpF,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YAEjF,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YAE3E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YACnF,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YACpF,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YAEnF,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YAEpF,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACvG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACxG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YAErG,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YAE1E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,mBAAmB;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YACxF,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAEhE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACvG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACxG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACvG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YAEvG,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;gBACvC,SAAS,EAAE,QAAQ;gBACnB,gBAAgB,EAAE,UAAU;aAC7B,EAAE,OAAO,CAAC,CAAC;YAEZ,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,6BAA6B;YAC7B,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACtD,gDAAgD;YAChD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YAC1D,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YACzD,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,+CAA+C;YAC/C,iDAAiD;YACjD,MAAM,KAAK,GAAG,CAAC,GAAG,wBAAwB,CAAC,CAAC;YAC5C,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -8,4 +8,9 @@
  * Install: claude mcp add observability-toolkit -- npx -y @alyshia/observability-toolkit
  */
 export { RateLimiter, ServerInitError } from './lib/server-utils.js';
+/**
+ * Remove signal handlers (for testing or error recovery).
+ * @internal
+ */
+export declare function removeSignalHandlers(): void;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA8BH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA0CH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuNrE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}