Expose structured service tiers in app-server

codex-rs/app-server-protocol/src/protocol/v2.rs

@@ -51,6 +51,7 @@ use codex_protocol::models::PermissionProfile as CorePermissionProfile;
 use codex_protocol::models::ResponseItem;
 use codex_protocol::openai_models::InputModality;
 use codex_protocol::openai_models::ModelAvailabilityNux as CoreModelAvailabilityNux;
+use codex_protocol::openai_models::ModelServiceTier as CoreModelServiceTier;
 use codex_protocol::openai_models::ReasoningEffort;
 use codex_protocol::openai_models::default_input_modalities;
 use codex_protocol::parse_command::ParsedCommand as CoreParsedCommand;
@@ -153,6 +154,29 @@ impl TryFrom<&CoreServiceTier> for ServiceTier {
     }
 }
 
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)]
+#[serde(transparent)]
+#[ts(type = "string", export_to = "v2/")]
+pub struct ServiceTierId(pub String);
+
+impl From<ServiceTierId> for CoreServiceTier {
+    fn from(value: ServiceTierId) -> Self {
+        Self::from(value.0)
+    }
+}
+
+impl From<CoreServiceTier> for ServiceTierId {
+    fn from(value: CoreServiceTier) -> Self {
+        Self(value.to_string())
+    }
+}
+
+impl From<&CoreServiceTier> for ServiceTierId {
+    fn from(value: &CoreServiceTier) -> Self {
+        Self(value.to_string())
+    }
+}
+
 // Macro to declare a camelCased API v2 enum mirroring a core enum which
 // tends to use either snake_case or kebab-case.
 macro_rules! v2_enum_from_core {
@@ -2541,6 +2565,35 @@ impl From<CoreModelAvailabilityNux> for ModelAvailabilityNux {
     }
 }
 
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)]
+#[serde(rename_all = "camelCase")]
+#[ts(export_to = "v2/")]
+pub struct ModelServiceTier {
+    pub id: ServiceTierId,
+    pub name: String,
+    pub description: String,
+}
+
+impl From<CoreModelServiceTier> for ModelServiceTier {
+    fn from(value: CoreModelServiceTier) -> Self {
+        Self {
+            id: value.id.into(),
+            name: value.name,
+            description: value.description,
+        }
+    }
+}
+
+impl From<ModelServiceTier> for CoreModelServiceTier {
+    fn from(value: ModelServiceTier) -> Self {
+        Self {
+            id: value.id.into(),
+            name: value.name,
+            description: value.description,
+        }
+    }
+}
+
 #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
 #[serde(rename_all = "camelCase")]
 #[ts(export_to = "v2/")]
@@ -2559,8 +2612,13 @@ pub struct Model {
     pub input_modalities: Vec<InputModality>,
     #[serde(default)]
     pub supports_personality: bool,
+    /// Deprecated: use `serviceTiers` for structured service-tier metadata.
+    ///
+    /// @deprecated use `serviceTiers` instead.
     #[serde(default)]
     pub additional_speed_tiers: Vec<String>,
+    #[serde(default)]
+    pub service_tiers: Vec<ModelServiceTier>,
     // Only one model should be marked as default.
     pub is_default: bool,
 }

codex-rs/app-server/README.md

@@ -191,7 +191,7 @@ Example with notification opt-out:
 - `fs/watch` — subscribe this connection to filesystem change notifications for an absolute file or directory path and caller-provided `watchId`; returns the canonicalized `path`.
 - `fs/unwatch` — stop sending notifications for a prior `fs/watch`; returns `{}`.
 - `fs/changed` — notification emitted when watched paths change, including the `watchId` and `changedPaths`.
-- `model/list` — list available models (set `includeHidden: true` to include entries with `hidden: true`), with reasoning effort options, `additionalSpeedTiers`, optional legacy `upgrade` model ids, optional `upgradeInfo` metadata (`model`, `upgradeCopy`, `modelLink`, `migrationMarkdown`), and optional `availabilityNux` metadata.
+- `model/list` — list available models (set `includeHidden: true` to include entries with `hidden: true`), with reasoning effort options, `serviceTiers` (`id`, `name`, `description`), deprecated `additionalSpeedTiers`, optional legacy `upgrade` model ids, optional `upgradeInfo` metadata (`model`, `upgradeCopy`, `modelLink`, `migrationMarkdown`), and optional `availabilityNux` metadata.
 - `modelProvider/capabilities/read` — read provider-level capabilities for the currently configured model provider.
 - `experimentalFeature/list` — list feature flags with stage metadata (`beta`, `underDevelopment`, `stable`, etc.), enabled/default-enabled state, and cursor pagination. For non-beta flags, `displayName`/`description`/`announcement` are `null`.
 - `experimentalFeature/enablement/set` — patch the in-memory process-wide runtime feature enablement for the currently supported feature keys (`apps`, `memories`, `plugins`, `remote_control`, `tool_search`, `tool_suggest`, `tool_call_mcp_elicitation`). For each feature, precedence is: cloud requirements > --enable <feature_name> > config.toml > experimentalFeature/enablement/set (new) > code default.

codex-rs/app-server/src/models.rs

@@ -46,6 +46,7 @@ fn model_from_preset(preset: ModelPreset) -> Model {
         input_modalities: preset.input_modalities,
         supports_personality: preset.supports_personality,
         additional_speed_tiers,
+        service_tiers: preset.service_tiers.into_iter().map(Into::into).collect(),
         is_default: preset.is_default,
     }
 }

codex-rs/app-server/tests/suite/v2/model_list.rs

@@ -53,6 +53,12 @@ fn model_from_preset(preset: &ModelPreset) -> Model {
         // todo(sayan): fix, maybe make roundtrip use ModelInfo only
         supports_personality: false,
         additional_speed_tiers: legacy_additional_speed_tiers(&preset.service_tiers),
+        service_tiers: preset
+            .service_tiers
+            .clone()
+            .into_iter()
+            .map(Into::into)
+            .collect(),
         is_default: preset.is_default,
     }
 }