@agentforge-ai/cli 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# @agentforge-ai/cli
+
+Command-line interface for creating, running, and managing AgentForge projects.
+
+## Installation
+
+```bash
+npm install -g @agentforge-ai/cli
+```
+
+## Commands
+
+### `agentforge create <project-name>`
+
+Creates a new AgentForge project with all the necessary boilerplate.
+
+```bash
+agentforge create my-agent-project
+```
+
+### `agentforge run`
+
+Starts the local development environment (Convex dev server).
+
+```bash
+cd my-agent-project
+agentforge run
+```
+
+### `agentforge deploy`
+
+Deploy your project (coming soon).
+
+## License
+
+Apache-2.0

package/dist/default/.env.example

@@ -0,0 +1,8 @@
+# OpenAI API Key (required for default model)
+OPENAI_API_KEY=sk-your-key-here
+
+# E2B API Key (required for sandbox execution)
+E2B_API_KEY=e2b_your-key-here
+
+# Convex deployment URL (set automatically by `npx convex dev`)
+# CONVEX_URL=https://your-deployment.convex.cloud

package/dist/default/README.md

@@ -0,0 +1,30 @@
+# My AgentForge Project
+
+Built with [AgentForge](https://github.com/Agentic-Engineering-Agency/agentforge) - The Minimalist Framework for Collaborative AI Agents.
+
+## Getting Started
+
+```bash
+# Start the development server
+agentforge run
+
+# Or use pnpm directly
+pnpm dev
+```
+
+## Project Structure
+
+```
+├── convex/          # Convex schema and functions
+│   └── schema.ts    # Database schema (agents, threads, messages)
+├── src/
+│   └── agent.ts     # Your agent definition
+├── package.json
+└── tsconfig.json
+```
+
+## Learn More
+
+- [AgentForge Documentation](https://github.com/Agentic-Engineering-Agency/agentforge)
+- [Mastra Documentation](https://mastra.ai/docs)
+- [Convex Documentation](https://docs.convex.dev)

package/dist/default/convex/schema.ts

@@ -0,0 +1,28 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+
+export default defineSchema({
+  agents: defineTable({
+    id: v.string(),
+    name: v.string(),
+    instructions: v.string(),
+    model: v.string(),
+    tools: v.optional(v.any()),
+  }).index("by_id", ["id"]),
+
+  threads: defineTable({
+    name: v.optional(v.string()),
+  }),
+
+  messages: defineTable({
+    threadId: v.id("threads"),
+    role: v.union(
+      v.literal("user"),
+      v.literal("assistant"),
+      v.literal("system"),
+      v.literal("tool")
+    ),
+    content: v.string(),
+    tool_calls: v.optional(v.any()),
+  }).index("by_thread", ["threadId"]),
+});

package/dist/default/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-agentforge-project",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "agentforge run",
+    "build": "tsc",
+    "convex:dev": "npx convex dev",
+    "convex:deploy": "npx convex deploy"
+  },
+  "dependencies": {
+    "@agentforge-ai/core": "^0.1.0",
+    "convex": "^1.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}

package/dist/default/src/agent.ts

@@ -0,0 +1,22 @@
+import { Agent } from '@agentforge-ai/core';
+
+/**
+ * A sample AgentForge agent.
+ *
+ * This is a starting point for your own agent. Modify the instructions,
+ * model, and tools to suit your needs.
+ */
+const myAgent = new Agent({
+  id: 'my-first-agent',
+  name: 'My First Agent',
+  instructions: `You are a helpful AI assistant built with AgentForge.
+You can help users with a variety of tasks.
+Be concise, accurate, and friendly.`,
+  model: 'openai:gpt-4o-mini',
+});
+
+export default myAgent;
+
+// Example usage:
+// const response = await myAgent.generate('Hello, what can you do?');
+// console.log(response.text);

package/dist/default/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*.ts", "convex/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/create.ts
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "fs-extra";
+import { execSync } from "child_process";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+async function createProject(projectName, options) {
+  const targetDir = path.resolve(process.cwd(), projectName);
+  if (await fs.pathExists(targetDir)) {
+    console.error(`Error: Directory "${projectName}" already exists.`);
+    process.exit(1);
+  }
+  console.log(`
+\u{1F528} Creating AgentForge project: ${projectName}
+`);
+  const templateDir = path.resolve(
+    __dirname,
+    "..",
+    // from dist/commands to dist
+    "templates",
+    options.template
+  );
+  if (!await fs.pathExists(templateDir)) {
+    console.error(`Error: Template "${options.template}" not found.`);
+    process.exit(1);
+  }
+  await fs.copy(templateDir, targetDir);
+  const pkgPath = path.join(targetDir, "package.json");
+  if (await fs.pathExists(pkgPath)) {
+    const pkg = await fs.readJson(pkgPath);
+    pkg.name = projectName;
+    await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+  }
+  console.log(`  \u2705 Project scaffolded at ./${projectName}`);
+  console.log(`
+\u{1F4E6} Installing dependencies...
+`);
+  try {
+    execSync("pnpm install", {
+      cwd: targetDir,
+      stdio: "inherit"
+    });
+    console.log(`
+  \u2705 Dependencies installed`);
+  } catch {
+    console.warn(
+      `
+  \u26A0\uFE0F  Could not install dependencies. Run "cd ${projectName} && pnpm install" manually.`
+    );
+  }
+  console.log(`
+\u{1F389} AgentForge project "${projectName}" created successfully!
+
+Next steps:
+  cd ${projectName}
+  agentforge run
+
+Documentation: https://github.com/Agentic-Engineering-Agency/agentforge
+`);
+}
+
+// src/commands/run.ts
+import { spawn } from "child_process";
+import path2 from "path";
+import fs2 from "fs-extra";
+async function runProject(options) {
+  const projectDir = process.cwd();
+  const pkgPath = path2.join(projectDir, "package.json");
+  if (!await fs2.pathExists(pkgPath)) {
+    console.error(
+      "Error: No package.json found. Are you in an AgentForge project directory?"
+    );
+    process.exit(1);
+  }
+  const convexDir = path2.join(projectDir, "convex");
+  if (!await fs2.pathExists(convexDir)) {
+    console.error(
+      "Error: No convex/ directory found. Are you in an AgentForge project directory?"
+    );
+    process.exit(1);
+  }
+  console.log(`
+\u{1F680} Starting AgentForge development server...
+`);
+  console.log(`  Convex dev server starting on port ${options.port}...`);
+  const convexProcess = spawn("npx", ["convex", "dev"], {
+    cwd: projectDir,
+    stdio: "inherit",
+    shell: true
+  });
+  convexProcess.on("error", (err) => {
+    console.error(`Failed to start Convex dev server: ${err.message}`);
+    process.exit(1);
+  });
+  convexProcess.on("close", (code) => {
+    if (code !== 0) {
+      console.error(`Convex dev server exited with code ${code}`);
+    }
+  });
+  const shutdown = () => {
+    console.log("\n\n\u{1F44B} Shutting down AgentForge dev server...");
+    convexProcess.kill("SIGTERM");
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
+// src/index.ts
+var program = new Command();
+program.name("agentforge").description("CLI tool for creating, running, and managing AgentForge projects").version("0.1.0");
+program.command("create").argument("<project-name>", "Name of the project to create").description("Create a new AgentForge project").option("-t, --template <template>", "Project template to use", "default").action(async (projectName, options) => {
+  await createProject(projectName, options);
+});
+program.command("run").description("Start the local development environment").option("-p, --port <port>", "Port for the dev server", "3000").action(async (options) => {
+  await runProject(options);
+});
+program.command("deploy").description("Deploy the project (coming soon)").action(() => {
+  console.log("Deploy command coming soon. Stay tuned!");
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands/create.ts","../src/commands/run.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { createProject } from './commands/create.js';\nimport { runProject } from './commands/run.js';\n\nconst program = new Command();\n\nprogram\n  .name('agentforge')\n  .description('CLI tool for creating, running, and managing AgentForge projects')\n  .version('0.1.0');\n\nprogram\n  .command('create')\n  .argument('<project-name>', 'Name of the project to create')\n  .description('Create a new AgentForge project')\n  .option('-t, --template <template>', 'Project template to use', 'default')\n  .action(async (projectName: string, options: { template: string }) => {\n    await createProject(projectName, options);\n  });\n\nprogram\n  .command('run')\n  .description('Start the local development environment')\n  .option('-p, --port <port>', 'Port for the dev server', '3000')\n  .action(async (options: { port: string }) => {\n    await runProject(options);\n  });\n\nprogram\n  .command('deploy')\n  .description('Deploy the project (coming soon)')\n  .action(() => {\n    console.log('Deploy command coming soon. Stay tuned!');\n  });\n\nprogram.parse();\n","import path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport fs from 'fs-extra';\nimport { execSync } from 'node:child_process';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n/**\n * Options for the create command.\n */\nexport interface CreateOptions {\n  /** The project template to use. */\n  template: string;\n}\n\n/**\n * Creates a new AgentForge project from a template.\n *\n * @param projectName - The name of the project to create.\n * @param options - Options for the create command.\n */\nexport async function createProject(\n  projectName: string,\n  options: CreateOptions\n): Promise<void> {\n  const targetDir = path.resolve(process.cwd(), projectName);\n\n  // Check if directory already exists\n  if (await fs.pathExists(targetDir)) {\n    console.error(`Error: Directory \"${projectName}\" already exists.`);\n    process.exit(1);\n  }\n\n  console.log(`\\n🔨 Creating AgentForge project: ${projectName}\\n`);\n\n  // Resolve template directory\n  const templateDir = path.resolve(\n    __dirname,\n    '..', // from dist/commands to dist\n    'templates',\n    options.template\n  );\n\n  if (!(await fs.pathExists(templateDir))) {\n    console.error(`Error: Template \"${options.template}\" not found.`);\n    process.exit(1);\n  }\n\n  // Copy template to target directory\n  await fs.copy(templateDir, targetDir);\n\n  // Update package.json with project name\n  const pkgPath = path.join(targetDir, 'package.json');\n  if (await fs.pathExists(pkgPath)) {\n    const pkg = await fs.readJson(pkgPath);\n    pkg.name = projectName;\n    await fs.writeJson(pkgPath, pkg, { spaces: 2 });\n  }\n\n  console.log(`  ✅ Project scaffolded at ./${projectName}`);\n\n  // Install dependencies\n  console.log(`\\n📦 Installing dependencies...\\n`);\n  try {\n    execSync('pnpm install', {\n      cwd: targetDir,\n      stdio: 'inherit',\n    });\n    console.log(`\\n  ✅ Dependencies installed`);\n  } catch {\n    console.warn(\n      `\\n  ⚠️  Could not install dependencies. Run \"cd ${projectName} && pnpm install\" manually.`\n    );\n  }\n\n  console.log(`\n🎉 AgentForge project \"${projectName}\" created successfully!\n\nNext steps:\n  cd ${projectName}\n  agentforge run\n\nDocumentation: https://github.com/Agentic-Engineering-Agency/agentforge\n`);\n}\n","import { spawn } from 'node:child_process';\nimport path from 'node:path';\nimport fs from 'fs-extra';\n\n/**\n * Options for the run command.\n */\nexport interface RunOptions {\n  /** The port for the dev server. */\n  port: string;\n}\n\n/**\n * Starts the local development environment for an AgentForge project.\n *\n * This command starts the Convex development server and watches for file changes.\n *\n * @param options - Options for the run command.\n */\nexport async function runProject(options: RunOptions): Promise<void> {\n  const projectDir = process.cwd();\n\n  // Verify we're in an AgentForge project\n  const pkgPath = path.join(projectDir, 'package.json');\n  if (!(await fs.pathExists(pkgPath))) {\n    console.error(\n      'Error: No package.json found. Are you in an AgentForge project directory?'\n    );\n    process.exit(1);\n  }\n\n  const convexDir = path.join(projectDir, 'convex');\n  if (!(await fs.pathExists(convexDir))) {\n    console.error(\n      'Error: No convex/ directory found. Are you in an AgentForge project directory?'\n    );\n    process.exit(1);\n  }\n\n  console.log(`\\n🚀 Starting AgentForge development server...\\n`);\n  console.log(`  Convex dev server starting on port ${options.port}...`);\n\n  // Start the Convex dev server\n  const convexProcess = spawn('npx', ['convex', 'dev'], {\n    cwd: projectDir,\n    stdio: 'inherit',\n    shell: true,\n  });\n\n  convexProcess.on('error', (err) => {\n    console.error(`Failed to start Convex dev server: ${err.message}`);\n    process.exit(1);\n  });\n\n  convexProcess.on('close', (code) => {\n    if (code !== 0) {\n      console.error(`Convex dev server exited with code ${code}`);\n    }\n  });\n\n  // Handle graceful shutdown\n  const shutdown = () => {\n    console.log('\\n\\n👋 Shutting down AgentForge dev server...');\n    convexProcess.kill('SIGTERM');\n    process.exit(0);\n  };\n\n  process.on('SIGINT', shutdown);\n  process.on('SIGTERM', shutdown);\n}\n"],"mappings":"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","names":["path","fs"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agentforge-ai/cli",
+  "version": "0.1.0",
+  "description": "CLI tool for creating, running, and managing AgentForge projects",
+  "type": "module",
+  "bin": {
+    "agentforge": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "agentforge",
+    "cli",
+    "ai",
+    "agents",
+    "scaffolding"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Agentic-Engineering-Agency/agentforge.git",
+    "directory": "packages/cli"
+  }
+}

package/templates/default/.env.example

@@ -0,0 +1,8 @@
+# OpenAI API Key (required for default model)
+OPENAI_API_KEY=sk-your-key-here
+
+# E2B API Key (required for sandbox execution)
+E2B_API_KEY=e2b_your-key-here
+
+# Convex deployment URL (set automatically by `npx convex dev`)
+# CONVEX_URL=https://your-deployment.convex.cloud

package/templates/default/README.md

@@ -0,0 +1,30 @@
+# My AgentForge Project
+
+Built with [AgentForge](https://github.com/Agentic-Engineering-Agency/agentforge) - The Minimalist Framework for Collaborative AI Agents.
+
+## Getting Started
+
+```bash
+# Start the development server
+agentforge run
+
+# Or use pnpm directly
+pnpm dev
+```
+
+## Project Structure
+
+```
+├── convex/          # Convex schema and functions
+│   └── schema.ts    # Database schema (agents, threads, messages)
+├── src/
+│   └── agent.ts     # Your agent definition
+├── package.json
+└── tsconfig.json
+```
+
+## Learn More
+
+- [AgentForge Documentation](https://github.com/Agentic-Engineering-Agency/agentforge)
+- [Mastra Documentation](https://mastra.ai/docs)
+- [Convex Documentation](https://docs.convex.dev)

package/templates/default/convex/schema.ts

@@ -0,0 +1,28 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+
+export default defineSchema({
+  agents: defineTable({
+    id: v.string(),
+    name: v.string(),
+    instructions: v.string(),
+    model: v.string(),
+    tools: v.optional(v.any()),
+  }).index("by_id", ["id"]),
+
+  threads: defineTable({
+    name: v.optional(v.string()),
+  }),
+
+  messages: defineTable({
+    threadId: v.id("threads"),
+    role: v.union(
+      v.literal("user"),
+      v.literal("assistant"),
+      v.literal("system"),
+      v.literal("tool")
+    ),
+    content: v.string(),
+    tool_calls: v.optional(v.any()),
+  }).index("by_thread", ["threadId"]),
+});

package/templates/default/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "my-agentforge-project",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "agentforge run",
+    "build": "tsc",
+    "convex:dev": "npx convex dev",
+    "convex:deploy": "npx convex deploy"
+  },
+  "dependencies": {
+    "@agentforge-ai/core": "^0.1.0",
+    "convex": "^1.17.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}

package/templates/default/src/agent.ts

@@ -0,0 +1,22 @@
+import { Agent } from '@agentforge-ai/core';
+
+/**
+ * A sample AgentForge agent.
+ *
+ * This is a starting point for your own agent. Modify the instructions,
+ * model, and tools to suit your needs.
+ */
+const myAgent = new Agent({
+  id: 'my-first-agent',
+  name: 'My First Agent',
+  instructions: `You are a helpful AI assistant built with AgentForge.
+You can help users with a variety of tasks.
+Be concise, accurate, and friendly.`,
+  model: 'openai:gpt-4o-mini',
+});
+
+export default myAgent;
+
+// Example usage:
+// const response = await myAgent.generate('Hello, what can you do?');
+// console.log(response.text);

package/templates/default/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*.ts", "convex/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}