@plumbus/ai-decision-openai 0.2.0 → 0.3.0-beta.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.0-beta.0 — core 0.8 beta family
+
+- Carries the stable-line functionality below into the coordinated core 0.8 beta family, published under `plumbus-next`; `latest` stays on the 0.7 family. Install matching beta packages together; the core peer is `>=0.8.0-beta.0 <0.9.0`. See the [0.8 upgrade notes](../../docs/upgrading-core-0.8.md).
+- Depends on `@plumbus/ai-decision` `~0.3.0-beta.1`, including the endpoint-path and rounding support required by the adapter.
+
 ## 0.2.0 — 2026-10-08
 
 - Initial optional OpenAI Decisions API (`POST /v1/decisions`) adapter for typed choices, scores, and probabilities (#72), using `@plumbus/ai-decision` 0.2.3 contracts, validation, and the shared bounded HTTP transport. No OpenAI SDK dependency. OpenAI's Decisions API is in public beta; the adapter follows its documentation as of 2026-10-08 and may need a patch if the API changes at general availability.

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm](https://img.shields.io/npm/v/@plumbus/ai-decision-openai.svg)](https://www.npmjs.com/package/@plumbus/ai-decision-openai)
 [![license](https://img.shields.io/npm/l/@plumbus/ai-decision-openai.svg)](https://github.com/plumbus-framework/plumbus/blob/main/LICENSE)
-[![peer: @plumbus/core 0.7.x](https://img.shields.io/badge/peer-%40plumbus%2Fcore%200.7.x-blue)](https://www.npmjs.com/package/@plumbus/core)
+[![peer: @plumbus/core 0.8 beta](https://img.shields.io/badge/peer-%40plumbus%2Fcore%200.8%20beta-blue)](https://www.npmjs.com/package/@plumbus/core)
 
 ## What is this?
 
@@ -45,32 +45,32 @@ This package gives apps that already use OpenAI a registered decision provider w
 
 ## Status
 
-Optional decision provider, version `0.2.0` (version-locked **`0.2.x`**); required peer `@plumbus/core` exactly **`0.7.x`**; Node.js 20.6+. **Runtime floor:** `ctx.ai.decide()` needs `@plumbus/core` **≥ 0.7.3** and `ctx.ai.classify({ provider })` needs **≥ 0.7.4**; use core **0.7.9** (see [Install](#install)); agent wiring **v19** (core 0.7.9) links these instructions. Depends on `@plumbus/ai-decision` `~0.2.3`. Install alone is not enough until the adapter is registered under `decisions.providers`.
+Optional decision provider, version `0.3.0-beta.0` (core 0.8 beta family, npm dist-tag `plumbus-next`); required peer `@plumbus/core` **`>=0.8.0-beta.0 <0.9.0`**; Node.js 20.6+. **Runtime floor:** `ctx.ai.decide()` needs `@plumbus/core` **≥ 0.7.3** and `ctx.ai.classify({ provider })` needs **≥ 0.7.4**; use the matching core **0.8 beta** (see [Install](#install)); agent wiring **v19** in this family links these instructions. Depends on `@plumbus/ai-decision` `~0.3.0-beta.1`. Install alone is not enough until the adapter is registered under `decisions.providers`.
 
 OpenAI's Decisions API is in public beta. This adapter follows OpenAI's documentation as of
 2026-10-08 and may need a patch release if the API changes when it becomes generally available.
 
 Not included: vendor model catalogs, automatic environment provider discovery, and dedicated decision CLI commands.
 
-Release notes: [changelog](./CHANGELOG.md) and [version/upgrade guide](../../docs/upgrading-classification.md).
+Release notes: [changelog](./CHANGELOG.md) and [0.8 upgrade notes](../../docs/upgrading-core-0.8.md), and [classification upgrade guide](../../docs/upgrading-classification.md).
 
 ## Install
 
 ```bash
-pnpm add @plumbus/ai-decision-openai
+pnpm add @plumbus/ai-decision-openai@plumbus-next
 ```
 
-Install explicitly with `pnpm add @plumbus/ai-decision-openai`. Provider packages install
-`@plumbus/ai-decision` (`0.2.3+`) transitively. There is no dependency on the OpenAI SDK
+Install explicitly with `pnpm add @plumbus/ai-decision-openai@plumbus-next`. Provider packages install
+`@plumbus/ai-decision` (`~0.3.0-beta.1`) transitively. There is no dependency on the OpenAI SDK
 or on the other decision providers.
 
 Through `ctx.ai`, core checks every result again with its own copy of
-`@plumbus/ai-decision`, and only 0.2.3+ allows for this adapter's rounding. Core 0.7.9
-depends on `~0.2.3`. On core 0.7.3–0.7.8, run `pnpm dedupe` after installing and check
-that `pnpm why @plumbus/ai-decision` lists a single 0.2.3+ copy. With an older copy,
-core rejects OpenAI's rounded answers as `invalid_response` after the call is billed.
+`@plumbus/ai-decision`. The matching beta family shares `~0.3.0-beta.1`, including
+this adapter's rounding support. Do not mix beta and stable packages. On the stable
+0.7 line, use core 0.7.9 and shared contracts 0.2.3+; older shared contracts reject
+OpenAI's rounded answers as `invalid_response` after the call is billed.
 
-Peer (copy literally): `@plumbus/core` `0.7.x`. See `node_modules/@plumbus/core/instructions/peer-dependencies.md`.
+Peer (copy literally): `@plumbus/core` `>=0.8.0-beta.0 <0.9.0`. See `node_modules/@plumbus/core/instructions/peer-dependencies.md`.
 
 If agent wiring predates the decision provider instructions, refresh:
 
@@ -187,7 +187,7 @@ Unknown response models return `cost: null`; they are not free. Core records suc
 - **Probabilities are not permissions.** A probability is P(true), not a boolean, and a high confidence value is not authorization or proof of correctness. Validate thresholds on the actual task, model, and language.
 - **Retries can repeat cost.** The transport retries HTTP 429, 500, 502, 503, 504, and 529 (two retries by default, honoring `Retry-After`); repeated requests can still incur cost, with no exactly-once guarantee.
 - **Refusals fail the whole call.** `decide()` and `classify()` throw `invalid_response` with `error.refusedQuestions` (for `classify()`, `label_<index>` by position in `labels`); `refusedQuestions` is set only for refusals. Handle it as a business outcome, such as routing to review, not by retrying in a loop.
-- **Core needs its own `@plumbus/ai-decision` 0.2.3+.** Use core 0.7.9, or dedupe on core 0.7.3–0.7.8 (see [Install](#install)).
+- **Core and the adapter must share rounding-aware contracts.** Install the matching beta family (`@plumbus/ai-decision` `~0.3.0-beta.1`); see [Install](#install) for stable-line compatibility.
 - **Public beta.** OpenAI may change the Decisions API at general availability.
 
 ## Documentation / Agent recipes