@thinkai/tai-api-contract 2.56.0 → 2.57.0

package/dist/generated/openapi.d.ts

@@ -216,6 +216,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/platform/banner": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Global platform banner
+         * @description Returns the active global outage or maintenance banner for the platform shell, if any. No authentication required so signed-in users can see incident messaging during partial outages. When both a database-managed banner and a runtime-config fallback exist, the database value wins.
+         */
+        get: operations["getPlatformBanner"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin/platform/banner": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read stored and effective global platform banner
+         * @description Platform admins only. Returns the database-stored banner (`stored`) for editing and the merged banner users see (`effective`, DB wins over runtime-config fallback). Requires Bearer JWT from an email on `PLATFORM_ADMIN_EMAILS`.
+         */
+        get: operations["adminGetPlatformBanner"];
+        /**
+         * Set or clear global platform banner
+         * @description Platform admins may activate, update, or clear (`banner: null`) the global outage/maintenance banner shown in the authenticated SPA shell. Requires Bearer JWT from an email on `PLATFORM_ADMIN_EMAILS`.
+         */
+        put: operations["adminUpsertPlatformBanner"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/me": {
         parameters: {
             query?: never;
@@ -4995,6 +5039,40 @@ export interface components {
             /** Format: date-time */
             createdAt?: string;
         };
+        PlatformBannerDto: {
+            /** @description Stable identifier used for dismiss persistence in the SPA. */
+            id: string;
+            /** @enum {string} */
+            kind: "maintenance" | "outage" | "info";
+            title: string;
+            message: string;
+            dismissible: boolean;
+            /** @description Optional link to the public status page (status.aidrivensdlc.com). */
+            statusPageUrl?: string;
+            /**
+             * Format: date-time
+             * @description When set, the banner is hidden before this instant (UTC).
+             */
+            startsAt?: string;
+            /**
+             * Format: date-time
+             * @description When set, the banner is hidden after this instant (UTC).
+             */
+            endsAt?: string;
+        };
+        PlatformBannerViewDto: {
+            banner: components["schemas"]["PlatformBannerDto"] | null;
+        };
+        PlatformBannerUpsertDto: {
+            /** @description Pass null to clear the active database-managed banner. */
+            banner: components["schemas"]["PlatformBannerDto"] | null;
+        };
+        PlatformAdminBannerDto: {
+            /** @description Banner persisted in the database (editable via PUT). */
+            stored: components["schemas"]["PlatformBannerDto"] | null;
+            /** @description Merged banner shown in the SPA (stored wins over runtime-config fallback). */
+            effective: components["schemas"]["PlatformBannerViewDto"];
+        };
         NotificationDto: {
             id: string;
             /** @enum {string} */
@@ -5832,6 +5910,10 @@ export type SquadDto = components['schemas']['SquadDto'];
 export type WorkflowDto = components['schemas']['WorkflowDto'];
 export type ProjectDto = components['schemas']['ProjectDto'];
 export type ProjectPatchDto = components['schemas']['ProjectPatchDto'];
+export type PlatformBannerDto = components['schemas']['PlatformBannerDto'];
+export type PlatformBannerViewDto = components['schemas']['PlatformBannerViewDto'];
+export type PlatformBannerUpsertDto = components['schemas']['PlatformBannerUpsertDto'];
+export type PlatformAdminBannerDto = components['schemas']['PlatformAdminBannerDto'];
 export type NotificationDto = components['schemas']['NotificationDto'];
 export type NotificationListDto = components['schemas']['NotificationListDto'];
 export type NotificationUnreadCountDto = components['schemas']['NotificationUnreadCountDto'];
@@ -6578,6 +6660,123 @@ export interface operations {
             };
         };
     };
+    getPlatformBanner: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Active platform banner (if any) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlatformBannerViewDto"];
+                };
+            };
+        };
+    };
+    adminGetPlatformBanner: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Admin platform banner view */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlatformAdminBannerDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not a platform admin. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Platform banner persistence unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    adminUpsertPlatformBanner: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PlatformBannerUpsertDto"];
+            };
+        };
+        responses: {
+            /** @description Updated platform banner */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlatformBannerViewDto"];
+                };
+            };
+            /** @description Invalid banner payload */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not a platform admin. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "forbidden"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Platform banner persistence unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getMe: {
         parameters: {
             query?: never;