@thinkai/tai-api-contract 2.37.0 → 2.39.0

package/src/generated/openapi.ts

@@ -292,6 +292,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/sources/{type}/insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Disconnect AI tool usage insights credentials
+         * @description Remove usage-insights credentials (admin/analytics API keys) for `cursor` or `claude` while preserving execution keys used by the readiness agent. Purges cached AI-tool usage data for that provider. Requires admin workspace role.
+         */
+        delete: operations["deleteSourceInsightsByType"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/dashboard/productivity": {
         parameters: {
             query?: never;
@@ -586,6 +606,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/usage-trends": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — per-provider weekly spend/token trends
+         * @description Per-provider weekly spend and token series for the **Usage Trends** stacked area chart on `/insights/ai-usage`. Returns one week entry per calendar bucket, each containing an array of provider rows with spend, token count, and active user count for that week. Weeks with zero activity for a provider are omitted from the providers array. Same filter params as other Measure insights routes.
+         */
+        get: operations["getAiUsageSpendUsageTrends"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/company-profile": {
         parameters: {
             query?: never;
@@ -2016,6 +2056,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/integrations/zenhr/reconnect": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Attempt silent ZenHR reconnect
+         * @description Attempts a silent token refresh and branch ping using stored ZenHR OAuth credentials. Returns `{ ok: true }` when the connection is restored without user interaction. Returns `{ ok: false, oauthRequired: true }` when stored credentials exist but refresh failed with an OAuth re-authorization error (e.g. `invalid_grant`); the SPA should start ZenHR OAuth next. Returns `502` for other upstream failures (same semantics as `GET .../integrations/zenhr/branches`).
+         */
+        post: operations["reconnectWorkspaceZenHr"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/hris/status": {
         parameters: {
             query?: never;
@@ -2840,6 +2900,31 @@ export interface components {
             usageDeltaPercent: number;
             weeks: components["schemas"]["AiUsageSpendRoiProductivitySignalWeekDto"][];
         };
+        AiUsageSpendUsageTrendsProviderWeekDto: {
+            providerId: string;
+            providerName: string;
+            spendCents: number;
+            tokenCount: number;
+            activeUsers: number;
+        };
+        AiUsageSpendUsageTrendsWeekDto: {
+            /** Format: date-time */
+            bucketStart: string;
+            /** Format: date-time */
+            bucketEnd: string;
+            weekLabel?: string;
+            providers: components["schemas"]["AiUsageSpendUsageTrendsProviderWeekDto"][];
+        };
+        AiUsageSpendUsageTrendsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            weeks: components["schemas"]["AiUsageSpendUsageTrendsWeekDto"][];
+        };
         MeProfileDto: {
             id: string;
             email: string;
@@ -4042,7 +4127,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "integrations.claude.analytics_key.added" | "integrations.claude.analytics_key.updated" | "integrations.claude.analytics_key.removed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped";
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -4125,6 +4210,16 @@ export interface components {
         HrisSyncStatusListDto: {
             statuses: components["schemas"]["HrisSyncStatusDto"][];
         };
+        ZenHrReconnectResultDto: {
+            ok: boolean;
+            /** @description When true with ok=false, stored credentials exist but refresh failed with an OAuth re-authorization error; the SPA should start ZenHR OAuth next. */
+            oauthRequired?: boolean;
+            /**
+             * @description Machine-readable code when ok=false and oauthRequired=true.
+             * @enum {string}
+             */
+            error?: "zenhr_oauth_required";
+        };
         HrisTriggerSyncResultDto: {
             /** @enum {string} */
             status: "ok" | "skipped" | "error" | "partial";
@@ -4408,6 +4503,9 @@ export type AiUsageSpendAiToolUsageSpendDto = components['schemas']['AiUsageSpen
 export type AiUsageSpendTeamToolHeatmapDto = components['schemas']['AiUsageSpendTeamToolHeatmapDto'];
 export type AiUsageSpendRoiProductivitySignalWeekDto = components['schemas']['AiUsageSpendRoiProductivitySignalWeekDto'];
 export type AiUsageSpendRoiProductivitySignalDto = components['schemas']['AiUsageSpendRoiProductivitySignalDto'];
+export type AiUsageSpendUsageTrendsProviderWeekDto = components['schemas']['AiUsageSpendUsageTrendsProviderWeekDto'];
+export type AiUsageSpendUsageTrendsWeekDto = components['schemas']['AiUsageSpendUsageTrendsWeekDto'];
+export type AiUsageSpendUsageTrendsDto = components['schemas']['AiUsageSpendUsageTrendsDto'];
 export type MeProfileDto = components['schemas']['MeProfileDto'];
 export type UpdateMeBodyDto = components['schemas']['UpdateMeBodyDto'];
 export type WorkspaceSummaryDto = components['schemas']['WorkspaceSummaryDto'];
@@ -4533,6 +4631,7 @@ export type WorkspaceAbsenceDto = components['schemas']['WorkspaceAbsenceDto'];
 export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceListDto'];
 export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
 export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
+export type ZenHrReconnectResultDto = components['schemas']['ZenHrReconnectResultDto'];
 export type HrisTriggerSyncResultDto = components['schemas']['HrisTriggerSyncResultDto'];
 export type HrisProviderSyncResultDto = components['schemas']['HrisProviderSyncResultDto'];
 export type ActivityLogPageDto = components['schemas']['ActivityLogPageDto'];
@@ -5331,6 +5430,63 @@ export interface operations {
             };
         };
     };
+    deleteSourceInsightsByType: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description AI tool source type (`cursor` or `claude`). */
+                type: "cursor" | "claude";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Insights credentials removed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": true
+                     *     }
+                     */
+                    "application/json": {
+                        ok: boolean;
+                    };
+                };
+            };
+            /** @description Invalid or unsupported source type */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Invalid or unsupported source type for insights disconnect",
+                     *       "code": "invalid_source_type"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Source missing or no insights credentials configured */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getDashboardProductivity: {
         parameters: {
             query?: {
@@ -6103,6 +6259,58 @@ export interface operations {
             };
         };
     };
+    getAiUsageSpendUsageTrends: {
+        parameters: {
+            query?: {
+                /** @description Measure time range (maps to weekly bucket count). */
+                rangeId?: "4w" | "8w" | "q";
+                /** @description Department filter; send `All departments` to include every department. Scoped using imported `thinkai_org_structure` members when present, otherwise SPA org chart `department` nodes and their descendant teams. When neither source defines the requested department, insights return no scoped teams or contributors (not org-wide data). */
+                department?: components["parameters"]["InsightsDepartmentFilter"];
+                /** @description Team name filter; send `All teams` to include every team. */
+                team?: string;
+                /** @description ISO timestamp for the end of the last weekly bucket; omit for current week. */
+                windowEnd?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Per-provider weekly spend and token trend series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendUsageTrendsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
     getCompanyProfile: {
         parameters: {
             query?: never;
@@ -9636,6 +9844,58 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    reconnectWorkspaceZenHr: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Silent reconnect succeeded or OAuth is required */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ZenHrReconnectResultDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description ZenHR is not connected for this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "zenhr_not_connected"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description ZenHR refresh or branch ping failed for a non-OAuth reason */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "zenhr_reconnect_failed"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getHrisSyncStatus: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -900,6 +900,29 @@ export interface AiUsageSpendRoiProductivitySignalDto {
   weeks: AiUsageSpendRoiProductivitySignalWeekDto[];
 }
 
+export interface AiUsageSpendUsageTrendsProviderWeekDto {
+  providerId: string;
+  providerName: string;
+  spendCents: number;
+  tokenCount: number;
+  activeUsers: number;
+}
+
+export interface AiUsageSpendUsageTrendsWeekDto {
+  bucketStart: string;
+  bucketEnd: string;
+  weekLabel?: string;
+  providers: AiUsageSpendUsageTrendsProviderWeekDto[];
+}
+
+export interface AiUsageSpendUsageTrendsDto {
+  workspaceId: string;
+  range: string;
+  scope: { department: string; team: string };
+  generatedAt: string;
+  weeks: AiUsageSpendUsageTrendsWeekDto[];
+}
+
 /** Appeal: user contests a misattributed event. Lifecycle: pending → approved | rejected. */
 export interface AppealDto {
   id: string;
@@ -1120,6 +1143,14 @@ export interface HrisProviderSyncResultDto {
   error?: string;
 }
 
+/** Response body for POST /workspaces/:id/integrations/zenhr/reconnect. */
+export interface ZenHrReconnectResultDto {
+  ok: boolean;
+  /** When true with ok=false, the SPA should start ZenHR OAuth next. */
+  oauthRequired?: boolean;
+  error?: "zenhr_oauth_required";
+}
+
 /** Response body for POST /workspaces/:id/hris/sync (manual trigger). */
 export interface HrisTriggerSyncResultDto {
   status: "ok" | "skipped" | "error" | "partial";