@agentforge-ai/cli 0.3.2 → 0.4.0

package/dist/default/.env.example

@@ -1,8 +1,37 @@
-# OpenAI API Key (required for default model)
-OPENAI_API_KEY=sk-your-key-here
+# ─── Convex ─────────────────────────────────────────────────────────────
+# Your Convex deployment URL (set automatically by `npx convex dev`)
+CONVEX_URL=
 
-# E2B API Key (required for sandbox execution)
-E2B_API_KEY=e2b_your-key-here
+# ─── LLM Providers ─────────────────────────────────────────────────────
+# Set the API key for your preferred provider(s).
+# You only need ONE provider to get started.
 
-# Convex deployment URL (set automatically by `npx convex dev`)
-# CONVEX_URL=https://your-deployment.convex.cloud
+# OpenAI (https://platform.openai.com/api-keys)
+OPENAI_API_KEY=
+
+# OpenRouter — access 100+ models with one key (https://openrouter.ai/keys)
+OPENROUTER_API_KEY=
+
+# Anthropic (https://console.anthropic.com/)
+ANTHROPIC_API_KEY=
+
+# Google Gemini (https://aistudio.google.com/apikey)
+GOOGLE_API_KEY=
+
+# xAI / Grok (https://console.x.ai/)
+XAI_API_KEY=
+
+# ─── AgentForge Defaults ───────────────────────────────────────────────
+# Default provider: openai | openrouter | anthropic | google | xai
+AGENTFORGE_DEFAULT_PROVIDER=openai
+
+# Default model (provider-specific)
+AGENTFORGE_DEFAULT_MODEL=gpt-4o-mini
+
+# ─── Sandbox (Code Execution) ──────────────────────────────────────────
+# E2B API key for secure code execution (https://e2b.dev/)
+E2B_API_KEY=
+
+# ─── Dashboard ──────────────────────────────────────────────────────────
+# Port for the web dashboard (default: 3000)
+AGENTFORGE_DASHBOARD_PORT=3000

package/dist/default/README.md

@@ -1,30 +1,110 @@
 # My AgentForge Project
 
-Built with [AgentForge](https://github.com/Agentic-Engineering-Agency/agentforge) - The Minimalist Framework for Collaborative AI Agents.
+Built with [AgentForge](https://github.com/Agentic-Engineering-Agency/agentforge) — a NanoClaw made with Mastra.
 
-## Getting Started
+## Quick Start
 
 ```bash
-# Start the development server
-agentforge run
+# 1. Install dependencies
+npm install
 
-# Or use pnpm directly
-pnpm dev
+# 2. Set up your environment
+cp .env.example .env
+# Edit .env and add your API key (OpenAI, OpenRouter, Anthropic, etc.)
+
+# 3. Start the Convex dev server
+npx convex dev
+
+# 4. Start building!
+npm run dev
 ```
 
 ## Project Structure
 
 ```
 ├── convex/          # Convex schema and functions
-│   └── schema.ts    # Database schema (agents, threads, messages)
+│   └── schema.ts    # Database schema (agents, threads, messages, etc.)
 ├── src/
 │   └── agent.ts     # Your agent definition
+├── skills/          # Custom skills directory
+├── .env.example     # Environment variable template
 ├── package.json
 └── tsconfig.json
 ```
 
+## CLI Commands
+
+```bash
+# Agent Management
+agentforge agents list              # List all agents
+agentforge agents create            # Create a new agent (interactive)
+agentforge agents inspect <id>      # Show agent details
+agentforge agents edit <id>         # Edit an agent
+agentforge agents delete <id>       # Delete an agent
+
+# Chat
+agentforge chat <agent-id>          # Start chatting with an agent
+agentforge chat --session <id>      # Resume a session
+
+# Sessions & Threads
+agentforge sessions list            # List all sessions
+agentforge threads list             # List all threads
+
+# Skills
+agentforge skills list              # List installed skills
+agentforge skills install <name>    # Install a skill
+agentforge skills search <query>    # Search available skills
+
+# Cron Jobs
+agentforge cron list                # List cron jobs
+agentforge cron create              # Create a cron job (interactive)
+
+# MCP Connections
+agentforge mcp list                 # List MCP connections
+agentforge mcp add                  # Add a connection (interactive)
+agentforge mcp test <id>            # Test connection health
+
+# Files & Projects
+agentforge files list               # List files
+agentforge files upload <path>      # Upload a file
+agentforge projects list            # List projects
+agentforge projects create <name>   # Create a project
+
+# Configuration & Vault
+agentforge config list              # List all config
+agentforge vault list               # List secrets (masked)
+agentforge vault add <name> <value> # Store a secret
+
+# Utilities
+agentforge status                   # Show system health
+agentforge logs                     # Tail recent logs
+agentforge dashboard                # Open the web dashboard
+agentforge deploy                   # Deploy to production
+```
+
+## Providers
+
+AgentForge supports multiple LLM providers. Set your preferred provider in `.env`:
+
+| Provider | Model Format | API Key Variable |
+|----------|-------------|-----------------|
+| OpenAI | `openai:gpt-4o-mini` | `OPENAI_API_KEY` |
+| OpenRouter | `openrouter:anthropic/claude-3.5-sonnet` | `OPENROUTER_API_KEY` |
+| Anthropic | `anthropic:claude-3-5-sonnet-20241022` | `ANTHROPIC_API_KEY` |
+| Google | `google:gemini-2.0-flash` | `GOOGLE_API_KEY` |
+| xAI | `xai:grok-2` | `XAI_API_KEY` |
+
+## Web Dashboard
+
+Launch the dashboard for a visual interface:
+
+```bash
+agentforge dashboard
+```
+
 ## Learn More
 
 - [AgentForge Documentation](https://github.com/Agentic-Engineering-Agency/agentforge)
-- [Mastra Documentation](https://mastra.ai/docs)
-- [Convex Documentation](https://docs.convex.dev)
+- [CLI Reference](https://github.com/Agentic-Engineering-Agency/agentforge/blob/main/docs/cli-reference.md)
+- [Convex Docs](https://docs.convex.dev)
+- [Mastra Docs](https://mastra.ai/docs)

package/dist/default/convex/schema.ts

@@ -1,19 +1,53 @@
 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 ───────────────────────────────────────────────
   agents: defineTable({
     id: v.string(),
     name: v.string(),
+    description: v.optional(v.string()),
     instructions: v.string(),
     model: v.string(),
+    provider: v.string(),
     tools: v.optional(v.any()),
-  }).index("by_id", ["id"]),
+    temperature: v.optional(v.number()),
+    maxTokens: v.optional(v.number()),
+    topP: v.optional(v.number()),
+    isActive: v.boolean(),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    userId: v.optional(v.string()),
+  })
+    .index("byAgentId", ["id"])
+    .index("byUserId", ["userId"])
+    .index("byIsActive", ["isActive"]),
 
+  // ─── 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(),
+    metadata: v.optional(v.any()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byUserId", ["userId"])
+    .index("byStatus", ["status"]),
 
+  // ─── Messages ────────────────────────────────────────────────────────
   messages: defineTable({
     threadId: v.id("threads"),
     role: v.union(
@@ -23,6 +57,216 @@ export default defineSchema({
       v.literal("tool")
     ),
     content: v.string(),
-    tool_calls: v.optional(v.any()),
-  }).index("by_thread", ["threadId"]),
+    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"]),
+
+  // ─── Sessions ────────────────────────────────────────────────────────
+  sessions: defineTable({
+    name: v.string(),
+    agentId: v.string(),
+    threadId: v.optional(v.id("threads")),
+    status: v.string(),
+    userId: v.optional(v.string()),
+    startedAt: v.number(),
+    lastActivityAt: v.number(),
+    metadata: v.optional(v.any()),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byUserId", ["userId"])
+    .index("byStatus", ["status"]),
+
+  // ─── Files ───────────────────────────────────────────────────────────
+  files: defineTable({
+    name: v.string(),
+    folderId: v.optional(v.string()),
+    mimeType: v.string(),
+    size: v.number(),
+    storageId: v.optional(v.string()),
+    url: v.optional(v.string()),
+    userId: v.optional(v.string()),
+    projectId: v.optional(v.string()),
+    createdAt: v.number(),
+  })
+    .index("byFolderId", ["folderId"])
+    .index("byUserId", ["userId"])
+    .index("byProjectId", ["projectId"]),
+
+  // ─── Folders ─────────────────────────────────────────────────────────
+  folders: defineTable({
+    name: v.string(),
+    parentId: v.optional(v.string()),
+    userId: v.optional(v.string()),
+    projectId: v.optional(v.string()),
+    createdAt: v.number(),
+  })
+    .index("byParentId", ["parentId"])
+    .index("byUserId", ["userId"]),
+
+  // ─── 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"]),
+
+  // ─── Skills ──────────────────────────────────────────────────────────
+  skills: defineTable({
+    name: v.string(),
+    description: v.optional(v.string()),
+    category: v.string(),
+    version: v.string(),
+    isInstalled: v.boolean(),
+    configuration: v.optional(v.any()),
+    agentId: v.optional(v.string()),
+    userId: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byCategory", ["category"])
+    .index("byIsInstalled", ["isInstalled"]),
+
+  // ─── Cron Jobs ───────────────────────────────────────────────────────
+  cronJobs: defineTable({
+    name: v.string(),
+    schedule: v.string(),
+    agentId: v.string(),
+    action: v.string(),
+    isEnabled: v.boolean(),
+    lastRunAt: v.optional(v.number()),
+    nextRunAt: v.optional(v.number()),
+    userId: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byIsEnabled", ["isEnabled"])
+    .index("byUserId", ["userId"]),
+
+  // ─── MCP Connections ─────────────────────────────────────────────────
+  mcpConnections: defineTable({
+    name: v.string(),
+    type: v.string(),
+    endpoint: v.string(),
+    isConnected: v.boolean(),
+    isEnabled: v.boolean(),
+    credentials: v.optional(v.any()),
+    capabilities: v.optional(v.any()),
+    userId: v.optional(v.string()),
+    lastConnectedAt: v.optional(v.number()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byUserId", ["userId"])
+    .index("byIsEnabled", ["isEnabled"]),
+
+  // ─── API Keys ────────────────────────────────────────────────────────
+  apiKeys: defineTable({
+    provider: v.string(),
+    keyName: v.string(),
+    encryptedKey: v.string(),
+    isActive: v.boolean(),
+    userId: v.optional(v.string()),
+    createdAt: v.number(),
+    lastUsedAt: v.optional(v.number()),
+  })
+    .index("byProvider", ["provider"])
+    .index("byUserId", ["userId"])
+    .index("byIsActive", ["isActive"]),
+
+  // ─── Usage Tracking ──────────────────────────────────────────────────
+  usage: defineTable({
+    agentId: v.string(),
+    sessionId: v.optional(v.string()),
+    provider: v.string(),
+    model: v.string(),
+    promptTokens: v.number(),
+    completionTokens: v.number(),
+    totalTokens: v.number(),
+    cost: v.optional(v.number()),
+    userId: v.optional(v.string()),
+    timestamp: v.number(),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byUserId", ["userId"])
+    .index("byTimestamp", ["timestamp"])
+    .index("byProvider", ["provider"]),
+
+  // ─── Settings ────────────────────────────────────────────────────────
+  settings: defineTable({
+    userId: v.string(),
+    key: v.string(),
+    value: v.any(),
+    updatedAt: v.number(),
+  })
+    .index("byUserId", ["userId"])
+    .index("byUserIdAndKey", ["userId", "key"]),
+
+  // ─── System Logs ─────────────────────────────────────────────────────
+  logs: defineTable({
+    level: v.union(
+      v.literal("debug"),
+      v.literal("info"),
+      v.literal("warn"),
+      v.literal("error")
+    ),
+    source: v.string(),
+    message: v.string(),
+    metadata: v.optional(v.any()),
+    userId: v.optional(v.string()),
+    timestamp: v.number(),
+  })
+    .index("byLevel", ["level"])
+    .index("bySource", ["source"])
+    .index("byTimestamp", ["timestamp"]),
+
+  // ─── Heartbeat (Task Continuation) ───────────────────────────────────
+  heartbeats: defineTable({
+    agentId: v.string(),
+    threadId: v.optional(v.id("threads")),
+    status: v.string(),
+    currentTask: v.optional(v.string()),
+    pendingTasks: v.array(v.string()),
+    context: v.string(),
+    lastCheck: v.number(),
+    nextCheck: v.number(),
+    metadata: v.optional(v.any()),
+  })
+    .index("byAgentId", ["agentId"])
+    .index("byStatus", ["status"])
+    .index("byNextCheck", ["nextCheck"]),
+
+  // ─── Secure Vault ────────────────────────────────────────────────────
+  vault: defineTable({
+    name: v.string(),
+    category: v.string(),
+    provider: v.optional(v.string()),
+    encryptedValue: v.string(),
+    iv: v.string(),
+    maskedValue: v.string(),
+    isActive: v.boolean(),
+    expiresAt: v.optional(v.number()),
+    lastAccessedAt: v.optional(v.number()),
+    accessCount: v.number(),
+    userId: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index("byUserId", ["userId"])
+    .index("byCategory", ["category"])
+    .index("byProvider", ["provider"])
+    .index("byIsActive", ["isActive"]),
 });

package/dist/default/package.json

@@ -7,11 +7,13 @@
     "dev": "agentforge run",
     "build": "tsc",
     "convex:dev": "npx convex dev",
-    "convex:deploy": "npx convex deploy"
+    "convex:deploy": "npx convex deploy",
+    "dashboard": "agentforge dashboard"
   },
   "dependencies": {
-    "@agentforge-ai/core": "^0.3.1",
-    "convex": "^1.17.0"
+    "@agentforge-ai/core": "^0.3.2",
+    "convex": "^1.17.0",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "typescript": "^5.5.0"