@nordsym/apiclaw 1.5.17 → 1.5.19

package/convex/logs.d.ts

@@ -1,38 +0,0 @@
-/**
- * Create a log entry for an API call
- * Called after each Direct Call execution
- */
-export declare const createLog: any;
-/**
- * Internal log creation (when workspaceId is already known)
- * Used by execute functions that have already verified the session
- */
-export declare const createLogInternal: any;
-/**
- * Combined log creation + spend tracking (PRD 2.6)
- * Creates log entry, tracks spend, returns budget status
- * Returns shouldSendAlert: true if 80% threshold crossed (caller should send email)
- */
-export declare const createLogWithSpend: any;
-/**
- * Get logs for a workspace with pagination and filters
- */
-export declare const getLogs: any;
-/**
- * Get aggregated log stats for workspace
- */
-export declare const getLogStats: any;
-/**
- * Get unique providers for filter dropdown
- */
-export declare const getProviders: any;
-/**
- * Get logs for a specific subagent
- */
-export declare const getBySubagent: any;
-/**
- * Clear all logs for a workspace (admin cleanup)
- */
-export declare const clearWorkspaceLogs: any;
-export declare const createProxyLog: any;
-//# sourceMappingURL=logs.d.ts.map

package/convex/logs.js

@@ -1,487 +0,0 @@
-import { v } from "convex/values";
-import { mutation, query } from "./_generated/server";
-// ============================================
-// MUTATIONS
-// ============================================
-/**
- * Create a log entry for an API call
- * Called after each Direct Call execution
- */
-export const createLog = mutation({
-    args: {
-        token: v.string(),
-        provider: v.string(),
-        action: v.string(),
-        status: v.union(v.literal("success"), v.literal("error")),
-        latencyMs: v.number(),
-        errorMessage: v.optional(v.string()),
-        subagentId: v.optional(v.string()), // from X-APIClaw-Subagent header
-    },
-    handler: async (ctx, args) => {
-        // Verify session and get workspace
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session token");
-        }
-        // Create log entry
-        return await ctx.db.insert("apiLogs", {
-            workspaceId: session.workspaceId,
-            sessionToken: args.token,
-            subagentId: args.subagentId,
-            provider: args.provider,
-            action: args.action,
-            status: args.status,
-            latencyMs: args.latencyMs,
-            errorMessage: args.errorMessage,
-            createdAt: Date.now(),
-        });
-    },
-});
-/**
- * Internal log creation (when workspaceId is already known)
- * Used by execute functions that have already verified the session
- */
-export const createLogInternal = mutation({
-    args: {
-        workspaceId: v.id("workspaces"),
-        sessionToken: v.string(),
-        provider: v.string(),
-        action: v.string(),
-        status: v.union(v.literal("success"), v.literal("error")),
-        latencyMs: v.number(),
-        errorMessage: v.optional(v.string()),
-        subagentId: v.optional(v.string()), // from X-APIClaw-Subagent header
-    },
-    handler: async (ctx, args) => {
-        return await ctx.db.insert("apiLogs", {
-            workspaceId: args.workspaceId,
-            sessionToken: args.sessionToken,
-            subagentId: args.subagentId,
-            provider: args.provider,
-            action: args.action,
-            status: args.status,
-            latencyMs: args.latencyMs,
-            errorMessage: args.errorMessage,
-            createdAt: Date.now(),
-        });
-    },
-});
-// ============================================
-// HELPER: Get month start
-// ============================================
-function getMonthStart() {
-    const now = new Date();
-    return new Date(now.getUTCFullYear(), now.getUTCMonth(), 1, 0, 0, 0, 0).getTime();
-}
-/**
- * Combined log creation + spend tracking (PRD 2.6)
- * Creates log entry, tracks spend, returns budget status
- * Returns shouldSendAlert: true if 80% threshold crossed (caller should send email)
- */
-export const createLogWithSpend = mutation({
-    args: {
-        workspaceId: v.id("workspaces"),
-        sessionToken: v.string(),
-        provider: v.string(),
-        action: v.string(),
-        status: v.union(v.literal("success"), v.literal("error")),
-        latencyMs: v.number(),
-        costCents: v.number(), // Cost in USD cents
-        errorMessage: v.optional(v.string()),
-        subagentId: v.optional(v.string()),
-    },
-    handler: async (ctx, args) => {
-        const now = Date.now();
-        const monthStart = getMonthStart();
-        // 1. Create log entry
-        const logId = await ctx.db.insert("apiLogs", {
-            workspaceId: args.workspaceId,
-            sessionToken: args.sessionToken,
-            subagentId: args.subagentId,
-            provider: args.provider,
-            action: args.action,
-            status: args.status,
-            latencyMs: args.latencyMs,
-            errorMessage: args.errorMessage,
-            createdAt: now,
-        });
-        // 2. Track spend if successful call with cost
-        if (args.status === "success" && args.costCents > 0) {
-            const workspace = await ctx.db.get(args.workspaceId);
-            if (!workspace) {
-                return { logId, spendTracked: false };
-            }
-            // 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.costCents;
-            const budgetCap = workspace.budgetCap;
-            // Update workspace
-            await ctx.db.patch(args.workspaceId, {
-                monthlySpendCents: newSpend,
-                lastSpendResetAt: monthStart,
-                updatedAt: now,
-            });
-            // Check if we need to send alert (80% threshold)
-            let shouldSendAlert = false;
-            let budgetExceeded = false;
-            if (budgetCap && budgetCap > 0) {
-                const threshold = budgetCap * 0.8;
-                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: now,
-                    });
-                }
-                // Check if budget exceeded
-                if (newSpend >= budgetCap) {
-                    budgetExceeded = true;
-                }
-            }
-            return {
-                logId,
-                spendTracked: true,
-                currentSpendCents: newSpend,
-                budgetCapCents: budgetCap || null,
-                budgetPercentage: budgetCap ? Math.round((newSpend / budgetCap) * 100) : null,
-                shouldSendAlert,
-                budgetExceeded,
-                email: workspace.email,
-            };
-        }
-        return { logId, spendTracked: false };
-    },
-});
-// ============================================
-// QUERIES
-// ============================================
-/**
- * Get logs for a workspace with pagination and filters
- */
-export const getLogs = query({
-    args: {
-        token: v.string(),
-        limit: v.optional(v.number()),
-        cursor: v.optional(v.number()), // createdAt timestamp for pagination
-        status: v.optional(v.union(v.literal("success"), v.literal("error"), v.literal("all"))),
-        provider: v.optional(v.string()),
-        subagentId: v.optional(v.string()), // filter by subagent
-    },
-    handler: async (ctx, args) => {
-        const limit = args.limit ?? 50;
-        const status = args.status ?? "all";
-        const provider = args.provider;
-        const subagentId = args.subagentId;
-        const cursor = args.cursor;
-        // Verify session
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
-            .first();
-        if (!session) {
-            return { logs: [], hasMore: false };
-        }
-        // Get logs for workspace
-        let query = ctx.db
-            .query("apiLogs")
-            .withIndex("by_workspaceId_createdAt", (q) => q.eq("workspaceId", session.workspaceId))
-            .order("desc");
-        // Apply cursor (pagination)
-        if (cursor) {
-            query = query.filter((q) => q.lt(q.field("createdAt"), cursor));
-        }
-        // Collect more than limit to check hasMore
-        const allLogs = await query.take(limit + 1);
-        // Apply filters in-memory (Convex doesn't support complex compound filters)
-        let filteredLogs = allLogs;
-        if (status !== "all") {
-            filteredLogs = filteredLogs.filter((log) => log.status === status);
-        }
-        if (provider && provider !== "all") {
-            filteredLogs = filteredLogs.filter((log) => log.provider === provider);
-        }
-        // Filter by subagent
-        if (subagentId) {
-            if (subagentId === "main") {
-                // Main agent calls (no subagentId)
-                filteredLogs = filteredLogs.filter((log) => !log.subagentId);
-            }
-            else {
-                filteredLogs = filteredLogs.filter((log) => log.subagentId === subagentId);
-            }
-        }
-        const hasMore = filteredLogs.length > limit;
-        const logs = filteredLogs.slice(0, limit);
-        return {
-            logs: logs.map((log) => ({
-                id: log._id,
-                provider: log.provider,
-                action: log.action,
-                status: log.status,
-                latencyMs: log.latencyMs,
-                errorMessage: log.errorMessage,
-                subagentId: log.subagentId || null,
-                createdAt: log.createdAt,
-            })),
-            hasMore,
-            nextCursor: logs.length > 0 ? logs[logs.length - 1].createdAt : undefined,
-        };
-    },
-});
-/**
- * Get aggregated log stats for workspace
- */
-export const getLogStats = query({
-    args: {
-        token: v.string(),
-        periodDays: v.optional(v.number()),
-    },
-    handler: async (ctx, args) => {
-        const periodDays = args.periodDays ?? 7;
-        // Verify session
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
-            .first();
-        if (!session) {
-            return {
-                totalCalls: 0,
-                successCount: 0,
-                errorCount: 0,
-                successRate: 0,
-                avgLatency: 0,
-                byProvider: [],
-                byDay: [],
-            };
-        }
-        const now = Date.now();
-        const periodStart = now - periodDays * 24 * 60 * 60 * 1000;
-        // Get all logs for this workspace in the period
-        const logs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_workspaceId_createdAt", (q) => q.eq("workspaceId", session.workspaceId))
-            .filter((q) => q.gte(q.field("createdAt"), periodStart))
-            .collect();
-        const totalCalls = logs.length;
-        const successCount = logs.filter((l) => l.status === "success").length;
-        const errorCount = logs.filter((l) => l.status === "error").length;
-        const successRate = totalCalls > 0 ? (successCount / totalCalls) * 100 : 0;
-        const totalLatency = logs.reduce((sum, l) => sum + l.latencyMs, 0);
-        const avgLatency = totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0;
-        // Group by provider
-        const byProviderMap = {};
-        for (const log of logs) {
-            if (!byProviderMap[log.provider]) {
-                byProviderMap[log.provider] = { calls: 0, success: 0, error: 0, latency: 0 };
-            }
-            byProviderMap[log.provider].calls++;
-            byProviderMap[log.provider].latency += log.latencyMs;
-            if (log.status === "success") {
-                byProviderMap[log.provider].success++;
-            }
-            else {
-                byProviderMap[log.provider].error++;
-            }
-        }
-        const byProvider = Object.entries(byProviderMap)
-            .map(([provider, data]) => ({
-            provider,
-            calls: data.calls,
-            successRate: data.calls > 0 ? (data.success / data.calls) * 100 : 0,
-            avgLatency: data.calls > 0 ? Math.round(data.latency / data.calls) : 0,
-        }))
-            .sort((a, b) => b.calls - a.calls);
-        // Group by day
-        const byDayMap = {};
-        for (const log of logs) {
-            const day = new Date(log.createdAt).toISOString().split("T")[0];
-            if (!byDayMap[day]) {
-                byDayMap[day] = { calls: 0, success: 0, error: 0 };
-            }
-            byDayMap[day].calls++;
-            if (log.status === "success") {
-                byDayMap[day].success++;
-            }
-            else {
-                byDayMap[day].error++;
-            }
-        }
-        const byDay = Object.entries(byDayMap)
-            .map(([date, data]) => ({
-            date,
-            calls: data.calls,
-            success: data.success,
-            error: data.error,
-        }))
-            .sort((a, b) => a.date.localeCompare(b.date));
-        // Get unique providers and agents for filter dropdowns
-        const providers = [...new Set(logs.map((l) => l.provider))].sort();
-        const agents = [...new Set(logs.map((l) => l.subagentId || "main"))].sort();
-        return {
-            totalCalls,
-            successCount,
-            errorCount,
-            successRate: Math.round(successRate * 10) / 10,
-            avgLatency,
-            byProvider,
-            byDay,
-            providers,
-            agents,
-        };
-    },
-});
-/**
- * Get unique providers for filter dropdown
- */
-export const getProviders = query({
-    args: {
-        token: v.string(),
-    },
-    handler: async (ctx, args) => {
-        // Verify session
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
-            .first();
-        if (!session) {
-            return [];
-        }
-        // Get all logs for this workspace
-        const logs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_workspaceId", (q) => q.eq("workspaceId", session.workspaceId))
-            .collect();
-        // Get unique providers
-        const providers = [...new Set(logs.map((l) => l.provider))].sort();
-        return providers;
-    },
-});
-/**
- * Get logs for a specific subagent
- */
-export const getBySubagent = query({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-        limit: v.optional(v.number()),
-    },
-    handler: async (ctx, { token, subagentId, limit = 20 }) => {
-        // Verify session
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session)
-            return null;
-        // Get API logs for this subagent
-        const apiLogs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_subagentId", (q) => q.eq("subagentId", subagentId))
-            .order("desc")
-            .take(limit);
-        // Get search logs for this subagent  
-        const searchLogs = await ctx.db
-            .query("searchLogs")
-            .filter((q) => q.eq(q.field("subagentId"), subagentId))
-            .order("desc")
-            .take(limit);
-        // Merge and sort by timestamp
-        const combined = [
-            ...apiLogs.map(l => ({
-                ...l,
-                type: "direct_call",
-                timestamp: l.createdAt
-            })),
-            ...searchLogs.map(l => ({
-                ...l,
-                type: "search",
-                timestamp: l.timestamp
-            })),
-        ].sort((a, b) => (b.timestamp || 0) - (a.timestamp || 0));
-        return combined.slice(0, limit);
-    },
-});
-/**
- * Clear all logs for a workspace (admin cleanup)
- */
-export const clearWorkspaceLogs = mutation({
-    args: {
-        token: v.string(),
-    },
-    handler: async (ctx, { token }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session)
-            throw new Error("Invalid session");
-        // Delete all apiLogs
-        const apiLogs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_workspaceId", (q) => q.eq("workspaceId", session.workspaceId))
-            .collect();
-        for (const log of apiLogs) {
-            await ctx.db.delete(log._id);
-        }
-        // Delete all searchLogs
-        const searchLogs = await ctx.db
-            .query("searchLogs")
-            .withIndex("by_workspaceId", (q) => q.eq("workspaceId", session.workspaceId))
-            .collect();
-        for (const log of searchLogs) {
-            await ctx.db.delete(log._id);
-        }
-        return {
-            deleted: {
-                apiLogs: apiLogs.length,
-                searchLogs: searchLogs.length
-            }
-        };
-    },
-});
-// Log proxy API calls from external agents (Hivr bees)
-export const createProxyLog = mutation({
-    args: {
-        workspaceId: v.id("workspaces"),
-        provider: v.string(),
-        action: v.string(),
-        subagentId: v.optional(v.string()),
-        sessionToken: v.optional(v.string()),
-    },
-    handler: async (ctx, { workspaceId, provider, action, subagentId, sessionToken }) => {
-        const now = Date.now();
-        await ctx.db.insert("apiLogs", {
-            workspaceId,
-            provider,
-            action,
-            subagentId: subagentId || "unknown",
-            sessionToken: sessionToken || "proxy",
-            status: "success",
-            latencyMs: 0, // Proxy calls don't track latency
-            createdAt: now,
-        });
-        // Update workspace lastActiveAt (main agent activity)
-        await ctx.db.patch(workspaceId, { lastActiveAt: now });
-        // If this is a subagent call, update that subagent's timestamp
-        if (subagentId && subagentId !== "unknown" && subagentId !== "main") {
-            const subagent = await ctx.db
-                .query("subagents")
-                .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", workspaceId).eq("subagentId", subagentId))
-                .first();
-            if (subagent) {
-                await ctx.db.patch(subagent._id, { lastActiveAt: now });
-            }
-        }
-        return { success: true };
-    },
-});
-//# sourceMappingURL=logs.js.map

package/convex/mou.d.ts

@@ -1,6 +0,0 @@
-export declare const getByPartnerId: any;
-export declare const create: any;
-export declare const sign: any;
-export declare const list: any;
-export declare const remove: any;
-//# sourceMappingURL=mou.d.ts.map

package/convex/mou.js

@@ -1,82 +0,0 @@
-import { v } from "convex/values";
-import { query, mutation } from "./_generated/server";
-// Get MOU by partnerId
-export const getByPartnerId = query({
-    args: { partnerId: v.string() },
-    handler: async (ctx, args) => {
-        return await ctx.db
-            .query("mouDocuments")
-            .withIndex("by_partnerId", (q) => q.eq("partnerId", args.partnerId))
-            .first();
-    },
-});
-// Create new MOU document
-export const create = mutation({
-    args: {
-        partnerId: v.string(),
-        partnerName: v.string(),
-        partnerEmail: v.string(),
-        documentHtml: v.string(),
-    },
-    handler: async (ctx, args) => {
-        return await ctx.db.insert("mouDocuments", {
-            ...args,
-            status: "pending",
-            createdAt: Date.now(),
-        });
-    },
-});
-// Sign MOU
-export const sign = mutation({
-    args: {
-        partnerId: v.string(),
-        signatureDataUrl: v.string(),
-        signerName: v.string(),
-        signerTitle: v.string(),
-        signerIp: v.optional(v.string()),
-    },
-    handler: async (ctx, args) => {
-        const mou = await ctx.db
-            .query("mouDocuments")
-            .withIndex("by_partnerId", (q) => q.eq("partnerId", args.partnerId))
-            .first();
-        if (!mou) {
-            throw new Error("MOU not found");
-        }
-        if (mou.status === "signed") {
-            throw new Error("MOU already signed");
-        }
-        await ctx.db.patch(mou._id, {
-            status: "signed",
-            signedAt: Date.now(),
-            signatureDataUrl: args.signatureDataUrl,
-            signerName: args.signerName,
-            signerTitle: args.signerTitle,
-            signerIp: args.signerIp,
-        });
-        return { success: true };
-    },
-});
-// List all MOUs (admin)
-export const list = query({
-    args: {},
-    handler: async (ctx) => {
-        return await ctx.db.query("mouDocuments").collect();
-    },
-});
-// Delete MOU (admin)
-export const remove = mutation({
-    args: { partnerId: v.string() },
-    handler: async (ctx, args) => {
-        const mou = await ctx.db
-            .query("mouDocuments")
-            .withIndex("by_partnerId", (q) => q.eq("partnerId", args.partnerId))
-            .first();
-        if (mou) {
-            await ctx.db.delete(mou._id);
-            return { success: true, deleted: args.partnerId };
-        }
-        return { success: false, message: "MOU not found" };
-    },
-});
-//# sourceMappingURL=mou.js.map

package/convex/providerKeys.d.ts

@@ -1,31 +0,0 @@
-export declare const BYOK_PROVIDERS: readonly [{
-    readonly id: "brave_search";
-    readonly name: "Brave Search";
-    readonly icon: "🔍";
-}, {
-    readonly id: "openrouter";
-    readonly name: "OpenRouter";
-    readonly icon: "🤖";
-}, {
-    readonly id: "elevenlabs";
-    readonly name: "ElevenLabs";
-    readonly icon: "🎙️";
-}, {
-    readonly id: "twilio";
-    readonly name: "Twilio";
-    readonly icon: "📞";
-}, {
-    readonly id: "resend";
-    readonly name: "Resend";
-    readonly icon: "📧";
-}, {
-    readonly id: "e2b";
-    readonly name: "E2B";
-    readonly icon: "💻";
-}];
-export declare const addKey: any;
-export declare const removeKey: any;
-export declare const getKeys: any;
-export declare const getKeyForExecution: any;
-export declare const getSupportedProviders: any;
-//# sourceMappingURL=providerKeys.d.ts.map