@thinkai/tai-api-contract 2.40.0 → 2.41.0-pr.841.238652fb

package/src/generated/openapi.ts

@@ -626,6 +626,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI tool integration — paginated member list with usage totals
+         * @description Paginated list of active AI-tool seats enriched with spend, token, and active-day totals for the selected time range. Supports search (by email / display name) and sort (spend_cents_desc, active_days_desc, token_count_desc, name_asc). Useful for the **Members** tab of the AI tool integration detail page.
+         */
+        get: operations["getAiToolMembers"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/teams": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI tool integration — team rollups from org chart
+         * @description Team-level AI tool usage aggregated from org-chart membership (SPA org chart snapshot). Returns spend, token, active member counts per team for the selected range. Members not mapped to any team are excluded.
+         */
+        get: operations["getAiToolTeams"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/integrations/ai-tool/{provider}/members/{externalId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI tool integration — member detail drill-down
+         * @description Individual member detail: total spend, tokens, active days, per-model spend breakdown, and per-day activity heatmap for the selected range. The member's team (from org chart) is returned when available.
+         */
+        get: operations["getAiToolMemberDetail"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/company-profile": {
         parameters: {
             query?: never;
@@ -2929,6 +2989,59 @@ export interface components {
             generatedAt: string;
             weeks: components["schemas"]["AiUsageSpendUsageTrendsWeekDto"][];
         };
+        AiToolMemberSummaryDto: {
+            externalId: string;
+            email: string;
+            displayName?: string;
+            role?: string;
+            spendCents: number;
+            tokenCount: number;
+            activeDays: number;
+            mostUsedModel?: string;
+        };
+        AiToolMembersListDto: {
+            members: components["schemas"]["AiToolMemberSummaryDto"][];
+            total: number;
+            page: number;
+            pageSize: number;
+        };
+        AiToolTeamSummaryDto: {
+            teamId: string;
+            teamName: string;
+            memberCount: number;
+            activeMembers: number;
+            spendCents: number;
+            tokenCount: number;
+        };
+        AiToolTeamsListDto: {
+            teams: components["schemas"]["AiToolTeamSummaryDto"][];
+            total: number;
+        };
+        AiToolMemberModelBreakdownItemDto: {
+            modelName: string;
+            spendCents: number;
+            tokenCount: number;
+            eventCount: number;
+        };
+        AiToolMemberHeatmapDayDto: {
+            /** Format: date */
+            day: string;
+            isActive: boolean;
+            tokenCount: number;
+        };
+        AiToolMemberDetailDto: {
+            externalId: string;
+            email: string;
+            displayName?: string;
+            role?: string;
+            isRemoved: boolean;
+            spendCents: number;
+            tokenCount: number;
+            activeDays: number;
+            teamName?: string;
+            modelBreakdown: components["schemas"]["AiToolMemberModelBreakdownItemDto"][];
+            heatmap: components["schemas"]["AiToolMemberHeatmapDayDto"][];
+        };
         MeProfileDto: {
             id: string;
             email: string;
@@ -4510,6 +4623,13 @@ export type AiUsageSpendRoiProductivitySignalDto = components['schemas']['AiUsag
 export type AiUsageSpendUsageTrendsProviderWeekDto = components['schemas']['AiUsageSpendUsageTrendsProviderWeekDto'];
 export type AiUsageSpendUsageTrendsWeekDto = components['schemas']['AiUsageSpendUsageTrendsWeekDto'];
 export type AiUsageSpendUsageTrendsDto = components['schemas']['AiUsageSpendUsageTrendsDto'];
+export type AiToolMemberSummaryDto = components['schemas']['AiToolMemberSummaryDto'];
+export type AiToolMembersListDto = components['schemas']['AiToolMembersListDto'];
+export type AiToolTeamSummaryDto = components['schemas']['AiToolTeamSummaryDto'];
+export type AiToolTeamsListDto = components['schemas']['AiToolTeamsListDto'];
+export type AiToolMemberModelBreakdownItemDto = components['schemas']['AiToolMemberModelBreakdownItemDto'];
+export type AiToolMemberHeatmapDayDto = components['schemas']['AiToolMemberHeatmapDayDto'];
+export type AiToolMemberDetailDto = components['schemas']['AiToolMemberDetailDto'];
 export type MeProfileDto = components['schemas']['MeProfileDto'];
 export type UpdateMeBodyDto = components['schemas']['UpdateMeBodyDto'];
 export type WorkspaceSummaryDto = components['schemas']['WorkspaceSummaryDto'];
@@ -6315,6 +6435,154 @@ export interface operations {
             };
         };
     };
+    getAiToolMembers: {
+        parameters: {
+            query?: {
+                rangeId?: "4w" | "8w" | "q";
+                windowEnd?: string;
+                page?: number;
+                pageSize?: number;
+                search?: string;
+                sort?: "spend_cents_desc" | "active_days_desc" | "token_count_desc" | "name_asc";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description AI tool provider id (e.g. claude, cursor). */
+                provider: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated member list with usage totals */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiToolMembersListDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getAiToolTeams: {
+        parameters: {
+            query?: {
+                rangeId?: "4w" | "8w" | "q";
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Team rollup list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiToolTeamsListDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    getAiToolMemberDetail: {
+        parameters: {
+            query?: {
+                rangeId?: "4w" | "8w" | "q";
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                provider: string;
+                /** @description Provider-assigned member external id. */
+                externalId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Member detail with model breakdown and day heatmap */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiToolMemberDetailDto"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example invalid_query */
+                        error: string;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or member does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCompanyProfile: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -1174,6 +1174,72 @@ export interface HrisTriggerSyncResultDto {
   providers?: HrisProviderSyncResultDto[];
 }
 
+/** Single AI-tool seat with usage totals for a time range. */
+export interface AiToolMemberSummaryDto {
+  externalId: string;
+  email: string;
+  displayName?: string;
+  role?: string;
+  spendCents: number;
+  tokenCount: number;
+  activeDays: number;
+  mostUsedModel?: string;
+}
+
+/** Paginated response for GET .../integrations/ai-tool/:provider/members */
+export interface AiToolMembersListDto {
+  members: AiToolMemberSummaryDto[];
+  total: number;
+  page: number;
+  pageSize: number;
+}
+
+/** Team-level AI tool usage aggregated from org-chart membership. */
+export interface AiToolTeamSummaryDto {
+  teamId: string;
+  teamName: string;
+  memberCount: number;
+  activeMembers: number;
+  spendCents: number;
+  tokenCount: number;
+}
+
+/** Response for GET .../integrations/ai-tool/:provider/teams */
+export interface AiToolTeamsListDto {
+  teams: AiToolTeamSummaryDto[];
+  total: number;
+}
+
+/** Per-model spend and token breakdown for a member in a time range. */
+export interface AiToolMemberModelBreakdownItemDto {
+  modelName: string;
+  spendCents: number;
+  tokenCount: number;
+  eventCount: number;
+}
+
+/** Per-day activity entry in the member detail heatmap. */
+export interface AiToolMemberHeatmapDayDto {
+  day: string;
+  isActive: boolean;
+  tokenCount: number;
+}
+
+/** Response for GET .../integrations/ai-tool/:provider/members/:externalId */
+export interface AiToolMemberDetailDto {
+  externalId: string;
+  email: string;
+  displayName?: string;
+  role?: string;
+  isRemoved: boolean;
+  spendCents: number;
+  tokenCount: number;
+  activeDays: number;
+  teamName?: string;
+  modelBreakdown: AiToolMemberModelBreakdownItemDto[];
+  heatmap: AiToolMemberHeatmapDayDto[];
+}
+
 export {
   JOURNEY_STEP_IDS,
   JOURNEY_STEP_REGISTRY,