@absolutejs/ai 0.6.4 → 0.6.6

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.6.6 — 2026-10-22
+
+### Changed
+
+- **Recover approved providers in either direction across preparation and streaming; preserve checkpoints, normalize finite-key OpenAI schemas, and clear cancelled billing probes** (`AIInputError`, `PrepareAITextInputOptions`, `AIContextPolicy`, `streamWithProviderFallback`)
+
+## 0.6.5 — 2026-10-22
+
+### Changed
+
+- **Preserve Sync 3 peer compatibility alongside provider recovery**
+
 ## 0.6.4 — 2026-10-22
 
 ### Added
@@ -16,6 +28,13 @@ This file is generated by `absolute-changelog` from the entries in
 
 - **Expose provider billing rejection and credential-scoped suppression** (`ProviderError`, `ProviderErrorInit`)
 
+## 0.6.3 — 2026-10-22
+
+### Changed
+
+- **Accepts @absolutejs/sync 3**
+  The `@absolutejs/sync` peer range stopped below 3, so an app on sync 3 (built against Elysia 2.0.0-rc.0) installed a second copy for ai. sync 3.0.0 changed no API, so the range now runs from 2.14.0 below 4.
+
 ## 0.6.2 — 2026-10-22
 
 ### Added

package/README.md

@@ -593,3 +593,21 @@ polls or subscribes to actual progress, and binds actions to authenticated route
 
 
 `streamWithProviderFallback` accepts approved model IDs, an individually metered `stream(model)` callback, and an optional `onFallback` hook. It never restarts after a chunk or caller cancellation. `ProviderError.billingUnavailable` identifies provider billing failures; `notSent` identifies requests blocked locally. Billing suppression is scoped to the configured provider instance, with a five-minute probe interval.
+
+
+### Recovery across approved providers
+
+Set `contextPolicy.providerFallback` on generation helpers and
+`providerFallback` on `prepareAITextInput` / `prepareAITextInputStep` to cover
+both token-capacity checks and generation. `models` accepts an array or a
+function of the current model; the requested model runs first. Use a provider
+router containing every approved model. Each alternate validates its own input
+capacity. Optional `onFallback({ from, to, error })` reports the switch.
+
+Recovery stops after any output chunk, including tool/usage chunks, and never
+replays cancellation or accounting/application errors. Completed document
+sections retain validated checkpoints across provider switches. Finite-key
+OpenAI record schemas are translated to optional named properties without
+removing value constraints. `isProviderError` works across package entrypoints;
+`isPermanentAIProviderFailure` classifies terminal provider/preflight failures
+for job runners. Callers own retry budgets, funding, and model approval.

package/changelog.json

@@ -2,6 +2,32 @@
 	"contract": 1,
 	"name": "@absolutejs/ai",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "changed",
+					"summary": "Recover approved providers in either direction across preparation and streaming; preserve checkpoints, normalize finite-key OpenAI schemas, and clear cancelled billing probes",
+					"symbols": [
+						"AIInputError",
+						"PrepareAITextInputOptions",
+						"AIContextPolicy",
+						"streamWithProviderFallback"
+					]
+				}
+			],
+			"date": "2026-10-22",
+			"version": "0.6.6"
+		},
+		{
+			"changes": [
+				{
+					"kind": "changed",
+					"summary": "Preserve Sync 3 peer compatibility alongside provider recovery"
+				}
+			],
+			"date": "2026-10-22",
+			"version": "0.6.5"
+		},
 		{
 			"changes": [
 				{
@@ -23,6 +49,17 @@
 			"date": "2026-10-22",
 			"version": "0.6.4"
 		},
+		{
+			"changes": [
+				{
+					"detail": "The `@absolutejs/sync` peer range stopped below 3, so an app on sync 3 (built against Elysia 2.0.0-rc.0) installed a second copy for ai. sync 3.0.0 changed no API, so the range now runs from 2.14.0 below 4.",
+					"kind": "changed",
+					"summary": "Accepts @absolutejs/sync 3"
+				}
+			],
+			"date": "2026-10-22",
+			"version": "0.6.3"
+		},
 		{
 			"changes": [
 				{