How light200312/ai_council_minor_project works
AI Council is a full-stack multi-agent discussion platform. Users configure a topic, participating personas, and discussion mode in the client; backend orchestration selects speakers, invokes agent response generation, and returns discussion results and analytics. Separate features support persona management, saved conversations, combat-style debates, mentoring, and domain-specific panels. The README documents tools, memory, and provider routing; source excerpts/index confirm core calls and imports. Some UI and panel internals were not sampled, so their links are limited to documented capabilities or indexed references.
Main entry points: server.js HTTP server · App.jsx Council app · orchestrator.service.js Speaker selection · agentRuntime.service.js Agent response runtime
Components 29
Client experience
- Council app
frontend/src/App.jsx - Session store
frontend/src/store/useAppStore.js - API client
frontend/src/lib/api.js - Discussion analytics
frontend/src/components/LiveAnalytics.jsx - Verdict reports
frontend/src/components/VerdictReportViewer.jsx - Learning panels
frontend/src/components - Client sample data
frontend/src/data/mockData.js
Backend features
- HTTP server
backend/server.js - Authentication
backend/features/auth/auth.controller.js - Persona management
backend/features/agent/agent.controller.js - Orchestration endpoint
backend/features/orchestrator/orchestrator.routes.js - Orchestration handler
backend/features/orchestrator/orchestrator.controller.js - Debate rounds
backend/features/combat/combat.service.js - Conversation history
backend/features/message/message.controller.js - Domain panels
backend/features/panels/panels.service.js
AI runtime
- Persona generation
backend/features/agent/agentCreator.service.js - Speaker selection
backend/features/orchestrator/orchestrator.service.js - Agent response runtime
backend/features/agent/agentRuntime.service.js - Conversation memory
backend/shared/memoryService.js
Persistence and shared state
- Persona catalog
backend/features/agent/agent.model.js - Message records
backend/features/message/message.model.js - Discussion reports
backend/features/message/discussionReport.model.js - Topic memory
backend/shared/topicMemory.model.js - Prebuilt personas
backend/data/preBuildAgents.js
Models and tools
- LLM client
backend/shared/llmClient.js - Model routing
backend/shared/agentModelRegistry.js - Tool execution
backend/tools/tools.js
Other components
- User
- External knowledge
Connections 34
- User → Council app: configures discussion
README.md - Council app → Session store: reads session state
frontend/src/App.jsx - Session store → API client: requests data
frontend/src/store/useAppStore.js - Council app → Discussion analytics: renders analytics
frontend/src/App.jsx - Council app → Verdict reports: renders reports
frontend/src/App.jsx - Council app → Learning panels: offers panel views
frontend/src/App.jsx - API client → HTTP server: calls API
- HTTP server → Authentication: mounts routes
backend/server.js - HTTP server → Persona management: mounts routes
backend/server.js - HTTP server → Orchestration endpoint: mounts routes
backend/server.js - HTTP server → Debate rounds: mounts debate routes
backend/server.js - HTTP server → Conversation history: mounts message routes
backend/server.js - HTTP server → Domain panels: mounts panel routes
backend/server.js - Persona management → Persona catalog: creates and queries
backend/features/agent/agent.controller.js - Persona management → Persona generation: requests drafts
backend/features/agent/agent.controller.js - Orchestration endpoint → Orchestration handler: routes request
backend/features/orchestrator/orchestrator.routes.js - Orchestration handler → Speaker selection: delegates task
backend/features/orchestrator/orchestrator.controller.js - Speaker selection → Agent response runtime: runs selected agent
backend/features/orchestrator/orchestrator.service.js - Speaker selection → LLM client: selects speaker
backend/features/orchestrator/orchestrator.service.js - Speaker selection → Persona catalog: loads candidates
backend/features/orchestrator/orchestrator.service.js - Agent response runtime → LLM client: generates response
backend/features/agent/agentRuntime.service.js - Agent response runtime → Tool execution: uses tools
backend/features/agent/agentRuntime.service.js - Agent response runtime → Conversation memory: uses conversation memory
backend/features/agent/agentRuntime.service.js - Agent response runtime → Model routing: routes persona model
backend/features/agent/agentRuntime.service.js - LLM client → Model routing: resolves local model
backend/shared/llmClient.js - Tool execution → External knowledge: queries sources
README.md - Conversation memory → Topic memory: reads and writes
backend/shared/memoryService.js - Debate rounds → Persona catalog: uses personas
backend/features/combat/combat.service.js - Conversation history → Message records: reads and writes
backend/features/message/message.controller.js - Conversation history → Discussion reports: loads reports
backend/features/message/message.controller.js - Domain panels → Prebuilt personas: uses preset personas
backend/features/panels/panels.service.js - Session store → Client sample data: loads sample data
frontend/src/store/useAppStore.js - Speaker selection → Discussion analytics: returns trace and metrics
README.md - User → Authentication: authenticates