ruvnet / ruvnet/midstream

SOTA: split realtime reflex control from deliberative reasoning

Open
#106 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
147
Forks
39
Avg merge
16h 39m
Merged PRs (30d)
2

Description

Goal

Implement and validate a two-speed agent control primitive where MidStream handles sub-second reflex events and Ruflo continues slower deliberative reasoning.

Architecture

Fast path handles interruption acknowledgement, backchannel, pause, cancel request, and stream continuity. It must not perform privileged tool actions or invent task conclusions.

Slow path remains responsible for reasoning, planning, tool choice, and task completion through Ruflo/RVM.

Primitive

Add a dependency-free ReflexController with:

  • typed realtime events
  • explicit reflex-safe actions
  • monotonic sequence numbers
  • stale event rejection
  • interruption coalescing
  • cancellation accounting
  • bounded queue depth
  • deterministic receipts with authority: none
  • reasoner handoff state that preserves task and interruption provenance

Benchmark

Compare monolithic deliberative control with split reflex/reasoning control under identical synthetic event traces.

Report:

  • interruption acknowledgement latency
  • queued event count
  • cancelled work units
  • wasted deliberative work
  • task completion quality proxy
  • stale event drops
  • overflow behavior
  • determinism

Promotion gate

Candidate must reduce interruption acknowledgement latency by at least 40%, preserve task quality within 2 absolute points, keep cancellation waste below 10% of deliberative work, reject stale/out-of-order events deterministically, and never grant execution authority.

Security

Reflex actions are local interaction controls only. Tool invocation, network access, filesystem mutation, capability grant, and external effects remain behind RVM and the deliberative path.

Cross-stack

MidStream owns reflex arbitration. Ruflo owns reasoning. MetaHarness owns matched benchmark and adversarial reproduction. RVM owns authority. Core Memory may persist receipts and session state. Cognitum can use the split for voice, robotics, ambient interfaces, and realtime customer agents.

No autonomous merge or deployment.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are named. Start by locating MidStream’s Rust control and arbitration entry point, then map the Ruflo/RVM handoff and MetaHarness benchmark before implementing; done means meeting the stated latency, quality, cancellation, ordering, overflow, determinism, and authority constraints.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
ai, backend-api-design, testing
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.