@agentforge-ai/cli 0.4.0 → 0.4.1

package/dist/default/dashboard/vite.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import tsconfigPaths from "vite-tsconfig-paths";
+
+export default defineConfig({
+  plugins: [react(), tsconfigPaths()],
+  build: {
+    outDir: "dist",
+    sourcemap: true,
+  },
+  server: {
+    port: 3000,
+    host: "0.0.0.0",
+    allowedHosts: true,
+  },
+});

package/dist/default/package.json

@@ -8,10 +8,13 @@
     "build": "tsc",
     "convex:dev": "npx convex dev",
     "convex:deploy": "npx convex deploy",
-    "dashboard": "agentforge dashboard"
+    "dashboard": "agentforge dashboard",
+    "dashboard:install": "cd dashboard && pnpm install",
+    "dashboard:dev": "cd dashboard && pnpm dev",
+    "dashboard:build": "cd dashboard && pnpm build"
   },
   "dependencies": {
-    "@agentforge-ai/core": "^0.3.2",
+    "@agentforge-ai/core": "^0.4.0",
     "convex": "^1.17.0",
     "zod": "^3.23.0"
   },

package/dist/default/src/agent.ts

@@ -1,11 +1,17 @@
 import { Agent } from '@agentforge-ai/core';
+import { AgentForgeWorkspace } from '@agentforge-ai/core/workspace';
 
 /**
  * AgentForge — Your First Agent
  *
  * This starter agent demonstrates how to configure an AI agent with
- * AgentForge's multi-provider support. You can use OpenAI, OpenRouter,
- * Anthropic, Google, or xAI as your LLM provider.
+ * AgentForge's multi-provider support and Mastra Workspace integration.
+ *
+ * Workspace gives your agent:
+ *   - Filesystem: Read, write, list, and delete files
+ *   - Sandbox: Execute shell commands
+ *   - Skills: Discover and activate reusable instructions
+ *   - Search: BM25 keyword search over indexed content
  *
  * Set your provider and API key in the .env file:
  *   OPENAI_API_KEY=sk-...
@@ -13,6 +19,20 @@ import { Agent } from '@agentforge-ai/core';
  *   ANTHROPIC_API_KEY=sk-ant-...
  */
 
+// ─── Workspace Setup ──────────────────────────────────────────────────
+// The workspace provides persistent file storage, command execution,
+// skill discovery, and content search for your agents.
+const workspace = AgentForgeWorkspace.local({
+  basePath: './workspace',
+  skills: ['/skills'],
+  search: true,
+  autoIndexPaths: ['/skills'],
+  sandbox: true,
+});
+
+// Initialize workspace (triggers auto-indexing)
+await workspace.init();
+
 // ─── Main Agent ────────────────────────────────────────────────────────
 const myAgent = new Agent({
   id: 'my-first-agent',
@@ -21,6 +41,9 @@ const myAgent = new Agent({
 You can help users with a variety of tasks.
 Be concise, accurate, and friendly.
 
+You have access to a workspace with file management, command execution,
+and skill discovery capabilities. Use them when appropriate.
+
 When you don't know something, say so honestly.
 When asked about your capabilities, mention that you're powered by AgentForge.`,
 
@@ -33,8 +56,21 @@ When asked about your capabilities, mention that you're powered by AgentForge.`,
   model: 'openai:gpt-4o-mini',
 });
 
+export { workspace };
 export default myAgent;
 
+// ─── Example: Cloud Workspace (Cloudflare R2) ─────────────────────────
+// For production deployment on Cloudflare, use a cloud workspace:
+//
+// const cloudWorkspace = AgentForgeWorkspace.cloud({
+//   bucket: 'my-agent-files',
+//   region: 'auto',
+//   endpoint: process.env.R2_ENDPOINT,
+//   accessKeyId: process.env.R2_ACCESS_KEY_ID,
+//   secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+//   skills: ['/skills'],
+// });
+
 // ─── Example: Agent with Custom Tools ──────────────────────────────────
 // import { z } from 'zod';
 //
@@ -60,3 +96,7 @@ export default myAgent;
 // ─── Example: Using the Agent ──────────────────────────────────────────
 // const response = await myAgent.generate('Hello, what can you do?');
 // console.log(response.text);
+//
+// ─── Example: Searching Workspace Content ──────────────────────────────
+// const results = await workspace.search('code review');
+// console.log(results);

package/dist/index.js

@@ -19,15 +19,25 @@ async function createProject(projectName, options) {
   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)) {
+  const searchDirs = [
+    path.resolve(__dirname, options.template),
+    // dist/default (built)
+    path.resolve(__dirname, "..", "templates", options.template),
+    // packages/cli/templates/default (dev)
+    path.resolve(__dirname, "..", "..", "templates", options.template)
+    // fallback
+  ];
+  let templateDir = "";
+  for (const dir of searchDirs) {
+    if (await fs.pathExists(path.join(dir, "package.json"))) {
+      templateDir = dir;
+      break;
+    }
+  }
+  if (!templateDir) {
     console.error(`Error: Template "${options.template}" not found.`);
+    console.error(`Searched in:`);
+    searchDirs.forEach((d) => console.error(`  - ${d}`));
     process.exit(1);
   }
   await fs.copy(templateDir, targetDir);
@@ -37,6 +47,12 @@ async function createProject(projectName, options) {
     pkg2.name = projectName;
     await fs.writeJson(pkgPath, pkg2, { spaces: 2 });
   }
+  const dashPkgPath = path.join(targetDir, "dashboard", "package.json");
+  if (await fs.pathExists(dashPkgPath)) {
+    const dashPkg = await fs.readJson(dashPkgPath);
+    dashPkg.name = `${projectName}-dashboard`;
+    await fs.writeJson(dashPkgPath, dashPkg, { spaces: 2 });
+  }
   console.log(`  \u2705 Project scaffolded at ./${projectName}`);
   console.log(`
 \u{1F4E6} Installing dependencies...
@@ -54,12 +70,58 @@ async function createProject(projectName, options) {
   \u26A0\uFE0F  Could not install dependencies. Run "cd ${projectName} && pnpm install" manually.`
     );
   }
+  const dashDir = path.join(targetDir, "dashboard");
+  if (await fs.pathExists(dashDir)) {
+    console.log(`
+\u{1F4E6} Installing dashboard dependencies...
+`);
+    try {
+      execSync("pnpm install", {
+        cwd: dashDir,
+        stdio: "inherit"
+      });
+      console.log(`
+  \u2705 Dashboard dependencies installed`);
+    } catch {
+      console.warn(
+        `
+  \u26A0\uFE0F  Could not install dashboard dependencies. Run "cd ${projectName}/dashboard && pnpm install" manually.`
+      );
+    }
+  }
+  console.log(`
+\u26A1 Initializing Convex...
+`);
+  try {
+    execSync("npx convex dev --once", {
+      cwd: targetDir,
+      stdio: "inherit"
+    });
+    console.log(`
+  \u2705 Convex initialized`);
+  } catch {
+    console.warn(
+      `
+  \u26A0\uFE0F  Convex initialization skipped. Run "npx convex dev" to set up your backend.`
+    );
+  }
   console.log(`
 \u{1F389} AgentForge project "${projectName}" created successfully!
 
 Next steps:
   cd ${projectName}
-  agentforge run
+
+  # Start the Convex backend
+  npx convex dev
+
+  # In another terminal, launch the dashboard
+  agentforge dashboard
+
+  # Or chat with your agent from the CLI
+  agentforge chat
+
+  # Check system status
+  agentforge status
 
 Documentation: https://github.com/Agentic-Engineering-Agency/agentforge
 `);
@@ -1545,6 +1607,7 @@ function registerStatusCommand(program2) {
     checks["Project Root"] = fs8.existsSync(path8.join(cwd, "package.json")) ? "\u2714 Found" : "\u2716 Not found";
     checks["Convex Dir"] = fs8.existsSync(path8.join(cwd, "convex")) ? "\u2714 Found" : "\u2716 Not found";
     checks["Skills Dir"] = fs8.existsSync(path8.join(cwd, "skills")) ? "\u2714 Found" : "\u2716 Not configured";
+    checks["Dashboard Dir"] = fs8.existsSync(path8.join(cwd, "dashboard")) ? "\u2714 Found" : "\u2716 Not found";
     checks["Env Config"] = fs8.existsSync(path8.join(cwd, ".env.local")) || fs8.existsSync(path8.join(cwd, ".env")) ? "\u2714 Found" : "\u2716 Not found";
     try {
       const client = createClient();
@@ -1577,24 +1640,75 @@ function registerStatusCommand(program2) {
     checks["LLM Provider"] = provider !== "Not configured" ? `\u2714 ${provider}` : "\u2716 Not configured";
     details(checks);
   });
-  program2.command("dashboard").description("Launch the web dashboard").option("-p, --port <port>", "Port for the dashboard", "3000").action(async (opts) => {
+  program2.command("dashboard").description("Launch the web dashboard").option("-p, --port <port>", "Port for the dashboard", "3000").option("--install", "Install dashboard dependencies before starting").action(async (opts) => {
     const cwd = process.cwd();
-    const webDir = path8.join(cwd, "node_modules", "@agentforge-ai", "web");
-    const localWebDir = path8.join(cwd, "packages", "web");
+    const searchPaths = [
+      path8.join(cwd, "dashboard"),
+      // 1. Bundled in project (agentforge create)
+      path8.join(cwd, "packages", "web"),
+      // 2. Monorepo structure
+      path8.join(cwd, "node_modules", "@agentforge-ai", "web")
+      // 3. Installed as dependency
+    ];
     let dashDir = "";
-    if (fs8.existsSync(localWebDir)) {
-      dashDir = localWebDir;
-    } else if (fs8.existsSync(webDir)) {
-      dashDir = webDir;
-    } else {
-      info("Dashboard not found locally. Starting from the built-in dashboard...");
-      info("Install the dashboard: pnpm add @agentforge-ai/web");
-      info("Or clone the repo: git clone https://github.com/Agentic-Engineering-Agency/agentforge");
+    for (const p of searchPaths) {
+      if (fs8.existsSync(path8.join(p, "package.json"))) {
+        dashDir = p;
+        break;
+      }
+    }
+    if (!dashDir) {
+      error("Dashboard not found!");
+      console.log();
+      info("The dashboard should be in your project's ./dashboard/ directory.");
+      info("If you created this project with an older version of AgentForge,");
+      info("you can add it manually:");
+      console.log();
+      console.log(`  ${colors.cyan}# Option 1: Recreate the project${colors.reset}`);
+      console.log(`  agentforge create my-project`);
+      console.log();
+      console.log(`  ${colors.cyan}# Option 2: Clone the dashboard from the repo${colors.reset}`);
+      console.log(`  git clone https://github.com/Agentic-Engineering-Agency/agentforge /tmp/af`);
+      console.log(`  cp -r /tmp/af/packages/web ./dashboard`);
+      console.log(`  cd dashboard && pnpm install`);
+      console.log();
       return;
     }
+    const nodeModulesExists = fs8.existsSync(path8.join(dashDir, "node_modules"));
+    if (!nodeModulesExists || opts.install) {
+      header("AgentForge Dashboard \u2014 Installing Dependencies");
+      info(`Installing in ${path8.relative(cwd, dashDir) || "."}...`);
+      console.log();
+      const installChild = spawn2("pnpm", ["install"], {
+        cwd: dashDir,
+        stdio: "inherit",
+        shell: true
+      });
+      await new Promise((resolve2, reject) => {
+        installChild.on("close", (code) => {
+          if (code === 0) resolve2();
+          else reject(new Error(`pnpm install exited with code ${code}`));
+        });
+        installChild.on("error", reject);
+      });
+      console.log();
+      success("Dependencies installed.");
+      console.log();
+    }
+    const envPath = path8.join(cwd, ".env.local");
+    if (fs8.existsSync(envPath)) {
+      const envContent = fs8.readFileSync(envPath, "utf-8");
+      const convexUrlMatch = envContent.match(/CONVEX_URL=(.+)/);
+      if (convexUrlMatch) {
+        const dashEnvPath = path8.join(dashDir, ".env.local");
+        const dashEnvContent = `VITE_CONVEX_URL=${convexUrlMatch[1].trim()}
+`;
+        fs8.writeFileSync(dashEnvPath, dashEnvContent);
+      }
+    }
     header("AgentForge Dashboard");
     info(`Starting dashboard on port ${opts.port}...`);
-    info(`Open http://localhost:${opts.port} in your browser.`);
+    info(`Open ${colors.cyan}http://localhost:${opts.port}${colors.reset} in your browser.`);
     console.log();
     const child = spawn2("pnpm", ["dev", "--port", opts.port], {
       cwd: dashDir,
@@ -1653,7 +1767,6 @@ function registerStatusCommand(program2) {
     });
     console.log();
     const rl = readline9.createInterface({ input: process.stdin, output: process.stdout });
-    const { createInterface } = await import("readline");
     const answer = await new Promise((r) => rl.question("Resume pending tasks? (y/N): ", (a) => {
       rl.close();
       r(a.trim());