@absolutejs/ai 0.6.3 → 0.6.4

package/dist/src/ai/errors/providerError.d.ts

@@ -8,6 +8,8 @@ export type ProviderErrorInit = {
     /** Provider-specific error type, e.g. Anthropic's "overloaded_error". */
     type?: string | null;
     retryable: boolean;
+    /** No request was sent (for example, a locally blocked provider). */
+    notSent?: boolean;
     cause?: unknown;
     /** Provider-native structured details, when the response exposes them. */
     metadata?: Record<string, unknown>;
@@ -19,6 +21,8 @@ export declare class ProviderError extends Error {
     readonly type: string | null;
     /** Whether retrying the same request later could plausibly succeed. */
     readonly retryable: boolean;
+    readonly billingUnavailable: boolean;
+    readonly notSent: boolean;
     readonly metadata: Record<string, unknown> | undefined;
     /** Provider status page, when known — for surfacing "is it them?" to users. */
     readonly statusPageUrl: string | null;

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

@@ -50,3 +50,4 @@ export { inspectAIContext, streamWithAIContext, isAIContextRejection, } from "./
 export type { AIContextBudget, AIContextCapacity, AIContextPolicy, AIContextEvent, AIContextRecoveryReason, } from "./contextPolicy";
 export { createAIStoredToolResultRecovery } from "./storedToolResultRecovery";
 export { createAIProviderRouter } from "./providerRouter";
+export { streamWithProviderFallback } from "./providerFallback";

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

@@ -0,0 +1,14 @@
+import type { AIChunk } from "../../types/ai";
+import { ProviderError } from "./errors/providerError";
+/** Execute approved, individually metered alternatives. Never replay a stream
+ * after any chunk (including tools or usage), or after caller cancellation. */
+export declare function streamWithProviderFallback(options: {
+    models: readonly string[];
+    stream: (model: string) => AsyncIterable<AIChunk>;
+    signal?: AbortSignal;
+    onFallback?: (event: {
+        from: string;
+        to: string;
+        error: ProviderError;
+    }) => void | Promise<void>;
+}): AsyncIterable<AIChunk>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"
@@ -114,7 +114,7 @@
     "react": "^19.2.0",
     "svelte": "^5.35.2",
     "vue": "^3.5.27",
-    "@absolutejs/sync": ">=2.14.0 <4"
+    "@absolutejs/sync": ">=2.14.0 <3"
   },
   "peerDependenciesMeta": {
     "@absolutejs/isolated-jsc": {
@@ -137,7 +137,7 @@
     "@absolutejs/absolute": "^0.20.0-beta.0",
     "@absolutejs/changelog": "^0.6.0",
     "@absolutejs/isolated-jsc": "0.6.0",
-    "@absolutejs/sync": "3.0.0",
+    "@absolutejs/sync": "2.14.0",
     "@angular/core": "^21.0.0",
     "@eslint/js": "^10.0.1",
     "@types/bun": "1.3.9",