cloze-reader / src /aiService.js
milwright's picture
feat: implement batch API processing for both passages
cd16e7b
raw
history blame
11.8 kB
class OpenRouterService {
constructor() {
this.apiUrl = 'https://openrouter.ai/api/v1/chat/completions';
this.apiKey = this.getApiKey();
this.model = 'google/gemma-3-27b-it:free';
}
getApiKey() {
if (typeof process !== 'undefined' && process.env && process.env.OPENROUTER_API_KEY) {
return process.env.OPENROUTER_API_KEY;
}
if (typeof window !== 'undefined' && window.OPENROUTER_API_KEY) {
return window.OPENROUTER_API_KEY;
}
console.warn('No API key found in getApiKey()');
return '';
}
setApiKey(key) {
this.apiKey = key;
}
async generateContextualHint(prompt) {
// Check for API key at runtime
const currentKey = this.getApiKey();
if (currentKey && !this.apiKey) {
this.apiKey = currentKey;
}
if (!this.apiKey) {
return 'API key required for hints';
}
try {
const response = await fetch(this.apiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${this.apiKey}`,
'HTTP-Referer': window.location.origin,
'X-Title': 'Cloze Reader'
},
body: JSON.stringify({
model: this.model,
messages: [{
role: 'system',
content: 'You provide clues for word puzzles. You will be told the target word that players need to guess, but you must NEVER mention, spell, or reveal that word in your response. Follow the EXACT format requested. Be concise and direct about the target word without revealing it. Use plain text only - no bold, italics, asterisks, or markdown formatting. Stick to word limits.'
}, {
role: 'user',
content: prompt
}],
max_tokens: 50,
temperature: 0.6
})
});
if (!response.ok) {
throw new Error(`API request failed: ${response.status}`);
}
const data = await response.json();
// Check if data and choices exist before accessing
if (!data || !data.choices || data.choices.length === 0) {
console.error('Invalid API response structure:', data);
return 'Unable to generate hint at this time';
}
// Check if message content exists
if (!data.choices[0].message || !data.choices[0].message.content) {
console.error('No content in API response');
return 'Unable to generate hint at this time';
}
let content = data.choices[0].message.content.trim();
// Clean up AI response artifacts
content = content
.replace(/^\s*["']|["']\s*$/g, '') // Remove leading/trailing quotes
.replace(/^\s*[:;]+\s*/, '') // Remove leading colons and semicolons
.replace(/\*+/g, '') // Remove asterisks (markdown bold/italic)
.replace(/_+/g, '') // Remove underscores (markdown)
.replace(/#+\s*/g, '') // Remove hash symbols (markdown headers)
.replace(/\s+/g, ' ') // Normalize whitespace
.trim();
return content;
} catch (error) {
console.error('Error generating contextual hint:', error);
return 'Unable to generate hint at this time';
}
}
async selectSignificantWords(passage, count) {
console.log('selectSignificantWords called with count:', count);
// Check for API key at runtime in case it was loaded after initialization
const currentKey = this.getApiKey();
if (currentKey && !this.apiKey) {
this.apiKey = currentKey;
}
console.log('API key available:', !!this.apiKey);
if (!this.apiKey) {
console.error('No API key for word selection');
throw new Error('API key required for word selection');
}
try {
const response = await fetch(this.apiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${this.apiKey}`,
'HTTP-Referer': window.location.origin,
'X-Title': 'Cloze Reader'
},
body: JSON.stringify({
model: this.model,
messages: [{
role: 'system',
content: 'You are a vocabulary selector for educational cloze exercises. Select meaningful, properly-spelled content words that appear exactly as written in the passage.'
}, {
role: 'user',
content: `Select exactly ${count} words from this passage for a cloze exercise.
REQUIREMENTS:
- Choose clear, properly-spelled words (no OCR errors like "andsatires")
- Select meaningful nouns, verbs, or adjectives (4-12 letters)
- Words must appear EXACTLY as written in the passage
- Avoid: function words, archaic terms, proper nouns, technical jargon
- Skip any words that look malformed or concatenated
Return ONLY a JSON array of the selected words.
Passage: "${passage}"`
}],
max_tokens: 100,
temperature: 0.3
})
});
if (!response.ok) {
throw new Error(`API request failed: ${response.status}`);
}
const data = await response.json();
// Check for OpenRouter error response
if (data.error) {
console.error('OpenRouter API error for word selection:', data.error);
throw new Error(`OpenRouter API error: ${data.error.message || JSON.stringify(data.error)}`);
}
// Check if response has expected structure
if (!data.choices || !data.choices[0] || !data.choices[0].message || !data.choices[0].message.content) {
console.error('Invalid word selection API response structure:', data);
throw new Error('API response missing expected content');
}
const content = data.choices[0].message.content.trim();
// Try to parse as JSON array
try {
const words = JSON.parse(content);
if (Array.isArray(words)) {
return words.slice(0, count);
}
} catch (e) {
// If not valid JSON, try to extract words from the response
const matches = content.match(/"([^"]+)"/g);
if (matches) {
return matches.map(m => m.replace(/"/g, '')).slice(0, count);
}
}
throw new Error('Failed to parse AI response');
} catch (error) {
console.error('Error selecting words with AI:', error);
throw error;
}
}
async processBothPassages(passage1, book1, passage2, book2, blanksPerPassage) {
// Process both passages in a single API call to avoid rate limits
const currentKey = this.getApiKey();
if (currentKey && !this.apiKey) {
this.apiKey = currentKey;
}
if (!this.apiKey) {
throw new Error('API key required for passage processing');
}
try {
const response = await fetch(this.apiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${this.apiKey}`,
'HTTP-Referer': window.location.origin,
'X-Title': 'Cloze Reader'
},
body: JSON.stringify({
model: this.model,
messages: [{
role: 'system',
content: 'Process two passages for a cloze reading exercise. For each passage: 1) Select words for blanks, 2) Generate a contextual introduction. Return a JSON object with both passages\' data.'
}, {
role: 'user',
content: `Process these two passages for cloze exercises:
PASSAGE 1:
Title: "${book1.title}" by ${book1.author}
Text: "${passage1}"
Select ${blanksPerPassage} words for blanks.
PASSAGE 2:
Title: "${book2.title}" by ${book2.author}
Text: "${passage2}"
Select ${blanksPerPassage} words for blanks.
For each passage return:
- "words": array of selected words (exactly as they appear)
- "context": one-sentence intro about the book/author
Return as JSON: {"passage1": {...}, "passage2": {...}}`
}],
max_tokens: 500,
temperature: 0.3
})
});
if (!response.ok) {
throw new Error(`API request failed: ${response.status}`);
}
const data = await response.json();
const content = data.choices[0].message.content.trim();
try {
return JSON.parse(content);
} catch (e) {
console.error('Failed to parse batch response:', e);
throw new Error('Invalid API response format');
}
} catch (error) {
console.error('Error processing passages:', error);
throw error;
}
}
async generateContextualization(title, author) {
console.log('generateContextualization called for:', title, 'by', author);
// Check for API key at runtime
const currentKey = this.getApiKey();
if (currentKey && !this.apiKey) {
this.apiKey = currentKey;
}
console.log('API key available for contextualization:', !!this.apiKey);
if (!this.apiKey) {
console.log('No API key, returning fallback contextualization');
return `πŸ“š Practice with classic literature from ${author}'s "${title}"`;
}
try {
const response = await fetch(this.apiUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${this.apiKey}`,
'HTTP-Referer': window.location.origin,
'X-Title': 'Cloze Reader'
},
body: JSON.stringify({
model: this.model,
messages: [{
role: 'system',
content: 'You are a literary expert. Provide exactly 1 short, factual sentence about this classic work. Be accurate and concise. Do not add fictional details or characters.'
}, {
role: 'user',
content: `Write one factual sentence about "${title}" by ${author}. Focus on what type of work it is, when it was written, or its historical significance.`
}],
max_tokens: 80,
temperature: 0.2
})
});
if (!response.ok) {
const errorText = await response.text();
console.error('Contextualization API error:', response.status, errorText);
throw new Error(`API request failed: ${response.status}`);
}
const data = await response.json();
// Check for OpenRouter error response
if (data.error) {
console.error('OpenRouter API error for contextualization:', data.error);
throw new Error(`OpenRouter API error: ${data.error.message || JSON.stringify(data.error)}`);
}
// Check if response has expected structure
if (!data.choices || !data.choices[0] || !data.choices[0].message || !data.choices[0].message.content) {
console.error('Invalid contextualization API response structure:', data);
throw new Error('API response missing expected content');
}
let content = data.choices[0].message.content.trim();
// Clean up AI response artifacts
content = content
.replace(/^\s*["']|["']\s*$/g, '') // Remove leading/trailing quotes
.replace(/^\s*[:;]+\s*/, '') // Remove leading colons and semicolons
.replace(/\*+/g, '') // Remove asterisks (markdown bold/italic)
.replace(/_+/g, '') // Remove underscores (markdown)
.replace(/#+\s*/g, '') // Remove hash symbols (markdown headers)
.replace(/\s+/g, ' ') // Normalize whitespace
.trim();
console.log('Contextualization received:', content);
return content;
} catch (error) {
console.error('Error getting contextualization:', error);
return `πŸ“š Practice with classic literature from ${author}'s "${title}"`;
}
}
}
export { OpenRouterService as AIService };