@squadrules/mcp 4.8.6 → 5.0.0

package/dist/services/vector-store/lancedb/LanceExecutionTraceStore.js

@@ -0,0 +1,222 @@
+/**
+ * LanceDB implementation of the execution-trace port (`IExecutionTraceStore`).
+ *
+ * Traces carry no vectors, so this is the simplest backend slice: one row per
+ * execution, keyed by a stable id, with the whole `StoredExecutionTrace` kept as
+ * a JSON string. Reads that run before any write treat the absent table as empty
+ * rather than creating it, so a cold start never touches the disk for a read.
+ *
+ * The in-process per-execution mutation lock mirrors `ExecutionTraceStore` so
+ * concurrent forwards in this process serialize exactly as the Qdrant path does;
+ * cross-process durability comes from the SDK's MVCC plus `withCommitRetry`.
+ */
+import crypto from 'node:crypto';
+import { logger } from '../../../utils/structured-logger.js';
+import { openLanceConnection } from '../lancedb-connection.js';
+import { withCommitRetry } from '../commit-retry.js';
+const TRACE_TABLE = 'execution_traces';
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Stable primary key for an execution: reuse UUIDs, hash anything else to a UUID shape. */
+function toRowId(executionId) {
+    if (UUID_REGEX.test(executionId))
+        return executionId;
+    return crypto
+        .createHash('md5')
+        .update(executionId)
+        .digest('hex')
+        .replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, '$1-$2-$3-$4-$5');
+}
+/** Escape a string for a LanceQL equality literal. */
+function sqlLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+function adapterIdFromUri(adapterUri) {
+    return adapterUri.split('/').pop() ?? adapterUri;
+}
+export class LanceExecutionTraceStore {
+    connectionPromise = null;
+    mutationChains = new Map();
+    getConnection() {
+        if (!this.connectionPromise) {
+            this.connectionPromise = openLanceConnection();
+        }
+        return this.connectionPromise;
+    }
+    /** Open the trace table, or return null when nothing has been written yet. */
+    async openTableIfPresent() {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (!names.includes(TRACE_TABLE))
+            return null;
+        return connection.openTable(TRACE_TABLE);
+    }
+    /** Open-or-create the trace table from a first row (schema inferred from data). */
+    async ensureTableForWrite(firstRow) {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (names.includes(TRACE_TABLE)) {
+            return connection.openTable(TRACE_TABLE);
+        }
+        return connection.createTable(TRACE_TABLE, [firstRow], { mode: 'create' });
+    }
+    toRow(data) {
+        return {
+            id: toRowId(data.execution_id),
+            execution_id: data.execution_id,
+            adapter_id: data.adapter_id,
+            data: JSON.stringify(data)
+        };
+    }
+    async persist(data) {
+        const row = this.toRow(data);
+        const table = await this.ensureTableForWrite(row);
+        await withCommitRetry(() => table
+            .mergeInsert('id')
+            .whenMatchedUpdateAll()
+            .whenNotMatchedInsertAll()
+            .execute([row]), `trace:${data.execution_id}`);
+    }
+    async withMutationLock(key, task) {
+        const previous = this.mutationChains.get(key) ?? Promise.resolve();
+        let release;
+        const gate = new Promise((resolve) => {
+            release = resolve;
+        });
+        const next = previous.catch(() => undefined).then(() => gate);
+        this.mutationChains.set(key, next);
+        await previous.catch(() => undefined);
+        try {
+            return await task();
+        }
+        finally {
+            release?.();
+            if (this.mutationChains.get(key) === next) {
+                this.mutationChains.delete(key);
+            }
+        }
+    }
+    async startExecution(params) {
+        const { executionId, adapterId, adapterUri, activationQuery } = params;
+        await this.withMutationLock(`execution:${executionId}`, async () => {
+            const existing = await this.getExecution(executionId);
+            const resolvedActivationQuery = activationQuery ?? existing?.activation_query;
+            if (existing && existing.adapter_id !== adapterId) {
+                throw new Error(`Execution ${executionId} already belongs to adapter ${existing.adapter_id}; refusing to reassign it to ${adapterId}`);
+            }
+            const stored = {
+                execution_id: executionId,
+                adapter_id: adapterId,
+                adapter_uri: adapterUri,
+                ...(resolvedActivationQuery ? { activation_query: resolvedActivationQuery } : {}),
+                ...(existing?.reward ? { reward: existing.reward } : {}),
+                traces: existing?.traces ?? []
+            };
+            await this.persist(stored);
+        });
+    }
+    async appendTrace(trace) {
+        const adapterId = adapterIdFromUri(trace.adapter_uri);
+        await this.withMutationLock(`execution:${trace.execution_id}`, async () => {
+            const existing = await this.getExecution(trace.execution_id);
+            if (existing && existing.adapter_uri !== trace.adapter_uri) {
+                throw new Error(`Execution ${trace.execution_id} already points at ${existing.adapter_uri}; refusing to append a trace for ${trace.adapter_uri}`);
+            }
+            const stored = existing ?? {
+                execution_id: trace.execution_id,
+                adapter_id: adapterId,
+                adapter_uri: trace.adapter_uri,
+                ...(trace.activation_query ? { activation_query: trace.activation_query } : {}),
+                traces: []
+            };
+            const key = `${trace.layer_index}:${trace.layer_uri}`;
+            const tracesByKey = new Map(stored.traces.map((t) => [`${t.layer_index}:${t.layer_uri}`, t]));
+            tracesByKey.set(key, trace);
+            await this.persist({
+                ...stored,
+                traces: Array.from(tracesByKey.values()).sort((a, b) => a.layer_index - b.layer_index)
+            });
+        });
+    }
+    async setReward(executionId, reward) {
+        await this.withMutationLock(`execution:${executionId}`, async () => {
+            const existing = await this.getExecution(executionId);
+            if (!existing) {
+                logger.warn(`[LanceExecutionTraceStore] Skipping reward for missing execution ${executionId}`);
+                return;
+            }
+            await this.persist({ ...existing, reward });
+        });
+    }
+    async getExecution(executionId) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return null;
+        const rows = (await table
+            .query()
+            .where(`execution_id = ${sqlLiteral(executionId)}`)
+            .limit(1)
+            .toArray());
+        const row = rows[0];
+        if (!row)
+            return null;
+        try {
+            const parsed = JSON.parse(row.data);
+            parsed.traces = (parsed.traces ?? []).sort((a, b) => a.layer_index - b.layer_index);
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    async listAdapterExecutions(adapterId) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return [];
+        const rows = (await table
+            .query()
+            .where(`adapter_id = ${sqlLiteral(adapterId)}`)
+            .select(['execution_id'])
+            .toArray());
+        return rows.map((row) => row.execution_id).filter(Boolean);
+    }
+    async buildTrainingPairsForAdapter(adapterId, includeReward = true) {
+        const executionIds = await this.listAdapterExecutions(adapterId);
+        const pairs = [];
+        for (const executionId of executionIds) {
+            const execution = await this.getExecution(executionId);
+            if (!execution)
+                continue;
+            for (const trace of execution.traces) {
+                pairs.push({
+                    id: `${execution.execution_id}:${trace.layer_index}`,
+                    execution_id: execution.execution_id,
+                    adapter_uri: execution.adapter_uri,
+                    layer_uri: trace.layer_uri,
+                    layer_index: trace.layer_index,
+                    timestamp: trace.created_at,
+                    instruction: {
+                        tensor_in: trace.tensor_in,
+                        ...(execution.activation_query ? { activation_query: execution.activation_query } : {}),
+                        layer_instructions: trace.layer_instructions ?? ''
+                    },
+                    response: {
+                        ...(trace.tensor_out ? { tensor_out: trace.tensor_out } : {}),
+                        ...(trace.trace ? { trace: trace.trace } : {}),
+                        ...(trace.raw_solution !== undefined ? { raw_solution: trace.raw_solution } : {})
+                    },
+                    ...(includeReward && execution.reward ? { reward: execution.reward } : {})
+                });
+            }
+        }
+        return pairs.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+    async deleteExecution(executionId) {
+        await this.withMutationLock(`execution:${executionId}`, async () => {
+            const table = await this.openTableIfPresent();
+            if (!table)
+                return;
+            await withCommitRetry(() => table.delete(`id = ${sqlLiteral(toRowId(executionId))}`), `trace-delete:${executionId}`);
+        });
+    }
+}
+//# sourceMappingURL=LanceExecutionTraceStore.js.map

package/dist/services/vector-store/lancedb/LanceExecutionTraceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanceExecutionTraceStore.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/LanceExecutionTraceStore.ts"],"names":[],"mappings":"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"}

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Embedded LanceDB record store.
+ *
+ * Satisfies the `IVectorRecordStore` port and the read/admin surface the tools
+ * reach through `qdrantService`, so a single instance can back both injected
+ * slots on the embedded path (selected by `isQdrantConfigured`). Reads,
+ * read-modify-write mutations, semantic search (JS cosine) and the markdown-to-
+ * points writers (`storeAdapter` / `storeArtifact`) are all implemented, reusing
+ * the backend-neutral parse/build helpers so the store matches the Qdrant path's
+ * contract. Search-ranking and train parity are validated against the Qdrant
+ * integration suite when the store is wired and exercised end-to-end.
+ */
+import type { Memory } from '../../../types/memory.js';
+import type { IVectorRecordStore } from '../IVectorRecordStore.js';
+import type { ArtifactResolveOutcome, GetMemoryOptions, LayerRecord, MemorySearchResult, SlugResolveOutcome, StoreAdapterOptions } from '../types.js';
+import type { StoreArtifactOptions } from '../../memory/store-adapter.js';
+export declare class LanceVectorRecordStore implements IVectorRecordStore {
+    private readonly engine;
+    private readonly reader;
+    private readonly mutator;
+    private readonly search;
+    private readonly writer;
+    private connectionPromise;
+    private connection;
+    init(): Promise<void>;
+    checkHealth(_timeoutMs?: number): Promise<boolean>;
+    getMemory(memoryUuid: string, _options?: GetMemoryOptions): Promise<Memory | null>;
+    getAdapterLayers(adapterId: string, extraSpaceIds?: string[]): Promise<LayerRecord[]>;
+    findFirstStepMemoryUuidBySlug(slug: string): Promise<SlugResolveOutcome>;
+    findArtifactMemoryUuidBySlug(slug: string): Promise<ArtifactResolveOutcome>;
+    scrollSpace(spaceId: string, options?: {
+        paginate?: boolean;
+        limit?: number;
+    }): Promise<LayerRecord[]>;
+    listAdapterArtifacts(adapterId: string): Promise<LayerRecord[]>;
+    findProtocolFooterLayers(refineSlug: string, createSlug: string): Promise<LayerRecord[]>;
+    getStoredAdapterVersion(slug: string): Promise<string | undefined>;
+    updateMemory(memoryUuid: string, patch: Record<string, unknown>): Promise<void>;
+    deleteMemory(memoryUuid: string): Promise<void>;
+    setPayloadOnLayers(layerIds: string[], patch: Record<string, unknown>): Promise<void>;
+    deleteAppSpaceBySlug(slug: string): Promise<void>;
+    deleteAppSpaceByAdapterId(adapterId: string): Promise<void>;
+    retrieveById(uuid: string): Promise<{
+        uuid: string;
+        payload: any;
+    } | null>;
+    getMemoryByUUID(uuid: string): Promise<any | null>;
+    findProtocolSteps(protocolId: string): Promise<Array<{
+        uuid: string;
+        protocol: unknown;
+        payload: Record<string, unknown>;
+    }>>;
+    findProtocolStep(domain: string, type: string, task: string, step: number): Promise<{
+        uuid: string;
+        payload: Record<string, unknown>;
+    } | null>;
+    updateQualityMetrics(id: string, metrics: any): Promise<void>;
+    updateQualityMetadata(id: string, qualityMetadata: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    }): Promise<void>;
+    propagateRewardToAdapterHead(stepPointId: string, metricsUpdate: Record<string, unknown>): Promise<string | null>;
+    initialize(): Promise<void>;
+    createOrUpdateAlias(): Promise<void>;
+    getCollections(): Promise<Array<{
+        name?: string;
+    }>>;
+    dropCollection(): Promise<void>;
+    get collectionName(): string;
+    get qdrantUrl(): string;
+    get apiKey(): string | undefined;
+    searchMemories(query: string, limit: number, _collapse?: boolean): Promise<MemorySearchResult>;
+    searchAdapterTitlesBySimilarity(query: string, limit: number): Promise<MemorySearchResult>;
+    storeAdapter(docs: string[], llmModelId: string, options?: StoreAdapterOptions): Promise<Memory[]>;
+    storeArtifact(content: string, options: StoreArtifactOptions): Promise<Memory[]>;
+}
+//# sourceMappingURL=LanceVectorRecordStore.d.ts.map

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanceVectorRecordStore.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/LanceVectorRecordStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAS1E,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAC1E,OAAO,CAAC,iBAAiB,CAAyC;IAElE,OAAO,CAAC,UAAU;IAMZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIlF,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIrF,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIxE,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI3E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAItG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI/D,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIxF,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIlE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAC;IAI1E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAIlD,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAI5H,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAI9I,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5J,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAInD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAGK,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9F,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK1F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIlG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAGvF"}

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.js

@@ -0,0 +1,136 @@
+import { getQdrantCollection } from '../../../config.js';
+import { logger } from '../../../utils/structured-logger.js';
+import { openLanceConnection } from '../lancedb-connection.js';
+import { LanceRecordEngine } from './lance-records-engine.js';
+import { LanceRecordReader } from './lance-records-reads.js';
+import { LanceRecordMutator } from './lance-records-mutations.js';
+import { LanceRecordSearch } from './lance-records-search.js';
+import { LanceRecordWriter } from './lance-records-writes.js';
+const COLLECTION_LABEL = getQdrantCollection('squadrules');
+export class LanceVectorRecordStore {
+    engine = new LanceRecordEngine();
+    reader = new LanceRecordReader(this.engine);
+    mutator = new LanceRecordMutator(this.engine);
+    search = new LanceRecordSearch(this.engine);
+    writer = new LanceRecordWriter(this.engine, this.search);
+    connectionPromise = null;
+    connection() {
+        if (!this.connectionPromise)
+            this.connectionPromise = openLanceConnection();
+        return this.connectionPromise;
+    }
+    // --- lifecycle ---
+    async init() {
+        await this.connection();
+        logger.info('[LanceVectorRecordStore] Embedded LanceDB record store ready');
+    }
+    async checkHealth(_timeoutMs) {
+        try {
+            await this.connection();
+            return true;
+        }
+        catch (error) {
+            logger.warn(`[LanceVectorRecordStore] health check failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    // --- reads (delegate) ---
+    async getMemory(memoryUuid, _options) {
+        return this.reader.getMemory(memoryUuid);
+    }
+    async getAdapterLayers(adapterId, extraSpaceIds) {
+        return this.reader.getAdapterLayers(adapterId, extraSpaceIds);
+    }
+    async findFirstStepMemoryUuidBySlug(slug) {
+        return this.reader.findFirstStepMemoryUuidBySlug(slug);
+    }
+    async findArtifactMemoryUuidBySlug(slug) {
+        return this.reader.findArtifactMemoryUuidBySlug(slug);
+    }
+    async scrollSpace(spaceId, options) {
+        return this.reader.scrollSpace(spaceId, options);
+    }
+    async listAdapterArtifacts(adapterId) {
+        return this.reader.listAdapterArtifacts(adapterId);
+    }
+    async findProtocolFooterLayers(refineSlug, createSlug) {
+        return this.reader.findProtocolFooterLayers(refineSlug, createSlug);
+    }
+    async getStoredAdapterVersion(slug) {
+        return this.reader.getStoredAdapterVersion(slug);
+    }
+    async updateMemory(memoryUuid, patch) {
+        return this.mutator.updateMemory(memoryUuid, patch);
+    }
+    async deleteMemory(memoryUuid) {
+        return this.mutator.deleteMemory(memoryUuid);
+    }
+    async setPayloadOnLayers(layerIds, patch) {
+        return this.mutator.setPayloadOnLayers(layerIds, patch);
+    }
+    async deleteAppSpaceBySlug(slug) {
+        return this.mutator.deleteAppSpaceBySlug(slug);
+    }
+    async deleteAppSpaceByAdapterId(adapterId) {
+        return this.mutator.deleteAppSpaceByAdapterId(adapterId);
+    }
+    // --- qdrantService read surface (delegate) ---
+    async retrieveById(uuid) {
+        return this.reader.retrieveById(uuid);
+    }
+    async getMemoryByUUID(uuid) {
+        return this.reader.getMemoryByUUID(uuid);
+    }
+    async findProtocolSteps(protocolId) {
+        return this.reader.findProtocolSteps(protocolId);
+    }
+    async findProtocolStep(domain, type, task, step) {
+        return this.reader.findProtocolStep(domain, type, task, step);
+    }
+    async updateQualityMetrics(id, metrics) {
+        return this.mutator.updateQualityMetrics(id, metrics);
+    }
+    async updateQualityMetadata(id, qualityMetadata) {
+        return this.mutator.updateQualityMetadata(id, qualityMetadata);
+    }
+    async propagateRewardToAdapterHead(stepPointId, metricsUpdate) {
+        return this.mutator.propagateRewardToAdapterHead(stepPointId, metricsUpdate);
+    }
+    // --- admin (embedded store has no aliases / server collections) ---
+    async initialize() {
+        await this.init();
+    }
+    async createOrUpdateAlias() {
+        logger.debug('[LanceVectorRecordStore] createOrUpdateAlias is a no-op on the embedded store');
+    }
+    async getCollections() {
+        return [];
+    }
+    async dropCollection() {
+        logger.debug('[LanceVectorRecordStore] dropCollection is a no-op on the embedded store');
+    }
+    get collectionName() {
+        return COLLECTION_LABEL;
+    }
+    get qdrantUrl() {
+        return 'embedded:lancedb';
+    }
+    get apiKey() {
+        return undefined;
+    }
+    // --- search (JS cosine) ---
+    async searchMemories(query, limit, _collapse) {
+        return this.search.searchMemories(query, limit);
+    }
+    async searchAdapterTitlesBySimilarity(query, limit) {
+        return this.search.searchAdapterTitlesBySimilarity(query, limit);
+    }
+    // --- writers (delegate) ---
+    async storeAdapter(docs, llmModelId, options) {
+        return this.writer.storeAdapter(docs, llmModelId, options);
+    }
+    async storeArtifact(content, options) {
+        return this.writer.storeArtifact(content, options);
+    }
+}
+//# sourceMappingURL=LanceVectorRecordStore.js.map

package/dist/services/vector-store/lancedb/LanceVectorRecordStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanceVectorRecordStore.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/LanceVectorRecordStore.ts"],"names":[],"mappings":"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"}

package/dist/services/vector-store/lancedb/lance-records-engine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Lance table engine for memory records.
+ *
+ * Owns the connection and the one `memory_records` table, exposing the small set
+ * of primitives the read/query/mutation layers are built on: open-or-create,
+ * atomic upsert of Qdrant-shaped points, filtered scans, retrieve-by-id (with
+ * vectors preserved for read-modify-write) and delete-by-filter. Reads before any
+ * write treat the absent table as empty (never create it), so a cold start does
+ * not touch disk for a read. Writes serialize on Lance MVCC via `withCommitRetry`.
+ */
+import type { LanceTable } from '../lancedb-connection.js';
+import { type LanceRecordRow, type QdrantPointLike } from './lance-records-schema.js';
+export declare class LanceRecordEngine {
+    private connectionPromise;
+    private getConnection;
+    /** Open the records table, or return null when nothing has been written yet. */
+    openTableIfPresent(): Promise<LanceTable | null>;
+    /** Open-or-create the records table, inferring the schema from a first row. */
+    ensureTableForWrite(firstRow: LanceRecordRow): Promise<LanceTable>;
+    /** Atomic upsert of Qdrant-shaped points (keyed by id) with commit retry. */
+    putPoints(points: QdrantPointLike[]): Promise<number>;
+    /** Replace rows wholesale for a set of ids after building new points. */
+    putRows(rows: LanceRecordRow[]): Promise<void>;
+    /** Scan rows matching a Qdrant-style filter, optionally capped. */
+    scroll(filter: {
+        must?: Array<Record<string, unknown>>;
+        must_not?: Array<Record<string, unknown>>;
+    }, limit?: number): Promise<LanceRecordRow[]>;
+    /** Retrieve a single raw row by id (carries vector columns for read-modify-write). */
+    retrieveRaw(id: string): Promise<LanceRecordRow | null>;
+    /** Delete rows matching a Qdrant-style filter. */
+    deleteByFilter(filter: {
+        must?: Array<Record<string, unknown>>;
+        must_not?: Array<Record<string, unknown>>;
+    }): Promise<void>;
+    /** Delete one row by id. */
+    deleteById(id: string): Promise<void>;
+    /** Rebuild and persist a row from a mutated Qdrant-shaped point. */
+    upsertPoint(point: QdrantPointLike): Promise<void>;
+}
+//# sourceMappingURL=lance-records-engine.d.ts.map

package/dist/services/vector-store/lancedb/lance-records-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-engine.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAAiC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMrH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,iBAAiB,CAAyC;IAElE,OAAO,CAAC,aAAa;IAOrB,gFAAgF;IAC1E,kBAAkB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOtD,+EAA+E;IACzE,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IASxE,6EAA6E;IACvE,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB3D,yEAAyE;IACnE,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,mEAAmE;IAC7D,MAAM,CACV,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,EAC5F,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B,sFAAsF;IAChF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAW7D,kDAAkD;IAC5C,cAAc,CAClB,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,GAC3F,OAAO,CAAC,IAAI,CAAC;IAQhB,4BAA4B;IACtB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,oEAAoE;IAC9D,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzD"}

package/dist/services/vector-store/lancedb/lance-records-engine.js

@@ -0,0 +1,102 @@
+import { openLanceConnection } from '../lancedb-connection.js';
+import { withCommitRetry } from '../commit-retry.js';
+import { toRow, buildWhere, sqlLiteral } from './lance-records-schema.js';
+const RECORDS_TABLE = 'memory_records';
+/** Full scans use a generous limit; record counts per space are small. */
+const SCAN_LIMIT = 100_000;
+export class LanceRecordEngine {
+    connectionPromise = null;
+    getConnection() {
+        if (!this.connectionPromise) {
+            this.connectionPromise = openLanceConnection();
+        }
+        return this.connectionPromise;
+    }
+    /** Open the records table, or return null when nothing has been written yet. */
+    async openTableIfPresent() {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (!names.includes(RECORDS_TABLE))
+            return null;
+        return connection.openTable(RECORDS_TABLE);
+    }
+    /** Open-or-create the records table, inferring the schema from a first row. */
+    async ensureTableForWrite(firstRow) {
+        const connection = await this.getConnection();
+        const names = await connection.tableNames();
+        if (names.includes(RECORDS_TABLE)) {
+            return connection.openTable(RECORDS_TABLE);
+        }
+        return connection.createTable(RECORDS_TABLE, [firstRow], { mode: 'create' });
+    }
+    /** Atomic upsert of Qdrant-shaped points (keyed by id) with commit retry. */
+    async putPoints(points) {
+        if (points.length === 0)
+            return 0;
+        const rows = points.map(toRow);
+        const table = await this.ensureTableForWrite(rows[0]);
+        await withCommitRetry(() => table
+            .mergeInsert('id')
+            .whenMatchedUpdateAll()
+            .whenNotMatchedInsertAll()
+            .execute(rows), `records-upsert:${rows.length}`);
+        return rows.length;
+    }
+    /** Replace rows wholesale for a set of ids after building new points. */
+    async putRows(rows) {
+        if (rows.length === 0)
+            return;
+        const table = await this.ensureTableForWrite(rows[0]);
+        await withCommitRetry(() => table
+            .mergeInsert('id')
+            .whenMatchedUpdateAll()
+            .whenNotMatchedInsertAll()
+            .execute(rows), `records-put:${rows.length}`);
+    }
+    /** Scan rows matching a Qdrant-style filter, optionally capped. */
+    async scroll(filter, limit) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return [];
+        const where = buildWhere(filter);
+        const query = table.query();
+        if (where)
+            query.where(where);
+        const rows = (await query.limit(limit ?? SCAN_LIMIT).toArray());
+        return rows;
+    }
+    /** Retrieve a single raw row by id (carries vector columns for read-modify-write). */
+    async retrieveRaw(id) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return null;
+        const rows = (await table
+            .query()
+            .where(`id = ${sqlLiteral(id)}`)
+            .limit(1)
+            .toArray());
+        return rows[0] ?? null;
+    }
+    /** Delete rows matching a Qdrant-style filter. */
+    async deleteByFilter(filter) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return;
+        const where = buildWhere(filter);
+        if (!where)
+            return;
+        await withCommitRetry(() => table.delete(where), 'records-delete');
+    }
+    /** Delete one row by id. */
+    async deleteById(id) {
+        const table = await this.openTableIfPresent();
+        if (!table)
+            return;
+        await withCommitRetry(() => table.delete(`id = ${sqlLiteral(id)}`), `records-delete:${id}`);
+    }
+    /** Rebuild and persist a row from a mutated Qdrant-shaped point. */
+    async upsertPoint(point) {
+        await this.putPoints([point]);
+    }
+}
+//# sourceMappingURL=lance-records-engine.js.map

package/dist/services/vector-store/lancedb/lance-records-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-engine.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-engine.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAA6C,MAAM,2BAA2B,CAAC;AAErH,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,0EAA0E;AAC1E,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B,MAAM,OAAO,iBAAiB;IACpB,iBAAiB,GAAoC,IAAI,CAAC;IAE1D,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,kBAAkB;QACtB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,mBAAmB,CAAC,QAAwB;QAChD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,UAAU,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,SAAS,CAAC,MAAyB;QACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACvD,MAAM,eAAe,CACnB,GAAG,EAAE,CACH,KAAK;aACF,WAAW,CAAC,IAAI,CAAC;aACjB,oBAAoB,EAAE;aACtB,uBAAuB,EAAE;aACzB,OAAO,CAAC,IAAI,CAAC,EAClB,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAChC,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,OAAO,CAAC,IAAsB;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;QACvD,MAAM,eAAe,CACnB,GAAG,EAAE,CACH,KAAK;aACF,WAAW,CAAC,IAAI,CAAC;aACjB,oBAAoB,EAAE;aACtB,uBAAuB,EAAE;aACzB,OAAO,CAAC,IAAI,CAAC,EAClB,eAAe,IAAI,CAAC,MAAM,EAAE,CAC7B,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,MAAM,CACV,MAA4F,EAC5F,KAAc;QAEd,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,KAAK;YAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,OAAO,EAAE,CAAgC,CAAC;QAC/F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK;aACtB,KAAK,EAAE;aACP,KAAK,CAAC,QAAQ,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;aAC/B,KAAK,CAAC,CAAC,CAAC;aACR,OAAO,EAAE,CAAgC,CAAC;QAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACzB,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,cAAc,CAClB,MAA4F;QAE5F,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,eAAe,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACrE,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,eAAe,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,WAAW,CAAC,KAAsB;QACtC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/services/vector-store/lancedb/lance-records-mutations.d.ts

@@ -0,0 +1,22 @@
+import type { LanceRecordEngine } from './lance-records-engine.js';
+export declare class LanceRecordMutator {
+    private readonly engine;
+    constructor(engine: LanceRecordEngine);
+    private loadAccessibleRow;
+    updateMemory(id: string, updates: any): Promise<void>;
+    deleteMemory(id: string): Promise<void>;
+    updateQualityMetrics(id: string, metrics: any): Promise<void>;
+    updateQualityMetadata(id: string, qualityMetadata: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    }): Promise<void>;
+    /** Resolve a completion layer's adapter head and propagate reward to it. */
+    propagateRewardToAdapterHead(stepPointId: string, metricsUpdate: Record<string, unknown>): Promise<string | null>;
+    /** Attach a payload patch (e.g. content hash) to a set of layer points. */
+    setPayloadOnLayers(layerIds: string[], patch: Record<string, unknown>): Promise<void>;
+    /** Delete app-space points matching a slug. */
+    deleteAppSpaceBySlug(slug: string): Promise<void>;
+    /** Delete app-space points matching an adapter id. */
+    deleteAppSpaceByAdapterId(adapterId: string): Promise<void>;
+}
+//# sourceMappingURL=lance-records-mutations.d.ts.map