@thinkai/tai-api-contract 2.174.0 → 2.176.0

package/dist/generated/openapi.d.ts

@@ -4805,6 +4805,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/evals/packs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List platform eval starter packs
+         * @description Returns the platform starter-pack catalog for Prompt & model evals. Packs are ThinkAI-authored templates (not workspace-owned and not a public marketplace). Requires workspace membership. Empty catalog is not expected in production builds; clients should still handle `{ "packs": [] }`.
+         */
+        get: operations["listEvalPacks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/evals/packs/{packId}/install": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Install an eval starter pack as a suite
+         * @description Creates a new editable eval suite from a platform starter pack (`version: 1`). Sets `target.promptKey` to `pack:<packId>` for traceability. Requires workspace editor or admin. Pack cases include fixture completions so the first run can succeed without AI connectors. Does not score on the request path.
+         */
+        post: operations["installEvalPack"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/evals/suites": {
         parameters: {
             query?: never;
@@ -4853,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;
@@ -11251,6 +11335,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"][];
@@ -11387,6 +11473,103 @@ export interface components {
             tokenEfficiency: components["schemas"]["EvalTokenEfficiencyDto"] | null;
             modelComparison: components["schemas"]["EvalModelComparisonDto"][];
         };
+        /** @description Platform starter pack summary for the hub catalog. Install materializes a full `EvalSuiteDto`; pack payloads are not returned on list. */
+        EvalPackSummaryDto: {
+            /** @description Stable pack id (kebab-case). */
+            id: string;
+            name: string;
+            description: string;
+            /** @description Workflow bucket for UI grouping (e.g. `pr-review`). */
+            workflow: string;
+            /** @description Number of golden cases that will be created on install. */
+            caseCount: number;
+        };
+        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 */
@@ -11426,6 +11609,8 @@ export interface components {
         WorkspaceId: string;
         /** @description Eval suite id (`tai_workspace_eval_suites.id`). */
         EvalSuiteId: string;
+        /** @description Platform starter pack id (kebab-case), e.g. `pr-review`. Not a UUID. */
+        EvalPackId: string;
         /** @description Eval run id (`tai_workspace_eval_runs.id`). */
         EvalRunId: string;
         RepoId: string;
@@ -12101,11 +12286,22 @@ export type EvalPromptTipDto = components['schemas']['EvalPromptTipDto'];
 export type EvalTokenEfficiencyDto = components['schemas']['EvalTokenEfficiencyDto'];
 export type EvalModelComparisonDto = components['schemas']['EvalModelComparisonDto'];
 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'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
 export type ParameterEvalSuiteId = components['parameters']['EvalSuiteId'];
+export type ParameterEvalPackId = components['parameters']['EvalPackId'];
 export type ParameterEvalRunId = components['parameters']['EvalRunId'];
 export type ParameterRepoId = components['parameters']['RepoId'];
 export type ParameterProviderSlug = components['parameters']['ProviderSlug'];
@@ -24677,6 +24873,122 @@ export interface operations {
             };
         };
     };
+    listEvalPacks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Starter pack catalog */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "packs": [
+                     *         {
+                     *           "id": "pr-review",
+                     *           "name": "PR review comments",
+                     *           "description": "Check review tone and clear blocking feedback",
+                     *           "workflow": "pr-review",
+                     *           "caseCount": 3
+                     *         }
+                     *       ]
+                     *     }
+                     */
+                    "application/json": components["schemas"]["EvalPackListDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    installEvalPack: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Platform starter pack id (kebab-case), e.g. `pr-review`. Not a UUID. */
+                packId: components["parameters"]["EvalPackId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Suite created from pack */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EvalSuiteDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Viewer cannot install packs */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Workspace editor role required",
+                     *       "code": "workspace_editor_required"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Unknown pack id or workspace not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Eval starter pack not found",
+                     *       "code": "eval_pack_not_found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Workspace already has the maximum number of suites (50) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Maximum of 50 eval suites per workspace",
+                     *       "code": "eval_suite_limit_reached"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     listEvalSuites: {
         parameters: {
             query?: never;
@@ -24919,6 +25231,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;