Crate spn_core 

spn-core: Core types and validation for the SuperNovae ecosystem.

This crate provides:

• Provider definitions (13+ LLM and MCP service providers)
• Key format validation with detailed error messages
• MCP server configuration types
• Package registry types

Design Principles

• Zero dependencies: Pure Rust, fast compilation, WASM-compatible
• Single source of truth: All provider definitions in one place
• Shared types: Used by spn-cli, spn-client, spn-keyring, and nika

Example

use spn_core::{
    Provider, ProviderCategory, KNOWN_PROVIDERS,
    find_provider, provider_to_env_var,
    validate_key_format, mask_key, ValidationResult,
};

// Find a provider
let provider = find_provider("anthropic").unwrap();
assert_eq!(provider.env_var, "ANTHROPIC_API_KEY");

// Validate a key format
match validate_key_format("anthropic", "sk-ant-api03-xxx") {
    ValidationResult::Valid => println!("Key is valid!"),
    ValidationResult::InvalidPrefix { expected, .. } => {
        println!("Key should start with: {}", expected);
    }
    _ => {}
}

// Mask a key for display
let masked = mask_key("sk-ant-secret-key-12345");
assert_eq!(masked, "sk-ant-••••••••");

Structs

GpuInfo

GPU device information.

LoadConfig

Configuration for loading a model.

McpConfig

Complete MCP configuration containing multiple servers.

McpServer

MCP server configuration.

ModelInfo

Information about an installed model.

PackageManifest

Package manifest (spn.yaml content).

PackageRef

Reference to a package in the registry.

Provider

Provider metadata.

PullProgress

Progress information during model pull/download.

RunningModel

Information about a currently running/loaded model.

Enums

BackendError

Error types for backend operations.

McpServerType

Type of MCP server transport.

McpSource

Source of an MCP configuration.

PackageType

Type of package in the registry.

ProviderCategory

Category of provider service.

ValidationResult

Result of key format validation.

Statics

KNOWN_PROVIDERS

All known providers in the SuperNovae ecosystem.

Functions

find_provider

Find a provider by ID (case-insensitive).

mask_key

Mask an API key for safe display.

provider_to_env_var

Get the environment variable name for a provider.

providers_by_category

Get all providers in a specific category.

validate_key_format

Validate an API key format for a specific provider.