@lov3kaizen/agentsea-nestjs

NestJS integration for AgentSea - Unite and orchestrate AI agents in your NestJS applications.

Features

• Decorators for agents and tools (@Agent, @Tool)
• REST API endpoints for agent execution
• WebSocket gateway for real-time streaming
• Rate limiting guard
• Full dependency injection support

Installation

npm install @lov3kaizen/agentsea-nestjs @lov3kaizen/agentsea-core
# or
pnpm add @lov3kaizen/agentsea-nestjs @lov3kaizen/agentsea-core
# or
yarn add @lov3kaizen/agentsea-nestjs @lov3kaizen/agentsea-core

Quick Start

import { Module } from '@nestjs/common';
import { AgenticModule } from '@lov3kaizen/agentsea-nestjs';
import { AnthropicProvider } from '@lov3kaizen/agentsea-core';

@Module({
  imports: [
    AgenticModule.forRoot({
      provider: new AnthropicProvider(),
      defaultConfig: {
        model: 'claude-sonnet-4-20250514',
        provider: 'anthropic',
      },
      enableRestApi: true,
      enableWebSocket: true,
    }),
  ],
})
export class AppModule {}

REST API Endpoints

When enableRestApi is set to true:

• GET /agents - List all agents
• GET /agents/:name - Get agent details
• POST /agents/:name/execute - Execute agent
• POST /agents/:name/stream - Stream agent response (SSE)

WebSocket Events

When enableWebSocket is set to true:

• execute - Execute an agent
• stream - Real-time streaming events
• listAgents - Get available agents
• getAgent - Get agent info

Creating Agents with Decorators

import { Injectable } from '@nestjs/common';
import { Agent, Tool } from '@lov3kaizen/agentsea-nestjs';

@Injectable()
@Agent({
  name: 'assistant',
  description: 'A helpful assistant',
  model: 'claude-sonnet-4-20250514',
  provider: 'anthropic',
})
export class AssistantAgent {
  @Tool({
    name: 'greet',
    description: 'Greet a user by name',
    parameters: {
      name: { type: 'string', description: 'The name to greet' },
    },
  })
  greet(params: { name: string }) {
    return `Hello, ${params.name}!`;
  }
}

Documentation

Full documentation available at agentsea.dev

• NestJS Integration
• API Reference

Related Packages

• @lov3kaizen/agentsea-core - Core library
• @lov3kaizen/agentsea-cli - Command-line interface
• @lov3kaizen/agentsea-react - React components

License

MIT License - see LICENSE for details