wolbarg 0.4.0 → 0.5.1

package/dist/index.d.cts

@@ -49,7 +49,7 @@ declare const meta: {
  * Schema is intentionally extensible for future providers (Postgres, cloud).
  */
 /** Public operation names recorded as telemetry events. */
-type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint";
+type TelemetryOperation = "remember" | "recall" | "forget" | "compress" | "rememberBatch" | "recallBatch" | "export" | "import" | "checkpoint" | "rollback" | "error" | "startup" | "shutdown" | "ingest" | "history" | "stats" | "clear" | "deleteCheckpoint" | "listCheckpoints" | "getCheckpoint" | "linkMemories" | "getRelated" | "graphQuery";
 type TelemetryStatus = "ok" | "error" | "cancelled";
 type TelemetryLogLevel = "off" | "error" | "warn" | "info" | "debug" | "trace";
 /** Stage-level latency breakdown recorded on each event. */
@@ -388,6 +388,12 @@ interface RecallOptions {
      * When `true`, return enriched explain results instead of plain RecallResult[].
      */
     explain?: boolean;
+    /**
+     * When `true` and a graph provider is configured, each hit includes
+     * `related` memories from {@link GraphProvider.getRelated}.
+     * Omitted / false → no behavior change (related is absent).
+     */
+    includeGraph?: boolean;
 }
 /** A single recalled memory with similarity score. */
 interface RecallResult {
@@ -400,6 +406,11 @@ interface RecallResult {
     similarity: number;
     createdAt: Date;
     updatedAt: Date;
+    /**
+     * Present only when `recall({ includeGraph: true })` and a graph provider
+     * is configured. Related memories via graph traversal (depth 1, both dirs).
+     */
+    related?: MemoryRecord[];
 }
 /** Enriched recall hit when `explain: true`. */
 interface RecallExplanationHit {
@@ -579,6 +590,107 @@ interface IngestResult {
     usedVision: boolean;
 }
 
+/**
+ * Graph memory provider contract.
+ *
+ * Mirrors {@link StorageProvider} lifecycle naming (`open` / `close` / `health`
+ * pattern via `health()`). Fully optional — omitting a graph provider does not
+ * change existing memory behavior.
+ *
+ * ## Portability contract
+ *
+ * - The five typed methods (`linkMemories`, `unlinkMemories`, `getRelated`,
+ *   `upsertEntity`, `linkEntityToMemory`) are **guaranteed** identical behavior
+ *   across SQLite and Neo4j. This is the tested, supported contract (see
+ *   `graph-parity.test.ts`).
+ * - `query(cypher, params)` is supported on Neo4j only. The SQLite graph
+ *   provider **hard-errors** immediately — SQLite has no Cypher. Use typed
+ *   methods for portable code, or query the graph SQLite tables directly if you
+ *   need raw SQL locally.
+ * - `health()` guarantees only `ok` and `backend`. The `details` payload
+ *   differs (embedded file path vs networked cluster/connection info).
+ * - `deleteMemory` supports hard-delete cascade from `forget` / `clear` and is
+ *   part of the portable typed surface.
+ */
+
+/** Direction for {@link GraphProvider.getRelated}. */
+type GraphDirection = "in" | "out" | "both";
+interface GetRelatedOptions {
+    relation?: string;
+    /** Traversal depth (default 1). */
+    depth?: number;
+    direction?: GraphDirection;
+}
+interface GraphEntityInput {
+    name: string;
+    type: string;
+    metadata?: Record<string, unknown>;
+}
+interface GraphHealthResult {
+    ok: boolean;
+    backend: string;
+    details?: unknown;
+}
+/**
+ * Pluggable graph store for memory–memory and entity–memory relations.
+ *
+ * Typed CRUD methods MUST be implemented with each backend’s native driver API
+ * (not by routing through {@link GraphProvider.query}). `query()` is the
+ * user-facing raw escape hatch only (Neo4j); SQLite throws.
+ */
+interface GraphProvider {
+    readonly name: string;
+    /** Open connection / embedded database and ensure schema. */
+    open(): Promise<void>;
+    /** Close the underlying connection. */
+    close(): Promise<void>;
+    /**
+     * Create (or ensure) a directed relation between two memory nodes.
+     * Implementations create stub Memory nodes when missing.
+     */
+    linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Remove relation(s) between two memory nodes. */
+    unlinkMemories(fromId: string, toId: string, relation?: string): Promise<void>;
+    /**
+     * Traverse from a memory node and return related Memory records as stored
+     * in the graph (facade may re-hydrate from SQL storage).
+     */
+    getRelated(memoryId: string, options?: GetRelatedOptions): Promise<MemoryRecord[]>;
+    /** Upsert an entity node; returns stable entity id. */
+    upsertEntity(entity: GraphEntityInput): Promise<string>;
+    /** Link an entity to a memory with an optional role. */
+    linkEntityToMemory(entityId: string, memoryId: string, role?: string): Promise<void>;
+    /**
+     * Hard-delete a memory node and all incident edges (cascade for forget/clear).
+     */
+    deleteMemory(memoryId: string): Promise<void>;
+    /**
+     * Raw Cypher escape hatch. Supported on Neo4j only — the SQLite provider
+     * throws a typed error. See module portability contract above.
+     */
+    query(cypher: string, params?: Record<string, unknown>): Promise<unknown>;
+    health(): Promise<GraphHealthResult>;
+    /**
+     * When true, checkpoint/export may snapshot {@link getDataPath}.
+     * Network-backed providers (Neo4j) return false.
+     */
+    supportsFileSnapshot(): boolean;
+    /** Absolute path to the embedded graph data directory/file, if any. */
+    getDataPath(): string | null;
+}
+/** Config shape accepted by `wolbarg({ graph: … })` when not passing an instance. */
+type GraphConfig = {
+    provider: "sqlite";
+    path: string;
+} | {
+    provider: "neo4j";
+    url: string;
+    username: string;
+    password: string;
+    database?: string;
+};
+type GraphInput$1 = GraphProvider | GraphConfig;
+
 /**
  * Chunking strategies for document ingestion.
  */
@@ -1034,6 +1146,7 @@ declare function openaiVision(options: {
 type EmbeddingInput = EmbeddingProvider | EmbeddingConfig;
 type LlmInput = LlmProvider | LlmConfig;
 type StorageInput = StorageProvider | StorageConfig | DatabaseConfig;
+type GraphInput = GraphProvider | GraphConfig;
 interface WolbargOptionsBase {
     /** Organization namespace isolating memories within a shared database. */
     organization: string;
@@ -1062,6 +1175,12 @@ interface WolbargOptionsBase {
     ocr?: OCRProvider;
     /** Optional vision model for image captions. */
     vision?: VisionProvider;
+    /**
+     * Optional graph memory layer (SQLite embedded or Neo4j networked).
+     * Fully optional — omitting it does not change existing memory behavior.
+     * Accepts a {@link GraphProvider} instance or a recognized config shape.
+     */
+    graph?: GraphInput;
     /** Optional compression provider (overrides llm-backed default). */
     compression?: CompressionProvider;
     /** Optional default chunking strategy for ingest. */
@@ -1149,6 +1268,7 @@ declare class Wolbarg<HasLlm extends boolean = false> {
     private keywordSearch;
     private ocr;
     private vision;
+    private graph;
     private chunking;
     private retrievalConfig;
     private embeddingDimensions;
@@ -1214,6 +1334,17 @@ declare class Wolbarg<HasLlm extends boolean = false> {
     /** @internal */
     private runCompress;
     ingest(options: IngestOptions): Promise<IngestResult>;
+    /**
+     * Link two memories in the optional graph layer.
+     * Throws {@link ProviderNotConfiguredError} when no graph provider is set.
+     */
+    linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Traverse related memories via the optional graph layer.
+     * Throws {@link ProviderNotConfiguredError} when no graph provider is set.
+     * Results are re-hydrated from SQL storage when available.
+     */
+    getRelated(memoryId: string, options?: GetRelatedOptions): Promise<MemoryRecord[]>;
     forget(options: ForgetOptions): Promise<number>;
     history(options: HistoryOptions): Promise<HistoryResult>;
     stats(): Promise<StatsResult>;
@@ -1244,11 +1375,21 @@ declare class Wolbarg<HasLlm extends boolean = false> {
     private requireReady;
     private assertEmbeddingDimensions;
     private requireCheckpointProvider;
+    private requireGraph;
+    private assertGraphCheckpointSupported;
+    private graphSnapshotDir;
+    private closeGraphForSnapshot;
+    private snapshotGraphAlongside;
+    private restoreGraphAlongside;
+    private hydrateRelated;
     private requireMemoryDbPath;
 }
 /** Preferred v0.3 entry — re-exported from factories as well. */
 declare function wolbarg$1(options: WolbargOptions): Wolbarg;
 
+/** Published SDK semver — keep in sync with package.json `version`. */
+declare const SDK_VERSION = "0.5.0";
+
 /**
  * Operation-scoped errors with reason + suggestion for developer experience.
  */
@@ -1338,6 +1479,14 @@ declare class ProviderNotConfiguredError extends ConfigurationError {
     readonly provider: string;
     constructor(provider: string, method: string, hint: string);
 }
+/**
+ * Thrown when graph checkpoint / rollback / export / import is requested for a
+ * network-backed graph provider (e.g. Neo4j). File-backed SQLite graph supports
+ * snapshots; Neo4j does not in v1 — we refuse rather than silently skip.
+ */
+declare class GraphCheckpointNotSupportedError extends WolbargError {
+    constructor(backend: string, operation: string);
+}
 /** Map low-level SQLite / driver errors into actionable operation errors. */
 declare function wrapOperationError(operation: string, error: unknown): WolbargError;
 
@@ -1365,6 +1514,17 @@ declare function postgresConfig(connectionString: string, options?: {
 declare function sqliteTelemetry(url: string): TelemetryProvider;
 /** Create a SQLite checkpoint provider. */
 declare function sqliteCheckpoint(directory?: string): CheckpointProvider;
+/** Create an embedded SQLite graph provider (file-backed, local/dev). */
+declare function sqliteGraph(options: {
+    path: string;
+}): GraphProvider;
+/** Create a Neo4j graph provider (networked). Requires optional peer `neo4j-driver`. */
+declare function neo4jGraph(options: {
+    url: string;
+    username: string;
+    password: string;
+    database?: string;
+}): GraphProvider;
 /** Create a telemetry provider from config (SQLite only in v0.3). */
 declare function createTelemetryProvider(config: TelemetryConfig): TelemetryProvider;
 /**
@@ -1720,6 +1880,110 @@ declare function createStorageProvider(config: StorageConfig | DatabaseConfig, o
 /** @deprecated Prefer {@link createStorageProvider}. */
 declare function createDatabaseProvider(config: DatabaseConfig): StorageProvider;
 
+/**
+ * Embedded SQLite graph provider (file-backed, local/dev).
+ *
+ * Implements the five typed {@link GraphProvider} methods with plain SQL and
+ * recursive CTEs — no Cypher. Schema is created on open (plain CREATE TABLE IF
+ * NOT EXISTS; no graph-engine DDL / schema-creation-on-first-write complexity).
+ *
+ * Uses the same `node:sqlite` + {@link withImmediateTransaction} patterns as
+ * {@link SqliteStorageProvider}. Graph data lives in a separate SQLite file from
+ * the memory store by default.
+ */
+
+interface SqliteGraphProviderOptions {
+    /** Path to the graph SQLite file (separate from the memory store by default). */
+    path: string;
+    /** Optional write-concurrency tuning (same shape as memory SQLite). */
+    concurrency?: ConcurrencyConfig;
+}
+declare class SqliteGraphProvider implements GraphProvider {
+    readonly name = "sqlite";
+    private readonly dbPath;
+    private readonly concurrency;
+    private db;
+    private opened;
+    constructor(options: SqliteGraphProviderOptions);
+    supportsFileSnapshot(): boolean;
+    getDataPath(): string | null;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
+    unlinkMemories(fromId: string, toId: string, relation?: string): Promise<void>;
+    /**
+     * Bounded recursive CTE over `graph_edges`.
+     *
+     * Default depth: {@link DEFAULT_GET_RELATED_DEPTH} (1). Cap: 16.
+     * Only memory↔memory edges are walked (entity MENTIONS edges are excluded).
+     * Cycle-safe via path membership (`instr`) so A→B→C→A terminates.
+     *
+     * Returns stub {@link MemoryRecord}s (id + empty fields). The facade
+     * re-hydrates full rows via `toMemoryRecord` from storage when possible.
+     */
+    getRelated(memoryId: string, options?: GetRelatedOptions): Promise<MemoryRecord[]>;
+    upsertEntity(entity: GraphEntityInput): Promise<string>;
+    linkEntityToMemory(entityId: string, memoryId: string, role?: string): Promise<void>;
+    deleteMemory(memoryId: string): Promise<void>;
+    /**
+     * Raw Cypher escape hatch — **not supported** on the SQLite graph provider.
+     * Use the typed methods, or open the underlying SQLite file yourself for raw SQL.
+     */
+    query(_cypher: string, _params?: Record<string, unknown>): Promise<unknown>;
+    health(): Promise<GraphHealthResult>;
+    private withTx;
+    private requireDb;
+    private findMemoryNodeId;
+    private ensureMemoryNodeSync;
+}
+
+/**
+ * Neo4j graph provider (networked, production).
+ *
+ * Uses neo4j-driver session.run with parameterized Cypher for typed methods —
+ * NOT GraphProvider.query(). Schema-flexible: nodes/relationships are created
+ * freely without DDL.
+ *
+ * Install as optional peer: `npm install neo4j-driver`.
+ */
+
+interface Neo4jGraphProviderOptions {
+    url: string;
+    username: string;
+    password: string;
+    database?: string;
+}
+declare class Neo4jGraphProvider implements GraphProvider {
+    readonly name = "neo4j";
+    private readonly url;
+    private readonly username;
+    private readonly password;
+    private readonly database;
+    private driver;
+    private opened;
+    constructor(options: Neo4jGraphProviderOptions);
+    supportsFileSnapshot(): boolean;
+    getDataPath(): string | null;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    private requireDriver;
+    private withSession;
+    private run;
+    private ensureMemoryNode;
+    linkMemories(fromId: string, toId: string, relation: string, metadata?: Record<string, unknown>): Promise<void>;
+    unlinkMemories(fromId: string, toId: string, relation?: string): Promise<void>;
+    /**
+     * Native Neo4j variable-length path traversal.
+     * Relationship filter uses RELATED.relation property for parity with Kuzu.
+     */
+    getRelated(memoryId: string, options?: GetRelatedOptions): Promise<MemoryRecord[]>;
+    upsertEntity(entity: GraphEntityInput): Promise<string>;
+    linkEntityToMemory(entityId: string, memoryId: string, role?: string): Promise<void>;
+    deleteMemory(memoryId: string): Promise<void>;
+    query(cypher: string, params?: Record<string, unknown>): Promise<unknown>;
+    health(): Promise<GraphHealthResult>;
+}
+
 /**
  * Database-agnostic memory persistence contract.
  * Alias of StorageProvider for the v0.3 provider architecture.
@@ -1830,6 +2094,22 @@ declare class SqliteCheckpointProvider implements CheckpointProvider {
     deleteCheckpoint(name: string): Promise<boolean>;
     listCheckpoints(): Promise<CheckpointMeta[]>;
     getCheckpoint(name: string): Promise<CheckpointMeta | null>;
+    /**
+     * Consistent SQLite file backup (WAL checkpoint + backup API / copy).
+     * Used for memory snapshots and for secondary files such as the graph DB.
+     */
+    backupSqliteFile(sourcePath: string, destPath: string): Promise<void>;
+    /**
+     * Snapshot a secondary SQLite file (typically the graph DB) next to a named
+     * memory checkpoint as `{name}.graph.db`.
+     */
+    checkpointGraph(name: string, graphSourcePath: string): Promise<string>;
+    /**
+     * Restore a previously snapshotted graph SQLite file into `targetPath`.
+     */
+    rollbackGraph(name: string, targetPath: string): Promise<void>;
+    /** Absolute path of the graph snapshot for a named checkpoint, if present. */
+    graphSnapshotPath(name: string): string;
     private metaPath;
     private snapshotPath;
     private requireReady;
@@ -1928,4 +2208,4 @@ interface BenchmarkReport {
 declare function runBenchmark(name: string, iterations: number, fn: () => Promise<void> | void): Promise<BenchmarkSample[]>;
 declare function summarizeBenchmark(samples: BenchmarkSample[], startedAt: string, finishedAt: string): BenchmarkReport;
 
-export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };
+export { type BenchmarkReport, type BenchmarkSample, type ChatMessage, type CheckpointInfo, type CheckpointMeta, type CheckpointOptions, type CheckpointProvider, type Chunk, type ChunkingOptions, type ChunkingStrategy, type ClearOptions, type CompressOptions, type CompressResult, CompressionError, type CompressionProvider, type ConcurrencyConfig$1 as ConcurrencyConfig, ConfigurationError, type CreateCheckpointOptions, type DatabaseConfig, DatabaseError, type DatabaseProvider, type DatabaseProviderName, type EmbeddingCacheConfig, type EmbeddingConfig, EmbeddingError, type EmbeddingProvider, type EventDatabase, type ExportResult, FixedChunkingStrategy, type ForgetByFilterOptions, type ForgetByIdOptions, type ForgetOptions, type GetRelatedOptions, GraphCheckpointNotSupportedError, type GraphConfig, type GraphDirection, type GraphEntityInput, type GraphHealthResult, type GraphInput$1 as GraphInput, type GraphProvider, HeadingChunkingStrategy, type HistoryEvent, type HistoryOptions, type HistoryResult, type HybridConfig, type ImportResult, type IngestOptions, type IngestResult, type InitOptions, InitializationError, type KeywordDocument, type KeywordSearchHit, type KeywordSearchProvider, type LatencyBreakdown, LlmCompressionProvider, type LlmConfig, type LlmProvider, MarkdownChunkingStrategy, type MemoryChangeCallback, type MemoryChangeEvent, type MemoryContent, type MemoryDedupeConfig, type MemoryDedupeStrategy, type MemoryFilter, type MemoryMetadata, MemoryNotFoundError, type MemoryProvider, type MemoryRecord, type MetadataFilter as MetaFilter, type MetadataComparison, type MetadataFilter, type MmrConfig, Neo4jGraphProvider, NoopTelemetryProvider, type OCRProvider, type OcrResult, ParagraphChunkingStrategy, type PersistedRecallExplainPayload, type PostgresDatabaseConfig, PostgresStorageProvider, ProviderNotConfiguredError, type RecallExplainResponse, type RecallExplanationHit, type RecallOptions, type RecallResult, type RememberAction, type RememberOptions, type RememberResult, type RerankDocument, type RerankHit, type RerankerProvider, type RetrievalConfig, SDK_VERSION, SentenceChunkingStrategy, SqliteCheckpointProvider, type SqliteDatabaseConfig, SqliteDatabaseProvider, SqliteEventDatabase, SqliteGraphProvider, SqliteStorageProvider, SqliteTelemetryProvider, type StageSpan, type StatsResult, type StorageConfig, StorageLockedError, type StorageProvider, type StorageProviderName, type SubscribableEvent, type SubscribeFilter, type TelemetryConfig, TelemetryEmitter, type TelemetryEvent, type TelemetryEventInput, type TelemetryLogLevel, type TelemetryOperation, type TelemetryProvider, type TelemetryQuery, type TelemetryQueryResult, type TelemetryStatus, type Unsubscribe, ValidationError, type VisionProvider, type VisionResult, Wolbarg, WolbargError, WolbargLogger, type WolbargOptions, type WolbargOptionsWithLlm, type WolbargOptionsWithoutLlm, bgeReranker, bm25, cohereReranker, createChunkingStrategy, createCompressionProvider, createDatabaseProvider, createEmbeddingProvider, createLlmProvider, createStorageProvider, createTelemetryProvider, wolbarg as createWolbarg, crossEncoder, geminiEmbedding, geminiVision, jinaReranker, lmStudioEmbedding, meta, neo4jGraph, ollamaEmbedding, ollamaLlm, openRouterEmbedding, openRouterLlm, openaiCompatibleEmbedding, openaiCompatibleLlm, openaiEmbedding, openaiLlm, openaiReranker, openaiVision, postgres, postgresConfig, runBenchmark, sqlite, sqliteCheckpoint, sqliteConfig, sqliteGraph, sqliteTelemetry, summarizeBenchmark, tesseract, togetherEmbedding, vllmEmbedding, wolbarg$1 as wolbarg, wrapOperationError };