@thinkai/tai-api-contract 2.175.0 → 2.177.0

package/dist/generated/openapi.d.ts

@@ -4893,6 +4893,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/evals/suites/{suiteId}/compare": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Compare two succeeded eval runs on a suite
+         * @description Side-by-side compare of a baseline run vs a candidate run on the same suite. Both runs must be `succeeded`. Aligns cases by `caseId` and reports suite- and case-level score/token/cost deltas when present. Requires workspace membership. Does not trigger scoring.
+         */
+        get: operations["compareEvalRuns"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/evals/suites/{suiteId}/decisions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List eval promote/keep/reject decisions for a suite
+         * @description Returns the last 50 decisions for the suite (newest first). Empty → `{ "decisions": [] }`. Requires workspace membership.
+         */
+        get: operations["listEvalDecisions"];
+        put?: never;
+        /**
+         * Record a promote, keep, or reject decision
+         * @description Persists an audit decision for a baseline vs candidate run pair. Requires workspace editor or admin. Both runs must be `succeeded` on this suite. `promote` also applies the candidate run's `suiteSnapshot.target` to the live suite (version may bump). Promotion gate attach is deferred (`gateApplied: false`, `gateDetail.reason: deferred`) until thinkai-platform-workspace#492.
+         */
+        post: operations["createEvalDecision"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/evals/suites/{suiteId}/runs": {
         parameters: {
             query?: never;
@@ -9100,7 +9144,7 @@ export interface components {
         };
         AssessmentDictionaryDto: {
             /** @enum {string} */
-            version: "2026-10-18.1";
+            version: "2026-10-20.1";
             /** @enum {integer} */
             periodDays: 90;
             /** @enum {integer} */
@@ -9112,6 +9156,8 @@ export interface components {
             /** @enum {integer} */
             accessDaysAfterDelivery: 30;
             /** @enum {integer} */
+            deliveryBusinessDays: 5;
+            /** @enum {integer} */
             maxRepositories: 50;
             /** @enum {integer} */
             maxActiveEngineers: 500;
@@ -9141,15 +9187,90 @@ export interface components {
                 status: "supported";
                 providers: ("gitlab_self_managed" | "bitbucket_data_center")[];
             };
+            rules: {
+                /** @enum {number} */
+                windowCoverageRatio: 1;
+                /** @enum {integer} */
+                repositoryMergedPullRequestsInBothWindows: 1;
+                freshness: {
+                    /** @enum {integer} */
+                    gitHours: 24;
+                    /** @enum {integer} */
+                    jiraHours: 24;
+                    /** @enum {integer} */
+                    incidentHours: 24;
+                    /** @enum {integer} */
+                    aiUsageDays: 7;
+                    /** @enum {integer} */
+                    readinessScanDays: 30;
+                };
+                tolerances: {
+                    /** @enum {number} */
+                    moneyUsd: 0.01;
+                    /** @enum {number} */
+                    ratioPercentagePoints: 0.01;
+                    /** @enum {integer} */
+                    durationSeconds: 1;
+                };
+                /** @enum {string} */
+                outputUnit: "normalized_ship_weight";
+                /** @enum {string} */
+                rolloutTimezone: "America/New_York";
+                /** @enum {string} */
+                rolloutBoundary: "midnight";
+                /** @enum {string} */
+                costAssessableCurrency: "USD";
+            };
             unresolved: {
                 baselinePrice: components["schemas"]["UnsetAssessmentDecisionDto"];
                 premiumPrice: components["schemas"]["UnsetAssessmentDecisionDto"];
-                currency: components["schemas"]["UnsetAssessmentDecisionDto"];
-                creditWindowDays: components["schemas"]["UnsetAssessmentDecisionDto"];
-                jiraLinkageMinimum: components["schemas"]["UnsetAssessmentDecisionDto"];
-                confounderRules: components["schemas"]["UnsetAssessmentDecisionDto"];
-                activeEngineerRule: components["schemas"]["UnsetAssessmentDecisionDto"];
-                workingDayCalendar: components["schemas"]["UnsetAssessmentDecisionDto"];
+                currency: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {string} */
+                    code: "USD";
+                };
+                creditWindowDays: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {integer} */
+                    days: 90;
+                    /** @enum {string} */
+                    eligibleSubscription: "annual";
+                };
+                jiraLinkageMinimum: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {number} */
+                    ratio: 0.8;
+                };
+                confounderRules: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {number} */
+                    headcountChangeRatio: 0.1;
+                    /** @enum {number} */
+                    repositoryScopeChangeRatio: 0.1;
+                    namedEvents: ("major_release" | "migration" | "acquisition" | "policy_change")[];
+                };
+                activeEngineerRule: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {string} */
+                    activity: "authored_commit_or_merged_pr";
+                    /** @enum {string} */
+                    window: "measured_period";
+                    exclude: ("bot" | "service_account" | "unmapped" | "read_only")[];
+                };
+                workingDayCalendar: {
+                    /** @enum {string} */
+                    status: "set";
+                    /** @enum {string} */
+                    timezone: "America/New_York";
+                    weekdays: ("monday" | "tuesday" | "wednesday" | "thursday" | "friday")[];
+                    /** @enum {string} */
+                    holidays: "none";
+                };
                 countryAllowList: components["schemas"]["UnsetAssessmentDecisionDto"];
             };
         };
@@ -11291,6 +11412,8 @@ export interface components {
             createdByUserId: string;
             target: components["schemas"]["EvalSuiteTargetDto"];
             cases: components["schemas"]["EvalCaseDto"][];
+            /** @description Most recent promote/keep/reject decision for this suite, when any exist. Omitted or null when none recorded. */
+            latestDecision?: components["schemas"]["EvalDecisionDto"] | null;
         };
         EvalSuiteListDto: {
             suites: components["schemas"]["EvalSuiteDto"][];
@@ -11441,6 +11564,89 @@ export interface components {
         EvalPackListDto: {
             packs: components["schemas"]["EvalPackSummaryDto"][];
         };
+        EvalCompareRunSummaryDto: {
+            /** Format: uuid */
+            id: string;
+            suiteVersion: number;
+            score: number | null;
+            /** Format: date-time */
+            finishedAt: string | null;
+            target: components["schemas"]["EvalSuiteTargetDto"];
+            passCount: number;
+            failCount: number;
+            errorCount: number;
+        };
+        EvalCompareCaseDto: {
+            caseId: string;
+            name: string;
+            baselineStatus: (string & components["schemas"]["EvalCaseResultStatusDto"]) | null;
+            candidateStatus: (string & components["schemas"]["EvalCaseResultStatusDto"]) | null;
+            baselinePass: boolean | null;
+            candidatePass: boolean | null;
+            baselineFailedSignalIds: string[];
+            candidateFailedSignalIds: string[];
+            baselineInputTokens?: number | null;
+            candidateInputTokens?: number | null;
+            baselineOutputTokens?: number | null;
+            candidateOutputTokens?: number | null;
+            baselineCostCents?: number | null;
+            candidateCostCents?: number | null;
+            /** @description Candidate pass (1/0) minus baseline pass when both scored. */
+            scoreDelta?: number | null;
+            inputTokensDelta?: number | null;
+            outputTokensDelta?: number | null;
+            costCentsDelta?: number | null;
+        };
+        EvalCompareDto: {
+            /** Format: uuid */
+            suiteId: string;
+            baseline: components["schemas"]["EvalCompareRunSummaryDto"];
+            candidate: components["schemas"]["EvalCompareRunSummaryDto"];
+            /** @description candidate.score − baseline.score when both present. */
+            scoreDelta: number | null;
+            avgInputTokensDelta?: number | null;
+            avgOutputTokensDelta?: number | null;
+            avgCostCentsDelta?: number | null;
+            cases: components["schemas"]["EvalCompareCaseDto"][];
+            /** @description Case ids present on only one run's results/snapshot. */
+            unpairedCaseIds: string[];
+        };
+        /** @enum {string} */
+        EvalDecisionKindDto: "promote" | "keep" | "reject";
+        EvalGateDetailDto: {
+            /** @description Machine-readable gate outcome. `deferred` until promotion-gate attach (thinkai-platform-workspace#492) ships. */
+            reason: string;
+        };
+        EvalDecisionDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            suiteId: string;
+            decision: components["schemas"]["EvalDecisionKindDto"];
+            /** Format: uuid */
+            baselineRunId: string;
+            /** Format: uuid */
+            candidateRunId: string;
+            /** Format: uuid */
+            decidedByUserId: string;
+            /** Format: date-time */
+            decidedAt: string;
+            note?: string | null;
+            /** @description True when a promotion gate attach point enforced this decision. */
+            gateApplied: boolean;
+            gateDetail?: components["schemas"]["EvalGateDetailDto"] | null;
+        };
+        EvalDecisionListDto: {
+            decisions: components["schemas"]["EvalDecisionDto"][];
+        };
+        CreateEvalDecisionBodyDto: {
+            decision: components["schemas"]["EvalDecisionKindDto"];
+            /** Format: uuid */
+            baselineRunId: string;
+            /** Format: uuid */
+            candidateRunId: string;
+            note?: string;
+        };
     };
     responses: {
         /** @description Missing or invalid bearer token */
@@ -12159,6 +12365,14 @@ export type EvalModelComparisonDto = components['schemas']['EvalModelComparisonD
 export type EvalInsightsDto = components['schemas']['EvalInsightsDto'];
 export type EvalPackSummaryDto = components['schemas']['EvalPackSummaryDto'];
 export type EvalPackListDto = components['schemas']['EvalPackListDto'];
+export type EvalCompareRunSummaryDto = components['schemas']['EvalCompareRunSummaryDto'];
+export type EvalCompareCaseDto = components['schemas']['EvalCompareCaseDto'];
+export type EvalCompareDto = components['schemas']['EvalCompareDto'];
+export type EvalDecisionKindDto = components['schemas']['EvalDecisionKindDto'];
+export type EvalGateDetailDto = components['schemas']['EvalGateDetailDto'];
+export type EvalDecisionDto = components['schemas']['EvalDecisionDto'];
+export type EvalDecisionListDto = components['schemas']['EvalDecisionListDto'];
+export type CreateEvalDecisionBodyDto = components['schemas']['CreateEvalDecisionBodyDto'];
 export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ResponseZenHrSyncInProgress = components['responses']['ZenHrSyncInProgress'];
@@ -12511,11 +12725,44 @@ export interface operations {
                         shareMode: "internal" | "external";
                         /** @enum {string|null} */
                         watermark: "NOT VALIDATED" | "SAMPLE · SYNTHETIC DATA" | null;
-                        scope: Record<string, never>;
-                        windows: Record<string, never>;
-                        sources: Record<string, never>[];
-                        consent: Record<string, never>;
-                        sections: Record<string, never>[];
+                        scope: {
+                            repositories: {
+                                id: string;
+                                name: string;
+                            }[];
+                            excluded: {
+                                id: string;
+                                name: string;
+                                reason: string;
+                            }[];
+                        };
+                        windows: {
+                            pre: {
+                                start: string;
+                                end: string;
+                            } | null;
+                            post: {
+                                start: string;
+                                end: string;
+                            } | null;
+                            transitionDays: number;
+                        };
+                        sources: {
+                            provider: string;
+                            status: string;
+                            freshAt: string | null;
+                        }[];
+                        consent: {
+                            /** @enum {string} */
+                            aggregateUse: "opt_in" | "opt_out" | "unset";
+                            recordedAt: string | null;
+                        };
+                        sections: {
+                            id: string;
+                            /** @enum {string} */
+                            status: "ok" | "failed" | "omitted";
+                            reason?: string;
+                        }[];
                     };
                     workspaceId: string;
                     expectedWorkspaceId: string;
@@ -25094,6 +25341,155 @@ export interface operations {
             };
         };
     };
+    compareEvalRuns: {
+        parameters: {
+            query: {
+                baselineRunId: string;
+                candidateRunId: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Eval suite id (`tai_workspace_eval_suites.id`). */
+                suiteId: components["parameters"]["EvalSuiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Compare result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EvalCompareDto"];
+                };
+            };
+            /** @description Runs not comparable (e.g. not succeeded, same id, or invalid query). Codes: `eval_compare_runs_required`, `eval_compare_runs_not_succeeded`, `eval_compare_same_run`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace, suite, or run not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    listEvalDecisions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Eval suite id (`tai_workspace_eval_suites.id`). */
+                suiteId: components["parameters"]["EvalSuiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Decision history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "decisions": []
+                     *     }
+                     */
+                    "application/json": components["schemas"]["EvalDecisionListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or suite not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    createEvalDecision: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Eval suite id (`tai_workspace_eval_suites.id`). */
+                suiteId: components["parameters"]["EvalSuiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateEvalDecisionBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Decision recorded */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EvalDecisionDto"];
+                };
+            };
+            /** @description Validation failed. Codes: `eval_decision_invalid`, `eval_compare_runs_not_succeeded`, `eval_compare_same_run`, `eval_promote_snapshot_missing`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Authenticated but not a workspace editor/admin */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Workspace editor role required",
+                     *       "code": "workspace_editor_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace, suite, or run not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     listEvalRuns: {
         parameters: {
             query?: never;