@thinkai/tai-api-contract 2.58.0-pr.901.2e63dee8 → 2.58.1-pr.901.538cc170

package/dist/generated/openapi.d.ts

@@ -1038,7 +1038,7 @@ export interface paths {
         put?: never;
         /**
          * Create GitHub App installation URL
-         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
+         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Default intent `connect` installs ThinkAI Platform Insights (read). Intent `enable_fixes` installs ThinkAI Platform Automations (write) for the Insights installation identified by `installationId`. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
          */
         post: operations["postGithubInstallUrl"];
         delete?: never;
@@ -1047,6 +1047,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/github/installations/{installationId}/automated-fixes/enable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Enable automated fixes for a GitHub installation
+         * @description Workspace-level enable for automated fixes on an Insights (read) installation. If an Automations (write) installation is already linked, flips `automatedFixesEnabled` without reinstalling. Otherwise returns `outcome: needs_install` so the client can call install-url with intent=enable_fixes.
+         */
+        post: operations["postGithubAutomatedFixesEnable"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/github/installations/{installationId}/automated-fixes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Disable automated fixes for a GitHub installation
+         * @description Workspace-level disable. Clears `automatedFixesEnabled` but keeps the linked Automations write installation id so re-enable does not require reinstall. Does not uninstall the Automations app from GitHub.
+         */
+        delete: operations["deleteGithubAutomatedFixes"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/github/user-authorize-url": {
         parameters: {
             query?: never;
@@ -4230,6 +4270,22 @@ export interface components {
              */
             granted?: "read" | "write" | "admin" | null;
         };
+        GithubWritePermissionsRequiredErrorDto: {
+            /** @enum {string} */
+            error: "github_write_permissions_required";
+            missingPermissions: components["schemas"]["GithubMissingPermissionDto"][];
+            /** @description GitHub installation settings URL to approve write permissions. */
+            manageUrl?: string | null;
+            /** @description Human-readable summary of the write permission upgrade. */
+            writeUpgradeMessage?: string | null;
+        };
+        GithubPermissionsCheckFailedErrorDto: {
+            /**
+             * @description GitHub installation permissions could not be verified (transient upstream failure).
+             * @enum {string}
+             */
+            error: "github_permissions_check_failed";
+        };
         GithubInstallationSummaryDto: {
             installationId: string;
             account: components["schemas"]["GithubAccountDto"];
@@ -4243,7 +4299,7 @@ export interface components {
             permissionsUpgradeRequired: boolean;
             /** @description True when installation grants read permissions for repository analysis (contents, metadata, pull requests, and members for org installs). */
             corePermissionsOk: boolean;
-            /** @description True when installation grants write permissions required for automated fix PRs. */
+            /** @description True when automated fixes are enabled and the linked Automations (write) installation grants write permissions required for fix PRs. */
             writePermissionsOk: boolean;
             /** @description Alias for `!writePermissionsOk`. */
             writePermissionsUpgradeRequired: boolean;
@@ -4255,6 +4311,19 @@ export interface components {
             upgradeMessage?: string | null;
             /** @description Human-readable summary for UI when write permissions are missing. */
             writeUpgradeMessage?: string | null;
+            /** @description True when this workspace has enabled automated fixes for this Insights (read) installation and linked a ThinkAI Platform Automations (write) installation. */
+            automatedFixesEnabled: boolean;
+            /** @description True when an Automations (write) GitHub App installation is linked. */
+            writeAppInstalled: boolean;
+            /** @description GitHub installation id for the Automations (write) app, when linked. */
+            writeInstallationId?: string | null;
+            /**
+             * Format: uri
+             * @description GitHub settings URL for the Automations (write) installation.
+             */
+            writeManageUrl?: string | null;
+            /** @description True when the Automations app is configured and automated fixes are not yet enabled for this installation (UI may show Enable automated fixes). */
+            canEnableAutomatedFixes: boolean;
         };
         GithubPendingApprovalDto: {
             /**
@@ -4373,12 +4442,28 @@ export interface components {
              * @description SPA origin to redirect back to after OAuth; must match server spaOrigins allowlist.
              */
             spaOrigin?: string;
+            /**
+             * @description connect installs ThinkAI Platform Insights (read). enable_fixes installs ThinkAI Platform Automations (write) for the Insights installation identified by installationId.
+             * @enum {string}
+             */
+            intent?: "connect" | "enable_fixes";
+            /** @description Insights (read) installation id required when intent is enable_fixes. */
+            installationId?: string;
         };
         GithubInstallUrlResponseDto: {
             /** Format: uri */
             url: string;
             state: string;
         };
+        GithubAutomatedFixesEnableResponseDto: {
+            /**
+             * @description enabled — write app already linked and flag flipped; needs_install — client should call install-url with intent=enable_fixes.
+             * @enum {string}
+             */
+            outcome: "enabled" | "needs_install";
+            /** @description Present when outcome is enabled. */
+            status?: components["schemas"]["GithubInstallationStatusDto"];
+        };
         GithubUserAuthorizeUrlRequestDto: {
             returnPath?: string;
             /**
@@ -5855,6 +5940,8 @@ export type RepoEligibilityOverridesDto = components['schemas']['RepoEligibility
 export type WorkspaceRepoEligibilityDto = components['schemas']['WorkspaceRepoEligibilityDto'];
 export type RepoEligibilityLimitsDto = components['schemas']['RepoEligibilityLimitsDto'];
 export type GithubMissingPermissionDto = components['schemas']['GithubMissingPermissionDto'];
+export type GithubWritePermissionsRequiredErrorDto = components['schemas']['GithubWritePermissionsRequiredErrorDto'];
+export type GithubPermissionsCheckFailedErrorDto = components['schemas']['GithubPermissionsCheckFailedErrorDto'];
 export type GithubInstallationSummaryDto = components['schemas']['GithubInstallationSummaryDto'];
 export type GithubPendingApprovalDto = components['schemas']['GithubPendingApprovalDto'];
 export type GithubSetupInProgressDto = components['schemas']['GithubSetupInProgressDto'];
@@ -5864,6 +5951,7 @@ export type GithubActionsEnableResponseDto = components['schemas']['GithubAction
 export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
 export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
 export type GithubInstallUrlResponseDto = components['schemas']['GithubInstallUrlResponseDto'];
+export type GithubAutomatedFixesEnableResponseDto = components['schemas']['GithubAutomatedFixesEnableResponseDto'];
 export type GithubUserAuthorizeUrlRequestDto = components['schemas']['GithubUserAuthorizeUrlRequestDto'];
 export type GithubUserAuthorizeUrlResponseDto = components['schemas']['GithubUserAuthorizeUrlResponseDto'];
 export type GithubConnectableAccountDto = components['schemas']['GithubConnectableAccountDto'];
@@ -8962,6 +9050,90 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description Requested GitHub App is not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    postGithubAutomatedFixesEnable: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                installationId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Enable result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubAutomatedFixesEnableResponseDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or installation not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Automations GitHub App not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    deleteGithubAutomatedFixes: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                installationId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Automated fixes disabled (or already disabled) */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or installation not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     postGithubUserAuthorizeUrl: {
@@ -11366,6 +11538,24 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description GitHub installation lacks write permissions required for automated fix PRs */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubWritePermissionsRequiredErrorDto"];
+                };
+            };
+            /** @description GitHub installation permissions could not be verified */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubPermissionsCheckFailedErrorDto"];
+                };
+            };
         };
     };
     postReadinessFixRetrigger: {
@@ -11409,6 +11599,24 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description GitHub installation lacks write permissions required for automated fix PRs */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubWritePermissionsRequiredErrorDto"];
+                };
+            };
+            /** @description GitHub installation permissions could not be verified */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GithubPermissionsCheckFailedErrorDto"];
+                };
+            };
         };
     };
     putCursorPlatformKeyConsent: {