@nordsym/apiclaw 1.5.13 → 1.5.14

package/dist/convex/searchLogs.js

@@ -0,0 +1,128 @@
+import { internalMutation, query } from "./_generated/server";
+import { v } from "convex/values";
+// Log a search query (uses existing searchLogs table schema)
+export const logSearch = internalMutation({
+    args: {
+        query: v.string(),
+        resultsCount: v.number(),
+        matchedProviders: v.optional(v.array(v.string())),
+        sessionToken: v.optional(v.string()),
+        userAgent: v.optional(v.string()),
+        responseTimeMs: v.optional(v.number()),
+    },
+    handler: async (ctx, args) => {
+        // Try to get workspaceId from session token
+        let workspaceId = undefined;
+        let subagentId = undefined;
+        if (args.sessionToken) {
+            try {
+                const token = args.sessionToken;
+                const session = await ctx.db
+                    .query("agentSessions")
+                    .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
+                    .first();
+                if (session) {
+                    workspaceId = session.workspaceId;
+                    // No agentId in agentSessions, subagentId stays undefined
+                }
+            }
+            catch (e) {
+                // Ignore - just skip workspace linking
+            }
+        }
+        // Only log if we have a workspace (existing schema requires it)
+        if (workspaceId) {
+            await ctx.db.insert("searchLogs", {
+                workspaceId,
+                subagentId,
+                query: args.query,
+                resultCount: args.resultsCount,
+                hasResults: args.resultsCount > 0,
+                matchedProviders: args.matchedProviders,
+                responseTimeMs: args.responseTimeMs || 0,
+                timestamp: Date.now(),
+            });
+        }
+        // TODO: Also log anonymous searches somewhere (for product insights)
+    },
+});
+// Get top search queries (for analytics)
+export const getTopQueries = query({
+    args: {
+        limit: v.optional(v.number()),
+        since: v.optional(v.number()), // timestamp
+    },
+    handler: async (ctx, args) => {
+        const limit = args.limit || 50;
+        const since = args.since || Date.now() - 7 * 24 * 60 * 60 * 1000; // Last 7 days
+        const logs = await ctx.db
+            .query("searchLogs")
+            .withIndex("by_timestamp")
+            .filter((q) => q.gte(q.field("timestamp"), since))
+            .collect();
+        // Aggregate by query
+        const queryCounts = {};
+        for (const log of logs) {
+            const q = log.query.toLowerCase().trim();
+            if (!q)
+                continue;
+            if (!queryCounts[q]) {
+                queryCounts[q] = { count: 0, avgResults: 0, totalResults: 0 };
+            }
+            queryCounts[q].count++;
+            queryCounts[q].totalResults += log.resultCount;
+        }
+        // Calculate averages and sort
+        const sorted = Object.entries(queryCounts)
+            .map(([query, data]) => ({
+            query,
+            count: data.count,
+            avgResults: Math.round(data.totalResults / data.count * 10) / 10,
+            noResults: data.totalResults === 0,
+        }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, limit);
+        return {
+            queries: sorted,
+            totalSearches: logs.length,
+            uniqueQueries: Object.keys(queryCounts).length,
+            period: {
+                since: new Date(since).toISOString(),
+                until: new Date().toISOString(),
+            },
+        };
+    },
+});
+// Get searches with no results (API gaps)
+export const getZeroResultQueries = query({
+    args: {
+        limit: v.optional(v.number()),
+        since: v.optional(v.number()),
+    },
+    handler: async (ctx, args) => {
+        const limit = args.limit || 20;
+        const since = args.since || Date.now() - 7 * 24 * 60 * 60 * 1000;
+        const logs = await ctx.db
+            .query("searchLogs")
+            .withIndex("by_hasResults")
+            .filter((q) => q.and(q.eq(q.field("hasResults"), false), q.gte(q.field("timestamp"), since)))
+            .collect();
+        // Aggregate
+        const queryCounts = {};
+        for (const log of logs) {
+            const q = log.query.toLowerCase().trim();
+            if (!q)
+                continue;
+            queryCounts[q] = (queryCounts[q] || 0) + 1;
+        }
+        const sorted = Object.entries(queryCounts)
+            .map(([query, count]) => ({ query, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, limit);
+        return {
+            gaps: sorted,
+            totalZeroResults: logs.length,
+            message: "These queries returned no results - potential APIs to add",
+        };
+    },
+});

package/dist/convex/spendAlerts.js

@@ -0,0 +1,379 @@
+import { v } from "convex/values";
+import { mutation, query, action, internalMutation } from "./_generated/server";
+// ============================================
+// CONSTANTS
+// ============================================
+const ALERT_THRESHOLD = 0.8; // 80% of budget
+const APP_URL = "https://apiclaw.nordsym.com";
+const EMAIL_FROM = "APIClaw <noreply@apiclaw.nordsym.com>";
+// ============================================
+// HELPER: Get current month start
+// ============================================
+function getMonthStart() {
+    const now = new Date();
+    return new Date(now.getUTCFullYear(), now.getUTCMonth(), 1, 0, 0, 0, 0).getTime();
+}
+// ============================================
+// MUTATIONS
+// ============================================
+/**
+ * Update workspace budget settings
+ */
+export const updateBudgetSettings = mutation({
+    args: {
+        workspaceId: v.id("workspaces"),
+        budgetCap: v.optional(v.union(v.number(), v.null())), // in USD cents, null = unlimited
+        pauseOnBudgetExceeded: v.optional(v.boolean()),
+    },
+    handler: async (ctx, args) => {
+        const workspace = await ctx.db.get(args.workspaceId);
+        if (!workspace) {
+            throw new Error("Workspace not found");
+        }
+        const updates = {
+            updatedAt: Date.now(),
+        };
+        if (args.budgetCap !== undefined) {
+            updates.budgetCap = args.budgetCap;
+            // Reset alert when budget changes
+            updates.budgetAlertSentAt = undefined;
+        }
+        if (args.pauseOnBudgetExceeded !== undefined) {
+            updates.pauseOnBudgetExceeded = args.pauseOnBudgetExceeded;
+        }
+        await ctx.db.patch(args.workspaceId, updates);
+        return { success: true };
+    },
+});
+/**
+ * Record spend and check budget alerts
+ * Called after each successful API execution
+ * Returns budget status for response
+ */
+export const recordSpend = mutation({
+    args: {
+        workspaceId: v.id("workspaces"),
+        amountCents: v.number(),
+    },
+    handler: async (ctx, args) => {
+        const workspace = await ctx.db.get(args.workspaceId);
+        if (!workspace) {
+            throw new Error("Workspace not found");
+        }
+        const monthStart = getMonthStart();
+        // Reset monthly spend if new month
+        let currentSpend = workspace.monthlySpendCents || 0;
+        if (!workspace.lastSpendResetAt || workspace.lastSpendResetAt < monthStart) {
+            currentSpend = 0;
+        }
+        // Add new spend
+        const newSpend = currentSpend + args.amountCents;
+        // Update workspace
+        await ctx.db.patch(args.workspaceId, {
+            monthlySpendCents: newSpend,
+            lastSpendResetAt: monthStart,
+            updatedAt: Date.now(),
+        });
+        // Check if we need to send alert
+        const budgetCap = workspace.budgetCap;
+        let shouldSendAlert = false;
+        let budgetExceeded = false;
+        if (budgetCap && budgetCap > 0) {
+            const threshold = budgetCap * ALERT_THRESHOLD;
+            const alertAlreadySentThisMonth = workspace.budgetAlertSentAt &&
+                workspace.budgetAlertSentAt >= monthStart;
+            // Check if at 80% and alert not yet sent
+            if (newSpend >= threshold && !alertAlreadySentThisMonth) {
+                shouldSendAlert = true;
+                await ctx.db.patch(args.workspaceId, {
+                    budgetAlertSentAt: Date.now(),
+                });
+            }
+            // Check if budget exceeded
+            if (newSpend >= budgetCap) {
+                budgetExceeded = true;
+            }
+        }
+        return {
+            success: true,
+            currentSpendCents: newSpend,
+            budgetCapCents: budgetCap || null,
+            budgetPercentage: budgetCap ? (newSpend / budgetCap) * 100 : null,
+            shouldSendAlert,
+            budgetExceeded,
+            email: workspace.email,
+        };
+    },
+});
+/**
+ * Check budget before execution
+ * Returns { allowed: boolean, reason?: string }
+ */
+export const checkBudget = query({
+    args: {
+        workspaceId: v.id("workspaces"),
+        estimatedCostCents: v.optional(v.number()),
+    },
+    handler: async (ctx, args) => {
+        const workspace = await ctx.db.get(args.workspaceId);
+        if (!workspace) {
+            return { allowed: false, reason: "Workspace not found" };
+        }
+        // No budget cap set = unlimited
+        if (!workspace.budgetCap || workspace.budgetCap <= 0) {
+            return { allowed: true };
+        }
+        // Check if pause on exceeded is enabled
+        if (!workspace.pauseOnBudgetExceeded) {
+            return { allowed: true };
+        }
+        const monthStart = getMonthStart();
+        let currentSpend = workspace.monthlySpendCents || 0;
+        // Reset if new month
+        if (!workspace.lastSpendResetAt || workspace.lastSpendResetAt < monthStart) {
+            currentSpend = 0;
+        }
+        const estimatedCost = args.estimatedCostCents || 0;
+        const projectedSpend = currentSpend + estimatedCost;
+        if (projectedSpend > workspace.budgetCap) {
+            const budgetCapUsd = (workspace.budgetCap / 100).toFixed(2);
+            const currentSpendUsd = (currentSpend / 100).toFixed(2);
+            return {
+                allowed: false,
+                reason: `Budget exceeded. Monthly cap: $${budgetCapUsd}, current spend: $${currentSpendUsd}. Adjust budget in workspace settings.`,
+                currentSpendCents: currentSpend,
+                budgetCapCents: workspace.budgetCap,
+            };
+        }
+        return {
+            allowed: true,
+            currentSpendCents: currentSpend,
+            budgetCapCents: workspace.budgetCap,
+            remainingCents: workspace.budgetCap - currentSpend,
+        };
+    },
+});
+/**
+ * Get budget status for workspace dashboard
+ */
+export const getBudgetStatus = query({
+    args: {
+        workspaceId: v.id("workspaces"),
+    },
+    handler: async (ctx, args) => {
+        const workspace = await ctx.db.get(args.workspaceId);
+        if (!workspace) {
+            return null;
+        }
+        const monthStart = getMonthStart();
+        let currentSpend = workspace.monthlySpendCents || 0;
+        // Reset if new month
+        if (!workspace.lastSpendResetAt || workspace.lastSpendResetAt < monthStart) {
+            currentSpend = 0;
+        }
+        const budgetCap = workspace.budgetCap || null;
+        const budgetPercentage = budgetCap ? (currentSpend / budgetCap) * 100 : null;
+        return {
+            budgetCapCents: budgetCap,
+            budgetCapUsd: budgetCap ? budgetCap / 100 : null,
+            currentSpendCents: currentSpend,
+            currentSpendUsd: currentSpend / 100,
+            remainingCents: budgetCap ? Math.max(0, budgetCap - currentSpend) : null,
+            remainingUsd: budgetCap ? Math.max(0, (budgetCap - currentSpend) / 100) : null,
+            budgetPercentage: budgetPercentage ? Math.min(100, budgetPercentage) : null,
+            pauseOnBudgetExceeded: workspace.pauseOnBudgetExceeded || false,
+            isOverBudget: budgetCap ? currentSpend >= budgetCap : false,
+            isNearBudget: budgetCap ? currentSpend >= budgetCap * ALERT_THRESHOLD : false,
+            alertSentAt: workspace.budgetAlertSentAt || null,
+        };
+    },
+});
+/**
+ * Get budget status by session token (for dashboard)
+ */
+export const getBudgetStatusByToken = query({
+    args: {
+        token: v.string(),
+    },
+    handler: async (ctx, args) => {
+        const session = await ctx.db
+            .query("agentSessions")
+            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
+            .first();
+        if (!session) {
+            return null;
+        }
+        const workspace = await ctx.db.get(session.workspaceId);
+        if (!workspace) {
+            return null;
+        }
+        const monthStart = getMonthStart();
+        let currentSpend = workspace.monthlySpendCents || 0;
+        if (!workspace.lastSpendResetAt || workspace.lastSpendResetAt < monthStart) {
+            currentSpend = 0;
+        }
+        const budgetCap = workspace.budgetCap || null;
+        return {
+            budgetCapCents: budgetCap,
+            budgetCapUsd: budgetCap ? budgetCap / 100 : null,
+            currentSpendCents: currentSpend,
+            currentSpendUsd: currentSpend / 100,
+            remainingCents: budgetCap ? Math.max(0, budgetCap - currentSpend) : null,
+            remainingUsd: budgetCap ? Math.max(0, (budgetCap - currentSpend) / 100) : null,
+            budgetPercentage: budgetCap ? Math.min(100, (currentSpend / budgetCap) * 100) : null,
+            pauseOnBudgetExceeded: workspace.pauseOnBudgetExceeded || false,
+            isOverBudget: budgetCap ? currentSpend >= budgetCap : false,
+            isNearBudget: budgetCap ? currentSpend >= budgetCap * ALERT_THRESHOLD : false,
+        };
+    },
+});
+// ============================================
+// EMAIL ACTION
+// ============================================
+/**
+ * Send budget alert email (80% warning)
+ */
+export const sendBudgetAlertEmail = action({
+    args: {
+        email: v.string(),
+        currentSpendCents: v.number(),
+        budgetCapCents: v.number(),
+    },
+    handler: async (ctx, args) => {
+        const RESEND_API_KEY = process.env.RESEND_API_KEY;
+        if (!RESEND_API_KEY) {
+            console.error("RESEND_API_KEY not configured");
+            return { success: false, error: "Email not configured" };
+        }
+        const currentSpendUsd = (args.currentSpendCents / 100).toFixed(2);
+        const budgetCapUsd = (args.budgetCapCents / 100).toFixed(2);
+        const percentageUsed = Math.round((args.currentSpendCents / args.budgetCapCents) * 100);
+        const settingsUrl = `${APP_URL}/dashboard/settings`;
+        // Build email HTML
+        let html = "<!DOCTYPE html><html><head><meta charset='utf-8'></head>";
+        html += "<body style='margin:0;padding:40px;background:#f5f5f5;font-family:Arial,sans-serif;'>";
+        html += "<table width='100%' cellpadding='0' cellspacing='0'><tr><td align='center'>";
+        html += "<table width='500' cellpadding='0' cellspacing='0' style='background:#fff;border-radius:12px;'>";
+        html += "<tr><td style='padding:32px;text-align:center;'>";
+        html += "<div style='font-size:48px;'>🦞</div>";
+        html += "<h1 style='margin:16px 0;color:#0a0a0a;'>APIClaw</h1>";
+        html += "<h2 style='margin:0 0 16px;font-size:20px;color:#f59e0b;'>⚠️ Budget Alert</h2>";
+        html += "<p style='margin:0 0 16px;color:#525252;font-size:16px;'>You've used <strong>" + percentageUsed + "%</strong> of your monthly budget.</p>";
+        html += "<div style='background:#fef3c7;border:1px solid #f59e0b;border-radius:8px;padding:16px;margin-bottom:24px;'>";
+        html += "<p style='margin:0;color:#92400e;font-size:14px;'><strong>Current spend:</strong> $" + currentSpendUsd + " / $" + budgetCapUsd + "</p>";
+        html += "</div>";
+        html += "<p style='margin:0 0 24px;color:#525252;font-size:14px;'>If your budget is exceeded, API calls will be paused until the next billing cycle (if pause is enabled).</p>";
+        html += "<a href='" + settingsUrl + "' style='display:inline-block;background:#ef4444;color:white;padding:14px 32px;border-radius:8px;text-decoration:none;font-weight:600;'>Adjust Budget</a>";
+        html += "</td></tr></table>";
+        html += "</td></tr></table></body></html>";
+        const textContent = `APIClaw Budget Alert\n\nYou've used ${percentageUsed}% of your monthly budget.\nCurrent spend: $${currentSpendUsd} / $${budgetCapUsd}\n\nAdjust your budget: ${settingsUrl}`;
+        const response = await fetch("https://api.resend.com/emails", {
+            method: "POST",
+            headers: {
+                "Authorization": "Bearer " + RESEND_API_KEY,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                from: EMAIL_FROM,
+                to: args.email,
+                subject: "⚠️ APIClaw: 80% of Monthly Budget Used",
+                html: html,
+                text: textContent,
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            console.error("Failed to send budget alert email:", errorText);
+            return { success: false, error: errorText };
+        }
+        return { success: true };
+    },
+});
+/**
+ * Send budget exceeded email
+ */
+export const sendBudgetExceededEmail = action({
+    args: {
+        email: v.string(),
+        currentSpendCents: v.number(),
+        budgetCapCents: v.number(),
+        isPaused: v.boolean(),
+    },
+    handler: async (ctx, args) => {
+        const RESEND_API_KEY = process.env.RESEND_API_KEY;
+        if (!RESEND_API_KEY) {
+            console.error("RESEND_API_KEY not configured");
+            return { success: false, error: "Email not configured" };
+        }
+        const currentSpendUsd = (args.currentSpendCents / 100).toFixed(2);
+        const budgetCapUsd = (args.budgetCapCents / 100).toFixed(2);
+        const settingsUrl = `${APP_URL}/dashboard/settings`;
+        const pauseMessage = args.isPaused
+            ? "API execution has been paused. Increase your budget or disable pause-on-exceed to continue."
+            : "Your agents can still make calls, but you're over budget.";
+        let html = "<!DOCTYPE html><html><head><meta charset='utf-8'></head>";
+        html += "<body style='margin:0;padding:40px;background:#f5f5f5;font-family:Arial,sans-serif;'>";
+        html += "<table width='100%' cellpadding='0' cellspacing='0'><tr><td align='center'>";
+        html += "<table width='500' cellpadding='0' cellspacing='0' style='background:#fff;border-radius:12px;'>";
+        html += "<tr><td style='padding:32px;text-align:center;'>";
+        html += "<div style='font-size:48px;'>🦞</div>";
+        html += "<h1 style='margin:16px 0;color:#0a0a0a;'>APIClaw</h1>";
+        html += "<h2 style='margin:0 0 16px;font-size:20px;color:#ef4444;'>🚨 Budget Exceeded</h2>";
+        html += "<p style='margin:0 0 16px;color:#525252;font-size:16px;'>Your monthly budget has been exceeded.</p>";
+        html += "<div style='background:#fee2e2;border:1px solid #ef4444;border-radius:8px;padding:16px;margin-bottom:24px;'>";
+        html += "<p style='margin:0;color:#991b1b;font-size:14px;'><strong>Current spend:</strong> $" + currentSpendUsd + " / $" + budgetCapUsd + "</p>";
+        html += "</div>";
+        html += "<p style='margin:0 0 24px;color:#525252;font-size:14px;'>" + pauseMessage + "</p>";
+        html += "<a href='" + settingsUrl + "' style='display:inline-block;background:#ef4444;color:white;padding:14px 32px;border-radius:8px;text-decoration:none;font-weight:600;'>Increase Budget</a>";
+        html += "</td></tr></table>";
+        html += "</td></tr></table></body></html>";
+        const response = await fetch("https://api.resend.com/emails", {
+            method: "POST",
+            headers: {
+                "Authorization": "Bearer " + RESEND_API_KEY,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                from: EMAIL_FROM,
+                to: args.email,
+                subject: "🚨 APIClaw: Monthly Budget Exceeded",
+                html: html,
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            console.error("Failed to send budget exceeded email:", errorText);
+            return { success: false, error: errorText };
+        }
+        return { success: true };
+    },
+});
+// ============================================
+// CRON: Monthly reset
+// ============================================
+/**
+ * Reset monthly spend for all workspaces (called by cron on 1st of month)
+ */
+export const resetMonthlySpend = internalMutation({
+    args: {},
+    handler: async (ctx) => {
+        const monthStart = getMonthStart();
+        // Get all workspaces with spend tracking
+        const workspaces = await ctx.db
+            .query("workspaces")
+            .collect();
+        let resetCount = 0;
+        for (const workspace of workspaces) {
+            if (workspace.monthlySpendCents && workspace.monthlySpendCents > 0) {
+                await ctx.db.patch(workspace._id, {
+                    monthlySpendCents: 0,
+                    lastSpendResetAt: monthStart,
+                    budgetAlertSentAt: undefined, // Reset alert flag for new month
+                    updatedAt: Date.now(),
+                });
+                resetCount++;
+            }
+        }
+        return { resetCount };
+    },
+});