@defai.digital/contracts 13.0.3

package/dist/provider/v1/circuit-breaker.js

@@ -0,0 +1,119 @@
+/**
+ * Circuit Breaker Contract V1
+ *
+ * Provides circuit breaker pattern for provider resilience.
+ * Prevents cascading failures when providers become unhealthy.
+ *
+ * Invariants:
+ * - INV-CB-001: Closed state allows all requests
+ * - INV-CB-002: Open state rejects until resetTimeout elapsed
+ * - INV-CB-003: Half-open state allows limited test requests
+ * - INV-CB-004: Failure threshold triggers transition to open
+ * - INV-CB-005: Successful tests in half-open trigger transition to closed
+ */
+import { z } from 'zod';
+/**
+ * Circuit breaker states
+ */
+export const CircuitStateSchema = z.enum(['closed', 'open', 'halfOpen']);
+/**
+ * Circuit breaker configuration
+ */
+export const CircuitBreakerConfigSchema = z.object({
+    /** Failures before opening circuit (INV-CB-004) */
+    failureThreshold: z.number().int().min(1).max(100).default(5),
+    /** Time before attempting half-open state in ms (INV-CB-002) */
+    resetTimeoutMs: z.number().int().min(1000).max(300000).default(30000),
+    /** Number of test requests allowed in half-open state (INV-CB-003) */
+    halfOpenRequests: z.number().int().min(1).max(10).default(3),
+    /** Interval for passive health checks in ms */
+    monitorIntervalMs: z.number().int().min(1000).max(60000).default(10000),
+    /** Success threshold to close circuit from half-open */
+    successThreshold: z.number().int().min(1).max(10).default(3),
+});
+/**
+ * Circuit breaker state snapshot
+ */
+export const CircuitBreakerStateSchema = z.object({
+    /** Current circuit state */
+    state: CircuitStateSchema,
+    /** Consecutive failure count */
+    failureCount: z.number().int().min(0),
+    /** Success count in half-open state */
+    successCount: z.number().int().min(0),
+    /** Timestamp of last failure */
+    lastFailureTime: z.string().datetime().optional(),
+    /** Timestamp of last success */
+    lastSuccessTime: z.string().datetime().optional(),
+    /** Next allowed attempt time (when open) */
+    nextAttemptTime: z.string().datetime().optional(),
+    /** Time of last state transition */
+    lastTransitionTime: z.string().datetime().optional(),
+    /** Total requests since last reset */
+    totalRequests: z.number().int().min(0).default(0),
+    /** Total failures since last reset */
+    totalFailures: z.number().int().min(0).default(0),
+});
+/**
+ * Circuit breaker event types
+ */
+export const CircuitBreakerEventTypeSchema = z.enum([
+    'circuit.opened',
+    'circuit.closed',
+    'circuit.halfOpen',
+    'circuit.requestAllowed',
+    'circuit.requestRejected',
+    'circuit.successRecorded',
+    'circuit.failureRecorded',
+]);
+/**
+ * Circuit breaker event
+ */
+export const CircuitBreakerEventSchema = z.object({
+    eventId: z.string().uuid(),
+    type: CircuitBreakerEventTypeSchema,
+    providerId: z.string(),
+    timestamp: z.string().datetime(),
+    previousState: CircuitStateSchema.optional(),
+    currentState: CircuitStateSchema,
+    details: z.record(z.unknown()).optional(),
+});
+/**
+ * Error codes for circuit breaker operations
+ */
+export const CircuitBreakerErrorCodes = {
+    CIRCUIT_OPEN: 'CIRCUIT_BREAKER_OPEN',
+    HALF_OPEN_LIMIT: 'CIRCUIT_BREAKER_HALF_OPEN_LIMIT',
+    INVALID_CONFIG: 'CIRCUIT_BREAKER_INVALID_CONFIG',
+};
+/**
+ * Validates circuit breaker configuration
+ */
+export function validateCircuitBreakerConfig(data) {
+    return CircuitBreakerConfigSchema.parse(data);
+}
+/**
+ * Validates circuit breaker state
+ */
+export function validateCircuitBreakerState(data) {
+    return CircuitBreakerStateSchema.parse(data);
+}
+/**
+ * Creates default circuit breaker configuration
+ */
+export function createDefaultCircuitBreakerConfig() {
+    return CircuitBreakerConfigSchema.parse({});
+}
+/**
+ * Creates initial circuit breaker state (closed)
+ */
+export function createInitialCircuitBreakerState() {
+    return {
+        state: 'closed',
+        failureCount: 0,
+        successCount: 0,
+        totalRequests: 0,
+        totalFailures: 0,
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/provider/v1/circuit-breaker.js.map

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

package/dist/provider/v1/health.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Provider Health Contract V1
+ *
+ * Provides health monitoring for provider resilience.
+ * Tracks latency, error rates, and availability for intelligent routing.
+ *
+ * Invariants:
+ * - INV-HM-001: Latency samples bounded by configured size
+ * - INV-HM-002: Error rate calculated over sliding window
+ * - INV-HM-003: Availability derived from circuit and error state
+ */
+import { z } from 'zod';
+/**
+ * Health check configuration
+ */
+export declare const HealthCheckConfigSchema: z.ZodObject<{
+    /** Interval between active health checks in ms */
+    intervalMs: z.ZodDefault<z.ZodNumber>;
+    /** Timeout for health check request in ms */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    /** Number of latency samples to retain (INV-HM-001) */
+    latencySampleSize: z.ZodDefault<z.ZodNumber>;
+    /** Error rate threshold for unhealthy status */
+    unhealthyErrorRate: z.ZodDefault<z.ZodNumber>;
+    /** Consecutive failures for degraded status */
+    degradedThreshold: z.ZodDefault<z.ZodNumber>;
+    /** Enable active health checks */
+    enableActiveChecks: z.ZodDefault<z.ZodBoolean>;
+    /** Enable passive health tracking */
+    enablePassiveTracking: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    timeoutMs: number;
+    intervalMs: number;
+    latencySampleSize: number;
+    unhealthyErrorRate: number;
+    degradedThreshold: number;
+    enableActiveChecks: boolean;
+    enablePassiveTracking: boolean;
+}, {
+    timeoutMs?: number | undefined;
+    intervalMs?: number | undefined;
+    latencySampleSize?: number | undefined;
+    unhealthyErrorRate?: number | undefined;
+    degradedThreshold?: number | undefined;
+    enableActiveChecks?: boolean | undefined;
+    enablePassiveTracking?: boolean | undefined;
+}>;
+export type HealthCheckConfig = z.infer<typeof HealthCheckConfigSchema>;
+/**
+ * Health status levels
+ */
+export declare const HealthLevelSchema: z.ZodEnum<["healthy", "degraded", "unhealthy", "unknown"]>;
+export type HealthLevel = z.infer<typeof HealthLevelSchema>;
+/**
+ * Provider health status
+ */
+export declare const HealthStatusSchema: z.ZodObject<{
+    /** Provider identifier */
+    providerId: z.ZodString;
+    /** Whether provider is available for requests */
+    available: z.ZodBoolean;
+    /** Overall health level */
+    level: z.ZodEnum<["healthy", "degraded", "unhealthy", "unknown"]>;
+    /** Average latency in ms */
+    latencyMs: z.ZodNumber;
+    /** P50 latency in ms */
+    latencyP50Ms: z.ZodOptional<z.ZodNumber>;
+    /** P95 latency in ms */
+    latencyP95Ms: z.ZodOptional<z.ZodNumber>;
+    /** P99 latency in ms */
+    latencyP99Ms: z.ZodOptional<z.ZodNumber>;
+    /** Error rate (0-1) */
+    errorRate: z.ZodNumber;
+    /** Consecutive failures */
+    consecutiveFailures: z.ZodNumber;
+    /** Consecutive successes */
+    consecutiveSuccesses: z.ZodNumber;
+    /** Timestamp of last health check */
+    lastCheckTime: z.ZodString;
+    /** Timestamp of last successful request */
+    lastSuccessTime: z.ZodOptional<z.ZodString>;
+    /** Timestamp of last failed request */
+    lastErrorTime: z.ZodOptional<z.ZodString>;
+    /** Last error message */
+    lastError: z.ZodOptional<z.ZodString>;
+    /** Last error code */
+    lastErrorCode: z.ZodOptional<z.ZodString>;
+    /** Circuit breaker state */
+    circuitState: z.ZodEnum<["closed", "open", "halfOpen"]>;
+    /** Rate limit state */
+    rateLimitState: z.ZodEnum<["normal", "throttled", "blocked"]>;
+    /** Total requests in monitoring window */
+    totalRequests: z.ZodNumber;
+    /** Total errors in monitoring window */
+    totalErrors: z.ZodNumber;
+    /** Uptime percentage in monitoring window */
+    uptimePercent: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    providerId: string;
+    available: boolean;
+    level: "unknown" | "healthy" | "degraded" | "unhealthy";
+    totalRequests: number;
+    latencyMs: number;
+    errorRate: number;
+    consecutiveFailures: number;
+    consecutiveSuccesses: number;
+    lastCheckTime: string;
+    circuitState: "open" | "closed" | "halfOpen";
+    rateLimitState: "blocked" | "normal" | "throttled";
+    totalErrors: number;
+    lastSuccessTime?: string | undefined;
+    latencyP50Ms?: number | undefined;
+    latencyP95Ms?: number | undefined;
+    latencyP99Ms?: number | undefined;
+    lastErrorTime?: string | undefined;
+    lastError?: string | undefined;
+    lastErrorCode?: string | undefined;
+    uptimePercent?: number | undefined;
+}, {
+    providerId: string;
+    available: boolean;
+    level: "unknown" | "healthy" | "degraded" | "unhealthy";
+    totalRequests: number;
+    latencyMs: number;
+    errorRate: number;
+    consecutiveFailures: number;
+    consecutiveSuccesses: number;
+    lastCheckTime: string;
+    circuitState: "open" | "closed" | "halfOpen";
+    rateLimitState: "blocked" | "normal" | "throttled";
+    totalErrors: number;
+    lastSuccessTime?: string | undefined;
+    latencyP50Ms?: number | undefined;
+    latencyP95Ms?: number | undefined;
+    latencyP99Ms?: number | undefined;
+    lastErrorTime?: string | undefined;
+    lastError?: string | undefined;
+    lastErrorCode?: string | undefined;
+    uptimePercent?: number | undefined;
+}>;
+export type HealthStatus = z.infer<typeof HealthStatusSchema>;
+/**
+ * Health check result
+ */
+export declare const HealthCheckResultSchema: z.ZodObject<{
+    /** Check identifier */
+    checkId: z.ZodString;
+    /** Provider identifier */
+    providerId: z.ZodString;
+    /** Whether check passed */
+    success: z.ZodBoolean;
+    /** Latency of health check in ms */
+    latencyMs: z.ZodNumber;
+    /** Timestamp of check */
+    timestamp: z.ZodString;
+    /** Error message if failed */
+    error: z.ZodOptional<z.ZodString>;
+    /** Error code if failed */
+    errorCode: z.ZodOptional<z.ZodString>;
+    /** Check type */
+    checkType: z.ZodEnum<["active", "passive"]>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    success: boolean;
+    providerId: string;
+    latencyMs: number;
+    checkId: string;
+    checkType: "active" | "passive";
+    error?: string | undefined;
+    errorCode?: string | undefined;
+}, {
+    timestamp: string;
+    success: boolean;
+    providerId: string;
+    latencyMs: number;
+    checkId: string;
+    checkType: "active" | "passive";
+    error?: string | undefined;
+    errorCode?: string | undefined;
+}>;
+export type HealthCheckResult = z.infer<typeof HealthCheckResultSchema>;
+/**
+ * Health event types
+ */
+export declare const HealthEventTypeSchema: z.ZodEnum<["health.check.started", "health.check.passed", "health.check.failed", "health.status.changed", "health.degraded", "health.recovered", "health.unhealthy"]>;
+export type HealthEventType = z.infer<typeof HealthEventTypeSchema>;
+/**
+ * Health event
+ */
+export declare const HealthEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    type: z.ZodEnum<["health.check.started", "health.check.passed", "health.check.failed", "health.status.changed", "health.degraded", "health.recovered", "health.unhealthy"]>;
+    providerId: z.ZodString;
+    timestamp: z.ZodString;
+    previousLevel: z.ZodOptional<z.ZodEnum<["healthy", "degraded", "unhealthy", "unknown"]>>;
+    currentLevel: z.ZodEnum<["healthy", "degraded", "unhealthy", "unknown"]>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "health.check.started" | "health.check.passed" | "health.check.failed" | "health.status.changed" | "health.degraded" | "health.recovered" | "health.unhealthy";
+    timestamp: string;
+    eventId: string;
+    providerId: string;
+    currentLevel: "unknown" | "healthy" | "degraded" | "unhealthy";
+    details?: Record<string, unknown> | undefined;
+    previousLevel?: "unknown" | "healthy" | "degraded" | "unhealthy" | undefined;
+}, {
+    type: "health.check.started" | "health.check.passed" | "health.check.failed" | "health.status.changed" | "health.degraded" | "health.recovered" | "health.unhealthy";
+    timestamp: string;
+    eventId: string;
+    providerId: string;
+    currentLevel: "unknown" | "healthy" | "degraded" | "unhealthy";
+    details?: Record<string, unknown> | undefined;
+    previousLevel?: "unknown" | "healthy" | "degraded" | "unhealthy" | undefined;
+}>;
+export type HealthEvent = z.infer<typeof HealthEventSchema>;
+/**
+ * Error codes for health operations
+ */
+export declare const HealthErrorCodes: {
+    readonly CHECK_TIMEOUT: "HEALTH_CHECK_TIMEOUT";
+    readonly CHECK_FAILED: "HEALTH_CHECK_FAILED";
+    readonly PROVIDER_UNAVAILABLE: "HEALTH_PROVIDER_UNAVAILABLE";
+    readonly INVALID_CONFIG: "HEALTH_INVALID_CONFIG";
+};
+export type HealthErrorCode = (typeof HealthErrorCodes)[keyof typeof HealthErrorCodes];
+/**
+ * Validates health check configuration
+ */
+export declare function validateHealthCheckConfig(data: unknown): HealthCheckConfig;
+/**
+ * Validates health status
+ */
+export declare function validateHealthStatus(data: unknown): HealthStatus;
+/**
+ * Creates default health check configuration
+ */
+export declare function createDefaultHealthCheckConfig(): HealthCheckConfig;
+/**
+ * Creates initial health status (unknown)
+ */
+export declare function createInitialHealthStatus(providerId: string): HealthStatus;
+/**
+ * Calculate percentile from sorted array
+ */
+export declare function calculatePercentile(sortedValues: number[], percentile: number): number;
+//# sourceMappingURL=health.d.ts.map

package/dist/provider/v1/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/provider/v1/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,kDAAkD;;IAGlD,6CAA6C;;IAG7C,uDAAuD;;IAGvD,gDAAgD;;IAGhD,+CAA+C;;IAG/C,kCAAkC;;IAGlC,qCAAqC;;;;;;;;;;;;;;;;;;EAErC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB,4DAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,0BAA0B;;IAG1B,iDAAiD;;IAGjD,2BAA2B;;IAG3B,4BAA4B;;IAG5B,wBAAwB;;IAGxB,wBAAwB;;IAGxB,wBAAwB;;IAGxB,uBAAuB;;IAGvB,2BAA2B;;IAG3B,4BAA4B;;IAG5B,qCAAqC;;IAGrC,2CAA2C;;IAG3C,uCAAuC;;IAGvC,yBAAyB;;IAGzB,sBAAsB;;IAGtB,4BAA4B;;IAG5B,uBAAuB;;IAGvB,0CAA0C;;IAG1C,wCAAwC;;IAGxC,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7C,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,uBAAuB;;IAGvB,0BAA0B;;IAG1B,2BAA2B;;IAG3B,oCAAoC;;IAGpC,yBAAyB;;IAGzB,8BAA8B;;IAG9B,2BAA2B;;IAG3B,iBAAiB;;;;;;;;;;;;;;;;;;;;EAEjB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,qBAAqB,uKAQhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAE1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAElE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAgB1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtF"}

package/dist/provider/v1/health.js

@@ -0,0 +1,190 @@
+/**
+ * Provider Health Contract V1
+ *
+ * Provides health monitoring for provider resilience.
+ * Tracks latency, error rates, and availability for intelligent routing.
+ *
+ * Invariants:
+ * - INV-HM-001: Latency samples bounded by configured size
+ * - INV-HM-002: Error rate calculated over sliding window
+ * - INV-HM-003: Availability derived from circuit and error state
+ */
+import { z } from 'zod';
+import { CircuitStateSchema } from './circuit-breaker.js';
+import { RateLimitStateEnumSchema } from './rate-limit.js';
+/**
+ * Health check configuration
+ */
+export const HealthCheckConfigSchema = z.object({
+    /** Interval between active health checks in ms */
+    intervalMs: z.number().int().min(5000).max(300000).default(30000),
+    /** Timeout for health check request in ms */
+    timeoutMs: z.number().int().min(1000).max(30000).default(5000),
+    /** Number of latency samples to retain (INV-HM-001) */
+    latencySampleSize: z.number().int().min(1).max(100).default(10),
+    /** Error rate threshold for unhealthy status */
+    unhealthyErrorRate: z.number().min(0).max(1).default(0.5),
+    /** Consecutive failures for degraded status */
+    degradedThreshold: z.number().int().min(1).max(20).default(3),
+    /** Enable active health checks */
+    enableActiveChecks: z.boolean().default(true),
+    /** Enable passive health tracking */
+    enablePassiveTracking: z.boolean().default(true),
+});
+/**
+ * Health status levels
+ */
+export const HealthLevelSchema = z.enum([
+    'healthy', // Fully operational
+    'degraded', // Experiencing issues but operational
+    'unhealthy', // Not operational
+    'unknown', // No data available
+]);
+/**
+ * Provider health status
+ */
+export const HealthStatusSchema = z.object({
+    /** Provider identifier */
+    providerId: z.string(),
+    /** Whether provider is available for requests */
+    available: z.boolean(),
+    /** Overall health level */
+    level: HealthLevelSchema,
+    /** Average latency in ms */
+    latencyMs: z.number().min(0),
+    /** P50 latency in ms */
+    latencyP50Ms: z.number().min(0).optional(),
+    /** P95 latency in ms */
+    latencyP95Ms: z.number().min(0).optional(),
+    /** P99 latency in ms */
+    latencyP99Ms: z.number().min(0).optional(),
+    /** Error rate (0-1) */
+    errorRate: z.number().min(0).max(1),
+    /** Consecutive failures */
+    consecutiveFailures: z.number().int().min(0),
+    /** Consecutive successes */
+    consecutiveSuccesses: z.number().int().min(0),
+    /** Timestamp of last health check */
+    lastCheckTime: z.string().datetime(),
+    /** Timestamp of last successful request */
+    lastSuccessTime: z.string().datetime().optional(),
+    /** Timestamp of last failed request */
+    lastErrorTime: z.string().datetime().optional(),
+    /** Last error message */
+    lastError: z.string().optional(),
+    /** Last error code */
+    lastErrorCode: z.string().optional(),
+    /** Circuit breaker state */
+    circuitState: CircuitStateSchema,
+    /** Rate limit state */
+    rateLimitState: RateLimitStateEnumSchema,
+    /** Total requests in monitoring window */
+    totalRequests: z.number().int().min(0),
+    /** Total errors in monitoring window */
+    totalErrors: z.number().int().min(0),
+    /** Uptime percentage in monitoring window */
+    uptimePercent: z.number().min(0).max(100).optional(),
+});
+/**
+ * Health check result
+ */
+export const HealthCheckResultSchema = z.object({
+    /** Check identifier */
+    checkId: z.string().uuid(),
+    /** Provider identifier */
+    providerId: z.string(),
+    /** Whether check passed */
+    success: z.boolean(),
+    /** Latency of health check in ms */
+    latencyMs: z.number().min(0),
+    /** Timestamp of check */
+    timestamp: z.string().datetime(),
+    /** Error message if failed */
+    error: z.string().optional(),
+    /** Error code if failed */
+    errorCode: z.string().optional(),
+    /** Check type */
+    checkType: z.enum(['active', 'passive']),
+});
+/**
+ * Health event types
+ */
+export const HealthEventTypeSchema = z.enum([
+    'health.check.started',
+    'health.check.passed',
+    'health.check.failed',
+    'health.status.changed',
+    'health.degraded',
+    'health.recovered',
+    'health.unhealthy',
+]);
+/**
+ * Health event
+ */
+export const HealthEventSchema = z.object({
+    eventId: z.string().uuid(),
+    type: HealthEventTypeSchema,
+    providerId: z.string(),
+    timestamp: z.string().datetime(),
+    previousLevel: HealthLevelSchema.optional(),
+    currentLevel: HealthLevelSchema,
+    details: z.record(z.unknown()).optional(),
+});
+/**
+ * Error codes for health operations
+ */
+export const HealthErrorCodes = {
+    CHECK_TIMEOUT: 'HEALTH_CHECK_TIMEOUT',
+    CHECK_FAILED: 'HEALTH_CHECK_FAILED',
+    PROVIDER_UNAVAILABLE: 'HEALTH_PROVIDER_UNAVAILABLE',
+    INVALID_CONFIG: 'HEALTH_INVALID_CONFIG',
+};
+/**
+ * Validates health check configuration
+ */
+export function validateHealthCheckConfig(data) {
+    return HealthCheckConfigSchema.parse(data);
+}
+/**
+ * Validates health status
+ */
+export function validateHealthStatus(data) {
+    return HealthStatusSchema.parse(data);
+}
+/**
+ * Creates default health check configuration
+ */
+export function createDefaultHealthCheckConfig() {
+    return HealthCheckConfigSchema.parse({});
+}
+/**
+ * Creates initial health status (unknown)
+ */
+export function createInitialHealthStatus(providerId) {
+    const now = new Date().toISOString();
+    return {
+        providerId,
+        available: false,
+        level: 'unknown',
+        latencyMs: 0,
+        errorRate: 0,
+        consecutiveFailures: 0,
+        consecutiveSuccesses: 0,
+        lastCheckTime: now,
+        circuitState: 'closed',
+        rateLimitState: 'normal',
+        totalRequests: 0,
+        totalErrors: 0,
+    };
+}
+/**
+ * Calculate percentile from sorted array
+ */
+export function calculatePercentile(sortedValues, percentile) {
+    if (sortedValues.length === 0)
+        return 0;
+    const index = Math.ceil((percentile / 100) * sortedValues.length) - 1;
+    const safeIndex = Math.max(0, Math.min(index, sortedValues.length - 1));
+    return sortedValues[safeIndex] ?? 0;
+}
+//# sourceMappingURL=health.js.map

package/dist/provider/v1/health.js.map

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

package/dist/provider/v1/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider Contract V1
+ *
+ * Contracts for provider resilience patterns including
+ * circuit breaker, rate limiting, and health monitoring.
+ *
+ * Also includes provider port interfaces for Ports & Adapters pattern.
+ */
+export { ProviderMessageSchema, ProviderRequestSchema, ProviderResponseSchema, ModelInfoSchema, validateProviderRequest, validateProviderResponse, safeValidateProviderRequest, createProviderSuccessResponse, createProviderErrorResponse, type ProviderMessage, type ProviderRequest, type ProviderResponse, type ModelInfo, type ProviderPort, type ProviderRegistryPort, } from './port.js';
+export { CircuitStateSchema, CircuitBreakerConfigSchema, CircuitBreakerStateSchema, CircuitBreakerEventTypeSchema, CircuitBreakerEventSchema, CircuitBreakerErrorCodes, validateCircuitBreakerConfig, validateCircuitBreakerState, createDefaultCircuitBreakerConfig, createInitialCircuitBreakerState, type CircuitState, type CircuitBreakerConfig, type CircuitBreakerState, type CircuitBreakerEventType, type CircuitBreakerEvent, type CircuitBreakerErrorCode, } from './circuit-breaker.js';
+export { RateLimitStrategySchema, RateLimitStateEnumSchema, RateLimitConfigSchema, RateLimitStateSchema, RateLimitResultSchema, RateLimitEventTypeSchema, RateLimitEventSchema, RateLimitErrorCodes, validateRateLimitConfig, validateRateLimitState, createDefaultRateLimitConfig, createInitialRateLimitState, type RateLimitStrategy, type RateLimitStateEnum, type RateLimitConfig, type RateLimitState, type RateLimitResult, type RateLimitEventType, type RateLimitEvent, type RateLimitErrorCode, } from './rate-limit.js';
+export { HealthCheckConfigSchema, HealthLevelSchema, HealthStatusSchema, HealthCheckResultSchema, HealthEventTypeSchema, HealthEventSchema, HealthErrorCodes, validateHealthCheckConfig, validateHealthStatus, createDefaultHealthCheckConfig, createInitialHealthStatus, calculatePercentile, type HealthCheckConfig, type HealthLevel, type HealthStatus, type HealthCheckResult, type HealthEventType, type HealthEvent, type HealthErrorCode, } from './health.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/provider/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,gCAAgC,EAChC,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/provider/v1/index.js

@@ -0,0 +1,17 @@
+/**
+ * Provider Contract V1
+ *
+ * Contracts for provider resilience patterns including
+ * circuit breaker, rate limiting, and health monitoring.
+ *
+ * Also includes provider port interfaces for Ports & Adapters pattern.
+ */
+// Provider Port Interfaces
+export { ProviderMessageSchema, ProviderRequestSchema, ProviderResponseSchema, ModelInfoSchema, validateProviderRequest, validateProviderResponse, safeValidateProviderRequest, createProviderSuccessResponse, createProviderErrorResponse, } from './port.js';
+// Circuit Breaker
+export { CircuitStateSchema, CircuitBreakerConfigSchema, CircuitBreakerStateSchema, CircuitBreakerEventTypeSchema, CircuitBreakerEventSchema, CircuitBreakerErrorCodes, validateCircuitBreakerConfig, validateCircuitBreakerState, createDefaultCircuitBreakerConfig, createInitialCircuitBreakerState, } from './circuit-breaker.js';
+// Rate Limiting
+export { RateLimitStrategySchema, RateLimitStateEnumSchema, RateLimitConfigSchema, RateLimitStateSchema, RateLimitResultSchema, RateLimitEventTypeSchema, RateLimitEventSchema, RateLimitErrorCodes, validateRateLimitConfig, validateRateLimitState, createDefaultRateLimitConfig, createInitialRateLimitState, } from './rate-limit.js';
+// Health Monitoring
+export { HealthCheckConfigSchema, HealthLevelSchema, HealthStatusSchema, HealthCheckResultSchema, HealthEventTypeSchema, HealthEventSchema, HealthErrorCodes, validateHealthCheckConfig, validateHealthStatus, createDefaultHealthCheckConfig, createInitialHealthStatus, calculatePercentile, } from './health.js';
+//# sourceMappingURL=index.js.map

package/dist/provider/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/provider/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,2BAA2B,GAO5B,MAAM,WAAW,CAAC;AAEnB,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,gCAAgC,GAOjC,MAAM,sBAAsB,CAAC;AAE9B,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,GAS5B,MAAM,iBAAiB,CAAC;AAEzB,oBAAoB;AACpB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,GAQpB,MAAM,aAAa,CAAC"}