incremnt 0.1.13 → 0.1.16

package/src/openrouter.js

@@ -1,11 +1,83 @@
-const DEFAULT_MODEL = 'meta-llama/llama-3.1-8b-instruct:free';
-const DEFAULT_TIMEOUT_MS = 15_000;
+const SUMMARY_MODEL_CHAIN = [
+  'deepseek/deepseek-v3.2-20251201',
+  'anthropic/claude-3.5-haiku'
+];
+const ASK_MODEL_CHAIN = [
+  'anthropic/claude-3.5-haiku',
+  'deepseek/deepseek-v3.2-20251201'
+];
+const TIMEOUT_PER_MODEL_MS = 12_000;
+const ASK_TIMEOUT_MS = 8_000;
 const DEFAULT_MAX_TOKENS = 500;
 
-const CYCLE_SUMMARY_PROMPT = `You are a strength coach reviewing a trainee's completed training cycle (typically one week). Write 3-4 short paragraphs separated by blank lines.
+async function callOpenRouter(messages, { apiKey, models, temperature, maxTokens, timeoutMs }) {
+  const chain = models ?? SUMMARY_MODEL_CHAIN;
+  const timeout = timeoutMs ?? TIMEOUT_PER_MODEL_MS;
+  const errors = [];
+
+  const startTotal = Date.now();
+
+  for (const model of chain) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    const startModel = Date.now();
+
+    try {
+      const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${apiKey}`,
+          'Content-Type': 'application/json',
+          'HTTP-Referer': 'https://incremnt.app',
+          'X-Title': 'incremnt'
+        },
+        body: JSON.stringify({
+          model,
+          messages,
+          max_tokens: maxTokens ?? DEFAULT_MAX_TOKENS,
+          temperature: temperature ?? 0.5
+        }),
+        signal: controller.signal
+      });
+
+      if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`OpenRouter API error ${response.status}: ${text}`);
+      }
+
+      const data = await response.json();
+      const content = data.choices?.[0]?.message?.content;
+      if (!content) {
+        throw new Error('No content in OpenRouter response');
+      }
+
+      return {
+        text: content.trim(),
+        model,
+        fallback: model !== chain[0],
+        durationMs: Date.now() - startTotal,
+        errors: errors.length > 0 ? errors : undefined
+      };
+    } catch (err) {
+      errors.push({ model, error: err.message, durationMs: Date.now() - startModel });
+      console.error(`OpenRouter ${model} failed (${Date.now() - startModel}ms): ${err.message}`);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  const err = new Error(`All models failed: ${errors.map((e) => `${e.model}: ${e.error}`).join('; ')}`);
+  err.modelErrors = errors;
+  err.durationMs = Date.now() - startTotal;
+  throw err;
+}
+
+export const CYCLE_SUMMARY_PROMPT = `You are a strength coach reviewing a trainee's completed training cycle (typically one week). Write 3-4 short paragraphs separated by blank lines.
 
 Your job is to give a cycle-level review — not a session-by-session recap. The app already shows set completion rate, individual session breakdowns, and deload adjustments — do NOT repeat any of that. Synthesize across the cycle.
 
+The data tells the story — your job is to interpret it honestly, not to make the trainee feel good.
+
 Cover these in order of relevance (skip any that don't apply):
 1. Overall cycle assessment: was this a build/deload/peak week? Did volume and intensity match the intent? If it was a deload, don't flag low numbers as a problem.
 2. Progression commentary: the app made auto-progression decisions listed below. Comment on whether they look right given the data.
@@ -13,61 +85,24 @@ Cover these in order of relevance (skip any that don't apply):
 4. Goal progress: if the trainee has strength goals, comment on trajectory.
 5. One concrete thing to watch or change next cycle. Be specific.
 
-Rules:
-- Only state what the data shows. Never claim how something "felt."
-- Reference specific exercises, weights, and reps. Use numbers, not vague praise.
-- If there are PRs, mention them matter-of-factly. Do not celebrate or inflate them.
-- If exercises were swapped from the plan, note the pattern and ask about it if recurring.
-- Write like a training partner looking at a logbook, not a motivational coach. Short sentences, no filler, no cheerleading. Questions are good.
-- Never use words like: impressive, crushed, solid, demonstrating, significant, incredible, fantastic, highlighting, smooth, controlled.
-- Never use -ing clauses that add fake depth.
-- No bullet points or lists.`;
+Only state what the data shows. Never claim how something "felt." Reference specific exercises, weights, and reps — use numbers, not vague descriptions. If there are PRs, mention them matter-of-factly. If exercises were swapped from the plan, note the pattern and ask about it if recurring. Write like a training partner looking at a logbook. Short sentences, no filler, no cheerleading. Questions are good.
 
-export async function generateCoachingSummary(cycleContext, { apiKey, model, timeoutMs } = {}) {
-  const resolvedModel = model || DEFAULT_MODEL;
-  const resolvedTimeout = timeoutMs || DEFAULT_TIMEOUT_MS;
-
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), resolvedTimeout);
-
-  try {
-    const userContent = formatCycleContext(cycleContext);
-
-    const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${apiKey}`,
-        'Content-Type': 'application/json',
-        'HTTP-Referer': 'https://incremnt.app',
-        'X-Title': 'incremnt'
-      },
-      body: JSON.stringify({
-        model: resolvedModel,
-        messages: [
-          { role: 'system', content: CYCLE_SUMMARY_PROMPT },
-          { role: 'user', content: userContent }
-        ],
-        max_tokens: DEFAULT_MAX_TOKENS,
-        temperature: 0.7
-      }),
-      signal: controller.signal
-    });
-
-    if (!response.ok) {
-      const text = await response.text().catch(() => '');
-      throw new Error(`OpenRouter API error ${response.status}: ${text}`);
-    }
+If you catch yourself writing something that sounds like a performance review or a fitness influencer post, rewrite it. No -ing clauses that add fake depth. No bullet points or lists.`;
 
-    const data = await response.json();
-    const content = data.choices?.[0]?.message?.content;
-    if (!content) {
-      throw new Error('No content in OpenRouter response');
+export async function generateCoachingSummary(cycleContext, { apiKey, model, timeoutMs } = {}) {
+  const userContent = formatCycleContext(cycleContext);
+  return callOpenRouter(
+    [
+      { role: 'system', content: CYCLE_SUMMARY_PROMPT },
+      { role: 'user', content: userContent }
+    ],
+    {
+      apiKey,
+      models: model ? [model] : SUMMARY_MODEL_CHAIN,
+      temperature: 0.5,
+      timeoutMs
     }
-
-    return content.trim();
-  } finally {
-    clearTimeout(timer);
-  }
+  );
 }
 
 export function formatCycleContext(ctx) {
@@ -161,80 +196,67 @@ export function formatCycleContext(ctx) {
     }
   }
 
+  const recoveryParts = [];
+  if (ctx.avgRestingHR) recoveryParts.push(`avg resting HR ${ctx.avgRestingHR} bpm`);
+  if (ctx.avgHRV) recoveryParts.push(`avg HRV ${ctx.avgHRV} ms`);
+  if (ctx.latestVO2Max) recoveryParts.push(`VO2 max ${ctx.latestVO2Max} ml/kg/min`);
+  if (ctx.avgSleepMins) recoveryParts.push(`avg sleep ${(ctx.avgSleepMins / 60).toFixed(1)}h`);
+  if (ctx.latestBodyWeightKg) recoveryParts.push(`body weight ${ctx.latestBodyWeightKg} kg`);
+  if (recoveryParts.length > 0) {
+    lines.push('');
+    lines.push(`Recovery metrics this cycle: ${recoveryParts.join(', ')}`);
+  }
+
+  if (ctx.cycleCardio?.length > 0) {
+    lines.push('');
+    lines.push('Cardio this cycle:');
+    for (const w of ctx.cycleCardio) {
+      const parts = [w.durationSecs ? `${Math.round(w.durationSecs / 60)} min` : '? min'];
+      if (w.distanceKm) parts.push(`${w.distanceKm.toFixed(1)} km`);
+      if (w.avgHR) parts.push(`avg HR ${w.avgHR} bpm`);
+      if (w.effortScore) parts.push(`effort ${w.effortScore}/10`);
+      lines.push(`  ${w.date} ${w.workoutType}: ${parts.join(', ')}`);
+    }
+  }
+
   return lines.join('\n');
 }
 
 export const WORKOUT_COACH_PROMPT = `You are reviewing a training session log. Write 2-3 short paragraphs separated by blank lines.
 
-Your job is to surface things the user wouldn't notice from glancing at their workout summary. The app already shows them PRs, total volume, effort score, and exercise breakdown — do NOT repeat any of that.
+Your job is to surface things the user wouldn't notice from glancing at their workout summary. The app already shows them PRs, total volume, effort score, and exercise breakdown — do NOT repeat any of that. The data tells the story — your job is to interpret it honestly, not to make the user feel good.
 
-Focus on:
-- Plan deviations: exercises swapped, skipped, or added vs the plan. Ask why if something looks unusual.
-- Set completion: if they did fewer sets than planned on an exercise, note it and ask about it.
-- Cross-session patterns: trends across recent sessions (volume direction on specific lifts, consistent cutoffs, same weight for weeks).
-- Ask 1-2 genuine questions about choices that look interesting or unusual.
+Focus on plan deviations (exercises swapped, skipped, or added vs the plan), set completion (if they did fewer sets than planned, note it and ask about it), and cross-session patterns (volume direction on specific lifts, consistent cutoffs, same weight for weeks). If exercises are marked "first session" they have zero prior history — state this plainly, don't frame it as "exploring" or "a new loading strategy." If this is an adhoc session, note any overlap with programmed exercises.
 
-Rules:
-- Only state what the data shows. Never claim how something "felt" — you have numbers, not feelings.
-- Never use words like: impressive, crushed, solid, demonstrating, significant, incredible, fantastic, smooth, controlled.
-- Never use -ing clauses that add fake depth ("indicating progressive overload", "demonstrating strength gains").
-- Never say things "felt smooth", "felt controlled", "feels about average" — you cannot know this.
-- Never restate PRs, total volume, or effort score — the user already sees these in the app.
-- Write like a training partner looking at a logbook, not a motivational coach.
-- Short sentences, no filler, no cheerleading. Questions are good.
-- No bullet points or lists.`;
+Never name an exercise that does not appear in the workout data below. [first session] means no prior history for that exact exercise. It does not mean the user switched from another exercise.
 
-export async function generateWorkoutCoachingSummary(workoutContext, { apiKey, model, timeoutMs } = {}) {
-  const resolvedModel = model || DEFAULT_MODEL;
-  const resolvedTimeout = timeoutMs || DEFAULT_TIMEOUT_MS;
-
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), resolvedTimeout);
-
-  try {
-    const userContent = formatWorkoutContext(workoutContext);
-
-    const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${apiKey}`,
-        'Content-Type': 'application/json',
-        'HTTP-Referer': 'https://incremnt.app',
-        'X-Title': 'incremnt'
-      },
-      body: JSON.stringify({
-        model: resolvedModel,
-        messages: [
-          { role: 'system', content: WORKOUT_COACH_PROMPT },
-          { role: 'user', content: userContent }
-        ],
-        max_tokens: DEFAULT_MAX_TOKENS,
-        temperature: 0.7
-      }),
-      signal: controller.signal
-    });
-
-    if (!response.ok) {
-      const text = await response.text().catch(() => '');
-      throw new Error(`OpenRouter API error ${response.status}: ${text}`);
-    }
+Ask 1-2 genuine questions about choices that look interesting or unusual. This is the most valuable thing you can do — a good question is worth more than restating what happened.
 
-    const data = await response.json();
-    const content = data.choices?.[0]?.message?.content;
-    if (!content) {
-      throw new Error('No content in OpenRouter response');
-    }
+Only state what the data shows. Never claim how something "felt." Be specific — use numbers and exercise names. Don't soften with "suggests", "appears to", "seems", "might." State it. Don't start sentences with "The session shows", "Your performance indicates", "It's worth noting." Just say it.
 
-    return content.trim();
-  } finally {
-    clearTimeout(timer);
-  }
+If you catch yourself writing something that sounds like a performance review or a fitness influencer post, rewrite it. No -ing clauses that add fake depth. No bullet points or lists.`;
+
+export async function generateWorkoutCoachingSummary(workoutContext, { apiKey, model, timeoutMs } = {}) {
+  const userContent = formatWorkoutContext(workoutContext);
+  return callOpenRouter(
+    [
+      { role: 'system', content: WORKOUT_COACH_PROMPT },
+      { role: 'user', content: userContent }
+    ],
+    {
+      apiKey,
+      models: model ? [model] : SUMMARY_MODEL_CHAIN,
+      temperature: 0.5,
+      timeoutMs
+    }
+  );
 }
 
 export function formatWorkoutContext(ctx) {
-  const lines = [
-    `Session: ${ctx.dayName}, ${ctx.sessionDate}, ${ctx.totalVolume} kg total volume.`
-  ];
+  const sessionLabel = ctx.isAdhoc
+    ? `Session: ${ctx.dayName}, ${ctx.sessionDate}, adhoc (no program), ${ctx.totalVolume} kg total volume.`
+    : `Session: ${ctx.dayName}, ${ctx.sessionDate}, program "${ctx.programName}", ${ctx.totalVolume} kg total volume.`;
+  const lines = [sessionLabel];
 
   if (ctx.effortScore) {
     lines.push(`Effort rating: ${ctx.effortScore}/10.`);
@@ -243,11 +265,14 @@ export function formatWorkoutContext(ctx) {
   lines.push('Exercises:');
   for (const ex of ctx.exercises) {
     const topPart = ex.topSet ? ` (top: ${ex.topSet.weight}×${ex.topSet.reps})` : '';
-    lines.push(`  ${ex.exerciseName}: ${ex.completedSets} sets${topPart}`);
+    const historyPart = ex.priorSessions === 0
+      ? ' [first session]'
+      : ` [${ex.priorSessions} prior sessions]`;
+    lines.push(`  ${ex.exerciseName}: ${ex.completedSets} sets${topPart}${historyPart}`);
   }
 
   if (ctx.prs.length > 0) {
-    lines.push('PRs this session:');
+    lines.push('PRs this session (only exercises with prior history):');
     for (const pr of ctx.prs) {
       lines.push(`  ${pr.exerciseName}: ${pr.weight}×${pr.reps} (e1RM ${pr.estimatedOneRM})`);
     }
@@ -257,7 +282,8 @@ export function formatWorkoutContext(ctx) {
     lines.push('Recent same-day sessions for comparison:');
     for (const comp of ctx.recentComparisons) {
       const effort = comp.effortScore ? `, effort ${comp.effortScore}/10` : '';
-      lines.push(`  ${comp.date}: ${comp.totalVolume} kg volume${effort}`);
+      const prog = comp.programName ? ` (${comp.programName})` : '';
+      lines.push(`  ${comp.date}: ${comp.totalVolume} kg volume${effort}${prog}`);
     }
   }
 
@@ -280,5 +306,66 @@ export function formatWorkoutContext(ctx) {
     }
   }
 
+  // Recovery context
+  const recoveryParts = [];
+  if (ctx.restingHROnDay) recoveryParts.push(`resting HR ${Math.round(ctx.restingHROnDay)} bpm`);
+  if (ctx.hrvOnDay) recoveryParts.push(`HRV ${Math.round(ctx.hrvOnDay)} ms`);
+  if (ctx.vo2MaxLatest) recoveryParts.push(`VO2 max ${ctx.vo2MaxLatest} ml/kg/min`);
+  if (ctx.sleepNight) recoveryParts.push(`sleep ${(ctx.sleepNight.durationMins / 60).toFixed(1)}h`);
+  if (ctx.bodyWeightKg) recoveryParts.push(`body weight ${ctx.bodyWeightKg} kg`);
+  if (recoveryParts.length > 0) {
+    lines.push(`Recovery (session day): ${recoveryParts.join(', ')}`);
+  }
+
+  if (ctx.nearbyCardio?.length > 0) {
+    lines.push('Cardio in the 7 days before this session:');
+    for (const w of ctx.nearbyCardio) {
+      const parts = [w.durationSecs ? `${Math.round(w.durationSecs / 60)} min` : '? min'];
+      if (w.distanceKm) parts.push(`${w.distanceKm.toFixed(1)} km`);
+      if (w.avgHR) parts.push(`avg HR ${w.avgHR} bpm`);
+      if (w.effortScore) parts.push(`effort ${w.effortScore}/10`);
+      lines.push(`  ${w.date} ${w.workoutType}: ${parts.join(', ')}`);
+    }
+  }
+
   return lines.join('\n');
 }
+
+export const ASK_PROMPT = `You are a strength coach answering questions from the user's training history. Give concrete, useful coaching, not hype.
+
+Rules:
+- Use only the data provided. If the data does not support a claim, do not make it.
+- Focus on trend, weak points, tradeoffs, and next steps. Be specific with exercises, weights, reps, volume, and timing when relevant.
+- Match the response length to the question. Short or playful prompts get a short conversational reply plus an invitation to ask something specific.
+- Keep the tone natural and direct. No hype, no filler, no emoji, no "let's dive in", no performance-review language.
+- Never name an exercise that does not appear in the training data below.
+- If data is missing or ambiguous, say so plainly.
+
+When the user asks for analysis, answer like a coach who has watched their training over time. When they ask for a plan, give a clear next-session recommendation. Bullet points are fine when they make the answer easier to use.`;
+
+export async function generateAskAnswer(context, question, { apiKey, model, timeoutMs, history = [] } = {}) {
+  // First user message includes the workout context; follow-ups are plain questions
+  const firstUserContent = `${context}\n\nQuestion: ${question}`;
+  const isFollowUp = history.length > 0;
+  const newUserContent = isFollowUp ? question : firstUserContent;
+
+  const priorMessages = history.map((m) => ({ role: m.role, content: m.content }));
+  // Prepend context to the first user message in history if needed
+  if (isFollowUp && priorMessages.length > 0 && priorMessages[0].role === 'user') {
+    priorMessages[0] = { role: 'user', content: `${context}\n\nQuestion: ${priorMessages[0].content}` };
+  }
+
+  return callOpenRouter(
+    [
+      { role: 'system', content: ASK_PROMPT },
+      ...priorMessages,
+      { role: 'user', content: newUserContent }
+    ],
+    {
+      apiKey,
+      models: model ? [model] : ASK_MODEL_CHAIN,
+      temperature: 0.3,
+      timeoutMs: timeoutMs ?? ASK_TIMEOUT_MS
+    }
+  );
+}