@agentforge-ai/cli 0.3.2 → 0.4.0

package/templates/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/templates/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"

package/templates/default/skills/skill-creator/SKILL.md

@@ -0,0 +1,270 @@
+# Skill Creator
+
+**Built-in AgentForge Skill** — Create, manage, and discover skills for your agents.
+
+## Overview
+
+The Skill Creator is a default skill that ships with every AgentForge project. It allows you to:
+
+1. **Create new skills** from natural language descriptions
+2. **Browse example skills** to understand the skill format
+3. **Validate skills** before installing them
+4. **Generate skill code** using your connected LLM
+
+## Usage
+
+### Via CLI
+
+```bash
+# Create a new skill interactively
+agentforge skills create
+
+# Ask the agent to create a skill
+agentforge chat my-agent
+> Create a skill that can fetch weather data for any city
+
+# List available example skills
+agentforge skills search examples
+```
+
+### Via Dashboard
+
+Navigate to **Skills** in the sidebar, then click **"Create Skill"** to use the visual skill builder.
+
+### Via Agent Chat
+
+When chatting with an agent that has the Skill Creator tool enabled, simply ask:
+
+> "Create a skill that can [description of what you want]"
+
+The agent will generate the skill definition, validate it, and offer to install it.
+
+## Skill Format
+
+Every AgentForge skill is a directory with the following structure:
+
+```
+skills/
+  my-skill/
+    SKILL.md          # Documentation and instructions
+    index.ts          # Main skill entry point
+    config.json       # Skill metadata and configuration
+```
+
+### config.json
+
+```json
+{
+  "name": "my-skill",
+  "version": "1.0.0",
+  "description": "What this skill does",
+  "category": "utility",
+  "author": "Your Name",
+  "tools": ["tool-name-1", "tool-name-2"],
+  "dependencies": [],
+  "agentInstructions": "Additional instructions for agents using this skill"
+}
+```
+
+### index.ts
+
+```typescript
+import { z } from 'zod';
+
+export const tools = [
+  {
+    name: 'my-tool',
+    description: 'What this tool does',
+    inputSchema: z.object({
+      param1: z.string().describe('Description of param1'),
+    }),
+    outputSchema: z.object({
+      result: z.string(),
+    }),
+    handler: async (input: { param1: string }) => {
+      // Your tool logic here
+      return { result: `Processed: ${input.param1}` };
+    },
+  },
+];
+
+export default { tools };
+```
+
+## Example Skills
+
+### 1. Web Search Skill
+
+```typescript
+// skills/web-search/index.ts
+import { z } from 'zod';
+
+export const tools = [
+  {
+    name: 'web-search',
+    description: 'Search the web for information',
+    inputSchema: z.object({
+      query: z.string().describe('Search query'),
+      maxResults: z.number().optional().default(5),
+    }),
+    outputSchema: z.object({
+      results: z.array(z.object({
+        title: z.string(),
+        url: z.string(),
+        snippet: z.string(),
+      })),
+    }),
+    handler: async (input) => {
+      // Implement with your preferred search API
+      const response = await fetch(
+        `https://api.search.example/search?q=${encodeURIComponent(input.query)}&limit=${input.maxResults}`
+      );
+      const data = await response.json();
+      return { results: data.results };
+    },
+  },
+];
+```
+
+### 2. Calculator Skill
+
+```typescript
+// skills/calculator/index.ts
+import { z } from 'zod';
+
+export const tools = [
+  {
+    name: 'calculate',
+    description: 'Evaluate a mathematical expression',
+    inputSchema: z.object({
+      expression: z.string().describe('Math expression to evaluate (e.g., "2 + 2 * 3")'),
+    }),
+    outputSchema: z.object({
+      result: z.number(),
+      expression: z.string(),
+    }),
+    handler: async (input) => {
+      const result = Function('"use strict"; return (' + input.expression + ')')();
+      return { result: Number(result), expression: input.expression };
+    },
+  },
+];
+```
+
+### 3. File Reader Skill
+
+```typescript
+// skills/file-reader/index.ts
+import { z } from 'zod';
+import { readFile } from 'fs/promises';
+
+export const tools = [
+  {
+    name: 'read-file',
+    description: 'Read the contents of a file',
+    inputSchema: z.object({
+      path: z.string().describe('Path to the file'),
+      encoding: z.string().optional().default('utf-8'),
+    }),
+    outputSchema: z.object({
+      content: z.string(),
+      size: z.number(),
+    }),
+    handler: async (input) => {
+      const content = await readFile(input.path, input.encoding as BufferEncoding);
+      return { content, size: content.length };
+    },
+  },
+];
+```
+
+### 4. JSON Transformer Skill
+
+```typescript
+// skills/json-transformer/index.ts
+import { z } from 'zod';
+
+export const tools = [
+  {
+    name: 'transform-json',
+    description: 'Transform JSON data using a jq-like expression',
+    inputSchema: z.object({
+      data: z.string().describe('JSON string to transform'),
+      path: z.string().describe('Dot-notation path to extract (e.g., "users.0.name")'),
+    }),
+    outputSchema: z.object({
+      result: z.any(),
+    }),
+    handler: async (input) => {
+      const obj = JSON.parse(input.data);
+      const parts = input.path.split('.');
+      let current: any = obj;
+      for (const part of parts) {
+        current = current?.[part] ?? current?.[Number(part)];
+      }
+      return { result: current };
+    },
+  },
+];
+```
+
+### 5. HTTP Request Skill
+
+```typescript
+// skills/http-request/index.ts
+import { z } from 'zod';
+
+export const tools = [
+  {
+    name: 'http-request',
+    description: 'Make an HTTP request to any URL',
+    inputSchema: z.object({
+      url: z.string().url().describe('URL to request'),
+      method: z.enum(['GET', 'POST', 'PUT', 'DELETE']).default('GET'),
+      headers: z.record(z.string()).optional(),
+      body: z.string().optional(),
+    }),
+    outputSchema: z.object({
+      status: z.number(),
+      body: z.string(),
+      headers: z.record(z.string()),
+    }),
+    handler: async (input) => {
+      const response = await fetch(input.url, {
+        method: input.method,
+        headers: input.headers,
+        body: input.body,
+      });
+      const body = await response.text();
+      const headers: Record<string, string> = {};
+      response.headers.forEach((v, k) => { headers[k] = v; });
+      return { status: response.status, body, headers };
+    },
+  },
+];
+```
+
+## Creating Skills with AI
+
+When you ask an agent to create a skill, the Skill Creator tool will:
+
+1. **Parse your request** — Understand what the skill should do
+2. **Generate the code** — Create `index.ts` with proper Zod schemas
+3. **Create metadata** — Generate `config.json` with name, description, category
+4. **Write documentation** — Generate `SKILL.md` with usage instructions
+5. **Validate** — Ensure the skill compiles and schemas are correct
+6. **Install** — Save to your `skills/` directory and register with Convex
+
+## Categories
+
+Skills are organized by category:
+
+| Category | Description | Examples |
+|----------|-------------|---------|
+| `utility` | General-purpose tools | Calculator, JSON transformer |
+| `web` | Web interaction | HTTP requests, web search, scraping |
+| `file` | File operations | Read, write, transform files |
+| `data` | Data processing | CSV parsing, data analysis |
+| `integration` | External services | Slack, GitHub, email |
+| `ai` | AI-powered tools | Summarization, translation |
+| `custom` | User-defined | Anything else |

package/templates/default/skills/skill-creator/config.json

@@ -0,0 +1,11 @@
+{
+  "name": "skill-creator",
+  "version": "1.0.0",
+  "description": "Built-in skill for creating, managing, and discovering AgentForge skills. Allows agents to generate new skills from natural language descriptions.",
+  "category": "utility",
+  "author": "AgentForge",
+  "isBuiltIn": true,
+  "tools": ["create-skill", "list-examples", "validate-skill"],
+  "dependencies": [],
+  "agentInstructions": "You have access to the Skill Creator tool. When a user asks you to create a skill, use the create-skill tool to generate the skill code, config, and documentation. You can also use list-examples to show available example skills, and validate-skill to check if a skill definition is valid."
+}