#!/usr/bin/env python3 import os import json import logging import re from typing import Dict, List, Optional from pathlib import Path from flask import Flask, request, jsonify from flask_cors import CORS from dotenv import load_dotenv from langchain_groq import ChatGroq from typing_extensions import TypedDict # --- Type Definitions --- class AssistantState(TypedDict): conversationSummary: str language: str mode: str # "teacher" or "student" # --- Logging --- logging.basicConfig(level=logging.INFO, format="%(asctime)s [%(levelname)s] %(message)s") logger = logging.getLogger("code-assistant") # --- Load environment --- load_dotenv() GROQ_API_KEY = os.getenv("GROQ_API_KEY") if not GROQ_API_KEY: logger.error("GROQ_API_KEY not set in environment") raise RuntimeError("GROQ_API_KEY not set in environment") # --- Flask app setup --- BASE_DIR = Path(__file__).resolve().parent static_folder = BASE_DIR / "static" app = Flask(__name__, static_folder=str(static_folder), static_url_path="/static") CORS(app) # --- LLM setup --- llm = ChatGroq( model=os.getenv("LLM_MODEL", "meta-llama/llama-4-scout-17b-16e-instruct"), temperature=0.1, max_tokens=2048, api_key=GROQ_API_KEY, ) # --- Helper functions --- def detect_language_from_text(text: str) -> Optional[str]: if not text: return None lower = text.lower() known_languages = ["python", "javascript", "java", "c++", "c#", "go", "ruby", "php", "typescript", "swift"] lang_match = re.search(r'\b(in|using|for)\s+(' + '|'.join(known_languages) + r')\b', lower) if lang_match: return lang_match.group(2).capitalize() return None def update_summary(chat_history: List[Dict[str, str]]) -> str: """ Simple heuristic summary: last 6 messages concatenated. Replace with your own summarization chain if desired. """ recent_msgs = chat_history[-6:] summary = " | ".join(f"{m['role']}: {m['content'][:50].replace('\n',' ')}" for m in recent_msgs) return summary def build_system_prompt(language: str, conversation_summary: str, mode: str) -> str: """ Build system prompt dynamically based on mode. """ base = f"You are a helpful programming assistant. Current language: {language}. Conversation summary: {conversation_summary}\n\n" if mode == "student": base += ( "You are in STUDENT MODE: Your goal is to engage the user in problem-solving and learning. " "Do NOT give complete answers or full code. Instead:\n" " - Ask guiding questions to make the user think.\n" " - Give hints, small examples, or pseudocode to help the user discover the solution.\n" " - Encourage step-by-step problem solving and curiosity.\n" " - Only provide full solutions as a last resort if the user is completely stuck." ) else: # teacher mode default base += ( "You are in TEACHER MODE: Provide detailed suggestions, structured explanations, and full code examples. " "Explain reasoning clearly and comprehensively." ) return base # --- Routes --- @app.route("/", methods=["GET"]) def serve_frontend(): try: return app.send_static_file("frontend.html") except Exception: return "