@thinkai/tai-api-contract 2.156.0 → 2.157.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.156.0
+  version: 2.157.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -9343,10 +9343,11 @@ paths:
       summary: Slack install URL for Message Center
       operationId: getSlackInstallUrl
       description: >
-        Workspace admin only. Returns the Slack OAuth authorize URL. State is stored
-        server-side and names this workspace and the signed-in admin. Editor or viewer
-        is `403` with `code` `workspace_admin_required`. Missing Slack app settings are
-        `503` with `code` `slack_not_configured`.
+        Workspace admin only. Returns the Slack OAuth authorize URL with
+        `incoming-webhook` scope. State is stored server-side and names this workspace
+        and the signed-in admin. Editor or viewer is `403` with `code`
+        `workspace_admin_required`. Missing Slack app settings are `503` with `code`
+        `slack_not_configured`.
       security:
         - bearerAuth: []
       parameters:
@@ -9393,10 +9394,11 @@ paths:
       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
+        and is single-use. Install requests `incoming-webhook` only. The encrypted
+        incoming-webhook URL and the channel Slack returns are stored 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.
+        page with `slack=error`. The webhook URL is never in the redirect.
       parameters:
         - name: code
           in: query
@@ -9431,8 +9433,10 @@ paths:
       summary: Slack connection status
       operationId: getSlackIntegration
       description: >
-        Any workspace member. `{ connected, channelName }`. `channelName` is null
-        until an admin saves a channel. The bot token is never returned.
+        Any workspace member. `{ connected, channelName }`. `connected` is true only
+        when a decryptable install webhook is stored. `channelName` is the channel
+        chosen on Slack's install screen (null when not connected). Secrets are
+        never returned.
       security:
         - bearerAuth: []
       parameters:
@@ -9459,8 +9463,8 @@ paths:
       summary: Disconnect Slack
       operationId: deleteSlackIntegration
       description: >
-        Workspace admin only. Removes the bot token and saved channel. Later
-        Message Center delivery does not post to Slack.
+        Workspace admin only. Removes the install webhook, optional bot token, and
+        saved channel. Later Message Center delivery does not post to Slack.
       security:
         - bearerAuth: []
       parameters:
@@ -9489,13 +9493,15 @@ paths:
   /workspaces/{workspaceId}/integrations/slack/channel:
     put:
       tags: [Integrations]
-      summary: Save the Slack channel for Message Center
+      summary: Change Slack channel (requires reinstall)
       operationId: putSlackChannel
       description: >
-        Workspace admin only. Body `{ channelId }`. Slack must already be connected.
-        The response is the same status object as `getSlackIntegration`, with the
-        channel name Slack returned. Unknown or malformed `channelId` is `400`
-        `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
+        Workspace admin only. Body `{ channelId }`. The notification channel is
+        chosen on Slack's install screen with the incoming webhook; this route does
+        not rewrite channel metadata. When Slack is connected, the API returns `409`
+        with `code` `slack_channel_reinstall_required` — reconnect via
+        `getSlackInstallUrl` to pick a different channel. Malformed `channelId` is
+        `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
       security:
         - bearerAuth: []
       parameters:
@@ -9508,19 +9514,21 @@ paths:
               $ref: "#/components/schemas/SlackChannelBodyDto"
       responses:
         "200":
-          description: Channel saved
+          description: >
+            Not returned. The channel is chosen on Slack's install screen; when
+            connected the API responds with `409` `slack_channel_reinstall_required`.
           content:
             application/json:
               schema:
                 $ref: "#/components/schemas/SlackIntegrationStatusDto"
         "400":
-          description: channelId is missing, malformed, or unknown to Slack
+          description: channelId is missing or malformed
           content:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
               example:
-                error: Slack channel was not found
+                error: channelId is required
                 code: invalid_slack_channel
         "401":
           $ref: "#/components/responses/Unauthorized"
@@ -9540,23 +9548,22 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
         "409":
-          description: Slack is not connected
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ErrorMessageDto"
-              example:
-                error: Slack is not connected
-                code: slack_not_connected
-        "502":
-          description: Slack rejected the lookup
+          description: >
+            Slack is not connected (`slack_not_connected`), or the channel cannot be
+            changed without a new install (`slack_channel_reinstall_required`).
           content:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
-              example:
-                error: Slack did not accept the channel
-                code: slack_request_failed
+              examples:
+                notConnected:
+                  value:
+                    error: Slack is not connected
+                    code: slack_not_connected
+                reinstallRequired:
+                  value:
+                    error: Reconnect Slack to change the notification channel
+                    code: slack_channel_reinstall_required
 
   /workspaces/{workspaceId}/notification-preferences:
     get:
@@ -19646,7 +19653,8 @@ components:
       properties:
         url:
           type: string
-          description: Slack OAuth authorize URL. The bot token is not included.
+          description: >
+            Slack OAuth authorize URL (`incoming-webhook` scope). Secrets are not included.
 
     SlackIntegrationStatusDto:
       type: object
@@ -19655,10 +19663,13 @@ components:
       properties:
         connected:
           type: boolean
+          description: >
+            True only when a decryptable install webhook URL is stored for this workspace.
         channelName:
           type: string
           nullable: true
-          description: Saved channel name. Null until an admin saves a channel, and when disconnected.
+          description: >
+            Channel name returned by Slack at install time. Null when not connected.
 
     SlackChannelBodyDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.156.0",
+  "version": "2.157.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -3774,7 +3774,7 @@ export interface paths {
         };
         /**
          * Slack install URL for Message Center
-         * @description Workspace admin only. Returns the Slack OAuth authorize URL. State is stored server-side and names this workspace and the signed-in admin. Editor or viewer is `403` with `code` `workspace_admin_required`. Missing Slack app settings are `503` with `code` `slack_not_configured`.
+         * @description Workspace admin only. Returns the Slack OAuth authorize URL with `incoming-webhook` scope. State is stored server-side and names this workspace and the signed-in admin. Editor or viewer is `403` with `code` `workspace_admin_required`. Missing Slack app settings are `503` with `code` `slack_not_configured`.
          */
         get: operations["getSlackInstallUrl"];
         put?: never;
@@ -3794,7 +3794,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}/workspace/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. Install requests `incoming-webhook` only. The encrypted incoming-webhook URL and the channel Slack returns are stored 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 webhook URL is never in the redirect.
          */
         get: operations["getSlackOauthCallback"];
         put?: never;
@@ -3814,14 +3814,14 @@ export interface paths {
         };
         /**
          * Slack connection status
-         * @description Any workspace member. `{ connected, channelName }`. `channelName` is null until an admin saves a channel. The bot token is never returned.
+         * @description Any workspace member. `{ connected, channelName }`. `connected` is true only when a decryptable install webhook is stored. `channelName` is the channel chosen on Slack's install screen (null when not connected). Secrets are never returned.
          */
         get: operations["getSlackIntegration"];
         put?: never;
         post?: never;
         /**
          * Disconnect Slack
-         * @description Workspace admin only. Removes the bot token and saved channel. Later Message Center delivery does not post to Slack.
+         * @description Workspace admin only. Removes the install webhook, optional bot token, and saved channel. Later Message Center delivery does not post to Slack.
          */
         delete: operations["deleteSlackIntegration"];
         options?: never;
@@ -3838,8 +3838,8 @@ export interface paths {
         };
         get?: never;
         /**
-         * Save the Slack channel for Message Center
-         * @description Workspace admin only. Body `{ channelId }`. Slack must already be connected. The response is the same status object as `getSlackIntegration`, with the channel name Slack returned. Unknown or malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
+         * Change Slack channel (requires reinstall)
+         * @description Workspace admin only. Body `{ channelId }`. The notification channel is chosen on Slack's install screen with the incoming webhook; this route does not rewrite channel metadata. When Slack is connected, the API returns `409` with `code` `slack_channel_reinstall_required` — reconnect via `getSlackInstallUrl` to pick a different channel. Malformed `channelId` is `400` `invalid_slack_channel`. Not connected is `409` `slack_not_connected`.
          */
         put: operations["putSlackChannel"];
         post?: never;
@@ -8354,12 +8354,13 @@ export interface components {
             teams: components["schemas"]["NotificationChatChannelsDto"];
         };
         SlackInstallUrlDto: {
-            /** @description Slack OAuth authorize URL. The bot token is not included. */
+            /** @description Slack OAuth authorize URL (`incoming-webhook` scope). Secrets are not included. */
             url: string;
         };
         SlackIntegrationStatusDto: {
+            /** @description True only when a decryptable install webhook URL is stored for this workspace. */
             connected: boolean;
-            /** @description Saved channel name. Null until an admin saves a channel, and when disconnected. */
+            /** @description Channel name returned by Slack at install time. Null when not connected. */
             channelName: string | null;
         };
         SlackChannelBodyDto: {
@@ -21397,7 +21398,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Channel saved */
+            /** @description Not returned. The channel is chosen on Slack's install screen; when connected the API responds with `409` `slack_channel_reinstall_required`. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -21406,7 +21407,7 @@ export interface operations {
                     "application/json": components["schemas"]["SlackIntegrationStatusDto"];
                 };
             };
-            /** @description channelId is missing, malformed, or unknown to Slack */
+            /** @description channelId is missing or malformed */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -21414,7 +21415,7 @@ export interface operations {
                 content: {
                     /**
                      * @example {
-                     *       "error": "Slack channel was not found",
+                     *       "error": "channelId is required",
                      *       "code": "invalid_slack_channel"
                      *     }
                      */
@@ -21446,33 +21447,12 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Slack is not connected */
+            /** @description Slack is not connected (`slack_not_connected`), or the channel cannot be changed without a new install (`slack_channel_reinstall_required`). */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    /**
-                     * @example {
-                     *       "error": "Slack is not connected",
-                     *       "code": "slack_not_connected"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["ErrorMessageDto"];
-                };
-            };
-            /** @description Slack rejected the lookup */
-            502: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "Slack did not accept the channel",
-                     *       "code": "slack_request_failed"
-                     *     }
-                     */
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };