clawft-kernel 0.8.3

WeftOS kernel: boot sequence, process table, service registry, and health subsystem
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

//! Stable inference address, proxy and resolution (card mesh-placement-19;
//! ADR-101 section 5).
//!
//! - [`table`]: the [`PlacementTable`], role to serving node, fed by the
//!   card-18 adapters (local) and `infer.<role>` [`ServiceAdvertisement`]s
//!   of admitted peers (remote). Resolution for in-process consumers
//!   (`base_url_for_role`, wired to `clawft_llm::PlacementResolver`).
//! - [`listener`]: [`InferProxy`], the loopback endpoint proxy that keeps
//!   `127.0.0.1:<role port>` stable while the instance moves.
//! - [`mesh_forward`] / [`wire`]: forwarding over the authenticated mesh
//!   (frame types `InferRequest` / `InferResponse`).
//! - [`http`] / [`upstream`]: the HTTP edge and the loopback client.
//!
//! The proxy is not a general proxy. It binds loopback only, takes the
//! destination from the placement table and never from the request, allows
//! GET and POST on an inference path allowlist, refuses a non-loopback
//! `Host` and a cross-origin `Origin`, and bounds sizes and times
//! ([`ProxyLimits`]). Mesh forwarding reaches only admitted, verified peers
//! and only roles a node chose to expose.
//!
//! [`ServiceAdvertisement`]: crate::mesh_service_adv::ServiceAdvertisement

pub mod http;
pub mod hub;
pub mod listener;
pub mod mesh_forward;
pub mod mesh_policy;
pub mod table;
pub mod types;
pub mod upstream;
pub mod wire;

#[cfg(test)]
mod support;
#[cfg(test)]
mod tests_expose;
#[cfg(test)]
mod tests_http;
#[cfg(test)]
mod tests_hub;
#[cfg(test)]
mod tests_mesh;
#[cfg(test)]
mod tests_mesh_serve;
#[cfg(test)]
mod tests_proxy;

#[cfg(feature = "exochain")]
pub use types::ChainAudit;
pub use hub::InferHub;
pub use listener::{ExposureAuth, ExposurePermit, InferProxy, OccupiedPolicy, ProxyStats, Started, check_bind};
pub use mesh_forward::{InferPeer, ServeGate, ServePolicy, Served, forward_remote, serve_infer};
pub use table::{DEFAULT_ADVERT_TTL, MeshLocal, PlacementTable, SERVICE_PREFIX, SyncOutcome};
pub use types::{
    MeshDialer, Method, ProxyAudit, ProxyError, ProxyLimits, ProxyRequest, ResponseSink, Target,
};
pub use upstream::Upstream;