@dikolab/kbdb 0.1.6 → 0.2.1

package/dist/src/shared/mcp/functions/handle-recall.function.d.ts

@@ -0,0 +1,29 @@
+import type { McpWorkerClient } from '../typings/mcp-client.interface.ts';
+/** Shape of a content item in an MCP tool call response. */
+interface ToolContent {
+    /** Content type identifier, typically `'text'`. */
+    readonly type: string;
+    /** The text payload. */
+    readonly text: string;
+}
+/** Result returned by a tool call handler. */
+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;
+}
+/**
+ * Handles the MCP `recall` tool call.
+ *
+ * Retrieves full content and context for one or more knowledge-base
+ * sections by identifier. At least one of `kbid` or `kbids` must be
+ * present in `args`; omitting both returns an error result.
+ *
+ * @param client - the worker client used to execute the operation
+ * @param args - tool arguments from the MCP request
+ * @returns content with JSON-stringified recall result, or an error
+ *   content item when required arguments are missing
+ */
+export declare function handleRecall(client: McpWorkerClient, args: Record<string, unknown>): Promise<ToolCallResult>;
+export {};

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

@@ -73,19 +73,23 @@ export interface McpWorkerClient {
         readonly mode?: string;
         /** Maximum number of results to return. */
         readonly limit?: number;
+        /** Number of results to skip for pagination. */
+        readonly offset?: number;
     }): Promise<{
-        /** Knowledge-base identifier of the matched section. */
-        kbid: string;
-        /** Relevance score assigned by the ranking engine. */
-        score: number;
-        /** Terms that matched within this section. */
-        readonly matches: readonly {
-            /** The matched term. */
-            readonly term: string;
-            /** Number of times the term appears in the section. */
-            readonly frequency: number;
+        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;
+    }>;
     /**
      * Adds a new section to the knowledge base.
      *
@@ -211,6 +215,21 @@ export interface McpWorkerClient {
      * @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>;
     /** Destroys the IPC socket and clears the connection state. */
     disconnect(): void;
 }

package/dist/src/shared/version/constants/version.constant.d.ts

@@ -1,2 +1,2 @@
 /** Current package version, kept in sync with package.json. */
-export declare const VERSION = "0.1.6";
+export declare const VERSION = "0.2.1";

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

@@ -0,0 +1,28 @@
+import type { RecallResult } from '../../worker-client/typings/recall-result.model.ts';
+/**
+ * Decodes recall result binary output from the `worker_recall` WASM
+ * export.
+ *
+ * Binary layout:
+ * - `u8 tag`: `0` = single result, `1` = batch
+ * - If tag=0: one RecallResult record
+ * - If tag=1: `u32 count` + `count` RecallResult records
+ *
+ * Each RecallResult:
+ * ```
+ * String kbid
+ * Option<String> heading  (0x00=null, 0x01 + String)
+ * String section_type
+ * String content
+ * u32 docids_count + String[] docids
+ * u32 documents_count + RecallDocument[]
+ * u32 back_references_count + RecallReference[]
+ * u32 siblings_count + RecallSibling[]
+ * u32 references_count + RecallReference[]
+ * ```
+ *
+ * @param bytes - raw binary output from the WASM export
+ * @returns a single `RecallResult` for tag=0, or `RecallResult[]`
+ *   for tag=1
+ */
+export declare function decodeRecallResult(bytes: Uint8Array): RecallResult | RecallResult[];

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

@@ -1,10 +1,17 @@
-export interface TermMatch {
-    term: string;
-    frequency: number;
-}
-export interface ScoredResult {
+export interface SectionMatch {
     kbid: string;
+    heading: string | null;
+    type: string;
+    docids: string[];
     score: number;
-    matches: TermMatch[];
+    snippet: string;
+    matched_terms: string[];
+}
+export interface PagedSearchResult {
+    items: SectionMatch[];
+    total: number;
+    offset: number;
+    limit: number;
+    has_more: boolean;
 }
-export declare function decodeScoredResults(bytes: Uint8Array): ScoredResult[];
+export declare function decodePagedSearchResult(bytes: Uint8Array): PagedSearchResult;

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

@@ -0,0 +1,21 @@
+/**
+ * Encodes recall parameters to the binary format expected by the
+ * `worker_recall` WASM export.
+ *
+ * Binary layout:
+ * - `u8 tag`: `0` = single kbid, `1` = batch
+ * - If tag=0: `u32 len + utf8` kbid
+ * - If tag=1: `u32 count` + (`u32 len + utf8`) per kbid
+ * - `u32 depth` (little-endian)
+ *
+ * When both `kbid` and `kbids` are provided, `kbids` takes precedence
+ * and `kbid` is appended to the batch.
+ *
+ * @param params - recall parameters; at least one of `kbid` or
+ *   `kbids` must be present
+ */
+export declare function encodeRecallParams(params: {
+    kbid?: string;
+    kbids?: readonly string[];
+    depth?: number;
+}): Uint8Array;

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

@@ -1 +1 @@
-export declare function encodeSearchParams(query: string, mode?: string, limit?: number): Uint8Array;
+export declare function encodeSearchParams(query: string, mode?: string, limit?: number, offset?: number): Uint8Array;

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

@@ -13,7 +13,7 @@ export { decodeString } from './functions/decode-string.function.ts';
 export { decodeU32 } from './functions/decode-u32.function.ts';
 export { decodeF32 } from './functions/decode-f32.function.ts';
 export { decodeU64 } from './functions/decode-u64.function.ts';
-export { decodeScoredResults } from './functions/decode-scored-results.function.ts';
+export { decodePagedSearchResult } from './functions/decode-scored-results.function.ts';
 export { decodeSectionRecords } from './functions/decode-section-records.function.ts';
 export { decodeSectionRecordList } from './functions/decode-section-record-list.function.ts';
 export { decodeDocumentManifest } from './functions/decode-document-manifest.function.ts';
@@ -21,9 +21,12 @@ export { decodeDocumentManifestList } from './functions/decode-document-manifest
 export { decodeComposeOutput } from './functions/decode-compose-output.function.ts';
 export { decodeKeyValueText } from './functions/decode-key-value-text.function.ts';
 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 type { DecodeResult } from './functions/decode-string.function.ts';
 export type { AddSectionInput } from './functions/encode-add-section-params.function.ts';
-export type { ScoredResult, TermMatch, } from './functions/decode-scored-results.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';
 export type { ComposeOutput } from './functions/decode-compose-output.function.ts';
+export type { RecallResult, RecallDocument, RecallSibling, RecallReference, } from '../worker-client/typings/recall-result.model.ts';

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

@@ -1,5 +1,5 @@
 import type { SearchParams } from '../typings/search-params.model.ts';
-import type { SearchResult } from '../typings/search-result.model.ts';
+import type { PagedSearchResult } from '../typings/search-result.model.ts';
 import type { AddSectionParams, Section } from '../typings/section.model.ts';
 import type { StatusResult } from '../typings/status-result.model.ts';
 import type { AddSectionResult } from '../typings/add-section-result.model.ts';
@@ -12,6 +12,7 @@ import type { MigrateResult } from '../typings/migrate-result.model.ts';
 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';
 /**
  * IPC client that communicates with the worker daemon over a Unix
  * domain socket (or Windows named pipe) using JSON-RPC 2.0 with
@@ -50,9 +51,18 @@ export declare class WorkerClient {
      * Searches the knowledge base.
      *
      * @param params - query parameters including the search string
-     * @returns ranked list of matching sections
+     * @returns paginated search results with metadata
      */
-    search(params: SearchParams): Promise<SearchResult[]>;
+    search(params: SearchParams): Promise<PagedSearchResult>;
+    /**
+     * 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 `RecallResult` when `kbid` is provided without
+     *   `kbids`, or a `RecallResult[]` when `kbids` is provided
+     */
+    recall(params: RecallParams): Promise<RecallResult | RecallResult[]>;
     /**
      * Adds a new section to the knowledge base.
      *

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

@@ -7,7 +7,7 @@ export { spawnDaemon } from './functions/spawn-daemon.function.ts';
 export { waitForDaemon } from './functions/wait-for-daemon.function.ts';
 export type { WorkerClientOptions } from './typings/worker-client-options.interface.ts';
 export type { SearchParams } from './typings/search-params.model.ts';
-export type { SearchResult } from './typings/search-result.model.ts';
+export type { SearchResult, PagedSearchResult, } from './typings/search-result.model.ts';
 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';
@@ -20,3 +20,4 @@ export type { GcResult } from './typings/gc-result.model.ts';
 export type { RebuildResult } from './typings/rebuild-result.model.ts';
 export type { MigrateResult } from './typings/migrate-result.model.ts';
 export type { VersionCompatibility, VersionStatus, } from './typings/version-status.model.ts';
+export type { RecallParams, RecallResult, RecallDocument, RecallSibling, RecallReference, } from './typings/recall-result.model.ts';

package/dist/src/shared/worker-client/typings/recall-result.model.d.ts

@@ -0,0 +1,94 @@
+/** Parameters for a recall operation. */
+export interface RecallParams {
+    /** Single section identifier to recall. */
+    readonly kbid?: string;
+    /** Batch of section identifiers to recall. */
+    readonly kbids?: readonly string[];
+    /**
+     * Context expansion depth (0-3).
+     *
+     * At depth 0 only the section itself is returned.
+     * Higher values include progressively more context:
+     * documents, siblings, and references.
+     */
+    readonly depth?: number;
+}
+/** A document record included at depth >= 1. */
+export interface RecallDocument {
+    /** Unique document identifier. */
+    readonly docid: string;
+    /** Human-readable document title. */
+    readonly title: string;
+    /** Ordered list of section summaries belonging to this document. */
+    readonly sections: readonly {
+        /** Knowledge-base identifier of the section. */
+        readonly kbid: string;
+        /** Section heading text, or `null` when absent. */
+        readonly heading: string | null;
+        /** Semantic type label for the section. */
+        readonly type: string;
+    }[];
+}
+/** A sibling section adjacent to the recalled section. */
+export interface RecallSibling {
+    /** Knowledge-base identifier of the sibling section. */
+    readonly kbid: string;
+    /** Sibling heading text, or `null` when absent. */
+    readonly heading: string | null;
+    /** Semantic type label for the sibling section. */
+    readonly type: string;
+    /** Full text content of the sibling section. */
+    readonly content: string;
+}
+/** A section that references or is referenced by the recalled section. */
+export interface RecallReference {
+    /** Knowledge-base identifier of the referencing/referenced section. */
+    readonly kbid: string;
+    /** Heading text of the referencing section, or `null` when absent. */
+    readonly heading: string | null;
+    /** Semantic type label of the referencing section. */
+    readonly type: string;
+    /** Application-level marker type (e.g. `'see_also'`, `'link'`). */
+    readonly marker_type: string;
+    /** Short excerpt from the referencing section surrounding the marker. */
+    readonly context_snippet: string;
+    /** Whether the reference is `'forward'` (outgoing) or `'back'` (incoming). */
+    readonly direction: 'forward' | 'back';
+}
+/** Full content and context for a recalled knowledge-base section. */
+export interface RecallResult {
+    /** Knowledge-base identifier of the recalled section. */
+    readonly kbid: string;
+    /** Section heading text, or `null` when absent. */
+    readonly heading: string | null;
+    /** Semantic type label for the section. */
+    readonly type: string;
+    /** Full text content of the section. */
+    readonly content: string;
+    /** Identifiers of documents that contain this section. */
+    readonly docids: readonly string[];
+    /**
+     * Full document records containing this section.
+     *
+     * Populated when `depth >= 1`.
+     */
+    readonly documents?: readonly RecallDocument[];
+    /**
+     * Sections that contain a marker pointing back to this section.
+     *
+     * Populated when `depth >= 1`.
+     */
+    readonly back_references?: readonly RecallReference[];
+    /**
+     * Sections adjacent to this section in the same document.
+     *
+     * Populated when `depth >= 1`.
+     */
+    readonly siblings?: readonly RecallSibling[];
+    /**
+     * Sections that this section points to via markers.
+     *
+     * Populated when `depth >= 1`.
+     */
+    readonly references?: readonly RecallReference[];
+}

package/dist/src/shared/worker-client/typings/search-params.model.d.ts

@@ -9,4 +9,6 @@ export interface SearchParams {
     readonly mode?: 'sections' | 'documents' | 'stats';
     /** Maximum number of results to return. */
     readonly limit?: number;
+    /** Number of results to skip (pagination offset). */
+    readonly offset?: number;
 }

package/dist/src/shared/worker-client/typings/search-result.model.d.ts

@@ -2,13 +2,29 @@
 export interface SearchResult {
     /** Knowledge-base identifier for 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 assigned by the ranking engine. */
     readonly score: number;
-    /** Terms that matched within this section. */
-    readonly matches: readonly {
-        /** The matched term. */
-        readonly term: string;
-        /** Number of times the term appears in the section. */
-        readonly frequency: number;
-    }[];
+    /** KWIC snippet (~150 chars around the best match). */
+    readonly snippet: string;
+    /** Query terms that matched within this section. */
+    readonly matched_terms: readonly string[];
+}
+/** Paginated search result envelope. */
+export interface PagedSearchResult {
+    /** Matching sections for the current page. */
+    readonly items: readonly SearchResult[];
+    /** Total number of matches across all pages. */
+    readonly total: number;
+    /** Number of results skipped (pagination offset). */
+    readonly offset: number;
+    /** Maximum results per page. */
+    readonly limit: number;
+    /** Whether more results exist beyond this page. */
+    readonly has_more: boolean;
 }

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

@@ -127,6 +127,7 @@ export declare class WorkerDaemon {
     private handleInvalidate;
     private handleListByType;
     private handleListDocsByType;
+    private handleRecall;
     private handleInvalidateAll;
     private handleDbStatus;
     private handleIntegrityCheck;

package/dist/src/worker.d.ts

@@ -1 +1,8 @@
+/**
+ * @module
+ *
+ * Worker daemon executable for kbdb. Runs as a detached
+ * background process that loads WASM modules and serves
+ * JSON-RPC 2.0 requests over local IPC.
+ */
 export {};

package/dist/wasm/fs-database/kbdb_fs_database.d.ts

@@ -48,6 +48,22 @@ declare namespace wasm_bindgen {
      */
     export function db_gc(_ptr: number, _len: number): number;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_back_refs(ptr: number, len: number): number;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_forward_refs(ptr: number, len: number): number;
+
     /**
      * Initialises the database context path.
      *
@@ -185,6 +201,8 @@ declare interface InitOutput {
     readonly db_check_integrity: (a: number, b: number) => number;
     readonly db_check_version: (a: number, b: number) => number;
     readonly db_gc: (a: number, b: number) => number;
+    readonly db_get_back_refs: (a: number, b: number) => number;
+    readonly db_get_forward_refs: (a: number, b: number) => number;
     readonly db_init: (a: number, b: number) => number;
     readonly db_init_catalog: (a: number, b: number) => number;
     readonly db_init_directory: (a: number, b: number) => number;

package/dist/wasm/fs-database/kbdb_fs_database.js

@@ -85,6 +85,36 @@ let wasm_bindgen = (function(exports) {
     }
     exports.db_gc = db_gc;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_back_refs(ptr, len) {
+        const ret = wasm.db_get_back_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_back_refs = db_get_back_refs;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_forward_refs(ptr, len) {
+        const ret = wasm.db_get_forward_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_forward_refs = db_get_forward_refs;
+
     /**
      * Initialises the database context path.
      *

package/dist/wasm/fs-database/kbdb_fs_database_bg.wasm.d.ts

@@ -8,6 +8,8 @@ export const db_add_to_index: (a: number, b: number) => number;
 export const db_check_integrity: (a: number, b: number) => number;
 export const db_check_version: (a: number, b: number) => number;
 export const db_gc: (a: number, b: number) => number;
+export const db_get_back_refs: (a: number, b: number) => number;
+export const db_get_forward_refs: (a: number, b: number) => number;
 export const db_init: (a: number, b: number) => number;
 export const db_init_catalog: (a: number, b: number) => number;
 export const db_init_directory: (a: number, b: number) => number;

package/dist/wasm/kb-worker/kbdb_worker.d.ts

@@ -48,6 +48,22 @@ declare namespace wasm_bindgen {
      */
     export function db_gc(_ptr: number, _len: number): number;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_back_refs(ptr: number, len: number): number;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     */
+    export function db_get_forward_refs(ptr: number, len: number): number;
+
     /**
      * Initialises the database context path.
      *
@@ -431,6 +447,20 @@ declare namespace wasm_bindgen {
      */
     export function worker_rebuild_indexes(): number;
 
+    /**
+     * Recalls section content with optional progressive context expansion.
+     *
+     * Input format (binary):
+     * - `u8 tag`: 0 = single kbid, 1 = batch kbids
+     * - If tag=0: `String kbid`
+     * - If tag=1: `u32 count` + `String[]` kbids
+     * - `u32 depth` (0-3, values above 3 are clamped to 3)
+     *
+     * On success writes the encoded result to the return slot and returns 0.
+     * On error writes an error message to the return slot and returns -1.
+     */
+    export function worker_recall(ptr: number, len: number): number;
+
     /**
      * Removes a document grouping. Returns 0 on success, -1 on error.
      */
@@ -457,6 +487,11 @@ declare namespace wasm_bindgen {
 
     /**
      * Performs a search, returning an async result token.
+     *
+     * Input format: `"query\nmode\nlimit\noffset"` (offset is optional,
+     * defaults to 0).
+     *
+     * The result is a `PagedSearchResult` envelope encoded as binary.
      */
     export function worker_search(ptr: number, len: number): number;
 
@@ -502,6 +537,7 @@ declare interface InitOutput {
     readonly worker_query: (a: number, b: number) => number;
     readonly worker_read_sections: (a: number, b: number) => number;
     readonly worker_rebuild_indexes: () => number;
+    readonly worker_recall: (a: number, b: number) => number;
     readonly worker_remove_grouping: (a: number, b: number) => number;
     readonly worker_remove_section: (a: number, b: number) => number;
     readonly worker_result_status: (a: number) => number;
@@ -530,6 +566,8 @@ declare interface InitOutput {
     readonly db_check_integrity: (a: number, b: number) => number;
     readonly db_check_version: (a: number, b: number) => number;
     readonly db_gc: (a: number, b: number) => number;
+    readonly db_get_back_refs: (a: number, b: number) => number;
+    readonly db_get_forward_refs: (a: number, b: number) => number;
     readonly db_init: (a: number, b: number) => number;
     readonly db_init_catalog: (a: number, b: number) => number;
     readonly db_init_directory: (a: number, b: number) => number;

package/dist/wasm/kb-worker/kbdb_worker.js

@@ -85,6 +85,36 @@ let wasm_bindgen = (function(exports) {
     }
     exports.db_gc = db_gc;
 
+    /**
+     * Returns back-references pointing to a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_back_refs(ptr, len) {
+        const ret = wasm.db_get_back_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_back_refs = db_get_back_refs;
+
+    /**
+     * Returns forward references for a section.
+     * `ptr`/`len` point to a UTF-8 kbid string.
+     * On success encodes `u32 count` followed by entries (peer_id, marker_type,
+     * context_snippet) into the return slot.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function db_get_forward_refs(ptr, len) {
+        const ret = wasm.db_get_forward_refs(ptr, len);
+        return ret;
+    }
+    exports.db_get_forward_refs = db_get_forward_refs;
+
     /**
      * Initialises the database context path.
      *
@@ -813,6 +843,27 @@ let wasm_bindgen = (function(exports) {
     }
     exports.worker_rebuild_indexes = worker_rebuild_indexes;
 
+    /**
+     * Recalls section content with optional progressive context expansion.
+     *
+     * Input format (binary):
+     * - `u8 tag`: 0 = single kbid, 1 = batch kbids
+     * - If tag=0: `String kbid`
+     * - If tag=1: `u32 count` + `String[]` kbids
+     * - `u32 depth` (0-3, values above 3 are clamped to 3)
+     *
+     * On success writes the encoded result to the return slot and returns 0.
+     * On error writes an error message to the return slot and returns -1.
+     * @param {number} ptr
+     * @param {number} len
+     * @returns {number}
+     */
+    function worker_recall(ptr, len) {
+        const ret = wasm.worker_recall(ptr, len);
+        return ret;
+    }
+    exports.worker_recall = worker_recall;
+
     /**
      * Removes a document grouping. Returns 0 on success, -1 on error.
      * @param {number} ptr
@@ -866,6 +917,11 @@ let wasm_bindgen = (function(exports) {
 
     /**
      * Performs a search, returning an async result token.
+     *
+     * Input format: `"query\nmode\nlimit\noffset"` (offset is optional,
+     * defaults to 0).
+     *
+     * The result is a `PagedSearchResult` envelope encoded as binary.
      * @param {number} ptr
      * @param {number} len
      * @returns {number}

package/dist/wasm/kb-worker/kbdb_worker_bg.wasm.d.ts

@@ -20,6 +20,7 @@ export const worker_list_docs_by_type: (a: number, b: number) => number;
 export const worker_query: (a: number, b: number) => number;
 export const worker_read_sections: (a: number, b: number) => number;
 export const worker_rebuild_indexes: () => number;
+export const worker_recall: (a: number, b: number) => number;
 export const worker_remove_grouping: (a: number, b: number) => number;
 export const worker_remove_section: (a: number, b: number) => number;
 export const worker_result_status: (a: number) => number;
@@ -48,6 +49,8 @@ export const db_add_to_index: (a: number, b: number) => number;
 export const db_check_integrity: (a: number, b: number) => number;
 export const db_check_version: (a: number, b: number) => number;
 export const db_gc: (a: number, b: number) => number;
+export const db_get_back_refs: (a: number, b: number) => number;
+export const db_get_forward_refs: (a: number, b: number) => number;
 export const db_init: (a: number, b: number) => number;
 export const db_init_catalog: (a: number, b: number) => number;
 export const db_init_directory: (a: number, b: number) => number;