@thinkai/tai-api-contract 2.190.0 → 2.191.0

package/dist/generated/openapi.d.ts

@@ -833,6 +833,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/ai-model-policy": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get workspace AI model right-sizing policy and per-person overrides
+         * @description Returns the workspace default model-mix right-sizing policy plus optional per-person overrides used by Key Insights `model_right_sizing` (Cost-to-Value #2). `policy: null` means the server applies Phase A constants (40% threshold, fixed premium allowlist, sample gates). Member-level read access. Overrides affect coaching eligibility/copy only — they never rewrite spend rollups.
+         */
+        get: operations["getWorkspaceAiModelPolicy"];
+        /**
+         * Set workspace AI model right-sizing policy and per-person overrides
+         * @description Full-replace workspace model-mix policy and person overrides. `policy: null` clears the workspace default (Phase A constants). `overrides: {}` clears all person overrides. Max **200** override entries. Thresholds must be 1–100. Requires workspace **admin** (`403` `workspace_admin_required` for editors). On success the server writes activity `ai_model_policy.changed` with secret-free metadata (threshold, override count / modes). Does not mutate `model_daily` or spend KPIs.
+         */
+        put: operations["putWorkspaceAiModelPolicy"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/productivity-targets": {
         parameters: {
             query?: never;
@@ -6375,6 +6399,43 @@ export interface components {
                 [key: string]: components["schemas"]["RepoDeliveryOverrideDto"];
             };
         };
+        /** @description Workspace default model-mix right-sizing policy (Cost-to-Value insight #2 Phase B). When the parent `policy` field is null, the server uses Phase A constants instead. */
+        AiModelPolicyConfigDto: {
+            /** @description Premium share of model spend threshold (%). Phase A default is 40. */
+            premiumShareThresholdPct: number;
+            /** @description Optional case-insensitive model-name globs that extend the Phase A premium allowlist (`*` wildcards). Unmatched names remain non-premium. */
+            premiumModelPatterns?: string[];
+            /** @description Min total model spend (cents) before the workspace card emits. Phase A default 5000. */
+            minWorkspaceSpendCents?: number;
+            /** @description Min distinct active model-spend days for a person card. Phase A default 5. */
+            minPersonActiveDays?: number;
+            /** @description Min personal model spend (cents) before a person card emits. Phase A default 1000. */
+            minPersonSpendCents?: number;
+            /** @description Optional coaching copy used for recommendedAction on model_right_sizing cards. */
+            defaultGuidance?: string;
+        };
+        /** @description Per-person coaching override. `allow_premium` suppresses the person card; `coach_downgrade` flags at `thresholdPct` (default 25 when omitted). */
+        AiModelPolicyPersonOverrideDto: {
+            /** @enum {string} */
+            mode: "allow_premium" | "coach_downgrade";
+            /** @description Effective threshold for coach_downgrade (ignored for allow_premium). */
+            thresholdPct?: number;
+            /** @description Optional admin note (not shown as Key Insight evidence numbers). */
+            note?: string;
+            /** Format: date-time */
+            updatedAt: string;
+            /** Format: uuid */
+            updatedByUserId: string;
+        };
+        /** @description Workspace AI model policy + per-person overrides for Key Insights model right-sizing. Overrides affect recommendation eligibility/copy only; spend KPIs and model_daily are unchanged. */
+        AiModelPolicyDto: {
+            /** @description Null clears / means Phase A constants on the key-insights engine. */
+            policy: components["schemas"]["AiModelPolicyConfigDto"] | null;
+            /** @description Map keyed by person_id (max 200 entries). Empty object clears all overrides. */
+            overrides: {
+                [key: string]: components["schemas"]["AiModelPolicyPersonOverrideDto"];
+            };
+        };
         /** @description Optional weekly per-engineer targets for Productivity Insights. Omitted or null fields mean no target for that metric. Additional properties are rejected. */
         ProductivityTargetsDto: {
             /** @description Floor — meet or exceed this many merged PRs per engineer per week. */
@@ -13081,6 +13142,9 @@ export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type DeliveryRoleConfigDto = components['schemas']['DeliveryRoleConfigDto'];
 export type RepoDeliveryOverrideDto = components['schemas']['RepoDeliveryOverrideDto'];
 export type DeliveryTopologyDto = components['schemas']['DeliveryTopologyDto'];
+export type AiModelPolicyConfigDto = components['schemas']['AiModelPolicyConfigDto'];
+export type AiModelPolicyPersonOverrideDto = components['schemas']['AiModelPolicyPersonOverrideDto'];
+export type AiModelPolicyDto = components['schemas']['AiModelPolicyDto'];
 export type ProductivityTargetsDto = components['schemas']['ProductivityTargetsDto'];
 export type AiEmailAliasEntryDto = components['schemas']['AiEmailAliasEntryDto'];
 export type AiEmailAliasesDto = components['schemas']['AiEmailAliasesDto'];
@@ -16309,6 +16373,91 @@ export interface operations {
             };
         };
     };
+    getWorkspaceAiModelPolicy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current policy (policy may be null; overrides may be empty) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AiModelPolicyDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putWorkspaceAiModelPolicy: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AiModelPolicyDto"];
+            };
+        };
+        responses: {
+            /** @description Policy persisted (or cleared). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid payload (unknown keys, out-of-range, or >200 overrides) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Forbidden — workspace admin required */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace does not exist or malformed workspaceId */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getWorkspaceProductivityTargets: {
         parameters: {
             query?: never;