@thinkai/tai-api-contract 2.61.0 → 2.62.0

package/src/generated/openapi.ts

@@ -1039,7 +1039,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;
@@ -1048,6 +1048,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;
@@ -2466,6 +2506,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/your-ai-journey/hero": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * First-paint hero payload for the /dashboard page
+         * @description Returns analytics and productivity in one response so the dashboard hero can paint with a single RTT (auth + membership checked once). Nested payloads match the dedicated analytics and productivity routes and reuse those routes' 60s caches (there is no separate hero-level cache). `generatedAt` on the hero envelope and both nested payloads is set to the same assembly timestamp.
+         */
+        get: operations["getYourAiJourneyHero"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/your-ai-journey/analytics": {
         parameters: {
             query?: never;
@@ -4489,6 +4549,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"];
@@ -4498,11 +4574,35 @@ export interface components {
             manageUrl?: string | null;
             /** Format: date-time */
             lastSyncedAt?: string | null;
-            /** @description True when this installation's granted permissions are below what the ThinkAI GitHub App currently requests. */
+            /** @description True when this installation lacks core read permissions required for connect and analysis. Alias for `!corePermissionsOk`. */
             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 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;
+            /** @description Core read permissions still needed for connect and analysis. */
             missingPermissions?: components["schemas"]["GithubMissingPermissionDto"][];
-            /** @description Human-readable summary for UI when permissionsUpgradeRequired is true. */
+            /** @description Write permissions still needed for automated fix PRs. */
+            missingWritePermissions?: components["schemas"]["GithubMissingPermissionDto"][];
+            /** @description Human-readable summary for UI when core permissions are missing. */
             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: {
             /**
@@ -4658,8 +4758,18 @@ export interface components {
         GithubInstallationStatusDto: {
             installed: boolean;
             installations: components["schemas"]["GithubInstallationSummaryDto"][];
-            /** @description True if any connected installation is under-permissioned. */
+            /** @description True if any connected installation lacks core read permissions. Alias for `!corePermissionsOk`. */
             permissionsUpgradeRequired: boolean;
+            /** @description True when every connected installation grants core read permissions. */
+            corePermissionsOk: boolean;
+            /** @description True when every connected installation grants write permissions for automated fixes. */
+            writePermissionsOk: boolean;
+            /** @description True when any connected installation lacks write permissions for automated fixes. */
+            writePermissionsUpgradeRequired: boolean;
+            /** @description Aggregated write permissions missing on installations that lack write access. */
+            missingWritePermissions?: components["schemas"]["GithubMissingPermissionDto"][];
+            /** @description Human-readable summary when write permissions are missing. */
+            writeUpgradeMessage?: string | null;
             /** @description Present when an org admin must approve the GitHub App install request. */
             pendingApproval?: components["schemas"]["GithubPendingApprovalDto"] | null;
             /** @description Present when GitHub connect was started but not completed (install OAuth state or account-picker session still active). Omitted when pendingApproval is set. */
@@ -4699,12 +4809,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;
             /**
@@ -5617,6 +5743,17 @@ export interface components {
                 totalFixedIssues: number;
             };
         };
+        YourAiJourneyHeroDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /**
+             * Format: date-time
+             * @description Assembly timestamp for this hero response; also written onto analytics.generatedAt and productivity.generatedAt so all three match.
+             */
+            generatedAt: string;
+            analytics: components["schemas"]["YourAiJourneyAnalyticsDto"];
+            productivity: components["schemas"]["DashboardProductivityDto"];
+        };
         YourAiJourneyAnalyticsDto: {
             /** Format: uuid */
             workspaceId: string;
@@ -6214,6 +6351,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'];
@@ -6229,6 +6368,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'];
@@ -6327,6 +6467,7 @@ export type YourAiJourneyPrSignalsWeekDto = components['schemas']['YourAiJourney
 export type YourAiJourneyPrSignalsDto = components['schemas']['YourAiJourneyPrSignalsDto'];
 export type YourAiJourneyReadinessDimensionDto = components['schemas']['YourAiJourneyReadinessDimensionDto'];
 export type YourAiJourneyReadinessAggregateDto = components['schemas']['YourAiJourneyReadinessAggregateDto'];
+export type YourAiJourneyHeroDto = components['schemas']['YourAiJourneyHeroDto'];
 export type YourAiJourneyAnalyticsDto = components['schemas']['YourAiJourneyAnalyticsDto'];
 export type YourAiJourneyAiSpendWeekDto = components['schemas']['YourAiJourneyAiSpendWeekDto'];
 export type YourAiJourneyAiSpendDto = components['schemas']['YourAiJourneyAiSpendDto'];
@@ -9332,6 +9473,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: {
@@ -11988,6 +12213,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: {
@@ -12031,6 +12274,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: {
@@ -12774,6 +13035,39 @@ export interface operations {
             };
         };
     };
+    getYourAiJourneyHero: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Hero bootstrap payload */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["YourAiJourneyHeroDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getYourAiJourneyAnalytics: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -1145,6 +1145,14 @@ export interface YourAiJourneyAnalyticsDto {
 /** Response for GET /workspaces/:workspaceId/your-ai-journey/productivity — same shape as DashboardProductivityDto. */
 export type YourAiJourneyProductivityDto = DashboardProductivityDto;
 
+/** Response for GET /workspaces/:workspaceId/your-ai-journey/hero — first-paint BFF. */
+export interface YourAiJourneyHeroDto {
+  workspaceId: string;
+  generatedAt: string;
+  analytics: YourAiJourneyAnalyticsDto;
+  productivity: YourAiJourneyProductivityDto;
+}
+
 /** Response for GET /workspaces/:workspaceId/your-ai-journey/agentic-foundation — same shape as AgenticFoundationDashboardDto. */
 export type YourAiJourneyAgenticFoundationDto = AgenticFoundationDashboardDto;