@dikolab/kbdb 0.2.2 → 0.3.1

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

@@ -0,0 +1,8 @@
+import type { ExportEntry } from '../typings/export-entry.interface.ts';
+/**
+ * Serializes an export entry to a flat file format.
+ *
+ * Format: TOML frontmatter delimited by `+++` lines,
+ * followed by the body content.
+ */
+export declare function serializeExportEntry(entry: ExportEntry): string;

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

@@ -0,0 +1,9 @@
+export { resolveConflict } from './functions/resolve-conflict.function.ts';
+export { buildImportReport } from './functions/build-import-report.function.ts';
+export { serializeExportEntry } from './functions/serialize-export-entry.function.ts';
+export { parseExportEntry } from './functions/parse-export-entry.function.ts';
+export type { ExportEntry } from './typings/export-entry.interface.ts';
+export type { ExportOptions } from './typings/export-options.interface.ts';
+export type { ImportOptions } from './typings/import-options.interface.ts';
+export type { ImportReport } from './typings/import-report.interface.ts';
+export type { ConflictResolution } from './typings/conflict-resolution.type.ts';

package/dist/src/shared/sync/typings/conflict-resolution.type.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Conflict resolution strategy.
+ *
+ * - 'skip': same kbid -> skip
+ * - 'supersede': same source_key -> replace if newer
+ * - 'add': no match -> add
+ */
+export type ConflictResolution = 'skip' | 'supersede' | 'add';

package/dist/src/shared/sync/typings/export-entry.interface.d.ts

@@ -0,0 +1,13 @@
+/** A single entry in an export manifest. */
+export interface ExportEntry {
+    /** Section kbid. */
+    readonly kbid: string;
+    /** Source key. */
+    readonly sourceKey: string;
+    /** Section heading. */
+    readonly heading: string;
+    /** Content body. */
+    readonly body: string;
+    /** Created timestamp (ISO). */
+    readonly createdAt: string;
+}

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

@@ -0,0 +1,9 @@
+/** Options for export operation. */
+export interface ExportOptions {
+    /** Export format. */
+    readonly format: 'git' | 'archive';
+    /** Output directory or file path. */
+    readonly outputPath: string;
+    /** Exclude vector indexes. */
+    readonly excludeVectors: boolean;
+}

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

@@ -0,0 +1,7 @@
+/** Options for import operation. */
+export interface ImportOptions {
+    /** Source path (exported directory or archive). */
+    readonly fromPath: string;
+    /** Dry-run mode. */
+    readonly dryRun: boolean;
+}

package/dist/src/shared/sync/typings/import-report.interface.d.ts

@@ -0,0 +1,15 @@
+/** Report of an import operation. */
+export interface ImportReport {
+    /** Sections added. */
+    readonly sectionsAdded: number;
+    /** Sections skipped (same kbid). */
+    readonly sectionsSkipped: number;
+    /** Sections superseded (same source_key, newer). */
+    readonly sectionsSuperseded: number;
+    /** Documents added. */
+    readonly documentsAdded: number;
+    /** Documents skipped. */
+    readonly documentsSkipped: number;
+    /** Whether rebuild is required. */
+    readonly rebuildRequired: boolean;
+}

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-one-recall-result.function.d.ts

@@ -0,0 +1,14 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { RecallResult } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Decodes a single `RecallResult` record from WASM binary output.
+ *
+ * Wire format: kbid, heading, section_type, content, docid list,
+ * document list, back_references list, siblings list,
+ * references list.
+ *
+ * @param bytes - raw binary buffer
+ * @param startOffset - byte position of the record start
+ * @returns decoded result and number of bytes consumed
+ */
+export declare function decodeOneRecallResult(bytes: Uint8Array, startOffset: number): DecodeResult<RecallResult>;

package/dist/src/shared/wasm-codec/functions/decode-option-string.function.d.ts

@@ -0,0 +1,12 @@
+import type { DecodeResult } from './decode-string.function.ts';
+/**
+ * Decodes an `Option<String>` from WASM binary output.
+ *
+ * Wire format: `u8` tag byte (`0x00` = `None`, any other value =
+ * `Some`) followed by a length-prefixed UTF-8 string when present.
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the tag byte
+ * @returns decoded nullable string and number of bytes consumed
+ */
+export declare function decodeOptionString(bytes: Uint8Array, offset: number): DecodeResult<string | null>;

package/dist/src/shared/wasm-codec/functions/decode-recall-document.function.d.ts

@@ -0,0 +1,14 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { RecallDocument } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Decodes a single `RecallDocument` record from WASM binary output.
+ *
+ * Wire format: docid (String), title (String), section_count (u32),
+ * then each section as kbid (String), heading (Option<String>),
+ * section_type (String).
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the record start
+ * @returns decoded document and number of bytes consumed
+ */
+export declare function decodeRecallDocument(bytes: Uint8Array, offset: number): DecodeResult<RecallDocument>;

package/dist/src/shared/wasm-codec/functions/decode-recall-reference.function.d.ts

@@ -0,0 +1,14 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { RecallReference } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Decodes a single `RecallReference` record from WASM binary output.
+ *
+ * Wire format: kbid (String), heading (Option<String>),
+ * section_type (String), marker_type (String),
+ * context_snippet (String), direction (String).
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the record start
+ * @returns decoded reference and number of bytes consumed
+ */
+export declare function decodeRecallReference(bytes: Uint8Array, offset: number): DecodeResult<RecallReference>;

package/dist/src/shared/wasm-codec/functions/decode-recall-sibling.function.d.ts

@@ -0,0 +1,13 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { RecallSibling } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Decodes a single `RecallSibling` record from WASM binary output.
+ *
+ * Wire format: kbid (String), heading (Option<String>),
+ * section_type (String), content (String).
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the record start
+ * @returns decoded sibling and number of bytes consumed
+ */
+export declare function decodeRecallSibling(bytes: Uint8Array, offset: number): DecodeResult<RecallSibling>;

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-match.function.d.ts

@@ -0,0 +1,15 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { SectionMatch } from '../typings/section-match.model.ts';
+/**
+ * Decodes a single `SectionMatch` item from WASM binary output.
+ *
+ * Wire format per item: kbid, heading (Option<String>),
+ * section_type, docids (u32 count + String[]), score (f32),
+ * confidence (f32), snippet, matched_terms (u32 + String[]),
+ * matched_fields (u32 + String[]), created_at.
+ *
+ * @param bytes - raw binary buffer
+ * @param startOffset - byte position of the item start
+ * @returns decoded match and number of bytes consumed
+ */
+export declare function decodeSectionMatch(bytes: Uint8Array, startOffset: number): DecodeResult<SectionMatch>;

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

@@ -0,0 +1,14 @@
+import type { SectionRecordTrailing } from '../typings/section-record-trailing.model.ts';
+export type { SectionRecordTrailing };
+/**
+ * Decodes the trailing backward-compatible fields of a
+ * `SectionRecord` from WASM binary output.
+ *
+ * Fields present only in newer binary output; each is guarded by a
+ * length check. Missing fields default to `null` or `[]`.
+ *
+ * @param bytes - raw bytes from a WASM section-list export
+ * @param startOffset - byte position after the `typeName` field
+ * @returns decoded trailing fields and bytes consumed
+ */
+export declare function decodeSectionRecordTrailing(bytes: Uint8Array, startOffset: number): SectionRecordTrailing;

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

@@ -0,0 +1,14 @@
+import type { DecodeResult } from './decode-string.function.ts';
+import type { SectionRecord } from '../typings/section-record.model.ts';
+/**
+ * Decodes a single `SectionRecord` from WASM binary output.
+ *
+ * Reads all section fields in the order produced by the Rust
+ * `SectionRecord::encode` implementation. Trailing fields added
+ * after `typeName` default to `null` / `[]` when absent.
+ *
+ * @param bytes - raw bytes returned by a WASM section-list export
+ * @param startOffset - byte position of the record start
+ * @returns decoded record and number of bytes consumed
+ */
+export declare function decodeSectionRecord(bytes: Uint8Array, startOffset: number): DecodeResult<SectionRecord>;

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/decode-section-type.function.d.ts

@@ -0,0 +1,13 @@
+import type { SectionTypeResult } from '../typings/section-type-result.model.ts';
+export type { SectionTypeResult };
+/**
+ * Decodes a section type discriminant from WASM binary output.
+ *
+ * Wire format: `u8` tag (`0x00` = text, `0x01` = code,
+ * `0x02` = image), followed by a MIME string for code/image.
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the tag byte
+ * @returns section type, optional MIME type, and bytes consumed
+ */
+export declare function decodeSectionType(bytes: Uint8Array, offset: number): SectionTypeResult;

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

@@ -0,0 +1,17 @@
+import type { ItemDecoder } from '../typings/item-decoder.type.ts';
+export type { ItemDecoder };
+/**
+ * Decodes a length-prefixed list from WASM binary output.
+ *
+ * Wire format: u32 item count, then that many items decoded
+ * sequentially by `decode`.
+ *
+ * @param bytes - raw binary buffer
+ * @param offset - byte position of the u32 count
+ * @param decode - decoder function for each item
+ * @returns decoded item array and total bytes consumed
+ */
+export declare function decodeWasmList<T>(bytes: Uint8Array, offset: number, decode: ItemDecoder<T>): {
+    items: T[];
+    bytesRead: number;
+};

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/wasm-codec/typings/add-section-input.model.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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;
+}

package/dist/src/shared/wasm-codec/typings/add-section-result.model.d.ts

@@ -0,0 +1,27 @@
+import type { NearDuplicate } from './near-duplicate.model.ts';
+/**
+ * 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[];
+}

package/dist/src/shared/wasm-codec/typings/document-manifest.model.d.ts

@@ -0,0 +1,19 @@
+import type { DocumentSection } from './document-section.model.ts';
+/**
+ * A document manifest decoded from WASM binary output.
+ *
+ * Represents a grouped document record with its ordered list of
+ * section references as returned by `worker_retrieve_doc`.
+ */
+export interface DocumentManifest {
+    /** Unique document identifier. */
+    docid: string;
+    /** Human-readable document title. */
+    title: string;
+    /** Document creation timestamp as a Unix epoch value. */
+    createdAt: bigint;
+    /** Application-level type name assigned to this document. */
+    docType: string;
+    /** Ordered list of section references belonging to the document. */
+    sections: DocumentSection[];
+}

package/dist/src/shared/wasm-codec/typings/document-section.model.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A single section reference within a document manifest.
+ *
+ * Associates a knowledge-base identifier with the section's
+ * ordinal position in the document.
+ */
+export interface DocumentSection {
+    /** Knowledge-base identifier of the referenced section. */
+    kbid: string;
+    /** Zero-based position of this section within its document. */
+    position: number;
+}

package/dist/src/shared/wasm-codec/typings/item-decoder.type.d.ts

@@ -0,0 +1,6 @@
+import type { DecodeResult } from '../functions/decode-string.function.ts';
+/**
+ * A function that decodes one item from a binary buffer at the
+ * given byte offset, returning the decoded value and bytes consumed.
+ */
+export type ItemDecoder<T> = (bytes: Uint8Array, offset: number) => DecodeResult<T>;

package/dist/src/shared/wasm-codec/typings/near-duplicate.model.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A near-duplicate section identified during add-section indexing.
+ */
+export interface NearDuplicate {
+    /** Knowledge-base identifier of the near-duplicate section. */
+    readonly kbid: string;
+    /** Similarity score (0.0–1.0). */
+    readonly similarity: number;
+    /**
+     * Detection method that produced this match.
+     *
+     * Optional for backward compatibility with WASM-decoded results
+     * that do not carry method information.
+     */
+    readonly method?: 'jaccard' | 'cosine';
+}

package/dist/src/shared/wasm-codec/typings/paged-search-result.model.d.ts

@@ -0,0 +1,21 @@
+import type { SectionMatch } from './section-match.model.ts';
+/**
+ * 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;
+}