proserpina 0.3.0

Multi-agent critique and cross-examination pipeline for documents requiring intellectual rigor — provider-agnostic interaction-graph engine with pluggable LLM backends
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

// Copyright (C) 2026 Industrial Algebra
// SPDX-License-Identifier: Apache-2.0-only

//! API-key auth flow: prompt, validate, store.

use crate::backend::http::{validate_provider, RetryPolicy};
use crate::ProserpinaError;

use super::{auth_to_http_config, AuthMethod, AuthUi, ProviderAuth};

/// Runs the API-key auth flow for a provider: prompt for a key, validate it,
/// return the validated key for storage.
///
/// # Errors
///
/// Returns [`ProserpinaError`] if validation fails (the key is rejected by
/// the provider).
pub fn run_api_key_flow(
    ui: &dyn AuthUi,
    provider: &ProviderAuth,
) -> Result<String, ProserpinaError> {
    let AuthMethod::ApiKey { signup_url, .. } = &provider.method else {
        return Err(ProserpinaError::agent_failure(
            provider.name,
            "not an API-key provider",
        ));
    };

    let key = ui.prompt_api_key(provider.name, signup_url)?;

    ui.show_status("Validating...");
    let config = auth_to_http_config(provider, key.clone());
    validate_provider(&config, &RetryPolicy::NONE)?;

    Ok(key)
}