@agentforge-ai/cli 0.3.2 → 0.4.1

package/dist/default/.env.example

@@ -1,8 +1,48 @@
-# 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=
+
+# ─── Workspace ──────────────────────────────────────────────────────────
+# Workspace base path for local development (default: ./workspace)
+AGENTFORGE_WORKSPACE_PATH=./workspace
+
+# ─── Cloudflare R2 (Cloud Workspace) ────────────────────────────────────
+# Required for cloud workspace deployment on Cloudflare
+R2_ENDPOINT=
+R2_ACCESS_KEY_ID=
+R2_SECRET_ACCESS_KEY=
+R2_BUCKET=
+
+# ─── 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/dashboard/app/components/DashboardLayout.tsx

@@ -0,0 +1,245 @@
+import React, { useState, useEffect } from "react";
+import { Link, useRouterState } from "@tanstack/react-router";
+import {
+  MessageSquare, LayoutDashboard, Radio, Server, Activity, Clock,
+  Bot, Sparkles, Network, Settings, Bug, FileText, Menu, X,
+  ChevronLeft, ChevronRight, User, Heart, FolderKanban, Folder,
+} from "lucide-react";
+
+const navItems = [
+  {
+    section: "Chat",
+    items: [
+      { href: "/chat", label: "Chat", icon: MessageSquare },
+    ],
+  },
+  {
+    section: "Control",
+    items: [
+      { href: "/", label: "Overview", icon: LayoutDashboard },
+      { href: "/sessions", label: "Sessions", icon: Activity },
+      { href: "/usage", label: "Usage", icon: Clock },
+      { href: "/cron", label: "Cron Jobs", icon: Clock },
+    ],
+  },
+  {
+    section: "Agent",
+    items: [
+      { href: "/agents", label: "Agents", icon: Bot },
+      { href: "/skills", label: "Skills", icon: Sparkles },
+      { href: "/connections", label: "Connections", icon: Network },
+    ],
+  },
+  {
+    section: "Workspace",
+    items: [
+      { href: "/projects", label: "Projects", icon: FolderKanban },
+      { href: "/files", label: "Files", icon: Folder },
+    ],
+  },
+  {
+    section: "Settings",
+    items: [
+      { href: "/settings", label: "Config", icon: Settings },
+    ],
+  },
+];
+
+const HealthStatus = () => {
+  const [isOnline, setIsOnline] = useState(true);
+
+  useEffect(() => {
+    const interval = setInterval(() => {
+      // In production, poll the Convex backend heartbeat
+    }, 30000);
+    return () => clearInterval(interval);
+  }, []);
+
+  return (
+    <div className="flex items-center gap-2 text-sm text-muted-foreground">
+      <span className="relative flex h-2 w-2">
+        <span
+          className={`animate-ping absolute inline-flex h-full w-full rounded-full ${
+            isOnline ? "bg-green-400" : "bg-red-400"
+          } opacity-75`}
+        ></span>
+        <span
+          className={`relative inline-flex rounded-full h-2 w-2 ${
+            isOnline ? "bg-green-500" : "bg-red-500"
+          }`}
+        ></span>
+      </span>
+      {isOnline ? "Online" : "Offline"}
+    </div>
+  );
+};
+
+const Breadcrumb = () => {
+  const { location } = useRouterState();
+  const pathnames = location.pathname.split("/").filter((x) => x);
+
+  if (pathnames.length === 0) {
+    return <span className="text-sm font-medium">Overview</span>;
+  }
+
+  return (
+    <nav className="flex" aria-label="Breadcrumb">
+      <ol className="inline-flex items-center space-x-1 md:space-x-2 rtl:space-x-reverse">
+        <li className="inline-flex items-center">
+          <Link
+            to="/"
+            className="inline-flex items-center text-sm font-medium text-muted-foreground hover:text-foreground"
+          >
+            <LayoutDashboard className="w-4 h-4 me-2.5" />
+            Home
+          </Link>
+        </li>
+        {pathnames.map((value, index) => {
+          const to = `/${pathnames.slice(0, index + 1).join("/")}`;
+          const isLast = index === pathnames.length - 1;
+          return (
+            <li key={to}>
+              <div className="flex items-center">
+                <ChevronRight className="w-4 h-4 text-muted-foreground" />
+                <Link
+                  to={to}
+                  className={`ms-1 text-sm font-medium ${
+                    isLast
+                      ? "text-foreground"
+                      : "text-muted-foreground hover:text-foreground"
+                  } md:ms-2`}
+                >
+                  {value.charAt(0).toUpperCase() + value.slice(1)}
+                </Link>
+              </div>
+            </li>
+          );
+        })}
+      </ol>
+    </nav>
+  );
+};
+
+export function DashboardLayout({ children }: { children: React.ReactNode }) {
+  const [isSidebarOpen, setIsSidebarOpen] = useState(true);
+  const [isMobileMenuOpen, setIsMobileMenuOpen] = useState(false);
+  const { location } = useRouterState();
+
+  const NavLink = ({ item }: { item: any }) => {
+    const isActive = location.pathname === item.href;
+    return (
+      <Link
+        to={item.href}
+        className={`flex items-center px-3 py-2 text-sm font-medium rounded-md transition-colors ${
+          isActive
+            ? "bg-primary text-primary-foreground"
+            : "text-muted-foreground hover:bg-muted hover:text-foreground"
+        }`}
+        onClick={() => setIsMobileMenuOpen(false)}
+      >
+        <item.icon className="w-5 h-5 mr-3" />
+        <span>{item.label}</span>
+      </Link>
+    );
+  };
+
+  const sidebarContent = (
+    <div className="flex flex-col h-full">
+      <div className="flex items-center justify-between h-16 px-4 border-b border-border">
+        <Link to="/" className="flex items-center gap-2 text-lg font-bold">
+          <Bot className="w-7 h-7 text-primary" />
+          <span>AgentForge</span>
+        </Link>
+      </div>
+      <nav className="flex-1 px-2 py-4 space-y-4 overflow-y-auto">
+        {navItems.map((section) => (
+          <div key={section.section}>
+            <h3 className="px-3 mb-2 text-xs font-semibold tracking-wider text-muted-foreground/80 uppercase">
+              {section.section}
+            </h3>
+            <div className="space-y-1">
+              {section.items.map((item) => (
+                <NavLink key={item.href} item={item} />
+              ))}
+            </div>
+          </div>
+        ))}
+      </nav>
+      <div className="p-4 border-t border-border">
+        <HealthStatus />
+      </div>
+    </div>
+  );
+
+  return (
+    <div className="flex h-screen bg-background text-foreground">
+      {/* Desktop Sidebar */}
+      <aside
+        className={`hidden md:block bg-card border-r border-border transition-all duration-300 ease-in-out ${
+          isSidebarOpen ? "w-64" : "w-0 overflow-hidden"
+        }`}
+      >
+        {sidebarContent}
+      </aside>
+
+      {/* Mobile Sidebar Overlay */}
+      {isMobileMenuOpen && (
+        <div
+          className="fixed inset-0 z-40 flex md:hidden"
+          role="dialog"
+          aria-modal="true"
+        >
+          <div
+            className="fixed inset-0 bg-black/60"
+            aria-hidden="true"
+            onClick={() => setIsMobileMenuOpen(false)}
+          ></div>
+          <div className="relative flex flex-col flex-1 w-full max-w-xs bg-card">
+            <div className="absolute top-0 right-0 pt-2 -mr-12">
+              <button
+                type="button"
+                className="flex items-center justify-center w-10 h-10 ml-1 rounded-full focus:outline-none focus:ring-2 focus:ring-inset focus:ring-white"
+                onClick={() => setIsMobileMenuOpen(false)}
+              >
+                <span className="sr-only">Close sidebar</span>
+                <X className="w-6 h-6 text-white" />
+              </button>
+            </div>
+            {sidebarContent}
+          </div>
+        </div>
+      )}
+
+      <div className="flex flex-col flex-1 min-w-0">
+        <header className="flex items-center justify-between h-16 px-4 bg-card border-b border-border md:px-6">
+          <div className="flex items-center gap-4">
+            <button
+              onClick={() => setIsSidebarOpen(!isSidebarOpen)}
+              className="hidden p-2 rounded-md md:block hover:bg-muted"
+            >
+              {isSidebarOpen ? (
+                <ChevronLeft className="w-5 h-5" />
+              ) : (
+                <ChevronRight className="w-5 h-5" />
+              )}
+            </button>
+            <button
+              onClick={() => setIsMobileMenuOpen(true)}
+              className="p-2 rounded-md md:hidden hover:bg-muted"
+            >
+              <Menu className="w-5 h-5" />
+            </button>
+            <Breadcrumb />
+          </div>
+          <div className="flex items-center gap-4">
+            <HealthStatus />
+            <div className="p-2 rounded-full bg-muted">
+              <User className="w-5 h-5 text-muted-foreground" />
+            </div>
+          </div>
+        </header>
+        <main className="flex-1 p-4 overflow-y-auto md:p-6">{children}</main>
+      </div>
+    </div>
+  );
+}