cata-centavo 0.1.0

package/dist/core/transactions.js

@@ -0,0 +1,46 @@
+import { collectAccounts } from "./accounts.js";
+export function createTransactionReader(options) {
+    const inFlight = new Map();
+    return {
+        load: async (connectionIds) => {
+            const collected = await collectAccounts(options.bank, connectionIds, options.toFailure, options.clock);
+            await Promise.all(collected.accounts.map((account) => walkIfStale(options, inFlight, account)));
+            return collected;
+        },
+        query: (filter) => options.store.query(filter),
+        byIds: (ids) => options.store.byIds(ids),
+        cardRows: (accountId) => options.store.cardRows(accountId),
+        dataThrough: (accountIds, today) => options.store.dataThrough(accountIds, today),
+    };
+}
+function walkIfStale(options, inFlight, account) {
+    const existing = inFlight.get(account.id);
+    if (existing !== undefined) {
+        return existing;
+    }
+    if (!needsWalk(options.store, account)) {
+        return Promise.resolve();
+    }
+    const walk = performWalk(options, account).finally(() => inFlight.delete(account.id));
+    inFlight.set(account.id, walk);
+    return walk;
+}
+function needsWalk(store, account) {
+    const current = freshnessStamp(account);
+    if (current === null) {
+        return true;
+    }
+    return store.syncedLastUpdatedAt(account.id) !== current;
+}
+async function performWalk(options, account) {
+    const rows = await options.bank.getTransactions(account);
+    const deleted = options.store.replaceAccount(account.id, account.connectionId, rows, freshnessStamp(account));
+    options.log.info({ accountId: account.id, connectionId: account.connectionId, rows: rows.length, deleted }, "Walked transactions");
+}
+function freshnessStamp(account) {
+    if (account.lastUpdatedAt === null) {
+        return null;
+    }
+    return account.lastUpdatedAt.toISOString();
+}
+//# sourceMappingURL=transactions.js.map

package/dist/core/transactions.js.map

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

package/dist/logging.js

@@ -0,0 +1,93 @@
+import { chmodSync, closeSync, mkdirSync, openSync } from "node:fs";
+import { dirname } from "node:path";
+import { Writable } from "node:stream";
+import pino, {} from "pino";
+const REDACT_PATHS = [
+    "clientSecret",
+    "apiKey",
+    "authorization",
+    "key",
+    "*.clientSecret",
+    "*.apiKey",
+    "*.authorization",
+    "*.key",
+];
+/**
+ * Builds the process logger. The real stderr destination is fd 2 because fd 1
+ * is the MCP JSON-RPC channel. File failures degrade to stderr only.
+ */
+export function createLogger(options) {
+    const level = options.env.CATA_CENTAVO_LOG_LEVEL ?? "info";
+    let stderrLevel;
+    if (level === "debug") {
+        stderrLevel = "debug";
+    }
+    else {
+        stderrLevel = "warn";
+    }
+    let stderr;
+    if (options.write === undefined) {
+        stderr = pino.destination({ dest: 2, sync: true });
+    }
+    else {
+        stderr = testDestination(options.write);
+    }
+    const streams = [
+        { level: stderrLevel, stream: stderr },
+    ];
+    const file = fileStream(options, level);
+    if (file !== null)
+        streams.push(file);
+    const root = pino({
+        level,
+        // Pino's runtime sentinel for the design's `base: undefined` is null;
+        // it omits pid and hostname without violating exactOptionalPropertyTypes.
+        base: null,
+        redact: { paths: REDACT_PATHS, censor: "[Redacted]" },
+    }, pino.multistream(streams));
+    return wrap(root);
+}
+/** Null whenever the file is switched off, unconfigured, or could not be opened. */
+function fileStream(options, level) {
+    if (options.logFile === null || options.env.CATA_CENTAVO_LOG_FILE === "off") {
+        return null;
+    }
+    const stream = createFileDestination(options.logFile);
+    if (stream === null) {
+        return null;
+    }
+    return { level, stream };
+}
+function wrap(log) {
+    return {
+        debug: (fields, message) => log.debug(fields, message),
+        info: (fields, message) => log.info(fields, message),
+        warn: (fields, message) => log.warn(fields, message),
+        error: (fields, message) => log.error(fields, message),
+        child: (fields) => wrap(log.child(fields)),
+    };
+}
+function testDestination(write) {
+    return new Writable({
+        write(chunk, _encoding, callback) {
+            write(String(chunk));
+            callback();
+        },
+    });
+}
+function createFileDestination(path) {
+    try {
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        const descriptor = openSync(path, "a", 0o600);
+        closeSync(descriptor);
+        chmodSync(path, 0o600);
+        return pino.transport({
+            target: "pino-roll",
+            options: { file: path, size: "5m", mkdir: true, mode: 0o600 },
+        });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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

package/dist/mcp/cursor.js

@@ -0,0 +1,64 @@
+import { createHash } from "node:crypto";
+export function encodeCursor(position, filter) {
+    const payload = { d: position.localDate, i: position.id, f: fingerprint(filter) };
+    return Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
+}
+export function decodeCursor(cursor, filter) {
+    const payload = parseCursor(cursor);
+    if (payload === null) {
+        return invalidCursor("cursor is not valid base64url JSON");
+    }
+    if (payload.f !== fingerprint(filter)) {
+        return invalidCursor("cursor does not match these filters");
+    }
+    return { ok: true, position: { localDate: payload.d, id: payload.i } };
+}
+function parseCursor(cursor) {
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+        if (!isRecord(parsed)) {
+            return null;
+        }
+        const d = parsed["d"];
+        const i = parsed["i"];
+        const f = parsed["f"];
+        if (typeof d !== "string" || typeof i !== "string" || typeof f !== "string") {
+            return null;
+        }
+        return { d, i, f };
+    }
+    catch {
+        return null;
+    }
+}
+function invalidCursor(message) {
+    return { ok: false, message };
+}
+function fingerprint(filter) {
+    const canonical = {};
+    for (const key of Object.keys(filter).sort()) {
+        if (key === "limit" || key === "after") {
+            continue;
+        }
+        canonical[key] = filter[key];
+    }
+    const stable = stableValue(canonical);
+    return createHash("sha256").update(JSON.stringify(stable)).digest("hex");
+}
+function stableValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(stableValue);
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+        sorted[key] = stableValue(value[key]);
+    }
+    return sorted;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/mcp/cursor.js.map

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

package/dist/mcp/format.js

@@ -0,0 +1,38 @@
+export function toDecimal(cents) {
+    let sign;
+    if (cents < 0) {
+        sign = "-";
+    }
+    else {
+        sign = "";
+    }
+    const absoluteCents = Math.abs(cents);
+    const whole = Math.trunc(absoluteCents / 100);
+    const fraction = absoluteCents % 100;
+    return `${sign}${whole}.${fraction.toString().padStart(2, "0")}`;
+}
+export function prune(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => {
+            const pruned = prune(item);
+            if (pruned === undefined) {
+                return [];
+            }
+            return [pruned];
+        });
+    }
+    if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).flatMap(([key, item]) => {
+            const pruned = prune(item);
+            if (pruned === undefined) {
+                return [];
+            }
+            return [[key, pruned]];
+        }));
+    }
+    return value;
+}
+//# sourceMappingURL=format.js.map

package/dist/mcp/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/mcp/format.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,aAAa,GAAG,GAAG,CAAC;IAErC,OAAO,GAAG,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp/server.js

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerGetAccounts, registerGetBalanceByAccount } from "./tools/accounts.js";
+import { registerGetBalance } from "./tools/balance.js";
+import { registerGetBills, registerGetBillSummary } from "./tools/bills.js";
+import { registerDeleteClosingDay, registerListClosingDays, registerSetClosingDay, } from "./tools/closing-days.js";
+import { registerListSources } from "./tools/sources.js";
+import { registerGetTransactionDetails } from "./tools/transaction-details.js";
+import { registerGetTransactions, registerListTransactions } from "./tools/transactions.js";
+import { registerSetCategory, registerSetCounterpartyCategory } from "./tools/set-category.js";
+/** Creates the MCP server and registers its financial tools. */
+export function createServer(options) {
+    const server = new McpServer({ name: "cata-centavo", version: options.version });
+    const deps = toolDeps(options);
+    for (const register of REGISTRARS) {
+        register(server, deps);
+    }
+    return server;
+}
+/** Every tool this server exposes. One list, so registering is not a place to forget one. */
+const REGISTRARS = [
+    registerGetAccounts,
+    registerGetBalanceByAccount,
+    registerGetBalance,
+    registerGetTransactions,
+    registerListTransactions,
+    registerGetTransactionDetails,
+    registerSetCategory,
+    registerSetCounterpartyCategory,
+    registerListClosingDays,
+    registerSetClosingDay,
+    registerDeleteClosingDay,
+    registerGetBills,
+    registerGetBillSummary,
+    registerListSources,
+];
+function toolDeps(options) {
+    const clock = { now: () => new Date() };
+    if (!options.source.ok) {
+        return { source: options.source, log: options.log, reader: null, writer: null, closingDays: null, clock };
+    }
+    return {
+        source: options.source,
+        log: options.log,
+        reader: options.source.reader,
+        writer: options.source.writer,
+        closingDays: options.source.closingDays ?? null,
+        clock,
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAE/F,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,OAI5B;IACC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,GAA6D;IAC3E,mBAAmB;IACnB,2BAA2B;IAC3B,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,6BAA6B;IAC7B,mBAAmB;IACnB,+BAA+B;IAC/B,uBAAuB;IACvB,qBAAqB;IACrB,wBAAwB;IACxB,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB;CACpB,CAAC;AAEF,SAAS,QAAQ,CAAC,OAA0D;IAC1E,MAAM,KAAK,GAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5G,CAAC;IACD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;QAC7B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI;QAC/C,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/mcp/source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source.js.map

package/dist/mcp/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/mcp/source.ts"],"names":[],"mappings":""}

package/dist/mcp/tools/accounts.js

@@ -0,0 +1,144 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { collectAccounts } from "../../core/accounts.js";
+import { ACCOUNT_TYPES } from "../../core/account.js";
+import { toDecimal } from "../format.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+const getBalanceByAccountInput = z.object({ accountId: z.string().min(1) });
+export const GET_ACCOUNTS_DESCRIPTION = `Lists every account across the configured bank connections.
+
+Use this tool when:
+- You need an account map before inspecting one account or filtering financial activity.
+- You need to see which configured connections could not provide account data.
+
+Returns: Per-account figures in different units. A BANK account reports \`balance\`, the money available. A credit card reports \`usedCredit\`, how much of its limit is currently taken — this mixes the cycle in progress with instalments not yet charged, so it is not what the card owes this month and does not match the statement in a banking app. No tool here reports a card's statement amount.`;
+export const GET_BALANCE_BY_ACCOUNT_DESCRIPTION = `Gets the current figures and details for one account.
+
+Use this tool when:
+- You need one account's numbers and already have its ID from getAccounts.
+- You need that account's credit limit and cycle dates.
+
+Returns: For a BANK account, its balance. For a credit card, \`usedCredit\` — the portion of the limit currently taken, which is not the amount owed for the month. Also the currency, type, credit limit and cycle dates when applicable, and when the connection last supplied data.`;
+/** Registers the account map tool. */
+export function registerGetAccounts(server, deps) {
+    server.registerTool("getAccounts", { description: GET_ACCOUNTS_DESCRIPTION }, async () => handleGetAccounts(deps));
+}
+/** Registers the single-account balance tool. */
+export function registerGetBalanceByAccount(server, deps) {
+    server.registerTool("getBalanceByAccount", { description: GET_BALANCE_BY_ACCOUNT_DESCRIPTION, inputSchema: getBalanceByAccountInput }, async (input) => handleGetBalanceByAccount(deps, input));
+}
+/** Lists accounts from every configured connection, retaining any unavailable connections. */
+export async function handleGetAccounts(deps) {
+    const startedAt = Date.now();
+    const log = deps.log.child({ tool: "getAccounts", callId: randomUUID() });
+    log.info({}, "getAccounts started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    const collected = await collectAccounts(deps.source.bank, deps.source.connections, deps.source.toFailure, deps.clock);
+    for (const unavailable of collected.unavailable) {
+        log.warn({
+            connectionId: unavailable.connectionId,
+            kind: unavailable.kind,
+            message: unavailable.message,
+            accounts: collected.accounts.length,
+            unavailable: collected.unavailable.length,
+        }, "Connection unavailable");
+    }
+    if (collected.accounts.length === 0 && collected.unavailable.length > 0) {
+        return finishToolError(log, startedAt, noAccountsMessage(collected.unavailable), {
+            accounts: 0,
+            unavailable: collected.unavailable.length,
+        });
+    }
+    const response = { accounts: collected.accounts.map(formatAccount), unavailable: collected.unavailable };
+    log.debug({ accounts: response.accounts }, "getAccounts returned account details");
+    log.info({ durationMs: Date.now() - startedAt, outcome: "ok", accounts: response.accounts.length, unavailable: collected.unavailable.length }, "getAccounts finished");
+    return textResult(response);
+}
+/** Gets the figures and details of one configured account. */
+export async function handleGetBalanceByAccount(deps, input) {
+    const startedAt = Date.now();
+    const parsed = getBalanceByAccountInput.parse(input);
+    const log = deps.log.child({ tool: "getBalanceByAccount", callId: randomUUID() });
+    log.info({ accountId: parsed.accountId }, "getBalanceByAccount started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    try {
+        const account = await getConfiguredAccount(deps.source, parsed.accountId);
+        if (account === null) {
+            return finishToolError(log, startedAt, "Unknown account.", { accounts: 0 });
+        }
+        const response = formatAccount(account);
+        log.debug({ account: response }, "getBalanceByAccount returned account details");
+        log.info({ durationMs: Date.now() - startedAt, outcome: "ok", accounts: 1 }, "getBalanceByAccount finished");
+        return textResult(response);
+    }
+    catch (error) {
+        log.info({ durationMs: Date.now() - startedAt, outcome: "crash" }, "getBalanceByAccount crashed");
+        throw error;
+    }
+}
+async function getConfiguredAccount(source, accountId) {
+    try {
+        const account = await source.bank.getAccount(accountId);
+        if (source.connections.includes(account.connectionId)) {
+            return account;
+        }
+        return null;
+    }
+    catch (error) {
+        if (source.toFailure(error).kind === "unknown-connection")
+            return null;
+        throw error;
+    }
+}
+function noAccountsMessage(unavailable) {
+    return `No accounts came back from any configured connection: ${unavailable
+        .map(({ connectionId, kind, message }) => `${connectionId} (${kind}): ${message}`)
+        .join("; ")}`;
+}
+function formatAccount(account) {
+    let amountField;
+    if (account.type === ACCOUNT_TYPES.credit) {
+        amountField = { usedCredit: toDecimal(account.amountCents) };
+    }
+    else {
+        amountField = { balance: toDecimal(account.amountCents) };
+    }
+    return {
+        id: account.id,
+        connectionId: account.connectionId,
+        institution: account.institution,
+        name: account.name,
+        type: account.type,
+        subtype: account.subtype,
+        ...amountField,
+        currency: account.currency,
+        lastUpdatedAt: account.lastUpdatedAt?.toISOString() ?? null,
+        credit: formatCredit(account.credit),
+    };
+}
+function formatCredit(credit) {
+    if (credit === null)
+        return null;
+    return {
+        limit: decimalOrNull(credit.limitCents),
+        availableLimit: decimalOrNull(credit.availableLimitCents),
+        balanceCloseDate: isoOrNull(credit.balanceCloseDate),
+        balanceDueDate: isoOrNull(credit.balanceDueDate),
+        brand: credit.brand,
+    };
+}
+function decimalOrNull(cents) {
+    if (cents === null) {
+        return null;
+    }
+    return toDecimal(cents);
+}
+function isoOrNull(date) {
+    return date?.toISOString() ?? null;
+}
+//# sourceMappingURL=accounts.js.map

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

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

package/dist/mcp/tools/balance.js

@@ -0,0 +1,96 @@
+import { randomUUID } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { collectAccounts } from "../../core/accounts.js";
+import { summarize } from "../../core/balance.js";
+import { prune, toDecimal } from "../format.js";
+import { configurationProblems, finishToolError, textResult } from "./result.js";
+export const GET_BALANCE_DESCRIPTION = `Gets consolidated figures across all configured bank connections.
+
+Use this tool when:
+- You need total money available without mixing it with what cards have taken.
+- You need to know when each connection last supplied its account data.
+
+Returns: \`cash\`, the money available across bank accounts, and \`creditUsed\`, the limit currently taken across cards — never added together, because they are not the same unit. Investment and loan totals when reported, plus the currency, how many accounts were counted, and each source's update time.`;
+/** Registers the consolidated balance tool. */
+export function registerGetBalance(server, deps) {
+    server.registerTool("getBalance", { description: GET_BALANCE_DESCRIPTION }, async () => handleGetBalance(deps));
+}
+/** Gets separate totals for every available configured connection. */
+export async function handleGetBalance(deps) {
+    const startedAt = Date.now();
+    const log = deps.log.child({ tool: "getBalance", callId: randomUUID() });
+    log.info({}, "getBalance started");
+    if (!deps.source.ok) {
+        return finishToolError(log, startedAt, configurationProblems(deps.source.problems), { problems: deps.source.problems.length });
+    }
+    const collected = await collectAccounts(deps.source.bank, deps.source.connections, deps.source.toFailure, deps.clock);
+    if (collected.unavailable.length > 0) {
+        logUnavailableConnections(log, collected.accounts.length, collected.unavailable);
+        return finishToolError(log, startedAt, unavailableMessage(collected.unavailable), {
+            accounts: collected.accounts.length,
+            unavailable: collected.unavailable.length,
+        });
+    }
+    const summary = summarize(collected.accounts);
+    if (!summary.ok) {
+        return finishToolError(log, startedAt, mixedCurrencyMessage(summary.currencies), { currencies: summary.currencies });
+    }
+    const response = formatSummary(summary.summary, collected.accounts);
+    log.debug({ balance: response }, "getBalance returned consolidated balances");
+    log.info({ durationMs: Date.now() - startedAt, outcome: "ok", accounts: summary.summary.accountsCounted }, "getBalance finished");
+    return textResult(response);
+}
+function logUnavailableConnections(log, accounts, unavailable) {
+    for (const connection of unavailable) {
+        log.warn({
+            connectionId: connection.connectionId,
+            kind: connection.kind,
+            message: connection.message,
+            accounts,
+            unavailable: unavailable.length,
+        }, "Connection unavailable");
+    }
+}
+function unavailableMessage(unavailable) {
+    return `Cannot consolidate balances because ${unavailable
+        .map(({ connectionId, kind, message }) => `${connectionId} (${kind}): ${message}`)
+        .join("; ")}`;
+}
+function mixedCurrencyMessage(currencies) {
+    return `Cannot consolidate balances across currencies: ${currencies.join(", ")}.`;
+}
+function formatSummary(summary, accounts) {
+    let investedField;
+    if (summary.investedCents === undefined) {
+        investedField = {};
+    }
+    else {
+        investedField = { invested: toDecimal(summary.investedCents) };
+    }
+    let loansField;
+    if (summary.loanCents === undefined) {
+        loansField = {};
+    }
+    else {
+        loansField = { loans: toDecimal(summary.loanCents) };
+    }
+    return {
+        cash: toDecimal(summary.cashCents),
+        creditUsed: toDecimal(summary.creditUsedCents),
+        ...investedField,
+        ...loansField,
+        currency: summary.currency,
+        accountsCounted: summary.accountsCounted,
+        asOf: accountsAsOf(accounts),
+    };
+}
+function accountsAsOf(accounts) {
+    const byConnection = new Map();
+    for (const account of accounts) {
+        if (!byConnection.has(account.connectionId)) {
+            byConnection.set(account.connectionId, account);
+        }
+    }
+    return [...byConnection.values()].map((account) => prune({ connectionId: account.connectionId, lastUpdatedAt: account.lastUpdatedAt?.toISOString() ?? null }));
+}
+//# sourceMappingURL=balance.js.map

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

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