@rubytech/create-realagent 1.0.406

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

@@ -0,0 +1,63 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { getSession } from "../lib/neo4j.js";
+import { assertUUID, readMeta, attachmentDir, } from "../lib/attachments.js";
+export async function memoryRenameAttachment(params) {
+    const { accountId, attachmentId, newFilename } = params;
+    assertUUID(attachmentId, "attachmentId");
+    if (!newFilename || newFilename.trim().length === 0) {
+        throw new Error("newFilename must not be empty.");
+    }
+    const trimmedName = newFilename.trim();
+    const t0 = Date.now();
+    const tag = attachmentId.slice(0, 8);
+    const log = (stage, detail) => console.error(`[memory-rename-attachment] [${tag}] ${stage}${detail ? ` — ${detail}` : ""} (${Date.now() - t0}ms)`);
+    log("start", `→ "${trimmedName}"`);
+    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 oldFilename = meta.filename;
+    if (oldFilename === trimmedName) {
+        log("no-op", "filename unchanged");
+        return { attachmentId, oldFilename, newFilename: trimmedName, graphUpdated: false };
+    }
+    // Update Neo4j first — if this fails, nothing has changed on disk
+    let graphUpdated = false;
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (d:KnowledgeDocument { attachmentId: $attachmentId, accountId: $accountId })
+       SET d.name = $newFilename, d.updatedAt = $updatedAt
+       RETURN count(d) AS updated`, {
+            attachmentId,
+            accountId,
+            newFilename: trimmedName,
+            updatedAt: new Date().toISOString(),
+        });
+        graphUpdated =
+            (result.records[0]?.get("updated")?.toNumber?.() ?? 0) > 0;
+        if (graphUpdated) {
+            log("graph-updated", `"${oldFilename}" → "${trimmedName}"`);
+        }
+        else {
+            log("graph-skipped", "no KnowledgeDocument node for this attachment");
+        }
+    }
+    finally {
+        await session.close();
+    }
+    // Update .meta.json
+    const updatedMeta = { ...meta, filename: trimmedName };
+    const metaPath = resolve(attachmentDir(accountId, attachmentId), `${attachmentId}.meta.json`);
+    await writeFile(metaPath, JSON.stringify(updatedMeta, null, 2));
+    log("meta-updated");
+    log("complete", `"${oldFilename}" → "${trimmedName}"`);
+    return {
+        attachmentId,
+        oldFilename,
+        newFilename: trimmedName,
+        graphUpdated,
+    };
+}
+//# sourceMappingURL=memory-rename-attachment.js.map

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

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

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

@@ -0,0 +1,34 @@
+interface SearchParams {
+    query: string;
+    labels?: string[];
+    accountId?: string;
+    limit?: number;
+    expandHops?: number;
+    /** When set, only nodes whose `scope` is in this list (or IS NULL) are returned. Omit for unrestricted (admin). */
+    allowedScopes?: string[];
+    /** When set, filter results to nodes whose `keywords` array contains these values. Nodes without a `keywords` property pass through (vector similarity alone determines relevance). */
+    keywords?: string[];
+    /** "any" (default) = OR semantics, "all" = AND semantics. Only used when keywords is set. */
+    keywordMatch?: "any" | "all";
+    /** When set, filter to nodes where this slug is in the node's `agents` array. */
+    agentSlug?: string;
+    /** When set, run BM25 queries per keyword and union results with directly-tagged nodes. */
+    keywordSubscriptions?: string[];
+}
+interface SearchResult {
+    nodeId: string;
+    labels: string[];
+    properties: Record<string, unknown>;
+    score: number;
+    related: Array<{
+        relationship: string;
+        direction: string;
+        labels: string[];
+        properties: Record<string, unknown>;
+    }>;
+}
+/** Clear the index cache — call after schema changes. */
+export declare function clearIndexCache(): void;
+export declare function memorySearch(params: SearchParams): Promise<SearchResult[]>;
+export {};
+//# sourceMappingURL=memory-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-search.d.ts","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"AAyBA,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mHAAmH;IACnH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uLAAuL;IACvL,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC,CAAC;CACJ;AAiCD,yDAAyD;AACzD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAuFD,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsRhF"}

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

@@ -0,0 +1,380 @@
+import { int } from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+import { embed } from "../lib/embeddings.js";
+// ---------------------------------------------------------------------------
+// Hybrid search pipeline:
+//
+// QUERY ──▶ EMBED ──▶ VECTOR SEARCH (per index) ──▶ ┐
+//      │                                              ├──▶ MERGE ──▶ EXPAND ──▶ RESULTS
+//      └──────────▶ BM25 FULL-TEXT SEARCH ──────────▶ ┘
+//
+// Merge: normalise BM25 scores to [0,1] via min-max, then combine:
+//   combined = 0.7 * vector_score + 0.3 * normalised_bm25_score
+// Deduplicate by nodeId, taking the higher combined score.
+// Fall back to vector-only if the full-text index doesn't exist.
+//
+// Soft-deleted nodes (deletedAt IS NOT NULL) are excluded from ALL query paths:
+// vector search, BM25 search, property-based keyword search, and graph expand.
+// The filter is unconditional — no parameter controls it.
+// ---------------------------------------------------------------------------
+const VECTOR_WEIGHT = 0.7;
+const BM25_WEIGHT = 0.3;
+const FULLTEXT_INDEX_NAME = "knowledge_fulltext";
+// Cached vector index map — discovered from Neo4j at first query.
+let indexCache = null;
+/**
+ * Discover all vector indexes from Neo4j.
+ * Returns a map of label → index name.
+ */
+async function discoverIndexes() {
+    if (indexCache)
+        return indexCache;
+    const session = getSession();
+    try {
+        const result = await session.run(`SHOW INDEXES YIELD name, labelsOrTypes, type WHERE type = 'VECTOR' RETURN name, labelsOrTypes`);
+        indexCache = new Map();
+        for (const record of result.records) {
+            const name = record.get("name");
+            const labels = record.get("labelsOrTypes");
+            for (const label of labels) {
+                indexCache.set(label, name);
+            }
+        }
+        return indexCache;
+    }
+    finally {
+        await session.close();
+    }
+}
+/** Clear the index cache — call after schema changes. */
+export function clearIndexCache() {
+    indexCache = null;
+}
+/**
+ * Run BM25 full-text search against the knowledge_fulltext index.
+ * Returns empty array if the index doesn't exist (graceful fallback).
+ */
+async function bm25Search(queryText, accountId, limit, allowedScopes, keywordFilter, agentSlug) {
+    const session = getSession();
+    try {
+        const scopeClause = allowedScopes
+            ? "AND (node.scope IS NULL OR node.scope IN $allowedScopes)"
+            : "";
+        const agentClause = agentSlug
+            ? "AND node.agents IS NOT NULL AND $agentSlug IN node.agents"
+            : "";
+        const deletedAtClause = "AND node.deletedAt IS NULL";
+        const kwClause = keywordFilter?.clause ?? "";
+        // Escape Lucene special characters in the query
+        const escaped = queryText.replace(/[+\-&|!(){}[\]^"~*?:\\/]/g, "\\$&");
+        const result = await session.run(`CALL db.index.fulltext.queryNodes($indexName, $query)
+       YIELD node, score
+       WHERE node.accountId = $accountId
+       ${scopeClause}
+       ${agentClause}
+       ${deletedAtClause}
+       ${kwClause}
+       RETURN node, score, labels(node) AS nodeLabels, elementId(node) AS nodeId
+       ORDER BY score DESC
+       LIMIT $limit`, {
+            indexName: FULLTEXT_INDEX_NAME,
+            query: escaped,
+            accountId,
+            limit: int(limit),
+            ...(allowedScopes ? { allowedScopes } : {}),
+            ...(agentSlug ? { agentSlug } : {}),
+            ...(keywordFilter?.params ?? {}),
+        });
+        return result.records.map((r) => ({
+            nodeId: r.get("nodeId"),
+            labels: r.get("nodeLabels"),
+            properties: nodeToPlain(r.get("node").properties),
+            score: typeof r.get("score") === "number" ? r.get("score") : Number(r.get("score")),
+        }));
+    }
+    catch (err) {
+        // Full-text index may not exist yet — fall back to vector-only
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("index") || msg.includes("fulltext") || msg.includes("not found")) {
+            return [];
+        }
+        throw err;
+    }
+    finally {
+        await session.close();
+    }
+}
+/**
+ * Normalise BM25 scores to [0, 1] using min-max within the result set.
+ * If all scores are equal (or single result), returns 1.0 for all.
+ */
+function normaliseBm25Scores(scores) {
+    if (scores.length === 0)
+        return [];
+    const min = Math.min(...scores);
+    const max = Math.max(...scores);
+    const range = max - min;
+    if (range === 0)
+        return scores.map(() => 1.0);
+    return scores.map((s) => (s - min) / range);
+}
+export async function memorySearch(params) {
+    const { query: queryText, labels, accountId, limit = 10, expandHops = 1, allowedScopes, keywords, keywordMatch = "any", agentSlug, keywordSubscriptions, } = params;
+    const queryEmbedding = await embed(queryText);
+    const labelToIndex = await discoverIndexes();
+    const session = getSession();
+    // Build the keyword filter clause (applied inside vector + BM25 queries).
+    // When keywords are provided, nodes WITH a `keywords` property must match;
+    // nodes WITHOUT the property (e.g. Email) pass through unfiltered.
+    const keywordFn = keywordMatch === "all" ? "ALL" : "ANY";
+    const keywordClause = keywords && keywords.length > 0
+        ? `AND (node.keywords IS NULL OR ${keywordFn}(kw IN $keywords WHERE kw IN node.keywords))`
+        : "";
+    const keywordParams = keywords && keywords.length > 0
+        ? { keywords: keywords.map((k) => k.toLowerCase().trim()) }
+        : {};
+    try {
+        // --- Vector search ---
+        let indexesToQuery;
+        if (labels && labels.length > 0) {
+            indexesToQuery = labels
+                .map((l) => labelToIndex.get(l))
+                .filter((idx) => idx !== undefined);
+            if (indexesToQuery.length === 0) {
+                return [];
+            }
+        }
+        else {
+            indexesToQuery = [...new Set(labelToIndex.values())];
+        }
+        const scoredMap = new Map();
+        // Build scope clause — omit for admin (unrestricted), filter for scoped agents.
+        // IS NULL handles legacy nodes that predate the scope migration.
+        const scopeClause = allowedScopes
+            ? "AND (node.scope IS NULL OR node.scope IN $allowedScopes)"
+            : "";
+        const scopeParams = allowedScopes ? { allowedScopes } : {};
+        // Build per-agent tag clause — when set, only nodes explicitly tagged for this agent.
+        // Both agentSlug AND allowedScopes must pass (defense in depth).
+        const agentClause = agentSlug
+            ? "AND node.agents IS NOT NULL AND $agentSlug IN node.agents"
+            : "";
+        const agentParams = agentSlug ? { agentSlug } : {};
+        // Unconditional soft-delete filter — nodes with deletedAt set are never returned.
+        const deletedAtClause = "AND node.deletedAt IS NULL";
+        for (const indexName of indexesToQuery) {
+            const vectorQuery = `
+        CALL db.index.vector.queryNodes($indexName, $limit, $embedding)
+        YIELD node, score
+        WHERE node.accountId = $accountId
+        ${scopeClause}
+        ${agentClause}
+        ${deletedAtClause}
+        ${keywordClause}
+        RETURN node, score, labels(node) AS nodeLabels, elementId(node) AS nodeId
+        ORDER BY score DESC
+        LIMIT $limit
+      `;
+            const vectorResult = await session.run(vectorQuery, {
+                indexName,
+                embedding: queryEmbedding,
+                limit: int(limit),
+                accountId,
+                ...scopeParams,
+                ...agentParams,
+                ...keywordParams,
+            });
+            for (const record of vectorResult.records) {
+                const nodeId = record.get("nodeId");
+                const score = typeof record.get("score") === "number"
+                    ? record.get("score")
+                    : Number(record.get("score"));
+                const existing = scoredMap.get(nodeId);
+                if (existing) {
+                    existing.vectorScore = Math.max(existing.vectorScore, score);
+                }
+                else {
+                    scoredMap.set(nodeId, {
+                        nodeId,
+                        labels: record.get("nodeLabels"),
+                        properties: nodeToPlain(record.get("node").properties),
+                        vectorScore: score,
+                        bm25Score: 0,
+                    });
+                }
+            }
+        }
+        // --- BM25 search (knowledge documents only, graceful fallback) ---
+        const bm25KeywordFilter = keywordClause
+            ? { clause: keywordClause, params: keywordParams }
+            : undefined;
+        const bm25Results = await bm25Search(queryText, accountId, limit, allowedScopes, bm25KeywordFilter, agentSlug);
+        if (bm25Results.length > 0) {
+            const rawScores = bm25Results.map((r) => r.score);
+            const normalised = normaliseBm25Scores(rawScores);
+            for (let i = 0; i < bm25Results.length; i++) {
+                const r = bm25Results[i];
+                const existing = scoredMap.get(r.nodeId);
+                if (existing) {
+                    existing.bm25Score = Math.max(existing.bm25Score, normalised[i]);
+                }
+                else {
+                    scoredMap.set(r.nodeId, {
+                        nodeId: r.nodeId,
+                        labels: r.labels,
+                        properties: r.properties,
+                        vectorScore: 0,
+                        bm25Score: normalised[i],
+                    });
+                }
+            }
+        }
+        // --- Keyword subscription queries (per-agent reactive knowledge) ---
+        // When keywordSubscriptions are configured, two complementary searches run:
+        //   1. BM25 full-text search per keyword (catches content matches)
+        //   2. Property-based search on the node `keywords` array (catches tagged nodes)
+        // Both run WITHOUT the agentSlug clause — keyword matches are scope-inclusive
+        // by design. ALLOWED_SCOPES still applies (defense in depth).
+        //
+        // QUERY ──▶ BM25 per keyword ──────────────────▶ ┐
+        //      └──▶ Property match (node.keywords) ────▶ ├──▶ scoredMap (union)
+        //                                                 ┘
+        if (keywordSubscriptions && keywordSubscriptions.length > 0) {
+            // 1. BM25 full-text search per keyword (case-insensitive via analyzer)
+            for (const kw of keywordSubscriptions) {
+                const kwResults = await bm25Search(kw, accountId, limit, allowedScopes);
+                if (kwResults.length > 0) {
+                    const rawScores = kwResults.map((r) => r.score);
+                    const normalised = normaliseBm25Scores(rawScores);
+                    for (let i = 0; i < kwResults.length; i++) {
+                        const r = kwResults[i];
+                        const existing = scoredMap.get(r.nodeId);
+                        if (existing) {
+                            existing.bm25Score = Math.max(existing.bm25Score, normalised[i]);
+                        }
+                        else {
+                            scoredMap.set(r.nodeId, {
+                                nodeId: r.nodeId,
+                                labels: r.labels,
+                                properties: r.properties,
+                                vectorScore: 0,
+                                bm25Score: normalised[i],
+                            });
+                        }
+                    }
+                }
+            }
+            // 2. Property-based search: find nodes whose `keywords` array contains
+            //    any of the subscription keywords. Runs against ALL node labels (not
+            //    just KnowledgeDocument) since knowledge may be stored as DefinedTerm,
+            //    Question, Service, etc. Uses toLower() on both sides as a transitional
+            //    measure for existing mixed-case data.
+            const propScopeClause = allowedScopes
+                ? "AND (node.scope IS NULL OR node.scope IN $allowedScopes)"
+                : "";
+            const propResult = await session.run(`MATCH (node)
+         WHERE node.accountId = $accountId
+         AND node.deletedAt IS NULL
+         AND node.keywords IS NOT NULL
+         AND ANY(kw IN $kwSubs WHERE ANY(nk IN node.keywords WHERE toLower(nk) = kw))
+         ${propScopeClause}
+         RETURN node, labels(node) AS nodeLabels, elementId(node) AS nodeId
+         LIMIT $limit`, {
+                accountId,
+                kwSubs: keywordSubscriptions,
+                limit: int(limit),
+                ...(allowedScopes ? { allowedScopes } : {}),
+            });
+            for (const record of propResult.records) {
+                const nodeId = record.get("nodeId");
+                const existing = scoredMap.get(nodeId);
+                if (existing) {
+                    // Property match is exact — boost bm25Score to maximum
+                    existing.bm25Score = Math.max(existing.bm25Score, 1.0);
+                }
+                else {
+                    scoredMap.set(nodeId, {
+                        nodeId,
+                        labels: record.get("nodeLabels"),
+                        properties: nodeToPlain(record.get("node").properties),
+                        vectorScore: 0,
+                        bm25Score: 1.0,
+                    });
+                }
+            }
+        }
+        // --- Merge: combine vector + BM25 scores ---
+        const merged = [...scoredMap.values()].map((node) => ({
+            ...node,
+            combinedScore: VECTOR_WEIGHT * node.vectorScore + BM25_WEIGHT * node.bm25Score,
+        }));
+        merged.sort((a, b) => b.combinedScore - a.combinedScore);
+        const topResults = merged.slice(0, limit);
+        // --- Graph expand ---
+        const allResults = [];
+        for (const node of topResults) {
+            const result = {
+                nodeId: node.nodeId,
+                labels: node.labels,
+                properties: node.properties,
+                score: node.combinedScore,
+                related: [],
+            };
+            if (expandHops > 0) {
+                const expandScopeClause = allowedScopes
+                    ? "AND (related.scope IS NULL OR related.scope IN $allowedScopes)"
+                    : "";
+                // Per-agent expand filter: related nodes must be untagged or tagged for this agent.
+                // Prevents cross-agent content leakage via graph traversal.
+                const expandAgentClause = agentSlug
+                    ? "AND (related.agents IS NULL OR $agentSlug IN related.agents)"
+                    : "";
+                const expandQuery = `
+          MATCH (n)-[r]-(related)
+          WHERE elementId(n) = $nodeId
+          AND related.deletedAt IS NULL
+          ${expandScopeClause}
+          ${expandAgentClause}
+          RETURN type(r) AS relType,
+                 CASE WHEN startNode(r) = n THEN 'outgoing' ELSE 'incoming' END AS direction,
+                 labels(related) AS relatedLabels,
+                 related
+          LIMIT 20
+        `;
+                const expandResult = await session.run(expandQuery, {
+                    nodeId: node.nodeId,
+                    ...scopeParams,
+                    ...agentParams,
+                });
+                for (const relRecord of expandResult.records) {
+                    result.related.push({
+                        relationship: relRecord.get("relType"),
+                        direction: relRecord.get("direction"),
+                        labels: relRecord.get("relatedLabels"),
+                        properties: nodeToPlain(relRecord.get("related").properties),
+                    });
+                }
+            }
+            allResults.push(result);
+        }
+        return allResults;
+    }
+    finally {
+        await session.close();
+    }
+}
+function nodeToPlain(properties) {
+    const plain = {};
+    for (const [key, value] of Object.entries(properties)) {
+        if (key === "embedding")
+            continue;
+        if (value && typeof value === "object" && "toNumber" in value) {
+            plain[key] = value.toNumber();
+        }
+        else {
+            plain[key] = value;
+        }
+    }
+    return plain;
+}
+//# sourceMappingURL=memory-search.js.map

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

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

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

@@ -0,0 +1,13 @@
+interface UpdateParams {
+    nodeId: string;
+    properties: Record<string, unknown>;
+    accountId: string;
+}
+interface UpdateResult {
+    nodeId: string;
+    labels: string[];
+    updated: boolean;
+}
+export declare function memoryUpdate(params: UpdateParams): Promise<UpdateResult>;
+export {};
+//# sourceMappingURL=memory-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-update.d.ts","sourceRoot":"","sources":["../../src/tools/memory-update.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAwE9E"}

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

@@ -0,0 +1,62 @@
+import { getSession } from "../lib/neo4j.js";
+import { embed } from "../lib/embeddings.js";
+import { buildTextRepresentation } from "./memory-write.js";
+export async function memoryUpdate(params) {
+    const { nodeId, properties, accountId } = params;
+    if (Object.keys(properties).length === 0) {
+        throw new Error("No properties to update — provide at least one property.");
+    }
+    // Filter out restricted keys that should not be overwritten by the caller
+    const restricted = new Set(["embedding", "accountId", "createdAt", "createdOn"]);
+    const safeProps = {};
+    for (const [key, value] of Object.entries(properties)) {
+        if (!restricted.has(key)) {
+            safeProps[key] = value;
+        }
+    }
+    if (Object.keys(safeProps).length === 0) {
+        throw new Error("All provided properties are restricted and cannot be updated.");
+    }
+    const session = getSession();
+    try {
+        // Match by element ID AND accountId to prevent cross-account edits
+        const updateQuery = `
+      MATCH (n)
+      WHERE elementId(n) = $nodeId AND n.accountId = $accountId
+      SET n += $props, n.updatedAt = $updatedAt
+      RETURN elementId(n) AS nodeId, labels(n) AS nodeLabels, properties(n) AS allProps
+    `;
+        const result = await session.run(updateQuery, {
+            nodeId,
+            accountId,
+            updatedAt: new Date().toISOString(),
+            props: safeProps,
+        });
+        if (result.records.length === 0) {
+            throw new Error(`Node not found or not owned by this account (ID: ${nodeId}).`);
+        }
+        const record = result.records[0];
+        const updatedNodeId = record.get("nodeId");
+        const nodeLabels = record.get("nodeLabels");
+        const allProps = record.get("allProps");
+        // Re-embed from updated properties
+        const propsForEmbed = { ...allProps };
+        delete propsForEmbed.embedding;
+        delete propsForEmbed.accountId;
+        try {
+            const textForEmbedding = buildTextRepresentation(nodeLabels, propsForEmbed);
+            const embedding = await embed(textForEmbedding);
+            await session.run(`MATCH (n) WHERE elementId(n) = $nodeId SET n.embedding = $embedding`, { nodeId: updatedNodeId, embedding });
+        }
+        catch {
+            // Properties were updated successfully — embedding re-computation failed.
+            // Stale embedding is acceptable; the node remains searchable with the old vector.
+            // memory-reindex can fix this later.
+        }
+        return { nodeId: updatedNodeId, labels: nodeLabels, updated: true };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=memory-update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-update.js","sourceRoot":"","sources":["../../src/tools/memory-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAc5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEjD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,0EAA0E;IAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,mEAAmE;QACnE,MAAM,WAAW,GAAG;;;;;KAKnB,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE;YAC5C,MAAM;YACN,SAAS;YACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,oDAAoD,MAAM,IAAI,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAW,CAAC;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAa,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAA4B,CAAC;QAEnE,mCAAmC;QACnC,MAAM,aAAa,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtC,OAAO,aAAa,CAAC,SAAS,CAAC;QAC/B,OAAO,aAAa,CAAC,SAAS,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAC5E,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAEhD,MAAM,OAAO,CAAC,GAAG,CACf,qEAAqE,EACrE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CACrC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,kFAAkF;YAClF,qCAAqC;QACvC,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACtE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+interface WriteParams {
+    labels: string[];
+    properties: Record<string, unknown>;
+    accountId?: string;
+    /** Visibility scope for the node (e.g. "public", "shared", "admin", "user:phone:+44..."). Required — caller must specify. */
+    scope: string;
+    relationships?: Array<{
+        type: string;
+        direction: "outgoing" | "incoming";
+        targetNodeId: string;
+    }>;
+}
+interface WriteResult {
+    nodeId: string;
+    labels: string[];
+    created: boolean;
+}
+export declare function memoryWrite(params: WriteParams): Promise<WriteResult>;
+export declare function buildTextRepresentation(labels: string[], properties: Record<string, unknown>): string;
+export {};
+//# sourceMappingURL=memory-write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-write.d.ts","sourceRoot":"","sources":["../../src/tools/memory-write.ts"],"names":[],"mappings":"AAGA,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6HAA6H;IAC7H,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;QACnC,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAyD3E;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAUR"}