@agentlang/agentmanager 0.0.3

package/apps/agentmanager/src/employee-code/employee-code.controller.ts

@@ -0,0 +1,114 @@
+import {
+  Controller,
+  Get,
+  Put,
+  Delete,
+  Param,
+  Body,
+  HttpCode,
+  HttpStatus,
+} from '@nestjs/common';
+import { EmployeeCodeService } from './employee-code.service';
+import { PutModuleDto } from './dto/put-module.dto';
+import { PutPackageDto } from './dto/put-package.dto';
+import { PutConfigDto } from './dto/put-config.dto';
+
+@Controller('projects/:projectId/employees/:employeeId')
+export class EmployeeCodeController {
+  constructor(private readonly employeeCodeService: EmployeeCodeService) {}
+
+  // --- Modules ---
+
+  @Get('modules')
+  async listModules(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+  ) {
+    const data = await this.employeeCodeService.listModules(
+      projectId,
+      employeeId,
+    );
+    return { data };
+  }
+
+  @Get('modules/:name')
+  async getModule(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+    @Param('name') name: string,
+  ) {
+    return this.employeeCodeService.getModule(projectId, employeeId, name);
+  }
+
+  @Put('modules/:name')
+  async putModule(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+    @Param('name') name: string,
+    @Body() dto: PutModuleDto,
+  ) {
+    return this.employeeCodeService.putModule(
+      projectId,
+      employeeId,
+      name,
+      dto.source,
+    );
+  }
+
+  @Delete('modules/:name')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  async deleteModule(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+    @Param('name') name: string,
+  ) {
+    return this.employeeCodeService.deleteModule(projectId, employeeId, name);
+  }
+
+  // --- Package ---
+
+  @Get('package')
+  async getPackage(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+  ) {
+    return this.employeeCodeService.getPackage(projectId, employeeId);
+  }
+
+  @Put('package')
+  async putPackage(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+    @Body() dto: PutPackageDto,
+  ) {
+    return this.employeeCodeService.putPackage(projectId, employeeId, dto);
+  }
+
+  // --- Config ---
+
+  @Get('config')
+  async getConfig(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+  ) {
+    const content = await this.employeeCodeService.getConfig(
+      projectId,
+      employeeId,
+    );
+    return { content };
+  }
+
+  @Put('config')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  async putConfig(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+    @Body() dto: PutConfigDto,
+  ) {
+    return this.employeeCodeService.putConfig(
+      projectId,
+      employeeId,
+      dto.content,
+    );
+  }
+}

package/apps/agentmanager/src/employee-code/employee-code.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { EmployeeCodeController } from './employee-code.controller';
+import { EmployeeCodeService } from './employee-code.service';
+
+@Module({
+  controllers: [EmployeeCodeController],
+  providers: [EmployeeCodeService],
+  exports: [EmployeeCodeService],
+})
+export class EmployeeCodeModule {}

package/apps/agentmanager/src/employee-code/employee-code.service.ts

@@ -0,0 +1,55 @@
+import { Injectable, Inject } from '@nestjs/common';
+import {
+  EMPLOYEE_CODE_PROVIDER,
+  EmployeeCodeProvider,
+  EmployeePackage,
+} from '@app/project-provider';
+
+@Injectable()
+export class EmployeeCodeService {
+  constructor(
+    @Inject(EMPLOYEE_CODE_PROVIDER)
+    private readonly codeProvider: EmployeeCodeProvider,
+  ) {}
+
+  async listModules(projectId: string, employeeId: string) {
+    return this.codeProvider.listModules(projectId, employeeId);
+  }
+
+  async getModule(projectId: string, employeeId: string, name: string) {
+    return this.codeProvider.getModule(projectId, employeeId, name);
+  }
+
+  async putModule(
+    projectId: string,
+    employeeId: string,
+    name: string,
+    source: string,
+  ) {
+    return this.codeProvider.putModule(projectId, employeeId, name, source);
+  }
+
+  async deleteModule(projectId: string, employeeId: string, name: string) {
+    return this.codeProvider.deleteModule(projectId, employeeId, name);
+  }
+
+  async getPackage(projectId: string, employeeId: string) {
+    return this.codeProvider.getPackage(projectId, employeeId);
+  }
+
+  async putPackage(
+    projectId: string,
+    employeeId: string,
+    dto: EmployeePackage,
+  ) {
+    return this.codeProvider.putPackage(projectId, employeeId, dto);
+  }
+
+  async getConfig(projectId: string, employeeId: string) {
+    return this.codeProvider.getConfig(projectId, employeeId);
+  }
+
+  async putConfig(projectId: string, employeeId: string, content: string) {
+    return this.codeProvider.putConfig(projectId, employeeId, content);
+  }
+}

package/apps/agentmanager/src/employees/dto/register-employee.dto.ts

@@ -0,0 +1,9 @@
+import { createZodDto } from 'nestjs-zod';
+import { z } from 'zod';
+
+export const RegisterEmployeeSchema = z.object({
+  sourcePath: z.string().min(1),
+  employeeId: z.string().min(1).max(100).optional(),
+});
+
+export class RegisterEmployeeDto extends createZodDto(RegisterEmployeeSchema) {}

package/apps/agentmanager/src/employees/employees.controller.ts

@@ -0,0 +1,53 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Delete,
+  Param,
+  Body,
+  HttpCode,
+  HttpStatus,
+} from '@nestjs/common';
+import { EmployeesService } from './employees.service';
+import { RegisterEmployeeDto } from './dto/register-employee.dto';
+
+@Controller('projects/:projectId/employees')
+export class EmployeesController {
+  constructor(private readonly employeesService: EmployeesService) {}
+
+  @Get()
+  async listEmployees(@Param('projectId') projectId: string) {
+    const data = await this.employeesService.listEmployees(projectId);
+    return { data };
+  }
+
+  @Get(':employeeId')
+  async getEmployee(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+  ) {
+    return this.employeesService.getEmployee(projectId, employeeId);
+  }
+
+  @Post()
+  @HttpCode(HttpStatus.CREATED)
+  async registerEmployee(
+    @Param('projectId') projectId: string,
+    @Body() dto: RegisterEmployeeDto,
+  ) {
+    return this.employeesService.registerEmployee(
+      projectId,
+      dto.sourcePath,
+      dto.employeeId,
+    );
+  }
+
+  @Delete(':employeeId')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  async removeEmployee(
+    @Param('projectId') projectId: string,
+    @Param('employeeId') employeeId: string,
+  ) {
+    return this.employeesService.removeEmployee(projectId, employeeId);
+  }
+}

package/apps/agentmanager/src/employees/employees.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { EmployeesController } from './employees.controller';
+import { EmployeesService } from './employees.service';
+
+@Module({
+  controllers: [EmployeesController],
+  providers: [EmployeesService],
+  exports: [EmployeesService],
+})
+export class EmployeesModule {}

package/apps/agentmanager/src/employees/employees.service.ts

@@ -0,0 +1,29 @@
+import { Injectable, Inject } from '@nestjs/common';
+import { REGISTRY_PROVIDER, RegistryProvider } from '@app/project-provider';
+
+@Injectable()
+export class EmployeesService {
+  constructor(
+    @Inject(REGISTRY_PROVIDER) private readonly registry: RegistryProvider,
+  ) {}
+
+  async listEmployees(projectId: string) {
+    return this.registry.listEmployees(projectId);
+  }
+
+  async getEmployee(projectId: string, employeeId: string) {
+    return this.registry.getEmployee(projectId, employeeId);
+  }
+
+  async registerEmployee(
+    projectId: string,
+    sourcePath: string,
+    employeeId?: string,
+  ) {
+    return this.registry.registerEmployee(projectId, sourcePath, employeeId);
+  }
+
+  async removeEmployee(projectId: string, employeeId: string) {
+    return this.registry.removeEmployee(projectId, employeeId);
+  }
+}

package/apps/agentmanager/src/health/health.controller.ts

@@ -0,0 +1,22 @@
+import { Controller, Get } from '@nestjs/common';
+import {
+  HealthCheck,
+  HealthCheckService,
+  MemoryHealthIndicator,
+} from '@nestjs/terminus';
+
+@Controller('health')
+export class HealthController {
+  constructor(
+    private readonly health: HealthCheckService,
+    private readonly memory: MemoryHealthIndicator,
+  ) {}
+
+  @Get()
+  @HealthCheck()
+  check() {
+    return this.health.check([
+      () => this.memory.checkHeap('memory_heap', 256 * 1024 * 1024),
+    ]);
+  }
+}

package/apps/agentmanager/src/health/health.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { TerminusModule } from '@nestjs/terminus';
+import { HealthController } from './health.controller';
+
+@Module({
+  imports: [TerminusModule],
+  controllers: [HealthController],
+})
+export class HealthModule {}

package/apps/agentmanager/src/inbox/dto/list-messages-query.dto.ts

@@ -0,0 +1,12 @@
+import { createZodDto } from 'nestjs-zod';
+import { z } from 'zod';
+
+export const ListMessagesQuerySchema = z.object({
+  status: z.enum(['unread', 'read', 'pending', 'responded']).optional(),
+  kind: z.enum(['notification', 'action']).optional(),
+  from: z.string().optional(),
+});
+
+export class ListMessagesQueryDto extends createZodDto(
+  ListMessagesQuerySchema,
+) {}

package/apps/agentmanager/src/inbox/dto/push-message.dto.ts

@@ -0,0 +1,55 @@
+import { createZodDto } from 'nestjs-zod';
+import { z } from 'zod';
+
+const VALID_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'] as const;
+
+const HttpContinuationSchema = z.object({
+  method: z.enum(VALID_METHODS),
+  url: z.string().url(),
+});
+
+const EventContinuationSchema = z.object({
+  event: z.string().min(1),
+});
+
+const ContinuationSchema = z.union([
+  HttpContinuationSchema,
+  EventContinuationSchema,
+]);
+
+export const ContinuationsSchema = z.object({}).catchall(ContinuationSchema);
+
+const MessageSenderSchema = z.object({
+  kind: z.enum(['employee', 'agentcraft', 'system']),
+  id: z.string(),
+});
+
+const ActionSchema = z.object({
+  responses: z.array(z.string()).min(1),
+  continuations: ContinuationsSchema.optional(),
+  inputPrompt: z.string().optional(),
+});
+
+export const PushMessageSchema = z
+  .object({
+    from: MessageSenderSchema,
+    subject: z.string().min(1).max(500),
+    body: z.string().min(1).max(50_000),
+    kind: z.enum(['notification', 'action']),
+    action: ActionSchema.optional(),
+  })
+  .refine(
+    (data) => {
+      if (data.kind === 'notification' && data.action !== undefined)
+        return false;
+      if (data.kind === 'action' && data.action === undefined) return false;
+      return true;
+    },
+    {
+      message:
+        "Action messages must include 'action', notification messages must not",
+      path: ['kind'],
+    },
+  );
+
+export class PushMessageDto extends createZodDto(PushMessageSchema) {}

package/apps/agentmanager/src/inbox/dto/respond-message.dto.ts

@@ -0,0 +1,9 @@
+import { createZodDto } from 'nestjs-zod';
+import { z } from 'zod';
+
+export const RespondMessageSchema = z.object({
+  selected: z.string().min(1),
+  input: z.string().min(1).optional(),
+});
+
+export class RespondMessageDto extends createZodDto(RespondMessageSchema) {}

package/apps/agentmanager/src/inbox/inbox.controller.ts

@@ -0,0 +1,87 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Param,
+  Body,
+  Query,
+  HttpCode,
+  HttpStatus,
+} from '@nestjs/common';
+import { InboxService } from './inbox.service';
+import { PushMessageDto } from './dto/push-message.dto';
+import { RespondMessageDto } from './dto/respond-message.dto';
+import { ListMessagesQueryDto } from './dto/list-messages-query.dto';
+import type { ActionSpec } from '@app/project-provider';
+
+@Controller('inboxes')
+export class InboxController {
+  constructor(private readonly inboxService: InboxService) {}
+
+  @Post(':inbox/messages')
+  @HttpCode(HttpStatus.CREATED)
+  async pushMessage(
+    @Param('inbox') inbox: string,
+    @Body() dto: PushMessageDto,
+  ) {
+    return this.inboxService.pushMessage(inbox, {
+      inbox,
+      from: dto.from,
+      subject: dto.subject,
+      body: dto.body,
+      kind: dto.kind,
+      ...(dto.action ? { action: dto.action as ActionSpec } : {}),
+    });
+  }
+
+  @Get(':inbox/messages')
+  async listMessages(
+    @Param('inbox') inbox: string,
+    @Query() query: ListMessagesQueryDto,
+  ) {
+    const { status, kind, from } = query;
+    const hasFilter =
+      status !== undefined || kind !== undefined || from !== undefined;
+    const data = await this.inboxService.listMessages(
+      inbox,
+      hasFilter ? { status, kind, from } : undefined,
+    );
+    return { data };
+  }
+
+  @Get(':inbox/messages/:messageId')
+  async getMessage(
+    @Param('inbox') inbox: string,
+    @Param('messageId') messageId: string,
+  ) {
+    return this.inboxService.getMessage(inbox, messageId);
+  }
+
+  @Post(':inbox/messages/:messageId/read')
+  @HttpCode(HttpStatus.OK)
+  async markRead(
+    @Param('inbox') inbox: string,
+    @Param('messageId') messageId: string,
+  ) {
+    return this.inboxService.markRead(inbox, messageId);
+  }
+
+  @Post(':inbox/messages/:messageId/respond')
+  @HttpCode(HttpStatus.OK)
+  async respond(
+    @Param('inbox') inbox: string,
+    @Param('messageId') messageId: string,
+    @Body() dto: RespondMessageDto,
+  ) {
+    const message = await this.inboxService.respond(
+      inbox,
+      messageId,
+      dto.selected,
+      dto.input,
+    );
+
+    await this.inboxService.executeContinuation(message);
+
+    return message;
+  }
+}

package/apps/agentmanager/src/inbox/inbox.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { InboxController } from './inbox.controller';
+import { InboxService } from './inbox.service';
+
+@Module({
+  controllers: [InboxController],
+  providers: [InboxService],
+  exports: [InboxService],
+})
+export class InboxModule {}