@thinkai/tai-api-contract 2.84.0 → 2.89.0-pr.986.c95d8ece

package/dist/generated/openapi.d.ts

@@ -2132,7 +2132,7 @@ export interface paths {
         /**
          * Export repository readiness issues as Markdown
          * @description Download outstanding readiness issues for one repository as a Markdown (`.md`) attachment for local IDE workflows. Reuses the same scorecard as `GET .../readiness/repos/{repoId}` (issues plus optional remediation from `criteriaDetails`).
-         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available.
+         *     The Markdown is grouped **by readiness dimension** (catalog order). Each dimension section lists matching issues sorted by severity. Issue sections include severity in the heading and do not emit per-issue `Fix status` / `Fix tier` lines. Default filter is outstanding issues (`open` + `pr-pending`). Optional query params narrow the set. When `includeCriteria` is true (default), each issue includes a Remediation section from the matching criterion when available. Timestamps use the optional `timeZone` query (IANA; default `UTC`).
          *     The response sets `Content-Disposition: attachment` with filename `readiness-issues-{providerSlug}-{date}.md`.
          */
         get: operations["exportReadinessRepoIssuesMarkdown"];
@@ -2847,6 +2847,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export the wiki as an Open Knowledge Format (OKF) v0.2 bundle
+         * @description Adapter over the stored wiki for OKF-aware platforms and agents. Does not change the live pages. Rewrites `wiki:` links to relative concept paths, adds YAML front matter plus reserved `index.md` / `log.md`, and validates Mermaid (invalid diagrams are demoted to a text fence inside the export).
+         */
+        get: operations["exportCodeChatWikiOkf"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/indexes/{indexId}/wiki/{slug}": {
         parameters: {
             query?: never;
@@ -7333,6 +7353,8 @@ export interface components {
             edgeCount: number;
             commitSha?: string | null;
             errorMessage?: string | null;
+            /** @description Human-readable indexing stage while a job is running (queued, clone, graph, save, wiki). Cleared when the index is ready or failed. */
+            progressMessage?: string | null;
             /** Format: date-time */
             indexedAt?: string | null;
             /** Format: date-time */
@@ -7352,6 +7374,11 @@ export interface components {
         CodeChatSyncIndexesBodyDto: {
             /** @description Optional subset; omit or empty to enqueue all readiness GitHub repos. */
             repoIds?: string[];
+            /**
+             * @description When true, re-enqueue even if the repository is already indexing or was indexed within the last 10 minutes.
+             * @default false
+             */
+            force: boolean;
         };
         CodeChatSyncIndexesResultDto: {
             enqueued: number;
@@ -7367,7 +7394,7 @@ export interface components {
              * @description Stable machine-readable skip reason
              * @enum {string}
              */
-            code: "repo_ineligible";
+            code: "repo_ineligible" | "indexed_recently" | "index_in_progress";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -7494,6 +7521,23 @@ export interface components {
         CodeChatWikiPageListDto: {
             items: components["schemas"]["CodeChatWikiPageDto"][];
         };
+        /** @description Portable OKF v0.2 knowledge bundle. Unpack `files` into a directory tree for OKF-aware tools; the in-app wiki is unchanged. */
+        CodeChatWikiOkfExportDto: {
+            /** @enum {string} */
+            kind: "okf-bundle";
+            /** @enum {string} */
+            okfVersion: "0.2";
+            /** Format: date-time */
+            generatedAt: string;
+            repoName: string;
+            files: {
+                /** @description Path inside the bundle (e.g. concepts/overview.md) */
+                path: string;
+                content: string;
+            }[];
+            /** @description Concept paths whose Mermaid failed validation and was exported as a text fence */
+            demotedDiagrams: string[];
+        };
         CodeChatSymbolQueryBodyDto: {
             query: string;
             repoIds?: string[];
@@ -7594,8 +7638,14 @@ export interface components {
             }[];
         };
         CodeChatVisualizeBodyDto: {
-            /** @enum {string} */
-            kind?: "dependency" | "blast" | "atlas";
+            /**
+             * @description Omit or send `auto` to let the server pick the most informative view for the repository. `blast` traces `query` as a symbol and falls back to a focused subgraph, or to impact hotspots when `query` is empty.
+             * @enum {string}
+             */
+            kind?: "auto" | "dependency" | "module" | "focus" | "impact" | "blast" | "atlas";
+            /** @description Symbol, path, or plain-language request ("how does billing reach the ledger"). Free text is resolved against the graph to seed a focused view. */
+            query?: string;
+            /** @description Deprecated alias for `query`. */
             symbol?: string;
             repoIds?: string[];
         };
@@ -7610,10 +7660,34 @@ export interface components {
                 source: string;
                 /** @description Set when dependency edges could not be resolved and a fallback view is shown. */
                 note?: string;
+                /** @description Short plain-prose narrative for the Engineering Context Graph panel. LLM-written when the workspace has an agent execution key, otherwise a deterministic reading of hubs and areas from the graph. */
+                architectureBrief?: string;
+                /**
+                 * @description Which reading of the repository this diagram is. `module` rolls files up into source groups when too few file dependencies resolved for a file map, `focus` answers a plain-language request, `impact` shows the most depended-on files, and `blast` traces one symbol.
+                 * @enum {string}
+                 */
+                kind?: "dependency" | "module" | "focus" | "impact" | "blast";
+                /** @description Measured facts about the graph — hubs, dependency coverage, test share, route count. */
+                insights?: string[];
+                /** @description Present when free text drove the view. */
+                focus?: {
+                    query: string;
+                    /** @description Files that matched the request and seeded the graph. */
+                    paths: string[];
+                };
                 nodes: {
                     id: string;
                     label: string;
                     kind?: string;
+                    path?: string;
+                    summary?: string;
+                    group?: string;
+                    inDegree?: number;
+                    outDegree?: number;
+                    /** @description File matched the request; highlight it as the answer. */
+                    isFocus?: boolean;
+                    /** @description Files behind a module box. */
+                    weight?: number;
                 }[];
                 edges: {
                     from: string;
@@ -8313,6 +8387,7 @@ export type CodeChatModuleInventoryRowDto = components['schemas']['CodeChatModul
 export type CodeChatStructuredBlockDto = components['schemas']['CodeChatStructuredBlockDto'];
 export type CodeChatWikiPageDto = components['schemas']['CodeChatWikiPageDto'];
 export type CodeChatWikiPageListDto = components['schemas']['CodeChatWikiPageListDto'];
+export type CodeChatWikiOkfExportDto = components['schemas']['CodeChatWikiOkfExportDto'];
 export type CodeChatSymbolQueryBodyDto = components['schemas']['CodeChatSymbolQueryBodyDto'];
 export type CodeChatSymbolHitDto = components['schemas']['CodeChatSymbolHitDto'];
 export type CodeChatSymbolHitListDto = components['schemas']['CodeChatSymbolHitListDto'];
@@ -13924,6 +13999,8 @@ export interface operations {
                 severity?: "critical" | "high" | "medium" | "low";
                 /** @description Include remediation from criteriaDetails (default true). */
                 includeCriteria?: boolean;
+                /** @description IANA time zone for human-readable `Last analyzed` / `Exported` timestamps and the calendar date in the attachment filename (e.g. `Europe/Berlin`). Defaults to `UTC`. */
+                timeZone?: string;
             };
             header?: never;
             path: {
@@ -15835,6 +15912,53 @@ export interface operations {
             };
         };
     };
+    exportCodeChatWikiOkf: {
+        parameters: {
+            query?: {
+                format?: "okf";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                indexId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OKF bundle (JSON with a files array of path/content pairs) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatWikiOkfExportDto"];
+                };
+            };
+            /** @description Unsupported format */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Index not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Wiki has no pages yet */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getCodeChatWikiPage: {
         parameters: {
             query?: never;