@thinkai/tai-api-contract 2.129.0 → 2.131.0

package/openapi/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ThinkAI API
-  version: 2.129.0
+  version: 2.131.0
   description: >
     Contract surface for the AI Driven SDLC backend used by ThinkAI.
     Workspace-scoped routes use `/workspaces/{workspaceId}/...`.
@@ -6222,10 +6222,9 @@ paths:
       tags: [RepositoryReadiness]
       summary: Foundation activity audit log
       description: >
-        Paginated chronological feed of Agentic Foundation events for a workspace: readiness
-        scans, fix requests, PR merges, and score changes derived from existing run and fix
-        tables. Never includes secrets or raw tokens. Config-change events are not included
-        until dedicated event storage exists (issue #473).
+        Paginated chronological feed of human-initiated Agentic Foundation fix requests and
+        merged fix PRs for a workspace. Readiness scan progress, scores, and run history remain
+        available on their dedicated readiness surfaces. Never includes secrets or raw tokens.
       operationId: listReadinessAudit
       parameters:
         - $ref: "#/components/parameters/WorkspaceId"
@@ -8531,6 +8530,121 @@ paths:
         "409":
           description: Index not ready
 
+  /workspaces/{workspaceId}/code-chat/indexes/{indexId}/origin-prompt:
+    get:
+      tags: [CodeChat]
+      summary: Origin prompt and symbol-index status for one repository index
+      operationId: getCodeChatOriginPrompt
+      x-test-coverage-skip: lightweight read; covered by package unit tests
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: indexId
+          in: path
+          required: true
+          schema: { type: string, format: uuid }
+      responses:
+        "200":
+          description: Stored origin prompt and symbol-index status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatOriginPromptDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
+  /workspaces/{workspaceId}/code-chat/indexes/{indexId}/context-pack:
+    get:
+      tags: [CodeChat]
+      summary: Reader context pack for one repository index
+      operationId: getCodeChatRepoContextPack
+      description: Reader export. The agent tool remains POST …/code-chat/tools/get_context_pack.
+      x-test-coverage-skip: lightweight read; covered by package unit tests
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: indexId
+          in: path
+          required: true
+          schema: { type: string, format: uuid }
+      responses:
+        "200":
+          description: Context pack markdown and section list
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatRepoContextPackDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Index not ready
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+
+  /workspaces/{workspaceId}/code-chat/symbols/search:
+    get:
+      tags: [CodeChat]
+      summary: Search stored symbols in the workspace
+      operationId: searchCodeChatSymbols
+      x-test-coverage-skip: covered by code-context analysis unit tests
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: q
+          in: query
+          required: true
+          schema: { type: string, minLength: 1 }
+        - name: repoId
+          in: query
+          required: false
+          schema: { type: string, format: uuid }
+      responses:
+        "200":
+          description: Symbol hits
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatSymbolHitListDto"
+        "400":
+          description: Missing query
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
+  /workspaces/{workspaceId}/code-chat/symbols/refs:
+    get:
+      tags: [CodeChat]
+      summary: List references for a stored symbol
+      operationId: listCodeChatSymbolRefs
+      x-test-coverage-skip: covered by code-context analysis unit tests
+      parameters:
+        - $ref: "#/components/parameters/WorkspaceId"
+        - name: symbol
+          in: query
+          required: true
+          schema: { type: string, minLength: 1 }
+        - name: repoId
+          in: query
+          required: false
+          schema: { type: string, format: uuid }
+      responses:
+        "200":
+          description: Reference hits
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CodeChatSymbolHitListDto"
+        "400":
+          description: Missing symbol
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessageDto"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+
   /workspaces/{workspaceId}/code-chat/analyze/symbols:
     post:
       tags: [CodeChat]
@@ -17092,11 +17206,8 @@ components:
     ReadinessAuditEventType:
       type: string
       enum:
-        - scan-started
-        - scan-completed
         - fix-requested
         - pr-merged
-        - score-changed
 
     ReadinessAuditOutcome:
       type: string
@@ -20802,6 +20913,13 @@ components:
         kind: { type: string }
         summary: { type: string }
         startLine: { type: integer }
+        label: { type: string }
+        symbol: { type: string }
+        role: { type: string }
+        precision: { type: string, enum: [scip, structural] }
+        language: { type: string }
+        source: { type: string, enum: [scip, structural, codegraph] }
+        indexId: { type: string, format: uuid }
         repoId: { type: string, format: uuid }
         repoName: { type: string }
         commitSha: { type: string, nullable: true }
@@ -20813,6 +20931,30 @@ components:
         items:
           type: array
           items: { $ref: "#/components/schemas/CodeChatSymbolHitDto" }
+        source: { type: string, enum: [scip_store, codegraph] }
+
+    CodeChatOriginPromptDto:
+      type: object
+      properties:
+        originPromptMd: { type: string, nullable: true }
+        scipStatus:
+          type: object
+          nullable: true
+          additionalProperties: true
+
+    CodeChatRepoContextPackDto:
+      type: object
+      required: [markdown, tokenEstimate, maxTokens, sectionsIncluded]
+      properties:
+        markdown: { type: string }
+        tokenEstimate: { type: integer }
+        maxTokens: { type: integer }
+        sectionsIncluded:
+          type: array
+          items: { type: string }
+        pack:
+          type: object
+          additionalProperties: true
 
     CodeChatReferenceQueryBodyDto:
       type: object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkai/tai-api-contract",
-  "version": "2.129.0",
+  "version": "2.131.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
   },
   "devDependencies": {
     "@stoplight/spectral-cli": "^6.16.3",
-    "@types/node": "^26.5.1",
+    "@types/node": "^26.6.2",
     "jsonpath-plus": "^10.3.0",
     "openapi-typescript": "^7.13.0",
     "typescript": "~6.0.3"

package/src/generated/openapi.ts

@@ -2365,7 +2365,7 @@ export interface paths {
         };
         /**
          * Foundation activity audit log
-         * @description Paginated chronological feed of Agentic Foundation events for a workspace: readiness scans, fix requests, PR merges, and score changes derived from existing run and fix tables. Never includes secrets or raw tokens. Config-change events are not included until dedicated event storage exists (issue #473).
+         * @description Paginated chronological feed of human-initiated Agentic Foundation fix requests and merged fix PRs for a workspace. Readiness scan progress, scores, and run history remain available on their dedicated readiness surfaces. Never includes secrets or raw tokens.
          */
         get: operations["listReadinessAudit"];
         put?: never;
@@ -3382,6 +3382,77 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/origin-prompt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Origin prompt and symbol-index status for one repository index */
+        get: operations["getCodeChatOriginPrompt"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/context-pack": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Reader context pack for one repository index
+         * @description Reader export. The agent tool remains POST …/code-chat/tools/get_context_pack.
+         */
+        get: operations["getCodeChatRepoContextPack"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/symbols/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search stored symbols in the workspace */
+        get: operations["searchCodeChatSymbols"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-chat/symbols/refs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List references for a stored symbol */
+        get: operations["listCodeChatSymbolRefs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/analyze/symbols": {
         parameters: {
             query?: never;
@@ -7302,7 +7373,7 @@ export interface components {
             items: components["schemas"]["FixRequestDto"][];
         };
         /** @enum {string} */
-        ReadinessAuditEventType: "scan-started" | "scan-completed" | "fix-requested" | "pr-merged" | "score-changed";
+        ReadinessAuditEventType: "fix-requested" | "pr-merged";
         /** @enum {string} */
         ReadinessAuditOutcome: "success" | "partial" | "failed";
         ReadinessAuditEntryDto: {
@@ -9168,6 +9239,16 @@ export interface components {
             kind: string;
             summary?: string;
             startLine?: number;
+            label?: string;
+            symbol?: string;
+            role?: string;
+            /** @enum {string} */
+            precision?: "scip" | "structural";
+            language?: string;
+            /** @enum {string} */
+            source?: "scip" | "structural" | "codegraph";
+            /** Format: uuid */
+            indexId?: string;
             /** Format: uuid */
             repoId?: string;
             repoName?: string;
@@ -9175,6 +9256,23 @@ export interface components {
         };
         CodeChatSymbolHitListDto: {
             items: components["schemas"]["CodeChatSymbolHitDto"][];
+            /** @enum {string} */
+            source?: "scip_store" | "codegraph";
+        };
+        CodeChatOriginPromptDto: {
+            originPromptMd?: string | null;
+            scipStatus?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        CodeChatRepoContextPackDto: {
+            markdown: string;
+            tokenEstimate: number;
+            maxTokens: number;
+            sectionsIncluded: string[];
+            pack?: {
+                [key: string]: unknown;
+            };
         };
         CodeChatReferenceQueryBodyDto: {
             symbol: string;
@@ -10340,6 +10438,8 @@ export type CodeChatWikiOkfExportDto = components['schemas']['CodeChatWikiOkfExp
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
 export type CodeChatSymbolHitDto = components['schemas']['CodeChatSymbolHitDto'];
 export type CodeChatSymbolHitListDto = components['schemas']['CodeChatSymbolHitListDto'];
+export type CodeChatOriginPromptDto = components['schemas']['CodeChatOriginPromptDto'];
+export type CodeChatRepoContextPackDto = components['schemas']['CodeChatRepoContextPackDto'];
 export type CodeChatReferenceQueryBodyDto = components['schemas']['CodeChatReferenceQueryBodyDto'];
 export type CodeChatReferenceHitDto = components['schemas']['CodeChatReferenceHitDto'];
 export type CodeChatReferenceHitListDto = components['schemas']['CodeChatReferenceHitListDto'];
@@ -19210,6 +19310,133 @@ export interface operations {
             };
         };
     };
+    getCodeChatOriginPrompt: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Stored origin prompt and symbol-index status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatOriginPromptDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    getCodeChatRepoContextPack: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Context pack markdown and section list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatRepoContextPackDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Index not ready */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    searchCodeChatSymbols: {
+        parameters: {
+            query: {
+                q: string;
+                repoId?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Symbol hits */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatSymbolHitListDto"];
+                };
+            };
+            /** @description Missing query */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    listCodeChatSymbolRefs: {
+        parameters: {
+            query: {
+                symbol: string;
+                repoId?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Reference hits */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatSymbolHitListDto"];
+                };
+            };
+            /** @description Missing symbol */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     analyzeCodeChatSymbols: {
         parameters: {
             query?: never;