Expand description
Connect rutis to other processes, languages and machines.
runtime: plugins written in other languages, run by language runtimes (started withruntime::Launcher::starton this machine, each the far end of a session); rutis-loader manages them as rows.Session: the far end of aChannel(a runtime, an app, a node) as plugins of this kernel. A far rutis kernel is a session’s far end too: the services of both are seen on both sides, events are one bus, and each runs the other’s plugins from itsPluginCatalog.events: the logical event bus across runtimes and nodes.- What sessions run over:
pipe(local processes),memory(in-process channels) andwebsocket(featurewebsocket), each giving aChanneldirectly (pipe::spawn,memory::pair,websocket::dial,websocket::listen). session: the protocol all of these speak, over anychannel::Channel.- [
cordis] (featurecordis): Cordis plugins mounted in a Rust application with Rust bindings generated at build time.
Design: docs/design-protocol-channel-decoupling-2026-10-03.md,
docs/design-remote-session-2026-10-28.md.
Re-exports§
pub use channel::Channel;pub use channel::Close;pub use channel::ConnectError;pub use channel::PeerId;pub use session::plugin::Greeted;pub use session::plugin::LocalId;pub use session::plugin::RowHandle;pub use session::plugin::Session;pub use session::plugin::SessionHandle;
Modules§
- channel
- The channel a rutis interop session runs on
(
docs/design-protocol-channel-decoupling-2026-10-03.md). - events
- The logical event bus across processes and nodes (#464,
docs/design-events-2026-10-18.md, protocoldocs/design-events-protocol-2026-10-18.md). - exports
- Rust services used by name from the plugins of other languages.
- memory
- Channels within one process, for tests and in-process sessions:
bounded,
CAPACITYmessages per direction. - pipe
- Channels to processes on the same machine:
spawnstarts a process on an inherited socket (Unix) or a loopback address with a one-time token (every platform) and connects it; the channel owns the process. Unix sockets are framed the same way, by newline. - report
- An error as a host prints it (the diagnostics design §4.4, §4.6): its own text, then which row it came from and what that row was doing, then the frames of the plugin that threw it.
- runtime
- Language runtimes: processes that run plugins written in another
language, whose plugins rutis-loader manages as rows. How each
language’s process starts is the application’s (rutis-host’s
rutis-host/spawn); aLaunchersays it. - session
- The session protocol between rutis and another process: calls both
ways, references to objects and functions, async results and
cancellation, over any
Channel. Language runtimes and links between nodes both run on it.
Structs§
- Greeted
- A session whose far end greeted, not mounted yet: nothing of the far end
is registered. Mount it with
ctx.plugin(greeted); dropping it unmounted closes the channel withClose::Done. - Installed
- An installed plugin: what it declares, and how to build it.
- LocalId
- The id this end greets with in every session. The host provides it on
its root:
root.provide(LocalId(id)). There is no default: a session without one fails, sayingthe host provides no id for its sessions. - RowHandle
- A plugin of the far end this end runs: dropping it stops the plugin.
RowHandle::loadedwaits for its load. - Session
- A session on one channel, handshake and mount in one plugin:
ctx.plugin(Session::new(channel)). ItsFiberViewends when the session unloads: the far end left, it was unloaded, or the handshake failed (the plugin fails with why). - Session
Handle - A mounted session, as code that is not one of its plugins uses it.
- Static
Catalog - A catalog from a fixed list.
Traits§
- Plugin
Catalog - The plugins installed here that a far kernel may run, with what each declares. Looking one up may take a while (a loader’s resolvers).
Functions§
- fingerprint
- The SHA-256 fingerprint of a certificate’s DER.
- thrown
- The error another language threw, inside a rutis error: a row that
failed, a call to a plugin’s service that failed. Gives its name, code,
data, stack and site (
docs/design-diagnostics-2026-10-26.md§4.2), so a host can say it in its own words by code instead of matching text.Nonefor errors rutis or Rust code raised. Takes arutis::Error(&error) or theErrorKinda row’s state keeps.