@thinkai/tai-api-contract 2.172.0 → 2.174.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.172.0
+  version: 2.173.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -8835,7 +8835,8 @@ paths:
         `status` is `indexing`, `generating_agent_md`, `failed`, or `ready`. Chat stays closed
         until `ready`: create thread and post message return `409 chat_not_ready` with
         `progressMessage` when status is not ready. An open index wave reports `indexing` until
-        every job in that wave is terminal.
+        every job in that wave is terminal. When ready, includes `activeProvider` and
+        `attachmentLimits` for Conversations file uploads.
       operationId: getCodeChatReadiness
       x-test-coverage-skip: thin HTTP over deriveCodeChatReadiness; covered by code-chat-readiness unit tests
       parameters:
@@ -8859,6 +8860,58 @@ paths:
                 error: Code Intelligence is disabled for this workspace
                 code: code_intelligence_disabled
 
+  /workspaces/{workspaceId}/code-chat/attachments:
+    post:
+      tags: [CodeChat]
+      summary: Upload a Conversations attachment
+      description: >
+        Any workspace member when chat is ready. Validates size/type against the active
+        provider profile (`attachmentLimits` from readiness). Returns metadata; pass `id`
+        as `attachmentIds` on the next POST message. Max 5 MB per file.
+      operationId: postCodeChatAttachment
+      x-test-coverage-skip: thin HTTP over validateAttachment + store insert
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CodeChatUploadAttachmentBodyDto"
+      responses:
+        "201":
+          description: Attachment stored
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatAttachmentMetaDto"
+        "400":
+          description: Validation failed (size, type, totals)
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          description: Engineering Context Graph is off
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "409":
+          description: Chat not ready
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "422":
+          description: Could not process the file
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
   /workspaces/{workspaceId}/code-chat/indexes/{indexId}:
     get:
       tags: [CodeChat]
@@ -11954,7 +12007,6 @@ paths:
         Requires workspace membership (`requireWorkspaceMember`). Empty workspace →
         `{ "suites": [] }`.
       operationId: listEvalSuites
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
       responses:
@@ -11986,7 +12038,6 @@ paths:
         `eval_suite_cases_required`); or when the workspace already has 50 suites.
         Each case must include at least one expected signal.
       operationId: createEvalSuite
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
       requestBody:
@@ -12076,7 +12127,6 @@ paths:
         runs via `suiteVersion` + snapshot on each run; this endpoint does not expose
         prior versions. Requires workspace membership.
       operationId: getEvalSuite
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - $ref: "#/components/parameters/EvalSuiteId"
@@ -12107,7 +12157,6 @@ paths:
         name/description-only updates do not bump `version`. Same validation rules
         as create (cases required, target required, bounds).
       operationId: updateEvalSuite
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - $ref: "#/components/parameters/EvalSuiteId"
@@ -12156,7 +12205,6 @@ paths:
         Returns the last 50 runs for the suite (newest first). Empty → `{ "runs": [] }`.
         Requires workspace membership. Does not trigger scoring.
       operationId: listEvalRuns
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - $ref: "#/components/parameters/EvalSuiteId"
@@ -12190,7 +12238,6 @@ paths:
         Requires workspace editor or admin. At most one active (`queued`|`running`)
         run per suite; a second POST returns `409` `eval_run_in_progress`.
       operationId: enqueueEvalRun
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - $ref: "#/components/parameters/EvalSuiteId"
@@ -12240,7 +12287,6 @@ paths:
         `caseResults` may be empty and `score` null. Requires workspace membership.
         Does not trigger scoring.
       operationId: getEvalRun
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
         - $ref: "#/components/parameters/EvalSuiteId"
@@ -12276,7 +12322,6 @@ paths:
         and null `tokenEfficiency`. Requires workspace membership. Distinct from
         `/insights-recommendations` and AI Usage & Spend.
       operationId: getEvalInsights
-      x-test-coverage-skip: contract-only; HTTP/store coverage lands with evals-storage-api
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
       responses:
@@ -14040,6 +14085,43 @@ components:
           format: date-time
           nullable: true
 
+    CodeChatAttachmentLimitsDto:
+      type: object
+      required:
+        - maxFiles
+        - maxBytesPerFile
+        - maxTotalBytes
+        - maxTextChars
+        - maxPdfPages
+        - allowedMimeTypes
+        - allowedExtensions
+        - supportsImages
+        - supportsPdf
+      properties:
+        maxFiles: { type: integer, minimum: 1 }
+        maxBytesPerFile: { type: integer, minimum: 1 }
+        maxTotalBytes: { type: integer, minimum: 1 }
+        maxTextChars: { type: integer, minimum: 1 }
+        maxPdfPages: { type: integer, minimum: 1 }
+        allowedMimeTypes:
+          type: array
+          items: { type: string }
+        allowedExtensions:
+          type: array
+          items: { type: string }
+        supportsImages: { type: boolean }
+        supportsPdf: { type: boolean }
+
+    CodeChatAttachmentMetaDto:
+      type: object
+      required: [id, filename, mimeType, sizeBytes, createdAt]
+      properties:
+        id: { type: string, format: uuid }
+        filename: { type: string }
+        mimeType: { type: string }
+        sizeBytes: { type: integer, minimum: 1 }
+        createdAt: { type: string, format: date-time }
+
     CodeChatReadinessDto:
       type: object
       required:
@@ -14079,6 +14161,13 @@ components:
           type: string
           nullable: true
           enum: [generated, admin]
+        activeProvider:
+          type: string
+          nullable: true
+          enum: [claude, cursor]
+          description: Active Ask synthesizer for attachment limit profiles
+        attachmentLimits:
+          $ref: "#/components/schemas/CodeChatAttachmentLimitsDto"
 
     CodeWikiGuidanceDto:
       type: object
@@ -23889,6 +23978,10 @@ components:
           type: array
           items: { $ref: "#/components/schemas/CodeChatCitationDto" }
         createdAt: { type: string, format: date-time }
+        attachments:
+          type: array
+          items: { $ref: "#/components/schemas/CodeChatAttachmentMetaDto" }
+          description: Present on user turns that included uploaded files
 
     CodeChatThreadDetailDto:
       allOf:
@@ -23915,6 +24008,24 @@ components:
           description: >
             Optional force deterministic inventory catalog instead of LLM synthesis.
             When omitted, the server classifies listing-style API/module questions automatically.
+        attachmentIds:
+          type: array
+          maxItems: 5
+          items: { type: string, format: uuid }
+          description: Previously uploaded attachment ids to bind to this user turn
+
+    CodeChatUploadAttachmentBodyDto:
+      type: object
+      required: [filename, mimeType, contentBase64]
+      properties:
+        filename: { type: string, minLength: 1, maxLength: 255 }
+        mimeType: { type: string, minLength: 1, maxLength: 255 }
+        contentBase64:
+          type: string
+          minLength: 1
+          description: Base64-encoded file bytes (no data-URL prefix required)
+        threadId: { type: string, format: uuid, nullable: true }
+        pdfPageCount: { type: integer, minimum: 1, nullable: true }
 
     CodeChatMessageReplyDto:
       allOf:

package/package.json

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

package/src/generated/openapi.ts

@@ -3279,7 +3279,7 @@ export interface paths {
         };
         /**
          * Workspace chat readiness
-         * @description Any workspace member. 403 `code_intelligence_disabled` when Engineering Context Graph is off. `status` is `indexing`, `generating_agent_md`, `failed`, or `ready`. Chat stays closed until `ready`: create thread and post message return `409 chat_not_ready` with `progressMessage` when status is not ready. An open index wave reports `indexing` until every job in that wave is terminal.
+         * @description Any workspace member. 403 `code_intelligence_disabled` when Engineering Context Graph is off. `status` is `indexing`, `generating_agent_md`, `failed`, or `ready`. Chat stays closed until `ready`: create thread and post message return `409 chat_not_ready` with `progressMessage` when status is not ready. An open index wave reports `indexing` until every job in that wave is terminal. When ready, includes `activeProvider` and `attachmentLimits` for Conversations file uploads.
          */
         get: operations["getCodeChatReadiness"];
         put?: never;
@@ -3290,6 +3290,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/attachments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upload a Conversations attachment
+         * @description Any workspace member when chat is ready. Validates size/type against the active provider profile (`attachmentLimits` from readiness). Returns metadata; pass `id` as `attachmentIds` on the next POST message. Max 5 MB per file.
+         */
+        post: operations["postCodeChatAttachment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/indexes/{indexId}": {
         parameters: {
             query?: never;
@@ -5505,6 +5525,26 @@ export interface components {
             /** Format: date-time */
             updatedAt: string | null;
         };
+        CodeChatAttachmentLimitsDto: {
+            maxFiles: number;
+            maxBytesPerFile: number;
+            maxTotalBytes: number;
+            maxTextChars: number;
+            maxPdfPages: number;
+            allowedMimeTypes: string[];
+            allowedExtensions: string[];
+            supportsImages: boolean;
+            supportsPdf: boolean;
+        };
+        CodeChatAttachmentMetaDto: {
+            /** Format: uuid */
+            id: string;
+            filename: string;
+            mimeType: string;
+            sizeBytes: number;
+            /** Format: date-time */
+            createdAt: string;
+        };
         CodeChatReadinessDto: {
             /** @enum {string} */
             status: "indexing" | "generating_agent_md" | "failed" | "ready";
@@ -5518,6 +5558,12 @@ export interface components {
             indexingCadence: "daily" | "weekly" | "manual";
             /** @enum {string|null} */
             agentMdSource: "generated" | "admin" | null;
+            /**
+             * @description Active Ask synthesizer for attachment limit profiles
+             * @enum {string|null}
+             */
+            activeProvider?: "claude" | "cursor" | null;
+            attachmentLimits?: components["schemas"]["CodeChatAttachmentLimitsDto"];
         };
         CodeWikiGuidanceDto: {
             /**
@@ -10048,6 +10094,8 @@ export interface components {
             citations: components["schemas"]["CodeChatCitationDto"][];
             /** Format: date-time */
             createdAt: string;
+            /** @description Present on user turns that included uploaded files */
+            attachments?: components["schemas"]["CodeChatAttachmentMetaDto"][];
         };
         CodeChatThreadDetailDto: components["schemas"]["CodeChatThreadDto"] & {
             messages: components["schemas"]["CodeChatMessageDto"][];
@@ -10064,6 +10112,17 @@ export interface components {
              * @enum {string}
              */
             intent?: "inventory_apis" | "inventory_modules";
+            /** @description Previously uploaded attachment ids to bind to this user turn */
+            attachmentIds?: string[];
+        };
+        CodeChatUploadAttachmentBodyDto: {
+            filename: string;
+            mimeType: string;
+            /** @description Base64-encoded file bytes (no data-URL prefix required) */
+            contentBase64: string;
+            /** Format: uuid */
+            threadId?: string | null;
+            pdfPageCount?: number | null;
         };
         CodeChatMessageReplyDto: components["schemas"]["CodeChatMessageDto"] & {
             /**
@@ -11515,6 +11574,8 @@ export type PutCodeIntelligenceSettingsDto = components['schemas']['PutCodeIntel
 export type CodeWikiGuidanceTopicDto = components['schemas']['CodeWikiGuidanceTopicDto'];
 export type PutCodeIntelligenceAgentMdDto = components['schemas']['PutCodeIntelligenceAgentMdDto'];
 export type CodeIntelligenceAgentMdDto = components['schemas']['CodeIntelligenceAgentMdDto'];
+export type CodeChatAttachmentLimitsDto = components['schemas']['CodeChatAttachmentLimitsDto'];
+export type CodeChatAttachmentMetaDto = components['schemas']['CodeChatAttachmentMetaDto'];
 export type CodeChatReadinessDto = components['schemas']['CodeChatReadinessDto'];
 export type CodeWikiGuidanceDto = components['schemas']['CodeWikiGuidanceDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
@@ -11931,6 +11992,7 @@ export type CodeChatCitationDto = components['schemas']['CodeChatCitationDto'];
 export type CodeChatMessageDto = components['schemas']['CodeChatMessageDto'];
 export type CodeChatThreadDetailDto = components['schemas']['CodeChatThreadDetailDto'];
 export type CodeChatPostMessageBodyDto = components['schemas']['CodeChatPostMessageBodyDto'];
+export type CodeChatUploadAttachmentBodyDto = components['schemas']['CodeChatUploadAttachmentBodyDto'];
 export type CodeChatMessageReplyDto = components['schemas']['CodeChatMessageReplyDto'];
 export type CodeChatApiRouteRowDto = components['schemas']['CodeChatApiRouteRowDto'];
 export type CodeChatModuleInventoryRowDto = components['schemas']['CodeChatModuleInventoryRowDto'];
@@ -20941,6 +21003,69 @@ export interface operations {
             };
         };
     };
+    postCodeChatAttachment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CodeChatUploadAttachmentBodyDto"];
+            };
+        };
+        responses: {
+            /** @description Attachment stored */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatAttachmentMetaDto"];
+                };
+            };
+            /** @description Validation failed (size, type, totals) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Chat not ready */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Could not process the file */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getCodeChatIndex: {
         parameters: {
             query?: never;