@thinkai/tai-api-contract 2.189.0 → 2.191.0

package/src/generated/openapi.ts

@@ -834,6 +834,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;
@@ -3364,6 +3388,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/rules-skills/create": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Draft Rules & Skills via agent execution
+         * @description Generates hub (≥1 of `AGENTS.md` / `CLAUDE.md` per assessed tools) plus ≥1 rule and ≥1 skill with correct stack paths using workspace **agent execution** (`ThinkAiAgent` / same credential path as the fix processor — not Fix Processor enqueue). Runs the shared soft-quality gate from the validate engine. Soft failures block Open PR unless `overrideSoftQuality` + `overrideReason` (audited). Structural failures are never overridable. Requires workspace editor or admin. Assessed tools come from the latest succeeded readiness scan.
+         */
+        post: operations["postRulesSkillsCreate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/rules-skills/pull-requests": {
         parameters: {
             query?: never;
@@ -3375,7 +3419,7 @@ export interface paths {
         put?: never;
         /**
          * Open a Rules & Skills remediation pull request
-         * @description Applies `proposedFiles` (or a future create-mode session) onto a non-default branch via the Automations GitHub App installation and opens a pull request. Never pushes to the default branch. PR title/body identify the change as platform-generated and link back to `/agentic-foundation/rules-skills`. Requires workspace editor or admin. Same write-permission gate as readiness fixes.
+         * @description Applies `proposedFiles` (from validate or create drafts) onto a non-default branch via the Automations GitHub App installation and opens a pull request. Never pushes to the default branch. PR title/body identify the change as platform-generated and link back to `/agentic-foundation/rules-skills`. Requires workspace editor or admin. Same write-permission gate as readiness fixes. For create mode, pass the `drafts` returned by `POST .../rules-skills/create` as `proposedFiles` after soft-quality passes or a logged override.
          */
         post: operations["postRulesSkillsPullRequest"];
         delete?: never;
@@ -6356,6 +6400,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. */
@@ -9367,6 +9448,29 @@ export interface components {
             /** @description Quiet-case note (e.g. empty tree under pathPrefixes). */
             note?: string;
         };
+        RulesSkillsCreateRequestDto: {
+            /** Format: uuid */
+            repoId: string;
+            /** @description Optional criterion targets. At least one of `intent` or non-empty `criterionIds` is required. */
+            criterionIds?: ("A1" | "A2" | "A3" | "A3a" | "A3b" | "A3c" | "A11")[];
+            /** @description Free-text create intent (required when criterionIds is empty). */
+            intent?: string;
+            notes?: string;
+            /** @description When true, soft-quality fails are omitted from `blockingFailures` (structural fails always remain). Requires `overrideReason`; audited. */
+            overrideSoftQuality?: boolean;
+            /** @description Required when overrideSoftQuality is true. */
+            overrideReason?: string;
+        };
+        RulesSkillsCreateResponseDto: {
+            assessedTools: components["schemas"]["RulesSkillsAssessedTools"];
+            /** @description Draft patches for review; pass to open-PR as proposedFiles. */
+            drafts: components["schemas"]["RulesSkillsProposedFileDto"][];
+            softQuality: components["schemas"]["RulesSkillsSoftQualitySummaryDto"];
+            /** @description Structural fails always; soft fails unless softQualityOverridden. Open PR should wait until empty (or soft override was logged). */
+            blockingFailures: components["schemas"]["RulesSkillsFindingDto"][];
+            softQualityOverridden: boolean;
+            note?: string;
+        };
         RulesSkillsOpenPullRequestRequestDto: {
             /** Format: uuid */
             repoId: string;
@@ -9374,7 +9478,7 @@ export interface components {
             mode: "validate" | "create";
             /**
              * Format: uuid
-             * @description Reserved for Create-mode sessions; validate mode uses proposedFiles.
+             * @description Reserved for persisted create sessions; currently pass proposedFiles.
              */
             sessionId?: string;
             proposedFiles?: components["schemas"]["RulesSkillsProposedFileDto"][];
@@ -9942,7 +10046,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.suspended" | "integration.github.unsuspended" | "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" | "code_insights.design_run_started" | "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.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.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" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.datadog.added" | "integrations.datadog.removed" | "integrations.datadog.sync_completed" | "integrations.datadog.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.suspended" | "integration.github.unsuspended" | "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" | "code_insights.design_run_started" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "rules_skills.soft_quality.override" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.invite_accepted" | "member.invite_rejected" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.zenhr.sync_started" | "hris.zenhr.sync_completed" | "hris.zenhr.sync_failed" | "hris.zelt.sync_started" | "hris.zelt.sync_completed" | "hris.zelt.sync_failed" | "hris.hibob.sync_started" | "hris.hibob.sync_completed" | "hris.hibob.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" | "integrations.code_intelligence.settings_changed" | "integrations.code_intelligence.execution_key.added" | "integrations.code_intelligence.execution_key.updated" | "integrations.code_intelligence.execution_key.removed" | "integrations.code_intelligence.execution_key.check_failed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped" | "productivity.ingest.repo_skipped" | "productivity.ingest.coverage_gap_detected" | "integrations.newrelic.added" | "integrations.newrelic.removed" | "integrations.newrelic.sync_completed" | "integrations.newrelic.sync_failed" | "integrations.prometheus.added" | "integrations.prometheus.removed" | "integrations.prometheus.sync_completed" | "integrations.prometheus.sync_failed" | "integrations.grafana.added" | "integrations.grafana.removed" | "integrations.grafana.sync_completed" | "integrations.grafana.sync_failed" | "integrations.datadog.added" | "integrations.datadog.removed" | "integrations.datadog.sync_completed" | "integrations.datadog.sync_failed" | "integrations.zelt.added" | "integrations.zelt.removed" | "report.exported" | "report.assessment_stored" | "report.assessment_link_sent" | "report.assessment_link_revoked" | "report.assessment_downloaded" | "report.assessment_hidden" | "report.assessment_restored" | "workspace.aggregate_use.changed" | "workspace.assessment_rollout.changed";
         /** @description Current legal-approved opt-in notice, or `unset` while opt-in is unavailable. */
         AggregateUseNoticeStatusDto: {
             /** @enum {string} */
@@ -13039,6 +13143,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'];
@@ -13285,6 +13392,8 @@ export type RulesSkillsSoftQualityCheckDto = components['schemas']['RulesSkillsS
 export type RulesSkillsSoftQualitySummaryDto = components['schemas']['RulesSkillsSoftQualitySummaryDto'];
 export type RulesSkillsProposedFileDto = components['schemas']['RulesSkillsProposedFileDto'];
 export type RulesSkillsValidateResponseDto = components['schemas']['RulesSkillsValidateResponseDto'];
+export type RulesSkillsCreateRequestDto = components['schemas']['RulesSkillsCreateRequestDto'];
+export type RulesSkillsCreateResponseDto = components['schemas']['RulesSkillsCreateResponseDto'];
 export type RulesSkillsOpenPullRequestRequestDto = components['schemas']['RulesSkillsOpenPullRequestRequestDto'];
 export type RulesSkillsOpenPullRequestResponseDto = components['schemas']['RulesSkillsOpenPullRequestResponseDto'];
 export type PhaseRoleDto = components['schemas']['PhaseRoleDto'];
@@ -16265,6 +16374,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;
@@ -23087,6 +23281,79 @@ export interface operations {
             };
         };
     };
+    postRulesSkillsCreate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RulesSkillsCreateRequestDto"];
+            };
+        };
+        responses: {
+            /** @description Drafts generated (may include soft-quality blockingFailures) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RulesSkillsCreateResponseDto"];
+                };
+            };
+            /** @description Missing intent and criterionIds, or override without reason (`code: intent_or_criterion_required` | `override_reason_required`) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace, repository, or GitHub installation not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No succeeded readiness scan (`readiness_scan_required`), non-GitHub repo, or agent drafts missing required hub/rule/skill coverage (`rules_skills_create_incomplete`) */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Create rate limit exceeded */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Agent execution credential missing (`agent_execution_unavailable`) or clone/agent run failed (`rules_skills_create_failed`) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     postRulesSkillsPullRequest: {
         parameters: {
             query?: never;

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";