@dikolab/kbdb 0.2.2 → 0.3.1

package/dist/src/shared/mcp/typings/mcp-client.interface.d.ts

@@ -35,6 +35,17 @@ export interface McpIntegrityCheckResult {
     /** Time taken to complete the check, in milliseconds. */
     readonly elapsed_ms: number;
 }
+/** Export report returned by the daemon. */
+export interface McpExportResult {
+    /** Absolute path to the directory where files were written. */
+    readonly path: string;
+    /** Number of section files copied to the export directory. */
+    readonly sections_exported: number;
+    /** Number of document manifest files copied. */
+    readonly documents_exported: number;
+    /** Time taken to complete the export, in milliseconds. */
+    readonly elapsed_ms: number;
+}
 /** Garbage collection report returned by the daemon. */
 export interface McpGcResult {
     /** Number of unreferenced sections removed. */
@@ -43,6 +54,12 @@ export interface McpGcResult {
     readonly removed_bytes: number;
     /** Time taken to complete garbage collection, in milliseconds. */
     readonly elapsed_ms: number;
+    /**
+     * Number of sections whose source_path file no longer contains
+     * their heading text. Advisory; not auto-removed by gc.
+     * Absent on older daemon versions.
+     */
+    readonly stale_sources?: number;
 }
 /** Index rebuild report returned by the daemon. */
 export interface McpRebuildResult {
@@ -75,6 +92,8 @@ export interface McpWorkerClient {
         readonly limit?: number;
         /** Number of results to skip for pagination. */
         readonly offset?: number;
+        /** Search algorithm: 'lexical', 'vector', or 'hybrid'. */
+        readonly algo?: string;
     }): Promise<{
         readonly items: readonly {
             readonly kbid: string;
@@ -84,11 +103,20 @@ export interface McpWorkerClient {
             readonly score: number;
             readonly snippet: string;
             readonly matched_terms: readonly string[];
+            /** Fields that contained matches (heading, body, code). */
+            readonly matched_fields?: readonly string[];
+            /** ISO 8601 creation timestamp of the section. */
+            readonly created_at?: string;
         }[];
         readonly total: number;
         readonly offset: number;
         readonly limit: number;
         readonly has_more: boolean;
+        /**
+         * `true` when results came from an automatic AND-to-OR
+         * fallback query relaxation.
+         */
+        readonly relaxed?: boolean;
     }>;
     /**
      * Adds a new section to the knowledge base.
@@ -107,6 +135,13 @@ export interface McpWorkerClient {
         readonly description?: string;
         /** Optional document ID to group this section under. */
         readonly docid?: string;
+        /** Optional tags for scoping and filtering. */
+        readonly tags?: string[];
+        /**
+         * When `true`, replaces an existing section that has the same
+         * source key (supersession).
+         */
+        readonly replace?: boolean;
     }): Promise<AddSectionResult>;
     /**
      * Removes a section from the knowledge base.
@@ -230,6 +265,16 @@ export interface McpWorkerClient {
         /** Expansion depth (0-3, default: 0). */
         readonly depth?: number;
     }): Promise<unknown>;
+    /**
+     * Exports the database to a target directory as a self-contained
+     * snapshot (sections, documents, catalog -- no indexes).
+     *
+     * @param params - optional export parameters
+     * @returns export report with the resolved path and file counts
+     */
+    export(params?: {
+        readonly path?: string;
+    }): Promise<McpExportResult>;
     /** Destroys the IPC socket and clears the connection state. */
     disconnect(): void;
 }

package/dist/src/shared/mcp/typings/mcp-completion.interface.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Discriminated reference used in MCP completion requests.
+ * Identifies whether the completion target is a prompt or a resource.
+ */
+export interface McpCompletionRef {
+    /**
+     * The reference type: `'ref/prompt'` for named prompts (skills
+     * and agents) or `'ref/resource'` for resource URIs.
+     */
+    readonly type: 'ref/prompt' | 'ref/resource';
+    /** Prompt name, present when `type` is `'ref/prompt'`. */
+    readonly name?: string;
+    /** Resource URI, present when `type` is `'ref/resource'`. */
+    readonly uri?: string;
+}
+/**
+ * Completion argument supplied by the client, describing which
+ * argument is being completed and the current partial value.
+ */
+export interface McpCompletionArgument {
+    /** The argument name being completed. */
+    readonly name: string;
+    /** The partial value typed so far; used for prefix filtering. */
+    readonly value: string;
+}
+/**
+ * Result returned by `handleCompletion`, containing the list of
+ * matching completion values and pagination metadata.
+ */
+export interface McpCompletionResult {
+    /** Completion payload. */
+    readonly completion: {
+        /** Matching completion strings for the given prefix. */
+        readonly values: string[];
+        /**
+         * Whether more results are available beyond what is returned.
+         * Always `false` in this implementation.
+         */
+        readonly hasMore: boolean;
+        /** Total number of values returned. */
+        readonly total: number;
+    };
+}

package/dist/src/shared/mcp/typings/mcp-content-result.model.d.ts

@@ -0,0 +1,9 @@
+/** Result returned by content composition. */
+export interface McpContentResult {
+    /** MIME type of the composed output, always `'text/markdown'`. */
+    readonly type: 'text/markdown';
+    /** The composed Markdown string. */
+    readonly data: string;
+    /** Character count of `data` (not byte count). */
+    readonly total: number;
+}

package/dist/src/shared/mcp/typings/mcp-export-result.model.d.ts

@@ -0,0 +1,11 @@
+/** Export report returned by the daemon. */
+export interface McpExportResult {
+    /** Absolute path to the directory where files were written. */
+    readonly path: string;
+    /** Number of section files copied to the export directory. */
+    readonly sections_exported: number;
+    /** Number of document manifest files copied. */
+    readonly documents_exported: number;
+    /** Time taken to complete the export, in milliseconds. */
+    readonly elapsed_ms: number;
+}

package/dist/src/shared/mcp/typings/mcp-gc-result.model.d.ts

@@ -0,0 +1,15 @@
+/** Garbage collection report returned by the daemon. */
+export interface McpGcResult {
+    /** Number of unreferenced sections removed. */
+    readonly removed_sections: number;
+    /** Total bytes freed by removing unreferenced sections. */
+    readonly removed_bytes: number;
+    /** Time taken to complete garbage collection, in milliseconds. */
+    readonly elapsed_ms: number;
+    /**
+     * Number of sections whose source_path file no longer contains
+     * their heading text. Advisory; not auto-removed by gc.
+     * Absent on older daemon versions.
+     */
+    readonly stale_sources?: number;
+}

package/dist/src/shared/mcp/typings/mcp-integrity-check-result.model.d.ts

@@ -0,0 +1,16 @@
+import type { McpIntegrityError } from './mcp-integrity-error.model.ts';
+/** Integrity check report returned by the daemon. */
+export interface McpIntegrityCheckResult {
+    /** `true` when all checks passed and no errors were found. */
+    readonly ok: boolean;
+    /** All integrity errors found; empty when `ok` is `true`. */
+    readonly errors: McpIntegrityError[];
+    /** Total number of sections examined. */
+    readonly sections_checked: number;
+    /** Total number of documents examined. */
+    readonly documents_checked: number;
+    /** Total number of marker references checked. */
+    readonly references_checked: number;
+    /** Time taken to complete the check, in milliseconds. */
+    readonly elapsed_ms: number;
+}

package/dist/src/shared/mcp/typings/mcp-integrity-error.model.d.ts

@@ -0,0 +1,9 @@
+/** A single integrity error found during a database check. */
+export interface McpIntegrityError {
+    /** The category of integrity violation detected. */
+    readonly type: 'checksum_mismatch' | 'orphan_section' | 'orphan_document' | 'broken_reference' | 'type_mismatch' | 'circular_reference';
+    /** Identifier of the entity (kbid or docid) that has the issue. */
+    readonly entity: string;
+    /** Human-readable description of the specific problem. */
+    readonly detail: string;
+}

package/dist/src/shared/mcp/typings/mcp-notification.interface.d.ts

@@ -0,0 +1,9 @@
+/** A JSON-RPC 2.0 notification with no expected response. */
+export interface McpNotification {
+    /** JSON-RPC protocol version. Must always be '2.0'. */
+    readonly jsonrpc: '2.0';
+    /** Notification method name. */
+    readonly method: string;
+    /** Optional notification parameters. */
+    readonly params?: Record<string, unknown>;
+}

package/dist/src/shared/mcp/typings/mcp-rebuild-result.model.d.ts

@@ -0,0 +1,9 @@
+/** Index rebuild report returned by the daemon. */
+export interface McpRebuildResult {
+    /** Number of text and code sections that were re-indexed. */
+    readonly sections_reindexed: number;
+    /** Total number of unique terms written to the rebuilt indexes. */
+    readonly terms_indexed: number;
+    /** Time taken to complete the rebuild, in milliseconds. */
+    readonly elapsed_ms: number;
+}

package/dist/src/shared/mcp/typings/mcp-request.interface.d.ts

@@ -0,0 +1,11 @@
+/** A JSON-RPC 2.0 request message sent to the MCP server. */
+export interface McpRequest {
+    /** JSON-RPC protocol version. Must always be '2.0'. */
+    readonly jsonrpc: '2.0';
+    /** Request identifier; absent for notifications. */
+    readonly id?: number | string;
+    /** RPC method name. */
+    readonly method: string;
+    /** Optional method parameters. */
+    readonly params?: Record<string, unknown>;
+}

package/dist/src/shared/mcp/typings/mcp-resource-result.interface.d.ts

@@ -0,0 +1,12 @@
+/** Result returned by `handleResourceRead`. */
+export interface McpResourceResult {
+    /** One or more content items for the requested resource URI. */
+    readonly contents: readonly {
+        /** The resource URI that was read. */
+        readonly uri: string;
+        /** MIME type of the content body. */
+        readonly mimeType: string;
+        /** Text body of the resource. */
+        readonly text: string;
+    }[];
+}

package/dist/src/shared/mcp/typings/mcp-resource-template.interface.d.ts

@@ -0,0 +1,11 @@
+/** A URI template describing an MCP resource the server serves. */
+export interface McpResourceTemplate {
+    /** RFC 6570 URI template for the resource. */
+    readonly uriTemplate: string;
+    /** Human-readable resource name. */
+    readonly name: string;
+    /** Human-readable description of the resource. */
+    readonly description: string;
+    /** Optional MIME type for the resource content. */
+    readonly mimeType?: string;
+}

package/dist/src/shared/mcp/typings/mcp-response.interface.d.ts

@@ -0,0 +1,18 @@
+/** A JSON-RPC 2.0 response message sent from the MCP server. */
+export interface McpResponse {
+    /** JSON-RPC protocol version. Must always be '2.0'. */
+    readonly jsonrpc: '2.0';
+    /** Echoes the request identifier. */
+    readonly id: number | string;
+    /** Successful result payload; absent when error is set. */
+    readonly result?: unknown;
+    /** Error payload; absent when result is set. */
+    readonly error?: {
+        /** Numeric error code as defined by JSON-RPC or MCP. */
+        readonly code: number;
+        /** Human-readable error message. */
+        readonly message: string;
+        /** Optional additional error data. */
+        readonly data?: unknown;
+    };
+}

package/dist/src/shared/mcp/typings/mcp-server-info.interface.d.ts

@@ -0,0 +1,7 @@
+/** Identity information for the MCP server. */
+export interface McpServerInfo {
+    /** Server name reported during MCP initialization. */
+    readonly name: string;
+    /** Server version string reported during MCP initialization. */
+    readonly version: string;
+}

package/dist/src/shared/mcp/typings/mcp-server-state.interface.d.ts

@@ -0,0 +1,16 @@
+import type { McpLogLevel } from './log-types.interface.ts';
+/**
+ * Mutable runtime state shared by `McpServer` and its request
+ * handler. Extracted as an interface so the handler can be
+ * tested independently of the full server class.
+ */
+export interface McpServerState {
+    /** Advertised capabilities received from the MCP host. */
+    hostCapabilities: Record<string, unknown> | null;
+    /** Currently configured log level, or `null` when unset. */
+    logLevel: McpLogLevel | null;
+    /** Set of URI strings that the host has subscribed to. */
+    readonly subscriptions: Set<string>;
+    /** Filesystem path used as the KB context root. */
+    readonly contextPath: string;
+}

package/dist/src/shared/mcp/typings/mcp-tool-annotations.interface.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Optional behavioral hints for an MCP tool, used by clients to
+ * decide how to present or invoke the tool safely.
+ */
+export interface McpToolAnnotations {
+    /**
+     * Human-readable title for the tool, suitable for display
+     * in client UIs.
+     */
+    readonly title?: string;
+    /**
+     * When `true`, the tool only reads data and does not modify
+     * any server-side state.
+     */
+    readonly readOnlyHint?: boolean;
+    /**
+     * When `true`, the tool may cause data loss or irreversible
+     * changes.
+     */
+    readonly destructiveHint?: boolean;
+    /**
+     * When `true`, calling the tool multiple times with the same
+     * arguments produces the same result with no additional side
+     * effects.
+     */
+    readonly idempotentHint?: boolean;
+    /**
+     * When `true`, the tool may interact with systems or data
+     * outside the immediate knowledge base context.
+     */
+    readonly openWorldHint?: boolean;
+}

package/dist/src/shared/mcp/typings/mcp-tool-definition.interface.d.ts

@@ -0,0 +1,15 @@
+import type { McpToolAnnotations } from './mcp-tool-annotations.interface.ts';
+/** Definition of a single MCP tool exposed by the server. */
+export interface McpToolDefinition {
+    /** Unique tool name used to invoke it. */
+    readonly name: string;
+    /** Human-readable description of what the tool does. */
+    readonly description: string;
+    /** JSON Schema object describing the tool's input parameters. */
+    readonly inputSchema: Record<string, unknown>;
+    /**
+     * Optional behavioral hints that describe how the tool
+     * interacts with state.
+     */
+    readonly annotations?: McpToolAnnotations;
+}

package/dist/src/shared/mcp/typings/mcp-tool-result.interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Result returned by `handleToolCall`. Successful tool responses
+ * carry `isError: true` for application-level failures rather than
+ * using JSON-RPC error responses.
+ */
+export interface McpToolResult {
+    /** One or more text content items describing the result. */
+    readonly content: readonly {
+        /** Content type identifier, always 'text'. */
+        readonly type: string;
+        /** Text payload of the content item. */
+        readonly text: string;
+    }[];
+    /**
+     * Set to `true` when the tool encountered an application-level
+     * error. Absent or `false` on success.
+     */
+    readonly isError?: boolean;
+}

package/dist/src/shared/mcp/typings/mcp-worker-client.interface.d.ts

@@ -0,0 +1,220 @@
+import type { AddSectionResult } from '../../worker-client/typings/add-section-result.model.ts';
+import type { RemoveSectionResult } from './remove-section-result.model.ts';
+import type { SectionRecord } from '../../wasm-codec/functions/decode-section-records.function.ts';
+import type { DocumentManifest } from '../../wasm-codec/functions/decode-document-manifest.function.ts';
+import type { McpContentResult } from './mcp-content-result.model.ts';
+import type { McpIntegrityCheckResult } from './mcp-integrity-check-result.model.ts';
+import type { McpGcResult } from './mcp-gc-result.model.ts';
+import type { McpRebuildResult } from './mcp-rebuild-result.model.ts';
+import type { McpExportResult } from './mcp-export-result.model.ts';
+/**
+ * Interface for the worker client dependency consumed by the MCP
+ * server. Defines the knowledge-base operations the server exposes
+ * as MCP tools and resources without coupling to the concrete
+ * `WorkerClient` class.
+ */
+export interface McpWorkerClient {
+    /**
+     * Searches the knowledge base using the given parameters.
+     *
+     * @param params - query string and optional search options
+     * @returns ranked list of matching section summaries
+     */
+    search(params: {
+        /** Natural language query text. */
+        readonly query: string;
+        /** Search mode: 'sections', 'documents', or 'stats'. */
+        readonly mode?: string;
+        /**
+         * Search algorithm: `'lexical'`, `'vector'`, or `'hybrid'`.
+         * Defaults to `'lexical'` when omitted.
+         */
+        readonly algo?: string;
+        /** Maximum number of results to return. */
+        readonly limit?: number;
+        /** Number of results to skip for pagination. */
+        readonly offset?: number;
+    }): Promise<{
+        readonly items: readonly {
+            readonly kbid: string;
+            readonly heading: string | null;
+            readonly type: string;
+            readonly docids: readonly string[];
+            readonly score: number;
+            readonly snippet: string;
+            readonly matched_terms: readonly string[];
+            /** Fields that contained matches (heading, body, code). */
+            readonly matched_fields?: readonly string[];
+            /** ISO 8601 creation timestamp of the section. */
+            readonly created_at?: string;
+        }[];
+        readonly total: number;
+        readonly offset: number;
+        readonly limit: number;
+        readonly has_more: boolean;
+        /**
+         * `true` when results came from an automatic AND-to-OR
+         * fallback query relaxation.
+         */
+        readonly relaxed?: boolean;
+    }>;
+    /**
+     * Adds a new section to the knowledge base.
+     *
+     * @param params - content type, raw content, and optional metadata
+     * @returns the assigned knowledge-base identifier
+     */
+    addSection(params: {
+        /** Semantic type label for the section content. */
+        readonly sectionType: string;
+        /** Raw text or base64-encoded content for the section. */
+        readonly content: string;
+        /** Optional section title. Required for image/* types. */
+        readonly title?: string;
+        /** Optional section description. */
+        readonly description?: string;
+        /** Optional document ID to group this section under. */
+        readonly docid?: string;
+        /** Optional tags for scoping and filtering. */
+        readonly tags?: string[];
+        /**
+         * When `true`, replaces an existing section that has the same
+         * source key (supersession).
+         */
+        readonly replace?: boolean;
+    }): Promise<AddSectionResult>;
+    /**
+     * Removes a section from the knowledge base.
+     *
+     * @param kbid - knowledge-base identifier of the section to remove
+     * @returns removal result with `removed` flag and elapsed time
+     */
+    removeSection(kbid: string): Promise<RemoveSectionResult>;
+    /**
+     * Retrieves one or more sections by their identifiers.
+     *
+     * @param kbids - list of knowledge-base identifiers to fetch
+     * @returns sections in the order their IDs were requested
+     */
+    readSections(kbids: string[]): Promise<{
+        /** Knowledge-base identifier for this section. */
+        kbid: string;
+        /** Semantic type label assigned to the section. */
+        sectionType: string;
+        /** Raw text content of the section. */
+        content: string;
+        /** Byte size of the stored content. */
+        size: number;
+    }[]>;
+    /**
+     * Retrieves a full document record including its ordered sections.
+     *
+     * @param docid - identifier of the document to retrieve
+     * @returns the document record as returned by the daemon
+     */
+    retrieveDocument(docid: string): Promise<unknown>;
+    /**
+     * Composes a rendered Markdown document from one or more kbid
+     * or docid identifiers.
+     *
+     * @param ids - list of kbid or docid identifiers (may be mixed)
+     * @returns composed Markdown result with character count
+     */
+    content(ids: string[]): Promise<McpContentResult>;
+    /**
+     * Returns database metadata and status from the daemon.
+     *
+     * @returns document count, section count, and timing statistics
+     */
+    dbStatus(): Promise<{
+        /** Whether the daemon has finished loading its WASM modules. */
+        initialized: boolean;
+        /** Absolute path to the context directory the daemon serves. */
+        contextPath: string;
+        /** In-memory cache statistics. */
+        cacheStats: {
+            /** Number of content entries currently cached. */
+            contentCount: number;
+            /** Number of index entries currently cached. */
+            indexCount: number;
+        };
+    }>;
+    /**
+     * Runs an integrity check on the knowledge-base database.
+     *
+     * @returns a report of all issues found; `ok` is `true` when
+     *   no errors were detected
+     */
+    integrityCheck(): Promise<McpIntegrityCheckResult>;
+    /**
+     * Removes unreferenced sections from the database.
+     *
+     * @returns a report of sections removed and bytes freed
+     */
+    gc(): Promise<McpGcResult>;
+    /**
+     * Reconstructs all index files from section files and document
+     * manifests on disk.
+     *
+     * @returns a report of sections and terms re-indexed
+     */
+    rebuildIndexes(): Promise<McpRebuildResult>;
+    /**
+     * Retrieves all sections whose type name matches the given string.
+     *
+     * @param sectionType - the application-level type name to filter by
+     * @returns all section records with a matching type name
+     */
+    listByType(sectionType: string): Promise<SectionRecord[]>;
+    /**
+     * Retrieves all documents whose type name matches the given string.
+     *
+     * @param docType - the application-level document type to filter by
+     * @returns all document manifests with a matching type name
+     */
+    listDocumentsByType(docType: string): Promise<DocumentManifest[]>;
+    /**
+     * Groups a set of sections under a named document.
+     *
+     * @param title - human-readable document title
+     * @param kbids - identifiers of the sections to group
+     * @returns the assigned document identifier
+     */
+    groupSections(title: string, kbids: string[], docType?: string): Promise<string>;
+    /**
+     * Removes the document grouping for the given document.
+     *
+     * The sections themselves are not deleted; only the grouping
+     * record is removed.
+     *
+     * @param docid - identifier of the document grouping to remove
+     */
+    removeGrouping(docid: string): Promise<void>;
+    /**
+     * Retrieves full content and context for one or more sections by
+     * their knowledge-base identifiers.
+     *
+     * @param params - section identifier(s) and optional expansion depth
+     * @returns a single result or array of results depending on input
+     */
+    recall(params: {
+        /** Single section identifier. */
+        readonly kbid?: string;
+        /** Batch section identifiers. */
+        readonly kbids?: readonly string[];
+        /** Expansion depth (0-3, default: 0). */
+        readonly depth?: number;
+    }): Promise<unknown>;
+    /**
+     * Exports the database to a target directory as a self-contained
+     * snapshot (sections, documents, catalog -- no indexes).
+     *
+     * @param params - optional export parameters
+     * @returns export report with the resolved path and file counts
+     */
+    export(params?: {
+        readonly path?: string;
+    }): Promise<McpExportResult>;
+    /** Destroys the IPC socket and clears the connection state. */
+    disconnect(): void;
+}

package/dist/src/shared/mcp/typings/tool-call-result.model.d.ts

@@ -0,0 +1,17 @@
+/** Shape of a content item in an MCP tool call response. */
+export interface ToolContent {
+    /** Content type identifier, typically `'text'`. */
+    readonly type: string;
+    /** The text payload. */
+    readonly text: string;
+}
+/**
+ * Result returned by any MCP tool call handler, containing one or
+ * more content items and an optional error flag.
+ */
+export interface ToolCallResult {
+    /** One or more content items describing the result. */
+    readonly content: ToolContent[];
+    /** Set to `true` when the tool encountered an error. */
+    readonly isError?: boolean;
+}

package/dist/src/shared/sync/functions/build-import-report.function.d.ts

@@ -0,0 +1,18 @@
+import type { ConflictResolution } from '../typings/conflict-resolution.type.ts';
+import type { ExportEntry } from '../typings/export-entry.interface.ts';
+import type { ImportReport } from '../typings/import-report.interface.ts';
+/** A resolution record pairing an entry with its resolution. */
+interface ResolutionRecord {
+    /** The export entry being resolved. */
+    readonly entry: ExportEntry;
+    /** The resolution applied to the entry. */
+    readonly resolution: ConflictResolution;
+}
+/**
+ * Builds an import report from resolution results.
+ *
+ * Counts each resolution type and determines whether
+ * a database rebuild is required after the import.
+ */
+export declare function buildImportReport(resolutions: readonly ResolutionRecord[]): ImportReport;
+export {};

package/dist/src/shared/sync/functions/parse-export-entry.function.d.ts

@@ -0,0 +1,11 @@
+import type { ExportEntry } from '../typings/export-entry.interface.ts';
+/**
+ * Parses a serialized export entry.
+ *
+ * Expects TOML frontmatter delimited by `+++` lines,
+ * followed by the body content.
+ *
+ * @throws {Error} if the frontmatter delimiters are absent
+ *   or required fields are missing.
+ */
+export declare function parseExportEntry(content: string): ExportEntry;

package/dist/src/shared/sync/functions/resolve-conflict.function.d.ts

@@ -0,0 +1,13 @@
+import type { ConflictResolution } from '../typings/conflict-resolution.type.ts';
+import type { ExportEntry } from '../typings/export-entry.interface.ts';
+/**
+ * Determines the conflict resolution action for
+ * an incoming section.
+ *
+ * Rules applied in order:
+ * 1. Same kbid exists -> skip
+ * 2. Same source_key, incoming is newer -> supersede
+ * 3. Same source_key, incoming is not newer -> skip
+ * 4. No match -> add
+ */
+export declare function resolveConflict(incoming: ExportEntry, existingKbids: ReadonlySet<string>, existingBySourceKey: ReadonlyMap<string, ExportEntry>): ConflictResolution;