import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationCandidateUpsertInput, KnowledgeConsolidationReportRecord, KnowledgeConsolidationReportUpsertInput, KnowledgeEdgeRecord, KnowledgeEdgeUpsertInput, KnowledgeExtractionRecord, KnowledgeExtractionUpsertInput, KnowledgeIssueRecord, KnowledgeIssueUpsertInput, KnowledgeItemView, KnowledgeJobRunRecord, KnowledgeJobRunUpsertInput, KnowledgeRefinementTaskFilter, KnowledgeRefinementTaskRecord, KnowledgeRefinementTaskUpsertInput, KnowledgeNodeRecord, KnowledgeNodeRevisionRecord, KnowledgeNodeUpsertInput, KnowledgeScheduleRecord, KnowledgeScheduleUpsertInput, KnowledgeSemanticEnrichmentStateRecord, KnowledgeSourceRecord, KnowledgeSourceUpsertInput, KnowledgeStatus, KnowledgeUsageRecord, KnowledgeUsageUpsertInput } from './types.js';
import { type KnowledgeStoreConfig } from './store-config.js';
import { type KnowledgeSpaceDeleteResult } from './store-space-delete.js';
export declare class KnowledgeStore {
    private readonly sqlite;
    private readonly dbPath;
    private ready;
    private initPromise;
    private readonly sources;
    private readonly nodes;
    private readonly edges;
    private readonly issues;
    private readonly extractions;
    private readonly jobRuns;
    private readonly refinementTasks;
    private readonly usageRecords;
    private readonly consolidationCandidates;
    private readonly consolidationReports;
    private readonly schedules;
    private readonly nodeRevisions;
    private readonly semanticEnrichmentStates;
    private readonly nodeAutoAcceptConfidence;
    constructor(config: KnowledgeStoreConfig);
    get isReady(): boolean;
    get storagePath(): string;
    private asReadView;
    init(): Promise<void>;
    status(): KnowledgeStatus;
    /** Cheap count of retained in-memory records, for MemoryGovernor cache visibility. */
    retainedEntryCount(): number;
    batch<T>(operation: () => Promise<T>): Promise<T>;
    listSources(limit?: number): KnowledgeSourceRecord[];
    listSourcesInSpace(spaceId: string): KnowledgeSourceRecord[];
    listNodes(limit?: number): KnowledgeNodeRecord[];
    /** One bounded page of sources (insertion order, no full materialization). */
    listSourcesPage(offset: number, limit: number): KnowledgeSourceRecord[];
    /** One bounded page of nodes (insertion order, no full materialization). */
    listNodesPage(offset: number, limit: number): KnowledgeNodeRecord[];
    /**
     * Single-pass cursor over sources (insertion order, no materialization).
     * O(N) for a full scan, offset paging in a loop re-walks the Map from zero
     * per page (O(N²/page)). Map iterators tolerate concurrent upsert/delete.
     */
    iterateSources(): IterableIterator<KnowledgeSourceRecord>;
    /** Single-pass cursor over nodes. See {@link iterateSources}. */
    iterateNodes(): IterableIterator<KnowledgeNodeRecord>;
    listNodesInSpace(spaceId: string): KnowledgeNodeRecord[];
    listEdges(): KnowledgeEdgeRecord[];
    listIssues(limit?: number): KnowledgeIssueRecord[];
    listIssuesInSpace(spaceId: string): KnowledgeIssueRecord[];
    listExtractions(limit?: number): KnowledgeExtractionRecord[];
    listExtractionsInSpace(spaceId: string): KnowledgeExtractionRecord[];
    listExtractionsForSources(sourceIds: ReadonlySet<string>): KnowledgeExtractionRecord[];
    listJobRuns(limit?: number, jobId?: string): KnowledgeJobRunRecord[];
    listRefinementTasks(limit?: number, input?: KnowledgeRefinementTaskFilter): KnowledgeRefinementTaskRecord[];
    listUsageRecords(limit?: number, input?: {
        readonly targetKind?: KnowledgeUsageRecord['targetKind'] | undefined;
        readonly targetId?: string | undefined;
        readonly usageKind?: KnowledgeUsageRecord['usageKind'] | undefined;
    }): KnowledgeUsageRecord[];
    listConsolidationCandidates(limit?: number, input?: {
        readonly status?: KnowledgeConsolidationCandidateRecord['status'] | undefined;
        readonly subjectKind?: KnowledgeConsolidationCandidateRecord['subjectKind'] | undefined;
        readonly subjectId?: string | undefined;
    }): KnowledgeConsolidationCandidateRecord[];
    listConsolidationReports(limit?: number): KnowledgeConsolidationReportRecord[];
    listSchedules(limit?: number): KnowledgeScheduleRecord[];
    getSource(id: string): KnowledgeSourceRecord | null;
    getNode(id: string): KnowledgeNodeRecord | null;
    getIssue(id: string): KnowledgeIssueRecord | null;
    getExtraction(id: string): KnowledgeExtractionRecord | null;
    getExtractionBySourceId(sourceId: string): KnowledgeExtractionRecord | null;
    getJobRun(id: string): KnowledgeJobRunRecord | null;
    getRefinementTask(id: string): KnowledgeRefinementTaskRecord | null;
    getUsageRecord(id: string): KnowledgeUsageRecord | null;
    getConsolidationCandidate(id: string): KnowledgeConsolidationCandidateRecord | null;
    getConsolidationCandidateBySubject(subjectKind: KnowledgeConsolidationCandidateRecord['subjectKind'], subjectId: string, candidateType: KnowledgeConsolidationCandidateRecord['candidateType']): KnowledgeConsolidationCandidateRecord | null;
    getConsolidationReport(id: string): KnowledgeConsolidationReportRecord | null;
    getSchedule(id: string): KnowledgeScheduleRecord | null;
    getSourceByCanonicalUri(canonicalUri: string): KnowledgeSourceRecord | null;
    getNodeByKindAndSlug(kind: KnowledgeNodeRecord['kind'], slug: string): KnowledgeNodeRecord | null;
    edgesFor(kind: KnowledgeEdgeRecord['fromKind'] | KnowledgeEdgeRecord['toKind'], id: string): KnowledgeEdgeRecord[];
    getItem(id: string): KnowledgeItemView | null;
    upsertSource(input: KnowledgeSourceUpsertInput): Promise<KnowledgeSourceRecord>;
    deleteSource(id: string): Promise<boolean>;
    private asRecordDeleteView;
    replaceSourceRecord(record: KnowledgeSourceRecord): Promise<void>;
    upsertNode(input: KnowledgeNodeUpsertInput): Promise<KnowledgeNodeRecord>;
    /** Read a node's append-only revision history, oldest first. (Invariant 8.) */
    listNodeRevisions(nodeId: string): KnowledgeNodeRevisionRecord[];
    deleteNode(id: string): Promise<boolean>;
    replaceNodeRecord(record: KnowledgeNodeRecord): Promise<void>;
    /** Merge one node into another, re-pointing cross-reference edges. (Invariant 7.) */
    mergeNodes(loserId: string, winnerId: string): Promise<{
        merged: boolean;
        repointedEdges: number;
    }>;
    getSemanticEnrichmentState(sourceId: string): KnowledgeSemanticEnrichmentStateRecord | null;
    upsertSemanticEnrichmentState(input: {
        readonly sourceId: string;
        readonly textHash?: string | undefined;
        readonly enrichedAt?: number | undefined;
        readonly metadata?: Record<string, unknown> | undefined;
    }): Promise<KnowledgeSemanticEnrichmentStateRecord>;
    upsertEdge(input: KnowledgeEdgeUpsertInput): Promise<KnowledgeEdgeRecord>;
    deleteEdge(id: string): Promise<boolean>;
    replaceEdgeRecord(record: KnowledgeEdgeRecord): Promise<void>;
    replaceIssues(inputs: readonly KnowledgeIssueUpsertInput[], namespace?: string): Promise<KnowledgeIssueRecord[]>;
    upsertIssue(input: KnowledgeIssueUpsertInput): Promise<KnowledgeIssueRecord>;
    replaceIssueRecord(record: KnowledgeIssueRecord): Promise<void>;
    upsertExtraction(input: KnowledgeExtractionUpsertInput): Promise<KnowledgeExtractionRecord>;
    upsertJobRun(input: KnowledgeJobRunUpsertInput): Promise<KnowledgeJobRunRecord>;
    /**
     * Bound the retained job-run history to `keep` records. Active (queued /
     * running) runs are never pruned; settled runs beyond the cap are removed
     * oldest-first from BOTH the in-memory mirror and the sqlite table, so the
     * history cannot accrete without bound across uptime or restarts. Also the
     * MemoryGovernor's trim hook for this store (a real reclaim, not a no-op).
     */
    pruneJobRuns(keep: number): number;
    upsertRefinementTask(input: KnowledgeRefinementTaskUpsertInput): Promise<KnowledgeRefinementTaskRecord>;
    upsertUsageRecord(input: KnowledgeUsageUpsertInput): Promise<KnowledgeUsageRecord>;
    upsertConsolidationCandidate(input: KnowledgeConsolidationCandidateUpsertInput): Promise<KnowledgeConsolidationCandidateRecord>;
    upsertConsolidationReport(input: KnowledgeConsolidationReportUpsertInput): Promise<KnowledgeConsolidationReportRecord>;
    upsertSchedule(input: KnowledgeScheduleUpsertInput): Promise<KnowledgeScheduleRecord>;
    deleteSchedule(id: string): Promise<boolean>;
    planKnowledgeSpaceDelete(spaceId: string): Promise<KnowledgeSpaceDeleteResult>;
    deleteKnowledgeSpace(spaceId: string, input?: {
        readonly dryRun?: boolean;
    }): Promise<KnowledgeSpaceDeleteResult>;
    private knowledgeSpaceRowStores;
    private initialize;
}
//# sourceMappingURL=store.d.ts.map