@avantf/dsh-mem 0.6.4 → 0.8.0

package/lib/engine/mem-retrieval/adapters/local_reranker.d.ts

@@ -1,52 +0,0 @@
-import type { Reranker } from '../interfaces.js';
-import { type ModelEnv } from './local_bge.js';
-/** One text-classification result: transformers.js yields `{label, score}`; tolerate a raw `{data}` tensor too. */
-type ClassifyResult = {
-    label?: string;
-    score?: number;
-    data?: number[];
-};
-/** The injected pipeline surface: a batch of (query, document) pairs in, scores out. */
-export type ClassifyFn = (inputs: [string, string][], opts?: Record<string, unknown>) => Promise<ClassifyResult[]>;
-/** Injectable seam: tests supply a fake classifier instead of the transformers.js import. */
-export type RerankerPipeFactory = (model: string, env: ModelEnv) => Promise<ClassifyFn>;
-/** Never hand the classifier a degenerate document; below this the score is meaningless. */
-export declare const MIN_DOC_TOKENS = 16;
-/**
- * Local cross-encoder reranker via `@huggingface/transformers` (`bge-reranker`).
- * Lazily imported; `warmUp()` configures the mirror/cache and triggers a load.
- * Degrades to identity order when the package/model is not available.
- *
- * Like {@link LocalBgeBackend}, a failed warmup is retryable through
- * `ensureWarm()` rather than being final until the next restart.
- */
-export declare class LocalReranker implements Reranker {
-    readonly name = "bge_reranker";
-    private _available;
-    private _pipe;
-    private _warming;
-    private _lengthWarned;
-    private _window;
-    private readonly configuredMax;
-    private readonly model;
-    private readonly env;
-    private readonly pipeFactory;
-    private readonly gate;
-    constructor(model: string, env?: Partial<ModelEnv>, pipeFactory?: RerankerPipeFactory);
-    isAvailable(): boolean;
-    /** Fire-and-forget retry for call sites that only observe availability (see `warm_gate.ts`). */
-    ensureWarm(): void;
-    warmUp(): Promise<void>;
-    private _doWarmup;
-    private window;
-    /**
-     * Bound one document for a pair, given how much of the window the query already spends.
-     * Returns the document text unchanged when it fits.
-     */
-    private boundDocument;
-    rerank(query: string, candidates: {
-        id: number;
-        text: string;
-    }[]): Promise<number[]>;
-}
-export {};

package/lib/engine/mem-retrieval/adapters/none_reranker.d.ts

@@ -1,10 +0,0 @@
-import type { Reranker } from '../interfaces.js';
-/** `none` — reranking disabled (the default). Reports unavailable so callers skip the rerank pass entirely. */
-export declare class NoneReranker implements Reranker {
-    readonly name = "none";
-    isAvailable(): boolean;
-    rerank(_query: string, candidates: {
-        id: number;
-        text: string;
-    }[]): Promise<number[]>;
-}

package/lib/engine/mem-retrieval/rerank.d.ts

@@ -1,13 +0,0 @@
-import type { Reranker } from './interfaces.js';
-/**
- * The one rerank-and-reorder pass shared by every retrieval leg (memory search,
- * knowledge search — the blocks were byte-identical and had already drifted once
- * on the miss-sort sentinel).
- *
- * Contract: `reranker.rerank` returns candidate ids best-first; ids it omits sort
- * last with their fused order preserved (stable sort). A disabled/unavailable
- * reranker is a pass-through.
- */
-export declare function rerankHits<T extends {
-    id: number;
-}>(reranker: Reranker, query: string, hits: T[], textOf: (id: number) => string): Promise<T[]>;

package/lib/types/client/domains.d.ts

@@ -1,53 +0,0 @@
-/**
- * The 知识域 picker's option list.
- *
- * The host's `kbDomains` returns `knowledge.domains` (the configured allowlist) ∪ the domains the
- * library already holds. The union is the point: a historical name that the allowlist would not
- * accept as NEW must stay selectable, or the tab offers a value the store then refuses.
- * `restricted` mirrors "the allowlist is non-empty" — then the control is a closed `<select>` and
- * a new domain is a config change, not a second spelling of an existing one. An explicitly empty
- * allowlist means no restriction, so the control stays a free input.
- *
- * `DomainCatalog` itself is the CONTRACT's type (type-only import, erased from the bundle): the
- * host store's `domainCatalog()` return and this picker name the same declaration, so the shape
- * cannot be copied wrong on one half.
- */
-import type { DomainCatalog } from '../../engine/mem-contract/index.js';
-/** One `<option>`: `value` is what the form sends, `label` is what the user reads. */
-export interface DomainOption {
-    value: string;
-    label: string;
-}
-/** The empty choice first, then every catalog domain in the host's order. */
-export declare function domainOptions(catalog: DomainCatalog | null, emptyLabel: string): DomainOption[];
-/**
- * `'select'` when the allowlist is active (non-empty) — the control must not offer free input, or
- * two spellings of one domain can still be created. `'input'` when it is empty (no restriction),
- * and also while the catalog is not loaded yet: the form stays usable and the store is the final
- * guard either way.
- */
-export declare function domainPickerMode(catalog: DomainCatalog | null): 'select' | 'input';
-/**
- * What the 「+」 draft means, so the form and the store agree on the rules BEFORE a round-trip.
- *
- * `existing` is not an error: a name the picker already offers is a SELECTION (the user typed the
- * option instead of choosing it), and writing it a second time would only produce a duplicate list
- * entry. `invalid` is the case that must never reach the store: a `/` or `\` would become one level
- * of the managed path (`docs/<domain>/<source>/<title>.md`), and `sanitizeSegment` rewrites it — so
- * the picker would show a name that is not the directory name.
- */
-export type NewDomainCheck = {
-    kind: 'empty';
-} | {
-    kind: 'invalid';
-    reason: string;
-} | {
-    kind: 'existing';
-    name: string;
-} | {
-    kind: 'new';
-    name: string;
-};
-/** Classify one 「+」 draft against the domains the picker currently offers. */
-export declare function checkNewDomain(raw: string, existing: readonly string[]): NewDomainCheck;
-//# sourceMappingURL=domains.d.ts.map

package/lib/types/client/domains.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/client/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAElF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAOvF"}

package/lib/types/client/ingest.d.ts

@@ -1,24 +0,0 @@
-/**
- * The 知识 tab's 入库 result: did it land, or is the host asking whether to REPLACE?
- *
- * Kept as pure functions (no React, no Remote) so the decision is unit-testable, matching
- * `domains.ts`'s `checkNewDomain`. The host answers an unconfirmed collision with a
- * `KbConflictReport` and writes NOTHING, so the client's job is exactly two steps: recognise the
- * report, and phrase the question. The wiring that asks the user and re-sends with
- * `overwrite: true` lives in `index.ts` (pinned by a source guard in `test/ingest.spec.ts`).
- *
- * The confirm text is capped at 8 documents: a directory import that collides with the whole
- * library must produce a readable question, not a wall. The counts say what the rest are.
- */
-import type { KbConflictReport } from '../../engine/mem-contract/index.js';
-/**
- * The host's collision report, or `null` for any other payload.
- *
- * Validated structurally rather than by a bare cast: the value crossed the Remote wire, and a
- * truncated/garbled payload must fall through to the ordinary "完成" path instead of being shown
- * as a confirmation for a conflict that was never reported.
- */
-export declare function ingestConflict(value: unknown): KbConflictReport | null;
-/** The question the 「入库」 form asks before re-running the SAME request with `overwrite`. */
-export declare function conflictMessage(report: KbConflictReport): string;
-//# sourceMappingURL=ingest.d.ts.map

package/lib/types/client/ingest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/client/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAK5D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAMtE;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAQhE"}

package/lib/types/open.d.ts

@@ -1,77 +0,0 @@
-import type { OpenOutcome, OpenTarget } from '../engine/mem-contract/index.js';
-/**
- * The file names one command can have on PATH.
- *
- * On Windows a shim is `code.cmd` (or `.exe`/`.bat`), never the bare `code`, so probing only the
- * bare name silently loses the editor and falls back to the OS default application. `PATHEXT` is
- * what the shell itself uses; the default list is the fallback when it is not exported.
- */
-export declare function commandFileNames(command: string, platform?: NodeJS.Platform, pathext?: string | undefined): string[];
-/**
- * The file name of `command` that actually exists on `env.PATH`, or `undefined`.
- *
- * Returning the NAME (not a boolean) is what lets the launcher see `code.cmd` and know it holds a
- * batch shim. `[win]` — the win32 form is asserted from Linux with an injected platform/env.
- */
-export declare function resolveOnPath(command: string, platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string | undefined;
-/** True for a Windows batch shim — the one shape Node will not spawn without a shell. */
-export declare function isWindowsBatchShim(command: string, platform?: NodeJS.Platform): boolean;
-/** Why a launch failed: the editor is not here (fall through) or the launch was refused (report). */
-type LaunchFailure = 'missing' | 'refused';
-/**
- * Classify a synchronous spawn failure.
- *
- * `ENOENT` means the command is not there after all — the documented priority order just moves on,
- * with no warning. Everything else (the `EINVAL` a `.cmd` gets without a shell, `EACCES`, a bad
- * argument) is a wiring defect, and swallowing it is exactly how "open in VS Code" disappeared.
- */
-export declare function classifyLaunchFailure(error: unknown): LaunchFailure;
-/** The options the launch hands to `spawn`. */
-export interface LaunchOptions {
-    detached: boolean;
-    stdio: 'ignore';
-    /** Required on Windows for a `.cmd`/`.bat` shim (CVE-2024-27980 forbids a shell-less spawn). */
-    shell?: boolean;
-}
-/** What to hand to `spawn` for one candidate. */
-interface LaunchPlan {
-    command: string;
-    args: string[];
-    options: LaunchOptions;
-}
-/** The slice of `child_process.spawn` this module uses — narrow so a test can inject a fake. */
-export type SpawnLike = (command: string, args: string[], options: LaunchOptions) => {
-    unref: () => void;
-};
-/**
- * The concrete spawn shape for one candidate on `platform`.
- *
- * TWO Windows-only rules, both from the same root cause (CVE-2024-27980): a `.cmd`/`.bat` shim is
- * spawned through `shell: true`; and the last-resort fallback is `cmd /c start`, whose quoted path
- * must follow its own title argument or cmd treats the path AS the title. The plan is pure and
- * takes the platform, so the win32 shapes are asserted on Linux (`[win]`, real-machine re-check
- * still owed).
- */
-export declare function launchPlan(command: string, arg: string, platform?: NodeJS.Platform): LaunchPlan;
-/** Where a refused launch is reported; injectable so both failure paths are assertable. */
-type WarnSink = (message: string) => void;
-/** Host facts and side effects a caller (or a test) may replace. */
-interface OpenDeps {
-    platform?: NodeJS.Platform;
-    env?: NodeJS.ProcessEnv;
-    spawn?: SpawnLike;
-    /** Defaults to `console.warn` (stderr): a refused launch must leave a trace. */
-    warn?: WarnSink;
-}
-/**
- * Launch the configured/detected tool on one document path.
- *
- * @param documentPath - the managed `.md` path.
- * @param target - `file` opens the document, `dir` opens the directory that holds it.
- * @param configured - `knowledge.open.editor` from config (empty ⇒ auto-detect).
- * @param deps - platform / env / spawn / warning sink, for tests.
- * @throws when no candidate is available or every one of them fails to start.
- */
-export declare function openDocumentPath(documentPath: string, target: OpenTarget, configured: string, deps?: OpenDeps): OpenOutcome;
-export {};
-//# sourceMappingURL=open.d.ts.map

package/lib/types/open.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/open.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEnE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,OAAO,GAAE,MAAM,GAAG,SAAkC,GACnD,MAAM,EAAE,CAIV;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAepB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,OAAO,CAEzG;AAED,qGAAqG;AACrG,KAAK,aAAa,GAAG,SAAS,GAAG,SAAS,CAAA;AAE1C;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEnE;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,QAAQ,CAAA;IACf,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,iDAAiD;AACjD,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,KAAK;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAA;AAgB1G;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,UAAU,CAajH;AAgED,2FAA2F;AAC3F,KAAK,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEzC,oEAAoE;AACpE,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,QAAa,GAClB,WAAW,CAiDb"}

package/lib/types/reconcile.d.ts

@@ -1,64 +0,0 @@
-/**
- * Corpus reconciliation: the throttled "did anything under `knowledge.docs.dir` change?" sweep behind
- * `tools/result`.
- *
- * WHY IT IS ITS OWN MODULE. The plugin reaches the corpus through tool calls, so a finished tool call
- * is the moment to ask the question — and the answer is cheap (`corpusDrift()` is one `stat` per
- * document, reading nothing), which is what makes it affordable after EVERY tool result. Two things
- * about it are easy to get wrong and are pinned by `test/reconcile.spec.ts` instead of by a mounted
- * plugin: the THROTTLE (with a trailing run — skipping alone would drop the LAST edit, the one that
- * matters) and the STOP rule (an in-flight pass must not keep writing after the plugin unmounted and
- * its databases closed). `index.ts` is the assembly hub; this is the rule.
- *
- * @module @avantf/dsh-mem/reconcile
- */
-/** The corpus surface a reconciler drives — structural, so a test can hand it a fake. */
-interface ReconcileCorpus {
-    /** Re-ingest changed documents; `{}` is the full sweep that also reports corpus-level changes. */
-    sync(options: {
-        docId?: number;
-    }): Promise<unknown>;
-    /**
-     * One `stat` per document; no file is read. ASYNC because it is a per-document walk that yields
-     * the event loop every batch (see `KnowledgeStore.corpusDrift`), so it is another `await`
-     * boundary at which `stop()` is honoured.
-     */
-    corpusDrift(): Promise<{
-        changed: number[];
-        missing: number[];
-        fileSetChanged: boolean;
-    }>;
-}
-/** What {@link createCorpusReconciler} needs from its caller. */
-export interface ReconcileDeps {
-    corpus: ReconcileCorpus;
-    /** Minimum spacing between non-full checks (ms). */
-    minIntervalMs: number;
-    /** Called for a failed pass. The reconciler NEVER rethrows: a sync failure must not break the host. */
-    onError(error: unknown): void;
-    /** Clock seam (defaults to `Date.now`). */
-    now?(): number;
-    /** Timer seam (defaults to the global `setTimeout`); the handle is `unref`ed when it supports it. */
-    schedule?(fn: () => void, ms: number): ReturnType<typeof setTimeout>;
-    /** Timer-cancellation seam (defaults to the global `clearTimeout`). */
-    cancel?(handle: ReturnType<typeof setTimeout>): void;
-}
-/** The handle `index.ts` wires into an effect: request a check, and stop it on unmount. */
-interface CorpusReconciler {
-    /** Run one check — `full` bypasses the throttle and takes the baseline after the sweep. */
-    request(full: boolean): Promise<void>;
-    /**
-     * Stop permanently: no further pass starts, a scheduled trailing check is cancelled, and a pass
-     * already in flight exits at its next `await` boundary without touching the corpus again.
-     */
-    stop(): void;
-    /** Whether a pass is currently in flight (diagnostics and the unmount test). */
-    readonly running: boolean;
-}
-/**
- * Build the reconciler. All state is closed over here, so a fresh mount gets a fresh one — the
- * plugin can be unmounted and mounted again in one process.
- */
-export declare function createCorpusReconciler(deps: ReconcileDeps): CorpusReconciler;
-export {};
-//# sourceMappingURL=reconcile.d.ts.map

package/lib/types/reconcile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yFAAyF;AACzF,UAAU,eAAe;IACvB,kGAAkG;IAClG,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC1F;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAA;IACvB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAA;IACrB,uGAAuG;IACvG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,2CAA2C;IAC3C,GAAG,CAAC,IAAI,MAAM,CAAA;IACd,qGAAqG;IACrG,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;IACpE,uEAAuE;IACvE,MAAM,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAA;CACrD;AAED,2FAA2F;AAC3F,UAAU,gBAAgB;IACxB,2FAA2F;IAC3F,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAA;IACZ,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CA8E5E"}