agent-creator

Agent Creator

Create composable AI agent systems in NestJS with uniform tool interfaces, DAG-based planning, and database-backed state.

Core Concept

Every agent system exposes the same Tool interface as a simple tool. Callers don't know if they're calling a web search API or a complex research system. This enables arbitrary composition and nesting.

Workflow

1. Gather Requirements

Ask the user:

1. Purpose: What should this agent accomplish?
2. Inputs/Outputs: What data goes in and comes out?
3. Tools: What capabilities does it need? (existing tools or other agents)
4. Success Criteria: How do we know the output is good?
5. Evaluator Types: What quality dimensions matter? (see evaluators.md)

2. Generate Agent Structure

Create this NestJS module structure:

src/agents/{agent-name}/
├── {agent-name}.module.ts           # NestJS module
├── {agent-name}.tool.ts             # Tool interface (public API)
├── services/
│   ├── orchestrator.service.ts      # Workflow coordination
│   ├── planner.service.ts           # Plan generation
│   ├── executor.service.ts          # Tool execution
│   └── state.service.ts             # State management
├── evaluators/
│   ├── evaluator.registry.ts        # Registry service
│   └── {type}.evaluator.ts          # Per evaluator type
├── tools/
│   └── tool.registry.ts             # Available tools
├── entities/                         # TypeORM entities
├── dto/                              # Input/output DTOs
├── prompts/                          # LLM prompts
├── config/
│   └── {agent-name}.config.ts
└── interfaces/

3. Implement Components

For each component, follow the patterns in:

• architecture.md - Core interfaces, component roles, loops
• nestjs-patterns.md - NestJS service templates
• prompts.md - System prompts for planner/executor/evaluators
• evaluators.md - Built-in evaluator types