sipp-rs 0.1.0

Unified Rust library for extensible Sipp inference
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
37
38
39
40
41
42
43
44
45
46
47
48
49

use std::path::PathBuf;

use crate::engine::NativeRuntimeConfig;

use crate::client::GatewayEndpointConfig;
#[cfg(feature = "providers")]
use crate::client::ProviderEndpointConfig;

/// Configuration used by `SippClient::add` to register an endpoint.
#[derive(Debug, Clone, PartialEq)]
pub enum EndpointDescriptor {
    /// Local GGUF model loaded into this process.
    LocalModel(LocalModelDescriptor),
    /// First-party HTTP gateway endpoint.
    Gateway(GatewayEndpointConfig),
    /// Direct provider endpoint using caller-owned credentials.
    #[cfg(feature = "providers")]
    Provider(ProviderEndpointConfig),
}

impl EndpointDescriptor {
    /// Create a local model descriptor.
    pub fn local(model_path: impl Into<PathBuf>, config: NativeRuntimeConfig) -> Self {
        Self::LocalModel(LocalModelDescriptor {
            model_path: model_path.into(),
            config,
        })
    }

    /// Create a gateway endpoint descriptor.
    pub fn gateway(config: GatewayEndpointConfig) -> Self {
        Self::Gateway(config)
    }

    /// Create a direct provider descriptor.
    #[cfg(feature = "providers")]
    pub fn provider(config: ProviderEndpointConfig) -> Self {
        Self::Provider(config)
    }
}

/// Local GGUF model descriptor.
#[derive(Debug, Clone, PartialEq)]
pub struct LocalModelDescriptor {
    /// Path to the local model artifact.
    pub model_path: PathBuf,
    /// Native runtime configuration.
    pub config: NativeRuntimeConfig,
}