@squadrules/mcp 4.8.6 → 5.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-mutations.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-mutations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAsCnE,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;YAExC,iBAAiB;IASzB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7D,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;IASlK,4EAA4E;IACtE,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BvH,2EAA2E;IACrE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3F,+CAA+C;IACzC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD,sDAAsD;IAChD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQlE"}

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

@@ -0,0 +1,211 @@
+/**
+ * Lance mutation layer for memory records.
+ *
+ * Read-modify-write operations mirror their Qdrant counterparts (`memory-updates.ts`,
+ * `quality.ts`, `reward-propagation.ts` and the `store.ts` bulk payload/delete
+ * helpers) field for field: the same accessible-space gate, the same payload merge
+ * and retired-alias drop, the same `quality_metrics` accumulation and `attest_boost`
+ * formula, the same text-change → re-embed rule, and the same cache invalidation
+ * calls. Named vectors are preserved across the round-trip so an update never
+ * silently drops an embedding column.
+ */
+import { SQUADRULES_APP_SPACE_ID, MIN_ATTEST_RUNS, RUNS_FULL_CONFIDENCE, ATTEST_BOOST_MAX } from '../../../config.js';
+import { getSpaceContext, getTenantId } from '../../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../../utils/space-filter.js';
+import { SquadrulesError } from '../../../types/index.js';
+import { logger } from '../../../utils/structured-logger.js';
+import { embeddingService } from '../../embedding/service.js';
+import { redisCacheService } from '../../redis-cache.js';
+import { validateAndConvertId } from '../../qdrant/utils.js';
+import { toNumberArray } from './lance-records-schema.js';
+function payloadOf(row) {
+    return JSON.parse(row.payload);
+}
+function isAccessible(row) {
+    const spaceId = String(payloadOf(row)['space_id'] ?? SQUADRULES_APP_SPACE_ID);
+    const allowed = getSpaceContext().allowedSpaceIds;
+    return allowed.includes(spaceId) || spaceId === SQUADRULES_APP_SPACE_ID;
+}
+/** Pull the named dense vectors (+ bm25) out of a row so an update preserves them. */
+function vectorsFromRow(row) {
+    const vector = {};
+    for (const [key, value] of Object.entries(row)) {
+        const numbers = toNumberArray(value);
+        if (numbers)
+            vector[key] = numbers;
+    }
+    if (row.bm25_json) {
+        try {
+            vector['bm25'] = JSON.parse(row.bm25_json);
+        }
+        catch {
+            /* ignore malformed sparse blob */
+        }
+    }
+    return vector;
+}
+function computeAttestBoost(successCount, failureCount) {
+    const runs = successCount + failureCount;
+    if (runs < MIN_ATTEST_RUNS)
+        return 0;
+    const successRatio = runs > 0 ? successCount / runs : 0;
+    const confidence = Math.min(runs / RUNS_FULL_CONFIDENCE, 1);
+    return Math.min(ATTEST_BOOST_MAX * successRatio * confidence, ATTEST_BOOST_MAX);
+}
+export class LanceRecordMutator {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async loadAccessibleRow(id, notFoundMessage) {
+        const validated = validateAndConvertId(id);
+        const row = await this.engine.retrieveRaw(validated);
+        if (!row || !isAccessible(row)) {
+            throw new SquadrulesError(notFoundMessage, 'MEMORY_NOT_FOUND', 404);
+        }
+        return row;
+    }
+    async updateMemory(id, updates) {
+        const tenantId = getTenantId();
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found`);
+        const existingPayload = payloadOf(row);
+        let newQualityMetadata = existingPayload.quality_metadata;
+        const shouldRecalculate = updates.label || updates.text || updates.domain || updates.task || updates.type || updates.tags;
+        if (shouldRecalculate) {
+            const { modelStats } = await import('../../stats/model-stats.js');
+            const qualityMetadata = modelStats.calculateStepQualityMetadata(updates.label || existingPayload.label || '', updates.domain || existingPayload.domain || 'general', updates.task || existingPayload.task || 'general-task', updates.type || existingPayload.type || 'context', updates.tags || existingPayload.tags || []);
+            newQualityMetadata = { step_quality_score: qualityMetadata.step_quality_score, step_quality: qualityMetadata.step_quality };
+        }
+        const { description_short: _d, description_full: _f, ...safeUpdates } = updates ?? {};
+        const defaultSpaceId = getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = {
+            ...existingPayload,
+            space_id: existingPayload.space_id ?? defaultSpaceId,
+            ...safeUpdates,
+            updated_at: new Date().toISOString(),
+            modified_at: new Date().toISOString(),
+            modified_by: getSpaceContext().userId || 'system',
+            created_by: existingPayload.created_by ?? (getSpaceContext().userId || 'system'),
+            quality_metadata: newQualityMetadata
+        };
+        const vector = vectorsFromRow(row);
+        const textChanged = typeof updates?.text === 'string' && updates.text !== existingPayload.text;
+        if (textChanged) {
+            const embeddingResult = await embeddingService.generateEmbedding(updates.text);
+            const primaryName = `vs${embeddingResult.embedding.length}`;
+            for (const key of Object.keys(vector)) {
+                if (key.startsWith('vs'))
+                    delete vector[key];
+            }
+            vector[primaryName] = embeddingResult.embedding;
+        }
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector });
+        await redisCacheService.invalidateMemoryCacheStrict(row.id);
+        await redisCacheService.invalidateAfterUpdate();
+        logger.debug(`[LanceRecordMutator] updateMemory ${row.id} tenant=${tenantId}`);
+    }
+    async deleteMemory(id) {
+        const validated = validateAndConvertId(id);
+        const row = await this.engine.retrieveRaw(validated);
+        if (!row || !isAccessible(row)) {
+            throw new SquadrulesError(`Memory with ID ${id} not found`, 'MEMORY_NOT_FOUND', 404);
+        }
+        await this.engine.deleteById(validated);
+        await redisCacheService.invalidateMemoryCacheStrict(validated);
+        await redisCacheService.invalidateAfterUpdate();
+    }
+    async updateQualityMetrics(id, metrics) {
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found for quality update`);
+        const existingPayload = payloadOf(row);
+        const currentMetrics = existingPayload.quality_metrics || {
+            retrievalCount: 0, successCount: 0, partialCount: 0, failureCount: 0,
+            lastRated: null, lastRater: null, qualityBonus: 0, usageContext: null,
+            implementation_stats: { total_attempts: 0, success_attempts: 0, model_success_rates: {}, confidence_level: 0, last_implementation_attempt: null },
+            healer_contributions: { total_healers: 0, total_improvements: 0, healer_bonus_distributed: 0, last_healed: null, healer_models: {} },
+            step_success_rates: {}
+        };
+        const updatedMetrics = {
+            ...currentMetrics,
+            ...metrics,
+            retrievalCount: currentMetrics.retrievalCount + (metrics.retrievalCount || 0),
+            successCount: currentMetrics.successCount + (metrics.successCount || 0),
+            partialCount: currentMetrics.partialCount + (metrics.partialCount || 0),
+            failureCount: currentMetrics.failureCount + (metrics.failureCount || 0),
+            qualityBonus: currentMetrics.qualityBonus + (metrics.qualityBonus || 0)
+        };
+        const attest_boost = computeAttestBoost(updatedMetrics.successCount ?? 0, updatedMetrics.failureCount ?? 0);
+        const spaceId = existingPayload.space_id ?? getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = { ...existingPayload, space_id: spaceId, quality_metrics: updatedMetrics, attest_boost, updated_at: new Date().toISOString() };
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector: vectorsFromRow(row) });
+    }
+    async updateQualityMetadata(id, qualityMetadata) {
+        const row = await this.loadAccessibleRow(id, `Memory with ID ${id} not found for quality metadata update`);
+        const existingPayload = payloadOf(row);
+        const updatedQualityMetadata = { ...(existingPayload.quality_metadata || {}), ...qualityMetadata };
+        const spaceId = existingPayload.space_id ?? getSpaceContext().defaultWriteSpaceId;
+        const updatedPayload = { ...existingPayload, space_id: spaceId, quality_metadata: updatedQualityMetadata, updated_at: new Date().toISOString() };
+        await this.engine.upsertPoint({ id: row.id, payload: updatedPayload, vector: vectorsFromRow(row) });
+    }
+    /** Resolve a completion layer's adapter head and propagate reward to it. */
+    async propagateRewardToAdapterHead(stepPointId, metricsUpdate) {
+        const stepRow = await this.engine.retrieveRaw(validateAndConvertId(stepPointId));
+        if (!stepRow || !isAccessible(stepRow))
+            return null;
+        const payload = payloadOf(stepRow);
+        const adapterId = payload['adapter']?.id;
+        if (!adapterId || typeof adapterId !== 'string')
+            return null;
+        const layerIndex = payload['adapter']?.layer_index;
+        if (layerIndex === 1)
+            return null;
+        const heads = await this.engine.scroll(buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        }), 1);
+        if (heads.length === 0) {
+            logger.warn(`[reward-propagation] Adapter head not found for adapter ${adapterId}, skip propagation`);
+            return null;
+        }
+        const adapterHeadId = heads[0].id;
+        await this.updateQualityMetrics(adapterHeadId, metricsUpdate);
+        try {
+            await redisCacheService.invalidateBeginCache();
+        }
+        catch (cacheErr) {
+            logger.warn(`[reward-propagation] Cache invalidation failed after adapter head update (adapterHeadId=${adapterHeadId}): ${cacheErr instanceof Error ? cacheErr.message : String(cacheErr)}`);
+        }
+        return adapterHeadId;
+    }
+    /** Attach a payload patch (e.g. content hash) to a set of layer points. */
+    async setPayloadOnLayers(layerIds, patch) {
+        const points = [];
+        for (const rawId of layerIds) {
+            const row = await this.engine.retrieveRaw(validateAndConvertId(rawId));
+            if (!row)
+                continue;
+            points.push({ id: row.id, payload: { ...payloadOf(row), ...patch }, vector: vectorsFromRow(row) });
+        }
+        await this.engine.putPoints(points);
+    }
+    /** Delete app-space points matching a slug. */
+    async deleteAppSpaceBySlug(slug) {
+        await this.engine.deleteByFilter({
+            must: [
+                { key: 'slug', match: { value: slug } },
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } }
+            ]
+        });
+    }
+    /** Delete app-space points matching an adapter id. */
+    async deleteAppSpaceByAdapterId(adapterId) {
+        await this.engine.deleteByFilter({
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } }
+            ]
+        });
+    }
+}
+//# sourceMappingURL=lance-records-mutations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-mutations.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-mutations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAA6C,MAAM,2BAA2B,CAAC;AAErG,SAAS,SAAS,CAAC,GAAmB;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAA4B,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,GAAmB;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,uBAAuB,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC,eAAe,CAAC;IAClD,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,uBAAuB,CAAC;AAC1E,CAAC;AAED,sFAAsF;AACtF,SAAS,cAAc,CAAC,GAAmB;IACzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,YAAoB,EAAE,YAAoB;IACpE,MAAM,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC;IACzC,IAAI,IAAI,GAAG,eAAe;QAAE,OAAO,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,YAAY,GAAG,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAElD,KAAK,CAAC,iBAAiB,CAAC,EAAU,EAAE,eAAuB;QACjE,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,OAAY;QACzC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC/E,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,kBAAkB,GAAG,eAAe,CAAC,gBAAgB,CAAC;QAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;QAC1H,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YAClE,MAAM,eAAe,GAAG,UAAU,CAAC,4BAA4B,CAC7D,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,IAAI,EAAE,EAC5C,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM,IAAI,SAAS,EACrD,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,IAAI,cAAc,EACtD,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,IAAI,SAAS,EACjD,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,IAAI,EAAE,CAC3C,CAAC;YACF,kBAAkB,GAAG,EAAE,kBAAkB,EAAE,eAAe,CAAC,kBAAkB,EAAE,YAAY,EAAE,eAAe,CAAC,YAAY,EAAE,CAAC;QAC9H,CAAC;QAED,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACtF,MAAM,cAAc,GAAG,eAAe,EAAE,CAAC,mBAAmB,CAAC;QAC7D,MAAM,cAAc,GAAG;YACrB,GAAG,eAAe;YAClB,QAAQ,EAAE,eAAe,CAAC,QAAQ,IAAI,cAAc;YACpD,GAAG,WAAW;YACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,eAAe,EAAE,CAAC,MAAM,IAAI,QAAQ;YACjD,UAAU,EAAE,eAAe,CAAC,UAAU,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,IAAI,QAAQ,CAAC;YAChF,gBAAgB,EAAE,kBAAkB;SACrC,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,CAAC;QAC/F,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAc,CAAC,CAAC;YACzF,MAAM,WAAW,GAAG,KAAK,eAAe,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC;QAClD,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,MAAM,iBAAiB,CAAC,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,iBAAiB,CAAC,qBAAqB,EAAE,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,CAAC,EAAE,WAAW,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU;QAC3B,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,iBAAiB,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,iBAAiB,CAAC,qBAAqB,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,EAAU,EAAE,OAAY;QACjD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;QAClG,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,cAAc,GAAG,eAAe,CAAC,eAAe,IAAI;YACxD,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;YACpE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI;YACrE,oBAAoB,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE,2BAA2B,EAAE,IAAI,EAAE;YACjJ,oBAAoB,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,wBAAwB,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE;YACpI,kBAAkB,EAAE,EAAE;SACvB,CAAC;QACF,MAAM,cAAc,GAAG;YACrB,GAAG,cAAc;YACjB,GAAG,OAAO;YACV,cAAc,EAAE,cAAc,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;YAC7E,YAAY,EAAE,cAAc,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;YACvE,YAAY,EAAE,cAAc,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;YACvE,YAAY,EAAE,cAAc,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;YACvE,YAAY,EAAE,cAAc,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;SACxE,CAAC;QACF,MAAM,YAAY,GAAG,kBAAkB,CAAC,cAAc,CAAC,YAAY,IAAI,CAAC,EAAE,cAAc,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;QAC5G,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC,mBAAmB,CAAC;QAClF,MAAM,cAAc,GAAG,EAAE,GAAG,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACtJ,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,EAAU,EAAE,eAA0G;QAChJ,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,EAAE,wCAAwC,CAAC,CAAC;QAC3G,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,sBAAsB,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,gBAAgB,IAAI,EAAE,CAAC,EAAE,GAAG,eAAe,EAAE,CAAC;QACnG,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC,mBAAmB,CAAC;QAClF,MAAM,cAAc,GAAG,EAAE,GAAG,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACjJ,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,4BAA4B,CAAC,WAAmB,EAAE,aAAsC;QAC5F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,SAAS,GAAI,OAAO,CAAC,SAAS,CAAiC,EAAE,EAAE,CAAC;QAC1E,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC7D,MAAM,UAAU,GAAI,OAAO,CAAC,SAAS,CAA0C,EAAE,WAAW,CAAC;QAC7F,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE;YACzF,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBAClD,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;aACpD;SACF,CAAC,EAAE,CAAC,CAAC,CAAC;QACP,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,2DAA2D,SAAS,oBAAoB,CAAC,CAAC;YACtG,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,2FAA2F,aAAa,MAAM,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/L,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,kBAAkB,CAAC,QAAkB,EAAE,KAA8B;QACzE,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,oBAAoB,CAAC,IAAY;QACrC,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;YAC/B,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACvC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE;aAC/D;SACF,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,yBAAyB,CAAC,SAAiB;QAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;YAC/B,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBAClD,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE;aAC/D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,64 @@
+/**
+ * Lance read/query layer for memory records.
+ *
+ * Every method mirrors the semantics of the Qdrant leaf helper it replaces
+ * (`memory-retrieval.ts`, `protocol.ts` and the `store.ts` domain reads), down to
+ * the space-source used for gating, the slug disambiguation precedence, the
+ * pagination-until-exhausted scroll, and the exact returned object shape. Rows
+ * carry the payload verbatim, so reads are byte-identical to the Qdrant path.
+ */
+import type { Memory } from '../../../types/memory.js';
+import type { LayerRecord, SlugResolveOutcome, ArtifactResolveOutcome } from '../types.js';
+import type { LanceRecordEngine } from './lance-records-engine.js';
+interface RawPoint {
+    id: string;
+    payload: any;
+}
+export declare class LanceRecordReader {
+    private readonly engine;
+    constructor(engine: LanceRecordEngine);
+    /** Accessible-by-space single point (mirrors `retrieveAccessiblePointById`). */
+    retrieveAccessibleById(uuid: string): Promise<RawPoint | null>;
+    /** Neutral `Memory` read (mirrors `store.getMemory`). */
+    getMemory(memoryUuid: string): Promise<Memory | null>;
+    /** `{uuid, payload}` retrieval (mirrors `retrieveById`). */
+    retrieveById(uuid: string): Promise<{
+        uuid: string;
+        payload: any;
+    } | null>;
+    /** Ad-hoc memory object (mirrors `getMemoryByUUID` exactly). */
+    getMemoryByUUID(uuid: string): Promise<any | null>;
+    /** All non-artifact layers of one adapter, sorted by layer index. */
+    getAdapterLayers(adapterId: string, extraSpaceIds?: string[]): Promise<Array<{
+        uuid: string;
+        payload: any;
+    }>>;
+    /** Exact slug -> adapter entry-layer point, deterministic on ambiguity. */
+    findFirstStepMemoryUuidBySlug(slug: string): Promise<SlugResolveOutcome>;
+    /** Exact artifact slug -> single artifact point, null when ambiguous. */
+    findArtifactMemoryUuidBySlug(slug: string): Promise<ArtifactResolveOutcome>;
+    /** Points carrying a `protocol_id` (mirrors `findProtocolSteps`). */
+    findProtocolSteps(protocolId: string): Promise<Array<{
+        uuid: string;
+        protocol: unknown;
+        payload: Record<string, unknown>;
+    }>>;
+    /** Single protocol step by domain/type/task/step (mirrors `findProtocolStep`). */
+    findProtocolStep(domain: string, type: string, task: string, step: number): Promise<{
+        uuid: string;
+        payload: Record<string, unknown>;
+    } | null>;
+    /** Every layer point in one space. */
+    scrollSpace(spaceId: string, options?: {
+        paginate?: boolean;
+        limit?: number;
+    }): Promise<LayerRecord[]>;
+    /** Artifact layer points attached to an adapter, across searchable spaces. */
+    listAdapterArtifacts(adapterId: string): Promise<LayerRecord[]>;
+    /** First-layer footer points for the refining/creation protocol slugs. */
+    findProtocolFooterLayers(refineSlug: string, createSlug: string): Promise<LayerRecord[]>;
+    /** Protocol version already stored for an app-space adapter slug. */
+    getStoredAdapterVersion(slug: string): Promise<string | undefined>;
+}
+export {};
+//# sourceMappingURL=lance-records-reads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-reads.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-reads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAOvD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,GAAG,CAAC;CACd;AAqBD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEtD,gFAAgF;IAC1E,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAUpE,yDAAyD;IACnD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM3D,4DAA4D;IACtD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAC;IAMhF,gEAAgE;IAC1D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAsCxD,qEAAqE;IAC/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAgBnH,2EAA2E;IACrE,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2C9E,yEAAyE;IACnE,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAcjF,qEAAqE;IAC/D,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;IAYlI,kFAAkF;IAC5E,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;IAapJ,sCAAsC;IAChC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKhH,8EAA8E;IACxE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAUrE,0EAA0E;IACpE,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAW9F,qEAAqE;IAC/D,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAWzE"}

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

@@ -0,0 +1,237 @@
+import { SQUADRULES_APP_SPACE_ID } from '../../../config.js';
+import { getSearchSpaceIds, getSpaceContext } from '../../../utils/tenant-context.js';
+import { buildSpaceFilter, buildAdapterSiblingScrollFilter } from '../../../utils/space-filter.js';
+import { ALLOWED_ARTIFACT_MIMES } from '../../../tools/artifact-mime.js';
+import { structuredLogger } from '../../../utils/structured-logger.js';
+import { pointToMemory } from '../../memory/qdrant-point-to-memory.js';
+function payloadOf(row) {
+    return JSON.parse(row.payload);
+}
+function rowToPoint(row) {
+    return { id: row.id, payload: payloadOf(row) };
+}
+function toLayerRecord(row) {
+    return { uuid: row.id, payload: payloadOf(row) };
+}
+function slugPrecedence(spaceId) {
+    if (spaceId.startsWith('user:'))
+        return 0;
+    if (spaceId.startsWith('group:'))
+        return 1;
+    if (spaceId === SQUADRULES_APP_SPACE_ID || spaceId.startsWith('app:'))
+        return 2;
+    return 2;
+}
+export class LanceRecordReader {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /** Accessible-by-space single point (mirrors `retrieveAccessiblePointById`). */
+    async retrieveAccessibleById(uuid) {
+        const row = await this.engine.retrieveRaw(uuid);
+        if (!row)
+            return null;
+        const point = rowToPoint(row);
+        const spaceId = String(point.payload['space_id'] ?? SQUADRULES_APP_SPACE_ID);
+        const allowed = getSpaceContext().allowedSpaceIds;
+        const canRead = allowed.includes(spaceId) || spaceId === SQUADRULES_APP_SPACE_ID;
+        return canRead ? point : null;
+    }
+    /** Neutral `Memory` read (mirrors `store.getMemory`). */
+    async getMemory(memoryUuid) {
+        const point = await this.retrieveAccessibleById(memoryUuid);
+        if (!point)
+            return null;
+        return pointToMemory(point);
+    }
+    /** `{uuid, payload}` retrieval (mirrors `retrieveById`). */
+    async retrieveById(uuid) {
+        const point = await this.retrieveAccessibleById(uuid);
+        if (!point)
+            return null;
+        return { uuid: point.id, payload: point.payload };
+    }
+    /** Ad-hoc memory object (mirrors `getMemoryByUUID` exactly). */
+    async getMemoryByUUID(uuid) {
+        const result = await this.retrieveById(uuid);
+        if (!result)
+            return null;
+        const payload = result.payload;
+        return {
+            id: result.uuid,
+            label: payload.label || '',
+            text: payload.text || '',
+            domain: payload.domain || '',
+            task: payload.task || '',
+            type: payload.type || 'context',
+            tags: payload.tags || [],
+            protocol: payload.protocol,
+            quality_metrics: payload.quality_metrics,
+            quality_metadata: payload.quality_metadata,
+            memory_uuid: uuid,
+            adapter: payload.adapter ? {
+                id: payload.adapter.id,
+                name: payload.adapter.name,
+                layer_index: payload.adapter.layer_index,
+                layer_count: payload.adapter.layer_count,
+                ...(typeof payload.adapter.protocol_version === 'string' && { protocol_version: payload.adapter.protocol_version }),
+                ...(Array.isArray(payload.adapter.activation_patterns) && { activation_patterns: payload.adapter.activation_patterns }),
+                ...(typeof payload.adapter.reward_signal === 'string' && { reward_signal: payload.adapter.reward_signal }),
+                ...(typeof payload.adapter.chain_root === 'string' && payload.adapter.chain_root.length > 0 && { chain_root: payload.adapter.chain_root })
+            } : undefined,
+            inference_contract: payload.inference_contract,
+            embedding: [],
+            access_count: payload.quality_metrics?.retrievalCount || 0,
+            last_accessed: new Date(payload.updated_at || payload.created_at || Date.now()),
+            relevance_score: 1.0,
+            created_at: new Date(payload.created_at || Date.now()),
+            peak_contexts: [],
+            certainty: 0.8,
+            entropy: 0.2
+        };
+    }
+    /** All non-artifact layers of one adapter, sorted by layer index. */
+    async getAdapterLayers(adapterId, extraSpaceIds) {
+        const spaceIds = extraSpaceIds && extraSpaceIds.length > 0 ? extraSpaceIds : getSearchSpaceIds();
+        const sibling = buildAdapterSiblingScrollFilter(spaceIds, adapterId);
+        const rows = await this.engine.scroll({
+            must: sibling.must,
+            must_not: [{ key: 'content_type', match: { any: [...ALLOWED_ARTIFACT_MIMES] } }]
+        });
+        return rows
+            .map((row) => ({ uuid: row.id, payload: payloadOf(row) }))
+            .sort((a, b) => {
+            const ai = typeof a.payload?.adapter?.layer_index === 'number' ? a.payload.adapter.layer_index : 0;
+            const bi = typeof b.payload?.adapter?.layer_index === 'number' ? b.payload.adapter.layer_index : 0;
+            return ai - bi;
+        });
+    }
+    /** Exact slug -> adapter entry-layer point, deterministic on ambiguity. */
+    async findFirstStepMemoryUuidBySlug(slug) {
+        const normalized = (slug || '').trim().toLowerCase();
+        if (!normalized)
+            return { layerUuid: null };
+        const filter = buildSpaceFilter(getSearchSpaceIds(), {
+            must: [
+                { key: 'slug', match: { value: normalized } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        });
+        const rows = await this.engine.scroll(filter);
+        if (rows.length === 0)
+            return { layerUuid: null };
+        const points = rows.map(rowToPoint).sort((a, b) => a.id.localeCompare(b.id));
+        const byAdapterId = new Map();
+        for (const p of points) {
+            const adapterId = typeof p.payload?.adapter?.id === 'string' ? p.payload.adapter.id : `__orphan_${p.id}`;
+            if (!byAdapterId.has(adapterId))
+                byAdapterId.set(adapterId, p);
+        }
+        const unique = [...byAdapterId.values()];
+        if (unique.length === 1)
+            return { layerUuid: unique[0].id };
+        const spaceOf = (p) => String(p.payload?.space_id ?? SQUADRULES_APP_SPACE_ID);
+        const sorted = [...unique].sort((a, b) => {
+            const ap = slugPrecedence(spaceOf(a));
+            const bp = slugPrecedence(spaceOf(b));
+            if (ap !== bp)
+                return ap - bp;
+            return a.id.localeCompare(b.id);
+        });
+        const winner = sorted[0];
+        const chosenId = winner.id;
+        const adapterHint = typeof winner.payload?.adapter?.id === 'string' ? winner.payload.adapter.id : chosenId;
+        const winnerSpaceId = spaceOf(winner);
+        const contenderSummary = sorted
+            .map((p) => {
+            const adapterId = typeof p.payload?.adapter?.id === 'string' ? p.payload.adapter.id : p.id;
+            return `${adapterId}@${spaceOf(p)}`;
+        })
+            .join(', ');
+        const note = `Slug "${normalized}" matched ${unique.length} adapters; selected "${adapterHint}" from "${winnerSpaceId}" by precedence (personal > group > app/system, then stable id). Candidates: ${contenderSummary}. Prefer an explicit adapter URI such as squadrules://adapter/${adapterHint} to avoid ambiguity.`;
+        structuredLogger.warn(`[slug-resolve] ${note}`);
+        return { layerUuid: chosenId, disambiguation_note: note };
+    }
+    /** Exact artifact slug -> single artifact point, null when ambiguous. */
+    async findArtifactMemoryUuidBySlug(slug) {
+        const normalized = (slug || '').trim().toLowerCase();
+        if (!normalized)
+            return { artifactUuid: null };
+        const rows = await this.engine.scroll(buildSpaceFilter(getSearchSpaceIds(), {
+            must: [{ key: 'artifact.slug', match: { value: normalized } }]
+        }));
+        if (rows.length === 0)
+            return { artifactUuid: null };
+        if (rows.length > 1) {
+            const candidates = rows.map((r) => r.id).join(', ');
+            return { artifactUuid: null, disambiguation_note: `Artifact slug "${normalized}" is ambiguous. Matching artifact UUIDs: ${candidates}` };
+        }
+        return { artifactUuid: rows[0].id };
+    }
+    /** Points carrying a `protocol_id` (mirrors `findProtocolSteps`). */
+    async findProtocolSteps(protocolId) {
+        const rows = await this.engine.scroll(buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [{ key: 'protocol_id', match: { value: protocolId } }]
+        }));
+        return rows
+            .map((row) => {
+            const payload = payloadOf(row);
+            return { uuid: row.id, protocol: payload['protocol'], payload };
+        })
+            .filter((item) => item.protocol);
+    }
+    /** Single protocol step by domain/type/task/step (mirrors `findProtocolStep`). */
+    async findProtocolStep(domain, type, task, step) {
+        const rows = await this.engine.scroll(buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [
+                { key: 'domain', match: { value: domain } },
+                { key: 'type', match: { value: type } },
+                { key: 'task', match: { value: task } },
+                { key: 'protocol.step', match: { value: step } }
+            ]
+        }), 1);
+        if (rows.length === 0)
+            return null;
+        return { uuid: rows[0].id, payload: payloadOf(rows[0]) };
+    }
+    /** Every layer point in one space. */
+    async scrollSpace(spaceId, options = {}) {
+        const rows = await this.engine.scroll(buildSpaceFilter([spaceId]), options.paginate === false ? options.limit : undefined);
+        return rows.map(toLayerRecord);
+    }
+    /** Artifact layer points attached to an adapter, across searchable spaces. */
+    async listAdapterArtifacts(adapterId) {
+        const rows = await this.engine.scroll(buildSpaceFilter(getSearchSpaceIds(), {
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'content_type', match: { any: [...ALLOWED_ARTIFACT_MIMES] } }
+            ]
+        }));
+        return rows.map(toLayerRecord);
+    }
+    /** First-layer footer points for the refining/creation protocol slugs. */
+    async findProtocolFooterLayers(refineSlug, createSlug) {
+        const rows = await this.engine.scroll({
+            must: [
+                { key: 'slug', match: { any: [refineSlug, createSlug] } },
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        }, 10);
+        return rows.map(toLayerRecord);
+    }
+    /** Protocol version already stored for an app-space adapter slug. */
+    async getStoredAdapterVersion(slug) {
+        const rows = await this.engine.scroll({
+            must: [
+                { key: 'space_id', match: { value: SQUADRULES_APP_SPACE_ID } },
+                { key: 'slug', match: { value: slug } }
+            ]
+        }, 1);
+        const payload = rows[0] ? payloadOf(rows[0]) : undefined;
+        const version = payload?.['protocol_version'];
+        return typeof version === 'string' ? version : undefined;
+    }
+}
+//# sourceMappingURL=lance-records-reads.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-reads.js","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-reads.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAUvE,SAAS,SAAS,CAAC,GAAmB;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAA4B,CAAC;AAC5D,CAAC;AAED,SAAS,UAAU,CAAC,GAAmB;IACrC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,GAAmB;IACxC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAsB,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,CAAC;IAChF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,gFAAgF;IAChF,KAAK,CAAC,sBAAsB,CAAC,IAAY;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAwB,IAAI,uBAAuB,CAAC,CAAC;QACrG,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC,eAAe,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,uBAAuB,CAAC;QACjF,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,SAAS,CAAC,UAAkB;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,IAAI;YACf,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzB,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;gBACtB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC1B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;gBACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;gBACxC,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,KAAK,QAAQ,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBACnH,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBACvH,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1G,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;aAC3I,CAAC,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,OAAO,CAAC,eAAe,EAAE,cAAc,IAAI,CAAC;YAC1D,aAAa,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/E,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACtD,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,aAAwB;QAChE,MAAM,QAAQ,GAAG,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;QACjG,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,sBAAsB,CAAC,EAAE,EAAE,CAAC;SACjF,CAAC,CAAC;QACH,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aACzD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YACnG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YACnG,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,6BAA6B,CAAC,IAAY;QAC9C,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,EAAE;YACnD,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;gBAC7C,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;aACpD;SACF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE7E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC;YACzG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,CAAC;QAE7D,MAAM,OAAO,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,uBAAuB,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,EAAE,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3G,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,MAAM;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO,GAAG,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,UAAU,aAAa,MAAM,CAAC,MAAM,wBAAwB,WAAW,WAAW,aAAa,gFAAgF,gBAAgB,iEAAiE,WAAW,sBAAsB,CAAC;QACxT,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,4BAA4B,CAAC,IAAY;QAC7C,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,EAAE;YAC1E,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;SAC/D,CAAC,CAAC,CAAC;QACJ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACrD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,kBAAkB,UAAU,4CAA4C,UAAU,EAAE,EAAE,CAAC;QAC3I,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,iBAAiB,CAAC,UAAkB;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE;YACxF,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;SAC7D,CAAC,CAAC,CAAC;QACJ,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;QAClE,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY;QAC7E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE;YACxF,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC3C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACvC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACvC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;aACjD;SACF,CAAC,EAAE,CAAC,CAAC,CAAC;QACP,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,UAAkD,EAAE;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3H,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,EAAE;YAC1E,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;gBAClD,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,sBAAsB,CAAC,EAAE,EAAE;aACrE;SACF,CAAC,CAAC,CAAC;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,wBAAwB,CAAC,UAAkB,EAAE,UAAkB;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE;gBACzD,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE;gBAC9D,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;aACpD;SACF,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,uBAAuB,CAAC,IAAY;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE;gBAC9D,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;aACxC;SACF,EAAE,CAAC,CAAC,CAAC;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,kBAAkB,CAAC,CAAC;QAC9C,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;CACF"}

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

@@ -0,0 +1,48 @@
+/** A point shaped the way the Qdrant write handlers build them. */
+export interface QdrantPointLike {
+    id: string;
+    payload: Record<string, unknown>;
+    vector?: Record<string, unknown>;
+}
+/** One Lance record row: promoted scalars + verbatim payload + named vectors. */
+export interface LanceRecordRow {
+    id: string;
+    space_id: string;
+    slug: string;
+    adapter_id: string;
+    layer_index: number;
+    layer_count: number;
+    protocol_version: string;
+    content_type: string;
+    protocol_id: string;
+    domain: string;
+    task: string;
+    type: string;
+    artifact_slug: string;
+    protocol_step: number;
+    created_at: string;
+    payload: string;
+    bm25_json: string;
+    [vectorColumn: string]: unknown;
+}
+/** Escape a value for a LanceQL string literal. */
+export declare function sqlLiteral(value: string): string;
+/**
+ * Coerce a stored numeric cell to a plain `number[]`. A data-inferred embedding
+ * column reads back as an Apache Arrow `Vector` (not a JS array), so an
+ * `Array.isArray` test alone would silently drop every embedding.
+ */
+export declare function toNumberArray(value: unknown): number[] | null;
+/** Column name for a dotted payload key, if it is promoted; else undefined. */
+export declare function columnForKey(key: string): keyof LanceRecordRow | undefined;
+/**
+ * Build a LanceQL `WHERE` string from Qdrant-style `must` / `must_not` arrays.
+ * Returns undefined when there is nothing to constrain (match-all).
+ */
+export declare function buildWhere(filter: {
+    must?: Array<Record<string, unknown>>;
+    must_not?: Array<Record<string, unknown>>;
+}): string | undefined;
+/** Convert a Qdrant-shaped point to a Lance row (payload verbatim, scalars promoted). */
+export declare function toRow(point: QdrantPointLike): LanceRecordRow;
+//# sourceMappingURL=lance-records-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-schema.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-schema.ts"],"names":[],"mappings":"AAcA,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAoBD,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAS7D;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,cAAc,GAAG,SAAS,CAE1E;AA0CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3C,GAAG,MAAM,GAAG,SAAS,CAQrB;AAOD,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAoC5D"}