Contextual Commentary

# From utils.py:34-68
def generate_contextual_commentary(query: str, verse: dict) -> str:
    """
    Generate commentary that specifically addresses the user's question.

    Args:
        query: The user's original question
        verse: Dict with chapter, verse, translation, and optionally full_commentary/summarized_commentary

    Returns:
        Contextual commentary string tailored to the user's question
    """
    # Get available commentary for context
    commentary_context = verse.get("full_commentary") or verse.get("summarized_commentary") or ""
    if commentary_context:
        commentary_context = f"\n\nTraditional commentary for context:\n{commentary_context[:1500]}"

    prompt = f"""The user asked: "{query}"

The most relevant verse from the Bhagavad Gita is Chapter {verse['chapter']}, Verse {verse['verse']}:
"{verse['translation']}"{commentary_context}

Write a 2-3 paragraph response that:
1. Explains how this verse directly addresses their situation or question
2. Draws practical wisdom they can apply to their life
3. Maintains a warm, thoughtful tone without being preachy

Vary your opening - don't start with "This verse...". Keep it concise but meaningful."""

    response = openai_client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": prompt}],
        max_tokens=500,
        temperature=0.7,
    )
    return response.choices[0].message.content.strip()

# From utils.py:50-60
prompt = f"""The user asked: "{query}"

The most relevant verse from the Bhagavad Gita is Chapter {verse['chapter']}, Verse {verse['verse']}:
"{verse['translation']}"{commentary_context}

Write a 2-3 paragraph response that:
1. Explains how this verse directly addresses their situation or question
2. Draws practical wisdom they can apply to their life
3. Maintains a warm, thoughtful tone without being preachy

Vary your opening - don't start with "This verse...". Keep it concise but meaningful."""

# From utils.py:62-67
response = openai_client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=500,
    temperature=0.7,
)

max_tokens=500

# From main.py:115-143
@app.post("/api/query", response_model=dict)
@limiter.limit("30/minute")
async def query_gita(request: Request, query: Query) -> dict:
    """
    Query the Gita with the provided query string(s).
    Returns verse with contextual commentary tailored to the user's question.
    """
    try:
        from model import match
        from utils import generate_contextual_commentary

        result = match(query.query)
        if not result:
            raise HTTPException(status_code=404, detail="No matches found")

        # Generate contextual commentary that addresses the user's specific question
        try:
            contextual = generate_contextual_commentary(query.query, result)
            result["summarized_commentary"] = contextual
        except Exception as e:
            # Fall back to pre-computed summary if OpenAI fails
            logging.warning(f"Contextual commentary failed, using fallback: {e}")

        return {"status": "success", "data": result}
    except HTTPException:
        raise
    except Exception as e:
        logging.error(f"Query error: {type(e).__name__}: {e}")
        raise HTTPException(status_code=500, detail="Internal Server Error")

# From main.py:131-136
try:
    contextual = generate_contextual_commentary(query.query, result)
    result["summarized_commentary"] = contextual
except Exception as e:
    # Fall back to pre-computed summary if OpenAI fails
    logging.warning(f"Contextual commentary failed, using fallback: {e}")

# From clients.py:20-21
# OpenAI client with timeout
openai_client = OpenAI(api_key=GPT_KEY, timeout=30.0)

# From utils.py:12-31
def summarize(commentary_text: str) -> str:
    """Generate a summary of the commentary using GPT-4o-mini."""
    if not commentary_text or len(commentary_text) < 10:
        return ""

    response = openai_client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {
                "role": "system",
                "content": "You are a helpful assistant that summarizes text concisely but completely.",
            },
            {
                "role": "user",
                "content": f"Summarize the following commentary: {commentary_text}",
            },
        ],
        max_tokens=500,
    )
    return response.choices[0].message.content.strip()

# From main.py:131-136
try:
    contextual = generate_contextual_commentary(query.query, result)
    result["summarized_commentary"] = contextual
except Exception as e:
    # Fall back to pre-computed summary if OpenAI fails
    logging.warning(f"Contextual commentary failed, using fallback: {e}")

# From utils.py:45-48
# Get available commentary for context
commentary_context = verse.get("full_commentary") or verse.get("summarized_commentary") or ""
if commentary_context:
    commentary_context = f"\n\nTraditional commentary for context:\n{commentary_context[:1500]}"