@thinkai/tai-api-contract 2.151.0 → 2.153.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.151.0
+  version: 2.153.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -9236,7 +9236,7 @@ paths:
       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
+        `{spa}/workspace/preferences`. An unknown or expired token is `400` HTML and
         does not change preferences.
       operationId: postNotificationEmailUnsubscribe
       security: []
@@ -9252,7 +9252,7 @@ paths:
           description: Preference updated, or left unchanged for status email.
           headers:
             Location:
-              description: "`{spa}/settings?tab=preferences`"
+              description: "`{spa}/workspace/preferences`"
               schema:
                 type: string
         "400":
@@ -9326,7 +9326,7 @@ paths:
         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
+        `{spa}/workspace/preferences?chat=slack`. Failures redirect to the same
         page with `slack=error`. The token is never in the redirect.
       parameters:
         - name: code
@@ -9489,6 +9489,61 @@ paths:
                 error: Slack did not accept the channel
                 code: slack_request_failed
 
+  /workspaces/{workspaceId}/notification-preferences:
+    get:
+      tags: [Notifications]
+      summary: 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`).
+      operationId: getWorkspaceNotificationPreferences
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Preferences for this member in this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceNotificationPreferencesDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    put:
+      tags: [Notifications]
+      summary: 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.
+      operationId: putWorkspaceNotificationPreferences
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PutWorkspaceNotificationPreferencesBodyDto"
+      responses:
+        "200":
+          description: Saved preferences
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WorkspaceNotificationPreferencesDto"
+        "400":
+          description: Invalid body, or status email set to off
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Status email cannot be turned off
+                code: notification_channel_required
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
   /workspaces/{workspaceId}/notifications:
     get:
       tags: [Notifications]
@@ -9566,6 +9621,35 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/notifications/read:
+    post:
+      tags: [Notifications]
+      summary: 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.
+      operationId: postNotificationsRead
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/NotificationReadIdsBodyDto"
+      responses:
+        "204":
+          description: Updated
+        "400":
+          description: Invalid ids
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
   /workspaces/{workspaceId}/notifications/{id}/read:
     post:
       tags: [Notifications]
@@ -9580,6 +9664,27 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/notifications/{id}/unread:
+    post:
+      tags: [Notifications]
+      summary: Mark notification unread
+      description: Clears read state for the current member's row. Does not follow a route.
+      operationId: postNotificationUnread
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - $ref: "#/components/parameters/NotificationId"
+      responses:
+        "204":
+          description: Updated
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Notification was not found for this member
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/notifications/read-all:
     post:
       tags: [Notifications]
@@ -10305,7 +10410,7 @@ paths:
       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}/settings?tab=preferences&chat=teams`.
+        and redirects to `{spa}/workspace/preferences?chat=teams`.
       security: []
       parameters:
         - name: code
@@ -10328,7 +10433,7 @@ paths:
             Location:
               schema:
                 type: string
-                example: "https://app.example.com/settings?tab=preferences&chat=teams"
+                example: "https://app.example.com/workspace/preferences?chat=teams"
         "503":
           description: SPA origin is not configured
           content:
@@ -19369,6 +19474,44 @@ components:
         system:
           $ref: "#/components/schemas/NotificationChatDeliveryMode"
 
+    WorkspaceNotificationPreferencesDto:
+      type: object
+      additionalProperties: false
+      required: [notifications, notificationChannels]
+      description: >
+        Message Center switches and delivery cells for one member in one workspace.
+      properties:
+        notifications:
+          $ref: "#/components/schemas/NotificationPreferencesDto"
+        notificationChannels:
+          $ref: "#/components/schemas/NotificationChannelsDto"
+
+    PutWorkspaceNotificationPreferencesBodyDto:
+      type: object
+      additionalProperties: false
+      required: [notifications]
+      description: >
+        Body for `PUT /workspaces/{workspaceId}/notification-preferences`.
+        Omit `notificationChannels` to keep stored cells.
+      properties:
+        notifications:
+          $ref: "#/components/schemas/NotificationPreferencesDto"
+        notificationChannels:
+          $ref: "#/components/schemas/PutNotificationChannelsDto"
+
+    NotificationReadIdsBodyDto:
+      type: object
+      additionalProperties: false
+      required: [ids]
+      properties:
+        ids:
+          type: array
+          minItems: 1
+          maxItems: 100
+          items:
+            type: string
+            format: uuid
+
     NotificationChannelsDto:
       type: object
       additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.151.0",
+  "version": "2.153.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -19,9 +19,9 @@
     }
   },
   "devDependencies": {
-    "@stoplight/spectral-cli": "^6.16.3",
-    "@types/node": "^26.6.3",
-    "jsonpath-plus": "^11.1.0",
+    "@stoplight/spectral-cli": "^6.17.0",
+    "@types/node": "^26.6.4",
+    "jsonpath-plus": "^11.1.1",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"
   },

package/src/generated/openapi.ts

@@ -3716,7 +3716,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;
@@ -3754,7 +3754,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;
@@ -3809,6 +3809,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;
@@ -3849,6 +3873,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;
@@ -3866,6 +3910,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/notifications/{id}/unread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark notification unread
+         * @description Clears read state for the current member's row. Does not follow a route.
+         */
+        post: operations["postNotificationUnread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/notifications/read-all": {
         parameters: {
             query?: never;
@@ -4236,7 +4300,7 @@ export interface paths {
         };
         /**
          * 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}/settings?tab=preferences&chat=teams`.
+         * @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;
@@ -8217,6 +8281,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"];
@@ -11026,6 +11103,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'];
@@ -20958,7 +21038,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;
                 };
@@ -21243,6 +21323,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?: {
@@ -21305,6 +21450,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;
@@ -21327,6 +21506,37 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    postNotificationUnread: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                id: components["parameters"]["NotificationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Updated */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Notification was not found for this member */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postNotificationsReadAll: {
         parameters: {
             query?: never;