@nordsym/apiclaw 1.3.11 → 1.3.13

package/convex/spendAlerts.ts

@@ -0,0 +1,442 @@
+import { v } from "convex/values";
+import { mutation, query, action, internalMutation } from "./_generated/server";
+import { Id } from "./_generated/dataModel";
+import { internal } from "./_generated/api";
+
+// ============================================
+// 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(): number {
+  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: Record<string, unknown> = {
+      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 };
+  },
+});

package/convex/workspaces.ts

@@ -94,7 +94,10 @@ export const verifyMagicLink = mutation({
         status: "active",
         tier: "free",
         usageCount: 0,
-        usageLimit: 50, // 50 free API calls
+        usageLimit: 50, // Legacy field, now using weekly limits
+        weeklyUsageCount: 0,
+        weeklyUsageLimit: 50, // 50 calls/week for free tier
+        hourlyUsageCount: 0,
         referralCode: newReferralCode!,
         createdAt: Date.now(),
         updatedAt: Date.now(),
@@ -102,56 +105,21 @@ export const verifyMagicLink = mutation({
       workspace = await ctx.db.get(workspaceId);
     }
 
-    // Process referral for new users
+    // REFERRAL DISABLED (2026-03-01): Risk of abuse with awesome-list exposure
+    // Tracking referredBy for analytics only, no credit bonus
     if (isNewUser && referralCode) {
-      // Find referrer by code
       const referrer = await ctx.db
         .query("workspaces")
         .withIndex("by_referralCode", (q) => q.eq("referralCode", referralCode))
         .first();
 
       if (referrer && referrer._id !== workspace!._id) {
-        // Update new user's referredBy
+        // Track referral for analytics only
         await ctx.db.patch(workspace!._id, {
           referredBy: referrer._id,
           updatedAt: Date.now(),
         });
-
-        // Get or create referrer's earn progress
-        let referrerProgress = await ctx.db
-          .query("earnProgress")
-          .withIndex("by_workspaceId", (q) => q.eq("workspaceId", referrer._id))
-          .first();
-
-        if (!referrerProgress) {
-          await ctx.db.insert("earnProgress", {
-            workspaceId: referrer._id,
-            firstDirectCall: false,
-            apisUsed: [],
-            apisUsedComplete: false,
-            agentListed: false,
-            apiListed: false,
-            byokSetup: false,
-            githubStarred: false,
-            twitterFollowed: false,
-            referralCount: 1,
-            totalEarned: 10,
-            createdAt: Date.now(),
-            updatedAt: Date.now(),
-          });
-        } else {
-          await ctx.db.patch(referrerProgress._id, {
-            referralCount: referrerProgress.referralCount + 1,
-            totalEarned: referrerProgress.totalEarned + 10,
-            updatedAt: Date.now(),
-          });
-        }
-
-        // Credit referrer with +10 API calls
-        await ctx.db.patch(referrer._id, {
-          usageLimit: referrer.usageLimit + 10,
-          updatedAt: Date.now(),
-        });
+        // No credit bonus - referral rewards disabled
       }
     }
 
@@ -258,6 +226,14 @@ export const getWorkspaceDashboard = query({
     const usageRemaining = workspace.usageLimit - workspace.usageCount;
     const usagePercentage = (workspace.usageCount / workspace.usageLimit) * 100;
 
+    // Budget status (PRD 2.6)
+    const monthStart = getMonthStartForBudget();
+    let currentSpend = workspace.monthlySpendCents || 0;
+    if (!workspace.lastSpendResetAt || workspace.lastSpendResetAt < monthStart) {
+      currentSpend = 0;
+    }
+    const budgetCap = workspace.budgetCap || null;
+
     return {
       workspace: {
         id: workspace._id,
@@ -276,10 +252,28 @@ export const getWorkspaceDashboard = query({
         totalCredits: workspaceCredits.reduce((sum, c) => sum + c.balanceUsd, 0),
         totalPurchases: workspacePurchases.length,
       },
+      budget: {
+        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 * 0.8 : false,
+      },
     };
   },
 });
 
+// Helper for budget month start
+function getMonthStartForBudget(): number {
+  const now = new Date();
+  return new Date(now.getUTCFullYear(), now.getUTCMonth(), 1, 0, 0, 0, 0).getTime();
+}
+
 // Get connected agents for workspace
 export const getConnectedAgents = query({
   args: { token: v.string() },
@@ -537,6 +531,29 @@ export const updateTier = mutation({
 });
 
 // Increment usage count
+// Constants for rate limiting
+const FREE_WEEKLY_LIMIT = 50;
+const FREE_HOURLY_LIMIT = 10;
+const BACKER_END_DATE = new Date("2026-12-31T23:59:59Z").getTime();
+
+// Helper: Get start of current week (Monday 00:00 UTC)
+function getWeekStart(): number {
+  const now = new Date();
+  const dayOfWeek = now.getUTCDay();
+  const diff = dayOfWeek === 0 ? 6 : dayOfWeek - 1; // Monday = 0
+  const monday = new Date(now);
+  monday.setUTCDate(now.getUTCDate() - diff);
+  monday.setUTCHours(0, 0, 0, 0);
+  return monday.getTime();
+}
+
+// Helper: Get start of current hour
+function getHourStart(): number {
+  const now = new Date();
+  now.setUTCMinutes(0, 0, 0);
+  return now.getTime();
+}
+
 export const incrementUsage = mutation({
   args: {
     workspaceId: v.id("workspaces"),
@@ -548,22 +565,65 @@ export const incrementUsage = mutation({
       throw new Error("Workspace not found");
     }
 
-    const newCount = workspace.usageCount + amount;
+    const now = Date.now();
+    const weekStart = getWeekStart();
+    const hourStart = getHourStart();
+    
+    // Check if Backer (unlimited until end of 2026)
+    const isBacker = workspace.tier === "backer" || 
+                     (workspace.backerUntil && workspace.backerUntil > now);
+    
+    // Initialize weekly/hourly counters if needed
+    let weeklyCount = workspace.weeklyUsageCount || 0;
+    let hourlyCount = workspace.hourlyUsageCount || 0;
     
-    // Check if over limit
-    if (newCount > workspace.usageLimit) {
-      throw new Error("Usage limit exceeded");
+    // Reset weekly counter if new week
+    if (!workspace.lastWeeklyResetAt || workspace.lastWeeklyResetAt < weekStart) {
+      weeklyCount = 0;
+    }
+    
+    // Reset hourly counter if new hour
+    if (!workspace.lastHourlyResetAt || workspace.lastHourlyResetAt < hourStart) {
+      hourlyCount = 0;
+    }
+    
+    // Check rate limits for free tier
+    if (!isBacker && workspace.tier !== "pro" && workspace.tier !== "enterprise") {
+      // Check hourly limit (10/hour for free)
+      if (hourlyCount + amount > FREE_HOURLY_LIMIT) {
+        throw new Error(`Hourly rate limit exceeded (${FREE_HOURLY_LIMIT}/hour). Upgrade to Backer for unlimited.`);
+      }
+      
+      // Check weekly limit (50/week for free)
+      if (weeklyCount + amount > FREE_WEEKLY_LIMIT) {
+        throw new Error(`Weekly limit exceeded (${FREE_WEEKLY_LIMIT}/week). Upgrade to Backer for unlimited.`);
+      }
     }
 
+    const newTotalCount = workspace.usageCount + amount;
+    const newWeeklyCount = weeklyCount + amount;
+    const newHourlyCount = hourlyCount + amount;
+
     await ctx.db.patch(workspaceId, {
-      usageCount: newCount,
-      updatedAt: Date.now(),
+      usageCount: newTotalCount,
+      weeklyUsageCount: newWeeklyCount,
+      hourlyUsageCount: newHourlyCount,
+      lastWeeklyResetAt: weekStart,
+      lastHourlyResetAt: hourStart,
+      updatedAt: now,
     });
 
+    // Calculate remaining for free tier
+    const weeklyRemaining = isBacker ? Infinity : Math.max(0, FREE_WEEKLY_LIMIT - newWeeklyCount);
+    const hourlyRemaining = isBacker ? Infinity : Math.max(0, FREE_HOURLY_LIMIT - newHourlyCount);
+
     return { 
       success: true, 
-      usageCount: newCount,
-      usageRemaining: workspace.usageLimit - newCount,
+      usageCount: newTotalCount,
+      weeklyUsageCount: newWeeklyCount,
+      weeklyRemaining,
+      hourlyRemaining,
+      isBacker,
     };
   },
 });

package/dist/execute.d.ts

@@ -7,7 +7,12 @@ interface ExecuteResult {
     action: string;
     data?: unknown;
     error?: string;
+    code?: string;
     cost?: number;
+    url?: string;
+    id?: string;
+    content?: string;
+    status?: string;
 }
 interface DryRunResult {
     dry_run: true;

package/dist/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,OAAO,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAyKD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,YAAY,CA8Dd;AAmtBD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAGD,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnF;AAGD,wBAAgB,qBAAqB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAKjF;AAGD,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CA8FxB"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiLD,UAAU,YAAY;IACpB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,OAAO,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAyKD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,YAAY,CA8Dd;AA8tBD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAGD,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnF;AAGD,wBAAgB,qBAAqB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAKjF;AAGD,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAkGxB"}