@rubytech/create-realagent 1.0.406

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest.js

@@ -0,0 +1,233 @@
+import { getSession } from "../lib/neo4j.js";
+import { embedBatch } from "../lib/embeddings.js";
+import { extractCache } from "./memory-ingest-extract.js";
+import { deleteDocumentChildren } from "../lib/document-hierarchy.js";
+export async function memoryIngest(params) {
+    const { accountId, attachmentId, documentSummary, sections, scope, entities, sourceUrl, sourceType, keywords: rawKeywords, userKeywords: rawUserKeywords, } = params;
+    if (!scope) {
+        throw new Error("scope is required — valid values: 'public', 'shared', 'admin', 'user:{identifier}'");
+    }
+    // Normalize and merge keywords: user-supplied ∪ LLM-extracted, deduplicated.
+    // User keywords appear first (cosmetic — both are equal after merge).
+    const normalizeArray = (arr) => arr.map((k) => k.toLowerCase().trim()).filter(Boolean);
+    const hasUserKeywords = rawUserKeywords && rawUserKeywords.length > 0;
+    const hasKeywords = rawKeywords && rawKeywords.length > 0;
+    const keywords = hasUserKeywords || hasKeywords
+        ? [...new Set([
+                ...normalizeArray(rawUserKeywords ?? []),
+                ...normalizeArray(rawKeywords ?? []),
+            ])]
+        : undefined;
+    const t0 = Date.now();
+    const log = (stage, detail) => console.error(`[memory-ingest] [${attachmentId.slice(0, 8)}] ${stage}${detail ? ` — ${detail}` : ""} (${Date.now() - t0}ms)`);
+    log("start", `${sections.length} sections, scope=${scope}`);
+    // 1. Retrieve cached content from memory-ingest-extract
+    const cached = extractCache.get(attachmentId);
+    if (!cached) {
+        throw new Error(`No cached extract found for attachment "${attachmentId}". ` +
+            `Call memory-ingest-extract first to extract and chunk the document.`);
+    }
+    log("cache-hit", cached.filename);
+    // Validate section count matches
+    if (sections.length !== cached.sections.length) {
+        throw new Error(`Section count mismatch: model provided ${sections.length} sections ` +
+            `but the extracted document has ${cached.sections.length} sections. ` +
+            `Provide exactly one summary per section returned by memory-ingest-extract.`);
+    }
+    // Validate chunk summary counts per section
+    for (let i = 0; i < sections.length; i++) {
+        const expectedChunks = cached.sections[i].chunks.length;
+        const providedSummaries = sections[i].chunkSummaries.length;
+        if (providedSummaries !== expectedChunks) {
+            throw new Error(`Chunk count mismatch in section "${sections[i].title}": ` +
+                `model provided ${providedSummaries} chunk summaries ` +
+                `but the section has ${expectedChunks} chunks.`);
+        }
+    }
+    const { filename, mimeType } = cached;
+    const now = new Date().toISOString();
+    // 2. Collect all texts that need embedding in a flat array.
+    const textsToEmbed = [];
+    // Document-level summary
+    textsToEmbed.push(documentSummary);
+    const docEmbedIdx = 0;
+    // Section-level summaries
+    const sectionEmbedIndices = [];
+    for (const section of sections) {
+        sectionEmbedIndices.push(textsToEmbed.length);
+        textsToEmbed.push(section.summary);
+    }
+    // Chunk-level summaries
+    const chunkEmbedIndices = [];
+    for (let si = 0; si < sections.length; si++) {
+        for (let ci = 0; ci < sections[si].chunkSummaries.length; ci++) {
+            chunkEmbedIndices.push({
+                sectionIdx: si,
+                chunkIdx: ci,
+                embedIdx: textsToEmbed.length,
+            });
+            textsToEmbed.push(sections[si].chunkSummaries[ci]);
+        }
+    }
+    // 3. Batch embed all summaries in a single Ollama call.
+    log("embedding", `${textsToEmbed.length} texts`);
+    const embeddings = await embedBatch(textsToEmbed);
+    log("embedded", `${embeddings.length} vectors`);
+    // 4. Write nodes to Neo4j.
+    log("neo4j-write", "starting");
+    const session = getSession();
+    let documentNodeId = "";
+    let totalChunks = 0;
+    let entityLinks = 0;
+    try {
+        // 4a. Create KnowledgeDocument node
+        // Build optional SET clauses for web-sourced properties.
+        // When sourceUrl/sourceType/keywords are undefined (file uploads),
+        // the corresponding SET lines are omitted — existing values preserved on re-ingest.
+        const optionalSets = [];
+        const optionalParams = {};
+        if (sourceUrl !== undefined) {
+            optionalSets.push("d.sourceUrl = $sourceUrl");
+            optionalParams.sourceUrl = sourceUrl;
+        }
+        if (sourceType !== undefined) {
+            optionalSets.push("d.sourceType = $sourceType");
+            optionalParams.sourceType = sourceType;
+        }
+        if (keywords !== undefined) {
+            optionalSets.push("d.keywords = $keywords");
+            optionalParams.keywords = keywords;
+        }
+        const optionalSetClause = optionalSets.length > 0
+            ? ", " + optionalSets.join(", ")
+            : "";
+        const docResult = await session.run(`MERGE (d:KnowledgeDocument { attachmentId: $attachmentId })
+       SET d.accountId      = $accountId,
+           d.name           = $filename,
+           d.encodingFormat  = $mimeType,
+           d.summary         = $documentSummary,
+           d.sectionCount    = $sectionCount,
+           d.scope           = $scope,
+           d.embedding       = $embedding,
+           d.createdAt       = $createdAt,
+           d.updatedAt       = $updatedAt
+           ${optionalSetClause}
+       RETURN elementId(d) AS nodeId`, {
+            attachmentId,
+            accountId,
+            filename,
+            mimeType,
+            documentSummary,
+            sectionCount: sections.length,
+            scope,
+            embedding: embeddings[docEmbedIdx],
+            createdAt: now,
+            updatedAt: now,
+            ...optionalParams,
+        });
+        documentNodeId = docResult.records[0].get("nodeId");
+        // 4a-cleanup. Remove stale children before re-creating.
+        // On first ingestion the queries return nothing and the DELETEs are no-ops.
+        // Also clear any soft-delete marker on the document itself (re-ingestion revives).
+        const cleanup = await deleteDocumentChildren(attachmentId, session);
+        if (cleanup.sections > 0 || cleanup.chunks > 0 || cleanup.references > 0) {
+            log("cleanup", `deleted ${cleanup.sections} sections, ${cleanup.chunks} chunks, ${cleanup.references} references`);
+        }
+        // Clear deletedAt if the document was previously soft-deleted
+        await session.run(`MATCH (d:KnowledgeDocument { attachmentId: $attachmentId })
+       WHERE d.deletedAt IS NOT NULL
+       REMOVE d.deletedAt`, { attachmentId });
+        // 4b. Create Section nodes and link HAS_SECTION
+        const sectionNodeIds = [];
+        for (let si = 0; si < sections.length; si++) {
+            const section = sections[si];
+            const sectionResult = await session.run(`CREATE (s:Section {
+           accountId:  $accountId,
+           title:      $title,
+           summary:    $summary,
+           position:   $position,
+           scope:      $scope,
+           embedding:  $embedding,
+           createdAt:  $createdAt,
+           updatedAt:  $updatedAt
+         })
+         RETURN elementId(s) AS nodeId`, {
+                accountId,
+                title: section.title,
+                summary: section.summary,
+                position: si,
+                scope,
+                embedding: embeddings[sectionEmbedIndices[si]],
+                createdAt: now,
+                updatedAt: now,
+            });
+            const sectionNodeId = sectionResult.records[0].get("nodeId");
+            sectionNodeIds.push(sectionNodeId);
+            // Link KnowledgeDocument -[HAS_SECTION]-> Section
+            await session.run(`MATCH (d), (s)
+         WHERE elementId(d) = $docId AND elementId(s) = $sectionId
+         CREATE (d)-[:HAS_SECTION]->(s)`, { docId: documentNodeId, sectionId: sectionNodeId });
+        }
+        // 4c. Create Chunk nodes and link HAS_CHUNK — content from cache
+        for (const { sectionIdx, chunkIdx, embedIdx } of chunkEmbedIndices) {
+            const cachedChunk = cached.sections[sectionIdx].chunks[chunkIdx];
+            const chunkSummary = sections[sectionIdx].chunkSummaries[chunkIdx];
+            const chunkResult = await session.run(`CREATE (c:Chunk {
+           accountId:  $accountId,
+           summary:    $summary,
+           content:    $content,
+           position:   $position,
+           scope:      $scope,
+           embedding:  $embedding,
+           createdAt:  $createdAt,
+           updatedAt:  $updatedAt
+         })
+         RETURN elementId(c) AS nodeId`, {
+                accountId,
+                summary: chunkSummary,
+                content: cachedChunk.content,
+                position: chunkIdx,
+                scope,
+                embedding: embeddings[embedIdx],
+                createdAt: now,
+                updatedAt: now,
+            });
+            const chunkNodeId = chunkResult.records[0].get("nodeId");
+            totalChunks++;
+            // Link Section -[HAS_CHUNK]-> Chunk
+            await session.run(`MATCH (s), (c)
+         WHERE elementId(s) = $sectionId AND elementId(c) = $chunkId
+         CREATE (s)-[:HAS_CHUNK]->(c)`, { sectionId: sectionNodeIds[sectionIdx], chunkId: chunkNodeId });
+        }
+        // 4d. Create REFERENCES links to entities
+        if (entities && entities.length > 0) {
+            for (const entity of entities) {
+                try {
+                    await session.run(`MATCH (d), (e)
+             WHERE elementId(d) = $docId AND elementId(e) = $entityId
+             MERGE (d)-[:REFERENCES]->(e)`, { docId: documentNodeId, entityId: entity.nodeId });
+                    entityLinks++;
+                }
+                catch {
+                    // Entity node may have been deleted — skip silently, log via caller
+                }
+            }
+        }
+        log("neo4j-done", `doc=${documentNodeId.slice(0, 12)} sections=${sections.length} chunks=${totalChunks} entityLinks=${entityLinks}`);
+        return {
+            documentNodeId,
+            sectionCount: sections.length,
+            chunkCount: totalChunks,
+            entityLinks,
+            documentSummary,
+            keywords,
+        };
+    }
+    finally {
+        // Evict cache entry — content is now persisted in Neo4j
+        extractCache.delete(attachmentId);
+        await session.close();
+        log("complete");
+    }
+}
+//# sourceMappingURL=memory-ingest.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/memory-list-attachments.d.ts

@@ -0,0 +1,17 @@
+export interface AttachmentEntry {
+    attachmentId: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    storedAt: string;
+    ingested: boolean;
+    softDeleted: boolean;
+}
+export interface ListResult {
+    entries: AttachmentEntry[];
+    totalFiles: number;
+    ingestedCount: number;
+    skippedCount: number;
+}
+export declare function memoryListAttachments(accountId: string): Promise<ListResult>;
+//# sourceMappingURL=memory-list-attachments.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-list-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-list-attachments.d.ts","sourceRoot":"","sources":["../../src/tools/memory-list-attachments.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAwGrB"}

package/payload/platform/plugins/memory/mcp/dist/tools/memory-list-attachments.js

@@ -0,0 +1,86 @@
+import { readdir, readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { getSession } from "../lib/neo4j.js";
+import { ATTACHMENTS_ROOT, } from "../lib/attachments.js";
+export async function memoryListAttachments(accountId) {
+    const t0 = Date.now();
+    const log = (stage, detail) => console.error(`[memory-list-attachments] [${accountId.slice(0, 8)}] ${stage}${detail ? ` — ${detail}` : ""} (${Date.now() - t0}ms)`);
+    log("start");
+    const accountDir = resolve(ATTACHMENTS_ROOT, accountId);
+    if (!existsSync(accountDir)) {
+        log("empty", "no attachments directory");
+        return { entries: [], totalFiles: 0, ingestedCount: 0, skippedCount: 0 };
+    }
+    // Read all attachment subdirectories
+    const subdirs = await readdir(accountDir);
+    const entries = [];
+    let skippedCount = 0;
+    for (const subdir of subdirs) {
+        const metaPath = resolve(accountDir, subdir, `${subdir}.meta.json`);
+        if (!existsSync(metaPath)) {
+            skippedCount++;
+            continue;
+        }
+        try {
+            const raw = await readFile(metaPath, "utf-8");
+            const meta = JSON.parse(raw);
+            entries.push({
+                attachmentId: meta.attachmentId,
+                filename: meta.filename,
+                mimeType: meta.mimeType,
+                sizeBytes: meta.sizeBytes,
+                storedAt: meta.storedAt,
+                ingested: false,
+                softDeleted: false,
+            });
+        }
+        catch {
+            log("skip", `corrupt meta.json for ${subdir}`);
+            skippedCount++;
+        }
+    }
+    if (entries.length === 0) {
+        log("empty", "no valid meta.json files found");
+        return { entries, totalFiles: 0, ingestedCount: 0, skippedCount };
+    }
+    // Cross-reference with Neo4j for ingestion status
+    const session = getSession();
+    try {
+        const attachmentIds = entries.map((e) => e.attachmentId);
+        const result = await session.run(`MATCH (k:KnowledgeDocument { accountId: $accountId })
+       WHERE k.attachmentId IN $attachmentIds
+       RETURN k.attachmentId AS aid, k.deletedAt AS deletedAt`, { accountId, attachmentIds });
+        const ingestionMap = new Map();
+        for (const record of result.records) {
+            const aid = record.get("aid");
+            const deletedAt = record.get("deletedAt");
+            ingestionMap.set(aid, {
+                ingested: true,
+                softDeleted: deletedAt != null,
+            });
+        }
+        let ingestedCount = 0;
+        for (const entry of entries) {
+            const status = ingestionMap.get(entry.attachmentId);
+            if (status) {
+                entry.ingested = status.ingested;
+                entry.softDeleted = status.softDeleted;
+                ingestedCount++;
+            }
+        }
+        // Sort by storedAt descending (newest first)
+        entries.sort((a, b) => new Date(b.storedAt).getTime() - new Date(a.storedAt).getTime());
+        log("done", `${entries.length} files, ${ingestedCount} ingested, ${skippedCount} skipped`);
+        return {
+            entries,
+            totalFiles: entries.length,
+            ingestedCount,
+            skippedCount,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=memory-list-attachments.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-list-attachments.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/memory-read-attachment.d.ts

@@ -0,0 +1,12 @@
+export interface ReadResult {
+    attachmentId: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    storedAt: string;
+    content?: string;
+    contentNote?: string;
+    httpUrl?: string;
+}
+export declare function memoryReadAttachment(accountId: string, attachmentId: string): Promise<ReadResult>;
+//# sourceMappingURL=memory-read-attachment.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-read-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-read-attachment.d.ts","sourceRoot":"","sources":["../../src/tools/memory-read-attachment.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC,CAsGrB"}

package/payload/platform/plugins/memory/mcp/dist/tools/memory-read-attachment.js

@@ -0,0 +1,100 @@
+import { readFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { assertUUID, readMeta, findDataFile, } from "../lib/attachments.js";
+// ---------------------------------------------------------------------------
+// memory-read-attachment — read a stored attachment's content from disk.
+//
+// META.JSON ──▶ MIME CHECK ──▶ READ/EXTRACT ──▶ RETURN
+//                  │               │
+//                  ▼               ▼
+//             [image?]        [text → raw]
+//             → metadata      [pdf → pdftotext]
+//               + URL
+// ---------------------------------------------------------------------------
+const execFileAsync = promisify(execFile);
+export async function memoryReadAttachment(accountId, attachmentId) {
+    assertUUID(attachmentId, "attachmentId");
+    const t0 = Date.now();
+    const tag = attachmentId.slice(0, 8);
+    const log = (stage, detail) => console.error(`[memory-read-attachment] [${tag}] ${stage}${detail ? ` — ${detail}` : ""} (${Date.now() - t0}ms)`);
+    log("start");
+    const meta = await readMeta(accountId, attachmentId);
+    if (!meta) {
+        throw new Error(`Attachment "${attachmentId}" not found. ` +
+            `No metadata file exists for this attachment in this account.`);
+    }
+    const dataFile = await findDataFile(accountId, attachmentId);
+    if (!dataFile) {
+        throw new Error(`Attachment "${attachmentId}" metadata exists but the data file is missing.`);
+    }
+    const { filename, mimeType, sizeBytes, storedAt } = meta;
+    // Images: return metadata + URL only (binary content not useful in text response)
+    if (mimeType.startsWith("image/")) {
+        log("image", `${filename} — metadata only`);
+        return {
+            attachmentId,
+            filename,
+            mimeType,
+            sizeBytes,
+            storedAt,
+            contentNote: "Image files are returned as metadata only. " +
+                "Use the HTTP URL to view the image in the chat UI.",
+            httpUrl: `/api/admin/attachment/${attachmentId}`,
+        };
+    }
+    // Text/markdown: return full content
+    if (mimeType === "text/plain" || mimeType === "text/markdown") {
+        const content = await readFile(dataFile, "utf-8");
+        log("text", `${filename} — ${content.length} chars`);
+        return {
+            attachmentId,
+            filename,
+            mimeType,
+            sizeBytes,
+            storedAt,
+            content,
+        };
+    }
+    // PDF: extract text via pdftotext
+    if (mimeType === "application/pdf") {
+        log("pdf-extract", filename);
+        try {
+            const { stdout } = await execFileAsync("pdftotext", [dataFile, "-"], {
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            const content = stdout.trim();
+            log("pdf-extracted", `${content.length} chars`);
+            return {
+                attachmentId,
+                filename,
+                mimeType,
+                sizeBytes,
+                storedAt,
+                content,
+                contentNote: "This is extracted text from a PDF. " +
+                    "The original layout and formatting are not preserved.",
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("ENOENT") || msg.includes("not found")) {
+                throw new Error("pdftotext not found. Install poppler-utils: sudo apt-get install -y poppler-utils");
+            }
+            throw new Error(`PDF text extraction failed: ${msg}`);
+        }
+    }
+    // CSV and other types: return metadata only with explanation
+    log("unsupported-content", `${filename} (${mimeType}) — metadata only`);
+    return {
+        attachmentId,
+        filename,
+        mimeType,
+        sizeBytes,
+        storedAt,
+        contentNote: `Content reading is not supported for MIME type "${mimeType}". ` +
+            `Supported for reading: text/plain, text/markdown, application/pdf. ` +
+            `Images return metadata and HTTP URL.`,
+    };
+}
+//# sourceMappingURL=memory-read-attachment.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-read-attachment.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/memory-reindex.d.ts

@@ -0,0 +1,8 @@
+interface ReindexResult {
+    nodesProcessed: number;
+    nodesSkipped: number;
+    errors: string[];
+}
+export declare function memoryReindex(accountId: string): Promise<ReindexResult>;
+export {};
+//# sourceMappingURL=memory-reindex.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-reindex.d.ts","sourceRoot":"","sources":["../../src/tools/memory-reindex.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA4ExB"}

package/payload/platform/plugins/memory/mcp/dist/tools/memory-reindex.js

@@ -0,0 +1,71 @@
+import { getSession } from "../lib/neo4j.js";
+import { embedBatch } from "../lib/embeddings.js";
+export async function memoryReindex(accountId) {
+    const session = getSession();
+    const batchSize = 50;
+    let nodesProcessed = 0;
+    let nodesSkipped = 0;
+    const errors = [];
+    try {
+        // Find all nodes missing embeddings or with stale embeddings
+        const countResult = await session.run(`MATCH (n) WHERE n.accountId = $accountId AND n.embedding IS NULL RETURN count(n) AS total`, { accountId });
+        const total = countResult.records[0].get("total").toNumber();
+        if (total === 0) {
+            return { nodesProcessed: 0, nodesSkipped: 0, errors: [] };
+        }
+        // Process in batches
+        let offset = 0;
+        while (offset < total) {
+            const batchResult = await session.run(`MATCH (n)
+         WHERE n.accountId = $accountId AND n.embedding IS NULL
+         RETURN elementId(n) AS nodeId, labels(n) AS nodeLabels, properties(n) AS props
+         SKIP $offset LIMIT $batchSize`, { accountId, offset, batchSize });
+            if (batchResult.records.length === 0)
+                break;
+            const texts = [];
+            const nodeIds = [];
+            for (const record of batchResult.records) {
+                const nodeId = record.get("nodeId");
+                const labels = record.get("nodeLabels");
+                const props = record.get("props");
+                const text = buildTextForEmbedding(labels, props);
+                if (text.length < 5) {
+                    nodesSkipped++;
+                    continue;
+                }
+                texts.push(text);
+                nodeIds.push(nodeId);
+            }
+            if (texts.length > 0) {
+                try {
+                    const embeddings = await embedBatch(texts);
+                    for (let i = 0; i < nodeIds.length; i++) {
+                        await session.run(`MATCH (n) WHERE elementId(n) = $nodeId SET n.embedding = $embedding`, { nodeId: nodeIds[i], embedding: embeddings[i] });
+                    }
+                    nodesProcessed += texts.length;
+                }
+                catch (err) {
+                    errors.push(`Batch at offset ${offset}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            offset += batchSize;
+        }
+        return { nodesProcessed, nodesSkipped, errors };
+    }
+    finally {
+        await session.close();
+    }
+}
+function buildTextForEmbedding(labels, properties) {
+    const parts = [`[${labels.join(", ")}]`];
+    for (const [key, value] of Object.entries(properties)) {
+        if (value !== null &&
+            value !== undefined &&
+            key !== "embedding" &&
+            key !== "accountId") {
+            parts.push(`${key}: ${String(value)}`);
+        }
+    }
+    return parts.join(" | ");
+}
+//# sourceMappingURL=memory-reindex.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-reindex.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/memory-rename-attachment.d.ts

@@ -0,0 +1,13 @@
+export interface RenameParams {
+    accountId: string;
+    attachmentId: string;
+    newFilename: string;
+}
+export interface RenameResult {
+    attachmentId: string;
+    oldFilename: string;
+    newFilename: string;
+    graphUpdated: boolean;
+}
+export declare function memoryRenameAttachment(params: RenameParams): Promise<RenameResult>;
+//# sourceMappingURL=memory-rename-attachment.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-rename-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-rename-attachment.d.ts","sourceRoot":"","sources":["../../src/tools/memory-rename-attachment.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA6EvB"}