@agentforge/cli 0.1.0

package/templates/full/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "description": "{{PROJECT_DESCRIPTION}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@agentforge/core": "workspace:*",
+    "@agentforge/patterns": "workspace:*",
+    "@langchain/openai": "^0.3.14",
+    "langchain": "^0.3.7",
+    "zod": "^3.24.1",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@vitest/ui": "^2.1.8",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsup": "^8.3.5",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}
+

package/templates/full/src/index.ts

@@ -0,0 +1,53 @@
+import 'dotenv/config';
+import { ChatOpenAI } from '@langchain/openai';
+import { createReActAgent } from '@agentforge/patterns';
+import { createLogger } from '@agentforge/core';
+import { exampleTool } from './tools/example.js';
+
+const logger = createLogger({ level: 'info' });
+
+/**
+ * Main entry point for {{PROJECT_NAME}}
+ */
+async function main() {
+  logger.info('🚀 Starting {{PROJECT_NAME}}...');
+
+  // Initialize the language model
+  const model = new ChatOpenAI({
+    modelName: process.env.OPENAI_MODEL || 'gpt-4',
+    temperature: 0,
+  });
+
+  // Create a ReAct agent with tools
+  const agent = createReActAgent({
+    model,
+    tools: [exampleTool],
+    systemPrompt: 'You are a helpful AI assistant with access to various tools.',
+    maxIterations: 10,
+  });
+
+  // Compile the agent
+  const compiledAgent = agent.compile();
+
+  // Run the agent
+  logger.info('Running agent...');
+  const result = await compiledAgent.invoke({
+    messages: [
+      {
+        role: 'user',
+        content: 'Use the example tool to greet me!',
+      },
+    ],
+  });
+
+  logger.info('✅ Agent completed');
+  console.log('\nFinal response:');
+  console.log(result.messages[result.messages.length - 1].content);
+}
+
+// Run the main function
+main().catch((error) => {
+  logger.error('❌ Error:', error);
+  process.exit(1);
+});
+

package/templates/full/src/tools/example.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { createTool } from '@agentforge/core';
+
+/**
+ * Example tool that demonstrates the tool creation API
+ */
+export const exampleTool = createTool()
+  .name('example_tool')
+  .description('An example tool that greets a user by name')
+  .category('utility')
+  .schema(
+    z.object({
+      name: z.string().describe('The name of the person to greet'),
+    })
+  )
+  .implement(async ({ name }) => {
+    return `Hello, ${name}! This is an example tool response.`;
+  })
+  .build();
+

package/templates/full/tests/example.test.ts

@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest';
+import { exampleTool } from '../src/tools/example.js';
+
+describe('Example Tool', () => {
+  it('should greet a user by name', async () => {
+    const result = await exampleTool.invoke({ name: 'Alice' });
+    expect(result).toContain('Alice');
+    expect(result).toContain('Hello');
+  });
+
+  it('should have correct metadata', () => {
+    expect(exampleTool.name).toBe('example_tool');
+    expect(exampleTool.description).toBeDefined();
+    expect(exampleTool.category).toBe('utility');
+  });
+});
+

package/templates/full/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}
+

package/templates/minimal/README.md

@@ -0,0 +1,64 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+ 
+- pnpm (recommended) or npm
+
+### Installation
+
+```bash
+pnpm install
+```
+
+### Development
+
+```bash
+# Run in development mode with hot reload
+pnpm dev
+
+# Build for production
+pnpm build
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm typecheck
+
+# Lint code
+pnpm lint
+```
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── src/
+│   └── index.ts          # Main entry point
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Next Steps
+
+1. Add your tools in `src/tools/`
+2. Customize the agent in `src/index.ts`
+3. Add tests in `tests/`
+4. Deploy using the deployment guides in AgentForge docs
+
+## Learn More
+
+- [AgentForge Documentation](../../docs/)
+- [Agent Patterns Guide](../../docs/guides/patterns/)
+- [Tool Development Guide](../../docs/guides/tools/)
+
+## License
+
+MIT
+

package/templates/minimal/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "description": "{{PROJECT_DESCRIPTION}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@agentforge/core": "workspace:*",
+    "@agentforge/patterns": "workspace:*",
+    "@langchain/openai": "^0.3.14",
+    "langchain": "^0.3.7",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsup": "^8.3.5",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}
+

package/templates/minimal/src/index.ts

@@ -0,0 +1,40 @@
+import { ChatOpenAI } from '@langchain/openai';
+import { createReActAgent } from '@agentforge/patterns';
+
+/**
+ * Main entry point for {{PROJECT_NAME}}
+ */
+async function main() {
+  console.log('🚀 Starting {{PROJECT_NAME}}...\n');
+
+  // Initialize the language model
+  const model = new ChatOpenAI({
+    modelName: 'gpt-4',
+    temperature: 0,
+  });
+
+  // Create a simple ReAct agent
+  const agent = createReActAgent({
+    model,
+    tools: [],
+    systemPrompt: 'You are a helpful AI assistant.',
+  });
+
+  // Compile the agent
+  const compiledAgent = agent.compile();
+
+  // Run the agent
+  const result = await compiledAgent.invoke({
+    messages: [{ role: 'user', content: 'Hello! What can you help me with?' }],
+  });
+
+  console.log('\n✅ Agent response:');
+  console.log(result.messages[result.messages.length - 1].content);
+}
+
+// Run the main function
+main().catch((error) => {
+  console.error('❌ Error:', error);
+  process.exit(1);
+});
+

package/templates/minimal/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}
+