@thinkai/tai-api-contract 2.59.0 → 2.60.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.59.0
+  version: 2.60.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1314,6 +1314,8 @@ paths:
                       - $ref: "#/components/schemas/ClaudeSourcePatchDto"
                       - $ref: "#/components/schemas/ClaudeSourceDto"
                       - $ref: "#/components/schemas/NewRelicSourceDto"
+                      - $ref: "#/components/schemas/PrometheusSourceDto"
+                      - $ref: "#/components/schemas/GrafanaSourceDto"
                       - $ref: "#/components/schemas/TenantSourceEntryDto"
             examples:
               cursorAndJira:
@@ -1426,6 +1428,8 @@ paths:
                 - $ref: "#/components/schemas/ClaudeSourcePatchDto"
                 - $ref: "#/components/schemas/ClaudeSourceDto"
                 - $ref: "#/components/schemas/NewRelicSourceDto"
+                - $ref: "#/components/schemas/PrometheusSourceDto"
+                - $ref: "#/components/schemas/GrafanaSourceDto"
                 - $ref: "#/components/schemas/TenantSourceEntryDto"
             examples:
               cursorValid:
@@ -3881,6 +3885,144 @@ paths:
               schema:
                 $ref: "#/components/schemas/NewRelicTriggerSyncResultDto"
 
+  /workspaces/{workspaceId}/integrations/prometheus:
+    get:
+      tags: [Integrations]
+      summary: Prometheus monitoring integration status
+      operationId: getWorkspacePrometheusIntegrationStatus
+      description: >
+        Returns whether Prometheus/Alertmanager is connected and the last monitoring ingest sync outcome.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Prometheus integration status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PrometheusIntegrationStatusDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/integrations/prometheus/sync:
+    post:
+      tags: [Integrations]
+      summary: Trigger Prometheus monitoring ingest now
+      operationId: postWorkspacePrometheusIntegrationSync
+      description: >
+        Manually polls Alertmanager for firing/resolved alerts and refreshes Quality dashboard buckets.
+        Requires editor role.
+      security:
+        - bearerAuth: []
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Sync completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PrometheusTriggerSyncResultDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Prometheus is not connected on this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PrometheusTriggerSyncResultDto"
+        "503":
+          description: Sync failed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PrometheusTriggerSyncResultDto"
+
+  /workspaces/{workspaceId}/integrations/grafana:
+    get:
+      tags: [Integrations]
+      summary: Grafana monitoring integration status
+      operationId: getWorkspaceGrafanaIntegrationStatus
+      description: >
+        Returns whether Grafana is connected and the last monitoring ingest sync outcome.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Grafana integration status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GrafanaIntegrationStatusDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/integrations/grafana/sync:
+    post:
+      tags: [Integrations]
+      summary: Trigger Grafana monitoring ingest now
+      operationId: postWorkspaceGrafanaIntegrationSync
+      description: >
+        Manually polls Grafana Unified Alerting and deploy annotations, persists canonical events,
+        and refreshes Quality/DORA dashboard buckets. Requires editor role.
+      security:
+        - bearerAuth: []
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Sync completed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GrafanaTriggerSyncResultDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace does not exist or malformed workspaceId
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Grafana is not connected on this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GrafanaTriggerSyncResultDto"
+        "503":
+          description: Sync failed
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GrafanaTriggerSyncResultDto"
+
   /integrations/github/webhook:
     post:
       tags: [Integrations]
@@ -7452,6 +7594,103 @@ components:
           type: string
           description: New Relic user name when known from the last successful verify.
 
+    PrometheusSourceDto:
+      type: object
+      description: >
+        Prometheus / Alertmanager monitoring source for workspace sources PUT and connection test.
+        Provide at least one URL; authentication is optional.
+      required: [type]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [prometheus]
+        baseUrl:
+          type: string
+          minLength: 1
+          description: Prometheus server URL (health check when Alertmanager is separate).
+        alertmanagerUrl:
+          type: string
+          minLength: 1
+          description: Alertmanager API base URL (preferred for alert ingest).
+        token:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: Optional bearer token (write-only on PUT).
+        username:
+          type: string
+          description: Optional HTTP basic auth username.
+        password:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: Optional HTTP basic auth password (write-only on PUT).
+
+    PrometheusSourceConfigDto:
+      type: object
+      description: Redacted Prometheus source returned by GET workspace config.
+      required: [type, hasToken, baseUrl, alertmanagerUrl, hasPassword]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [prometheus]
+        hasToken:
+          type: boolean
+        hasPassword:
+          type: boolean
+        baseUrl:
+          type: string
+        alertmanagerUrl:
+          type: string
+        username:
+          type: string
+          description: Stored basic auth username when configured.
+
+    GrafanaSourceDto:
+      type: object
+      description: Grafana monitoring source for workspace sources PUT and connection test.
+      required: [type, baseUrl, token]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [grafana]
+        baseUrl:
+          type: string
+          minLength: 1
+          description: Grafana stack URL (Cloud or self-hosted).
+        token:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: Service account token (write-only on PUT).
+        orgId:
+          type: string
+          description: Optional organization ID for multi-org stacks.
+        orgName:
+          type: string
+          description: Optional org display name from a successful connection test.
+
+    GrafanaSourceConfigDto:
+      type: object
+      description: Redacted Grafana source returned by GET workspace config.
+      required: [type, hasToken, baseUrl]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [grafana]
+        hasToken:
+          type: boolean
+        baseUrl:
+          type: string
+        orgId:
+          type: string
+        orgName:
+          type: string
+
     AgentExecutionProviderDto:
       type: string
       description: >
@@ -7476,6 +7715,8 @@ components:
               - $ref: "#/components/schemas/CursorSourceConfigDto"
               - $ref: "#/components/schemas/ClaudeSourceConfigDto"
               - $ref: "#/components/schemas/NewRelicSourceConfigDto"
+              - $ref: "#/components/schemas/PrometheusSourceConfigDto"
+              - $ref: "#/components/schemas/GrafanaSourceConfigDto"
               - $ref: "#/components/schemas/TenantSourceEntryDto"
         orgChart:
           nullable: true
@@ -7522,13 +7763,22 @@ components:
           description: Error detail when `executionKeyValid` is false.
         userName:
           type: string
-          description: Present for New Relic verify success — authenticated New Relic user name.
+          description: Present for New Relic or Grafana verify success — authenticated user name.
         accountName:
           type: string
           description: Present for New Relic verify success — resolved account display name.
         accountId:
           type: string
           description: Present for New Relic verify success — resolved account ID.
+        orgName:
+          type: string
+          description: Present for Grafana verify success — resolved organization name.
+        clusterName:
+          type: string
+          description: Present for Prometheus verify success — Alertmanager cluster name.
+        version:
+          type: string
+          description: Present for Prometheus verify success — Alertmanager version when available.
 
     CursorKeyUsageDto:
       type: object
@@ -10547,6 +10797,115 @@ components:
           type: string
           description: Error message when status is error.
 
+    PrometheusIntegrationStatusDto:
+      type: object
+      additionalProperties: false
+      required: [connected, status]
+      properties:
+        connected:
+          type: boolean
+          description: "True when a type:prometheus workspace source is configured."
+        lastSyncAt:
+          type: string
+          format: date-time
+          nullable: true
+        status:
+          type: string
+          enum: [ok, error, never]
+        lastError:
+          type: string
+          nullable: true
+        issueCount:
+          type: integer
+          nullable: true
+          description: Alerts fetched on the last successful sync.
+        deploymentCount:
+          type: integer
+          nullable: true
+        eventCount:
+          type: integer
+          nullable: true
+
+    PrometheusTriggerSyncResultDto:
+      type: object
+      additionalProperties: false
+      required: [status]
+      properties:
+        status:
+          type: string
+          enum: [ok, skipped, error]
+        code:
+          type: string
+        reason:
+          type: string
+        issueCount:
+          type: integer
+        deploymentCount:
+          type: integer
+        eventCount:
+          type: integer
+        bucketsWritten:
+          type: integer
+        durationMs:
+          type: integer
+        error:
+          type: string
+
+    GrafanaIntegrationStatusDto:
+      type: object
+      additionalProperties: false
+      required: [connected, status]
+      properties:
+        connected:
+          type: boolean
+          description: "True when a type:grafana workspace source is configured."
+        lastSyncAt:
+          type: string
+          format: date-time
+          nullable: true
+        status:
+          type: string
+          enum: [ok, error, never]
+        lastError:
+          type: string
+          nullable: true
+        issueCount:
+          type: integer
+          nullable: true
+          description: Unified alerts fetched on the last successful sync.
+        deploymentCount:
+          type: integer
+          nullable: true
+          description: Deploy annotations ingested on the last successful sync.
+        eventCount:
+          type: integer
+          nullable: true
+
+    GrafanaTriggerSyncResultDto:
+      type: object
+      additionalProperties: false
+      required: [status]
+      properties:
+        status:
+          type: string
+          enum: [ok, skipped, error]
+        code:
+          type: string
+        reason:
+          type: string
+        issueCount:
+          type: integer
+        deploymentCount:
+          type: integer
+        eventCount:
+          type: integer
+        bucketsWritten:
+          type: integer
+        durationMs:
+          type: integer
+        error:
+          type: string
+
     GithubActionsEnableResponseDto:
       type: object
       additionalProperties: false
@@ -12991,6 +13350,18 @@ components:
         - productivity.ingest.completed
         - productivity.ingest.failed
         - productivity.ingest.skipped
+        - integrations.newrelic.added
+        - integrations.newrelic.removed
+        - integrations.newrelic.sync_completed
+        - integrations.newrelic.sync_failed
+        - integrations.prometheus.added
+        - integrations.prometheus.removed
+        - integrations.prometheus.sync_completed
+        - integrations.prometheus.sync_failed
+        - integrations.grafana.added
+        - integrations.grafana.removed
+        - integrations.grafana.sync_completed
+        - integrations.grafana.sync_failed
 
     ActivityLogActorDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.59.0",
+  "version": "2.60.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",