@dikolab/kbdb 0.3.0 → 0.3.2

package/dist/src/shared/auto-capture/classes/auto-capture-controller.class.d.ts

@@ -0,0 +1,33 @@
+import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';
+import type { AutoCaptureState } from '../typings/auto-capture-state.interface.ts';
+import type { AutoCaptureTrigger } from '../typings/auto-capture-trigger.interface.ts';
+/**
+ * Controls the auto-capture lifecycle.
+ *
+ * Tracks tool call counts, evaluates trigger conditions, and
+ * advances session state when a capture fires. Reset state on
+ * disconnect or session end via `reset()`.
+ */
+export declare class AutoCaptureController {
+    private toolCallsSinceLastCapture;
+    private lastCaptureTimestamp;
+    private totalCapturesThisSession;
+    private readonly config;
+    /** @param config - the auto-capture configuration to use */
+    constructor(config: AutoCaptureConfig);
+    /** Record one tool call for trigger counting. */
+    recordToolCall(): void;
+    /**
+     * Evaluates the current state against the trigger criteria.
+     *
+     * When the trigger fires, advances the session counters so the
+     * next evaluation respects rate limiting and the session cap.
+     *
+     * @returns the trigger decision with a human-readable reason
+     */
+    evaluate(): AutoCaptureTrigger;
+    /** Reset all counters, e.g. on client disconnect. */
+    reset(): void;
+    /** Returns a snapshot of the current controller state. */
+    state(): AutoCaptureState;
+}

package/dist/src/shared/auto-capture/constants/auto-capture-defaults.constant.d.ts

@@ -0,0 +1,8 @@
+import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';
+/**
+ * Default configuration for the auto-capture feature.
+ *
+ * Auto-capture is disabled by default. Enable it in
+ * `worker.toml` under `[auto_capture]`.
+ */
+export declare const AUTO_CAPTURE_DEFAULTS: AutoCaptureConfig;

package/dist/src/shared/auto-capture/functions/build-capture-prompt.function.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds the MCP sampling prompt for knowledge extraction.
+ *
+ * Instructs the host LLM to identify durable factual knowledge
+ * from the recent conversation context, filter out ephemeral or
+ * task-specific information, and format the result for storage
+ * following memory-protocol criteria.
+ *
+ * @param recentContext - the conversation excerpt to analyse
+ */
+export declare function buildCapturePrompt(recentContext: string): string;

package/dist/src/shared/auto-capture/functions/evaluate-trigger.function.d.ts

@@ -0,0 +1,12 @@
+import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';
+import type { AutoCaptureState } from '../typings/auto-capture-state.interface.ts';
+import type { AutoCaptureTrigger } from '../typings/auto-capture-trigger.interface.ts';
+/**
+ * Evaluates whether auto-capture should fire given the current
+ * configuration and runtime state.
+ *
+ * Checks (in order): feature flag, session cap, rate limit,
+ * and tool-call count threshold. Returns the first failing
+ * condition as the reason.
+ */
+export declare function evaluateTrigger(config: AutoCaptureConfig, state: AutoCaptureState): AutoCaptureTrigger;

package/dist/src/shared/auto-capture/index.d.ts

@@ -0,0 +1,7 @@
+export { AutoCaptureController } from './classes/auto-capture-controller.class.ts';
+export { AUTO_CAPTURE_DEFAULTS } from './constants/auto-capture-defaults.constant.ts';
+export { evaluateTrigger } from './functions/evaluate-trigger.function.ts';
+export { buildCapturePrompt } from './functions/build-capture-prompt.function.ts';
+export type { AutoCaptureConfig } from './typings/auto-capture-config.interface.ts';
+export type { AutoCaptureTrigger } from './typings/auto-capture-trigger.interface.ts';
+export type { AutoCaptureState } from './typings/auto-capture-state.interface.ts';

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

@@ -0,0 +1,13 @@
+/** Configuration for auto-capture behavior. */
+export interface AutoCaptureConfig {
+    /** Enable or disable auto-capture. */
+    readonly enabled: boolean;
+    /** Trigger a capture after this many tool calls. */
+    readonly triggerAfterToolCalls: number;
+    /** Minimum time in milliseconds between captures. */
+    readonly minIntervalMs: number;
+    /** Maximum number of captures allowed per session. */
+    readonly maxCapturesPerSession: number;
+    /** Log without writing when true. */
+    readonly dryRun: boolean;
+}

package/dist/src/shared/auto-capture/typings/auto-capture-state.interface.d.ts

@@ -0,0 +1,13 @@
+/** Runtime state tracked by the auto-capture controller. */
+export interface AutoCaptureState {
+    /** Tool calls recorded since the last successful capture. */
+    readonly toolCallsSinceLastCapture: number;
+    /**
+     * Unix epoch milliseconds of the most recent capture.
+     *
+     * Zero when no capture has occurred this session.
+     */
+    readonly lastCaptureTimestamp: number;
+    /** Total captures completed during the current session. */
+    readonly totalCapturesThisSession: number;
+}

package/dist/src/shared/auto-capture/typings/auto-capture-trigger.interface.d.ts

@@ -0,0 +1,7 @@
+/** Result of evaluating whether auto-capture should fire. */
+export interface AutoCaptureTrigger {
+    /** Whether a capture should be triggered. */
+    readonly shouldCapture: boolean;
+    /** Human-readable reason for the decision. */
+    readonly reason: string;
+}

package/dist/src/shared/cli/constants/global-help.constant.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Top-level help text displayed when no command is given or when
+ * `--help` is passed without a command name.
+ *
+ * Lists all available commands grouped by category and describes
+ * global options.
+ */
+export declare const GLOBAL_HELP: string;

package/dist/src/shared/cli/constants/leaf-help.constant.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Help text strings keyed by top-level command name.
+ *
+ * Used by `generateHelp` to display per-command documentation
+ * when the user runs `kbdb <command> --help`.
+ */
+export declare const LEAF_HELP: Readonly<Record<string, string>>;

package/dist/src/shared/cli/constants/memory-protocol-body.constant.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Body text for the `memory-protocol` default skill.
+ *
+ * Teaches AI agents when and what to store in the knowledge base
+ * to keep it accurate and useful.
+ */
+export declare const MEMORY_PROTOCOL_BODY: string;

package/dist/src/shared/cli/constants/query-guidance-body.constant.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Body text for the `query-guidance` default skill.
+ *
+ * Teaches AI agents how to effectively search the knowledge base
+ * using lexical BM25F queries.
+ */
+export declare const QUERY_GUIDANCE_BODY: string;

package/dist/src/shared/cli/constants/subcommand-help.constant.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Detailed help texts keyed by `"group-subcommand"`.
+ *
+ * Used by `generateHelp` to display per-subcommand documentation
+ * when the user runs `kbdb <group> <subcommand> --help`. Falls
+ * back to group-level help when the key is absent.
+ */
+export declare const SUBCOMMAND_HELP: Readonly<Record<string, string>>;

package/dist/src/shared/cli/functions/collect-files.function.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolves a single target path to a flat list of supported files.
+ *
+ * When `target` is a file, returns it wrapped in an array if its
+ * extension is in `SUPPORTED_EXTENSIONS` and it is not a dotfile;
+ * otherwise returns `[]`. When `target` is a directory, recursively
+ * collects all matching files, skipping dot-entries at every level.
+ * Returns `[]` for non-existent or inaccessible paths.
+ *
+ * @param target - file or directory path to resolve
+ * @returns flat array of absolute or relative paths to supported files
+ */
+export declare function collectFiles(target: string): string[];

package/dist/src/shared/cli/functions/compute-section-kbid.function.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Computes a 26-character kbid for a section using the same algorithm
+ * as the Rust engine's `hash_section`.
+ *
+ * Algorithm:
+ * 1. Build input: `"section <mime> <byteLen>\0<content>"`
+ * 2. SHA-256 hash the input
+ * 3. Take the first 16 bytes
+ * 4. Base32 encode (RFC 4648, no padding), lowercased → 26 chars
+ *
+ * @param mimeType - MIME type string (e.g. `"text/markdown"`)
+ * @param content - UTF-8 section content string
+ * @returns 26-character lowercase base32 kbid
+ */
+export declare function computeSectionKbid(mimeType: string, content: string): string;

package/dist/src/shared/cli/functions/format-mcp-output.function.d.ts

@@ -0,0 +1,9 @@
+import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
+/**
+ * Formats a paged search result as a JSON string compatible
+ * with the MCP (Model Context Protocol) `text` content block.
+ *
+ * @param paged - paginated search results to serialise
+ * @returns MCP-compatible JSON string ready for stdout
+ */
+export declare function formatMcpOutput(paged: PagedSearchDisplay): string;

package/dist/src/shared/cli/functions/format-text-output.function.d.ts

@@ -0,0 +1,9 @@
+import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
+/**
+ * Formats a paged search result as a numbered human-readable
+ * text list with a paging footer and optional "more" hint.
+ *
+ * @param paged - paginated search results to render
+ * @returns formatted string ready for stdout
+ */
+export declare function formatTextOutput(paged: PagedSearchDisplay): string;

package/dist/src/shared/cli/functions/generate-group-help.function.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generates the level-2 help text for a group command.
+ *
+ * Lists all subcommands with their descriptions and
+ * includes a footer pointing to per-subcommand help.
+ *
+ * @param group - the group command name (e.g. `'db'`, `'skill'`)
+ * @param subs - ordered list of `[name, description]` pairs
+ * @returns formatted help string for the group command
+ */
+export declare function generateGroupHelp(group: string, subs: readonly (readonly [string, string])[]): string;

package/dist/src/shared/cli/functions/handle-data-command.function.d.ts

@@ -0,0 +1,16 @@
+import type { CliOptions } from '../typings/cli-options.interface.ts';
+import type { CommandResult } from '../typings/command-result.model.ts';
+import type { CliDeps } from '../typings/cli-deps.interface.ts';
+/**
+ * Handles data commands (search, learn, recall, etc.) by finding or
+ * creating the database, running the version gate, and dispatching to
+ * the appropriate command handler.
+ *
+ * When the database is not found in non-TTY mode, returns an error.
+ * In TTY mode, prompts the user to create a new database.
+ *
+ * @param options - parsed CLI options with command and args
+ * @param deps - injectable CLI dependencies
+ * @returns a `CommandResult` from the dispatched command
+ */
+export declare function handleDataCommand(options: CliOptions, deps: CliDeps): Promise<CommandResult>;

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

@@ -0,0 +1,15 @@
+import type { CliOptions } from '../typings/cli-options.interface.ts';
+import type { CommandResult } from '../typings/command-result.model.ts';
+import type { CliDeps } from '../typings/cli-deps.interface.ts';
+/**
+ * Handles the `mcp` command sub-flow.
+ *
+ * Resolves the database directory, creates a worker client, runs
+ * the version gate, and starts the MCP server. Disconnects the
+ * worker client when finished.
+ *
+ * @param options - parsed CLI options (uses `dbPath` and env fallback)
+ * @param deps - injectable CLI dependencies
+ * @returns a `CommandResult` with `exitCode: 0` on success
+ */
+export declare function handleMcp(options: CliOptions, deps: CliDeps): Promise<CommandResult>;

package/dist/src/shared/cli/functions/handle-migrate.function.d.ts

@@ -0,0 +1,15 @@
+import type { CliOptions } from '../typings/cli-options.interface.ts';
+import type { CommandResult } from '../typings/command-result.model.ts';
+import type { CliDeps } from '../typings/cli-deps.interface.ts';
+/**
+ * Handles the `migrate` / `db-migrate` command sub-flow.
+ *
+ * Resolves the database directory, creates a worker client,
+ * checks the version, and runs migrations when needed. Disconnects
+ * the worker client when finished.
+ *
+ * @param options - parsed CLI options (uses `dbPath`)
+ * @param deps - injectable CLI dependencies
+ * @returns a `CommandResult` with migration output or an error
+ */
+export declare function handleMigrate(options: CliOptions, deps: CliDeps): Promise<CommandResult>;

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

@@ -0,0 +1,14 @@
+import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
+import type { ContentClient } from './run-content.function.ts';
+/**
+ * Hydrates each result's `preview` field with the actual section
+ * content fetched from the client.
+ *
+ * Failures for individual results are caught and suppressed so that
+ * one unavailable section does not prevent other previews from
+ * being returned.
+ *
+ * @param client - content client used to fetch section text
+ * @param paged - mutable search display records to hydrate
+ */
+export declare function hydrateSearchPreviews(client: ContentClient, paged: PagedSearchDisplay): Promise<void>;

package/dist/src/shared/cli/functions/resolve-skill-names.function.d.ts

@@ -0,0 +1,16 @@
+import type { AgentGetClient, AgentDocumentSection } from '../typings/agent-get-client.interface.ts';
+/**
+ * Resolves skill names by reading each skill section's JSON content.
+ *
+ * Returns `null` for any reference whose section no longer exists
+ * (dangling reference) or whose content cannot be parsed.
+ *
+ * @param client - client used to fetch section records
+ * @param skillRefs - ordered section references to resolve
+ * @returns list of resolved skill entries with name and position
+ */
+export declare function resolveSkillNames(client: AgentGetClient, skillRefs: AgentDocumentSection[]): Promise<{
+    kbid: string;
+    name: string | null;
+    position: number;
+}[]>;

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

@@ -67,6 +67,7 @@ export interface SearchClient {
         mode?: string;
         limit?: number;
         offset?: number;
+        algo?: string;
     }): Promise<RawSearchResponse>;
 }
 /**

package/dist/src/shared/cli/functions/version-gate.function.d.ts

@@ -0,0 +1,15 @@
+import type { CommandResult } from '../typings/command-result.model.ts';
+import type { DisconnectableClient } from '../typings/disconnectable-client.interface.ts';
+/**
+ * Checks the database version and returns a `CommandResult` error
+ * when the version is incompatible, or `null` when it is compatible.
+ *
+ * - `'needs_migration'`: prompts the user to run `kbdb --migrate`
+ * - `'too_new'`: informs the user to upgrade kbdb
+ * - `'compatible'`: returns `null` (no gate triggered)
+ *
+ * @param client - disconnectable client with version-check capability
+ * @param dbDir - absolute path to the `.kbdb` database root
+ * @returns error `CommandResult` when blocked, or `null` when clear
+ */
+export declare function versionGate(client: DisconnectableClient, dbDir: string): Promise<CommandResult | null>;

package/dist/src/shared/cli/functions/wrap-command.function.d.ts

@@ -0,0 +1,15 @@
+import type { CommandResult } from '../typings/command-result.model.ts';
+/**
+ * Wraps an async command handler in a standard try/catch envelope.
+ *
+ * On success, serialises the result with `JSON.stringify` and
+ * returns `exitCode: 0`. On failure, returns an error message
+ * prefixed with `<label> failed:` and `exitCode: 1`.
+ *
+ * @param label - command name used in the error prefix
+ * @param handler - async function that produces the command result
+ * @param exitCodeSelector - optional function to derive `exitCode`
+ *   from the successful result; defaults to always returning 0
+ * @returns a `CommandResult` with output or error
+ */
+export declare function wrapCommand<T>(label: string, handler: () => Promise<T>, exitCodeSelector?: (result: T) => number): Promise<CommandResult>;

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

@@ -0,0 +1,42 @@
+import type { AddSectionResult } from '../../worker-client/typings/add-section-result.model.ts';
+/**
+ * Minimal client interface required by `runAgentCreate`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface AgentCreateClient {
+    /**
+     * Ingests a content section into the knowledge base.
+     *
+     * @param params - section type label, raw content, and optional
+     *   metadata
+     * @returns result object containing the assigned knowledge-base
+     *   identifier
+     */
+    addSection(params: {
+        readonly sectionType: string;
+        readonly content: string;
+        readonly title?: string;
+        readonly description?: string;
+    }): Promise<AddSectionResult>;
+    /**
+     * Groups a set of sections under a named document.
+     *
+     * @param title - human-readable document title
+     * @param kbids - identifiers of the sections to group
+     * @param docType - application-level document type tag; omit or
+     *   pass an empty string for untagged documents
+     * @returns the assigned document identifier
+     */
+    groupSections(title: string, kbids: string[], docType?: string): Promise<string>;
+    /**
+     * Retrieves one or more sections by their identifiers.
+     *
+     * @param kbids - list of knowledge-base identifiers to fetch
+     * @returns sections found; missing kbids are omitted from the result
+     */
+    readSections(kbids: string[]): Promise<{
+        kbid: string;
+    }[]>;
+}

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

@@ -0,0 +1,36 @@
+/** A document section reference as returned by `retrieveDocument`. */
+export interface AgentDocumentSection {
+    /** Knowledge-base identifier of the section. */
+    readonly kbid: string;
+    /** Zero-based position of the section within the document. */
+    readonly position: number;
+}
+/** A section record as returned by `readSections`. */
+export interface AgentSectionRecord {
+    /** Knowledge-base identifier of the section. */
+    readonly kbid: string;
+    /** Raw text content stored in the section. */
+    readonly content: string;
+}
+/**
+ * Minimal client interface required by `runAgentGet`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface AgentGetClient {
+    /**
+     * Retrieves a full document record including its ordered sections.
+     *
+     * @param docid - identifier of the document to retrieve
+     * @returns the document record
+     */
+    retrieveDocument(docid: string): Promise<unknown>;
+    /**
+     * Retrieves one or more sections by their identifiers.
+     *
+     * @param kbids - list of knowledge-base identifiers to fetch
+     * @returns sections found; missing kbids are omitted from the result
+     */
+    readSections(kbids: string[]): Promise<AgentSectionRecord[]>;
+}

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

@@ -0,0 +1,58 @@
+/** Raw daemon response from `integrityCheck`. */
+export interface RawIntegrityCheckResult {
+    /** `true` when all checks passed and no errors were found. */
+    readonly ok: boolean;
+    /** All integrity errors found; empty when `ok` is `true`. */
+    readonly errors: IntegrityError[];
+    /** Total number of sections examined. */
+    readonly sections_checked: number;
+    /** Total number of documents examined. */
+    readonly documents_checked: number;
+    /** Total number of marker references checked. */
+    readonly references_checked: number;
+    /** Time taken to complete the check, in milliseconds. */
+    readonly elapsed_ms: number;
+    /**
+     * Encoded divergent-content map.
+     *
+     * Format: `sk1:kbid1,kbid2;sk2:kbid3,kbid4`
+     *
+     * Each semicolon-separated segment is a source key followed by
+     * a colon and a comma-separated list of kbids. Absent when no
+     * divergent content exists.
+     */
+    readonly divergent_content?: string;
+}
+/** A single integrity error found during a database check. */
+export interface IntegrityError {
+    /**
+     * The category of integrity violation detected.
+     *
+     * - `'checksum_mismatch'` -- stored content does not match its hash
+     * - `'orphan_section'` -- section not referenced by any document
+     * - `'orphan_document'` -- document references no existing sections
+     * - `'broken_reference'` -- a marker references a non-existent entity
+     * - `'type_mismatch'` -- stored MIME type conflicts with content
+     * - `'circular_reference'` -- marker chain contains a cycle
+     */
+    readonly type: 'checksum_mismatch' | 'orphan_section' | 'orphan_document' | 'broken_reference' | 'type_mismatch' | 'circular_reference';
+    /** Identifier of the entity (kbid or docid) that has the issue. */
+    readonly entity: string;
+    /** Human-readable description of the specific problem. */
+    readonly detail: string;
+}
+/**
+ * Minimal client interface required by `runCheck`.
+ *
+ * Decouples the CLI function from the concrete `WorkerClient`
+ * implementation, making it straightforward to test with mocks.
+ */
+export interface CheckClient {
+    /**
+     * Runs an integrity check on the knowledge-base database.
+     *
+     * @returns a report of all issues found; `ok` is `true` when
+     *   no errors were detected
+     */
+    integrityCheck(): Promise<RawIntegrityCheckResult>;
+}

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

@@ -0,0 +1,48 @@
+import type { CliOptions } from './cli-options.interface.ts';
+import type { InitResult } from '../functions/run-init.function.ts';
+import type { DisconnectableClient } from './disconnectable-client.interface.ts';
+/**
+ * Injectable dependencies for the CLI orchestrator.
+ *
+ * Every external side-effect is injected so the function
+ * is fully testable without touching process globals,
+ * filesystem, or network.
+ */
+export interface CliDeps {
+    /** Returns `true` when stdin is an interactive terminal. */
+    isStdinTty: () => boolean;
+    /**
+     * Prompts the user with the given question and resolves with
+     * their trimmed response.
+     *
+     * @param question - text to display before the input prompt
+     */
+    promptUser: (question: string) => Promise<string>;
+    /**
+     * Creates a worker client connected to the given database path.
+     *
+     * @param opts - connection options including the context path
+     */
+    createWorkerClient: (opts: {
+        contextPath: string;
+    }) => Promise<DisconnectableClient>;
+    /**
+     * Finds the `.kbdb` directory starting from the given base path.
+     *
+     * @param basePath - starting directory; defaults to `process.cwd()`
+     * @returns absolute path to `.kbdb` or `null` when not found
+     */
+    findDb: (basePath?: string) => string | null;
+    /**
+     * Initialises a new `.kbdb` database directory.
+     *
+     * @param options - parsed CLI options
+     */
+    runInit: (options: CliOptions) => InitResult;
+    /**
+     * Starts the MCP server using the given database path.
+     *
+     * @param contextPath - absolute path to the `.kbdb` directory
+     */
+    startMcpServer?: (contextPath: string) => Promise<void>;
+}

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

@@ -27,6 +27,8 @@ export interface CliOptions {
     format: OutputFormat;
     /** Search mode passed to the worker daemon. Defaults to `'sections'`. */
     mode: SearchMode;
+    /** Search algorithm: `'lexical'`, `'vector'`, or `'hybrid'`. */
+    algo?: string;
     /** Maximum number of results to return. Defaults to 20. */
     limit: number;
     /** Number of results to skip for pagination. */

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

@@ -0,0 +1,26 @@
+import type { VersionStatus } from '../../worker-client/typings/version-status.model.ts';
+import type { MigrateResult } from '../../worker-client/typings/migrate-result.model.ts';
+import type { DispatchClient } from './dispatch-client.type.ts';
+/**
+ * Extension of `DispatchClient` with lifecycle methods needed by
+ * the CLI orchestrator.
+ *
+ * Adds version checking, migration, and disconnect so the orchestrator
+ * can manage a worker-client connection across all CLI commands.
+ */
+export interface DisconnectableClient extends DispatchClient {
+    /**
+     * Checks the database version against the worker engine.
+     *
+     * @param targetPath - absolute path to the `.kbdb` database root
+     */
+    checkVersion(targetPath: string): Promise<VersionStatus>;
+    /**
+     * Runs all pending database migrations.
+     *
+     * @param targetPath - absolute path to the `.kbdb` database root
+     */
+    migrateDatabase(targetPath: string): Promise<MigrateResult>;
+    /** Disconnects from the worker daemon and releases resources. */
+    disconnect(): void;
+}

package/dist/src/shared/cli/typings/dispatch-client.type.d.ts

@@ -0,0 +1,27 @@
+import type { SearchClient } from './search-client.interface.ts';
+import type { LearnClient } from './learn-client.interface.ts';
+import type { UnlearnClient } from '../functions/run-unlearn.function.ts';
+import type { ContentClient } from '../functions/run-content.function.ts';
+import type { CheckClient } from './check-client.interface.ts';
+import type { GcClient } from '../functions/run-gc.function.ts';
+import type { RebuildClient } from '../functions/run-rebuild.function.ts';
+import type { StatusClient } from '../functions/run-status.function.ts';
+import type { DbMigrateClient } from '../functions/run-db-migrate.function.ts';
+import type { SkillLearnClient } from '../functions/run-skill-learn.function.ts';
+import type { SkillListClient } from '../functions/run-skill-list.function.ts';
+import type { SkillGetClient } from '../functions/run-skill-get.function.ts';
+import type { SkillDeleteClient } from '../functions/run-skill-delete.function.ts';
+import type { AgentCreateClient } from './agent-create-client.interface.ts';
+import type { AgentListClient } from '../functions/run-agent-list.function.ts';
+import type { AgentGetClient } from './agent-get-client.interface.ts';
+import type { AgentDeleteClient } from '../functions/run-agent-delete.function.ts';
+import type { RecallClient } from '../functions/run-recall.function.ts';
+import type { ExportClient } from '../functions/run-export.function.ts';
+/**
+ * Intersection of all data-command client interfaces.
+ *
+ * Each run* function defines its own minimal interface; this
+ * intersection combines them so `dispatchCommand` can route
+ * to any command handler with full type safety.
+ */
+export type DispatchClient = SearchClient & LearnClient & UnlearnClient & ContentClient & CheckClient & GcClient & RebuildClient & StatusClient & DbMigrateClient & SkillLearnClient & SkillListClient & SkillGetClient & SkillDeleteClient & AgentCreateClient & AgentListClient & AgentGetClient & AgentDeleteClient & RecallClient & ExportClient;