@thinkai/tai-api-contract 2.7.3 → 2.8.1

package/src/generated/openapi.ts

@@ -195,7 +195,7 @@ export interface paths {
          * @description Replace the workspace's `sources` array. Cursor entries are validated strictly (`token` 1-256 chars, no whitespace, no `env:` prefix; optional deprecated `baseUrl` is accepted for backwards compatibility and ignored at runtime; verification and future refresh use the fixed Cursor Admin API host. Other types pass through with only a non-empty `type` requirement so existing jira / sonarqube / bitbucket callers are not regressed. **`type: github` is rejected** with HTTP 400 and `code: github_sources_deprecated`; use the GitHub App integration (`POST /workspaces/{workspaceId}/integrations/github/install-url` and callback) instead.
          *     Every secret-keyed top-level string field (`token`, `password`, `api_key`, `secret`, `private_key`, `client_secret`) is encrypted at rest with AES-256-GCM under `SOURCES_TOKEN_ENC_KEY` before persistence; `env:`-prefixed values pass through unchanged. `GET /workspaces/{workspaceId}/config` continues to redact every secret-keyed field to `***` regardless of whether the stored value is encrypted, plaintext, or `env:` ref.
          *     Requires editor or admin workspace role.
-         *     **Typical outcomes:** Valid typed sources → `200` with `{ ok: true, workspaceId }`. Missing required fields for a given `type` → `400` with `error` text. Unknown `type` strings (non-cursor, non-github) currently pass through to storage (lenient compatibility); only `cursor` entries get strict field validation. Cursor sources enforce strict token shape (no whitespace, no `env:` prefix).
+         *     **Typical outcomes:** Valid typed sources → `200` with `{ ok: true, workspaceId }`. Missing required fields for a given `type` → `400` with `error` text. Unknown `type` strings (non-AI-tool, non-github) currently pass through to storage (lenient compatibility). Registered AI tools (`cursor`, `claude`) get strict field validation (no whitespace, no `env:` prefix on tokens).
          */
         put: operations["putTenantSources"];
         post?: never;
@@ -217,8 +217,8 @@ 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.
-         *     Currently only `type: cursor` is verified end-to-end (Cursor Admin API, HTTP Basic against `https://api.cursor.com`; optional `baseUrl` in the body is deprecated and ignored). Other types report `{ success: false, error: "unsupported_type" }`. Documented `error` codes for cursor: `invalid_token`, `rate_limited`, `network_error`.
-         *     **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: "..." }` (Cursor verifier and non-cursor paths as documented above).
+         *     Registered AI tools are verified end-to-end: `cursor` (Cursor Admin API at `https://api.cursor.com`, HTTP Basic; optional `baseUrl` is deprecated and ignored) and `claude` (Anthropic Admin API at `https://api.anthropic.com`, `X-Api-Key` with an organization Admin API key `sk-ant-admin...`). Other types report `{ success: false, error: "unsupported_type" }`. Documented `error` codes for AI tool verifiers: `invalid_token`, `rate_limited`, `network_error`.
+         *     **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"];
         delete?: never;
@@ -915,6 +915,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/repos/{repoId}/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Paginated readiness run history for one repository
+         * @description Append-only scan history for charts on repo detail. Ordered by scan finish time (or `createdAt` when still in progress). Use `cursor` from the previous response for the next page. Failed and `partial_failed` runs are included with nullable `overallScore`.
+         */
+        get: operations["listReadinessRepoRuns"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/readiness/score-history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Workspace score time-series for all repositories
+         * @description Returns succeeded runs with stored `overallScore` per repo in one call (avoids N+1). Points are ordered ascending by `finishedAt` within each repo. Omit failed and `partial_failed` runs. Use `since` to bound the window; `limitPerRepo` caps points per repo (most recent first, then returned oldest-to-newest within the cap).
+         */
+        get: operations["getReadinessScoreHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/agentic-foundation/dashboard": {
         parameters: {
             query?: never;
@@ -1606,6 +1646,13 @@ export interface components {
              */
             baseUrl: string;
         };
+        /** @description Claude (Anthropic) source entry for `PUT /workspaces/{workspaceId}/sources` and `POST /workspaces/{workspaceId}/sources/test`. The `token` field carries a literal Organization Admin API key on writes (`sk-ant-admin...`); reads from `GET /workspaces/{workspaceId}/config` redact it to `***`. Runtime calls use the Anthropic Admin API at `https://api.anthropic.com`. Provision keys in Claude Console → Organization settings (admin role required). */
+        ClaudeSourceDto: {
+            /** @enum {string} */
+            type: "claude";
+            /** @description Anthropic Organization Admin API key (literal, must start with sk-ant-admin). Standard API keys (sk-ant-api...) are rejected. Whitespace and `env:` prefix are rejected. */
+            token: string;
+        };
         WorkspaceConfigDto: {
             sources: components["schemas"]["TenantSourceEntryDto"][];
             orgChart?: components["schemas"]["ScoringOrgChartDto"] | null;
@@ -2375,6 +2422,46 @@ export interface components {
             criteriaSummary?: components["schemas"]["ReadinessCriteriaSummaryDto"] | null;
             issues: components["schemas"]["ReadinessIssueDto"][];
         };
+        ReadinessRepoRunHistoryItemDto: {
+            /** Format: uuid */
+            runId: string;
+            status: components["schemas"]["ReadinessRunStatusDto"];
+            /** @description Present for succeeded runs after migration 050; null otherwise. */
+            overallScore: number | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            finishedAt: string | null;
+        };
+        ReadinessRepoRunListDto: {
+            items: components["schemas"]["ReadinessRepoRunHistoryItemDto"][];
+            limit: number;
+            /** @description Pass as `cursor` query param to fetch the next page; null when no more rows. */
+            nextCursor: string | null;
+        };
+        ReadinessScoreHistoryPointDto: {
+            /** Format: date-time */
+            finishedAt: string;
+            overallScore: number;
+        };
+        ReadinessRepoScoreHistoryDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /**
+             * Format: date-time
+             * @description When the repository was first materialized in the workspace (GitHub connect).
+             */
+            connectedAt: string;
+            points: components["schemas"]["ReadinessScoreHistoryPointDto"][];
+        };
+        WorkspaceReadinessScoreHistoryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** Format: date-time */
+            generatedAt: string;
+            repos: components["schemas"]["ReadinessRepoScoreHistoryDto"][];
+        };
         RepoReadinessScoreDto: {
             /** Format: uuid */
             repoId: string;
@@ -2385,6 +2472,11 @@ export interface components {
             dimensions: components["schemas"]["DimensionScoreDto"][];
             /** Format: date-time */
             lastAnalyzed: string;
+            /**
+             * Format: date-time
+             * @description First time this repository was materialized in the workspace (GitHub connect).
+             */
+            connectedAt: string;
             /** Format: uuid */
             teamId?: string | null;
             provider: components["schemas"]["RepoProviderDto"];
@@ -2840,6 +2932,7 @@ export type OrgChartImportResultDto = components['schemas']['OrgChartImportResul
 export type OrgChartSaveResultDto = components['schemas']['OrgChartSaveResultDto'];
 export type TenantSourceEntryDto = components['schemas']['TenantSourceEntryDto'];
 export type CursorSourceDto = components['schemas']['CursorSourceDto'];
+export type ClaudeSourceDto = components['schemas']['ClaudeSourceDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
 export type AiToolSeatDto = components['schemas']['AiToolSeatDto'];
@@ -2921,6 +3014,11 @@ export type ReadinessRunSummaryDto = components['schemas']['ReadinessRunSummaryD
 export type ReadinessCriteriaSummaryDto = components['schemas']['ReadinessCriteriaSummaryDto'];
 export type ReadinessIssueDto = components['schemas']['ReadinessIssueDto'];
 export type DimensionScoreDto = components['schemas']['DimensionScoreDto'];
+export type ReadinessRepoRunHistoryItemDto = components['schemas']['ReadinessRepoRunHistoryItemDto'];
+export type ReadinessRepoRunListDto = components['schemas']['ReadinessRepoRunListDto'];
+export type ReadinessScoreHistoryPointDto = components['schemas']['ReadinessScoreHistoryPointDto'];
+export type ReadinessRepoScoreHistoryDto = components['schemas']['ReadinessRepoScoreHistoryDto'];
+export type WorkspaceReadinessScoreHistoryDto = components['schemas']['WorkspaceReadinessScoreHistoryDto'];
 export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
@@ -3487,7 +3585,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    sources: (components["schemas"]["CursorSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
+                    sources: (components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["TenantSourceEntryDto"])[];
                 };
             };
         };
@@ -3541,7 +3639,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CursorSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
+                "application/json": components["schemas"]["CursorSourceDto"] | components["schemas"]["ClaudeSourceDto"] | components["schemas"]["TenantSourceEntryDto"];
             };
         };
         responses: {
@@ -4567,7 +4665,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                provider: "cursor";
+                provider: "cursor" | "claude";
             };
             cookie?: never;
         };
@@ -4622,7 +4720,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                provider: "cursor";
+                provider: "cursor" | "claude";
             };
             cookie?: never;
         };
@@ -4653,7 +4751,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                provider: "cursor";
+                provider: "cursor" | "claude";
             };
             cookie?: never;
         };
@@ -4682,7 +4780,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                provider: "cursor";
+                provider: "cursor" | "claude";
             };
             cookie?: never;
         };
@@ -4709,7 +4807,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                provider: "cursor";
+                provider: "cursor" | "claude";
             };
             cookie?: never;
         };
@@ -5298,6 +5396,100 @@ export interface operations {
             };
         };
     };
+    listReadinessRepoRuns: {
+        parameters: {
+            query?: {
+                limit?: number;
+                order?: "asc" | "desc";
+                /** @description Opaque cursor from a prior response `nextCursor` field. */
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                repoId: components["parameters"]["RepoId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Run history page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadinessRepoRunListDto"];
+                };
+            };
+            /** @description Invalid pagination query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getReadinessScoreHistory: {
+        parameters: {
+            query?: {
+                /** @description ISO-8601 lower bound on `finishedAt` (inclusive). */
+                since?: string;
+                limitPerRepo?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Score history grouped by repository */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceReadinessScoreHistoryDto"];
+                };
+            };
+            /** @description Invalid query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getAgenticFoundationDashboard: {
         parameters: {
             query?: never;