npm - @oas-tools/oas-telemetry - Versions diffs - 0.7.0-alpha.5 → 0.7.1 - Mend

@oas-tools/oas-telemetry 0.7.0-alpha.5 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (121) hide show

package/.env.example +2 -0
package/README.md +35 -17
package/dist/cjs/config/bootConfig.cjs +3 -1
package/dist/cjs/docs/openapi.yaml +1399 -0
package/dist/cjs/index.cjs +1 -0
package/dist/cjs/routesManager.cjs +1 -1
package/dist/cjs/telemetry/custom-implementations/exporters/InMemoryDbLogExporter.cjs +43 -13
package/dist/cjs/telemetry/custom-implementations/exporters/InMemoryDbMetricExporter.cjs +10 -2
package/dist/cjs/telemetry/custom-implementations/exporters/InMemoryDbSpanExporter.cjs +21 -16
package/dist/cjs/telemetry/initializeTelemetry.cjs +39 -15
package/dist/cjs/telemetry/telemetryConfigurator.cjs +6 -9
package/dist/cjs/telemetry/telemetryRegistry.cjs +11 -8
package/dist/cjs/tlm-ai/agent.cjs +54 -84
package/dist/cjs/tlm-ai/aiController.cjs +69 -47
package/dist/cjs/tlm-ai/aiRoutes.cjs +10 -3
package/dist/cjs/tlm-ai/aiService.cjs +109 -0
package/dist/cjs/tlm-ai/tools.cjs +30 -268
package/dist/cjs/tlm-auth/authController.cjs +9 -9
package/dist/cjs/tlm-auth/authMiddleware.cjs +1 -1
package/dist/cjs/tlm-log/logController.cjs +30 -36
package/dist/cjs/tlm-log/logRoutes.cjs +3 -2
package/dist/cjs/tlm-metric/metricsController.cjs +15 -8
package/dist/cjs/tlm-metric/metricsRoutes.cjs +2 -1
package/dist/cjs/tlm-plugin/pluginController.cjs +11 -1
package/dist/cjs/tlm-plugin/pluginProcess.cjs +4 -2
package/dist/cjs/tlm-plugin/pluginService.cjs +3 -0
package/dist/cjs/tlm-trace/traceController.cjs +16 -9
package/dist/cjs/tlm-trace/traceRoutes.cjs +2 -1
package/dist/cjs/tlm-util/utilController.cjs +23 -2
package/dist/cjs/tlm-util/utilRoutes.cjs +44 -5
package/dist/cjs/utils/logger.cjs +35 -13
package/dist/esm/config/bootConfig.js +2 -0
package/dist/esm/docs/openapi.yaml +1399 -0
package/dist/esm/index.js +1 -0
package/dist/esm/routesManager.js +1 -1
package/dist/esm/telemetry/custom-implementations/exporters/InMemoryDbLogExporter.js +32 -11
package/dist/esm/telemetry/custom-implementations/exporters/InMemoryDbMetricExporter.js +10 -2
package/dist/esm/telemetry/custom-implementations/exporters/InMemoryDbSpanExporter.js +20 -13
package/dist/esm/telemetry/initializeTelemetry.js +22 -14
package/dist/esm/telemetry/telemetryConfigurator.js +7 -10
package/dist/esm/telemetry/telemetryRegistry.js +10 -7
package/dist/esm/tlm-ai/agent.js +37 -78
package/dist/esm/tlm-ai/aiController.js +56 -39
package/dist/esm/tlm-ai/aiRoutes.js +11 -4
package/dist/esm/tlm-ai/aiService.js +94 -0
package/dist/esm/tlm-ai/tools.js +29 -255
package/dist/esm/tlm-auth/authController.js +8 -8
package/dist/esm/tlm-auth/authMiddleware.js +1 -1
package/dist/esm/tlm-log/logController.js +26 -28
package/dist/esm/tlm-log/logRoutes.js +4 -3
package/dist/esm/tlm-metric/metricsController.js +10 -6
package/dist/esm/tlm-metric/metricsRoutes.js +3 -2
package/dist/esm/tlm-plugin/pluginController.js +2 -1
package/dist/esm/tlm-plugin/pluginProcess.js +4 -2
package/dist/esm/tlm-plugin/pluginService.js +4 -0
package/dist/esm/tlm-trace/traceController.js +11 -7
package/dist/esm/tlm-trace/traceRoutes.js +3 -2
package/dist/esm/tlm-util/utilController.js +22 -0
package/dist/esm/tlm-util/utilRoutes.js +40 -5
package/dist/esm/utils/logger.js +35 -12
package/dist/types/config/bootConfig.d.ts +1 -0
package/dist/types/index.d.ts +2 -1
package/dist/types/telemetry/custom-implementations/exporters/InMemoryDbLogExporter.d.ts +7 -1
package/dist/types/telemetry/custom-implementations/exporters/InMemoryDbMetricExporter.d.ts +1 -0
package/dist/types/telemetry/custom-implementations/exporters/InMemoryDbSpanExporter.d.ts +1 -0
package/dist/types/telemetry/telemetryRegistry.d.ts +22 -6
package/dist/types/tlm-ai/agent.d.ts +2 -2
package/dist/types/tlm-ai/aiController.d.ts +5 -4
package/dist/types/tlm-ai/aiRoutes.d.ts +1 -1
package/dist/types/tlm-ai/aiService.d.ts +38 -0
package/dist/types/tlm-ai/tools.d.ts +5 -14
package/dist/types/tlm-log/logController.d.ts +2 -2
package/dist/types/tlm-metric/metricsController.d.ts +2 -1
package/dist/types/tlm-plugin/pluginService.d.ts +2 -0
package/dist/types/tlm-trace/traceController.d.ts +2 -1
package/dist/types/tlm-util/utilController.d.ts +1 -0
package/dist/types/utils/logger.d.ts +5 -5
package/dist/ui/assets/ApiDocsPage-C_VVPPHa.js +16 -0
package/dist/ui/assets/CollapsibleCard-B3KR_8mL.js +1 -0
package/dist/ui/assets/DevToolsPage-OyZcDcmw.js +1 -0
package/dist/ui/assets/LandingPage-CppFBA6K.js +6 -0
package/dist/ui/assets/LogsPage-9Fq8GArS.js +26 -0
package/dist/ui/assets/NotFoundPage-B3quk3P1.js +1 -0
package/dist/ui/assets/PluginCreatePage-X_aCH4t4.js +50 -0
package/dist/ui/assets/PluginPage-DMDSihrZ.js +27 -0
package/dist/ui/assets/alert-jQ9HCPIf.js +1133 -0
package/dist/ui/assets/badge-CNq0-mH5.js +1 -0
package/dist/ui/assets/card-DFAwwhN3.js +1 -0
package/dist/ui/assets/chevron-down-CPsvsmqj.js +6 -0
package/dist/ui/assets/chevron-up-Df9jMo1X.js +6 -0
package/dist/ui/assets/circle-alert-DOPQPvU8.js +6 -0
package/dist/ui/assets/index-BkD6DijD.js +15 -0
package/dist/ui/assets/index-CERGVYZK.js +292 -0
package/dist/ui/assets/index-CSIPf9qw.css +1 -0
package/dist/ui/assets/input-Dzvg_ZEZ.js +1 -0
package/dist/ui/assets/label-DuVnkZ4q.js +1 -0
package/dist/ui/assets/loader-circle-CrvlRy5o.js +6 -0
package/dist/ui/assets/loginPage-qa4V-B70.js +6 -0
package/dist/ui/assets/select-DhS8YUtJ.js +1 -0
package/dist/ui/assets/separator-isK4chBP.js +6 -0
package/dist/ui/assets/severityOptions-O38dSOfk.js +11 -0
package/dist/ui/assets/switch-Z3mImG9n.js +1 -0
package/dist/ui/assets/tabs-_77MUUQe.js +16 -0
package/dist/ui/assets/upload-C1LT4Gkb.js +16 -0
package/dist/ui/assets/utilService-DNyqzwj0.js +1 -0
package/dist/ui/index.html +2 -2
package/package.json +24 -14
package/dist/cjs/telemetry/custom-implementations/exporters/PluginLogExporter.cjs +0 -45
package/dist/cjs/telemetry/custom-implementations/exporters/PluginMetricExporter.cjs +0 -46
package/dist/cjs/telemetry/custom-implementations/exporters/PluginSpanExporter.cjs +0 -61
package/dist/cjs/tlm-ai/knownMicroservices.cjs +0 -13
package/dist/esm/telemetry/custom-implementations/exporters/PluginLogExporter.js +0 -36
package/dist/esm/telemetry/custom-implementations/exporters/PluginMetricExporter.js +0 -35
package/dist/esm/telemetry/custom-implementations/exporters/PluginSpanExporter.js +0 -52
package/dist/esm/tlm-ai/knownMicroservices.js +0 -5
package/dist/types/telemetry/custom-implementations/exporters/PluginLogExporter.d.ts +0 -8
package/dist/types/telemetry/custom-implementations/exporters/PluginMetricExporter.d.ts +0 -12
package/dist/types/telemetry/custom-implementations/exporters/PluginSpanExporter.d.ts +0 -14
package/dist/types/tlm-ai/knownMicroservices.d.ts +0 -6
package/dist/ui/assets/index-Bgd7fFFH.js +0 -1743
package/dist/ui/assets/index-Cz3N1n1Q.css +0 -1

package/dist/cjs/docs/openapi.yaml ADDED Viewed

@@ -0,0 +1,1399 @@
+openapi: 3.1.0
+info:
+  title: '@oas-tools/oas-telemetry'
+  version: 0.7.0-alpha.2
+  license:
+    name: Apache-2.0
+  description: |-
+    Automatically collects and stores telemetry data in memory using OpenTelemetry.
+    Just import the Express middleware to access it through the built-in REST API or web UI—no extra setup required.
+components:
+  securitySchemes:
+    CookieAuth:
+      type: apiKey
+      in: cookie
+      name: oas-tlm-access-token
+security:
+  - CookieAuth: []
+servers:
+  - url: "{protocol}://{host}:{port}/{basePath}"
+    variables:
+      protocol:
+        default: http
+        enum:
+          - http
+          - https
+      host:
+        default: localhost
+      port:
+        default: "3000"
+      basePath:
+        default: telemetry
+        description: Base path for all endpoints. Can be customized, e.g. "myCustomTelemetryPath"
+tags:
+  - name: traces
+    description: Operations for managing telemetry traces
+  - name: metrics
+    description: Operations for managing telemetry metrics
+  - name: logs
+    description: Operations for managing telemetry logs
+  - name: utils
+    description: Utility endpoints
+  - name: ui
+    description: User interface
+  - name: ai
+    description: AI-related operations
+  - name: plugins
+    description: Operations for managing plugins
+  - name: auth
+    description: Authentication operations
+paths:
+  /:
+    get:
+      summary: Redirect to telemetry UI (Only works in production mode)
+      tags:
+        - ui
+      responses:
+        '302':
+          description: Found
+          content:
+            text/html:
+              schema:
+                type: string
+                example: <p>Found. Redirecting to /oas-telemetry-ui</p>
+  /oas-telemetry-ui:
+    get:
+      summary: OAS-Telemetry Web UI (Only works in production mode)
+      tags:
+        - ui
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: <!DOCTYPE html><title>OAS-Telemetry UI</title></head><body><h1>Welcome to OAS-Telemetry UI</h1></body></html>
+  /traces:
+    get:
+      summary: Get collected traces
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  spansCount:
+                    type: number
+                    example: 0
+                  spans:
+                    type: array
+                    items:
+                      type: object
+                    example: []
+    post:
+      summary: Insert traces (optionally reset first)
+      description: |
+        Inserts traces. If the query parameter `reset=true` is provided, the trace database is reset before inserting.
+        The response message will indicate whether a reset occurred.
+      tags:
+        - traces
+      parameters:
+        - name: reset
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - "true"
+              - "false"
+          description: If true, reset the database before inserting
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                spans:
+                  type: array
+                  items:
+                    type: object
+                  description: Array of trace objects to insert
+              example:
+                spans:
+                  - traceId: "123"
+                    spanId: "456"
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Inserted 1 traces.
+                  InsertedTracesCount:
+                    type: number
+                    example: 1
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid data format. Expected an array of JSON objects.
+  /traces/find:
+    post:
+      summary: Find traces
+      tags:
+        - traces
+      requestBody:
+        required: true
+        description: Search criteria for traces.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                query:
+                  type: object
+                  additionalProperties: true
+                  description: Mongo-like query criteria
+                  example:
+                    attributes.http.target:
+                      $regex: "^/api/v1/pets.*$"
+                    attributes.http.method: "GET"
+                    $or:
+                      - attributes.http.status_code:
+                          $lte: 400
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  spansCount:
+                    type: number
+                    example: 0
+                  spans:
+                    type: array
+                    items:
+                      type: object
+                    example: []
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid regex in query
+  /traces/start:
+    post:
+      summary: Start trace collection
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Traces started
+  /traces/stop:
+    post:
+      summary: Stop trace collection
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Traces stopped
+  /traces/status:
+    get:
+      summary: Get trace collection status
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  active:
+                    type: boolean
+                    example: true
+  /traces/reset:
+    post:
+      summary: Reset trace database
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Traces reset
+  /traces/retention-time:
+    get:
+      summary: Get trace retention time (seconds)
+      tags:
+        - traces
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  retentionTimeInSeconds:
+                    type: number
+                    example: 3600
+    post:
+      summary: Set retention time for traces
+      tags:
+        - traces
+      requestBody:
+        required: true
+        description: Retention time in seconds.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                retentionTimeInSeconds:
+                  type: number
+                  description: Retention time in seconds.
+                  example: 3600
+            example:
+              retentionTimeInSeconds: 3600
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Retention time set to 3600 seconds.
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid retention time. Must be a positive number.
+  /metrics:
+    get:
+      summary: Get collected metrics
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  metricsCount:
+                    type: number
+                    example: 0
+                  metrics:
+                    type: array
+                    items:
+                      type: object
+                    example: []
+    post:
+      summary: Insert metrics (optionally reset first)
+      description: |
+        Inserts metrics. If the query parameter `reset=true` is provided, the metrics database is reset before inserting.
+        The response message will indicate whether a reset occurred.
+      tags:
+        - metrics
+      parameters:
+        - name: reset
+          in: query
+          required: false
+          schema:
+            type: boolean
+          description: If true, reset the database before inserting
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Inserted 25 metrics.
+                  InsertedMetricsCount:
+                    type: number
+                    example: 25
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid data format. Expected an array of JSON objects.
+  /metrics/find:
+    post:
+      summary: Find metrics
+      tags:
+        - metrics
+      requestBody:
+        required: true
+        description: Mongo-like (nedb) query object for metrics filtering.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                query:
+                  type: object
+                  additionalProperties: true
+                  description: Mongo-like query criteria
+                  example:
+                    metricId: "123"
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  metricsCount:
+                    type: number
+                    example: 0
+                  metrics:
+                    type: array
+                    items:
+                      type: object
+                    example: []
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid regex in query
+  /metrics/start:
+    post:
+      summary: Start metrics collection
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Metrics collection started
+  /metrics/stop:
+    post:
+      summary: Stop metrics collection
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Metrics collection stopped
+  /metrics/status:
+    get:
+      summary: Get metrics collection status
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  active:
+                    type: boolean
+                    example: true
+  /metrics/reset:
+    post:
+      summary: Reset metrics database
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            text/html:
+              schema:
+                type: string
+                example: Metrics reset
+  /metrics/retention-time:
+    get:
+      summary: Get metrics retention time (seconds)
+      tags:
+        - metrics
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  retentionTimeInSeconds:
+                    type: number
+                    example: 3600
+    post:
+      summary: Set retention time for metrics
+      tags:
+        - metrics
+      requestBody:
+        required: true
+        description: Retention time in seconds.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                retentionTimeInSeconds:
+                  type: number
+                  description: Retention time in seconds.
+                  example: 3600
+            example:
+              retentionTimeInSeconds: 3600
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Retention time set to 3600 seconds.
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid retention time. Must be a positive number.
+  /logs:
+    get:
+      summary: Get collected logs
+      tags:
+        - logs
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items: {}
+                example:
+                  items: []
+    post:
+      summary: Insert logs (optionally reset first)
+      description: |
+        Inserts logs. If the query parameter `reset=true` is provided, the logs database is reset before inserting.
+        The response message will indicate whether a reset occurred.
+      tags:
+        - logs
+      parameters:
+        - name: reset
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - "true"
+              - "false"
+          description: If true, reset the database before inserting
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                logs:
+                  type: array
+                  items:
+                    type: object
+                  description: Array of log objects to insert
+              example:
+                logs:
+                  - body: "Hello World!"
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Inserted 6 logs.
+                  InsertedLogsCount:
+                    type: number
+                    example: 6
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid data format. Expected an array of JSON objects.
+  /logs/find:
+    post:
+      summary: Find logs
+      tags:
+        - logs
+      requestBody:
+        required: true
+        description: Search criteria for logs. Supports textSearch, a Mongo-like (nedb) query, and sort.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                textSearch:
+                  type: string
+                  description: Text that the log body must contain
+                query:
+                  type: object
+                  additionalProperties: true
+                  description: Mongo-like query criteria
+                sort:
+                  type: object
+                  additionalProperties: true
+                  description: Sort order for logs
+                  example:
+                    timestamp: -1
+                limit:
+                  type: integer
+                  description: Number of logs to return
+                  default: 50
+              example:
+                textSearch: "World!"
+                query: {}
+                sort:
+                  timestamp: -1
+                limit: 50
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items: {}
+                example:
+                  items: []
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid regex in query
+  /utils/spec:
+    get:
+      summary: Get OpenAPI spec in JSON
+      tags:
+        - utils
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  paths:
+                    type: object
+  /utils/heapStats:
+    get:
+      summary: Get heap statistics
+      tags:
+        - utils
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  total_heap_size:
+                    type: number
+                  total_heap_size_executable:
+                    type: number
+                  total_physical_size:
+                    type: number
+                  total_available_size:
+                    type: number
+                  used_heap_size:
+                    type: number
+                  heap_size_limit:
+                    type: number
+                  malloced_memory:
+                    type: number
+                  peak_malloced_memory:
+                    type: number
+                  does_zap_garbage:
+                    type: integer
+                  number_of_native_contexts:
+                    type: integer
+                  number_of_detached_contexts:
+                    type: integer
+                  total_global_handles_size:
+                    type: number
+                  used_global_handles_size:
+                    type: number
+                  external_memory:
+                    type: number
+                  units:
+                    type: string
+                example:
+                  total_heap_size: 46.418
+                  total_heap_size_executable: 3
+                  total_physical_size: 46.418
+                  total_available_size: 4101.352
+                  used_heap_size: 42.636
+                  heap_size_limit: 4144
+                  malloced_memory: 0.531
+                  peak_malloced_memory: 67.936
+                  does_zap_garbage: 0
+                  number_of_native_contexts: 0
+                  number_of_detached_contexts: 0
+                  total_global_handles_size: 0.055
+                  used_global_handles_size: 0.04
+                  external_memory: 9.393
+                  units: "MB"
+  /utils/generate-log:
+    post:
+      summary: Generate a sample log
+      tags:
+        - utils
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                log:
+                  type: string
+                  description: The log message to generate. Defaults to "Default log message" if not specified.
+                repeat:
+                  type: integer
+                  description: Number of times to repeat the log message.
+                  default: 1
+                method:
+                  type: string
+                  description: Log method (log, warn, error, info, debug).
+                  enum: [log, warn, error, info, debug]
+                  default: log
+              example:
+                log: "Hello World!"
+                repeat: 2
+                method: "info"
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Log generated
+                  log:
+                    type: string
+                    example: Hello World!
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: Invalid method. Use log, warn, error, info, or debug.
+  /utils/generate-mock-logs:
+    post:
+      summary: Generate mock logs
+      tags:
+        - utils
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                count:
+                  type: integer
+                  description: Number of mock logs to generate.
+                  default: 50
+              example:
+                count: 100
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: Started generating mock logs
+  /utils/generate-wait/{seconds}:
+    get:
+      summary: Wait for the specified seconds
+      tags:
+        - utils
+      parameters:
+        - name: seconds
+          in: path
+          required: false
+          schema:
+            type: integer
+            default: 1
+          description: Number of seconds to wait. Defaults to 1 if not specified.
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  waited:
+                    type: number
+                    example: 2
+  /health:
+    get:
+      summary: Health check
+      tags:
+        - utils
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    example: OK
+  /plugins:
+    get:
+      summary: List all registered plugins
+      tags:
+        - plugins
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  pluginsCount:
+                    type: integer
+                    description: Number of plugins
+                  plugins:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        url:
+                          type: string
+                        active:
+                          type: boolean
+                example:
+                  pluginsCount: 1
+                  plugins:
+                    - id: "plugin-1"
+                      name: "Sample Plugin"
+                      url: "https://example.com/plugin.js"
+                      active: true
+    post:
+      summary: Register a new plugin
+      tags:
+        - plugins
+      requestBody:
+        required: true
+        description: Plugin registration details
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - id
+                - moduleFormat
+              properties:
+                id:
+                  type: string
+                  description: Unique identifier for the plugin
+                url:
+                  type: string
+                  description: URL of the plugin to register
+                code:
+                  type: string
+                  description: Inline code of the plugin (optional if URL is provided)
+                install:
+                  type: object
+                  description: Dependencies to install for the plugin
+                  properties:
+                    dependencies:
+                      type: array
+                      items:
+                        type: string
+                      description: List of dependencies
+                    ignoreErrors:
+                      type: boolean
+                      description: Whether to ignore errors during installation
+                config:
+                  type: object
+                  description: Configuration for the plugin
+                moduleFormat:
+                  type: string
+                  description: Module format of the plugin (e.g., "ESM" or "CJS")
+              example:
+                id: "plugin-1"
+                name: "Sample Plugin"
+                description: "A sample plugin for demonstration"
+                code: "console.log('Hello from plugin');export const plugin = {load:()=>{console.log('Plugin loaded')}, isConfigured:()=>true};"
+                install:
+                  dependencies: []
+                  ignoreErrors: true
+                config:
+                  key: "value"
+                moduleFormat: "ESM"
+      responses:
+        '201':
+          description: Plugin registered successfully
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: "Plugin code or URL must be provided"
+  /plugins/{id}/activate:
+    post:
+      summary: Activate a plugin
+      tags:
+        - plugins
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Plugin ID
+      responses:
+        '200':
+          description: Plugin activated
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin "plugin-1" activated.
+        '404':
+          description: Plugin not found
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin with id "plugin-1" not found.
+  /plugins/{id}/deactivate:
+    post:
+      summary: Deactivate a plugin
+      tags:
+        - plugins
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Plugin ID
+      responses:
+        '200':
+          description: Plugin deactivated
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin "plugin-1" deactivated.
+        '404':
+          description: Plugin not found
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin with id "plugin-1" not found.
+  /plugins/{id}:
+    delete:
+      summary: Delete a plugin
+      tags:
+        - plugins
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Plugin ID
+      responses:
+        '200':
+          description: Plugin deleted
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin "plugin-1" deleted.
+        '404':
+          description: Plugin not found
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: Plugin with id "plugin-1" not found.
+  /auth/login:
+    post:
+      summary: Login and obtain authentication cookies
+      tags:
+        - auth
+      requestBody:
+        required: true
+        description: Login credentials
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                password:
+                  type: string
+                  description: Password for authentication
+              required:
+                - password
+              example:
+                password: "your-password"
+      responses:
+        '200':
+          description: Login successful, cookies set
+          headers:
+            Set-Cookie:
+              schema:
+                type: string
+              description: |
+                Sets oas-tlm-access-token and oas-tlm-refresh-token cookies.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  message:
+                    type: string
+                example:
+                  valid: true
+                  message: Login successful
+        '400':
+          description: Invalid password
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  message:
+                    type: string
+                example:
+                  valid: false
+                  message: Invalid password
+  /auth/logout:
+    post:
+      summary: Logout and clear authentication cookies
+      tags:
+        - auth
+      responses:
+        '200':
+          description: Logout successful, cookies cleared
+          headers:
+            Set-Cookie:
+              schema:
+                type: string
+              description: |
+                Clears oas-tlm-access-token and oas-tlm-refresh-token cookies.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  message:
+                    type: string
+                example:
+                  valid: true
+                  message: Logged out
+  /auth/refresh:
+    post:
+      summary: Refresh access token using refresh token cookie
+      tags:
+        - auth
+      responses:
+        '200':
+          description: Access token refreshed, new cookie set
+          headers:
+            Set-Cookie:
+              schema:
+                type: string
+              description: |
+                Sets a new oas-tlm-access-token cookie.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  message:
+                    type: string
+                example:
+                  valid: true
+                  message: Refreshed
+        '401':
+          description: Invalid or missing refresh token
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  message:
+                    type: string
+                example:
+                  valid: false
+                  message: Invalid refresh token
+  /auth/enabled:
+    get:
+      summary: Check if authentication is enabled
+      tags:
+        - auth
+      responses:
+        '200':
+          description: Returns whether authentication is enabled
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  enabled:
+                    type: boolean
+                example:
+                  enabled: true
+  /ai/chat/health:
+    get:
+      summary: AI service health (alias)
+      tags:
+        - ai
+      responses:
+        '200':
+          description: OK
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: AI service is healthy
+  /ai/chat:
+    get:
+      summary: List AI conversations (alias)
+      tags:
+        - ai
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: string
+                    name:
+                      type: string
+                example:
+                  - id: "conv-1"
+                    name: "Conversation 1"
+    post:
+      summary: Create a new AI conversation (alias)
+      tags:
+        - ai
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                example:
+                  id: "conv-123"
+                  name: "New Conversation"
+  /ai/chat/{conversationId}:
+    parameters:
+      - name: conversationId
+        in: path
+        required: true
+        schema:
+          type: string
+        description: Conversation ID
+    get:
+      summary: Get conversation history (alias)
+      tags:
+        - ai
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  messages:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        role:
+                          type: string
+                        content:
+                          type: string
+                example:
+                  id: "conv-123"
+                  messages:
+                    - role: "user"
+                      content: "Hello"
+                    - role: "assistant"
+                      content: "Hi, how can I help?"
+        '404':
+          description: Not found
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                example:
+                  error: Not found
+    delete:
+      summary: Delete a conversation (alias)
+      tags:
+        - ai
+      responses:
+        '204':
+          description: Deleted
+        '404':
+          description: Not found
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                example:
+                  error: Not found
+  /ai/chat/{conversationId}/message:
+    parameters:
+      - name: conversationId
+        in: path
+        required: true
+        schema:
+          type: string
+        description: Conversation ID
+    post:
+      summary: Send a message to a conversation (alias)
+      tags:
+        - ai
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                content:
+                  type: string
+              required:
+                - content
+            example:
+              content: "Hello, summarize my last request."
+      responses:
+        '200':
+          description: Message sent, returns updated messages or assistant reply
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  messages:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        role:
+                          type: string
+                        content:
+                          type: string
+                example:
+                  messages:
+                    - role: "user"
+                      content: "Hello"
+                    - role: "assistant"
+                      content: "Here is a summary..."
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                example:
+                  error: Missing content