@dizzlkheinz/ynab-mcpb 0.12.2 → 0.13.1

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import 'dotenv/config';
 import { YNABMCPServer } from './server/YNABMCPServer.js';
-import { AuthenticationError, ConfigurationError } from './types/index.js';
+import { AuthenticationError, ConfigurationError, ValidationError } from './utils/errors.js';
 let serverInstance = null;
 async function gracefulShutdown(signal) {
     console.error(`Received ${signal}, initiating graceful shutdown...`);
@@ -19,9 +19,9 @@ async function gracefulShutdown(signal) {
     }
 }
 function reportError(error) {
-    if (error instanceof ConfigurationError) {
-        console.error('❌ Configuration Error:', error.message);
-        console.error('Please check your environment variables and try again.');
+    if (error instanceof ValidationError) {
+        console.error('❌ Validation Error:', error.message);
+        console.error('Please check your inputs and try again.');
         process.exit(1);
     }
     else if (error instanceof AuthenticationError) {
@@ -29,6 +29,11 @@ function reportError(error) {
         console.error('Please verify your YNAB access token and try again.');
         process.exit(1);
     }
+    else if (error instanceof ConfigurationError) {
+        console.error('❌ Configuration Error:', error.message);
+        console.error('Please check your environment variables and try again.');
+        process.exit(1);
+    }
     else if (error instanceof Error) {
         console.error('❌ Server Error:', error.message);
         if (process.env['NODE_ENV'] === 'development') {
@@ -41,25 +46,9 @@ function reportError(error) {
         process.exit(1);
     }
 }
-function validateStartupEnvironment() {
-    const nodeVersion = process.version;
-    const majorVersion = parseInt(nodeVersion.slice(1).split('.')[0] || '0');
-    if (majorVersion < 18) {
-        console.error('❌ Node.js version 18 or higher is required');
-        console.error(`Current version: ${nodeVersion}`);
-        process.exit(1);
-    }
-    if (!process.env['YNAB_ACCESS_TOKEN']) {
-        console.error('❌ YNAB_ACCESS_TOKEN environment variable is required');
-        console.error('Please set your YNAB Personal Access Token and try again.');
-        process.exit(1);
-    }
-    console.error('✅ Environment validation passed');
-}
 async function main() {
     try {
         console.error('🚀 Starting YNAB MCP Server...');
-        validateStartupEnvironment();
         serverInstance = new YNABMCPServer();
         console.error('✅ Server instance created successfully');
         await serverInstance.run();

package/dist/server/YNABMCPServer.d.ts

@@ -4,9 +4,9 @@ import { ToolRegistry } from './toolRegistry.js';
 export declare class YNABMCPServer {
     private server;
     private ynabAPI;
-    private config;
     private exitOnError;
     private defaultBudgetId;
+    private configInstance;
     private serverVersion;
     private toolRegistry;
     private resourceManager;
@@ -18,6 +18,7 @@ export declare class YNABMCPServer {
     private errorHandler;
     constructor(exitOnError?: boolean);
     validateToken(): Promise<boolean>;
+    private isMalformedTokenResponse;
     private setupHandlers;
     private setupToolRegistry;
     private extractMinifyOverride;

package/dist/server/YNABMCPServer.js

@@ -5,8 +5,10 @@ import path from 'path';
 import { z } from 'zod';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListPromptsRequestSchema, ReadResourceRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import * as ynab from 'ynab';
-import { AuthenticationError, ConfigurationError, ErrorHandler, ValidationError, } from '../types/index.js';
-import { createErrorHandler } from './errorHandler.js';
+import { AuthenticationError, ConfigurationError, ValidationError as ConfigValidationError, } from '../utils/errors.js';
+import { ValidationError } from '../types/index.js';
+import { loadConfig } from './config.js';
+import { createErrorHandler, ErrorHandler } from './errorHandler.js';
 import { BudgetResolver } from './budgetResolver.js';
 import { SecurityMiddleware, withSecurityWrapper } from './securityMiddleware.js';
 import { handleListBudgets, handleGetBudget, GetBudgetSchema } from '../tools/budgetTools.js';
@@ -22,7 +24,6 @@ import { handleGetUser, handleConvertAmount, ConvertAmountSchema } from '../tool
 import { cacheManager, CacheManager } from './cacheManager.js';
 import { responseFormatter } from './responseFormatter.js';
 import { ToolRegistry, DefaultArgumentResolutionError, } from './toolRegistry.js';
-import { validateEnvironment } from './config.js';
 import { ResourceManager } from './resources.js';
 import { PromptManager } from './prompts.js';
 import { DiagnosticManager } from './diagnostics.js';
@@ -30,24 +31,22 @@ import { ServerKnowledgeStore } from './serverKnowledgeStore.js';
 import { DeltaCache } from './deltaCache.js';
 import { DeltaFetcher } from '../tools/deltaFetcher.js';
 import { ToolAnnotationPresets } from '../tools/toolCategories.js';
-import { GetUserOutputSchema, ConvertAmountOutputSchema, GetDefaultBudgetOutputSchema, SetDefaultBudgetOutputSchema, ClearCacheOutputSchema, SetOutputFormatOutputSchema, DiagnosticInfoOutputSchema, GetBudgetOutputSchema, ListBudgetsOutputSchema, ListAccountsOutputSchema, GetAccountOutputSchema, CreateAccountOutputSchema, ListTransactionsOutputSchema, GetTransactionOutputSchema, ExportTransactionsOutputSchema, CompareTransactionsOutputSchema, CreateTransactionOutputSchema, CreateTransactionsOutputSchema, UpdateTransactionOutputSchema, UpdateTransactionsOutputSchema, DeleteTransactionOutputSchema, CreateReceiptSplitTransactionOutputSchema, ListCategoriesOutputSchema, GetCategoryOutputSchema, UpdateCategoryOutputSchema, ListPayeesOutputSchema, GetPayeeOutputSchema, GetMonthOutputSchema, ListMonthsOutputSchema, ReconcileAccountOutputSchema, } from '../tools/schemas/outputs/index.js';
+import { GetUserOutputSchema, ConvertAmountOutputSchema, GetDefaultBudgetOutputSchema, SetDefaultBudgetOutputSchema, ClearCacheOutputSchema, SetOutputFormatOutputSchema, DiagnosticInfoOutputSchema, GetBudgetOutputSchema, ListBudgetsOutputSchema, ListAccountsOutputSchema, GetAccountOutputSchema, GetTransactionOutputSchema, ExportTransactionsOutputSchema, CompareTransactionsOutputSchema, ListCategoriesOutputSchema, GetCategoryOutputSchema, ListPayeesOutputSchema, GetPayeeOutputSchema, GetMonthOutputSchema, ListMonthsOutputSchema, } from '../tools/schemas/outputs/index.js';
 export class YNABMCPServer {
     constructor(exitOnError = true) {
         this.exitOnError = exitOnError;
-        this.config = validateEnvironment();
-        if (this.config.defaultBudgetId !== undefined) {
-            this.defaultBudgetId = this.config.defaultBudgetId;
-        }
-        this.ynabAPI = new ynab.API(this.config.accessToken);
+        this.configInstance = loadConfig();
+        this.defaultBudgetId = process.env['YNAB_DEFAULT_BUDGET_ID'];
+        this.ynabAPI = new ynab.API(this.configInstance.YNAB_ACCESS_TOKEN);
         this.serverVersion = this.readPackageVersion() ?? '0.0.0';
         this.server = new Server({
             name: 'ynab-mcp-server',
             version: this.serverVersion,
         }, {
             capabilities: {
-                tools: {},
-                resources: {},
-                prompts: {},
+                tools: { listChanged: true },
+                resources: { listChanged: true },
+                prompts: { listChanged: true },
             },
         });
         this.errorHandler = createErrorHandler(responseFormatter);
@@ -87,7 +86,7 @@ export class YNABMCPServer {
                 },
             },
             validateAccessToken: (token) => {
-                const expected = this.config.accessToken.trim();
+                const expected = this.configInstance.YNAB_ACCESS_TOKEN.trim();
                 const provided = typeof token === 'string' ? token.trim() : '';
                 if (!provided) {
                     throw this.errorHandler.createYNABError(401, 'validating access token', new Error('Missing access token'));
@@ -122,6 +121,9 @@ export class YNABMCPServer {
             return true;
         }
         catch (error) {
+            if (this.isMalformedTokenResponse(error)) {
+                throw new AuthenticationError('Unexpected response from YNAB during token validation');
+            }
             if (error instanceof Error) {
                 if (error.message.includes('401') || error.message.includes('Unauthorized')) {
                     throw new AuthenticationError('Invalid or expired YNAB access token');
@@ -129,9 +131,28 @@ export class YNABMCPServer {
                 if (error.message.includes('403') || error.message.includes('Forbidden')) {
                     throw new AuthenticationError('YNAB access token has insufficient permissions');
                 }
+                const reason = error.message || String(error);
+                throw new AuthenticationError(`Token validation failed: ${reason}`);
             }
-            throw new AuthenticationError(`Token validation failed: ${error}`);
+            throw new AuthenticationError(`Token validation failed: ${String(error)}`);
+        }
+    }
+    isMalformedTokenResponse(error) {
+        if (error instanceof SyntaxError) {
+            return true;
+        }
+        const message = typeof error === 'string'
+            ? error
+            : typeof error?.message === 'string'
+                ? String(error.message)
+                : null;
+        if (!message) {
+            return false;
         }
+        const normalized = message.toLowerCase();
+        return (normalized.includes('unexpected token') ||
+            normalized.includes('unexpected end of json') ||
+            normalized.includes('<html'));
     }
     setupHandlers() {
         this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
@@ -173,7 +194,7 @@ export class YNABMCPServer {
                 : undefined;
             const executionOptions = {
                 name: request.params.name,
-                accessToken: this.config.accessToken,
+                accessToken: this.configInstance.YNAB_ACCESS_TOKEN,
                 arguments: sanitizedArgs ?? {},
             };
             if (minifyOverride !== undefined) {
@@ -220,6 +241,7 @@ export class YNABMCPServer {
             pretty_spaces: z.number().int().min(0).max(10).optional(),
         })
             .strict();
+        const LooseObjectSchema = z.object({}).passthrough();
         register({
             name: 'list_budgets',
             description: "List all budgets associated with the user's account",
@@ -344,7 +366,7 @@ export class YNABMCPServer {
             name: 'create_account',
             description: 'Create a new account in the specified budget',
             inputSchema: CreateAccountSchema,
-            outputSchema: CreateAccountOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleCreateAccount),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -358,7 +380,7 @@ export class YNABMCPServer {
             name: 'list_transactions',
             description: 'List transactions for a budget with optional filtering',
             inputSchema: ListTransactionsSchema,
-            outputSchema: ListTransactionsOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWithDelta(handleListTransactions),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -400,7 +422,7 @@ export class YNABMCPServer {
             name: 'reconcile_account',
             description: 'Guided reconciliation workflow with human narrative, insight detection, and optional execution (create/update/unclear). Set include_structured_data=true to also get full JSON output (large).',
             inputSchema: ReconcileAccountSchema,
-            outputSchema: ReconcileAccountOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWithDelta(handleReconcileAccount),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -428,7 +450,7 @@ export class YNABMCPServer {
             name: 'create_transaction',
             description: 'Create a new transaction in the specified budget and account',
             inputSchema: CreateTransactionSchema,
-            outputSchema: CreateTransactionOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleCreateTransaction),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -442,7 +464,7 @@ export class YNABMCPServer {
             name: 'create_transactions',
             description: 'Create multiple transactions in a single batch (1-100 items) with duplicate detection, dry-run validation, and automatic response size management with correlation metadata.',
             inputSchema: CreateTransactionsSchema,
-            outputSchema: CreateTransactionsOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleCreateTransactions),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -456,7 +478,7 @@ export class YNABMCPServer {
             name: 'update_transactions',
             description: 'Update multiple transactions in a single batch (1-100 items) with dry-run validation, automatic cache invalidation, and response size management. Supports optional original_account_id and original_date metadata for efficient cache invalidation.',
             inputSchema: UpdateTransactionsSchema,
-            outputSchema: UpdateTransactionsOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleUpdateTransactions),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -470,7 +492,7 @@ export class YNABMCPServer {
             name: 'create_receipt_split_transaction',
             description: 'Create a split transaction from receipt items with proportional tax allocation',
             inputSchema: CreateReceiptSplitTransactionSchema,
-            outputSchema: CreateReceiptSplitTransactionOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleCreateReceiptSplitTransaction),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -484,7 +506,7 @@ export class YNABMCPServer {
             name: 'update_transaction',
             description: 'Update an existing transaction',
             inputSchema: UpdateTransactionSchema,
-            outputSchema: UpdateTransactionOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleUpdateTransaction),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -498,7 +520,7 @@ export class YNABMCPServer {
             name: 'delete_transaction',
             description: 'Delete a transaction from the specified budget',
             inputSchema: DeleteTransactionSchema,
-            outputSchema: DeleteTransactionOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleDeleteTransaction),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -540,7 +562,7 @@ export class YNABMCPServer {
             name: 'update_category',
             description: 'Update the budgeted amount for a category in the current month',
             inputSchema: UpdateCategorySchema,
-            outputSchema: UpdateCategoryOutputSchema,
+            outputSchema: LooseObjectSchema,
             handler: adaptWrite(handleUpdateCategory),
             defaultArgumentResolver: resolveBudgetId(),
             metadata: {
@@ -726,8 +748,12 @@ export class YNABMCPServer {
             console.error('YNAB MCP Server started successfully');
         }
         catch (error) {
-            if (error instanceof AuthenticationError || error instanceof ConfigurationError) {
-                console.error(`Server startup failed: ${error.message}`);
+            if (error instanceof AuthenticationError ||
+                error instanceof ConfigurationError ||
+                error instanceof ConfigValidationError ||
+                error instanceof ValidationError ||
+                error?.name === 'ValidationError') {
+                console.error(`Server startup failed: ${error instanceof Error ? error.message : error}`);
                 if (this.exitOnError) {
                     process.exit(1);
                 }
@@ -828,6 +854,14 @@ export class YNABMCPServer {
         }
         catch {
         }
+        try {
+            const dir = typeof __dirname === 'string' ? __dirname : undefined;
+            if (dir) {
+                candidates.push(path.resolve(dir, '../../package.json'), path.resolve(dir, '../package.json'), path.resolve(dir, 'package.json'));
+            }
+        }
+        catch {
+        }
         for (const p of candidates) {
             try {
                 if (fs.existsSync(p)) {

package/dist/server/cacheKeys.d.ts

@@ -0,0 +1,8 @@
+export declare const CacheKeys: {
+    readonly ACCOUNTS: "accounts";
+    readonly BUDGETS: "budgets";
+    readonly CATEGORIES: "categories";
+    readonly PAYEES: "payees";
+    readonly TRANSACTIONS: "transactions";
+    readonly MONTHS: "months";
+};

package/dist/server/cacheKeys.js

@@ -0,0 +1,8 @@
+export const CacheKeys = {
+    ACCOUNTS: 'accounts',
+    BUDGETS: 'budgets',
+    CATEGORIES: 'categories',
+    PAYEES: 'payees',
+    TRANSACTIONS: 'transactions',
+    MONTHS: 'months',
+};

package/dist/server/config.d.ts

@@ -1,3 +1,22 @@
-import { ServerConfig } from '../types/index.js';
-export declare function validateEnvironment(): ServerConfig;
-export type { ServerConfig } from '../types/index.js';
+import 'dotenv/config';
+import { z } from 'zod';
+declare const envSchema: z.ZodObject<{
+    YNAB_ACCESS_TOKEN: z.ZodString;
+    MCP_PORT: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        warn: "warn";
+        info: "info";
+        debug: "debug";
+        trace: "trace";
+        fatal: "fatal";
+    }>>;
+}, z.core.$strip>;
+export type AppConfig = z.infer<typeof envSchema>;
+export declare function loadConfig(env?: NodeJS.ProcessEnv): AppConfig;
+export declare const config: {
+    YNAB_ACCESS_TOKEN: string;
+    LOG_LEVEL: "error" | "warn" | "info" | "debug" | "trace" | "fatal";
+    MCP_PORT?: number | undefined;
+};
+export {};

package/dist/server/config.js

@@ -1,19 +1,18 @@
-import { ConfigurationError } from '../types/index.js';
-export function validateEnvironment() {
-    const accessToken = process.env['YNAB_ACCESS_TOKEN'];
-    const defaultBudgetId = process.env['YNAB_DEFAULT_BUDGET_ID'];
-    if (accessToken === undefined) {
-        throw new ConfigurationError('YNAB_ACCESS_TOKEN environment variable is required but not set');
+import 'dotenv/config';
+import { z } from 'zod';
+import { fromZodError } from 'zod-validation-error';
+import { ValidationError } from '../utils/errors.js';
+const envSchema = z.object({
+    YNAB_ACCESS_TOKEN: z.string().trim().min(1, 'YNAB_ACCESS_TOKEN must be a non-empty string'),
+    MCP_PORT: z.coerce.number().int().positive().optional(),
+    LOG_LEVEL: z.enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal']).default('info'),
+});
+export function loadConfig(env = process.env) {
+    const result = envSchema.safeParse(env);
+    if (!result.success) {
+        const validationError = fromZodError(result.error);
+        throw new ValidationError(validationError.toString());
     }
-    if (typeof accessToken !== 'string' || accessToken.trim().length === 0) {
-        throw new ConfigurationError('YNAB_ACCESS_TOKEN must be a non-empty string');
-    }
-    const trimmedDefaultBudgetId = defaultBudgetId?.trim();
-    const config = {
-        accessToken: accessToken.trim(),
-    };
-    if (trimmedDefaultBudgetId && trimmedDefaultBudgetId.length > 0) {
-        config.defaultBudgetId = trimmedDefaultBudgetId;
-    }
-    return config;
+    return result.data;
 }
+export const config = loadConfig();

package/dist/server/securityMiddleware.js

@@ -1,4 +1,5 @@
 import { z } from 'zod/v4';
+import { fromZodError } from 'zod-validation-error';
 import { globalRateLimiter, RateLimitError } from './rateLimiter.js';
 import { globalRequestLogger } from './requestLogger.js';
 import { ErrorHandler } from './errorHandler.js';
@@ -42,12 +43,8 @@ export class SecurityMiddleware {
         }
         catch (error) {
             if (error instanceof z.ZodError) {
-                const errorMessage = error.issues && error.issues.length > 0
-                    ? error.issues
-                        .map((err) => `${err.path.join('.')}: ${err.message}`)
-                        .join(', ')
-                    : error.message || 'Validation failed';
-                throw new Error(`Validation failed: ${errorMessage}`);
+                const validationError = fromZodError(error);
+                throw new Error(`Validation failed: ${validationError.message}`);
             }
             throw error;
         }

package/dist/server/toolRegistry.js

@@ -1,4 +1,5 @@
 import { z, toJSONSchema } from 'zod/v4';
+import { fromZodError } from 'zod-validation-error';
 export class DefaultArgumentResolutionError extends Error {
     constructor(result) {
         super('Default argument resolution failed');
@@ -41,7 +42,7 @@ export class ToolRegistry {
                 inputSchema,
             };
             if (tool.outputSchema) {
-                const outputSchema = this.generateJsonSchema(tool.outputSchema);
+                const outputSchema = this.generateJsonSchema(tool.outputSchema, 'output');
                 result.outputSchema = outputSchema;
             }
             if (tool.metadata?.annotations) {
@@ -160,7 +161,8 @@ export class ToolRegistry {
     }
     normalizeSecurityError(error, tool) {
         if (error instanceof z.ZodError) {
-            return this.deps.errorHandler.createValidationError(`Invalid parameters for ${tool.name}`, error.message);
+            const validationError = fromZodError(error);
+            return this.deps.errorHandler.createValidationError(`Invalid parameters for ${tool.name}`, validationError.message);
         }
         if (error instanceof Error && error.message.includes('Validation failed')) {
             return this.deps.errorHandler.createValidationError(`Invalid parameters for ${tool.name}`, error.message);
@@ -204,9 +206,9 @@ export class ToolRegistry {
             throw new Error(`Tool '${definition.name}' defaultArgumentResolver must be a function when provided`);
         }
     }
-    generateJsonSchema(schema) {
+    generateJsonSchema(schema, ioMode = 'input') {
         try {
-            return toJSONSchema(schema, { target: 'draft-2020-12', io: 'output' });
+            return toJSONSchema(schema, { target: 'draft-2020-12', io: ioMode });
         }
         catch (error) {
             console.warn(`Failed to generate JSON schema for tool: ${error}`);
@@ -256,12 +258,8 @@ export class ToolRegistry {
         }
         const result = validator.safeParse(parsedOutput);
         if (!result.success) {
-            const validationErrors = result.error.issues
-                .map((err) => {
-                const path = err.path.join('.');
-                return path ? `${path}: ${err.message}` : err.message;
-            })
-                .join('; ');
+            const validationError = fromZodError(result.error);
+            const validationErrors = validationError.message;
             return this.deps.errorHandler.createValidationError(`Output validation failed for ${toolName}`, `Handler output does not match declared output schema: ${validationErrors}`, [
                 'Check that the handler returns data matching the output schema',
                 'Review the tool definition output schema',

package/dist/tools/accountTools.js

@@ -3,6 +3,7 @@ import { withToolErrorHandling } from '../types/index.js';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { milliunitsToAmount } from '../utils/amountUtils.js';
 import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.js';
+import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs, resolveDeltaWriteArgs } from './deltaSupport.js';
 export const ListAccountsSchema = z
     .object({
@@ -76,7 +77,7 @@ export async function handleListAccounts(ynabAPI, deltaFetcherOrParams, maybePar
 }
 export async function handleGetAccount(ynabAPI, params) {
     return await withToolErrorHandling(async () => {
-        const cacheKey = CacheManager.generateKey('account', 'get', params.budget_id, params.account_id);
+        const cacheKey = CacheManager.generateKey(CacheKeys.ACCOUNTS, 'get', params.budget_id, params.account_id);
         const wasCached = cacheManager.has(cacheKey);
         const account = await cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.ACCOUNTS,
@@ -145,9 +146,9 @@ export async function handleCreateAccount(ynabAPI, deltaCacheOrParams, knowledge
             account: accountData,
         });
         const account = response.data.account;
-        const accountsListCacheKey = CacheManager.generateKey('accounts', 'list', params.budget_id);
+        const accountsListCacheKey = CacheManager.generateKey(CacheKeys.ACCOUNTS, 'list', params.budget_id);
         cacheManager.delete(accountsListCacheKey);
-        deltaCache.invalidate(params.budget_id, 'accounts');
+        deltaCache.invalidate(params.budget_id, CacheKeys.ACCOUNTS);
         return {
             content: [
                 {

package/dist/tools/categoryTools.js

@@ -3,6 +3,7 @@ import { withToolErrorHandling } from '../types/index.js';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { milliunitsToAmount } from '../utils/amountUtils.js';
 import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.js';
+import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs, resolveDeltaWriteArgs } from './deltaSupport.js';
 export const ListCategoriesSchema = z
     .object({
@@ -84,7 +85,7 @@ export async function handleListCategories(ynabAPI, deltaFetcherOrParams, maybeP
 }
 export async function handleGetCategory(ynabAPI, params) {
     return await withToolErrorHandling(async () => {
-        const cacheKey = CacheManager.generateKey('category', 'get', params.budget_id, params.category_id);
+        const cacheKey = CacheManager.generateKey(CacheKeys.CATEGORIES, 'get', params.budget_id, params.category_id);
         const wasCached = cacheManager.has(cacheKey);
         const category = await cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.CATEGORIES,
@@ -152,16 +153,16 @@ export async function handleUpdateCategory(ynabAPI, deltaCacheOrParams, knowledg
         const currentMonth = `${currentDate.getFullYear()}-${String(currentDate.getMonth() + 1).padStart(2, '0')}-01`;
         const response = await ynabAPI.categories.updateMonthCategory(params.budget_id, currentMonth, params.category_id, { category: { budgeted: params.budgeted } });
         const category = response.data.category;
-        const categoriesListCacheKey = CacheManager.generateKey('categories', 'list', params.budget_id);
-        const specificCategoryCacheKey = CacheManager.generateKey('category', 'get', params.budget_id, params.category_id);
+        const categoriesListCacheKey = CacheManager.generateKey(CacheKeys.CATEGORIES, 'list', params.budget_id);
+        const specificCategoryCacheKey = CacheManager.generateKey(CacheKeys.CATEGORIES, 'get', params.budget_id, params.category_id);
         cacheManager.delete(categoriesListCacheKey);
         cacheManager.delete(specificCategoryCacheKey);
-        const monthsListCacheKey = CacheManager.generateKey('months', 'list', params.budget_id);
-        const currentMonthCacheKey = CacheManager.generateKey('month', 'get', params.budget_id, currentMonth);
+        const monthsListCacheKey = CacheManager.generateKey(CacheKeys.MONTHS, 'list', params.budget_id);
+        const currentMonthCacheKey = CacheManager.generateKey(CacheKeys.MONTHS, 'get', params.budget_id, currentMonth);
         cacheManager.delete(monthsListCacheKey);
         cacheManager.delete(currentMonthCacheKey);
-        deltaCache.invalidate(params.budget_id, 'categories');
-        deltaCache.invalidate(params.budget_id, 'months');
+        deltaCache.invalidate(params.budget_id, CacheKeys.CATEGORIES);
+        deltaCache.invalidate(params.budget_id, CacheKeys.MONTHS);
         const serverKnowledge = response.data.server_knowledge;
         if (typeof serverKnowledge === 'number') {
             knowledgeStore.update(categoriesListCacheKey, serverKnowledge);

package/dist/tools/monthTools.js

@@ -3,6 +3,7 @@ import { withToolErrorHandling } from '../types/index.js';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { milliunitsToAmount } from '../utils/amountUtils.js';
 import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.js';
+import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs } from './deltaSupport.js';
 export const GetMonthSchema = z
     .object({
@@ -17,7 +18,7 @@ export const ListMonthsSchema = z
     .strict();
 export async function handleGetMonth(ynabAPI, params) {
     return await withToolErrorHandling(async () => {
-        const cacheKey = CacheManager.generateKey('month', 'get', params.budget_id, params.month);
+        const cacheKey = CacheManager.generateKey(CacheKeys.MONTHS, 'get', params.budget_id, params.month);
         const wasCached = cacheManager.has(cacheKey);
         const month = await cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.MONTHS,

package/dist/tools/payeeTools.js

@@ -2,6 +2,7 @@ import { z } from 'zod/v4';
 import { withToolErrorHandling } from '../types/index.js';
 import { responseFormatter } from '../server/responseFormatter.js';
 import { cacheManager, CACHE_TTLS, CacheManager } from '../server/cacheManager.js';
+import { CacheKeys } from '../server/cacheKeys.js';
 import { resolveDeltaFetcherArgs } from './deltaSupport.js';
 export const ListPayeesSchema = z
     .object({
@@ -50,7 +51,7 @@ export async function handleListPayees(ynabAPI, deltaFetcherOrParams, maybeParam
 }
 export async function handleGetPayee(ynabAPI, params) {
     return await withToolErrorHandling(async () => {
-        const cacheKey = CacheManager.generateKey('payee', 'get', params.budget_id, params.payee_id);
+        const cacheKey = CacheManager.generateKey(CacheKeys.PAYEES, 'get', params.budget_id, params.payee_id);
         const wasCached = cacheManager.has(cacheKey);
         const payee = await cacheManager.wrap(cacheKey, {
             ttl: CACHE_TTLS.PAYEES,