stdiobus-core

Core types and protocol models for stdio_bus - the AI agent transport layer.

This crate provides shared types, error definitions, and protocol models used by other stdiobus crates.

Installation

[dependencies]
stdiobus-core = "1.0"

Contents

• BusConfig, PoolConfig, LimitsConfig - Typed configuration matching C bus JSON schema
• ConfigSource - Configuration source enum (programmatic or file path)
• Error - Comprehensive error types with is_retryable() support
• ErrorCode - Error code enumeration matching C library codes
• BusState - Bus lifecycle states (Created, Starting, Running, Stopping, Stopped)
• BusStats - Runtime statistics
• Message - JSON-RPC message types
• generate_client_session_id() - Generate unique session IDs for routing

Usage

Most users should use stdiobus-client instead of this crate directly.

use stdiobus_core::{Error, ErrorCode, generate_client_session_id};

// Generate a client session ID for routing
let session_id = generate_client_session_id();

// Check if an error is retryable
match some_operation() {
    Err(e) if e.is_retryable() => {
        // Retry the operation
    }
    Err(e) => return Err(e),
    Ok(v) => v,
}

License

Apache-2.0