@fatagnus/convex-feedback 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/convex-feedback",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Bug reports and feedback collection component for Convex applications with AI analysis and email notifications",
   "license": "Apache-2.0",
   "repository": {

package/src/convex/agents/bugReportAgent.ts

@@ -19,32 +19,23 @@ import { components, internal } from "../_generated/api";
 import { internalAction, internalQuery } from "../_generated/server";
 import type { BugSeverity, Effort } from "../schema";
 
-// Create OpenRouter provider
-const openrouter = createOpenAICompatible({
-  name: "openrouter",
-  baseURL: "https://openrouter.ai/api/v1",
-  headers: {
-    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
-  },
-});
+// Helper to create OpenRouter provider dynamically
+// This is created dynamically because Convex components don't inherit parent env vars
+function createOpenRouterProvider(apiKey: string) {
+  return createOpenAICompatible({
+    name: "openrouter",
+    baseURL: "https://openrouter.ai/api/v1",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  });
+}
 
 // Agent name constant
 const AGENT_NAME = "Bug Report Analyst";
 
-// ============================================================================
-// Agent Definition
-// ============================================================================
-
-/**
- * Bug Report Analysis Agent
- *
- * Analyzes bug report submissions and generates comprehensive analysis.
- */
-export const bugReportAgent = new Agent(components.agent, {
-  name: AGENT_NAME,
-  languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
-
-  instructions: `You are the Bug Report Analyst, an AI assistant that analyzes bug report submissions.
+// Agent instructions (shared between dynamic agent instances)
+const BUG_REPORT_AGENT_INSTRUCTIONS = `You are the Bug Report Analyst, an AI assistant that analyzes bug report submissions.
 
 When given a bug report, you will:
 1. **Summarize** the bug in 2-3 clear sentences
@@ -74,11 +65,7 @@ Always respond in the following JSON format:
 - Reproduction steps should be specific and actionable
 - Suggested fix should be practical and implementable
 - Effort estimation should account for investigation, fix, testing, and deployment
-- Severity should reflect user impact and business criticality`,
-
-  tools: {},
-  maxSteps: 3,
-});
+- Severity should reflect user impact and business criticality`;
 
 // ============================================================================
 // Internal Queries
@@ -142,7 +129,8 @@ export const processBugReport = internalAction({
   }),
   handler: async (ctx, args): Promise<{ success: boolean; error?: string }> => {
     // Check if OpenRouter API key is configured
-    if (!process.env.OPENROUTER_API_KEY) {
+    const apiKey = process.env.OPENROUTER_API_KEY;
+    if (!apiKey) {
       console.log("OPENROUTER_API_KEY not configured, skipping AI analysis");
       // Still try to send notifications without AI analysis
       try {
@@ -170,6 +158,18 @@ export const processBugReport = internalAction({
       title: `Bug Report Analysis: ${bugReport.title}`,
     });
 
+    // Create OpenRouter provider dynamically with the API key
+    const openrouter = createOpenRouterProvider(apiKey);
+
+    // Create agent dynamically to ensure API key is available at runtime
+    const bugReportAgent = new Agent(components.agent, {
+      name: AGENT_NAME,
+      languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
+      instructions: BUG_REPORT_AGENT_INSTRUCTIONS,
+      tools: {},
+      maxSteps: 3,
+    });
+
     // Build the prompt for analysis
     const consoleErrorsSection = bugReport.consoleErrors 
       ? `**Console Errors:** ${bugReport.consoleErrors}` 

package/src/convex/agents/feedbackAgent.ts

@@ -18,32 +18,23 @@ import { components, internal } from "../_generated/api";
 import { internalAction, internalQuery } from "../_generated/server";
 import type { FeedbackPriority, Effort } from "../schema";
 
-// Create OpenRouter provider
-const openrouter = createOpenAICompatible({
-  name: "openrouter",
-  baseURL: "https://openrouter.ai/api/v1",
-  headers: {
-    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
-  },
-});
+// Helper to create OpenRouter provider dynamically
+// This is created dynamically because Convex components don't inherit parent env vars
+function createOpenRouterProvider(apiKey: string) {
+  return createOpenAICompatible({
+    name: "openrouter",
+    baseURL: "https://openrouter.ai/api/v1",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  });
+}
 
 // Agent name constant
 const AGENT_NAME = "Feedback Analyst";
 
-// ============================================================================
-// Agent Definition
-// ============================================================================
-
-/**
- * Feedback Analysis Agent
- *
- * Analyzes feedback submissions and generates comprehensive reports.
- */
-export const feedbackAgent = new Agent(components.agent, {
-  name: AGENT_NAME,
-  languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
-
-  instructions: `You are the Feedback Analyst, an AI assistant that analyzes user feedback submissions.
+// Agent instructions (shared between dynamic agent instances)
+const FEEDBACK_AGENT_INSTRUCTIONS = `You are the Feedback Analyst, an AI assistant that analyzes user feedback submissions.
 
 When given feedback, you will:
 1. **Summarize** the feedback in 2-3 clear sentences
@@ -70,11 +61,7 @@ Always respond in the following JSON format:
 - Consider both technical and business impact
 - Action items should be specific and actionable
 - Effort estimation should account for development, testing, and deployment
-- Priority should reflect urgency and user impact`,
-
-  tools: {},
-  maxSteps: 3,
-});
+- Priority should reflect urgency and user impact`;
 
 // ============================================================================
 // Internal Queries
@@ -138,7 +125,8 @@ export const processFeedback = internalAction({
   }),
   handler: async (ctx, args): Promise<{ success: boolean; error?: string }> => {
     // Check if OpenRouter API key is configured
-    if (!process.env.OPENROUTER_API_KEY) {
+    const apiKey = process.env.OPENROUTER_API_KEY;
+    if (!apiKey) {
       console.log("OPENROUTER_API_KEY not configured, skipping AI analysis");
       // Still try to send notifications without AI analysis
       try {
@@ -166,6 +154,18 @@ export const processFeedback = internalAction({
       title: `Feedback Analysis: ${feedback.title}`,
     });
 
+    // Create OpenRouter provider dynamically with the API key
+    const openrouter = createOpenRouterProvider(apiKey);
+
+    // Create agent dynamically to ensure API key is available at runtime
+    const feedbackAgent = new Agent(components.agent, {
+      name: AGENT_NAME,
+      languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
+      instructions: FEEDBACK_AGENT_INSTRUCTIONS,
+      tools: {},
+      maxSteps: 3,
+    });
+
     // Build the prompt for analysis
     const analysisPrompt = `Please analyze the following feedback submission:
 

package/src/convex/agents/feedbackInterviewAgent.ts

@@ -19,14 +19,17 @@ import { action, query, mutation, internalMutation } from "../_generated/server"
 import type { Id } from "../_generated/dataModel";
 import type { BugSeverity, FeedbackType, FeedbackPriority } from "../schema";
 
-// Create OpenRouter provider
-const openrouter = createOpenAICompatible({
-  name: "openrouter",
-  baseURL: "https://openrouter.ai/api/v1",
-  headers: {
-    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
-  },
-});
+// Helper to create OpenRouter provider with a specific API key
+// This is created dynamically because Convex components don't inherit parent env vars
+function createOpenRouterProvider(apiKey: string) {
+  return createOpenAICompatible({
+    name: "openrouter",
+    baseURL: "https://openrouter.ai/api/v1",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  });
+}
 
 // Agent name constant
 const AGENT_NAME = "Feedback Interview Agent";
@@ -186,101 +189,6 @@ const generateFeedback = createTool({
   },
 });
 
-// ============================================================================
-// Agent Definition
-// ============================================================================
-
-/**
- * Bug Report Interview Agent
- */
-export const bugInterviewAgent = new Agent(components.agent, {
-  name: "Bug Report Interview Agent",
-  languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
-  
-  instructions: `You are a helpful assistant that interviews users to gather detailed information about bugs they've encountered.
-
-Your goal is to understand the bug thoroughly and generate a high-quality bug report.
-
-## Interview Flow
-
-1. **Greet briefly** and ask what went wrong (the bug they encountered).
-
-2. **Understand the bug**:
-   - What happened? (the actual behavior)
-   - What did they expect to happen? (expected behavior)
-   - How often does this occur? (always, sometimes, once)
-
-3. **Get reproduction info**:
-   - What steps led to this bug?
-   - Can they reliably reproduce it?
-
-4. **Assess impact**:
-   - How does this affect their work?
-   - How urgent is this for them?
-
-5. **Generate the report** using the generateBugReport tool when you have enough information.
-
-## Guidelines
-- Be conversational but efficient - aim for 3-5 exchanges
-- Use choice inputs when there are clear options
-- Use text inputs for open-ended questions
-- Don't ask for technical details the user might not know
-- Focus on understanding the user experience
-- Generate the report as soon as you have enough info`,
-
-  tools: {
-    requestUserInput,
-    generateBugReport,
-  },
-
-  maxSteps: 30,
-});
-
-/**
- * Feedback Interview Agent
- */
-export const feedbackInterviewAgent = new Agent(components.agent, {
-  name: "Feedback Interview Agent",
-  languageModel: openrouter.languageModel("anthropic/claude-sonnet-4"),
-  
-  instructions: `You are a helpful assistant that interviews users to gather detailed feedback and suggestions.
-
-Your goal is to understand their idea thoroughly and generate well-structured feedback.
-
-## Interview Flow
-
-1. **Greet briefly** and ask about their idea or suggestion.
-
-2. **Understand the need**:
-   - What problem does this solve?
-   - What's their current workaround (if any)?
-
-3. **Clarify the request**:
-   - What would the ideal solution look like?
-   - Is this a new feature, change to existing, or general feedback?
-
-4. **Assess importance**:
-   - How important is this to them?
-   - Who else might benefit?
-
-5. **Generate the feedback** using the generateFeedback tool when you have enough information.
-
-## Guidelines
-- Be conversational but efficient - aim for 3-5 exchanges
-- Use choice inputs when there are clear options
-- Use text inputs for open-ended questions
-- Help users articulate their ideas clearly
-- Focus on understanding the value and impact
-- Generate the feedback as soon as you have enough info`,
-
-  tools: {
-    requestUserInput,
-    generateFeedback,
-  },
-
-  maxSteps: 30,
-});
-
 // ============================================================================
 // Internal Mutations
 // ============================================================================
@@ -570,6 +478,7 @@ Your goal is to understand their idea thoroughly and generate well-structured fe
  */
 export const startBugInterview = action({
   args: {
+    openRouterApiKey: v.string(),
     reporterType: v.union(v.literal("staff"), v.literal("customer")),
     reporterId: v.string(),
     reporterEmail: v.string(),
@@ -605,10 +514,8 @@ export const startBugInterview = action({
     })),
   }),
   handler: async (ctx, args) => {
-    // Check if OpenRouter API key is configured
-    if (!process.env.OPENROUTER_API_KEY) {
-      throw new Error("OPENROUTER_API_KEY not configured. Interview mode requires AI.");
-    }
+    // Create OpenRouter provider with the passed API key
+    const openrouter = createOpenRouterProvider(args.openRouterApiKey);
 
     // Create a thread for the interview
     const threadId = await createThread(ctx, components.agent, {
@@ -702,6 +609,7 @@ export const startBugInterview = action({
  */
 export const startFeedbackInterview = action({
   args: {
+    openRouterApiKey: v.string(),
     reporterType: v.union(v.literal("staff"), v.literal("customer")),
     reporterId: v.string(),
     reporterEmail: v.string(),
@@ -737,10 +645,8 @@ export const startFeedbackInterview = action({
     })),
   }),
   handler: async (ctx, args) => {
-    // Check if OpenRouter API key is configured
-    if (!process.env.OPENROUTER_API_KEY) {
-      throw new Error("OPENROUTER_API_KEY not configured. Interview mode requires AI.");
-    }
+    // Create OpenRouter provider with the passed API key
+    const openrouter = createOpenRouterProvider(args.openRouterApiKey);
 
     // Create a thread for the interview
     const threadId = await createThread(ctx, components.agent, {
@@ -834,6 +740,7 @@ export const startFeedbackInterview = action({
  */
 export const continueInterview = action({
   args: {
+    openRouterApiKey: v.string(),
     threadId: v.string(),
     sessionId: v.string(),
     requestId: v.id("feedbackInputRequests"),
@@ -891,6 +798,9 @@ export const continueInterview = action({
     })),
   }),
   handler: async (ctx, args) => {
+    // Create OpenRouter provider with the passed API key
+    const openrouter = createOpenRouterProvider(args.openRouterApiKey);
+
     // Submit the response
     await ctx.runMutation(
       api.inputRequests.submitResponse,