@thinkai/tai-api-contract 2.49.0 → 2.50.0-pr.877.6ff333f6

package/dist/generated/openapi.d.ts

@@ -747,7 +747,7 @@ export interface paths {
         };
         /**
          * AI usage & spend insights — AI-assisted code percentage
-         * @description Period and weekly AI-assisted code percentage for the Measure **AI-assisted code** card on `/phase-c/c7` and the **AI impact** curve on `/phase-c/c4`. When scoped productivity metrics include `aiAssistedContributionRatioPercent`, values are **measured** from ingest; otherwise the API falls back to token→LOC heuristics and sets `dataQuality` to **estimated**. Clients should not present estimated series as Cursor-measured signal.
+         * @description Period and weekly AI-assisted code percentage for the Measure **AI-assisted code** card on `/phase-c/c7` and the **AI impact** curve on `/phase-c/c4`. When engagement daily rows exist for the scope, values are **measured** from Σ `ai_lines_added` ÷ merged-PR lines (`dashboard_metrics`); otherwise the API falls back to token→LOC heuristics and sets `dataQuality` to **estimated**. Clients should not present estimated series as editor-measured signal.
          */
         get: operations["getAiUsageSpendAiAssistedCodePercentage"];
         put?: never;
@@ -758,6 +758,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/insights/ai-usage-spend/provider-engagement-insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage & spend insights — provider engagement cards
+         * @description Provider-specific engagement insight metrics derived from `tai_workspace_ai_tool_engagement_daily` (accepted AI lines, tab completions, suggestion accept rates, Claude Code sessions, etc.). Metrics are **provider- and data-gated**: structurally absent signals render as N/A, not zero. Claude per-user cards require Enterprise Analytics (`insightsPlan` ≠ team).
+         */
+        get: operations["getAiUsageSpendProviderEngagementInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/insights/ai-usage-spend/ai-tool-usage-spend": {
         parameters: {
             query?: never;
@@ -3248,6 +3268,32 @@ export interface components {
             totalSpendCents?: number;
             weeks: components["schemas"]["AiUsageSpendAiAssistedCodeWeekDto"][];
         };
+        /** @enum {string} */
+        ProviderEngagementInsightAvailability: "measured" | "not_applicable";
+        AiUsageSpendProviderEngagementMetricDto: {
+            id: string;
+            label: string;
+            value: number | null;
+            displayValue: string;
+            availability: components["schemas"]["ProviderEngagementInsightAvailability"];
+            unit?: string;
+            methodologyNote?: string;
+        };
+        AiUsageSpendProviderEngagementCardDto: {
+            providerId: string;
+            providerName: string;
+            metrics: components["schemas"]["AiUsageSpendProviderEngagementMetricDto"][];
+        };
+        AiUsageSpendProviderEngagementInsightsDto: {
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            range: "4w" | "8w" | "q";
+            scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
+            /** Format: date-time */
+            generatedAt: string;
+            providers: components["schemas"]["AiUsageSpendProviderEngagementCardDto"][];
+        };
         AiUsageSpendAiToolUsageSpendProviderItemDto: {
             providerId: string;
             providerName: string;
@@ -5212,6 +5258,10 @@ export type AiAssistedCodeDataQuality = components['schemas']['AiAssistedCodeDat
 export type AiAssistedCodeEstimationSource = components['schemas']['AiAssistedCodeEstimationSource'];
 export type AiUsageSpendAiAssistedCodeWeekDto = components['schemas']['AiUsageSpendAiAssistedCodeWeekDto'];
 export type AiUsageSpendAiAssistedCodePercentageDto = components['schemas']['AiUsageSpendAiAssistedCodePercentageDto'];
+export type ProviderEngagementInsightAvailability = components['schemas']['ProviderEngagementInsightAvailability'];
+export type AiUsageSpendProviderEngagementMetricDto = components['schemas']['AiUsageSpendProviderEngagementMetricDto'];
+export type AiUsageSpendProviderEngagementCardDto = components['schemas']['AiUsageSpendProviderEngagementCardDto'];
+export type AiUsageSpendProviderEngagementInsightsDto = components['schemas']['AiUsageSpendProviderEngagementInsightsDto'];
 export type AiUsageSpendAiToolUsageSpendProviderItemDto = components['schemas']['AiUsageSpendAiToolUsageSpendProviderItemDto'];
 export type AiUsageSpendAiToolUsageSpendModelItemDto = components['schemas']['AiUsageSpendAiToolUsageSpendModelItemDto'];
 export type AiUsageSpendAiToolUsageSpendDto = components['schemas']['AiUsageSpendAiToolUsageSpendDto'];
@@ -7514,6 +7564,58 @@ export interface operations {
             };
         };
     };
+    getAiUsageSpendProviderEngagementInsights: {
+        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 Provider engagement insight cards */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiUsageSpendProviderEngagementInsightsDto"];
+                };
+            };
+            /** @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;
+            };
+        };
+    };
     getAiUsageSpendAiToolUsageSpend: {
         parameters: {
             query?: {