brains-mcp 1.61.2

package/dist/tools/pullSessionBundle.js

@@ -0,0 +1,432 @@
+import { z } from "zod";
+import matter from "gray-matter";
+import { resolveIndexOwnerSubject } from "../storage/client.js";
+import { serializeBundle, buildBundleHeader } from "../session/bundle.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+import { listActiveGrantsForGrantee } from "../access/projectShares.js";
+import { DEFAULT_ACCESS_CONTEXT, isHiveModeEnabled, parseAccessLevel, parseAudience, pagePassesFilter, writeGovernanceAuditEntry, } from "../governance/accessControl.js";
+const MIN_BYTES = 1024;
+const MAX_BYTES = 200_000;
+const DEFAULT_MAX_BYTES = 150_000;
+const DEFAULT_MAX_PAGES = 10;
+const FTS_MAX_RESULTS = 500;
+const SYSTEM_FILES = new Set(["index.md", "log.md"]);
+export const pullSessionBundleInputSchema = z.object({
+    folder: z
+        .string()
+        .optional()
+        .describe("Optional path prefix filter (e.g. 'projects/brainsapp')."),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Optional tag filter — any-match OR semantics. Pages matching any of the given tags are included."),
+    query: z
+        .string()
+        .optional()
+        .describe("Optional full-text query for relevance-ranked selection when Postgres search is enabled."),
+    includeSystem: z
+        .boolean()
+        .default(false)
+        .describe("If true, includes system files index.md and log.md."),
+    cursor: z
+        .string()
+        .optional()
+        .describe("Opaque continuation token from a prior call's nextCursor. Omit for the first page."),
+    maxBytes: z
+        .number()
+        .default(DEFAULT_MAX_BYTES)
+        .describe(`Soft cap on bundle text size in bytes (clamp ${MIN_BYTES}–${MAX_BYTES}). Default: ${DEFAULT_MAX_BYTES}.`),
+    maxPages: z
+        .number()
+        .default(DEFAULT_MAX_PAGES)
+        .describe(`Hard cap on pages per slice. Default: ${DEFAULT_MAX_PAGES}.`),
+    session_audience: z
+        .enum(["internal", "client-safe", "public"])
+        .optional()
+        .describe("Optional audience constraint for this session. When set, only pages whose audience matches are included. " +
+        "'client-safe' → client-safe + public pages. 'public' → public pages only. " +
+        "Only effective when BRAINS_HIVE_MODE=true."),
+});
+function encodeCursor(lastName) {
+    return Buffer.from(JSON.stringify({ lastName }), "utf8").toString("base64");
+}
+function decodeCursor(cursor) {
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, "base64").toString("utf8"));
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "lastName" in parsed &&
+            typeof parsed.lastName === "string") {
+            return parsed;
+        }
+        throw new Error("missing lastName");
+    }
+    catch {
+        throw new Error("Invalid cursor: malformed or corrupt");
+    }
+}
+function pageMatchesFilter(name, content, normalizedFolder, tags) {
+    const hasFilter = normalizedFolder !== undefined || (tags !== undefined && tags.length > 0);
+    if (!hasFilter)
+        return true;
+    const matchesFolder = normalizedFolder ? name.startsWith(normalizedFolder) : false;
+    if (tags && tags.length > 0) {
+        try {
+            const parsed = matter(content);
+            const pageTags = parsed.data?.tags ?? [];
+            if (tags.some((t) => pageTags.includes(t)))
+                return true;
+        }
+        catch {
+            // fall through to folder match
+        }
+    }
+    return matchesFolder;
+}
+/**
+ * Active project-share grants (BRA-368) for `userId`, narrowed to those
+ * relevant to `folder` (if set) so a folder-scoped bundle pull doesn't drag
+ * in unrelated shared projects. Without this, a grantee's bundle only ever
+ * contains their own pages — the owner's shared content is invisible
+ * (BRA-383, mirrors the list_pages/search_pages fix in BRA-379/#380).
+ */
+async function grantScopesFor(userId, folder) {
+    if (!userId)
+        return [];
+    // Strip any trailing slash before comparing — callers may pass either
+    // form, but a raw trailing slash would double up in the startsWith
+    // checks below (e.g. "projects/" -> "projects//") and silently drop
+    // otherwise-matching grants.
+    const normalizedFolder = folder ? folder.replace(/\/$/, "") : undefined;
+    const grants = await listActiveGrantsForGrantee(userId).catch(() => []);
+    return grants
+        .filter((g) => !normalizedFolder ||
+        g.project_path === normalizedFolder ||
+        g.project_path.startsWith(`${normalizedFolder}/`) ||
+        normalizedFolder.startsWith(`${g.project_path}/`))
+        .map((g) => ({ userId: g.owner_subject, folder: g.project_path }));
+}
+function usePostgresIndex() {
+    const searchBackend = (process.env.SEARCH_BACKEND ?? "").toLowerCase();
+    const storageBackend = (process.env.STORAGE_BACKEND ?? "local").toLowerCase();
+    return (storageBackend === "supabase" &&
+        searchBackend !== "sqlite" &&
+        searchBackend !== "scan");
+}
+/**
+ * The files at a project root that every instruction file tells an agent to read
+ * first. They are hoisted ahead of the rest of the candidate list so a capped
+ * slice cannot drop them.
+ *
+ * They were being dropped, and the ordering made it systematic rather than
+ * unlucky. `listPages` returns `modified.desc.nullslast,name.asc`, so candidate
+ * order is newest-touched-first — which means any bulk operation buries the
+ * pages that matter most. Measured on `projects/oio` (GH #462): a migration
+ * touched 22 pages over seven minutes, and the next `folder=projects/oio` pull
+ * returned 20 pages, all of them from that migration window. `status.md` and
+ * `readme.md`, untouched two hours earlier, sorted to positions ~27 and ~28 and
+ * fell outside the byte cap. The better-maintained the project, the more
+ * reliably its entry points get pushed out of its own bundle.
+ */
+const CONVENTIONAL_ROOT_FILES = ["readme.md", "status.md", "open-loops.md", "index.md"];
+function conventionalRootPaths(folder) {
+    if (!folder)
+        return [];
+    const prefix = folder.replace(/\/$/, "") + "/";
+    return CONVENTIONAL_ROOT_FILES.map((name) => prefix + name);
+}
+function hoistConventionalRootFiles(candidates, folder) {
+    const priority = conventionalRootPaths(folder);
+    if (priority.length === 0)
+        return candidates;
+    const rank = new Map(priority.map((name, i) => [name, i]));
+    const hoisted = [];
+    const rest = [];
+    for (const name of candidates) {
+        if (rank.has(name))
+            hoisted.push(name);
+        else
+            rest.push(name);
+    }
+    if (hoisted.length === 0)
+        return candidates;
+    hoisted.sort((a, b) => rank.get(a) - rank.get(b));
+    return [...hoisted, ...rest];
+}
+async function getCandidateNames(drive, folder, tags, query, includeSystem, userId, accessCtx) {
+    const normalizedFolder = folder ? folder.replace(/\/$/, "") + "/" : undefined;
+    if (usePostgresIndex()) {
+        const index = getPostgresSearchIndex();
+        const accessLevel = isHiveModeEnabled() ? accessCtx.userAccessLevel : undefined;
+        // Folder must be pushed into the query, not applied to the result.
+        // Without it these calls fetch every page the user has and filter in JS —
+        // but PostgREST caps rows, so the cap truncates before the filter runs and
+        // the folder pull silently undercounts. Measured on a 2,750-page wiki:
+        // folder=projects/job-search returned 164 of a true 213, losing the 49
+        // oldest by modified date, which is the order the cap slices on (GH #432).
+        // listPages/search take the prefix without a trailing slash.
+        const folderPrefix = folder ? folder.replace(/\/$/, "") : undefined;
+        // Cross-account sharing (BRA-383): without this, a grantee's bundle only
+        // ever contains pages they authored themselves — the owner's shared
+        // content never comes back, same root cause as BRA-379/#380.
+        const grantScopes = await grantScopesFor(userId, folder);
+        let names;
+        const trimmedQuery = query?.trim();
+        if (trimmedQuery) {
+            let rankedLists;
+            if (tags && tags.length > 0) {
+                rankedLists = await Promise.all(tags.map((tag) => index.search({ query: trimmedQuery, tag, folder: folderPrefix, maxResults: FTS_MAX_RESULTS, userId, accessLevel, grantScopes })
+                    .then((result) => result.results.map((r) => r.name))));
+            }
+            else {
+                const searchResult = await index.search({
+                    query: trimmedQuery,
+                    folder: folderPrefix,
+                    maxResults: FTS_MAX_RESULTS,
+                    userId,
+                    accessLevel,
+                    grantScopes,
+                });
+                rankedLists = [searchResult.results.map((r) => r.name)];
+            }
+            const seen = new Set();
+            names = [];
+            for (const list of rankedLists) {
+                for (const name of list) {
+                    if (!seen.has(name)) {
+                        seen.add(name);
+                        names.push(name);
+                    }
+                }
+            }
+        }
+        else if (tags && tags.length > 0) {
+            const sets = await Promise.all(tags.map((tag) => index.listPages({ tag, folder: folderPrefix, userId, accessLevel, grantScopes }).then((rows) => rows.map((r) => r.name))));
+            const union = new Set();
+            for (const set of sets)
+                for (const name of set)
+                    union.add(name);
+            names = Array.from(union);
+        }
+        else {
+            const rows = await index.listPages({ folder: folderPrefix, userId, accessLevel, grantScopes });
+            names = rows.map((r) => r.name);
+        }
+        // Belt-and-braces: the prefix is already applied server-side above, so this
+        // only catches anything a scope merge might reintroduce.
+        if (normalizedFolder) {
+            names = names.filter((name) => name.startsWith(normalizedFolder));
+        }
+        // Exclude system files unless includeSystem is set
+        if (!includeSystem) {
+            names = names.filter((name) => !SYSTEM_FILES.has(name));
+        }
+        // Exclude version-history snapshots regardless of includeSystem
+        names = names.filter((name) => !name.startsWith("page-versions/"));
+        return names;
+    }
+    // Fallback: drive.listFiles() + frontmatter scan for tags
+    const allFiles = await drive.listFiles();
+    const candidates = [];
+    const hasFilter = normalizedFolder !== undefined || (tags !== undefined && tags.length > 0);
+    const hiveActive = isHiveModeEnabled();
+    /**
+     * Check governance access for a file whose content has already been read.
+     * Returns false and emits an audit entry when the page should be excluded.
+     */
+    function passesGovernanceFilter(name, content) {
+        if (!hiveActive)
+            return true;
+        const parsed = matter(content);
+        const pageLevel = parseAccessLevel(parsed.data.access_level);
+        const pageAudience = parseAudience(parsed.data.audience);
+        if (!pagePassesFilter(pageLevel, pageAudience, accessCtx.userAccessLevel, accessCtx.sessionAudience)) {
+            writeGovernanceAuditEntry(userId, name, pageLevel, accessCtx.userAccessLevel, accessCtx.sessionAudience, pageLevel > accessCtx.userAccessLevel ? "access_level_exceeded" : "audience_mismatch");
+            return false;
+        }
+        return true;
+    }
+    for (const entry of allFiles) {
+        if (!entry.name.endsWith(".md"))
+            continue;
+        if (!includeSystem && SYSTEM_FILES.has(entry.name))
+            continue;
+        if (entry.name.startsWith("page-versions/"))
+            continue;
+        if (!hasFilter && !hiveActive) {
+            candidates.push(entry.name);
+            continue;
+        }
+        // We need to read file content for tag matching or access filtering
+        if (tags && tags.length > 0) {
+            const file = await drive.readFile(entry.name);
+            if (!passesGovernanceFilter(entry.name, file.content))
+                continue;
+            if (pageMatchesFilter(entry.name, file.content, normalizedFolder, tags)) {
+                candidates.push(entry.name);
+            }
+        }
+        else if (normalizedFolder && entry.name.startsWith(normalizedFolder)) {
+            if (hiveActive) {
+                const file = await drive.readFile(entry.name);
+                if (!passesGovernanceFilter(entry.name, file.content))
+                    continue;
+            }
+            candidates.push(entry.name);
+        }
+        else if (!hasFilter) {
+            if (hiveActive) {
+                const file = await drive.readFile(entry.name);
+                if (!passesGovernanceFilter(entry.name, file.content))
+                    continue;
+            }
+            candidates.push(entry.name);
+        }
+    }
+    return candidates.sort();
+}
+export async function pullSessionBundle(drive, input, userId = "", accessCtx = DEFAULT_ACCESS_CONTEXT) {
+    const maxBytes = Math.min(Math.max(input.maxBytes, MIN_BYTES), MAX_BYTES);
+    const maxPages = Math.max(1, input.maxPages);
+    // Decode cursor if present
+    let lastNameFromCursor;
+    if (input.cursor) {
+        try {
+            const decoded = decodeCursor(input.cursor);
+            lastNameFromCursor = decoded.lastName;
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : "Invalid cursor" };
+        }
+    }
+    // Merge session_audience from input into the access context
+    const effectiveAccessCtx = {
+        ...accessCtx,
+        sessionAudience: input.session_audience ?? accessCtx.sessionAudience,
+    };
+    // Get candidate names
+    const rawCandidates = await getCandidateNames(drive, input.folder, input.tags, input.query, input.includeSystem, userId, effectiveAccessCtx);
+    // Hoist the project's entry points, but only on a plain folder pull. With a
+    // query the caller asked for specific content and the list is relevance-ranked;
+    // promoting four fixed files ahead of the hits would answer a different
+    // question than the one asked.
+    const allCandidates = input.query?.trim()
+        ? rawCandidates
+        : hoistConventionalRootFiles(rawCandidates, input.folder);
+    const totalMatchingPages = allCandidates.length;
+    // Naming the filter and the match count lets an agent judge whether the bundle
+    // plausibly covers what it needs. Without it, an under-matching filter yields a
+    // bundle that looks authoritative — see buildBundleHeader's note. Computed
+    // before the selection loop because header size counts against maxBytes.
+    const filterParts = [];
+    if (input.folder)
+        filterParts.push(`folder=${input.folder}`);
+    if (input.tags && input.tags.length > 0)
+        filterParts.push(`tags=[${input.tags.join(", ")}]`);
+    if (input.query?.trim())
+        filterParts.push(`query="${input.query.trim()}"`);
+    const filterDescription = filterParts.length > 0 ? filterParts.join(" ") : "no filter (whole wiki)";
+    const candidatePositions = new Map(allCandidates.map((name, index) => [name, index]));
+    // Which entry points actually exist for this folder. Hoisting means they are
+    // normally all included, so this is a backstop for the cases hoisting does not
+    // cover: a query pull, a tags-only pull with no folder, a cap too small to fit
+    // even these, or a later slice reached by cursor.
+    const conventionalPresent = conventionalRootPaths(input.folder).filter((name) => candidatePositions.has(name));
+    // Skip past cursor based on candidate order
+    const remaining = (() => {
+        if (!lastNameFromCursor)
+            return allCandidates;
+        const cursorIndex = candidatePositions.get(lastNameFromCursor) ?? -1;
+        return cursorIndex >= 0 ? allCandidates.slice(cursorIndex + 1) : allCandidates;
+    })();
+    // Build bundle slice
+    const includedPages = [];
+    const bundlePages = [];
+    const errors = [];
+    let bundleBytes = 0;
+    let lastProcessed;
+    for (const name of remaining) {
+        if (includedPages.length >= maxPages)
+            break;
+        let file;
+        try {
+            // Hot path: read from DB row when Postgres is the primary (avoids Storage read on stale mirror).
+            // Cross-account sharing (BRA-383): the row (if any) is indexed under the
+            // true storage owner, not the raw actor — resolve that first so shared
+            // content actually hits the hot path instead of falling back silently.
+            const dbRow = usePostgresIndex()
+                ? await getPostgresSearchIndex().fetchPageRow(name, resolveIndexOwnerSubject(drive, name, userId)).catch(() => null)
+                : null;
+            file = dbRow ?? await drive.readFile(name);
+        }
+        catch (err) {
+            errors.push({ name, reason: err instanceof Error ? err.message : String(err) });
+            lastProcessed = name;
+            continue;
+        }
+        const delimiter = `===PAGE: ${name}===\n`;
+        const pageContrib = (bundlePages.length === 0 ? delimiter : "\n" + delimiter) + file.content;
+        const pageBytes = Buffer.byteLength(pageContrib, "utf8");
+        // The working-set header ships inside `bundle`, so its bytes count against
+        // maxBytes too — it grows by a line per page, so ignoring it would overshoot
+        // by more the larger the bundle. Measured against the truncated variant,
+        // which is the longer of the two: adding a page can be what causes the next
+        // one to be dropped, and the resulting truncation notice must already fit.
+        const prospectiveHeaderBytes = Buffer.byteLength(buildBundleHeader([...bundlePages, { name }], {
+            truncated: true,
+            filter: filterDescription,
+            totalMatching: totalMatchingPages,
+            // Worst case — assume every entry point ends up omitted, so the estimate
+            // is never smaller than the header this bundle actually ships with.
+            omittedConventional: conventionalPresent,
+        }), "utf8");
+        if (prospectiveHeaderBytes + bundleBytes + pageBytes > maxBytes && includedPages.length > 0) {
+            // Would exceed soft cap — stop here (but only if we already have at least one page)
+            break;
+        }
+        bundlePages.push({ name, content: file.content });
+        includedPages.push({
+            name,
+            bytes: Buffer.byteLength(file.content, "utf8"),
+            modifiedTime: file.modifiedTime,
+            revision: file.revision,
+        });
+        bundleBytes += pageBytes;
+        lastProcessed = name;
+    }
+    // Compute nextCursor: advance past all attempted pages (including those that errored),
+    // so subsequent slices don't get stuck on an unreadable page.
+    const lastProcessedIndex = lastProcessed === undefined
+        ? -1
+        : (candidatePositions.get(lastProcessed) ?? -1);
+    const hasMore = lastProcessedIndex >= 0 && lastProcessedIndex < allCandidates.length - 1;
+    const nextCursor = hasMore ? encodeCursor(lastProcessed) : undefined;
+    // Header is composed after hasMore so a truncated bundle can say so — an agent
+    // that cannot tell whether a page was included will re-read defensively, which
+    // is exactly the behaviour this is meant to remove (GH #426).
+    // Naming the filter and the match count lets an agent judge whether the
+    // bundle plausibly covers what it needs. Without it, an under-matching filter
+    // produces a bundle that looks authoritative — see the header's own note.
+    // A count of "20 of 132" does not tell an agent that the 112 it did not get
+    // include the two pages its instructions call read-first. Name them.
+    const includedNames = new Set(includedPages.map((p) => p.name));
+    const omittedConventional = conventionalPresent.filter((name) => !includedNames.has(name));
+    const bundle = buildBundleHeader(bundlePages, {
+        truncated: hasMore,
+        filter: filterDescription,
+        totalMatching: totalMatchingPages,
+        omittedConventional,
+    }) + serializeBundle(bundlePages);
+    return {
+        ok: true,
+        bundle,
+        pages: includedPages,
+        pageCount: includedPages.length,
+        totalMatchingPages,
+        bytes: Buffer.byteLength(bundle, "utf8"),
+        generatedAt: new Date().toISOString(),
+        ...(errors.length > 0 ? { errors } : {}),
+        ...(nextCursor !== undefined ? { nextCursor } : {}),
+    };
+}
+//# sourceMappingURL=pullSessionBundle.js.map

package/dist/tools/pullSessionBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pullSessionBundle.js","sourceRoot":"","sources":["../../src/tools/pullSessionBundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAsB,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAmB,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAEL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0FAA0F,CAAC;IACvG,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qDAAqD,CAAC;IAClE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IACjG,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,OAAO,CAAC,iBAAiB,CAAC;SAC1B,QAAQ,CAAC,gDAAgD,SAAS,IAAI,SAAS,eAAe,iBAAiB,GAAG,CAAC;IACtH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,OAAO,CAAC,iBAAiB,CAAC;SAC1B,QAAQ,CAAC,yCAAyC,iBAAiB,GAAG,CAAC;IAC1E,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;SAC3C,QAAQ,EAAE;SACV,QAAQ,CACP,2GAA2G;QAC3G,4EAA4E;QAC5E,4CAA4C,CAC7C;CACJ,CAAC,CAAC;AAQH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY,CAAC;QACrF,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,UAAU,IAAI,MAAM;YACpB,OAAQ,MAAkC,CAAC,QAAQ,KAAK,QAAQ,EAChE,CAAC;YACD,OAAO,MAAuB,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,OAAe,EACf,gBAAoC,EACpC,IAA0B;IAE1B,MAAM,SAAS,GAAG,gBAAgB,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5F,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEnF,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAc,MAAM,CAAC,IAAI,EAAE,IAA6B,IAAI,EAAE,CAAC;YAC7E,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,MAAe;IAC3D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,sEAAsE;IACtE,mEAAmE;IACnE,oEAAoE;IACpE,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,MAAM;SACV,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,gBAAgB;QACjB,CAAC,CAAC,YAAY,KAAK,gBAAgB;QACnC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,CAAC;QACjD,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CACpD;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9E,OAAO,CACL,cAAc,KAAK,UAAU;QAC7B,aAAa,KAAK,QAAQ;QAC1B,aAAa,KAAK,MAAM,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,uBAAuB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,CAAU,CAAC;AAEjG,SAAS,qBAAqB,CAAC,MAA0B;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IAC/C,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,0BAA0B,CAAC,UAAoB,EAAE,MAA0B;IAClF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAE5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,KAAoB,EACpB,MAA0B,EAC1B,IAA0B,EAC1B,KAAyB,EACzB,aAAsB,EACtB,MAAc,EACd,SAAwB;IAExB,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9E,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,mEAAmE;QACnE,0EAA0E;QAC1E,2EAA2E;QAC3E,uEAAuE;QACvE,uEAAuE;QACvE,2EAA2E;QAC3E,6DAA6D;QAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,yEAAyE;QACzE,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,KAAe,CAAC;QAEpB,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QACnC,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,WAAuB,CAAC;YAC5B,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACf,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;qBAC5H,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CACvD,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;oBACtC,KAAK,EAAE,YAAY;oBACnB,MAAM,EAAE,YAAY;oBACpB,UAAU,EAAE,eAAe;oBAC3B,MAAM;oBACN,WAAW;oBACX,WAAW;iBACZ,CAAC,CAAC;gBACH,WAAW,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,GAAG,EAAE,CAAC;YACX,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5I,CAAC;YACF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,KAAK,MAAM,IAAI,IAAI,GAAG;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;YAC/F,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,4EAA4E;QAC5E,yDAAyD;QACzD,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,gEAAgE;QAChE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAEnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,gBAAgB,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5F,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IAEvC;;;OAGG;IACH,SAAS,sBAAsB,CAAC,IAAY,EAAE,OAAe;QAC3D,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAE,MAAM,CAAC,IAAgC,CAAC,YAAY,CAAC,CAAC;QAC1F,MAAM,YAAY,GAAG,aAAa,CAAE,MAAM,CAAC,IAAgC,CAAC,QAAQ,CAAC,CAAC;QACtF,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,eAAe,EAAE,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;YACrG,yBAAyB,CACvB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE,SAAS,CAAC,eAAe,EAC7E,SAAS,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,mBAAmB,CACtF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,aAAa,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7D,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,SAAS;QAEtD,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,oEAAoE;QACpE,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC;gBAAE,SAAS;YAChE,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC;gBACxE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,IAAI,gBAAgB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACvE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC;oBAAE,SAAS;YAClE,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC;oBAAE,SAAS;YAClE,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAoB,EACpB,KAA6B,EAC7B,MAAM,GAAG,EAAE,EACX,YAA2B,sBAAsB;IAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE7C,2BAA2B;IAC3B,IAAI,kBAAsC,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3C,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,kBAAkB,GAAkB;QACxC,GAAG,SAAS;QACZ,eAAe,EAAE,KAAK,CAAC,gBAAgB,IAAI,SAAS,CAAC,eAAe;KACrE,CAAC;IAEF,sBAAsB;IACtB,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAC3C,KAAK,EACL,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,aAAa,EACnB,MAAM,EACN,kBAAkB,CACnB,CAAC;IAEF,4EAA4E;IAC5E,gFAAgF;IAChF,wEAAwE;IACxE,+BAA+B;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;QACvC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,0BAA0B,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE5D,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC;IAEhD,+EAA+E;IAC/E,gFAAgF;IAChF,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM;QAAE,WAAW,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,WAAW,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7F,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;QAAE,WAAW,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACpG,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtF,6EAA6E;IAC7E,+EAA+E;IAC/E,+EAA+E;IAC/E,kDAAkD;IAClD,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9E,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAC7B,CAAC;IAEF,4CAA4C;IAC5C,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE;QACtB,IAAI,CAAC,kBAAkB;YAAE,OAAO,aAAa,CAAC;QAC9C,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,OAAO,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IACjF,CAAC,CAAC,EAAE,CAAC;IAEL,qBAAqB;IACrB,MAAM,aAAa,GAAmF,EAAE,CAAC;IACzG,MAAM,WAAW,GAA6C,EAAE,CAAC;IACjE,MAAM,MAAM,GAA4C,EAAE,CAAC;IAC3D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,aAAiC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,aAAa,CAAC,MAAM,IAAI,QAAQ;YAAE,MAAM;QAE5C,IAAI,IAAiE,CAAC;QACtE,IAAI,CAAC;YACH,iGAAiG;YACjG,yEAAyE;YACzE,uEAAuE;YACvE,uEAAuE;YACvE,MAAM,KAAK,GAAG,gBAAgB,EAAE;gBAC9B,CAAC,CAAC,MAAM,sBAAsB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;gBACpH,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,GAAG,KAAK,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChF,aAAa,GAAG,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,IAAI,OAAO,CAAC;QAC1C,MAAM,WAAW,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEzD,2EAA2E;QAC3E,6EAA6E;QAC7E,yEAAyE;QACzE,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,sBAAsB,GAAG,MAAM,CAAC,UAAU,CAC9C,iBAAiB,CAAC,CAAC,GAAG,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YAC5C,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,iBAAiB;YACzB,aAAa,EAAE,kBAAkB;YACjC,yEAAyE;YACzE,oEAAoE;YACpE,mBAAmB,EAAE,mBAAmB;SACzC,CAAC,EACF,MAAM,CACP,CAAC;QAEF,IAAI,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5F,oFAAoF;YACpF,MAAM;QACR,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;YAC9C,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,WAAW,IAAI,SAAS,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,uFAAuF;IACvF,8DAA8D;IAC9D,MAAM,kBAAkB,GAAG,aAAa,KAAK,SAAS;QACpD,CAAC,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,kBAAkB,IAAI,CAAC,IAAI,kBAAkB,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,aAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtE,+EAA+E;IAC/E,+EAA+E;IAC/E,8DAA8D;IAC9D,wEAAwE;IACxE,8EAA8E;IAC9E,0EAA0E;IAC1E,4EAA4E;IAC5E,qEAAqE;IACrE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE;QAC5C,SAAS,EAAE,OAAO;QAClB,MAAM,EAAE,iBAAiB;QACzB,aAAa,EAAE,kBAAkB;QACjC,mBAAmB;KACpB,CAAC,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAElC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM;QACN,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,aAAa,CAAC,MAAM;QAC/B,kBAAkB;QAClB,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;QACxC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/tools/purgeWiki.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { StorageClient } from "../storage/client.js";
+export declare const purgeWikiInputSchema: z.ZodObject<{
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    exportBeforeDelete: z.ZodDefault<z.ZodBoolean>;
+    exportOutputPath: z.ZodOptional<z.ZodString>;
+    includeSystem: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeSystem: boolean;
+    confirm: boolean;
+    exportBeforeDelete: boolean;
+    exportOutputPath?: string | undefined;
+}, {
+    includeSystem?: boolean | undefined;
+    confirm?: boolean | undefined;
+    exportBeforeDelete?: boolean | undefined;
+    exportOutputPath?: string | undefined;
+}>;
+export type PurgeWikiInput = z.infer<typeof purgeWikiInputSchema>;
+export declare function purgeWiki(drive: StorageClient, input: PurgeWikiInput, userId?: string, opts?: {
+    onProgress?: (processed: number, total: number) => void;
+}): Promise<object>;
+//# sourceMappingURL=purgeWiki.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"purgeWiki.d.ts","sourceRoot":"","sources":["../../src/tools/purgeWiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EA6B/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,wBAAsB,SAAS,CAC9B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,cAAc,EACrB,MAAM,SAAK,EACX,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GACpE,OAAO,CAAC,MAAM,CAAC,CAkGjB"}

package/dist/tools/purgeWiki.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { exportWiki } from "./exportWiki.js";
+import { appendLogEntry } from "../wiki/log.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+export const purgeWikiInputSchema = z.object({
+    confirm: z
+        .boolean()
+        .default(false)
+        .describe("Must be set to true to proceed with deletion. " +
+        "If false, returns a warning with the list of files that would be deleted."),
+    exportBeforeDelete: z
+        .boolean()
+        .default(false)
+        .describe("If true, runs export_wiki to create a ZIP archive before deleting. " +
+        "Requires exportOutputPath to be set."),
+    exportOutputPath: z
+        .string()
+        .optional()
+        .describe("Path where the ZIP archive will be written when exportBeforeDelete is true " +
+        "(e.g. '/tmp/wiki-backup.zip'). Required when exportBeforeDelete is true."),
+    includeSystem: z
+        .boolean()
+        .default(false)
+        .describe("If true, also deletes system files index.md and log.md. " +
+        "Default is false to protect system files."),
+});
+const SYSTEM_FILES = new Set(["index.md", "log.md"]);
+export async function purgeWiki(drive, input, userId = "", opts = {}) {
+    const files = await drive.listFiles();
+    const toDelete = files.filter((f) => input.includeSystem || !SYSTEM_FILES.has(f.name));
+    if (!input.confirm) {
+        return {
+            success: false,
+            confirmed: false,
+            warning: "This operation will permanently delete all wiki pages. " +
+                "Set confirm=true to proceed. " +
+                "Set exportBeforeDelete=true with exportOutputPath to create a backup first.",
+            fileCount: toDelete.length,
+            files: toDelete.map((f) => f.name),
+        };
+    }
+    if (input.exportBeforeDelete) {
+        if (!input.exportOutputPath) {
+            return {
+                success: false,
+                error: "exportOutputPath is required when exportBeforeDelete is true. " +
+                    "Provide a path such as '/tmp/wiki-backup.zip'.",
+            };
+        }
+        await exportWiki(drive, {
+            outputPath: input.exportOutputPath,
+            includeSystem: true,
+        });
+    }
+    const deleted = [];
+    const failures = [];
+    // Flush Postgres index deletes every FLUSH_CHUNK files so that if the process is
+    // interrupted mid-loop, at most FLUSH_CHUNK ghost rows are left rather than all of them.
+    const FLUSH_CHUNK = 50;
+    const pgIndex = getPostgresSearchIndex();
+    const pgConfigured = pgIndex.isConfigured();
+    const pendingIndexDeletes = [];
+    async function flushIndexDeletes() {
+        if (!pgConfigured || pendingIndexDeletes.length === 0)
+            return;
+        const names = pendingIndexDeletes.splice(0);
+        await pgIndex.deletePages(names, userId).catch((err) => {
+            console.error("[purge] Postgres index cleanup failed:", err instanceof Error ? err.message : err);
+        });
+    }
+    let progressProcessed = 0;
+    for (const file of toDelete) {
+        try {
+            await drive.deleteFile(file.name);
+            deleted.push(file.name);
+            pendingIndexDeletes.push(file.name);
+            if (pendingIndexDeletes.length >= FLUSH_CHUNK) {
+                await flushIndexDeletes();
+            }
+        }
+        catch (err) {
+            failures.push({
+                name: file.name,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        opts.onProgress?.(++progressProcessed, toDelete.length);
+    }
+    // Flush any remaining index deletes.
+    await flushIndexDeletes();
+    const exportInfo = input.exportBeforeDelete && input.exportOutputPath
+        ? { exportedTo: input.exportOutputPath }
+        : undefined;
+    if (failures.length === 0) {
+        await appendLogEntry(drive, {
+            type: "update",
+            title: "Purge wiki",
+            detail: `deleted=${deleted.length}${exportInfo ? `, exportedTo=${exportInfo.exportedTo}` : ""}`,
+        }, userId).catch(() => {
+            /* non-fatal -- log.md may have been deleted if includeSystem was true */
+        });
+    }
+    return {
+        success: failures.length === 0,
+        confirmed: true,
+        deletedCount: deleted.length,
+        failedCount: failures.length,
+        deleted,
+        failures,
+        ...(exportInfo ?? {}),
+    };
+}
+//# sourceMappingURL=purgeWiki.js.map

package/dist/tools/purgeWiki.js.map

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