Skip to main content

noesis_ship/
lib.rs

1//! # noesis-ship
2//!
3//! Rust NATS communication platform for multi-agent AI systems.
4//!
5//! Provides five core primitives over NATS:
6//!
7//! - **PubSub** — Fire-and-forget publish/subscribe (NATS Core)
8//! - **EventBus** — Durable event streaming (JetStream)
9//! - **Channels** — Point-to-point messaging with history (JetStream)
10//! - **KV Store** — Key-value state management (NATS KV)
11//! - **Object Store** — Large blob storage (NATS Object Store)
12//! - **JobQueue** — Generic job lifecycle (queued → running → complete/failed)
13//!
14//! Plus **NatsServiceBuilder** — a framework for building NATS request-reply
15//! services in ~20 lines of glue code.
16//!
17//! ## Quick Start
18//!
19//! ```rust
20//! use noesis_ship::types::NatsConfig;
21//!
22//! let config = NatsConfig::new("nats://localhost:4222");
23//! assert_eq!(config.url, "nats://localhost:4222");
24//! ```
25
26pub mod channels;
27pub mod connection;
28pub mod event_bus;
29pub mod job_queue;
30pub mod kv;
31pub mod object_store;
32pub mod pubsub;
33pub mod service;
34pub mod types;