How yanzai-4/yuzu works
Yuzu is a multi-agent workplace where people chat with role- and permission-scoped agents, coordinate work through tickets and task lists, and observe live activity. The principal workflow begins with a room message, passes through agent intake and decision-making, and may produce a reply or tool action; agent memory and supervision support that work. The README documents the major cognition, safety, behavior-review, and tool-calling capabilities, but most of their wiring was not sampled, so the graph shows those as distinct stages without asserting undocumented call links.
Main entry points: ChatService.java Room chat · impl Agent tools · llm Model gateway · realtime Realtime event stream
Components 23
Workplace
- Room chat
backend/src/main/java/ai/yuzu/chat/ChatService.java - Questions and approvals
backend/src/main/java/ai/yuzu/card/CardService.java - Rooms and membership
backend/src/main/java/ai/yuzu/room
Agent runtime
- Agent profiles
backend/src/main/java/ai/yuzu/agent/AgentService.java - Agent runtime
backend/src/main/java/ai/yuzu/agent/runtime
Agent intelligence
- Message intake
backend/src/main/java/ai/yuzu/internal/intake - Chat triage
backend/src/main/java/ai/yuzu/external/chat - Safety review
backend/src/main/java/ai/yuzu/external/safety - Planning and cognition
backend/src/main/java/ai/yuzu/internal - Main consciousness
backend/src/main/java/ai/yuzu/internal/consciousness - Subconscious supervision
backend/src/main/java/ai/yuzu/internal/subconscious - Agent memory
backend/src/main/java/ai/yuzu/internal/memory - Behavior review
backend/src/main/java/ai/yuzu/external/behavior
Work coordination
- Tickets and task lists
backend/src/main/java/ai/yuzu/task - Simulated business
backend/src/main/java/ai/yuzu/sim
Operations and integrations
- Tool calling
backend/src/main/java/ai/yuzu/external/toolcall - Agent tools
backend/src/main/java/ai/yuzu/tool/impl - Model gateway
backend/src/main/java/ai/yuzu/llm - Model settings
backend/src/main/java/ai/yuzu/settings - Live status and traces
backend/src/main/java/ai/yuzu/monitor - Realtime event stream
backend/src/main/java/ai/yuzu/realtime
Other components
- Room participant
- OpenAI-compatible provider
Connections 16
- Room participant → Room chat: posts messages
- Room chat → Rooms and membership: checks membership
- Room chat → Message intake: dispatches messages
- Message intake → Chat triage: routes stimuli
- Room participant → Questions and approvals: answers cards
- Agent runtime → Agent profiles: loads profiles
- Main consciousness → Model gateway: requests model output
- Model gateway → OpenAI-compatible provider: sends completions
- Main consciousness → Tool calling: submits actions
- Tool calling → Agent tools: dispatches calls
- Agent tools → Tickets and task lists: manages work
- Agent tools → Simulated business: uses simulations
- Room chat → Realtime event stream: publishes chat events
- Live status and traces → Realtime event stream: publishes status events
- Realtime event stream → Room participant: streams updates
- Model settings → Model gateway: configures model access