@futdevpro/fsm-dynamo 1.16.27 → 1.16.29

package/src/_modules/ai/_modules/open-ai/_collections/oai-models.const.ts

@@ -1,404 +1,404 @@
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
-import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
-import { DyFM_AI_ModelSettingsSchema } from '../../../_models/ai-model-settings-schema.interface';
-import { DyFM_OAI_Model } from '../_enums/oai-model.enum';
-
-/**
- * OpenAI model registry — verified 2026-06-01 against developers.openai.com docs.
- *
- * Contains current GA + still-callable legacy models. Retired models are omitted;
- * sunsetting ones carry `status: 'deprecated'` + `successorId` + `sunsetDate`.
- *
- * Tool-calling note: native function calling is universal across current OpenAI
- * chat models. The `-pro` reasoning models support tools but NOT streaming and
- * are Responses-API-only — reflected in `capabilities.streaming`.
- *
- * Settings note (FR-048): `settingsSchema` is now populated — it records which tuning
- * params each model ACCEPTS/REJECTS, so the reconciler can drop model-rejected params
- * before the call instead of hard-failing with HTTP 400. See
- * `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
- */
-
-/**
- * Models that MEASURABLY reject the sampling params (HTTP 400) and expose `reasoningEffort` instead.
- *
- * **Live capture 2026-07-21** — confirmed rejecting: `gpt-5.5`, `o3-mini`, `o4-mini`. Two distinct
- * semantics were observed and both mean "do not send it":
- *  - `unsupported_parameter` — the param is not supported at all (o3-mini).
- *  - `unsupported_value` — the param exists but only the default is allowed (gpt-5.5, o4-mini:
- *    "does not support 0.5 with this model. Only the default (1)").
- *
- * ⚠️ This list is NOT the whole `gpt-5.x` family — see {@link OAI_SAMPLING_ACCEPTED}. The earlier
- * family-wide assumption (FR-047 `isReasoningModel` = `/^gpt-5/`) was falsified by the capture.
- */
-const OAI_SAMPLING_REJECTED: DyFM_AI_ModelSettingsSchema = {
-  supported: [ 'maxTokens' ],
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty' ],
-  extraParams: [ 'reasoningEffort' ],
-  constraints: {
-    reasoningEffort: {
-      allowed: [ 'none', 'low', 'medium', 'high', 'xhigh' ],
-      note: 'Reasoning-only knob. Source: FR-048 §Problem (2026-06-01); allowed-set not re-verified by capture.',
-    },
-  },
-};
-
-/**
- * Same shape as {@link OAI_SAMPLING_REJECTED}, but **NOT verified by live capture** — kept on the
- * conservative (reject) assumption.
- *
- * Applies to `gpt-5.5-pro` and `o3-pro` only: the pro-tier models were deliberately NOT probed (cost).
- * (`gpt-5.4` was here too, until the 2026-07-21 probe showed it ACCEPTS — see OAI_SAMPLING_ACCEPTED.
- * The emerging pattern is a GENERATION boundary, not "reasoning vs not": the whole 5.4 line accepts,
- * 5.5 rejects. That makes the pro-tier behaviour genuinely unpredictable from the family name alone.)
- *
- * **Risk direction, stated honestly:** if such a model actually ACCEPTS the params, the reconciler
- * drops them silently → the caller's temperature is quietly ignored. That is the milder failure vs.
- * a hard 400, which is why the conservative side was chosen — but it IS an assumption, not a fact.
- * Resolve by probing these three models (one cheap error-call each).
- */
-const OAI_SAMPLING_UNVERIFIED: DyFM_AI_ModelSettingsSchema = {
-  supported: [ 'maxTokens' ],
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty' ],
-  extraParams: [ 'reasoningEffort' ],
-  constraints: {
-    reasoningEffort: {
-      note: 'UNVERIFIED (no live capture) — assumption inherited from the FR-047 family-wide rule.',
-    },
-  },
-};
-
-/**
- * Non-reasoning chat models (`gpt-4o` family) accept the classic sampling params.
- *
- * Numeric bounds captured from the official OpenAI API reference
- * (https://developers.openai.com/api/reference — fetched 2026-07-21). The docs state the ranges but
- * do NOT document default values, so no `default` is encoded here (an invented default would be a guess).
- */
-const OAI_CLASSIC_CHAT_SETTINGS: DyFM_AI_ModelSettingsSchema = {
-  supported: [ 'temperature', 'maxTokens', 'topP', 'frequencyPenalty', 'presencePenalty' ],
-  constraints: {
-    temperature: {
-      min: 0,
-      max: 2,
-      note: 'OpenAI: "between 0 and 2". Source: developers.openai.com API reference, verified 2026-07-21.',
-    },
-    topP: {
-      min: 0,
-      max: 1,
-      note: 'OpenAI nucleus sampling: "between 0 and 1". Source: developers.openai.com API reference, verified 2026-07-21.',
-    },
-    frequencyPenalty: {
-      min: -2,
-      max: 2,
-      note: 'OpenAI: "Number between -2.0 and 2.0". Source: developers.openai.com API reference, verified 2026-07-21.',
-    },
-    presencePenalty: {
-      min: -2,
-      max: 2,
-      note: 'OpenAI: "Number between -2.0 and 2.0". Source: developers.openai.com API reference, verified 2026-07-21.',
-    },
-  },
-};
-
-/**
- * `gpt-5.4-mini` / `gpt-5.4-nano` — **MEASURABLY ACCEPT** all four sampling params.
- *
- * **Live capture 2026-07-21:** `temperature` / `topP` / `frequencyPenalty` / `presencePenalty` each
- * returned HTTP 200 with `reasoning_tokens: 0`. They therefore behave like classic chat models, NOT
- * like the rejecting reasoning models — despite matching the `/^gpt-5/` pattern that FR-047 used.
- *
- * `gpt-5.4` (base) was probed separately on 2026-07-21 and ALSO accepts (HTTP 200). The pattern is
- * therefore a **generation boundary**, not "reasoning vs not": the whole 5.4 line accepts, 5.5 rejects.
- * That is precisely why per-model data beats a family-wide regex.
- * Bounds are the documented OpenAI ranges (see {@link OAI_CLASSIC_CHAT_SETTINGS}).
- */
-const OAI_SAMPLING_ACCEPTED: DyFM_AI_ModelSettingsSchema = {
-  ...OAI_CLASSIC_CHAT_SETTINGS,
-  extraParams: [ 'reasoningEffort' ],
-};
-
-/**
- * Embedding models: the one real knob is `dimensions`.
- *
- * **Live capture 2026-07-21 — CORRECTION:** the sampling params are **NOT rejected**; sending
- * `temperature` to `/v1/embeddings` returns **HTTP 200 and is silently ignored**. They are still listed
- * under `unsupported` so the reconciler DROPS them (dropping a meaningless param is always safe and
- * keeps requests clean) — but note that this does NOT mean the API would 400. The validator's
- * `unsupported_parameter` error for these is therefore stricter than the live API.
- * Max/default dims: 1536 / 3072 — confirmed by capture
- * ("Invalid value for 'dimensions' = 5000. Must be less than or equal to 1536.").
- */
-const OAI_EMBEDDING_SETTINGS_SMALL: DyFM_AI_ModelSettingsSchema = {
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
-  extraParams: [ 'dimensions' ],
-  constraints: {
-    dimensions: { max: 1536, default: 1536, note: 'text-embedding-3-small native dims (Matryoshka truncation allowed below max).' },
-  },
-};
-
-/** As {@link OAI_EMBEDDING_SETTINGS_SMALL}, with the 3-large native dimension count. */
-const OAI_EMBEDDING_SETTINGS_LARGE: DyFM_AI_ModelSettingsSchema = {
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
-  extraParams: [ 'dimensions' ],
-  constraints: {
-    dimensions: { max: 3072, default: 3072, note: 'text-embedding-3-large native dims (Matryoshka truncation allowed below max).' },
-  },
-};
-
-/**
- * Image-generation models take no chat sampling params (dropped by the reconciler).
- * The image-specific knobs (size / quality / background) are NOT encoded yet — pending doc capture (D4).
- */
-const OAI_IMAGE_SETTINGS: DyFM_AI_ModelSettingsSchema = {
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
-};
-export const DyFM_OAI_Models: DyFM_AI_ModelInfo[] = [
-  // ── Chat / reasoning (current GA) ──
-  {
-    id: DyFM_OAI_Model.gpt55,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-5.5',
-    tier: 'flagship',
-    settingsSchema: OAI_SAMPLING_REJECTED,
-    status: 'ga',
-    contextWindow: 1_050_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.gpt55_pro,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-5.5 Pro',
-    tier: 'pro',
-    settingsSchema: OAI_SAMPLING_UNVERIFIED,
-    status: 'ga',
-    contextWindow: 1_050_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: false, // Responses-API-only, no streaming
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.gpt54,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-5.4',
-    tier: 'flagship',
-    settingsSchema: OAI_SAMPLING_ACCEPTED,
-    status: 'ga',
-    contextWindow: 1_000_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.gpt54_mini,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-5.4 mini',
-    tier: 'mini',
-    settingsSchema: OAI_SAMPLING_ACCEPTED,
-    status: 'ga',
-    contextWindow: 400_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.gpt54_nano,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-5.4 nano',
-    tier: 'nano',
-    settingsSchema: OAI_SAMPLING_ACCEPTED,
-    status: 'ga',
-    contextWindow: 400_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.o3_pro,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'o3-pro',
-    tier: 'pro',
-    settingsSchema: OAI_SAMPLING_UNVERIFIED,
-    status: 'ga',
-    contextWindow: 200_000,
-    maxOutputTokens: 100_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: false, // Responses-API-only, no streaming
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-
-  // ── Chat (legacy-active, sunsetting) ──
-  {
-    id: DyFM_OAI_Model.gpt4o,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-4o',
-    tier: 'legacy',
-    settingsSchema: OAI_CLASSIC_CHAT_SETTINGS,
-    status: 'deprecated',
-    successorId: DyFM_OAI_Model.gpt54_mini,
-    sunsetDate: '2026-10-23',
-    contextWindow: 128_000,
-    maxOutputTokens: 16_384,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.gpt4o_mini,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'GPT-4o mini',
-    tier: 'legacy',
-    settingsSchema: OAI_CLASSIC_CHAT_SETTINGS,
-    status: 'deprecated',
-    successorId: DyFM_OAI_Model.gpt54_mini,
-    sunsetDate: '2026-10-23',
-    contextWindow: 128_000,
-    maxOutputTokens: 16_384,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-
-  // ── Embeddings (current GA) ──
-  {
-    id: DyFM_OAI_Model.textEmbedding_3Small,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Embedding,
-    displayName: 'text-embedding-3-small',
-    status: 'ga',
-    settingsSchema: OAI_EMBEDDING_SETTINGS_SMALL,
-    contextWindow: 8_191,
-    capabilities: {
-      functionCalling: false,
-      vision: false,
-      streaming: false,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: true,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_OAI_Model.textEmbedding_3Large,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Embedding,
-    displayName: 'text-embedding-3-large',
-    status: 'ga',
-    settingsSchema: OAI_EMBEDDING_SETTINGS_LARGE,
-    contextWindow: 8_191,
-    capabilities: {
-      functionCalling: false,
-      vision: false,
-      streaming: false,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: true,
-      adultContent: false,
-    },
-  },
-
-  // ── Image generation (current GA) ──
-  {
-    id: DyFM_OAI_Model.gptImage_2,
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Image,
-    displayName: 'GPT Image 2',
-    status: 'ga',
-    settingsSchema: OAI_IMAGE_SETTINGS,
-    capabilities: {
-      functionCalling: false,
-      vision: true, // accepts image input for editing
-      streaming: false,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: true,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-];
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
+import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
+import { DyFM_AI_ModelSettingsSchema } from '../../../_models/ai-model-settings-schema.interface';
+import { DyFM_OAI_Model } from '../_enums/oai-model.enum';
+
+/**
+ * OpenAI model registry — verified 2026-06-01 against developers.openai.com docs.
+ *
+ * Contains current GA + still-callable legacy models. Retired models are omitted;
+ * sunsetting ones carry `status: 'deprecated'` + `successorId` + `sunsetDate`.
+ *
+ * Tool-calling note: native function calling is universal across current OpenAI
+ * chat models. The `-pro` reasoning models support tools but NOT streaming and
+ * are Responses-API-only — reflected in `capabilities.streaming`.
+ *
+ * Settings note (FR-048): `settingsSchema` is now populated — it records which tuning
+ * params each model ACCEPTS/REJECTS, so the reconciler can drop model-rejected params
+ * before the call instead of hard-failing with HTTP 400. See
+ * `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ */
+
+/**
+ * Models that MEASURABLY reject the sampling params (HTTP 400) and expose `reasoningEffort` instead.
+ *
+ * **Live capture 2026-07-21** — confirmed rejecting: `gpt-5.5`, `o3-mini`, `o4-mini`. Two distinct
+ * semantics were observed and both mean "do not send it":
+ *  - `unsupported_parameter` — the param is not supported at all (o3-mini).
+ *  - `unsupported_value` — the param exists but only the default is allowed (gpt-5.5, o4-mini:
+ *    "does not support 0.5 with this model. Only the default (1)").
+ *
+ * ⚠️ This list is NOT the whole `gpt-5.x` family — see {@link OAI_SAMPLING_ACCEPTED}. The earlier
+ * family-wide assumption (FR-047 `isReasoningModel` = `/^gpt-5/`) was falsified by the capture.
+ */
+const OAI_SAMPLING_REJECTED: DyFM_AI_ModelSettingsSchema = {
+  supported: [ 'maxTokens' ],
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty' ],
+  extraParams: [ 'reasoningEffort' ],
+  constraints: {
+    reasoningEffort: {
+      allowed: [ 'none', 'low', 'medium', 'high', 'xhigh' ],
+      note: 'Reasoning-only knob. Source: FR-048 §Problem (2026-06-01); allowed-set not re-verified by capture.',
+    },
+  },
+};
+
+/**
+ * Same shape as {@link OAI_SAMPLING_REJECTED}, but **NOT verified by live capture** — kept on the
+ * conservative (reject) assumption.
+ *
+ * Applies to `gpt-5.5-pro` and `o3-pro` only: the pro-tier models were deliberately NOT probed (cost).
+ * (`gpt-5.4` was here too, until the 2026-07-21 probe showed it ACCEPTS — see OAI_SAMPLING_ACCEPTED.
+ * The emerging pattern is a GENERATION boundary, not "reasoning vs not": the whole 5.4 line accepts,
+ * 5.5 rejects. That makes the pro-tier behaviour genuinely unpredictable from the family name alone.)
+ *
+ * **Risk direction, stated honestly:** if such a model actually ACCEPTS the params, the reconciler
+ * drops them silently → the caller's temperature is quietly ignored. That is the milder failure vs.
+ * a hard 400, which is why the conservative side was chosen — but it IS an assumption, not a fact.
+ * Resolve by probing these three models (one cheap error-call each).
+ */
+const OAI_SAMPLING_UNVERIFIED: DyFM_AI_ModelSettingsSchema = {
+  supported: [ 'maxTokens' ],
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty' ],
+  extraParams: [ 'reasoningEffort' ],
+  constraints: {
+    reasoningEffort: {
+      note: 'UNVERIFIED (no live capture) — assumption inherited from the FR-047 family-wide rule.',
+    },
+  },
+};
+
+/**
+ * Non-reasoning chat models (`gpt-4o` family) accept the classic sampling params.
+ *
+ * Numeric bounds captured from the official OpenAI API reference
+ * (https://developers.openai.com/api/reference — fetched 2026-07-21). The docs state the ranges but
+ * do NOT document default values, so no `default` is encoded here (an invented default would be a guess).
+ */
+const OAI_CLASSIC_CHAT_SETTINGS: DyFM_AI_ModelSettingsSchema = {
+  supported: [ 'temperature', 'maxTokens', 'topP', 'frequencyPenalty', 'presencePenalty' ],
+  constraints: {
+    temperature: {
+      min: 0,
+      max: 2,
+      note: 'OpenAI: "between 0 and 2". Source: developers.openai.com API reference, verified 2026-07-21.',
+    },
+    topP: {
+      min: 0,
+      max: 1,
+      note: 'OpenAI nucleus sampling: "between 0 and 1". Source: developers.openai.com API reference, verified 2026-07-21.',
+    },
+    frequencyPenalty: {
+      min: -2,
+      max: 2,
+      note: 'OpenAI: "Number between -2.0 and 2.0". Source: developers.openai.com API reference, verified 2026-07-21.',
+    },
+    presencePenalty: {
+      min: -2,
+      max: 2,
+      note: 'OpenAI: "Number between -2.0 and 2.0". Source: developers.openai.com API reference, verified 2026-07-21.',
+    },
+  },
+};
+
+/**
+ * `gpt-5.4-mini` / `gpt-5.4-nano` — **MEASURABLY ACCEPT** all four sampling params.
+ *
+ * **Live capture 2026-07-21:** `temperature` / `topP` / `frequencyPenalty` / `presencePenalty` each
+ * returned HTTP 200 with `reasoning_tokens: 0`. They therefore behave like classic chat models, NOT
+ * like the rejecting reasoning models — despite matching the `/^gpt-5/` pattern that FR-047 used.
+ *
+ * `gpt-5.4` (base) was probed separately on 2026-07-21 and ALSO accepts (HTTP 200). The pattern is
+ * therefore a **generation boundary**, not "reasoning vs not": the whole 5.4 line accepts, 5.5 rejects.
+ * That is precisely why per-model data beats a family-wide regex.
+ * Bounds are the documented OpenAI ranges (see {@link OAI_CLASSIC_CHAT_SETTINGS}).
+ */
+const OAI_SAMPLING_ACCEPTED: DyFM_AI_ModelSettingsSchema = {
+  ...OAI_CLASSIC_CHAT_SETTINGS,
+  extraParams: [ 'reasoningEffort' ],
+};
+
+/**
+ * Embedding models: the one real knob is `dimensions`.
+ *
+ * **Live capture 2026-07-21 — CORRECTION:** the sampling params are **NOT rejected**; sending
+ * `temperature` to `/v1/embeddings` returns **HTTP 200 and is silently ignored**. They are still listed
+ * under `unsupported` so the reconciler DROPS them (dropping a meaningless param is always safe and
+ * keeps requests clean) — but note that this does NOT mean the API would 400. The validator's
+ * `unsupported_parameter` error for these is therefore stricter than the live API.
+ * Max/default dims: 1536 / 3072 — confirmed by capture
+ * ("Invalid value for 'dimensions' = 5000. Must be less than or equal to 1536.").
+ */
+const OAI_EMBEDDING_SETTINGS_SMALL: DyFM_AI_ModelSettingsSchema = {
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
+  extraParams: [ 'dimensions' ],
+  constraints: {
+    dimensions: { max: 1536, default: 1536, note: 'text-embedding-3-small native dims (Matryoshka truncation allowed below max).' },
+  },
+};
+
+/** As {@link OAI_EMBEDDING_SETTINGS_SMALL}, with the 3-large native dimension count. */
+const OAI_EMBEDDING_SETTINGS_LARGE: DyFM_AI_ModelSettingsSchema = {
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
+  extraParams: [ 'dimensions' ],
+  constraints: {
+    dimensions: { max: 3072, default: 3072, note: 'text-embedding-3-large native dims (Matryoshka truncation allowed below max).' },
+  },
+};
+
+/**
+ * Image-generation models take no chat sampling params (dropped by the reconciler).
+ * The image-specific knobs (size / quality / background) are NOT encoded yet — pending doc capture (D4).
+ */
+const OAI_IMAGE_SETTINGS: DyFM_AI_ModelSettingsSchema = {
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
+};
+export const DyFM_OAI_Models: DyFM_AI_ModelInfo[] = [
+  // ── Chat / reasoning (current GA) ──
+  {
+    id: DyFM_OAI_Model.gpt55,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-5.5',
+    tier: 'flagship',
+    settingsSchema: OAI_SAMPLING_REJECTED,
+    status: 'ga',
+    contextWindow: 1_050_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.gpt55_pro,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-5.5 Pro',
+    tier: 'pro',
+    settingsSchema: OAI_SAMPLING_UNVERIFIED,
+    status: 'ga',
+    contextWindow: 1_050_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: false, // Responses-API-only, no streaming
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.gpt54,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-5.4',
+    tier: 'flagship',
+    settingsSchema: OAI_SAMPLING_ACCEPTED,
+    status: 'ga',
+    contextWindow: 1_000_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.gpt54_mini,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-5.4 mini',
+    tier: 'mini',
+    settingsSchema: OAI_SAMPLING_ACCEPTED,
+    status: 'ga',
+    contextWindow: 400_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.gpt54_nano,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-5.4 nano',
+    tier: 'nano',
+    settingsSchema: OAI_SAMPLING_ACCEPTED,
+    status: 'ga',
+    contextWindow: 400_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.o3_pro,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'o3-pro',
+    tier: 'pro',
+    settingsSchema: OAI_SAMPLING_UNVERIFIED,
+    status: 'ga',
+    contextWindow: 200_000,
+    maxOutputTokens: 100_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: false, // Responses-API-only, no streaming
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+
+  // ── Chat (legacy-active, sunsetting) ──
+  {
+    id: DyFM_OAI_Model.gpt4o,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-4o',
+    tier: 'legacy',
+    settingsSchema: OAI_CLASSIC_CHAT_SETTINGS,
+    status: 'deprecated',
+    successorId: DyFM_OAI_Model.gpt54_mini,
+    sunsetDate: '2026-10-23',
+    contextWindow: 128_000,
+    maxOutputTokens: 16_384,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.gpt4o_mini,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'GPT-4o mini',
+    tier: 'legacy',
+    settingsSchema: OAI_CLASSIC_CHAT_SETTINGS,
+    status: 'deprecated',
+    successorId: DyFM_OAI_Model.gpt54_mini,
+    sunsetDate: '2026-10-23',
+    contextWindow: 128_000,
+    maxOutputTokens: 16_384,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+
+  // ── Embeddings (current GA) ──
+  {
+    id: DyFM_OAI_Model.textEmbedding_3Small,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Embedding,
+    displayName: 'text-embedding-3-small',
+    status: 'ga',
+    settingsSchema: OAI_EMBEDDING_SETTINGS_SMALL,
+    contextWindow: 8_191,
+    capabilities: {
+      functionCalling: false,
+      vision: false,
+      streaming: false,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: true,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_OAI_Model.textEmbedding_3Large,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Embedding,
+    displayName: 'text-embedding-3-large',
+    status: 'ga',
+    settingsSchema: OAI_EMBEDDING_SETTINGS_LARGE,
+    contextWindow: 8_191,
+    capabilities: {
+      functionCalling: false,
+      vision: false,
+      streaming: false,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: true,
+      adultContent: false,
+    },
+  },
+
+  // ── Image generation (current GA) ──
+  {
+    id: DyFM_OAI_Model.gptImage_2,
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Image,
+    displayName: 'GPT Image 2',
+    status: 'ga',
+    settingsSchema: OAI_IMAGE_SETTINGS,
+    capabilities: {
+      functionCalling: false,
+      vision: true, // accepts image input for editing
+      streaming: false,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: true,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+];