@thinkai/tai-api-contract 2.116.0 → 2.118.0

package/src/generated/openapi.ts

@@ -3093,6 +3093,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/knowledge-pages/generate/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get live workspace context generation progress */
+        get: operations["getWorkspaceContextGenerationStatus"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/knowledge-pages/prd/generate": {
         parameters: {
             query?: never;
@@ -3113,6 +3130,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/knowledge-graph": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the persisted workspace knowledge graph
+         * @description Cross-repository graph (repo nodes and dependency edges) built when workspace knowledge pages are generated. Empty until the first successful generate.
+         */
+        get: operations["getWorkspaceKnowledgeGraph"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/knowledge-pages/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export workspace knowledge for local use
+         * @description Download workspace context as `WORKSPACE.md` (markdown) or a structured `wkg-pack` JSON bundle. Markdown rewrites `ecg://` deep links per `linkMode`.
+         */
+        get: operations["exportWorkspaceKnowledgePages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/code-intelligence/repo-wiki-json": {
         parameters: {
             query?: never;
@@ -8372,6 +8429,8 @@ export interface components {
         GenerateWorkspaceKnowledgePagesBodyDto: {
             /** @description Ready repository indexes to synthesize from. Omit or send empty for all ready indexes. */
             repoIds?: string[];
+            /** @description When true and execution keys are configured, run a deeper LLM pass to expand Key decisions with multi-repo citations (falls back to deterministic on failure). */
+            deepResearch?: boolean;
         };
         GenerateWorkspaceKnowledgePagesResultDto: {
             items: components["schemas"]["WorkspaceKnowledgePageDto"][];
@@ -8385,6 +8444,21 @@ export interface components {
             platformToolIds?: string[];
             usage?: components["schemas"]["CodeIntelligenceUsageDto"];
         };
+        WorkspaceContextGenerationStatusDto: {
+            /** @enum {string} */
+            phase: "inventory" | "facts" | "contracts" | "integrations" | "clustering" | "llm" | "persisted";
+            /** @enum {string} */
+            status: "running" | "complete" | "failed";
+            detail: string;
+            /** Format: date-time */
+            updatedAt: string;
+            partial?: {
+                repoCount?: number;
+                contractCount?: number;
+                groupCount?: number;
+                standaloneCount?: number;
+            };
+        };
         GeneratePrdDraftBodyDto: {
             /** @description Feature or change the PRD should describe */
             featureIntent: string;
@@ -8410,6 +8484,7 @@ export interface components {
             id: string;
             /** Format: uuid */
             workspaceId: string;
+            /** @description Page slug. `workspace-agent` is the canonical hub; supporting pages include `workspace-overview`, `cross-repo-map`, `shared-concepts`, and `prd-*` drafts. */
             slug: string;
             title: string;
             bodyMd: string;
@@ -8444,11 +8519,158 @@ export interface components {
             platformMissingToolIds: string[];
             /** @description Bounded markdown summary of platform evidence for the system panel */
             platformSnippet?: string;
+            insights?: components["schemas"]["WorkspaceContextInsightsDto"];
+        };
+        WorkspaceContextInsightsDto: {
+            /** @enum {string} */
+            kind: "workspace-insights";
+            /** @enum {integer} */
+            version: 2;
+            /** Format: date-time */
+            generatedAt: string;
+            repoRoles: {
+                /** Format: uuid */
+                repoId: string;
+                repoName: string;
+                role: string;
+                rationale: string;
+            }[];
+            emergentInsights: {
+                kind: string;
+                title: string;
+                detail: string;
+                repoIds: string[];
+                /** @enum {string} */
+                certainty: "fact" | "inference" | "possibility";
+                evidenceRefs?: string[];
+            }[];
+            sharedConcepts: {
+                term: string;
+                repoNames: string[];
+                kind: string;
+            }[];
+            crossRepoLinks: components["schemas"]["WorkspaceKnowledgeCrossRepoLinkDto"][];
+            contracts: {
+                id: string;
+                kind: string;
+                specKey: string;
+                producers: {
+                    [key: string]: unknown;
+                }[];
+                consumers: {
+                    [key: string]: unknown;
+                }[];
+                /** @enum {string} */
+                certainty: "fact" | "inference" | "possibility";
+                score: number;
+            }[];
+            groups: {
+                id: string;
+                kind: string;
+                label: string;
+                repoIds: string[];
+                backboneContractIds: string[];
+                possibilityLinkCount: number;
+                integrationSummary: string;
+                summary: string;
+            }[];
+            standaloneRepos: {
+                /** Format: uuid */
+                repoId: string;
+                repoName: string;
+                summary: string;
+            }[];
+            coverage: {
+                /** Format: uuid */
+                repoId: string;
+                detected: number;
+                resolved: number;
+                external: number;
+                unresolved: number;
+            }[];
+            integrationFootprints: {
+                /** Format: uuid */
+                repoId: string;
+                repoName: string;
+                availableSignals: string[];
+                missingSignals: string[];
+                gaps: string[];
+            }[];
+            integrationOpportunities: string[];
         };
         WorkspaceKnowledgePageListDto: {
             items: components["schemas"]["WorkspaceKnowledgePageDto"][];
             systemContext?: components["schemas"]["WorkspaceKnowledgeSystemContextDto"];
         };
+        WorkspaceKnowledgeGraphNodeDto: {
+            id: string;
+            label: string;
+            score?: number;
+            contractId?: string;
+            /** @enum {string} */
+            kind: "repo" | "package" | "protocol";
+        };
+        WorkspaceKnowledgeGraphEdgeDto: {
+            /** @description Source node id (usually repoId) */
+            from: string;
+            /** @description Target node id (usually repoId) */
+            to: string;
+            relation: string;
+            label?: string;
+            /** @enum {string} */
+            certainty?: "fact" | "inference" | "possibility";
+        };
+        WorkspaceKnowledgeGraphDto: {
+            /** @enum {string} */
+            kind: "workspace-kg";
+            version: number;
+            /** Format: date-time */
+            exportedAt: string;
+            nodes: components["schemas"]["WorkspaceKnowledgeGraphNodeDto"][];
+            edges: components["schemas"]["WorkspaceKnowledgeGraphEdgeDto"][];
+        };
+        WorkspaceKnowledgeCrossRepoLinkDto: {
+            /** Format: uuid */
+            fromRepoId: string;
+            /** Format: uuid */
+            toRepoId: string;
+            fromRepoName?: string;
+            toRepoName?: string;
+            relation: string;
+            /** @enum {string} */
+            certainty: "fact" | "inference" | "possibility";
+            evidence: string;
+            label: string;
+        };
+        WorkspaceKnowledgePackRepoDto: {
+            /** Format: uuid */
+            repoId: string;
+            repoName: string;
+            commitSha?: string | null;
+            providerSlug?: string | null;
+            wikiOutline?: {
+                slug: string;
+                title: string;
+            }[];
+        };
+        WorkspaceKnowledgePackPageDto: {
+            slug: string;
+            title: string;
+            bodyMd: string;
+        };
+        WorkspaceKnowledgePackDto: {
+            /** @enum {string} */
+            kind: "wkg-pack";
+            version: number;
+            /** Format: date-time */
+            exportedAt: string;
+            workspaceName?: string;
+            pages: components["schemas"]["WorkspaceKnowledgePackPageDto"][];
+            crossRepoLinks: components["schemas"]["WorkspaceKnowledgeCrossRepoLinkDto"][];
+            repos: components["schemas"]["WorkspaceKnowledgePackRepoDto"][];
+            graph?: components["schemas"]["WorkspaceKnowledgeGraphDto"];
+            workspaceContext?: components["schemas"]["WorkspaceContextInsightsDto"];
+        };
         CodeIntelligenceUsageDto: {
             /** @description Ledger operation key (code_chat, prd_generate, workspace_kb, wiki_json_outline, wiki_enrich, …) */
             operation: string;
@@ -9465,11 +9687,20 @@ export type RepoWikiJsonSummaryDto = components['schemas']['RepoWikiJsonSummaryD
 export type RepoWikiJsonSummaryListDto = components['schemas']['RepoWikiJsonSummaryListDto'];
 export type GenerateWorkspaceKnowledgePagesBodyDto = components['schemas']['GenerateWorkspaceKnowledgePagesBodyDto'];
 export type GenerateWorkspaceKnowledgePagesResultDto = components['schemas']['GenerateWorkspaceKnowledgePagesResultDto'];
+export type WorkspaceContextGenerationStatusDto = components['schemas']['WorkspaceContextGenerationStatusDto'];
 export type GeneratePrdDraftBodyDto = components['schemas']['GeneratePrdDraftBodyDto'];
 export type GeneratePrdDraftResultDto = components['schemas']['GeneratePrdDraftResultDto'];
 export type WorkspaceKnowledgePageDto = components['schemas']['WorkspaceKnowledgePageDto'];
 export type WorkspaceKnowledgeSystemContextDto = components['schemas']['WorkspaceKnowledgeSystemContextDto'];
+export type WorkspaceContextInsightsDto = components['schemas']['WorkspaceContextInsightsDto'];
 export type WorkspaceKnowledgePageListDto = components['schemas']['WorkspaceKnowledgePageListDto'];
+export type WorkspaceKnowledgeGraphNodeDto = components['schemas']['WorkspaceKnowledgeGraphNodeDto'];
+export type WorkspaceKnowledgeGraphEdgeDto = components['schemas']['WorkspaceKnowledgeGraphEdgeDto'];
+export type WorkspaceKnowledgeGraphDto = components['schemas']['WorkspaceKnowledgeGraphDto'];
+export type WorkspaceKnowledgeCrossRepoLinkDto = components['schemas']['WorkspaceKnowledgeCrossRepoLinkDto'];
+export type WorkspaceKnowledgePackRepoDto = components['schemas']['WorkspaceKnowledgePackRepoDto'];
+export type WorkspaceKnowledgePackPageDto = components['schemas']['WorkspaceKnowledgePackPageDto'];
+export type WorkspaceKnowledgePackDto = components['schemas']['WorkspaceKnowledgePackDto'];
 export type CodeIntelligenceUsageDto = components['schemas']['CodeIntelligenceUsageDto'];
 export type CodeIntelligenceTokenUsageByOperationDto = components['schemas']['CodeIntelligenceTokenUsageByOperationDto'];
 export type CodeIntelligenceTokenUsageByRepoDto = components['schemas']['CodeIntelligenceTokenUsageByRepoDto'];
@@ -17620,6 +17851,29 @@ export interface operations {
             };
         };
     };
+    getWorkspaceContextGenerationStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current or most recent workspace context generation phase */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceContextGenerationStatusDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     generatePrdDraft: {
         parameters: {
             query?: never;
@@ -17668,6 +17922,85 @@ export interface operations {
             };
         };
     };
+    getWorkspaceKnowledgeGraph: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspace knowledge graph */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceKnowledgeGraphDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Graph not generated yet */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    exportWorkspaceKnowledgePages: {
+        parameters: {
+            query?: {
+                format?: "markdown" | "wkg-pack" | "zip";
+                /** @description How to rewrite ecg:// links in markdown export */
+                linkMode?: "github" | "platform" | "relative";
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Export payload (markdown body or wkg-pack JSON) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/markdown": string;
+                    "application/json": components["schemas"]["WorkspaceKnowledgePackDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Code Intelligence is disabled for this workspace */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No workspace knowledge pages to export */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description ZIP export not implemented (use markdown or wkg-pack) */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listRepoWikiJsonSummaries: {
         parameters: {
             query?: never;