@nordsym/apiclaw 1.5.18 → 1.5.19

package/convex/agents.js

@@ -1,499 +0,0 @@
-import { v } from "convex/values";
-import { mutation, query } from "./_generated/server";
-// ============================================
-// AGENT NAME GENERATION
-// ============================================
-const ADJECTIVES = [
-    "Crimson", "Azure", "Golden", "Silver", "Obsidian",
-    "Emerald", "Sapphire", "Violet", "Amber", "Jade",
-    "Scarlet", "Cobalt", "Onyx", "Ruby", "Pearl",
-    "Shadow", "Storm", "Frost", "Blaze", "Thunder",
-    "Swift", "Silent", "Bright", "Dark", "Wild",
-    "Noble", "Fierce", "Cosmic", "Quantum", "Neural",
-];
-const NOUNS = [
-    "Phoenix", "Falcon", "Dragon", "Wolf", "Raven",
-    "Serpent", "Tiger", "Hawk", "Panther", "Lynx",
-    "Cipher", "Vector", "Prism", "Nexus", "Core",
-    "Agent", "Oracle", "Sentinel", "Phantom", "Vanguard",
-    "Forge", "Spark", "Pulse", "Echo", "Byte",
-    "Matrix", "Vertex", "Helix", "Nova", "Zenith",
-];
-function generateAgentName() {
-    const adj = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
-    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
-    return `${adj} ${noun}`;
-}
-function generateUUID() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-        const r = Math.random() * 16 | 0;
-        const v = c === 'x' ? r : (r & 0x3 | 0x8);
-        return v.toString(16);
-    });
-}
-// ============================================
-// MAIN AGENT QUERIES
-// ============================================
-/**
- * Get main agent info for a workspace
- */
-export const getMainAgent = query({
-    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) {
-            return null;
-        }
-        const workspace = await ctx.db.get(session.workspaceId);
-        if (!workspace) {
-            return null;
-        }
-        return {
-            workspaceId: workspace._id,
-            email: workspace.email,
-            mainAgentId: workspace.mainAgentId || null,
-            mainAgentName: workspace.mainAgentName || null,
-            aiBackend: workspace.aiBackend || null,
-            usageCount: workspace.usageCount,
-            createdAt: workspace.createdAt,
-        };
-    },
-});
-/**
- * Rename the main agent
- */
-export const renameMainAgent = mutation({
-    args: {
-        token: v.string(),
-        name: v.string(),
-    },
-    handler: async (ctx, { token, name }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session");
-        }
-        const workspace = await ctx.db.get(session.workspaceId);
-        if (!workspace) {
-            throw new Error("Workspace not found");
-        }
-        // Validate name length
-        const trimmedName = name.trim();
-        if (trimmedName.length < 2 || trimmedName.length > 50) {
-            throw new Error("Name must be between 2 and 50 characters");
-        }
-        await ctx.db.patch(workspace._id, {
-            mainAgentName: trimmedName,
-            updatedAt: Date.now(),
-        });
-        return { success: true, name: trimmedName };
-    },
-});
-/**
- * Initialize main agent (auto-generate name and ID if not set)
- * Called on first API call
- */
-export const ensureMainAgent = mutation({
-    args: { workspaceId: v.id("workspaces") },
-    handler: async (ctx, { workspaceId }) => {
-        const workspace = await ctx.db.get(workspaceId);
-        if (!workspace) {
-            throw new Error("Workspace not found");
-        }
-        // Already initialized
-        if (workspace.mainAgentId && workspace.mainAgentName) {
-            return {
-                mainAgentId: workspace.mainAgentId,
-                mainAgentName: workspace.mainAgentName,
-                created: false,
-            };
-        }
-        const mainAgentId = workspace.mainAgentId || generateUUID();
-        const mainAgentName = workspace.mainAgentName || generateAgentName();
-        await ctx.db.patch(workspaceId, {
-            mainAgentId,
-            mainAgentName,
-            updatedAt: Date.now(),
-        });
-        return {
-            mainAgentId,
-            mainAgentName,
-            created: true,
-        };
-    },
-});
-// ============================================
-// SUBAGENT QUERIES
-// ============================================
-/**
- * Get all subagents for a workspace
- */
-export const getSubagents = query({
-    args: {
-        token: v.string(),
-        limit: v.optional(v.number()),
-    },
-    handler: async (ctx, { token, limit = 50 }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            return { subagents: [], total: 0 };
-        }
-        const subagents = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId", (q) => q.eq("workspaceId", session.workspaceId))
-            .order("desc")
-            .take(limit);
-        // Sort by lastActiveAt descending
-        const sorted = subagents.sort((a, b) => b.lastActiveAt - a.lastActiveAt);
-        return {
-            subagents: sorted.map((s) => ({
-                id: s._id,
-                subagentId: s.subagentId,
-                name: s.name || s.subagentId,
-                callCount: s.callCount,
-                firstSeenAt: s.firstSeenAt,
-                lastActiveAt: s.lastActiveAt,
-            })),
-            total: subagents.length,
-        };
-    },
-});
-/**
- * Get stats for a specific subagent
- */
-export const getSubagentStats = query({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-    },
-    handler: async (ctx, { token, subagentId }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            return null;
-        }
-        const subagent = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", session.workspaceId).eq("subagentId", subagentId))
-            .first();
-        if (!subagent) {
-            return null;
-        }
-        // Get recent logs for this subagent
-        const logs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_subagentId", (q) => q.eq("subagentId", subagentId))
-            .order("desc")
-            .take(100);
-        const successCount = logs.filter((l) => l.status === "success").length;
-        const errorCount = logs.filter((l) => l.status === "error").length;
-        const avgLatency = logs.length > 0
-            ? Math.round(logs.reduce((sum, l) => sum + l.latencyMs, 0) / logs.length)
-            : 0;
-        // Group by provider
-        const byProvider = {};
-        for (const log of logs) {
-            byProvider[log.provider] = (byProvider[log.provider] || 0) + 1;
-        }
-        return {
-            subagentId: subagent.subagentId,
-            name: subagent.name || subagent.subagentId,
-            callCount: subagent.callCount,
-            successCount,
-            errorCount,
-            successRate: logs.length > 0 ? Math.round((successCount / logs.length) * 100) : 0,
-            avgLatency,
-            firstSeenAt: subagent.firstSeenAt,
-            lastActiveAt: subagent.lastActiveAt,
-            byProvider: Object.entries(byProvider)
-                .map(([provider, count]) => ({ provider, count }))
-                .sort((a, b) => b.count - a.count),
-        };
-    },
-});
-/**
- * Rename a subagent
- */
-export const renameSubagent = mutation({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-        name: v.string(),
-    },
-    handler: async (ctx, { token, subagentId, name }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session");
-        }
-        const subagent = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", session.workspaceId).eq("subagentId", subagentId))
-            .first();
-        if (!subagent) {
-            throw new Error("Subagent not found");
-        }
-        const trimmedName = name.trim();
-        if (trimmedName.length < 1 || trimmedName.length > 100) {
-            throw new Error("Name must be between 1 and 100 characters");
-        }
-        await ctx.db.patch(subagent._id, { name: trimmedName });
-        return { success: true, name: trimmedName };
-    },
-});
-/**
- * Track a subagent call (upsert subagent record)
- * Called when X-APIClaw-Subagent header is present
- */
-export const trackSubagentCall = mutation({
-    args: {
-        workspaceId: v.id("workspaces"),
-        subagentId: v.string(),
-    },
-    handler: async (ctx, { workspaceId, subagentId }) => {
-        const now = Date.now();
-        // Find existing subagent record
-        const existing = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", workspaceId).eq("subagentId", subagentId))
-            .first();
-        if (existing) {
-            // Increment call count
-            await ctx.db.patch(existing._id, {
-                callCount: existing.callCount + 1,
-                lastActiveAt: now,
-            });
-            return { id: existing._id, created: false };
-        }
-        // Create new subagent record
-        const id = await ctx.db.insert("subagents", {
-            workspaceId,
-            subagentId,
-            callCount: 1,
-            firstSeenAt: now,
-            lastActiveAt: now,
-        });
-        return { id, created: true };
-    },
-});
-// ============================================
-// AGGREGATE STATS
-// ============================================
-// ============================================
-// AGENT REGISTRATION & AI BACKEND TRACKING
-// ============================================
-/**
- * Pre-register a task agent (subagent)
- * Allows agents to be registered before they make their first call
- */
-export const registerTaskAgent = mutation({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-        name: v.optional(v.string()),
-        description: v.optional(v.string()),
-    },
-    handler: async (ctx, { token, subagentId, name, description }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session");
-        }
-        // Validate subagentId
-        const trimmedId = subagentId.trim();
-        if (trimmedId.length < 1 || trimmedId.length > 100) {
-            throw new Error("Subagent ID must be between 1 and 100 characters");
-        }
-        const now = Date.now();
-        // Check if already exists
-        const existing = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", session.workspaceId).eq("subagentId", trimmedId))
-            .first();
-        if (existing) {
-            // Update existing record
-            await ctx.db.patch(existing._id, {
-                name: name || existing.name,
-                description: description || existing.description,
-                isRegistered: true,
-                lastActiveAt: now,
-            });
-            return { id: existing._id, created: false };
-        }
-        // Create new subagent record
-        const id = await ctx.db.insert("subagents", {
-            workspaceId: session.workspaceId,
-            subagentId: trimmedId,
-            name: name,
-            description: description,
-            callCount: 0,
-            isRegistered: true,
-            firstSeenAt: now,
-            lastActiveAt: now,
-        });
-        return { id, created: true };
-    },
-});
-/**
- * Update AI backend for workspace or subagent
- * Called when X-APIClaw-AI-Backend header is present
- */
-export const updateAIBackend = mutation({
-    args: {
-        workspaceId: v.id("workspaces"),
-        subagentId: v.optional(v.string()),
-        aiBackend: v.string(),
-    },
-    handler: async (ctx, { workspaceId, subagentId, aiBackend }) => {
-        const now = Date.now();
-        if (subagentId) {
-            // Update subagent's AI backend
-            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, {
-                    aiBackend,
-                    lastActiveAt: now,
-                });
-            }
-        }
-        else {
-            // Update workspace's main agent AI backend
-            await ctx.db.patch(workspaceId, {
-                aiBackend,
-                aiBackendLastSeen: now,
-                updatedAt: now,
-            });
-        }
-        return { success: true };
-    },
-});
-// ============================================
-// AGGREGATE STATS
-// ============================================
-/**
- * Get agent overview for workspace (main + subagents summary)
- */
-export const getAgentOverview = query({
-    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) {
-            return null;
-        }
-        const workspace = await ctx.db.get(session.workspaceId);
-        if (!workspace) {
-            return null;
-        }
-        // Get all subagents
-        const subagents = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId", (q) => q.eq("workspaceId", session.workspaceId))
-            .collect();
-        // Calculate totals
-        const totalSubagentCalls = subagents.reduce((sum, s) => sum + s.callCount, 0);
-        const mainAgentCalls = workspace.usageCount - totalSubagentCalls;
-        // Get most active subagents (top 5)
-        const topSubagents = subagents
-            .sort((a, b) => b.callCount - a.callCount)
-            .slice(0, 5)
-            .map((s) => ({
-            subagentId: s.subagentId,
-            name: s.name || s.subagentId,
-            callCount: s.callCount,
-            lastActiveAt: s.lastActiveAt,
-        }));
-        return {
-            mainAgent: {
-                id: workspace.mainAgentId || null,
-                name: workspace.mainAgentName || "Unnamed Agent",
-                callCount: Math.max(0, mainAgentCalls), // Ensure non-negative
-            },
-            subagents: {
-                total: subagents.length,
-                totalCalls: totalSubagentCalls,
-                topActive: topSubagents,
-            },
-            totalCalls: workspace.usageCount,
-        };
-    },
-});
-/**
- * Delete a subagent
- */
-export const deleteSubagent = mutation({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-    },
-    handler: async (ctx, { token, subagentId }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session");
-        }
-        const subagent = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", session.workspaceId).eq("subagentId", subagentId))
-            .first();
-        if (!subagent) {
-            throw new Error("Subagent not found");
-        }
-        await ctx.db.delete(subagent._id);
-        return { success: true };
-    },
-});
-/**
- * Update subagent stats (call count, last active)
- * Internal helper for tracking
- */
-export const updateSubagentStats = mutation({
-    args: {
-        token: v.string(),
-        subagentId: v.string(),
-        incrementCalls: v.optional(v.number()),
-    },
-    handler: async (ctx, { token, subagentId, incrementCalls = 1 }) => {
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", token))
-            .first();
-        if (!session) {
-            throw new Error("Invalid session");
-        }
-        const subagent = await ctx.db
-            .query("subagents")
-            .withIndex("by_workspaceId_subagentId", (q) => q.eq("workspaceId", session.workspaceId).eq("subagentId", subagentId))
-            .first();
-        if (!subagent) {
-            throw new Error("Subagent not found");
-        }
-        await ctx.db.patch(subagent._id, {
-            callCount: (subagent.callCount || 0) + incrementCalls,
-            lastActiveAt: Date.now(),
-        });
-        return { success: true, newCallCount: (subagent.callCount || 0) + incrementCalls };
-    },
-});
-//# sourceMappingURL=agents.js.map

package/convex/analytics.d.ts

@@ -1,5 +0,0 @@
-export declare const log: any;
-export declare const getStats: any;
-export declare const getRecent: any;
-export declare const getProviderBreakdown: any;
-//# sourceMappingURL=analytics.d.ts.map

package/convex/analytics.js

@@ -1,166 +0,0 @@
-import { mutation, query } from "./_generated/server";
-import { v } from "convex/values";
-// Log an analytics event
-export const log = mutation({
-    args: {
-        event: v.string(),
-        provider: v.optional(v.string()),
-        query: v.optional(v.string()),
-        identifier: v.string(),
-        metadata: v.optional(v.any()),
-    },
-    handler: async (ctx, args) => {
-        return await ctx.db.insert("analytics", {
-            ...args,
-            timestamp: Date.now(),
-        });
-    },
-});
-// Get stats for dashboard
-export const getStats = query({
-    args: {
-        hoursBack: v.optional(v.number()),
-    },
-    handler: async (ctx, args) => {
-        const hoursBack = args.hoursBack || 24;
-        const since = Date.now() - hoursBack * 3600000;
-        const events = await ctx.db
-            .query("analytics")
-            .withIndex("by_timestamp")
-            .filter((q) => q.gte(q.field("timestamp"), since))
-            .collect();
-        // Aggregate stats
-        const stats = {
-            totalEvents: events.length,
-            discoveries: events.filter((e) => e.event === "discovery").length,
-            instantCalls: events.filter((e) => e.event === "instant").length,
-            uniqueUsers: new Set(events.map((e) => e.identifier)).size,
-            byProvider: {},
-            topQueries: [],
-            hourly: [],
-        };
-        // By provider
-        for (const event of events.filter((e) => e.provider)) {
-            stats.byProvider[event.provider] = (stats.byProvider[event.provider] || 0) + 1;
-        }
-        // Top queries
-        const queryCounts = {};
-        for (const event of events.filter((e) => e.query)) {
-            queryCounts[event.query] = (queryCounts[event.query] || 0) + 1;
-        }
-        stats.topQueries = Object.entries(queryCounts)
-            .sort(([, a], [, b]) => b - a)
-            .slice(0, 10)
-            .map(([query, count]) => ({ query, count }));
-        // Hourly breakdown
-        const hourlyCounts = {};
-        for (const event of events) {
-            const hour = new Date(event.timestamp).toISOString().slice(0, 13);
-            hourlyCounts[hour] = (hourlyCounts[hour] || 0) + 1;
-        }
-        stats.hourly = Object.entries(hourlyCounts)
-            .sort(([a], [b]) => a.localeCompare(b))
-            .map(([hour, count]) => ({ hour, count }));
-        return stats;
-    },
-});
-// Get recent events for live feed
-export const getRecent = query({
-    args: {
-        limit: v.optional(v.number()),
-    },
-    handler: async (ctx, args) => {
-        const limit = args.limit || 50;
-        return await ctx.db
-            .query("analytics")
-            .withIndex("by_timestamp")
-            .order("desc")
-            .take(limit);
-    },
-});
-// Get provider breakdown for Agent Analytics (workspace-specific)
-export const getProviderBreakdown = query({
-    args: {
-        token: v.string(),
-        periodDays: v.optional(v.number()),
-    },
-    handler: async (ctx, args) => {
-        const periodDays = args.periodDays || 7;
-        const since = Date.now() - periodDays * 24 * 3600000;
-        // Verify session and get workspace
-        const session = await ctx.db
-            .query("agentSessions")
-            .withIndex("by_sessionToken", (q) => q.eq("sessionToken", args.token))
-            .first();
-        if (!session) {
-            return null;
-        }
-        // Get all API logs for this workspace
-        const logs = await ctx.db
-            .query("apiLogs")
-            .withIndex("by_workspaceId_createdAt", (q) => q.eq("workspaceId", session.workspaceId))
-            .filter((q) => q.gte(q.field("createdAt"), since))
-            .collect();
-        if (logs.length === 0) {
-            return null; // Return null so frontend knows to show empty state, not preview
-        }
-        // Aggregate stats
-        const totalCalls = logs.length;
-        const successCount = logs.filter((l) => l.status === "success").length;
-        const failureCount = logs.filter((l) => l.status === "error").length;
-        const totalLatency = logs.reduce((sum, l) => sum + (l.latencyMs || 0), 0);
-        const avgLatency = totalCalls > 0 ? Math.round(totalLatency / totalCalls) : 0;
-        // Provider breakdown
-        const byProvider = {};
-        for (const log of logs) {
-            if (!byProvider[log.provider]) {
-                byProvider[log.provider] = { count: 0, latency: 0 };
-            }
-            byProvider[log.provider].count++;
-            byProvider[log.provider].latency += log.latencyMs || 0;
-        }
-        // Agent breakdown (by subagentId)
-        const byAgent = {};
-        for (const log of logs) {
-            const agent = log.subagentId || "main";
-            byAgent[agent] = (byAgent[agent] || 0) + 1;
-        }
-        // Action breakdown
-        const byAction = {};
-        for (const log of logs) {
-            const key = `${log.provider}:${log.action}`;
-            byAction[key] = (byAction[key] || 0) + 1;
-        }
-        // Time series (daily)
-        const dailyCounts = {};
-        for (const log of logs) {
-            const day = new Date(log.createdAt).toISOString().slice(0, 10);
-            dailyCounts[day] = (dailyCounts[day] || 0) + 1;
-        }
-        return {
-            totalCalls,
-            successCount,
-            failureCount,
-            successRate: totalCalls > 0 ? (successCount / totalCalls) * 100 : 0,
-            avgLatency,
-            byProvider: Object.entries(byProvider).map(([name, data]) => ({
-                name,
-                count: data.count,
-                avgLatency: data.count > 0 ? Math.round(data.latency / data.count) : 0,
-            })).sort((a, b) => b.count - a.count),
-            byAgent: Object.entries(byAgent).map(([name, count]) => ({
-                name,
-                count,
-            })).sort((a, b) => b.count - a.count),
-            byAction: Object.entries(byAction).map(([name, count]) => ({
-                name,
-                count,
-            })).sort((a, b) => b.count - a.count).slice(0, 10),
-            timeSeries: Object.entries(dailyCounts)
-                .sort(([a], [b]) => a.localeCompare(b))
-                .map(([date, count]) => ({ date, count })),
-            isPreview: false,
-        };
-    },
-});
-//# sourceMappingURL=analytics.js.map