@rubytech/create-realagent 1.0.678 → 1.0.681

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

@@ -1,9 +1,51 @@
 import { getSession } from "../lib/neo4j.js";
 import { trashNode } from "../../../../../lib/graph-trash/dist/index.js";
+import { verifyFilterToken, filterTokenFingerprint } from "../lib/filter-token.js";
+import { reverifyCandidate } from "./memory-find-candidates.js";
+export class FilterTokenError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = "FilterTokenError";
+    }
+}
 export async function memoryDelete(params) {
-    const { accountId, elementId, reason } = params;
+    const t0 = Date.now();
+    const { accountId, elementId, reason, filterToken } = params;
     const session = getSession();
     try {
+        // Filter-token re-verification (Task 655). Must run before trashNode so a
+        // rejection never mutates the graph. Observable outcome: the
+        // `[memory-delete]` log line carries `reverified=true|false` and
+        // `outcome=trashed|rejected` — never silent.
+        let reverified = false;
+        if (filterToken) {
+            const verify = verifyFilterToken(filterToken);
+            if (!verify.ok) {
+                const ms = Date.now() - t0;
+                process.stderr.write(`[memory-delete] elementId=${elementId} filterToken=${filterTokenFingerprint(filterToken)} reverified=false outcome=rejected reason=${verify.reason} ms=${ms}\n`);
+                throw new FilterTokenError(`memory-delete: filter token rejected (${verify.reason})`, verify.reason);
+            }
+            if (verify.payload.accountId !== accountId) {
+                const ms = Date.now() - t0;
+                process.stderr.write(`[memory-delete] elementId=${elementId} filterToken=${filterTokenFingerprint(filterToken)} reverified=false outcome=rejected reason=account-mismatch ms=${ms}\n`);
+                throw new FilterTokenError(`memory-delete: filter token account mismatch`, "mismatch");
+            }
+            const stillMatches = await reverifyCandidate({
+                session,
+                accountId,
+                filter: verify.payload.filter,
+                agentType: verify.payload.agentType,
+                elementId,
+            });
+            if (!stillMatches) {
+                const ms = Date.now() - t0;
+                process.stderr.write(`[memory-delete] elementId=${elementId} filterToken=${filterTokenFingerprint(filterToken)} reverified=false outcome=rejected reason=predicate-no-longer-matches ms=${ms}\n`);
+                throw new FilterTokenError(`memory-delete: target ${elementId} no longer matches filter '${verify.payload.filter}'`, "mismatch");
+            }
+            reverified = true;
+        }
         const root = await trashNode({
             session,
             accountId,
@@ -45,6 +87,10 @@ export async function memoryDelete(params) {
                     chunks++;
             }
         }
+        const ms = Date.now() - t0;
+        const outcome = root.alreadyTrashed ? "already-trashed" : "trashed";
+        const tokenFp = filterToken ? filterTokenFingerprint(filterToken) : "none";
+        process.stderr.write(`[memory-delete] elementId=${elementId} filterToken=${tokenFp} reverified=${reverified} outcome=${outcome} ms=${ms}\n`);
         return {
             elementId,
             labels: root.labels,

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

@@ -1 +1 @@
-{"version":3,"file":"memory-delete.js","sourceRoot":"","sources":["../../src/tools/memory-delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAoB,MAAM,8CAA8C,CAAC;AAkC3F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0B;IAE1B,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAgB,MAAM,SAAS,CAAC;YACxC,OAAO;YACP,SAAS;YACT,SAAS;YACT,EAAE,EAAE,eAAe;YACnB,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC9C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC;;;;;+EAKuE,EACvE,EAAE,GAAG,EAAE,SAAS,EAAE,CACnB,CAAC;YACF,MAAM,UAAU,GAAI,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAc,IAAI,EAAE,CAAC;YACjF,MAAM,QAAQ,GAAI,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAc,IAAI,EAAE,CAAC;YAE7E,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;oBACxB,OAAO;oBACP,SAAS;oBACT,SAAS,EAAE,GAAG;oBACd,EAAE,EAAE,8BAA8B,SAAS,EAAE;oBAC7C,MAAM,EAAE,MAAM,IAAI,kCAAkC,SAAS,EAAE;iBAChE,CAAC,CAAC;gBACH,IAAI,CAAC,CAAC,OAAO;oBAAE,QAAQ,EAAE,CAAC;YAC5B,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;oBACxB,OAAO;oBACP,SAAS;oBACT,SAAS,EAAE,GAAG;oBACd,EAAE,EAAE,8BAA8B,SAAS,EAAE;oBAC7C,MAAM,EAAE,MAAM,IAAI,kCAAkC,SAAS,EAAE;iBAChE,CAAC,CAAC;gBACH,IAAI,CAAC,CAAC,OAAO;oBAAE,MAAM,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;SAC9B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"memory-delete.js","sourceRoot":"","sources":["../../src/tools/memory-delete.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,58 @@
+import { type CandidatesFilter } from "../lib/filter-token.js";
+/**
+ * memory-find-candidates — deterministic bulk-delete selector.
+ *
+ * Closes the 2026-04-22 failure class where the admin agent authored a
+ * selection cypher against a schema it had not loaded (`[:HAS_MESSAGE]`
+ * instead of `[:PART_OF]`), producing a vacuously-true filter that trashed
+ * 175 Conversation nodes (69 with real user content). The fix removes the
+ * LLM from the selection predicate: the agent chooses a filter name from a
+ * fixed set, and the server runs the canonical cypher.
+ *
+ * Two filters ship in v1 (Task 655):
+ * - `empty`              — zero `(m:Message)-[:PART_OF]->(c:Conversation)` Messages
+ * - `single-assistant`   — exactly one `:PART_OF` Message, with `role='assistant'`
+ *
+ * A third filter `no-real-user-input` is deferred to Task 656 (content-match
+ * predicate has a distinct false-positive risk profile).
+ *
+ * The returned `filterToken` is a signed opaque bundle that `memory-delete`
+ * re-verifies at trash time. There is no path by which the agent can feed a
+ * hand-rolled list to `memory-delete` with a token — the token only exists
+ * when `memory-find-candidates` minted it, and the server re-runs the same
+ * predicate on each elementId before trashing.
+ */
+export interface MemoryFindCandidatesParams {
+    accountId: string;
+    filter: CandidatesFilter;
+    agentType?: "admin" | "public";
+    limit?: number;
+    dryRun?: boolean;
+}
+export interface MemoryFindCandidatesItem {
+    elementId: string;
+    conversationId: string | null;
+    assistantMsgCount: number;
+    realUserMsgCount: number;
+    firstUserMsgPreview: string | null;
+    trashedAt: string | null;
+}
+export interface MemoryFindCandidatesResult {
+    filter: CandidatesFilter;
+    agentType?: "admin" | "public";
+    matched: number;
+    sampled: number;
+    items: MemoryFindCandidatesItem[];
+    filterToken: string;
+    dryRun: boolean;
+}
+/** Server-side re-check for `memory-delete` token verification. */
+export declare function reverifyCandidate(params: {
+    session: import("neo4j-driver").Session;
+    accountId: string;
+    filter: CandidatesFilter;
+    agentType?: "admin" | "public";
+    elementId: string;
+}): Promise<boolean>;
+export declare function memoryFindCandidates(params: MemoryFindCandidatesParams): Promise<MemoryFindCandidatesResult>;
+//# sourceMappingURL=memory-find-candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-find-candidates.d.ts","sourceRoot":"","sources":["../../src/tools/memory-find-candidates.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAwDD,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,OAAO,cAAc,EAAE,OAAO,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BnB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA6CrC"}

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

@@ -0,0 +1,125 @@
+import { getSession } from "../lib/neo4j.js";
+import { mintFilterToken } from "../lib/filter-token.js";
+const DEFAULT_LIMIT = 200;
+const MAX_LIMIT = 1000;
+const PROJECT_AND_ORDER = `
+  WITH c,
+       size([x IN msgs WHERE x.role = 'assistant'])                   AS assistantMsgCount,
+       size([x IN msgs WHERE x.role = 'user' OR x.role IS NULL])      AS realUserMsgCount,
+       head([x IN msgs WHERE x.role = 'user' | x.content])            AS firstUserMsg
+  RETURN elementId(c)                           AS elementId,
+         c.conversationId                        AS conversationId,
+         assistantMsgCount                       AS assistantMsgCount,
+         realUserMsgCount                        AS realUserMsgCount,
+         CASE WHEN firstUserMsg IS NULL THEN NULL
+              WHEN size(firstUserMsg) > 120 THEN left(firstUserMsg, 120) + '…'
+              ELSE firstUserMsg
+         END                                     AS firstUserMsgPreview,
+         toString(c.trashedAt)                   AS trashedAt
+  ORDER BY c.createdAt ASC
+  LIMIT toInteger($limit)
+`;
+/**
+ * Canonical selection cypher per filter. Agent-authored cypher never reaches
+ * the DB; these literals are the only delete-selection path from the admin
+ * agent's tool surface.
+ */
+function buildSelectionCypher(filter) {
+    if (filter === "empty") {
+        return `
+      MATCH (c:Conversation)
+      WHERE c.accountId = $accountId
+        AND NOT c:Trashed
+        AND c.deletedAt IS NULL
+        AND ($agentTypeFilter IS NULL OR c.agentType = $agentTypeFilter)
+        AND NOT EXISTS { MATCH (:Message)-[:PART_OF]->(c) }
+      WITH c, [] AS msgs
+      ${PROJECT_AND_ORDER}
+    `;
+    }
+    // single-assistant
+    return `
+    MATCH (c:Conversation)
+    WHERE c.accountId = $accountId
+      AND NOT c:Trashed
+      AND c.deletedAt IS NULL
+      AND ($agentTypeFilter IS NULL OR c.agentType = $agentTypeFilter)
+    WITH c, [(m:Message)-[:PART_OF]->(c) | m] AS msgs
+    WHERE size(msgs) = 1
+      AND size([x IN msgs WHERE x.role = 'assistant']) = 1
+    ${PROJECT_AND_ORDER}
+  `;
+}
+/** Server-side re-check for `memory-delete` token verification. */
+export async function reverifyCandidate(params) {
+    const { session, accountId, filter, agentType, elementId } = params;
+    const cypher = filter === "empty"
+        ? `
+        MATCH (c:Conversation)
+        WHERE elementId(c) = $elementId
+          AND c.accountId = $accountId
+          AND NOT c:Trashed
+          AND c.deletedAt IS NULL
+          AND ($agentTypeFilter IS NULL OR c.agentType = $agentTypeFilter)
+          AND NOT EXISTS { MATCH (:Message)-[:PART_OF]->(c) }
+        RETURN elementId(c) AS eid
+      `
+        : `
+        MATCH (c:Conversation)
+        WHERE elementId(c) = $elementId
+          AND c.accountId = $accountId
+          AND NOT c:Trashed
+          AND c.deletedAt IS NULL
+          AND ($agentTypeFilter IS NULL OR c.agentType = $agentTypeFilter)
+        WITH c, [(m:Message)-[:PART_OF]->(c) | m] AS msgs
+        WHERE size(msgs) = 1 AND size([x IN msgs WHERE x.role = 'assistant']) = 1
+        RETURN elementId(c) AS eid
+      `;
+    const result = await session.run(cypher, {
+        elementId,
+        accountId,
+        agentTypeFilter: agentType ?? null,
+    });
+    return result.records.length === 1;
+}
+export async function memoryFindCandidates(params) {
+    const t0 = Date.now();
+    const { accountId, filter, agentType, dryRun = false } = params;
+    const limit = Math.min(params.limit ?? DEFAULT_LIMIT, MAX_LIMIT);
+    const session = getSession();
+    try {
+        const cypher = buildSelectionCypher(filter);
+        const result = await session.run(cypher, {
+            accountId,
+            agentTypeFilter: agentType ?? null,
+            limit,
+        });
+        const items = result.records.map((r) => ({
+            elementId: r.get("elementId"),
+            conversationId: r.get("conversationId") ?? null,
+            assistantMsgCount: Number(r.get("assistantMsgCount") ?? 0),
+            realUserMsgCount: Number(r.get("realUserMsgCount") ?? 0),
+            firstUserMsgPreview: r.get("firstUserMsgPreview") ?? null,
+            trashedAt: r.get("trashedAt") ?? null,
+        }));
+        // Under dryRun the caller wants to see what would match without receiving
+        // an actionable token — so the agent cannot "accidentally" feed a dryRun
+        // result to memory-delete. Returning an empty string rather than omitting
+        // the field keeps the result shape stable for the MCP surface.
+        const filterToken = dryRun ? "" : mintFilterToken({ filter, agentType, accountId });
+        process.stderr.write(`[memory-find-candidates] filter=${filter} agentType=${agentType ?? "any"} matched=${items.length} sampled=${items.length} dryRun=${dryRun} ms=${Date.now() - t0}\n`);
+        return {
+            filter,
+            agentType,
+            matched: items.length,
+            sampled: items.length,
+            items,
+            filterToken,
+            dryRun,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=memory-find-candidates.js.map

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

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