@thinkai/tai-api-contract 2.81.0-pr.976.a7aec716 → 2.82.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.81.0
+  version: 2.82.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -7010,6 +7010,15 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Repository blocked by workspace eligibility or size limits
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+              example:
+                error: Repository exceeds the workspace eligibility limits and cannot be indexed
+                code: repo_ineligible
 
   /workspaces/{workspaceId}/code-chat/indexes/sync:
     post:
@@ -16868,6 +16877,21 @@ components:
         items:
           type: array
           items: { $ref: "#/components/schemas/CodeChatIndexDto" }
+        skipped:
+          type: array
+          description: Repositories requested (or considered) for sync but not enqueued
+          items: { $ref: "#/components/schemas/CodeChatSkippedRepoDto" }
+
+    CodeChatSkippedRepoDto:
+      type: object
+      required: [repoId, repoName, code]
+      properties:
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+        code:
+          type: string
+          enum: [repo_ineligible]
+          description: Stable machine-readable skip reason
 
     CodeChatThreadDto:
       type: object
@@ -16956,7 +16980,65 @@ components:
         - type: object
           required: [mode]
           properties:
-            mode: { type: string, enum: [llm, retrieval] }
+            mode:
+              type: string
+              enum: [llm, retrieval, inventory]
+              description: >
+                How the assistant answer was produced. `inventory` returns a deterministic
+                catalog (APIs or modules) rather than LLM synthesis.
+            structured:
+              description: Optional typed inventory payload for rich UI tables
+              allOf:
+                - $ref: "#/components/schemas/CodeChatStructuredBlockDto"
+            groundedInWiki:
+              type: boolean
+              description: True when wiki pages from one or more repos contributed to LLM context
+            wikiRepos:
+              type: array
+              items: { type: string }
+              description: Repository names whose wiki pages grounded the answer
+
+    CodeChatApiRouteRowDto:
+      type: object
+      required: [method, path, file]
+      properties:
+        method: { type: string }
+        path: { type: string }
+        file: { type: string }
+        line: { type: integer }
+        summary: { type: string }
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+        providerSlug: { type: string }
+        commitSha: { type: string, nullable: true }
+
+    CodeChatModuleInventoryRowDto:
+      type: object
+      required: [name, kind, path]
+      properties:
+        name: { type: string }
+        kind: { type: string, enum: [package, root, area] }
+        path: { type: string }
+        summary: { type: string }
+        repoId: { type: string, format: uuid }
+        repoName: { type: string }
+
+    CodeChatStructuredBlockDto:
+      oneOf:
+        - type: object
+          required: [kind, rows]
+          properties:
+            kind: { type: string, enum: [api_inventory] }
+            rows:
+              type: array
+              items: { $ref: "#/components/schemas/CodeChatApiRouteRowDto" }
+        - type: object
+          required: [kind, rows]
+          properties:
+            kind: { type: string, enum: [module_inventory] }
+            rows:
+              type: array
+              items: { $ref: "#/components/schemas/CodeChatModuleInventoryRowDto" }
 
     CodeChatWikiPageDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.81.0-pr.976.a7aec716",
+  "version": "2.82.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/src/generated/openapi.ts

@@ -7325,6 +7325,18 @@ export interface components {
         CodeChatSyncIndexesResultDto: {
             enqueued: number;
             items?: components["schemas"]["CodeChatIndexDto"][];
+            /** @description Repositories requested (or considered) for sync but not enqueued */
+            skipped?: components["schemas"]["CodeChatSkippedRepoDto"][];
+        };
+        CodeChatSkippedRepoDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            /**
+             * @description Stable machine-readable skip reason
+             * @enum {string}
+             */
+            code: "repo_ineligible";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -7387,8 +7399,48 @@ export interface components {
             content: string;
         };
         CodeChatMessageReplyDto: components["schemas"]["CodeChatMessageDto"] & {
+            /**
+             * @description How the assistant answer was produced. `inventory` returns a deterministic catalog (APIs or modules) rather than LLM synthesis.
+             * @enum {string}
+             */
+            mode: "llm" | "retrieval" | "inventory";
+            /** @description Optional typed inventory payload for rich UI tables */
+            structured?: components["schemas"]["CodeChatStructuredBlockDto"];
+            /** @description True when wiki pages from one or more repos contributed to LLM context */
+            groundedInWiki?: boolean;
+            /** @description Repository names whose wiki pages grounded the answer */
+            wikiRepos?: string[];
+        };
+        CodeChatApiRouteRowDto: {
+            method: string;
+            path: string;
+            file: string;
+            line?: number;
+            summary?: string;
+            /** Format: uuid */
+            repoId?: string;
+            repoName?: string;
+            providerSlug?: string;
+            commitSha?: string | null;
+        };
+        CodeChatModuleInventoryRowDto: {
+            name: string;
             /** @enum {string} */
-            mode: "llm" | "retrieval";
+            kind: "package" | "root" | "area";
+            path: string;
+            summary?: string;
+            /** Format: uuid */
+            repoId?: string;
+            repoName?: string;
+        };
+        CodeChatStructuredBlockDto: {
+            /** @enum {string} */
+            kind: "api_inventory";
+            rows: components["schemas"]["CodeChatApiRouteRowDto"][];
+        } | {
+            /** @enum {string} */
+            kind: "module_inventory";
+            rows: components["schemas"]["CodeChatModuleInventoryRowDto"][];
         };
         CodeChatWikiPageDto: {
             /** Format: uuid */
@@ -8215,6 +8267,7 @@ export type CodeChatIndexListDto = components['schemas']['CodeChatIndexListDto']
 export type CodeChatCreateIndexBodyDto = components['schemas']['CodeChatCreateIndexBodyDto'];
 export type CodeChatSyncIndexesBodyDto = components['schemas']['CodeChatSyncIndexesBodyDto'];
 export type CodeChatSyncIndexesResultDto = components['schemas']['CodeChatSyncIndexesResultDto'];
+export type CodeChatSkippedRepoDto = components['schemas']['CodeChatSkippedRepoDto'];
 export type CodeChatThreadDto = components['schemas']['CodeChatThreadDto'];
 export type CodeChatThreadListDto = components['schemas']['CodeChatThreadListDto'];
 export type CodeChatCreateThreadBodyDto = components['schemas']['CodeChatCreateThreadBodyDto'];
@@ -8223,6 +8276,9 @@ export type CodeChatMessageDto = components['schemas']['CodeChatMessageDto'];
 export type CodeChatThreadDetailDto = components['schemas']['CodeChatThreadDetailDto'];
 export type CodeChatPostMessageBodyDto = components['schemas']['CodeChatPostMessageBodyDto'];
 export type CodeChatMessageReplyDto = components['schemas']['CodeChatMessageReplyDto'];
+export type CodeChatApiRouteRowDto = components['schemas']['CodeChatApiRouteRowDto'];
+export type CodeChatModuleInventoryRowDto = components['schemas']['CodeChatModuleInventoryRowDto'];
+export type CodeChatStructuredBlockDto = components['schemas']['CodeChatStructuredBlockDto'];
 export type CodeChatWikiPageDto = components['schemas']['CodeChatWikiPageDto'];
 export type CodeChatWikiPageListDto = components['schemas']['CodeChatWikiPageListDto'];
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
@@ -15417,6 +15473,21 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
+            /** @description Repository blocked by workspace eligibility or size limits */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Repository exceeds the workspace eligibility limits and cannot be indexed",
+                     *       "code": "repo_ineligible"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     syncCodeChatIndexes: {