@rubytech/create-realagent 1.0.693 → 1.0.695

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

@@ -1,405 +1,42 @@
-import { int } from "neo4j-driver";
 import { getSession } from "../lib/neo4j.js";
 import { embed } from "../lib/embeddings.js";
-import { notTrashed } from "../../../../../lib/graph-trash/dist/index.js";
+import { hybrid } from "../../../../../lib/graph-search/dist/index.js";
 // ---------------------------------------------------------------------------
-// Hybrid search pipeline:
+// Memory search — thin adapter over the shared `graph-search` lib (Task 675).
+// The hybrid pipeline, Lucene escape, BM25 normalisation, and graph expand
+// all live in platform/lib/graph-search; this file threads the MCP tool
+// parameters through and applies the trash-census observability log.
 //
-// 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.
-//
-// Trashed nodes (Task 576 :Trashed label) and legacy soft-deleted nodes
-// (pre-Task-576 deletedAt property) are excluded from ALL query paths via
-// the shared notTrashed() helper: vector search, BM25, property keyword
-// search, and graph expand. The filter is unconditional — no parameter
-// controls it. When the filter drops results, [trash:read-filter-skipped]
-// is emitted so silent over-filtering is observable.
+// Trash filter visibility: when the account holds `:Trashed` nodes we emit
+// `[trash:read-filter-skipped]` so silent over-filtering stays observable.
+// The census lives here (not in the shared lib) because it is MCP-tool-
+// specific context the admin route doesn't share.
 // ---------------------------------------------------------------------------
-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 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}
-       AND ${notTrashed("node")}
-       ${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()) }
-        : {};
+    const limit = params.limit ?? 10;
     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 — :Trashed nodes (Task 576) and legacy
-        // deletedAt-marked nodes are never returned. notTrashed() centralises the
-        // predicate so a future migration drops the legacy arm in one place.
-        for (const indexName of indexesToQuery) {
-            const vectorQuery = `
-        CALL db.index.vector.queryNodes($indexName, $limit, $embedding)
-        YIELD node, score
-        WHERE node.accountId = $accountId
-        ${scopeClause}
-        ${agentClause}
-        AND ${notTrashed("node")}
-        ${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 ${notTrashed("node")}
-         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 ${notTrashed("related")}
-          ${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);
-        }
-        // Trash filter visibility: emit when the account holds any :Trashed nodes,
-        // so silent over-filtering is observable. Cheap single-row aggregate;
-        // accountId-as-unique-key labels (LocalBusiness/OnboardingState) have
-        // their accountId nulled and are missed here — acceptable, those labels
-        // are 1-per-account and rare in trash.
+        const res = await hybrid(session, embed, { ...params, limit });
         try {
-            const trashCensus = await session.run(`MATCH (n:Trashed) WHERE n.accountId = $accountId RETURN count(n) AS c`, { accountId });
+            const trashCensus = await session.run(`MATCH (n:Trashed) WHERE n.accountId = $accountId RETURN count(n) AS c`, { accountId: params.accountId });
             const skipped = trashCensus.records[0]?.get("c");
             const skippedCount = typeof skipped === "number"
                 ? skipped
                 : skipped?.toNumber?.() ?? 0;
             if (skippedCount > 0) {
-                const fingerprint = (labels && labels.length > 0)
-                    ? `labels=${labels.join(",")}`
-                    : `query=${queryText.slice(0, 40).replace(/\s+/g, " ")}`;
-                process.stderr.write(`[trash:read-filter-skipped] accountId=${accountId} ${fingerprint} skippedCount=${skippedCount}\n`);
+                const fingerprint = (params.labels && params.labels.length > 0)
+                    ? `labels=${params.labels.join(",")}`
+                    : `query=${params.query.slice(0, 40).replace(/\s+/g, " ")}`;
+                process.stderr.write(`[trash:read-filter-skipped] accountId=${params.accountId} ${fingerprint} skippedCount=${skippedCount}\n`);
             }
         }
         catch {
-            // Census is observability-only — never break a search on its failure.
+            // observability-only; never break a search on census failure.
         }
-        return allResults;
+        return res.results;
     }
     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

@@ -1 +1 @@
-{"version":3,"file":"memory-search.js","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-search.js","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAwC,MAAM,+CAA+C,CAAC;AAE7G,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,wEAAwE;AACxE,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAwD;IAExD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,uEAAuE,EACvE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAChC,CAAC;YACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAGlC,CAAC;YACd,MAAM,YAAY,GAAG,OAAO,OAAO,KAAK,QAAQ;gBAC9C,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC7D,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;oBACrC,CAAC,CAAC,SAAS,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yCAAyC,MAAM,CAAC,SAAS,IAAI,WAAW,iBAAiB,YAAY,IAAI,CAC1G,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;QAED,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,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

@@ -1,15 +1,19 @@
 import type { LoadedSchema } from "../lib/schema-loader.js";
+import { type GraphRelationship, type CreatedBy } from "../../../../../lib/graph-write/dist/index.js";
 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;
-    }>;
+    /**
+     * At least one relationship required — enforced by writeNodeWithEdges.
+     * The doctrine: a node without at least one adjacency is noise, not
+     * knowledge. See .docs/neo4j.md (Write doctrine).
+     */
+    relationships: GraphRelationship[];
+    /** Provenance stamp — sourced from the MCP server env vars (agent/session). */
+    createdBy: CreatedBy;
     /**
      * Loaded schema used to validate the write before any Neo4j or embedding
      * work is done. Required — the caller (index.ts) loads this once at

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

@@ -1 +1 @@
-{"version":3,"file":"memory-write.d.ts","sourceRoot":"","sources":["../../src/tools/memory-write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,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;IACH;;;;OAIG;IACH,MAAM,EAAE,YAAY,CAAC;CACtB;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,CAqI3E;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKhD;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAUR"}
+{"version":3,"file":"memory-write.d.ts","sourceRoot":"","sources":["../../src/tools/memory-write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAC;AAEtD,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;;;;OAIG;IACH,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,+EAA+E;IAC/E,SAAS,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,MAAM,EAAE,YAAY,CAAC;CACtB;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,CAkH3E;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKhD;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAUR"}

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

@@ -1,8 +1,9 @@
 import { getSession } from "../lib/neo4j.js";
 import { embed } from "../lib/embeddings.js";
 import { validateWrite } from "../lib/schema-validator.js";
+import { writeNodeWithEdges, } from "../../../../../lib/graph-write/dist/index.js";
 export async function memoryWrite(params) {
-    const { labels, properties, accountId, scope, relationships, schema } = params;
+    const { labels, properties, accountId, scope, relationships, createdBy, schema } = params;
     if (!scope) {
         throw new Error("scope is required — valid values: 'public', 'shared', 'admin', 'user:{identifier}'");
     }
@@ -20,7 +21,6 @@ export async function memoryWrite(params) {
     const session = getSession();
     const labelStr = labels.map((l) => `\`${l}\``).join(":");
     try {
-        // Compute embedding from a text representation of the node
         const textForEmbedding = buildTextRepresentation(labels, properties);
         const embedding = await embed(textForEmbedding);
         const nodeProps = {
@@ -33,27 +33,14 @@ export async function memoryWrite(params) {
         if (!properties.createdOn && !properties.createdAt) {
             nodeProps.createdAt = new Date().toISOString();
         }
-        const createQuery = `
-      CREATE (n:${labelStr} $props)
-      RETURN elementId(n) AS nodeId, labels(n) AS nodeLabels
-    `;
-        const result = await session.run(createQuery, { props: nodeProps });
-        const record = result.records[0];
-        const nodeId = record.get("nodeId");
-        const nodeLabels = record.get("nodeLabels");
-        // Create relationships if specified
-        if (relationships && relationships.length > 0) {
-            for (const rel of relationships) {
-                const relQuery = rel.direction === "outgoing"
-                    ? `MATCH (a), (b) WHERE elementId(a) = $fromId AND elementId(b) = $toId CREATE (a)-[:${rel.type}]->(b)`
-                    : `MATCH (a), (b) WHERE elementId(a) = $fromId AND elementId(b) = $toId CREATE (b)-[:${rel.type}]->(a)`;
-                await session.run(relQuery, {
-                    fromId: nodeId,
-                    toId: rel.targetNodeId,
-                });
-            }
-        }
-        return { nodeId, labels: nodeLabels, created: true };
+        const result = await writeNodeWithEdges({
+            session,
+            labels,
+            props: nodeProps,
+            relationships,
+            createdBy,
+        });
+        return { nodeId: result.nodeId, labels: result.labels, created: true };
     }
     catch (error) {
         // Constraint violations include an unusable internal ID (e.g. "Node(219)").

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

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

package/payload/platform/plugins/memory/references/graph-primitives.md

@@ -57,7 +57,7 @@ graph as a single action.
 | User intent | Tool | When to pick this, not the next row |
 |---|---|---|
 | "remove admin X", "take away their admin access", "revoke admin" | `mcp__admin__admin-remove` | Device-level admin offboarding — detaches the `(AdminUser)-[:ADMIN_OF]->(LocalBusiness)` edge and updates `platform/config/users.json`. Not for scrubbing personal data — use the GDPR contact-erase tools for that. |
-| "delete this specific node", "remove this entry by its id", "get rid of node X", "remove orphans", "prune", "clean up" | `mcp__memory__memory-delete` | Soft-deletes a single node by `elementId` (adds `:Trashed`, preserves relationships, snapshots unique keys, invisible to `memory-search` and any `notTrashed`-filtered read). For KnowledgeDocument, cascades to Sections and Chunks. Enumerate candidates first with a Cypher read, confirm with the user, then delete each by `elementId`. There is no bulk "delete everything without relationships" tool — standalone nodes are legitimate for many labels (OnboardingState, configuration nodes, freshly-discovered Persons before edges land). |
+| "delete this specific node", "remove this entry by its id", "get rid of node X", "remove orphans", "prune", "clean up" | `mcp__memory__memory-delete` | Soft-deletes a single node by `elementId` (adds `:Trashed`, preserves relationships, snapshots unique keys, invisible to `memory-search` and any `notTrashed`-filtered read). For KnowledgeDocument, cascades to Sections and Chunks. Enumerate candidates first with a Cypher read, confirm with the user, then delete each by `elementId`. There is no bulk "delete everything without relationships" tool. Per the Task 673 write doctrine (`.docs/neo4j.md` § Write doctrine), **new** orphans should be impossible — every writer now rejects zero-edge calls at the MCP tool-surface. Existing orphans from pre-Task-673 data are legitimate backfill candidates (see Task 677) but are not produced by any live writer; if you see a freshly-created orphan, it is a bug in a writer that bypassed `writeNodeWithEdges`, not expected state. |
 | "undo that delete", "I deleted X by mistake, bring it back", "restore the contact I just trashed" | `mcp__memory__memory-restore` | Removes `:Trashed`, restores snapshotted unique-key properties. Fails loudly when an active node already holds the unique slot (e.g. a fresh `OnboardingState` was created while the old one was in trash) — the error names the conflicting `elementId` so you can ask the user how to resolve. |
 | "empty the trash", "purge old soft-deletes", "what's been sitting in trash and ready to clear" | `mcp__memory__memory-empty-trash` | Hard-deletes trashed nodes whose `trashedAt` is older than `graceDays` (default 30); `dryRun=true` lists candidates without mutating. Use `dryRun` first, show the list to the user, then run for real. For KnowledgeDocument candidates, the on-disk attachment directory is removed too. |
 | "scrub this conversation's memory", "remove this claim the bot picked up", "forget what we said in that thread" | `mcp__memory__conversation-memory-expunge` | Removes deny-listable content from `:Memory` nodes scoped to one conversation. Requires an explicit pattern and conversationId. Not for deleting individual nodes — use `memory-delete`. |

package/payload/platform/plugins/scheduling/mcp/dist/index.js

@@ -24,6 +24,8 @@ const accountId = process.env.ACCOUNT_ID;
 if (!accountId) {
     throw new Error("ACCOUNT_ID environment variable is required");
 }
+const sessionId = process.env.SESSION_ID || undefined;
+const agentSlug = process.env.AGENT_SLUG || undefined;
 // ---------------------------------------------------------------------------
 // Shared schema fragments
 // ---------------------------------------------------------------------------
@@ -52,7 +54,12 @@ server.tool("schedule-event", "Create a scheduled event or appointment. For one-
     try {
         const timezone = await getUserTimezone(accountId);
         console.error(`[schedule-event] formatted for timezone: ${timezone}`);
-        const result = await scheduleEvent({ ...params, accountId });
+        const result = await scheduleEvent({
+            ...params,
+            accountId,
+            sessionKey: params.sessionKey ?? sessionId,
+            createdBy: { agent: agentSlug, session: sessionId, tool: "schedule-event" },
+        });
         const parts = [`Event created: "${params.name}" (ID: ${result.eventId})`];
         parts.push(`starts: ${formatCombined(params.startDate, timezone)}`);
         if (params.recurrence)