@agentlang/agentgen

AI-powered code generation for Agentlang - a declarative language for building agentic applications. This package provides pre-configured AI agents, workflows, and instructions to generate Agentlang code from natural language descriptions.

Overview

AgentGen is a meta-programming toolkit that uses AI agents to automatically generate Agentlang modules, including:

- Data Models: Entities, records, relationships, and attributes
- Workflows: Event-driven business logic and orchestration
- AI Agents: Intelligent agents with LLM integration
- Components: Individual entity, event, workflow, agent, and relationship components

Features

- Full Module Generation: Generate complete Agentlang applications from requirements
- Component-Level Generation: Create or update individual components
- Smart Requirement Analysis: Automatically distill and structure user requirements
- Validation & Retry: Built-in validation with automatic retry logic
- Metadata Generation: Auto-generate documentation for generated code
- Orchestration: Multi-step component creation with dependency management

Installation

``bash
npm install @agentlang/agentgen
`

Quick Start

`typescript
import { BUILDER_MODULE_DEFINITION, getAgentCraftConfigContent } from '@agentlang/agentgen';

// Get the AgentCraft module definition
const moduleDefinition = BUILDER_MODULE_DEFINITION;

// Get LLM configuration
const config = getAgentCraftConfigContent();
`

Usage in Agentlang Applications

To use AgentGen in your Agentlang application:

1. Load the module definition into your Agentlang runtime
2. Configure the LLM settings using config.al
3. Trigger generation events with your requirements

`typescript
import { BUILDER_MODULE_DEFINITION, getAgentCraftConfigContent } from '@agentlang/agentgen';

// In your Agentlang runtime initialization:
// 1. Load the AgentCraft module
// 2. Load the LLM configuration
// 3. Trigger events like 'generateAgentlang' with user requirements
`

API Reference

$3

#### BUILDER_MODULE_DEFINITION

The complete AgentCraft module definition as an Agentlang string. This contains all agents, workflows, events, and data models needed for code generation.

`typescript
const moduleDefinition: string = BUILDER_MODULE_DEFINITION;
`

#### getAgentCraftConfigContent()

Returns the LLM configuration content from config.al.

`typescript
function getAgentCraftConfigContent(): string;
`

Returns: Raw JSON configuration string compatible with Agentlang's loadConfigEntities function.

$3

#### escapeAgentlangString(str: string): string

Escapes special characters for safe embedding in Agentlang strings.

`typescript
import { escapeAgentlangString } from '@agentlang/agentgen';

const escaped = escapeAgentlangString('My "string" with\nnewlines');
`

Development

$3

`bash


Build the package

nx build agentgen

Build for playground

npm run build:agentgen-playground
`

$3

`
libs/agentgen/
├── src/
│ ├── index.ts # Main exports
│ ├── module.ts # AgentCraft module definition
│ ├── instructions.ts # Agent instructions and prompts
│ └── configLoader.ts # Configuration loader
├── config.al # LLM configuration
├── package.json # Package metadata
├── vite.config.ts # Build configuration
└── README.md # This file
``

Related Projects

- Agentlang - The declarative language for agentic applications

Support

- Documentation

---

Built with ❤️ by the Agentlang team