oh-my-second-brain 0.3.0 → 0.6.2

package/dist/kernel/engine/embed/model.d.ts

@@ -0,0 +1,134 @@
+/** The canonical environment variables for selecting an embedding model. */
+export declare const EMBEDDING_PROVIDER_ENV: "OMS_EMBEDDING_PROVIDER";
+export declare const EMBEDDING_MODEL_ENV: "OMS_EMBEDDING_MODEL";
+export declare const INSTALLED_DEFAULT_DESCRIPTOR = "default-model.json";
+export declare const CAPABILITY_RECEIPT = "capability-receipt.json";
+/** Metadata needed to use an installed embedding model. */
+export interface EmbeddingModelDescriptor {
+    readonly provider: string;
+    /** Provider model id. For local providers this may be a filename. */
+    readonly model: string;
+    /** Absolute path to a locally installed model, when applicable. */
+    readonly path?: string;
+    /** Alias accepted in descriptors produced by setup adapters. */
+    readonly modelPath?: string;
+    /** Source URL used by setup, when this model was acquired. */
+    readonly url?: string;
+    /** SHA-256 digest of the installed bytes, lowercase hexadecimal. */
+    readonly sha256?: string;
+    readonly dimensions?: number;
+    /** Canonical model context window in tokens. */
+    readonly context?: number;
+    /** Canonical context-length alias used by some setup adapters. */
+    readonly contextLength?: number;
+    readonly contextTokens?: number;
+    /** Optional Matryoshka (MRL) output width. */
+    readonly mrlDim?: number;
+    /** Declared output-vector normalization scheme. */
+    readonly normalization?: string;
+    /** Declared query/passage prefix scheme. */
+    readonly prefixScheme?: string;
+    /** Optional filename used for the cache artifact. */
+    readonly filename?: string;
+}
+export type ModelResolutionSource = "configured" | "installed-default" | "none";
+export interface EmbeddingCapabilityReceipt {
+    readonly kind: "embedding-capability";
+    readonly available: boolean;
+    readonly source: ModelResolutionSource | "setup";
+    readonly provider?: string;
+    readonly model?: string;
+    readonly modelPath?: string;
+    readonly cachePath?: string;
+    readonly sha256?: string;
+    readonly dimensions?: number;
+    readonly context?: number;
+    readonly contextLength?: number;
+    readonly contextTokens?: number;
+    readonly mrlDim?: number;
+    readonly normalization?: string;
+    readonly prefixScheme?: string;
+    readonly guidance: string;
+}
+export interface EmbeddingModelResolution {
+    readonly available: boolean;
+    readonly source: ModelResolutionSource;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly modelPath?: string;
+    readonly descriptor?: EmbeddingModelDescriptor;
+    readonly receipt: EmbeddingCapabilityReceipt;
+}
+export interface ResolveEmbeddingModelOptions {
+    /** Environment snapshot. Defaults to process.env. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /** Installed descriptor to use when the canonical env pair is absent. */
+    readonly installedDefault?: EmbeddingModelDescriptor | null;
+    /** Alias accepted for callers that call the descriptor a default model. */
+    readonly defaultModel?: EmbeddingModelDescriptor | null;
+    /** Optional cache root for automatic installed-default discovery. */
+    readonly cacheDir?: string;
+}
+/**
+ * Resolve the one canonical embedding selection.
+ *
+ * A complete environment pair always wins. A half-pair is an error rather than
+ * an invitation to silently use a different model. If neither environment
+ * variable is set, an explicitly supplied installed descriptor is used, then
+ * the result is an honest unavailable capability.
+ */
+export declare function resolveEmbeddingModel(options?: ResolveEmbeddingModelOptions): EmbeddingModelResolution;
+/** Short alias for code that refers to this operation as model resolution. */
+export declare const resolveModel: typeof resolveEmbeddingModel;
+/**
+ * Cache root for downloaded model bytes. It is deliberately user-level and
+ * never derived from a vault path. `cacheDir` can be supplied by setup/tests.
+ */
+export declare function embeddingModelCacheDir(options?: {
+    readonly cacheDir?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly homeDir?: string;
+}): string;
+export declare const getEmbeddingModelCacheDir: typeof embeddingModelCacheDir;
+/** Read the setup-written descriptor synchronously for engine assembly. */
+export declare function readInstalledEmbeddingDefaultSync(options?: {
+    readonly cacheDir?: string;
+}): EmbeddingModelDescriptor | null;
+export interface AcquireEmbeddingModelOptions {
+    /** Descriptor must include URL and expected SHA-256 for setup acquisition. */
+    readonly descriptor: EmbeddingModelDescriptor & {
+        readonly url: string;
+        readonly sha256: string;
+    };
+    /** Optional explicit cache root. It must be outside `vault`, when provided. */
+    readonly cacheDir?: string;
+    /** Used only to reject an accidental cache path inside the vault. */
+    readonly vault?: string;
+    /** Injection point for focused tests; production uses the global fetch. */
+    readonly fetchImpl?: typeof fetch;
+}
+export interface AcquiredEmbeddingModel {
+    readonly descriptor: EmbeddingModelDescriptor;
+    readonly modelPath: string;
+    readonly cachePath: string;
+    readonly receipt: EmbeddingCapabilityReceipt;
+}
+/**
+ * Download and install a model for setup only.
+ *
+ * This function is intentionally not imported by the MCP server. It writes
+ * only to the user-level model cache, verifies bytes before publishing them,
+ * and leaves an installed-default descriptor plus capability receipt there for
+ * future model resolution.
+ */
+export declare function acquireEmbeddingModel(options: AcquireEmbeddingModelOptions): Promise<AcquiredEmbeddingModel>;
+/** Read the setup-written default descriptor without touching a vault. */
+export declare function readInstalledEmbeddingDefault(options?: {
+    readonly cacheDir?: string;
+}): Promise<EmbeddingModelDescriptor | null>;
+/** Async resolver that consults the setup cache when no env pair is present. */
+export declare function resolveEmbeddingModelFromCache(options?: {
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly cacheDir?: string;
+}): Promise<EmbeddingModelResolution>;
+export declare const resolveModelFromCache: typeof resolveEmbeddingModelFromCache;

package/dist/kernel/engine/embed/model.js

@@ -0,0 +1,302 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+/** The canonical environment variables for selecting an embedding model. */
+export const EMBEDDING_PROVIDER_ENV = "OMS_EMBEDDING_PROVIDER";
+export const EMBEDDING_MODEL_ENV = "OMS_EMBEDDING_MODEL";
+export const INSTALLED_DEFAULT_DESCRIPTOR = "default-model.json";
+export const CAPABILITY_RECEIPT = "capability-receipt.json";
+const INCOMPLETE_CONFIG_ERROR = `Embedding configuration is incomplete. Set both ${EMBEDDING_PROVIDER_ENV} and ${EMBEDDING_MODEL_ENV}.`;
+const NO_MODEL_GUIDANCE = `No embedding model is configured. Set ${EMBEDDING_PROVIDER_ENV} and ${EMBEDDING_MODEL_ENV}, ` +
+    "or install a local model with `oms setup --embedding-descriptor <descriptor>`.";
+function trim(value) {
+    return (value ?? "").trim();
+}
+function assertCompleteDescriptor(descriptor) {
+    const context = descriptor.context ?? descriptor.contextLength ?? descriptor.contextTokens;
+    if (!Number.isInteger(descriptor.dimensions) || descriptor.dimensions === undefined || descriptor.dimensions <= 0 ||
+        !Number.isInteger(context) || context === undefined || context <= 0 ||
+        !Number.isInteger(descriptor.mrlDim) || descriptor.mrlDim === undefined || descriptor.mrlDim < 0 ||
+        !trim(descriptor.normalization) ||
+        !trim(descriptor.prefixScheme)) {
+        throw new Error("Embedding descriptor is incomplete. dimensions/context/mrlDim/normalization/prefixScheme are required.");
+    }
+}
+function receiptFor(resolution, guidance) {
+    return {
+        kind: "embedding-capability",
+        available: resolution.available,
+        source: resolution.source,
+        ...(resolution.provider ? { provider: resolution.provider } : {}),
+        ...(resolution.model ? { model: resolution.model } : {}),
+        ...(resolution.modelPath ? { modelPath: resolution.modelPath } : {}),
+        ...(resolution.descriptor?.sha256 ? { sha256: resolution.descriptor.sha256 } : {}),
+        ...(resolution.descriptor?.dimensions !== undefined
+            ? { dimensions: resolution.descriptor.dimensions }
+            : {}),
+        ...(resolution.descriptor?.context !== undefined ? { context: resolution.descriptor.context } : {}),
+        ...(resolution.descriptor?.contextLength !== undefined
+            ? { contextLength: resolution.descriptor.contextLength }
+            : {}),
+        ...(resolution.descriptor?.contextTokens !== undefined
+            ? { contextTokens: resolution.descriptor.contextTokens }
+            : {}),
+        ...(resolution.descriptor?.mrlDim !== undefined ? { mrlDim: resolution.descriptor.mrlDim } : {}),
+        ...(resolution.descriptor?.normalization !== undefined
+            ? { normalization: resolution.descriptor.normalization }
+            : {}),
+        ...(resolution.descriptor?.prefixScheme !== undefined
+            ? { prefixScheme: resolution.descriptor.prefixScheme }
+            : {}),
+        guidance,
+    };
+}
+function withReceipt(resolution, guidance) {
+    return { ...resolution, receipt: receiptFor(resolution, guidance) };
+}
+/**
+ * Resolve the one canonical embedding selection.
+ *
+ * A complete environment pair always wins. A half-pair is an error rather than
+ * an invitation to silently use a different model. If neither environment
+ * variable is set, an explicitly supplied installed descriptor is used, then
+ * the result is an honest unavailable capability.
+ */
+export function resolveEmbeddingModel(options = {}) {
+    const env = options.env ?? process.env;
+    const provider = trim(env[EMBEDDING_PROVIDER_ENV]);
+    const model = trim(env[EMBEDDING_MODEL_ENV]);
+    if ((provider === "") !== (model === "")) {
+        throw new Error(INCOMPLETE_CONFIG_ERROR);
+    }
+    if (provider !== "" && model !== "") {
+        const descriptor = options.installedDefault !== undefined
+            ? options.installedDefault
+            : options.defaultModel !== undefined
+                ? options.defaultModel
+                : readInstalledEmbeddingDefaultSync({ cacheDir: options.cacheDir });
+        if (descriptor !== null && descriptor !== undefined) {
+            const descriptorModel = trim(descriptor.path) || trim(descriptor.modelPath) || trim(descriptor.model);
+            if (trim(descriptor.provider) !== provider || descriptorModel !== model) {
+                throw new Error("Embedding descriptor does not match the configured provider/model.");
+            }
+            assertCompleteDescriptor(descriptor);
+        }
+        const resolution = {
+            available: true,
+            source: "configured",
+            provider,
+            model,
+            ...(descriptor !== null && descriptor !== undefined ? { descriptor } : {}),
+        };
+        return withReceipt(resolution, "Embedding model selected from the canonical environment pair.");
+    }
+    // `null` explicitly disables discovery. With no override, setup's
+    // user-level descriptor is the second precedence tier.
+    const descriptor = options.installedDefault !== undefined
+        ? options.installedDefault
+        : options.defaultModel !== undefined
+            ? options.defaultModel
+            : readInstalledEmbeddingDefaultSync({ cacheDir: options.cacheDir });
+    if (descriptor !== null) {
+        const installedProvider = trim(descriptor.provider);
+        const installedModel = trim(descriptor.model);
+        if (installedProvider === "" || installedModel === "") {
+            throw new Error(`Installed embedding default is invalid. It must name both a provider and model (${EMBEDDING_PROVIDER_ENV} / ${EMBEDDING_MODEL_ENV}).`);
+        }
+        const modelPath = trim(descriptor.path) || trim(descriptor.modelPath);
+        const resolution = {
+            available: true,
+            source: "installed-default",
+            provider: installedProvider,
+            model: installedModel,
+            ...(modelPath ? { modelPath } : {}),
+            descriptor,
+        };
+        return withReceipt(resolution, `Using the installed default model. Set ${EMBEDDING_PROVIDER_ENV}=${installedProvider} and ${EMBEDDING_MODEL_ENV}=${modelPath || installedModel} to select it explicitly.`);
+    }
+    const resolution = {
+        available: false,
+        source: "none",
+    };
+    return withReceipt(resolution, NO_MODEL_GUIDANCE);
+}
+/** Short alias for code that refers to this operation as model resolution. */
+export const resolveModel = resolveEmbeddingModel;
+/**
+ * Cache root for downloaded model bytes. It is deliberately user-level and
+ * never derived from a vault path. `cacheDir` can be supplied by setup/tests.
+ */
+export function embeddingModelCacheDir(options = {}) {
+    if (options.cacheDir?.trim())
+        return path.resolve(options.cacheDir);
+    const env = options.env ?? process.env;
+    const xdg = trim(env["XDG_CACHE_HOME"]);
+    const root = xdg !== "" ? xdg : path.join(options.homeDir ?? homedir(), ".cache");
+    return path.resolve(root, "oms", "models");
+}
+export const getEmbeddingModelCacheDir = embeddingModelCacheDir;
+/** Read the setup-written descriptor synchronously for engine assembly. */
+export function readInstalledEmbeddingDefaultSync(options = {}) {
+    try {
+        const parsed = JSON.parse(readFileSync(path.join(embeddingModelCacheDir(options), INSTALLED_DEFAULT_DESCRIPTOR), "utf8"));
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const candidate = parsed;
+        if (typeof candidate.provider !== "string" || typeof candidate.model !== "string")
+            return null;
+        return candidate;
+    }
+    catch {
+        return null;
+    }
+}
+function isInside(child, parent) {
+    const relative = path.relative(parent, child);
+    return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
+}
+function safeName(value) {
+    const result = value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    return result || "model";
+}
+function extensionFromDescriptor(descriptor) {
+    const candidate = descriptor.filename ?? descriptor.model;
+    const extension = path.extname(candidate);
+    return extension.length > 0 && extension.length <= 12 ? extension : ".bin";
+}
+function modelFilename(descriptor) {
+    const supplied = descriptor.filename?.trim();
+    if (supplied)
+        return path.basename(supplied);
+    return `${safeName(descriptor.provider)}-${safeName(descriptor.model)}${extensionFromDescriptor(descriptor)}`;
+}
+function sha256Bytes(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function assertSha256(expected) {
+    const normalized = (expected ?? "").trim().toLowerCase();
+    if (!/^[a-f0-9]{64}$/.test(normalized)) {
+        throw new Error("Embedding model SHA-256 must be a 64-character hexadecimal digest.");
+    }
+    return normalized;
+}
+async function readVerified(pathname, expected) {
+    try {
+        const bytes = await readFile(pathname);
+        const actual = sha256Bytes(bytes);
+        if (actual !== expected) {
+            await rm(pathname, { force: true });
+            throw new Error(`Embedding model SHA-256 checksum mismatch: expected ${expected}, got ${actual}.`);
+        }
+        return bytes;
+    }
+    catch (error) {
+        if (error instanceof Error && /checksum mismatch/.test(error.message))
+            throw error;
+        return null;
+    }
+}
+async function writeAtomic(pathname, bytes) {
+    const temporary = `${pathname}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await writeFile(temporary, bytes, { flag: "wx" });
+        await rename(temporary, pathname);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+/**
+ * Download and install a model for setup only.
+ *
+ * This function is intentionally not imported by the MCP server. It writes
+ * only to the user-level model cache, verifies bytes before publishing them,
+ * and leaves an installed-default descriptor plus capability receipt there for
+ * future model resolution.
+ */
+export async function acquireEmbeddingModel(options) {
+    const descriptor = options.descriptor;
+    const expected = assertSha256(descriptor.sha256);
+    const url = typeof descriptor.url === "string" ? descriptor.url.trim() : "";
+    if (url === "") {
+        throw new Error("Embedding model URL is required for setup acquisition.");
+    }
+    const cacheRoot = embeddingModelCacheDir({ cacheDir: options.cacheDir });
+    if (options.vault !== undefined && isInside(cacheRoot, path.resolve(options.vault))) {
+        throw new Error("Embedding model cache must be outside the vault.");
+    }
+    await mkdir(cacheRoot, { recursive: true });
+    const cachePath = path.join(cacheRoot, modelFilename(descriptor));
+    let bytes = await readVerified(cachePath, expected);
+    if (bytes === null) {
+        const fetchImpl = options.fetchImpl ?? fetch;
+        const response = await fetchImpl(url);
+        if (!response.ok) {
+            throw new Error(`Embedding model download failed: ${response.status} ${response.statusText}.`);
+        }
+        bytes = new Uint8Array(await response.arrayBuffer());
+        const actual = sha256Bytes(bytes);
+        if (actual !== expected) {
+            throw new Error(`Embedding model SHA-256 checksum mismatch: expected ${expected}, got ${actual}.`);
+        }
+        await writeAtomic(cachePath, bytes);
+    }
+    const installed = {
+        ...descriptor,
+        path: cachePath,
+        sha256: expected,
+        filename: modelFilename(descriptor),
+    };
+    const descriptorPath = path.join(cacheRoot, INSTALLED_DEFAULT_DESCRIPTOR);
+    const receiptPath = path.join(cacheRoot, CAPABILITY_RECEIPT);
+    await writeAtomic(descriptorPath, `${JSON.stringify(installed, null, 2)}\n`);
+    const receipt = {
+        kind: "embedding-capability",
+        available: true,
+        source: "setup",
+        provider: installed.provider,
+        model: installed.model,
+        modelPath: cachePath,
+        cachePath,
+        sha256: expected,
+        ...(installed.dimensions !== undefined ? { dimensions: installed.dimensions } : {}),
+        ...(installed.context !== undefined ? { context: installed.context } : {}),
+        ...(installed.contextLength !== undefined ? { contextLength: installed.contextLength } : {}),
+        ...(installed.contextTokens !== undefined ? { contextTokens: installed.contextTokens } : {}),
+        ...(installed.mrlDim !== undefined ? { mrlDim: installed.mrlDim } : {}),
+        ...(installed.normalization !== undefined ? { normalization: installed.normalization } : {}),
+        ...(installed.prefixScheme !== undefined ? { prefixScheme: installed.prefixScheme } : {}),
+        guidance: `Model installed. Set ${EMBEDDING_PROVIDER_ENV}=${installed.provider} and ${EMBEDDING_MODEL_ENV}=${installed.path || installed.model} to select it.`,
+    };
+    await writeAtomic(receiptPath, `${JSON.stringify(receipt, null, 2)}\n`);
+    return { descriptor: installed, modelPath: cachePath, cachePath, receipt };
+}
+/** Read the setup-written default descriptor without touching a vault. */
+export async function readInstalledEmbeddingDefault(options = {}) {
+    try {
+        const raw = await readFile(path.join(embeddingModelCacheDir(options), INSTALLED_DEFAULT_DESCRIPTOR), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const candidate = parsed;
+        if (typeof candidate.provider !== "string" || typeof candidate.model !== "string")
+            return null;
+        return candidate;
+    }
+    catch {
+        return null;
+    }
+}
+/** Async resolver that consults the setup cache when no env pair is present. */
+export async function resolveEmbeddingModelFromCache(options = {}) {
+    const provider = trim((options.env ?? process.env)[EMBEDDING_PROVIDER_ENV]);
+    const model = trim((options.env ?? process.env)[EMBEDDING_MODEL_ENV]);
+    if (provider !== "" || model !== "")
+        return resolveEmbeddingModel({ env: options.env });
+    const installedDefault = await readInstalledEmbeddingDefault({ cacheDir: options.cacheDir });
+    return resolveEmbeddingModel({ env: options.env, installedDefault });
+}
+export const resolveModelFromCache = resolveEmbeddingModelFromCache;
+//# sourceMappingURL=model.js.map

package/dist/kernel/engine/embed/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/kernel/engine/embed/model.ts"],"names":[],"mappings":"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"}

package/dist/kernel/engine/embed/provider.d.ts

@@ -19,9 +19,28 @@
 import type { EmbeddingProvider } from "../types.js";
 /** Default embedding dimension for the GGUF provider (EmbeddingGemma-300M). */
 export declare const GGUF_EMBEDDING_DIMENSIONS = 768;
+/** Default context length for the GGUF provider (EmbeddingGemma-300M). */
+export declare const GGUF_EMBEDDING_CONTEXT_LENGTH = 2048;
+/** Embedding provider seam for callers that need the query-side prefix. */
+export interface QueryEmbeddingProvider extends EmbeddingProvider {
+    readonly embedQuery: (text: string) => Promise<Float32Array>;
+}
+/** Per-model runtime dimensions/context supplied by the model descriptor. */
+export interface EmbeddingRuntimeOptions {
+    readonly dimensions?: number;
+    /** Canonical model context window in tokens. */
+    readonly context?: number;
+    /** Canonical context length field. */
+    readonly contextLength?: number;
+    /** Descriptor alias used by setup adapters. */
+    readonly contextTokens?: number;
+    readonly mrlDim?: number;
+    readonly normalization?: string;
+    readonly prefixScheme?: string;
+}
 /**
  * Create a production EmbeddingProvider backed by a local GGUF model via
- * node-llama-cpp.  Target model: EmbeddingGemma-300M (768d).
+ * node-llama-cpp.  Target model: EmbeddingGemma-300M (descriptor width).
  *
  * Design (ported idea-only from qmd, MIT — ACKNOWLEDGMENTS.md M1):
  *   - Lazy-load: model/contexts are not initialised until the first embed() call.
@@ -32,9 +51,10 @@ export declare const GGUF_EMBEDDING_DIMENSIONS = 768;
  *       Contexts are selected round-robin; embed calls do not queue.
  *
  * @param modelPath  - Absolute path to the GGUF model file.
- * @param dimensions - Expected embedding dimension (default 768 for Gemma-300M).
+ * @param dimensionsOrOptions - Expected width or descriptor runtime options.
+ * @param contextLength - Legacy positional context-length override.
  */
-export declare function createGGUFEmbeddingProvider(modelPath: string, dimensions?: number): EmbeddingProvider;
+export declare function createGGUFEmbeddingProvider(modelPath: string, dimensionsOrOptions?: number | EmbeddingRuntimeOptions, contextLength?: number): QueryEmbeddingProvider;
 /**
  * Create an Upstage Solar embedding provider (4096d).
  *
@@ -42,7 +62,7 @@ export declare function createGGUFEmbeddingProvider(modelPath: string, dimension
  * when UPSTAGE_API_KEY is set in the environment; never use by default.
  * The API key MUST come from env — never hardcoded (R4 secrets-via-env).
  */
-export declare function createUpstageProvider(apiKey: string, model: string): EmbeddingProvider;
+export declare function createUpstageProvider(apiKey: string, model: string, dimensions?: number, metadata?: Pick<EmbeddingRuntimeOptions, "context" | "contextLength" | "contextTokens" | "mrlDim" | "normalization" | "prefixScheme">): QueryEmbeddingProvider;
 export type EmbeddingProviderKind = "gguf" | "upstage";
 /** Options for the production embedding factory (explicit provider + model). */
 export interface EmbeddingProviderOptions {
@@ -50,6 +70,17 @@ export interface EmbeddingProviderOptions {
     provider?: EmbeddingProviderKind | string;
     /** Provider-specific model identifier selected by OMS_EMBEDDING_MODEL. */
     model?: string;
+    /** Descriptor-derived vector width. */
+    dimensions?: number;
+    /** Canonical model context window in tokens. */
+    context?: number;
+    /** Descriptor-derived context length (no model-specific default here). */
+    contextLength?: number;
+    /** Setup descriptor alias for contextLength. */
+    contextTokens?: number;
+    mrlDim?: number;
+    normalization?: string;
+    prefixScheme?: string;
 }
 /** Alias kept for callers that import StrictEmbeddingProviderOptions by name. */
 export type StrictEmbeddingProviderOptions = EmbeddingProviderOptions;
@@ -63,4 +94,4 @@ export type StrictEmbeddingProviderOptions = EmbeddingProviderOptions;
  * @throws {Error} When provider/model are missing or unsupported, or when
  *                 provider-specific auth is missing.
  */
-export declare function requireRealEmbeddingProvider(opts?: StrictEmbeddingProviderOptions): EmbeddingProvider;
+export declare function requireRealEmbeddingProvider(opts?: StrictEmbeddingProviderOptions): QueryEmbeddingProvider;