@thinkai/tai-api-contract 2.116.0 → 2.119.0

package/package.json

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

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;
@@ -3867,6 +3924,26 @@ export interface paths {
         patch: operations["patchWorkspaceZenHrBranch"];
         trace?: never;
     };
+    "/workspaces/{workspaceId}/ingest-coverage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Ingest / backfill data coverage
+         * @description Read-only snapshot of historical ingest coverage for connected pipelines (productivity GitHub, AI usage/spend per provider, SDLC components, monitoring, HRIS). Aggregates existing watermarks and stored day/week evidence — does not trigger ingest or refresh. Requires workspace membership. Disconnected sources are omitted.
+         */
+        get: operations["getWorkspaceIngestCoverage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/hris/status": {
         parameters: {
             query?: never;
@@ -7594,6 +7671,115 @@ export interface components {
              */
             syncedAt: string | null;
         };
+        IngestCoverageGapDto: {
+            /** @description Inclusive gap start (ISO date or UTC Monday week start). */
+            from: string;
+            /** @description Inclusive gap end (ISO date or UTC Monday week start). */
+            to: string;
+        };
+        IngestCoverageLastRunDto: {
+            /** Format: date-time */
+            startedAt?: string | null;
+            /** Format: date-time */
+            completedAt?: string | null;
+            /** Format: int64 */
+            durationMs?: number | null;
+            /** @description Pipeline-specific run mode (e.g. recent, historical, refresh). */
+            mode?: string | null;
+            /** @enum {string|null} */
+            outcome?: "ok" | "failed" | "in_progress" | null;
+        };
+        IngestCoverageProductivityRepoDto: {
+            slug: string;
+            /** @enum {string} */
+            queueStatus: "pending" | "complete" | "failed" | "skipped";
+            weeksWithData?: number | null;
+            earliestWeek?: string | null;
+            latestWeek?: string | null;
+            missingWeeks?: number | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            lastErrorKind?: string | null;
+        };
+        IngestCoverageProductivityDetailDto: {
+            /** @enum {string|null} */
+            phase?: "recent" | "historical" | "complete" | null;
+            historicalWeekStart?: string | null;
+            pendingRepoCount?: number;
+            skippedRepoCount?: number;
+            failedRepoCount?: number;
+            coveragePercent?: number | null;
+            repos?: components["schemas"]["IngestCoverageProductivityRepoDto"][];
+        };
+        IngestCoverageFactFamilyDto: {
+            /** @enum {string} */
+            id: "daily_usage" | "spend_daily" | "model_daily" | "product_daily";
+            expectedDays?: number;
+            daysPresent?: number;
+            ingestedFrom?: string | null;
+            ingestedTo?: string | null;
+            missingDayCount?: number;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+        };
+        IngestCoverageAiDetailDto: {
+            factFamilies?: components["schemas"]["IngestCoverageFactFamilyDto"][];
+            refreshInProgress?: boolean;
+        };
+        IngestCoverageSdlcComponentDto: {
+            /** @enum {string} */
+            id: "rollup" | "security_ingest" | "governance_github" | "governance_auditor" | "financial_ingest" | "cost_refresher";
+            latestBucketDate?: string | null;
+            lookbackDays?: number;
+            mode?: string | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            missingCount?: number | null;
+            /** Format: date-time */
+            lastSuccessAt?: string | null;
+            /** Format: int64 */
+            staleForMs?: number | null;
+            isStale?: boolean;
+        };
+        IngestCoverageSdlcDetailDto: {
+            components?: components["schemas"]["IngestCoverageSdlcComponentDto"][];
+        };
+        IngestCoverageSyncDetailDto: {
+            provider?: string;
+            /** @enum {string} */
+            syncStatus?: "ok" | "error" | "never";
+        };
+        IngestCoveragePipelineDto: {
+            id: string;
+            /** @enum {string} */
+            kind: "productivity_github" | "ai_usage" | "sdlc_github" | "monitoring" | "hris";
+            provider?: string | null;
+            /** @enum {string} */
+            status: "not_started" | "backfilling" | "incremental" | "complete" | "failed" | "in_progress";
+            targetWindowDays: number;
+            ingestedFrom?: string | null;
+            ingestedTo?: string | null;
+            progressPercent?: number | null;
+            /** Format: date-time */
+            lastSuccessAt?: string | null;
+            /** Format: date-time */
+            lastAttemptAt?: string | null;
+            lastErrorKind?: string | null;
+            lastErrorMessage?: string | null;
+            /** Format: int64 */
+            staleForMs?: number | null;
+            isStale: boolean;
+            dataLagDays?: number | null;
+            gaps?: components["schemas"]["IngestCoverageGapDto"][];
+            missingCount?: number | null;
+            lastRun?: components["schemas"]["IngestCoverageLastRunDto"];
+            productivity?: components["schemas"]["IngestCoverageProductivityDetailDto"];
+            ai?: components["schemas"]["IngestCoverageAiDetailDto"];
+            sdlc?: components["schemas"]["IngestCoverageSdlcDetailDto"];
+            sync?: components["schemas"]["IngestCoverageSyncDetailDto"];
+        };
+        IngestCoverageDto: {
+            pipelines: components["schemas"]["IngestCoveragePipelineDto"][];
+            /** Format: date-time */
+            generatedAt?: string;
+        };
         HrisSyncStatusDto: {
             /** @description Provider identifier (e.g. 'personio', 'zenhr'). */
             provider: string;
@@ -7876,7 +8062,7 @@ export interface components {
         InsightsResponseMeta: {
             /**
              * Format: date-time
-             * @description ISO timestamp when numbers were computed server-side
+             * @description ISO timestamp when numbers were computed server-side. An empty string means the workspace has no successful AI-tool refresh or productivity ingest timestamp yet.
              */
             syncedAt: string;
             /**
@@ -8372,6 +8558,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 +8573,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 +8613,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 +8648,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;
@@ -9375,6 +9726,17 @@ export type ActivityLogActorDto = components['schemas']['ActivityLogActorDto'];
 export type ActivityLogEntryDto = components['schemas']['ActivityLogEntryDto'];
 export type WorkspaceAbsenceDto = components['schemas']['WorkspaceAbsenceDto'];
 export type WorkspaceAbsenceListDto = components['schemas']['WorkspaceAbsenceListDto'];
+export type IngestCoverageGapDto = components['schemas']['IngestCoverageGapDto'];
+export type IngestCoverageLastRunDto = components['schemas']['IngestCoverageLastRunDto'];
+export type IngestCoverageProductivityRepoDto = components['schemas']['IngestCoverageProductivityRepoDto'];
+export type IngestCoverageProductivityDetailDto = components['schemas']['IngestCoverageProductivityDetailDto'];
+export type IngestCoverageFactFamilyDto = components['schemas']['IngestCoverageFactFamilyDto'];
+export type IngestCoverageAiDetailDto = components['schemas']['IngestCoverageAiDetailDto'];
+export type IngestCoverageSdlcComponentDto = components['schemas']['IngestCoverageSdlcComponentDto'];
+export type IngestCoverageSdlcDetailDto = components['schemas']['IngestCoverageSdlcDetailDto'];
+export type IngestCoverageSyncDetailDto = components['schemas']['IngestCoverageSyncDetailDto'];
+export type IngestCoveragePipelineDto = components['schemas']['IngestCoveragePipelineDto'];
+export type IngestCoverageDto = components['schemas']['IngestCoverageDto'];
 export type HrisSyncStatusDto = components['schemas']['HrisSyncStatusDto'];
 export type HrisSyncStatusListDto = components['schemas']['HrisSyncStatusListDto'];
 export type ZenHrReconnectResultDto = components['schemas']['ZenHrReconnectResultDto'];
@@ -9465,11 +9827,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 +17991,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 +18062,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;
@@ -19377,6 +19850,30 @@ export interface operations {
             503: components["responses"]["ZenHrSyncInProgress"];
         };
     };
+    getWorkspaceIngestCoverage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ingest coverage for connected pipelines */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestCoverageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     getHrisSyncStatus: {
         parameters: {
             query?: never;