LNMP - LLM Native Minimal Protocol

LNMP is a meta crate that provides unified access to all modules of the LLM Native Minimal Protocol ecosystem. Instead of managing multiple dependencies, simply add lnmp to your project and get everything you need.

📋 FID Registry: All Field IDs have official definitions in registry/fids.yaml. See spec/fid-governance.md for governance rules.

Quick Start

Add this to your Cargo.toml:

[dependencies]
lnmp = "0.5.13"

Then use any LNMP module:

use lnmp::prelude::*;
use lnmp::core::{Message, MessageType};
use lnmp::codec::{encode, decode};
use lnmp::embedding::VectorDelta;
use lnmp::spatial::SpatialStreamer;

What's Included

This meta crate re-exports all LNMP modules:

Why Use the Meta Crate?

Before (Multiple Dependencies)

[dependencies]
lnmp-core = "0.5.13"
lnmp-codec = "0.5.13"
lnmp-embedding = "0.5.13"
lnmp-spatial = "0.5.13"
# ... which ones do I need?

After (Single Dependency)

[dependencies]
lnmp = "0.5.13"  # Everything included!

Usage Examples

Basic Message Encoding

use lnmp::prelude::*;

let message = Message::new(MessageType::Text, b"Hello, LNMP!");
let encoded = encode(&message)?;
let decoded = decode(&encoded)?;

Embedding Delta Compression

use lnmp::embedding::{VectorDelta, DeltaMode};

let old_vector = vec![1.0, 2.0, 3.0];
let new_vector = vec![1.1, 2.0, 3.2];

// Compute delta (needs base_id for reconstruction)
let delta = VectorDelta::from_vectors(&old_vector, &new_vector, 1)?;

Spatial Streaming

use lnmp::spatial::{SpatialStreamer, HybridProtocol};

let streamer = SpatialStreamer::new(HybridProtocol::default());
// Stream spatial data efficiently...

Network Routing

use lnmp::net::{NetMessage, MessageKind, RoutingPolicy};

// Create a network message
let msg = NetMessage::new(envelope, MessageKind::Alert);

// Make intelligent routing decision
let policy = RoutingPolicy::default();
let decision = policy.decide(&msg, now_ms)?;

Individual Modules

If you prefer fine-grained control and only need specific functionality, you can still depend on individual crates:

• lnmp-core - Core protocol definitions
• lnmp-codec - Encoding/decoding
• lnmp-embedding - Embedding operations
• lnmp-llb - Large Language Blocks
• lnmp-quant - Quantization
• lnmp-sanitize - Sanitization
• lnmp-sfe - Secure Function Evaluation
• lnmp-spatial - Spatial streaming
• lnmp-transport - Transport bindings
• lnmp-net - Network behavior layer

Documentation

• API Documentation
• Protocol Specification
• Migration Guide

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.