@nordsym/apiclaw 1.7.3 → 1.7.5

package/convex/purchases.d.ts

@@ -0,0 +1,7 @@
+export declare const purchaseAccess: any;
+export declare const getAgentPurchases: any;
+export declare const getActivePurchase: any;
+export declare const getUsage: any;
+export declare const recordUsage: any;
+export declare const getBalanceSummary: any;
+//# sourceMappingURL=purchases.d.ts.map

package/convex/purchases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchases.d.ts","sourceRoot":"","sources":["purchases.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,cAAc,KAoDzB,CAAC;AAGH,eAAO,MAAM,iBAAiB,KAQ5B,CAAC;AAGH,eAAO,MAAM,iBAAiB,KAe5B,CAAC;AAGH,eAAO,MAAM,QAAQ,KAQnB,CAAC;AAGH,eAAO,MAAM,WAAW,KAsCtB,CAAC;AAGH,eAAO,MAAM,iBAAiB,KA0B5B,CAAC"}

package/convex/purchases.js

@@ -0,0 +1,157 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+// Provider pricing (credits per dollar)
+const CREDITS_PER_DOLLAR = {
+    "46elks": 30, // ~30 SMS per dollar
+    twilio: 25, // ~25 SMS per dollar
+    resend: 1000, // ~1000 emails per dollar
+    brave_search: 200, // ~200 searches per dollar
+    openrouter: 100, // ~100k tokens per dollar
+    elevenlabs: 3333, // ~3333 characters per dollar
+};
+// Calculate credits for a provider purchase
+function calculateCredits(providerId, amountUsd) {
+    const rate = CREDITS_PER_DOLLAR[providerId] || 100;
+    return Math.floor(amountUsd * rate);
+}
+// Purchase API access
+export const purchaseAccess = mutation({
+    args: {
+        agentId: v.string(),
+        providerId: v.string(),
+        amountUsd: v.number(),
+        credentials: v.any(), // Credentials passed from server side
+    },
+    handler: async (ctx, args) => {
+        // Check balance
+        const credits = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+        if (!credits || credits.balanceUsd < args.amountUsd) {
+            throw new Error(`Insufficient balance: have $${(credits?.balanceUsd || 0).toFixed(2)}, need $${args.amountUsd.toFixed(2)}`);
+        }
+        // Deduct credits
+        await ctx.db.patch(credits._id, {
+            balanceUsd: credits.balanceUsd - args.amountUsd,
+            updatedAt: Date.now(),
+        });
+        // Calculate credits granted
+        const creditsGranted = calculateCredits(args.providerId, args.amountUsd);
+        // Create purchase record
+        const purchaseId = await ctx.db.insert("purchases", {
+            agentId: args.agentId,
+            providerId: args.providerId,
+            amountUsd: args.amountUsd,
+            creditsGranted,
+            status: "active",
+            credentials: args.credentials,
+            createdAt: Date.now(),
+        });
+        // Initialize usage tracking
+        await ctx.db.insert("usage", {
+            purchaseId,
+            providerId: args.providerId,
+            unitsUsed: 0,
+            unitsRemaining: creditsGranted,
+            costIncurredUsd: 0,
+            lastUsedAt: Date.now(),
+        });
+        return await ctx.db.get(purchaseId);
+    },
+});
+// Get all purchases for an agent
+export const getAgentPurchases = query({
+    args: { agentId: v.string() },
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("purchases")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .collect();
+    },
+});
+// Get active purchase for a provider
+export const getActivePurchase = query({
+    args: {
+        agentId: v.string(),
+        providerId: v.string(),
+    },
+    handler: async (ctx, args) => {
+        const purchases = await ctx.db
+            .query("purchases")
+            .withIndex("by_agentId_providerId", (q) => q.eq("agentId", args.agentId).eq("providerId", args.providerId))
+            .collect();
+        return purchases.find((p) => p.status === "active") || null;
+    },
+});
+// Get usage for a purchase
+export const getUsage = query({
+    args: { purchaseId: v.id("purchases") },
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("usage")
+            .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+            .first();
+    },
+});
+// Record usage
+export const recordUsage = mutation({
+    args: {
+        purchaseId: v.id("purchases"),
+        unitsUsed: v.number(),
+        costUsd: v.number(),
+    },
+    handler: async (ctx, args) => {
+        const usage = await ctx.db
+            .query("usage")
+            .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+            .first();
+        if (!usage) {
+            throw new Error("Usage record not found");
+        }
+        const newUnitsRemaining = Math.max(0, usage.unitsRemaining - args.unitsUsed);
+        await ctx.db.patch(usage._id, {
+            unitsUsed: usage.unitsUsed + args.unitsUsed,
+            unitsRemaining: newUnitsRemaining,
+            costIncurredUsd: usage.costIncurredUsd + args.costUsd,
+            lastUsedAt: Date.now(),
+        });
+        // Update purchase status if depleted
+        if (newUnitsRemaining === 0) {
+            const purchase = await ctx.db.get(args.purchaseId);
+            if (purchase) {
+                await ctx.db.patch(args.purchaseId, { status: "exhausted" });
+            }
+        }
+        return await ctx.db
+            .query("usage")
+            .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+            .first();
+    },
+});
+// Get balance summary for an agent
+export const getBalanceSummary = query({
+    args: { agentId: v.string() },
+    handler: async (ctx, args) => {
+        const credits = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+        const purchases = await ctx.db
+            .query("purchases")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .collect();
+        const activePurchases = purchases.filter((p) => p.status === "active");
+        const totalSpent = purchases.reduce((sum, p) => sum + p.amountUsd, 0);
+        return {
+            credits: credits || {
+                agentId: args.agentId,
+                balanceUsd: 0,
+                currency: "USD",
+            },
+            activePurchases,
+            totalSpentUsd: totalSpent,
+        };
+    },
+});
+//# sourceMappingURL=purchases.js.map

package/convex/purchases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchases.js","sourceRoot":"","sources":["purchases.ts"],"names":[],"mappings":"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"}

package/convex/purchases.ts

@@ -0,0 +1,183 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// Provider pricing (credits per dollar)
+const CREDITS_PER_DOLLAR: Record<string, number> = {
+  "46elks": 30, // ~30 SMS per dollar
+  twilio: 25, // ~25 SMS per dollar
+  resend: 1000, // ~1000 emails per dollar
+  brave_search: 200, // ~200 searches per dollar
+  openrouter: 100, // ~100k tokens per dollar
+  elevenlabs: 3333, // ~3333 characters per dollar
+};
+
+// Calculate credits for a provider purchase
+function calculateCredits(providerId: string, amountUsd: number): number {
+  const rate = CREDITS_PER_DOLLAR[providerId] || 100;
+  return Math.floor(amountUsd * rate);
+}
+
+// Purchase API access
+export const purchaseAccess = mutation({
+  args: {
+    agentId: v.string(),
+    providerId: v.string(),
+    amountUsd: v.number(),
+    credentials: v.any(), // Credentials passed from server side
+  },
+  handler: async (ctx, args) => {
+    // Check balance
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    if (!credits || credits.balanceUsd < args.amountUsd) {
+      throw new Error(
+        `Insufficient balance: have $${(credits?.balanceUsd || 0).toFixed(2)}, need $${args.amountUsd.toFixed(2)}`
+      );
+    }
+
+    // Deduct credits
+    await ctx.db.patch(credits._id, {
+      balanceUsd: credits.balanceUsd - args.amountUsd,
+      updatedAt: Date.now(),
+    });
+
+    // Calculate credits granted
+    const creditsGranted = calculateCredits(args.providerId, args.amountUsd);
+
+    // Create purchase record
+    const purchaseId = await ctx.db.insert("purchases", {
+      agentId: args.agentId,
+      providerId: args.providerId,
+      amountUsd: args.amountUsd,
+      creditsGranted,
+      status: "active",
+      credentials: args.credentials,
+      createdAt: Date.now(),
+    });
+
+    // Initialize usage tracking
+    await ctx.db.insert("usage", {
+      purchaseId,
+      providerId: args.providerId,
+      unitsUsed: 0,
+      unitsRemaining: creditsGranted,
+      costIncurredUsd: 0,
+      lastUsedAt: Date.now(),
+    });
+
+    return await ctx.db.get(purchaseId);
+  },
+});
+
+// Get all purchases for an agent
+export const getAgentPurchases = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("purchases")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .collect();
+  },
+});
+
+// Get active purchase for a provider
+export const getActivePurchase = query({
+  args: {
+    agentId: v.string(),
+    providerId: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const purchases = await ctx.db
+      .query("purchases")
+      .withIndex("by_agentId_providerId", (q) =>
+        q.eq("agentId", args.agentId).eq("providerId", args.providerId)
+      )
+      .collect();
+
+    return purchases.find((p) => p.status === "active") || null;
+  },
+});
+
+// Get usage for a purchase
+export const getUsage = query({
+  args: { purchaseId: v.id("purchases") },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("usage")
+      .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+      .first();
+  },
+});
+
+// Record usage
+export const recordUsage = mutation({
+  args: {
+    purchaseId: v.id("purchases"),
+    unitsUsed: v.number(),
+    costUsd: v.number(),
+  },
+  handler: async (ctx, args) => {
+    const usage = await ctx.db
+      .query("usage")
+      .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+      .first();
+
+    if (!usage) {
+      throw new Error("Usage record not found");
+    }
+
+    const newUnitsRemaining = Math.max(0, usage.unitsRemaining - args.unitsUsed);
+
+    await ctx.db.patch(usage._id, {
+      unitsUsed: usage.unitsUsed + args.unitsUsed,
+      unitsRemaining: newUnitsRemaining,
+      costIncurredUsd: usage.costIncurredUsd + args.costUsd,
+      lastUsedAt: Date.now(),
+    });
+
+    // Update purchase status if depleted
+    if (newUnitsRemaining === 0) {
+      const purchase = await ctx.db.get(args.purchaseId);
+      if (purchase) {
+        await ctx.db.patch(args.purchaseId, { status: "exhausted" });
+      }
+    }
+
+    return await ctx.db
+      .query("usage")
+      .withIndex("by_purchaseId", (q) => q.eq("purchaseId", args.purchaseId))
+      .first();
+  },
+});
+
+// Get balance summary for an agent
+export const getBalanceSummary = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    const purchases = await ctx.db
+      .query("purchases")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .collect();
+
+    const activePurchases = purchases.filter((p) => p.status === "active");
+    const totalSpent = purchases.reduce((sum, p) => sum + p.amountUsd, 0);
+
+    return {
+      credits: credits || {
+        agentId: args.agentId,
+        balanceUsd: 0,
+        currency: "USD",
+      },
+      activePurchases,
+      totalSpentUsd: totalSpent,
+    };
+  },
+});

package/convex/ratelimit.d.ts

@@ -0,0 +1,4 @@
+export declare const checkLimit: any;
+export declare const getUsage: any;
+export declare const cleanup: any;
+//# sourceMappingURL=ratelimit.d.ts.map

package/convex/ratelimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit.d.ts","sourceRoot":"","sources":["ratelimit.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,UAAU,KAsCrB,CAAC;AAGH,eAAO,MAAM,QAAQ,KAuBnB,CAAC;AAGH,eAAO,MAAM,OAAO,KAgBlB,CAAC"}

package/convex/ratelimit.js

@@ -0,0 +1,91 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+// Rate limit config per tier
+const LIMITS = {
+    free: {
+        discovery: 100, // searches per hour
+        instant: 10, // API calls per hour
+    },
+    subscriber: {
+        discovery: 1000,
+        instant: 100,
+    },
+    provider: {
+        discovery: 10000,
+        instant: 1000,
+    },
+};
+// Check and increment rate limit
+export const checkLimit = mutation({
+    args: {
+        identifier: v.string(), // IP or agentId
+        action: v.union(v.literal("discovery"), v.literal("instant")),
+        tier: v.optional(v.union(v.literal("free"), v.literal("subscriber"), v.literal("provider"))),
+    },
+    handler: async (ctx, args) => {
+        const tier = args.tier || "free";
+        const limit = LIMITS[tier][args.action];
+        const hourKey = Math.floor(Date.now() / 3600000); // Hour bucket
+        const key = `${args.identifier}:${args.action}:${hourKey}`;
+        // Get current count
+        const existing = await ctx.db
+            .query("rateLimits")
+            .withIndex("by_key", (q) => q.eq("key", key))
+            .first();
+        if (existing) {
+            if (existing.count >= limit) {
+                return { allowed: false, remaining: 0, resetIn: 3600 - (Date.now() % 3600000) / 1000 };
+            }
+            await ctx.db.patch(existing._id, { count: existing.count + 1 });
+            return { allowed: true, remaining: limit - existing.count - 1 };
+        }
+        // Create new entry
+        await ctx.db.insert("rateLimits", {
+            key,
+            identifier: args.identifier,
+            action: args.action,
+            count: 1,
+            hourBucket: hourKey,
+            createdAt: Date.now(),
+        });
+        return { allowed: true, remaining: limit - 1 };
+    },
+});
+// Get current usage stats
+export const getUsage = query({
+    args: {
+        identifier: v.string(),
+    },
+    handler: async (ctx, args) => {
+        const hourKey = Math.floor(Date.now() / 3600000);
+        const discovery = await ctx.db
+            .query("rateLimits")
+            .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:discovery:${hourKey}`))
+            .first();
+        const instant = await ctx.db
+            .query("rateLimits")
+            .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:instant:${hourKey}`))
+            .first();
+        return {
+            discovery: discovery?.count || 0,
+            instant: instant?.count || 0,
+            limits: LIMITS.free,
+        };
+    },
+});
+// Cleanup old rate limit entries (run via cron)
+export const cleanup = mutation({
+    args: {},
+    handler: async (ctx) => {
+        const hourAgo = Math.floor(Date.now() / 3600000) - 2; // Keep 2 hours
+        const old = await ctx.db
+            .query("rateLimits")
+            .filter((q) => q.lt(q.field("hourBucket"), hourAgo))
+            .take(100);
+        for (const entry of old) {
+            await ctx.db.delete(entry._id);
+        }
+        return { deleted: old.length };
+    },
+});
+//# sourceMappingURL=ratelimit.js.map

package/convex/ratelimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratelimit.js","sourceRoot":"","sources":["ratelimit.ts"],"names":[],"mappings":"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"}

package/convex/ratelimit.ts

@@ -0,0 +1,104 @@
+import { mutation, query } from "./_generated/server";
+import { v } from "convex/values";
+
+// Rate limit config per tier
+const LIMITS = {
+  free: {
+    discovery: 100,    // searches per hour
+    instant: 10,       // API calls per hour
+  },
+  subscriber: {
+    discovery: 1000,
+    instant: 100,
+  },
+  provider: {
+    discovery: 10000,
+    instant: 1000,
+  },
+};
+
+// Check and increment rate limit
+export const checkLimit = mutation({
+  args: {
+    identifier: v.string(),  // IP or agentId
+    action: v.union(v.literal("discovery"), v.literal("instant")),
+    tier: v.optional(v.union(v.literal("free"), v.literal("subscriber"), v.literal("provider"))),
+  },
+  handler: async (ctx, args) => {
+    const tier = args.tier || "free";
+    const limit = LIMITS[tier][args.action];
+    const hourKey = Math.floor(Date.now() / 3600000); // Hour bucket
+    const key = `${args.identifier}:${args.action}:${hourKey}`;
+
+    // Get current count
+    const existing = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", key))
+      .first();
+
+    if (existing) {
+      if (existing.count >= limit) {
+        return { allowed: false, remaining: 0, resetIn: 3600 - (Date.now() % 3600000) / 1000 };
+      }
+      await ctx.db.patch(existing._id, { count: existing.count + 1 });
+      return { allowed: true, remaining: limit - existing.count - 1 };
+    }
+
+    // Create new entry
+    await ctx.db.insert("rateLimits", {
+      key,
+      identifier: args.identifier,
+      action: args.action,
+      count: 1,
+      hourBucket: hourKey,
+      createdAt: Date.now(),
+    });
+
+    return { allowed: true, remaining: limit - 1 };
+  },
+});
+
+// Get current usage stats
+export const getUsage = query({
+  args: {
+    identifier: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const hourKey = Math.floor(Date.now() / 3600000);
+    
+    const discovery = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:discovery:${hourKey}`))
+      .first();
+
+    const instant = await ctx.db
+      .query("rateLimits")
+      .withIndex("by_key", (q) => q.eq("key", `${args.identifier}:instant:${hourKey}`))
+      .first();
+
+    return {
+      discovery: discovery?.count || 0,
+      instant: instant?.count || 0,
+      limits: LIMITS.free,
+    };
+  },
+});
+
+// Cleanup old rate limit entries (run via cron)
+export const cleanup = mutation({
+  args: {},
+  handler: async (ctx) => {
+    const hourAgo = Math.floor(Date.now() / 3600000) - 2; // Keep 2 hours
+    
+    const old = await ctx.db
+      .query("rateLimits")
+      .filter((q) => q.lt(q.field("hourBucket"), hourAgo))
+      .take(100);
+
+    for (const entry of old) {
+      await ctx.db.delete(entry._id);
+    }
+
+    return { deleted: old.length };
+  },
+});