cata-centavo 0.1.0

package/dist/mcp/tools/list-transactions.js.map

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

package/dist/mcp/tools/result.js

@@ -0,0 +1,12 @@
+import { prune } from "../format.js";
+export function finishToolError(log, startedAt, message, fields) {
+    log.info({ durationMs: Date.now() - startedAt, outcome: "tool-error", ...fields }, "Tool finished with an error");
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+export function configurationProblems(problems) {
+    return `Configuration problems:\n${problems.join("\n")}`;
+}
+export function textResult(payload) {
+    return { content: [{ type: "text", text: JSON.stringify(prune(payload)) }] };
+}
+//# sourceMappingURL=result.js.map

package/dist/mcp/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/mcp/tools/result.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAarC,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,SAAiB,EACjB,OAAe,EACf,MAAyC;IAEzC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC;IAElH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA2B;IAC/D,OAAO,4BAA4B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/mcp/tools/set-category.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { isCategoryId } from "../../core/category.js";
+import { isDocument } from "../../core/counterparty.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+export const SET_CATEGORY_DESCRIPTION = `Corrects the category of specific transactions.
+
+Use this tool when:
+- The user tells you a transaction is in the wrong category.
+- You listed uncategorized transactions with categories: ["none"] and the user said what they are.
+
+Returns: How many transactions were corrected, and any ids that are not in the local cache.`;
+export const SET_COUNTERPARTY_CATEGORY_DESCRIPTION = `Assigns a category to everyone a CPF or CNPJ identifies, backwards and forwards.
+
+Use this tool when:
+- The user tells you what a merchant is, rather than what one transaction is.
+- The same counterparty keeps landing in the wrong category.
+
+Returns: The document, the category, and how many cached transactions now resolve through it. That count is the blast radius — read it back to the user when it is larger than they expected.`;
+const categoryInput = z.string().refine(isCategoryId, "must be a known category id");
+export const setCategorySchema = z.object({
+    transactionIds: z.array(z.string().min(1)).min(1).max(100),
+    category: categoryInput,
+});
+export const setCounterpartyCategorySchema = z.object({
+    document: z.string().min(1),
+    category: categoryInput,
+});
+export function registerSetCategory(server, deps) {
+    server.registerTool("setCategory", { description: SET_CATEGORY_DESCRIPTION, inputSchema: setCategorySchema }, async (input) => handleSetCategory(deps, input));
+}
+export function registerSetCounterpartyCategory(server, deps) {
+    server.registerTool("setCounterpartyCategory", { description: SET_COUNTERPARTY_CATEGORY_DESCRIPTION, inputSchema: setCounterpartyCategorySchema }, async (input) => handleSetCounterpartyCategory(deps, input));
+}
+export async function handleSetCategory(deps, rawInput) {
+    const startedAt = Date.now();
+    if (!deps.source.ok) {
+        return finishToolError(deps.log, startedAt, configurationProblems(deps.source.problems), { tool: "setCategory" });
+    }
+    const parsed = setCategorySchema.safeParse(rawInput);
+    if (!parsed.success) {
+        return finishToolError(deps.log, startedAt, parsed.error.message, { tool: "setCategory" });
+    }
+    const writer = deps.writer ?? deps.source.writer;
+    if (!writer) {
+        return finishToolError(deps.log, startedAt, "Storage is read-only", { tool: "setCategory" });
+    }
+    const result = writer.setCategory(parsed.data.transactionIds, parsed.data.category);
+    return textResult(result);
+}
+export async function handleSetCounterpartyCategory(deps, rawInput) {
+    const startedAt = Date.now();
+    if (!deps.source.ok) {
+        return finishToolError(deps.log, startedAt, configurationProblems(deps.source.problems), { tool: "setCounterpartyCategory" });
+    }
+    const parsed = setCounterpartyCategorySchema.safeParse(rawInput);
+    if (!parsed.success) {
+        return finishToolError(deps.log, startedAt, parsed.error.message, { tool: "setCounterpartyCategory" });
+    }
+    const cleanDoc = parsed.data.document.replace(/\D/g, "");
+    if (!isDocument(cleanDoc)) {
+        return finishToolError(deps.log, startedAt, "document must be an 11-digit CPF or 14-digit CNPJ", { tool: "setCounterpartyCategory" });
+    }
+    const writer = deps.writer ?? deps.source.writer;
+    if (!writer) {
+        return finishToolError(deps.log, startedAt, "Storage is read-only", { tool: "setCounterpartyCategory" });
+    }
+    const result = writer.setCounterpartyCategory(cleanDoc, parsed.data.category);
+    return textResult({
+        document: cleanDoc,
+        category: parsed.data.category,
+        affected: result.affected,
+    });
+}
+//# sourceMappingURL=set-category.js.map

package/dist/mcp/tools/set-category.js.map

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

package/dist/mcp/tools/sources.js

@@ -0,0 +1,73 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { diagnose } from "../../core/diagnose.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+export const LIST_SOURCES_DESCRIPTION = `Lists every configured bank connection with its sync status and consent state.
+
+Use this tool when:
+- You want to diagnose why an account or transaction tool came back empty or unavailable.
+- The user asks which banks are connected, or whether a connection needs attention.
+
+Returns: Per connection, its institution, sync status, warnings, what the bank is waiting on, and consent state (active, revoked, expired or unknown). This lists what is configured, not what exists in your Pluggy account — a bank linked outside this configuration is invisible to it.`;
+/** Registers the diagnostic tool over every configured connection. */
+export function registerListSources(server, deps) {
+    server.registerTool("listSources", { description: LIST_SOURCES_DESCRIPTION }, async () => handleListSources(deps));
+}
+/**
+ * Reports every configured connection's status and consent.
+ *
+ * Never returns `isError` because of connection state: a broken connection
+ * *is* the diagnosis this tool exists to give, and erroring at the moment
+ * everything is rotten would hide it. Only missing configuration errors.
+ */
+export async function handleListSources(deps) {
+    const startedAt = Date.now();
+    const log = deps.log.child({ tool: "listSources", callId: randomUUID() });
+    log.info({}, "listSources started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    const diagnoses = await diagnose(deps.source.bank, deps.source.connections, deps.source.toFailure, deps.clock);
+    const response = { sources: diagnoses.map(formatDiagnosis) };
+    log.info({ durationMs: Date.now() - startedAt, outcome: "ok", sources: diagnoses.length }, "listSources finished");
+    return textResult(response);
+}
+function formatDiagnosis(diagnosis) {
+    return {
+        id: diagnosis.id,
+        ...formatConnectionFields(diagnosis),
+        failure: diagnosis.failure,
+        consent: formatConsent(diagnosis),
+    };
+}
+function formatConnectionFields(diagnosis) {
+    const { connection } = diagnosis;
+    if (connection === null) {
+        return {};
+    }
+    return {
+        institution: connection.institution,
+        status: connection.status,
+        executionStatus: connection.executionStatus,
+        lastUpdatedAt: connection.lastUpdatedAt?.toISOString() ?? null,
+        warnings: connection.warnings,
+        parameter: connection.parameter,
+        failedLogins: connection.failedLogins,
+    };
+}
+function formatConsent(diagnosis) {
+    const { consent } = diagnosis;
+    return {
+        state: diagnosis.state,
+        expiresAt: isoOrNull(consent?.expiresAt),
+        revokedAt: isoOrNull(consent?.revokedAt),
+        products: consent?.products ?? null,
+    };
+}
+function isoOrNull(date) {
+    if (date === null || date === undefined) {
+        return null;
+    }
+    return date.toISOString();
+}
+//# sourceMappingURL=sources.js.map

package/dist/mcp/tools/sources.js.map

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

package/dist/mcp/tools/transaction-details.js

@@ -0,0 +1,146 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { toDecimal } from "../format.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+const getTransactionDetailsInput = z.object({
+    ids: z.array(z.string().min(1)).min(1).max(20),
+}).superRefine((input, context) => {
+    if (new Set(input.ids).size !== input.ids.length) {
+        context.addIssue({ code: "custom", path: ["ids"], message: "must not contain duplicates" });
+    }
+});
+export const GET_TRANSACTION_DETAILS_DESCRIPTION = `Returns full details for a bounded set of transaction ids.
+
+Use this tool when:
+- You need the counterparty, payment, instalment or card metadata behind a transaction.
+- An aggregate sample id or a listed row identifies the transaction to inspect.
+
+Returns: Our transaction fields with money as decimal strings. The request is capped at 20 ids, and unknown ids are reported as an error.`;
+export function registerGetTransactionDetails(server, deps) {
+    server.registerTool("getTransactionDetails", { description: GET_TRANSACTION_DETAILS_DESCRIPTION, inputSchema: getTransactionDetailsInput }, async (input) => handleGetTransactionDetails(deps, input));
+}
+export async function handleGetTransactionDetails(deps, input) {
+    const startedAt = Date.now();
+    const parsed = getTransactionDetailsInput.safeParse(input);
+    if (!parsed.success) {
+        return finishToolError(deps.log, startedAt, validationMessage(parsed.error), { outcome: "invalid-input" });
+    }
+    const log = deps.log.child({ tool: "getTransactionDetails" });
+    log.info({}, "getTransactionDetails started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    if (deps.reader === null) {
+        return finishToolError(log, startedAt, "Transaction reader is unavailable.", { outcome: "reader-unavailable" });
+    }
+    return executeDetails({ source: deps.source, input: parsed.data, startedAt, log, reader: deps.reader });
+}
+async function executeDetails(options) {
+    const { source, input, startedAt, log, reader } = options;
+    try {
+        const loaded = await reader.load(source.connections);
+        const unavailable = unavailableConnections(loaded.unavailable);
+        if (unavailable !== null) {
+            return finishToolError(log, startedAt, unavailable.message, unavailable.fields);
+        }
+        const rows = reader.byIds(input.ids);
+        const missing = input.ids.filter((id) => !rows.some((row) => row.id === id));
+        if (missing.length > 0) {
+            return finishToolError(log, startedAt, `Unknown transaction id(s): ${missing.join(", ")}.`, { missing });
+        }
+        const byId = new Map(rows.map((row) => [row.id, row]));
+        const transactions = input.ids.map((id) => formatDetail(rowForId(byId, id)));
+        log.info({ durationMs: Date.now() - startedAt, outcome: "ok", rows: transactions.length }, "getTransactionDetails finished");
+        return textResult({ transactions });
+    }
+    catch (error) {
+        return finishToolError(log, startedAt, `Cannot read transaction details: ${messageOf(error)}`, { outcome: "failure" });
+    }
+}
+function unavailableConnections(unavailable) {
+    if (unavailable.length === 0) {
+        return null;
+    }
+    const connections = unavailable.map(({ connectionId }) => connectionId).join(", ");
+    return {
+        message: `Cannot read transaction details because these connections are unavailable: ${connections}.`,
+        fields: { unavailable: unavailable.length },
+    };
+}
+function rowForId(rows, id) {
+    const row = rows.get(id);
+    if (row === undefined) {
+        throw new Error(`transaction ${id} disappeared during detail lookup`);
+    }
+    return row;
+}
+function formatDetail(row) {
+    return {
+        id: row.id,
+        accountId: row.accountId,
+        accountType: row.accountType,
+        accountSubtype: row.accountSubtype,
+        date: row.localDate,
+        occurredAt: row.occurredAt,
+        description: row.description,
+        descriptionNorm: row.descriptionNorm,
+        amount: toDecimal(row.amountCents),
+        currency: row.currency,
+        original: formatOriginal(row),
+        category: row.category,
+        categorySrc: row.categorySrc,
+        categoryId: row.categoryId,
+        counterparty: formatCounterparty(row),
+        paymentMethod: row.paymentMethod,
+        instalment: formatInstalment(row),
+        purchaseDate: row.purchaseDate,
+        mcc: row.mcc,
+        billId: row.billId,
+    };
+}
+function formatOriginal(row) {
+    if (row.originalAmountCents === null || row.originalCurrency === null) {
+        return undefined;
+    }
+    return { amount: toDecimal(row.originalAmountCents), currency: row.originalCurrency };
+}
+function formatCounterparty(row) {
+    if (row.document === null && row.counterpartyName === null) {
+        return undefined;
+    }
+    const details = {};
+    if (row.document !== null) {
+        details.document = row.document;
+    }
+    if (row.counterpartyName !== null) {
+        details.name = row.counterpartyName;
+    }
+    return details;
+}
+function formatInstalment(row) {
+    if (row.instalmentNumber === null && row.instalmentTotal === null) {
+        return undefined;
+    }
+    const details = {};
+    if (row.instalmentNumber !== null) {
+        details.number = row.instalmentNumber;
+    }
+    if (row.instalmentTotal !== null) {
+        details.total = row.instalmentTotal;
+    }
+    return details;
+}
+function validationMessage(error) {
+    const issue = error.issues[0];
+    if (issue === undefined) {
+        return "Invalid transaction ids.";
+    }
+    return `Invalid transaction ids: ${issue.path.join(".") || "input"} ${issue.message}.`;
+}
+function messageOf(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=transaction-details.js.map

package/dist/mcp/tools/transaction-details.js.map

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

package/dist/mcp/tools/transaction-input.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { isCategoryFilterValue } from "../../core/category.js";
+const dateInput = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "must be YYYY-MM-DD");
+const categoryInput = z.string().refine(isCategoryFilterValue, 'must be a known category id, or "none" for uncategorized');
+export const listTransactionsInput = z.object({
+    startDate: dateInput,
+    endDate: dateInput,
+    categories: z.array(categoryInput).optional(),
+    minAmountCents: z.number().int().optional(),
+    maxAmountCents: z.number().int().optional(),
+    accountType: z.enum(["BANK", "CREDIT", "INVESTMENT", "LOAN"]).optional(),
+    accountSubtype: z.string().min(1).optional(),
+    limit: z.number().int().min(1).max(100),
+    cursor: z.string().optional(),
+}).superRefine(validateRange);
+export function validateRange(input, context) {
+    if (input.endDate < input.startDate) {
+        context.addIssue({ code: "custom", path: ["endDate"], message: "must not be before startDate" });
+    }
+}
+export function validationMessage(error) {
+    const issue = error.issues[0];
+    if (issue === undefined) {
+        return "Invalid transaction filters.";
+    }
+    return `Invalid transaction filters: ${issue.path.join(".") || "input"} ${issue.message}.`;
+}
+export function toTransactionFilter(input, accounts) {
+    let filter = {
+        accountIds: accounts.map((account) => account.id),
+        from: input.startDate,
+        to: input.endDate,
+    };
+    if (input.categories !== undefined) {
+        filter = { ...filter, categories: input.categories };
+    }
+    if (input.minAmountCents !== undefined) {
+        filter = { ...filter, minAmountCents: input.minAmountCents };
+    }
+    if (input.maxAmountCents !== undefined) {
+        filter = { ...filter, maxAmountCents: input.maxAmountCents };
+    }
+    if (input.accountType !== undefined) {
+        filter = { ...filter, accountType: input.accountType };
+    }
+    if (input.accountSubtype !== undefined) {
+        filter = { ...filter, accountSubtype: input.accountSubtype };
+    }
+    return filter;
+}
+//# sourceMappingURL=transaction-input.js.map

package/dist/mcp/tools/transaction-input.js.map

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

package/dist/mcp/tools/transactions.js

@@ -0,0 +1,186 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { aggregate } from "../../core/aggregate.js";
+import { categoryById, isCategoryFilterValue } from "../../core/category.js";
+import { todayIn } from "../../core/date.js";
+import { toDecimal } from "../format.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+export { handleListTransactions, registerListTransactions, LIST_TRANSACTIONS_DESCRIPTION } from "./list-transactions.js";
+export const GET_TRANSACTIONS_DESCRIPTION = `Totals spending and income over a date range, grouped by category.
+
+Use this tool when:
+- You need to know how much was spent in a period, overall or in one category.
+- You need to compare categories or periods against each other.
+- You need transaction ids to look at individual rows afterwards.
+- You need to know how much is still uncategorized, by passing \`categories: ["none"]\`.
+
+Returns: \`spent\` and \`received\` as positive amounts, and one group per category with a signed total, a count and up to ten sample ids. Transfers between the user's own accounts and credit card bill payments are listed as groups but excluded from \`spent\` and \`received\`, because moving money between your own accounts is not spending. Instalments dated in the future are reported separately as \`upcoming\`. \`dataThrough\` states the most recent date each connection has actually supplied, which can trail its last sync by weeks.`;
+const dateInput = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "must be YYYY-MM-DD");
+const categoryInput = z.string().refine(isCategoryFilterValue, 'must be a known category id, or "none" for uncategorized');
+const getTransactionsInput = z.object({
+    startDate: dateInput,
+    endDate: dateInput,
+    categories: z.array(categoryInput).optional(),
+    minAmountCents: z.number().int().optional(),
+    maxAmountCents: z.number().int().optional(),
+    accountType: z.enum(["BANK", "CREDIT", "INVESTMENT", "LOAN"]).optional(),
+    accountSubtype: z.string().min(1).optional(),
+}).superRefine(validateRange);
+export function registerGetTransactions(server, deps) {
+    server.registerTool("getTransactions", { description: GET_TRANSACTIONS_DESCRIPTION, inputSchema: getTransactionsInput }, async (input) => handleGetTransactions(deps, input));
+}
+export async function handleGetTransactions(deps, input) {
+    const startedAt = Date.now();
+    const parsed = getTransactionsInput.safeParse(input);
+    if (!parsed.success) {
+        return finishToolError(deps.log, startedAt, validationMessage(parsed.error), { outcome: "invalid-input" });
+    }
+    const log = deps.log.child({ tool: "getTransactions" });
+    log.info({}, "getTransactions started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    if (deps.reader === null) {
+        return finishToolError(log, startedAt, "Transaction reader is unavailable.", { outcome: "reader-unavailable" });
+    }
+    return executeGetTransactions({ deps, input: parsed.data, startedAt, log, reader: deps.reader });
+}
+function validateRange(input, context) {
+    if (input.endDate < input.startDate) {
+        context.addIssue({ code: "custom", path: ["endDate"], message: "must not be before startDate" });
+    }
+}
+async function executeGetTransactions(options) {
+    const { deps, input, startedAt, log, reader } = options;
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    try {
+        const loaded = await reader.load(deps.source.connections);
+        const unavailable = unavailableRefusal(loaded.unavailable);
+        if (unavailable !== null) {
+            return finishToolError(log, startedAt, unavailable.message, unavailable.fields);
+        }
+        const currency = oneCurrency(loaded.accounts);
+        if (currency === null) {
+            return currencyError(log, startedAt, loaded.accounts);
+        }
+        const aggregateResult = readAggregate({ source: deps.source, reader, input, accounts: loaded.accounts, clock: deps.clock });
+        const response = formatResponse({ result: aggregateResult.result, input, currency, accounts: loaded.accounts, reader, today: aggregateResult.today });
+        log.info({ durationMs: Date.now() - startedAt, outcome: "ok", rows: aggregateResult.rows }, "getTransactions finished");
+        return textResult(response);
+    }
+    catch (error) {
+        return finishToolError(log, startedAt, `Cannot read transactions: ${messageOf(error)}`, { outcome: "failure" });
+    }
+}
+function validationMessage(error) {
+    const issue = error.issues[0];
+    if (issue === undefined) {
+        return "Invalid transaction filters.";
+    }
+    return `Invalid transaction filters: ${issue.path.join(".") || "input"} ${issue.message}.`;
+}
+function toFilter(input, accounts) {
+    let filter = {
+        accountIds: accounts.map((account) => account.id),
+        from: input.startDate,
+        to: input.endDate,
+    };
+    if (input.categories !== undefined) {
+        filter = { ...filter, categories: input.categories };
+    }
+    if (input.minAmountCents !== undefined) {
+        filter = { ...filter, minAmountCents: input.minAmountCents };
+    }
+    if (input.maxAmountCents !== undefined) {
+        filter = { ...filter, maxAmountCents: input.maxAmountCents };
+    }
+    if (input.accountType !== undefined) {
+        filter = { ...filter, accountType: input.accountType };
+    }
+    if (input.accountSubtype !== undefined) {
+        filter = { ...filter, accountSubtype: input.accountSubtype };
+    }
+    return filter;
+}
+function oneCurrency(accounts) {
+    const currencies = currenciesIn(accounts);
+    if (currencies.length !== 1) {
+        return null;
+    }
+    const currency = currencies[0];
+    if (currency === undefined) {
+        return null;
+    }
+    return currency;
+}
+function currenciesIn(accounts) {
+    return [...new Set(accounts.map((account) => account.currency))].sort();
+}
+function currencyError(log, startedAt, accounts) {
+    const currencies = currenciesIn(accounts);
+    return finishToolError(log, startedAt, `Cannot consolidate transactions across currencies: ${currencies.join(", ")}.`, { currencies });
+}
+function unavailableRefusal(unavailable) {
+    if (unavailable.length === 0) {
+        return null;
+    }
+    return {
+        message: `Cannot read transactions because ${unavailable
+            .map(({ connectionId, kind, message }) => `${connectionId} (${kind}): ${message}`)
+            .join("; ")}`,
+        fields: { unavailable: unavailable.length },
+    };
+}
+function readAggregate(options) {
+    const filter = toFilter(options.input, options.accounts);
+    const rows = options.reader.query(filter);
+    const today = todayIn(options.clock);
+    return { result: aggregate(rows, today), rows: rows.length, today };
+}
+function formatResponse(options) {
+    const { result, input, currency, accounts, reader, today } = options;
+    let upcomingField;
+    if (result.upcoming.count === 0) {
+        upcomingField = {};
+    }
+    else {
+        upcomingField = { upcoming: { total: toDecimal(result.upcoming.totalCents), count: result.upcoming.count } };
+    }
+    return {
+        from: input.startDate,
+        to: input.endDate,
+        currency,
+        spent: toDecimal(result.spentCents),
+        received: toDecimal(result.receivedCents),
+        groups: result.groups.map(formatGroup),
+        ...upcomingField,
+        accountsCovered: accounts.length,
+        dataThrough: [...reader.dataThrough(accounts.map((account) => account.id), today)].map(([connectionId, through]) => ({ connectionId, through })),
+    };
+}
+function messageOf(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function formatGroup(group) {
+    let label = "Uncategorized";
+    if (group.categoryId !== null) {
+        const category = categoryById(group.categoryId);
+        if (category === undefined) {
+            throw new Error(`category ${group.categoryId} is not in the display taxonomy`);
+        }
+        label = category.pt;
+    }
+    return {
+        category: group.categoryId,
+        label,
+        total: toDecimal(group.totalCents),
+        count: group.count,
+        sampleIds: group.sampleIds,
+    };
+}
+//# sourceMappingURL=transactions.js.map

package/dist/mcp/tools/transactions.js.map

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