@thinkai/tai-api-contract 2.95.0 → 2.96.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.95.0
+  version: 2.96.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -1550,6 +1550,7 @@ paths:
                       - $ref: "#/components/schemas/GrafanaSourceDto"
                       - $ref: "#/components/schemas/SonarQubeSourceDto"
                       - $ref: "#/components/schemas/PagerDutySourceDto"
+                      - $ref: "#/components/schemas/JiraSourceDto"
                       - $ref: "#/components/schemas/TenantSourceEntryDto"
             examples:
               cursorAndJira:
@@ -1645,6 +1646,8 @@ paths:
         required; optional `branch`) calls `GET {baseUrl}/api/measures/component` with a Bearer
         token. Other types report `{ success: false, error: "unsupported_type" }`. Documented
         `error` codes for AI tool verifiers: `invalid_token`, `rate_limited`, `network_error`.
+        `jira` (`baseUrl`, `email`, `apiToken` or legacy `api_key`) calls
+        `GET {baseUrl}/rest/api/3/myself` with Basic auth.
 
         **Typical outcomes:** Malformed body, missing `type`, invalid `type`, or missing required fields for the
         declared type → `400` with `{ error: "..." }`. Well-formed body with bad credentials or unreachable
@@ -1668,6 +1671,7 @@ paths:
                 - $ref: "#/components/schemas/GrafanaSourceDto"
                 - $ref: "#/components/schemas/SonarQubeSourceDto"
                 - $ref: "#/components/schemas/PagerDutySourceDto"
+                - $ref: "#/components/schemas/JiraSourceDto"
                 - $ref: "#/components/schemas/TenantSourceEntryDto"
             examples:
               cursorValid:
@@ -10201,6 +10205,73 @@ components:
           type: string
           description: PagerDuty user email when known from the last successful verify.
 
+    JiraSourceDto:
+      type: object
+      description: >
+        Jira Cloud source for `PUT /workspaces/{workspaceId}/sources` and
+        `POST /workspaces/{workspaceId}/sources/test`. Uses Atlassian Cloud email + API token
+        (Basic auth). Provide `apiToken` (preferred) or legacy write-only `api_key`; the server
+        normalizes `api_key` to `apiToken` on write.
+      required: [type, baseUrl, email]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [jira]
+        baseUrl:
+          type: string
+          minLength: 1
+          description: Jira Cloud site URL (e.g. `https://your-domain.atlassian.net`).
+        email:
+          type: string
+          minLength: 1
+          description: Atlassian account email used with the API token.
+        apiToken:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: Atlassian API token (write-only on PUT; preferred).
+        api_key:
+          type: string
+          minLength: 1
+          maxLength: 512
+          description: >
+            Deprecated write-only alias for `apiToken`. Accepted for backward compatibility;
+            normalized to `apiToken` and never returned on GET `/config`.
+        userName:
+          type: string
+          description: Optional display name from a successful connection test (echo-after-test).
+        accountId:
+          type: string
+          description: Optional Atlassian account id from a successful connection test.
+
+    JiraSourceConfigDto:
+      type: object
+      description: >
+        Redacted Jira source returned by `GET /workspaces/{workspaceId}/config`.
+        Raw API token is never returned.
+      required: [type, hasToken, baseUrl, email]
+      additionalProperties: false
+      properties:
+        type:
+          type: string
+          enum: [jira]
+        hasToken:
+          type: boolean
+          description: Whether an API token is stored for this workspace.
+        baseUrl:
+          type: string
+          description: Configured Jira Cloud site URL.
+        email:
+          type: string
+          description: Atlassian account email associated with the stored token.
+        userName:
+          type: string
+          description: Display name when known from the last successful verify.
+        accountId:
+          type: string
+          description: Atlassian account id when known from the last successful verify.
+
     AgentExecutionProviderDto:
       type: string
       description: >
@@ -10252,6 +10323,7 @@ components:
               - $ref: "#/components/schemas/GrafanaSourceConfigDto"
               - $ref: "#/components/schemas/SonarQubeSourceConfigDto"
               - $ref: "#/components/schemas/PagerDutySourceConfigDto"
+              - $ref: "#/components/schemas/JiraSourceConfigDto"
               - $ref: "#/components/schemas/TenantSourceEntryDto"
         orgChart:
           nullable: true
@@ -10329,13 +10401,13 @@ components:
           description: Error detail when `executionKeyValid` is false.
         userName:
           type: string
-          description: Present for New Relic or Grafana verify success — authenticated user name.
+          description: Present for New Relic, Grafana, PagerDuty, or Jira 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.
+          description: Present for New Relic or Jira verify success — resolved account ID.
         orgName:
           type: string
           description: Present for Grafana verify success — resolved organization name.

package/package.json

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

package/src/generated/openapi.ts

@@ -596,7 +596,7 @@ export interface paths {
         /**
          * Test one source connection (does not persist)
          * @description Verify a source's credentials without persisting them. Always returns 200 — upstream auth, rate-limit, and network failures surface as `{ success: false, error }` so the SPA can render an inline error.
-         *     Registered AI tools are verified end-to-end: `cursor` (Admin API key in `token` and/or execution key in `executionToken`; at least one must be present). Execution-only tests validate the key against the Cloud Agents API (`GET /v1/me`, with `GET /v1/models` fallback for service accounts) and return `executionKeyValid` / `executionKeyError` without calling the Admin API on `token`. Malformed cursor entries return `400` with `code: invalid_source_entry`. `claude` (Anthropic Admin API at `https://api.anthropic.com`, `X-Api-Key` with an organization Admin API key `sk-ant-admin...`). `sonarqube` (`baseUrl`, `token`, `projectKey` required; optional `branch`) calls `GET {baseUrl}/api/measures/component` with a Bearer token. Other types report `{ success: false, error: "unsupported_type" }`. Documented `error` codes for AI tool verifiers: `invalid_token`, `rate_limited`, `network_error`.
+         *     Registered AI tools are verified end-to-end: `cursor` (Admin API key in `token` and/or execution key in `executionToken`; at least one must be present). Execution-only tests validate the key against the Cloud Agents API (`GET /v1/me`, with `GET /v1/models` fallback for service accounts) and return `executionKeyValid` / `executionKeyError` without calling the Admin API on `token`. Malformed cursor entries return `400` with `code: invalid_source_entry`. `claude` (Anthropic Admin API at `https://api.anthropic.com`, `X-Api-Key` with an organization Admin API key `sk-ant-admin...`). `sonarqube` (`baseUrl`, `token`, `projectKey` required; optional `branch`) calls `GET {baseUrl}/api/measures/component` with a Bearer token. Other types report `{ success: false, error: "unsupported_type" }`. Documented `error` codes for AI tool verifiers: `invalid_token`, `rate_limited`, `network_error`. `jira` (`baseUrl`, `email`, `apiToken` or legacy `api_key`) calls `GET {baseUrl}/rest/api/3/myself` with Basic auth.
          *     **Typical outcomes:** Malformed body, missing `type`, invalid `type`, or missing required fields for the declared type → `400` with `{ error: "..." }`. Well-formed body with bad credentials or unreachable service → `200` with `{ success: false, error: "..." }`.
          */
         post: operations["postTenantSourceTest"];
@@ -4106,6 +4106,38 @@ export interface components {
             /** @description PagerDuty user email when known from the last successful verify. */
             userEmail?: string;
         };
+        /** @description Jira Cloud source for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. Uses Atlassian Cloud email + API token (Basic auth). Provide `apiToken` (preferred) or legacy write-only `api_key`; the server normalizes `api_key` to `apiToken` on write. */
+        JiraSourceDto: {
+            /** @enum {string} */
+            type: "jira";
+            /** @description Jira Cloud site URL (e.g. `https://your-domain.atlassian.net`). */
+            baseUrl: string;
+            /** @description Atlassian account email used with the API token. */
+            email: string;
+            /** @description Atlassian API token (write-only on PUT; preferred). */
+            apiToken?: string;
+            /** @description Deprecated write-only alias for `apiToken`. Accepted for backward compatibility; normalized to `apiToken` and never returned on GET `/config`. */
+            api_key?: string;
+            /** @description Optional display name from a successful connection test (echo-after-test). */
+            userName?: string;
+            /** @description Optional Atlassian account id from a successful connection test. */
+            accountId?: string;
+        };
+        /** @description Redacted Jira source returned by `GET /workspaces/{workspaceId}/config`. Raw API token is never returned. */
+        JiraSourceConfigDto: {
+            /** @enum {string} */
+            type: "jira";
+            /** @description Whether an API token is stored for this workspace. */
+            hasToken: boolean;
+            /** @description Configured Jira Cloud site URL. */
+            baseUrl: string;
+            /** @description Atlassian account email associated with the stored token. */
+            email: string;
+            /** @description Display name when known from the last successful verify. */
+            userName?: string;
+            /** @description Atlassian account id when known from the last successful verify. */
+            accountId?: string;
+        };
         /**
          * @description The agent execution account used for Agentic Foundation runs (readiness scanner + fix queue). Exactly one is active per workspace.
          *       - `thinkai_platform_cursor`: ThinkAI platform Cursor key (Cursor Agent CLI) — opt-in, never default.
@@ -4124,7 +4156,7 @@ export interface components {
             claudeModel?: string | null;
         };
         WorkspaceConfigDto: {
-            sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["CodeIntelligenceSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
+            sources: (components["schemas"]["CursorSourceConfigDto"] | components["schemas"]["ClaudeSourceConfigDto"] | components["schemas"]["CodeIntelligenceSourceConfigDto"] | components["schemas"]["NewRelicSourceConfigDto"] | components["schemas"]["PrometheusSourceConfigDto"] | components["schemas"]["GrafanaSourceConfigDto"] | components["schemas"]["SonarQubeSourceConfigDto"] | components["schemas"]["PagerDutySourceConfigDto"] | components["schemas"]["JiraSourceConfigDto"] | components["schemas"]["TenantSourceEntryDto"])[];
             orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
             /** @enum {string|null} */
             region?: "us" | "eu" | "me" | null;
@@ -4159,11 +4191,11 @@ export interface components {
             executionKeyValid?: boolean | null;
             /** @description Error detail when `executionKeyValid` is false. */
             executionKeyError?: string | null;
-            /** @description Present for New Relic or Grafana verify success — authenticated user name. */
+            /** @description Present for New Relic, Grafana, PagerDuty, or Jira verify success — authenticated user name. */
             userName?: string;
             /** @description Present for New Relic verify success — resolved account display name. */
             accountName?: string;
-            /** @description Present for New Relic verify success — resolved account ID. */
+            /** @description Present for New Relic or Jira verify success — resolved account ID. */
             accountId?: string;
             /** @description Present for Grafana verify success — resolved organization name. */
             orgName?: string;
@@ -8254,6 +8286,8 @@ export type SonarQubeRepoMappingValidateRowDto = components['schemas']['SonarQub
 export type SonarQubeRepoMappingsValidateResponseDto = components['schemas']['SonarQubeRepoMappingsValidateResponseDto'];
 export type PagerDutySourceDto = components['schemas']['PagerDutySourceDto'];
 export type PagerDutySourceConfigDto = components['schemas']['PagerDutySourceConfigDto'];
+export type JiraSourceDto = components['schemas']['JiraSourceDto'];
+export type JiraSourceConfigDto = components['schemas']['JiraSourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
 export type PutCodeIntelligenceSettingsDto = components['schemas']['PutCodeIntelligenceSettingsDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
@@ -10220,7 +10254,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
+                    sources: (components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
                 };
             };
         };
@@ -10274,7 +10308,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["TenantSourceEntryDto"];
+                "application/json": components["schemas"]["CursorSourcePatchDto"] | components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourcePatchDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["CodeIntelligenceSourcePatchDto"] | components["schemas"]["NewRelicSourceDto"] | components["schemas"]["PrometheusSourceDto"] | components["schemas"]["GrafanaSourceDto"] | components["schemas"]["SonarQubeSourceDto"] | components["schemas"]["PagerDutySourceDto"] | components["schemas"]["JiraSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
             };
         };
         responses: {