@thinkai/tai-api-contract 2.186.0 → 2.187.0

package/dist/generated/openapi.d.ts

@@ -6955,13 +6955,52 @@ export interface components {
             generatedAt: string;
             contributors: components["schemas"]["AiUsageSpendAggregatedContributorRowDto"][];
         };
+        /** @description Numeric evidence for `id=model_right_sizing` (Cost-to-Value insight #2). Premium share is `premiumSpendCents / totalModelSpendCents` against `thresholdPct` (Phase A default 40). */
+        AiUsageSpendKeyInsightModelRightSizingEvidenceDto: {
+            /** @description Premium-model share of model spend in the window (0–100). */
+            premiumSharePct: number;
+            /** @description Sum of spend_cents on premium-classified models (cents). */
+            premiumSpendCents: number;
+            /** @description Sum of spend_cents across all models in the window (cents). */
+            totalModelSpendCents: number;
+            /** @description Effective premium-share threshold used for this card (0–100). */
+            thresholdPct: number;
+            /** @description Distinct mapped person_id rows contributing to this card's sample (workspace rollup or the single person for a person-scoped card). */
+            personCount: number;
+        };
+        /** @description Optional member drill-down for person-scoped `model_right_sizing` cards. Links to `GET …/integrations/ai-tool/{provider}/members/{externalId}`. */
+        AiUsageSpendKeyInsightDrilldownDto: {
+            /**
+             * @description AI tool provider for the member detail route.
+             * @enum {string}
+             */
+            provider: "cursor" | "claude";
+            /** @description Provider member external id for the member detail route. */
+            externalId: string;
+        };
+        /** @description One Key Insights panel card. Base fields (`id`, `tone`, `text`) apply to all insights. When `id` is `model_right_sizing`, clients MUST treat `dataQuality`, `limitation`, `recommendedAction`, and `evidence` as required; `scope` and `drilldown` are optional (person cards may set both). */
         AiUsageSpendKeyInsightItemDto: {
-            /** @description Stable insight key (e.g. spend-leader, spend-vs-output). */
+            /** @description Stable insight key (e.g. spend-leader, spend-vs-output, model_right_sizing). */
             id: string;
             /** @enum {string} */
             tone: "positive" | "warning" | "neutral";
             /** @description Human-readable insight sentence for the UI panel. */
             text: string;
+            /** @description Required when `id=model_right_sizing`. Phase A/B always `estimated` (model-mix heuristic; no task-complexity telemetry until Phase 3). */
+            dataQuality?: components["schemas"]["AiAssistedCodeDataQuality"];
+            /** @description Required when `id=model_right_sizing`. Fixed honesty string that the model mix is heuristic and does not encode task complexity. */
+            limitation?: string;
+            /** @description Required when `id=model_right_sizing`. Coaching copy for the card CTA (advisory only; not vendor enforcement). */
+            recommendedAction?: string;
+            /** @description Required when `id=model_right_sizing`. */
+            evidence?: components["schemas"]["AiUsageSpendKeyInsightModelRightSizingEvidenceDto"];
+            /**
+             * @description Optional scope for `model_right_sizing` cards. Workspace default vs per-person personalized item.
+             * @enum {string}
+             */
+            scope?: "workspace" | "person";
+            /** @description Optional when `scope=person` for `model_right_sizing`; omitted on workspace cards. */
+            drilldown?: components["schemas"]["AiUsageSpendKeyInsightDrilldownDto"];
         };
         AiUsageSpendKeyInsightsDto: {
             /** Format: uuid */
@@ -12900,6 +12939,8 @@ export type AiUsageSpendAggregatedTeamsDto = components['schemas']['AiUsageSpend
 export type AiUsageSpendAggregatedContributorRowDto = components['schemas']['AiUsageSpendAggregatedContributorRowDto'];
 export type AiUsageSpendAggregatedContributorsDto = components['schemas']['AiUsageSpendAggregatedContributorsDto'];
 export type AiUsageSpendContributorToolHeatmapDto = components['schemas']['AiUsageSpendContributorToolHeatmapDto'];
+export type AiUsageSpendKeyInsightModelRightSizingEvidenceDto = components['schemas']['AiUsageSpendKeyInsightModelRightSizingEvidenceDto'];
+export type AiUsageSpendKeyInsightDrilldownDto = components['schemas']['AiUsageSpendKeyInsightDrilldownDto'];
 export type AiUsageSpendKeyInsightItemDto = components['schemas']['AiUsageSpendKeyInsightItemDto'];
 export type AiUsageSpendKeyInsightsDto = components['schemas']['AiUsageSpendKeyInsightsDto'];
 export type AiAssistedCodeDataQuality = components['schemas']['AiAssistedCodeDataQuality'];