@thinkai/tai-api-contract 2.1.0 → 2.2.1

package/src/generated/openapi.ts

@@ -211,16 +211,20 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/reviews": {
+    "/workspaces/{workspaceId}/company-profile": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Admin review queue */
-        get: operations["listAdminReviews"];
-        put?: never;
+        /** Get company profile */
+        get: operations["getCompanyProfile"];
+        /**
+         * Upsert company profile
+         * @description Idempotent upsert of the workspace's company profile. On success, also synchronizes `tai_workspaces.name` to the new `companyName` so subsequent calls to `GET /me/workspaces` reflect the updated display name. Repeated PUTs replace the stored payload entirely.
+         */
+        put: operations["putCompanyProfile"];
         post?: never;
         delete?: never;
         options?: never;
@@ -228,42 +232,27 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/reviews/{id}": {
+    "/workspaces/{workspaceId}/integrations/github": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Single review submission */
-        get: operations["getAdminReview"];
+        /**
+         * GitHub App installation status for workspace
+         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub.
+         */
+        get: operations["getWorkspaceGithubInstallationStatus"];
         put?: never;
         post?: never;
         delete?: never;
         options?: never;
         head?: never;
-        /** Update review metadata */
-        patch: operations["patchAdminReview"];
-        trace?: never;
-    };
-    "/admin/reviews/{id}/sections/{sectionId}/comments": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Add section comment */
-        post: operations["postAdminReviewComment"];
-        delete?: never;
-        options?: never;
-        head?: never;
         patch?: never;
         trace?: never;
     };
-    "/admin/reviews/{id}/sections/{sectionId}/decision": {
+    "/workspaces/{workspaceId}/integrations/github/install-url": {
         parameters: {
             query?: never;
             header?: never;
@@ -271,63 +260,31 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
-        /** Set section decision */
-        put: operations["putAdminReviewSectionDecision"];
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/reviews/{id}/pricing": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        /** Update pricing lines */
-        put: operations["putAdminReviewPricing"];
-        post?: never;
+        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 `/phase-a/p3` return path.
+         */
+        post: operations["postGithubInstallUrl"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/admin/reviews/{id}/deployment": {
+    "/integrations/github/callback": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        /** Update deployment plan */
-        put: operations["putAdminReviewDeployment"];
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/workspaces/{workspaceId}/company-profile": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Get company profile */
-        get: operations["getCompanyProfile"];
         /**
-         * Upsert company profile
-         * @description Idempotent upsert of the workspace's company profile. On success, also synchronizes `tai_workspaces.name` to the new `companyName` so subsequent calls to `GET /me/workspaces` reflect the updated display name. Repeated PUTs replace the stored payload entirely.
+         * GitHub App installation callback
+         * @description Public callback endpoint used by GitHub App installation flow. Resolves and consumes install state, persists workspace installation linkage, then redirects to configured SPA origin with status markers.
          */
-        put: operations["putCompanyProfile"];
+        get: operations["getGithubInstallCallback"];
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -335,20 +292,20 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/workspaces/{workspaceId}/integrations/github": {
+    "/integrations/github/webhook": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * GitHub App installation status for workspace
-         * @description Returns whether a GitHub App installation is linked and cached repo metadata. When no installation exists, returns 200 with `installed: false` (never 404 for missing install). Use `refresh=true` to bypass cache and re-list repositories from GitHub.
+         * GitHub App webhook receiver
+         * @description Public webhook endpoint that verifies `X-Hub-Signature-256` and updates or removes workspace GitHub integration/cache state for installation events.
          */
-        get: operations["getWorkspaceGithubInstallationStatus"];
-        put?: never;
-        post?: never;
+        post: operations["postGithubWebhook"];
         delete?: never;
         options?: never;
         head?: never;
@@ -787,7 +744,13 @@ export interface components {
             [key: string]: unknown;
         };
         DashboardProductivityDto: {
+            /** Format: uuid */
             workspaceId: string;
+            /**
+             * Format: date-time
+             * @description Response generation time (RFC 3339).
+             */
+            generatedAt?: string;
             /** Format: date-time */
             windowStart: string;
             /** Format: date-time */
@@ -800,6 +763,10 @@ export interface components {
             };
         };
         DashboardProductivityHistoryDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            bucket: "day" | "week" | "month";
             buckets: {
                 /** Format: date-time */
                 bucketStart: string;
@@ -871,6 +838,14 @@ export interface components {
             /** Format: date-time */
             lastSyncedAt?: string | null;
         };
+        GithubInstallUrlRequestDto: {
+            returnPath?: string;
+        };
+        GithubInstallUrlResponseDto: {
+            /** Format: uri */
+            url: string;
+            state: string;
+        };
         AIReadinessDto: {
             currentUsage: string;
             tools: string[];
@@ -1107,86 +1082,6 @@ export interface components {
             items: components["schemas"]["NotificationDto"][];
             total: number;
         };
-        ReviewQueueItemDto: {
-            id: string;
-            client: string;
-            project: string;
-            workflows: ("greenfield" | "brownfield")[];
-            /** Format: date-time */
-            submittedAt: string;
-            reviewer: string | null;
-            /** @enum {string} */
-            status: "pending" | "in_review" | "approved" | "changes_requested";
-            /** @enum {string} */
-            priority: "high" | "medium" | "low";
-        };
-        AdminDashboardDto: {
-            queue: components["schemas"]["ReviewQueueItemDto"][];
-            reviewers: string[];
-        };
-        PatchAdminReviewBodyDto: {
-            /** @enum {string} */
-            status?: "pending" | "in_review" | "approved" | "changes_requested";
-            reviewer?: string;
-            /** @enum {string} */
-            priority?: "high" | "medium" | "low";
-        };
-        CommentDto: {
-            id: string;
-            sectionId: string;
-            author: string;
-            text: string;
-            /** Format: date-time */
-            timestamp: string;
-        };
-        AdminCommentBodyDto: {
-            text: string;
-        };
-        SectionDecisionBodyDto: {
-            /** @enum {string} */
-            decision: "pending" | "approved" | "changes_requested" | "rejected";
-        };
-        PricingLineDto: {
-            id: string;
-            label: string;
-            rate: number;
-            hours: number;
-        };
-        PricingUpdateBodyDto: {
-            items: {
-                id: string;
-                rate: number;
-                hours: number;
-            }[];
-        };
-        DeploymentPlanDto: {
-            startDate: string;
-            endDate: string;
-            milestones: string[];
-        };
-        ReviewSectionDto: {
-            id: string;
-            label: string;
-            detail: string;
-            /** @enum {string} */
-            decision: "pending" | "approved" | "changes_requested" | "rejected";
-            comments: components["schemas"]["CommentDto"][];
-        };
-        ReviewSubmissionDto: {
-            id: string;
-            client: string;
-            project: string;
-            workflows: ("greenfield" | "brownfield")[];
-            /** @enum {string} */
-            status: "pending" | "in_review" | "approved" | "changes_requested";
-            isResubmission: boolean;
-            context: {
-                text: string;
-            }[];
-            sections: components["schemas"]["ReviewSectionDto"][];
-            pricing: components["schemas"]["PricingLineDto"][];
-            deployment: components["schemas"]["DeploymentPlanDto"];
-        };
         EffectiveTaskRowDto: {
             id: string;
             name: string;
@@ -1277,8 +1172,6 @@ export interface components {
         WorkspaceId: string;
         RepoId: string;
         ProjectId: string;
-        ReviewId: string;
-        SectionId: string;
         NotificationId: string;
     };
     requestBodies: never;
@@ -1307,6 +1200,8 @@ export type CompanyProfileDto = components['schemas']['CompanyProfileDto'];
 export type GithubAccountDto = components['schemas']['GithubAccountDto'];
 export type GithubInstalledRepoDto = components['schemas']['GithubInstalledRepoDto'];
 export type GithubInstallationStatusDto = components['schemas']['GithubInstallationStatusDto'];
+export type GithubInstallUrlRequestDto = components['schemas']['GithubInstallUrlRequestDto'];
+export type GithubInstallUrlResponseDto = components['schemas']['GithubInstallUrlResponseDto'];
 export type AiReadinessDto = components['schemas']['AIReadinessDto'];
 export type AiMaturityResultDto = components['schemas']['AiMaturityResultDto'];
 export type TechCategoryDto = components['schemas']['TechCategoryDto'];
@@ -1336,17 +1231,6 @@ export type ProjectDto = components['schemas']['ProjectDto'];
 export type ProjectPatchDto = components['schemas']['ProjectPatchDto'];
 export type NotificationDto = components['schemas']['NotificationDto'];
 export type NotificationListDto = components['schemas']['NotificationListDto'];
-export type ReviewQueueItemDto = components['schemas']['ReviewQueueItemDto'];
-export type AdminDashboardDto = components['schemas']['AdminDashboardDto'];
-export type PatchAdminReviewBodyDto = components['schemas']['PatchAdminReviewBodyDto'];
-export type CommentDto = components['schemas']['CommentDto'];
-export type AdminCommentBodyDto = components['schemas']['AdminCommentBodyDto'];
-export type SectionDecisionBodyDto = components['schemas']['SectionDecisionBodyDto'];
-export type PricingLineDto = components['schemas']['PricingLineDto'];
-export type PricingUpdateBodyDto = components['schemas']['PricingUpdateBodyDto'];
-export type DeploymentPlanDto = components['schemas']['DeploymentPlanDto'];
-export type ReviewSectionDto = components['schemas']['ReviewSectionDto'];
-export type ReviewSubmissionDto = components['schemas']['ReviewSubmissionDto'];
 export type EffectiveTaskRowDto = components['schemas']['EffectiveTaskRowDto'];
 export type EffectivePhaseTasksBlockDto = components['schemas']['EffectivePhaseTasksBlockDto'];
 export type AiStrategyRecommendBodyDto = components['schemas']['AiStrategyRecommendBodyDto'];
@@ -1364,8 +1248,6 @@ export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
 export type ParameterRepoId = components['parameters']['RepoId'];
 export type ParameterProjectId = components['parameters']['ProjectId'];
-export type ParameterReviewId = components['parameters']['ReviewId'];
-export type ParameterSectionId = components['parameters']['SectionId'];
 export type ParameterNotificationId = components['parameters']['NotificationId'];
 export type $defs = Record<string, never>;
 export interface operations {
@@ -1763,6 +1645,18 @@ export interface operations {
                     "application/json": components["schemas"]["DashboardProductivityDto"];
                 };
             };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
             401: components["responses"]["Unauthorized"];
         };
     };
@@ -1793,129 +1687,75 @@ export interface operations {
                     "application/json": components["schemas"]["DashboardProductivityHistoryDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-        };
-    };
-    listAdminReviews: {
-        parameters: {
-            query?: {
-                status?: string;
-                priority?: string;
-                reviewer?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Queue and reviewer list */
-            200: {
+            /** @description Invalid query parameters */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AdminDashboardDto"];
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
                 };
             };
             401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
         };
     };
-    getAdminReview: {
+    getCompanyProfile: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                id: components["parameters"]["ReviewId"];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Review detail */
+            /** @description Company profile DTO, or JSON `null` when the workspace exists but no profile has been saved yet. Clients should treat `null` as the empty initial state (the wizard renders blank inputs); they MUST NOT treat the absence of a saved profile as a 404. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ReviewSubmissionDto"];
+                    "application/json": components["schemas"]["CompanyProfileDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-        };
-    };
-    patchAdminReview: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: components["parameters"]["ReviewId"];
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PatchAdminReviewBodyDto"];
-            };
-        };
-        responses: {
-            /** @description Updated review */
-            200: {
+            /** @description Malformed workspaceId */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ReviewSubmissionDto"];
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-        };
-    };
-    postAdminReviewComment: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: components["parameters"]["ReviewId"];
-                sectionId: components["parameters"]["SectionId"];
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AdminCommentBodyDto"];
-            };
-        };
-        responses: {
-            /** @description Created comment */
-            200: {
+            /** @description Workspace does not exist */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CommentDto"];
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
         };
     };
-    putAdminReviewSectionDecision: {
+    putCompanyProfile: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                id: components["parameters"]["ReviewId"];
-                sectionId: components["parameters"]["SectionId"];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SectionDecisionBodyDto"];
+                "application/json": components["schemas"]["CompanyProfileDto"];
             };
         };
         responses: {
@@ -1926,84 +1766,132 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Body fails validation (missing/invalid required field, bad enum, conditional rule) */
+            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"];
+                };
+            };
         };
     };
-    putAdminReviewPricing: {
+    getWorkspaceGithubInstallationStatus: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub. */
+                refresh?: boolean;
+            };
             header?: never;
             path: {
-                id: components["parameters"]["ReviewId"];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["PricingUpdateBodyDto"];
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description Saved */
-            204: {
+            /** @description Installation status */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["GithubInstallationStatusDto"];
+                };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
-    putAdminReviewDeployment: {
+    postGithubInstallUrl: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                id: components["parameters"]["ReviewId"];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["DeploymentPlanDto"];
+                "application/json": components["schemas"]["GithubInstallUrlRequestDto"];
             };
         };
         responses: {
-            /** @description Saved */
-            204: {
+            /** @description Installation URL + signed state */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["GithubInstallUrlResponseDto"];
+                };
+            };
+            /** @description Request validation failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
-    getCompanyProfile: {
+    getGithubInstallCallback: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
+            query: {
+                state: string;
+                installation_id: string;
+                setup_action?: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Company profile DTO, or JSON `null` when the workspace exists but no profile has been saved yet. Clients should treat `null` as the empty initial state (the wizard renders blank inputs); they MUST NOT treat the absence of a saved profile as a 404. */
-            200: {
+            /** @description Redirect to ThinkAI SPA return path with GitHub connection status */
+            302: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["CompanyProfileDto"];
-                };
+                content?: never;
             };
-            /** @description Malformed workspaceId */
-            400: {
+            /** @description Workspace store not configured */
+            501: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2011,10 +1899,8 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+            /** @description SPA origin configuration missing */
+            503: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2024,29 +1910,32 @@ export interface operations {
             };
         };
     };
-    putCompanyProfile: {
+    postGithubWebhook: {
         parameters: {
             query?: never;
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
+            header: {
+                "X-Hub-Signature-256": string;
+                "X-GitHub-Event": string;
             };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CompanyProfileDto"];
+                "application/json": {
+                    [key: string]: unknown;
+                };
             };
         };
         responses: {
-            /** @description Saved */
-            204: {
+            /** @description Webhook accepted */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Body fails validation (missing/invalid required field, bad enum, conditional rule) */
+            /** @description Invalid payload */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2055,10 +1944,8 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist */
-            404: {
+            /** @description Invalid webhook signature */
+            401: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2066,35 +1953,17 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-        };
-    };
-    getWorkspaceGithubInstallationStatus: {
-        parameters: {
-            query?: {
-                /** @description When true, bypass `tai_workspace_vcs_repos_cache` and re-fetch from GitHub. */
-                refresh?: boolean;
-            };
-            header?: never;
-            path: {
-                workspaceId: components["parameters"]["WorkspaceId"];
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Installation status */
-            200: {
+            /** @description Workspace store not configured */
+            501: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GithubInstallationStatusDto"];
+                    "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            401: components["responses"]["Unauthorized"];
-            403: components["responses"]["Forbidden"];
-            /** @description Workspace does not exist or malformed workspaceId */
-            404: {
+            /** @description Missing GitHub webhook secret or GitHub App configuration */
+            503: {
                 headers: {
                     [name: string]: unknown;
                 };