@thinkai/tai-api-contract 2.193.0 → 2.195.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.193.0
+  version: 2.195.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -34,8 +34,6 @@ tags:
     description: NDA flows (§4, §14 storagePath)
   - name: RepositoryReadiness
     description: Repository readiness (§5)
-  - name: SquadProjects
-    description: Squad and projects (§6)
   - name: Notifications
     description: Notifications (§7)
   - name: AIStrategy
@@ -1759,6 +1757,59 @@ paths:
               schema:
                 $ref: "#/components/schemas/PlatformBannerViewDto"
 
+  /admin/jobs-session:
+    post:
+      tags: [PlatformAdmin]
+      summary: Mint HttpOnly cookie for /admin/jobs dashboard access
+      operationId: adminCreateJobsSession
+      description: >
+        Platform admins only. Copies the caller's Bearer JWT into an HttpOnly
+        `tai_admin_jobs` cookie (`Path=/admin/`, `SameSite=Lax`, `Secure` when HTTPS/prod,
+        `Max-Age` 1 hour) so browser navigations and admin-SPA iframes can authenticate to
+        `/admin/jobs*` without an `Authorization` header on every request.
+
+        Requires a Bearer JWT from an email on `PLATFORM_ADMIN_EMAILS`. The cookie is only
+        accepted as a Bearer substitute on `/admin/jobs*` paths by the API auth preHandler.
+        The mounted `@pg-boss/dashboard` HTML surface is not part of this contract.
+      responses:
+        "204":
+          description: "Session cookie set (Set-Cookie with tai_admin_jobs)."
+          headers:
+            Set-Cookie:
+              schema:
+                type: string
+              description: >
+                HttpOnly jobs session cookie with the caller's JWT value,
+                Path=/admin/, SameSite=Lax, Max-Age=3600, Secure when applicable.
+        "401":
+          description: Missing or non-Bearer Authorization (no JWT to put in the cookie).
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Unauthorized
+                code: unauthorized
+        "403":
+          description: Caller is not a platform admin.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Forbidden
+                code: forbidden
+        "503":
+          description: >
+            Jobs dashboard unavailable (`JOBS_PG_BOSS_ENABLED=false` or readiness DB URL missing).
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Jobs dashboard unavailable
+                code: jobs_dashboard_unavailable
+
   /admin/platform/banner:
     get:
       tags: [PlatformAdmin]
@@ -10195,104 +10246,6 @@ paths:
         "403":
           $ref: "#/components/responses/Forbidden"
 
-  /workspaces/{workspaceId}/squad:
-    get:
-      tags: [SquadProjects]
-      summary: Get squad configuration
-      operationId: getSquad
-      parameters:
-        - $ref: "#/components/parameters/WorkspaceId"
-      responses:
-        "200":
-          description: Squad
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/SquadDto"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-    put:
-      tags: [SquadProjects]
-      summary: Upsert squad
-      operationId: putSquad
-      parameters:
-        - $ref: "#/components/parameters/WorkspaceId"
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/SquadDto"
-      responses:
-        "204":
-          description: Saved
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-
-  /workspaces/{workspaceId}/projects:
-    get:
-      tags: [SquadProjects]
-      summary: List projects
-      operationId: listProjects
-      parameters:
-        - $ref: "#/components/parameters/WorkspaceId"
-      responses:
-        "200":
-          description: Projects
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/ProjectDto"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-    post:
-      tags: [SquadProjects]
-      summary: Create project
-      operationId: createProject
-      parameters:
-        - $ref: "#/components/parameters/WorkspaceId"
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/ProjectDto"
-      responses:
-        "200":
-          description: Created project
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProjectDto"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-
-  /workspaces/{workspaceId}/projects/{projectId}:
-    patch:
-      tags: [SquadProjects]
-      summary: Update project
-      operationId: patchProject
-      parameters:
-        - $ref: "#/components/parameters/WorkspaceId"
-        - $ref: "#/components/parameters/ProjectId"
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/ProjectPatchDto"
-      responses:
-        "200":
-          description: Updated project
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProjectDto"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-
   /workspaces/{workspaceId}/code-chat/indexes:
     get:
       tags: [CodeChat]
@@ -14347,12 +14300,6 @@ components:
         maxLength: 512
         pattern: "^[^/]+/[^/]+$"
         example: thinkai-llc/thinkai-platform-backend
-    ProjectId:
-      name: projectId
-      in: path
-      required: true
-      schema:
-        type: string
     NotificationId:
       name: id
       in: path
@@ -23436,141 +23383,6 @@ components:
         branchName:
           type: string
 
-    PhaseRoleDto:
-      type: object
-      required: [phase, assignment]
-      properties:
-        phase:
-          type: string
-        assignment:
-          type: string
-          enum: [orchestrate, review, both, none]
-
-    SquadMemberDto:
-      type: object
-      required: [id, role, roleLabel, description, count, phases]
-      properties:
-        id:
-          type: string
-        role:
-          type: string
-        roleLabel:
-          type: string
-        name:
-          type: string
-        description:
-          type: string
-        count:
-          type: integer
-        phases:
-          type: array
-          items:
-            $ref: "#/components/schemas/PhaseRoleDto"
-        custom:
-          type: boolean
-
-    CustomWorkStreamTaskDto:
-      type: object
-      required: [id, name, summary]
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        summary:
-          type: string
-
-    PhaseWorkStreamConfigDto:
-      type: object
-      properties:
-        deselectedCatalogIds:
-          type: array
-          items:
-            type: string
-        customTasks:
-          type: array
-          items:
-            $ref: "#/components/schemas/CustomWorkStreamTaskDto"
-
-    SquadDto:
-      type: object
-      required: [members, hrConnected]
-      properties:
-        members:
-          type: array
-          items:
-            $ref: "#/components/schemas/SquadMemberDto"
-        hrConnected:
-          type: boolean
-        selectedPhases:
-          type: array
-          items:
-            type: string
-        phaseWorkStreams:
-          type: object
-          additionalProperties:
-            $ref: "#/components/schemas/PhaseWorkStreamConfigDto"
-
-    WorkflowDto:
-      type: object
-      required: [id, name, kinds, typeDescription, roles]
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        kinds:
-          type: array
-          items:
-            type: string
-            enum: [greenfield, brownfield]
-        typeDescription:
-          type: string
-        roles:
-          type: array
-          items:
-            type: string
-
-    ProjectDto:
-      type: object
-      required: [id, name, description, startDate, workflows, createdAt]
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        description:
-          type: string
-        startDate:
-          type: string
-        workflows:
-          type: array
-          items:
-            $ref: "#/components/schemas/WorkflowDto"
-        createdAt:
-          type: string
-          format: date-time
-
-    ProjectPatchDto:
-      type: object
-      description: Partial update; all properties optional
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        description:
-          type: string
-        startDate:
-          type: string
-        workflows:
-          type: array
-          items:
-            $ref: "#/components/schemas/WorkflowDto"
-        createdAt:
-          type: string
-          format: date-time
-
     PlatformBannerDto:
       type: object
       required: [id, kind, title, message, dismissible]

package/package.json

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