@thinkai/tai-api-contract 2.150.0 → 2.152.0

package/dist/generated/openapi.d.ts

@@ -3715,7 +3715,7 @@ export interface paths {
         put?: never;
         /**
          * Apply a Message Center email unsubscribe (public)
-         * @description **Unauthenticated.** Sets that category's email cell to `off` when the category allows off. A status token leaves status email unchanged. Redirects `303` to `{spa}/settings?tab=preferences`. An unknown or expired token is `400` HTML and does not change preferences.
+         * @description **Unauthenticated.** Sets that category's email cell to `off` when the category allows off. A status token leaves status email unchanged. Redirects `303` to `{spa}/workspace/preferences`. An unknown or expired token is `400` HTML and does not change preferences.
          */
         post: operations["postNotificationEmailUnsubscribe"];
         delete?: never;
@@ -3753,7 +3753,7 @@ export interface paths {
         };
         /**
          * Slack OAuth callback
-         * @description Browser return from Slack. The provider redirect does not include the API bearer token. `state` was issued by `getSlackInstallUrl` to a signed-in admin and is single-use. The bot token is stored encrypted only when that user is still a workspace admin. Success redirects to `{spa}/settings?tab=preferences&chat=slack`. Failures redirect to the same page with `slack=error`. The token is never in the redirect.
+         * @description Browser return from Slack. The provider redirect does not include the API bearer token. `state` was issued by `getSlackInstallUrl` to a signed-in admin and is single-use. The bot token is stored encrypted only when that user is still a workspace admin. Success redirects to `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same page with `slack=error`. The token is never in the redirect.
          */
         get: operations["getSlackOauthCallback"];
         put?: never;
@@ -3808,6 +3808,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/notification-preferences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Member notification preferences for this workspace
+         * @description In-app Message Center switches and email, Slack, and Teams cells for the current member in this workspace. Missing stored values use the same defaults as account preferences (`email.status` is `digest`; other channel cells are `off`).
+         */
+        get: operations["getWorkspaceNotificationPreferences"];
+        /**
+         * Save member notification preferences for this workspace
+         * @description Replaces the in-app switches. `notificationChannels` may be omitted to keep stored cells. `email.status` = `off` is `400` `notification_channel_required`. Account `PUT /me/preferences` no longer changes the inbox or delivery.
+         */
+        put: operations["putWorkspaceNotificationPreferences"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/notifications": {
         parameters: {
             query?: never;
@@ -3848,6 +3872,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/notifications/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark selected notifications read
+         * @description Marks only the given ids read for the current member in this workspace. Ids that are missing or belong to someone else are ignored. `ids` is 1 to 100 uuids.
+         */
+        post: operations["postNotificationsRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/notifications/{id}/read": {
         parameters: {
             query?: never;
@@ -4206,6 +4250,90 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/teams/install-url": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Microsoft sign-in URL for Teams notification delivery
+         * @description Workspace **admin** only. Returns the Microsoft authorize URL. State carries the workspace and the signed-in admin. Editor or viewer is `403` `workspace_admin_required`.
+         */
+        get: operations["getWorkspaceTeamsInstallUrl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/integrations/teams/callback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Finish Teams Microsoft sign-in
+         * @description Public redirect target. The one-time state was minted by a signed-in admin and still requires that user to be a workspace admin. Stores the bot token encrypted and redirects to `{spa}/workspace/preferences?chat=teams`.
+         */
+        get: operations["getTeamsIntegrationCallback"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Teams connection status
+         * @description Any workspace member. `{ connected, channelName }`. Never returns the bot token. `channelName` is null until an admin saves a channel.
+         */
+        get: operations["getWorkspaceTeamsConnection"];
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect Teams
+         * @description Workspace **admin** only. Later Message Center posts do not go to Teams. Member chat cells stay unchanged.
+         */
+        delete: operations["deleteWorkspaceTeamsConnection"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/teams/channel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Save the Teams channel for notification posts
+         * @description Workspace **admin** only. Body `{ channelId }`. The channel must be visible to the connected Microsoft account. Until a channel is saved, channel-mode delivery is skipped with `chat_channel_unset`.
+         */
+        put: operations["putWorkspaceTeamsChannel"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/integrations/zelt/authorize-url": {
         parameters: {
             query?: never;
@@ -4470,6 +4598,19 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        TeamsInstallUrlDto: {
+            /** Format: uri */
+            url: string;
+        };
+        TeamsConnectionDto: {
+            /** @description True after an admin completes Microsoft sign-in. */
+            connected: boolean;
+            /** @description Selected channel display name. Null until an admin saves a channel. */
+            channelName: string | null;
+        };
+        TeamsChannelBodyDto: {
+            channelId: string;
+        };
         ErrorMessageDto: {
             error: string;
             /** @description Machine-readable error code when present (for example `last_admin`). */
@@ -8119,6 +8260,19 @@ export interface components {
             activity: components["schemas"]["NotificationChatDeliveryMode"];
             system: components["schemas"]["NotificationChatDeliveryMode"];
         };
+        /** @description Message Center switches and delivery cells for one member in one workspace. */
+        WorkspaceNotificationPreferencesDto: {
+            notifications: components["schemas"]["NotificationPreferencesDto"];
+            notificationChannels: components["schemas"]["NotificationChannelsDto"];
+        };
+        /** @description Body for `PUT /workspaces/{workspaceId}/notification-preferences`. Omit `notificationChannels` to keep stored cells. */
+        PutWorkspaceNotificationPreferencesBodyDto: {
+            notifications: components["schemas"]["NotificationPreferencesDto"];
+            notificationChannels?: components["schemas"]["PutNotificationChannelsDto"];
+        };
+        NotificationReadIdsBodyDto: {
+            ids: string[];
+        };
         /** @description Delivery cells beside the in-app Message Center switches. Defaults: `email.status` is `digest`; every other cell is `off`. Inbox rows whose type is `integration` use the `status` cell. */
         NotificationChannelsDto: {
             email: components["schemas"]["NotificationEmailChannelsDto"];
@@ -10603,6 +10757,9 @@ export interface components {
     headers: never;
     pathItems: never;
 }
+export type TeamsInstallUrlDto = components['schemas']['TeamsInstallUrlDto'];
+export type TeamsConnectionDto = components['schemas']['TeamsConnectionDto'];
+export type TeamsChannelBodyDto = components['schemas']['TeamsChannelBodyDto'];
 export type ErrorMessageDto = components['schemas']['ErrorMessageDto'];
 export type TeamMemberDto = components['schemas']['TeamMemberDto'];
 export type TeamMemberListDto = components['schemas']['TeamMemberListDto'];
@@ -10925,6 +11082,9 @@ export type NotificationEmailDeliveryMode = components['schemas']['NotificationE
 export type NotificationChatDeliveryMode = components['schemas']['NotificationChatDeliveryMode'];
 export type NotificationEmailChannelsDto = components['schemas']['NotificationEmailChannelsDto'];
 export type NotificationChatChannelsDto = components['schemas']['NotificationChatChannelsDto'];
+export type WorkspaceNotificationPreferencesDto = components['schemas']['WorkspaceNotificationPreferencesDto'];
+export type PutWorkspaceNotificationPreferencesBodyDto = components['schemas']['PutWorkspaceNotificationPreferencesBodyDto'];
+export type NotificationReadIdsBodyDto = components['schemas']['NotificationReadIdsBodyDto'];
 export type NotificationChannelsDto = components['schemas']['NotificationChannelsDto'];
 export type SlackInstallUrlDto = components['schemas']['SlackInstallUrlDto'];
 export type SlackIntegrationStatusDto = components['schemas']['SlackIntegrationStatusDto'];
@@ -20857,7 +21017,7 @@ export interface operations {
             /** @description Preference updated, or left unchanged for status email. */
             303: {
                 headers: {
-                    /** @description `{spa}/settings?tab=preferences` */
+                    /** @description `{spa}/workspace/preferences` */
                     Location?: string;
                     [name: string]: unknown;
                 };
@@ -21142,6 +21302,71 @@ export interface operations {
             };
         };
     };
+    getWorkspaceNotificationPreferences: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Preferences for this member in this workspace */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceNotificationPreferencesDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    putWorkspaceNotificationPreferences: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutWorkspaceNotificationPreferencesBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Saved preferences */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceNotificationPreferencesDto"];
+                };
+            };
+            /** @description Invalid body, or status email set to off */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Status email cannot be turned off",
+                     *       "code": "notification_channel_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     listNotifications: {
         parameters: {
             query?: {
@@ -21204,6 +21429,40 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    postNotificationsRead: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["NotificationReadIdsBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid ids */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     postNotificationRead: {
         parameters: {
             query?: never;
@@ -21976,6 +22235,310 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getWorkspaceTeamsInstallUrl: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Authorize URL */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "url": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=example&state=example-state"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["TeamsInstallUrlDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Teams app credentials are not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams sign-in is not configured",
+                     *       "code": "teams_not_configured"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getTeamsIntegrationCallback: {
+        parameters: {
+            query: {
+                code?: string;
+                state: string;
+                error?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Redirect to Settings → Preferences */
+            302: {
+                headers: {
+                    Location?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description SPA origin is not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getWorkspaceTeamsConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Connection status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "connected": true,
+                     *       "channelName": "General"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["TeamsConnectionDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    deleteWorkspaceTeamsConnection: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Disconnected */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putWorkspaceTeamsChannel: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "channelId": "19:example@thread.tacv2"
+                 *     }
+                 */
+                "application/json": components["schemas"]["TeamsChannelBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Channel saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "connected": true,
+                     *       "channelName": "General"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["TeamsConnectionDto"];
+                };
+            };
+            /** @description Missing channelId, or the channel was not found */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Editor or viewer */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Forbidden",
+                     *       "code": "workspace_admin_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Not found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Teams is not connected */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams is not connected",
+                     *       "code": "teams_not_connected"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Microsoft Graph rejected the channel lookup */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Teams channel lookup failed",
+                     *       "code": "teams_graph_failed"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postWorkspaceZeltAuthorizeUrl: {
         parameters: {
             query?: never;