@zackbart/connecta 0.28.1 → 0.29.0

package/dist/providers/{planning-center.js → planning-center/index.js}

@@ -1,3 +1,4 @@
+import { skill } from "./skill.generated.js";
 /**
  * Planning Center Online as a hand-written `api()` provider: named tools for
  * the jobs a church staff agent actually does, plus two hatches split by safety
@@ -19,16 +20,19 @@
  * Drift. Planning Center publishes an OpenAPI 3.1 document per product and
  * dated version (`/<app>/v2/open_api/<version>`) and a credential-free
  * documentation graph listing every version (`/<app>/v2/documentation`).
- * `scripts/drift/planning-center-endpoints.json` records each endpoint a named
+ * `src/providers/planning-center/drift.json` records each endpoint a named
  * tool calls, digested at the version pinned below, and
  * `npm run providers:check -- --provider planning-center` reports a touched
  * contract that moved and a newly published version of any pinned product.
  * Both are evidence only: no tool here is generated from either document.
  */
-import { apiConnector as api } from "../connectors/api-connector.js";
-import { guardedFetch, retryAfterMs, } from "../connectors/guarded-fetch.js";
-import { ConnectorCallError } from "../errors.js";
-import { CONNECTA_VERSION } from "../version.js";
+import { apiConnector as api } from "../../connectors/api-connector.js";
+import { guardedFetch, retryAfterMs, } from "../../connectors/guarded-fetch.js";
+import { ConnectorCallError } from "../../errors.js";
+import { CONNECTA_VERSION } from "../../version.js";
+import { keys, optionsOf } from "../../config-schema.js";
+import { PROVIDER_COMMON } from "../../connectors/option-shapes.js";
+import { asProviderFactory } from "../../provider.js";
 /** Planning Center's REST origin. Override only for a proxy or test double. */
 export const PLANNING_CENTER_API_BASE_URL = "https://api.planningcenteronline.com";
 /** The products behind `/<app>/v2`, in the order their guides list them. */
@@ -148,9 +152,7 @@ const PERSONAL_ACCESS_TOKEN = {
     },
 };
 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 : [];
@@ -267,9 +269,7 @@ function errorDetail(payload, status) {
         if (text)
             parts.push(`${text}${at}`);
     }
-    return parts.length > 0
-        ? `Planning Center: ${parts.join("; ")}`
-        : `Planning Center returned HTTP ${status}.`;
+    return parts.length > 0 ? `Planning Center: ${parts.join("; ")}` : `Planning Center returned HTTP ${status}.`;
 }
 /**
  * Map by the caller's next move.
@@ -293,7 +293,7 @@ function planningCenterFailure(status, headers, payload) {
         return new ConnectorCallError("auth_required", `${detail} The personal access token was rejected: revoked, mistyped, or an Application ID and Secret from different tokens. An operator must replace it.`);
     }
     if (status === 403) {
-        return new ConnectorCallError("connector_call_failed", `${detail} The token's Planning Center user lacks permission for this product or record. Permissions belong to that user; an operator must raise them or use another user's token. Retrying will not help.`, { retryable: false });
+        return new ConnectorCallError("provider_permission_denied", `${detail} The token's Planning Center user lacks permission for this product or record. Permissions belong to that user; an operator must raise them or use another user's token. Retrying will not help.`, { retryable: false });
     }
     if (status === 404) {
         return new ConnectorCallError("not_found", `${detail} Confirm the id with its list tool. A person id that used to resolve was probably merged: look it up in /people/v2/person_mergers with where[person_to_remove_id].`);
@@ -471,8 +471,20 @@ const PERSON_SCHEMA = record({
     addresses: ARRAY,
     households: ARRAY,
 });
-const EMAIL_SCHEMA = record({ id: STRING, address: STRING, location: NULLABLE_STRING, primary: BOOLEAN, person_id: STRING });
-const PHONE_SCHEMA = record({ id: STRING, number: STRING, location: NULLABLE_STRING, primary: BOOLEAN, person_id: STRING });
+const EMAIL_SCHEMA = record({
+    id: STRING,
+    address: STRING,
+    location: NULLABLE_STRING,
+    primary: BOOLEAN,
+    person_id: STRING,
+});
+const PHONE_SCHEMA = record({
+    id: STRING,
+    number: STRING,
+    location: NULLABLE_STRING,
+    primary: BOOLEAN,
+    person_id: STRING,
+});
 const CARD_SCHEMA = record({
     id: STRING,
     stage: STRING,
@@ -560,7 +572,10 @@ function personSummary(person, index) {
     };
 }
 function emailRecord(email) {
-    return compact({ ...pick(email, ["address", "location", "primary"]), person_id: relId(email, "person") ?? undefined });
+    return compact({
+        ...pick(email, ["address", "location", "primary"]),
+        person_id: relId(email, "person") ?? undefined,
+    });
 }
 function phoneRecord(phone) {
     return compact({ ...pick(phone, ["number", "location", "primary"]), person_id: relId(phone, "person") ?? undefined });
@@ -738,10 +753,21 @@ const PERSON_WRITE_PROPERTIES = {
     lastName: { type: "string", minLength: 1, description: "Last name." },
     nickname: { type: ["string", "null"], description: "Nickname; null clears it." },
     middleName: { type: ["string", "null"], description: "Middle name; null clears it." },
-    birthdate: { type: ["string", "null"], pattern: "^\\d{4}-\\d{2}-\\d{2}$", description: "Birthdate, YYYY-MM-DD; null clears it." },
-    anniversary: { type: ["string", "null"], pattern: "^\\d{4}-\\d{2}-\\d{2}$", description: "Anniversary, YYYY-MM-DD; null clears it." },
+    birthdate: {
+        type: ["string", "null"],
+        pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+        description: "Birthdate, YYYY-MM-DD; null clears it.",
+    },
+    anniversary: {
+        type: ["string", "null"],
+        pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+        description: "Anniversary, YYYY-MM-DD; null clears it.",
+    },
     gender: { type: ["string", "null"], description: "Gender as the organization records it, e.g. Male or Female." },
-    membership: { type: ["string", "null"], description: "Membership type, one of the organization's own values such as Member or Visitor." },
+    membership: {
+        type: ["string", "null"],
+        description: "Membership type, one of the organization's own values such as Member or Visitor.",
+    },
     child: { type: "boolean", description: "Whether the person is a child." },
     primaryCampusId: { type: "string", pattern: "^[0-9]+$", description: "Campus id from /people/v2/campuses." },
 };
@@ -760,15 +786,7 @@ function personAttributes(args) {
         status: args["status"],
     };
 }
-const WORKFLOW_CARD_ACTIONS = [
-    "promote",
-    "go_back",
-    "skip_step",
-    "snooze",
-    "unsnooze",
-    "remove",
-    "restore",
-];
+const WORKFLOW_CARD_ACTIONS = ["promote", "go_back", "skip_step", "snooze", "unsnooze", "remove", "restore"];
 function tools(call, defaultPageSize) {
     const perPage = (args) => args["perPage"] ?? defaultPageSize;
     const list = (spec) => listTool(call, defaultPageSize, spec);
@@ -909,7 +927,11 @@ function tools(call, defaultPageSize) {
             inputSchema: input({
                 personId: PERSON_ID,
                 ...PERSON_WRITE_PROPERTIES,
-                status: { type: "string", enum: ["active", "inactive"], description: "inactive archives the profile; active restores it." },
+                status: {
+                    type: "string",
+                    enum: ["active", "inactive"],
+                    description: "inactive archives the profile; active restores it.",
+                },
             }, ["personId"]),
             outputSchema: PERSON_SUMMARY_SCHEMA,
             handler: async (args, ctx) => {
@@ -953,7 +975,11 @@ function tools(call, defaultPageSize) {
             inputSchema: input({
                 personId: PERSON_ID,
                 number: { type: "string", minLength: 3, description: "Phone number as dialed; Planning Center formats it." },
-                location: { type: "string", minLength: 1, description: "Label such as Mobile, Home, or Work. Defaults to Mobile." },
+                location: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Label such as Mobile, Home, or Work. Defaults to Mobile.",
+                },
                 primary: { type: "boolean", description: "Make this the primary number." },
             }, ["personId", "number"]),
             outputSchema: PHONE_SCHEMA,
@@ -987,7 +1013,15 @@ function tools(call, defaultPageSize) {
             },
             path: () => "/people/v2/lists",
             query: (args) => ({ "where[name]": args["name"], order: args["order"] }),
-            project: (row) => pick(row, ["name", "description", "total_people", "status", "refreshed_at", "auto_refresh", "automations_active"]),
+            project: (row) => pick(row, [
+                "name",
+                "description",
+                "total_people",
+                "status",
+                "refreshed_at",
+                "auto_refresh",
+                "automations_active",
+            ]),
         }),
         list({
             name: "list_list_people",
@@ -1058,7 +1092,11 @@ function tools(call, defaultPageSize) {
             item: CARD_SCHEMA,
             properties: {
                 workflowId: idProperty("Workflow id from list_workflows."),
-                stage: { type: "string", minLength: 1, description: "Card stage as Planning Center reports it, e.g. ready, snoozed, completed, removed." },
+                stage: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Card stage as Planning Center reports it, e.g. ready, snoozed, completed, removed.",
+                },
                 stepId: idProperty("Only cards on this step (list_workflows steps[].id)."),
                 assigneeId: idProperty("Only cards assigned to this person id."),
                 overdue: { type: "boolean", description: "Only overdue (true) or on-time (false) cards." },
@@ -1104,7 +1142,12 @@ function tools(call, defaultPageSize) {
                     enum: [...WORKFLOW_CARD_ACTIONS],
                     description: "promote completes the step; skip_step moves on without completing it; go_back returns to the previous step.",
                 },
-                snoozeDays: { type: "integer", minimum: 1, maximum: 365, description: "Days to snooze; required with action snooze and refused otherwise." },
+                snoozeDays: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 365,
+                    description: "Days to snooze; required with action snooze and refused otherwise.",
+                },
             }, ["personId", "cardId", "action"]),
             outputSchema: record({ cardId: STRING, action: STRING, applied: BOOLEAN }, ["cardId", "action", "applied"]),
             handler: async (args, ctx) => {
@@ -1254,7 +1297,13 @@ function tools(call, defaultPageSize) {
             name: "list_service_types",
             description: "List Services service types — the recurring services such as Sunday Morning. Supplies serviceTypeId for plans and teams.",
             key: "serviceTypes",
-            item: record({ id: STRING, name: STRING, frequency: NULLABLE_STRING, sequence: NULLABLE_INTEGER, parent_id: NULLABLE_STRING }),
+            item: record({
+                id: STRING,
+                name: STRING,
+                frequency: NULLABLE_STRING,
+                sequence: NULLABLE_INTEGER,
+                parent_id: NULLABLE_STRING,
+            }),
             path: () => "/services/v2/service_types",
             query: () => ({ order: "sequence" }),
             project: (row) => ({ ...pick(row, ["name", "frequency", "sequence"]), parent_id: relId(row, "parent") ?? null }),
@@ -1276,7 +1325,11 @@ function tools(call, defaultPageSize) {
             }),
             properties: {
                 serviceTypeId: SERVICE_TYPE_ID,
-                when: { type: "string", enum: ["future", "past", "all"], description: "future (default) sorts soonest first; past sorts most recent first." },
+                when: {
+                    type: "string",
+                    enum: ["future", "past", "all"],
+                    description: "future (default) sorts soonest first; past sorts most recent first.",
+                },
             },
             required: ["serviceTypeId"],
             path: (args) => `/services/v2/service_types/${segment(args["serviceTypeId"])}/plans`,
@@ -1302,7 +1355,10 @@ function tools(call, defaultPageSize) {
             name: "get_plan",
             description: "Get one plan with its times, order of service, and scheduled team in a single call. Flags a section past 100 rows rather than dropping it silently.",
             annotations: READ,
-            inputSchema: input({ serviceTypeId: SERVICE_TYPE_ID, planId: PLAN_ID, raw: RAW_PROPERTY }, ["serviceTypeId", "planId"]),
+            inputSchema: input({ serviceTypeId: SERVICE_TYPE_ID, planId: PLAN_ID, raw: RAW_PROPERTY }, [
+                "serviceTypeId",
+                "planId",
+            ]),
             outputSchema: {
                 type: "object",
                 properties: {
@@ -1340,12 +1396,18 @@ function tools(call, defaultPageSize) {
                 const teamIndex = indexIncluded(teamDocument);
                 return {
                     plan: {
-                        ...pick(plan, ["title", "series_title", "dates", "sort_date", "total_length", "needed_positions_count", "planning_center_url"]),
+                        ...pick(plan, [
+                            "title",
+                            "series_title",
+                            "dates",
+                            "sort_date",
+                            "total_length",
+                            "needed_positions_count",
+                            "planning_center_url",
+                        ]),
                         times: relatedMany(plan, "plan_times", planIndex).map((time) => pick(time, ["name", "time_type", "starts_at", "ends_at"])),
                     },
-                    items: items
-                        .map(itemRecord)
-                        .sort((a, b) => Number(a["sequence"] ?? 0) - Number(b["sequence"] ?? 0)),
+                    items: items.map(itemRecord).sort((a, b) => Number(a["sequence"] ?? 0) - Number(b["sequence"] ?? 0)),
                     teamMembers: members.map((member) => planPersonRecord(member, teamIndex)),
                     ...truncation,
                 };
@@ -1386,9 +1448,20 @@ function tools(call, defaultPageSize) {
             },
             required: ["personId"],
             path: (args) => `/services/v2/people/${segment(args["personId"])}/schedules`,
-            query: (args) => ({ filter: args["when"] ?? "future", order: args["when"] === "past" ? "-starts_at" : "starts_at" }),
+            query: (args) => ({
+                filter: args["when"] ?? "future",
+                order: args["when"] === "past" ? "-starts_at" : "starts_at",
+            }),
             project: (row) => ({
-                ...pick(row, ["dates", "sort_date", "service_type_name", "team_name", "team_position_name", "status", "decline_reason"]),
+                ...pick(row, [
+                    "dates",
+                    "sort_date",
+                    "service_type_name",
+                    "team_name",
+                    "team_position_name",
+                    "status",
+                    "decline_reason",
+                ]),
                 plan_id: relId(row, "plan") ?? null,
             }),
         }),
@@ -1401,9 +1474,16 @@ function tools(call, defaultPageSize) {
                 planId: PLAN_ID,
                 personId: PERSON_ID,
                 teamId: idProperty("Team id from list_teams."),
-                teamPositionName: { type: "string", minLength: 1, description: "Position name from list_teams positions[].name." },
+                teamPositionName: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Position name from list_teams positions[].name.",
+                },
                 status: { type: "string", enum: ["U", "C"], description: "U unconfirmed (default) or C confirmed." },
-                prepareNotification: { type: "boolean", description: "Queue Planning Center's scheduling notification for this person." },
+                prepareNotification: {
+                    type: "boolean",
+                    description: "Queue Planning Center's scheduling notification for this person.",
+                },
                 notes: { type: "string", description: "Note shown to the person." },
             }, ["serviceTypeId", "planId", "personId", "teamId"]),
             outputSchema: PLAN_PERSON_SCHEMA,
@@ -1438,7 +1518,11 @@ function tools(call, defaultPageSize) {
                 keyId: idProperty("Key id from list_song_arrangements keys[].id."),
                 length: { type: "integer", minimum: 0, maximum: 86_400, description: "Length in seconds." },
                 sequence: { type: "integer", minimum: 0, description: "Position in the order; omit to append." },
-                servicePosition: { type: "string", enum: ["pre", "during", "post"], description: "Before, during, or after the service. Defaults to during." },
+                servicePosition: {
+                    type: "string",
+                    enum: ["pre", "during", "post"],
+                    description: "Before, during, or after the service. Defaults to during.",
+                },
                 description: { type: "string", description: "Item description." },
             }, ["serviceTypeId", "planId", "title"]),
             outputSchema: ITEM_SCHEMA,
@@ -1530,7 +1614,11 @@ function tools(call, defaultPageSize) {
             properties: {
                 name: { type: "string", minLength: 1, description: "Exact group name; end it with % for a prefix match." },
                 groupTypeId: idProperty("Only groups of this type (/groups/v2/group_types)."),
-                archived: { type: "string", enum: ["exclude", "include", "only"], description: "Archived groups: exclude (default), include, or only." },
+                archived: {
+                    type: "string",
+                    enum: ["exclude", "include", "only"],
+                    description: "Archived groups: exclude (default), include, or only.",
+                },
                 order: orderProperty(["name", "created_at", "memberships_count"]),
             },
             path: () => "/groups/v2/groups",
@@ -1541,7 +1629,14 @@ function tools(call, defaultPageSize) {
                 order: args["order"],
             }),
             project: (row) => ({
-                ...pick(row, ["name", "memberships_count", "schedule", "contact_email", "archived_at", "public_church_center_web_url"]),
+                ...pick(row, [
+                    "name",
+                    "memberships_count",
+                    "schedule",
+                    "contact_email",
+                    "archived_at",
+                    "public_church_center_web_url",
+                ]),
                 group_type_id: relId(row, "group_type") ?? null,
             }),
         }),
@@ -1606,7 +1701,7 @@ function tools(call, defaultPageSize) {
                 startsBefore: dateProperty("Only events starting before this time."),
                 includeCanceled: { type: "boolean", description: "Include canceled events." },
             },
-            path: (args) => args["groupId"] ? `/groups/v2/groups/${segment(args["groupId"])}/events` : "/groups/v2/events",
+            path: (args) => (args["groupId"] ? `/groups/v2/groups/${segment(args["groupId"])}/events` : "/groups/v2/events"),
             query: (args) => ({
                 ...range(["starts_at"], args["startsAfter"], args["startsBefore"]),
                 filter: args["includeCanceled"] === true ? undefined : "not_canceled",
@@ -1628,7 +1723,10 @@ function tools(call, defaultPageSize) {
                 includeArchived: { type: "boolean", description: "Include archived events." },
             },
             path: () => "/check-ins/v2/events",
-            query: (args) => ({ "where[name]": args["name"], filter: args["includeArchived"] === true ? undefined : "not_archived" }),
+            query: (args) => ({
+                "where[name]": args["name"],
+                filter: args["includeArchived"] === true ? undefined : "not_archived",
+            }),
             project: (row) => pick(row, ["name", "frequency", "archived_at"]),
         }),
         list({
@@ -1653,7 +1751,15 @@ function tools(call, defaultPageSize) {
             required: ["eventId"],
             path: (args) => `/check-ins/v2/events/${segment(args["eventId"])}/event_periods`,
             query: (args) => ({ ...range(["starts_at"], args["startsAfter"], args["startsBefore"]), order: "-starts_at" }),
-            project: (row) => pick(row, ["starts_at", "ends_at", "regular_count", "guest_count", "volunteer_count", "unique_total_count", "note"]),
+            project: (row) => pick(row, [
+                "starts_at",
+                "ends_at",
+                "regular_count",
+                "guest_count",
+                "volunteer_count",
+                "unique_total_count",
+                "note",
+            ]),
         }),
         list({
             name: "list_check_ins",
@@ -1686,7 +1792,16 @@ function tools(call, defaultPageSize) {
                 order: args["order"],
             }),
             project: (row) => ({
-                ...pick(row, ["first_name", "last_name", "kind", "number", "security_code", "created_at", "checked_out_at", "one_time_guest"]),
+                ...pick(row, [
+                    "first_name",
+                    "last_name",
+                    "kind",
+                    "number",
+                    "security_code",
+                    "created_at",
+                    "checked_out_at",
+                    "one_time_guest",
+                ]),
                 person_id: relId(row, "person") ?? null,
                 event_period_id: relId(row, "event_period") ?? null,
             }),
@@ -1720,7 +1835,16 @@ function tools(call, defaultPageSize) {
                 order: "starts_at",
             }),
             project: (row) => ({
-                ...pick(row, ["name", "starts_at", "ends_at", "all_day_event", "location", "kind", "recurrence_description", "church_center_url"]),
+                ...pick(row, [
+                    "name",
+                    "starts_at",
+                    "ends_at",
+                    "all_day_event",
+                    "location",
+                    "kind",
+                    "recurrence_description",
+                    "church_center_url",
+                ]),
                 event_id: relId(row, "event") ?? null,
             }),
         }),
@@ -1742,11 +1866,25 @@ function tools(call, defaultPageSize) {
                 new_registration_url: NULLABLE_STRING,
             }),
             properties: {
-                archived: { type: "string", enum: ["unarchived", "archived", "all"], description: "unarchived (default), archived, or all." },
+                archived: {
+                    type: "string",
+                    enum: ["unarchived", "archived", "all"],
+                    description: "unarchived (default), archived, or all.",
+                },
             },
             path: () => "/registrations/v2/signups",
             query: (args) => ({ filter: args["archived"] === "all" ? undefined : (args["archived"] ?? "unarchived") }),
-            project: (row) => pick(row, ["name", "open", "closed", "open_at", "close_at", "maximum_capacity", "at_maximum_capacity", "archived", "new_registration_url"]),
+            project: (row) => pick(row, [
+                "name",
+                "open",
+                "closed",
+                "open_at",
+                "close_at",
+                "maximum_capacity",
+                "at_maximum_capacity",
+                "archived",
+                "new_registration_url",
+            ]),
         }),
         list({
             name: "list_signup_attendees",
@@ -1764,7 +1902,11 @@ function tools(call, defaultPageSize) {
             }),
             properties: {
                 signupId: idProperty("Signup id from list_signups."),
-                status: { type: "string", enum: ["active", "waitlist", "canceled"], description: "Only attendees in this state." },
+                status: {
+                    type: "string",
+                    enum: ["active", "waitlist", "canceled"],
+                    description: "Only attendees in this state.",
+                },
             },
             required: ["signupId"],
             path: (args) => `/registrations/v2/signups/${segment(args["signupId"])}/attendees`,
@@ -1803,7 +1945,14 @@ function tools(call, defaultPageSize) {
             name: "list_funds",
             description: "List Giving funds with ledger codes and visibility. Supplies fundId for donation filters.",
             key: "funds",
-            item: record({ id: STRING, name: STRING, ledger_code: NULLABLE_STRING, visibility: STRING, default: BOOLEAN, description: NULLABLE_STRING }),
+            item: record({
+                id: STRING,
+                name: STRING,
+                ledger_code: NULLABLE_STRING,
+                visibility: STRING,
+                default: BOOLEAN,
+                description: NULLABLE_STRING,
+            }),
             path: () => "/giving/v2/funds",
             project: (row) => pick(row, ["name", "ledger_code", "visibility", "default", "description"]),
         }),
@@ -1823,12 +1972,24 @@ function tools(call, defaultPageSize) {
                 batch_group_id: NULLABLE_STRING,
             }),
             properties: {
-                status: { type: "string", enum: ["committed", "in_progress"], description: "Only committed or in-progress batches." },
+                status: {
+                    type: "string",
+                    enum: ["committed", "in_progress"],
+                    description: "Only committed or in-progress batches.",
+                },
             },
             path: () => "/giving/v2/batches",
             query: (args) => ({ filter: args["status"], order: "-updated_at" }),
             project: (row) => ({
-                ...pick(row, ["description", "status", "donations_count", "total_cents", "total_currency", "committed_at", "created_at"]),
+                ...pick(row, [
+                    "description",
+                    "status",
+                    "donations_count",
+                    "total_cents",
+                    "total_currency",
+                    "committed_at",
+                    "created_at",
+                ]),
                 batch_group_id: relId(row, "batch_group") ?? null,
             }),
         }),
@@ -1895,12 +2056,21 @@ function tools(call, defaultPageSize) {
                 person_id: NULLABLE_STRING,
                 designations: DESIGNATIONS,
             }),
-            properties: { status: { type: "string", minLength: 1, description: "Status as Planning Center reports it, e.g. active." } },
+            properties: {
+                status: { type: "string", minLength: 1, description: "Status as Planning Center reports it, e.g. active." },
+            },
             path: () => "/giving/v2/recurring_donations",
             query: (args) => ({ "where[status]": args["status"] }),
             include: "designations,designations.fund",
             project: (row, index) => ({
-                ...pick(row, ["amount_cents", "amount_currency", "schedule", "status", "next_occurrence", "last_donation_received_at"]),
+                ...pick(row, [
+                    "amount_cents",
+                    "amount_currency",
+                    "schedule",
+                    "status",
+                    "next_occurrence",
+                    "last_donation_received_at",
+                ]),
                 person_id: relId(row, "person") ?? null,
                 designations: designations(row, index),
             }),
@@ -1911,9 +2081,20 @@ function tools(call, defaultPageSize) {
             description: "List the organization's webhook subscriptions: event name, URL, and active state. Never returns the signing secret; that needs pco_api_get.",
             annotations: READ,
             inputSchema: input({ perPage: perPageProperty(defaultPageSize), offset: OFFSET_PROPERTY }),
-            outputSchema: listOutput("subscriptions", record({ id: STRING, name: STRING, url: STRING, active: BOOLEAN, application_id: NULLABLE_STRING, created_at: STRING })),
+            outputSchema: listOutput("subscriptions", record({
+                id: STRING,
+                name: STRING,
+                url: STRING,
+                active: BOOLEAN,
+                application_id: NULLABLE_STRING,
+                created_at: STRING,
+            })),
             handler: async (args, ctx) => {
-                const document = asRecord(await call({ method: "GET", path: "/webhooks/v2/webhook_subscriptions", query: { per_page: perPage(args), offset: args["offset"] } }, ctx));
+                const document = asRecord(await call({
+                    method: "GET",
+                    path: "/webhooks/v2/webhook_subscriptions",
+                    query: { per_page: perPage(args), offset: args["offset"] },
+                }, ctx));
                 // `authenticity_secret` verifies deliveries. A projection is the
                 // place it never appears, so this read has no `raw` mode.
                 return {
@@ -1929,50 +2110,29 @@ function tools(call, defaultPageSize) {
 // ---------------------------------------------------------------------------
 function usageGuide(purpose, instructions) {
     const organizationInstructions = instructions?.trim();
-    return `# Planning Center usage
-
-Planning Center Online church management — People, Services, Groups, Check-Ins, Calendar, Registrations, Giving, Publishing, Webhooks — for: ${purpose}
-
-## Identity first
-
-- A person id is the join key across every product: the id \`search_people\` returns is the \`personId\` for Services schedules, Groups memberships, Giving donations, and Check-Ins. Resolve ids with list tools; never guess one.
-- A person id that used to resolve and now answers \`not_found\` was most likely merged. Read \`/people/v2/person_mergers\` with \`where[person_to_remove_id]\` and follow \`person_to_keep_id\`.
-- \`get_me\` names the user this token acts as. Every read and write runs with that user's permissions, product by product; a \`connector_call_failed\` naming permission means the user cannot, not that the call was wrong.
-
-## Results and paging
-
-- Records keep Planning Center's own snake_case attribute names; a relationship appears as \`<relationship>_id\`. Pass \`raw: true\` for the untouched JSON:API resources and \`included\`.
-- Lists page by offset: \`perPage\` up to 100, then pass \`page.nextOffset\` back as \`offset\` while \`page.hasMore\` is true. \`page.totalCount\` answers "how many" without paging — request \`perPage: 1\`.
-- A bare date in a date filter is the organization's local day; pass a full timestamp for exact bounds. Name filters are exact; end one with \`%\` for a prefix match.
-- \`get_plan\` fetches the plan, its items, and its team in one call and sets \`itemsTruncated\`/\`teamMembersTruncated\` past 100 rows; page the rest with \`pco_api_get\`.
-
-## What each product lets the API write
-
-- People: full read/write. \`update_person\` with \`status: inactive\` archives reversibly; a DELETE is permanent and only reachable through \`pco_api_mutate\`. \`run_list\` can fire list automations.
-- Services: full read/write. A plan's dates come from its plan times. Scheduling needs a team.
-- Groups: memberships and group settings are writable; groups cannot be created, and events and attendance are read-only.
-- Check-Ins and Registrations: read-only. Nobody can be checked in or registered through the API.
-- Calendar: events, instances, and times are read-only; tags, resources, rooms, and folders are writable through \`pco_api_mutate\`.
-- Giving: the named tools only read, amounts in integer cents. Creating or editing donations, refunds, and committing a batch move money and go through \`pco_api_mutate\`.
-- Publishing and the \`api\` product (organization, OAuth applications, personal access tokens) have no named tools; use the hatches.
-
-## The hatches
-
-- \`pco_api_get\` reaches any GET; \`pco_api_mutate\` any POST, PATCH, or DELETE, always approval-gated. Paths start \`/<app>/v2\`, exactly as Planning Center documents them; the connector owns host, auth, content type, and the \`X-PCO-API-Version\` header.
-- Bodies are JSON:API documents: \`{"data":{"type":"Email","attributes":{...}}}\`. \`null\` clears an attribute; an omitted key is left alone.
-- Each product is pinned to a reviewed API version: ${PLANNING_CENTER_APPS.map((app) => `${app} ${PLANNING_CENTER_API_VERSIONS[app]}`).join(", ")}. Pass \`version\` only for an endpoint those versions lack.
-- Query parameters are name/value pairs with literal brackets: \`where[status]\`, \`include\`, \`order\`, \`filter\`, \`fields[Person]\`. Every list response's \`meta\` names the \`can_query_by\`, \`can_order_by\`, and \`can_include\` values for that endpoint; an unknown \`where\` key is ignored rather than refused.
-- File uploads go to a separate host (upload.planningcenteronline.com), which this connection does not reach.
-
-## Rate limits
-
-Planning Center allows 100 requests per 20 seconds per user, shared by every integration running as that user. This connection admits 100 calls per 20 seconds, five at a time, per runtime — an approximation, not a guarantee. A \`rate_limited\` failure carries Planning Center's wait. Filter server-side and use \`totalCount\` rather than paging to count.
-${organizationInstructions
-        ? `\n## Organization instructions\n\n${organizationInstructions}\n`
-        : ""}`;
+    return `${skill.fragments.guide_0}${purpose}${skill.fragments.guide_1}${PLANNING_CENTER_APPS.map((app) => `${app} ${PLANNING_CENTER_API_VERSIONS[app]}`).join(", ")}${skill.fragments.guide_2}${organizationInstructions ? `\n## ${skill.instructionsHeading}\n\n${organizationInstructions}\n` : ""}`;
 }
+/** The closed options planningCenter() accepts; see `assertKnownOptions`. */
+const PLANNING_CENTER_OPTIONS = optionsOf()({
+    ...PROVIDER_COMMON,
+    ...keys("userAgent", "defaultPageSize", "baseUrl"),
+});
 /** A maintained Planning Center Online connection over the REST API. */
-export function planningCenter(id, options) {
+export const planningCenter = asProviderFactory({
+    name: "planning-center",
+    title: "Planning Center",
+    kind: "api",
+    readme: "Planning Center",
+    bundle: {
+        "baselineGzip": 26970,
+        "maxGzip": 86970,
+        "note": "./providers/planning-center starts at 26,970 B gzip. It is api() over the guarded transport with no hosted-MCP surface, so neither the MCP client nor the Effect core is in its graph; the cap uses the existing baseline + 60,000 B policy.",
+    },
+    skill,
+    options: PLANNING_CENTER_OPTIONS,
+    create: planningCenterConnector,
+});
+function planningCenterConnector(id, options) {
     const purpose = options.purpose.trim();
     if (!purpose) {
         throw new Error("planningCenter() requires a non-empty organization purpose.");
@@ -2004,7 +2164,7 @@ export function planningCenter(id, options) {
                 const document = asRecord(await call({ method: "GET", path: "/people/v2/me", query: { include: "organization" } }, {
                     ...ctx,
                     credential: {
-                        get: async (field) => (field ? values[field] ?? null : null),
+                        get: async (field) => (field ? (values[field] ?? null) : null),
                         getAll: async () => values,
                     },
                 }));