How pathwiseee/pathwiseagenticassistant works
Pathwise is a learning assistant that turns a learner’s technology-learning request into a researched, reviewed, interactive lesson, then answers follow-up questions grounded in that lesson. The principal flow runs through chat intake, research, lesson compilation, and persistence; tutoring is the follow-up branch. The graph also shows the web research and lesson-review stages, safety gates, and the Gradio presentation layer. Evidence is limited to the supplied excerpts and SOURCE INDEX; unsampled UI wiring and other unshown connections are omitted or marked unverified.
Main entry points: research_manager.py Research manager · pathwiseWorkflow.py Lesson workflow · app.py Gradio app · chat_service.py Chat service
Components 25
Learner experience
- Gradio app
src/pathwiseagenticassistant/ui/app.py - Chat service
src/pathwiseagenticassistant/chat/chat_service.py - Request intake
src/pathwiseagenticassistant/agents/front_door/intake_agent.py - Lesson tutor
src/pathwiseagenticassistant/agents/front_door/tutor_agent.py - Help agent
src/pathwiseagenticassistant/agents/front_door/help_agent.py - Lesson renderer
src/pathwiseagenticassistant/ui/renderer.py - UI components
src/pathwiseagenticassistant/ui/components.py
Research
- Research manager
src/pathwiseagenticassistant/agents/research/research_manager.py - Topic planning
src/pathwiseagenticassistant/agents/research/topic_planning_agent.py - Web search
src/pathwiseagenticassistant/tools/web_search_agent.py - Relevance judging
src/pathwiseagenticassistant/agents/research/relevance_judge.py - Source summaries
src/pathwiseagenticassistant/tools/summarizer.py - Gap analysis
src/pathwiseagenticassistant/agents/research/critic_agent.py
Lesson compilation
- Lesson workflow
src/pathwiseagenticassistant/agents/pathwiseWorkflow.py - Compilation orchestrator
src/pathwiseagenticassistant/agents/compilation/compilation_orchestrator.py - Lesson planning
src/pathwiseagenticassistant/agents/compilation/lesson_planning_agent.py - Plan review
src/pathwiseagenticassistant/agents/compilation/lesson_reviewer_agent.py - Lesson writing
src/pathwiseagenticassistant/agents/compilation/lesson_writing_agent.py - Page verification
src/pathwiseagenticassistant/agents/compilation/page_verifier_agent.py - Lesson structure
src/pathwiseagenticassistant/agents/compilation/ui_component.py
Shared services
- Link verification
src/pathwiseagenticassistant/tools/link_verifier.py - Safety guardrails
src/pathwiseagenticassistant/guardrails.py - Chat and lesson store
src/pathwiseagenticassistant/storage/db.py - Domain schemas
src/pathwiseagenticassistant/schemas.py
Other components
- Learner
Connections 29
- Learner → Gradio app: uses
- Gradio app → Chat service: dispatches messages
src/pathwiseagenticassistant/ui/app.py - Gradio app → Lesson renderer: renders lessons
src/pathwiseagenticassistant/ui/app.py - Gradio app → Help agent: requests help
src/pathwiseagenticassistant/ui/app.py - Gradio app → Chat and lesson store: loads and saves
src/pathwiseagenticassistant/ui/app.py - Chat service → Request intake: classifies requests
src/pathwiseagenticassistant/chat/chat_service.py - Chat service → Lesson tutor: answers follow-ups
src/pathwiseagenticassistant/chat/chat_service.py - Chat service → Lesson workflow: starts lesson workflow
src/pathwiseagenticassistant/chat/chat_service.py - Chat service → Chat and lesson store: reads and attaches
src/pathwiseagenticassistant/chat/chat_service.py - Request intake → Safety guardrails: checks input
src/pathwiseagenticassistant/agents/front_door/intake_agent.py - Lesson tutor → Safety guardrails: checks answers
src/pathwiseagenticassistant/agents/front_door/tutor_agent.py - Lesson workflow → Research manager: requests research
src/pathwiseagenticassistant/agents/pathwiseWorkflow.py - Lesson workflow → Compilation orchestrator: streams compilation
src/pathwiseagenticassistant/agents/pathwiseWorkflow.py - Lesson workflow → Web search: provides search agent
src/pathwiseagenticassistant/agents/pathwiseWorkflow.py - Lesson workflow → Source summaries: provides summarizer
src/pathwiseagenticassistant/agents/pathwiseWorkflow.py - Research manager → Topic planning: plans queries
src/pathwiseagenticassistant/agents/research/research_manager.py - Research manager → Web search: searches queries
src/pathwiseagenticassistant/agents/research/research_manager.py - Research manager → Relevance judging: filters articles
src/pathwiseagenticassistant/agents/research/research_manager.py - Research manager → Source summaries: summarizes sources
src/pathwiseagenticassistant/agents/research/research_manager.py - Research manager → Gap analysis: finds topic gaps
src/pathwiseagenticassistant/agents/research/research_manager.py - Compilation orchestrator → Lesson planning: drafts plan
src/pathwiseagenticassistant/agents/compilation/compilation_orchestrator.py - Compilation orchestrator → Plan review: reviews plan
src/pathwiseagenticassistant/agents/compilation/compilation_orchestrator.py - Compilation orchestrator → Lesson writing: writes lesson
src/pathwiseagenticassistant/agents/compilation/compilation_orchestrator.py - Compilation orchestrator → Page verification: verifies page
src/pathwiseagenticassistant/agents/compilation/compilation_orchestrator.py - Plan review → Link verification: verifies links
src/pathwiseagenticassistant/agents/compilation/lesson_reviewer_agent.py - Lesson writing → Lesson structure: builds components
src/pathwiseagenticassistant/agents/compilation/lesson_writing_agent.py - Page verification → Lesson structure: checks structure
src/pathwiseagenticassistant/agents/compilation/page_verifier_agent.py - Lesson renderer → UI components: uses components
src/pathwiseagenticassistant/ui/renderer.py - Lesson renderer → Lesson workflow: starts lesson creation
src/pathwiseagenticassistant/ui/renderer.py