@thinkai/tai-api-contract 2.154.0 → 2.157.0

package/dist/generated/openapi.d.ts

@@ -3773,7 +3773,7 @@ export interface paths {
         };
         /**
          * Slack install URL for Message Center
-         * @description Workspace admin only. Returns the Slack OAuth authorize URL. State is stored server-side and names this workspace and the signed-in admin. Editor or viewer is `403` with `code` `workspace_admin_required`. Missing Slack app settings are `503` with `code` `slack_not_configured`.
+         * @description Workspace admin only. Returns the Slack OAuth authorize URL with `incoming-webhook` scope. State is stored server-side and names this workspace and the signed-in admin. Editor or viewer is `403` with `code` `workspace_admin_required`. Missing Slack app settings are `503` with `code` `slack_not_configured`.
          */
         get: operations["getSlackInstallUrl"];
         put?: never;
@@ -3793,7 +3793,7 @@ export interface paths {
         };
         /**
          * Slack OAuth callback
-         * @description Browser return from Slack. The provider redirect does not include the API bearer token. `state` was issued by `getSlackInstallUrl` to a signed-in admin and is single-use. The bot token is stored encrypted only when that user is still a workspace admin. Success redirects to `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same page with `slack=error`. The token is never in the redirect.
+         * @description Browser return from Slack. The provider redirect does not include the API bearer token. `state` was issued by `getSlackInstallUrl` to a signed-in admin and is single-use. Install requests `incoming-webhook` only. The encrypted incoming-webhook URL and the channel Slack returns are stored only when that user is still a workspace admin. Success redirects to `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same page with `slack=error`. The webhook URL is never in the redirect.
          */
         get: operations["getSlackOauthCallback"];
         put?: never;
@@ -3813,14 +3813,14 @@ export interface paths {
         };
         /**
          * Slack connection status
-         * @description Any workspace member. `{ connected, channelName }`. `channelName` is null until an admin saves a channel. The bot token is never returned.
+         * @description Any workspace member. `{ connected, channelName }`. `connected` is true only when a decryptable install webhook is stored. `channelName` is the channel chosen on Slack's install screen (null when not connected). Secrets are never returned.
          */
         get: operations["getSlackIntegration"];
         put?: never;
         post?: never;
         /**
          * Disconnect Slack
-         * @description Workspace admin only. Removes the bot token and saved channel. Later Message Center delivery does not post to Slack.
+         * @description Workspace admin only. Removes the install webhook, optional bot token, and saved channel. Later Message Center delivery does not post to Slack.
          */
         delete: operations["deleteSlackIntegration"];
         options?: never;
@@ -3837,8 +3837,8 @@ export interface paths {
         };
         get?: never;
         /**
-         * Save the Slack channel for Message Center
-         * @description Workspace admin only. Body `{ channelId }`. Slack must already be connected. The response is the same status object as `getSlackIntegration`, with the channel name Slack returned. Unknown or malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
+         * Change Slack channel (requires reinstall)
+         * @description Workspace admin only. Body `{ channelId }`. The notification channel is chosen on Slack's install screen with the incoming webhook; this route does not rewrite channel metadata. When Slack is connected, the API returns `409` with `code` `slack_channel_reinstall_required` — reconnect via `getSlackInstallUrl` to pick a different channel. Malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
          */
         put: operations["putSlackChannel"];
         post?: never;
@@ -7489,6 +7489,8 @@ export interface components {
             fixStatus: "open" | "pr-pending" | "fixed";
             /** @description True when the platform does not yet have an auto-fix skill for this issue's dimension. The UI should render these items as disabled with a "Coming Soon" tooltip. */
             comingSoon?: boolean;
+            /** @description Short labels when the instruction file names two alternatives and does not pick one. Fix it stays disabled until the request includes one of these as patternChoice. */
+            unresolvedChoices?: string[];
             /**
              * @description How automated fixing is supported for this criterion. `auto` — agent edits files directly; no human input needed. `decisions-first` — agent requires docs/ai-readiness-decisions.md to be filled first. `guidance` — admin-level action; agent creates an instructions doc PR.
              * @enum {string}
@@ -7929,6 +7931,15 @@ export interface components {
                 /** @description Issues whose fix has been applied (fix_status = fixed). */
                 fixed: number;
             };
+            /** @description Distinct non-archived repos whose latest succeeded scan has an A1 gap (no instruction file) or a B5 gap (CI never runs tests). A gap whose matching issue is already fixed is excluded. Omitted when the server cannot see per-criterion status. */
+            verificationGapCount?: number;
+            /** @description Up to 12 repo and reason pairs for verificationGapCount. A repo with both gaps appears twice. Does not change averageOverallScore. */
+            verificationGaps?: components["schemas"]["AgenticFoundationVerificationGapDto"][];
+        };
+        AgenticFoundationVerificationGapDto: {
+            repoName: string;
+            /** @enum {string} */
+            reason: "no instruction file" | "CI never runs tests";
         };
         PageMetaDto: {
             /** @description Total rows matching filters (full workspace, not just this page). */
@@ -8097,6 +8108,8 @@ export interface components {
              * @description Workspace repository id that owns the issue
              */
             repoId: string;
+            /** @description Required when the issue has unresolvedChoices. Must be one of those labels. Stored on the fix row and stated in the worker prompt. */
+            patternChoice?: string;
         };
         PhaseRoleDto: {
             phase: string;
@@ -8340,12 +8353,13 @@ export interface components {
             teams: components["schemas"]["NotificationChatChannelsDto"];
         };
         SlackInstallUrlDto: {
-            /** @description Slack OAuth authorize URL. The bot token is not included. */
+            /** @description Slack OAuth authorize URL (`incoming-webhook` scope). Secrets are not included. */
             url: string;
         };
         SlackIntegrationStatusDto: {
+            /** @description True only when a decryptable install webhook URL is stored for this workspace. */
             connected: boolean;
-            /** @description Saved channel name. Null until an admin saves a channel, and when disconnected. */
+            /** @description Channel name returned by Slack at install time. Null when not connected. */
             channelName: string | null;
         };
         SlackChannelBodyDto: {
@@ -11097,6 +11111,7 @@ export type LinkedRolePendingDto = components['schemas']['LinkedRolePendingDto']
 export type LinkedRoleAssessmentDto = components['schemas']['LinkedRoleAssessmentDto'];
 export type RepoReadinessScoreDetailDto = components['schemas']['RepoReadinessScoreDetailDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
+export type AgenticFoundationVerificationGapDto = components['schemas']['AgenticFoundationVerificationGapDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
 export type ReadinessEligibilityLimitsDto = components['schemas']['ReadinessEligibilityLimitsDto'];
 export type ReadinessRepoListDto = components['schemas']['ReadinessRepoListDto'];
@@ -18981,7 +18996,7 @@ export interface operations {
                     "application/json": components["schemas"]["FixRequestDto"];
                 };
             };
-            /** @description Invalid body or malformed `repoId` (not a UUID) */
+            /** @description Invalid body, malformed `repoId`, or a missing/unknown `patternChoice` when the issue has `unresolvedChoices` (`pattern_choice_required`, `pattern_choice_invalid`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -21382,7 +21397,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Channel saved */
+            /** @description Not returned. The channel is chosen on Slack's install screen; when connected the API responds with `409` `slack_channel_reinstall_required`. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -21391,7 +21406,7 @@ export interface operations {
                     "application/json": components["schemas"]["SlackIntegrationStatusDto"];
                 };
             };
-            /** @description channelId is missing, malformed, or unknown to Slack */
+            /** @description channelId is missing or malformed */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -21399,7 +21414,7 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "error": "Slack channel was not found",
+                     *       "error": "channelId is required",
                      *       "code": "invalid_slack_channel"
                      *     }
                      */
@@ -21431,33 +21446,12 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Slack is not connected */
+            /** @description Slack is not connected (`slack_not_connected`), or the channel cannot be changed without a new install (`slack_channel_reinstall_required`). */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "Slack is not connected",
-                     *       "code": "slack_not_connected"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["ErrorMessageDto"];
-                };
-            };
-            /** @description Slack rejected the lookup */
-            502: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "Slack did not accept the channel",
-                     *       "code": "slack_request_failed"
-                     *     }
-                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };