@carlonicora/nestjs-neo4jsonapi 1.34.0 → 1.34.2

package/README.md

@@ -1,6 +1,6 @@
 # @carlonicora/nestjs-neo4jsonapi
 
-A comprehensive NestJS foundation package providing JSON:API compliant APIs, Neo4j graph database integration, Redis caching, LangChain-based AI agents (including GraphRAG), and common utilities for building modern multi-tenant applications.
+A comprehensive NestJS foundation package providing JSON:API compliant APIs, Neo4j graph database integration, Redis caching, LangChain-based AI agents (including GraphRAG and DRIFT), OAuth 2.0 server, OpenAPI documentation, and common utilities for building modern multi-tenant applications.
 
 ## Table of Contents
 
@@ -9,14 +9,18 @@ A comprehensive NestJS foundation package providing JSON:API compliant APIs, Neo
 - [Installation](#installation)
 - [Environment Variables](#environment-variables)
 - [Quick Start](#quick-start)
-- [Advanced Setup (Custom Bootstrap)](#advanced-setup-custom-bootstrap)
 - [Company-User Model (B2B & B2C)](#company-user-model-b2b--b2c)
 - [Required Configuration Files](#required-configuration-files)
 - [Core Modules](#core-modules)
 - [Health Check Endpoints](#health-check-endpoints)
 - [Foundation Modules](#foundation-modules)
 - [AI Agents](#ai-agents)
+- [DRIFT Module (Advanced Semantic Search)](#drift-module-advanced-semantic-search)
+- [OpenAPI Documentation](#openapi-documentation)
+- [OAuth 2.0 Support](#oauth-20-support)
 - [Security & Authentication](#security--authentication)
+- [Company Deletion Handler](#company-deletion-handler)
+- [Entity Descriptors (defineEntity)](#entity-descriptors-defineentity)
 - [Customizing Agent Prompts](#customizing-agent-prompts-optional)
 - [License](#license)
 
@@ -27,10 +31,15 @@ A comprehensive NestJS foundation package providing JSON:API compliant APIs, Neo
 - **Neo4j Integration**: Graph database operations with Cypher query builder
 - **Redis Caching**: Built-in caching layer with configurable TTLs
 - **Multi-Tenant Architecture**: Support for both B2B (multi-company) and B2C (single invisible company) scenarios
-- **AI Agents**: LangChain-powered agents including GraphRAG for knowledge extraction, summarization, and intelligent responses
+- **AI Agents**: LangChain-powered agents including GraphRAG and DRIFT for knowledge extraction, summarization, and intelligent responses
+- **DRIFT Search**: Advanced semantic search using community detection and HyDE (Hypothetical Document Embedding)
+- **OAuth 2.0 Server**: RFC 6749/7636 compliant authorization server with PKCE support
+- **OpenAPI Documentation**: Auto-generated JSON:API compliant Swagger/Redoc documentation
 - **Authentication**: JWT-based authentication with role-based access control
 - **Background Jobs**: BullMQ integration for async job processing
 - **WebSockets**: Real-time communication support
+- **Vision LLM Support**: Separate configuration for vision/image analysis models
+- **Transcriber Support**: Speech-to-text transcription capabilities
 - **Tracing**: OpenTelemetry integration for distributed tracing
 - **Logging**: Structured logging with Loki integration
 
@@ -49,6 +58,7 @@ The library is designed to run in two modes from the same codebase:
 
 - Processes BullMQ jobs asynchronously
 - Runs scheduled tasks (cron jobs)
+- Discord bot integration (when configured)
 - No HTTP server - just job processing
 - Same configuration and modules as API
 
@@ -66,19 +76,20 @@ pnpm start:prod       # API mode
 pnpm start:worker:prod # Worker mode
 ```
 
-The mode is determined by the `--mode` flag and configured via `getAppMode()` and `getAppModeConfig()`:
+The mode is determined by the `--mode` flag and configured via `getAppMode()` and `getAppModeConfig()`.
 
 ## Architecture
 
-The library is organized into four main layers:
+The library is organized into five main layers:
 
 ```
 @carlonicora/nestjs-neo4jsonapi
 ├── common/       # Shared utilities, abstracts, decorators, guards
 ├── config/       # Configuration system and tokens
-├── core/         # Infrastructure modules (18 modules)
-├── foundations/  # Domain/business modules (17 modules)
-├── agents/       # AI agent modules (4 modules)
+├── core/         # Infrastructure modules (19 modules)
+├── foundations/  # Domain/business modules (31 modules)
+├── agents/       # AI agent modules (7 modules)
+├── openapi/      # OpenAPI/Swagger documentation
 └── bootstrap/    # Application bootstrap utilities
 ```
 
@@ -208,28 +219,84 @@ CACHE_SKIP_PATTERNS=/access,/auth,/notifications,/websocket,/version
 JWT_SECRET=your-jwt-secret
 JWT_EXPIRES_IN=1h
 
+# Auth
+ALLOW_REGISTRATION=true
+
+# OAuth 2.0 Server (optional)
+OAUTH_ENABLED=false
+OAUTH_AUTHORIZATION_CODE_LIFETIME=600
+OAUTH_ACCESS_TOKEN_LIFETIME=3600
+OAUTH_REFRESH_TOKEN_LIFETIME=604800
+OAUTH_REQUIRE_PKCE_FOR_PUBLIC_CLIENTS=true
+OAUTH_ROTATE_REFRESH_TOKENS=true
+
 # CORS
 CORS_ORIGINS=http://localhost:3001
 CORS_CREDENTIALS=true
+CORS_ORIGIN_PATTERNS=
+CORS_METHODS=GET,HEAD,PUT,PATCH,POST,DELETE,OPTIONS
+CORS_ALLOWED_HEADERS=
+CORS_MAX_AGE=86400
+CORS_PREFLIGHT_CONTINUE=false
+CORS_OPTIONS_SUCCESS_STATUS=204
+CORS_LOG_VIOLATIONS=true
 
 # AI Configuration (optional)
 AI_PROVIDER=openai
 AI_API_KEY=sk-...
 AI_MODEL=gpt-4o-mini
+AI_URL=
+AI_REGION=
+AI_INSTANCE=
+AI_API_VERSION=
+AI_INPUT_COST_PER_1M_TOKENS=0
+AI_OUTPUT_COST_PER_1M_TOKENS=0
+AI_GOOGLE_CREDENTIALS_BASE64=
+
+# Vision LLM (optional - falls back to AI_ settings if not set)
+VISION_PROVIDER=openai
+VISION_API_KEY=
+VISION_MODEL=gpt-4o
+VISION_URL=
+VISION_REGION=
+VISION_SECRET=
+VISION_INSTANCE=
+VISION_API_VERSION=
+VISION_INPUT_COST_PER_1M_TOKENS=0
+VISION_OUTPUT_COST_PER_1M_TOKENS=0
+VISION_GOOGLE_CREDENTIALS_BASE64=
+
+# Transcriber (optional)
+TRANSCRIBER_PROVIDER=
+TRANSCRIBER_API_KEY=
+TRANSCRIBER_MODEL=
+TRANSCRIBER_URL=
+TRANSCRIBER_API_VERSION=
 
 # Embedder (optional)
 EMBEDDER_PROVIDER=openrouter
 EMBEDDER_API_KEY=sk-...
 EMBEDDER_MODEL=openai/text-embedding-3-large
 EMBEDDER_DIMENSIONS=3072
+EMBEDDER_INSTANCE=
+EMBEDDER_API_VERSION=
+EMBEDDER_REGION=
+EMBEDDER_GOOGLE_CREDENTIALS_BASE64=
 
 # Logging - Loki (optional)
 LOKI_ENABLED=false
 LOKI_HOST=http://localhost:3100
+LOKI_USERNAME=
+LOKI_PASSWORD=
+LOKI_BATCHING=true
+LOKI_INTERVAL=30
+LOKI_APP_LABEL=
 
 # Tracing - Tempo (optional)
 TEMPO_ENABLED=false
 TEMPO_ENDPOINT=http://localhost:4318/v1/traces
+TEMPO_SERVICE_NAME=my-app
+TEMPO_SERVICE_VERSION=1.0.0
 
 # S3 Storage (optional)
 S3_TYPE=aws
@@ -239,15 +306,23 @@ S3_ACCESS_KEY_ID=
 S3_SECRET_ACCESS_KEY=
 S3_REGION=eu-west-1
 
-# Email (optional)
+# Email (supports: sendgrid, smtp, brevo)
 EMAIL_PROVIDER=sendgrid
 EMAIL_API_KEY=
 EMAIL_FROM=noreply@example.com
+EMAIL_HOST=
+EMAIL_PORT=587
+EMAIL_SECURE=false
+EMAIL_USERNAME=
+EMAIL_PASSWORD=
 
 # Stripe (optional)
 STRIPE_SECRET_KEY=
 STRIPE_PUBLISHABLE_KEY=
 STRIPE_WEBHOOK_SECRET=
+STRIPE_API_VERSION=2024-12-18.acacia
+STRIPE_PORTAL_RETURN_URL=
+STRIPE_PORTAL_CONFIGURATION_ID=
 
 # Push Notifications (optional)
 VAPID_PUBLIC_KEY=
@@ -258,15 +333,41 @@ VAPID_EMAIL=
 RATE_LIMIT_ENABLED=true
 RATE_LIMIT_TTL=60000
 RATE_LIMIT_REQUESTS=100
+IP_RATE_LIMIT_REQUESTS=20
 
 # Encryption
 ENCRYPTION_KEY=your-32-char-encryption-key
+
+# Discord (optional)
+DISCORD_CLIENT_ID=
+DISCORD_CLIENT_SECRET=
+DISCORD_TOKEN=
+DISCORD_DEV_GUILD_ID=
+
+# Google (optional)
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
 ```
 
 ## Quick Start
 
 The library provides a `bootstrap()` function that handles all the complexity of setting up a NestJS application. You only need to provide your app-specific configuration.
 
+**What you need:**
+1. `main.ts` - Bootstrap entry point (~25 lines)
+2. `config/config.ts` - Optional custom config extending baseConfig
+3. `features/features.modules.ts` - Your feature modules
+
+**What the library handles internally:**
+- AppModule creation (no `app.module.ts` needed)
+- Fastify adapter with multipart support
+- Global validation pipes, exception filters, and interceptors
+- Rate limiting, CORS, and caching
+- i18n internationalization
+- OpenAPI/Swagger documentation
+- Discord bot integration (Worker mode)
+- Graceful shutdown handlers
+
 ### 1. Create Your Features Module
 
 ```typescript
@@ -282,7 +383,7 @@ import { Module } from "@nestjs/common";
 export class FeaturesModules {}
 ```
 
-### 3. Create Configuration File (Optional)
+### 2. Create Configuration File (Optional)
 
 If you need custom queues or content types, create a config file:
 
@@ -304,6 +405,33 @@ export default () => ({
 });
 ```
 
+### 3. Create OpenAPI Configuration (Optional)
+
+```typescript
+// src/openapi/openapi.config.ts
+import { OpenApiOptions } from "@carlonicora/nestjs-neo4jsonapi";
+import { allEntityDescriptors } from "./entity-registry";
+
+export function getOpenApiConfig(): OpenApiOptions {
+  const isDevelopment = process.env.NODE_ENV !== "production";
+
+  return {
+    enableSwagger: isDevelopment || process.env.ENABLE_SWAGGER === "true",
+    swaggerPath: "/api-docs",
+    enableRedoc: isDevelopment || process.env.ENABLE_REDOC === "true",
+    redocPath: "/docs",
+    entityDescriptors: [...allEntityDescriptors],
+    title: "My API",
+    description: "RESTful API following JSON:API specification",
+    version: process.env.npm_package_version || "1.0.0",
+    bearerAuth: true,
+    contactEmail: "api@example.com",
+    license: "Proprietary",
+    licenseUrl: "https://example.com/terms",
+  };
+}
+```
+
 ### 4. Bootstrap Your Application
 
 ```typescript
@@ -315,8 +443,9 @@ import * as path from "path";
 dotenv.config({ path: path.resolve(__dirname, "../../../.env") });
 
 import { bootstrap } from "@carlonicora/nestjs-neo4jsonapi";
-import config from "./config/config"; // Optional: only if you have custom config
+import config from "./config/config";
 import { FeaturesModules } from "./features/features.modules";
+import { getOpenApiConfig } from "./openapi/openapi.config";
 
 bootstrap({
   appModules: [FeaturesModules],
@@ -324,26 +453,25 @@ bootstrap({
     fallbackLanguage: "en",
     path: path.join(__dirname, "i18n"),
   },
-  config, // Optional: pass custom config to extend baseConfig
+  config: config,
+  contentExtension: {
+    additionalRelationships: [],
+  },
+  openApi: getOpenApiConfig(),
 });
 ```
 
-That's it! The `bootstrap()` function handles:
-
-- Tracing initialization
-- API vs Worker mode detection (via `--mode=api` or `--mode=worker` CLI args)
-- Fastify adapter with multipart support
-- Global validation pipes, exception filters, and interceptors
-- Rate limiting, CORS, and caching
-- Graceful shutdown handlers
+That's it! The `bootstrap()` function handles everything else.
 
 ### Bootstrap Options
 
-| Option       | Type                             | Required | Description                                                          |
-| ------------ | -------------------------------- | -------- | -------------------------------------------------------------------- |
-| `appModules` | `(Type<any> \| DynamicModule)[]` | Yes      | Your app-specific feature modules                                    |
-| `i18n`       | `I18nOptions`                    | No       | i18n configuration (fallbackLanguage, path)                          |
-| `config`     | `() => Record<string, any>`      | No       | Custom config that extends baseConfig (merged with library defaults) |
+| Option             | Type                             | Required | Description                                                          |
+| ------------------ | -------------------------------- | -------- | -------------------------------------------------------------------- |
+| `appModules`       | `(Type<any> \| DynamicModule)[]` | Yes      | Your app-specific feature modules                                    |
+| `i18n`             | `I18nOptions`                    | No       | i18n configuration (fallbackLanguage, path)                          |
+| `config`           | `() => Record<string, any>`      | No       | Custom config that extends baseConfig (merged with library defaults) |
+| `contentExtension` | `ContentExtensionOptions`        | No       | Additional relationships for Content module                          |
+| `openApi`          | `OpenApiOptions`                 | No       | OpenAPI/Swagger documentation configuration                          |
 
 ### Configuration Options (via `config`)
 
@@ -356,310 +484,26 @@ The `config` function returns an object that is merged with `baseConfig`. Availa
 | `jobNames`             | `{ process: Record<string, string>, notifications?: Record<string, string> }` | Job names for BullMQ processors (maps content types to job names)                              |
 | `prompts.*`            | Various                                                                       | Custom AI agent prompts (see [Customizing Agent Prompts](#customizing-agent-prompts-optional)) |
 
----
-
-## Advanced Setup (Custom Bootstrap)
-
-If you need more control over the bootstrap process, you can manually configure the AppModule and main.ts.
-
-### 1. Create Configuration File
-
-```typescript
-// src/config/config.ts
-import { baseConfig } from "@carlonicora/nestjs-neo4jsonapi";
-import { JobName } from "./enums/job.name";
-import { QueueId } from "./enums/queue.id";
-// Import your content type metas
-import { articleMeta } from "src/features/article/entities/article.meta";
-import { documentMeta } from "src/features/document/entities/document.meta";
-
-export default () => ({
-  ...baseConfig,
-  // Register all app queue IDs for background job processing
-  chunkQueues: {
-    queueIds: Object.values(QueueId),
-  },
-  // Register content type labels for multi-label Neo4j queries
-  contentTypes: {
-    types: [
-      articleMeta.labelName,
-      documentMeta.labelName,
-      // Add your content type labels here
-    ],
-  },
-  // Register job names for BullMQ processors
-  jobNames: JobName,
-});
-```
-
-```typescript
-// src/config/enums/queue.id.ts
-export enum QueueId {
-  CHUNK = "chunk",
-  DOCUMENT = "document",
-  ARTICLE = "article",
-  // Add your custom queue IDs here (lowercase of content type labelName)
-}
-```
-
-```typescript
-// src/config/enums/job.name.ts
-export const JobName = {
-  process: {
-    chunk: "process_chunk",
-    Document: "process_document",
-    Article: "process_article",
-    // Keys match content type labelName (e.g., "Article", "Document")
-    // Values are the job names used by processors
-  },
-  notifications: {
-    // Optional notification job names
-  },
-} as const;
-```
-
-### 2. Setup App Module
-
-```typescript
-// src/app.module.ts
-import { DynamicModule, Module } from "@nestjs/common";
-import { ConfigModule, ConfigService } from "@nestjs/config";
-import { EventEmitterModule } from "@nestjs/event-emitter";
-import { ScheduleModule } from "@nestjs/schedule";
-import { ThrottlerModule } from "@nestjs/throttler";
-import { ClsModule } from "nestjs-cls";
-
-import {
-  AgentsModule,
-  AppModeConfig,
-  AppModeModule,
-  BaseConfigInterface,
-  ConfigRateLimitInterface,
-  CoreModule,
-  FoundationsModule,
-} from "@carlonicora/nestjs-neo4jsonapi";
-
-// App configuration (includes chunkQueues config)
-import config from "./config/config";
-
-// App-specific modules
-import { FeaturesModules } from "src/features/features.modules";
-
-@Module({})
-export class AppModule {
-  static forRoot(modeConfig: AppModeConfig): DynamicModule {
-    return {
-      module: AppModule,
-      imports: [
-        // Event emitter for internal events
-        EventEmitterModule.forRoot(),
-
-        // App mode configuration (API vs Worker)
-        AppModeModule.forRoot(modeConfig),
-
-        // Configuration
-        ConfigModule.forRoot({
-          load: [config],
-          isGlobal: true,
-          cache: true,
-        }),
-
-        // Rate limiting
-        ThrottlerModule.forRootAsync({
-          imports: [ConfigModule],
-          inject: [ConfigService],
-          useFactory: (configService: ConfigService<BaseConfigInterface>) => {
-            const rateLimitConfig = configService.get<ConfigRateLimitInterface>("rateLimit");
-            return {
-              throttlers: [
-                {
-                  name: "default",
-                  ttl: rateLimitConfig.ttl,
-                  limit: rateLimitConfig.limit,
-                },
-              ],
-            };
-          },
-        }),
-
-        // Request-scoped context (CLS) - required for user/company context
-        ClsModule.forRoot({
-          global: true,
-          middleware: { mount: modeConfig.enableControllers },
-        }),
-
-        // Scheduled jobs (only enabled in worker mode)
-        ...(modeConfig.enableCronJobs ? [ScheduleModule.forRoot()] : []),
-
-        // ========================================
-        // LIBRARY MODULES
-        // ========================================
-
-        // Core infrastructure (Neo4j, Redis, Cache, Security, etc.)
-
-        // Foundation domain modules (User, Company, Auth, etc.)
-        // Queues are configured via baseConfig.chunkQueues in config.ts
-        FoundationsModule,
-
-        // AI Agents (GraphRAG, Summariser, Responder, etc.)
-        // Prompts are configured via baseConfig.prompts
-        AgentsModule,
-
-        // ========================================
-        // YOUR APP-SPECIFIC MODULES
-        // ========================================
-        FeaturesModules,
-      ],
-      global: true,
-      controllers: [],
-    };
-  }
-}
-```
-
-### 3. Setup main.ts (Bootstrap)
-
-```typescript
-// src/main.ts
-import * as dotenv from "dotenv";
-import * as path from "path";
-
-// Load environment variables FIRST
-dotenv.config({ path: path.resolve(__dirname, "../../../.env") });
-
-// Initialize tracing BEFORE any other imports
-import { tracingSetup } from "@carlonicora/nestjs-neo4jsonapi";
-tracingSetup.initialize();
-
-import { ValidationPipe } from "@nestjs/common";
-import { ConfigService } from "@nestjs/config";
-import { NestFactory, Reflector } from "@nestjs/core";
-import { FastifyAdapter, NestFastifyApplication } from "@nestjs/platform-fastify";
-import { EventEmitter } from "stream";
-
-import {
-  AppLoggingService,
-  AppMode,
-  AppModeConfig,
-  BaseConfigInterface,
-  CacheInterceptor,
-  CacheService,
-  ConfigApiInterface,
-  CorsService,
-  getAppMode,
-  getAppModeConfig,
-  HttpExceptionFilter,
-  LoggingInterceptor,
-  TracingInterceptor,
-} from "@carlonicora/nestjs-neo4jsonapi";
-
-import { AppModule } from "./app.module";
-
-async function bootstrapAPI(modeConfig: AppModeConfig): Promise<void> {
-  const app = await NestFactory.create<NestFastifyApplication>(
-    AppModule.forRoot(modeConfig),
-    new FastifyAdapter({
-      routerOptions: { ignoreTrailingSlash: true },
-      bodyLimit: 100 * 1024 * 1024,
-    }),
-    { logger: ["error", "warn"] },
-  );
-
-  const configService = app.get(ConfigService<BaseConfigInterface>);
-
-  // Register multipart support for file uploads
-  await app.register(require("@fastify/multipart"), {
-    limits: {
-      fileSize: 100 * 1024 * 1024,
-      fieldSize: 10 * 1024 * 1024,
-      files: 10,
-      fields: 20,
-    },
-    attachFieldsToBody: false,
-  });
-
-  // Setup logging
-  const loggingService = app.get(AppLoggingService);
-  app.useLogger(loggingService);
-
-  // Add Fastify onSend hook for request logging
-  app
-    .getHttpAdapter()
-    .getInstance()
-    .addHook("onSend", async (request, reply, payload) => {
-      const startTime = request.raw["requestStartTime"];
-      if (startTime) {
-        const responseTime = Date.now() - startTime;
-        loggingService.logHttpRequest(request.method, request.url, reply.statusCode, responseTime, request.ip);
-        loggingService.clearRequestContext();
-      }
-      return payload;
-    });
-
-  // Global filters and pipes
-  app.useGlobalFilters(new HttpExceptionFilter(loggingService));
-  app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
-
-  // Apply interceptors in order: Tracing -> Cache -> Logging
-  app.useGlobalInterceptors(app.get(TracingInterceptor));
-  app.useGlobalInterceptors(new CacheInterceptor(app.get(CacheService), app.get(Reflector), loggingService));
-  app.useGlobalInterceptors(app.get(LoggingInterceptor));
-
-  // Setup CORS
-  const corsService = app.get(CorsService);
-  corsService.validateConfiguration();
-  app.enableCors(corsService.getCorsConfiguration());
-
-  // Start server
-  const port = configService.get<ConfigApiInterface>("api").port;
-  await app.listen(port, "0.0.0.0");
-  loggingService.log(`API server started on port ${port}`);
-
-  // Graceful shutdown
-  process.on("SIGTERM", async () => {
-    await app.close();
-    process.exit(0);
-  });
-  process.on("SIGINT", async () => {
-    await app.close();
-    process.exit(0);
-  });
-}
-
-async function bootstrapWorker(modeConfig: AppModeConfig): Promise<void> {
-  const app = await NestFactory.createApplicationContext(AppModule.forRoot(modeConfig), {
-    logger: ["error", "warn"],
-  });
-
-  const loggingService = app.get(AppLoggingService);
-  app.useLogger(loggingService);
-  loggingService.log("Worker process started");
+### What bootstrap() Handles Internally
 
-  process.on("SIGTERM", async () => {
-    await app.close();
-    process.exit(0);
-  });
-  process.on("SIGINT", async () => {
-    await app.close();
-    process.exit(0);
-  });
-}
-
-async function bootstrap(): Promise<void> {
-  EventEmitter.defaultMaxListeners = 50;
+The `bootstrap()` function creates a dynamic `AppModule` that includes:
 
-  const mode = getAppMode();
-  const modeConfig = getAppModeConfig(mode);
+- EventEmitterModule for async events
+- AppModeModule (API vs Worker mode)
+- ConfigModule with merged configuration
+- ThrottlerModule for rate limiting
+- ClsModule for request context
+- I18nModule for internationalization
+- ScheduleModule for cron jobs (Worker mode only)
+- CoreModule (all infrastructure modules)
+- FoundationsModule (all domain modules)
+- AgentsModule (AI agents)
+- OpenApiModule for documentation
+- NecordModule + DiscordModule (Worker mode, when DISCORD_TOKEN is set)
 
-  if (mode === AppMode.WORKER) {
-    await bootstrapWorker(modeConfig);
-  } else {
-    await bootstrapAPI(modeConfig);
-  }
-}
+> **Note:** For advanced customization scenarios, you can examine the bootstrap source code in `packages/nestjs-neo4jsonapi/src/bootstrap/`. However, the default `bootstrap()` function handles all common use cases.
 
-bootstrap();
-```
+---
 
 ## Company-User Model (B2B & B2C)
 
@@ -839,17 +683,20 @@ query.query = `
 your-app/
 ├── src/
 │   ├── config/
-│   │   ├── config.ts                 # App configuration
-│   │   ├── company.configurations.ts # Company context loader
+│   │   ├── config.ts                 # App configuration (optional)
 │   │   └── enums/
-│   │       └── queue.id.ts           # Queue identifiers
+│   │       └── queue.id.ts           # Queue identifiers (if using jobs)
 │   ├── features/                     # Your app-specific modules
-│   ├── app.module.ts
-│   └── main.ts
+│   │   └── features.modules.ts       # Imports all your feature modules
+│   ├── openapi/                      # OpenAPI config (optional)
+│   │   └── openapi.config.ts
+│   └── main.ts                       # Bootstrap entry (~25 lines)
 ├── .env
 └── package.json
 ```
 
+**Note:** No `app.module.ts` is required - the library creates this dynamically via `createAppModule()`.
+
 ### Queue IDs and Job Names (if using background jobs)
 
 Queue IDs must match the lowercase version of your content type `labelName`:
@@ -882,7 +729,7 @@ export const JobName = {
 
 ## Core Modules
 
-The library includes 18 core infrastructure modules:
+The library includes 19 core infrastructure modules:
 
 | Module            | Description                                      |
 | ----------------- | ------------------------------------------------ |
@@ -893,7 +740,7 @@ The library includes 18 core infrastructure modules:
 | `JsonApiModule`   | JSON:API specification compliance                |
 | `LoggingModule`   | Structured logging with Loki                     |
 | `TracingModule`   | Distributed tracing with OpenTelemetry           |
-| `EmailModule`     | Email service (SendGrid, SMTP)                   |
+| `EmailModule`     | Email service (SendGrid, SMTP, Brevo)            |
 | `QueueModule`     | BullMQ job queue processing                      |
 | `WebsocketModule` | Real-time WebSocket communication                |
 | `CorsModule`      | CORS configuration                               |
@@ -1021,35 +868,50 @@ The module includes four health indicators:
 | `Neo4jHealthIndicator` | 3s      | Executes `RETURN 1` query  |
 | `RedisHealthIndicator` | 3s      | Connection status + PING   |
 | `S3HealthIndicator`    | 5s      | Bucket access (HeadBucket) |
-| `DiskHealthIndicator`  | -       | Free space ≥ 1GB or 10%    |
+| `DiskHealthIndicator`  | -       | Free space >= 1GB or 10%    |
 
 ## Foundation Modules
 
-The library includes 17 foundation modules for business domain logic:
-
-| Module               | Description                                      |
-| -------------------- | ------------------------------------------------ |
-| `UserModule`         | User management with CRUD operations             |
-| `CompanyModule`      | Multi-tenant company management                  |
-| `AuthModule`         | Authentication (login, register, password reset) |
-| `RoleModule`         | Role management                                  |
-| `ChunkModule`        | Document chunk storage and retrieval             |
-| `ChunkerModule`      | Document parsing (PDF, DOCX, XLSX, HTML)         |
-| `AtomicFactModule`   | Atomic facts management for knowledge graphs     |
-| `KeyConceptModule`   | Key concepts for knowledge graphs                |
-| `ContentModule`      | Content management                               |
-| `NotificationModule` | User notifications                               |
-| `PushModule`         | Push notifications (VAPID)                       |
-| `FeatureModule`      | Feature flag management                          |
-| `ModuleModule`       | Module/plugin management                         |
-| `S3Module`           | S3-compatible storage                            |
-| `TokenUsageModule`   | AI token usage tracking                          |
-| `AuditModule`        | Audit logging                                    |
-| `RelevancyModule`    | Relevancy scoring                                |
+The library includes 31 foundation modules for business domain logic:
+
+| Module                     | Description                                        |
+| -------------------------- | -------------------------------------------------- |
+| `UserModule`               | User management with CRUD operations               |
+| `CompanyModule`            | Multi-tenant company management with deletion      |
+| `AuthModule`               | Authentication (login, register, password reset)   |
+| `RoleModule`               | Role management                                    |
+| `OAuthModule`              | OAuth 2.0 Authorization Server (RFC 6749/7636)     |
+| `ChunkModule`              | Document chunk storage and retrieval               |
+| `ChunkerModule`            | Document parsing (PDF, DOCX, XLSX, HTML, PPTX)     |
+| `AtomicFactModule`         | Atomic facts management for knowledge graphs       |
+| `KeyConceptModule`         | Key concepts for knowledge graphs                  |
+| `CommunityModule`          | Knowledge graph community storage                  |
+| `ContentModule`            | Content management with extension support          |
+| `NotificationModule`       | User notifications                                 |
+| `PushModule`               | Push notifications (VAPID)                         |
+| `FeatureModule`            | Feature flag management                            |
+| `ModuleModule`             | Module/plugin management                           |
+| `S3Module`                 | S3-compatible storage                              |
+| `TokenUsageModule`         | AI token usage tracking                            |
+| `AuditModule`              | Audit logging                                      |
+| `RelevancyModule`          | Relevancy scoring                                  |
+| `DiscordModule`            | Discord bot integration                            |
+| `DiscordUserModule`        | Discord user management                            |
+| `GoogleUserModule`         | Google OAuth user management                       |
+| **Stripe Sub-modules:**    |                                                    |
+| `StripeModule`             | Core Stripe integration                            |
+| `StripeCustomerModule`     | Stripe customer management                         |
+| `StripeSubscriptionModule` | Subscription lifecycle management                  |
+| `StripeProductModule`      | Product management                                 |
+| `StripePriceModule`        | Price/plan management with feature selection       |
+| `StripeInvoiceModule`      | Invoice management                                 |
+| `StripeUsageModule`        | Usage-based billing                                |
+| `StripeWebhookModule`      | Webhook processing via BullMQ                      |
+| `StripeTrialModule`        | Trial period management with email notifications   |
 
 ## AI Agents
 
-LangChain-powered agents for intelligent document processing.
+The library includes 7 LangChain-powered agent modules for intelligent document processing:
 
 ### GraphCreatorModule
 
@@ -1127,13 +989,275 @@ export class MyService {
 }
 ```
 
+### CommunityDetectorModule
+
+Detects and creates communities from knowledge graph structure.
+
+```typescript
+import { CommunityDetectorService } from "@carlonicora/nestjs-neo4jsonapi";
+
+@Injectable()
+export class MyService {
+  constructor(private readonly communityDetector: CommunityDetectorService) {}
+
+  async detectCommunities() {
+    return this.communityDetector.detect();
+  }
+}
+```
+
+### CommunitySummariserModule
+
+Generates summaries for detected communities.
+
+```typescript
+import { CommunitySummariserService } from "@carlonicora/nestjs-neo4jsonapi";
+
+@Injectable()
+export class MyService {
+  constructor(private readonly summariser: CommunitySummariserService) {}
+
+  async summarizeCommunity(communityId: string) {
+    return this.summariser.summarize({ communityId });
+  }
+}
+```
+
+### DriftModule
+
+See [DRIFT Module (Advanced Semantic Search)](#drift-module-advanced-semantic-search) for detailed documentation.
+
+## DRIFT Module (Advanced Semantic Search)
+
+DRIFT (Dynamic Retrieval with Intelligence and Future-aware Thinking) is an advanced semantic search system that uses community detection and HyDE (Hypothetical Document Embedding) for sophisticated query understanding.
+
+### Architecture
+
+DRIFT uses a multi-node workflow:
+
+| Node                         | Purpose                                       |
+| ---------------------------- | --------------------------------------------- |
+| `HydeNodeService`            | Generates hypothetical document embedding     |
+| `CommunitySearchNodeService` | Vector search against community summaries     |
+| `PrimerAnswerNodeService`    | Generates initial answer + follow-up questions|
+| `FollowUpNodeService`        | Processes follow-up questions iteratively     |
+| `SynthesisNodeService`       | Combines all answers into final response      |
+
+### Usage
+
+```typescript
+import { DriftSearchService } from "@carlonicora/nestjs-neo4jsonapi";
+
+@Injectable()
+export class MyService {
+  constructor(private readonly driftSearch: DriftSearchService) {}
+
+  async searchWithDrift(question: string) {
+    // Full DRIFT workflow: HyDE -> Community Search -> Primer Answer -> Follow-ups -> Synthesis
+    const result = await this.driftSearch.search({
+      question,
+      config: {
+        primerTopK: 5,      // Top K communities to search
+        followUpDepth: 2,   // Depth of follow-up question iterations
+      },
+    });
+
+    // result contains:
+    // - answer: Final synthesized answer
+    // - matchedCommunities: Communities that matched the query
+    // - followUpAnswers: Answers from follow-up questions
+    // - initialAnswer: Initial answer before follow-ups
+    // - confidence: Confidence score
+    // - hydeEmbedding: Generated hypothetical document embedding
+    return result;
+  }
+
+  async quickSearch(question: string) {
+    // Quick search without follow-ups (HyDE + Community Search + Primer only)
+    return this.driftSearch.quickSearch({ question, topK: 5 });
+  }
+}
+```
+
+### How DRIFT Works
+
+1. **HyDE Generation**: Creates a hypothetical document that would answer the question
+2. **Community Search**: Uses the HyDE embedding to find relevant communities
+3. **Primer Answer**: Generates an initial answer and identifies follow-up questions
+4. **Follow-up Processing**: Recursively explores follow-up questions for deeper context
+5. **Synthesis**: Combines all gathered information into a comprehensive final answer
+
+## OpenAPI Documentation
+
+The library includes comprehensive OpenAPI/Swagger documentation support with JSON:API compliance.
+
+### Configuration
+
+Enable OpenAPI in your bootstrap options:
+
+```typescript
+import { bootstrap } from "@carlonicora/nestjs-neo4jsonapi";
+
+bootstrap({
+  appModules: [FeaturesModules],
+  openApi: {
+    enableSwagger: true,
+    swaggerPath: '/api-docs',
+    enableRedoc: true,
+    redocPath: '/docs',
+    title: 'My API',
+    description: 'RESTful API following JSON:API specification',
+    version: '1.0.0',
+    bearerAuth: true,
+    contactEmail: 'api@example.com',
+    license: 'Proprietary',
+    licenseUrl: 'https://example.com/terms',
+    entityDescriptors: [
+      PhotographDescriptor,
+      RollDescriptor,
+      // ... your entity descriptors
+    ],
+  },
+});
+```
+
+### OpenAPI Options
+
+| Option              | Type    | Default      | Description                            |
+| ------------------- | ------- | ------------ | -------------------------------------- |
+| `enableSwagger`     | boolean | false        | Enable Swagger UI endpoint             |
+| `swaggerPath`       | string  | '/api-docs'  | Path for Swagger UI                    |
+| `enableRedoc`       | boolean | false        | Enable Redoc endpoint                  |
+| `redocPath`         | string  | '/docs'      | Path for Redoc                         |
+| `title`             | string  | -            | API documentation title                |
+| `description`       | string  | -            | API description (supports markdown)    |
+| `version`           | string  | -            | API version                            |
+| `bearerAuth`        | boolean | true         | Enable JWT Bearer auth in docs         |
+| `contactEmail`      | string  | -            | Contact email                          |
+| `license`           | string  | -            | License name                           |
+| `licenseUrl`        | string  | -            | License URL                            |
+| `entityDescriptors` | array   | []           | Entity descriptors for schema generation |
+
+### JSON:API Decorators
+
+```typescript
+import {
+  ApiJsonApiResponse,
+  ApiJsonApiListQuery,
+  ApiJsonApiListErrors,
+  ApiJsonApiCreateErrors,
+  ApiJsonApiDeleteErrors,
+} from "@carlonicora/nestjs-neo4jsonapi";
+
+@Controller('photographs')
+export class PhotographController {
+  @Get(':id')
+  @ApiJsonApiResponse(PhotographDescriptor)
+  async findById() { ... }
+
+  @Get()
+  @ApiJsonApiResponse(PhotographDescriptor, { isList: true })
+  @ApiJsonApiListQuery()
+  @ApiJsonApiListErrors()
+  async findAll() { ... }
+
+  @Post()
+  @ApiJsonApiResponse(PhotographDescriptor, { status: 201 })
+  @ApiJsonApiCreateErrors()
+  async create() { ... }
+
+  @Delete(':id')
+  @HttpCode(HttpStatus.NO_CONTENT)
+  @ApiJsonApiDeleteErrors()
+  async delete() { ... }
+}
+```
+
+## OAuth 2.0 Support
+
+The library implements a complete OAuth 2.0 Authorization Server following RFC 6749 and RFC 7636 (PKCE).
+
+### Enabling OAuth
+
+```env
+OAUTH_ENABLED=true
+OAUTH_AUTHORIZATION_CODE_LIFETIME=600
+OAUTH_ACCESS_TOKEN_LIFETIME=3600
+OAUTH_REFRESH_TOKEN_LIFETIME=604800
+OAUTH_REQUIRE_PKCE_FOR_PUBLIC_CLIENTS=true
+OAUTH_ROTATE_REFRESH_TOKENS=true
+```
+
+### OAuth Endpoints
+
+| Endpoint            | Method | Purpose                        |
+| ------------------- | ------ | ------------------------------ |
+| `/oauth/authorize`  | GET    | Authorization endpoint         |
+| `/oauth/token`      | POST   | Token endpoint                 |
+| `/oauth/revoke`     | POST   | Token revocation (RFC 7009)    |
+| `/oauth/introspect` | POST   | Token introspection (RFC 7662) |
+| `/oauth/clients`    | CRUD   | Client management              |
+
+### Protecting Endpoints with OAuth
+
+```typescript
+import {
+  JwtOrOAuthGuard,
+  OAuthScopes,
+} from "@carlonicora/nestjs-neo4jsonapi";
+
+@Controller('photographs')
+export class PhotographController {
+  // Accepts both JWT and OAuth tokens (migration path)
+  @Get(':id')
+  @UseGuards(JwtOrOAuthGuard)
+  @OAuthScopes('photographs:read')
+  async findById() { ... }
+
+  @Post()
+  @UseGuards(JwtOrOAuthGuard)
+  @OAuthScopes('photographs:read', 'photographs:write')
+  async create() { ... }
+}
+```
+
+### Context Set by OAuth
+
+When using OAuth guards, the following context is set in CLS:
+
+```typescript
+// In your service
+const userId = this.cls.get('userId');
+const companyId = this.cls.get('companyId');
+const clientId = this.cls.get('oauthClientId');
+const scopes = this.cls.get('oauthScopes');
+const authType = this.cls.get('authType'); // 'oauth' or 'jwt'
+```
+
 ## Security & Authentication
 
+### Available Guards
+
+| Guard                | Purpose                                      |
+| -------------------- | -------------------------------------------- |
+| `JwtAuthGuard`       | Requires valid JWT token                     |
+| `AdminJwtAuthGuard`  | Requires Administrator role                  |
+| `OptionalJwtAuthGuard` | JWT optional (works for anonymous users)   |
+| `JwtOrOAuthGuard`    | Accepts OAuth first, falls back to JWT       |
+
 ### Using Guards
 
 ```typescript
 import { Controller, Get, UseGuards } from "@nestjs/common";
-import { JwtAuthGuard, AdminJwtAuthGuard, OptionalJwtAuthGuard, Roles, SystemRoles } from "@carlonicora/nestjs-neo4jsonapi";
+import {
+  JwtAuthGuard,
+  AdminJwtAuthGuard,
+  OptionalJwtAuthGuard,
+  JwtOrOAuthGuard,
+  Roles,
+  OAuthScopes,
+  SystemRoles
+} from "@carlonicora/nestjs-neo4jsonapi";
 import { AppRoles } from "./config/roles";
 
 @Controller("api/resources")
@@ -1153,6 +1277,12 @@ export class ResourceController {
   @UseGuards(OptionalJwtAuthGuard)
   async getPublicResources() { ... }
 
+  // Accepts both JWT and OAuth tokens
+  @Get("oauth-or-jwt")
+  @UseGuards(JwtOrOAuthGuard)
+  @OAuthScopes('resources:read')
+  async getResourcesWithOAuth() { ... }
+
   // Requires specific roles (UUIDs)
   @Get("restricted")
   @UseGuards(JwtAuthGuard)
@@ -1184,6 +1314,10 @@ export class MyService {
     const roles = this.cls.get("roles");
     const language = this.cls.get("language");
 
+    // OAuth-specific context (when using OAuth)
+    const authType = this.cls.get("authType"); // 'oauth' or 'jwt'
+    const oauthScopes = this.cls.get("oauthScopes");
+
     if (config?.hasModule("premium-feature")) {
       // User's company has access to premium feature
     }
@@ -1191,25 +1325,228 @@ export class MyService {
 }
 ```
 
+## Company Deletion Handler
+
+The library supports custom company deletion handlers for application-specific cleanup.
+
+### Interface
+
+```typescript
+import {
+  CompanyDeletionHandler,
+  COMPANY_DELETION_HANDLER,
+  DeletionReason,
+  DeletionOptions
+} from "@carlonicora/nestjs-neo4jsonapi";
+
+type DeletionReason = 'trial_expired' | 'subscription_cancelled' | 'immediate_deletion';
+
+interface DeletionOptions {
+  sendEmail?: boolean;
+  reason?: DeletionReason;
+}
+
+interface CompanyDeletionHandler {
+  deleteCompany(companyId: string, companyName: string, options?: DeletionOptions): Promise<void>;
+}
+```
+
+### Implementation
+
+```typescript
+import { Injectable } from "@nestjs/common";
+import {
+  CompanyDeletionHandler,
+  DeletionOptions,
+  S3Service,
+} from "@carlonicora/nestjs-neo4jsonapi";
+
+@Injectable()
+export class CompanyDeletionService implements CompanyDeletionHandler {
+  constructor(
+    private readonly s3: S3Service,
+    private readonly auditLogger: AuditLogger,
+  ) {}
+
+  async deleteCompany(companyId: string, companyName: string, options?: DeletionOptions) {
+    // 1. Delete S3 objects
+    await this.s3.deleteCompanyObjects(companyId);
+
+    // 2. Log audit event
+    await this.auditLogger.log({
+      action: 'company_deleted',
+      companyId,
+      companyName,
+      reason: options?.reason,
+    });
+
+    // 3. Send notification email if requested
+    if (options?.sendEmail) {
+      await this.sendDeletionEmail(companyName, options.reason);
+    }
+  }
+}
+```
+
+### Registration
+
+```typescript
+import { Module, Global } from "@nestjs/common";
+import { COMPANY_DELETION_HANDLER } from "@carlonicora/nestjs-neo4jsonapi";
+
+@Global()
+@Module({
+  providers: [
+    CompanyDeletionService,
+    {
+      provide: COMPANY_DELETION_HANDLER,
+      useExisting: CompanyDeletionService,
+    },
+  ],
+  exports: [CompanyDeletionService, COMPANY_DELETION_HANDLER],
+})
+export class CompanyDeletionModule {}
+```
+
+## Entity Descriptors (defineEntity)
+
+Entity Descriptors provide a single source of truth for entity configuration, auto-generating mappers, serializers, constraints, and indexes.
+
+### Basic Usage
+
+```typescript
+import { defineEntity, Entity, S3Service } from "@carlonicora/nestjs-neo4jsonapi";
+import { rollMeta, companyMeta } from "@carlonicora/nestjs-neo4jsonapi";
+
+// 1. Define entity type
+export type Photograph = Entity & {
+  url: string;
+  filename?: string;
+  stars: number;
+  roll: Roll;
+  company: Company;
+};
+
+// 2. Create entity descriptor
+export const PhotographDescriptor = defineEntity<Photograph>()({
+  // Meta (replaces .meta.ts file)
+  type: "photographs",
+  endpoint: "photographs",
+  nodeName: "photograph",
+  labelName: "Photograph",
+
+  // Inject services for field transformers
+  injectServices: [S3Service],
+
+  // Field definitions
+  fields: {
+    url: {
+      type: "string",
+      required: true,
+      transform: async (data, services) => {
+        return await services.S3Service.generateSignedUrl({ key: data.url });
+      },
+    },
+    filename: { type: "string" },
+    stars: { type: "number", default: 0 },
+  },
+
+  // Computed fields (from Neo4j record)
+  computed: {
+    position: {
+      compute: (params) => params.record.get("position"),
+      meta: true, // Goes to JSON:API meta
+    },
+  },
+
+  // Relationships
+  relationships: {
+    roll: {
+      model: rollMeta,
+      direction: "out",
+      relationship: "FRAME_OF",
+      cardinality: "one",
+      dtoKey: "roll",
+      fields: [{ name: "position", type: "number", required: true }],
+    },
+    company: {
+      model: companyMeta,
+      direction: "out",
+      relationship: "BELONGS_TO",
+      cardinality: "one",
+    },
+  },
+});
+```
+
+### Field Types
+
+| Type       | Neo4j/Cypher    | JSON     |
+| ---------- | --------------- | -------- |
+| `string`   | STRING          | string   |
+| `number`   | INTEGER/FLOAT   | number   |
+| `boolean`  | BOOLEAN         | boolean  |
+| `date`     | DATE            | string (ISO) |
+| `datetime` | DATETIME        | string (ISO) |
+| `json`     | MAP             | object   |
+| `string[]` | LIST\<STRING\>  | string[] |
+| `number[]` | LIST\<INTEGER\> | number[] |
+
+### Field Options
+
+| Option      | Type     | Description                        |
+| ----------- | -------- | ---------------------------------- |
+| `type`      | CypherType | Data type                        |
+| `required`  | boolean  | Required field                     |
+| `default`   | any      | Default value                      |
+| `meta`      | boolean  | Put in JSON:API meta               |
+| `transform` | function | Async transform for serialization  |
+
+### Relationship Options
+
+| Option        | Type              | Description                       |
+| ------------- | ----------------- | --------------------------------- |
+| `model`       | DataMeta          | Related entity metadata           |
+| `direction`   | 'in' \| 'out'     | Relationship direction            |
+| `relationship`| string            | Neo4j relationship type           |
+| `cardinality` | 'one' \| 'many'   | Single or collection              |
+| `required`    | boolean           | Use MATCH vs OPTIONAL MATCH       |
+| `contextKey`  | string            | CLS context key for value         |
+| `dtoKey`      | string            | Override key in DTO               |
+| `fields`      | array             | Edge properties                   |
+
+### What defineEntity Auto-Generates
+
+- **Constraints**: Unique constraint on `id`
+- **Indexes**: FULLTEXT index on all string fields
+- **Mapper**: Entity-to-record mapping
+- **Serializer**: JSON:API compliant serialization
+
 ## Customizing Agent Prompts (Optional)
 
 The library includes default prompts. Customization is entirely optional.
 
 ### Available Prompts
 
-| Agent              | Config Key                                    | Purpose                               |
-| ------------------ | --------------------------------------------- | ------------------------------------- |
-| **GraphCreator**   | `prompts.graphCreator`                        | Extract atomic facts and key concepts |
-| **Contextualiser** | `prompts.contextualiser.questionRefiner`      | Refine user questions                 |
-| **Contextualiser** | `prompts.contextualiser.rationalPlan`         | Create rational plans                 |
-| **Contextualiser** | `prompts.contextualiser.keyConceptExtractor`  | Score key concepts                    |
-| **Contextualiser** | `prompts.contextualiser.atomicFactsExtractor` | Evaluate atomic facts                 |
-| **Contextualiser** | `prompts.contextualiser.chunk`                | Assess text chunks                    |
-| **Contextualiser** | `prompts.contextualiser.chunkVector`          | Vector-based chunk retrieval          |
-| **Responder**      | `prompts.responder`                           | Generate final answers                |
-| **Summariser**     | `prompts.summariser.map`                      | Summarize individual chunks           |
-| **Summariser**     | `prompts.summariser.combine`                  | Combine summaries                     |
-| **Summariser**     | `prompts.summariser.tldr`                     | Create TLDR                           |
+| Agent                  | Config Key                                    | Purpose                               |
+| ---------------------- | --------------------------------------------- | ------------------------------------- |
+| **GraphCreator**       | `prompts.graphCreator`                        | Extract atomic facts and key concepts |
+| **Contextualiser**     | `prompts.contextualiser.questionRefiner`      | Refine user questions                 |
+| **Contextualiser**     | `prompts.contextualiser.rationalPlan`         | Create rational plans                 |
+| **Contextualiser**     | `prompts.contextualiser.keyConceptExtractor`  | Score key concepts                    |
+| **Contextualiser**     | `prompts.contextualiser.atomicFactsExtractor` | Evaluate atomic facts                 |
+| **Contextualiser**     | `prompts.contextualiser.chunk`                | Assess text chunks                    |
+| **Contextualiser**     | `prompts.contextualiser.chunkVector`          | Vector-based chunk retrieval          |
+| **Responder**          | `prompts.responder`                           | Generate final answers                |
+| **Summariser**         | `prompts.summariser.map`                      | Summarize individual chunks           |
+| **Summariser**         | `prompts.summariser.combine`                  | Combine summaries                     |
+| **Summariser**         | `prompts.summariser.tldr`                     | Create TLDR                           |
+| **CommunityDetector**  | `prompts.communityDetector`                   | Community detection                   |
+| **CommunitySummariser**| `prompts.communitySummariser`                 | Community summarization               |
+| **DRIFT**              | `prompts.drift.hyde`                          | HyDE generation                       |
+| **DRIFT**              | `prompts.drift.primerAnswer`                  | Initial answer generation             |
+| **DRIFT**              | `prompts.drift.followUp`                      | Follow-up question handling           |
+| **DRIFT**              | `prompts.drift.synthesis`                     | Final answer synthesis                |
 
 ### Custom Prompts Example