@agentforge-ai/cli 0.5.0 → 0.5.2

package/templates/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/templates/default/convex/sessions.ts

@@ -12,8 +12,8 @@ export const list = query({
     if (args.status) {
       const sessions = await ctx.db
         .query("sessions")
-        .withIndex("byStatus", (q) => q.eq("status", args.status as any))
-        .take(100).collect();
+        .withIndex("byStatus", (q) => q.eq("status", args.status! as any))
+        .collect();
       
       if (args.userId) {
         return sessions.filter((s) => s.userId === args.userId);
@@ -27,18 +27,18 @@ export const list = query({
     if (args.agentId) {
       return await ctx.db
         .query("sessions")
-        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId))
-        .take(100).collect();
+        .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))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     }
     
-    return await ctx.db.query("sessions").take(100).collect();
+    return await ctx.db.query("sessions").collect();
   },
 });
 
@@ -48,7 +48,7 @@ export const get = query({
   handler: async (ctx, args) => {
     return await ctx.db
       .query("sessions")
-      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId))
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
       .first();
   },
 });
@@ -62,7 +62,7 @@ export const listActive = query({
     const sessions = await ctx.db
       .query("sessions")
       .withIndex("byStatus", (q) => q.eq("status", "active"))
-      .take(100).collect();
+      .collect();
     
     if (args.userId) {
       return sessions.filter((s) => s.userId === args.userId);
@@ -103,7 +103,7 @@ export const updateActivity = mutation({
   handler: async (ctx, args) => {
     const session = await ctx.db
       .query("sessions")
-      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId))
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
       .first();
     
     if (!session) {
@@ -133,7 +133,7 @@ export const updateStatus = mutation({
   handler: async (ctx, args) => {
     const session = await ctx.db
       .query("sessions")
-      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId))
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
       .first();
     
     if (!session) {
@@ -161,7 +161,7 @@ export const remove = mutation({
   handler: async (ctx, args) => {
     const session = await ctx.db
       .query("sessions")
-      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId))
+      .withIndex("bySessionId", (q) => q.eq("sessionId", args.sessionId!))
       .first();
     
     if (!session) {

package/templates/default/convex/settings.ts

@@ -8,7 +8,7 @@ export const get = query({
     const setting = await ctx.db
       .query("settings")
       .withIndex("byUserIdAndKey", (q) =>
-        q.eq("userId", args.userId).eq("key", args.key)
+        q.eq("userId", args.userId!).eq("key", args.key!)
       )
       .first();
     return setting;
@@ -40,7 +40,7 @@ export const set = mutation({
     const existing = await ctx.db
       .query("settings")
       .withIndex("byUserIdAndKey", (q) =>
-        q.eq("userId", args.userId).eq("key", args.key)
+        q.eq("userId", args.userId!).eq("key", args.key!)
       )
       .first();
 
@@ -68,7 +68,7 @@ export const remove = mutation({
     const existing = await ctx.db
       .query("settings")
       .withIndex("byUserIdAndKey", (q) =>
-        q.eq("userId", args.userId).eq("key", args.key)
+        q.eq("userId", args.userId!).eq("key", args.key!)
       )
       .first();
 

package/templates/default/convex/skills.ts

@@ -12,8 +12,8 @@ export const list = query({
     if (args.category) {
       const skills = await ctx.db
         .query("skills")
-        .withIndex("byCategory", (q) => q.eq("category", args.category))
-        .take(100).collect();
+        .withIndex("byCategory", (q) => q.eq("category", args.category!))
+        .collect();
       
       if (args.userId) {
         return skills.filter((s) => s.userId === args.userId);
@@ -27,8 +27,8 @@ export const list = query({
     if (args.isInstalled !== undefined) {
       const skills = await ctx.db
         .query("skills")
-        .withIndex("byIsInstalled", (q) => q.eq("isInstalled", args.isInstalled))
-        .take(100).collect();
+        .withIndex("byIsInstalled", (q) => q.eq("isInstalled", args.isInstalled!))
+        .collect();
       
       if (args.userId) {
         return skills.filter((s) => s.userId === args.userId);
@@ -39,11 +39,11 @@ export const list = query({
     if (args.userId) {
       return await ctx.db
         .query("skills")
-        .withIndex("byUserId", (q) => q.eq("userId", args.userId))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     }
     
-    return await ctx.db.query("skills").take(100).collect();
+    return await ctx.db.query("skills").collect();
   },
 });
 
@@ -64,7 +64,7 @@ export const listInstalled = query({
     const skills = await ctx.db
       .query("skills")
       .withIndex("byIsInstalled", (q) => q.eq("isInstalled", true))
-      .take(100).collect();
+      .collect();
     
     if (args.userId) {
       return skills.filter((s) => s.userId === args.userId);

package/templates/default/convex/threads.ts

@@ -12,25 +12,25 @@ export const list = query({
     if (args.projectId) {
       return await ctx.db
         .query("threads")
-        .withIndex("byProjectId", (q) => q.eq("projectId", args.projectId))
-        .take(100).collect();
+        .withIndex("byProjectId", (q) => q.eq("projectId", args.projectId!))
+        .collect();
     }
     
     if (args.agentId) {
       return await ctx.db
         .query("threads")
-        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId))
-        .take(100).collect();
+        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId!))
+        .collect();
     }
     
     if (args.userId) {
       return await ctx.db
         .query("threads")
-        .withIndex("byUserId", (q) => q.eq("userId", args.userId))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     }
     
-    return await ctx.db.query("threads").take(100).collect();
+    return await ctx.db.query("threads").collect();
   },
 });
 
@@ -86,8 +86,8 @@ export const remove = mutation({
     // Delete all messages in the thread
     const messages = await ctx.db
       .query("messages")
-      .withIndex("byThread", (q) => q.eq("threadId", args.id))
-      .take(100).collect();
+      .withIndex("byThread", (q) => q.eq("threadId", args.id!))
+      .collect();
     
     for (const message of messages) {
       await ctx.db.delete(message._id);

package/templates/default/convex/usage.ts

@@ -16,20 +16,20 @@ export const list = query({
     if (args.provider) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byProvider", (q) => q.eq("provider", args.provider))
-        .take(100).collect();
+        .withIndex("byProvider", (q) => q.eq("provider", args.provider!))
+        .collect();
     } else if (args.agentId) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId))
-        .take(100).collect();
+        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId!))
+        .collect();
     } else if (args.userId) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byUserId", (q) => q.eq("userId", args.userId))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     } else {
-      records = await ctx.db.query("usage").take(100).collect();
+      records = await ctx.db.query("usage").collect();
     }
     
     // Filter by time range if provided
@@ -58,15 +58,15 @@ export const getStats = query({
     if (args.agentId) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId))
-        .take(100).collect();
+        .withIndex("byAgentId", (q) => q.eq("agentId", args.agentId!))
+        .collect();
     } else if (args.userId) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byUserId", (q) => q.eq("userId", args.userId))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     } else {
-      records = await ctx.db.query("usage").take(100).collect();
+      records = await ctx.db.query("usage").collect();
     }
     
     // Filter by time range
@@ -139,10 +139,10 @@ export const getByTimePeriod = query({
     if (args.userId) {
       records = await ctx.db
         .query("usage")
-        .withIndex("byUserId", (q) => q.eq("userId", args.userId))
-        .take(100).collect();
+        .withIndex("byUserId", (q) => q.eq("userId", args.userId!))
+        .collect();
     } else {
-      records = await ctx.db.query("usage").take(100).collect();
+      records = await ctx.db.query("usage").collect();
     }
     
     records = records.filter((r) => r.timestamp >= startTime);
@@ -182,7 +182,7 @@ export const cleanup = mutation({
     const records = await ctx.db
       .query("usage")
       .withIndex("byTimestamp")
-      .take(100).collect();
+      .collect();
     
     const toDelete = records.filter((r) => r.timestamp < args.olderThan);