Skip to main content

Crate rutis_bridge

Crate rutis_bridge 

Source
Expand description

Connect rutis to other processes, languages and machines.

  • runtime: plugins written in other languages, run by language runtimes (started with runtime::Launcher::start on this machine, each the far end of a session); rutis-loader manages them as rows.
  • Session: the far end of a Channel (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 its PluginCatalog.
  • events: the logical event bus across runtimes and nodes.
  • What sessions run over: pipe (local processes), memory (in-process channels) and websocket (feature websocket), each giving a Channel directly (pipe::spawn, memory::pair, websocket::dial, websocket::listen).
  • session: the protocol all of these speak, over any channel::Channel.
  • [cordis] (feature cordis): 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, protocol docs/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, CAPACITY messages per direction.
pipe
Channels to processes on the same machine: spawn starts 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); a Launcher says 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 with Close::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, saying the host provides no id for its sessions.
RowHandle
A plugin of the far end this end runs: dropping it stops the plugin. RowHandle::loaded waits for its load.
Session
A session on one channel, handshake and mount in one plugin: ctx.plugin(Session::new(channel)). Its FiberView ends when the session unloads: the far end left, it was unloaded, or the handshake failed (the plugin fails with why).
SessionHandle
A mounted session, as code that is not one of its plugins uses it.
StaticCatalog
A catalog from a fixed list.

Traits§

PluginCatalog
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. None for errors rutis or Rust code raised. Takes a rutis::Error (&error) or the ErrorKind a row’s state keeps.