@absolutejs/ai 0.0.22 → 0.0.24

package/dist/src/ai/resilience.d.ts

@@ -12,9 +12,30 @@ export type ResilienceConfig = {
 /** Override the global resilience defaults (retry counts, breaker thresholds). */
 export declare const configureProviderResilience: (partial: Partial<ResilienceConfig>) => void;
 type CircuitState = "closed" | "open" | "half-open";
+type ExternalStatus = {
+    available: boolean;
+    /** Statuspage indicator, e.g. "major_outage" | "operational" | "unknown". */
+    indicator: string;
+    reason: string;
+    checkedAt: number;
+};
+/**
+ * Feed externally-observed provider availability (typically from a status-page
+ * monitor) into the breaker. A report of `available: false` makes the provider
+ * fail fast immediately; `available: true` clears the external block (the
+ * reactive breaker still governs real failures).
+ */
+export declare const setProviderAvailability: (provider: string, status: {
+    available: boolean;
+    indicator?: string;
+    reason?: string;
+}) => void;
 export type ProviderHealth = {
     provider: string;
-    /** True when the circuit is closed (provider believed healthy). */
+    /**
+     * True when the provider is usable: circuit closed AND not reported down by
+     * an external status monitor.
+     */
     healthy: boolean;
     state: CircuitState;
     consecutiveFailures: number;
@@ -28,6 +49,8 @@ export type ProviderHealth = {
         message: string;
     } | null;
     statusPageUrl: string | null;
+    /** Latest externally-observed status (e.g. status page), if any. */
+    external: ExternalStatus | null;
 };
 /**
  * Inspect provider health as tracked by the circuit breaker. Pass a provider

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/ai",
-	"version": "0.0.22",
+	"version": "0.0.24",
 	"homepage": "https://github.com/absolutejs/ai",
 	"bugs": {
 		"url": "https://github.com/absolutejs/ai/issues"