@thinkai/tai-api-contract 2.2.9 → 2.3.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.2.9
+  version: 2.3.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -752,6 +752,211 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
 
+  /workspaces/{workspaceId}/integrations/ai-tool/{provider}/refresh:
+    post:
+      tags: [Integrations]
+      summary: Refresh AI tool integration snapshots
+      operationId: refreshWorkspaceAiTool
+      description: >
+        Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress.
+        On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error.
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: provider
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [cursor]
+      responses:
+        "200":
+          description: Refresh result
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AiToolRefreshResponseDto"
+              examples:
+                ok:
+                  value: { ok: true }
+                invalid_token:
+                  value: { ok: false, error: invalid_token }
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: Provider source missing for this workspace
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AiToolRefreshResponseDto"
+              example:
+                ok: false
+                error: no_source
+        "409":
+          description: Refresh already in progress
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AiToolRefreshResponseDto"
+              example:
+                ok: false
+                error: already_in_progress
+
+  /workspaces/{workspaceId}/integrations/ai-tool/{provider}/seats:
+    get:
+      tags: [Integrations]
+      summary: List latest AI-tool seats
+      operationId: getWorkspaceAiToolSeats
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: provider
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [cursor]
+      responses:
+        "200":
+          description: Seats
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [seats]
+                properties:
+                  seats:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AiToolSeatDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+
+  /workspaces/{workspaceId}/integrations/ai-tool/{provider}/daily-usage:
+    get:
+      tags: [Integrations]
+      summary: List AI-tool daily usage
+      operationId: getWorkspaceAiToolDailyUsage
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: provider
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [cursor]
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: string
+            format: date
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: string
+            format: date
+        - name: externalId
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Usage rows
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [rows]
+                properties:
+                  rows:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AiToolDailyUsageRowDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+
+  /workspaces/{workspaceId}/integrations/ai-tool/{provider}/spend:
+    get:
+      tags: [Integrations]
+      summary: List AI-tool spend
+      operationId: getWorkspaceAiToolSpend
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: provider
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [cursor]
+        - name: cycleStartMs
+          in: query
+          required: false
+          schema:
+            type: integer
+            format: int64
+      responses:
+        "200":
+          description: Spend rows
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [rows]
+                properties:
+                  rows:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AiToolSpendRowDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+
+  /workspaces/{workspaceId}/integrations/ai-tool/{provider}/status:
+    get:
+      tags: [Integrations]
+      summary: Get last refresh status
+      operationId: getWorkspaceAiToolRefreshStatus
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: provider
+          in: path
+          required: true
+          schema:
+            type: string
+            enum: [cursor]
+      responses:
+        "200":
+          description: Refresh status
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [status]
+                properties:
+                  status:
+                    $ref: "#/components/schemas/AiToolRefreshStatusDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          description: No refresh status yet (or provider source missing)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AiToolRefreshResponseDto"
+              example:
+                ok: false
+                error: no_source
+
   /integrations/github/callback:
     get:
       tags: [Integrations]
@@ -1662,6 +1867,101 @@ components:
         error:
           type: string
 
+    AiToolSeatDto:
+      type: object
+      required: [externalId, email, isRemoved]
+      properties:
+        externalId:
+          type: string
+        email:
+          type: string
+        displayName:
+          type: string
+          nullable: true
+        role:
+          type: string
+          nullable: true
+        isRemoved:
+          type: boolean
+        payload:
+          type: object
+          additionalProperties: true
+
+    AiToolDailyUsageRowDto:
+      type: object
+      required: [day, externalId, isActive]
+      properties:
+        day:
+          type: string
+          format: date
+        externalId:
+          type: string
+        email:
+          type: string
+          nullable: true
+        isActive:
+          type: boolean
+        mostUsedModel:
+          type: string
+          nullable: true
+        payload:
+          type: object
+          additionalProperties: true
+
+    AiToolSpendRowDto:
+      type: object
+      required: [billingCycleStartMs, externalId, spendCents]
+      properties:
+        billingCycleStartMs:
+          type: integer
+          format: int64
+        externalId:
+          type: string
+        email:
+          type: string
+          nullable: true
+        spendCents:
+          type: integer
+          format: int64
+        payload:
+          type: object
+          additionalProperties: true
+
+    AiToolRefreshStatusDto:
+      type: object
+      required: [lastAttemptAt, counts]
+      properties:
+        lastAttemptAt:
+          type: string
+          format: date-time
+        lastSuccessAt:
+          type: string
+          format: date-time
+          nullable: true
+        lastErrorKind:
+          type: string
+          nullable: true
+        lastErrorMessage:
+          type: string
+          nullable: true
+        durationMs:
+          type: integer
+          format: int64
+          nullable: true
+        counts:
+          type: object
+          additionalProperties: true
+
+    AiToolRefreshResponseDto:
+      type: object
+      required: [ok]
+      properties:
+        ok:
+          type: boolean
+        error:
+          type: string
+          nullable: true
+
     DashboardProductivityMetricsDto:
       type: object
       description: Nested metric groups; see TypeScript `DashboardProductivityMetricsDto` in @thinkai/tai-api-contract.

package/package.json

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

package/src/generated/openapi.ts

@@ -293,6 +293,94 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/refresh": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Refresh AI tool integration snapshots
+         * @description Provider-agnostic refresh. Returns 409 when an advisory-lock refresh is already in progress. On upstream auth/rate/network failures, returns `200` with `{ ok:false, error }` so the SPA can render inline error.
+         */
+        post: operations["refreshWorkspaceAiTool"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/seats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List latest AI-tool seats */
+        get: operations["getWorkspaceAiToolSeats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/daily-usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List AI-tool daily usage */
+        get: operations["getWorkspaceAiToolDailyUsage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/spend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List AI-tool spend */
+        get: operations["getWorkspaceAiToolSpend"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get last refresh status */
+        get: operations["getWorkspaceAiToolRefreshStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/integrations/github/callback": {
         parameters: {
             query?: never;
@@ -773,6 +861,55 @@ export interface components {
             success: boolean;
             error?: string;
         };
+        AiToolSeatDto: {
+            externalId: string;
+            email: string;
+            displayName?: string | null;
+            role?: string | null;
+            isRemoved: boolean;
+            payload?: {
+                [key: string]: unknown;
+            };
+        };
+        AiToolDailyUsageRowDto: {
+            /** Format: date */
+            day: string;
+            externalId: string;
+            email?: string | null;
+            isActive: boolean;
+            mostUsedModel?: string | null;
+            payload?: {
+                [key: string]: unknown;
+            };
+        };
+        AiToolSpendRowDto: {
+            /** Format: int64 */
+            billingCycleStartMs: number;
+            externalId: string;
+            email?: string | null;
+            /** Format: int64 */
+            spendCents: number;
+            payload?: {
+                [key: string]: unknown;
+            };
+        };
+        AiToolRefreshStatusDto: {
+            /** Format: date-time */
+            lastAttemptAt: string;
+            /** Format: date-time */
+            lastSuccessAt?: string | null;
+            lastErrorKind?: string | null;
+            lastErrorMessage?: string | null;
+            /** Format: int64 */
+            durationMs?: number | null;
+            counts: {
+                [key: string]: unknown;
+            };
+        };
+        AiToolRefreshResponseDto: {
+            ok: boolean;
+            error?: string | null;
+        };
         /** @description Nested metric groups; see TypeScript `DashboardProductivityMetricsDto` in @thinkai/tai-api-contract. */
         DashboardProductivityMetricsDto: {
             [key: string]: unknown;
@@ -1245,6 +1382,11 @@ export type TenantSourceEntryDto = components['schemas']['TenantSourceEntryDto']
 export type CursorSourceDto = components['schemas']['CursorSourceDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type TestConnectionResponseDto = components['schemas']['TestConnectionResponseDto'];
+export type AiToolSeatDto = components['schemas']['AiToolSeatDto'];
+export type AiToolDailyUsageRowDto = components['schemas']['AiToolDailyUsageRowDto'];
+export type AiToolSpendRowDto = components['schemas']['AiToolSpendRowDto'];
+export type AiToolRefreshStatusDto = components['schemas']['AiToolRefreshStatusDto'];
+export type AiToolRefreshResponseDto = components['schemas']['AiToolRefreshResponseDto'];
 export type DashboardProductivityMetricsDto = components['schemas']['DashboardProductivityMetricsDto'];
 export type DashboardProductivityDto = components['schemas']['DashboardProductivityDto'];
 export type DashboardProductivityHistoryDto = components['schemas']['DashboardProductivityHistoryDto'];
@@ -2027,6 +2169,190 @@ export interface operations {
             };
         };
     };
+    refreshWorkspaceAiTool: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: "cursor";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Refresh result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiToolRefreshResponseDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Provider source missing for this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": false,
+                     *       "error": "no_source"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["AiToolRefreshResponseDto"];
+                };
+            };
+            /** @description Refresh already in progress */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": false,
+                     *       "error": "already_in_progress"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["AiToolRefreshResponseDto"];
+                };
+            };
+        };
+    };
+    getWorkspaceAiToolSeats: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: "cursor";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Seats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        seats: components["schemas"]["AiToolSeatDto"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getWorkspaceAiToolDailyUsage: {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+                externalId?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: "cursor";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Usage rows */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        rows: components["schemas"]["AiToolDailyUsageRowDto"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getWorkspaceAiToolSpend: {
+        parameters: {
+            query?: {
+                cycleStartMs?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: "cursor";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Spend rows */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        rows: components["schemas"]["AiToolSpendRowDto"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getWorkspaceAiToolRefreshStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: "cursor";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Refresh status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        status: components["schemas"]["AiToolRefreshStatusDto"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description No refresh status yet (or provider source missing) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": false,
+                     *       "error": "no_source"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["AiToolRefreshResponseDto"];
+                };
+            };
+        };
+    };
     getGithubInstallCallback: {
         parameters: {
             query: {