agen 0.2.1

Provider-neutral orchestration for tool-using LLM applications
Documentation
//! `impl Scheme for OpenAIResponsesScheme`

use serde_json::Value;

use crate::llm_client::{
    ClientError,
    auth::AuthRequirement,
    capability::ModelCapability,
    client::ConfigWarning,
    event::Event,
    scheme::Scheme,
    types::{Request, RequestConfig},
};

use super::OpenAIResponsesScheme;

pub use super::events::OpenAIResponsesState;

impl Scheme for OpenAIResponsesScheme {
    type State = OpenAIResponsesState;

    fn default_base_url(&self) -> &'static str {
        // `/v1` は base_url 側に寄せる。互換 backend を使う場合も、
        // base URL を差し替えるだけで同じ `/responses` path を使える。
        "https://api.openai.com/v1"
    }

    fn path(&self, _model_id: &str) -> String {
        "/responses".to_string()
    }

    fn required_auth(&self) -> AuthRequirement {
        AuthRequirement::Bearer
    }

    fn build_request_body(
        &self,
        model_id: &str,
        request: &Request,
        capability: &ModelCapability,
    ) -> Value {
        let body = self.build_request(model_id, request, capability);
        serde_json::to_value(&body).expect("ResponsesRequest is always serialisable")
    }

    fn parse_sse(
        &self,
        event_type: &str,
        data: &str,
        state: &mut Self::State,
    ) -> Result<Vec<Event>, ClientError> {
        super::events::parse_sse(event_type, data, state)
    }

    fn default_capability(&self) -> ModelCapability {
        super::capability::default_capability()
    }

    fn validate_config(&self, config: &RequestConfig) -> Vec<ConfigWarning> {
        let mut warnings = Vec::new();
        // Some compatible backends reject `max_output_tokens` with HTTP 400.
        // If the scheme was built with `send_max_output_tokens=false`, body
        // projection is already disabled; only notify that the user's intent
        // was dropped.
        if !self.send_max_output_tokens && config.max_tokens.is_some() {
            warnings.push(ConfigWarning::unsupported(
                "max_tokens",
                "OpenAI Responses compatible backend",
            ));
        }
        // Same for `temperature` / `top_p` on compatible backends that
        // reject unsupported sampling parameters.
        if !self.send_sampling_params {
            if config.temperature.is_some() {
                warnings.push(ConfigWarning::unsupported(
                    "temperature",
                    "OpenAI Responses compatible backend",
                ));
            }
            if config.top_p.is_some() {
                warnings.push(ConfigWarning::unsupported(
                    "top_p",
                    "OpenAI Responses compatible backend",
                ));
            }
        }
        warnings
    }
}