feat: govern knowledge assets and source citations

2026-08-02 01:43:43 +08:00
parent cafb836cda
commit 699cc08050
144 changed files with 17205 additions and 453 deletions
@@ -119,6 +119,9 @@ export interface KnowledgeSnippet {
  status?: string | null;
  occurredAt?: string | null;
  updatedAt?: string | null;
+  mediaType?: KnowledgeCitation['mediaType'];
+  detailRef?: string | null;
+  locatorSummary?: KnowledgeCitation['locatorSummary'];
 }

 export interface KnowledgeDoc {
@@ -176,6 +179,36 @@ export interface KnowledgeCitation {
  status?: string | null;
  occurredAt?: string | null;
  updatedAt?: string | null;
+  mediaType?: 'TEXT' | 'PDF' | 'DOCX' | 'PPTX' | 'XLSX' | 'IMAGE' | 'VIDEO' | string | null;
+  detailRef?: string | null;
+  locatorSummary?: {
+    pageNumber?: number | null;
+    slideNumber?: number | null;
+    paragraphStart?: number | null;
+    paragraphEnd?: number | null;
+    sheetName?: string | null;
+    rowStart?: number | null;
+    rowEnd?: number | null;
+    startMs?: number | null;
+    endMs?: number | null;
+    frameMs?: number | null;
+  } | null;
+}
+
+export interface KnowledgeCitationTextSegment {
+  index: number;
+  text: string;
+  target: boolean;
+}
+
+export interface KnowledgeCitationDetail {
+  mediaType: 'TEXT' | 'PDF' | 'DOCX' | 'PPTX' | 'XLSX' | 'IMAGE' | 'VIDEO' | string;
+  title: string;
+  locator?: KnowledgeCitation['locatorSummary'];
+  snippet: string;
+  segments: KnowledgeCitationTextSegment[];
+  contentUrl?: string | null;
+  originalUrl?: string | null;
 }

 export interface KnowledgeResource {