@dikolab/kbdb 0.3.0 → 0.3.2

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

@@ -0,0 +1,52 @@
+/**
+ * Minimal client interface required by `runLearn`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface LearnClient {
+    /**
+     * Ingests a content section into the knowledge base.
+     *
+     * @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;
+        content: string;
+        title?: string;
+        description?: string;
+        docid?: string;
+        tags?: string[];
+        replace?: boolean;
+        /**
+         * Absolute path to the source file. Required for supersession
+         * via source key when `replace` is `true`.
+         */
+        sourcePath?: string;
+    }): Promise<LearnAddSectionResult>;
+}
+/** Enriched add-section result returned by the daemon. */
+export interface LearnAddSectionResult {
+    /** 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;
+    }[];
+}

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

@@ -0,0 +1,5 @@
+/** Injectable I/O for `runLearn` without real stdin. */
+export interface LearnIO {
+    /** Reads all stdin content and resolves with the full string. */
+    readStdin: () => Promise<string>;
+}

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

@@ -0,0 +1,71 @@
+/**
+ * Minimal client interface required by `runSearch`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface SearchClient {
+    /**
+     * Searches the knowledge base and returns paginated results.
+     *
+     * @param params - query, mode, limit, and offset
+     */
+    search(params: {
+        query: string;
+        mode?: string;
+        /** Search algorithm: `'lexical'`, `'vector'`, or `'hybrid'`. */
+        algo?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<SearchClientResponse>;
+}
+/** Raw paginated search response from the daemon. */
+export interface SearchClientResponse {
+    /** Result items for the current page. */
+    readonly items: readonly SearchClientItem[];
+    /** 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;
+}
+/** A single raw search result item returned by the daemon. */
+export interface SearchClientItem {
+    /** 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;
+}

package/dist/src/shared/embedding/classes/null-embedding-provider.class.d.ts

@@ -0,0 +1,20 @@
+import type { EmbeddingProvider } from '../typings/embedding-provider.interface.ts';
+/**
+ * No-op embedding provider used when embeddings are not configured.
+ *
+ * Satisfies the `EmbeddingProvider` contract without performing any
+ * computation. Use this as the default when no provider is selected
+ * in the config.
+ */
+export declare class NullEmbeddingProvider implements EmbeddingProvider {
+    /**
+     * Returns an empty `Float32Array` for each input text.
+     *
+     * @param texts - input strings (contents are ignored)
+     */
+    embed(texts: string[]): Promise<Float32Array[]>;
+    /** Always returns 0 -- no dimensions when disabled. */
+    dimensions(): number;
+    /** Always returns `'none'`. */
+    modelName(): string;
+}

package/dist/src/shared/embedding/constants/near-duplicate-thresholds.constant.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimum Jaccard coefficient to flag a section as a near-duplicate
+ * directly via the Jaccard pass.
+ */
+export declare const JACCARD_THRESHOLD = 0.85;
+/**
+ * Lower bound of the Jaccard pre-filter band that triggers the
+ * cosine-similarity pass.
+ */
+export declare const JACCARD_BAND_MIN = 0.4;
+/**
+ * Minimum cosine similarity to flag a section as a near-duplicate
+ * via the cosine pass.
+ */
+export declare const COSINE_THRESHOLD = 0.92;

package/dist/src/shared/embedding/functions/build-vector-index.function.d.ts

@@ -0,0 +1,14 @@
+import type { VectorIndexEntry } from '../typings/vector-index-entry.model.ts';
+/**
+ * Writes a binary `vectors.idx` file to the given directory.
+ *
+ * Header: 32 bytes (magic KBVX, version u32, dimensions u32, count
+ * u32, model-name length u32, 12 reserved bytes). Followed by the
+ * model name (UTF-8) then records (64-byte kbid + dims*4 floats).
+ *
+ * @param dirPath - directory where `vectors.idx` will be written
+ * @param modelName - name of the embedding model used
+ * @param dimensions - vector dimension count
+ * @param entries - kbid/vector pairs to index
+ */
+export declare function buildVectorIndex(dirPath: string, modelName: string, dimensions: number, entries: VectorIndexEntry[]): Promise<void>;

package/dist/src/shared/embedding/functions/cosine-similarity.function.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Computes cosine similarity between two vectors.
+ *
+ * Returns `dot(a, b) / (||a|| * ||b||)`. Returns `0` when either
+ * vector has zero magnitude to avoid division by zero.
+ *
+ * @param a - first embedding vector
+ * @param b - second embedding vector
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;

package/dist/src/shared/embedding/functions/detect-near-duplicates.function.d.ts

@@ -0,0 +1,18 @@
+import type { EmbeddingProvider } from '../typings/embedding-provider.interface.ts';
+import type { NearDuplicateCandidate } from '../typings/near-duplicate-candidate.model.ts';
+import type { NearDuplicateResult } from '../typings/near-duplicate-result.model.ts';
+/**
+ * Two-pass near-duplicate detection.
+ *
+ * Pass 1: Jaccard coefficient (always runs).
+ * Pass 2: Cosine similarity on embeddings (only when `provider` is
+ * available and the Jaccard score falls in the pre-filter band
+ * [0.40, 0.85)).
+ *
+ * @param candidate - the new section to test against existing ones
+ * @param existing - known sections to compare against
+ * @param provider - optional embedding provider; when absent or null,
+ *   the cosine pass is skipped entirely
+ * @returns detected near-duplicates in the same order as `existing`
+ */
+export declare function detectNearDuplicates(candidate: NearDuplicateCandidate, existing: NearDuplicateCandidate[], provider?: EmbeddingProvider | null): NearDuplicateResult[];

package/dist/src/shared/embedding/functions/jaccard-coefficient.function.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Computes Jaccard coefficient between two token sets.
+ *
+ * `|A ∩ B| / |A ∪ B|`. Returns `0` if both sets are empty.
+ *
+ * @param a - first token set
+ * @param b - second token set
+ */
+export declare function jaccardCoefficient(a: ReadonlySet<string>, b: ReadonlySet<string>): number;

package/dist/src/shared/embedding/functions/read-vector-index-meta.function.d.ts

@@ -0,0 +1,10 @@
+import type { VectorIndexMeta } from '../typings/vector-index-meta.model.ts';
+/**
+ * Reads the 32-byte header from a `vectors.idx` file and returns
+ * the embedded `VectorIndexMeta`.
+ *
+ * @param filePath - absolute path to the `vectors.idx` file
+ * @throws {Error} if the file does not exist or the magic bytes do
+ *   not match the expected `KBVX` signature
+ */
+export declare function readVectorIndexMeta(filePath: string): VectorIndexMeta;

package/dist/src/shared/embedding/functions/rrf-fuse.function.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fuses lexical and vector rankings using Reciprocal Rank Fusion.
+ *
+ * For each kbid in either map the fused score is:
+ * `1/(k + lexicalRank) + 1/(k + vectorRank)`.
+ * When a kbid appears in only one map the missing rank contributes
+ * `0` (treated as infinite rank -- no contribution).
+ *
+ * @param lexicalRanks - map of kbid to 1-based lexical rank position
+ * @param vectorRanks - map of kbid to 1-based vector rank position
+ * @param k - RRF smoothing constant (default 60)
+ * @returns map of kbid to fused RRF score
+ */
+export declare function rrfFuse(lexicalRanks: Map<string, number>, vectorRanks: Map<string, number>, k?: number): Map<string, number>;

package/dist/src/shared/embedding/functions/search-vectors.function.d.ts

@@ -0,0 +1,14 @@
+import type { VectorSearchResult } from '../typings/vector-search-result.model.ts';
+/**
+ * Brute-force linear scan of a `vectors.idx` file.
+ *
+ * Reads every stored vector, computes cosine similarity against
+ * `queryVector`, then returns the top `topN` results sorted by
+ * score descending.
+ *
+ * @param filePath - absolute path to the `vectors.idx` file
+ * @param queryVector - embedding to search against
+ * @param topN - maximum number of results to return
+ * @returns results sorted by descending cosine similarity score
+ */
+export declare function searchVectors(filePath: string, queryVector: Float32Array, topN: number): VectorSearchResult[];

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

@@ -0,0 +1,16 @@
+export { NullEmbeddingProvider } from './classes/null-embedding-provider.class.ts';
+export { cosineSimilarity } from './functions/cosine-similarity.function.ts';
+export { rrfFuse } from './functions/rrf-fuse.function.ts';
+export { buildVectorIndex } from './functions/build-vector-index.function.ts';
+export { searchVectors } from './functions/search-vectors.function.ts';
+export { readVectorIndexMeta } from './functions/read-vector-index-meta.function.ts';
+export { jaccardCoefficient } from './functions/jaccard-coefficient.function.ts';
+export { detectNearDuplicates } from './functions/detect-near-duplicates.function.ts';
+export { JACCARD_THRESHOLD, JACCARD_BAND_MIN, COSINE_THRESHOLD, } from './constants/near-duplicate-thresholds.constant.ts';
+export type { EmbeddingProvider } from './typings/embedding-provider.interface.ts';
+export type { EmbeddingConfig } from './typings/embedding-config.interface.ts';
+export type { VectorSearchResult } from './typings/vector-search-result.model.ts';
+export type { VectorIndexMeta } from './typings/vector-index-meta.model.ts';
+export type { VectorIndexEntry } from './typings/vector-index-entry.model.ts';
+export type { NearDuplicateCandidate } from './typings/near-duplicate-candidate.model.ts';
+export type { NearDuplicateResult } from './typings/near-duplicate-result.model.ts';

package/dist/src/shared/embedding/typings/embedding-config.interface.d.ts

@@ -0,0 +1,20 @@
+/** Configuration for the embedding provider. */
+export interface EmbeddingConfig {
+    /**
+     * Provider type.
+     *
+     * - `'none'` -- embeddings disabled (default)
+     * - `'onnx'` -- local ONNX Runtime model
+     * - `'api'` -- remote HTTP embedding API
+     */
+    readonly provider: 'none' | 'onnx' | 'api';
+    /** Model name or path (for onnx/api providers). */
+    readonly model?: string;
+    /** API endpoint URL (for api provider). */
+    readonly endpoint?: string;
+    /**
+     * Number of dimensions the model produces
+     * (required for api provider).
+     */
+    readonly dimensions?: number;
+}

package/dist/src/shared/embedding/typings/embedding-provider.interface.d.ts

@@ -0,0 +1,23 @@
+/** Pluggable embedding provider interface. */
+export interface EmbeddingProvider {
+    /**
+     * Compute embedding vectors for text inputs.
+     *
+     * @param texts - list of text strings to embed
+     * @returns a Float32Array embedding for each input text,
+     *   in the same order
+     */
+    embed(texts: string[]): Promise<Float32Array[]>;
+    /**
+     * Number of dimensions in the embedding vector.
+     *
+     * Returns 0 when embeddings are disabled.
+     */
+    dimensions(): number;
+    /**
+     * Name of the underlying model.
+     *
+     * Returns `'none'` when embeddings are disabled.
+     */
+    modelName(): string;
+}

package/dist/src/shared/embedding/typings/near-duplicate-candidate.model.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A document section candidate for near-duplicate detection.
+ *
+ * Carries the token set for Jaccard comparison and an optional
+ * embedding vector for cosine-similarity comparison.
+ */
+export interface NearDuplicateCandidate {
+    /** Knowledge-base identifier for this section. */
+    readonly kbid: string;
+    /**
+     * Set of lowercased word tokens extracted from the section body.
+     *
+     * Used by the Jaccard coefficient pass.
+     */
+    readonly tokens: Set<string>;
+    /**
+     * Optional embedding vector for this section.
+     *
+     * When present and a provider is available, used as the
+     * cosine-similarity pass input.
+     */
+    readonly embedding?: Float32Array;
+}

package/dist/src/shared/embedding/typings/near-duplicate-result.model.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A near-duplicate detected by the two-pass detection algorithm.
+ *
+ * Reports which existing section matched the candidate and which
+ * detection method produced the match.
+ */
+export interface NearDuplicateResult {
+    /** Knowledge-base identifier of the matched existing section. */
+    readonly kbid: string;
+    /**
+     * Similarity score of the match (0.0–1.0).
+     *
+     * Jaccard matches use the Jaccard coefficient; cosine matches use
+     * cosine similarity.
+     */
+    readonly score: number;
+    /**
+     * Detection method that produced this match.
+     *
+     * - `'jaccard'`: Jaccard coefficient >= 0.85
+     * - `'cosine'`: cosine similarity >= 0.92 with Jaccard 0.40–0.84
+     */
+    readonly method: 'jaccard' | 'cosine';
+}

package/dist/src/shared/embedding/typings/vector-index-entry.model.d.ts

@@ -0,0 +1,12 @@
+/** A single record written into the vector index file. */
+export interface VectorIndexEntry {
+    /**
+     * Knowledge-base identifier for this section.
+     *
+     * Stored as a fixed 64-byte UTF-8 field in the index file;
+     * truncated or zero-padded as needed.
+     */
+    readonly kbid: string;
+    /** Embedding vector for this section. */
+    readonly vector: Float32Array;
+}

package/dist/src/shared/embedding/typings/vector-index-meta.model.d.ts

@@ -0,0 +1,11 @@
+/** Metadata for a vector index file. */
+export interface VectorIndexMeta {
+    /** Name of the embedding model used. */
+    readonly modelName: string;
+    /** Embedding vector dimensions. */
+    readonly dimensions: number;
+    /** Number of vectors stored. */
+    readonly count: number;
+    /** Schema version. */
+    readonly version: number;
+}

package/dist/src/shared/embedding/typings/vector-search-result.model.d.ts

@@ -0,0 +1,7 @@
+/** Result from a vector similarity search. */
+export interface VectorSearchResult {
+    /** Knowledge base ID of the matched section. */
+    readonly kbid: string;
+    /** Cosine similarity score (0.0 to 1.0). */
+    readonly score: number;
+}

package/dist/src/shared/mcp/constants/tool-agent-create.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `agent-create` operation. */
+export declare const TOOL_AGENT_CREATE: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-agent-delete.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `agent-delete` operation. */
+export declare const TOOL_AGENT_DELETE: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-agent-get.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `agent-get` operation. */
+export declare const TOOL_AGENT_GET: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-agent-list.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `agent-list` operation. */
+export declare const TOOL_AGENT_LIST: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-auto-capture-review.constant.d.ts

@@ -0,0 +1,8 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/**
+ * MCP tool definition for the `auto-capture-review` operation.
+ *
+ * Allows agents to list, approve, or reject pending
+ * auto-captured knowledge entries before they are persisted.
+ */
+export declare const TOOL_AUTO_CAPTURE_REVIEW: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-check.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `check` operation. */
+export declare const TOOL_CHECK: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-content.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `content` operation. */
+export declare const TOOL_CONTENT: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-export.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `export` operation. */
+export declare const TOOL_EXPORT: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-gc.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `gc` operation. */
+export declare const TOOL_GC: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-learn.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `learn` operation. */
+export declare const TOOL_LEARN: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-rebuild.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `rebuild` operation. */
+export declare const TOOL_REBUILD: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-recall.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `recall` operation. */
+export declare const TOOL_RECALL: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-retrieve.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `retrieve` operation. */
+export declare const TOOL_RETRIEVE: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-search.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `search` operation. */
+export declare const TOOL_SEARCH: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-skill-delete.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `skill-delete` operation. */
+export declare const TOOL_SKILL_DELETE: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-skill-get.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `skill-get` operation. */
+export declare const TOOL_SKILL_GET: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-skill-learn.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `skill-learn` operation. */
+export declare const TOOL_SKILL_LEARN: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-skill-list.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `skill-list` operation. */
+export declare const TOOL_SKILL_LIST: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-status.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `status` operation. */
+export declare const TOOL_STATUS: McpToolDefinition;

package/dist/src/shared/mcp/constants/tool-unlearn.constant.d.ts

@@ -0,0 +1,3 @@
+import type { McpToolDefinition } from '../typings/mcp-types.interface.ts';
+/** MCP tool definition for the `unlearn` operation. */
+export declare const TOOL_UNLEARN: McpToolDefinition;

package/dist/src/shared/mcp/functions/as-boolean-or-undefined.function.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Narrows an `unknown` value to a boolean, returning `undefined`
+ * when the value is not a boolean.
+ *
+ * @param value - the value to narrow
+ */
+export declare function asBooleanOrUndefined(value: unknown): boolean | undefined;

package/dist/src/shared/mcp/functions/as-string-array-or-undefined.function.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Narrows an `unknown` value to a `string[]`, returning `undefined`
+ * when the value is not an array of strings.
+ *
+ * @param value - the value to narrow
+ */
+export declare function asStringArrayOrUndefined(value: unknown): string[] | undefined;

package/dist/src/shared/mcp/functions/as-string-array.function.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Narrows an `unknown` value to a `string[]`, returning an empty
+ * array when the value is not an array of strings.
+ *
+ * @param value - the value to narrow
+ */
+export declare function asStringArray(value: unknown): string[];

package/dist/src/shared/mcp/functions/as-string.function.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Narrows an `unknown` value to a string, returning the fallback
+ * when the value is not already a string.
+ *
+ * @param value - the value to narrow
+ * @param fallback - returned when `value` is not a string
+ */
+export declare function asString(value: unknown, fallback: string): string;

package/dist/src/shared/mcp/functions/build-skills-text.function.d.ts

@@ -0,0 +1,18 @@
+/** Minimal section shape for building the skills listing text. */
+export interface SkillSection {
+    /** Knowledge-base identifier of the section. */
+    readonly kbid: string;
+    /** Raw JSON content of the skill section. */
+    readonly content: string;
+}
+/**
+ * Builds a human-readable skills listing from an array of skill
+ * section records.
+ *
+ * Sections whose JSON is not parseable or whose `name` field is
+ * absent are silently omitted. Returns `null` when no valid skills
+ * remain after filtering.
+ *
+ * @param skillSections - array of section records to summarise
+ */
+export declare function buildSkillsText(skillSections: SkillSection[]): string | null;

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

@@ -0,0 +1,14 @@
+import type { McpWorkerClient } from '../typings/mcp-client.interface.ts';
+import type { McpPromptMessage } from '../typings/prompt-types.interface.ts';
+/**
+ * Handles an MCP `prompts/get` request for an agent prompt.
+ *
+ * Reads the agent document, extracts its persona from the metadata
+ * section, then reads all skill sections and composes the response.
+ * Returns an assistant message with the persona and, when skills
+ * exist, a user message listing them.
+ *
+ * @param name - prompt name with `agent:` prefix
+ * @param client - worker client used to access the knowledge base
+ */
+export declare function handleAgentPrompt(name: string, client: McpWorkerClient): Promise<McpPromptMessage[]>;

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

@@ -0,0 +1,14 @@
+import type { McpWorkerClient } from '../typings/mcp-client.interface.ts';
+import type { McpRequest, McpResponse } from '../typings/mcp-types.interface.ts';
+import type { McpServerState } from '../typings/mcp-server-state.interface.ts';
+/**
+ * Routes an MCP JSON-RPC request to the appropriate handler and
+ * returns the JSON-RPC response. Mutates `state` for methods that
+ * update server-side configuration (logging level, subscriptions,
+ * capabilities).
+ *
+ * @param request - the parsed MCP request
+ * @param client - worker client for knowledge-base operations
+ * @param state - mutable server state shared with `McpServer`
+ */
+export declare function handleMcpRequest(request: McpRequest, client: McpWorkerClient, state: McpServerState): Promise<McpResponse>;

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

@@ -10,9 +10,10 @@ import type { McpPromptMessage } from '../typings/prompt-types.interface.ts';
  * substitutes `{{argName}}` placeholders in the body, and returns a
  * single user message.
  *
- * For agent prompts: reads the agent document via `retrieveDocument`,
- * builds an assistant message from the persona section, and (when
- * skills exist) a user message listing their names and descriptions.
+ * For agent prompts: looks up the agent by title via
+ * `listDocumentsByType('agent')`, builds an assistant message from
+ * the persona section, and (when skills exist) a user message
+ * listing their names and descriptions.
  *
  * @param name - prompt name from the MCP request
  * @param promptArgs - argument key-value map from the MCP request