agentdb 3.0.0-alpha.9 → 3.0.0

package/dist/src/backends/rvf/FilterBuilder.d.ts

@@ -0,0 +1,136 @@
+/**
+ * FilterBuilder - Constructs RvfFilterExpr objects from a simple predicate DSL.
+ *
+ * Translates field-name-based predicates into field-ID-based RvfFilterExpr
+ * objects that the @ruvector/rvf SDK expects.
+ *
+ * Usage:
+ *   const filter = new FilterBuilder()
+ *     .eq('status', 'active')
+ *     .gt('score', 0.5)
+ *     .build();    // => RvfFilterExpr (AND of all predicates)
+ *
+ *   // Or build directly:
+ *   FilterBuilder.buildFilter({ status: 'active', score: { $gt: 0.5 } });
+ */
+/** Re-export filter types from @ruvector/rvf for convenience */
+export type RvfFilterValue = number | string | boolean;
+export type RvfFilterExpr = {
+    op: 'eq';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'ne';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'lt';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'le';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'gt';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'ge';
+    fieldId: number;
+    value: RvfFilterValue;
+} | {
+    op: 'in';
+    fieldId: number;
+    values: RvfFilterValue[];
+} | {
+    op: 'range';
+    fieldId: number;
+    low: RvfFilterValue;
+    high: RvfFilterValue;
+} | {
+    op: 'and';
+    exprs: RvfFilterExpr[];
+} | {
+    op: 'or';
+    exprs: RvfFilterExpr[];
+} | {
+    op: 'not';
+    expr: RvfFilterExpr;
+};
+/**
+ * Simple predicate DSL value: either a plain value (eq), or an operator object.
+ *
+ * Examples:
+ *   'active'          => eq('field', 'active')
+ *   { $gt: 5 }        => gt('field', 5)
+ *   { $in: [1,2,3] }  => in('field', [1,2,3])
+ *   { $range: [0,10]} => range('field', 0, 10)
+ *   { $ne: false }    => ne('field', false)
+ */
+export type PredicateValue = RvfFilterValue | {
+    $eq?: RvfFilterValue;
+} | {
+    $ne?: RvfFilterValue;
+} | {
+    $lt?: RvfFilterValue;
+} | {
+    $le?: RvfFilterValue;
+} | {
+    $gt?: RvfFilterValue;
+} | {
+    $ge?: RvfFilterValue;
+} | {
+    $in?: RvfFilterValue[];
+} | {
+    $range?: [RvfFilterValue, RvfFilterValue];
+};
+/** Predicate DSL: field name => predicate value */
+export type FilterPredicate = Record<string, PredicateValue>;
+/**
+ * Maps field names to numeric IDs for RvfFilterExpr.
+ *
+ * Field IDs are assigned sequentially starting from 0.
+ * The mapping is stable within a single FilterBuilder instance.
+ */
+export declare class FilterBuilder {
+    private fieldMap;
+    private nextFieldId;
+    private exprs;
+    /** Get or assign a numeric field ID for a field name */
+    fieldId(name: string): number;
+    /** Get the field name to ID mapping */
+    getFieldMap(): ReadonlyMap<string, number>;
+    /** Add an equality predicate */
+    eq(field: string, value: RvfFilterValue): this;
+    /** Add a not-equal predicate */
+    ne(field: string, value: RvfFilterValue): this;
+    /** Add a less-than predicate */
+    lt(field: string, value: RvfFilterValue): this;
+    /** Add a less-than-or-equal predicate */
+    le(field: string, value: RvfFilterValue): this;
+    /** Add a greater-than predicate */
+    gt(field: string, value: RvfFilterValue): this;
+    /** Add a greater-than-or-equal predicate */
+    ge(field: string, value: RvfFilterValue): this;
+    /** Add an IN predicate (value in set) */
+    in(field: string, values: RvfFilterValue[]): this;
+    /** Add a range predicate (low <= value <= high) */
+    range(field: string, low: RvfFilterValue, high: RvfFilterValue): this;
+    /** Add a NOT wrapper around an expression */
+    not(expr: RvfFilterExpr): this;
+    /** Build the final filter expression (AND of all added predicates) */
+    build(): RvfFilterExpr | null;
+    /** Reset the builder state */
+    reset(): this;
+    /**
+     * Build an RvfFilterExpr from a simple predicate DSL object.
+     *
+     * Example:
+     *   buildFilter({ status: 'active', score: { $gt: 0.5 } })
+     *   => AND(eq(status, 'active'), gt(score, 0.5))
+     */
+    static buildFilter(predicates: FilterPredicate): RvfFilterExpr | null;
+    private addExpr;
+}
+//# sourceMappingURL=FilterBuilder.d.ts.map

package/dist/src/backends/rvf/FilterBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterBuilder.d.ts","sourceRoot":"","sources":["../../../../src/backends/rvf/FilterBuilder.ts"],"names":[],"mappings":"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"}

package/dist/src/backends/rvf/FilterBuilder.js

@@ -0,0 +1,157 @@
+/**
+ * FilterBuilder - Constructs RvfFilterExpr objects from a simple predicate DSL.
+ *
+ * Translates field-name-based predicates into field-ID-based RvfFilterExpr
+ * objects that the @ruvector/rvf SDK expects.
+ *
+ * Usage:
+ *   const filter = new FilterBuilder()
+ *     .eq('status', 'active')
+ *     .gt('score', 0.5)
+ *     .build();    // => RvfFilterExpr (AND of all predicates)
+ *
+ *   // Or build directly:
+ *   FilterBuilder.buildFilter({ status: 'active', score: { $gt: 0.5 } });
+ */
+/** Maximum number of filter expressions allowed (safety bound) */
+const MAX_FILTER_EXPRS = 64;
+/**
+ * Maps field names to numeric IDs for RvfFilterExpr.
+ *
+ * Field IDs are assigned sequentially starting from 0.
+ * The mapping is stable within a single FilterBuilder instance.
+ */
+export class FilterBuilder {
+    fieldMap = new Map();
+    nextFieldId = 0;
+    exprs = [];
+    /** Get or assign a numeric field ID for a field name */
+    fieldId(name) {
+        let id = this.fieldMap.get(name);
+        if (id === undefined) {
+            id = this.nextFieldId++;
+            this.fieldMap.set(name, id);
+        }
+        return id;
+    }
+    /** Get the field name to ID mapping */
+    getFieldMap() {
+        return this.fieldMap;
+    }
+    /** Add an equality predicate */
+    eq(field, value) {
+        this.addExpr({ op: 'eq', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add a not-equal predicate */
+    ne(field, value) {
+        this.addExpr({ op: 'ne', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add a less-than predicate */
+    lt(field, value) {
+        this.addExpr({ op: 'lt', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add a less-than-or-equal predicate */
+    le(field, value) {
+        this.addExpr({ op: 'le', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add a greater-than predicate */
+    gt(field, value) {
+        this.addExpr({ op: 'gt', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add a greater-than-or-equal predicate */
+    ge(field, value) {
+        this.addExpr({ op: 'ge', fieldId: this.fieldId(field), value });
+        return this;
+    }
+    /** Add an IN predicate (value in set) */
+    in(field, values) {
+        this.addExpr({ op: 'in', fieldId: this.fieldId(field), values });
+        return this;
+    }
+    /** Add a range predicate (low <= value <= high) */
+    range(field, low, high) {
+        this.addExpr({ op: 'range', fieldId: this.fieldId(field), low, high });
+        return this;
+    }
+    /** Add a NOT wrapper around an expression */
+    not(expr) {
+        this.addExpr({ op: 'not', expr });
+        return this;
+    }
+    /** Build the final filter expression (AND of all added predicates) */
+    build() {
+        if (this.exprs.length === 0)
+            return null;
+        if (this.exprs.length === 1)
+            return this.exprs[0];
+        return { op: 'and', exprs: [...this.exprs] };
+    }
+    /** Reset the builder state */
+    reset() {
+        this.exprs = [];
+        return this;
+    }
+    /**
+     * Build an RvfFilterExpr from a simple predicate DSL object.
+     *
+     * Example:
+     *   buildFilter({ status: 'active', score: { $gt: 0.5 } })
+     *   => AND(eq(status, 'active'), gt(score, 0.5))
+     */
+    static buildFilter(predicates) {
+        if (!predicates || typeof predicates !== 'object')
+            return null;
+        const keys = Object.keys(predicates);
+        if (keys.length === 0)
+            return null;
+        const builder = new FilterBuilder();
+        for (const field of keys) {
+            if (builder.exprs.length >= MAX_FILTER_EXPRS) {
+                throw new Error(`Filter expression count exceeds maximum of ${MAX_FILTER_EXPRS}`);
+            }
+            const val = predicates[field];
+            if (val === null || val === undefined)
+                continue;
+            // Plain value => eq
+            if (typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean') {
+                builder.eq(field, val);
+                continue;
+            }
+            // Operator object
+            if (typeof val === 'object') {
+                const obj = val;
+                if ('$eq' in obj)
+                    builder.eq(field, obj.$eq);
+                else if ('$ne' in obj)
+                    builder.ne(field, obj.$ne);
+                else if ('$lt' in obj)
+                    builder.lt(field, obj.$lt);
+                else if ('$le' in obj)
+                    builder.le(field, obj.$le);
+                else if ('$gt' in obj)
+                    builder.gt(field, obj.$gt);
+                else if ('$ge' in obj)
+                    builder.ge(field, obj.$ge);
+                else if ('$in' in obj)
+                    builder.in(field, obj.$in);
+                else if ('$range' in obj) {
+                    const range = obj.$range;
+                    builder.range(field, range[0], range[1]);
+                }
+            }
+        }
+        return builder.build();
+    }
+    addExpr(expr) {
+        if (this.exprs.length >= MAX_FILTER_EXPRS) {
+            throw new Error(`Filter expression count exceeds maximum of ${MAX_FILTER_EXPRS}`);
+        }
+        this.exprs.push(expr);
+    }
+}
+//# sourceMappingURL=FilterBuilder.js.map

package/dist/src/backends/rvf/FilterBuilder.js.map

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

package/dist/src/backends/rvf/NativeAccelerator.d.ts

@@ -0,0 +1,158 @@
+/**
+ * NativeAccelerator - ADR-007 Phase 1 Capability Bridge
+ *
+ * Lazy-loads @ruvector APIs and provides accelerated alternatives to JS
+ * implementations. All imports are lazy/optional with JS fallbacks.
+ */
+import { WasmStoreBridge } from './WasmStoreBridge.js';
+export { WasmStoreBridge } from './WasmStoreBridge.js';
+export type { WasmStoreQueryResult } from './WasmStoreBridge.js';
+export interface AcceleratorStats {
+    simdAvailable: boolean;
+    simdActivationsAvailable: boolean;
+    wasmVerifyAvailable: boolean;
+    wasmStoreAvailable: boolean;
+    wasmQuantizationAvailable: boolean;
+    nativeInfoNceAvailable: boolean;
+    nativeAdamWAvailable: boolean;
+    nativeTensorCompressAvailable: boolean;
+    routerPersistAvailable: boolean;
+    sonaExtendedAvailable: boolean;
+    capabilities: string[];
+}
+export interface WitnessVerifyResult {
+    valid: boolean;
+    entryCount: number;
+}
+export interface SegmentVerifyResult {
+    valid: boolean;
+    crc: number;
+}
+export declare class NativeAccelerator {
+    private _simd;
+    private _witnessVerify;
+    private _witnessCount;
+    private _verifyHeader;
+    private _crc32c;
+    private _infoNceLoss;
+    private _adamWOptimizer;
+    private _tensorCompress;
+    private _routerSave;
+    private _routerLoad;
+    private _sonaFlush;
+    private _sonaContext;
+    private _sonaBaseLora;
+    private _graphTx;
+    private _graphBatchInsert;
+    private _graphCypher;
+    private _coreBatchInsert;
+    private _ewcManager;
+    private _sqLoad;
+    private _dequantI8;
+    private _pqLoadCodebook;
+    private _pqDistances;
+    private _wasmStore;
+    private _initialized;
+    initialize(): Promise<AcceleratorStats>;
+    get simdAvailable(): boolean;
+    cosineSimilarity(a: Float32Array, b: Float32Array): number;
+    dotProduct(a: Float32Array, b: Float32Array): number;
+    l2Distance(a: Float32Array, b: Float32Array): number;
+    hammingDistance(a: Uint8Array, b: Uint8Array): number;
+    get simdActivationsAvailable(): boolean;
+    matvec(matrix: number[][], vector: number[]): number[];
+    softmax(input: number[]): number[];
+    relu(input: number[]): number[];
+    gelu(input: number[]): number[];
+    sigmoid(input: number[]): number[];
+    layerNorm(input: number[], eps?: number): number[];
+    add(a: number[], b: number[]): number[];
+    mul(a: number[], b: number[]): number[];
+    scale(a: number[], scalar: number): number[];
+    normalizeVec(a: number[]): number[];
+    get wasmQuantizationAvailable(): boolean;
+    loadSqParams(params: Uint8Array, dim: number): boolean;
+    dequantI8(src: Uint8Array, dst: Float32Array, count: number): boolean;
+    loadPqCodebook(codebook: Uint8Array, m: number, k: number): boolean;
+    pqDistances(codes: Uint8Array, count: number): Float32Array | null;
+    get wasmStoreAvailable(): boolean;
+    get wasmStore(): WasmStoreBridge;
+    wasmStoreCreate(dim: number, metric: number): number | null;
+    wasmStoreIngest(handle: number, vecs: Float32Array, ids: number[], count: number): number;
+    wasmStoreQuery(handle: number, query: Float32Array, k: number, metric: number): {
+        id: number;
+        distance: number;
+    }[] | null;
+    wasmStoreExport(handle: number): Uint8Array | null;
+    wasmStoreClose(handle: number): boolean;
+    get wasmVerifyAvailable(): boolean;
+    verifyWitnessChain(chain: Uint8Array): WitnessVerifyResult;
+    verifySegmentHeader(data: Uint8Array): SegmentVerifyResult;
+    get nativeInfoNceAvailable(): boolean;
+    infoNceLoss(anchor: Float32Array, positive: Float32Array, negatives: Float32Array[], temperature: number): number;
+    get nativeAdamWAvailable(): boolean;
+    adamWStep(params: Float32Array, grads: Float32Array, m: Float32Array, v: Float32Array, step: number, lr: number, wd: number): void;
+    get nativeTensorCompressAvailable(): boolean;
+    /**
+     * Compress with @ruvector/gnn at a numeric level (see TENSOR_LEVELS).
+     * Returns the native compressed JSON as UTF-8 bytes, or null when the
+     * level is not delegated or the package is unavailable.
+     */
+    tensorCompress(vec: Float32Array, level: number): Uint8Array | null;
+    tensorDecompress(compressed: Uint8Array, dim: number): Float32Array | null;
+    /** No native batch API exists; compresses each vector in turn. */
+    tensorBatchCompress(vecs: Float32Array[], level: number): Uint8Array[] | null;
+    get routerPersistAvailable(): boolean;
+    routerSave(router: any, path: string): Promise<boolean>;
+    /** Load a saved @ruvector/router SemanticRouter (load() is an instance method). */
+    routerLoad(path: string, config?: {
+        dimension: number;
+    }): Promise<any | null>;
+    get sonaExtendedAvailable(): boolean;
+    sonaAddContext(engine: any, trajectoryId: number, context: Record<string, unknown>): boolean;
+    sonaFlush(engine: any): boolean;
+    sonaApplyBaseLora(engine: any, loraData: Float32Array): boolean;
+    get graphTxAvailable(): boolean;
+    get graphBatchInsertAvailable(): boolean;
+    get graphCypherAvailable(): boolean;
+    /**
+     * Run fn inside a @ruvector/graph-node transaction
+     * (db.begin() -> txId, db.commit(txId) / db.rollback(txId)).
+     */
+    graphTransaction(db: any, fn: (tx: any) => void | Promise<void>): Promise<boolean>;
+    /** db.batchInsert() (async in @ruvector/graph-node) */
+    graphBatchInsertNodes(db: any, batch: unknown): Promise<boolean>;
+    /** Cypher via db.query() (async in @ruvector/graph-node; it takes no params) */
+    graphCypherQuery(db: any, query: string): Promise<any | null>;
+    get coreBatchInsertAvailable(): boolean;
+    /** VectorDb.insertBatch() (async in @ruvector/core; metadata is a JSON string there) */
+    coreBatchInsert(vectorDb: any, items: Array<{
+        id: string;
+        vector: Float32Array;
+        metadata?: Record<string, unknown>;
+    }>): Promise<boolean>;
+    get ewcManagerAvailable(): boolean;
+    ewcPenalty(params: Float32Array): number;
+    ewcUpdateFisher(params: Float32Array, importance: number): boolean;
+    getStats(): AcceleratorStats;
+    /**
+     * Which native features actually loaded, by name. Unlike getStats(), this
+     * covers every optional package probed in initialize().
+     */
+    capabilities(): Record<string, boolean>;
+    private loadSimd;
+    private loadWasmVerify;
+    private loadWasmQuantization;
+    private loadWasmStore;
+    private loadNativeAttention;
+    private loadNativeTensorCompress;
+    private loadRouterPersistence;
+    private loadSonaExtended;
+    private loadGraphCapabilities;
+    private loadCoreBatch;
+    private loadEwcManager;
+    private validateDims;
+}
+export declare function getAccelerator(): Promise<NativeAccelerator>;
+export declare function resetAccelerator(): void;
+//# sourceMappingURL=NativeAccelerator.d.ts.map

package/dist/src/backends/rvf/NativeAccelerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAccelerator.d.ts","sourceRoot":"","sources":["../../../../src/backends/rvf/NativeAccelerator.ts"],"names":[],"mappings":"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"}