@nordsym/apiclaw 1.7.3 → 1.7.5

package/convex/credits.d.ts

@@ -0,0 +1,25 @@
+export declare const CREDIT_PACKAGES: {
+    readonly starter: {
+        readonly amountUsd: 10;
+        readonly credits: 100;
+        readonly bonus: 0;
+    };
+    readonly growth: {
+        readonly amountUsd: 50;
+        readonly credits: 550;
+        readonly bonus: 50;
+    };
+    readonly scale: {
+        readonly amountUsd: 100;
+        readonly credits: 1200;
+        readonly bonus: 200;
+    };
+};
+export declare const getOrCreateAgent: any;
+export declare const getAgentCredits: any;
+export declare const addCredits: any;
+export declare const deductCredits: any;
+export declare const recordTopup: any;
+export declare const completeTopup: any;
+export declare const getTopups: any;
+//# sourceMappingURL=credits.d.ts.map

package/convex/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["credits.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAIlB,CAAC;AAGX,eAAO,MAAM,gBAAgB,KAqB3B,CAAC;AAGH,eAAO,MAAM,eAAe,KAQ1B,CAAC;AAGH,eAAO,MAAM,UAAU,KA+BrB,CAAC;AAGH,eAAO,MAAM,aAAa,KA4BxB,CAAC;AAGH,eAAO,MAAM,WAAW,KAwBtB,CAAC;AAGH,eAAO,MAAM,aAAa,KA6DxB,CAAC;AAGH,eAAO,MAAM,SAAS,KAQpB,CAAC"}

package/convex/credits.js

@@ -0,0 +1,186 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+// Credit packages
+export const CREDIT_PACKAGES = {
+    starter: { amountUsd: 10, credits: 100, bonus: 0 },
+    growth: { amountUsd: 50, credits: 550, bonus: 50 }, // 10% bonus
+    scale: { amountUsd: 100, credits: 1200, bonus: 200 }, // 20% bonus
+};
+// Get or create agent credits account
+export const getOrCreateAgent = mutation({
+    args: { agentId: v.string() },
+    handler: async (ctx, args) => {
+        const existing = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+        if (existing)
+            return existing;
+        const now = Date.now();
+        const id = await ctx.db.insert("agentCredits", {
+            agentId: args.agentId,
+            balanceUsd: 0,
+            currency: "USD",
+            createdAt: now,
+            updatedAt: now,
+        });
+        return await ctx.db.get(id);
+    },
+});
+// Get agent credits
+export const getAgentCredits = query({
+    args: { agentId: v.string() },
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+    },
+});
+// Add credits to agent account (called by webhook or admin)
+export const addCredits = mutation({
+    args: {
+        agentId: v.string(),
+        amountUsd: v.number(),
+        source: v.optional(v.string()),
+    },
+    handler: async (ctx, args) => {
+        const credits = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+        const now = Date.now();
+        if (credits) {
+            await ctx.db.patch(credits._id, {
+                balanceUsd: credits.balanceUsd + args.amountUsd,
+                updatedAt: now,
+            });
+            return await ctx.db.get(credits._id);
+        }
+        else {
+            const id = await ctx.db.insert("agentCredits", {
+                agentId: args.agentId,
+                balanceUsd: args.amountUsd,
+                currency: "USD",
+                createdAt: now,
+                updatedAt: now,
+            });
+            return await ctx.db.get(id);
+        }
+    },
+});
+// Deduct credits (internal use)
+export const deductCredits = mutation({
+    args: {
+        agentId: v.string(),
+        amountUsd: v.number(),
+    },
+    handler: async (ctx, args) => {
+        const credits = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .first();
+        if (!credits) {
+            throw new Error(`No credits account for agent: ${args.agentId}`);
+        }
+        if (credits.balanceUsd < args.amountUsd) {
+            throw new Error(`Insufficient balance: have $${credits.balanceUsd.toFixed(2)}, need $${args.amountUsd.toFixed(2)}`);
+        }
+        await ctx.db.patch(credits._id, {
+            balanceUsd: credits.balanceUsd - args.amountUsd,
+            updatedAt: Date.now(),
+        });
+        return await ctx.db.get(credits._id);
+    },
+});
+// Record credit top-up from Stripe
+export const recordTopup = mutation({
+    args: {
+        agentId: v.string(),
+        stripeSessionId: v.optional(v.string()),
+        stripePaymentIntentId: v.optional(v.string()),
+        amountUsd: v.number(),
+        creditsGranted: v.number(),
+        packageType: v.string(),
+        status: v.string(),
+    },
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        return await ctx.db.insert("creditTopups", {
+            agentId: args.agentId,
+            stripeSessionId: args.stripeSessionId,
+            stripePaymentIntentId: args.stripePaymentIntentId,
+            amountUsd: args.amountUsd,
+            creditsGranted: args.creditsGranted,
+            packageType: args.packageType,
+            status: args.status,
+            createdAt: now,
+            completedAt: args.status === "completed" ? now : undefined,
+        });
+    },
+});
+// Complete a pending top-up
+export const completeTopup = mutation({
+    args: {
+        stripeSessionId: v.optional(v.string()),
+        stripePaymentIntentId: v.optional(v.string()),
+    },
+    handler: async (ctx, args) => {
+        let topup;
+        if (args.stripeSessionId) {
+            topup = await ctx.db
+                .query("creditTopups")
+                .withIndex("by_stripeSessionId", (q) => q.eq("stripeSessionId", args.stripeSessionId))
+                .first();
+        }
+        else if (args.stripePaymentIntentId) {
+            topup = await ctx.db
+                .query("creditTopups")
+                .withIndex("by_stripePaymentIntentId", (q) => q.eq("stripePaymentIntentId", args.stripePaymentIntentId))
+                .first();
+        }
+        if (!topup) {
+            throw new Error("Top-up not found");
+        }
+        if (topup.status === "completed") {
+            return topup; // Already completed, idempotent
+        }
+        // Update top-up status
+        await ctx.db.patch(topup._id, {
+            status: "completed",
+            completedAt: Date.now(),
+        });
+        // Add credits to agent
+        const credits = await ctx.db
+            .query("agentCredits")
+            .withIndex("by_agentId", (q) => q.eq("agentId", topup.agentId))
+            .first();
+        if (credits) {
+            await ctx.db.patch(credits._id, {
+                balanceUsd: credits.balanceUsd + topup.creditsGranted,
+                updatedAt: Date.now(),
+            });
+        }
+        else {
+            await ctx.db.insert("agentCredits", {
+                agentId: topup.agentId,
+                balanceUsd: topup.creditsGranted,
+                currency: "USD",
+                createdAt: Date.now(),
+                updatedAt: Date.now(),
+            });
+        }
+        return topup;
+    },
+});
+// Get all top-ups for an agent
+export const getTopups = query({
+    args: { agentId: v.string() },
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("creditTopups")
+            .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+            .collect();
+    },
+});
+//# sourceMappingURL=credits.js.map

package/convex/credits.js.map

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

package/convex/credits.ts

@@ -0,0 +1,211 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// Credit packages
+export const CREDIT_PACKAGES = {
+  starter: { amountUsd: 10, credits: 100, bonus: 0 },
+  growth: { amountUsd: 50, credits: 550, bonus: 50 }, // 10% bonus
+  scale: { amountUsd: 100, credits: 1200, bonus: 200 }, // 20% bonus
+} as const;
+
+// Get or create agent credits account
+export const getOrCreateAgent = mutation({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    if (existing) return existing;
+
+    const now = Date.now();
+    const id = await ctx.db.insert("agentCredits", {
+      agentId: args.agentId,
+      balanceUsd: 0,
+      currency: "USD",
+      createdAt: now,
+      updatedAt: now,
+    });
+
+    return await ctx.db.get(id);
+  },
+});
+
+// Get agent credits
+export const getAgentCredits = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+  },
+});
+
+// Add credits to agent account (called by webhook or admin)
+export const addCredits = mutation({
+  args: {
+    agentId: v.string(),
+    amountUsd: v.number(),
+    source: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    const now = Date.now();
+
+    if (credits) {
+      await ctx.db.patch(credits._id, {
+        balanceUsd: credits.balanceUsd + args.amountUsd,
+        updatedAt: now,
+      });
+      return await ctx.db.get(credits._id);
+    } else {
+      const id = await ctx.db.insert("agentCredits", {
+        agentId: args.agentId,
+        balanceUsd: args.amountUsd,
+        currency: "USD",
+        createdAt: now,
+        updatedAt: now,
+      });
+      return await ctx.db.get(id);
+    }
+  },
+});
+
+// Deduct credits (internal use)
+export const deductCredits = mutation({
+  args: {
+    agentId: v.string(),
+    amountUsd: v.number(),
+  },
+  handler: async (ctx, args) => {
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .first();
+
+    if (!credits) {
+      throw new Error(`No credits account for agent: ${args.agentId}`);
+    }
+
+    if (credits.balanceUsd < args.amountUsd) {
+      throw new Error(
+        `Insufficient balance: have $${credits.balanceUsd.toFixed(2)}, need $${args.amountUsd.toFixed(2)}`
+      );
+    }
+
+    await ctx.db.patch(credits._id, {
+      balanceUsd: credits.balanceUsd - args.amountUsd,
+      updatedAt: Date.now(),
+    });
+
+    return await ctx.db.get(credits._id);
+  },
+});
+
+// Record credit top-up from Stripe
+export const recordTopup = mutation({
+  args: {
+    agentId: v.string(),
+    stripeSessionId: v.optional(v.string()),
+    stripePaymentIntentId: v.optional(v.string()),
+    amountUsd: v.number(),
+    creditsGranted: v.number(),
+    packageType: v.string(),
+    status: v.string(),
+  },
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    return await ctx.db.insert("creditTopups", {
+      agentId: args.agentId,
+      stripeSessionId: args.stripeSessionId,
+      stripePaymentIntentId: args.stripePaymentIntentId,
+      amountUsd: args.amountUsd,
+      creditsGranted: args.creditsGranted,
+      packageType: args.packageType,
+      status: args.status,
+      createdAt: now,
+      completedAt: args.status === "completed" ? now : undefined,
+    });
+  },
+});
+
+// Complete a pending top-up
+export const completeTopup = mutation({
+  args: {
+    stripeSessionId: v.optional(v.string()),
+    stripePaymentIntentId: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    let topup;
+
+    if (args.stripeSessionId) {
+      topup = await ctx.db
+        .query("creditTopups")
+        .withIndex("by_stripeSessionId", (q) =>
+          q.eq("stripeSessionId", args.stripeSessionId)
+        )
+        .first();
+    } else if (args.stripePaymentIntentId) {
+      topup = await ctx.db
+        .query("creditTopups")
+        .withIndex("by_stripePaymentIntentId", (q) =>
+          q.eq("stripePaymentIntentId", args.stripePaymentIntentId)
+        )
+        .first();
+    }
+
+    if (!topup) {
+      throw new Error("Top-up not found");
+    }
+
+    if (topup.status === "completed") {
+      return topup; // Already completed, idempotent
+    }
+
+    // Update top-up status
+    await ctx.db.patch(topup._id, {
+      status: "completed",
+      completedAt: Date.now(),
+    });
+
+    // Add credits to agent
+    const credits = await ctx.db
+      .query("agentCredits")
+      .withIndex("by_agentId", (q) => q.eq("agentId", topup.agentId))
+      .first();
+
+    if (credits) {
+      await ctx.db.patch(credits._id, {
+        balanceUsd: credits.balanceUsd + topup.creditsGranted,
+        updatedAt: Date.now(),
+      });
+    } else {
+      await ctx.db.insert("agentCredits", {
+        agentId: topup.agentId,
+        balanceUsd: topup.creditsGranted,
+        currency: "USD",
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      });
+    }
+
+    return topup;
+  },
+});
+
+// Get all top-ups for an agent
+export const getTopups = query({
+  args: { agentId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("creditTopups")
+      .withIndex("by_agentId", (q) => q.eq("agentId", args.agentId))
+      .collect();
+  },
+});

package/convex/crons.d.ts

@@ -0,0 +1,3 @@
+declare const crons: import("convex/server").Crons;
+export default crons;
+//# sourceMappingURL=crons.d.ts.map

package/convex/crons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crons.d.ts","sourceRoot":"","sources":["crons.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,KAAK,+BAAa,CAAC;AAwBzB,eAAe,KAAK,CAAC"}

package/convex/crons.js

@@ -0,0 +1,17 @@
+import { cronJobs } from "convex/server";
+import { internal } from "./_generated/api";
+const crons = cronJobs();
+/**
+ * Daily Usage Reporting to Stripe
+ * Runs at 00:05 UTC every day
+ * Reports metered usage for all active subscriptions
+ */
+crons.daily("report-usage-to-stripe", { hourUTC: 0, minuteUTC: 5 }, internal.billing.reportAllUsageToStripe);
+/**
+ * Monthly Spend Reset
+ * Runs at 00:01 UTC on the 1st of each month
+ * Resets monthlySpendCents and budgetAlertSentAt for all workspaces
+ */
+crons.monthly("reset-monthly-spend", { day: 1, hourUTC: 0, minuteUTC: 1 }, internal.spendAlerts.resetMonthlySpend);
+export default crons;
+//# sourceMappingURL=crons.js.map

package/convex/crons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crons.js","sourceRoot":"","sources":["crons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;AAEzB;;;;GAIG;AACH,KAAK,CAAC,KAAK,CACT,wBAAwB,EACxB,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAC5B,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CACxC,CAAC;AAEF;;;;GAIG;AACH,KAAK,CAAC,OAAO,CACX,qBAAqB,EACrB,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EACpC,QAAQ,CAAC,WAAW,CAAC,iBAAiB,CACvC,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/convex/crons.ts

@@ -0,0 +1,28 @@
+import { cronJobs } from "convex/server";
+import { internal } from "./_generated/api";
+
+const crons = cronJobs();
+
+/**
+ * Daily Usage Reporting to Stripe
+ * Runs at 00:05 UTC every day
+ * Reports metered usage for all active subscriptions
+ */
+crons.daily(
+  "report-usage-to-stripe",
+  { hourUTC: 0, minuteUTC: 5 },
+  internal.billing.reportAllUsageToStripe
+);
+
+/**
+ * Monthly Spend Reset
+ * Runs at 00:01 UTC on the 1st of each month
+ * Resets monthlySpendCents and budgetAlertSentAt for all workspaces
+ */
+crons.monthly(
+  "reset-monthly-spend",
+  { day: 1, hourUTC: 0, minuteUTC: 1 },
+  internal.spendAlerts.resetMonthlySpend
+);
+
+export default crons;

package/convex/directCall.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Save/update provider's Direct Call configuration
+ */
+export declare const saveDirectCallConfig: any;
+/**
+ * Save Direct Call config with token auth (used by frontend)
+ */
+export declare const saveConfig: any;
+/**
+ * Create/update an action for a Direct Call config
+ */
+export declare const saveAction: any;
+/**
+ * Delete an action
+ */
+export declare const deleteAction: any;
+/**
+ * Publish Direct Call - set status to live
+ * Also marks apiListed earn progress for the provider's workspace
+ */
+export declare const publishDirectCall: any;
+/**
+ * Set Direct Call status (draft, testing, live)
+ */
+export declare const setStatus: any;
+/**
+ * Get Direct Call config by providerId
+ */
+export declare const getDirectCallConfig: any;
+/**
+ * Get Direct Call config by ID
+ */
+export declare const getDirectCallConfigById: any;
+/**
+ * Get Direct Call config by API ID
+ */
+export declare const getDirectCallConfigByApiId: any;
+/**
+ * Get all actions for a Direct Call config
+ */
+export declare const getActions: any;
+/**
+ * Get single action by directCallId + name
+ */
+export declare const getActionByName: any;
+/**
+ * Get action by ID
+ */
+export declare const getActionById: any;
+/**
+ * DEBUG: Get all Direct Call configs
+ */
+export declare const getAllConfigs: any;
+/**
+ * Get all live Direct Call configs (for public API discovery)
+ */
+export declare const getLiveConfigs: any;
+/**
+ * Get Direct Call config by API ID (for test console)
+ */
+export declare const getConfig: any;
+/**
+ * Get Direct Call config by API slug (for MCP/agent execution)
+ * Looks up API by name, then gets the Direct Call config
+ */
+export declare const getByApiSlug: any;
+/**
+ * Test an action by calling the actual provider API
+ * For V1: Provider passes their own test key
+ */
+export declare const testAction: any;
+//# sourceMappingURL=directCall.d.ts.map

package/convex/directCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directCall.d.ts","sourceRoot":"","sources":["directCall.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,oBAAoB,KAkD/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,KAkFrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,KAyDrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,KAQvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KA8E5B,CAAC;AAgBH;;GAEG;AACH,eAAO,MAAM,SAAS,KAiBpB,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB,KAU9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAOlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B,KAUrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,KAUrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,KAa1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAOxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,KAKxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,KAQzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,KAcpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,KAoCvB,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,UAAU,KAsJrB,CAAC"}