@aiquants/enrichment-react 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import React$1, { ReactNode } from "react";
-import { ConfidentialityLevel, EnrichmentStageKey, SearchMode } from "@aiquants/enrichment-core";
+import { SearchDegradationReason, ConfidentialityLevel, PipelineRunStatus, PipelineStepKey, EnrichmentStageKey, SearchMode, ChunkSource, PipelinePhase, PipelineStepMetric, DocumentKind, StepGate, PipelineRunRecord, PipelineFlow, NothingToReadToken, PipelineStepStatus, PipelineTrigger } from "@aiquants/enrichment-core";
+import React$1, { ReactNode, JSX } from "react";
 interface SearchMetadataLike {
     is_degraded: boolean;
     search_mode: string;
@@ -10,7 +10,7 @@ interface DegradedSearchBannerProps {
     metadata: SearchMetadataLike;
     onDismiss?: () => void;
 }
-declare const REASON_LABELS: Readonly<Record<string, string>>;
+declare const REASON_LABELS: Readonly<Record<SearchDegradationReason, string>>;
 declare function DegradedSearchBanner({ metadata, onDismiss }: DegradedSearchBannerProps): React$1.JSX.Element | null;
 interface DocumentIngestLabel {
     labelKey: string;
@@ -34,6 +34,13 @@ interface FileInspectionResult {
     mtime: string | null;
     revisionId: string | null;
 }
+interface RecentIngestLastRun {
+    runId: number;
+    status: PipelineRunStatus;
+    retryScheduled: boolean;
+    failedStepKey: PipelineStepKey | null;
+    finishedAt: string | null;
+}
 interface RecentIngestItem {
     id: number;
     fileUri: string;
@@ -45,6 +52,11 @@ interface RecentIngestItem {
     createdAt: string;
     updatedAt: string;
     errorMessage?: string | null;
+    lastRun: RecentIngestLastRun | null;
+}
+interface IngestDomainOption {
+    readonly key: string;
+    readonly label: string;
 }
 type IngestRowAction = {
     readonly kind: "retry";
@@ -63,6 +75,7 @@ interface IngestCapabilityPolicy {
 interface DocumentIngestConsoleProps {
     tenantId: string;
     policies?: readonly IngestCapabilityPolicy[];
+    domainOptions: readonly IngestDomainOption[];
     recentItems?: RecentIngestItem[];
     inspectionResult?: FileInspectionResult | null;
     isSubmitting?: boolean;
@@ -70,8 +83,9 @@ interface DocumentIngestConsoleProps {
     onInspectUri?: (fileUri: string) => void;
     onIngestDocument?: (payload: DocumentIngestPayload) => void;
     onRetryItem?: (fileId: number) => void;
+    onShowHistory?: (metadataId: number) => void;
 }
-declare function DocumentIngestConsole({ policies, tenantId, recentItems, inspectionResult, isSubmitting, isInspecting, onInspectUri, onIngestDocument, onRetryItem }: DocumentIngestConsoleProps): ReactNode;
+declare function DocumentIngestConsole({ policies, tenantId, domainOptions, recentItems, inspectionResult, isSubmitting, isInspecting, onInspectUri, onIngestDocument, onRetryItem, onShowHistory }: DocumentIngestConsoleProps): ReactNode;
 type StrategyProvenance = "tenant" | "system";
 interface EnrichmentStrategyRow {
     id: number;
@@ -89,8 +103,8 @@ interface EnrichmentStrategyBoardProps {
     onToggleStage?: (row: EnrichmentStrategyRow, stage: EnrichmentStageKey, enabled: boolean) => void | Promise<void>;
     isUpdating?: boolean;
 }
-type GateState = "open" | "closed" | "unmeasured" | "absent";
-declare function gateStateOf(featureFlagKey: string | null, flags: Readonly<Record<string, boolean>>): GateState;
+type GateState$1 = "open" | "closed" | "unmeasured" | "absent";
+declare function gateStateOf(featureFlagKey: string | null, flags: Readonly<Record<string, boolean>>): GateState$1;
 declare function EnrichmentStrategyBoard({ strategies, featureFlags, onToggleStage, isUpdating }: EnrichmentStrategyBoardProps): React$1.JSX.Element;
 interface ServiceHealthStatus {
     serviceName: string;
@@ -188,22 +202,66 @@ interface MetadataSearchResult {
         circuit_breaker_status?: Record<string, string>;
     };
 }
+type CircuitBreakerState = "CLOSED" | "OPEN" | "HALF_OPEN";
 interface MetadataSearchWorkbenchProps {
     tenantId: string;
-    onSearch?: (params: MetadataSearchParams) => Promise<MetadataSearchResult>;
+    onSearch: (params: MetadataSearchParams) => Promise<MetadataSearchResult>;
     initialParams?: Partial<MetadataSearchParams>;
     initialResult?: MetadataSearchResult | null;
-    circuitBreakerStatus?: Record<string, "CLOSED" | "OPEN" | "HALF_OPEN">;
+    circuitBreakerStatus?: Record<string, CircuitBreakerState>;
     isLoading?: boolean;
 }
 interface DeveloperSearchPreset {
     id: string;
     title: string;
     description: string;
-    params: Partial<MetadataSearchParams>;
+    params: Pick<MetadataSearchParams, "mode" | "limit"> & Partial<Pick<MetadataSearchParams, "threshold" | "fusion" | "rrf_k">>;
 }
 declare const SEARCH_PRESETS: DeveloperSearchPreset[];
 declare function MetadataSearchWorkbench({ tenantId, onSearch, initialParams, initialResult, circuitBreakerStatus, isLoading: externalLoading }: MetadataSearchWorkbenchProps): React.JSX.Element;
+interface ComparisonVariant {
+    readonly strategyId: number;
+    readonly label: string;
+    readonly embeddingModel: string;
+}
+interface ComparisonHit {
+    readonly id: string;
+    readonly title: string;
+    readonly score: number;
+}
+interface ComparisonVariantResult {
+    readonly strategyId: number;
+    readonly executionMs: number;
+    readonly hits: readonly ComparisonHit[];
+}
+interface ComparisonInput {
+    readonly query: string;
+    readonly strategyIds: readonly [
+        number,
+        number
+    ];
+    readonly limit: number;
+}
+type ComparisonOutcome = {
+    readonly ok: true;
+    readonly results: readonly ComparisonVariantResult[];
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+interface ModelComparisonWorkbenchProps {
+    variants: readonly ComparisonVariant[];
+    onCompare: (input: ComparisonInput) => Promise<ComparisonOutcome>;
+}
+declare const SCORE_DISPLAY_DECIMALS = 4;
+declare function formatComparisonScore(score: number): string;
+interface RankAgreement {
+    readonly sharedCount: number;
+    readonly overlapRatio: number | null;
+    readonly meanAbsoluteRankDifference: number | null;
+}
+declare function rankAgreement(a: readonly string[], b: readonly string[]): RankAgreement;
+declare function ModelComparisonWorkbench({ variants, onCompare }: ModelComparisonWorkbenchProps): ReactNode;
 interface OntologyClassItem {
     name: string;
     description: string;
@@ -236,6 +294,104 @@ interface OntologyStatusCardProps {
     ontologyStatus: OntologyStatusData;
 }
 declare function OntologyStatusCard({ tenantId, ontologyStatus }: OntologyStatusCardProps): ReactNode;
+type StepGateState = "open" | "closed-skip" | "closed-fail" | "unmeasured";
+type GateState = "open" | "closed" | "unmeasured";
+type StepGatePolicy = "none" | "skip" | "fail" | "mixed";
+interface PipelineFlowViewerProps {
+    featureFlags: Readonly<Record<string, boolean>>;
+    metrics: readonly PipelineStepMetric[];
+    metricSampleWindow: number;
+    selectedKind?: DocumentKind;
+    onSelectKind?: (kind: DocumentKind) => void;
+    selectedStepKey?: PipelineStepKey | null;
+    onSelectStep?: (key: PipelineStepKey | null) => void;
+}
+declare const PHASE_LABELS: Readonly<Record<PipelinePhase, string>>;
+declare const CHUNK_SOURCE_LABELS: Readonly<Record<ChunkSource, string>>;
+declare const GATE_STATE_PRESENTATION: Readonly<Record<StepGateState, {
+    readonly badge: string;
+    readonly stroke: string;
+    readonly dash: string | undefined;
+}>>;
+declare const GATE_POLICY_LABELS: Readonly<Record<StepGatePolicy, string>>;
+declare function gateState(gate: StepGate, featureFlags: Readonly<Record<string, boolean>>): GateState;
+declare function stepGateState(gates: readonly StepGate[], featureFlags: Readonly<Record<string, boolean>>): StepGateState;
+declare function stepGatePolicy(gates: readonly StepGate[]): StepGatePolicy;
+declare function gateCaption(state: StepGateState, policy: StepGatePolicy): string;
+declare function PipelineFlowViewer({ featureFlags, metrics, metricSampleWindow, selectedKind: controlledKind, onSelectKind, selectedStepKey: controlledStepKey, onSelectStep }: PipelineFlowViewerProps): ReactNode;
+interface PipelineRunInspectorProps {
+    metadataId: number;
+    runs: readonly PipelineRunRecord[];
+    selectedRunId: number | null;
+    onSelectRun: (runId: number) => void;
+    isLoading: boolean;
+    failure: string | null;
+    onClose: () => void;
+    openRequest: number;
+    returnFocusFallback: () => HTMLElement | null;
+}
+declare const STEP_CARDS_OPEN_LIMIT = 8;
+declare function PipelineRunInspector({ metadataId, runs, selectedRunId, onSelectRun, isLoading, failure, onClose, openRequest, returnFocusFallback }: PipelineRunInspectorProps): ReactNode;
+declare const FLOW_NODE_TEXT: {
+    readonly inset: 12;
+    readonly labelFontSize: 13;
+    readonly captionFontSize: 11;
+};
+declare const FLOW_FOCUS_RING: {
+    readonly offset: 3;
+    readonly stroke: 2;
+};
+interface FlowGeometry {
+    readonly node: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly gap: {
+        readonly column: number;
+        readonly row: number;
+    };
+    readonly padding: number;
+}
+declare const FLOW_GEOMETRY: FlowGeometry;
+interface LaidOutStep {
+    readonly key: PipelineStepKey;
+    readonly x: number;
+    readonly y: number;
+    readonly rank: number;
+    readonly order: number;
+    readonly width: number;
+    readonly height: number;
+}
+interface LaidOutEdge {
+    readonly from: PipelineStepKey;
+    readonly to: PipelineStepKey;
+    readonly path: string;
+}
+interface FlowLayout {
+    readonly width: number;
+    readonly height: number;
+    readonly steps: readonly LaidOutStep[];
+    readonly edges: readonly LaidOutEdge[];
+}
+declare function layoutFlow(flow: PipelineFlow, geometry?: FlowGeometry): FlowLayout;
+interface StatusPresentation {
+    readonly label: string;
+    readonly className: string;
+}
+interface StepStatusPresentation extends StatusPresentation {
+    readonly bar: string;
+}
+type PipelineRunPresentationKey = PipelineRunStatus | "FAILED_RETRY_SCHEDULED";
+declare const PIPELINE_RUN_STATUS_PRESENTATION: Readonly<Record<PipelineRunPresentationKey, StatusPresentation>>;
+declare const PIPELINE_STEP_STATUS_PRESENTATION: Readonly<Record<PipelineStepStatus, StepStatusPresentation>>;
+declare const PIPELINE_TRIGGER_LABELS: Readonly<Record<PipelineTrigger, string>>;
+declare const UNFINISHED_LABEL = "\u672A\u5B8C\u4E86";
+declare function pipelineRunPresentationKey(run: {
+    readonly status: PipelineRunStatus;
+    readonly retryScheduled: boolean;
+}): PipelineRunPresentationKey;
+declare const NOTHING_TO_READ_LABELS: Readonly<Record<NothingToReadToken, string>>;
+declare function skipReasonLabel(text: string): string;
 interface QdrantCollectionInfo {
     collection_name: string;
     domain_key: string;
@@ -259,57 +415,44 @@ interface QdrantCollectionInfo {
 interface QdrantHealthInfo {
     healthy: boolean;
     latency_ms: number;
-    status_text?: string;
 }
 interface QdrantResourceUsage {
-    ram_bytes?: number;
-    disk_bytes?: number;
-    segment_count?: number;
+    ram_bytes?: number | null;
+    disk_bytes?: number | null;
+    segment_count?: number | null;
 }
-interface QdrantStorageOverview {
+type QdrantStorageOverview = {
     collections: QdrantCollectionInfo[];
-    probe_failure: string | null;
+    probe_failure: null;
+} | {
+    collections: readonly [
+    ];
+    probe_failure: string;
+};
+interface QdrantCollectionSelection {
+    selectedCollectionName: string | null;
+    onSelectCollection: (collectionName: string) => void;
+    detailId: string;
 }
 interface QdrantStorageCardProps {
-    collections: QdrantCollectionInfo[];
-    probeFailure?: string | null;
+    overview: QdrantStorageOverview;
     health?: QdrantHealthInfo;
     resources?: QdrantResourceUsage;
     onRefresh?: () => void | Promise<void>;
     isRefreshing?: boolean;
-    onSelectCollection?: (collectionName: string) => void;
-    selectedCollectionName?: string | null;
-}
-declare function QdrantStorageCard({ collections, probeFailure, health, resources, onRefresh, isRefreshing, onSelectCollection, selectedCollectionName }: QdrantStorageCardProps): React$1.JSX.Element;
-interface StageMetric {
-    latency_p50_ms: number;
-    latency_p95_ms: number;
-    throughput_rps: number;
-    success_rate: number;
-}
-interface StageGates {
-    featureFlagKey: string | null;
-    featureFlag: boolean | null;
-    domainsEnabled: number | null;
-    domainsTotal: number | null;
-}
-interface PipelineConfig {
-    enable_summary_generation?: StageGates;
-    enable_structured_extraction?: StageGates;
-    enable_vector_indexing?: StageGates;
-    enable_graph_indexing?: StageGates;
-    enable_asset_extraction?: StageGates;
+    selection?: QdrantCollectionSelection;
 }
-type CircuitBreakerState = "CLOSED" | "OPEN" | "HALF_OPEN";
-type NodeOperationalStatus = "active" | "partial" | "degraded" | "disabled" | "unmeasured";
-interface RAGPipelineGraphViewerProps {
-    pipelineConfig: PipelineConfig;
-    circuitBreakerStatus?: Record<string, CircuitBreakerState>;
-    stageMetrics?: Record<string, StageMetric>;
-    selectedNodeId?: string | null;
-    onNodeSelect?: (nodeId: string | null) => void;
-}
-declare function RAGPipelineGraphViewer({ pipelineConfig, circuitBreakerStatus, stageMetrics, selectedNodeId: controlledSelectedId, onNodeSelect }: RAGPipelineGraphViewerProps): React$1.JSX.Element;
+declare function QdrantStorageCard({ overview, health, resources, onRefresh, isRefreshing, selection }: QdrantStorageCardProps): JSX.Element;
+type RecordedInstantProps = {
+    readonly iso: string | null;
+    readonly testId: string;
+};
+declare function RecordedInstant({ iso, testId }: RecordedInstantProps): JSX.Element;
+type FinishedInstantProps = {
+    readonly iso: string | null;
+    readonly testId: string;
+};
+declare function FinishedInstant({ iso, testId }: FinishedInstantProps): ReactNode;
 interface FailedSyncItem {
     id: string | number;
     file_uri: string;
@@ -339,4 +482,4 @@ interface SyncStatusMonitorProps {
     onRefresh?: () => void;
 }
 declare function SyncStatusMonitor({ counts, totalFiles, failedItems, onRetryAll, onRetryItem, isRetrying, onRefresh }: SyncStatusMonitorProps): React$1.JSX.Element;
-export { type CircuitBreakerState, type ConfidentialityLevelFilter, DegradedSearchBanner, type DegradedSearchBannerProps, type DeveloperSearchPreset, DocumentIngestConsole, type DocumentIngestConsoleProps, type DocumentIngestLabel, type DocumentIngestPayload, EnrichmentStrategyBoard, type EnrichmentStrategyBoardProps, type EnrichmentStrategyRow, type FailedSyncItem, type FileInspectionResult, type FusionStrategy, InfrastructureHealthMonitor, type InfrastructureHealthMonitorProps, type IngestCapabilityPolicy, type IngestRowAction, type MetadataSearchHit, type MetadataSearchParams, type MetadataSearchResult, MetadataSearchWorkbench, type MetadataSearchWorkbenchProps, type NodeOperationalStatus, type OntologyClassItem, type OntologyPredicateItem, OntologyStatusCard, type OntologyStatusCardProps, type OntologyStatusData, type PipelineConfig, type QdrantCollectionInfo, type QdrantHealthInfo, type QdrantResourceUsage, QdrantStorageCard, type QdrantStorageCardProps, type QdrantStorageOverview, RAGPipelineGraphViewer, type RAGPipelineGraphViewerProps, REASON_LABELS, type RecentIngestItem, SEARCH_MODE_LABELS, SEARCH_PRESETS, type SearchAuthzScopes, type SearchHitGraphRelation, type SearchHitScoreBreakdown, type SearchMetadataLike, type ServiceHealthStatus, type StageGates, type StageMetric, type StrategyProvenance, type SyncStatusCounts, SyncStatusMonitor, type SyncStatusMonitorProps, type SystemInfrastructureHealth, gateStateOf, ingestRowAction };
+export { CHUNK_SOURCE_LABELS, type CircuitBreakerState, type ComparisonHit, type ComparisonInput, type ComparisonOutcome, type ComparisonVariant, type ComparisonVariantResult, type ConfidentialityLevelFilter, DegradedSearchBanner, type DegradedSearchBannerProps, type DeveloperSearchPreset, DocumentIngestConsole, type DocumentIngestConsoleProps, type DocumentIngestLabel, type DocumentIngestPayload, EnrichmentStrategyBoard, type EnrichmentStrategyBoardProps, type EnrichmentStrategyRow, FLOW_FOCUS_RING, FLOW_GEOMETRY, FLOW_NODE_TEXT, type FailedSyncItem, type FileInspectionResult, FinishedInstant, type FinishedInstantProps, type FlowGeometry, type FlowLayout, type FusionStrategy, GATE_POLICY_LABELS, GATE_STATE_PRESENTATION, type GateState, InfrastructureHealthMonitor, type InfrastructureHealthMonitorProps, type IngestCapabilityPolicy, type IngestDomainOption, type IngestRowAction, type LaidOutEdge, type LaidOutStep, type MetadataSearchHit, type MetadataSearchParams, type MetadataSearchResult, MetadataSearchWorkbench, type MetadataSearchWorkbenchProps, ModelComparisonWorkbench, type ModelComparisonWorkbenchProps, NOTHING_TO_READ_LABELS, type OntologyClassItem, type OntologyPredicateItem, OntologyStatusCard, type OntologyStatusCardProps, type OntologyStatusData, PHASE_LABELS, PIPELINE_RUN_STATUS_PRESENTATION, PIPELINE_STEP_STATUS_PRESENTATION, PIPELINE_TRIGGER_LABELS, PipelineFlowViewer, type PipelineFlowViewerProps, PipelineRunInspector, type PipelineRunInspectorProps, type PipelineRunPresentationKey, type QdrantCollectionInfo, type QdrantCollectionSelection, type QdrantHealthInfo, type QdrantResourceUsage, QdrantStorageCard, type QdrantStorageCardProps, type QdrantStorageOverview, REASON_LABELS, type RankAgreement, type RecentIngestItem, type RecentIngestLastRun, RecordedInstant, type RecordedInstantProps, SCORE_DISPLAY_DECIMALS, SEARCH_MODE_LABELS, SEARCH_PRESETS, STEP_CARDS_OPEN_LIMIT, type SearchAuthzScopes, type SearchHitGraphRelation, type SearchHitScoreBreakdown, type SearchMetadataLike, type ServiceHealthStatus, type StatusPresentation, type StepGatePolicy, type StepGateState, type StepStatusPresentation, type StrategyProvenance, type SyncStatusCounts, SyncStatusMonitor, type SyncStatusMonitorProps, type SystemInfrastructureHealth, UNFINISHED_LABEL, formatComparisonScore, gateCaption, gateState, gateStateOf, ingestRowAction, layoutFlow, pipelineRunPresentationKey, rankAgreement, skipReasonLabel, stepGatePolicy, stepGateState };