@thinkai/tai-api-contract 2.57.0 → 2.58.0-pr.901.2e63dee8

package/openapi/openapi.yaml

@@ -10216,7 +10216,14 @@ components:
 
     GithubInstallationSummaryDto:
       type: object
-      required: [installationId, account, repos, permissionsUpgradeRequired]
+      required:
+        - installationId
+        - account
+        - repos
+        - permissionsUpgradeRequired
+        - corePermissionsOk
+        - writePermissionsOk
+        - writePermissionsUpgradeRequired
       properties:
         installationId:
           type: string
@@ -10238,16 +10245,38 @@ components:
         permissionsUpgradeRequired:
           type: boolean
           description: >
-            True when this installation's granted permissions are below what the ThinkAI GitHub App
-            currently requests.
+            True when this installation lacks core read permissions required for connect and analysis.
+            Alias for `!corePermissionsOk`.
+        corePermissionsOk:
+          type: boolean
+          description: >
+            True when installation grants read permissions for repository analysis (contents, metadata,
+            pull requests, and members for org installs).
+        writePermissionsOk:
+          type: boolean
+          description: >
+            True when installation grants write permissions required for automated fix PRs.
+        writePermissionsUpgradeRequired:
+          type: boolean
+          description: Alias for `!writePermissionsOk`.
         missingPermissions:
           type: array
           items:
             $ref: "#/components/schemas/GithubMissingPermissionDto"
+          description: Core read permissions still needed for connect and analysis.
+        missingWritePermissions:
+          type: array
+          items:
+            $ref: "#/components/schemas/GithubMissingPermissionDto"
+          description: Write permissions still needed for automated fix PRs.
         upgradeMessage:
           type: string
           nullable: true
-          description: Human-readable summary for UI when permissionsUpgradeRequired is true.
+          description: Human-readable summary for UI when core permissions are missing.
+        writeUpgradeMessage:
+          type: string
+          nullable: true
+          description: Human-readable summary for UI when write permissions are missing.
 
     GithubPendingApprovalDto:
       type: object
@@ -10361,7 +10390,13 @@ components:
 
     GithubInstallationStatusDto:
       type: object
-      required: [installed, installations, permissionsUpgradeRequired]
+      required:
+        - installed
+        - installations
+        - permissionsUpgradeRequired
+        - corePermissionsOk
+        - writePermissionsOk
+        - writePermissionsUpgradeRequired
       properties:
         installed:
           type: boolean
@@ -10371,7 +10406,25 @@ components:
             $ref: "#/components/schemas/GithubInstallationSummaryDto"
         permissionsUpgradeRequired:
           type: boolean
-          description: True if any connected installation is under-permissioned.
+          description: True if any connected installation lacks core read permissions. Alias for `!corePermissionsOk`.
+        corePermissionsOk:
+          type: boolean
+          description: True when every connected installation grants core read permissions.
+        writePermissionsOk:
+          type: boolean
+          description: True when every connected installation grants write permissions for automated fixes.
+        writePermissionsUpgradeRequired:
+          type: boolean
+          description: True when any connected installation lacks write permissions for automated fixes.
+        missingWritePermissions:
+          type: array
+          items:
+            $ref: "#/components/schemas/GithubMissingPermissionDto"
+          description: Aggregated write permissions missing on installations that lack write access.
+        writeUpgradeMessage:
+          type: string
+          nullable: true
+          description: Human-readable summary when write permissions are missing.
         pendingApproval:
           nullable: true
           allOf:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.57.0",
+  "version": "2.58.0-pr.901.2e63dee8",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -4240,11 +4240,22 @@ 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 installation grants write permissions required for automated 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;
         };
         GithubPendingApprovalDto: {
             /**
@@ -4312,8 +4323,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. */