@lov3kaizen/agentsea-nestjs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 lovekaizen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @agentsea/nestjs
+
+NestJS integration for AgentSea - Unite and orchestrate AI agents in your NestJS applications.
+
+[![npm version](https://img.shields.io/npm/v/@agentsea/nestjs.svg)](https://www.npmjs.com/package/@agentsea/nestjs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+## 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
+
+```bash
+npm install @agentsea/nestjs @agentsea/core
+# or
+pnpm add @agentsea/nestjs @agentsea/core
+# or
+yarn add @agentsea/nestjs @agentsea/core
+```
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { AgenticModule } from '@agentsea/nestjs';
+import { AnthropicProvider } from '@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
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { Agent, Tool } from '@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](https://agentsea.dev)
+
+- [NestJS Integration](https://agentsea.dev/docs/nestjs)
+- [API Reference](https://agentsea.dev/api)
+
+## Related Packages
+
+- [@agentsea/core](https://www.npmjs.com/package/@agentsea/core) - Core library
+- [@agentsea/cli](https://www.npmjs.com/package/@agentsea/cli) - Command-line interface
+- [@agentsea/react](https://www.npmjs.com/package/@agentsea/react) - React components
+
+## License
+
+MIT License - see [LICENSE](../../LICENSE) for details

package/dist/index.d.mts

@@ -0,0 +1,203 @@
+import * as _lov3kaizen_agentsea_core from '@lov3kaizen/agentsea-core';
+import { AgentConfig, LLMProvider, MemoryStore, TenantManager, Message, OutputFormat, FormatOptions, Agent as Agent$1, Tenant as Tenant$1, TenantStatus } from '@lov3kaizen/agentsea-core';
+export * from '@lov3kaizen/agentsea-core';
+import { DynamicModule, CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Server, Socket } from 'socket.io';
+
+declare const AGENT_METADATA = "agentsea:agent";
+declare function Agent(config: Partial<AgentConfig>): ClassDecorator;
+
+declare const TOOL_METADATA = "agentsea:tool";
+interface ToolOptions {
+    name: string;
+    description: string;
+}
+declare function Tool(options: ToolOptions): MethodDecorator;
+
+declare const Tenant: (...dataOrPipes: unknown[]) => ParameterDecorator;
+declare const TenantId: (...dataOrPipes: unknown[]) => ParameterDecorator;
+
+interface AgenticModuleOptions {
+    provider: 'anthropic' | 'openai' | LLMProvider;
+    apiKey?: string;
+    memory?: MemoryStore;
+    defaultAgentConfig?: Partial<AgentConfig>;
+    enableRestApi?: boolean;
+    enableWebSocket?: boolean;
+}
+declare class AgenticModule {
+    static forRoot(options: AgenticModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<AgenticModuleOptions> | AgenticModuleOptions;
+        inject?: any[];
+    }): DynamicModule;
+}
+
+declare const RATE_LIMIT_METADATA = "agentsea:rate-limit";
+interface RateLimitOptions {
+    maxRequests: number;
+    windowMs: number;
+    keyExtractor?: (context: ExecutionContext) => string;
+}
+declare class RateLimitGuard implements CanActivate {
+    private reflector;
+    private limiters;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean;
+    private getDefaultKey;
+}
+declare function RateLimit(options: RateLimitOptions): MethodDecorator;
+
+interface TenantGuardOptions {
+    tenantManager: TenantManager;
+    apiKeyHeader?: string;
+    tenantIdHeader?: string;
+    tenantQuery?: string;
+    useSubdomain?: boolean;
+    allowAnonymous?: boolean;
+}
+declare class TenantGuard implements CanActivate {
+    private tenantManager;
+    private apiKeyHeader;
+    private tenantIdHeader;
+    private tenantQuery;
+    private useSubdomain;
+    private allowAnonymous;
+    constructor(options: TenantGuardOptions);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+
+declare class ExecuteAgentDto {
+    input: string;
+    conversationId?: string;
+    userId?: string;
+    sessionData?: Record<string, any>;
+    history?: Message[];
+    metadata?: Record<string, any>;
+    outputFormat?: OutputFormat;
+    formatOptions?: FormatOptions;
+}
+
+declare class AgentService {
+    private agents;
+    registerAgent(agent: Agent$1): void;
+    getAgent(name: string): Agent$1 | undefined;
+    getAllAgents(): Agent$1[];
+    hasAgent(name: string): boolean;
+    unregisterAgent(name: string): boolean;
+}
+
+declare class AgentController {
+    private readonly agentService;
+    constructor(agentService: AgentService);
+    execute(name: string, dto: ExecuteAgentDto): Promise<{
+        success: boolean;
+        data: _lov3kaizen_agentsea_core.AgentResponse;
+        conversationId: string;
+    }>;
+    stream(name: string, dto: ExecuteAgentDto): Observable<MessageEvent>;
+    listAgents(): {
+        success: boolean;
+        data: {
+            name: string;
+            description: string;
+            model: string;
+            provider: string;
+            tools: string[];
+        }[];
+    };
+    getAgent(name: string): {
+        success: boolean;
+        data: {
+            name: string;
+            description: string;
+            model: string;
+            provider: string;
+            systemPrompt: string | undefined;
+            tools: {
+                name: string;
+                description: string;
+            }[];
+            temperature: number | undefined;
+            maxTokens: number | undefined;
+            maxIterations: number | undefined;
+        };
+    };
+    deleteConversation(_name: string, conversationId: string): {
+        success: boolean;
+        message: string;
+    };
+}
+
+declare class CreateTenantDto {
+    name: string;
+    slug: string;
+    metadata?: Record<string, unknown>;
+    settings?: Tenant$1['settings'];
+}
+declare class UpdateTenantDto {
+    name?: string;
+    slug?: string;
+    metadata?: Record<string, unknown>;
+    settings?: Tenant$1['settings'];
+    status?: TenantStatus;
+}
+declare class CreateApiKeyDto {
+    name: string;
+    scopes?: string[];
+    expiresAt?: Date;
+}
+declare class ListTenantsQuery {
+    limit?: number;
+    offset?: number;
+    status?: TenantStatus;
+}
+declare class TenantController {
+    private readonly tenantManager;
+    constructor(tenantManager: TenantManager);
+    createTenant(dto: CreateTenantDto): Promise<Tenant$1>;
+    listTenants(query: ListTenantsQuery): Promise<{
+        tenants: Tenant$1[];
+        total: number;
+    }>;
+    getTenant(id: string): Promise<Tenant$1 | null>;
+    updateTenant(id: string, dto: UpdateTenantDto): Promise<Tenant$1>;
+    deleteTenant(id: string): Promise<void>;
+    suspendTenant(id: string): Promise<Tenant$1>;
+    activateTenant(id: string): Promise<Tenant$1>;
+    createApiKey(id: string, dto: CreateApiKeyDto): Promise<{
+        apiKey: string;
+        name: string;
+        scopes: string[];
+    }>;
+    checkQuota(id: string, resource: string): Promise<{
+        allowed: boolean;
+        remaining: number;
+    }>;
+}
+
+declare class AgentGateway {
+    private readonly agentService;
+    server: Server;
+    constructor(agentService: AgentService);
+    handleExecute(client: Socket, data: {
+        agentName: string;
+        input: string;
+        conversationId?: string;
+        userId?: string;
+        sessionData?: Record<string, any>;
+        history?: any[];
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    handleGetAgent(client: Socket, data: {
+        agentName: string;
+    }): void;
+    handleListAgents(client: Socket): void;
+}
+
+declare const AGENTSEA_NESTJS_VERSION = "0.1.0";
+
+export { AGENTSEA_NESTJS_VERSION, AGENT_METADATA, AgentController, Agent as AgentDecorator, AgentGateway, AgentService, AgenticModule, type AgenticModuleOptions, CreateApiKeyDto, CreateTenantDto, ExecuteAgentDto, ListTenantsQuery, RATE_LIMIT_METADATA, RateLimit, RateLimitGuard, type RateLimitOptions, TOOL_METADATA, Tenant, TenantController, TenantGuard, type TenantGuardOptions, TenantId, Tool as ToolDecorator, type ToolOptions, UpdateTenantDto };

package/dist/index.d.ts

@@ -0,0 +1,203 @@
+import * as _lov3kaizen_agentsea_core from '@lov3kaizen/agentsea-core';
+import { AgentConfig, LLMProvider, MemoryStore, TenantManager, Message, OutputFormat, FormatOptions, Agent as Agent$1, Tenant as Tenant$1, TenantStatus } from '@lov3kaizen/agentsea-core';
+export * from '@lov3kaizen/agentsea-core';
+import { DynamicModule, CanActivate, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Server, Socket } from 'socket.io';
+
+declare const AGENT_METADATA = "agentsea:agent";
+declare function Agent(config: Partial<AgentConfig>): ClassDecorator;
+
+declare const TOOL_METADATA = "agentsea:tool";
+interface ToolOptions {
+    name: string;
+    description: string;
+}
+declare function Tool(options: ToolOptions): MethodDecorator;
+
+declare const Tenant: (...dataOrPipes: unknown[]) => ParameterDecorator;
+declare const TenantId: (...dataOrPipes: unknown[]) => ParameterDecorator;
+
+interface AgenticModuleOptions {
+    provider: 'anthropic' | 'openai' | LLMProvider;
+    apiKey?: string;
+    memory?: MemoryStore;
+    defaultAgentConfig?: Partial<AgentConfig>;
+    enableRestApi?: boolean;
+    enableWebSocket?: boolean;
+}
+declare class AgenticModule {
+    static forRoot(options: AgenticModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<AgenticModuleOptions> | AgenticModuleOptions;
+        inject?: any[];
+    }): DynamicModule;
+}
+
+declare const RATE_LIMIT_METADATA = "agentsea:rate-limit";
+interface RateLimitOptions {
+    maxRequests: number;
+    windowMs: number;
+    keyExtractor?: (context: ExecutionContext) => string;
+}
+declare class RateLimitGuard implements CanActivate {
+    private reflector;
+    private limiters;
+    constructor(reflector: Reflector);
+    canActivate(context: ExecutionContext): boolean;
+    private getDefaultKey;
+}
+declare function RateLimit(options: RateLimitOptions): MethodDecorator;
+
+interface TenantGuardOptions {
+    tenantManager: TenantManager;
+    apiKeyHeader?: string;
+    tenantIdHeader?: string;
+    tenantQuery?: string;
+    useSubdomain?: boolean;
+    allowAnonymous?: boolean;
+}
+declare class TenantGuard implements CanActivate {
+    private tenantManager;
+    private apiKeyHeader;
+    private tenantIdHeader;
+    private tenantQuery;
+    private useSubdomain;
+    private allowAnonymous;
+    constructor(options: TenantGuardOptions);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+
+declare class ExecuteAgentDto {
+    input: string;
+    conversationId?: string;
+    userId?: string;
+    sessionData?: Record<string, any>;
+    history?: Message[];
+    metadata?: Record<string, any>;
+    outputFormat?: OutputFormat;
+    formatOptions?: FormatOptions;
+}
+
+declare class AgentService {
+    private agents;
+    registerAgent(agent: Agent$1): void;
+    getAgent(name: string): Agent$1 | undefined;
+    getAllAgents(): Agent$1[];
+    hasAgent(name: string): boolean;
+    unregisterAgent(name: string): boolean;
+}
+
+declare class AgentController {
+    private readonly agentService;
+    constructor(agentService: AgentService);
+    execute(name: string, dto: ExecuteAgentDto): Promise<{
+        success: boolean;
+        data: _lov3kaizen_agentsea_core.AgentResponse;
+        conversationId: string;
+    }>;
+    stream(name: string, dto: ExecuteAgentDto): Observable<MessageEvent>;
+    listAgents(): {
+        success: boolean;
+        data: {
+            name: string;
+            description: string;
+            model: string;
+            provider: string;
+            tools: string[];
+        }[];
+    };
+    getAgent(name: string): {
+        success: boolean;
+        data: {
+            name: string;
+            description: string;
+            model: string;
+            provider: string;
+            systemPrompt: string | undefined;
+            tools: {
+                name: string;
+                description: string;
+            }[];
+            temperature: number | undefined;
+            maxTokens: number | undefined;
+            maxIterations: number | undefined;
+        };
+    };
+    deleteConversation(_name: string, conversationId: string): {
+        success: boolean;
+        message: string;
+    };
+}
+
+declare class CreateTenantDto {
+    name: string;
+    slug: string;
+    metadata?: Record<string, unknown>;
+    settings?: Tenant$1['settings'];
+}
+declare class UpdateTenantDto {
+    name?: string;
+    slug?: string;
+    metadata?: Record<string, unknown>;
+    settings?: Tenant$1['settings'];
+    status?: TenantStatus;
+}
+declare class CreateApiKeyDto {
+    name: string;
+    scopes?: string[];
+    expiresAt?: Date;
+}
+declare class ListTenantsQuery {
+    limit?: number;
+    offset?: number;
+    status?: TenantStatus;
+}
+declare class TenantController {
+    private readonly tenantManager;
+    constructor(tenantManager: TenantManager);
+    createTenant(dto: CreateTenantDto): Promise<Tenant$1>;
+    listTenants(query: ListTenantsQuery): Promise<{
+        tenants: Tenant$1[];
+        total: number;
+    }>;
+    getTenant(id: string): Promise<Tenant$1 | null>;
+    updateTenant(id: string, dto: UpdateTenantDto): Promise<Tenant$1>;
+    deleteTenant(id: string): Promise<void>;
+    suspendTenant(id: string): Promise<Tenant$1>;
+    activateTenant(id: string): Promise<Tenant$1>;
+    createApiKey(id: string, dto: CreateApiKeyDto): Promise<{
+        apiKey: string;
+        name: string;
+        scopes: string[];
+    }>;
+    checkQuota(id: string, resource: string): Promise<{
+        allowed: boolean;
+        remaining: number;
+    }>;
+}
+
+declare class AgentGateway {
+    private readonly agentService;
+    server: Server;
+    constructor(agentService: AgentService);
+    handleExecute(client: Socket, data: {
+        agentName: string;
+        input: string;
+        conversationId?: string;
+        userId?: string;
+        sessionData?: Record<string, any>;
+        history?: any[];
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    handleGetAgent(client: Socket, data: {
+        agentName: string;
+    }): void;
+    handleListAgents(client: Socket): void;
+}
+
+declare const AGENTSEA_NESTJS_VERSION = "0.1.0";
+
+export { AGENTSEA_NESTJS_VERSION, AGENT_METADATA, AgentController, Agent as AgentDecorator, AgentGateway, AgentService, AgenticModule, type AgenticModuleOptions, CreateApiKeyDto, CreateTenantDto, ExecuteAgentDto, ListTenantsQuery, RATE_LIMIT_METADATA, RateLimit, RateLimitGuard, type RateLimitOptions, TOOL_METADATA, Tenant, TenantController, TenantGuard, type TenantGuardOptions, TenantId, Tool as ToolDecorator, type ToolOptions, UpdateTenantDto };