@thinkai/tai-api-contract 2.143.0 → 2.144.1

package/src/generated/openapi.ts

@@ -2944,6 +2944,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-intelligence/agent-md": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the workspace agent.md
+         * @description Any workspace member. Returns the persisted workspace agent file, or null fields when none has been written. 403 `code_intelligence_disabled` when Engineering Context Graph is off.
+         */
+        get: operations["getCodeIntelligenceAgentMd"];
+        /**
+         * Save an admin edit of the workspace agent.md
+         * @description Admin only. Body is 1 to 12,000 characters. Saves source `admin`. Auto-generate and the cadence tick do not overwrite this text until an admin regenerates it. A non-admin receives 403.
+         */
+        put: operations["putCodeIntelligenceAgentMd"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/code-intelligence/agent-md/regenerate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rewrite workspace agent.md from ready code graphs
+         * @description Admin only. Rewrites the file from current ready eligible graphs and sets source `generated`. Returns 409 `agent_md_not_ready` when no eligible repository index is ready. Does not call an LLM and does not clone repositories.
+         */
+        post: operations["regenerateCodeIntelligenceAgentMd"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-intelligence/token-usage/summary": {
         parameters: {
             query?: never;
@@ -3108,7 +3152,10 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Enqueue indexing for all (or selected) readiness GitHub repos */
+        /**
+         * Enqueue indexing for all (or selected) readiness GitHub repos
+         * @description `indexOnly: true` enqueues a graph-only job. `{ "indexOnly": true, "force": true }` with no `repoIds` is admin-only and opens one index wave for every eligible GitHub repository. A single-repo indexOnly sync does not open a wave. Members who send that admin body receive 403.
+         */
         post: operations["syncCodeChatIndexes"];
         delete?: never;
         options?: never;
@@ -3116,6 +3163,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/code-chat/readiness": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 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.
+         */
+        get: operations["getCodeChatReadiness"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-chat/indexes/{indexId}": {
         parameters: {
             query?: never;
@@ -4287,6 +4354,8 @@ export interface components {
             error: string;
             /** @description Machine-readable error code when present (for example `last_admin`). */
             code?: string;
+            /** @description Human-readable progress when `code` is `chat_not_ready` (same text as `error` for that response). */
+            progressMessage?: string;
         };
         TeamMemberDto: {
             /** Format: uuid */
@@ -4845,6 +4914,13 @@ export interface components {
             provider?: components["schemas"]["AgentExecutionProviderDto"] | null;
             cursorModel?: string | null;
             claudeModel?: string | null;
+            /** @description When false, turning Engineering Context Graph on and the cadence tick do not enqueue index jobs. Stored graphs, wiki pages, and agent.md stay. Defaults to true. */
+            indexingEnabled?: boolean;
+            /**
+             * @description How often the code-knowledge worker enqueues an index-only wave for eligible GitHub repositories. `manual` never ticks. Defaults to `daily`.
+             * @enum {string}
+             */
+            indexingCadence?: "daily" | "weekly" | "manual";
             /** @description Deep Wiki documentation focus for this workspace. Steers topic planning when generating Engineering Context wiki pages. Optional in-repo `.aidrivensdlc/wiki.json` still overrides the topic outline when present. */
             wikiGuidance?: components["schemas"]["CodeWikiGuidanceDto"] | null;
         };
@@ -4854,6 +4930,30 @@ export interface components {
             /** @description Title of the parent topic for hierarchy (must match another topic title). */
             parentTitle?: string | null;
         };
+        PutCodeIntelligenceAgentMdDto: {
+            body: string;
+        };
+        CodeIntelligenceAgentMdDto: {
+            body: string | null;
+            /** @enum {string|null} */
+            source: "generated" | "admin" | null;
+            /** Format: date-time */
+            updatedAt: string | null;
+        };
+        CodeChatReadinessDto: {
+            /** @enum {string} */
+            status: "indexing" | "generating_agent_md" | "failed" | "ready";
+            progressMessage: string;
+            eligibleCount: number;
+            readyCount: number;
+            failedCount: number;
+            inProgressCount: number;
+            indexingEnabled: boolean;
+            /** @enum {string} */
+            indexingCadence: "daily" | "weekly" | "manual";
+            /** @enum {string|null} */
+            agentMdSource: "generated" | "admin" | null;
+        };
         CodeWikiGuidanceDto: {
             /**
              * @description Free-form notes describing what the wiki should emphasize.
@@ -4888,6 +4988,13 @@ export interface components {
             codeIntelligenceCursorModel?: string | null;
             /** @description Optional Claude model override for Code Intelligence (null/empty → env default). */
             codeIntelligenceClaudeModel?: string | null;
+            /** @description When false, enable-enqueue and the cadence tick do not start an index wave. Defaults to true. */
+            codeIntelligenceIndexingEnabled?: boolean;
+            /**
+             * @description Index wave cadence. `manual` does not tick. Defaults to `daily`.
+             * @enum {string}
+             */
+            codeIntelligenceIndexingCadence?: "daily" | "weekly" | "manual";
             /** @description True when a dedicated `code_intelligence` source has a stored executionToken. */
             hasCodeIntelligenceExecutionToken?: boolean;
             /** @description Federated-readiness delivery topology: which connected repos hold terraform / gitops / ci_templates / api_contracts truth for this workspace. Null when not configured. Change via `PUT /workspaces/{workspaceId}/delivery-topology`. */
@@ -8990,7 +9097,7 @@ export interface components {
              */
             force: boolean;
             /**
-             * @description When true, each enqueued knowledge job clones the repository, builds the code graph, marks the index ready, and finishes with wiki tracks skipped. It does not write wiki pages and does not require an execution key. Omit or false to keep the full pipeline, including wiki. Distinct from skipLlm, which still writes a skeleton wiki. A job that is already queued or running keeps the options it was enqueued with.
+             * @description When true, each enqueued knowledge job clones the repository, builds the code graph, marks the index ready, and finishes with wiki tracks skipped. It does not write wiki pages and does not require an execution key. Omit or false to keep the full pipeline, including wiki. Distinct from skipLlm, which still writes a skeleton wiki. A job that is already queued or running keeps the options it was enqueued with. Together with `force: true` and no `repoIds`, this opens an admin index wave.
              * @default false
              */
             indexOnly: boolean;
@@ -9006,10 +9113,10 @@ export interface components {
             repoId: string;
             repoName: string;
             /**
-             * @description Stable machine-readable skip reason
+             * @description Stable machine-readable skip reason. `ecg_source_off` covers a source turned off for Engineering Context Graph and non-GitHub providers that stay listed but are never indexed.
              * @enum {string}
              */
-            code: "repo_ineligible" | "indexed_recently" | "index_in_progress";
+            code: "repo_ineligible" | "indexed_recently" | "index_in_progress" | "ecg_source_off";
         };
         CodeChatThreadDto: {
             /** Format: uuid */
@@ -9022,6 +9129,11 @@ export interface components {
             repoIds: string[];
             revisionRef?: string | null;
             title: string;
+            /**
+             * @description `workspace` when `repoIds` is empty or has more than one id (Conversations). `repo` when exactly one repository is bound (System / Wiki).
+             * @enum {string}
+             */
+            scope: "workspace" | "repo";
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -9031,12 +9143,17 @@ export interface components {
             items: components["schemas"]["CodeChatThreadDto"][];
         };
         CodeChatCreateThreadBodyDto: {
+            /**
+             * @description Create a workspace conversation with empty `repoIds`. Does not reuse an older thread. Requires chat readiness and an execution key.
+             * @enum {string}
+             */
+            scope?: "workspace";
             /**
              * Format: uuid
              * @description Legacy single-index bind; prefer repoIds for workspace scope.
              */
             indexId?: string;
-            /** @description Empty or omitted = all ready repos. */
+            /** @description Empty or omitted = all ready repos. Ignored when scope is workspace. */
             repoIds?: string[];
             revisionRef?: string;
             title?: string;
@@ -9083,10 +9200,10 @@ export interface components {
         };
         CodeChatMessageReplyDto: components["schemas"]["CodeChatMessageDto"] & {
             /**
-             * @description How the assistant answer was produced. `inventory` returns a deterministic catalog (APIs or modules) rather than LLM synthesis.
+             * @description How the assistant answer was produced. `inventory` returns a deterministic catalog (APIs or modules) rather than LLM synthesis. `failed` is a short assistant message after provider timeout or error (no retrieval substitute).
              * @enum {string}
              */
-            mode: "llm" | "retrieval" | "inventory";
+            mode: "llm" | "retrieval" | "inventory" | "failed";
             /** @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 */
@@ -10320,6 +10437,9 @@ export type JiraSourceConfigDto = components['schemas']['JiraSourceConfigDto'];
 export type AgentExecutionProviderDto = components['schemas']['AgentExecutionProviderDto'];
 export type PutCodeIntelligenceSettingsDto = components['schemas']['PutCodeIntelligenceSettingsDto'];
 export type CodeWikiGuidanceTopicDto = components['schemas']['CodeWikiGuidanceTopicDto'];
+export type PutCodeIntelligenceAgentMdDto = components['schemas']['PutCodeIntelligenceAgentMdDto'];
+export type CodeIntelligenceAgentMdDto = components['schemas']['CodeIntelligenceAgentMdDto'];
+export type CodeChatReadinessDto = components['schemas']['CodeChatReadinessDto'];
 export type CodeWikiGuidanceDto = components['schemas']['CodeWikiGuidanceDto'];
 export type WorkspaceConfigDto = components['schemas']['WorkspaceConfigDto'];
 export type DeliveryRoleConfigDto = components['schemas']['DeliveryRoleConfigDto'];
@@ -18671,6 +18791,130 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getCodeIntelligenceAgentMd: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Persisted agent.md */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeIntelligenceAgentMdDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off, or the caller is not a member */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    putCodeIntelligenceAgentMd: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PutCodeIntelligenceAgentMdDto"];
+            };
+        };
+        responses: {
+            /** @description Saved agent.md */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeIntelligenceAgentMdDto"];
+                };
+            };
+            /** @description Body missing or outside 1 to 12,000 characters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not an admin, or Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    regenerateCodeIntelligenceAgentMd: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Regenerated agent.md */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeIntelligenceAgentMdDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Caller is not an admin, or Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description No ready eligible index */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "No ready repository index is available to write the workspace agent file.",
+                     *       "code": "agent_md_not_ready"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getCodeIntelligenceTokenUsageSummary: {
         parameters: {
             query?: {
@@ -19070,6 +19314,53 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off, or a member sent the admin force body (`indexOnly` and `force` with no `repoIds`). */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    getCodeChatReadiness: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Readiness snapshot */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CodeChatReadinessDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "Code Intelligence is disabled for this workspace",
+                     *       "code": "code_intelligence_disabled"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
         };
     };
     getCodeChatIndex: {
@@ -19153,6 +19444,15 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -19162,12 +19462,23 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Index not ready */
+            /** @description Chat not ready, or no ready corpus for a repo-scoped thread */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Execution key required */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
             };
         };
     };
@@ -19259,6 +19570,15 @@ export interface operations {
                 };
             };
             401: components["responses"]["Unauthorized"];
+            /** @description Engineering Context Graph is off */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
             /** @description Not found */
             404: {
                 headers: {
@@ -19268,12 +19588,23 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorMessageDto"];
                 };
             };
-            /** @description Index not ready */
+            /** @description Chat not ready, or no ready corpus in thread scope */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            /** @description Execution key required */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
             };
         };
     };