@solidxai/core 0.1.7 → 0.1.8-beta.1

package/src/controllers/agent-event.controller.ts

@@ -0,0 +1,70 @@
+import { Body, Controller, Delete, Get, Param, Patch, Post, Put, Query, UploadedFiles, UseInterceptors } from '@nestjs/common';
+import { AnyFilesInterceptor } from '@nestjs/platform-express';
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { CreateAgentEventDto } from 'src/dtos/create-agent-event.dto';
+import { UpdateAgentEventDto } from 'src/dtos/update-agent-event.dto';
+import { AgentEventService } from 'src/services/agent-event.service';
+
+@ApiTags('Solid Core')
+@Controller('agent-event')
+export class AgentEventController {
+  constructor(private readonly service: AgentEventService) {}
+
+  @ApiBearerAuth('jwt')
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateAgentEventDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateAgentEventDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateAgentEventDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Patch(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateAgentEventDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth('jwt')
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @ApiQuery({ name: 'offset', required: false, type: Number })
+  @ApiQuery({ name: 'fields', required: false, type: Array })
+  @ApiQuery({ name: 'sort', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  findMany(@Query() query: any) {
+    return this.service.find(query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Get(':id')
+  findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete('/bulk')
+  deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete(':id')
+  delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+}

package/src/controllers/agent-session.controller.ts

@@ -0,0 +1,70 @@
+import { Body, Controller, Delete, Get, Param, Patch, Post, Put, Query, UploadedFiles, UseInterceptors } from '@nestjs/common';
+import { AnyFilesInterceptor } from '@nestjs/platform-express';
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { CreateAgentSessionDto } from 'src/dtos/create-agent-session.dto';
+import { UpdateAgentSessionDto } from 'src/dtos/update-agent-session.dto';
+import { AgentSessionService } from 'src/services/agent-session.service';
+
+@ApiTags('Solid Core')
+@Controller('agent-session')
+export class AgentSessionController {
+  constructor(private readonly service: AgentSessionService) {}
+
+  @ApiBearerAuth('jwt')
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateAgentSessionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateAgentSessionDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateAgentSessionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Patch(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateAgentSessionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth('jwt')
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @ApiQuery({ name: 'offset', required: false, type: Number })
+  @ApiQuery({ name: 'fields', required: false, type: Array })
+  @ApiQuery({ name: 'sort', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  findMany(@Query() query: any) {
+    return this.service.find(query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Get(':id')
+  findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete('/bulk')
+  deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete(':id')
+  delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+}

package/src/dtos/create-agent-event.dto.ts

@@ -0,0 +1,84 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsDate, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class CreateAgentEventDto {
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  sessionId: string;
+
+  @IsNotEmpty()
+  @IsInt()
+  @ApiProperty()
+  turnNumber: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  stepNumber: number;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  eventType: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  eventData: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  content: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolName: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolArguments: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolOutput: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  toolReturncode: number;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  durationMs: number;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  cost: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  inputTokens: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  outputTokens: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  modelUsed: string;
+
+  @IsOptional()
+  @IsDate()
+  @ApiProperty()
+  createdAt: Date;
+}

package/src/dtos/create-agent-session.dto.ts

@@ -0,0 +1,64 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsDate, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class CreateAgentSessionDto {
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  sessionId: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  userId: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  projectRoot: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  modelName: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  status: string;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  totalCost: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalSteps: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalInputTokens: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalOutputTokens: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  summary: string;
+
+  @IsOptional()
+  @IsDate()
+  @ApiProperty()
+  createdAt: Date;
+
+  @IsOptional()
+  @IsDate()
+  @ApiProperty()
+  updatedAt: Date;
+}

package/src/dtos/update-agent-event.dto.ts

@@ -0,0 +1,83 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsInt, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class UpdateAgentEventDto {
+  @IsOptional()
+  @IsInt()
+  id: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  sessionId: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  turnNumber: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  stepNumber: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  eventType: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  eventData: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  content: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolName: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolArguments: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolOutput: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  toolReturncode: number;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  durationMs: number;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  cost: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  inputTokens: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  outputTokens: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  modelUsed: string;
+}

package/src/dtos/update-agent-session.dto.ts

@@ -0,0 +1,63 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsDate, IsInt, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class UpdateAgentSessionDto {
+  @IsOptional()
+  @IsInt()
+  id: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  sessionId: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  userId: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  projectRoot: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  modelName: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  status: string;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  totalCost: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalSteps: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalInputTokens: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  totalOutputTokens: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  summary: string;
+
+  @IsOptional()
+  @IsDate()
+  @ApiProperty()
+  updatedAt: Date;
+}

package/src/entities/agent-event.entity.ts

@@ -0,0 +1,88 @@
+import { Column, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
+import { Expose, Exclude } from 'class-transformer';
+
+@Exclude()
+@Entity({ name: 'ss_agent_events', synchronize: false })
+export class AgentEvent {
+  @Expose()
+  @PrimaryGeneratedColumn({ type: 'integer' })
+  id: number;
+
+  @Expose()
+  @Index()
+  @Column({ type: 'varchar', length: 36, name: 'session_id' })
+  sessionId: string;
+
+  @Expose()
+  @Column({ type: 'integer', name: 'turn_number' })
+  turnNumber: number;
+
+  @Expose()
+  @Column({ type: 'integer', nullable: true, name: 'step_number' })
+  stepNumber: number;
+
+  @Expose()
+  @Index()
+  @Column({ type: 'varchar', length: 64, name: 'event_type' })
+  eventType: string;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'event_data' })
+  eventData: string;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'content' })
+  content: string;
+
+  @Expose()
+  @Index()
+  @Column({ type: 'varchar', length: 128, nullable: true, name: 'tool_name' })
+  toolName: string;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'tool_arguments' })
+  toolArguments: string;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'tool_output' })
+  toolOutput: string;
+
+  @Expose()
+  @Column({ type: 'integer', nullable: true, name: 'tool_returncode' })
+  toolReturncode: number;
+
+  @Expose()
+  @Column({ type: 'double precision', nullable: true, name: 'duration_ms' })
+  durationMs: number;
+
+  @Expose()
+  @Column({ type: 'double precision', nullable: true, name: 'cost' })
+  cost: number;
+
+  @Expose()
+  @Column({ type: 'integer', nullable: true, name: 'input_tokens' })
+  inputTokens: number;
+
+  @Expose()
+  @Column({ type: 'integer', nullable: true, name: 'output_tokens' })
+  outputTokens: number;
+
+  @Expose()
+  @Column({ type: 'varchar', length: 255, nullable: true, name: 'model_used' })
+  modelUsed: string;
+
+  @Expose()
+  @Column({ type: 'timestamp without time zone', name: 'created_at' })
+  createdAt: Date;
+
+  // The following properties satisfy CRUDService<T extends CommonEntity> structural typing
+  // They are not mapped to DB columns (synchronize: false ensures no schema changes)
+  updatedAt: Date;
+  deletedAt: Date;
+  deletedTracker: string;
+  publishedAt: Date;
+  localeName: string;
+  defaultEntityLocaleId: number;
+  createdBy: number;
+  updatedBy: number;
+}

package/src/entities/agent-session.entity.ts

@@ -0,0 +1,71 @@
+import { Column, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
+import { Expose, Exclude } from 'class-transformer';
+
+@Exclude()
+@Entity({ name: 'ss_agent_sessions', synchronize: false })
+export class AgentSession {
+  @Expose()
+  @PrimaryGeneratedColumn({ type: 'integer' })
+  id: number;
+
+  @Expose()
+  @Index({ unique: true })
+  @Column({ type: 'varchar', length: 36, name: 'session_id' })
+  sessionId: string;
+
+  @Expose()
+  @Index()
+  @Column({ type: 'integer', nullable: true, name: 'user_id' })
+  userId: number;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'project_root' })
+  projectRoot: string;
+
+  @Expose()
+  @Column({ type: 'varchar', length: 255, name: 'model_name' })
+  modelName: string;
+
+  @Expose()
+  @Index()
+  @Column({ type: 'varchar', length: 32, name: 'status' })
+  status: string;
+
+  @Expose()
+  @Column({ type: 'double precision', name: 'total_cost', default: 0 })
+  totalCost: number;
+
+  @Expose()
+  @Column({ type: 'integer', name: 'total_steps', default: 0 })
+  totalSteps: number;
+
+  @Expose()
+  @Column({ type: 'integer', name: 'total_input_tokens', default: 0 })
+  totalInputTokens: number;
+
+  @Expose()
+  @Column({ type: 'integer', name: 'total_output_tokens', default: 0 })
+  totalOutputTokens: number;
+
+  @Expose()
+  @Column({ type: 'text', nullable: true, name: 'summary' })
+  summary: string;
+
+  @Expose()
+  @Column({ type: 'timestamp without time zone', name: 'created_at' })
+  createdAt: Date;
+
+  @Expose()
+  @Column({ type: 'timestamp without time zone', name: 'updated_at' })
+  updatedAt: Date;
+
+  // The following properties satisfy CRUDService<T extends CommonEntity> structural typing
+  // They are not mapped to DB columns (synchronize: false ensures no schema changes)
+  deletedAt: Date;
+  deletedTracker: string;
+  publishedAt: Date;
+  localeName: string;
+  defaultEntityLocaleId: number;
+  createdBy: number;
+  updatedBy: number;
+}