Skip to content

Commit 4e0e1aa

Browse files
author
SIN-Agent
committed
docs: Add RecursiveMAS guide for standalone agents
- Config examples for explore, librarian, oracle, hephaestus, metis, momus, multimodal-looker - RecursiveMAS is already in OpenSIN-Code runtime (PR #1123 MERGED) - Agents automatically inherit RecursiveMAS when using the runtime - Enable via recursiveMas config in agent settings Part of Phase 2 (Standalone Agents) RecursiveMAS rollout
1 parent 78038f5 commit 4e0e1aa

1 file changed

Lines changed: 88 additions & 0 deletions

File tree

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
# RecursiveMAS for Standalone Agents
2+
3+
> Configure RecursiveMAS for explore, librarian, oracle, and other standalone agents.
4+
5+
## Overview
6+
7+
RecursiveMAS is integrated into **OpenSIN-Code runtime** (PR #1123 MERGED). All standalone agents using this runtime automatically inherit RecursiveMAS.
8+
9+
## Configuration for Standalone Agents
10+
11+
Since standalone agents (explore, librarian, etc.) use the OpenSIN-Code CLI runtime, they just need to enable RecursiveMAS in their config.
12+
13+
### Explore Agent (explore)
14+
15+
Explore agent uses `nvidia-nim/stepfun-ai/step-3.5-flash`. Add RecursiveMAS to its config:
16+
17+
```json
18+
{
19+
"recursiveMas": {
20+
"enabled": true,
21+
"topology": "chain",
22+
"latentDim": 64,
23+
"cliPath": "recursivemas",
24+
"logTraces": true
25+
}
26+
}
27+
```
28+
29+
### Librarian Agent (librarian)
30+
31+
Librarian agent also uses `nvidia-nim/stepfun-ai/step-3.5-flash`:
32+
33+
```json
34+
{
35+
"recursiveMas": {
36+
"enabled": true,
37+
"topology": "star",
38+
"latentDim": 128,
39+
"cliPath": "/usr/local/bin/recursivemas",
40+
"logTraces": true
41+
}
42+
}
43+
```
44+
45+
### Oracle Agent (oracle)
46+
47+
```json
48+
{
49+
"recursiveMas": {
50+
"enabled": true,
51+
"topology": "chain",
52+
"latentDim": 64
53+
}
54+
}
55+
```
56+
57+
### Hephaestus, Metis, Momus, Multimodal-Looker
58+
59+
Same pattern — add `recursiveMas` config to each agent's settings.
60+
61+
## Testing RecursiveMAS with Standalone Agents
62+
63+
Since these agents use the OpenSIN-Code runtime, tests should verify RecursiveMAS works when the agent runs:
64+
65+
```bash
66+
# Test that RecursiveMAS monitor is active when agent uses runtime with RecursiveMasConfig
67+
python3 -m pytest opensin_core/tests/test_agent_loop.py -v
68+
```
69+
70+
Expected: All 22 tests pass (including RecursiveMAS tests).
71+
72+
## SOTA Compliance Checklist (Per Agent)
73+
74+
- [x] Opt-in feature flag (enabled: false by default in runtime)
75+
- [x] Clean integration (RecursiveMAS in OpenSIN-Code runtime)
76+
- [ ] Tests (verify RecursiveMAS works with each agent type)
77+
- [ ] Documentation (config examples + usage guides)
78+
- [ ] Issue closed (only after 100% complete)
79+
80+
## Related
81+
82+
- OpenSIN-Code PR: https://github.com/OpenSIN-Code/OpenSIN-Code/pull/1123
83+
- RecursiveMAS Runtime Integration: `opensin-engine/crates/runtime/src/recursive_mas.rs`
84+
- SIN-Zeus RecursiveMAS: `opensin_core/recursive_mas.py`
85+
- Plan File: `docs/plans/plan-a2a-fleet-recursivemas-rollout.md`
86+
87+
---
88+
*CEO mandate: No agent closes before 100% SOTA RecursiveMAS implementation, tests, and docs!*

0 commit comments

Comments
 (0)