How g9000/animaos-swarm works
AnimaOS-SWARM is a personal AI companion whose primary workflow is a user conversing in the web app, which uses the TypeScript SDK to reach the Rust daemon; the daemon runs agent tasks and returns live events and session history. The repository also documents memory, connected tools, delegated helpers, approvals, workspace management, and scheduled jobs as product capabilities. Several links below rely on README statements or the source index; unsampled implementation details are represented at subsystem level rather than inferred as specific calls.
Main entry points: app.rs Rust Daemon · engine.rs Agent Runtime Core · useLiveSession.ts Live Session · ViewHarness.tsx Companion Web
Components 17
Companion UI
- Companion Web
apps/web/src/ViewHarness.tsx - Live Session
apps/web/src/hooks/useLiveSession.ts
Client Boundary
- TypeScript SDK
packages/sdk/src/client.ts
Daemon Runtime
- Rust Daemon
hosts/rust-daemon/src/app.rs - HTTP Routes
hosts/rust-daemon/src/routes/http.rs - Agent Runs
hosts/rust-daemon/src/agent_runs.rs - Agent Runtime Core
packages/core-rust/crates/anima-core/src/engine.rs
Agent Capabilities
- Model Adapters
packages/core-rust/crates/anima-model-adapters/src/adapter.rs - Agent Tools
hosts/rust-daemon/src/tools.rs - Workspace Memory
packages/core-rust/crates/anima-memory/src/memory_manager.rs - Delegated Helpers
packages/core-rust/crates/anima-swarm/src/coordinator.rs - Connected Services
hosts/rust-daemon/src/connectors/runtime.rs - Approval Gates
hosts/rust-daemon/src/approvals/gate.rs - Scheduled Jobs
hosts/rust-daemon/src/jobs.rs
State and History
- Session History
hosts/rust-daemon/src/history/mod.rs - Daemon State
hosts/rust-daemon/src/state.rs
Other components
- Companion User
Connections 17
- Companion User → Companion Web: starts conversation
README.md - Companion Web → Live Session: opens session
- Live Session → TypeScript SDK: requests and subscribes
apps/web/src/hooks/useLiveSession.ts - TypeScript SDK → Rust Daemon: HTTP and SSE
README.md - Rust Daemon → HTTP Routes: routes requests
hosts/rust-daemon/src/app.rs - Rust Daemon → Agent Runs: hosts run service
hosts/rust-daemon/src/app.rs - Agent Runs → Agent Runtime Core: executes tasks
- Agent Runtime Core → Model Adapters: requests inference
- Agent Runtime Core → Agent Tools: invokes tools
- Agent Runtime Core → Workspace Memory: uses memory
- Agent Runtime Core → Delegated Helpers: delegates helpers
- Rust Daemon → Connected Services: hosts integrations
README.md - Rust Daemon → Approval Gates: enforces approvals
- Rust Daemon → Scheduled Jobs: runs scheduled work
hosts/rust-daemon/src/app.rs - Rust Daemon → Daemon State: maintains state
hosts/rust-daemon/src/app.rs - Daemon State → Session History: persists messages and runs
hosts/rust-daemon/src/history/mod.rs - Session History → Live Session: serves session history