@dikolab/kbdb 0.2.2 → 0.3.0

package/dist/src/shared/cli/functions/run-learn.function.d.ts

@@ -1,5 +1,28 @@
 import type { CliOptions } from '../typings/cli-options.interface.ts';
 import type { LearnResult } from '../typings/learn-result.model.ts';
+/** Enriched add-section result returned by the daemon. */
+interface AddSectionResult {
+    /** Knowledge-base identifier assigned to the new section. */
+    readonly kbid: string;
+    /**
+     * Kbid of the section superseded via `--replace`,
+     * or `null` / `undefined` when none.
+     */
+    readonly superseded?: string | null;
+    /**
+     * Advisory warning strings (e.g. `"heading_missing"`).
+     * May be absent from older daemon versions.
+     */
+    readonly warnings?: string[];
+    /**
+     * Near-duplicate sections with similarity >= 0.85.
+     * May be absent from older daemon versions.
+     */
+    readonly near_duplicates?: {
+        readonly kbid: string;
+        readonly similarity: number;
+    }[];
+}
 /**
  * Minimal client interface required by `runLearn`.
  *
@@ -10,9 +33,9 @@ export interface LearnClient {
     /**
      * Ingests a content section into the knowledge base.
      *
-     * @param params - section type label and raw text content
-     * @returns result object containing the knowledge-base identifier
-     *   assigned to the section
+     * @param params - section metadata and raw text content
+     * @returns enriched result containing the new kbid plus
+     *   optional supersession, warnings, and near-duplicate info
      */
     addSection(params: {
         sectionType: string;
@@ -20,9 +43,14 @@ export interface LearnClient {
         title?: string;
         description?: string;
         docid?: string;
-    }): Promise<{
-        kbid: string;
-    }>;
+        tags?: string[];
+        replace?: boolean;
+        /**
+         * Absolute path to the source file. Required for supersession
+         * via source key when `replace` is `true`.
+         */
+        sourcePath?: string;
+    }): Promise<AddSectionResult>;
 }
 /** Injectable I/O for testing without real stdin. */
 export interface LearnIO {
@@ -44,3 +72,4 @@ export interface LearnIO {
  * @returns one `LearnResult` per file successfully ingested
  */
 export declare function runLearn(client: LearnClient, options: CliOptions, io?: LearnIO): Promise<LearnResult[]>;
+export {};

package/dist/src/shared/cli/functions/run-recall.function.d.ts

@@ -0,0 +1,45 @@
+import type { CliOptions } from '../typings/cli-options.interface.ts';
+import type { RecallResult } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Minimal client interface required by `runRecall`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface RecallClient {
+    /**
+     * Retrieves full content and context for one or more sections
+     * by their knowledge-base identifiers.
+     *
+     * @param params - section identifier(s) and optional expansion
+     *   depth (0--3)
+     * @returns a single `RecallResult` when `kbid` is supplied, or
+     *   a `RecallResult[]` when `kbids` is supplied
+     */
+    recall(params: {
+        kbid?: string;
+        kbids?: string[];
+        depth?: number;
+    }): Promise<RecallResult | RecallResult[]>;
+}
+/**
+ * Retrieves full content and progressive context for one or more
+ * sections by kbid via the provided client.
+ *
+ * Returns an error result when no kbids are provided in
+ * `options.args`. For a single kbid, calls `client.recall` with the
+ * `kbid` parameter and returns the single `RecallResult`. For
+ * multiple kbids, calls `client.recall` with the `kbids` array.
+ *
+ * The `depth` option is read from `options.depth`, defaulting to 0
+ * and clamped to the range 0--3.
+ *
+ * @param client - recall client to delegate to
+ * @param options - parsed CLI options supplying kbids in `args` and
+ *   expansion depth in `depth`
+ * @returns the `RecallResult` or `RecallResult[]` from the client,
+ *   or an error object when no kbids are provided
+ */
+export declare function runRecall(client: RecallClient, options: CliOptions): Promise<RecallResult | RecallResult[] | {
+    error: string;
+}>;

package/dist/src/shared/cli/functions/run-search.function.d.ts

@@ -1,5 +1,55 @@
 import type { CliOptions } from '../typings/cli-options.interface.ts';
 import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
+/** A single raw search result item returned by the daemon. */
+interface RawSearchItem {
+    /** Knowledge-base identifier of the matched section. */
+    readonly kbid: string;
+    /** Section heading, or null when untitled. */
+    readonly heading: string | null;
+    /** MIME type of the section content. */
+    readonly type: string;
+    /** Document IDs this section belongs to. */
+    readonly docids: readonly string[];
+    /** Relevance score from the ranking engine. */
+    readonly score: number;
+    /** KWIC excerpt centered on the highest-scoring matched term. */
+    readonly snippet: string;
+    /** Query terms that matched within this section. */
+    readonly matched_terms: readonly string[];
+    /**
+     * Fields that contained at least one match.
+     * May be absent from older daemon versions.
+     */
+    readonly matched_fields?: readonly string[];
+    /**
+     * Normalised confidence score (0.0-1.0) relative to the top result.
+     * May be absent from older daemon versions.
+     */
+    readonly confidence?: number;
+    /**
+     * ISO 8601 creation timestamp of the section.
+     * May be absent from older daemon versions.
+     */
+    readonly created_at?: string;
+}
+/** Raw paginated search response from the daemon. */
+interface RawSearchResponse {
+    /** Result items for the current page. */
+    readonly items: readonly RawSearchItem[];
+    /** Total number of matches across all pages. */
+    readonly total: number;
+    /** Number of results skipped. */
+    readonly offset: number;
+    /** Maximum results per page. */
+    readonly limit: number;
+    /** Whether more results exist beyond this page. */
+    readonly has_more: boolean;
+    /**
+     * When `true`, the engine relaxed the query to produce results.
+     * May be absent from older daemon versions.
+     */
+    readonly relaxed?: boolean;
+}
 /**
  * Minimal client interface required by `runSearch`.
  *
@@ -17,21 +67,7 @@ export interface SearchClient {
         mode?: string;
         limit?: number;
         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[];
-        }[];
-        readonly total: number;
-        readonly offset: number;
-        readonly limit: number;
-        readonly has_more: boolean;
-    }>;
+    }): Promise<RawSearchResponse>;
 }
 /**
  * Executes a search query via the provided client and maps the
@@ -46,3 +82,4 @@ export interface SearchClient {
  *   search parameters
  */
 export declare function runSearch(client: SearchClient, options: CliOptions): Promise<PagedSearchDisplay>;
+export {};

package/dist/src/shared/cli/index.d.ts

@@ -1,6 +1,8 @@
 export { parseArgs } from './functions/parse-args.function.ts';
 export { formatOutput } from './functions/format-output.function.ts';
 export { runSearch } from './functions/run-search.function.ts';
+export { runRecall } from './functions/run-recall.function.ts';
+export { runExport } from './functions/run-export.function.ts';
 export { runLearn } from './functions/run-learn.function.ts';
 export { runUnlearn } from './functions/run-unlearn.function.ts';
 export { runContent } from './functions/run-content.function.ts';
@@ -21,6 +23,8 @@ export type { CliOptions, OutputFormat, SearchMode, } from './typings/cli-option
 export type { LearnResult } from './typings/learn-result.model.ts';
 export type { SearchDisplay, PagedSearchDisplay, } from './typings/search-display.model.ts';
 export type { SearchClient } from './functions/run-search.function.ts';
+export type { RecallClient } from './functions/run-recall.function.ts';
+export type { ExportClient } from './functions/run-export.function.ts';
 export type { LearnClient } from './functions/run-learn.function.ts';
 export type { UnlearnClient, UnlearnResult, } from './functions/run-unlearn.function.ts';
 export type { ContentClient } from './functions/run-content.function.ts';

package/dist/src/shared/cli/typings/cli-options.interface.d.ts

@@ -50,6 +50,19 @@ export interface CliOptions {
     body?: string;
     /** Comma-separated skill kbids for agent create. */
     skills?: string[];
+    /**
+     * Recall expansion depth (0-3). Clamped to 3.
+     * Defaults to 0.
+     */
+    depth?: number;
+    /** Comma-separated tags for scoping (learn, recall). */
+    tags?: string[];
+    /**
+     * When `true`, enables supersession by source key (learn).
+     * Re-learning edited content replaces the original section
+     * instead of creating a sibling.
+     */
+    replace?: boolean;
     /** Positional arguments following the sub-command. */
     args: string[];
 }

package/dist/src/shared/cli/typings/learn-result.model.d.ts

@@ -8,4 +8,23 @@ export interface LearnResult {
     size: number;
     /** `true` when the file was skipped without being ingested. */
     skipped: boolean;
+    /**
+     * Kbid of the section that was superseded via `--replace`,
+     * or `null` when no supersession occurred.
+     */
+    superseded: string | null;
+    /**
+     * Advisory warning strings returned by the engine
+     * (e.g. `"heading_missing"` when no title is provided).
+     */
+    warnings: string[];
+    /**
+     * Sections with content similarity >= 0.85 to this section.
+     * Each entry identifies a near-duplicate section and its
+     * similarity score.
+     */
+    near_duplicates: {
+        kbid: string;
+        similarity: number;
+    }[];
 }

package/dist/src/shared/cli/typings/search-display.model.d.ts

@@ -10,10 +10,22 @@ export interface SearchDisplay {
     docids: readonly string[];
     /** Relevance score assigned by the ranking engine. */
     score: number;
+    /**
+     * Normalised confidence score (0.0-1.0) relative to the
+     * top result in this result set.
+     */
+    confidence: number;
     /** KWIC snippet from the WASM engine (~150 chars). */
     snippet: string;
     /** Query terms that matched within this section. */
     matched_terms: readonly string[];
+    /**
+     * Fields that contained at least one match:
+     * subset of `["heading", "body", "code"]`.
+     */
+    matched_fields: readonly string[];
+    /** ISO 8601 creation timestamp of the section. */
+    created_at: string;
     /**
      * CLI-side truncated content preview for terminal display.
      * Populated when `--content` / `-c` is used.
@@ -32,4 +44,10 @@ export interface PagedSearchDisplay {
     limit: number;
     /** Whether more results exist beyond this page. */
     has_more: boolean;
+    /**
+     * When `true`, the engine relaxed the query (e.g. dropped
+     * rare terms) to return results that would otherwise be
+     * empty.
+     */
+    relaxed: boolean;
 }

package/dist/src/shared/mcp/classes/mcp-server.class.d.ts

@@ -52,4 +52,12 @@ export declare class McpServer {
     private processLine;
     private handleRequest;
     private send;
+    /**
+     * Runs an integrity check immediately after the MCP handshake
+     * completes. Emits a `notifications/message` warning when the
+     * check detects issues so the connected agent is aware before
+     * making requests. The server continues operating regardless of
+     * the result.
+     */
+    private runStartupHealthCheck;
 }

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 {
@@ -84,11 +101,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 +133,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 +263,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/wasm-codec/functions/decode-add-section-result.function.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A near-duplicate section identified during add-section indexing.
+ */
+export interface NearDuplicate {
+    /** Knowledge-base identifier of the near-duplicate section. */
+    readonly kbid: string;
+    /** Jaccard similarity score (0.0–1.0). */
+    readonly similarity: number;
+}
+/**
+ * Decoded result of a `worker_add_section` WASM call.
+ *
+ * Mirrors the Rust `AddSectionResult` struct encoded via the
+ * `Encode` trait wire format.
+ */
+export interface AddSectionResult {
+    /** Knowledge-base identifier assigned to the new section. */
+    readonly kbid: string;
+    /** Number of unique terms indexed for the section. */
+    readonly indexedTermsCount: number;
+    /** Wall-clock time the add operation took, in milliseconds. */
+    readonly elapsedMs: number;
+    /**
+     * Knowledge-base identifier of the section that was superseded,
+     * or `null` if no supersession occurred.
+     */
+    readonly superseded: string | null;
+    /** Advisory warnings emitted during indexing. */
+    readonly warnings: string[];
+    /**
+     * Near-duplicate sections detected above the similarity threshold
+     * (Jaccard ≥ 0.85).
+     */
+    readonly nearDuplicates: NearDuplicate[];
+}
+/**
+ * Decodes the binary `AddSectionResult` returned by the
+ * `worker_add_section` WASM export.
+ *
+ * Wire format (little-endian):
+ * - `kbid`: `u32` length + UTF-8 bytes
+ * - `indexed_terms_count`: `u32`
+ * - `elapsed_ms`: `u64`
+ * - `superseded`: `u8` flag (0=None, 1=Some) + optional `String`
+ * - `warnings`: `u32` count + each `String`
+ * - `near_duplicates`: `u32` count + each (`String` + `f32`)
+ */
+export declare function decodeAddSectionResult(bytes: Uint8Array): AddSectionResult;

package/dist/src/shared/wasm-codec/functions/decode-scored-results.function.d.ts

@@ -1,17 +1,75 @@
+/**
+ * A single ranked result item from a paged search response.
+ */
 export interface SectionMatch {
+    /** Knowledge-base identifier for the matched section. */
     kbid: string;
+    /** Section heading, or `null` when untitled. */
     heading: string | null;
+    /** MIME type of the section content. */
     type: string;
+    /** Document IDs this section belongs to. */
     docids: string[];
+    /** Relevance score from the ranking engine. */
     score: number;
+    /**
+     * Confidence modifier (0.0–1.0) applied after relaxed search.
+     * Always 1.0 for strict-mode results.
+     */
+    confidence: number;
+    /** KWIC snippet (~150 chars around the best match). */
     snippet: string;
+    /** Query terms that matched within this section. */
     matched_terms: string[];
+    /**
+     * Document fields that contained at least one matched term
+     * (e.g. `'title'`, `'body'`).
+     */
+    matched_fields: string[];
+    /** ISO 8601 creation timestamp of the section. */
+    created_at: string;
 }
+/**
+ * Paginated search response envelope returned by the WASM engine.
+ */
 export interface PagedSearchResult {
+    /** Matching sections for the current page. */
     items: SectionMatch[];
+    /** Total number of matches across all pages. */
     total: number;
+    /** Number of results skipped (pagination offset). */
     offset: number;
+    /** Maximum results per page. */
     limit: number;
+    /** Whether more results exist beyond this page. */
     has_more: boolean;
+    /**
+     * Whether the engine fell back to relaxed (OR-mode) search
+     * after strict (AND-mode) returned no results.
+     */
+    relaxed: boolean;
 }
+/**
+ * Decodes the binary `PagedSearchResult` returned by the
+ * `worker_get_result` WASM export after a `worker_search` call.
+ *
+ * Wire format (little-endian):
+ * - `total`: `u32`
+ * - `offset`: `u32`
+ * - `limit`: `u32`
+ * - `has_more`: `u8` (0/1)
+ * - `relaxed`: `u8` (0/1)
+ * - `item_count`: `u32`
+ * - Per item:
+ *   - `kbid`: `String`
+ *   - `heading`: `Option<String>`
+ *   - `section_type`: `String`
+ *   - `docids`: `u32` count + `String[]`
+ *   - `score`: `f32`
+ *   - `confidence`: `f32`
+ *   - `snippet`: `String`
+ *   - `matched_terms`: `u32` count + `String[]`
+ *   - `matched_fields`: `u32` count + `String[]`
+ *   - `created_at`: `String`
+ */
 export declare function decodePagedSearchResult(bytes: Uint8Array): PagedSearchResult;

package/dist/src/shared/wasm-codec/functions/decode-section-records.function.d.ts

@@ -36,6 +36,33 @@ export interface SectionRecord {
     codeTokenCount: number;
     /** Application-level type name assigned to this section. */
     typeName: string;
+    /**
+     * Stable logical identity derived from source path and heading.
+     * `null` for stdin input or sections without a source path.
+     */
+    sourceKey: string | null;
+    /**
+     * Absolute path of the source file that was learned.
+     * `null` for stdin input or programmatic API calls.
+     */
+    sourcePath: string | null;
+    /**
+     * ISO 8601 modified time of the source file at learn time.
+     * `null` when no source file exists.
+     */
+    sourceMtime: string | null;
+    /**
+     * ISO 8601 timestamp of the last supersession.
+     * `null` on first creation.
+     */
+    updatedAt: string | null;
+    /** User-supplied tags for scoping and filtering. */
+    tags: string[];
+    /**
+     * The kbid of the section this one replaced via supersession.
+     * `null` on first creation or non-superseding additions.
+     */
+    supersedes: string | null;
 }
 /**
  * Decodes a list of `SectionRecord` values from WASM binary output.
@@ -44,6 +71,12 @@ export interface SectionRecord {
  * Each record is decoded in field order as produced by the Rust
  * `SectionRecord::encode` implementation.
  *
+ * Trailing fields (`sourceKey`, `sourcePath`, `sourceMtime`,
+ * `updatedAt`, `tags`, `supersedes`) were added after the initial
+ * format. When decoding legacy bytes that stop after `typeName`,
+ * those fields default to `null` / `[]`. This matches the Rust
+ * decoder's backward-compatibility guards.
+ *
  * @param bytes - raw bytes returned by a WASM section-list export
  * @returns decoded array of section records, empty when count is zero
  */

package/dist/src/shared/wasm-codec/functions/encode-add-section-params.function.d.ts

@@ -1,10 +1,62 @@
+/**
+ * Parameters for adding a new section to the knowledge base.
+ *
+ * Maps to the Rust `AddSectionParams` struct encoded for the
+ * `worker_add_section` WASM export.
+ */
 export interface AddSectionInput {
+    /** Semantic content category. */
     sectionType: 'text' | 'code' | 'image';
+    /** MIME type; required for `code` and `image` section types. */
     mimeType?: string;
+    /** Raw section content. */
     content: string;
+    /** Optional section heading. */
     title?: string | null;
+    /** Optional description summary. */
     description?: string | null;
+    /** Optional document identifier to attach the section to. */
     docid?: string | null;
+    /**
+     * Application-level type name for the section (e.g. `'skill'`,
+     * `'fact'`). `null` means no custom type.
+     */
     typeName?: string | null;
+    /**
+     * Absolute path of the source file being learned. `undefined`
+     * means stdin input or programmatic API call.
+     */
+    sourcePath?: string;
+    /**
+     * ISO 8601 modified time of the source file. `undefined` means
+     * no source file exists.
+     */
+    sourceMtime?: string;
+    /**
+     * User-supplied tags for scoping and filtering. Defaults to
+     * an empty list when not provided.
+     */
+    tags?: string[];
+    /**
+     * When `true`, supersede any existing section with the same
+     * source key. Defaults to `false`.
+     */
+    replace?: boolean;
 }
+/**
+ * Encodes `AddSectionInput` as the binary format expected by the
+ * `worker_add_section` WASM export.
+ *
+ * Wire format (little-endian):
+ * - `SectionType` tag byte (+ optional MIME string for code/image)
+ * - `content`: `u32` length + UTF-8 bytes
+ * - `title`: `u8` flag + optional `String`
+ * - `description`: `u8` flag + optional `String`
+ * - `docid`: `u8` flag + optional `String`
+ * - `typeName`: `u8` flag + optional `String`
+ * - `sourcePath`: `u8` flag + optional `String`
+ * - `sourceMtime`: `u8` flag + optional `String`
+ * - `tags`: `u32` count + each `String`
+ * - `replace`: `u8` (0 or 1)
+ */
 export declare function encodeAddSectionParams(params: AddSectionInput): Uint8Array;

package/dist/src/shared/wasm-codec/index.d.ts

@@ -23,8 +23,10 @@ export { decodeKeyValueText } from './functions/decode-key-value-text.function.t
 export { decodeRemoveFlag } from './functions/decode-remove-flag.function.ts';
 export { encodeRecallParams } from './functions/encode-recall-params.function.ts';
 export { decodeRecallResult } from './functions/decode-recall-result.function.ts';
+export { decodeAddSectionResult } from './functions/decode-add-section-result.function.ts';
 export type { DecodeResult } from './functions/decode-string.function.ts';
 export type { AddSectionInput } from './functions/encode-add-section-params.function.ts';
+export type { AddSectionResult, NearDuplicate, } from './functions/decode-add-section-result.function.ts';
 export type { SectionMatch, PagedSearchResult, } from './functions/decode-scored-results.function.ts';
 export type { SectionRecord } from './functions/decode-section-records.function.ts';
 export type { DocumentManifest, DocumentSection, } from './functions/decode-document-manifest.function.ts';

package/dist/src/shared/worker-client/classes/worker-client.class.d.ts

@@ -13,6 +13,7 @@ import type { VersionStatus } from '../typings/version-status.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 { RecallParams, RecallResult } from '../typings/recall-result.model.ts';
+import type { ExportResult } from '../typings/export-result.model.ts';
 /**
  * IPC client that communicates with the worker daemon over a Unix
  * domain socket (or Windows named pipe) using JSON-RPC 2.0 with
@@ -221,6 +222,21 @@ export declare class WorkerClient {
      * @returns all document manifests with a matching type name
      */
     listDocumentsByType(docType: string): Promise<DocumentManifest[]>;
+    /**
+     * Exports the database to a target directory on disk.
+     *
+     * Copies section files, document manifests, and `catalog.toml`
+     * to `params.path`. Index files are not exported because they
+     * are derivable from the section and document data.
+     *
+     * @param params - optional export parameters
+     * @param params.path - target directory path; defaults to
+     *   `./kbdb-export/` when not provided
+     * @returns export report with the resolved path and file counts
+     */
+    export(params?: {
+        path?: string;
+    }): Promise<ExportResult>;
     /**
      * Sends a JSON-RPC 2.0 request and awaits the response.
      *

package/dist/src/shared/worker-client/index.d.ts

@@ -12,7 +12,7 @@ export type { Section, AddSectionParams, } from './typings/section.model.ts';
 export type { StatusResult } from './typings/status-result.model.ts';
 export type { WorkerClientError } from './typings/worker-client-error.interface.ts';
 export type { DaemonInfo } from './typings/daemon-info.model.ts';
-export type { AddSectionResult } from './typings/add-section-result.model.ts';
+export type { AddSectionResult, NearDuplicateEntry, } from './typings/add-section-result.model.ts';
 export type { RemoveSectionResult } from './typings/remove-section-result.model.ts';
 export type { ContentResult } from './typings/content-result.model.ts';
 export type { IntegrityCheckResult, IntegrityError, } from './typings/integrity-check-result.model.ts';