@zackbart/connecta 0.28.1 → 0.30.0

package/dist/providers/basecamp/skill.generated.js

@@ -0,0 +1,9 @@
+// Generated by scripts/generate-providers.mjs; do not edit.
+export const skill = {
+    "content": ". Basecamp's hosted server acts in the single account the grant was made for, and no tool takes an account id.  Another account is another connector, never an argument.\n\n- Confirm the account before relying on it: `get_me` returns the signed-in person and a label naming the connected account. A record id from another account's URL answers \"not found\" here — read that as wrong connector, not missing data.\n- Basecamp's own reference notes are a read away: `get_basecamp_guide` with `topic` `concepts`, `finding-things`, `my-work`, `posting-and-mentions`, or `deleting-and-trash`. Read the topic before an unfamiliar sequence instead of guessing one.\n- Resolve ids before acting; never guess one. A Basecamp URL carries the account, project, and record ids, and `get_by_url` reads any link into those ids, the record, and where a reply goes. `search` finds records by text; `list_projects` then `get_project` returns a project's dock, whose tool ids (to-do set, message board, schedule, vault, card table, chat) the create tools take. People are ids from `list_people`, `list_project_people`, or `list_pingable_people`; mention someone by passing ids as `create_comment`'s `mentions`, not by writing markup.\n- Rich-text bodies (messages, documents, comments, cards, to-do descriptions) are HTML; a to-do's title and a chat line are plain text. Dates are `YYYY-MM-DD`.\n- Lists return up to `limit` items (100 by default). Continue with the `next_cursor` or `next_page` a result carries rather than raising the limit; `truncated: true` means the server cut a result to fit and says where to resume. The event feeds page by `position` instead. `get_card_table`, `get_document`, and the account-wide `list_everything_*` reads are large — reduce inside `execute_code` and return only the fields the question needs.\n- `trash_*` is restorable for 25 days; `delete_*`, `destroy_*`, and `remove_account_logo` are permanent. `update_cloud_file` and `update_google_document` are full replaces: an omitted title or description is erased, so read the record and resend every field you keep. `update_project_access` can invite people into the account.\n- Do not call `create_stream_ticket`: it mints a WebSocket credential for a client that holds a live connection, which a connecta call cannot. Poll `list_feed_events` instead. `get_event_inbox` serves agent accounts only; a person's grant gets `agents_only` back.\n- This connector's tool list is not a fixed set. Basecamp has not published this server and changes it without notice, and timesheets, gauges, hill charts, the Lineup, and check-ins depend on account features, so search this connector for what it actually exposes rather than assuming a tool exists.\n- Basecamp answers a rate limit with `429` and a `Retry-After` in seconds, and adjusts its limits dynamically. Back off for that long rather than retrying at once, and avoid speculative fan-out.\n- Treat every create, update, trash, delete, destroy, move, reposition, complete, pin, archive, enable, disable, watch, and mark operation as a write. For guest calls, classification, and routing, fetch `skills({ name: \"usage\" })`.\n- An `auth_required` failure means this connector's Basecamp authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged. A rejected argument, a permission gap, or a missing feature comes back in Basecamp's own words instead — read it rather than re-authorizing.\n",
+    "instructionsHeading": "Account instructions",
+    "fragments": {
+        "guide_0": ". Basecamp's hosted server acts in the single account the grant was made for, and no tool takes an account id. ",
+        "guide_1": " Another account is another connector, never an argument.\n\n- Confirm the account before relying on it: `get_me` returns the signed-in person and a label naming the connected account. A record id from another account's URL answers \"not found\" here — read that as wrong connector, not missing data.\n- Basecamp's own reference notes are a read away: `get_basecamp_guide` with `topic` `concepts`, `finding-things`, `my-work`, `posting-and-mentions`, or `deleting-and-trash`. Read the topic before an unfamiliar sequence instead of guessing one.\n- Resolve ids before acting; never guess one. A Basecamp URL carries the account, project, and record ids, and `get_by_url` reads any link into those ids, the record, and where a reply goes. `search` finds records by text; `list_projects` then `get_project` returns a project's dock, whose tool ids (to-do set, message board, schedule, vault, card table, chat) the create tools take. People are ids from `list_people`, `list_project_people`, or `list_pingable_people`; mention someone by passing ids as `create_comment`'s `mentions`, not by writing markup.\n- Rich-text bodies (messages, documents, comments, cards, to-do descriptions) are HTML; a to-do's title and a chat line are plain text. Dates are `YYYY-MM-DD`.\n- Lists return up to `limit` items (100 by default). Continue with the `next_cursor` or `next_page` a result carries rather than raising the limit; `truncated: true` means the server cut a result to fit and says where to resume. The event feeds page by `position` instead. `get_card_table`, `get_document`, and the account-wide `list_everything_*` reads are large — reduce inside `execute_code` and return only the fields the question needs.\n- `trash_*` is restorable for 25 days; `delete_*`, `destroy_*`, and `remove_account_logo` are permanent. `update_cloud_file` and `update_google_document` are full replaces: an omitted title or description is erased, so read the record and resend every field you keep. `update_project_access` can invite people into the account.\n- Do not call `create_stream_ticket`: it mints a WebSocket credential for a client that holds a live connection, which a connecta call cannot. Poll `list_feed_events` instead. `get_event_inbox` serves agent accounts only; a person's grant gets `agents_only` back.\n- This connector's tool list is not a fixed set. Basecamp has not published this server and changes it without notice, and timesheets, gauges, hill charts, the Lineup, and check-ins depend on account features, so search this connector for what it actually exposes rather than assuming a tool exists.\n- Basecamp answers a rate limit with `429` and a `Retry-After` in seconds, and adjusts its limits dynamically. Back off for that long rather than retrying at once, and avoid speculative fan-out.\n- Treat every create, update, trash, delete, destroy, move, reposition, complete, pin, archive, enable, disable, watch, and mark operation as a write. For guest calls, classification, and routing, fetch `skills({ name: \"usage\" })`.\n- An `auth_required` failure means this connector's Basecamp authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged. A rejected argument, a permission gap, or a missing feature comes back in Basecamp's own words instead — read it rather than re-authorizing.\n"
+    }
+};

package/dist/providers/{breeze.d.ts → breeze/index.d.ts}

@@ -1,4 +1,4 @@
-import type { Connector, ConnectorCallAdmissionPolicy } from "../types.js";
+import type { ConnectorCallAdmissionPolicy } from "../../types.js";
 /** Every church's API lives at `https://<subdomain>.breezechms.com/api`. */
 export declare const BREEZE_HOST_SUFFIX = ".breezechms.com";
 export interface BreezeOptions {
@@ -31,4 +31,4 @@ export interface BreezeOptions {
     defaultPageSize?: number;
 }
 /** A maintained Breeze ChMS connection for one church's subdomain. */
-export declare function breeze(id: string, options: BreezeOptions): Connector;
+export declare const breeze: import("../../provider.js").ProviderFactory<BreezeOptions>;

package/dist/providers/{breeze.js → breeze/index.js}

@@ -1,3 +1,4 @@
+import { skill } from "./skill.generated.js";
 /**
  * Breeze ChMS — rebranded "Tithely Church Management" on 2025-11-11 — as a
  * hand-written `api()` surface. No SDK exists worth wrapping: Breeze's API is
@@ -52,9 +53,12 @@
  * distinct paths: the Tags section's "List People" points back at /people)
  * plus the 2023 giving, funds, and pledges sections.
  */
-import { apiConnector as api, defined } from "../connectors/api-connector.js";
-import { guardedFetch, retryAfterMs, } from "../connectors/guarded-fetch.js";
-import { ConnectorCallError } from "../errors.js";
+import { apiConnector as api, defined } from "../../connectors/api-connector.js";
+import { guardedFetch, retryAfterMs, } from "../../connectors/guarded-fetch.js";
+import { ConnectorCallError } from "../../errors.js";
+import { keys, optionsOf } from "../../config-schema.js";
+import { PROVIDER_COMMON } from "../../connectors/option-shapes.js";
+import { asProviderFactory } from "../../provider.js";
 /** Every church's API lives at `https://<subdomain>.breezechms.com/api`. */
 export const BREEZE_HOST_SUFFIX = ".breezechms.com";
 const DEFAULT_PAGE_SIZE = 100;
@@ -71,9 +75,7 @@ const BREEZE_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
 /** One DNS label: what `<subdomain>.breezechms.com` can actually be. */
 const SUBDOMAIN_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
 function asRecord(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function asArray(value) {
     return Array.isArray(value) ? value : [];
@@ -96,9 +98,7 @@ function flag(value) {
     return value === true || value === 1 || value === "1";
 }
 function idString(value) {
-    return value === undefined || value === null || value === ""
-        ? undefined
-        : String(value);
+    return value === undefined || value === null || value === "" ? undefined : String(value);
 }
 // --- Transport and failures ---------------------------------------------------
 /**
@@ -158,7 +158,9 @@ function breezeFailure(status, headers, text) {
         const wait = retryAfterMs(headers);
         return new ConnectorCallError("unavailable", `Breeze is failing upstream (HTTP ${status}).`, wait === undefined ? {} : { retryAfterMs: wait });
     }
-    return new ConnectorCallError("connector_call_failed", `Breeze request failed (HTTP ${status}).${detail}`, { retryable: false });
+    return new ConnectorCallError("connector_call_failed", `Breeze request failed (HTTP ${status}).${detail}`, {
+        retryable: false,
+    });
 }
 function shortText(value) {
     if (typeof value === "string")
@@ -211,7 +213,9 @@ async function callBreeze(send, request, ctx, options = {}) {
             // only the parse does. A hatch hands back what arrived.
             if (options.raw)
                 return text;
-            throw new ConnectorCallError("connector_call_failed", "Breeze returned a non-JSON successful response.", { retryable: false });
+            throw new ConnectorCallError("connector_call_failed", "Breeze returned a non-JSON successful response.", {
+                retryable: false,
+            });
         }
         const failure = reportedFailure(payload);
         if (failure)
@@ -253,7 +257,23 @@ const READ_ENDPOINTS = new Map([
     ["/account/summary", []],
     ["/account/list_log", ["action", "start", "end", "user_id", "details", "limit"]],
     // Undocumented since ~2023-09; parameters from the 2023-06-07 reference.
-    ["/giving/list", ["start", "end", "person_id", "include_family", "amount_min", "amount_max", "method_ids", "fund_ids", "envelope_number", "batches", "forms", "pledge_ids"]],
+    [
+        "/giving/list",
+        [
+            "start",
+            "end",
+            "person_id",
+            "include_family",
+            "amount_min",
+            "amount_max",
+            "method_ids",
+            "fund_ids",
+            "envelope_number",
+            "batches",
+            "forms",
+            "pledge_ids",
+        ],
+    ],
     ["/giving/view", ["payment_id"]],
     ["/funds/list", ["include_totals"]],
     ["/pledges/list_campaigns", []],
@@ -289,8 +309,7 @@ function queryPairs(value) {
             throw new ConnectorCallError("invalid_args", `Query parameter ${name} appears more than once; Breeze reads one value per name.`);
         }
         const item = pair["value"];
-        query[name] =
-            item !== null && typeof item === "object" ? JSON.stringify(item) : item;
+        query[name] = item !== null && typeof item === "object" ? JSON.stringify(item) : item;
     }
     return query;
 }
@@ -325,9 +344,7 @@ function projectPerson(value) {
         nickName: person["nick_name"] || undefined,
         middleName: person["middle_name"] || undefined,
         maidenName: person["maiden_name"] || undefined,
-        details: details && typeof details === "object" && !Array.isArray(details)
-            ? details
-            : undefined,
+        details: details && typeof details === "object" && !Array.isArray(details) ? details : undefined,
         family: family.length ? family.map(projectFamilyMember) : undefined,
     });
 }
@@ -610,8 +627,12 @@ function tools(send, defaultPageSize) {
             outputSchema: {
                 type: "object",
                 properties: {
-                    id: { type: "string" }, name: { type: "string" }, subdomain: { type: "string" },
-                    timezone: { type: "string" }, country: { type: "string" }, currency: { type: "string" },
+                    id: { type: "string" },
+                    name: { type: "string" },
+                    subdomain: { type: "string" },
+                    timezone: { type: "string" },
+                    country: { type: "string" },
+                    currency: { type: "string" },
                 },
                 required: ["name"],
             },
@@ -637,11 +658,16 @@ function tools(send, defaultPageSize) {
                 tagId: idProperty("Only people carrying this tag id from list_tags."),
                 filter: {
                     type: "object",
-                    description: "Breeze filter_json: profile fieldId to option ids joined by '-', e.g. {\"2000138015\":\"226-227\"}.",
+                    description: 'Breeze filter_json: profile fieldId to option ids joined by \'-\', e.g. {"2000138015":"226-227"}.',
+                },
+                includeDetails: {
+                    type: "boolean",
+                    description: "Include every profile field (slower, larger). Defaults to false.",
                 },
-                includeDetails: { type: "boolean", description: "Include every profile field (slower, larger). Defaults to false." },
                 limit: {
-                    type: "integer", minimum: 1, maximum: MAX_PAGE_SIZE,
+                    type: "integer",
+                    minimum: 1,
+                    maximum: MAX_PAGE_SIZE,
                     description: `People per page, 1 to connecta's ${MAX_PAGE_SIZE}. Defaults to ${defaultPageSize}.`,
                 },
                 cursor: { type: "string", pattern: ID_PATTERN, description: "Opaque nextCursor from the previous page." },
@@ -712,8 +738,11 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                fieldId: { type: "string" }, name: { type: "string" }, type: { type: "string" },
-                                section: { type: "string" }, options: { type: "array", items: { type: "object" } },
+                                fieldId: { type: "string" },
+                                name: { type: "string" },
+                                type: { type: "string" },
+                                section: { type: "string" },
+                                options: { type: "array", items: { type: "object" } },
                             },
                             required: ["fieldId", "name", "type"],
                         },
@@ -763,7 +792,9 @@ function tools(send, defaultPageSize) {
                 end: dateProperty("Last day, YYYY-MM-DD. Defaults to the end of this month."),
                 calendarId: idProperty("Only events on this calendar from list_calendars."),
                 limit: {
-                    type: "integer", minimum: 1, maximum: MAX_EVENT_LIMIT,
+                    type: "integer",
+                    minimum: 1,
+                    maximum: MAX_EVENT_LIMIT,
                     description: `Instances returned, 1 to Breeze's ${MAX_EVENT_LIMIT}. Defaults to ${DEFAULT_EVENT_LIMIT}.`,
                 },
                 raw: RAW_PROPERTY,
@@ -776,9 +807,12 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string", description: "Instance id." }, eventId: { type: "string", description: "Series id." },
-                                name: { type: "string" }, calendarId: { type: "string" },
-                                startsAt: { type: ["string", "null"] }, endsAt: { type: ["string", "null"] },
+                                id: { type: "string", description: "Instance id." },
+                                eventId: { type: "string", description: "Series id." },
+                                name: { type: "string" },
+                                calendarId: { type: "string" },
+                                startsAt: { type: ["string", "null"] },
+                                endsAt: { type: ["string", "null"] },
                             },
                             required: ["id", "name"],
                         },
@@ -790,7 +824,10 @@ function tools(send, defaultPageSize) {
             handler: async (args, ctx) => {
                 const limit = args["limit"] ?? DEFAULT_EVENT_LIMIT;
                 const rows = asArray(await get("/events", {
-                    start: args["start"], end: args["end"], category_id: args["calendarId"], limit,
+                    start: args["start"],
+                    end: args["end"],
+                    category_id: args["calendarId"],
+                    limit,
                 }, ctx));
                 return {
                     events: args["raw"] === true ? rows : rows.map(projectEvent),
@@ -841,8 +878,11 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                personId: { type: "string" }, firstName: { type: "string" }, lastName: { type: "string" },
-                                checkedInAt: { type: ["string", "null"] }, checkedOutAt: { type: ["string", "null"] },
+                                personId: { type: "string" },
+                                firstName: { type: "string" },
+                                lastName: { type: "string" },
+                                checkedInAt: { type: ["string", "null"] },
+                                checkedOutAt: { type: ["string", "null"] },
                             },
                             required: ["personId"],
                         },
@@ -853,7 +893,9 @@ function tools(send, defaultPageSize) {
             handler: async (args, ctx) => {
                 const wantDetails = args["includeNames"] === true || args["raw"] === true;
                 const rows = asArray(await get("/events/attendance/list", {
-                    instance_id: args["instanceId"], type: "person", details: wantDetails ? "true" : "false",
+                    instance_id: args["instanceId"],
+                    type: "person",
+                    details: wantDetails ? "true" : "false",
                 }, ctx));
                 if (args["raw"] === true)
                     return { attendance: rows };
@@ -887,8 +929,11 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string" }, name: { type: "string" }, slug: { type: "string" },
-                                archived: { type: "boolean" }, createdAt: { type: "string" },
+                                id: { type: "string" },
+                                name: { type: "string" },
+                                slug: { type: "string" },
+                                archived: { type: "boolean" },
+                                createdAt: { type: "string" },
                             },
                             required: ["id", "name"],
                         },
@@ -900,8 +945,11 @@ function tools(send, defaultPageSize) {
                 forms: asArray(await get("/forms/list_forms", { is_archived: args["archived"] === true ? 1 : 0 }, ctx)).map((value) => {
                     const form = asRecord(value);
                     return compact({
-                        id: idString(form["id"]), name: form["name"], slug: form["url_slug"],
-                        archived: flag(form["is_archived"]), createdAt: form["created_on"],
+                        id: idString(form["id"]),
+                        name: form["name"],
+                        slug: form["url_slug"],
+                        archived: flag(form["is_archived"]),
+                        createdAt: form["created_on"],
                     });
                 }),
             }),
@@ -919,7 +967,9 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                fieldId: { type: "string" }, name: { type: "string" }, type: { type: "string" },
+                                fieldId: { type: "string" },
+                                name: { type: "string" },
+                                type: { type: "string" },
                                 options: { type: "array", items: { type: "object" } },
                             },
                             required: ["fieldId", "name"],
@@ -951,8 +1001,10 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string" }, personId: { type: ["string", "null"] },
-                                createdAt: { type: "string" }, responses: { type: "object" },
+                                id: { type: "string" },
+                                personId: { type: ["string", "null"] },
+                                createdAt: { type: "string" },
+                                responses: { type: "object" },
                             },
                             required: ["id"],
                         },
@@ -962,7 +1014,8 @@ function tools(send, defaultPageSize) {
             },
             handler: async (args, ctx) => ({
                 entries: asArray(await get("/forms/list_form_entries", {
-                    form_id: args["formId"], details: args["includeResponses"] === true ? 1 : 0,
+                    form_id: args["formId"],
+                    details: args["includeResponses"] === true ? 1 : 0,
                 }, ctx)).map((value) => {
                     const entry = asRecord(value);
                     return compact({
@@ -987,8 +1040,11 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                personId: { type: "string" }, roleIds: { type: "array", items: { type: "string" } },
-                                response: { type: "string" }, comment: { type: "string" }, rsvpedAt: { type: ["string", "null"] },
+                                personId: { type: "string" },
+                                roleIds: { type: "array", items: { type: "string" } },
+                                response: { type: "string" },
+                                comment: { type: "string" },
+                                rsvpedAt: { type: ["string", "null"] },
                             },
                             required: ["personId", "roleIds"],
                         },
@@ -1033,7 +1089,8 @@ function tools(send, defaultPageSize) {
                     const role = asRecord(value);
                     const quantity = Number(role["quantity"]);
                     return compact({
-                        id: idString(role["id"]), name: role["name"],
+                        id: idString(role["id"]),
+                        name: role["name"],
                         quantity: Number.isFinite(quantity) ? quantity : undefined,
                     });
                 }),
@@ -1045,7 +1102,9 @@ function tools(send, defaultPageSize) {
             annotations: readOnly,
             inputSchema: namedInput({
                 action: {
-                    type: "string", pattern: "^[a-z_]+$", maxLength: 40,
+                    type: "string",
+                    pattern: "^[a-z_]+$",
+                    maxLength: 40,
                     description: "Logged action, e.g. person_updated, tag_assign, contribution_added; the guide lists all.",
                 },
                 start: dateProperty("Only actions on or after this day, YYYY-MM-DD."),
@@ -1053,7 +1112,9 @@ function tools(send, defaultPageSize) {
                 userId: idProperty("Only actions by this Breeze user id."),
                 includeDetails: { type: "boolean", description: "Include Breeze's unstandardized description." },
                 limit: {
-                    type: "integer", minimum: 1, maximum: MAX_LOG_LIMIT,
+                    type: "integer",
+                    minimum: 1,
+                    maximum: MAX_LOG_LIMIT,
                     description: `Rows returned, 1 to Breeze's ${MAX_LOG_LIMIT}. Defaults to ${DEFAULT_LOG_LIMIT}.`,
                 },
             }, ["action"]),
@@ -1065,9 +1126,12 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string" }, action: { type: "string" }, userId: { type: "string" },
+                                id: { type: "string" },
+                                action: { type: "string" },
+                                userId: { type: "string" },
                                 object: { description: "Parsed object_json, usually the affected id." },
-                                createdAt: { type: "string" }, details: {},
+                                createdAt: { type: "string" },
+                                details: {},
                             },
                             required: ["id", "action"],
                         },
@@ -1079,8 +1143,12 @@ function tools(send, defaultPageSize) {
             handler: async (args, ctx) => {
                 const limit = args["limit"] ?? DEFAULT_LOG_LIMIT;
                 const rows = asArray(await get("/account/list_log", {
-                    action: args["action"], start: args["start"], end: args["end"], user_id: args["userId"],
-                    details: args["includeDetails"] === true ? 1 : 0, limit,
+                    action: args["action"],
+                    start: args["start"],
+                    end: args["end"],
+                    user_id: args["userId"],
+                    details: args["includeDetails"] === true ? 1 : 0,
+                    limit,
                 }, ctx));
                 return {
                     entries: rows.map((value) => {
@@ -1123,9 +1191,15 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string" }, paidOn: { type: "string" }, amount: { type: "string" },
-                                method: { type: "string" }, personId: { type: "string" }, firstName: { type: "string" },
-                                lastName: { type: "string" }, batchNumber: { type: "string" }, funds: { type: "array", items: { type: "object" } },
+                                id: { type: "string" },
+                                paidOn: { type: "string" },
+                                amount: { type: "string" },
+                                method: { type: "string" },
+                                personId: { type: "string" },
+                                firstName: { type: "string" },
+                                lastName: { type: "string" },
+                                batchNumber: { type: "string" },
+                                funds: { type: "array", items: { type: "object" } },
                             },
                             required: ["id", "amount"],
                         },
@@ -1139,16 +1213,21 @@ function tools(send, defaultPageSize) {
                 if (args["includeFamily"] === true && args["personId"] === undefined) {
                     throw new ConnectorCallError("invalid_args", "includeFamily needs a personId.");
                 }
-                const joined = (value) => Array.isArray(value) ? value.join("-") : undefined;
+                const joined = (value) => (Array.isArray(value) ? value.join("-") : undefined);
                 // Breeze's 2023 table says DD-MM-YYYY while its own example request
                 // sends 2022-1-15; the server parses both, so the unambiguous ISO day
                 // is what the schema accepts and what goes on the wire.
                 const rows = asArray(await get("/giving/list", {
-                    start: args["start"], end: args["end"], person_id: args["personId"],
+                    start: args["start"],
+                    end: args["end"],
+                    person_id: args["personId"],
                     include_family: args["includeFamily"] === true ? 1 : undefined,
-                    amount_min: args["amountMin"], amount_max: args["amountMax"],
-                    fund_ids: joined(args["fundIds"]), method_ids: joined(args["methodIds"]),
-                    batches: joined(args["batchNumbers"]), envelope_number: args["envelopeNumber"],
+                    amount_min: args["amountMin"],
+                    amount_max: args["amountMax"],
+                    fund_ids: joined(args["fundIds"]),
+                    method_ids: joined(args["methodIds"]),
+                    batches: joined(args["batchNumbers"]),
+                    envelope_number: args["envelopeNumber"],
                 }, ctx));
                 return {
                     contributions: args["raw"] === true ? rows : rows.map(projectContribution),
@@ -1170,8 +1249,10 @@ function tools(send, defaultPageSize) {
                         items: {
                             type: "object",
                             properties: {
-                                id: { type: "string" }, name: { type: "string" },
-                                taxDeductible: { type: "boolean" }, isDefault: { type: "boolean" },
+                                id: { type: "string" },
+                                name: { type: "string" },
+                                taxDeductible: { type: "boolean" },
+                                isDefault: { type: "boolean" },
                             },
                             required: ["id", "name"],
                         },
@@ -1183,8 +1264,10 @@ function tools(send, defaultPageSize) {
                 funds: asArray(await get("/funds/list", {}, ctx)).map((value) => {
                     const fund = asRecord(value);
                     return compact({
-                        id: idString(fund["id"]), name: fund["name"],
-                        taxDeductible: flag(fund["tax_deductible"]), isDefault: flag(fund["is_default"]),
+                        id: idString(fund["id"]),
+                        name: fund["name"],
+                        taxDeductible: flag(fund["tax_deductible"]),
+                        isDefault: flag(fund["is_default"]),
                     });
                 }),
             }),
@@ -1201,7 +1284,8 @@ function tools(send, defaultPageSize) {
             outputSchema: PERSON_SCHEMA,
             handler: async (args, ctx) => {
                 const payload = await get("/people/add", {
-                    first: args["firstName"], last: args["lastName"],
+                    first: args["firstName"],
+                    last: args["lastName"],
                     fields_json: args["fields"] === undefined ? undefined : fieldsJson(args["fields"]),
                 }, ctx);
                 const person = Array.isArray(payload) ? payload[0] : payload;
@@ -1229,7 +1313,10 @@ function tools(send, defaultPageSize) {
             name: "assign_tag",
             description: "Add one tag to one person. Tag ids come from list_tags; adding a tag the person already has changes nothing.",
             annotations: additive,
-            inputSchema: namedInput({ personId: PERSON_ID, tagId: idProperty("Tag id from list_tags.") }, ["personId", "tagId"]),
+            inputSchema: namedInput({ personId: PERSON_ID, tagId: idProperty("Tag id from list_tags.") }, [
+                "personId",
+                "tagId",
+            ]),
             outputSchema: WROTE_SCHEMA("assigned"),
             handler: async (args, ctx) => {
                 requireTrue(await get("/tags/assign", { person_id: args["personId"], tag_id: args["tagId"] }, ctx), "the tag assignment");
@@ -1240,7 +1327,10 @@ function tools(send, defaultPageSize) {
             name: "unassign_tag",
             description: "Remove one tag from one person. The tag itself and its other people are untouched.",
             annotations: destructive,
-            inputSchema: namedInput({ personId: PERSON_ID, tagId: idProperty("Tag id from list_tags.") }, ["personId", "tagId"]),
+            inputSchema: namedInput({ personId: PERSON_ID, tagId: idProperty("Tag id from list_tags.") }, [
+                "personId",
+                "tagId",
+            ]),
             outputSchema: WROTE_SCHEMA("unassigned"),
             handler: async (args, ctx) => {
                 requireTrue(await get("/tags/unassign", { person_id: args["personId"], tag_id: args["tagId"] }, ctx), "the tag removal");
@@ -1255,7 +1345,9 @@ function tools(send, defaultPageSize) {
             outputSchema: WROTE_SCHEMA("checkedIn"),
             handler: async (args, ctx) => {
                 requireTrue(await get("/events/attendance/add", {
-                    person_id: args["personId"], instance_id: args["instanceId"], direction: "in",
+                    person_id: args["personId"],
+                    instance_id: args["instanceId"],
+                    direction: "in",
                 }, ctx), "the check-in");
                 return { checkedIn: true };
             },
@@ -1267,75 +1359,7 @@ function usageGuide(subdomain, purpose, instructions) {
     const churchInstructions = instructions?.trim();
     return `# Breeze ChMS usage
 
-Church database for ${subdomain}.breezechms.com (Breeze ChMS, now Tithely Church Management): people, tags, events, attendance, forms, volunteers, and giving.
-
-Church purpose: ${purpose}
-
-## Sensitive data: reduce in code
-
-People records carry home addresses, phones, birthdates, and family ties, and
-giving records reveal who gives and how much — religious affiliation by proxy.
-Read them inside \`execute_code\` and return only the counts, totals, or the
-few fields the task needs. Never echo whole profiles or donor lists.
-
-## Ids and profile fields
-
-- Ids are numeric strings. Read them from a list tool; never guess one.
-- Events have two ids: an instance id (\`list_events\` \`id\`) for one
-  occurrence, and a series \`eventId\`. Attendance, volunteers, and
-  check-in take the instance id.
-- Person \`details\` are keyed by profile \`fieldId\`, not by name. Call
-  \`list_profile_fields\` once and map ids to names in code. Multiple-choice
-  values and \`list_people\` filters use option ids from the same call;
-  join several with \`-\`.
-- \`list_people\` has no name search. List without details and match names
-  in code, then \`get_person\` the hits.
-- Projections rename Breeze's snake_case fields to camelCase and drop photo
-  paths and internal columns; \`raw: true\` returns Breeze's rows.
-
-## Pagination
-
-\`list_people\` pages by \`cursor\`: continue while \`page.hasMore\`. Breeze
-reports no total, so a full page sets \`hasMore\` and the next may be empty.
-\`list_events\` and \`list_account_log\` do not page: \`truncated: true\`
-means narrow the date range. Other lists return everything.
-
-## Giving
-
-\`list_contributions\` and \`list_funds\` call endpoints Breeze removed from
-its public reference in 2023 but still serves. They may change or vanish
-without notice; a failure there is not your argument's fault. Amounts are
-decimal strings; \`totalAmount\` is an exact sum. Online gifts processed by
-Tithe.ly arrive through its sync, batched per deposit, so the latest days
-may be missing. Read the currency from \`get_account_summary\`.
-
-## Writes and the hatches
-
-- Every write, \`add_person\`, \`assign_tag\`, and \`record_check_in\`
-  included, is a \`call_destructive_tool\` call unless the deployment exempts
-  it in \`execute.approval\`; a program inside \`execute_code\` is refused
-  the rest. Those three only add, and \`add_person\` never deduplicates.
-- \`update_person\` field values: text, date (M/D/YYYY), or option id in
-  \`response\`; email, phone, address, and family_role values in \`details\`.
-- Every Breeze call is a GET, writes included, so the hatches split by
-  endpoint. \`breeze_api_get\` admits only reviewed read endpoints and their
-  documented parameters, such as \`/tags/list_folders\`,
-  \`/events/list_event\`, \`/events/attendance/eligible\`, \`/giving/view\`,
-  and \`/pledges/list_campaigns\`; it refuses anything else. Everything else
-  — event, family, volunteer, and form writes, giving writes, check-out,
-  undocumented parameters — is \`breeze_api_mutate\`. Paths are below
-  \`/api\`; \`*_json\` values may be passed as objects.
-- \`list_account_log\` actions include person_created, person_updated,
-  person_deleted, tag_assign, tag_unassign, event_created,
-  attendance_deleted, form_entry_updated, contribution_added,
-  contribution_updated, contribution_deleted, and batch_updated.
-
-## Rate limits
-
-Breeze publishes no limit and sends no rate headers; a third party reports
-about 20 requests per minute. Keep loops sequential and prefer one list call
-over many single reads.
-${churchInstructions ? `\n## Church instructions\n\n${churchInstructions}\n` : ""}`;
+Church database for ${subdomain}${skill.fragments.guide_0}${purpose}${skill.fragments.guide_1}${churchInstructions ? `\n## ${skill.instructionsHeading}\n\n${churchInstructions}\n` : ""}`;
 }
 // --- Construction --------------------------------------------------------------
 function normalizeSubdomain(raw) {
@@ -1345,17 +1369,31 @@ function normalizeSubdomain(raw) {
     }
     return value;
 }
+/** The closed options breeze() accepts; see `assertKnownOptions`. */
+const BREEZE_OPTIONS = optionsOf()({ ...PROVIDER_COMMON, ...keys("subdomain", "defaultPageSize") });
 /** A maintained Breeze ChMS connection for one church's subdomain. */
-export function breeze(id, options) {
+export const breeze = asProviderFactory({
+    name: "breeze",
+    title: "Breeze ChMS",
+    kind: "api",
+    readme: "Breeze ChMS",
+    bundle: {
+        "baselineGzip": 20637,
+        "maxGzip": 80637,
+        "note": "./providers/breeze starts at 20,637 B gzip: a hand-written api() surface with no hosted-MCP interface, so it carries no MCP SDK. The cap uses the existing baseline + 60,000 B policy.",
+    },
+    skill,
+    options: BREEZE_OPTIONS,
+    create: breezeConnector,
+});
+function breezeConnector(id, options) {
     const purpose = typeof options.purpose === "string" ? options.purpose.trim() : "";
     if (!purpose) {
         throw new Error("breeze() requires a non-empty church purpose.");
     }
     const subdomain = normalizeSubdomain(options.subdomain);
     const defaultPageSize = options.defaultPageSize ?? DEFAULT_PAGE_SIZE;
-    if (!Number.isInteger(defaultPageSize) ||
-        defaultPageSize < 1 ||
-        defaultPageSize > MAX_PAGE_SIZE) {
+    if (!Number.isInteger(defaultPageSize) || defaultPageSize < 1 || defaultPageSize > MAX_PAGE_SIZE) {
         throw new Error(`breeze() defaultPageSize must be a whole number between 1 and ${MAX_PAGE_SIZE}.`);
     }
     const send = breezeTransport(subdomain);
@@ -1377,9 +1415,15 @@ export function breeze(id, options) {
                 const account = asRecord(await callBreeze(send, { method: "GET", path: "/account/summary" }, { ...ctx, credential: { get: async () => value, getAll: async () => ({ value }) } }));
                 const reported = typeof account["subdomain"] === "string" ? account["subdomain"].toLowerCase() : undefined;
                 if (reported && reported !== subdomain) {
-                    return { ok: false, message: `The key belongs to ${reported}${BREEZE_HOST_SUFFIX}, not ${subdomain}${BREEZE_HOST_SUFFIX}.` };
+                    return {
+                        ok: false,
+                        message: `The key belongs to ${reported}${BREEZE_HOST_SUFFIX}, not ${subdomain}${BREEZE_HOST_SUFFIX}.`,
+                    };
                 }
-                return { ok: true, message: `Authenticated to ${String(account["name"] ?? "the church account")} (${subdomain}${BREEZE_HOST_SUFFIX}).` };
+                return {
+                    ok: true,
+                    message: `Authenticated to ${String(account["name"] ?? "the church account")} (${subdomain}${BREEZE_HOST_SUFFIX}).`,
+                };
             }
             catch (error) {
                 return {