@agentforge-ai/cli 0.4.3 → 0.5.1

package/dist/default/convex/schema.ts

@@ -1,24 +1,15 @@
 import { defineSchema, defineTable } from "convex/server";
 import { v } from "convex/values";
 
-/**
- * AgentForge Database Schema
- *
- * This schema defines all the tables needed for your AgentForge project.
- * Customize it to fit your needs — add new tables, fields, or indexes.
- *
- * IMPORTANT: Index names cannot be "by_id" or "by_creation_time" (reserved by Convex).
- * Use camelCase names like "byAgentId", "byUserId", etc.
- */
 export default defineSchema({
-  // ─── Agent Definitions ───────────────────────────────────────────────
+  // Core agent definitions
   agents: defineTable({
     id: v.string(),
     name: v.string(),
     description: v.optional(v.string()),
     instructions: v.string(),
     model: v.string(),
-    provider: v.string(),
+    provider: v.string(), // "openai", "openrouter", "anthropic", etc.
     tools: v.optional(v.any()),
     temperature: v.optional(v.number()),
     maxTokens: v.optional(v.number()),
@@ -32,22 +23,21 @@ export default defineSchema({
     .index("byUserId", ["userId"])
     .index("byIsActive", ["isActive"]),
 
-  // ─── Conversation Threads ────────────────────────────────────────────
+  // Conversation threads
   threads: defineTable({
     name: v.optional(v.string()),
     agentId: v.string(),
     userId: v.optional(v.string()),
-    projectId: v.optional(v.string()),
-    status: v.string(),
+    projectId: v.optional(v.id("projects")),
     metadata: v.optional(v.any()),
     createdAt: v.number(),
     updatedAt: v.number(),
   })
     .index("byAgentId", ["agentId"])
     .index("byUserId", ["userId"])
-    .index("byStatus", ["status"]),
+    .index("byProjectId", ["projectId"]),
 
-  // ─── Messages ────────────────────────────────────────────────────────
+  // Messages in threads
   messages: defineTable({
     threadId: v.id("threads"),
     role: v.union(
@@ -57,113 +47,143 @@ export default defineSchema({
       v.literal("tool")
     ),
     content: v.string(),
-    toolCalls: v.optional(v.any()),
-    toolResults: v.optional(v.any()),
-    tokenUsage: v.optional(v.any()),
-    model: v.optional(v.string()),
-    provider: v.optional(v.string()),
-    timestamp: v.number(),
-  })
-    .index("byThreadId", ["threadId"])
-    .index("byTimestamp", ["timestamp"]),
+    tool_calls: v.optional(v.any()),
+    tool_results: v.optional(v.any()),
+    metadata: v.optional(v.any()),
+    createdAt: v.number(),
+  }).index("byThread", ["threadId"]),
 
-  // ─── Sessions ────────────────────────────────────────────────────────
+  // Active sessions
   sessions: defineTable({
-    name: v.string(),
+    sessionId: v.string(),
+    threadId: v.id("threads"),
     agentId: v.string(),
-    threadId: v.optional(v.id("threads")),
-    status: v.string(),
     userId: v.optional(v.string()),
+    status: v.union(
+      v.literal("active"),
+      v.literal("paused"),
+      v.literal("completed"),
+      v.literal("error")
+    ),
+    channel: v.optional(v.string()), // "dashboard", "api", "webhook", etc.
+    metadata: v.optional(v.any()),
     startedAt: v.number(),
     lastActivityAt: v.number(),
-    metadata: v.optional(v.any()),
+    completedAt: v.optional(v.number()),
   })
+    .index("bySessionId", ["sessionId"])
+    .index("byThreadId", ["threadId"])
     .index("byAgentId", ["agentId"])
-    .index("byUserId", ["userId"])
-    .index("byStatus", ["status"]),
+    .index("byStatus", ["status"])
+    .index("byUserId", ["userId"]),
 
-  // ─── Files ───────────────────────────────────────────────────────────
+  // File storage metadata (files stored in Cloudflare R2)
   files: defineTable({
     name: v.string(),
-    folderId: v.optional(v.string()),
+    originalName: v.string(),
     mimeType: v.string(),
     size: v.number(),
-    storageId: v.optional(v.string()),
-    url: v.optional(v.string()),
+    url: v.string(), // Cloudflare R2 URL
+    folderId: v.optional(v.id("folders")),
+    projectId: v.optional(v.id("projects")),
     userId: v.optional(v.string()),
-    projectId: v.optional(v.string()),
-    createdAt: v.number(),
+    uploadedAt: v.number(),
+    metadata: v.optional(v.any()),
   })
     .index("byFolderId", ["folderId"])
-    .index("byUserId", ["userId"])
-    .index("byProjectId", ["projectId"]),
+    .index("byProjectId", ["projectId"])
+    .index("byUserId", ["userId"]),
 
-  // ─── Folders ─────────────────────────────────────────────────────────
+  // Folder organization
   folders: defineTable({
     name: v.string(),
-    parentId: v.optional(v.string()),
+    parentId: v.optional(v.id("folders")),
+    projectId: v.optional(v.id("projects")),
     userId: v.optional(v.string()),
-    projectId: v.optional(v.string()),
     createdAt: v.number(),
+    updatedAt: v.number(),
   })
     .index("byParentId", ["parentId"])
+    .index("byProjectId", ["projectId"])
     .index("byUserId", ["userId"]),
 
-  // ─── Projects / Workspaces ───────────────────────────────────────────
+  // Projects/Workspaces
   projects: defineTable({
     name: v.string(),
     description: v.optional(v.string()),
-    status: v.string(),
     userId: v.optional(v.string()),
     settings: v.optional(v.any()),
     createdAt: v.number(),
     updatedAt: v.number(),
-  })
-    .index("byUserId", ["userId"])
-    .index("byStatus", ["status"]),
+  }).index("byUserId", ["userId"]),
 
-  // ─── Skills ──────────────────────────────────────────────────────────
+  // Skills/Tools marketplace
   skills: defineTable({
     name: v.string(),
-    description: v.optional(v.string()),
+    displayName: v.string(),
+    description: v.string(),
     category: v.string(),
     version: v.string(),
+    author: v.optional(v.string()),
+    repository: v.optional(v.string()),
+    documentation: v.optional(v.string()),
+    code: v.string(), // The actual skill code
+    schema: v.optional(v.any()), // JSON schema for skill parameters
     isInstalled: v.boolean(),
-    configuration: v.optional(v.any()),
-    agentId: v.optional(v.string()),
+    isEnabled: v.boolean(),
     userId: v.optional(v.string()),
+    installedAt: v.optional(v.number()),
     createdAt: v.number(),
     updatedAt: v.number(),
   })
-    .index("byAgentId", ["agentId"])
-    .index("byCategory", ["category"])
-    .index("byIsInstalled", ["isInstalled"]),
+    .index("byUserId", ["userId"])
+    .index("byIsInstalled", ["isInstalled"])
+    .index("byCategory", ["category"]),
 
-  // ─── Cron Jobs ───────────────────────────────────────────────────────
+  // Cron jobs/scheduled tasks
   cronJobs: defineTable({
     name: v.string(),
-    schedule: v.string(),
+    description: v.optional(v.string()),
+    schedule: v.string(), // Cron expression
     agentId: v.string(),
-    action: v.string(),
+    prompt: v.string(), // What to execute
     isEnabled: v.boolean(),
-    lastRunAt: v.optional(v.number()),
-    nextRunAt: v.optional(v.number()),
+    lastRun: v.optional(v.number()),
+    nextRun: v.optional(v.number()),
     userId: v.optional(v.string()),
+    metadata: v.optional(v.any()),
     createdAt: v.number(),
     updatedAt: v.number(),
   })
     .index("byAgentId", ["agentId"])
+    .index("byUserId", ["userId"])
     .index("byIsEnabled", ["isEnabled"])
-    .index("byUserId", ["userId"]),
+    .index("byNextRun", ["nextRun"]),
+
+  // Cron job execution history
+  cronJobRuns: defineTable({
+    cronJobId: v.id("cronJobs"),
+    status: v.union(
+      v.literal("success"),
+      v.literal("failed"),
+      v.literal("running")
+    ),
+    startedAt: v.number(),
+    completedAt: v.optional(v.number()),
+    output: v.optional(v.string()),
+    error: v.optional(v.string()),
+  })
+    .index("byCronJobId", ["cronJobId"])
+    .index("byStatus", ["status"]),
 
-  // ─── MCP Connections ─────────────────────────────────────────────────
+  // MCP (Model Context Protocol) connections
   mcpConnections: defineTable({
     name: v.string(),
-    type: v.string(),
-    endpoint: v.string(),
+    serverUrl: v.string(),
+    protocol: v.string(), // "mcp", "custom"
     isConnected: v.boolean(),
     isEnabled: v.boolean(),
-    credentials: v.optional(v.any()),
+    credentials: v.optional(v.any()), // Encrypted
     capabilities: v.optional(v.any()),
     userId: v.optional(v.string()),
     lastConnectedAt: v.optional(v.number()),
@@ -173,9 +193,9 @@ export default defineSchema({
     .index("byUserId", ["userId"])
     .index("byIsEnabled", ["isEnabled"]),
 
-  // ─── API Keys ────────────────────────────────────────────────────────
+  // API keys and credentials (encrypted)
   apiKeys: defineTable({
-    provider: v.string(),
+    provider: v.string(), // "openai", "openrouter", "anthropic", etc.
     keyName: v.string(),
     encryptedKey: v.string(),
     isActive: v.boolean(),
@@ -187,7 +207,7 @@ export default defineSchema({
     .index("byUserId", ["userId"])
     .index("byIsActive", ["isActive"]),
 
-  // ─── Usage Tracking ──────────────────────────────────────────────────
+  // Usage tracking for metrics
   usage: defineTable({
     agentId: v.string(),
     sessionId: v.optional(v.string()),
@@ -196,7 +216,7 @@ export default defineSchema({
     promptTokens: v.number(),
     completionTokens: v.number(),
     totalTokens: v.number(),
-    cost: v.optional(v.number()),
+    cost: v.optional(v.number()), // Estimated cost in USD
     userId: v.optional(v.string()),
     timestamp: v.number(),
   })
@@ -205,7 +225,7 @@ export default defineSchema({
     .index("byTimestamp", ["timestamp"])
     .index("byProvider", ["provider"]),
 
-  // ─── Settings ────────────────────────────────────────────────────────
+  // User settings and configuration
   settings: defineTable({
     userId: v.string(),
     key: v.string(),
@@ -215,7 +235,7 @@ export default defineSchema({
     .index("byUserId", ["userId"])
     .index("byUserIdAndKey", ["userId", "key"]),
 
-  // ─── System Logs ─────────────────────────────────────────────────────
+  // System logs for debugging
   logs: defineTable({
     level: v.union(
       v.literal("debug"),
@@ -223,7 +243,7 @@ export default defineSchema({
       v.literal("warn"),
       v.literal("error")
     ),
-    source: v.string(),
+    source: v.string(), // "agent", "system", "api", etc.
     message: v.string(),
     metadata: v.optional(v.any()),
     userId: v.optional(v.string()),
@@ -231,16 +251,31 @@ export default defineSchema({
   })
     .index("byLevel", ["level"])
     .index("bySource", ["source"])
-    .index("byTimestamp", ["timestamp"]),
+    .index("byTimestamp", ["timestamp"])
+    .index("byUserId", ["userId"]),
+
+  // Channels for multi-platform support
+  channels: defineTable({
+    name: v.string(),
+    type: v.string(), // "dashboard", "api", "webhook", "whatsapp", etc.
+    isEnabled: v.boolean(),
+    configuration: v.optional(v.any()),
+    userId: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byType", ["type"])
+    .index("byUserId", ["userId"])
+    .index("byIsEnabled", ["isEnabled"]),
 
-  // ─── Heartbeat (Task Continuation) ───────────────────────────────────
+  // Heartbeat system for ongoing task tracking
   heartbeats: defineTable({
     agentId: v.string(),
     threadId: v.optional(v.id("threads")),
-    status: v.string(),
+    status: v.string(), // "active", "waiting", "completed", "error"
     currentTask: v.optional(v.string()),
     pendingTasks: v.array(v.string()),
-    context: v.string(),
+    context: v.string(), // Markdown-formatted context
     lastCheck: v.number(),
     nextCheck: v.number(),
     metadata: v.optional(v.any()),
@@ -249,14 +284,14 @@ export default defineSchema({
     .index("byStatus", ["status"])
     .index("byNextCheck", ["nextCheck"]),
 
-  // ─── Secure Vault ────────────────────────────────────────────────────
+  // Secure Vault for encrypted secrets storage
   vault: defineTable({
-    name: v.string(),
-    category: v.string(),
-    provider: v.optional(v.string()),
-    encryptedValue: v.string(),
-    iv: v.string(),
-    maskedValue: v.string(),
+    name: v.string(), // Display name (e.g., "OpenAI API Key")
+    category: v.string(), // "api_key", "token", "secret", "credential"
+    provider: v.optional(v.string()), // Associated provider
+    encryptedValue: v.string(), // AES-256-GCM encrypted value
+    iv: v.string(), // Initialization vector for decryption
+    maskedValue: v.string(), // e.g., "sk-...abc123"
     isActive: v.boolean(),
     expiresAt: v.optional(v.number()),
     lastAccessedAt: v.optional(v.number()),
@@ -269,4 +304,36 @@ export default defineSchema({
     .index("byCategory", ["category"])
     .index("byProvider", ["provider"])
     .index("byIsActive", ["isActive"]),
+
+  // Audit log for vault access
+  vaultAuditLog: defineTable({
+    vaultEntryId: v.id("vault"),
+    action: v.string(), // "created", "accessed", "updated", "deleted", "auto_captured"
+    source: v.string(), // "dashboard", "chat", "api", "agent"
+    userId: v.optional(v.string()),
+    ipAddress: v.optional(v.string()),
+    timestamp: v.number(),
+  })
+    .index("byVaultEntryId", ["vaultEntryId"])
+    .index("byUserId", ["userId"])
+    .index("byTimestamp", ["timestamp"]),
+
+  // Agent instances for multi-agent workflows
+  instances: defineTable({
+    agentId: v.string(),
+    instanceId: v.string(),
+    status: v.union(
+      v.literal("running"),
+      v.literal("stopped"),
+      v.literal("error")
+    ),
+    configuration: v.optional(v.any()),
+    userId: v.optional(v.string()),
+    startedAt: v.number(),
+    stoppedAt: v.optional(v.number()),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byInstanceId", ["instanceId"])
+    .index("byStatus", ["status"])
+    .index("byUserId", ["userId"]),
 });

package/dist/default/convex/sessions.ts

@@ -0,0 +1,174 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// Query: Get all sessions
+export const list = query({
+  args: {
+    userId: v.optional(v.string()),
+    agentId: v.optional(v.string()),
+    status: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    if (args.status) {
+      const sessions = await ctx.db
+        .query("sessions")
+        .withIndex("byStatus", (q) => q.eq("status", args.status! as any))
+        .collect();
+      
+      if (args.userId) {
+        return sessions.filter((s) => s.userId === args.userId);
+      }
+      if (args.agentId) {
+        return sessions.filter((s) => s.agentId === args.agentId);
+      }
+      return sessions;
+    }
+    
+    if (args.agentId) {
+      return await ctx.db
+        .query("sessions")
+        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId!))
+        .collect();
+    }
+    
+    if (args.userId) {
+      return await ctx.db
+        .query("sessions")
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
+    }
+    
+    return await ctx.db.query("sessions").collect();
+  },
+});
+
+// Query: Get session by ID
+export const get = query({
+  args: { sessionId: v.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("sessions")
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
+      .first();
+  },
+});
+
+// Query: Get active sessions
+export const listActive = query({
+  args: {
+    userId: v.optional(v.string()),
+  },
+  handler: async (ctx, args) => {
+    const sessions = await ctx.db
+      .query("sessions")
+      .withIndex("byStatus", (q) => q.eq("status", "active"))
+      .collect();
+    
+    if (args.userId) {
+      return sessions.filter((s) => s.userId === args.userId);
+    }
+    
+    return sessions;
+  },
+});
+
+// Mutation: Create a new session
+export const create = mutation({
+  args: {
+    sessionId: v.string(),
+    threadId: v.id("threads"),
+    agentId: v.string(),
+    userId: v.optional(v.string()),
+    channel: v.optional(v.string()),
+    metadata: v.optional(v.any()),
+  },
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    const sessionId = await ctx.db.insert("sessions", {
+      ...args,
+      status: "active",
+      startedAt: now,
+      lastActivityAt: now,
+    });
+    return sessionId;
+  },
+});
+
+// Mutation: Update session activity
+export const updateActivity = mutation({
+  args: {
+    sessionId: v.string(),
+    metadata: v.optional(v.any()),
+  },
+  handler: async (ctx, args) => {
+    const session = await ctx.db
+      .query("sessions")
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
+      .first();
+    
+    if (!session) {
+      throw new Error(`Session ${args.sessionId} not found`);
+    }
+    
+    await ctx.db.patch(session._id, {
+      lastActivityAt: Date.now(),
+      ...(args.metadata && { metadata: args.metadata }),
+    });
+    
+    return session._id;
+  },
+});
+
+// Mutation: Update session status
+export const updateStatus = mutation({
+  args: {
+    sessionId: v.string(),
+    status: v.union(
+      v.literal("active"),
+      v.literal("paused"),
+      v.literal("completed"),
+      v.literal("error")
+    ),
+  },
+  handler: async (ctx, args) => {
+    const session = await ctx.db
+      .query("sessions")
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
+      .first();
+    
+    if (!session) {
+      throw new Error(`Session ${args.sessionId} not found`);
+    }
+    
+    const updates: any = {
+      status: args.status,
+      lastActivityAt: Date.now(),
+    };
+    
+    if (args.status === "completed" || args.status === "error") {
+      updates.completedAt = Date.now();
+    }
+    
+    await ctx.db.patch(session._id, updates);
+    
+    return session._id;
+  },
+});
+
+// Mutation: Delete session
+export const remove = mutation({
+  args: { sessionId: v.string() },
+  handler: async (ctx, args) => {
+    const session = await ctx.db
+      .query("sessions")
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
+      .first();
+    
+    if (!session) {
+      throw new Error(`Session ${args.sessionId} not found`);
+    }
+    
+    await ctx.db.delete(session._id);
+    return { success: true };
+  },
+});

package/dist/default/convex/settings.ts

@@ -0,0 +1,79 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server";
+
+// Query: Get a setting by key
+export const get = query({
+  args: { userId: v.string(), key: v.string() },
+  handler: async (ctx, args) => {
+    const setting = await ctx.db
+      .query("settings")
+      .withIndex("byUserIdAndKey", (q) =>
+        q.eq("userId", args.userId!).eq("key", args.key!)
+      )
+      .first();
+    return setting;
+  },
+});
+
+// Query: List all settings for a user
+export const list = query({
+  args: { userId: v.optional(v.string()) },
+  handler: async (ctx, args) => {
+    if (args.userId) {
+      return await ctx.db
+        .query("settings")
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
+    }
+    return await ctx.db.query("settings").collect();
+  },
+});
+
+// Mutation: Set a setting (upsert)
+export const set = mutation({
+  args: {
+    userId: v.string(),
+    key: v.string(),
+    value: v.any(),
+  },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("settings")
+      .withIndex("byUserIdAndKey", (q) =>
+        q.eq("userId", args.userId!).eq("key", args.key!)
+      )
+      .first();
+
+    if (existing) {
+      await ctx.db.patch(existing._id, {
+        value: args.value,
+        updatedAt: Date.now(),
+      });
+      return existing._id;
+    }
+
+    return await ctx.db.insert("settings", {
+      userId: args.userId,
+      key: args.key,
+      value: args.value,
+      updatedAt: Date.now(),
+    });
+  },
+});
+
+// Mutation: Delete a setting
+export const remove = mutation({
+  args: { userId: v.string(), key: v.string() },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("settings")
+      .withIndex("byUserIdAndKey", (q) =>
+        q.eq("userId", args.userId!).eq("key", args.key!)
+      )
+      .first();
+
+    if (existing) {
+      await ctx.db.delete(existing._id);
+    }
+  },
+});