@wiscale/velesdb-sdk 1.15.0 → 1.18.0

package/dist/index.d.mts

@@ -470,14 +470,16 @@ interface SearchResult {
  * @packageDocumentation
  */
 
+/** Graph node/edge ID. Large u64 IDs may be returned as strings to preserve precision. */
+type GraphNodeId = number | string;
 /** Graph edge representing a relationship between nodes */
 interface GraphEdge {
     /** Unique edge ID */
-    id: number;
+    id: GraphNodeId;
     /** Source node ID */
-    source: number;
+    source: GraphNodeId;
     /** Target node ID */
-    target: number;
+    target: GraphNodeId;
     /** Edge label (relationship type, e.g., "KNOWS", "FOLLOWS") */
     label: string;
     /** Edge properties */
@@ -504,7 +506,7 @@ interface GetEdgesOptions {
 /** Request for graph traversal (EPIC-016 US-050) */
 interface TraverseRequest {
     /** Source node ID to start traversal from */
-    source: number;
+    source: GraphNodeId;
     /** Traversal strategy: 'bfs' or 'dfs' */
     strategy?: 'bfs' | 'dfs';
     /** Maximum traversal depth */
@@ -519,7 +521,7 @@ interface TraverseRequest {
 /** Request for multi-source parallel BFS traversal */
 interface TraverseParallelRequest {
     /** Source node IDs to start traversal from */
-    sources: number[];
+    sources: GraphNodeId[];
     /** Maximum traversal depth */
     maxDepth?: number;
     /** Maximum number of results to return */
@@ -530,11 +532,11 @@ interface TraverseParallelRequest {
 /** A single traversal result item */
 interface TraversalResultItem {
     /** Target node ID reached */
-    targetId: number;
+    targetId: GraphNodeId;
     /** Depth of traversal (number of hops from source) */
     depth: number;
     /** Path taken (list of edge IDs) */
-    path: number[];
+    path: GraphNodeId[];
 }
 /** Statistics from traversal operation */
 interface TraversalStats {
@@ -607,6 +609,14 @@ interface ProceduralPattern {
     name: string;
     /** Ordered steps */
     steps: string[];
+    /**
+     * Embedding vector for the pattern.
+     *
+     * Required so that `matchProceduralPatterns` (a vector search) can
+     * recall the pattern — a point stored without a vector is invisible
+     * to similarity search.
+     */
+    embedding: number[];
     /** Optional metadata */
     metadata?: Record<string, unknown>;
 }
@@ -648,8 +658,8 @@ interface ColumnStatsDetail {
     name: string;
     nullCount: number;
     distinctCount: number;
-    minValue: unknown | null;
-    maxValue: unknown | null;
+    minValue: unknown;
+    maxValue: unknown;
     avgSizeBytes: number;
     histogramBuckets: number | null;
     histogramStale: boolean | null;
@@ -944,6 +954,7 @@ declare const WASM_CAPABILITIES: Readonly<CapabilityMap>;
  * aggregate, match query, graph node operations, and graph search.
  * @packageDocumentation
  */
+
 /** Result of `POST /collections/{name}/index/rebuild`. */
 interface RebuildIndexResponse {
     /** Informational message from the server. */
@@ -975,8 +986,8 @@ interface GuardRailsConfigResponse {
 }
 /** Options for `listNodes`. */
 interface ListNodesResponse {
-    /** Node IDs in insertion order. */
-    nodeIds: number[];
+    /** Node IDs in insertion order (string|number to preserve u64 precision). */
+    nodeIds: GraphNodeId[];
     /** Total count -- matches `nodeIds.length`. */
     count: number;
 }
@@ -990,7 +1001,7 @@ interface GetNodeEdgesOptions {
 /** Result of `GET /collections/{name}/graph/nodes/{id}/payload`. */
 interface NodePayloadResponse {
     /** Node ID. */
-    nodeId: number;
+    nodeId: GraphNodeId;
     /** Stored payload -- `null` if no payload has been set. */
     payload: Record<string, unknown> | null;
 }
@@ -1004,7 +1015,7 @@ interface GraphSearchRequest {
 /** Single result item from `graphSearch`. */
 interface GraphSearchResultItem {
     /** Node ID. */
-    id: number;
+    id: GraphNodeId;
     /** Similarity score. */
     score: number;
     /** Optional node payload (mirror of `GraphSearchResultItem.payload`). */
@@ -1044,7 +1055,7 @@ interface MatchQueryResponse {
 /** Single row of a `MatchQueryResponse`. */
 interface MatchQueryResultItem {
     /** Variable-binding map from the MATCH pattern. */
-    bindings: Record<string, number>;
+    bindings: Record<string, GraphNodeId>;
     /** Similarity score, present only when `similarity()` was used. */
     score?: number;
     /** Traversal depth reached to produce this row. */
@@ -1228,12 +1239,12 @@ interface IVelesDBBackend {
     storeSemanticFact(collection: string, entry: SemanticEntry): Promise<void>;
     /** Search semantic memory */
     searchSemanticMemory(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Record an episodic event */
-    recordEpisodicEvent(collection: string, event: EpisodicEvent): Promise<void>;
+    /** Record an episodic event. Returns the generated point ID. */
+    recordEpisodicEvent(collection: string, event: EpisodicEvent): Promise<number>;
     /** Recall episodic events */
     recallEpisodicEvents(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Store a procedural pattern */
-    storeProceduralPattern(collection: string, pattern: ProceduralPattern): Promise<void>;
+    /** Store a procedural pattern. Returns the generated point ID. */
+    storeProceduralPattern(collection: string, pattern: ProceduralPattern): Promise<number>;
     /** Match procedural patterns */
     matchProceduralPatterns(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
     /** Rebuild a collection's HNSW index (compacts tombstones). */
@@ -1302,20 +1313,31 @@ declare class AgentMemoryClient {
     private readonly backend;
     private readonly config?;
     constructor(backend: IVelesDBBackend, config?: AgentMemoryConfig | undefined);
-    /** Configured embedding dimension (default: 384) */
+    /**
+     * Advisory embedding dimension passed at construction (default: 384).
+     *
+     * This value is **not** enforced and does not create or size any
+     * collection — the dimension that actually governs storage and search
+     * is the one fixed when the collection was created
+     * (`db.createCollection(name, { dimension, metric: 'cosine' })`).
+     * Embeddings you pass to `storeFact` / `recordEvent` / `learnProcedure`
+     * must match that collection dimension.
+     */
     get dimension(): number;
     /** Store a semantic fact */
     storeFact(collection: string, entry: SemanticEntry): Promise<void>;
     /** Search semantic memory */
     searchFacts(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Record an episodic event */
-    recordEvent(collection: string, event: EpisodicEvent): Promise<void>;
+    /** Record an episodic event. Returns the generated point ID. */
+    recordEvent(collection: string, event: EpisodicEvent): Promise<number>;
     /** Recall episodic events */
     recallEvents(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Store a procedural pattern */
-    learnProcedure(collection: string, pattern: ProceduralPattern): Promise<void>;
+    /** Store a procedural pattern. Returns the generated point ID. */
+    learnProcedure(collection: string, pattern: ProceduralPattern): Promise<number>;
     /** Match procedural patterns */
     recallProcedures(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
+    /** Delete a memory entry (fact, event, or procedure) by its point ID. */
+    deleteMemory(collection: string, id: number): Promise<boolean>;
 }
 
 /**
@@ -1492,9 +1514,9 @@ declare class WasmBackend implements IVelesDBBackend {
     }>>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<void>;
+    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<number>;
     recallEpisodicEvents(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<void>;
+    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<number>;
     matchProceduralPatterns(c: string, e: number[], k?: number): Promise<SearchResult[]>;
     rebuildIndex(c: string): Promise<RebuildIndexResponse>;
     getGuardrails(): Promise<GuardRailsConfigResponse>;
@@ -1593,9 +1615,9 @@ declare class RestBackend implements IVelesDBBackend {
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<void>;
+    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<number>;
     recallEpisodicEvents(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<void>;
+    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<number>;
     matchProceduralPatterns(c: string, e: number[], k?: number): Promise<SearchResult[]>;
 }
 
@@ -2046,4 +2068,45 @@ type VelesErrorCode = (typeof VELES_ERROR_CODES)[number];
  */
 declare function parseVelesError(code: string | null | undefined, message: string): VelesError;
 
-export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type EpisodicEvent, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };
+/**
+ * Optional embedding helpers for the VelesDB TypeScript SDK.
+ *
+ * A thin {@link Embedder} interface plus an adapter for OpenAI-compatible
+ * endpoints. The adapter uses the global `fetch` API (Node ≥ 18, browsers,
+ * Deno) and has no additional runtime dependencies.
+ *
+ * @example
+ * ```typescript
+ * import { VelesDB, OpenAIEmbedder } from '@wiscale/velesdb-sdk';
+ *
+ * const embedder = new OpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });
+ * const db = new VelesDB({ backend: 'wasm' });
+ * await db.init();
+ * await db.createCollection('docs', { dimension: embedder.dimension ?? 1536 });
+ * const vectors = await embedder.embed(['hello world', 'vector search']);
+ * ```
+ */
+interface Embedder {
+    /** Embedding dimension, or `0` if not yet known (determined after first call). */
+    readonly dimension: number;
+    embed(texts: string[]): Promise<number[][]>;
+}
+interface OpenAIEmbedderOptions {
+    model?: string;
+    apiKey: string;
+    /** Override the base URL for Azure OpenAI, vLLM, or any compatible endpoint. */
+    baseUrl?: string;
+    /** Request a specific output dimension (requires a model that supports it). */
+    dimensions?: number;
+}
+declare class OpenAIEmbedder implements Embedder {
+    private readonly model;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly requestedDimensions;
+    dimension: number;
+    constructor(options: OpenAIEmbedderOptions);
+    embed(texts: string[]): Promise<number[][]>;
+}
+
+export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };

package/dist/index.d.ts

@@ -470,14 +470,16 @@ interface SearchResult {
  * @packageDocumentation
  */
 
+/** Graph node/edge ID. Large u64 IDs may be returned as strings to preserve precision. */
+type GraphNodeId = number | string;
 /** Graph edge representing a relationship between nodes */
 interface GraphEdge {
     /** Unique edge ID */
-    id: number;
+    id: GraphNodeId;
     /** Source node ID */
-    source: number;
+    source: GraphNodeId;
     /** Target node ID */
-    target: number;
+    target: GraphNodeId;
     /** Edge label (relationship type, e.g., "KNOWS", "FOLLOWS") */
     label: string;
     /** Edge properties */
@@ -504,7 +506,7 @@ interface GetEdgesOptions {
 /** Request for graph traversal (EPIC-016 US-050) */
 interface TraverseRequest {
     /** Source node ID to start traversal from */
-    source: number;
+    source: GraphNodeId;
     /** Traversal strategy: 'bfs' or 'dfs' */
     strategy?: 'bfs' | 'dfs';
     /** Maximum traversal depth */
@@ -519,7 +521,7 @@ interface TraverseRequest {
 /** Request for multi-source parallel BFS traversal */
 interface TraverseParallelRequest {
     /** Source node IDs to start traversal from */
-    sources: number[];
+    sources: GraphNodeId[];
     /** Maximum traversal depth */
     maxDepth?: number;
     /** Maximum number of results to return */
@@ -530,11 +532,11 @@ interface TraverseParallelRequest {
 /** A single traversal result item */
 interface TraversalResultItem {
     /** Target node ID reached */
-    targetId: number;
+    targetId: GraphNodeId;
     /** Depth of traversal (number of hops from source) */
     depth: number;
     /** Path taken (list of edge IDs) */
-    path: number[];
+    path: GraphNodeId[];
 }
 /** Statistics from traversal operation */
 interface TraversalStats {
@@ -607,6 +609,14 @@ interface ProceduralPattern {
     name: string;
     /** Ordered steps */
     steps: string[];
+    /**
+     * Embedding vector for the pattern.
+     *
+     * Required so that `matchProceduralPatterns` (a vector search) can
+     * recall the pattern — a point stored without a vector is invisible
+     * to similarity search.
+     */
+    embedding: number[];
     /** Optional metadata */
     metadata?: Record<string, unknown>;
 }
@@ -648,8 +658,8 @@ interface ColumnStatsDetail {
     name: string;
     nullCount: number;
     distinctCount: number;
-    minValue: unknown | null;
-    maxValue: unknown | null;
+    minValue: unknown;
+    maxValue: unknown;
     avgSizeBytes: number;
     histogramBuckets: number | null;
     histogramStale: boolean | null;
@@ -944,6 +954,7 @@ declare const WASM_CAPABILITIES: Readonly<CapabilityMap>;
  * aggregate, match query, graph node operations, and graph search.
  * @packageDocumentation
  */
+
 /** Result of `POST /collections/{name}/index/rebuild`. */
 interface RebuildIndexResponse {
     /** Informational message from the server. */
@@ -975,8 +986,8 @@ interface GuardRailsConfigResponse {
 }
 /** Options for `listNodes`. */
 interface ListNodesResponse {
-    /** Node IDs in insertion order. */
-    nodeIds: number[];
+    /** Node IDs in insertion order (string|number to preserve u64 precision). */
+    nodeIds: GraphNodeId[];
     /** Total count -- matches `nodeIds.length`. */
     count: number;
 }
@@ -990,7 +1001,7 @@ interface GetNodeEdgesOptions {
 /** Result of `GET /collections/{name}/graph/nodes/{id}/payload`. */
 interface NodePayloadResponse {
     /** Node ID. */
-    nodeId: number;
+    nodeId: GraphNodeId;
     /** Stored payload -- `null` if no payload has been set. */
     payload: Record<string, unknown> | null;
 }
@@ -1004,7 +1015,7 @@ interface GraphSearchRequest {
 /** Single result item from `graphSearch`. */
 interface GraphSearchResultItem {
     /** Node ID. */
-    id: number;
+    id: GraphNodeId;
     /** Similarity score. */
     score: number;
     /** Optional node payload (mirror of `GraphSearchResultItem.payload`). */
@@ -1044,7 +1055,7 @@ interface MatchQueryResponse {
 /** Single row of a `MatchQueryResponse`. */
 interface MatchQueryResultItem {
     /** Variable-binding map from the MATCH pattern. */
-    bindings: Record<string, number>;
+    bindings: Record<string, GraphNodeId>;
     /** Similarity score, present only when `similarity()` was used. */
     score?: number;
     /** Traversal depth reached to produce this row. */
@@ -1228,12 +1239,12 @@ interface IVelesDBBackend {
     storeSemanticFact(collection: string, entry: SemanticEntry): Promise<void>;
     /** Search semantic memory */
     searchSemanticMemory(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Record an episodic event */
-    recordEpisodicEvent(collection: string, event: EpisodicEvent): Promise<void>;
+    /** Record an episodic event. Returns the generated point ID. */
+    recordEpisodicEvent(collection: string, event: EpisodicEvent): Promise<number>;
     /** Recall episodic events */
     recallEpisodicEvents(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Store a procedural pattern */
-    storeProceduralPattern(collection: string, pattern: ProceduralPattern): Promise<void>;
+    /** Store a procedural pattern. Returns the generated point ID. */
+    storeProceduralPattern(collection: string, pattern: ProceduralPattern): Promise<number>;
     /** Match procedural patterns */
     matchProceduralPatterns(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
     /** Rebuild a collection's HNSW index (compacts tombstones). */
@@ -1302,20 +1313,31 @@ declare class AgentMemoryClient {
     private readonly backend;
     private readonly config?;
     constructor(backend: IVelesDBBackend, config?: AgentMemoryConfig | undefined);
-    /** Configured embedding dimension (default: 384) */
+    /**
+     * Advisory embedding dimension passed at construction (default: 384).
+     *
+     * This value is **not** enforced and does not create or size any
+     * collection — the dimension that actually governs storage and search
+     * is the one fixed when the collection was created
+     * (`db.createCollection(name, { dimension, metric: 'cosine' })`).
+     * Embeddings you pass to `storeFact` / `recordEvent` / `learnProcedure`
+     * must match that collection dimension.
+     */
     get dimension(): number;
     /** Store a semantic fact */
     storeFact(collection: string, entry: SemanticEntry): Promise<void>;
     /** Search semantic memory */
     searchFacts(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Record an episodic event */
-    recordEvent(collection: string, event: EpisodicEvent): Promise<void>;
+    /** Record an episodic event. Returns the generated point ID. */
+    recordEvent(collection: string, event: EpisodicEvent): Promise<number>;
     /** Recall episodic events */
     recallEvents(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
-    /** Store a procedural pattern */
-    learnProcedure(collection: string, pattern: ProceduralPattern): Promise<void>;
+    /** Store a procedural pattern. Returns the generated point ID. */
+    learnProcedure(collection: string, pattern: ProceduralPattern): Promise<number>;
     /** Match procedural patterns */
     recallProcedures(collection: string, embedding: number[], k?: number): Promise<SearchResult[]>;
+    /** Delete a memory entry (fact, event, or procedure) by its point ID. */
+    deleteMemory(collection: string, id: number): Promise<boolean>;
 }
 
 /**
@@ -1492,9 +1514,9 @@ declare class WasmBackend implements IVelesDBBackend {
     }>>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<void>;
+    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<number>;
     recallEpisodicEvents(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<void>;
+    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<number>;
     matchProceduralPatterns(c: string, e: number[], k?: number): Promise<SearchResult[]>;
     rebuildIndex(c: string): Promise<RebuildIndexResponse>;
     getGuardrails(): Promise<GuardRailsConfigResponse>;
@@ -1593,9 +1615,9 @@ declare class RestBackend implements IVelesDBBackend {
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<void>;
+    recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<number>;
     recallEpisodicEvents(c: string, e: number[], k?: number): Promise<SearchResult[]>;
-    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<void>;
+    storeProceduralPattern(c: string, p: ProceduralPattern): Promise<number>;
     matchProceduralPatterns(c: string, e: number[], k?: number): Promise<SearchResult[]>;
 }
 
@@ -2046,4 +2068,45 @@ type VelesErrorCode = (typeof VELES_ERROR_CODES)[number];
  */
 declare function parseVelesError(code: string | null | undefined, message: string): VelesError;
 
-export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type EpisodicEvent, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };
+/**
+ * Optional embedding helpers for the VelesDB TypeScript SDK.
+ *
+ * A thin {@link Embedder} interface plus an adapter for OpenAI-compatible
+ * endpoints. The adapter uses the global `fetch` API (Node ≥ 18, browsers,
+ * Deno) and has no additional runtime dependencies.
+ *
+ * @example
+ * ```typescript
+ * import { VelesDB, OpenAIEmbedder } from '@wiscale/velesdb-sdk';
+ *
+ * const embedder = new OpenAIEmbedder({ apiKey: process.env.OPENAI_API_KEY! });
+ * const db = new VelesDB({ backend: 'wasm' });
+ * await db.init();
+ * await db.createCollection('docs', { dimension: embedder.dimension ?? 1536 });
+ * const vectors = await embedder.embed(['hello world', 'vector search']);
+ * ```
+ */
+interface Embedder {
+    /** Embedding dimension, or `0` if not yet known (determined after first call). */
+    readonly dimension: number;
+    embed(texts: string[]): Promise<number[][]>;
+}
+interface OpenAIEmbedderOptions {
+    model?: string;
+    apiKey: string;
+    /** Override the base URL for Azure OpenAI, vLLM, or any compatible endpoint. */
+    baseUrl?: string;
+    /** Request a specific output dimension (requires a model that supports it). */
+    dimensions?: number;
+}
+declare class OpenAIEmbedder implements Embedder {
+    private readonly model;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly requestedDimensions;
+    dimension: number;
+    constructor(options: OpenAIEmbedderOptions);
+    embed(texts: string[]): Promise<number[][]>;
+}
+
+export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };