brains-mcp 1.61.2

package/dist/tools/pushSessionBundle.d.ts

@@ -0,0 +1,139 @@
+import { z } from "zod";
+import { type StorageClient } from "../storage/client.js";
+export declare const pushSessionBundleJsonSchema: z.ZodObject<{
+    bundle: z.ZodOptional<z.ZodString>;
+    manifest: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>, "many">, {
+        name: string;
+    }[], unknown>>;
+    pages: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }>, "many">, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[], unknown>>;
+    conflictStrategy: z.ZodDefault<z.ZodEnum<["overwrite", "skip", "error"]>>;
+    includeSystem: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeSystem: boolean;
+    conflictStrategy: "error" | "skip" | "overwrite";
+    pages?: {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[] | undefined;
+    bundle?: string | undefined;
+    manifest?: {
+        name: string;
+    }[] | undefined;
+}, {
+    pages?: unknown;
+    includeSystem?: boolean | undefined;
+    conflictStrategy?: "error" | "skip" | "overwrite" | undefined;
+    bundle?: string | undefined;
+    manifest?: unknown;
+}>;
+export declare const pushSessionBundleInputSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    bundle: z.ZodOptional<z.ZodString>;
+    manifest: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>, "many">, {
+        name: string;
+    }[], unknown>>;
+    pages: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }>, "many">, {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[], unknown>>;
+    conflictStrategy: z.ZodDefault<z.ZodEnum<["overwrite", "skip", "error"]>>;
+    includeSystem: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includeSystem: boolean;
+    conflictStrategy: "error" | "skip" | "overwrite";
+    pages?: {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[] | undefined;
+    bundle?: string | undefined;
+    manifest?: {
+        name: string;
+    }[] | undefined;
+}, {
+    pages?: unknown;
+    includeSystem?: boolean | undefined;
+    conflictStrategy?: "error" | "skip" | "overwrite" | undefined;
+    bundle?: string | undefined;
+    manifest?: unknown;
+}>, {
+    includeSystem: boolean;
+    conflictStrategy: "error" | "skip" | "overwrite";
+    pages?: {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[] | undefined;
+    bundle?: string | undefined;
+    manifest?: {
+        name: string;
+    }[] | undefined;
+}, {
+    pages?: unknown;
+    includeSystem?: boolean | undefined;
+    conflictStrategy?: "error" | "skip" | "overwrite" | undefined;
+    bundle?: string | undefined;
+    manifest?: unknown;
+}>, {
+    includeSystem: boolean;
+    conflictStrategy: "error" | "skip" | "overwrite";
+    pages?: {
+        name: string;
+        content: string;
+        revision?: string | undefined;
+    }[] | undefined;
+    bundle?: string | undefined;
+    manifest?: {
+        name: string;
+    }[] | undefined;
+}, {
+    pages?: unknown;
+    includeSystem?: boolean | undefined;
+    conflictStrategy?: "error" | "skip" | "overwrite" | undefined;
+    bundle?: string | undefined;
+    manifest?: unknown;
+}>;
+export type PushSessionBundleInput = z.infer<typeof pushSessionBundleInputSchema>;
+export declare function pushSessionBundle(drive: StorageClient, input: PushSessionBundleInput, userId?: string): Promise<object>;
+//# sourceMappingURL=pushSessionBundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pushSessionBundle.d.ts","sourceRoot":"","sources":["../../src/tools/pushSessionBundle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAA4B,MAAM,sBAAsB,CAAC;AAiEpF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAC;AAEzE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYtC,CAAC;AAEJ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AA+ClF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,sBAAsB,EAC7B,MAAM,SAAK,GACV,OAAO,CAAC,MAAM,CAAC,CA0LjB"}

package/dist/tools/pushSessionBundle.js

@@ -0,0 +1,282 @@
+import crypto from "crypto";
+import { z } from "zod";
+import { resolveIndexOwnerSubject } from "../storage/client.js";
+import { DriveNotFoundError } from "../drive/errors.js";
+import { tryParseJson } from "./coerce.js";
+import { resolvePageLimitContext, PageLimitError } from "../wiki/storageLimits.js";
+import { parsePage } from "../wiki/frontmatter.js";
+import { dispatchBundleWebhooks } from "../webhooks/dispatch.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+import { lintLayoutMany } from "../wiki/layoutLint.js";
+const SYSTEM_FILES = new Set(["index.md", "log.md"]);
+const manifestEntrySchema = z.object({
+    name: z.string().min(1),
+});
+const pageEntrySchema = z.object({
+    name: z.string().min(1).describe("Wiki path of the page (e.g. 'projects/foo/bar.md')."),
+    content: z.string().describe("Full page content to write."),
+    revision: z
+        .string()
+        .optional()
+        .describe("Revision of this page from your last pull_session_bundle/read_page call. When provided and the " +
+        "page has since been changed by someone else, the write is rejected as a conflict instead of " +
+        "overwriting their change. Omit to fall back to conflictStrategy-only behavior."),
+});
+const pushSessionBundleObjectSchema = z
+    .object({
+    // Bundle mode (legacy): full bundle string + manifest ordering
+    bundle: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("The (possibly edited) bundle text as returned by pull_session_bundle. " +
+        "Use only for small bundles (<20 KB). For larger edits use the 'pages' parameter instead."),
+    manifest: z
+        .preprocess(tryParseJson, z.array(manifestEntrySchema))
+        .optional()
+        .describe("Names in the same order they appear in the bundle. Required when 'bundle' is provided."),
+    // Pages mode (preferred): structured array of {name, content} pairs
+    pages: z
+        .preprocess(tryParseJson, z.array(pageEntrySchema))
+        .optional()
+        .describe("Preferred alternative to bundle+manifest. Pass only the pages you want to write, " +
+        "each as {name, content}. Avoids token-limit issues with large bundles. " +
+        "Cannot be combined with 'bundle'."),
+    conflictStrategy: z
+        .enum(["overwrite", "skip", "error"])
+        .default("overwrite")
+        .describe("How to handle pages that already exist: 'overwrite' replaces them, 'skip' leaves them unchanged, 'error' returns an error per conflict."),
+    includeSystem: z
+        .boolean()
+        .default(false)
+        .describe("If true, allows writing system files (index.md, log.md) when present in the manifest. When false, system file entries are silently skipped."),
+});
+// Exported as the bare ZodObject so zodToJsonSchema emits a top-level
+// `type: "object"` (ZodEffects from .refine() would suppress it and break MCP clients).
+// Runtime cross-field validation lives in pushSessionBundleInputSchema below.
+export const pushSessionBundleJsonSchema = pushSessionBundleObjectSchema;
+export const pushSessionBundleInputSchema = pushSessionBundleObjectSchema
+    .refine((data) => {
+    const hasBundleMode = data.bundle !== undefined && data.manifest !== undefined;
+    const hasPagesMode = data.pages !== undefined && data.pages.length > 0;
+    return hasBundleMode || hasPagesMode;
+}, { message: "Provide either (bundle + manifest) or pages — not neither." })
+    .refine((data) => !(data.bundle !== undefined && data.pages !== undefined), { message: "bundle and pages are mutually exclusive — use one or the other." });
+const WIKI_PATH_RE = /^[a-zA-Z0-9_/.-]+\.md$/;
+function splitBundleByManifest(bundle, manifest) {
+    const result = new Map();
+    for (let i = 0; i < manifest.length; i++) {
+        const name = manifest[i].name;
+        const delimiter = `===PAGE: ${name}===\n`;
+        const startIdx = bundle.indexOf(delimiter);
+        if (startIdx === -1) {
+            return { error: `manifest/bundle mismatch at index ${i}: delimiter for '${name}' not found in bundle` };
+        }
+        // Verify order: start must be after the end of the previous page's content
+        if (i > 0) {
+            const prevName = manifest[i - 1].name;
+            const prevDelimiter = `===PAGE: ${prevName}===\n`;
+            const prevStart = bundle.indexOf(prevDelimiter);
+            if (startIdx <= prevStart) {
+                return { error: `manifest/bundle mismatch at index ${i}: '${name}' appears before '${prevName}' in bundle` };
+            }
+        }
+        const contentStart = startIdx + delimiter.length;
+        // Content ends at the next delimiter (or end of bundle)
+        let contentEnd = bundle.length;
+        if (i + 1 < manifest.length) {
+            const nextName = manifest[i + 1].name;
+            const nextDelimiter = `\n===PAGE: ${nextName}===\n`;
+            const nextIdx = bundle.indexOf(nextDelimiter, contentStart);
+            if (nextIdx !== -1) {
+                contentEnd = nextIdx;
+            }
+        }
+        result.set(name, bundle.slice(contentStart, contentEnd).trim());
+    }
+    return result;
+}
+export async function pushSessionBundle(drive, input, userId = "") {
+    let pageMap;
+    let orderedNames;
+    const revisionMap = new Map();
+    if (input.pages !== undefined) {
+        // Pages mode: structured array, no bundle parsing needed
+        pageMap = new Map();
+        orderedNames = [];
+        for (let i = 0; i < input.pages.length; i++) {
+            const { name, content, revision } = input.pages[i];
+            if (!WIKI_PATH_RE.test(name)) {
+                return { ok: false, error: `pages entry ${i} has invalid wiki path: '${name}'` };
+            }
+            pageMap.set(name, content);
+            orderedNames.push(name);
+            if (revision !== undefined)
+                revisionMap.set(name, revision);
+        }
+    }
+    else {
+        // Bundle mode: validate manifest paths, then split bundle by manifest order
+        const manifest = input.manifest;
+        for (let i = 0; i < manifest.length; i++) {
+            const { name } = manifest[i];
+            if (!WIKI_PATH_RE.test(name)) {
+                return { ok: false, error: `manifest entry ${i} has invalid wiki path: '${name}'` };
+            }
+        }
+        const splitResult = splitBundleByManifest(input.bundle, manifest);
+        if ("error" in splitResult) {
+            return { ok: false, error: splitResult.error };
+        }
+        pageMap = splitResult;
+        orderedNames = manifest.map((e) => e.name);
+    }
+    // Resolve page limit once for this call. The check is deferred to each new-page create so
+    // that updates to existing pages never consume quota.
+    const { currentCount: baseCount, limit: subjectLimit } = await resolvePageLimitContext(userId);
+    let newCreates = 0;
+    let created = 0;
+    // Only newly created pages are linted. An update to an existing page cannot
+    // invent a path, so linting those would warn on every edit of a legacy-located
+    // page — noise that teaches an agent to ignore the field.
+    const createdNames = [];
+    let updated = 0;
+    let skipped = 0;
+    const errors = [];
+    const conflicts = [];
+    const webhookPages = [];
+    const pgIndex = getPostgresSearchIndex();
+    for (const name of orderedNames) {
+        // Skip system files unless includeSystem is set
+        if (!input.includeSystem && SYSTEM_FILES.has(name)) {
+            skipped++;
+            continue;
+        }
+        const incomingContent = pageMap.get(name);
+        if (incomingContent === undefined)
+            continue;
+        // Cross-account sharing (BRA-381): the authoritative Postgres row is indexed
+        // under the true storage owner, not the raw actor — resolve that first so
+        // grant-shared pages actually hit the hot path (and the conflict/revision
+        // check below) instead of silently falling back to a stale Storage mirror.
+        const indexOwner = resolveIndexOwnerSubject(drive, name, userId);
+        try {
+            // Existence check: DB-primary path checks Postgres first (avoids a Storage
+            // round-trip when pgIndex is configured), then falls back to Storage.
+            const dbRow = pgIndex.isConfigured()
+                ? await pgIndex.fetchPageRow(name, indexOwner).catch(() => null)
+                : null;
+            const storageRow = dbRow
+                ? null
+                : await drive
+                    .readFile(name)
+                    .catch((err) => (err instanceof DriveNotFoundError ? null : Promise.reject(err)));
+            const existing = dbRow ?? storageRow;
+            if (!existing) {
+                if (subjectLimit !== null && baseCount + newCreates + 1 > subjectLimit) {
+                    throw new PageLimitError(baseCount, subjectLimit);
+                }
+                const parsed = parsePage(incomingContent);
+                const revision = crypto
+                    .createHash("sha256")
+                    .update(incomingContent, "utf8")
+                    .digest("hex")
+                    .slice(0, 16);
+                const modifiedTime = new Date().toISOString();
+                if (pgIndex.isConfigured()) {
+                    // DB-primary: Postgres sync so read_page sees the new content immediately;
+                    // Storage is written behind (fire-and-forget) matching the patchPage pattern.
+                    await pgIndex.upsertPage(name, parsed.frontmatter, incomingContent, revision, modifiedTime, indexOwner);
+                    drive.createFile(name, incomingContent).catch((err) => {
+                        console.warn(`[write-behind] Storage create failed for '${name}':`, err instanceof Error ? err.message : err);
+                    });
+                }
+                else {
+                    // Storage-primary fallback: Storage sync, Postgres best-effort.
+                    await drive.createFile(name, incomingContent);
+                    pgIndex.upsertPage(name, parsed.frontmatter, incomingContent, revision, modifiedTime, indexOwner).catch(() => { });
+                }
+                created++;
+                createdNames.push(name);
+                newCreates++;
+                webhookPages.push({
+                    name,
+                    event: "create",
+                    title: String(parsed.frontmatter.title ?? name),
+                    tags: parsed.frontmatter.tags ?? [],
+                    summary: String(parsed.frontmatter.summary ?? ""),
+                });
+            }
+            else if (existing.content.trim() === incomingContent) {
+                skipped++;
+            }
+            else if (revisionMap.has(name) && existing.revision !== revisionMap.get(name)) {
+                // Someone else wrote this page after our caller last read it (pull_session_bundle
+                // or read_page) and before this push — do not blindly overwrite their change.
+                conflicts.push({
+                    path: name,
+                    reason: "Page was modified by someone else since your last read. Call read_page to see the current content, then re-push with the new revision or a merged version.",
+                    yourRevision: revisionMap.get(name),
+                    currentRevision: existing.revision,
+                });
+            }
+            else if (input.conflictStrategy === "skip") {
+                skipped++;
+            }
+            else if (input.conflictStrategy === "error") {
+                errors.push({ path: name, reason: "File already exists and conflictStrategy is 'error'" });
+            }
+            else {
+                // overwrite
+                const parsed = parsePage(incomingContent);
+                const revision = crypto
+                    .createHash("sha256")
+                    .update(incomingContent, "utf8")
+                    .digest("hex")
+                    .slice(0, 16);
+                const modifiedTime = new Date().toISOString();
+                if (pgIndex.isConfigured()) {
+                    // DB-primary: Postgres sync, Storage write-behind.
+                    await pgIndex.upsertPage(name, parsed.frontmatter, incomingContent, revision, modifiedTime, indexOwner);
+                    drive.updateFile(existing.fileId, incomingContent, "").catch((err) => {
+                        console.warn(`[write-behind] Storage update failed for '${name}':`, err instanceof Error ? err.message : err);
+                    });
+                }
+                else {
+                    // Storage-primary fallback: Storage sync, Postgres best-effort.
+                    await drive.updateFile(existing.fileId, incomingContent, existing.revision);
+                    pgIndex.upsertPage(name, parsed.frontmatter, incomingContent, revision, modifiedTime, indexOwner).catch(() => { });
+                }
+                updated++;
+                webhookPages.push({
+                    name,
+                    event: "update",
+                    title: String(parsed.frontmatter.title ?? name),
+                    tags: parsed.frontmatter.tags ?? [],
+                    summary: String(parsed.frontmatter.summary ?? ""),
+                });
+            }
+        }
+        catch (err) {
+            errors.push({
+                path: name,
+                reason: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Dispatch outbound webhooks — fire-and-forget, one POST per matching rule
+    if (webhookPages.length > 0) {
+        dispatchBundleWebhooks(userId, webhookPages);
+    }
+    const layoutWarnings = lintLayoutMany(createdNames);
+    return {
+        ok: errors.length === 0 && conflicts.length === 0,
+        created,
+        updated,
+        skipped,
+        errors,
+        ...(conflicts.length > 0 ? { conflicts } : {}),
+        ...(layoutWarnings.length > 0 ? { layoutWarnings } : {}),
+    };
+}
+//# sourceMappingURL=pushSessionBundle.js.map

package/dist/tools/pushSessionBundle.js.map

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

package/dist/tools/readGovernanceAudit.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const readGovernanceAuditInputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+}, {
+    limit?: number | undefined;
+}>;
+export type ReadGovernanceAuditInput = z.infer<typeof readGovernanceAuditInputSchema>;
+/**
+ * Read governance audit log entries.
+ *
+ * Returns filtered-content audit events for classification review.
+ * Only accessible to exec+ users (access_level ≥ 4) when Hive mode is enabled.
+ */
+export declare function readGovernanceAudit(input: ReadGovernanceAuditInput, userId: string): Promise<object>;
+//# sourceMappingURL=readGovernanceAudit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readGovernanceAudit.d.ts","sourceRoot":"","sources":["../../src/tools/readGovernanceAudit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,8BAA8B;;;;;;EAQzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/tools/readGovernanceAudit.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { readGovernanceAuditLog } from "../governance/accessControl.js";
+export const readGovernanceAuditInputSchema = z.object({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(100)
+        .describe("Maximum number of audit log entries to return (1–500). Ordered newest-first."),
+});
+/**
+ * Read governance audit log entries.
+ *
+ * Returns filtered-content audit events for classification review.
+ * Only accessible to exec+ users (access_level ≥ 4) when Hive mode is enabled.
+ */
+export async function readGovernanceAudit(input, userId) {
+    return readGovernanceAuditLog(userId, input.limit);
+}
+//# sourceMappingURL=readGovernanceAudit.js.map

package/dist/tools/readGovernanceAudit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readGovernanceAudit.js","sourceRoot":"","sources":["../../src/tools/readGovernanceAudit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA+B,EAC/B,MAAc;IAEd,OAAO,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}

package/dist/tools/readPage.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import { type StorageClient } from "../storage/client.js";
+import { type AccessContext } from "../governance/accessControl.js";
+export declare const readPageInputSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export type ReadPageInput = z.infer<typeof readPageInputSchema>;
+export declare function readPage(drive: StorageClient, input: ReadPageInput, userId?: string, accessCtx?: AccessContext): Promise<object>;
+//# sourceMappingURL=readPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readPage.d.ts","sourceRoot":"","sources":["../../src/tools/readPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAA4B,MAAM,sBAAsB,CAAC;AAKpF,OAAO,EACL,KAAK,aAAa,EAOnB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,aAAa,EACpB,MAAM,SAAK,EACX,SAAS,GAAE,aAAsC,GAChD,OAAO,CAAC,MAAM,CAAC,CA6CjB"}

package/dist/tools/readPage.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { resolveIndexOwnerSubject } from "../storage/client.js";
+import { parsePage } from "../wiki/frontmatter.js";
+import { DrivePermissionError } from "../drive/errors.js";
+import { getPostgresSearchIndex } from "../search/postgresIndex.js";
+import { extractWikiLinks } from "../wiki/links.js";
+import { DEFAULT_ACCESS_CONTEXT, isHiveModeEnabled, parseAccessLevel, parseAudience, pagePassesFilter, writeGovernanceAuditEntry, } from "../governance/accessControl.js";
+export const readPageInputSchema = z.object({
+    name: z.string().describe("Relative path of the page to read (e.g. 'projects/topic.md')"),
+});
+export async function readPage(drive, input, userId = "", accessCtx = DEFAULT_ACCESS_CONTEXT) {
+    const name = input.name.endsWith(".md") ? input.name : `${input.name}.md`;
+    // Hot path: serve from DB row (skips Supabase Storage round-trip).
+    // Falls back to Storage when not configured or row not found.
+    const pgIndex = getPostgresSearchIndex();
+    // Cross-account sharing (BRA-381): the DB row (if any) is indexed under the
+    // true storage owner, not the raw authenticated actor — resolve that first
+    // so the hot path actually hits for shared content instead of silently
+    // falling back to a Storage read every time.
+    const indexOwner = resolveIndexOwnerSubject(drive, name, userId);
+    const dbRow = await pgIndex.fetchPageRow(name, indexOwner).catch(() => null);
+    const file = dbRow ?? await drive.readFile(name);
+    const { frontmatter, content, warnings } = parsePage(file.content);
+    const outboundLinkCount = pgIndex.isConfigured()
+        ? await pgIndex.getOutboundLinkCount(name, indexOwner).catch(() => extractWikiLinks(name, content).length)
+        : extractWikiLinks(name, content).length;
+    if (isHiveModeEnabled()) {
+        const pageLevel = parseAccessLevel(frontmatter.access_level);
+        const pageAudience = parseAudience(frontmatter.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");
+            throw new DrivePermissionError(`Page '${name}' requires access level ${pageLevel}; your level is ${accessCtx.userAccessLevel}.`);
+        }
+    }
+    return {
+        name: file.name,
+        fileId: file.fileId,
+        revision: file.revision,
+        frontmatter,
+        content,
+        outbound_link_count: outboundLinkCount,
+        modifiedTime: file.modifiedTime,
+        warnings: warnings.map((w) => ({ field: w.field, message: w.message })),
+    };
+}
+//# sourceMappingURL=readPage.js.map

package/dist/tools/readPage.js.map

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

package/dist/tools/removeWebhook.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const removeWebhookInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type RemoveWebhookInput = z.infer<typeof removeWebhookInputSchema>;
+export declare function removeWebhook(input: RemoveWebhookInput, userId: string): Promise<{
+    deleted: boolean;
+    id: string;
+}>;
+//# sourceMappingURL=removeWebhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removeWebhook.d.ts","sourceRoot":"","sources":["../../src/tools/removeWebhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAIxH"}

package/dist/tools/removeWebhook.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import { deleteWebhookRule } from "../webhooks/webhookRules.js";
+export const removeWebhookInputSchema = z.object({
+    id: z.string().uuid().describe("ID of the webhook rule to delete"),
+});
+export async function removeWebhook(input, userId) {
+    if (!userId)
+        throw new Error("userId is required to manage webhook rules");
+    const deleted = await deleteWebhookRule(input.id, userId);
+    return { deleted, id: input.id };
+}
+//# sourceMappingURL=removeWebhook.js.map

package/dist/tools/removeWebhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeWebhook.js","sourceRoot":"","sources":["../../src/tools/removeWebhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACnE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB,EAAE,MAAc;IAC3E,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;AACnC,CAAC"}