File size: 8,687 Bytes
2380f6f
 
 
 
 
 
 
 
 
 
 
 
 
7218dd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2380f6f
 
 
7218dd0
2380f6f
 
 
7218dd0
2380f6f
 
 
 
 
7218dd0
2380f6f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7218dd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2380f6f
 
 
7218dd0
2380f6f
 
 
 
 
7218dd0
2380f6f
 
 
 
 
 
 
 
 
 
 
7218dd0
2380f6f
 
 
 
 
 
 
 
 
7218dd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2380f6f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
"""Service for topic extraction from text using LangChain Groq"""

import logging
from typing import Optional, List
from langchain_core.messages import HumanMessage, SystemMessage
from langchain_groq import ChatGroq
from pydantic import BaseModel, Field
from langsmith import traceable

from config import GROQ_API_KEY

logger = logging.getLogger(__name__)

# Predefined topics list
PREDEFINED_TOPICS = [
    "Assisted suicide should be a criminal offence",
    "We should abolish intellectual property rights",
    "Homeschooling should be banned",
    "The vow of celibacy should be abandoned",
    "We should legalize prostitution",
    "We should ban private military companies",
    "We should abolish capital punishment",
    "Foster care brings more harm than good",
    "Routine child vaccinations should be mandatory",
    "We should abolish the three-strikes laws",
    "We should subsidize student loans",
    "We should end the use of economic sanctions",
    "We should end mandatory retirement",
    "We should close Guantanamo Bay detention camp",
    "We should subsidize space exploration",
    "We should abandon the use of school uniform",
    "The use of public defenders should be mandatory",
    "We should adopt an austerity regime",
    "Social media platforms should be regulated by the government",
    "We should ban human cloning",
    "We should adopt atheism",
    "We should introduce compulsory voting",
    "We should adopt libertarianism",
    "We should abolish the right to keep and bear arms",
    "We should legalize sex selection",
    "We should abandon marriage",
    "Entrapment should be legalized",
    "We should end affirmative action",
    "We should prohibit women in combat",
    "We should adopt a zero-tolerance policy in schools",
    "We should subsidize vocational education",
    "We should ban the use of child actors",
    "We should legalize cannabis",
    "We should ban cosmetic surgery",
    "We should end racial profiling",
    "We should prohibit flag burning",
    "The USA is a good country to live in",
    "We should ban algorithmic trading",
    "We should fight for the abolition of nuclear weapons",
    "We should fight urbanization",
    "We should subsidize journalism",
]


class TopicOutput(BaseModel):
    """Pydantic schema for topic extraction output"""
    topic: str = Field(..., description="The selected topic from the predefined list that most closely matches the input text")


class TopicService:
    """Service for extracting topics from text arguments by matching to predefined topics"""
    
    def __init__(self):
        self.llm = None
        self.model_name = "openai/gpt-oss-safeguard-20b"  # Default model
        self.initialized = False
        self.predefined_topics = PREDEFINED_TOPICS
        
    def initialize(self, model_name: Optional[str] = None):
        """Initialize the Groq LLM with structured output"""
        if self.initialized:
            logger.info("Topic service already initialized")
            return
            
        if not GROQ_API_KEY:
            raise ValueError("GROQ_API_KEY not found in environment variables")
        
        if model_name:
            self.model_name = model_name
            
        try:
            logger.info(f"Initializing topic extraction service with model: {self.model_name}")
            
            llm = ChatGroq(
                model=self.model_name,
                api_key=GROQ_API_KEY,
                temperature=0.0,
                max_tokens=512,
            )
            
            # Bind structured output directly to the model
            self.llm = llm.with_structured_output(TopicOutput)
            self.initialized = True
            
            logger.info("✓ Topic extraction service initialized successfully")
            
        except Exception as e:
            logger.error(f"Error initializing topic service: {str(e)}")
            raise RuntimeError(f"Failed to initialize topic service: {str(e)}")
    
    def _get_system_message(self) -> str:
        """Generate system message with predefined topics list"""
        topics_list = "\n".join([f"{i+1}. {topic}" for i, topic in enumerate(self.predefined_topics)])
        
        return f"""You are a topic classification model. Your task is to select the MOST SIMILAR topic from the predefined list below that best matches the user's input text.

IMPORTANT: You MUST return EXACTLY one of the predefined topics below. Do not create new topics or modify the wording.

Predefined Topics:
{topics_list}

Instructions:
1. Analyze the user's input text carefully
2. Identify the main theme, subject, or argument being discussed
3. Find the topic from the predefined list that is MOST SIMILAR to the input text
4. Return the EXACT topic text as it appears in the list above

Examples:
- Input: "I think we need to make assisted suicide illegal and punishable by law."
  Output: "Assisted suicide should be a criminal offence"

- Input: "Student debt is crushing young people. The government should help pay for college."
  Output: "We should subsidize student loans"

- Input: "Marijuana should be legal for adults to use recreationally."
  Output: "We should legalize cannabis"
"""
    
    @traceable(name="extract_topic")
    def extract_topic(self, text: str) -> str:
        """
        Extract a topic from the given text/argument by matching to predefined topics
        
        Args:
            text: The input text/argument to extract topic from
            
        Returns:
            The extracted topic string (must be one of the predefined topics)
        """
        if not self.initialized:
            self.initialize()
        
        if not text or not isinstance(text, str):
            raise ValueError("Text must be a non-empty string")
        
        text = text.strip()
        if len(text) == 0:
            raise ValueError("Text cannot be empty")
        
        system_message = self._get_system_message()
        
        try:
            result = self.llm.invoke(
                [
                    SystemMessage(content=system_message),
                    HumanMessage(content=text),
                ]
            )
            
            selected_topic = result.topic.strip()
            
            # Validate that the returned topic is in the predefined list
            if selected_topic not in self.predefined_topics:
                logger.warning(
                    f"LLM returned topic not in predefined list: '{selected_topic}'. "
                    f"Attempting to find closest match..."
                )
                # Try to find the closest match (case-insensitive)
                selected_topic_lower = selected_topic.lower()
                for predefined_topic in self.predefined_topics:
                    if predefined_topic.lower() == selected_topic_lower:
                        selected_topic = predefined_topic
                        logger.info(f"Found case-insensitive match: '{selected_topic}'")
                        break
                else:
                    # If still no match, log error and raise
                    logger.error(
                        f"Could not match returned topic '{selected_topic}' to any predefined topic. "
                        f"Available topics: {self.predefined_topics[:3]}..."
                    )
                    raise ValueError(
                        f"Returned topic '{selected_topic}' is not in the predefined topics list"
                    )
            
            return selected_topic
            
        except Exception as e:
            logger.error(f"Error extracting topic: {str(e)}")
            raise RuntimeError(f"Topic extraction failed: {str(e)}")
    
    def batch_extract_topics(self, texts: List[str]) -> List[str]:
        """
        Extract topics from multiple texts
        
        Args:
            texts: List of input texts/arguments
            
        Returns:
            List of extracted topics
        """
        if not self.initialized:
            self.initialize()
        
        if not texts or not isinstance(texts, list):
            raise ValueError("Texts must be a non-empty list")
        
        results = []
        for text in texts:
            try:
                topic = self.extract_topic(text)
                results.append(topic)
            except Exception as e:
                logger.error(f"Error extracting topic for text '{text[:50]}...': {str(e)}")
                results.append(None)  # Or raise, depending on desired behavior
        
        return results


# Initialize singleton instance
topic_service = TopicService()