@squadrules/mcp 4.8.6 → 5.0.0

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

@@ -0,0 +1,159 @@
+/**
+ * Row/filter primitives for the embedded LanceDB record store.
+ *
+ * Records are persisted in a Lance table shaped to be a faithful mirror of a
+ * Qdrant point: the whole `payload` is kept verbatim as a JSON string (so reads
+ * reconstruct a byte-identical `Memory` via `pointToMemory`), while the scalar
+ * keys that appear in query filters are *promoted* to real columns so LanceQL
+ * scans and ANN can select them. `toRow` derives those columns from a
+ * Qdrant-shaped point, and `conditionToSql` translates the exact filter shape
+ * emitted by `buildSpaceFilter` (`must` / `must_not` of `{key, match}` and
+ * `{should}` / `{is_empty}` conditions) into a LanceQL `WHERE` clause.
+ */
+import { SQUADRULES_APP_SPACE_ID } from '../../../config.js';
+/**
+ * Dotted payload path -> promoted column. Covers every key that appears in a
+ * query filter across retrieval, protocol, slug-mint and artifact code paths.
+ */
+const KEY_TO_COLUMN = {
+    space_id: 'space_id',
+    slug: 'slug',
+    'adapter.id': 'adapter_id',
+    'adapter.layer_index': 'layer_index',
+    'artifact.slug': 'artifact_slug',
+    'protocol_id': 'protocol_id',
+    'protocol.step': 'protocol_step',
+    content_type: 'content_type',
+    domain: 'domain',
+    task: 'task',
+    type: 'type'
+};
+/** Escape a value for a LanceQL string literal. */
+export function sqlLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+/**
+ * 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 function toNumberArray(value) {
+    if (Array.isArray(value)) {
+        return value.every((n) => typeof n === 'number') ? value : null;
+    }
+    if (value && typeof value === 'object' && typeof value.length === 'number' && Symbol.iterator in value) {
+        const arr = Array.from(value);
+        return arr.length > 0 && arr.every((n) => typeof n === 'number') ? arr : null;
+    }
+    return null;
+}
+/** Column name for a dotted payload key, if it is promoted; else undefined. */
+export function columnForKey(key) {
+    return KEY_TO_COLUMN[key];
+}
+function renderMatch(column, match) {
+    if ('value' in match) {
+        const value = match['value'];
+        if (typeof value === 'number')
+            return `${column} = ${value}`;
+        if (typeof value === 'boolean')
+            return `${column} = ${value}`;
+        return `${column} = ${sqlLiteral(String(value))}`;
+    }
+    if ('any' in match) {
+        const list = Array.isArray(match['any']) ? match['any'] : [];
+        if (list.length === 0)
+            return '1 = 0';
+        const inList = list.map((v) => (typeof v === 'number' ? String(v) : sqlLiteral(String(v)))).join(', ');
+        return `${column} IN (${inList})`;
+    }
+    throw new Error(`Unsupported Lance match clause: ${JSON.stringify(match)}`);
+}
+function renderCondition(condition) {
+    if ('should' in condition) {
+        const branches = Array.isArray(condition['should']) ? condition['should'] : [];
+        if (branches.length === 0)
+            return '1 = 1';
+        return `(${branches.map((b) => renderCondition(b)).join(' OR ')})`;
+    }
+    if ('must' in condition) {
+        const inner = Array.isArray(condition['must']) ? condition['must'] : [];
+        return `(${inner.map((b) => renderCondition(b)).join(' AND ')})`;
+    }
+    if ('is_empty' in condition) {
+        const isEmpty = condition['is_empty'];
+        const column = isEmpty?.key ? columnForKey(isEmpty.key) : undefined;
+        if (!column)
+            throw new Error(`Unsupported is_empty key: ${isEmpty?.key}`);
+        return `(${column} IS NULL OR ${column} = '')`;
+    }
+    const key = condition['key'];
+    const match = condition['match'];
+    if (!key || !match)
+        throw new Error(`Unsupported Lance condition: ${JSON.stringify(condition)}`);
+    const column = columnForKey(key);
+    if (!column)
+        throw new Error(`Cannot filter on unpromoted payload key: ${key}`);
+    return renderMatch(column, match);
+}
+/**
+ * Build a LanceQL `WHERE` string from Qdrant-style `must` / `must_not` arrays.
+ * Returns undefined when there is nothing to constrain (match-all).
+ */
+export function buildWhere(filter) {
+    const must = filter.must ?? [];
+    const mustNot = filter.must_not ?? [];
+    const parts = [];
+    if (must.length > 0)
+        parts.push(`(${must.map(renderCondition).join(' AND ')})`);
+    for (const neg of mustNot)
+        parts.push(`NOT (${renderCondition(neg)})`);
+    if (parts.length === 0)
+        return undefined;
+    return parts.join(' AND ');
+}
+function readString(payload, key) {
+    const v = payload[key];
+    return typeof v === 'string' ? v : '';
+}
+/** Convert a Qdrant-shaped point to a Lance row (payload verbatim, scalars promoted). */
+export function toRow(point) {
+    const payload = point.payload ?? {};
+    const adapter = (payload['adapter'] ?? {});
+    const artifact = (payload['artifact'] ?? {});
+    const protocol = (payload['protocol'] ?? {});
+    const row = {
+        id: String(point.id),
+        space_id: typeof payload['space_id'] === 'string' && payload['space_id'].length > 0
+            ? payload['space_id']
+            : SQUADRULES_APP_SPACE_ID,
+        slug: readString(payload, 'slug'),
+        adapter_id: typeof adapter['id'] === 'string' ? adapter['id'] : '',
+        layer_index: typeof adapter['layer_index'] === 'number' ? adapter['layer_index'] : 0,
+        layer_count: typeof adapter['layer_count'] === 'number' ? adapter['layer_count'] : 0,
+        protocol_version: typeof adapter['protocol_version'] === 'string' ? adapter['protocol_version'] : '',
+        content_type: readString(payload, 'content_type'),
+        protocol_id: readString(payload, 'protocol_id'),
+        domain: readString(payload, 'domain'),
+        task: readString(payload, 'task'),
+        type: readString(payload, 'type'),
+        artifact_slug: typeof artifact['slug'] === 'string' ? artifact['slug'] : '',
+        protocol_step: typeof protocol['step'] === 'number' ? protocol['step'] : 0,
+        created_at: readString(payload, 'created_at'),
+        payload: JSON.stringify(payload),
+        bm25_json: ''
+    };
+    const vector = point.vector ?? {};
+    const bm25 = vector['bm25'];
+    if (bm25 && typeof bm25 === 'object')
+        row.bm25_json = JSON.stringify(bm25);
+    for (const [name, value] of Object.entries(vector)) {
+        if (name === 'bm25')
+            continue;
+        if (Array.isArray(value) && value.every((n) => typeof n === 'number')) {
+            row[name] = value;
+        }
+    }
+    return row;
+}
+//# sourceMappingURL=lance-records-schema.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Lance read-side semantic search (JS cosine).
+ *
+ * LanceDB's `nearestTo` requires a FixedSizeList column, but a data-inferred
+ * embedding column is a variable `List<Float64>`; rather than hand-author an
+ * Arrow schema (the recorded pitfall) we scan the adapter heads in the allowed
+ * spaces and score them in JS. The three stored dense vectors map onto the same
+ * terms the Qdrant formula boosts (primary relevance + adapter-title match +
+ * activation-pattern match), the scalar `label`/`tags` text matches and the
+ * stored `attest_boost`, and the post-processing (drop built-in footers, sort by
+ * score then uuid, slice, fall back to a flat score) mirrors `vectorSearch` so
+ * activation/train search sees the same ordering contract.
+ */
+import type { Memory } from '../../../types/memory.js';
+import type { LanceRecordEngine } from './lance-records-engine.js';
+export declare class LanceRecordSearch {
+    private readonly engine;
+    constructor(engine: LanceRecordEngine);
+    /** Full hybrid-style ranking over the three dense legs + text boosts. */
+    searchMemories(query: string, limit: number): Promise<{
+        memories: Memory[];
+        scores: number[];
+    }>;
+    /** Adapter-title similarity gate (mirrors `searchAdapterTitlesBySimilarity`). */
+    searchAdapterTitlesBySimilarity(query: string, limit: number): Promise<{
+        memories: Memory[];
+        scores: number[];
+    }>;
+}
+//# sourceMappingURL=lance-records-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-search.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAevD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAmEnE,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEtD,yEAAyE;IACnE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAwBrG,iFAAiF;IAC3E,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAYvH"}

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

@@ -0,0 +1,112 @@
+import { embeddingService } from '../../embedding/service.js';
+import { getSearchSpaceIds } from '../../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../../utils/space-filter.js';
+import { SQUADRULES_CREATION_PROTOCOL_SLUG, SQUADRULES_REFINING_PROTOCOL_SLUG, memoryIsBuiltinSearchFooterProtocol } from '../../../constants/builtin-search-meta.js';
+import { getActivationPatternVectorName, getAdapterTitleVectorName, getPrimaryVectorName } from '../../../utils/qdrant-vector-types.js';
+import { pointToMemory } from '../../memory/qdrant-point-to-memory.js';
+import { toNumberArray } from './lance-records-schema.js';
+const TITLE_MATCH_BOOST = 0.45;
+const ACTIVATION_PATTERN_MATCH_BOOST = 0.35;
+const LABEL_MATCH_BOOST = 0.15;
+const TAG_MATCH_BOOST = 0.05;
+function payloadOf(row) {
+    return JSON.parse(row.payload);
+}
+function cosine(a, b) {
+    if (!a || !b || a.length === 0 || a.length !== b.length)
+        return 0;
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        const x = a[i];
+        const y = b[i];
+        dot += x * y;
+        na += x * x;
+        nb += y * y;
+    }
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+function tokenize(text) {
+    return new Set((text || '').toLowerCase().split(/[^a-z0-9]+/).filter(Boolean));
+}
+/** Fraction of the query tokens present in the field text, capped to [0,1]. */
+function textMatch(queryTokens, fieldText) {
+    if (queryTokens.size === 0)
+        return 0;
+    const field = tokenize(fieldText);
+    let hits = 0;
+    for (const token of queryTokens)
+        if (field.has(token))
+            hits++;
+    return Math.min(hits / queryTokens.size, 1);
+}
+function headFilter() {
+    const base = buildSpaceFilter(getSearchSpaceIds(), {
+        must: [{ key: 'adapter.layer_index', match: { value: 1 } }]
+    });
+    return {
+        ...base,
+        must_not: [{ key: 'slug', match: { any: [SQUADRULES_REFINING_PROTOCOL_SLUG, SQUADRULES_CREATION_PROTOCOL_SLUG] } }]
+    };
+}
+function finalize(scored, limit, fallbackScore) {
+    let filtered = scored
+        .filter((e) => e.score > 0 && !memoryIsBuiltinSearchFooterProtocol(e.memory))
+        .sort((a, b) => (b.score !== a.score ? b.score - a.score : (a.memory.memory_uuid ?? '').localeCompare(b.memory.memory_uuid ?? '')))
+        .slice(0, limit);
+    if (filtered.length === 0 && scored.length > 0 && fallbackScore !== null) {
+        filtered = scored
+            .filter((e) => !memoryIsBuiltinSearchFooterProtocol(e.memory))
+            .slice(0, limit)
+            .map((e) => ({ memory: e.memory, score: fallbackScore }));
+    }
+    return { memories: filtered.map((e) => e.memory), scores: filtered.map((e) => e.score) };
+}
+export class LanceRecordSearch {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /** Full hybrid-style ranking over the three dense legs + text boosts. */
+    async searchMemories(query, limit) {
+        const queryKey = (query || '').trim();
+        if (!queryKey)
+            return { memories: [], scores: [] };
+        const { embedding: queryVector } = await embeddingService.generateEmbedding(queryKey);
+        const primaryName = getPrimaryVectorName(queryVector.length);
+        const titleName = getAdapterTitleVectorName(queryVector.length);
+        const activationName = getActivationPatternVectorName(queryVector.length);
+        const queryTokens = tokenize(queryKey);
+        const rows = await this.engine.scroll(headFilter());
+        const scored = rows.map((row) => {
+            const payload = payloadOf(row);
+            const memory = pointToMemory({ id: row.id, payload });
+            const score = cosine(queryVector, toNumberArray(row[primaryName])) +
+                TITLE_MATCH_BOOST * cosine(queryVector, toNumberArray(row[titleName])) +
+                ACTIVATION_PATTERN_MATCH_BOOST * cosine(queryVector, toNumberArray(row[activationName])) +
+                LABEL_MATCH_BOOST * textMatch(queryTokens, typeof payload.label_text === 'string' ? payload.label_text : payload.label || '') +
+                TAG_MATCH_BOOST * textMatch(queryTokens, typeof payload.tags_text === 'string' ? payload.tags_text : (payload.tags || []).join(' ')) +
+                (typeof payload.attest_boost === 'number' ? payload.attest_boost : 0);
+            return { memory, score };
+        });
+        return finalize(scored, limit, 0.5);
+    }
+    /** Adapter-title similarity gate (mirrors `searchAdapterTitlesBySimilarity`). */
+    async searchAdapterTitlesBySimilarity(query, limit) {
+        const queryKey = (query || '').trim();
+        if (!queryKey)
+            return { memories: [], scores: [] };
+        const { embedding: queryVector } = await embeddingService.generateEmbedding(queryKey);
+        const titleName = getAdapterTitleVectorName(queryVector.length);
+        const rows = await this.engine.scroll(headFilter());
+        const scored = rows.map((row) => ({
+            memory: pointToMemory({ id: row.id, payload: payloadOf(row) }),
+            score: cosine(queryVector, toNumberArray(row[titleName]))
+        }));
+        return finalize(scored, limit, null);
+    }
+}
+//# sourceMappingURL=lance-records-search.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { Memory } from '../../../types/memory.js';
+import type { StoreArtifactOptions } from '../../memory/store-adapter.js';
+import type { LanceRecordEngine } from './lance-records-engine.js';
+import type { LanceWriteRepo } from './lance-records-write-helpers.js';
+export declare class LanceArtifactWriter {
+    private readonly engine;
+    private readonly repo;
+    constructor(engine: LanceRecordEngine, repo: LanceWriteRepo);
+    storeArtifact(content: string, options: StoreArtifactOptions): Promise<Memory[]>;
+}
+//# sourceMappingURL=lance-records-write-artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-write-artifact.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-write-artifact.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAavD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAqB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAhD,MAAM,EAAE,iBAAiB,EAAmB,IAAI,EAAE,cAAc;IAEvF,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoGvF"}

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

@@ -0,0 +1,121 @@
+/**
+ * Lance artifact write path.
+ *
+ * Mirrors `store-artifact.ts` exactly — chain-id normalization, artifact
+ * metadata + sha256, duplicate detection by slug/name, created-at/by preservation
+ * on force-update, and the zero-vector dense columns (artifacts carry no learned
+ * embeddings) — but persists through the Lance engine and resolves adapter anchors
+ * via `LanceWriteRepo`. Keeping the returned `Memory` shape identical means artifact
+ * export/search behaves the same as on Qdrant.
+ */
+import crypto from 'node:crypto';
+import { logger } from '../../../utils/structured-logger.js';
+import { getEmbeddingDimension } from '../../embedding/config.js';
+import { bm25Tokenizer } from '../../embedding/bm25-tokenizer.js';
+import { getActivationPatternVectorName, getAdapterTitleVectorName, getPrimaryVectorName } from '../../../utils/qdrant-vector-types.js';
+import { getSpaceContext } from '../../../utils/tenant-context.js';
+import { redisCacheService } from '../../redis-cache.js';
+import { parseSquadrulesUri } from '../../../tools/squadrules-uri.js';
+import { extractArtifactMetadata } from '../../memory/artifact-metadata.js';
+export class LanceArtifactWriter {
+    engine;
+    repo;
+    constructor(engine, repo) {
+        this.engine = engine;
+        this.repo = repo;
+    }
+    async storeArtifact(content, options) {
+        const parsed = parseSquadrulesUri(options.adapterUri);
+        if (parsed.kind !== 'adapter') {
+            throw new Error('adapterUri must be a squadrules://adapter/{slug|uuid} URI');
+        }
+        const { adapterId, adapterName } = await this.repo.resolveChainAdapterIdForArtifacts(parsed);
+        const slugSourceInput = typeof options.relativePath === 'string' && options.relativePath.trim().length > 0 ? options.relativePath.trim() : options.name;
+        const artifact = extractArtifactMetadata(content, slugSourceInput);
+        const sha256 = crypto.createHash('sha256').update(content, 'utf8').digest('hex');
+        const vectorSize = getEmbeddingDimension();
+        const zeroVector = Array.from({ length: vectorSize }, () => 0);
+        const context = getSpaceContext();
+        const spaceId = context.defaultWriteSpaceId;
+        const actorId = context.userId || 'system';
+        const now = new Date().toISOString();
+        const normalizedArtifactName = options.name.trim().toLowerCase();
+        const existingPoints = await this.repo.listExistingArtifactPoints(spaceId, adapterId);
+        const matchingPoints = existingPoints.filter((point) => {
+            const artifactPayload = (point.payload['artifact'] ?? {});
+            const existingSlug = typeof artifactPayload['slug'] === 'string' ? artifactPayload['slug'].trim().toLowerCase() : '';
+            const existingName = typeof artifactPayload['name'] === 'string' ? artifactPayload['name'].trim().toLowerCase() : '';
+            if (artifact.slug_source === 'header')
+                return existingSlug === artifact.slug.toLowerCase();
+            return existingName === normalizedArtifactName || existingSlug === artifact.slug.toLowerCase();
+        });
+        matchingPoints.sort((a, b) => a.id.localeCompare(b.id));
+        if (matchingPoints.length > 0 && !options.forceUpdate) {
+            throw new Error(`Artifact "${options.name}" already exists on this adapter`);
+        }
+        const existingPoint = options.forceUpdate ? matchingPoints[0] : undefined;
+        const existingCreatedAt = typeof existingPoint?.payload['created_at'] === 'string' && existingPoint.payload['created_at'].trim().length > 0
+            ? existingPoint.payload['created_at'].trim()
+            : now;
+        const existingCreatedBy = typeof existingPoint?.payload['created_by'] === 'string' && existingPoint.payload['created_by'].trim().length > 0
+            ? existingPoint.payload['created_by'].trim()
+            : actorId;
+        const memoryUuid = existingPoint?.id ?? crypto.randomUUID();
+        const tags = ['artifact', options.mime.replace('text/', ''), `artifact:${artifact.slug}`];
+        const sparseText = `${options.name}\n${artifact.slug}\n${content.slice(0, 4096)}`;
+        const bm25 = bm25Tokenizer.tokenize(sparseText);
+        const point = {
+            id: memoryUuid,
+            vector: {
+                [getPrimaryVectorName(vectorSize)]: zeroVector,
+                [getAdapterTitleVectorName(vectorSize)]: zeroVector,
+                [getActivationPatternVectorName(vectorSize)]: zeroVector,
+                bm25: { indices: bm25.indices, values: bm25.values }
+            },
+            payload: {
+                space_id: spaceId,
+                label: options.name,
+                tags,
+                text: content,
+                llm_model_id: options.llmModelId,
+                created_at: existingCreatedAt,
+                created_by: existingCreatedBy,
+                modified_at: now,
+                modified_by: actorId,
+                content_type: options.mime,
+                artifact: {
+                    slug: artifact.slug,
+                    version: artifact.version,
+                    name: options.name,
+                    sha256,
+                    ...(typeof options.relativePath === 'string' && options.relativePath.trim().length > 0 ? { relative_path: options.relativePath.trim() } : {})
+                },
+                adapter: { id: adapterId, name: adapterName ?? options.name }
+            }
+        };
+        await this.engine.putPoints([point]);
+        logger.tool('lance-store', 'upsert', `artifact adapter=${adapterId} slug=${artifact.slug}`);
+        await redisCacheService.invalidateAfterUpdate();
+        return [
+            {
+                memory_uuid: memoryUuid,
+                space_id: spaceId,
+                label: options.name,
+                tags,
+                text: content,
+                llm_model_id: options.llmModelId,
+                created_at: now,
+                content_type: options.mime,
+                artifact: {
+                    slug: artifact.slug,
+                    version: artifact.version,
+                    name: options.name,
+                    sha256,
+                    ...(typeof options.relativePath === 'string' && options.relativePath.trim().length > 0 ? { relative_path: options.relativePath.trim() } : {})
+                },
+                adapter: { id: adapterId, name: adapterName ?? options.name, layer_index: 0, layer_count: 0 }
+            }
+        ];
+    }
+}
+//# sourceMappingURL=lance-records-write-artifact.js.map

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

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

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

@@ -0,0 +1,52 @@
+import { type AdapterSlugMintInput } from '../../memory/store-adapter-helpers.js';
+import type { LanceRecordEngine } from './lance-records-engine.js';
+import type { LanceRecordSearch } from './lance-records-search.js';
+export declare class LanceWriteRepo {
+    private readonly engine;
+    private readonly search;
+    constructor(engine: LanceRecordEngine, search: LanceRecordSearch);
+    /** Points already stored under this adapter id (duplicate check). */
+    checkDuplicateAdapter(adapterUuid: string): Promise<{
+        points: Array<{
+            id: string;
+            payload: any;
+        }>;
+    }>;
+    /**
+     * Replace-or-reject an existing adapter. Mirrors `handleDuplicateAdapter`: throw
+     * DUPLICATE_ADAPTER unless force_update, block writes into protected spaces, then
+     * delete the old adapter rows so the mint re-creates a clean chain.
+     */
+    handleDuplicateAdapter(adapterUuid: string, forceUpdate: boolean): Promise<void>;
+    /** Slug collision scan within allowed spaces. */
+    scrollPointsWithSlug(slug: string): Promise<Array<{
+        id: string;
+        payload: any;
+    }>>;
+    /** Allocate a non-colliding slug (author exact-collision rejects; auto appends -2, -3…). */
+    allocateAdapterSlugForMint(input: AdapterSlugMintInput, newAdapterUuid: string): Promise<string>;
+    /** Title-similarity guard before mint (throws SIMILAR_MEMORY_FOUND above threshold). */
+    checkSimilarAdapterByTitle(adapterTitle: string, forceUpdate: boolean): Promise<void>;
+    /** Resolve an adapter head point id by slug (lowest id wins). */
+    resolveAdapterAnchorPointId(slug: string): Promise<string | null>;
+    resolveAdapterNameByAdapterId(adapterId: string): Promise<string | null>;
+    /** Normalize a slug / layer-id / chain-id adapter reference to its chain id + name. */
+    resolveChainAdapterIdForArtifacts(parsed: {
+        id: string;
+        idKind?: string;
+    }): Promise<{
+        adapterId: string;
+        adapterName: string | null;
+    }>;
+    /** Existing artifact points for an adapter+space (for duplicate detection). */
+    listExistingArtifactPoints(spaceId: string, adapterId: string): Promise<Array<{
+        id: string;
+        payload: any;
+    }>>;
+    /** Re-export domain/task/type for the writer's per-memory metric loop. */
+    deriveDomainTaskType(label: string, text: string, tags: string[]): {
+        task: string;
+        type: string;
+    };
+}
+//# sourceMappingURL=lance-records-write-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lance-records-write-helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/vector-store/lancedb/lance-records-write-helpers.ts"],"names":[],"mappings":"AAqBA,OAAO,EAA2D,KAAK,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC3I,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAYnE,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAqB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAlD,MAAM,EAAE,iBAAiB,EAAmB,MAAM,EAAE,iBAAiB;IAElG,qEAAqE;IAC/D,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,GAAG,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAQ1G;;;;OAIG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCtF,iDAAiD;IAC3C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAMtF,4FAA4F;IACtF,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCtG,wFAAwF;IAClF,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C3F,iEAAiE;IAC3D,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYjE,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY9E,uFAAuF;IACjF,iCAAiC,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAyB5I,+EAA+E;IACzE,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAYlH,0EAA0E;IAC1E,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAGlG"}