spn-core 0.2.0

Core types, provider definitions, model registry, and validation for SuperNovae ecosystem
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# spn-core

Core types and validation for the SuperNovae ecosystem.

## Features

- **Zero dependencies** - Pure Rust, fast compilation, WASM-compatible
- **Provider definitions** - 13+ LLM and MCP service providers
- **Validation** - Key format validation with detailed error messages
- **MCP types** - Configuration types for MCP server management

## Usage

```rust
use spn_core::{
    // Provider definitions
    Provider, ProviderCategory, KNOWN_PROVIDERS,
    find_provider, provider_to_env_var,

    // Validation
    validate_key_format, mask_key, ValidationResult,

    // MCP types
    McpServer, McpConfig, McpSource,
};

// Validate an API key
match validate_key_format("anthropic", "sk-ant-...") {
    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-••••••••");

// Get environment variable name
let env_var = provider_to_env_var("anthropic");
assert_eq!(env_var, Some("ANTHROPIC_API_KEY"));
```

## Supported Providers

### LLM Providers (7)
- `anthropic` - Anthropic Claude
- `openai` - OpenAI GPT
- `mistral` - Mistral AI
- `groq` - Groq
- `deepseek` - DeepSeek
- `gemini` - Google Gemini
- `ollama` - Ollama (local)

### MCP Service Providers (6)
- `neo4j` - Neo4j Graph Database
- `github` - GitHub API
- `slack` - Slack API
- `perplexity` - Perplexity AI
- `firecrawl` - Firecrawl Web Scraping
- `supadata` - Supadata API

## License

AGPL-3.0-or-later