@zackbart/connecta 0.34.0 → 0.35.0

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

@@ -1,8 +1,5 @@
 // Generated by scripts/generate-providers.mjs; do not edit.
 export const skill = {
-    "content": "\n\n## Giving data is sensitive\n\n- Donor names, emails, addresses, and gift amounts are pastoral data. Reduce\n  inside `execute_code`: page, filter, and total there, and return the\n  aggregate (sums by fund, month, or donor count), not donor rows, unless the\n  task needs named people.\n- Organization projections omit the payout bank's last four and the legal\n  contact's date of birth. `raw: true` and `tithely_api_get` return them;\n  do not reach for either to answer a giving question.\n\n## Ids and vocabulary\n\n- Ids carry their kind: `org_` organization, `user_` donor account,\n  `ch_` charge, `rc_` recurring gift, `pm_` payment method. Read them\n  from `list_organizations` and `list_accounts`; never guess one.\n- A fund is a Tithe.ly giving type: `giving_type` becomes `fund`.\n- Projections rename snake_case to camelCase, return amounts as integer\n  `…Cents`, and Unix-second dates as ISO 8601 UTC `…At`.\n  `depositedAt` may be `\"pending\"`. There is no deposits resource: net\n  amount and fees live on each charge.\n\n## Paging\n\nList tools return `page.hasMore` and `page.nextCursor`; pass the cursor\nback unchanged with the same `order`. `list_charges` and\n`list_recurring_charges` need `organizationId` or `accountId`.\n`list_payment_methods` is not paged.\n\n## Failures\n\nTithe.ly answers most refusals with HTTP 200, `status: \"fail\"`, and a\nreason but no code. They arrive as `connector_call_failed`; read the reason\nrather than retrying blind.\n\n## Writes go through the mutate hatch\n\nEvery Tithe.ly write moves money or changes a donor's payment state, so none\nhas a named tool. `tithely_api_mutate` sends form fields as name/value pairs\nand always needs approval. Amounts are integer cents; card and bank tokens\ncome only from Tithely.js in a browser, never from an agent.\n\n- `POST /charges`: account_id, pm_id, organization_id, amount,\n  giving_type, optional memo. `POST /charge-once` charges a Tithely.js token\n  without an account.\n- `POST /refunds/{charge_id}` refunds a charge.\n- `POST /recurring`: account_id, pm_id, organization_id, amount,\n  giving_type, term (weekly, monthly, bimonthly, fortnightly), start_date\n  (Unix seconds). `DELETE /recurring/{recurring_id}` stops future charges and\n  refunds nothing.\n- `POST /payment-methods` (account_id, token), `POST\n  /payment-methods/{pm_id}` (account_id plus fields to change), `DELETE\n  /payment-methods/{pm_id}` with query account_id.\n- `POST /accounts` and `POST /accounts/{account_id}` create and update\n  donor accounts.\n\n## Limits\n\nTithe.ly publishes no rate limit, so this connection declares no call budget.\nAn operator who knows one sets `callAdmission` on the connection. Only v1 is\nreachable; Tithe.ly's undocumented v2 is not.\n",
-    "instructionsHeading": "Account instructions",
-    "fragments": {
-        "guide_0": "\n\n## Giving data is sensitive\n\n- Donor names, emails, addresses, and gift amounts are pastoral data. Reduce\n  inside `execute_code`: page, filter, and total there, and return the\n  aggregate (sums by fund, month, or donor count), not donor rows, unless the\n  task needs named people.\n- Organization projections omit the payout bank's last four and the legal\n  contact's date of birth. `raw: true` and `tithely_api_get` return them;\n  do not reach for either to answer a giving question.\n\n## Ids and vocabulary\n\n- Ids carry their kind: `org_` organization, `user_` donor account,\n  `ch_` charge, `rc_` recurring gift, `pm_` payment method. Read them\n  from `list_organizations` and `list_accounts`; never guess one.\n- A fund is a Tithe.ly giving type: `giving_type` becomes `fund`.\n- Projections rename snake_case to camelCase, return amounts as integer\n  `…Cents`, and Unix-second dates as ISO 8601 UTC `…At`.\n  `depositedAt` may be `\"pending\"`. There is no deposits resource: net\n  amount and fees live on each charge.\n\n## Paging\n\nList tools return `page.hasMore` and `page.nextCursor`; pass the cursor\nback unchanged with the same `order`. `list_charges` and\n`list_recurring_charges` need `organizationId` or `accountId`.\n`list_payment_methods` is not paged.\n\n## Failures\n\nTithe.ly answers most refusals with HTTP 200, `status: \"fail\"`, and a\nreason but no code. They arrive as `connector_call_failed`; read the reason\nrather than retrying blind.\n\n## Writes go through the mutate hatch\n\nEvery Tithe.ly write moves money or changes a donor's payment state, so none\nhas a named tool. `tithely_api_mutate` sends form fields as name/value pairs\nand always needs approval. Amounts are integer cents; card and bank tokens\ncome only from Tithely.js in a browser, never from an agent.\n\n- `POST /charges`: account_id, pm_id, organization_id, amount,\n  giving_type, optional memo. `POST /charge-once` charges a Tithely.js token\n  without an account.\n- `POST /refunds/{charge_id}` refunds a charge.\n- `POST /recurring`: account_id, pm_id, organization_id, amount,\n  giving_type, term (weekly, monthly, bimonthly, fortnightly), start_date\n  (Unix seconds). `DELETE /recurring/{recurring_id}` stops future charges and\n  refunds nothing.\n- `POST /payment-methods` (account_id, token), `POST\n  /payment-methods/{pm_id}` (account_id plus fields to change), `DELETE\n  /payment-methods/{pm_id}` with query account_id.\n- `POST /accounts` and `POST /accounts/{account_id}` create and update\n  donor accounts.\n\n## Limits\n\nTithe.ly publishes no rate limit, so this connection declares no call budget.\nAn operator who knows one sets `callAdmission` on the connection. Only v1 is\nreachable; Tithe.ly's undocumented v2 is not.\n"
-    }
+    "content": "## Giving data is pastoral\n\nDonor names, emails, addresses, and gift amounts are pastoral data. Reduce\ninside `execute_code`: page, filter, and total there, and return the\naggregate (sums by fund, month, or donor count), not donor rows, unless the\ntask needs named people.\n\n## Ids and joins\n\n- Ids carry their kind: `org_` organization, `user_` donor account, `ch_`\n  charge, `rc_` recurring gift, `pm_` payment method. Read them from the list\n  tools; never guess one.\n- Tithe.ly lists charges and recurring gifts only for one organization or one\n  donor, so pass `organizationId` or `accountId`.\n- A charge carries its donor's name and email, its organization's name, and\n  its payment method, so most joins need no second read.\n- `list_accounts` covers every account these keys can see; `scope: \"api\"`\n  narrows it to accounts created through this API.\n- The named reads project Tithe.ly's records. A field a projection omits, such\n  as an account's phone and postal address, comes back from `tithely_api_read`\n  on that record's path.\n\n## Money, dates and funds\n\n- A fund is a Tithe.ly giving type: `giving_type` in Tithe.ly's records,\n  `fund` in projections.\n- Projections give amounts as integer `…Cents` and dates as ISO 8601 UTC\n  `…At`. Tithe.ly's own records, from `tithely_api_read`, keep string cents\n  and Unix seconds.\n- `depositedAt` may be `\"pending\"`. There is no deposits resource: net amount\n  and fees live on each charge.\n- A charge a recurring gift produced has `recurring: true`; a one-time gift\n  has `recurring: false`.\n\n## Writes\n\n- Every write moves money or changes a donor's records. Bodies are form\n  fields in integer cents and Unix seconds.\n- `POST /refunds/{charge_id}` refunds a whole charge.\n  `DELETE /recurring/{recurring_id}` stops future charges and refunds nothing.\n- Card and bank tokens, which `POST /charge-once` and `POST /payment-methods`\n  need, come only from Tithely.js in a donor's browser. An agent cannot\n  create one.\n- Tithe.ly reports most refusals as HTTP 200 with `status: \"fail\"` and a\n  reason but no code. They arrive as `connector_call_failed`; read the reason\n  before deciding what to do next.\n\n## Not available\n\nOnly Tithe.ly's API v1 is reachable; its undocumented v2 is not.\n\n## Conventions\n\n- **Paging:** while `page.hasMore` is true, continue with `page.nextCursor` unchanged. For `list_accounts`, `list_charges`, `list_organizations`, `list_payment_methods`, `list_recurring_charges`, `tithely_api_details`, `tithely_api_search`, pass it as the top-level `cursor`; omit raw paging anchors on continuations. Keep the original method, path, filters, page size, fields and headers. Paged `list_*` and `search_*` reads take `limit` (default 25, at most 99). The last page has no `nextCursor`. If `page.hasMore` is true without a cursor, the data is incomplete and continuation was withheld. When approaching execute_code's per-program call limit, return page.nextCursor before the call that would exceed it and continue in the next program; don't restart.\n- **Results:** `fields` narrows a read's result to the dot paths you name. `truncated` lists the dot paths a result cut for size; the ids that fetch what was cut stay in the result.\n- **Hatch:** `tithely_api_search` finds this API's operations and reads no account data, `tithely_api_details` shows one operation's contract, and `tithely_api_read` calls a reviewed read. `tithely_api_write` calls a reviewed write; the host may ask the user to confirm it. An operation without a reviewed verdict is refused.\n- **Writes:** a write is sent once and never retried. When its outcome is unknown, read the target before repeating it. Writes take no idempotency key.\n- **Errors:** codes come from the vendor's statuses and error facts, never its prose. An unknown id, or one these credentials cannot reach, fails as `connector_call_failed`; this API does not tell the two apart. It documents no conflict.\n- **Withheld values:** a value withheld for safety reads `\"[redacted]\"`. Writes refuse whole marker values and withheld links; longer prose may mention the marker. Paths and queries refuse any containment.",
+    "instructionsHeading": "Account instructions"
 };

package/dist/providers/tithely/tools.js

@@ -0,0 +1,426 @@
+// Tithe.ly's curated tools on the provider kit (decision 0010) and their
+// projections. Decision 0011's step 2: standard lists ({ items, page } with
+// limit, cursor and fields), fields on every named read, and no `raw`: what a
+// projection drops stays reachable through the standard hatch, which the kit
+// builds from `api.ts`'s index and verdicts (decision 0014). Each named read
+// earns its place against the hatch with paging Tithe.ly cannot report
+// (lookahead), units (cents, ISO dates), joins (donor, organization and
+// payment method inline) or reconciliation of a known id after a write.
+import { Effect, Schema } from "effect";
+import { defined } from "../../connectors/api-connector.js";
+import { ConnectorCallError } from "../../errors.js";
+import { Refusal } from "../../http/errors.js";
+import { Integer } from "../../http/json-schema.js";
+import { lookahead } from "../../http/paging.js";
+import { get as getTool, list } from "../../http/tools.js";
+import { asArray, asRecord, entity, getCharge, getRecurring, listAccounts, listAllAccounts, listCharges, listOrganizations, listPaymentMethods, listRecurring, MAX_PAGE_SIZE, PAYOUT_CURRENCY, text, } from "./api.js";
+// --- Schemas ---------------------------------------------------------------------
+const Id = Schema.String.check(Schema.isMinLength(1));
+const Text = Schema.optionalKey(Schema.String);
+const Cents = Schema.optionalKey(Integer);
+const Flag = Schema.optionalKey(Schema.Boolean);
+const When = Schema.Union([
+    Integer.check(Schema.isGreaterThanOrEqualTo(0)),
+    Schema.String.check(Schema.isMinLength(1)),
+]);
+const Address = Schema.Struct({ streetAddress: Text, city: Text, state: Text, postal: Text, country: Text });
+const Organization = Schema.Struct({
+    organizationId: Text,
+    name: Text,
+    widgetId: Text,
+    ownerAccountId: Text,
+    website: Text,
+    phoneNumber: Text,
+    address: Schema.optionalKey(Address),
+    payoutCurrency: Text,
+    createdAt: Text,
+    funds: Schema.optionalKey(Schema.Array(Schema.Struct({ id: Text, name: Schema.String, status: Text }))),
+});
+const AccountSummary = Schema.Struct({
+    accountId: Text,
+    firstName: Text,
+    lastName: Text,
+    email: Text,
+    createdAt: Text,
+});
+const Donor = Schema.Struct({ firstName: Text, lastName: Text, email: Text });
+const Charge = Schema.Struct({
+    chargeId: Text,
+    status: Text,
+    amountCents: Cents,
+    netAmountCents: Cents,
+    feesCents: Cents,
+    currency: Text,
+    fund: Text,
+    chargedAt: Text,
+    depositedAt: Text,
+    recurring: Flag,
+    feesCovered: Flag,
+    memo: Text,
+    organizationId: Text,
+    organizationName: Text,
+    accountId: Text,
+    donor: Schema.optionalKey(Donor),
+    paymentMethodId: Text,
+    paymentMethod: Schema.optionalKey(Schema.Struct({ type: Text, brand: Text, last4: Text })),
+});
+const Recurring = Schema.Struct({
+    recurringId: Text,
+    amountCents: Cents,
+    currency: Text,
+    fund: Text,
+    term: Text,
+    startAt: Text,
+    organizationId: Text,
+    organizationName: Text,
+    accountId: Text,
+    donor: Schema.optionalKey(Donor),
+    paymentMethodId: Text,
+});
+const PaymentMethod = Schema.Struct({ paymentMethodId: Text, accountId: Text, type: Text, brand: Text, last4: Text });
+const AccountId = Id.annotate({ description: "Donor account id (user_…) from list_accounts." });
+const Order = Schema.optionalKey(Schema.Literals(["desc", "asc"]).annotate({
+    description: "Newest first (desc, Tithe.ly's default) or oldest first. Keep it constant while paging.",
+}));
+const Scope = (noun) => ({
+    organizationId: Schema.optionalKey(Id.annotate({ description: `Organization (org_…) ${noun}. This or accountId is required.` })),
+    accountId: Schema.optionalKey(Id.annotate({ description: `Donor account (user_…) that gave. This or organizationId is required.` })),
+});
+// --- Tools -----------------------------------------------------------------------
+/**
+ * Tithe.ly's seven curated reads, in catalog order. Every answer has already
+ * passed the connection's value safety and sensitive-field choice.
+ */
+export function tithelyTools({ connection, pageSize, options, }) {
+    const { send } = connection;
+    const limit = {
+        default: pageSize,
+        max: MAX_PAGE_SIZE,
+        description: `Rows per page. Tithe.ly allows 100; connecta asks for one extra to learn whether another page exists.`,
+    };
+    const pageQuery = (args, cursor, ask) => ({
+        limit: ask,
+        order_by: args.order === "asc" ? "ASC" : "DESC",
+        ...defined({ starting_after: cursor }),
+    });
+    // Ask for one row more than the page and address the next page by the last kept id.
+    const page = (idKey, size, fetch) => lookahead({
+        provider: "Tithe.ly",
+        idKey,
+        limit: size,
+        fetch: (ask) => fetch(ask).pipe(Effect.flatMap(({ data }) => listRows(data))),
+    });
+    // S6: a projection that drops fields points to the hatch, which passes the same privacy boundary.
+    const sensitive = options.sensitiveFields === "return"
+        ? "Fields this omits, payout bank and legal-contact details included, come from tithely_api_read."
+        : "Fields this omits come from tithely_api_read; payout bank and legal-contact details stay withheld.";
+    return [
+        list(connection, {
+            name: "list_organizations",
+            description: `List the organizations these keys manage, with their funds (giving types) and status. ${sensitive}`,
+            filters: { order: Order },
+            row: Organization,
+            limit,
+            cursor: "plain",
+            page: (args, cursor) => page("organization_id", args.limit, (ask) => send(listOrganizations, { query: pageQuery(args, cursor, ask) }, { flags: PAYOUT_CURRENCY })).pipe(Effect.map(({ rows, page }) => ({ rows: rows.map(projectOrganization), page }))),
+        }),
+        list(connection, {
+            name: "list_accounts",
+            description: "List donor accounts by name, email, and id. Giving history is list_charges by accountId; phone, address, and other fields come from tithely_api_read.",
+            filters: {
+                scope: Schema.optionalKey(Schema.Literals(["all", "api"]).annotate({
+                    description: "all (default) lists every account Tithe.ly lets these keys see; api lists only accounts created through this API.",
+                })),
+                order: Order,
+            },
+            row: AccountSummary,
+            limit,
+            cursor: "plain",
+            page: (args, cursor) => page("account_id", args.limit, (ask) => send(args.scope === "api" ? listAccounts : listAllAccounts, { query: pageQuery(args, cursor, ask) })).pipe(Effect.map(({ rows, page }) => ({ rows: rows.map(projectAccountSummary), page }))),
+        }),
+        list(connection, {
+            name: "list_charges",
+            description: "List gifts (charges) to one organization or from one donor, optionally within a created-date range, with gross, net, and fees in cents.",
+            filters: {
+                ...Scope("the gifts went to"),
+                createdAfter: Schema.optionalKey(When.annotate({
+                    description: "Only charges created after this time: Unix seconds or an ISO 8601 date/date-time (UTC when no offset).",
+                })),
+                createdBefore: Schema.optionalKey(When.annotate({ description: "Only charges created before this time, in the same forms as createdAfter." })),
+                order: Order,
+            },
+            row: Charge,
+            limit,
+            cursor: "plain",
+            page: (args, cursor) => Effect.gen(function* () {
+                const after = yield* seconds(args.createdAfter, "createdAfter");
+                const before = yield* seconds(args.createdBefore, "createdBefore");
+                if (after !== undefined && before !== undefined && after > before) {
+                    return yield* failed(new ConnectorCallError("invalid_args", "createdAfter is later than createdBefore, so no charge can match."));
+                }
+                const scope = yield* scopeFilters(args, "charges");
+                const { rows, page: next } = yield* page("charge_id", args.limit, (ask) => send(listCharges, {
+                    query: {
+                        ...scope,
+                        ...defined({ created_after: after, created_before: before }),
+                        ...pageQuery(args, cursor, ask),
+                    },
+                }));
+                return { rows: rows.map(projectCharge), page: next };
+            }),
+        }),
+        getTool(connection, {
+            name: "get_charge",
+            description: "Get one charge by id: amounts in cents, status, fund, deposit date, donor, and payment method. Use it to check a charge after a write; tithely_api_read returns the full record.",
+            input: Schema.Struct({ chargeId: Id.annotate({ description: "Charge id (ch_…) from list_charges." }) }),
+            output: Charge,
+            fields: true,
+            run: (args) => send(getCharge, { params: { charge_id: args.chargeId } }).pipe(Effect.map(({ data }) => projectCharge(entity(data, "charge_id")))),
+        }),
+        list(connection, {
+            name: "list_recurring_charges",
+            description: "List recurring gifts for one organization or one donor: amount, fund, term, and start date. Does not list the charges they produced.",
+            filters: { ...Scope("receiving the gifts"), order: Order },
+            row: Recurring,
+            limit,
+            cursor: "plain",
+            page: (args, cursor) => Effect.gen(function* () {
+                const scope = yield* scopeFilters(args, "recurring gifts");
+                const { rows, page: next } = yield* page("recurring_id", args.limit, (ask) => send(listRecurring, { query: { ...scope, ...pageQuery(args, cursor, ask) } }));
+                return { rows: rows.map(projectRecurring), page: next };
+            }),
+        }),
+        getTool(connection, {
+            name: "get_recurring_charge",
+            description: "Get one recurring gift by id: amount in cents, fund, term, start date, organization, and donor. Use it to check a gift after changing it.",
+            input: Schema.Struct({
+                recurringId: Id.annotate({ description: "Recurring gift id (rc_…) from list_recurring_charges." }),
+            }),
+            output: Recurring,
+            fields: true,
+            run: (args) => send(getRecurring, { params: { recurring_id: args.recurringId } }).pipe(Effect.map(({ data }) => projectRecurring(entity(data, "recurring_id")))),
+        }),
+        // Tithe.ly answers every method in one unpaged response; the kit windows it
+        // with a bound cursor so the list keeps the standard envelope.
+        list(connection, {
+            name: "list_payment_methods",
+            description: "List one donor's stored payment methods as type, brand, and last four, for the pm_ id a charge needs. Never card numbers or tokens.",
+            filters: { accountId: AccountId },
+            row: PaymentMethod,
+            limit,
+            cursor: "bound",
+            page: (args, cursor) => Effect.gen(function* () {
+                const { data } = yield* send(listPaymentMethods, { query: { account_id: args.accountId } });
+                const rows = asArray(asRecord(data)["data"]);
+                const start = cursor === undefined ? 0 : Number(cursor);
+                if (!Number.isSafeInteger(start) || start < 0 || start > rows.length) {
+                    return yield* failed(new ConnectorCallError("invalid_args", "This cursor no longer matches the donor's payment methods."));
+                }
+                const end = start + args.limit;
+                return {
+                    rows: rows.slice(start, end).map(projectPaymentMethod),
+                    page: end < rows.length ? { hasMore: true, nextCursor: String(end) } : { hasMore: false, nextCursor: null },
+                };
+            }),
+        }),
+    ];
+}
+// --- Arguments -----------------------------------------------------------------------
+const failed = (error) => Effect.fail(new Refusal({ error }));
+/**
+ * Tithe.ly lists charges and recurring gifts only for a donor or an
+ * organization, so a call naming neither can only fail: refuse it locally.
+ */
+function scopeFilters(args, noun) {
+    if (args.organizationId === undefined && args.accountId === undefined) {
+        return failed(new ConnectorCallError("invalid_args", `Tithe.ly lists ${noun} only for an organization or a donor: pass organizationId (from list_organizations) or accountId (from list_accounts).`));
+    }
+    return Effect.succeed(defined({ organization_id: args.organizationId, account_id: args.accountId }));
+}
+function listRows(payload) {
+    const data = asRecord(payload)["data"];
+    if (data !== undefined && !Array.isArray(data)) {
+        return failed(new ConnectorCallError("connector_call_failed", "Tithe.ly returned a list response whose data is not an array.", {
+            retryable: false,
+        }));
+    }
+    return Effect.succeed(data ?? []);
+}
+/** An ISO 8601 date-time with no `Z` or offset, which `Date.parse` reads as local time. */
+const OFFSETLESS_DATE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?$/;
+/**
+ * Unix seconds from an integer or an ISO 8601 date/date-time. A date-time
+ * without an offset is UTC, as the schema promises, not the runtime's zone.
+ */
+function seconds(value, name) {
+    if (value === undefined)
+        return Effect.succeed(undefined);
+    if (typeof value === "number")
+        return Effect.succeed(value);
+    const raw = String(value).trim();
+    if (/^\d+$/.test(raw))
+        return Effect.succeed(Number(raw));
+    const parsed = Date.parse(OFFSETLESS_DATE_TIME.test(raw) ? `${raw}Z` : raw);
+    if (!Number.isFinite(parsed)) {
+        return failed(new ConnectorCallError("invalid_args", `${name} must be Unix seconds or an ISO 8601 date or date-time; received "${raw}".`));
+    }
+    return Effect.succeed(Math.floor(parsed / 1000));
+}
+function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+/** Integer cents from Tithe.ly's string-or-number amounts. */
+function cents(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === "string" && /^-?\d+$/.test(value.trim()))
+        return Number(value.trim());
+    return undefined;
+}
+/** ISO 8601 UTC from a Unix-seconds string or number. */
+function isoTime(value) {
+    const seconds = typeof value === "number"
+        ? value
+        : typeof value === "string" && /^\d+$/.test(value.trim())
+            ? Number(value.trim())
+            : undefined;
+    if (seconds === undefined || !Number.isFinite(seconds))
+        return undefined;
+    const date = new Date(seconds * 1000);
+    return Number.isNaN(date.getTime()) ? undefined : date.toISOString();
+}
+function projectAddress(value) {
+    const address = asRecord(value);
+    if (Object.keys(address).length === 0)
+        return undefined;
+    return compact({
+        streetAddress: text(address["street_address"]),
+        city: text(address["city"]),
+        state: text(address["state"]),
+        postal: text(address["postal"]),
+        country: text(address["country"]),
+    });
+}
+const FUND_STATUS = { "0": "archived", "1": "active", "2": "hidden" };
+function projectFunds(organization) {
+    const full = asArray(organization["giving_types_full"]);
+    if (full.length > 0) {
+        return full.map((value) => {
+            const fund = asRecord(value);
+            const status = fund["status"] === undefined ? undefined : String(fund["status"]);
+            return compact({
+                id: fund["id"] === undefined ? undefined : String(fund["id"]),
+                name: String(fund["name"] ?? ""),
+                status: status === undefined ? undefined : (FUND_STATUS[status] ?? status),
+            });
+        });
+    }
+    return asArray(organization["giving_types"])
+        .filter((name) => typeof name === "string")
+        .map((name) => ({ name }));
+}
+/** Omits the payout bank and legal contact; `payoutCurrency` is the reviewed copy the connection's safety made. */
+function projectOrganization(value) {
+    const organization = asRecord(value);
+    return compact({
+        organizationId: text(organization["organization_id"]),
+        name: text(organization["name"]),
+        // The giving widget id embeds Tithe.ly's giving form; the step-2 eval showed agents need it (decision 0014).
+        widgetId: text(organization["widget_id"]),
+        ownerAccountId: text(organization["account_id"]),
+        website: text(organization["website"]),
+        phoneNumber: text(organization["phone_number"]),
+        address: projectAddress(organization["address"]),
+        payoutCurrency: text(organization["payoutCurrency"]),
+        createdAt: isoTime(organization["created_date"]),
+        funds: projectFunds(organization),
+    });
+}
+function projectAccountSummary(value) {
+    const account = asRecord(value);
+    return compact({
+        accountId: text(account["account_id"]),
+        firstName: text(account["first_name"]),
+        lastName: text(account["last_name"]),
+        email: text(account["email"]),
+        createdAt: isoTime(account["created_date"]),
+    });
+}
+/** A nested reference that is sometimes an id string and sometimes an object. */
+function reference(value, idKey) {
+    if (typeof value === "string")
+        return { id: value, record: {} };
+    const record = asRecord(value);
+    return { ...defined({ id: text(record[idKey]) }), record };
+}
+/** The donor as a giving record names them; address and phone stay on get_account. */
+function projectDonor(record) {
+    const donor = compact({
+        firstName: text(record["first_name"]),
+        lastName: text(record["last_name"]),
+        email: text(record["email"]),
+    });
+    return Object.keys(donor).length === 0 ? undefined : donor;
+}
+function projectCharge(value) {
+    const charge = asRecord(value);
+    const organization = reference(charge["organization"], "organization_id");
+    const donor = reference(charge["donor_account"], "account_id");
+    const method = reference(charge["payment_method"], "pm_id");
+    const deposit = charge["deposit_date"];
+    return compact({
+        chargeId: text(charge["charge_id"]),
+        status: text(charge["charge_status"]),
+        amountCents: cents(charge["amount"]),
+        netAmountCents: cents(charge["net_amount"]),
+        feesCents: cents(charge["fees"]),
+        currency: text(charge["currency"]),
+        fund: text(charge["giving_type"]),
+        chargedAt: isoTime(charge["charge_date"]),
+        depositedAt: deposit === "pending" ? "pending" : isoTime(deposit),
+        recurring: typeof charge["recurring_transaction"] === "boolean" ? charge["recurring_transaction"] : undefined,
+        feesCovered: typeof charge["fees_covered"] === "boolean" ? charge["fees_covered"] : undefined,
+        memo: text(charge["memo"]),
+        organizationId: organization.id,
+        organizationName: text(organization.record["name"]),
+        accountId: donor.id ?? text(method.record["account_id"]),
+        donor: projectDonor(donor.record),
+        paymentMethodId: method.id,
+        paymentMethod: Object.keys(method.record).length === 0
+            ? undefined
+            : compact({
+                type: text(method.record["pm_type"]),
+                brand: text(method.record["brand"]),
+                last4: text(method.record["last_4_digits"]),
+            }),
+    });
+}
+function projectRecurring(value) {
+    const recurring = asRecord(value);
+    const organization = reference(recurring["organization"], "organization_id");
+    const donor = reference(recurring["donor_account"], "account_id");
+    const method = reference(recurring["payment_method"], "pm_id");
+    return compact({
+        recurringId: text(recurring["recurring_id"]),
+        amountCents: cents(recurring["amount"]),
+        currency: text(recurring["currency"]),
+        fund: text(recurring["giving_type"]),
+        term: text(recurring["term"]),
+        startAt: isoTime(recurring["start_date"]),
+        organizationId: organization.id,
+        organizationName: text(organization.record["name"]),
+        accountId: donor.id,
+        donor: projectDonor(donor.record),
+        paymentMethodId: method.id,
+    });
+}
+function projectPaymentMethod(value) {
+    const method = asRecord(value);
+    return compact({
+        paymentMethodId: text(method["pm_id"]),
+        accountId: text(method["account_id"]),
+        type: text(method["pm_type"]),
+        brand: text(method["brand"]),
+        last4: text(method["last_4_digits"]),
+    });
+}