brains-mcp 1.61.2

package/dist/tools/patchPage.js

@@ -0,0 +1,287 @@
+import crypto from "crypto";
+import { z } from "zod";
+import { resolveIndexOwnerSubject } from "../storage/client.js";
+import { parsePage } from "../wiki/frontmatter.js";
+import { upsertIndexEntry } from "../wiki/index.js";
+import { appendLogEntry } from "../wiki/log.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+import { assertPageSize } from "../wiki/storageLimits.js";
+import { normalizeWikiPath } from "../wiki/path.js";
+import { DriveConflictError } from "../drive/errors.js";
+import { dispatchPageWebhook } from "../webhooks/dispatch.js";
+import { snapshotPage } from "./pageHistory.js";
+const patchOperationSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("insert_after"),
+        anchor: z.string().min(1),
+        text: z.string().min(1),
+        occurrence: z.number().int().positive().default(1),
+    }),
+    z.object({
+        type: z.literal("insert_before"),
+        anchor: z.string().min(1),
+        text: z.string().min(1),
+        occurrence: z.number().int().positive().default(1),
+    }),
+    z.object({
+        type: z.literal("replace"),
+        find: z.string().min(1),
+        replace: z.string(),
+        occurrence: z.number().int().positive().default(1),
+        all: z.boolean().default(false),
+    }),
+    z.object({
+        type: z.literal("append"),
+        text: z.string().min(1),
+    }),
+    z.object({
+        type: z.literal("replace_lines"),
+        startLine: z.number().int().positive(),
+        endLine: z.number().int().positive(),
+        text: z
+            .string()
+            .describe("Replacement text for the inclusive line range. Can contain multiple lines."),
+    }),
+]);
+export const patchPageInputSchema = z.object({
+    name: z.string().describe("Relative path of the page to patch (e.g. 'canonical/cars/ian-celica-dale.md')"),
+    operations: z
+        .array(patchOperationSchema)
+        .min(1)
+        .max(20)
+        .describe("Ordered patch operations. Each operation must include a 'type' field: 'replace' (fields: find, replace), 'insert_after' (fields: anchor, text), 'insert_before' (fields: anchor, text), 'append' (fields: text), or 'replace_lines' (fields: startLine, endLine, text). Prefer replace_lines for deterministic edits after reading a file."),
+    lineNumbersAre: z
+        .preprocess((value) => {
+        if (value === undefined || value === null)
+            return "file";
+        if (typeof value !== "string")
+            return value;
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "file" ||
+            normalized === "1-based full-file" ||
+            normalized === "1-based full file" ||
+            normalized === "full-file" ||
+            normalized === "full file") {
+            return "file";
+        }
+        return value;
+    }, z.enum(["file"]))
+        .default("file")
+        .describe("Line ranges are 1-based and refer to the full markdown file (including frontmatter). Accepts aliases like '1-based full-file'."),
+    summary: z
+        .string()
+        .optional()
+        .describe("Optional updated one-line summary for the index"),
+});
+export async function patchPage(drive, input, userId = "") {
+    const normalizedName = normalizeWikiPath(input.name);
+    const applyAndWrite = async () => {
+        const pgIndex = getPostgresSearchIndex();
+        // Cross-account sharing (BRA-381): attribute index/webhook writes to the
+        // true storage owner, not the raw authenticated actor.
+        const indexOwner = resolveIndexOwnerSubject(drive, normalizedName, userId);
+        // Hot path: read from DB row — avoids Supabase Storage download.
+        // Falls back to Storage when Postgres is not configured or row is missing.
+        const dbRow = await pgIndex.fetchPageRow(normalizedName, indexOwner).catch(() => null);
+        const existing = dbRow ?? await drive.readFile(normalizedName);
+        let nextContent;
+        let applied;
+        let parsed;
+        let revision;
+        let modifiedTime;
+        if (pgIndex.isConfigured()) {
+            // DB-primary: compare-and-swap against whatever we read (GH #500).
+            // A concurrent writer landing between our read and write moves the
+            // row out from under us — casUpdatePage/casInsertPage report that via
+            // `applied: false` instead of clobbering it. Re-read the now-current
+            // row, re-apply the same ops on top of it, and retry.
+            //
+            // This also covers the "no row yet" case: if two callers both read no
+            // row for a brand-new page, both used to fall through to a plain
+            // unconditional upsertPage — an unprotected last-write-wins race with
+            // no conflict ever reported. Now the first write is itself a
+            // conditional insert (fails if a row appeared concurrently), so that
+            // race retries into the same CAS loop as an existing-row conflict.
+            let attemptContent = existing.content;
+            let attemptRow = dbRow;
+            let casApplied = false;
+            const maxAttempts = 3;
+            for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+                const result = applyOperations(attemptContent, input.operations);
+                nextContent = result.content;
+                applied = result.applied;
+                assertPageSize(userId, normalizedName, nextContent);
+                parsed = parsePage(nextContent);
+                revision = crypto.createHash("sha256").update(nextContent, "utf8").digest("hex").slice(0, 16);
+                modifiedTime = new Date().toISOString();
+                casApplied = attemptRow
+                    ? await pgIndex.casUpdatePage(normalizedName, parsed.frontmatter, nextContent, attemptRow.revision, revision, modifiedTime, indexOwner)
+                    : await pgIndex.casInsertPage(normalizedName, parsed.frontmatter, nextContent, revision, modifiedTime, indexOwner);
+                if (casApplied)
+                    break;
+                const fresh = await pgIndex.fetchPageRow(normalizedName, indexOwner).catch(() => null);
+                if (!fresh)
+                    break;
+                attemptContent = fresh.content;
+                attemptRow = fresh;
+            }
+            if (!casApplied) {
+                return {
+                    success: false,
+                    conflict: true,
+                    name: normalizedName,
+                    reason: "Page was modified by someone else while this patch was being applied. Call read_page again to see the current content, then retry patch_page.",
+                    yourRevision: dbRow?.revision ?? "",
+                    currentRevision: attemptRow?.revision ?? "",
+                };
+            }
+            // Version snapshot — fire-and-forget, off the synchronous path
+            snapshotPage(drive, normalizedName, existing.content).catch(() => { });
+            // Write-behind: keep Storage mirror eventually consistent (non-blocking)
+            drive.updateFile(normalizedName, nextContent, "").catch((err) => {
+                console.warn(`[write-behind] Storage flush failed for '${normalizedName}':`, err instanceof Error ? err.message : err);
+            });
+        }
+        else {
+            const result = applyOperations(existing.content, input.operations);
+            nextContent = result.content;
+            applied = result.applied;
+            assertPageSize(userId, normalizedName, nextContent);
+            parsed = parsePage(nextContent);
+            snapshotPage(drive, normalizedName, existing.content).catch(() => { });
+            // Storage-primary fallback (no Postgres configured)
+            const writeResult = await drive.updateFile(existing.fileId, nextContent, existing.revision);
+            revision = writeResult.revision;
+            modifiedTime = writeResult.modifiedTime;
+            // Update DB index best-effort only in Storage-primary path
+            pgIndex.upsertPage(normalizedName, parsed.frontmatter, parsed.content, revision, modifiedTime, indexOwner).catch(() => { });
+        }
+        // Fire-and-forget: the link graph is a derived index, and nothing in this
+        // response depends on it. Awaiting it put three sequential Supabase round
+        // trips (~350-525ms) on the caller's critical path purely to decide whether
+        // to attach a cosmetic warning (GH #424). Staleness is self-healing —
+        // links_extracted_at drives extract_links' catch-up pass.
+        pgIndex
+            .syncPageLinks(normalizedName, parsed.content, indexOwner)
+            .catch((err) => {
+            console.warn(`[links] sync failed for '${normalizedName}'`, err instanceof Error ? err.message : err);
+        });
+        upsertIndexEntry(drive, {
+            name: normalizedName,
+            title: String(parsed.frontmatter.title ?? normalizedName),
+            summary: input.summary ?? String(parsed.frontmatter.summary ?? ""),
+            updated: new Date().toISOString().slice(0, 10),
+        }).catch(() => { });
+        appendLogEntry(drive, {
+            type: "update",
+            title: String(parsed.frontmatter.title ?? normalizedName),
+            detail: `Patched ${normalizedName}`,
+        }, indexOwner).catch((err) => {
+            // Surfaced rather than swallowed: a silent stop here is how an
+            // oversized log.md would go unnoticed (GH #417).
+            console.warn("[log] append failed:", err instanceof Error ? err.message : err);
+        });
+        // Dispatch outbound webhooks — fire-and-forget, never blocks the write
+        dispatchPageWebhook(indexOwner, "update", {
+            name: normalizedName,
+            title: String(parsed.frontmatter.title ?? normalizedName),
+            tags: parsed.frontmatter.tags ?? [],
+            summary: input.summary ?? String(parsed.frontmatter.summary ?? ""),
+            at: modifiedTime,
+        });
+        return {
+            success: true,
+            name: normalizedName,
+            fileId: existing.fileId,
+            revision,
+            modifiedTime,
+            bytesWritten: Buffer.byteLength(nextContent, "utf8"),
+            applied,
+        };
+    };
+    try {
+        return await applyAndWrite();
+    }
+    catch (err) {
+        if (!(err instanceof DriveConflictError)) {
+            throw err;
+        }
+        return await applyAndWrite();
+    }
+}
+function applyOperations(content, operations) {
+    let current = content;
+    const applied = [];
+    for (let i = 0; i < operations.length; i += 1) {
+        const op = operations[i];
+        if (op.type === "append") {
+            current = `${current.trimEnd()}\n\n${op.text}\n`;
+            applied.push({ index: i, type: op.type });
+            continue;
+        }
+        if (op.type === "insert_after") {
+            const idx = findOccurrence(current, op.anchor, op.occurrence);
+            if (idx === -1) {
+                throw new Error(`patch_page failed at operation ${i}: anchor not found for insert_after`);
+            }
+            current = `${current.slice(0, idx + op.anchor.length)}${op.text}${current.slice(idx + op.anchor.length)}`;
+            applied.push({ index: i, type: op.type });
+            continue;
+        }
+        if (op.type === "insert_before") {
+            const idx = findOccurrence(current, op.anchor, op.occurrence);
+            if (idx === -1) {
+                throw new Error(`patch_page failed at operation ${i}: anchor not found for insert_before`);
+            }
+            current = `${current.slice(0, idx)}${op.text}${current.slice(idx)}`;
+            applied.push({ index: i, type: op.type });
+            continue;
+        }
+        if (op.type === "replace") {
+            if (op.all) {
+                if (!current.includes(op.find)) {
+                    throw new Error(`patch_page failed at operation ${i}: find text not found for replace(all)`);
+                }
+                current = current.split(op.find).join(op.replace);
+                applied.push({ index: i, type: op.type });
+                continue;
+            }
+            const idx = findOccurrence(current, op.find, op.occurrence);
+            if (idx === -1) {
+                throw new Error(`patch_page failed at operation ${i}: find text not found for replace`);
+            }
+            current = `${current.slice(0, idx)}${op.replace}${current.slice(idx + op.find.length)}`;
+            applied.push({ index: i, type: op.type });
+            continue;
+        }
+        if (op.type === "replace_lines") {
+            current = replaceLineRange(current, op.startLine, op.endLine, op.text, i);
+            applied.push({ index: i, type: op.type });
+        }
+    }
+    return { content: current, applied };
+}
+function findOccurrence(haystack, needle, occurrence) {
+    let from = 0;
+    let idx = -1;
+    for (let i = 0; i < occurrence; i += 1) {
+        idx = haystack.indexOf(needle, from);
+        if (idx === -1)
+            return -1;
+        from = idx + needle.length;
+    }
+    return idx;
+}
+function replaceLineRange(content, startLine, endLine, text, operationIndex) {
+    const lines = content.split("\n");
+    if (startLine > endLine) {
+        throw new Error(`patch_page failed at operation ${operationIndex}: startLine must be <= endLine`);
+    }
+    if (startLine < 1 || endLine > lines.length) {
+        throw new Error(`patch_page failed at operation ${operationIndex}: line range ${startLine}-${endLine} out of bounds (1-${lines.length})`);
+    }
+    const replacementLines = text.split("\n");
+    lines.splice(startLine - 1, endLine - startLine + 1, ...replacementLines);
+    return lines.join("\n");
+}
+//# sourceMappingURL=patchPage.js.map

package/dist/tools/patchPage.js.map

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

package/dist/tools/pullSessionBundle.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { type StorageClient } from "../storage/client.js";
+import { type AccessContext } from "../governance/accessControl.js";
+export declare const pullSessionBundleInputSchema: z.ZodObject<{
+    folder: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    query: z.ZodOptional<z.ZodString>;
+    includeSystem: z.ZodDefault<z.ZodBoolean>;
+    cursor: z.ZodOptional<z.ZodString>;
+    maxBytes: z.ZodDefault<z.ZodNumber>;
+    maxPages: z.ZodDefault<z.ZodNumber>;
+    session_audience: z.ZodOptional<z.ZodEnum<["internal", "client-safe", "public"]>>;
+}, "strip", z.ZodTypeAny, {
+    includeSystem: boolean;
+    maxBytes: number;
+    maxPages: number;
+    tags?: string[] | undefined;
+    folder?: string | undefined;
+    query?: string | undefined;
+    cursor?: string | undefined;
+    session_audience?: "internal" | "client-safe" | "public" | undefined;
+}, {
+    tags?: string[] | undefined;
+    folder?: string | undefined;
+    query?: string | undefined;
+    includeSystem?: boolean | undefined;
+    cursor?: string | undefined;
+    maxBytes?: number | undefined;
+    maxPages?: number | undefined;
+    session_audience?: "internal" | "client-safe" | "public" | undefined;
+}>;
+export type PullSessionBundleInput = z.infer<typeof pullSessionBundleInputSchema>;
+export declare function pullSessionBundle(drive: StorageClient, input: PullSessionBundleInput, userId?: string, accessCtx?: AccessContext): Promise<object>;
+//# sourceMappingURL=pullSessionBundle.d.ts.map

package/dist/tools/pullSessionBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullSessionBundle.d.ts","sourceRoot":"","sources":["../../src/tools/pullSessionBundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,aAAa,EAA4B,MAAM,sBAAsB,CAAC;AAIpF,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,gCAAgC,CAAC;AAUxC,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAmRlF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,sBAAsB,EAC7B,MAAM,SAAK,EACX,SAAS,GAAE,aAAsC,GAChD,OAAO,CAAC,MAAM,CAAC,CAwKjB"}