CtrlK
BlogDocsLog inGet started
Tessl Logo

ruview-rvagent

Explore and prototype rvAgent + RVF integration for RuView agentic flows. Use when working on cross-cog coordination, operator-facing agents reading BFLD / pose / vitals events live, or persisting agent state alongside sensing data in the same RVF container.

58

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/ruview/skills/ruview-rvagent/SKILL.md
SKILL.md
Quality
Evals
Security

RuView rvAgent + RVF integration

Surface area for wiring vendor/ruvector/crates/rvAgent/ into RuView so the existing sensing pipeline becomes the substrate an agentic flow can read, reason about, and respond to.

Quickstart — published MCP server (@ruvnet/rvagent v0.1.0)

Installing this plugin registers @ruvnet/rvagent as an MCP server. On activation, Claude Code spawns npx -y @ruvnet/rvagent and exposes its tools directly:

ToolPurpose
bfld_last_scanMost recent BFLD event from the sensing server
bfld_subscribeStream BFLD events for a window
presence_nowCurrent room-level presence state
vitals_get_breathingLatest breathing-rate sample
vitals_get_heart_rateLatest heart-rate sample
vitals_get_allComposite vitals snapshot
vitals_fetchHistorical vitals window

Override the sensing-server URL via the RVAGENT_SENSING_URL env var (default http://localhost:3000). Source lives at tools/ruview-mcp/; ADR-124 captures the design.

Smoke-check the wiring: npm view @ruvnet/rvagent version should return 0.1.0 (or newer).

When to use this skill

  • "I want an agent that reacts to BFLD presence in the kitchen and pages the carer."
  • "I need cog-pose-estimation and cog-bfld to negotiate before publishing a synthesized event."
  • "Can the witness chain attest both the sensing event AND the agent decision in one RVF blob?"
  • "How do we keep rvAgent's tool outputs class-3 compliant when the source BFLD event is Restricted?"

Key surfaces

SurfaceFileNotes
rvAgent corevendor/ruvector/crates/rvAgent/rvagent-core/src/agi_container.rs (627 LOC)RVF-compatible state container
rvAgent middlewarevendor/ruvector/crates/rvAgent/rvagent-middleware/Witness, sanitizer, SONA, HNSW
Agent personasvendor/ruvector/crates/rvAgent/.ruv/agents/rvagent-{queen,coder,tester,security}.mdReference patterns
RVF containerv2/crates/wifi-densepose-sensing-server/src/rvf_container.rsAdd SEG_AGENT_STATE, SEG_DECISION
BFLD eventv2/crates/wifi-densepose-bfld/src/event.rsBfldEvent::to_json()ToolOutput
BFLD pipeline handlev2/crates/wifi-densepose-bfld/src/pipeline_handle.rsBfldPipelineHandle::send

Research dossier

Full integration analysis lives at docs/research/rvagent-rvf-integration/README.md.

Three shippable touchpoints, each independent:

  1. RVF wire: two new segment types (SEG_AGENT_STATE = 0x08, SEG_DECISION = 0x09) let rvAgent sessions interleave with RuView sensing sessions in the same blob.
  2. Tool surface: BfldEvent → ToolOutput shim turns BFLD events into agent context with no new IPC.
  3. Cog subagents: cog-pose-estimation / cog-person-count / cog-ha-matter / cog-bfld register as rvAgent subagents under a queen-agent router.

Open questions

  • Workspace inclusion of vendor/ruvector/crates/rvAgent/ (path dep vs published crate)
  • Sync ↔ async adapter (BFLD Publish is sync, rvAgent backends are tokio)
  • Privacy-class composition (does rvAgent's sanitizer consume PrivacyClass?)
  • Soul Signature ↔ SoulMatchOracle bridge
  • Whether BfldPipelineHandle::send lands as a public MCP tool via rvagent-mcp

Next decision

ADR-124 (proposed) — "rvAgent + RVF integration for RuView agentic flows" — would capture segment assignments, cog-subagent contract, and the privacy-class composition rule. Land before scaffolding v2/crates/wifi-densepose-agent.

Repository
ruvnet/RuView
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.