How starrfree/solver-agent works
Solver Agent turns a user’s technical problem into an auditable solution: the backend coordinates solver and specialist agents, records typed steps in a persistent ledger, and verifies the result; the Angular UI streams progress and exposes the proof, artifacts, and conversation controls. Separate branches support proof narration, side-talk, exports, and usage tracking. The graph reflects documented capabilities and the sampled wiring; several tool implementations and route handlers were not excerpted, so those links are omitted or marked unverified.
Main entry points: solverOrchestrator.ts Solver orchestrator · index.ts HTTP application · conversations.ts Conversation routes · ledgerRepo.ts Ledger repository
Components 25
User interface
- Conversation workspace
frontend/src/app/app.component.ts - Conversation state
frontend/src/app/core/state/conversation-store.service.ts - API and stream clients
frontend/src/app/core/api/api.service.ts - Ledger and proof views
frontend/src/app/features/content/content.component.ts - Artifact panel
frontend/src/app/features/artifacts/artifacts-panel.component.ts
Backend API
- HTTP application
backend/src/index.ts - Conversation routes
backend/src/routes/conversations.ts - Message routes
backend/src/routes/messages.ts - Live event route
backend/src/routes/stream.ts - Export routes
backend/src/routes/export.ts
Solver workflow
- Solver orchestrator
backend/src/services/solverOrchestrator.ts - Main solver agent
backend/src/agents/mainSolverAgent.ts - Specialist agents and tools
backend/src/agents - Provider facade
backend/src/agents/llmClient.ts - Computation sandbox
backend/src/python/runner.ts - Proof narrator
backend/src/services/narrativeService.ts
Persistence and events
- Ledger repository
backend/src/repositories/ledgerRepo.ts - Conversation repository
backend/src/repositories/conversationRepo.ts - MongoDB
backend/src/db/mongo.ts - Event bus
backend/src/events/eventBus.ts
Supporting capabilities
- Side-talk service
backend/src/routes/sideTalk.ts - Export rendering
backend/src/export/buildExport.ts - Usage tracking
backend/src/agents/usageTracker.ts
Other components
- Researcher
- LLM providers
Connections 30
- Researcher → Conversation workspace: poses problem
README.md - Conversation workspace → Conversation state: loads conversations
frontend/src/app/app.component.ts - Conversation state → API and stream clients: calls API
frontend/src/app/core/state/conversation-store.service.ts - API and stream clients → HTTP application: sends requests
- HTTP application → Conversation routes: routes requests
backend/src/index.ts - HTTP application → Message routes: routes requests
backend/src/index.ts - HTTP application → Live event route: routes requests
backend/src/index.ts - HTTP application → Export routes: routes requests
backend/src/index.ts - Conversation routes → Solver orchestrator: starts runs
backend/src/routes/conversations.ts - Conversation routes → Conversation repository: reads and writes
backend/src/routes/conversations.ts - Conversation routes → Ledger repository: reads and writes
backend/src/routes/conversations.ts - Message routes → Solver orchestrator: dispatches run
- Solver orchestrator → Main solver agent: runs solver turn
backend/src/services/solverOrchestrator.ts - Solver orchestrator → Ledger repository: updates ledger
backend/src/services/solverOrchestrator.ts - Solver orchestrator → Conversation repository: loads conversation
backend/src/services/solverOrchestrator.ts - Main solver agent → Specialist agents and tools: delegates computation
- Specialist agents and tools → Computation sandbox: runs code
- Main solver agent → Provider facade: requests responses
- Provider facade → LLM providers: dispatches calls
backend/src/agents/llmClient.ts - Solver orchestrator → Event bus: emits progress
backend/src/services/solverOrchestrator.ts - Proof narrator → Ledger repository: reads and saves proof
backend/src/services/narrativeService.ts - Proof narrator → Event bus: emits narrative event
backend/src/services/narrativeService.ts - Ledger repository → MongoDB: persists entries
backend/src/repositories/ledgerRepo.ts - Conversation repository → MongoDB: persists conversations
backend/src/repositories/conversationRepo.ts - Live event route → Event bus: streams events
- Conversation state → Ledger and proof views: supplies view state
- Ledger and proof views → Artifact panel: opens artifacts
- Export routes → Export rendering: builds exports
- Researcher → Side-talk service: interrogates solution
- Provider facade → Usage tracking: records call usage
backend/src/agents/llmClient.ts