@icen.ai/ui 0.8.1 → 0.10.0

package/dist/behaviors/kb-core.d.mts

@@ -0,0 +1,534 @@
+export { h, svgIcon } from './ai-core.js';
+
+/** 来源类型（内置 10 种；registerKbSourceType 开放扩展，镜像 ai-core 的 kind 注册表） */
+type KbSourceKind = 'doc' | 'web' | 'wiki' | 'sheet' | 'db' | 'ticket' | 'code' | 'api' | 'image' | 'mail';
+interface KbSourceTypeDef {
+    label: string;
+    /** 单色线性 svg（16×16 viewBox 24 的 path 集，经 svgIcon 消毒） */
+    icon: string;
+}
+/** 开放注册来源类型（自定义连接器的图标与名称；覆盖同名内置） */
+declare function registerKbSourceType(name: string, def: KbSourceTypeDef): void;
+declare function unregisterKbSourceType(name: string): void;
+declare function getKbSourceType(name: string | undefined): KbSourceTypeDef;
+declare function listKbSourceTypes(): string[];
+/** 引用定位三分型（Anthropic Citations 契约）：span 单位在 kind 上写死，防字符/字节错位 */
+interface KbLocation {
+    kind: 'char' | 'page' | 'block';
+    start: number;
+    end: number;
+    /** 仅 char 型需要声明（gemini 字节教训）：缺省 char */
+    unit?: 'char' | 'byte';
+}
+type KbPermission = 'readable' | 'restricted' | 'requestable';
+type KbScoreKind = 'cosine' | 'dot' | 'ip' | 'l2' | 'bm25' | 'rrf' | 'dbsf' | 'rerank' | 'hybrid';
+/** 引用/来源对象（hover 卡、来源列表、passage 查看器的公共数据单元） */
+interface KbCitation {
+    id: string;
+    /** 展示编号（来源列表中的 [n]；渲染端负责与正文角标对齐） */
+    index?: number;
+    title: string;
+    url?: string;
+    kind?: string;
+    /** 逐字原文引用（≤150 字符为宜；受限时置空） */
+    citedText?: string;
+    /** 摘录（列表用，可长于 citedText） */
+    snippet?: string;
+    date?: string;
+    score?: number | null;
+    scoreKind?: KbScoreKind;
+    official?: boolean;
+    permission?: KbPermission;
+    /** 文档责任人（企业常见：找谁确认口径） */
+    owner?: string;
+    loc?: KbLocation;
+    documentId?: string;
+    /** 被引次数（来源列表排序用） */
+    useCount?: number;
+}
+declare function normalizeCitation(raw: KbCitation | Record<string, unknown>): KbCitation;
+/** 正文 `[3]` / `[web:3]` 的切段结果：text 段与编号段交替 */
+interface KbCiteSegment {
+    text: string;
+    /** 编号段的序号（无则纯文本段） */
+    n?: number;
+}
+/** 累积文本切段（流式安全：delta 边界处的 `[3` 自然留在文本段，补全后下一次切段生效） */
+declare function parseInlineCitations(text: string): KbCiteSegment[];
+declare function collectCitationNumbers(text: string): number[];
+declare const KB_SCORE_KINDS: readonly KbScoreKind[];
+/** 该分数语义下「越大越好」还是「越小越好」（跨模型不可比，UI 严禁基数解读） */
+declare function scoreHigherIsBetter(kind: KbScoreKind | undefined): boolean;
+/** null / 非有限 → '—'（无分命中是一等状态，不是异常） */
+declare function formatScore(v: number | null | undefined, digits?: number): string;
+/** 分数条宽度占比（0–100；l2 反向归一；无值返回 null 不渲染条） */
+declare function scorePercent(v: number | null | undefined, kind?: KbScoreKind, max?: number): number | null;
+interface KbChunk {
+    id: string;
+    documentId: string;
+    content: string;
+    keywords?: string[];
+    /** available=false：不删除但排除出检索（RAGFlow 语义） */
+    available: boolean;
+    page?: number;
+    start?: number;
+    end?: number;
+    imageId?: string;
+    meta?: Record<string, string | number>;
+    edited?: boolean;
+}
+declare function normalizeChunk(raw: Record<string, unknown>): KbChunk;
+type KbRunStatus = 'unstart' | 'queued' | 'running' | 'cancel' | 'done' | 'fail';
+declare const KB_RUN_STATUSES: readonly KbRunStatus[];
+declare function kbRunStatusLabel(s: KbRunStatus): string;
+interface KbPipelineStep {
+    key: string;
+    label: string;
+    status: KbRunStatus;
+    detail?: string;
+    elapsedMs?: number;
+    count?: number;
+}
+interface KbPipelineRun {
+    documentId: string;
+    title?: string;
+    status: KbRunStatus;
+    /** 0–100（可选：无细粒度进度时缺省，用步骤状态表达） */
+    progress?: number;
+    steps: KbPipelineStep[];
+    chunkCount?: number;
+    elapsedMs?: number;
+    error?: {
+        stage?: string;
+        message: string;
+    };
+}
+declare function normalizePipelineRun(raw: Record<string, unknown>): KbPipelineRun;
+interface KbSyncMetrics {
+    added?: number;
+    updated?: number;
+    deleted?: number;
+    failed?: number;
+    lastSyncAt?: string;
+}
+type KbConnectorHealth = 'healthy' | 'stale' | 'failing' | 'off';
+interface KbConnector {
+    id: string;
+    name: string;
+    kind?: string;
+    scope?: string;
+    enabled: boolean;
+    lastSyncAt?: string;
+    lastCrawlStatus?: 'ok' | 'fail' | 'none';
+    itemsSynced?: number;
+    /** 24h 抓取速率（条/天） */
+    crawlRate?: number;
+    /** 变更速率（webhook 健康信号：持续 0 = 变更通道失效） */
+    changeRate?: number;
+    credential?: 'ok' | 'expired' | 'none';
+    schedule?: string;
+    metrics?: KbSyncMetrics;
+}
+declare function normalizeConnector(raw: Record<string, unknown>): KbConnector;
+/** 健康判定（不可逆优先级：off < failing < stale < healthy；停滞阈值 24h） */
+declare function connectorHealth(c: KbConnector, now?: Date): KbConnectorHealth;
+type KbCleanOption = 'collapse-blank' | 'strip-url' | 'strip-email';
+declare const KB_CLEAN_OPTIONS: readonly KbCleanOption[];
+interface KbSegmentConfig {
+    mode: 'auto' | 'custom' | 'parent-child';
+    delimiter?: string;
+    maxLength: number;
+    overlap: number;
+    clean: KbCleanOption[];
+    /** 模式创建后锁定（Dify 纪律：模式不可改、参数可调） */
+    locked?: boolean;
+}
+declare function normalizeSegmentConfig(raw?: Partial<KbSegmentConfig>): KbSegmentConfig;
+/**
+ * 纯函数分段预览（真实切分非估算）：清洗 → 分隔符切 → 超长块按 maxLength/overlap 二次切。
+ * parent-child 模式返回父段（分隔符级），子段由 maxLength 切分交给渲染端二级展示。
+ */
+declare function segmentText(text: string, config: KbSegmentConfig): string[];
+interface KbSegmentStats {
+    count: number;
+    avgLength: number;
+    /** tokens 粗估（≈ 字符/2，中英混排经验值；标注「≈」） */
+    tokensEstimate: number;
+}
+declare function segmentStats(chunks: string[]): KbSegmentStats;
+interface KbRetrievalHit {
+    chunkId: string;
+    documentId?: string;
+    title?: string;
+    snippet: string;
+    score?: number | null;
+    scoreKind?: KbScoreKind;
+    /** 分数拆解（Weaviate explainScore 纪律）：向量分 / 关键词分占比 */
+    vectorPart?: number;
+    keywordPart?: number;
+    explain?: string;
+    page?: number;
+    meta?: Record<string, string | number>;
+}
+declare function normalizeHit(raw: Record<string, unknown>): KbRetrievalHit;
+interface KbRetrievalParams {
+    topK: number;
+    mode: 'vector' | 'keyword' | 'hybrid';
+    /** hybrid：语义权重 0–1（1=纯语义） */
+    alpha?: number;
+    rerank?: boolean;
+    rerankModel?: string;
+    /** null = 不启用阈值（未启用 rerank 时阈值无效 → 渲染端显示 N/A） */
+    threshold?: number | null;
+}
+declare function normalizeRetrievalParams(raw?: Partial<KbRetrievalParams>): KbRetrievalParams;
+/** 检索请求的完整形态（playground 与生产共用同一契约，DSL 可复制） */
+interface KbRetrievalQuery {
+    query: string;
+    params: KbRetrievalParams;
+    filter?: KbFilterNode | null;
+}
+type KbFilterOp = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'contains' | 'exists';
+declare const KB_FILTER_OPS: readonly KbFilterOp[];
+type KbFilterNode = {
+    type: 'group';
+    op: 'and' | 'or';
+    children: KbFilterNode[];
+} | {
+    type: 'rule';
+    field: string;
+    op: KbFilterOp;
+    value?: string | number | boolean | Array<string | number>;
+};
+declare function normalizeFilterNode(raw: unknown): KbFilterNode | null;
+declare function filterToMongo(node: KbFilterNode | null | undefined): Record<string, unknown> | null;
+declare function filterToOData(node: KbFilterNode | null | undefined): string;
+interface KbRerankItem {
+    /** 稳定 key（chunk id；rerank 响应的 index 不足以跨请求稳定 join） */
+    key: string;
+    title?: string;
+    before?: {
+        rank: number;
+        score?: number | null;
+    };
+    after?: {
+        rank: number;
+        score?: number | null;
+    };
+}
+/** 排名变化：正 = 下降 n 位，负 = 上升 n 位（箭头语义由渲染端定） */
+declare function rerankDelta(item: KbRerankItem): number | null;
+interface KbHitTestCase {
+    id: string;
+    question: string;
+    expectedChunkIds?: string[];
+    lastHits?: Array<{
+        chunkId: string;
+        score?: number | null;
+        rank?: number;
+    }>;
+    passed?: boolean;
+    pinned?: boolean;
+}
+interface KbHitStats {
+    total: number;
+    passed: number;
+    /** 无 case 或未跑过 → null（不是 0） */
+    hitRate: number | null;
+    avgScore: number | null;
+}
+declare function hitTestStats(cases: KbHitTestCase[]): KbHitStats;
+interface KbSqlQuery {
+    sql: string;
+    dialect?: string;
+    tables?: string[];
+    /** SQL 可见性是权限问题（Vanna/Genie 纪律），不是展示偏好 */
+    visibility: 'all' | 'admin';
+    editable: boolean;
+    /** 修正循环：上一版 SQL（存在且报错时渲染 diff 修复卡） */
+    prevSql?: string;
+    reasoning?: string;
+}
+declare function normalizeSqlQuery(raw: Partial<KbSqlQuery>): KbSqlQuery;
+interface KbQueryResult {
+    columns: Array<{
+        name: string;
+        type?: string;
+    }>;
+    rows: Array<Array<string | number | null>>;
+    totalRows?: number;
+    /** 截断是契约不是 bug（WrenAI row-limit 纪律）：true 必须显示声明 */
+    truncated: boolean;
+    limit?: number;
+    rowCount: number;
+    durationMs?: number;
+    exportFormats?: string[];
+}
+declare function normalizeQueryResult(raw: Partial<KbQueryResult>): KbQueryResult;
+interface KbClarification {
+    id?: string;
+    question: string;
+    options: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** 为什么反问（弱化展示：口径歧义/缺时间范围…） */
+    reason?: string;
+}
+type KbAnswerKind = 'generated' | 'verified';
+interface KbVerifiedVia {
+    assetId: string;
+    assetType: 'parameterized-query' | 'function' | 'curated';
+    note?: string;
+}
+interface KbExplainFact {
+    tables?: string[];
+    columns?: string[];
+    filters?: string[];
+    aggregates?: string[];
+    /** 命中的指标口径（可深链语义层定义） */
+    metrics?: Array<{
+        name: string;
+        ref?: string;
+    }>;
+}
+interface KbPermissionNotice {
+    rowLevelPolicy?: string;
+    maskedColumns?: string[];
+}
+type KbSpanKind = 'retrieval' | 'generation' | 'rerank' | 'embed' | 'tool' | 'guard' | 'chunk' | 'query' | 'agent';
+declare const KB_SPAN_KINDS: readonly KbSpanKind[];
+declare function kbSpanKindLabel(k: KbSpanKind): string;
+type KbSpanStatus = 'running' | 'done' | 'error' | 'cancel';
+declare const KB_SPAN_STATUSES: readonly KbSpanStatus[];
+interface KbSpan {
+    id: string;
+    parentId?: string;
+    kind: KbSpanKind;
+    name: string;
+    status: KbSpanStatus;
+    startedAt?: number | string;
+    elapsedMs?: number;
+    detail?: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        costUsd?: number;
+    };
+    /** retrieval span 内嵌命中（差异化的核心展示） */
+    hits?: KbRetrievalHit[];
+    error?: string;
+}
+declare function normalizeSpans(raw: Array<Record<string, unknown>>): KbSpan[];
+interface KbScoreConfig {
+    name: string;
+    type: 'categorical' | 'numeric';
+    /** categorical 的选项（键盘 1–9 对应前 9 项） */
+    categories?: string[];
+    description?: string;
+}
+interface KbReviewTask {
+    id: string;
+    target: {
+        kind: 'trace' | 'message' | 'answer';
+        id: string;
+        label?: string;
+    };
+    status: 'open' | 'done';
+    assignee?: string;
+    scores?: Array<{
+        name: string;
+        value: string | number;
+    }>;
+}
+type KbEvalGrade = 'improvement' | 'regression' | 'tradeoff' | 'tie';
+interface KbEvalRow {
+    key: string;
+    input: string;
+    outputA?: string;
+    outputB?: string;
+    expected?: string;
+    scoresA?: Record<string, number | null>;
+    scoresB?: Record<string, number | null>;
+}
+/** Summary 判级（Braintrust 心智）：分数提升但成本/时延恶化 → tradeoff */
+declare function evalGrade(scoreDelta: number | null, costDeltaPct?: number | null, latencyDeltaPct?: number | null): KbEvalGrade;
+declare function meanScore(scores: Record<string, number | null> | undefined): number | null;
+declare function deltaLabel(v: number | null | undefined, digits?: number): string;
+interface KbGapQuery {
+    text: string;
+    count: number;
+    shareOfAllQueries?: number;
+    zeroClickRate?: number;
+    lastSeenAt?: string;
+}
+type KbCheckpointScope = 'content' | 'conversation' | 'both';
+interface KbCheckpoint {
+    id: string;
+    label?: string;
+    at: string | number;
+    reason?: string;
+    scopeOptions?: KbCheckpointScope[];
+}
+interface KbChainStep {
+    key: string;
+    label: string;
+    status: 'pending' | 'running' | 'done' | 'error';
+    detail?: string;
+}
+interface KbCanvasVersion {
+    id: string;
+    label?: string;
+    at: string | number;
+    current?: boolean;
+}
+interface KbCanvasSelection {
+    text: string;
+}
+interface KbSandboxMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+/** 角色四档（Drive 范式，权限序单调：viewer < commenter < editor < owner） */
+type KbRole = 'viewer' | 'commenter' | 'editor' | 'owner';
+declare const KB_ROLES: readonly KbRole[];
+declare function kbRoleLabel(r: KbRole | null): string;
+/** 权限序比较：roleA ⊇ roleB（owner 最大） */
+declare function roleAtLeast(role: KbRole, floor: KbRole): boolean;
+/**
+ * 可见性五级（调研结论：四维授权求值后的「输出状态」，非独立开关）。
+ * hidden=检索/列表/计数都不出现（security trimming）｜metadata=知道存在（锁+标题）｜
+ * restricted=metadata+申请通道｜summary=AI 摘要可见原文受限（新一代层级）｜full=内容态
+ */
+type KbVisibility = 'hidden' | 'metadata' | 'restricted' | 'summary' | 'full';
+declare const KB_VISIBILITIES: readonly KbVisibility[];
+declare function kbVisibilityLabel(v: KbVisibility): string;
+/** 授权主体（组是一等主体——部门树不当 ACL 用，业界共识） */
+interface KbSubject {
+    kind: 'user' | 'group' | 'org' | 'anyone' | 'link';
+    id: string;
+    label: string;
+    /** 呈现注记：「24 成员 · 由 IT 管理」「系统自动」 */
+    note?: string;
+}
+interface KbAclEntry {
+    subject: KbSubject;
+    role: KbRole;
+    /** 继承来源（容器名）；缺省 = 直接授权 */
+    inheritedFrom?: string;
+    /** 到期一等公民：ISO 时间；到期自动回收 */
+    expiresAt?: string;
+    /** 显式拒绝（一票否决，置顶呈现） */
+    deny?: boolean;
+    /** 系统自动态（Limited Access 类）：不可手工增删 */
+    system?: boolean;
+}
+declare function normalizeAclEntry(raw: KbAclEntry | Record<string, unknown>): KbAclEntry;
+/** 请求身份（来自服务端验证 token 的固定身份集——不接受自由输入，Kendra 自报身份教训） */
+interface KbIdentity {
+    user: string;
+    groups: string[];
+    label?: string;
+    note?: string;
+}
+declare function normalizeIdentity(raw: KbIdentity | Record<string, unknown>): KbIdentity;
+/** 可见性策略（文档级）：discoverable=无权限时是否可发现（Drive allowFileDiscovery；企业内部缺省可见存在） */
+interface KbVisibilityPolicy {
+    discoverable?: boolean;
+    /** 无权限但 AI 摘要可见（L2.5，摘要权限 ≠ 原文权限） */
+    summaryAllowed?: boolean;
+}
+declare function visibilityForRole(role: KbRole | null, policy?: KbVisibilityPolicy): KbVisibility;
+/** 有效权限决策：结论 + 扁平原因链（SharePoint Check Permissions 范式） */
+interface KbAclDecision {
+    role: KbRole | null;
+    visibility: KbVisibility;
+    /** 命中的授权来源（deny 置顶；via: direct|inherit|link） */
+    chain: Array<{
+        entry: KbAclEntry;
+        via: 'direct' | 'inherit' | 'link';
+    }>;
+    /** 显式 deny 的一票否决来源（最强信号，UI 置顶红） */
+    deniedBy?: KbSubject;
+    /** 本决策中最近的将来到期（倒计时/续期入口的数据源） */
+    expiresAt?: string;
+}
+/**
+ * 有效权限求值（纯函数）：先显式 deny（一票否决）→ 再 allow 并集（角色取权限序最大）→ 默认拒绝。
+ * 多角色叠加语义 = SharePoint/Azure/Zanzibar 主流范式；first-match 是 NTFS 反教材，禁止。
+ *
+ * 到期一等公民（spec §9.0-7，到期自动回收）：expiresAt 已过的条目整体不计入求值
+ * （deny / allow 并集 / 原因链都视同不存在）；全部授权过期 = 无授权 → fail-closed。
+ * expiresAt 不可解析时视为永不过期（normalize 诚实缺省，不猜）。当前时间经 now 参数
+ * 注入（缺省 new Date()）——求值必须可测试、可复现，守卫脚本钉死此形态。
+ */
+declare function evaluateAcl(entries: Array<KbAclEntry | Record<string, unknown>>, identity: KbIdentity | Record<string, unknown>, policy?: KbVisibilityPolicy, now?: Date | number): KbAclDecision;
+/** 访问申请状态机（Entra entitlement 收敛到 UI 需要的 9 态） */
+type KbAccessState = 'idle' | 'requested' | 'pending_review' | 'granted' | 'expiring' | 'expired' | 'denied' | 'revoked';
+declare const KB_ACCESS_STATES: readonly KbAccessState[];
+declare function kbAccessStateLabel(s: KbAccessState): string;
+interface KbAccessRequest {
+    id: string;
+    requester: string;
+    resource: string;
+    role: KbRole;
+    reason?: string;
+    state: KbAccessState;
+    submittedAt: string;
+    /** 路由明示：请求将发送给谁（页面级找 owner / 空间级找 admin——Confluence 十年踩坑） */
+    approverNote?: string;
+    decidedBy?: string;
+    decidedAt?: string;
+    /** granted 的到期（一等公民；缺省 = 永不过期） */
+    expiresAt?: string;
+}
+declare function normalizeAccessRequest(raw: KbAccessRequest | Record<string, unknown>): KbAccessRequest;
+/** 审计动作（读取与预览分列是 Purview 范式；break_glass 审计粒度 ≥ 常规） */
+type KbAuditAction = 'read' | 'preview' | 'permission_change' | 'grant' | 'revoke' | 'request' | 'approve' | 'deny' | 'delegation' | 'break_glass' | 'sync';
+declare const KB_AUDIT_ACTIONS: readonly KbAuditAction[];
+declare function kbAuditActionLabel(a: KbAuditAction): string;
+/** 审计通道（时间线过滤维度） */
+type KbAuditChannel = 'read' | 'permission' | 'request' | 'system';
+declare const KB_AUDIT_CHANNELS: readonly KbAuditChannel[];
+declare function auditChannelOf(a: KbAuditAction): KbAuditChannel;
+interface KbAuditEntry {
+    id: string;
+    at: string;
+    actor: {
+        kind: 'human' | 'app' | 'system';
+        name: string;
+    };
+    action: KbAuditAction;
+    resource?: string;
+    detail: string;
+    /** 应急访问标记：行级警示 + 「实时告警已通知安全团队」 */
+    breakGlass?: boolean;
+}
+declare function normalizeAuditEntry(raw: KbAuditEntry | Record<string, unknown>): KbAuditEntry;
+/** 权限异味（治理发现）：6 种，均为「源系统权限卫生」问题——RAG 只是放大器 */
+type KbHygieneKind = 'org_wide_link' | 'broad_group' | 'sensitive_mismatch' | 'broken_inheritance' | 'orphaned_owner' | 'overexposed';
+declare const KB_HYGIENE_KINDS: readonly KbHygieneKind[];
+declare function kbHygieneLabel(k: KbHygieneKind): string;
+interface KbHygieneIssue {
+    id: string;
+    kind: KbHygieneKind;
+    resource: string;
+    /** 量化数字（不去重暴露面计数等） */
+    metric: string;
+    hint: string;
+    severity: 'high' | 'medium' | 'low';
+}
+declare function normalizeHygieneIssue(raw: KbHygieneIssue | Record<string, unknown>): KbHygieneIssue;
+declare function formatPercent(v: number | null | undefined, digits?: number): string;
+declare function formatCount(n: number | null | undefined): string;
+/** 相对时间（来源日期/同步时间/检查点通用）：'刚刚' / 'N 分钟前' / 'N 小时前' / 'N 天前' / 超过 30 天给日期 */
+declare function relativeTime(input: string | number | Date, now?: Date): string;
+
+export { KB_ACCESS_STATES, KB_AUDIT_ACTIONS, KB_AUDIT_CHANNELS, KB_CLEAN_OPTIONS, KB_FILTER_OPS, KB_HYGIENE_KINDS, KB_ROLES, KB_RUN_STATUSES, KB_SCORE_KINDS, KB_SPAN_KINDS, KB_SPAN_STATUSES, KB_VISIBILITIES, type KbAccessRequest, type KbAccessState, type KbAclDecision, type KbAclEntry, type KbAnswerKind, type KbAuditAction, type KbAuditChannel, type KbAuditEntry, type KbCanvasSelection, type KbCanvasVersion, type KbChainStep, type KbCheckpoint, type KbCheckpointScope, type KbChunk, type KbCitation, type KbCiteSegment, type KbClarification, type KbCleanOption, type KbConnector, type KbConnectorHealth, type KbEvalGrade, type KbEvalRow, type KbExplainFact, type KbFilterNode, type KbFilterOp, type KbGapQuery, type KbHitStats, type KbHitTestCase, type KbHygieneIssue, type KbHygieneKind, type KbIdentity, type KbLocation, type KbPermission, type KbPermissionNotice, type KbPipelineRun, type KbPipelineStep, type KbQueryResult, type KbRerankItem, type KbRetrievalHit, type KbRetrievalParams, type KbRetrievalQuery, type KbReviewTask, type KbRole, type KbRunStatus, type KbSandboxMessage, type KbScoreConfig, type KbScoreKind, type KbSegmentConfig, type KbSegmentStats, type KbSourceKind, type KbSourceTypeDef, type KbSpan, type KbSpanKind, type KbSpanStatus, type KbSqlQuery, type KbSubject, type KbSyncMetrics, type KbVerifiedVia, type KbVisibility, type KbVisibilityPolicy, auditChannelOf, collectCitationNumbers, connectorHealth, deltaLabel, evalGrade, evaluateAcl, filterToMongo, filterToOData, formatCount, formatPercent, formatScore, getKbSourceType, hitTestStats, kbAccessStateLabel, kbAuditActionLabel, kbHygieneLabel, kbRoleLabel, kbRunStatusLabel, kbSpanKindLabel, kbVisibilityLabel, listKbSourceTypes, meanScore, normalizeAccessRequest, normalizeAclEntry, normalizeAuditEntry, normalizeChunk, normalizeCitation, normalizeConnector, normalizeFilterNode, normalizeHit, normalizeHygieneIssue, normalizeIdentity, normalizePipelineRun, normalizeQueryResult, normalizeRetrievalParams, normalizeSegmentConfig, normalizeSpans, normalizeSqlQuery, parseInlineCitations, registerKbSourceType, relativeTime, rerankDelta, roleAtLeast, scoreHigherIsBetter, scorePercent, segmentStats, segmentText, unregisterKbSourceType, visibilityForRole };