@zackbart/connecta 0.34.1 → 0.36.0

package/dist/providers/notion/rest.js

@@ -1,1226 +0,0 @@
-import { retryAfterMs } from "../../connectors/guarded-fetch.js";
-import { ConnectorCallError } from "../../errors.js";
-import { OperationIndex } from "../_shared/rest/operation-index.js";
-import { callRest, restCall, restTools, restTransport, } from "../_shared/rest/tools.js";
-import { carriesWithheldLink, valueSafety } from "../_shared/rest/value-safety.js";
-import { openapi } from "./openapi.generated.js";
-import { NOTION_FILE_HOSTS, NOTION_VALUE_SAFETY, sanitizeLinks } from "./value-safety.js";
-/** Notion's REST origin. Every request this connector sends goes to exactly this host. */
-export const NOTION_API_BASE_URL = "https://api.notion.com";
-/**
- * Pinned with no override, and equal to the pinned index's `Notion-Version`
- * (a test holds them together, so regenerating the index against a newer
- * version fails until this moves with it). Notion's date-named versions keep
- * working indefinitely, which makes an override look harmless; it is not.
- * `2026-03-11` is where databases split into data sources, `archived` became
- * `in_trash`, and block append took a `position` object instead of an `after`
- * string. Every projection, write body, and index contract here assumes those
- * shapes, so an older version would return quietly wrong results rather than
- * fail loudly.
- */
-export const NOTION_API_VERSION = "2026-03-11";
-/** Notion's hard cap on `page_size` for every paginated endpoint. */
-export const MAX_PAGE_SIZE = 100;
-/** Page retrieval caps `filter_properties` at 100; data-source queries declare no cap. */
-const MAX_PAGE_PROPERTY_FILTERS = 100;
-/** Notion's cap on `children` per append, and on blocks per page create. */
-const MAX_CHILDREN_PER_REQUEST = 100;
-/** Notion's cap on one rich-text run's `text.content`, and on runs in one rich-text array. */
-const MAX_TEXT_CONTENT = 2_000;
-const MAX_RICH_TEXT_RUNS = 100;
-/**
- * Ceiling on the fetches one `integration_get_page_content` walk may spend. Call admission
- * meters tool calls, not the requests inside them, so a deep `depth` would
- * otherwise drain the budget invisibly; the walk stops here and reports
- * `truncated: true` instead.
- */
-const MAX_CONTENT_REQUESTS = 20;
-/**
- * The largest response this connection will read. `page_size` tops out at
- * 100 and every payload is JSON, so four mebibytes is a ceiling on absurdity,
- * not a budget any real read has to think about.
- */
-const NOTION_MAX_RESPONSE_BYTES = 4 * 1024 * 1024;
-const READ_CAP_MS = 60_000;
-/**
- * POSTs that only read, admitted by `notion_api_read`. Each is a query over
- * existing objects that persists nothing. `POST /v1/views/{view_id}/queries`
- * is deliberately absent: it creates a stored view query that lives until
- * `DELETE /v1/views/{view_id}/queries/{query_id}` removes it.
- */
-const READ_POSTS = [
-    ["POST", "/v1/search", "Searches titles shared with the integration; Notion persists nothing."],
-    [
-        "POST",
-        "/v1/data_sources/{data_source_id}/query",
-        "Lists a data source's rows by filter and sort; persists nothing.",
-    ],
-    ["POST", "/v1/blocks/meeting_notes/query", "Lists meeting notes by filter and sort; persists nothing."],
-    ["POST", "/v1/agents/query", "Lists custom agents by name, filter, and sort; persists nothing."],
-    ["POST", "/v1/sessions/query", "Lists agent sessions by title, filter, and sort; persists nothing."],
-    ["POST", "/v1/sessions/{session_id}/events/query", "Lists one session's events; persists nothing."],
-];
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function invalid(message) {
-    throw new ConnectorCallError("invalid_args", message);
-}
-/**
- * Notion repeats `Retry-After` in the body as `additional_data.retry_after`,
- * a string of whole seconds, so a proxy that drops the header still leaves a
- * window to wait out.
- */
-function bodyRetryAfterMs(additional) {
-    const raw = isRecord(additional) ? additional["retry_after"] : undefined;
-    const seconds = typeof raw === "string" || typeof raw === "number" ? Number(raw) : Number.NaN;
-    return Number.isFinite(seconds) && seconds >= 0 ? Math.trunc(seconds * 1000) : undefined;
-}
-/** A Notion object id, dashed or not: the only committed-id shape shown when error text is withheld. */
-const NOTION_ID = /^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/i;
-/**
- * The ids a 503 reports as already committed, so a caller reads them instead
- * of repeating the write. For an operation whose error text is withheld, only
- * ids shaped as Notion ids are named, since anything else could echo what the
- * request sent; the write is still reported as committed.
- */
-function committedIds(additional, withheld) {
-    if (!isRecord(additional))
-        return "";
-    const resource = additional["committed_resource_id"];
-    const children = Array.isArray(additional["committed_child_ids"])
-        ? additional["committed_child_ids"].filter((child) => typeof child === "string")
-        : [];
-    if (typeof resource !== "string" || resource === "")
-        return "";
-    if (withheld && ![resource, ...children].every((committed) => NOTION_ID.test(committed))) {
-        return " Notion committed the write before failing; what it committed is withheld because this operation handles credentials. Read the object instead of repeating the write.";
-    }
-    return children.length
-        ? ` Notion committed the write before failing: it appended ${children.length} block(s) (${children.join(", ")}) under ${resource}. Read that block instead of repeating the write.`
-        : ` Notion committed the write before failing: the object it created or changed is ${resource}. Read it instead of repeating the write.`;
-}
-/**
- * Notion's own next step for a failed write, `additional_data.retry_guidance`.
- * An update to an existing object that was saved anyway names no committed
- * id, only this, so it is relayed as Notion wrote it.
- */
-function retryGuidance(additional) {
-    const guidance = isRecord(additional) ? additional["retry_guidance"] : undefined;
-    const lines = (Array.isArray(guidance) ? guidance : [guidance]).filter((line) => typeof line === "string" && line.trim() !== "");
-    return lines.map((line) => line.trim()).join(" ");
-}
-/**
- * Map to what the caller should do next, not to what Notion's `code` says
- * happened. The two that are easy to mistranslate:
- *
- * - **403 is not an authentication failure.** The token is fine; the integration
- *   lacks a capability, was never shared the object, or the workspace is past
- *   its block limit, and neither `authorize_connector` nor a new token can fix
- *   it. Notion's message says which. Non-retryable call failure.
- * - **404 does not prove absence.** Notion returns `object_not_found` both for an
- *   object that does not exist and for one never shared with the integration, and
- *   will not say which — so not `not_found`, which exists to assert absence
- *   (H11). The message names both possibilities.
- *
- * A 503 on a write may still have been saved. When Notion names what it
- * committed, or gives its own retry guidance, the failure says so and stops
- * being retryable; otherwise the shared path reports a write's outcome as
- * unknown (INV-9).
- *
- * `withheld` replaces every free-text field (message, retry guidance,
- * committed ids) for an operation whose error text the review withholds.
- * Text that does pass has had its pre-signed file links withheld first
- * (`sanitizeLinks`, as on success), since a message can echo the Markdown it
- * rejected.
- */
-function notionFailure(status, headers, payload, withheld = false) {
-    const body = isRecord(payload) ? payload : undefined;
-    const code = typeof body?.["code"] === "string" ? body["code"] : undefined;
-    const additional = body?.["additional_data"];
-    // For an operation the value-safety review withholds, Notion's message is
-    // replaced; its code still routes.
-    const detail = withheld
-        ? `Notion answered HTTP ${status}; its message is withheld because this operation handles credentials.`
-        : typeof body?.["message"] === "string" && body["message"].trim()
-            ? body["message"].trim()
-            : `Notion returned HTTP ${status}.`;
-    const retryAfter = retryAfterMs(headers) ?? bodyRetryAfterMs(additional);
-    const labelled = code ? `Notion ${code}: ${detail}` : detail;
-    if (status === 429) {
-        const reason = isRecord(additional) ? additional["rate_limit_reason"] : undefined;
-        if (reason === "public_api_request_blocked") {
-            return new ConnectorCallError("connector_call_failed", `${labelled} (limit: ${reason}) Notion has restricted this integration's API access. Retrying will not help; an operator must contact Notion support.`, { retryable: false });
-        }
-        const scope = reason === "public_api_space_request_rate_limit"
-            ? " The workspace's shared budget across all its connections is spent, and its window can exceed a minute."
-            : " Notion allows each integration 180 requests a minute (600 on Business and Enterprise), and a separate budget shared by the whole workspace.";
-        return new ConnectorCallError("rate_limited", `${labelled}${typeof reason === "string" ? ` (limit: ${reason})` : ""}${scope} Wait out the retry window.`, { retryAfterMs: retryAfter ?? 1_000 });
-    }
-    if (status === 529) {
-        // Notion documents 529 alongside 429: back off and respect Retry-After.
-        return new ConnectorCallError("unavailable", `${labelled} Notion is overloaded; retry after the reported window.`, {
-            retryAfterMs: retryAfter ?? 5_000,
-        });
-    }
-    if (status === 401) {
-        return new ConnectorCallError("auth_required", `${labelled} The Notion integration token is missing or invalid. Call authorize_connector for recovery options. When available, an operator can set a valid token in this connection in the operator UI.`);
-    }
-    if (status === 403) {
-        return new ConnectorCallError("provider_permission_denied", `${labelled} The token is valid but Notion refused this operation, and Notion's message says why. Usually an operator must enable the matching capability on the Notion integration (comment capabilities are off by default) or share the object with it; a workspace past its plan's block limit also answers 403. Re-authorizing will not help.`, { retryable: false });
-    }
-    if (status === 404) {
-        return new ConnectorCallError("connector_call_failed", `${labelled} Notion returns this both for an object that does not exist and for one that exists but has not been shared with this integration — do not treat it as proof of deletion. Confirm the id, then confirm the page or database is shared with the integration in Notion.`, { retryable: false });
-    }
-    if (status === 400) {
-        // Every documented 400 (validation_error, invalid_json, invalid_request,
-        // invalid_request_url, missing_version, invalid_beta) is a malformed
-        // request, which is exactly what invalid_args means to the caller.
-        return new ConnectorCallError("invalid_args", labelled);
-    }
-    if (status === 409) {
-        return new ConnectorCallError("unavailable", `${labelled} Notion reported a write conflict; this is safe to retry.`, {
-            retryAfterMs: retryAfter ?? 1_000,
-        });
-    }
-    if (status >= 500) {
-        const committed = committedIds(additional, withheld);
-        if (committed) {
-            return new ConnectorCallError("connector_call_failed", `${labelled}${committed}`, { retryable: false });
-        }
-        const guidance = retryGuidance(additional);
-        if (guidance) {
-            return new ConnectorCallError("connector_call_failed", withheld
-                ? `${labelled} Notion sent retry guidance, withheld because this operation handles credentials. Read the object before repeating the write.`
-                : `${labelled} Notion's guidance: ${guidance}`, { retryable: false });
-        }
-        return new ConnectorCallError("unavailable", `${labelled} Notion is failing upstream.`, retryAfter !== undefined ? { retryAfterMs: retryAfter } : {});
-    }
-    return new ConnectorCallError("connector_call_failed", labelled, { retryable: false });
-}
-/**
- * Notion lists carry `results` and `has_more`; the cursor, when there is one,
- * is `next_cursor` and goes back as `start_cursor`: a query parameter on GET
- * lists, a body field on the read-only POST queries. Two shapes differ:
- *
- * - `POST /v1/views/{view_id}/queries` answers a `view_query` object whose
- *   first page continues at `GET /v1/views/{view_id}/queries/{query_id}`
- *   (until `expires_at`), so the page names that path.
- * - `POST /v1/blocks/meeting_notes/query` has no cursor at all: `has_more`
- *   past its `limit` (50 at most) can only be answered by a narrower filter.
- * - A data source or view query stops at 10,000 results with `has_more: false`
- *   and `request_status.type: "incomplete"`. That is a cut-off with no cursor,
- *   reported like the meeting-note one: `hasMore` without `next`.
- *
- * Every shape keeps `hasMore`, so a `select` that drops the body's own
- * completeness fields cannot hide that a list was cut short.
- */
-function page(data, call) {
-    if (!isRecord(data) || typeof data["has_more"] !== "boolean" || !Array.isArray(data["results"]))
-        return undefined;
-    if (!data["has_more"] && incomplete(data))
-        return { hasMore: true };
-    const hasMore = data["has_more"];
-    const next = typeof data["next_cursor"] === "string" && data["next_cursor"] !== "" ? data["next_cursor"] : undefined;
-    if (!hasMore || !next)
-        return { hasMore };
-    if (data["object"] === "view_query" && typeof data["id"] === "string" && typeof data["view_id"] === "string") {
-        return {
-            hasMore,
-            next,
-            param: "start_cursor",
-            in: "query",
-            path: `/v1/views/${encodeURIComponent(data["view_id"])}/queries/${encodeURIComponent(data["id"])}`,
-        };
-    }
-    return { hasMore, next, param: "start_cursor", ...(call.method === "GET" ? {} : { in: "body" }) };
-}
-/** Whether a query stopped at Notion's per-query result cap rather than at its last row. */
-function incomplete(data) {
-    const status = data["request_status"];
-    return isRecord(status) && status["type"] === "incomplete";
-}
-/**
- * A read copied into a write: a file link whose signature this connector
- * withheld would be stored as the placeholder, or fail an exact `old_str`
- * match. Refused before dispatch, named tools and generic writes alike.
- */
-function refuseWithheldLinks(call) {
-    if (call.method === "GET" || call.method === "HEAD")
-        return;
-    if (READ_POSTS.some(([method, path]) => method === call.method && path === call.op.path))
-        return;
-    if (!carriesWithheldLink(call.body, NOTION_FILE_HOSTS))
-        return;
-    invalid("This write carries a Notion file link whose signature Connecta withheld ([redacted]), so Notion would store the placeholder. A redacted file URL cannot be copied into a write: re-upload the file (POST /v1/file_uploads), reference the existing block instead, and match Markdown edits on the text around the media rather than its URL.");
-}
-/** The pinned index, shared by every Notion REST connector in the deployment. */
-let index;
-let transport;
-function notionIndex() {
-    index ??= new OperationIndex(openapi, { vendor: "notion", title: "Notion" });
-    return index;
-}
-/** The reviewed value-safety table over the pinned index. */
-const SAFETY = valueSafety(NOTION_VALUE_SAFETY, () => notionIndex());
-function notionTransport() {
-    transport ??= restTransport({
-        provider: "Notion",
-        baseUrl: NOTION_API_BASE_URL,
-        headers: { "Notion-Version": NOTION_API_VERSION },
-        maxResponseBytes: NOTION_MAX_RESPONSE_BYTES,
-        timeoutMs: READ_CAP_MS,
-        authenticate: async (ctx) => {
-            const token = (await ctx.credential?.get())?.trim();
-            if (!token) {
-                throw new ConnectorCallError("auth_required", "No Notion integration token is configured for this connector. Call authorize_connector for recovery options. When available, an operator can add the token in this connection in the operator UI.");
-            }
-            return { Authorization: `Bearer ${token}` };
-        },
-    });
-    return transport;
-}
-const VENDOR = {
-    vendor: "notion",
-    title: "Notion",
-    get index() {
-        return notionIndex();
-    },
-    transport(server) {
-        return server === undefined
-            ? notionTransport()
-            : `This operation is served from ${server}, which this connector does not reach.`;
-    },
-    failure: (status, headers, payload, call) => notionFailure(status, headers, sanitizeLinks(payload), call ? SAFETY.withholdsErrors(call.op) : false),
-    readPosts: READ_POSTS,
-    valueSafety: SAFETY,
-    // Not an envelope to unwrap: page Markdown carries pre-signed file links
-    // inside its text, where redaction's URL rule cannot reach. Every success
-    // response passes here, named tools and paging included.
-    result: sanitizeLinks,
-    admit: refuseWithheldLinks,
-    page,
-    upload: 'Create the upload with POST /v1/file_uploads and mode "external_url" instead; this connector sends no multipart bodies.',
-    bodyHint: "Notion's JSON request body as notion_api_details lists it",
-};
-/**
- * Send one named-tool request on the shared path (same transport, framing,
- * failure mapping) and insist on an object back. A sent write whose answer
- * cannot be read stays unknown: the caller is told not to repeat it.
- */
-async function notion(ctx, method, path, input = {}) {
-    const { data } = await callRest(VENDOR, restCall(VENDOR, method, path, input), ctx);
-    if (!isRecord(data)) {
-        throw new ConnectorCallError("connector_call_failed", "Notion returned an unreadable or non-object response for a successful status. The request was sent, but its result could not be read; do not repeat a write to recover its result.", { retryable: false });
-    }
-    return data;
-}
-const id = (value) => encodeURIComponent(String(value));
-// Projections. Notion wraps every property in a discriminated object, every
-// string in an array of annotated rich-text runs, and every user in a nested
-// object, so a small query is tens of kilobytes of structure around a few
-// hundred bytes of meaning. Every named read collapses that to ids, plain
-// text, and flattened values. Nothing is lost for good: the reads that can
-// drop something take `raw: true` and return Notion's untouched response.
-//
-// Unknown types unwrap rather than switch exhaustively, because Notion ships
-// additive changes to every pinned version at once — a property type newer than
-// this release degrades to its raw value instead of vanishing.
-/** Concatenate a rich-text array to its plain text. Safe for every variant. */
-function plainText(value) {
-    if (!Array.isArray(value))
-        return "";
-    return value.map((run) => (typeof run?.plain_text === "string" ? run.plain_text : "")).join("");
-}
-/**
- * Wrap a plain string as the rich-text array Notion expects. Notion rejects a
- * run over 2,000 characters, so a longer string becomes consecutive runs, cut
- * between UTF-16 surrogate pairs, never inside one. Past 100 runs Notion
- * rejects the array itself, so that refuses here with the way forward.
- */
-function richText(value, field) {
-    const runs = [];
-    let rest = value;
-    while (rest.length > MAX_TEXT_CONTENT) {
-        const high = rest.charCodeAt(MAX_TEXT_CONTENT - 1);
-        const cut = high >= 0xd800 && high <= 0xdbff ? MAX_TEXT_CONTENT - 1 : MAX_TEXT_CONTENT;
-        runs.push(rest.slice(0, cut));
-        rest = rest.slice(cut);
-    }
-    runs.push(rest);
-    if (runs.length > MAX_RICH_TEXT_RUNS) {
-        invalid(`${field} is ${value.length} characters; Notion accepts at most ${MAX_RICH_TEXT_RUNS} runs of ${MAX_TEXT_CONTENT} characters in one rich-text value. Split it across several blocks.`);
-    }
-    return runs.map((content) => ({ type: "text", text: { content } }));
-}
-function userRef(value) {
-    if (!value || typeof value !== "object")
-        return null;
-    return {
-        id: typeof value.id === "string" ? value.id : null,
-        ...(typeof value.name === "string" ? { name: value.name } : {}),
-    };
-}
-/**
- * Flatten one Notion property value.
- *
- * The `default` branch is not laziness: Notion adds property types to every
- * API version simultaneously, so an exhaustive switch would start returning
- * `undefined` for a type that shipped after this release. Unwrapping
- * `value[value.type]` degrades an unknown type to its raw payload instead.
- */
-function projectPropertyValue(value) {
-    const type = value?.type;
-    switch (type) {
-        case "title":
-        case "rich_text":
-            return plainText(value[type]);
-        case "number":
-        case "checkbox":
-        case "url":
-        case "email":
-        case "phone_number":
-        case "created_time":
-        case "last_edited_time":
-            return value[type] ?? null;
-        case "select":
-        case "status":
-            return value[type]?.name ?? null;
-        case "multi_select":
-            return (value.multi_select ?? []).map((option) => option?.name ?? null);
-        case "date":
-            return value.date
-                ? {
-                    start: value.date.start ?? null,
-                    end: value.date.end ?? null,
-                    ...(value.date.time_zone ? { time_zone: value.date.time_zone } : {}),
-                }
-                : null;
-        case "people":
-            return (value.people ?? []).map(userRef);
-        case "created_by":
-        case "last_edited_by":
-            return userRef(value[type]);
-        case "files":
-            return (value.files ?? []).map((file) => ({
-                name: file?.name ?? null,
-                // A `file` upload carries a signed URL that expires; an `external` one
-                // is a plain link. Agents want the link either way.
-                url: file?.external?.url ?? file?.file?.url ?? null,
-            }));
-        case "relation":
-            return (value.relation ?? [])
-                .map((related) => related?.id ?? null)
-                .filter((related) => typeof related === "string");
-        case "formula":
-            // Notion answers `unsupported` for a value it cannot compute through the API.
-            return value.formula?.type === "unsupported" ? null : (value.formula?.[value.formula?.type] ?? null);
-        case "rollup": {
-            const rollup = value.rollup;
-            if (!rollup || rollup.type === "unsupported")
-                return null;
-            if (rollup.type === "array") {
-                return (rollup.array ?? []).map(projectPropertyValue);
-            }
-            return rollup[rollup.type] ?? null;
-        }
-        case "unique_id":
-            return value.unique_id?.prefix
-                ? `${value.unique_id.prefix}-${value.unique_id.number}`
-                : (value.unique_id?.number ?? null);
-        case "verification":
-            return value.verification?.state ?? null;
-        default:
-            return type ? (value[type] ?? null) : null;
-    }
-}
-function projectProperties(source, select) {
-    const properties = {};
-    const truncated = [];
-    if (!source || typeof source !== "object")
-        return { properties, truncated };
-    for (const [name, value] of Object.entries(source)) {
-        if (select && !select.includes(name))
-            continue;
-        properties[name] = projectPropertyValue(value);
-        if (value?.has_more === true) {
-            truncated.push({ name, id: typeof value?.id === "string" ? value.id : null });
-        }
-    }
-    return { properties, truncated };
-}
-/** The title property's name is arbitrary; its `type` is not. */
-function pageTitle(source) {
-    if (!source || typeof source !== "object")
-        return "";
-    for (const value of Object.values(source)) {
-        if (value?.type === "title")
-            return plainText(value.title);
-    }
-    return "";
-}
-function parentRef(parent) {
-    if (!parent || typeof parent !== "object")
-        return null;
-    const type = parent.type;
-    if (typeof type !== "string")
-        return null;
-    return { type, id: typeof parent[type] === "string" ? parent[type] : null };
-}
-/**
- * An icon as one string: the emoji itself, a native Notion icon's name, a
- * workspace custom emoji as `:name:`, or an image URL.
- */
-function iconRef(icon) {
-    if (!icon || typeof icon !== "object")
-        return null;
-    if (typeof icon.emoji === "string")
-        return icon.emoji;
-    if (icon.type === "icon" && typeof icon.icon?.name === "string")
-        return icon.icon.name;
-    if (icon.type === "custom_emoji" && typeof icon.custom_emoji?.name === "string") {
-        return `:${icon.custom_emoji.name}:`;
-    }
-    return icon.external?.url ?? icon.file?.url ?? null;
-}
-function projectPage(page, select) {
-    const { properties, truncated } = projectProperties(page?.properties, select);
-    return {
-        id: page?.id ?? null,
-        object: "page",
-        title: pageTitle(page?.properties),
-        url: page?.url ?? null,
-        parent: parentRef(page?.parent),
-        icon: iconRef(page?.icon),
-        created_time: page?.created_time ?? null,
-        last_edited_time: page?.last_edited_time ?? null,
-        created_by: userRef(page?.created_by),
-        last_edited_by: userRef(page?.last_edited_by),
-        in_trash: page?.in_trash === true,
-        is_archived: page?.is_archived === true,
-        properties,
-        ...(truncated.length ? { truncated_properties: truncated } : {}),
-    };
-}
-/**
- * Identity fields only, no properties. A 25-result search across a populated
- * database would otherwise drag back hundreds of flattened values for results
- * the agent is about to discard; `integration_get_page` fetches them for the one that hit.
- */
-function projectSearchHit(hit) {
-    if (hit?.object === "data_source") {
-        return {
-            id: hit?.id ?? null,
-            object: "data_source",
-            title: plainText(hit?.title) || (hit?.name ?? ""),
-            database_id: hit?.parent?.database_id ?? null,
-            url: hit?.url ?? null,
-            last_edited_time: hit?.last_edited_time ?? null,
-        };
-    }
-    return {
-        id: hit?.id ?? null,
-        object: hit?.object ?? "page",
-        title: hit?.object === "page" ? pageTitle(hit?.properties) : plainText(hit?.title),
-        url: hit?.url ?? null,
-        parent: parentRef(hit?.parent),
-        last_edited_time: hit?.last_edited_time ?? null,
-    };
-}
-/** Flatten one block to its text plus the few fields its type actually adds. */
-function projectBlock(block, depth) {
-    const type = block?.type;
-    const payload = type ? block?.[type] : undefined;
-    const projected = {
-        id: block?.id ?? null,
-        type: type ?? "unsupported",
-        depth,
-        text: plainText(payload?.rich_text),
-        has_children: block?.has_children === true,
-    };
-    switch (type) {
-        case "to_do":
-            projected["checked"] = payload?.checked === true;
-            break;
-        case "code":
-            projected["language"] = payload?.language ?? null;
-            break;
-        case "child_page":
-        case "child_database":
-            // Notion gives these a plain string title, not a rich-text array.
-            projected["text"] = typeof payload?.title === "string" ? payload.title : "";
-            break;
-        case "image":
-        case "video":
-        case "file":
-        case "pdf":
-            projected["url"] = payload?.external?.url ?? payload?.file?.url ?? null;
-            projected["text"] = plainText(payload?.caption);
-            break;
-        case "bookmark":
-        case "embed":
-        case "link_preview":
-            projected["url"] = payload?.url ?? null;
-            projected["text"] = plainText(payload?.caption);
-            break;
-        case "equation":
-            projected["text"] = payload?.expression ?? "";
-            break;
-        case "table_row":
-            projected["cells"] = (payload?.cells ?? []).map(plainText);
-            break;
-        case "callout":
-            projected["icon"] = iconRef(payload?.icon);
-            break;
-        default:
-            // A block type this projection does not model keeps its payload verbatim
-            // rather than collapsing to an empty string, so a block type newer than
-            // this release still carries its content.
-            if (carriesUnprojectedContent(payload))
-                projected["raw"] = payload;
-            break;
-    }
-    return projected;
-}
-function carriesUnprojectedContent(payload) {
-    if (!payload || typeof payload !== "object")
-        return false;
-    if (Array.isArray(payload.rich_text))
-        return false;
-    return Object.keys(payload).some((key) => key !== "color");
-}
-/**
- * A data source's schema, reduced to what a caller needs to filter and write.
- *
- * Select and status options are kept because a filter or a write that invents
- * an option name fails; everything else about a property collapses to its type.
- */
-function projectSchemaProperty(property) {
-    const type = property?.type;
-    const projected = { id: property?.id ?? null, type: type ?? null };
-    const payload = type ? property?.[type] : undefined;
-    if (type === "select" || type === "multi_select") {
-        projected["options"] = (payload?.options ?? []).map((option) => option?.name ?? null);
-    }
-    else if (type === "status") {
-        projected["options"] = (payload?.options ?? []).map((option) => option?.name ?? null);
-        projected["groups"] = (payload?.groups ?? []).map((group) => group?.name ?? null);
-    }
-    else if (type === "relation") {
-        // Requests must send data_source_id; responses carry both. Give the caller
-        // the one it is allowed to write with.
-        projected["relation_data_source_id"] = payload?.data_source_id ?? null;
-    }
-    else if (type === "formula") {
-        projected["expression"] = payload?.expression ?? null;
-    }
-    else if (type === "rollup") {
-        projected["rollup"] = {
-            relation_property_name: payload?.relation_property_name ?? null,
-            rollup_property_name: payload?.rollup_property_name ?? null,
-            function: payload?.function ?? null,
-        };
-    }
-    return projected;
-}
-// Shared schema fragments. The compact renderer inlines every property
-// description, so these are paid for once per tool that uses them; the long
-// versions live in the usage guide, which is fetched once rather than per tool
-// ([#342](https://github.com/zackbart/connecta/issues/342)).
-const RAW_PROPERTY = {
-    type: "boolean",
-    description: "Return Notion's much larger unprojected response instead of the lean projection.",
-};
-const PAGE_SIZE_PROPERTY = {
-    type: "integer",
-    minimum: 1,
-    maximum: MAX_PAGE_SIZE,
-    description: `Results per page (1-${MAX_PAGE_SIZE}). Defaults to the connector's configured page size.`,
-};
-const START_CURSOR_PROPERTY = {
-    type: "string",
-    description: "Opaque next_cursor from the previous response. Pass it back verbatim.",
-};
-const PROPERTY_SELECT = {
-    type: "array",
-    items: { type: "string" },
-    description: "Return only these property names. Omit for all. The cheapest way to shrink a result.",
-};
-function listOutputSchema(itemSchema) {
-    return {
-        type: "object",
-        properties: {
-            results: { type: "array", items: itemSchema },
-            has_more: { type: "boolean", description: "True when another page exists." },
-            next_cursor: { type: ["string", "null"], description: "Pass as start_cursor to fetch the next page." },
-        },
-        required: ["results", "has_more", "next_cursor"],
-    };
-}
-const PAGE_OUTPUT_SCHEMA = {
-    type: "object",
-    description: "Projected page. With raw: true this is Notion's full page object instead.",
-    properties: {
-        id: { type: "string" },
-        object: { type: "string" },
-        title: { type: "string", description: "Plain text of the title property." },
-        url: { type: ["string", "null"] },
-        parent: {
-            type: ["object", "null"],
-            properties: { type: { type: "string" }, id: { type: ["string", "null"] } },
-            required: ["type", "id"],
-        },
-        icon: { type: ["string", "null"], description: "Emoji, native icon name, :custom_emoji:, or icon URL." },
-        created_time: { type: ["string", "null"] },
-        last_edited_time: { type: ["string", "null"] },
-        created_by: { type: ["object", "null"] },
-        last_edited_by: { type: ["object", "null"] },
-        in_trash: { type: "boolean" },
-        is_archived: { type: "boolean" },
-        properties: {
-            type: "object",
-            description: "Property name to flattened value: text for title/rich_text, name for select/status, array of names for multi_select, array of page ids for relation.",
-        },
-        truncated_properties: {
-            type: "array",
-            items: {
-                type: "object",
-                properties: {
-                    name: { type: "string" },
-                    id: { type: ["string", "null"], description: "The property_id in the property-item path." },
-                },
-                required: ["name", "id"],
-            },
-            description: "Properties Notion truncated at 25 entries. Read each in full with notion_api_read GET /v1/pages/{page_id}/properties/{property_id}.",
-        },
-    },
-    required: ["id", "title", "properties"],
-};
-const BLOCK_OUTPUT_SCHEMA = {
-    type: "object",
-    properties: {
-        id: { type: "string" },
-        type: { type: "string" },
-        depth: { type: "integer", description: "0 for direct children, 1 for their children, and so on." },
-        text: { type: "string", description: "Plain text of the block." },
-        has_children: { type: "boolean" },
-        checked: { type: "boolean", description: "to_do blocks only." },
-        language: { type: ["string", "null"], description: "code blocks only." },
-        url: { type: ["string", "null"], description: "Media and link blocks." },
-        cells: { type: "array", items: { type: "string" }, description: "table_row blocks only." },
-        icon: { type: ["string", "null"], description: "callout blocks only." },
-        raw: {
-            type: "object",
-            description: "The block type's untouched payload, present only for types this projection does not model and whose content is not plain rich text.",
-        },
-    },
-    required: ["id", "type", "depth", "text", "has_children"],
-};
-function resolvePageSize(requested, fallback) {
-    if (typeof requested === "number" && Number.isFinite(requested)) {
-        return Math.min(Math.max(Math.trunc(requested), 1), MAX_PAGE_SIZE);
-    }
-    return fallback;
-}
-function listEnvelope(payload, results) {
-    return { results, has_more: payload?.has_more === true, next_cursor: payload?.next_cursor ?? null };
-}
-function mappedListEnvelope(payload, project) {
-    return listEnvelope(payload, (payload?.results ?? []).map(project));
-}
-function pagination(args, defaultPageSize) {
-    return {
-        page_size: resolvePageSize(args.page_size, defaultPageSize),
-        ...(args.start_cursor ? { start_cursor: args.start_cursor } : {}),
-    };
-}
-/** Both page GETs and data-source POST queries filter properties on the URL. */
-function propertyQuery(properties, maxFilters) {
-    if (properties === undefined)
-        return {};
-    // The title column's name varies, but its id is always `title`. Fetch it
-    // even when projection drops the column so the top-level title survives.
-    const filters = [...new Set([...properties, "title"])];
-    // Filtering is an optimization. An oversized selection still needs every
-    // requested column, so retrieve all properties and keep projecting locally.
-    return maxFilters !== undefined && filters.length > maxFilters ? {} : { filter_properties: filters };
-}
-/** Exactly-one-of validation, phrased so the agent knows what to send next. */
-function requireExactlyOne(provided, hint) {
-    const present = provided.filter(([, value]) => value !== undefined && value !== null && value !== "");
-    if (present.length !== 1) {
-        invalid(`Provide exactly one of ${provided.map(([name]) => name).join(", ")}. ${hint}`);
-    }
-    return present[0];
-}
-/**
- * The named tools. Each earns its catalog bytes over the generic set (H14):
- * the reads flatten Notion's wrapped properties, rich-text runs, and blocks
- * (and walk nesting under a request ceiling); the two writes author Notion's
- * rich-text and block shapes from plain text. Thin wrappers the generic tools
- * replace one for one (database, users, comments, property items, property
- * updates, trash) are gone; the guide names their operations.
- */
-function namedTools(defaultPageSize) {
-    return [
-        {
-            name: "integration_search",
-            description: "Find pages and data sources by title across everything shared with this integration. Never searches page content — use integration_query_data_source for rows inside a database. Returns identity fields only.",
-            annotations: { readOnlyHint: true },
-            inputSchema: {
-                type: "object",
-                required: [],
-                properties: {
-                    query: {
-                        type: "string",
-                        description: "Title substring to match. Omit to list everything shared with the integration.",
-                    },
-                    object_type: {
-                        type: "string",
-                        enum: ["page", "data_source"],
-                        description: "Restrict results to pages or to data sources. Omit for both.",
-                    },
-                    sort: {
-                        type: "string",
-                        enum: ["last_edited_desc", "last_edited_asc", "relevance"],
-                        description: "Result ordering. Defaults to Notion's relevance order.",
-                    },
-                    page_size: PAGE_SIZE_PROPERTY,
-                    start_cursor: START_CURSOR_PROPERTY,
-                    raw: RAW_PROPERTY,
-                },
-                additionalProperties: false,
-            },
-            outputSchema: listOutputSchema({
-                type: "object",
-                properties: {
-                    id: { type: "string" },
-                    object: { type: "string", description: '"page" or "data_source".' },
-                    title: { type: "string" },
-                    url: { type: ["string", "null"] },
-                    parent: { type: ["object", "null"] },
-                    database_id: { type: ["string", "null"], description: "Data source hits only: the containing database." },
-                    last_edited_time: { type: ["string", "null"] },
-                },
-                required: ["id", "object", "title"],
-            }),
-            handler: async (args, ctx) => {
-                const body = pagination(args, defaultPageSize);
-                if (args.query)
-                    body["query"] = args.query;
-                if (args.object_type)
-                    body["filter"] = { property: "object", value: args.object_type };
-                if (args.sort === "relevance") {
-                    body["sort"] = { property: "relevance" };
-                }
-                else if (args.sort) {
-                    body["sort"] = {
-                        timestamp: "last_edited_time",
-                        direction: args.sort === "last_edited_asc" ? "ascending" : "descending",
-                    };
-                }
-                const payload = await notion(ctx, "POST", "/v1/search", { body });
-                if (args.raw)
-                    return payload;
-                return mappedListEnvelope(payload, projectSearchHit);
-            },
-        },
-        {
-            name: "integration_get_page",
-            description: "Fetch one page's metadata and flattened property values by id. Returns the page's properties, not its body content — use integration_get_page_content for the blocks.",
-            annotations: { readOnlyHint: true },
-            inputSchema: {
-                type: "object",
-                properties: {
-                    page_id: { type: "string", description: "Notion page id, with or without dashes." },
-                    properties: PROPERTY_SELECT,
-                    raw: RAW_PROPERTY,
-                },
-                required: ["page_id"],
-                additionalProperties: false,
-            },
-            outputSchema: PAGE_OUTPUT_SCHEMA,
-            handler: async (args, ctx) => {
-                const payload = await notion(ctx, "GET", `/v1/pages/${id(args.page_id)}`, {
-                    query: propertyQuery(args.properties, MAX_PAGE_PROPERTY_FILTERS),
-                });
-                if (args.raw)
-                    return payload;
-                return projectPage(payload, args.properties);
-            },
-        },
-        {
-            name: "integration_get_page_content",
-            // `raw: true` returns the requested level exactly as Notion sent it and
-            // does not walk nested children, so `depth` is ignored alongside it: a
-            // raw read of a deep page yields one level.
-            description: "Read a page's body as a flat list of blocks reduced to plain text. Each block keeps its id, type, and depth so it can be quoted, appended after, or drilled into. Nested content requires depth > 0.",
-            annotations: { readOnlyHint: true },
-            inputSchema: {
-                type: "object",
-                properties: {
-                    block_id: {
-                        type: "string",
-                        description: "Page id, or any block id to read that block's children. A page id is a valid block id.",
-                    },
-                    depth: {
-                        type: "integer",
-                        minimum: 0,
-                        maximum: 2,
-                        description: "How many levels of nested children to follow. 0 (default) returns direct children only. Each level multiplies downstream requests.",
-                    },
-                    page_size: PAGE_SIZE_PROPERTY,
-                    start_cursor: START_CURSOR_PROPERTY,
-                    raw: {
-                        ...RAW_PROPERTY,
-                        description: `${RAW_PROPERTY["description"]} It returns this one level exactly as Notion sent it and does not walk nested children, so depth is ignored alongside it — read a child block_id directly instead.`,
-                    },
-                },
-                required: ["block_id"],
-                additionalProperties: false,
-            },
-            outputSchema: {
-                ...listOutputSchema(BLOCK_OUTPUT_SCHEMA),
-                properties: {
-                    ...listOutputSchema(BLOCK_OUTPUT_SCHEMA)["properties"],
-                    truncated: {
-                        type: "boolean",
-                        description: "True when the nested walk stopped at its request ceiling. Some descendants are missing; re-read a specific block_id to continue.",
-                    },
-                },
-                required: ["results", "has_more", "next_cursor", "truncated"],
-            },
-            handler: async (args, ctx) => {
-                const top = await notion(ctx, "GET", `/v1/blocks/${id(args.block_id)}/children`, {
-                    query: pagination(args, defaultPageSize),
-                });
-                if (args.raw)
-                    return top;
-                const maxDepth = typeof args.depth === "number" ? args.depth : 0;
-                let spent = 1;
-                let truncated = false;
-                const results = [];
-                const walk = async (blocks, depth) => {
-                    for (const block of blocks) {
-                        results.push(projectBlock(block, depth));
-                        if (depth >= maxDepth || block?.has_children !== true)
-                            continue;
-                        if (spent >= MAX_CONTENT_REQUESTS) {
-                            truncated = true;
-                            continue;
-                        }
-                        spent += 1;
-                        const child = await notion(ctx, "GET", `/v1/blocks/${id(block.id)}/children`, {
-                            query: { page_size: MAX_PAGE_SIZE },
-                        });
-                        // Nested levels take their first page only; a block with more than
-                        // 100 children is re-read directly rather than paged here.
-                        if (child["has_more"] === true)
-                            truncated = true;
-                        await walk(child["results"] ?? [], depth + 1);
-                    }
-                };
-                await walk(top["results"] ?? [], 0);
-                return { ...listEnvelope(top, results), truncated };
-            },
-        },
-        {
-            name: "integration_get_data_source_schema",
-            description: "List a data source's properties with their ids, types, and select/status options. Read this before filtering, sorting, or writing — filters and property names that do not match the schema exactly are rejected.",
-            annotations: { readOnlyHint: true },
-            inputSchema: {
-                type: "object",
-                properties: {
-                    data_source_id: {
-                        type: "string",
-                        description: "Data source id from integration_search or a database's data_sources, not a database id.",
-                    },
-                    raw: RAW_PROPERTY,
-                },
-                required: ["data_source_id"],
-                additionalProperties: false,
-            },
-            outputSchema: {
-                type: "object",
-                properties: {
-                    id: { type: "string" },
-                    name: { type: "string" },
-                    database_id: { type: ["string", "null"] },
-                    title_property: {
-                        type: ["string", "null"],
-                        description: "Name of the title-typed property. integration_create_page needs this to title a row.",
-                    },
-                    properties: {
-                        type: "object",
-                        description: "Property name to { id, type, options?, relation_data_source_id? }.",
-                    },
-                },
-                required: ["id", "name", "properties"],
-            },
-            handler: async (args, ctx) => {
-                const payload = await notion(ctx, "GET", `/v1/data_sources/${id(args.data_source_id)}`);
-                if (args.raw)
-                    return payload;
-                const properties = {};
-                let titleProperty = null;
-                for (const [name, property] of Object.entries((payload["properties"] ?? {}))) {
-                    properties[name] = projectSchemaProperty(property);
-                    if (property?.type === "title")
-                        titleProperty = name;
-                }
-                return {
-                    id: payload["id"] ?? null,
-                    name: plainText(payload["title"]) || (payload["name"] ?? ""),
-                    database_id: payload["parent"]?.database_id ?? null,
-                    title_property: titleProperty,
-                    properties,
-                };
-            },
-        },
-        {
-            name: "integration_query_data_source",
-            description: "List rows in a data source with optional filtering and sorting, returning each row's properties already flattened. Requires a data_source_id, never a database_id. Narrow with the properties argument to keep results small.",
-            annotations: { readOnlyHint: true },
-            inputSchema: {
-                type: "object",
-                properties: {
-                    data_source_id: {
-                        type: "string",
-                        description: "Data source id from integration_search or a database's data_sources.",
-                    },
-                    filter: {
-                        type: "object",
-                        description: 'Notion filter object, passed through unchanged. Single condition: {"property":"Status","status":{"equals":"Done"}}. Compound: {"and":[...]} or {"or":[...]}. Property names must match integration_get_data_source_schema exactly.',
-                    },
-                    sorts: {
-                        type: "array",
-                        description: "Sort order, applied in sequence.",
-                        items: {
-                            type: "object",
-                            properties: {
-                                property: { type: "string", description: "Property name to sort by." },
-                                timestamp: {
-                                    type: "string",
-                                    enum: ["created_time", "last_edited_time"],
-                                    description: "Sort by a timestamp instead of a property.",
-                                },
-                                direction: {
-                                    type: "string",
-                                    enum: ["ascending", "descending"],
-                                    description: "Direction for this sort.",
-                                },
-                            },
-                            additionalProperties: false,
-                        },
-                    },
-                    properties: PROPERTY_SELECT,
-                    page_size: PAGE_SIZE_PROPERTY,
-                    start_cursor: START_CURSOR_PROPERTY,
-                    raw: RAW_PROPERTY,
-                },
-                required: ["data_source_id"],
-                additionalProperties: false,
-            },
-            outputSchema: {
-                ...listOutputSchema(PAGE_OUTPUT_SCHEMA),
-                properties: {
-                    ...listOutputSchema(PAGE_OUTPUT_SCHEMA)["properties"],
-                    incomplete: {
-                        type: "boolean",
-                        description: "Present when Notion stopped this query at its 10,000-result cap: has_more is false but rows are missing. Narrow the filter.",
-                    },
-                },
-            },
-            handler: async (args, ctx) => {
-                const body = pagination(args, defaultPageSize);
-                if (args.filter)
-                    body["filter"] = args.filter;
-                if (args.sorts)
-                    body["sorts"] = args.sorts;
-                const payload = await notion(ctx, "POST", `/v1/data_sources/${id(args.data_source_id)}/query`, {
-                    query: propertyQuery(args.properties),
-                    body,
-                });
-                if (args.raw)
-                    return payload;
-                const rows = mappedListEnvelope(payload, (row) => projectPage(row, args.properties));
-                return incomplete(payload) ? { ...rows, incomplete: true } : rows;
-            },
-        },
-        {
-            name: "integration_create_page",
-            description: "Create a page, either as a child of another page or as a row in a data source. Notion has no idempotency key: a retried create makes a second page, so confirm with search before repeating one.",
-            annotations: { readOnlyHint: false },
-            inputSchema: {
-                // A deliberate subset of the 2026-03-11 create contract, reviewed after
-                // the 0.17.0 drift check (#408). Workspace-private pages, templates,
-                // page placement, and the expanded icon/cover forms stay out: they
-                // change ownership, start asynchronous content work, control ordering,
-                // or depend on file surfaces, none of which extend page/row authoring.
-                // notion_api_write reaches the full contract.
-                required: [],
-                type: "object",
-                properties: {
-                    parent_page_id: {
-                        type: "string",
-                        description: "Create as a child page of this page. Exactly one parent id, this or parent_data_source_id.",
-                    },
-                    parent_data_source_id: {
-                        type: "string",
-                        description: "Create as a row in this data source, not a database id. Exactly one parent id, this or parent_page_id.",
-                    },
-                    title: { type: "string", description: "Plain-text title." },
-                    title_property: {
-                        type: "string",
-                        description: 'Name of the title-typed property, from integration_get_data_source_schema. Required in practice for a data-source parent, whose title column is rarely called "title". Defaults to "title", which is the only valid key under a page parent.',
-                    },
-                    properties: {
-                        type: "object",
-                        description: 'Additional Notion property values, keyed by property name and in Notion\'s own wrapped form, e.g. {"Status":{"status":{"name":"Todo"}}}. Read integration_get_data_source_schema first.',
-                    },
-                    markdown: {
-                        type: "string",
-                        description: "Page body as Notion-flavored Markdown. Mutually exclusive with children.",
-                    },
-                    children: {
-                        type: "array",
-                        maxItems: MAX_CHILDREN_PER_REQUEST,
-                        description: "Page body as raw Notion block objects. Mutually exclusive with markdown.",
-                        items: { type: "object" },
-                    },
-                    icon: { type: "string", description: "Emoji to use as the page icon." },
-                },
-                additionalProperties: false,
-            },
-            outputSchema: PAGE_OUTPUT_SCHEMA,
-            handler: async (args, ctx) => {
-                const [parentKey, parentValue] = requireExactlyOne([
-                    ["parent_page_id", args.parent_page_id],
-                    ["parent_data_source_id", args.parent_data_source_id],
-                ], "A page needs exactly one parent, and a data source is addressed by its data_source_id — never by a database_id.");
-                if (args.markdown !== undefined && args.children !== undefined) {
-                    invalid("Provide either markdown or children for the page body, not both.");
-                }
-                const properties = { ...args.properties };
-                if (args.title !== undefined)
-                    properties[args.title_property ?? "title"] = { title: richText(args.title, "title") };
-                const body = {
-                    parent: parentKey === "parent_page_id"
-                        ? { type: "page_id", page_id: parentValue }
-                        : { type: "data_source_id", data_source_id: parentValue },
-                    properties,
-                };
-                if (args.markdown !== undefined)
-                    body["markdown"] = args.markdown;
-                if (args.children !== undefined)
-                    body["children"] = args.children;
-                if (args.icon !== undefined)
-                    body["icon"] = { type: "emoji", emoji: args.icon };
-                return projectPage(await notion(ctx, "POST", "/v1/pages", { body }));
-            },
-        },
-        {
-            name: "integration_append_blocks",
-            description: "Append content to the end of a page or block, or insert it at a chosen position. Appending only adds: existing blocks are never moved or replaced, and an appended block cannot be relocated later through the API.",
-            annotations: { readOnlyHint: false },
-            inputSchema: {
-                type: "object",
-                properties: {
-                    block_id: { type: "string", description: "Page id or block id to append into." },
-                    text: {
-                        type: "array",
-                        items: { type: "string" },
-                        maxItems: MAX_CHILDREN_PER_REQUEST,
-                        description: "Plain-text paragraphs, one block each. Use exactly one of text, checklist, or children.",
-                    },
-                    checklist: {
-                        type: "array",
-                        items: { type: "string" },
-                        maxItems: MAX_CHILDREN_PER_REQUEST,
-                        description: "Plain-text to-do items, one unchecked to_do block each.",
-                    },
-                    children: {
-                        type: "array",
-                        items: { type: "object" },
-                        maxItems: MAX_CHILDREN_PER_REQUEST,
-                        description: "Raw Notion block objects, for anything paragraphs and to-dos cannot express.",
-                    },
-                    position: {
-                        type: "string",
-                        enum: ["end", "start", "after_block"],
-                        description: 'Where to insert. Defaults to "end". "after_block" requires after_block_id.',
-                    },
-                    after_block_id: {
-                        type: "string",
-                        description: 'Insert directly after this block when position is "after_block".',
-                    },
-                },
-                required: ["block_id"],
-                additionalProperties: false,
-            },
-            outputSchema: {
-                type: "object",
-                properties: {
-                    appended: { type: "integer", description: "How many blocks were created." },
-                    results: { type: "array", items: BLOCK_OUTPUT_SCHEMA },
-                },
-                required: ["appended", "results"],
-            },
-            handler: async (args, ctx) => {
-                const [kind, value] = requireExactlyOne([
-                    ["text", args.text],
-                    ["checklist", args.checklist],
-                    ["children", args.children],
-                ], "Use text for plain paragraphs, checklist for to-do items, or children for raw Notion blocks.");
-                const children = kind === "text"
-                    ? value.map((line, at) => ({
-                        object: "block",
-                        type: "paragraph",
-                        paragraph: { rich_text: richText(line, `text[${at}]`) },
-                    }))
-                    : kind === "checklist"
-                        ? value.map((line, at) => ({
-                            object: "block",
-                            type: "to_do",
-                            to_do: { rich_text: richText(line, `checklist[${at}]`), checked: false },
-                        }))
-                        : value;
-                if (children.length === 0)
-                    invalid("Nothing to append: provide at least one block.");
-                const body = { children };
-                if (args.position === "after_block") {
-                    if (!args.after_block_id)
-                        invalid('position "after_block" requires after_block_id.');
-                    body["position"] = { type: "after_block", after_block: { id: args.after_block_id } };
-                }
-                else if (args.position) {
-                    body["position"] = { type: args.position };
-                }
-                const payload = await notion(ctx, "PATCH", `/v1/blocks/${id(args.block_id)}/children`, { body });
-                const results = (payload["results"] ?? []).map((block) => projectBlock(block, 0));
-                return { appended: results.length, results };
-            },
-        },
-    ];
-}
-/** Notion's generic and named REST tools and its credential test. */
-export function notionRest(defaultPageSize) {
-    return {
-        tools: [...restTools(VENDOR), ...namedTools(defaultPageSize)],
-        async testCredential(value, ctx) {
-            // Notion has no token-introspection endpoint for internal integrations;
-            // identifying the bot is the cheapest call that proves the token is live.
-            try {
-                const payload = await notion({ ...ctx, credential: { get: async () => value, getAll: async () => ({ value }) } }, "GET", "/v1/users/me");
-                const name = payload["bot"]?.workspace_name ?? payload["name"] ?? "Notion";
-                return { ok: true, message: `Authenticated as ${name}.` };
-            }
-            catch (error) {
-                return {
-                    ok: false,
-                    message: error instanceof ConnectorCallError ? error.message : "Notion rejected the token.",
-                };
-            }
-        },
-    };
-}