API: Added the description

Author: irfanpena

cortex-js/src/infrastructure/controllers/events.controller.ts

@@ -13,7 +13,7 @@ import { DownloadManagerService } from '@/download-manager/download-manager.serv
 import { ModelsUsecases } from '@/usecases/models/models.usecases';
 import { Controller, Sse } from '@nestjs/common';
 import { EventEmitter2 } from '@nestjs/event-emitter';
-import { ApiTags } from '@nestjs/swagger';
+import { ApiOperation, ApiTags } from '@nestjs/swagger';
 import {
   Observable,
   combineLatest,
@@ -34,6 +34,10 @@ export class EventsController {
     private readonly eventEmitter: EventEmitter2,
   ) {}
 
+  @ApiOperation({
+    summary: 'Get download status',
+    description: "Retrieves the model's download status.",
+  })
   @Sse('download')
   downloadEvent(): Observable<DownloadStateEvent> {
     const latestDownloadState$: Observable<DownloadStateEvent> = of({
@@ -60,6 +64,10 @@ export class EventsController {
     ).pipe();
   }
 
+  @ApiOperation({
+    summary: 'Get model status',
+    description: 'Retrieves all the available model statuses within Cortex.',
+  })
   @Sse('model')
   modelEvent(): Observable<ModelStatusAndEvent> {
     const latestModelStatus$: Observable<Record<ModelId, ModelStatus>> = of(

cortex-js/src/infrastructure/controllers/process.controller.ts

@@ -8,7 +8,7 @@ export class ProcessController {
 
   @ApiOperation({
     summary: 'Terminate service',
-    description: 'Terminate service endpoint',
+    description: 'Terminates the Cortex API endpoint server for the detached mode.',
   })
   @Delete()
   async delete() {

cortex-js/src/infrastructure/controllers/status.controller.ts

@@ -7,8 +7,8 @@ export class StatusController {
   constructor() {}
 
   @ApiOperation({
-    summary: 'Health check',
-    description: 'Health check endpoint.',
+    summary: "Get health status",
+    description: "Retrieves the health status of your Cortex's system.",
   })
   @HttpCode(200)
   @ApiResponse({

cortex-js/src/main.ts

@@ -58,6 +58,18 @@ async function bootstrap() {
       'Embeddings',
       'Endpoint for creating and retrieving embedding vectors from text inputs using specified models.',
     )
+    .addTag(
+      'Status',
+      "Endpoint for actively querying the health status of the Cortex.",
+    )
+    .addTag(
+      'Processes',
+      'Endpoint for terminating the Cortex API server processes.',
+    )
+    .addTag(
+      'Events',
+      'Endpoints for  observing Cortex statuses through event notifications.',
+    )    
     .addServer('http://localhost:1337')
     .addServer('http://localhost:1337/v1')
     .build();