@thinkai/tai-api-contract 2.190.0 → 2.191.0

package/src/index.ts

@@ -934,6 +934,45 @@ export interface AiUsageSpendKeyInsightsDto {
   items: AiUsageSpendKeyInsightItemDto[];
 }
 
+/** Workspace default model-mix right-sizing policy (Phase B). Null on GET → Phase A constants. */
+export interface AiModelPolicyConfigDto {
+  /** Premium share of model spend threshold (%); 1–100. */
+  premiumShareThresholdPct: number;
+  /** Optional extra premium model-name globs (case-insensitive); extends Phase A allowlist. */
+  premiumModelPatterns?: string[];
+  /** Min total model spend (cents) before workspace card emits. */
+  minWorkspaceSpendCents?: number;
+  /** Min distinct active model-spend days for a person card. */
+  minPersonActiveDays?: number;
+  /** Min personal model spend (cents) before a person card emits. */
+  minPersonSpendCents?: number;
+  /** Optional coaching copy override for recommendedAction. */
+  defaultGuidance?: string;
+}
+
+/** Per-person override for model-mix coaching (keyed by person_id). */
+export type AiModelPolicyOverrideMode = "allow_premium" | "coach_downgrade";
+
+export interface AiModelPolicyPersonOverrideDto {
+  mode: AiModelPolicyOverrideMode;
+  /** Effective threshold for coach_downgrade (default 25 when omitted). */
+  thresholdPct?: number;
+  note?: string;
+  updatedAt: string;
+  updatedByUserId: string;
+}
+
+/**
+ * GET/PUT /workspaces/:workspaceId/ai-model-policy body/response.
+ * Overrides must not change spend rollups — read-path coaching only.
+ */
+export interface AiModelPolicyDto {
+  /** Null clears / means Phase A constants on the key-insights engine. */
+  policy: AiModelPolicyConfigDto | null;
+  /** Map keyed by person_id; max 200 entries. */
+  overrides: Record<string, AiModelPolicyPersonOverrideDto>;
+}
+
 /** Whether AI-assisted code % is from ingest or token heuristics. */
 export type AiAssistedCodeDataQuality = "estimated" | "measured";