@warlock.js/ai-openai 4.13.0 → 4.14.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@warlock.js/ai-openai` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 4.13.0
+
+### Removed
+
+- **BREAKING** — `isOpenAIImageModel()` and `OPENAI_IMAGE_MODEL_PREFIXES` are no longer exported; the `known-image-models` module is deleted. Nothing in the adapter read them once the construction-time gate went away, so they were a public list of model ids that enforced nothing and went stale on OpenAI's release schedule, not this package's. Import them from nowhere — branch on your own id list if you need one.
+- **BREAKING** — `isOpenAISpeechModel()` and `isOpenAITranscriptionModel()` are no longer exported either, for the same reason. Once their construction-time gates went away nothing in the adapter read them, leaving two more public model-id lists that enforced nothing. No `@warlock.js/ai-*` adapter validates a model id locally, so the package no longer ships a helper that implies otherwise — branch on your own id list if you need one.
+
+### Changed
+
+- `openai.image({ name })`, `openai.speech({ name })` and `openai.transcribe({ name })` no longer reject an unknown model id at construction — the id is forwarded to OpenAI as given, so an id OpenAI does not serve now fails as a typed provider error instead of a local `InvalidRequestError`.
+
 ## 4.12.0
 
 ### Changed

package/cjs/index.cjs

@@ -451,37 +451,6 @@ var OpenAIEmbedder = class {
 	}
 };
 
-//#endregion
-//#region ../ai-openai/src/known-image-models.ts
-/**
-* Model-id prefixes OpenAI exposes through the **Images** API
-* (`client.images.generate`). The two live families:
-*
-* - `gpt-image-*` — token-metered, always returns base64 bytes (no
-*   `response_format` knob), supports `output_format` + `background`.
-* - `dall-e-*` — per-image-metered, returns a URL or base64 via
-*   `response_format`.
-*
-* Used by {@link isOpenAIImageModel} for the construction-time guard so
-* `openai.image({ name: "gpt-4o" })` fails fast with a curated error
-* instead of a downstream 400 — mirroring the embedder/vision guards.
-*/
-const OPENAI_IMAGE_MODEL_PREFIXES = ["gpt-image", "dall-e"];
-/**
-* True when `name` is a recognized OpenAI image-generation model. A
-* prefix match (not an exact list) so dated snapshots
-* (`gpt-image-1-mini`, `dall-e-3`) are covered without a maintenance
-* burden every time OpenAI ships a point release.
-*
-* @example
-* isOpenAIImageModel("gpt-image-1"); // true
-* isOpenAIImageModel("dall-e-3");    // true
-* isOpenAIImageModel("gpt-4o");      // false
-*/
-function isOpenAIImageModel(name) {
-	return OPENAI_IMAGE_MODEL_PREFIXES.some((prefix) => name.startsWith(prefix));
-}
-
 //#endregion
 //#region ../ai-openai/src/image.ts
 const LOG_MODULE$3 = "ai.openai";
@@ -498,17 +467,19 @@ function mediaTypeFor(format) {
 * OpenAI-backed implementation of `ImageModelContract`.
 *
 * **Role.** Bridges the vendor-neutral `ai.image()` verb to OpenAI's
-* **Images** API for the two image families OpenAI ships: the
+* **Images** API. Metering follows the family the id belongs to: the
 * token-metered `gpt-image-*` models (always return base64 bytes) and
 * the per-image-metered `dall-e-*` models (URL or base64). Like
 * `OpenAIEmbedder`, it's a standalone primitive — no relationship to
 * chat completions, tools, or the agent loop.
 *
-* **Capability guard.** The constructor rejects a non-image model id
-* up front (`gpt-4o` → typed `InvalidRequestError`) so the mistake
-* surfaces at wiring time, not as a downstream provider 400 — the
-* "fail fast at construction" rule shared with the embedder/vision
-* guards.
+* **No model-id validation.** `config.name` is forwarded to
+* `client.images.generate` exactly as given — the constructor never
+* inspects it. OpenAI adds and retires image model ids on its own
+* schedule, so an id this adapter does not recognize is not the
+* adapter's call to refuse; an unsupported id surfaces as a provider
+* error from OpenAI (wrapped into the typed `AIError` hierarchy by
+* `generate()`), not as a local one.
 *
 * **Error handling.** Raw OpenAI SDK errors are wrapped into the typed
 * `@warlock.js/ai` `AIError` hierarchy via `wrapOpenAIError`, so a
@@ -523,7 +494,6 @@ function mediaTypeFor(format) {
 var OpenAIImageModel = class {
 	constructor(client, config, provider = "openai") {
 		this.logger = _warlock_js_logger.log;
-		if (!isOpenAIImageModel(config.name)) throw new _warlock_js_ai.InvalidRequestError(`"${config.name}" is not a known OpenAI image-generation model. Use a \`gpt-image-*\` or \`dall-e-*\` model with openai.image({ name }).`);
 		this.client = client;
 		this.name = config.name;
 		this.provider = provider;
@@ -1070,16 +1040,6 @@ var OpenAIModel = class {
 //#endregion
 //#region ../ai-openai/src/speech.ts
 const LOG_MODULE$1 = "ai.openai";
-/** Model-id prefixes OpenAI exposes through the **Speech** (TTS) API. */
-const SPEECH_MODEL_PREFIXES = [
-	"tts-1",
-	"gpt-4o-mini-tts",
-	"gpt-audio"
-];
-/** True when `name` is a recognized OpenAI text-to-speech model. */
-function isOpenAISpeechModel(name) {
-	return SPEECH_MODEL_PREFIXES.some((prefix) => name.startsWith(prefix));
-}
 /** Map a neutral output container hint to its IANA audio media type. */
 function audioMediaType(format) {
 	switch (format) {
@@ -1096,9 +1056,11 @@ function audioMediaType(format) {
 * via `audio.speech.create`. Standalone primitive — no relation to chat
 * completions or the agent loop. Consumed by the `ai.speech()` verb.
 *
-* **Capability guard.** The constructor rejects a non-TTS model id up
-* front (`tts-1` / `gpt-4o-mini-tts` only) so the mistake surfaces at
-* wiring time, mirroring the embedder / image guards.
+* **No model-id validation.** `config.name` is forwarded to
+* `audio.speech.create` exactly as given — the constructor never
+* inspects it. OpenAI ships and retires TTS model ids on its own
+* schedule, so an unrecognized id fails at OpenAI (wrapped into the
+* typed `AIError` hierarchy by `generate()`), not here.
 *
 * @example
 * const tts = new OpenAISpeechModel(client, { name: "tts-1", voice: "alloy" }, "openai");
@@ -1107,7 +1069,6 @@ function audioMediaType(format) {
 var OpenAISpeechModel = class {
 	constructor(client, config, provider = "openai") {
 		this.logger = _warlock_js_logger.log;
-		if (!isOpenAISpeechModel(config.name)) throw new _warlock_js_ai.InvalidRequestError(`"${config.name}" is not a known OpenAI text-to-speech model. Use a \`tts-1\` / \`tts-1-hd\` / \`gpt-4o-mini-tts\` model with openai.speech({ name }).`);
 		this.client = client;
 		this.name = config.name;
 		this.provider = provider;
@@ -1157,21 +1118,16 @@ var OpenAISpeechModel = class {
 //#endregion
 //#region ../ai-openai/src/transcription.ts
 const LOG_MODULE = "ai.openai";
-/** Model-id prefixes OpenAI exposes through the **Transcription** (STT) API. */
-const TRANSCRIPTION_MODEL_PREFIXES = [
-	"whisper",
-	"gpt-4o-transcribe",
-	"gpt-4o-mini-transcribe"
-];
-/** True when `name` is a recognized OpenAI speech-to-text model. */
-function isOpenAITranscriptionModel(name) {
-	return TRANSCRIPTION_MODEL_PREFIXES.some((prefix) => name.startsWith(prefix));
-}
 /**
 * OpenAI-backed implementation of `TranscriptionModelContract`
 * (speech-to-text) via `audio.transcriptions.create`. Consumed by the
 * `ai.transcribe()` verb.
 *
+* **No model-id validation.** `config.name` is forwarded to
+* `audio.transcriptions.create` exactly as given — the constructor
+* never inspects it. An unrecognized id fails at OpenAI (wrapped into
+* the typed `AIError` hierarchy by `transcribe()`), not here.
+*
 * **Response format.** Defaults to `verbose_json` for `whisper-1` (so
 * the run gets a `duration` + timestamped `segments`) and `json` for
 * the token-metered `gpt-4o-transcribe` family. Base64 audio is wrapped
@@ -1184,7 +1140,6 @@ function isOpenAITranscriptionModel(name) {
 var OpenAITranscriptionModel = class {
 	constructor(client, config, provider = "openai") {
 		this.logger = _warlock_js_logger.log;
-		if (!isOpenAITranscriptionModel(config.name)) throw new _warlock_js_ai.InvalidRequestError(`"${config.name}" is not a known OpenAI transcription model. Use a \`whisper-1\` / \`gpt-4o-transcribe\` / \`gpt-4o-mini-transcribe\` model with openai.transcribe({ name }).`);
 		this.client = client;
 		this.name = config.name;
 		this.provider = provider;
@@ -1328,9 +1283,10 @@ var OpenAISDK = class {
 	}
 	/**
 	* Build an `OpenAIImageModel` bound to this SDK's client for use with
-	* `ai.image({ model, prompt })`. Accepts the `gpt-image-*` (token-metered)
-	* and `dall-e-*` (per-image-metered) families; a non-image model id
-	* is rejected at construction.
+	* `ai.image({ model, prompt })`. `config.name` is passed through to
+	* `client.images.generate` as given — no id is rejected locally, so
+	* an unsupported model fails at OpenAI, not here. Metering follows
+	* the family: `gpt-image-*` is token-metered, `dall-e-*` per-image.
 	*
 	* Pricing resolution mirrors `model()`: per-model `config.pricing`
 	* wins, otherwise the SDK-level registry entry keyed by `config.name`,
@@ -1352,9 +1308,10 @@ var OpenAISDK = class {
 	}
 	/**
 	* Build an `OpenAISpeechModel` (text-to-speech) bound to this SDK's
-	* client, for use with `ai.speech({ model, text })`. Accepts the
-	* `tts-1` / `gpt-4o-mini-tts` families; a non-TTS model id is rejected
-	* at construction.
+	* client, for use with `ai.speech({ model, text })`. `config.name` is
+	* passed through to `audio.speech.create` as given — no id is
+	* rejected locally, so an unsupported model fails at OpenAI, not
+	* here.
 	*
 	* @example
 	* const tts = openai.speech({ name: "tts-1", voice: "alloy" });
@@ -1366,8 +1323,9 @@ var OpenAISDK = class {
 	/**
 	* Build an `OpenAITranscriptionModel` (speech-to-text) bound to this
 	* SDK's client, for use with `ai.transcribe({ model, audio })`.
-	* Accepts the `whisper-1` / `gpt-4o-transcribe` families; a non-STT
-	* model id is rejected at construction.
+	* `config.name` is passed through to `audio.transcriptions.create`
+	* as given — no id is rejected locally, so an unsupported model
+	* fails at OpenAI, not here.
 	*
 	* @example
 	* const stt = openai.transcribe({ name: "whisper-1" });
@@ -1379,13 +1337,9 @@ var OpenAISDK = class {
 };
 
 //#endregion
-exports.OPENAI_IMAGE_MODEL_PREFIXES = OPENAI_IMAGE_MODEL_PREFIXES;
 exports.OpenAIEmbedder = OpenAIEmbedder;
 exports.OpenAIImageModel = OpenAIImageModel;
 exports.OpenAISDK = OpenAISDK;
 exports.OpenAISpeechModel = OpenAISpeechModel;
 exports.OpenAITranscriptionModel = OpenAITranscriptionModel;
-exports.isOpenAIImageModel = isOpenAIImageModel;
-exports.isOpenAISpeechModel = isOpenAISpeechModel;
-exports.isOpenAITranscriptionModel = isOpenAITranscriptionModel;
 //# sourceMappingURL=index.cjs.map