@thinkai/tai-api-contract 2.150.0 → 2.151.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.150.0
+  version: 2.151.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -10249,6 +10249,239 @@ paths:
         "403":
           $ref: "#/components/responses/Forbidden"
 
+  /workspaces/{workspaceId}/integrations/teams/install-url:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Microsoft sign-in URL for Teams notification delivery
+      operationId: getWorkspaceTeamsInstallUrl
+      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`.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Authorize URL
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsInstallUrlDto"
+              example:
+                url: "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=example&state=example-state"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+        "503":
+          description: Teams app credentials are not configured
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams sign-in is not configured
+                code: teams_not_configured
+
+  /integrations/teams/callback:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Finish Teams Microsoft sign-in
+      operationId: getTeamsIntegrationCallback
+      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`.
+      security: []
+      parameters:
+        - name: code
+          in: query
+          schema:
+            type: string
+        - name: state
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: error
+          in: query
+          schema:
+            type: string
+      responses:
+        "302":
+          description: Redirect to Settings → Preferences
+          headers:
+            Location:
+              schema:
+                type: string
+                example: "https://app.example.com/settings?tab=preferences&chat=teams"
+        "503":
+          description: SPA origin is not configured
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/integrations/teams:
+    get:
+      tags: [Integrations, Notifications]
+      summary: Teams connection status
+      operationId: getWorkspaceTeamsConnection
+      description: >
+        Any workspace member. `{ connected, channelName }`. Never returns the bot token.
+        `channelName` is null until an admin saves a channel.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "200":
+          description: Connection status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsConnectionDto"
+              example:
+                connected: true
+                channelName: General
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+    delete:
+      tags: [Integrations, Notifications]
+      summary: Disconnect Teams
+      operationId: deleteWorkspaceTeamsConnection
+      description: >
+        Workspace **admin** only. Later Message Center posts do not go to Teams.
+        Member chat cells stay unchanged.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      responses:
+        "204":
+          description: Disconnected
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+
+  /workspaces/{workspaceId}/integrations/teams/channel:
+    put:
+      tags: [Integrations, Notifications]
+      summary: Save the Teams channel for notification posts
+      operationId: putWorkspaceTeamsChannel
+      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`.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TeamsChannelBodyDto"
+            example:
+              channelId: "19:example@thread.tacv2"
+      responses:
+        "200":
+          description: Channel saved
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TeamsConnectionDto"
+              example:
+                connected: true
+                channelName: General
+        "400":
+          description: Missing channelId, or the channel was not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              examples:
+                invalid:
+                  value:
+                    error: channelId is required
+                    code: invalid_input
+                missing:
+                  value:
+                    error: Teams channel was not found
+                    code: teams_channel_not_found
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Editor or viewer
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: workspace_admin_required
+        "404":
+          description: Workspace not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Not found
+        "409":
+          description: Teams is not connected
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams is not connected
+                code: teams_not_connected
+        "502":
+          description: Microsoft Graph rejected the channel lookup
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Teams channel lookup failed
+                code: teams_graph_failed
+
   /workspaces/{workspaceId}/integrations/zelt/authorize-url:
     post:
       tags: [HRIS, Integrations]
@@ -11261,6 +11494,35 @@ components:
             error: zenhr_sync_in_progress
 
   schemas:
+    TeamsInstallUrlDto:
+      type: object
+      required: [url]
+      properties:
+        url:
+          type: string
+          format: uri
+
+    TeamsConnectionDto:
+      type: object
+      required: [connected, channelName]
+      properties:
+        connected:
+          type: boolean
+          description: True after an admin completes Microsoft sign-in.
+        channelName:
+          type: string
+          nullable: true
+          description: Selected channel display name. Null until an admin saves a channel.
+
+    TeamsChannelBodyDto:
+      type: object
+      required: [channelId]
+      properties:
+        channelId:
+          type: string
+          minLength: 1
+          maxLength: 256
+
     ErrorMessageDto:
       type: object
       required: [error]

package/package.json

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