capsule-react README

The project's README from github.com/unicity-aos/capsule-react. As one markdown file: README.md.

astrid-capsule-react

License: MIT OR Apache-2.0 MSRV: 1.94

The ReAct loop coordinator for Astrid OS.

In the OS model, this capsule is the shell. It drives the reasoning-and-action cycle that makes an agent an agent: fetch context, think, act, observe, repeat.

State machine

Idle -> AwaitingIdentity -> AwaitingPromptBuild -> Streaming -> AwaitingTools -> Streaming -> ... -> Idle

The react loop contains no inference logic. It is pure control flow that coordinates five other capsules over the IPC event bus:

  1. Session - fetch conversation history, persist turn results
  2. Identity - build the system prompt from workspace config
  3. Prompt Builder - merge plugin contributions into the final prompt
  4. Provider (e.g. Anthropic) - stream LLM responses
  5. Tool Router - dispatch tool calls and collect results

What it does not do

This capsule does not call LLMs, execute tools, build prompts, or store messages. It orchestrates the capsules that do. Replacing this capsule with a different orchestration strategy (debate, MCTS, chain-of-verification) changes the agent's behaviour without touching any other capsule.

Persistence

Ephemeral per-turn state is stored in the capsule KV store:

This is control flow state, not conversation history. History lives in the session capsule.

Development

rustup target add wasm32-unknown-unknown
cargo build --target wasm32-unknown-unknown --release

License

Dual-licensed under MIT and Apache 2.0.

Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.

capsule-react (unicity-aos/capsule-react)

Searching Database…

Что это такое?Это координатор цикла ReAct для Astrid OS, часть проекта Unicity AOS. Это автомат без собственного состояния, который запускает цикл «получить контекст, подумать, действовать, наблюдать, повторить», и именно этот цикл и делает агента агентом.
Это самостоятельный агент или часть более крупной системы?Это одна «капсула» (модульный компонент) в архитектуре Astrid OS. Её описывают как «оболочку», которая координирует пять других капсул и сама не выполняет никакой работы.
Как подключить это к проекту?Отдельной установки нет: капсула используется внутри системы Astrid OS и общается с остальными капсулами исключительно через шину событий IPC.
От каких других капсул это зависит?Он координирует пять капсул-компаньонов: Session (история), Identity (системный промпт), Prompt Builder (объединяет вклады плагинов), Provider, например Anthropic (передаёт потоковые ответы LLM), и Tool Router (распределяет вызовы инструментов).
Чего эта капсула намеренно не делает?Она никогда не вызывает LLM, не выполняет инструменты, не формирует промпты и не хранит историю диалога сама. Эти задачи относятся к другим капсулам, которыми она управляет.
Что именно представляет собой «капсула» в этой модели ОС?Капсула — это самодостаточный модуль, который общается с другими капсулами только через шину событий IPC. Поэтому любой отдельный элемент, будь то оркестрация, формирование промптов или маршрутизация инструментов, можно заменить независимо от остальных.
Где хранится состояние хода диалога?Временное служебное состояние каждого хода (не история чата) хранится в собственном KV-хранилище капсулы под ключами вида react.turn.{sessionid}. Сама история диалога остаётся в капсуле Session.
Можно ли заменить стратегию ReAct на другую?Да. Поскольку эта капсула содержит только логику оркестрации, её можно заменить другой стратегией, например дебатами, MCTS или chain-of-verification, не меняя при этом остальные капсулы.
Size
0.5 MB
Stars
5K
Age
7mo
Commits · 90 Days