Module backend

Module backend 

Source

Re-exports§

pub use oref::ORef;

Modules§

agent_config
Pure config-building logic for agent definitions.
agent_seed
Agent seed engine: preloads agents from an embedded manifest on first launch. Seeds agents with identity + content. Provider, agent_type, and environment are NOT baked into the manifest — they default to sensible values and are user-configurable via the Agent settings UI after seeding.
agent_session
Agent-anchored session zones (Option E, PR 1 of 2).
base
Wave base utilities: directory management, lock files, environment, platform detection. Port of Go’s pkg/base/.
blockcontroller
Block controller: manages lifecycle of each block (terminal, command, web app). Port of Go’s pkg/blockcontroller/blockcontroller.go.
config_watcher_fs
Filesystem watcher for settings.json — detects saves and pushes updated config to all connected WebSocket clients in real time.
docsite
Documentation site path resolution. Port of Go’s pkg/docsite/.
eventbus
Event bus: WebSocket event dispatching to connected clients. Port of Go’s pkg/eventbus/eventbus.go.
history
History module — discovers and indexes past CLI agent conversations from disk.
ijson
Incremental JSON (iJSON): path-based operations on JSON data. Port of Go’s pkg/ijson/ijson.go.
lan_discovery
LAN instance discovery via mDNS/DNS-SD.
layout
Phase E.4.B Phase 4 — pure layout-tree helpers (Rust port of layoutTree.ts). Pure layout-tree helper functions for the srv E.4.B reducer.
messagebus
Local MessageBus for inter-agent communication.
obj
WaveObj types: Rust equivalents of Go structs from pkg/obj/wtype.go. All #[serde(rename = "...")] tags match Go JSON tags for wire compatibility.
oref
ORef: typed object reference in “otype:oid” string format. Custom serde: serializes as a JSON string, not an object.
process_tracker
Agent-spawned process tracking.
providers
Static provider registry — Rust equivalent of frontend/app/view/agent/providers/index.ts.
reactive
Reactive messaging system for agent-to-agent terminal communication. Port of Go’s pkg/reactive/.
readutil
File reading utilities for forward and tail (reverse) reading. Port of Go’s pkg/util/readutil/readutil.go.
rpc
RPC communication layer: message routing and request/response engine. Port of Go’s pkg/wshutil/wshrouter.go and pkg/wshutil/wshrpc.go.
rpc_fileutil
Wave file utility: conversion between WaveFile (storage) and FileInfo (RPC). Port of Go’s pkg/util/rpc_fileutil/rpc_fileutil.go.
rpc_types
RPC wire format types: Rust equivalents of Go structs from pkg/wshutil/wshrpc.go and pkg/wshrpc/wshrpctypes.go.
schema
Schema path resolution with .json extension fallback. Port of Go’s pkg/schema/schema.go.
service
Service dispatcher: routes web/RPC calls to backend services. Port of Go’s pkg/service/service.go and all sub-services.
session_archive
Session archival and cleanup (Phase 3.3 — ultra-long-sessions).
shellexec
Shell process execution: PTY management and process lifecycle. Port of Go’s pkg/shellexec/shellexec.go + conninterface.go.
shellintegration
Shell integration script deployment and shell startup configuration.
sigutil
Signal handling utilities. Port of Go’s pkg/util/sigutil/sigutil.go.
storage
Storage layer: SQLite-backed object store and file store. Port of Go’s pkg/wstore and pkg/filestore.
subagent_watcher
Subagent watcher: monitors Claude Code session directories for subagent JSONL files and broadcasts activity events to WebSocket clients.
syncbuf
Thread-safe byte buffer. Port of Go’s pkg/util/syncbuf/syncbuf.go.
sysinfo
Sysinfo data collection loop: collects CPU, memory, and network metrics and publishes them via the WPS broker. Sampling interval is configurable via the telemetry:interval setting (0.1s–2.0s, default 1.0s).
tarcopy
Tar copy utilities for streaming file transfers over channels. Port of Go’s pkg/util/tarcopy/tarcopy.go.
tool_store
Tool store: ensures CLI tools (jq, rg, etc.) are available to agent subprocesses. Reads a bundled catalog JSON, checks system/bundled/managed install paths, and can download + verify tools on demand.
trimquotes
Quote handling utilities for CLI argument processing. Port of Go’s pkg/trimquotes/trimquotes.go.
userinput
User input: modal dialogs for interactive user prompts. Port of Go’s pkg/userinput/userinput.go.
utilds
Utility data structures. Port of Go’s pkg/utilds/.
utilfn
Utility functions ported from Go’s pkg/util/utilfn/utilfn.go.
wconfig
Configuration system: settings, themes, widgets, bookmarks, connections. Port of Go’s pkg/wconfig/.
wcore
Wave Core: application coordinator for storage + pub/sub. Port of Go’s pkg/wcore/wcore.go + window.go + workspace.go + block.go.
wps
Wave Pub/Sub system: event brokering with scoped subscriptions. Port of Go’s pkg/wps/wps.go + wpstypes.go.
wshutil
WSH RPC transport layer. Port of Go’s pkg/wshutil/ — OSC encoding, RPC proxy, event system, and I/O adapters.