@thinkai/tai-api-contract 2.176.0 → 2.180.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.176.0
+  version: 2.180.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -481,18 +481,75 @@ paths:
                       enum: ["NOT VALIDATED", "SAMPLE · SYNTHETIC DATA"]
                     scope:
                       type: object
+                      required: [repositories, excluded]
+                      properties:
+                        repositories:
+                          type: array
+                          items:
+                            type: object
+                            required: [id, name]
+                            properties:
+                              id: { type: string }
+                              name: { type: string }
+                        excluded:
+                          type: array
+                          items:
+                            type: object
+                            required: [id, name, reason]
+                            properties:
+                              id: { type: string }
+                              name: { type: string }
+                              reason: { type: string }
                     windows:
                       type: object
+                      required: [pre, post, transitionDays]
+                      properties:
+                        pre:
+                          type: object
+                          nullable: true
+                          required: [start, end]
+                          properties:
+                            start: { type: string }
+                            end: { type: string }
+                        post:
+                          type: object
+                          nullable: true
+                          required: [start, end]
+                          properties:
+                            start: { type: string }
+                            end: { type: string }
+                        transitionDays:
+                          type: integer
                     sources:
                       type: array
                       items:
                         type: object
+                        required: [provider, status, freshAt]
+                        properties:
+                          provider: { type: string }
+                          status: { type: string }
+                          freshAt: { type: string, nullable: true }
                     consent:
                       type: object
+                      required: [aggregateUse, recordedAt]
+                      properties:
+                        aggregateUse:
+                          type: string
+                          enum: [opt_in, opt_out, unset]
+                        recordedAt:
+                          type: string
+                          nullable: true
                     sections:
                       type: array
                       items:
                         type: object
+                        required: [id, status]
+                        properties:
+                          id: { type: string }
+                          status:
+                            type: string
+                            enum: [ok, failed, omitted]
+                          reason: { type: string }
                 workspaceId:
                   type: string
                 expectedWorkspaceId:
@@ -9211,6 +9268,32 @@ paths:
         "401":
           $ref: "#/components/responses/Unauthorized"
 
+  /workspaces/{workspaceId}/knowledge-pages/{slug}:
+    delete:
+      tags: [CodeChat]
+      summary: Delete a workspace knowledge page by slug
+      description: >-
+        Removes one page (typically a `prd-*` / `rfc-*` / `adr-*` draft). Does not
+        regenerate the rest of the knowledge base.
+      operationId: deleteWorkspaceKnowledgePage
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: slug
+          in: path
+          required: true
+          schema: { type: string, minLength: 1, maxLength: 200 }
+      responses:
+        "204":
+          description: Page deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Page not found (`knowledge_page_not_found`)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/knowledge-pages/generate:
     post:
       tags: [CodeChat]
@@ -22054,6 +22137,7 @@ components:
         - repairDays
         - secureLinkDays
         - accessDaysAfterDelivery
+        - deliveryBusinessDays
         - maxRepositories
         - maxActiveEngineers
         - dataCoverageRefreshCapDays
@@ -22066,11 +22150,12 @@ components:
         - aiProviders
         - optionalProviders
         - selfManagedGit
+        - rules
         - unresolved
       properties:
         version:
           type: string
-          enum: ["2026-10-18.1"]
+          enum: ["2026-10-20.1"]
         periodDays:
           type: integer
           enum: [90]
@@ -22086,6 +22171,9 @@ components:
         accessDaysAfterDelivery:
           type: integer
           enum: [30]
+        deliveryBusinessDays:
+          type: integer
+          enum: [5]
         maxRepositories:
           type: integer
           enum: [50]
@@ -22175,6 +22263,55 @@ components:
               items:
                 type: string
                 enum: [gitlab_self_managed, bitbucket_data_center]
+        rules:
+          type: object
+          additionalProperties: false
+          required:
+            - windowCoverageRatio
+            - repositoryMergedPullRequestsInBothWindows
+            - freshness
+            - tolerances
+            - outputUnit
+            - rolloutTimezone
+            - rolloutBoundary
+            - costAssessableCurrency
+          properties:
+            windowCoverageRatio:
+              type: number
+              enum: [1]
+            repositoryMergedPullRequestsInBothWindows:
+              type: integer
+              enum: [1]
+            freshness:
+              type: object
+              additionalProperties: false
+              required: [gitHours, jiraHours, incidentHours, aiUsageDays, readinessScanDays]
+              properties:
+                gitHours: { type: integer, enum: [24] }
+                jiraHours: { type: integer, enum: [24] }
+                incidentHours: { type: integer, enum: [24] }
+                aiUsageDays: { type: integer, enum: [7] }
+                readinessScanDays: { type: integer, enum: [30] }
+            tolerances:
+              type: object
+              additionalProperties: false
+              required: [moneyUsd, ratioPercentagePoints, durationSeconds]
+              properties:
+                moneyUsd: { type: number, enum: [0.01] }
+                ratioPercentagePoints: { type: number, enum: [0.01] }
+                durationSeconds: { type: integer, enum: [1] }
+            outputUnit:
+              type: string
+              enum: [normalized_ship_weight]
+            rolloutTimezone:
+              type: string
+              enum: [America/New_York]
+            rolloutBoundary:
+              type: string
+              enum: [midnight]
+            costAssessableCurrency:
+              type: string
+              enum: [USD]
         unresolved:
           type: object
           additionalProperties: false
@@ -22194,17 +22331,66 @@ components:
             premiumPrice:
               $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
             currency:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, code]
+              properties:
+                status: { type: string, enum: [set] }
+                code: { type: string, enum: [USD] }
             creditWindowDays:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, days, eligibleSubscription]
+              properties:
+                status: { type: string, enum: [set] }
+                days: { type: integer, enum: [90] }
+                eligibleSubscription: { type: string, enum: [annual] }
             jiraLinkageMinimum:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, ratio]
+              properties:
+                status: { type: string, enum: [set] }
+                ratio: { type: number, enum: [0.8] }
             confounderRules:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, headcountChangeRatio, repositoryScopeChangeRatio, namedEvents]
+              properties:
+                status: { type: string, enum: [set] }
+                headcountChangeRatio: { type: number, enum: [0.1] }
+                repositoryScopeChangeRatio: { type: number, enum: [0.1] }
+                namedEvents:
+                  type: array
+                  items:
+                    type: string
+                    enum: [major_release, migration, acquisition, policy_change]
             activeEngineerRule:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, activity, window, exclude]
+              properties:
+                status: { type: string, enum: [set] }
+                activity: { type: string, enum: [authored_commit_or_merged_pr] }
+                window: { type: string, enum: [measured_period] }
+                exclude:
+                  type: array
+                  items:
+                    type: string
+                    enum: [bot, service_account, unmapped, read_only]
             workingDayCalendar:
-              $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
+              type: object
+              additionalProperties: false
+              required: [status, timezone, weekdays, holidays]
+              properties:
+                status: { type: string, enum: [set] }
+                timezone: { type: string, enum: [America/New_York] }
+                weekdays:
+                  type: array
+                  items:
+                    type: string
+                    enum: [monday, tuesday, wednesday, thursday, friday]
+                holidays: { type: string, enum: [none] }
             countryAllowList:
               $ref: "#/components/schemas/UnsetAssessmentDecisionDto"
 
@@ -24303,6 +24489,7 @@ components:
                 - explain
                 - platform_ops
                 - feature_impact
+                - pr_review
                 - prd_request
               description: Classified Ask intent for the turn
             skillId:
@@ -24315,8 +24502,30 @@ components:
                 - chat-cicd
                 - chat-stack
                 - chat-platform
+                - chat-workspace
+                - chat-product
+                - chat-pr-review
                 - chat-wiki
               description: Conversation skill pack that grounded the LLM answer (Wave 10)
+            userMessage:
+              type: string
+              description: >
+                Short customer-safe summary when mode is failed. Shown in the reply body;
+                raw provider detail is only in providerFailures / debug marker.
+            providerFailures:
+              type: array
+              description: >
+                Structured provider failures for Conversations ⓘ hover (primary first).
+                Also embedded in content as `<!-- code-intel-debug:{...} -->` for reload.
+              items:
+                type: object
+                required: [provider, sanitized, raw]
+                properties:
+                  provider:
+                    type: string
+                    enum: [anthropic_messages, cursor_agent]
+                  sanitized: { type: string }
+                  raw: { type: string }
             usage:
               $ref: "#/components/schemas/CodeIntelligenceUsageDto"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.176.0",
+  "version": "2.180.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -3432,6 +3432,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/knowledge-pages/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a workspace knowledge page by slug
+         * @description Removes one page (typically a `prd-*` / `rfc-*` / `adr-*` draft). Does not regenerate the rest of the knowledge base.
+         */
+        delete: operations["deleteWorkspaceKnowledgePage"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/knowledge-pages/generate": {
         parameters: {
             query?: never;
@@ -9145,7 +9165,7 @@ export interface components {
         };
         AssessmentDictionaryDto: {
             /** @enum {string} */
-            version: "2026-10-18.1";
+            version: "2026-10-20.1";
             /** @enum {integer} */
             periodDays: 90;
             /** @enum {integer} */
@@ -9157,6 +9177,8 @@ export interface components {
             /** @enum {integer} */
             accessDaysAfterDelivery: 30;
             /** @enum {integer} */
+            deliveryBusinessDays: 5;
+            /** @enum {integer} */
             maxRepositories: 50;
             /** @enum {integer} */
             maxActiveEngineers: 500;
@@ -9186,15 +9208,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"];
             };
         };
@@ -10228,12 +10325,21 @@ export interface components {
              * @description Classified Ask intent for the turn
              * @enum {string}
              */
-            intent?: "inventory_apis" | "inventory_modules" | "explain" | "platform_ops" | "feature_impact" | "prd_request";
+            intent?: "inventory_apis" | "inventory_modules" | "explain" | "platform_ops" | "feature_impact" | "pr_review" | "prd_request";
             /**
              * @description Conversation skill pack that grounded the LLM answer (Wave 10)
              * @enum {string}
              */
-            skillId?: "chat-api-detail" | "chat-architecture" | "chat-tests" | "chat-contracts" | "chat-cicd" | "chat-stack" | "chat-platform" | "chat-wiki";
+            skillId?: "chat-api-detail" | "chat-architecture" | "chat-tests" | "chat-contracts" | "chat-cicd" | "chat-stack" | "chat-platform" | "chat-workspace" | "chat-product" | "chat-pr-review" | "chat-wiki";
+            /** @description Short customer-safe summary when mode is failed. Shown in the reply body; raw provider detail is only in providerFailures / debug marker. */
+            userMessage?: string;
+            /** @description Structured provider failures for Conversations ⓘ hover (primary first). Also embedded in content as `<!-- code-intel-debug:{...} -->` for reload. */
+            providerFailures?: {
+                /** @enum {string} */
+                provider: "anthropic_messages" | "cursor_agent";
+                sanitized: string;
+                raw: string;
+            }[];
             usage?: components["schemas"]["CodeIntelligenceUsageDto"];
         };
         CodeChatApiRouteRowDto: {
@@ -12649,11 +12755,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;
@@ -21638,6 +21777,37 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
         };
     };
+    deleteWorkspaceKnowledgePage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Page not found (`knowledge_page_not_found`) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     generateWorkspaceKnowledgePages: {
         parameters: {
             query?: never;