systemprompt-ai 0.14.5

//! Buffered `OpenAI` Chat Completions entry points.
//!
//! Each builds a canonical request through the bridge, renders it with the
//! shared `openai_chat` codec, posts it, and maps the parsed canonical reply
//! back to an [`AiResponse`].

use std::time::Instant;

use serde_json::Value;
use systemprompt_models::wire::canonical::ResponseFormat;
use systemprompt_models::wire::openai_chat;
use uuid::Uuid;

use crate::error::Result;
use crate::models::ai::AiResponse;
use crate::models::tools::ToolCall;
use crate::services::providers::canonical_bridge::{
    self, BridgeProvider, CanonicalBuild, agent_response_format, tools_to_canonical,
};
use crate::services::providers::{
    GenerationParams, SchemaGenerationParams, StructuredGenerationParams, ToolGenerationParams,
};

use super::provider::OpenAiProvider;

const STRUCTURED_OUTPUT_TOOL: &str = "structured_output";

async fn post_chat(provider: &OpenAiProvider, body: &Value) -> Result<Value> {
    let response = provider
        .client
        .post(format!("{}/chat/completions", provider.endpoint))
        .bearer_auth(&provider.api_key)
        .json(body)
        .send()
        .await?;
    if !response.status().is_success() {
        return Err(crate::error::AiError::from_error_response("openai", response).await);
    }
    Ok(response.json().await?)
}

pub(super) async fn generate(
    provider: &OpenAiProvider,
    params: GenerationParams<'_>,
) -> Result<AiResponse> {
    let start = Instant::now();
    let request_id = Uuid::new_v4();
    let canonical = CanonicalBuild::new(
        BridgeProvider::OpenAi,
        params.messages,
        params.model,
        params.max_output_tokens,
    )
    .with_sampling(params.sampling)
    .into_request();

    let body = openai_chat::build_request_body(&canonical, params.model);
    let value = post_chat(provider, &body).await?;
    let parsed = openai_chat::parse_response(&value, params.model);
    Ok(canonical_bridge::to_ai_response(
        "openai",
        params.model,
        request_id,
        start,
        &parsed,
    ))
}

pub(super) async fn generate_with_tools(
    provider: &OpenAiProvider,
    params: ToolGenerationParams<'_>,
) -> Result<(AiResponse, Vec<ToolCall>)> {
    let start = Instant::now();
    let request_id = Uuid::new_v4();
    let canonical = CanonicalBuild::new(
        BridgeProvider::OpenAi,
        params.base.messages,
        params.base.model,
        params.base.max_output_tokens,
    )
    .with_sampling(params.base.sampling)
    .with_tools(tools_to_canonical(params.tools))
    .into_request();

    let body = openai_chat::build_request_body(&canonical, params.base.model);
    let value = post_chat(provider, &body).await?;
    let parsed = openai_chat::parse_response(&value, params.base.model);
    let tool_calls = canonical_bridge::tool_calls(&parsed);
    let ai_response =
        canonical_bridge::to_ai_response("openai", params.base.model, request_id, start, &parsed);
    Ok((ai_response, tool_calls))
}

pub(super) async fn generate_structured(
    provider: &OpenAiProvider,
    params: StructuredGenerationParams<'_>,
) -> Result<AiResponse> {
    let start = Instant::now();
    let request_id = Uuid::new_v4();
    let canonical = CanonicalBuild::new(
        BridgeProvider::OpenAi,
        params.base.messages,
        params.base.model,
        params.base.max_output_tokens,
    )
    .with_sampling(params.base.sampling)
    .with_response_format(agent_response_format(params.response_format))
    .into_request();

    let body = openai_chat::build_request_body(&canonical, params.base.model);
    let value = post_chat(provider, &body).await?;
    let parsed = openai_chat::parse_response(&value, params.base.model);
    Ok(canonical_bridge::to_ai_response(
        "openai",
        params.base.model,
        request_id,
        start,
        &parsed,
    ))
}

pub(super) async fn generate_with_schema(
    provider: &OpenAiProvider,
    params: SchemaGenerationParams<'_>,
) -> Result<AiResponse> {
    let start = Instant::now();
    let request_id = Uuid::new_v4();
    let response_format = ResponseFormat::JsonSchema {
        name: STRUCTURED_OUTPUT_TOOL.to_owned(),
        schema: params.response_schema,
        strict: true,
    };
    let canonical = CanonicalBuild::new(
        BridgeProvider::OpenAi,
        params.base.messages,
        params.base.model,
        params.base.max_output_tokens,
    )
    .with_sampling(params.base.sampling)
    .with_response_format(Some(response_format))
    .into_request();

    let body = openai_chat::build_request_body(&canonical, params.base.model);
    let value = post_chat(provider, &body).await?;
    let parsed = openai_chat::parse_response(&value, params.base.model);
    Ok(canonical_bridge::to_ai_response(
        "openai",
        params.base.model,
        request_id,
        start,
        &parsed,
    ))
}