@lapis-notes/api 0.1.0

package/dist/storage/app-database.d.ts

@@ -0,0 +1,860 @@
+import { type SearchEmbeddingRuntimeStatus, type SearchEmbeddingProvider, type SearchEmbeddingProviderConfig } from "./search-embedding-provider";
+import { type SearchQueryEvaluationOptions, type SearchQueryTextRangeOptions } from "./search-query-evaluator";
+import { type IndexProjectionDefinitionRecord, type IndexProjectionEdgeRecord, type IndexQuery, type IndexQueryResult, type IndexRelatedQuery, type IndexProjectionRowRecord, type IndexProjectionSourceRecord, type IndexProjectionValueRecord, type MarkProjectionSourceErrorInput, type ReplaceProjectionSourceInput } from "./index-projection";
+import { type AppDatabaseLinkKind, type AppDatabaseTaskChildQuery, type AppDatabaseTaskQuery, type AppDatabaseTaskRecord } from "./task-projection";
+export type { SearchEmbeddingProviderConfig, SearchEmbeddingRuntimeStatus, } from "./search-embedding-provider";
+export type RuntimeTarget = "web-pwa" | "deno-desktop" | "test";
+export interface LocalSearchQueryEnhancementProviderConfig {
+    kind: "local-model";
+    queryExpansionModelId: string;
+    rerankerModelId: string;
+    allowRemoteModels?: boolean;
+    localModelPath?: string;
+    maxExpandedQueries: number;
+    maxRerankCandidates: number;
+}
+export type SearchQueryEnhancementProviderConfig = LocalSearchQueryEnhancementProviderConfig;
+export type SearchQueryEnhancementRuntimePhase = "ready" | "loading" | "running" | "error";
+export interface SearchQueryEnhancementRuntimeStatus {
+    providerKind: SearchQueryEnhancementProviderConfig["kind"];
+    phase: SearchQueryEnhancementRuntimePhase;
+    queryExpansionModelId?: string;
+    rerankerModelId?: string;
+    message?: string;
+    updatedAt: number;
+}
+export interface SearchQueryEnhancementSignal {
+    requestedMode: "auto" | "lexical" | "vector" | "hybrid";
+    topLexicalScore: number;
+    topVectorScore: number;
+    topFusedScore: number;
+    resultCount: number;
+}
+export interface SearchQueryExpansionResult {
+    expandedQueries: string[];
+}
+export interface SearchQueryRerankResult {
+    rankedPaths: string[];
+}
+export interface SearchQueryEnhancementProvider {
+    readonly config: SearchQueryEnhancementProviderConfig;
+    ready(): Promise<boolean>;
+    expandQuery(input: {
+        query: string;
+        signal: SearchQueryEnhancementSignal;
+        abortSignal?: AbortSignal;
+    }): Promise<SearchQueryExpansionResult>;
+    rerank(input: {
+        query: string;
+        candidates: AppDatabaseSearchResult[];
+        signal: SearchQueryEnhancementSignal;
+        abortSignal?: AbortSignal;
+    }): Promise<SearchQueryRerankResult>;
+    getRuntimeStatus(): SearchQueryEnhancementRuntimeStatus;
+}
+export interface AppDatabaseSearchQueryEnhancementRequest {
+    runtimeTarget: RuntimeTarget;
+    provider: SearchQueryEnhancementProviderConfig;
+    expandQuery: boolean;
+    rerankResults: boolean;
+}
+export type AppDatabaseSearchQueryEnhancementSkipReason = "unsupported-runtime" | "strong-signal" | "provider-unavailable";
+export interface AppDatabaseSearchQueryEnhancementDiagnostics {
+    runtimeTarget: RuntimeTarget;
+    providerKind: SearchQueryEnhancementProviderConfig["kind"];
+    expandQuery: boolean;
+    rerankResults: boolean;
+    applied: boolean;
+    skipReason?: AppDatabaseSearchQueryEnhancementSkipReason;
+    signal: SearchQueryEnhancementSignal;
+}
+export interface AppDatabaseSearchIndexStats {
+    documentCount: number;
+    chunkCount: number;
+    readyChunkCount: number;
+    pendingChunkCount: number;
+    errorChunkCount: number;
+    lastError: string | null;
+}
+export declare function supportsSearchQueryEnhancementRuntime(runtimeTarget?: RuntimeTarget | null): boolean;
+export type AppDatabaseKind = "turso-wasm" | "turso-native" | "memory";
+export type AppDatabaseStorageMode = "local" | "synced" | "remote";
+export type AppDatabaseTransport = "native" | "wasm-worker" | "broadcast-proxy" | "memory";
+export type AppDatabaseRole = "direct" | "owner" | "proxy" | "blocked" | "test";
+export interface AppDatabaseCapabilities {
+    nativeFullTextSearch: boolean;
+    vectorSearch: boolean;
+    approximateNearestNeighbors: boolean;
+    localEmbeddings: boolean;
+    crossTabCoordination: boolean;
+    sync: boolean;
+}
+export interface AppDatabaseDescriptor {
+    providerId: string;
+    engine: "turso" | "memory";
+    transport: AppDatabaseTransport;
+    role: AppDatabaseRole;
+    storageMode: AppDatabaseStorageMode;
+    capabilities: AppDatabaseCapabilities;
+}
+export declare const EMPTY_APP_DATABASE_CAPABILITIES: AppDatabaseCapabilities;
+export interface MetadataCacheSnapshot {
+    fileCache: Record<string, {
+        mtime: number;
+        size: number;
+        hash: string;
+    }>;
+    metadataCache: Record<string, unknown>;
+    resolvedLinks: Record<string, Record<string, number>>;
+    unresolvedLinks: Record<string, Record<string, number>>;
+}
+export interface AppDatabaseFileRecord {
+    path: string;
+    normalizedPath: string;
+    extension: string;
+    mtime: number;
+    size: number;
+    hash: string;
+    /** Parser signature from the indexed metadata row when requested as a manifest. */
+    parserVersion?: string;
+    indexed: boolean;
+    deleted?: boolean;
+}
+export interface AppDatabaseMetadataRecord {
+    path: string;
+    hash: string;
+    parserVersion: string;
+    metadata: unknown;
+}
+export interface AppDatabaseLinkRecord {
+    sourcePath: string;
+    targetText: string;
+    original?: string;
+    resolvedTargetPath: string | null;
+    type: "link" | "embed";
+    position?: unknown;
+    count: number;
+    heading?: string | null;
+    kind?: AppDatabaseLinkKind;
+    ordinal?: number;
+}
+export interface AppDatabaseTagRecord {
+    path: string;
+    tag: string;
+    parts: string[];
+    hierarchy: string[];
+    position?: unknown;
+}
+export interface AppDatabasePropertyRecord {
+    path: string;
+    name: string;
+    inferredType: string;
+    declaredType?: string;
+    value: unknown;
+}
+export interface AppDatabaseIndexedFile {
+    file: AppDatabaseFileRecord;
+    metadata: AppDatabaseMetadataRecord;
+    links: AppDatabaseLinkRecord[];
+    tags: AppDatabaseTagRecord[];
+    properties: AppDatabasePropertyRecord[];
+    task?: AppDatabaseTaskRecord | null;
+}
+export type AppDatabaseIndexedMetadataScalar = string | number | boolean | null;
+export type AppDatabaseIndexedMetadataPropertyFilterOp = "exists" | "not-exists" | "=" | "!=" | ">" | ">=" | "<" | "<=";
+export interface AppDatabaseIndexedMetadataPropertyFilter {
+    name: string;
+    op: AppDatabaseIndexedMetadataPropertyFilterOp;
+    value?: AppDatabaseIndexedMetadataScalar;
+}
+export type AppDatabaseIndexedMetadataSortField = {
+    kind: "file";
+    field: "path" | "extension" | "mtime" | "size";
+} | {
+    kind: "property";
+    name: string;
+};
+export interface AppDatabaseIndexedMetadataSort {
+    field: AppDatabaseIndexedMetadataSortField;
+    direction: "ASC" | "DESC";
+}
+export interface AppDatabaseIndexedMetadataQuery {
+    extensions?: string[];
+    pathPrefixes?: string[];
+    /** Exclude dot-prefixed path segments such as app and plugin state folders. */
+    excludeHiddenPaths?: boolean;
+    propertyFilters?: AppDatabaseIndexedMetadataPropertyFilter[];
+    requiredTags?: string[];
+    resolvedTargetPaths?: string[];
+    sort?: AppDatabaseIndexedMetadataSort[];
+    limit?: number;
+}
+export interface AppDatabaseIndexedMetadataRow {
+    file: AppDatabaseFileRecord;
+    metadata: AppDatabaseMetadataRecord | null;
+    properties: AppDatabasePropertyRecord[];
+    tags: AppDatabaseTagRecord[];
+    links: AppDatabaseLinkRecord[];
+}
+export interface AppDatabaseIndexedFileManifestQuery {
+    after?: string;
+    limit?: number;
+    /**
+     * Restrict the manifest lookup to a bounded set of exact paths. Callers use
+     * this to reconcile one vault iterator batch without materializing the
+     * complete vault or metadata payloads.
+     */
+    paths?: string[];
+}
+export interface AppDatabaseIndexedFileManifestPage {
+    rows: AppDatabaseFileRecord[];
+    nextCursor?: string;
+}
+export interface AppDatabaseIndexedMetadataPageQuery {
+    query?: AppDatabaseIndexedMetadataQuery;
+    after?: string;
+    limit?: number;
+    /**
+     * Select the materialized metadata domains returned for each file. File
+     * records are always included. Omit this field to preserve the complete
+     * metadata-row contract.
+     */
+    include?: AppDatabaseIndexedMetadataDomain[];
+}
+export type AppDatabaseIndexedMetadataDomain = "metadata" | "properties" | "tags" | "links";
+export interface AppDatabaseIndexedMetadataPage {
+    rows: AppDatabaseIndexedMetadataRow[];
+    nextCursor?: string;
+}
+export type AppDatabaseMetadataFacetKind = "tag" | "property-name" | "property-path" | "property-value";
+export interface AppDatabaseMetadataFacetQuery {
+    kind: AppDatabaseMetadataFacetKind;
+    propertyName?: string;
+    pathPrefixes?: string[];
+    limit?: number;
+}
+export interface AppDatabaseMetadataFacetRow {
+    value: AppDatabaseIndexedMetadataScalar;
+    valueType: "null" | "string" | "number" | "boolean" | "date";
+    count: number;
+    /** Metadata types observed for a property name or nested property path. */
+    metadataTypes?: string[];
+    /** Whether a property-name/path row represents a top-level frontmatter key. */
+    topLevel?: boolean;
+}
+export type AppDatabaseMetadataLinkDirection = "incoming" | "outgoing";
+export type AppDatabaseMetadataLinkResolution = "resolved" | "unresolved" | "all";
+export interface AppDatabaseMetadataLinkQuery {
+    direction: AppDatabaseMetadataLinkDirection;
+    path?: string;
+    /** Batch source/target paths for indexed consumers such as Bases. */
+    paths?: string[];
+    resolution?: AppDatabaseMetadataLinkResolution;
+    limit?: number;
+}
+export type AppDatabaseChangeDomain = "metadata" | "search" | "history" | "notification" | "notebook" | "task" | "projection" | "memory" | "meta";
+export interface AppDatabaseChangeSet {
+    revision: number;
+    domains: AppDatabaseChangeDomain[];
+    paths: string[];
+    renamed?: {
+        oldPath: string;
+        newPath: string;
+    }[];
+    reset?: boolean;
+    committedAt: number;
+}
+export type AppDatabaseChangeListener = (change: AppDatabaseChangeSet) => void;
+export interface SearchDocumentRecord {
+    path: string;
+    /** Domain projection owner used to isolate disposable search corpora. */
+    sourceProviderId?: string;
+    name: string;
+    extension: string;
+    checksum: string;
+    content: string;
+    tags: string[];
+    tagParts: string[];
+    tagHierarchy: string[];
+    metadataText?: string;
+    chunks?: SearchDocumentChunk[];
+    sourceMetadata?: SearchDocumentSourceMetadata;
+}
+export interface SearchDocumentChunkingSettings {
+    targetChars: number;
+    breakpointWindowChars: number;
+    breakpointDecay: number;
+}
+export interface SearchDocumentSourcePosition {
+    offset: number;
+}
+export interface SearchDocumentSourceRange {
+    start: SearchDocumentSourcePosition;
+    end: SearchDocumentSourcePosition;
+}
+export interface SearchDocumentSourceHeading {
+    heading: string;
+    level: number;
+    position: SearchDocumentSourceRange;
+}
+export interface SearchDocumentSourceSection {
+    type: string;
+    position: SearchDocumentSourceRange;
+}
+export interface SearchDocumentSourceMetadata {
+    /** Core metadata/content hash used for body-free warm reconciliation. */
+    metadataHash?: string;
+    /** Domain provider version that produced this projection. */
+    providerVersion?: string;
+    /** Chunking and projection configuration signature. */
+    projectionSignature?: string;
+    sourceMtime?: number;
+    sourceSize?: number;
+    rawTags: string[];
+    frontmatter?: unknown;
+    frontmatterEndOffset?: number;
+    headings: SearchDocumentSourceHeading[];
+    sections: SearchDocumentSourceSection[];
+    chunking: SearchDocumentChunkingSettings;
+}
+export interface SearchDocumentManifestRecord {
+    path: string;
+    checksum: string;
+    sourceProviderId?: string;
+    metadataHash?: string;
+    providerVersion?: string;
+    projectionSignature?: string;
+    sourceMtime?: number;
+    sourceSize?: number;
+}
+export interface SearchDocumentManifestQuery {
+    after?: string;
+    limit?: number;
+}
+export interface SearchDocumentManifestPage {
+    rows: SearchDocumentManifestRecord[];
+    nextCursor?: string;
+}
+export interface SearchDocumentChunkEmbeddingState {
+    status: "pending" | "ready" | "error";
+    modelId: string;
+    modelVersion?: string;
+    dimensions?: number;
+    vector?: number[];
+    fingerprint?: string;
+    dirty?: boolean;
+    updatedAt?: number;
+    error?: string;
+}
+export interface SearchDocumentChunk {
+    id: string;
+    text: string;
+    startOffset: number;
+    endOffset: number;
+    heading?: string;
+    kind?: "frontmatter" | "heading" | "paragraph" | "list" | "blockquote" | "code" | "fallback";
+    embedding?: SearchDocumentChunkEmbeddingState;
+}
+export declare function normalizeSearchDocument(document: SearchDocumentRecord): SearchDocumentRecord;
+export type AppDatabaseSearchMode = "lexical" | "vector" | "hybrid";
+export type AppDatabaseSearchField = "content" | "path" | "name" | "tags" | "metadata";
+export interface AppDatabaseSearchRange {
+    start: number;
+    end: number;
+}
+export interface AppDatabaseSearchSnippet {
+    field: AppDatabaseSearchField;
+    text: string;
+    ranges: AppDatabaseSearchRange[];
+    offset: number;
+    chunkId?: string;
+    chunkLabel?: string;
+}
+export interface AppDatabaseSearchOptions {
+    limit?: number;
+    /** Vault-relative directory filter applied before ranking and limiting. */
+    pathPrefix?: string;
+    snippetLength?: number;
+    mode?: AppDatabaseSearchMode | "auto";
+    includeDiagnostics?: boolean;
+    caseSensitive?: boolean;
+    sourceProviderIds?: string[];
+    queryEnhancement?: AppDatabaseSearchQueryEnhancementRequest;
+}
+export type AppDatabaseSearchScoreFusionAlgorithm = "lexical-score" | "vector-score" | "reciprocal-rank-fusion";
+export interface AppDatabaseSearchScoreFusion {
+    algorithm: AppDatabaseSearchScoreFusionAlgorithm;
+    k?: number;
+    lexicalRank?: number;
+    vectorRank?: number;
+    lexicalContribution?: number;
+    vectorContribution?: number;
+}
+export interface AppDatabaseSearchScoreBreakdown {
+    lexical?: number;
+    vector?: number;
+    fused: number;
+    fusion?: AppDatabaseSearchScoreFusion;
+}
+export interface AppDatabaseSearchDiagnostics {
+    requestedMode?: AppDatabaseSearchMode | "auto";
+    appliedMode: AppDatabaseSearchMode;
+    backendKind: AppDatabaseKind;
+    lexicalCandidateCount?: number;
+    vectorCandidateCount?: number;
+    totalCandidateCount?: number;
+    providerKind?: SearchEmbeddingProviderConfig["kind"];
+    modelId?: string;
+    modelReady?: boolean;
+    queryEnhancement?: AppDatabaseSearchQueryEnhancementDiagnostics;
+}
+export interface AppDatabaseSearchResult {
+    document: SearchDocumentRecord;
+    score: number;
+    snippets: AppDatabaseSearchSnippet[];
+    retrievalMode: AppDatabaseSearchMode;
+    scoreBreakdown: AppDatabaseSearchScoreBreakdown;
+    matchedChunkIds: string[];
+    diagnostics?: AppDatabaseSearchDiagnostics;
+}
+export interface AppDatabaseNotebookCellState {
+    state: string;
+    sourceHash?: string;
+    outputs: unknown[];
+    inputValues?: Record<string, unknown>;
+    error?: string;
+    durationMs?: number;
+    setupPhases?: AppDatabaseNotebookExecutionPhaseState[];
+}
+export interface AppDatabaseNotebookExecutionPhaseState {
+    key: string;
+    label: string;
+    status: string;
+    durationMs?: number;
+    detail?: string;
+}
+export interface AppDatabaseNotebookState {
+    sourcePath: string;
+    mtime: number;
+    updatedAt: number;
+    cells: Record<string, AppDatabaseNotebookCellState>;
+}
+export type AppDatabaseFileHistoryEventType = "baseline" | "create" | "modify" | "rename" | "delete" | "restore";
+export interface AppDatabaseFileHistoryFile {
+    fileId: string;
+    currentPath: string;
+    deleted: boolean;
+}
+export interface AppDatabaseFileHistoryRevision {
+    revisionId: string;
+    fileId: string;
+    currentPath: string;
+    capturedPath: string;
+    eventType: AppDatabaseFileHistoryEventType;
+    createdAt: number;
+    sourceMtime?: number;
+    sourceSize?: number;
+    contentHash: string;
+    content: string;
+}
+export interface AppDatabaseFileHistory {
+    file: AppDatabaseFileHistoryFile;
+    revisions: AppDatabaseFileHistoryRevision[];
+}
+export interface AppDatabaseStoreFileHistoryRevisionInput {
+    path: string;
+    previousPath?: string;
+    eventType: AppDatabaseFileHistoryEventType;
+    createdAt: number;
+    sourceMtime?: number;
+    sourceSize?: number;
+    contentHash?: string;
+    content?: string;
+    maxRevisions?: number;
+    replaceLatest?: boolean;
+}
+export interface AppDatabaseStoreFileHistoryRevisionResult {
+    fileId: string;
+    stored: boolean;
+    deduplicated: boolean;
+    revision?: AppDatabaseFileHistoryRevision;
+}
+export type AppDatabaseNotificationSeverity = "info" | "warning" | "error";
+export interface AppDatabaseNotificationRecord {
+    id: string;
+    title?: string;
+    message: string;
+    severity: AppDatabaseNotificationSeverity;
+    source?: string;
+    createdAt: number;
+    updatedAt: number;
+    read: boolean;
+    cleared: boolean;
+}
+export type AppDatabaseMemoryScopeKind = "user" | "workspace" | "project";
+export type AppDatabaseMemoryOriginClass = "owner" | "agent" | "untrusted" | "system";
+export interface AppDatabaseMemorySourceRecord {
+    sourceKey: string;
+    sourcePath: string;
+    sourceHash: string;
+    lastEntryId?: string;
+    lastEntryHash?: string;
+    status: "ready" | "inconsistent" | "error" | "excluded";
+    indexedAt: number;
+    errorCode?: string;
+}
+export interface AppDatabaseMemoryCandidateRecord {
+    id: string;
+    scopeKind: AppDatabaseMemoryScopeKind;
+    scopePath: string;
+    kind: "preference" | "fact" | "decision" | "procedure" | "constraint";
+    normalizedClaim: string;
+    claimHash: string;
+    supersessionKey?: string;
+    originClass: AppDatabaseMemoryOriginClass;
+    importance: 1 | 2 | 3 | 4 | 5;
+    triggers: string[];
+    state: "staged" | "review" | "promoted" | "rejected";
+    firstSeenAt: number;
+    lastSeenAt: number;
+    recurrenceCount: number;
+    conversationCount: number;
+    promotedMemoryId?: string;
+}
+export interface AppDatabaseMemoryCandidateOriginRecord {
+    candidateId: string;
+    conversationId: string;
+    entryId: string;
+    entryHash: string;
+    observedAt: number;
+}
+export interface AppDatabaseMemoryCandidateInput {
+    candidate: AppDatabaseMemoryCandidateRecord;
+    origins: AppDatabaseMemoryCandidateOriginRecord[];
+}
+export interface AppDatabaseMemoryCandidateQuery {
+    scopeKind?: AppDatabaseMemoryScopeKind;
+    scopePath?: string;
+    states?: AppDatabaseMemoryCandidateRecord["state"][];
+    limit?: number;
+}
+export interface AppDatabaseMemoryCandidateResult {
+    candidate: AppDatabaseMemoryCandidateRecord;
+    origins: AppDatabaseMemoryCandidateOriginRecord[];
+}
+export interface AppDatabaseMemoryRecallSignalRecord {
+    targetRef: string;
+    queryFingerprint: string;
+    day: string;
+    bestScore: number;
+    hitCount: number;
+}
+export interface AppDatabaseMemoryJobRecord {
+    id: string;
+    kind: "ingest" | "consolidate" | "rebuild" | "forget";
+    scopeKey: string;
+    status: "queued" | "running" | "completed" | "failed";
+    cursor?: string;
+    attempts: number;
+    maxAttempts: number;
+    ownerId?: string;
+    leaseUntil?: number;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    errorCode?: string;
+}
+export interface AppDatabaseMemoryJobClaimInput {
+    job: AppDatabaseMemoryJobRecord;
+    ownerId: string;
+    now: number;
+    leaseMs: number;
+}
+export interface AppDatabaseMemoryJobUpdateInput {
+    jobId: string;
+    ownerId: string;
+    now: number;
+    patch: Pick<AppDatabaseMemoryJobRecord, "status"> & Partial<Pick<AppDatabaseMemoryJobRecord, "cursor" | "leaseUntil" | "finishedAt" | "errorCode">>;
+}
+export interface AppDatabase {
+    readonly kind: AppDatabaseKind;
+    readonly vaultId: string;
+    readonly descriptor: AppDatabaseDescriptor;
+    open(): Promise<void>;
+    migrate(): Promise<void>;
+    close(): Promise<void>;
+    beginSearchIndexingBatch(): Promise<void>;
+    endSearchIndexingBatch(): Promise<void>;
+    configureSearchEmbeddingProvider(provider: SearchEmbeddingProviderConfig | null): Promise<void>;
+    getSearchEmbeddingProvider(): Promise<SearchEmbeddingProviderConfig | null>;
+    getSearchEmbeddingRuntimeStatus(): Promise<SearchEmbeddingRuntimeStatus | null>;
+    getSearchIndexStats(): Promise<AppDatabaseSearchIndexStats>;
+    getMeta<T = unknown>(key: string): Promise<T | undefined>;
+    setMeta(key: string, value: unknown): Promise<void>;
+    getNotebookState(sourcePath: string): Promise<AppDatabaseNotebookState | undefined>;
+    setNotebookState(sourcePath: string, state: AppDatabaseNotebookState): Promise<void>;
+    deleteNotebookState(sourcePath: string): Promise<void>;
+    loadMetadataSnapshot(): Promise<MetadataCacheSnapshot | null>;
+    saveMetadataSnapshot(snapshot: MetadataCacheSnapshot): Promise<void>;
+    getFileHistory(path: string): Promise<AppDatabaseFileHistory | null>;
+    storeFileHistoryRevision(input: AppDatabaseStoreFileHistoryRevisionInput): Promise<AppDatabaseStoreFileHistoryRevisionResult>;
+    listNotifications(): Promise<AppDatabaseNotificationRecord[]>;
+    upsertNotification(record: AppDatabaseNotificationRecord): Promise<void>;
+    markNotificationRead(id: string): Promise<void>;
+    clearNotification(id: string): Promise<void>;
+    clearAllNotifications(): Promise<void>;
+    getMemorySourceState(sourceKey: string): Promise<AppDatabaseMemorySourceRecord | undefined>;
+    listMemorySourceStates(): Promise<AppDatabaseMemorySourceRecord[]>;
+    upsertMemorySourceState(record: AppDatabaseMemorySourceRecord): Promise<void>;
+    deleteMemorySourceState(sourceKey: string): Promise<void>;
+    upsertMemoryCandidate(input: AppDatabaseMemoryCandidateInput): Promise<void>;
+    queryMemoryCandidates(query?: AppDatabaseMemoryCandidateQuery): Promise<AppDatabaseMemoryCandidateResult[]>;
+    deleteMemoryCandidatesByConversation(conversationId: string): Promise<void>;
+    recordMemoryRecallSignal(record: AppDatabaseMemoryRecallSignalRecord): Promise<void>;
+    listMemoryRecallSignals(targetRef?: string): Promise<AppDatabaseMemoryRecallSignalRecord[]>;
+    claimMemoryJob(input: AppDatabaseMemoryJobClaimInput): Promise<AppDatabaseMemoryJobRecord | null>;
+    updateMemoryJob(input: AppDatabaseMemoryJobUpdateInput): Promise<AppDatabaseMemoryJobRecord | null>;
+    listMemoryJobs(scopeKey?: string): Promise<AppDatabaseMemoryJobRecord[]>;
+    clearMemoryDerivedState(): Promise<void>;
+    getChangeRevision(): Promise<number>;
+    subscribeToChanges(listener: AppDatabaseChangeListener): () => void;
+    upsertIndexedFile(record: AppDatabaseIndexedFile): Promise<void>;
+    getIndexedFile(path: string): Promise<AppDatabaseIndexedMetadataRow | undefined>;
+    listIndexedFileManifest(query?: AppDatabaseIndexedFileManifestQuery): Promise<AppDatabaseIndexedFileManifestPage>;
+    queryIndexedMetadata(query?: AppDatabaseIndexedMetadataQuery): Promise<AppDatabaseIndexedMetadataRow[]>;
+    queryIndexedMetadataPage(query?: AppDatabaseIndexedMetadataPageQuery): Promise<AppDatabaseIndexedMetadataPage>;
+    queryMetadataFacets(query: AppDatabaseMetadataFacetQuery): Promise<AppDatabaseMetadataFacetRow[]>;
+    queryMetadataLinks(query: AppDatabaseMetadataLinkQuery): Promise<AppDatabaseLinkRecord[]>;
+    deleteIndexedFile(path: string): Promise<void>;
+    renameIndexedFile(oldPath: string, newPath: string): Promise<void>;
+    upsertSearchDocument(document: SearchDocumentRecord): Promise<void>;
+    deleteSearchDocument(path: string): Promise<void>;
+    getSearchDocument(path: string): Promise<SearchDocumentRecord | undefined>;
+    listSearchDocumentManifest(query?: SearchDocumentManifestQuery): Promise<SearchDocumentManifestPage>;
+    listSearchDocuments(): Promise<SearchDocumentRecord[]>;
+    rebuildSearchIndex(): Promise<void>;
+    searchDocuments(query: string, options?: AppDatabaseSearchOptions): Promise<AppDatabaseSearchResult[]>;
+    /** Match indexed search documents without returning their content. */
+    searchDocumentPaths(query: string, options?: AppDatabaseSearchOptions): Promise<string[]>;
+    upsertTaskProjection(record: AppDatabaseTaskRecord): Promise<void>;
+    deleteTaskProjection(path: string): Promise<void>;
+    queryTasks(query?: AppDatabaseTaskQuery): Promise<AppDatabaseTaskRecord[]>;
+    getTaskRow(lookup: {
+        path?: string;
+        id?: string;
+    }): Promise<AppDatabaseTaskRecord | undefined>;
+    listChildLinks(query: AppDatabaseTaskChildQuery): Promise<AppDatabaseLinkRecord[]>;
+    listTaskDescendants(path: string): Promise<AppDatabaseTaskRecord[]>;
+    registerProjectionDefinition(definition: IndexProjectionDefinitionRecord): Promise<void>;
+    unregisterProjectionDefinition(projectionId: string): Promise<void>;
+    replaceProjectionSource(input: ReplaceProjectionSourceInput): Promise<void>;
+    markProjectionSourceError(input: MarkProjectionSourceErrorInput): Promise<void>;
+    deleteProjectionSource(projectionId: string, sourcePath: string, writerPluginId?: string): Promise<void>;
+    queryProjection<T = Record<string, unknown>>(projectionId: string, query?: IndexQuery, readerPluginId?: string): Promise<IndexQueryResult<T>>;
+    getProjectionRow<T = Record<string, unknown>>(projectionId: string, rowId: string, readerPluginId?: string): Promise<T | null>;
+    queryRelated<T = Record<string, unknown>>(query: IndexRelatedQuery, readerPluginId?: string): Promise<IndexQueryResult<T>>;
+}
+export interface AppDatabaseOpenContext {
+    vaultId: string;
+    runtime: RuntimeTarget;
+    role?: AppDatabaseRole;
+}
+export interface AppDatabaseProvider {
+    readonly id: string;
+    canOpen(context: AppDatabaseOpenContext): boolean | Promise<boolean>;
+    open(context: AppDatabaseOpenContext): Promise<AppDatabase>;
+}
+export type AppDatabaseState = {
+    meta: Record<string, unknown>;
+    metadataSnapshot: MetadataCacheSnapshot | null;
+    searchEmbeddingProvider: SearchEmbeddingProviderConfig | null;
+    historyFiles: AppDatabaseFileHistoryFile[];
+    historyRevisions: [string, AppDatabaseFileHistoryRevision[]][];
+    files: AppDatabaseFileRecord[];
+    metadata: AppDatabaseMetadataRecord[];
+    links: [string, AppDatabaseLinkRecord[]][];
+    tags: [string, AppDatabaseTagRecord[]][];
+    properties: [string, AppDatabasePropertyRecord[]][];
+    searchDocuments: SearchDocumentRecord[];
+    tasks: AppDatabaseTaskRecord[];
+    projections?: IndexProjectionDefinitionRecord[];
+    projectionSources?: IndexProjectionSourceRecord[];
+    projectionRows?: IndexProjectionRowRecord[];
+    projectionValues?: IndexProjectionValueRecord[];
+    projectionEdges?: IndexProjectionEdgeRecord[];
+    projectionRevision?: number;
+    memorySources?: AppDatabaseMemorySourceRecord[];
+    memoryCandidates?: AppDatabaseMemoryCandidateRecord[];
+    memoryCandidateOrigins?: AppDatabaseMemoryCandidateOriginRecord[];
+    memoryRecallSignals?: AppDatabaseMemoryRecallSignalRecord[];
+    memoryJobs?: AppDatabaseMemoryJobRecord[];
+};
+export declare const APP_DATABASE_SCHEMA_VERSION = 6;
+export declare function searchTerms(query: string): string[];
+export declare function searchPropertyNames(query: string): string[];
+export declare function hasSearchPropertyNames(properties: AppDatabasePropertyRecord[], requiredNames: string[]): boolean;
+export declare function searchDocumentProperties(document: SearchDocumentRecord, indexedProperties: AppDatabasePropertyRecord[]): AppDatabasePropertyRecord[];
+export declare function mergeSearchRanges(ranges: AppDatabaseSearchRange[]): AppDatabaseSearchRange[];
+export declare function findSearchRanges(text: string, query: string, options?: SearchQueryTextRangeOptions): AppDatabaseSearchRange[];
+export declare function buildSearchSnippets(document: SearchDocumentRecord, query: string, options?: AppDatabaseSearchOptions): AppDatabaseSearchSnippet[];
+export declare function scoreSearchDocument(document: SearchDocumentRecord, query: string, properties?: AppDatabasePropertyRecord[], options?: SearchQueryEvaluationOptions): number;
+export declare const MIN_VECTOR_SEARCH_SCORE = 0.2;
+export declare const SEARCH_RRF_K = 60;
+export declare function scoreVectorDocument(document: SearchDocumentRecord, queryVector: number[]): {
+    score: number;
+    matchedChunkIds: string[];
+};
+export declare function rankSearchScores(entries: Array<{
+    path: string;
+    score: number;
+}>, isCandidate?: (score: number) => boolean): Map<string, number>;
+export declare function compareSearchResults(left: AppDatabaseSearchResult, right: AppDatabaseSearchResult): number;
+export declare function pathWithinPrefix(path: string, prefix?: string): boolean;
+export declare function resolveSearchQueryEnhancementDiagnostics(results: AppDatabaseSearchResult[], options: AppDatabaseSearchOptions): AppDatabaseSearchQueryEnhancementDiagnostics | undefined;
+export declare function embeddingErrorState(document: SearchDocumentRecord, provider: SearchEmbeddingProvider, error: unknown): SearchDocumentRecord;
+export declare function buildSearchResult(document: SearchDocumentRecord, query: string, options: AppDatabaseSearchOptions, context: {
+    backendKind: AppDatabaseKind;
+    appliedMode?: AppDatabaseSearchMode;
+    lexicalScore?: number;
+    vectorScore?: number;
+    lexicalCandidateCount?: number;
+    vectorCandidateCount?: number;
+    providerConfig?: SearchEmbeddingProviderConfig | null;
+    preferredChunkIds?: string[];
+    lexicalRank?: number;
+    vectorRank?: number;
+}): AppDatabaseSearchResult;
+export declare class MemoryAppDatabase implements AppDatabase {
+    readonly vaultId: string;
+    readonly kind: AppDatabaseKind;
+    get descriptor(): AppDatabaseDescriptor;
+    protected meta: Record<string, unknown>;
+    protected metadataSnapshot: MetadataCacheSnapshot | null;
+    protected searchEmbeddingProviderConfig: SearchEmbeddingProviderConfig | null;
+    protected searchEmbeddingProvider: SearchEmbeddingProvider | null;
+    protected searchIndexStatsByPath: Map<string, AppDatabaseSearchIndexStats>;
+    protected searchIndexStats: AppDatabaseSearchIndexStats;
+    protected searchIndexLastErrorPath: string | null;
+    protected historyFiles: Map<string, AppDatabaseFileHistoryFile>;
+    protected historyFileIdsByPath: Map<string, string>;
+    protected historyRevisions: Map<string, AppDatabaseFileHistoryRevision[]>;
+    protected files: Map<string, AppDatabaseFileRecord>;
+    protected metadata: Map<string, AppDatabaseMetadataRecord>;
+    protected links: Map<string, AppDatabaseLinkRecord[]>;
+    protected tags: Map<string, AppDatabaseTagRecord[]>;
+    protected properties: Map<string, AppDatabasePropertyRecord[]>;
+    protected searchDocs: Map<string, SearchDocumentRecord>;
+    protected tasks: Map<string, AppDatabaseTaskRecord>;
+    protected projections: Map<string, IndexProjectionDefinitionRecord>;
+    protected projectionSources: Map<string, IndexProjectionSourceRecord>;
+    protected projectionRows: Map<string, IndexProjectionRowRecord>;
+    protected projectionValues: IndexProjectionValueRecord[];
+    protected projectionEdges: IndexProjectionEdgeRecord[];
+    protected projectionRevision: number;
+    protected memorySources: Map<string, AppDatabaseMemorySourceRecord>;
+    protected memoryCandidates: Map<string, AppDatabaseMemoryCandidateRecord>;
+    protected memoryCandidateOrigins: Map<string, AppDatabaseMemoryCandidateOriginRecord[]>;
+    protected memoryRecallSignals: Map<string, AppDatabaseMemoryRecallSignalRecord>;
+    protected memoryJobs: Map<string, AppDatabaseMemoryJobRecord>;
+    protected changeRevision: number;
+    private readonly changeListeners;
+    constructor(vaultId: string);
+    open(): Promise<void>;
+    migrate(): Promise<void>;
+    close(): Promise<void>;
+    beginSearchIndexingBatch(): Promise<void>;
+    endSearchIndexingBatch(): Promise<void>;
+    configureSearchEmbeddingProvider(provider: SearchEmbeddingProviderConfig | null): Promise<void>;
+    getSearchEmbeddingProvider(): Promise<SearchEmbeddingProviderConfig | null>;
+    getSearchEmbeddingRuntimeStatus(): Promise<SearchEmbeddingRuntimeStatus | null>;
+    getSearchIndexStats(): Promise<AppDatabaseSearchIndexStats>;
+    getMeta<T = unknown>(key: string): Promise<T | undefined>;
+    setMeta(key: string, value: unknown): Promise<void>;
+    getNotebookState(sourcePath: string): Promise<AppDatabaseNotebookState | undefined>;
+    setNotebookState(sourcePath: string, state: AppDatabaseNotebookState): Promise<void>;
+    deleteNotebookState(sourcePath: string): Promise<void>;
+    loadMetadataSnapshot(): Promise<MetadataCacheSnapshot | null>;
+    saveMetadataSnapshot(snapshot: MetadataCacheSnapshot): Promise<void>;
+    getFileHistory(path: string): Promise<AppDatabaseFileHistory | null>;
+    storeFileHistoryRevision(input: AppDatabaseStoreFileHistoryRevisionInput): Promise<AppDatabaseStoreFileHistoryRevisionResult>;
+    listNotifications(): Promise<AppDatabaseNotificationRecord[]>;
+    upsertNotification(record: AppDatabaseNotificationRecord): Promise<void>;
+    markNotificationRead(id: string): Promise<void>;
+    clearNotification(id: string): Promise<void>;
+    clearAllNotifications(): Promise<void>;
+    getMemorySourceState(sourceKey: string): Promise<AppDatabaseMemorySourceRecord | undefined>;
+    listMemorySourceStates(): Promise<AppDatabaseMemorySourceRecord[]>;
+    upsertMemorySourceState(record: AppDatabaseMemorySourceRecord): Promise<void>;
+    deleteMemorySourceState(sourceKey: string): Promise<void>;
+    upsertMemoryCandidate(input: AppDatabaseMemoryCandidateInput): Promise<void>;
+    queryMemoryCandidates(query?: AppDatabaseMemoryCandidateQuery): Promise<AppDatabaseMemoryCandidateResult[]>;
+    deleteMemoryCandidatesByConversation(conversationId: string): Promise<void>;
+    recordMemoryRecallSignal(record: AppDatabaseMemoryRecallSignalRecord): Promise<void>;
+    listMemoryRecallSignals(targetRef?: string): Promise<AppDatabaseMemoryRecallSignalRecord[]>;
+    claimMemoryJob(input: AppDatabaseMemoryJobClaimInput): Promise<AppDatabaseMemoryJobRecord | null>;
+    updateMemoryJob(input: AppDatabaseMemoryJobUpdateInput): Promise<AppDatabaseMemoryJobRecord | null>;
+    listMemoryJobs(scopeKey?: string): Promise<AppDatabaseMemoryJobRecord[]>;
+    clearMemoryDerivedState(): Promise<void>;
+    getChangeRevision(): Promise<number>;
+    subscribeToChanges(listener: AppDatabaseChangeListener): () => void;
+    upsertIndexedFile(record: AppDatabaseIndexedFile): Promise<void>;
+    deleteIndexedFile(path: string): Promise<void>;
+    renameIndexedFile(oldPath: string, newPath: string): Promise<void>;
+    getIndexedFile(path: string): Promise<AppDatabaseIndexedMetadataRow | undefined>;
+    listIndexedFileManifest(query?: AppDatabaseIndexedFileManifestQuery): Promise<AppDatabaseIndexedFileManifestPage>;
+    queryIndexedMetadata(query?: AppDatabaseIndexedMetadataQuery): Promise<AppDatabaseIndexedMetadataRow[]>;
+    queryIndexedMetadataPage(input?: AppDatabaseIndexedMetadataPageQuery): Promise<AppDatabaseIndexedMetadataPage>;
+    queryMetadataFacets(query: AppDatabaseMetadataFacetQuery): Promise<AppDatabaseMetadataFacetRow[]>;
+    queryMetadataLinks(query: AppDatabaseMetadataLinkQuery): Promise<AppDatabaseLinkRecord[]>;
+    upsertSearchDocument(document: SearchDocumentRecord): Promise<void>;
+    deleteSearchDocument(path: string): Promise<void>;
+    getSearchDocument(path: string): Promise<SearchDocumentRecord | undefined>;
+    listSearchDocumentManifest(query?: SearchDocumentManifestQuery): Promise<SearchDocumentManifestPage>;
+    listSearchDocuments(): Promise<SearchDocumentRecord[]>;
+    rebuildSearchIndex(): Promise<void>;
+    protected prepareSearchDocument(document: SearchDocumentRecord): Promise<SearchDocumentRecord>;
+    searchDocuments(query: string, options?: AppDatabaseSearchOptions): Promise<AppDatabaseSearchResult[]>;
+    searchDocumentPaths(query: string, options?: AppDatabaseSearchOptions): Promise<string[]>;
+    upsertTaskProjection(record: AppDatabaseTaskRecord): Promise<void>;
+    deleteTaskProjection(path: string): Promise<void>;
+    queryTasks(query?: AppDatabaseTaskQuery): Promise<AppDatabaseTaskRecord[]>;
+    getTaskRow(lookup: {
+        path?: string;
+        id?: string;
+    }): Promise<AppDatabaseTaskRecord | undefined>;
+    registerProjectionDefinition(definition: IndexProjectionDefinitionRecord): Promise<void>;
+    unregisterProjectionDefinition(projectionId: string): Promise<void>;
+    replaceProjectionSource(input: ReplaceProjectionSourceInput): Promise<void>;
+    markProjectionSourceError(input: MarkProjectionSourceErrorInput): Promise<void>;
+    deleteProjectionSource(projectionId: string, sourcePath: string, writerPluginId?: string): Promise<void>;
+    queryProjection<T = Record<string, unknown>>(projectionId: string, query?: IndexQuery, readerPluginId?: string): Promise<IndexQueryResult<T>>;
+    getProjectionRow<T = Record<string, unknown>>(projectionId: string, rowId: string, readerPluginId?: string): Promise<T | null>;
+    private currentProjectionData;
+    queryRelated<T = Record<string, unknown>>(query: IndexRelatedQuery, readerPluginId?: string): Promise<IndexQueryResult<T>>;
+    private ensureTasksProjectionDefinition;
+    private projectionSourceKey;
+    private projectionRowKey;
+    private removeProjectionSource;
+    private renameProjectionSources;
+    listChildLinks(query: AppDatabaseTaskChildQuery): Promise<AppDatabaseLinkRecord[]>;
+    listTaskDescendants(path: string): Promise<AppDatabaseTaskRecord[]>;
+    protected searchDocumentsForPaths(query: string, options?: AppDatabaseSearchOptions, candidatePaths?: Iterable<string>): Promise<AppDatabaseSearchResult[]>;
+    protected finalizeSearchResults(results: AppDatabaseSearchResult[], options: AppDatabaseSearchOptions, limit?: number): AppDatabaseSearchResult[];
+    protected safeEmbedQuery(query: string): Promise<number[] | null>;
+    protected rebindSearchDocumentForProvider(document: SearchDocumentRecord): SearchDocumentRecord;
+    protected toState(): AppDatabaseState;
+    protected fromState(state: AppDatabaseState): void;
+    protected rebuildSearchIndexStats(): void;
+    protected computeSearchIndexStatsForDocument(document: SearchDocumentRecord): AppDatabaseSearchIndexStats;
+    protected updateSearchIndexStatsForDocument(path: string, document: SearchDocumentRecord): void;
+    protected deleteSearchIndexStatsForPath(path: string): void;
+    private addSearchIndexStats;
+    private removeSearchIndexStats;
+    private resolveFileHistoryFile;
+    protected materializeIndexedMetadataRows(candidatePaths?: Iterable<string>): AppDatabaseIndexedMetadataRow[];
+    protected applyIndexedMetadataQuery(rows: AppDatabaseIndexedMetadataRow[], query: AppDatabaseIndexedMetadataQuery): AppDatabaseIndexedMetadataRow[];
+    protected emitChange(domains: AppDatabaseChangeDomain[], paths?: string[], renamed?: {
+        oldPath: string;
+        newPath: string;
+    }[]): AppDatabaseChangeSet;
+}