@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.0

package/src/tools/schemas/outputs/index.ts

@@ -23,213 +23,213 @@
 
 // Main output schemas
 export {
-  GetUserOutputSchema,
-  type GetUserOutput,
-  GetDefaultBudgetOutputSchema,
-  type GetDefaultBudgetOutput,
-  SetDefaultBudgetOutputSchema,
-  type SetDefaultBudgetOutput,
-  ClearCacheOutputSchema,
-  type ClearCacheOutput,
-  SetOutputFormatOutputSchema,
-  type SetOutputFormatOutput,
-  DiagnosticInfoOutputSchema,
-  type DiagnosticInfoOutput,
-  GetBudgetOutputSchema,
-  type GetBudgetOutput,
-} from './utilityOutputs.js';
+	GetUserOutputSchema,
+	type GetUserOutput,
+	GetDefaultBudgetOutputSchema,
+	type GetDefaultBudgetOutput,
+	SetDefaultBudgetOutputSchema,
+	type SetDefaultBudgetOutput,
+	ClearCacheOutputSchema,
+	type ClearCacheOutput,
+	SetOutputFormatOutputSchema,
+	type SetOutputFormatOutput,
+	DiagnosticInfoOutputSchema,
+	type DiagnosticInfoOutput,
+	GetBudgetOutputSchema,
+	type GetBudgetOutput,
+} from "./utilityOutputs.js";
 
 // Nested schemas that may be useful independently
 export {
-  UserSchema,
-  DateFormatSchema,
-  CurrencyFormatSchema,
-  BudgetDetailSchema,
-  ServerInfoSchema,
-  MemoryInfoSchema,
-  EnvironmentInfoSchema,
-  CacheInfoSchema,
-  DeltaInfoSchema,
-} from './utilityOutputs.js';
+	UserSchema,
+	DateFormatSchema,
+	CurrencyFormatSchema,
+	BudgetDetailSchema,
+	ServerInfoSchema,
+	MemoryInfoSchema,
+	EnvironmentInfoSchema,
+	CacheInfoSchema,
+	DeltaInfoSchema,
+} from "./utilityOutputs.js";
 
 // ============================================================================
 // BUDGET TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ListBudgetsOutputSchema,
-  type ListBudgetsOutput,
-  BudgetSummarySchema,
-  type BudgetSummary,
-} from './budgetOutputs.js';
+	ListBudgetsOutputSchema,
+	type ListBudgetsOutput,
+	BudgetSummarySchema,
+	type BudgetSummary,
+} from "./budgetOutputs.js";
 
 // ============================================================================
 // ACCOUNT TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ListAccountsOutputSchema,
-  type ListAccountsOutput,
-  GetAccountOutputSchema,
-  type GetAccountOutput,
-  AccountSchema,
-  type Account,
-} from './accountOutputs.js';
+	ListAccountsOutputSchema,
+	type ListAccountsOutput,
+	GetAccountOutputSchema,
+	type GetAccountOutput,
+	AccountSchema,
+	type Account,
+} from "./accountOutputs.js";
 
 // ============================================================================
 // TRANSACTION TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ListTransactionsOutputSchema,
-  type ListTransactionsOutput,
-  GetTransactionOutputSchema,
-  type GetTransactionOutput,
-  TransactionSchema,
-  type Transaction,
-  TransactionPreviewSchema,
-  type TransactionPreview,
-} from './transactionOutputs.js';
+	ListTransactionsOutputSchema,
+	type ListTransactionsOutput,
+	GetTransactionOutputSchema,
+	type GetTransactionOutput,
+	TransactionSchema,
+	type Transaction,
+	TransactionPreviewSchema,
+	type TransactionPreview,
+} from "./transactionOutputs.js";
 
 // ============================================================================
 // CATEGORY TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ListCategoriesOutputSchema,
-  type ListCategoriesOutput,
-  GetCategoryOutputSchema,
-  type GetCategoryOutput,
-  CategorySchema,
-  type Category,
-  CategoryGroupSchema,
-  type CategoryGroup,
-} from './categoryOutputs.js';
+	ListCategoriesOutputSchema,
+	type ListCategoriesOutput,
+	GetCategoryOutputSchema,
+	type GetCategoryOutput,
+	CategorySchema,
+	type Category,
+	CategoryGroupSchema,
+	type CategoryGroup,
+} from "./categoryOutputs.js";
 
 // ============================================================================
 // PAYEE TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ListPayeesOutputSchema,
-  type ListPayeesOutput,
-  GetPayeeOutputSchema,
-  type GetPayeeOutput,
-  PayeeSchema,
-  type Payee,
-} from './payeeOutputs.js';
+	ListPayeesOutputSchema,
+	type ListPayeesOutput,
+	GetPayeeOutputSchema,
+	type GetPayeeOutput,
+	PayeeSchema,
+	type Payee,
+} from "./payeeOutputs.js";
 
 // ============================================================================
 // MONTH TOOL OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  GetMonthOutputSchema,
-  type GetMonthOutput,
-  ListMonthsOutputSchema,
-  type ListMonthsOutput,
-  MonthDetailSchema,
-  type MonthDetail,
-  MonthSummarySchema,
-  type MonthSummary,
-  MonthCategorySchema,
-  type MonthCategory,
-} from './monthOutputs.js';
+	GetMonthOutputSchema,
+	type GetMonthOutput,
+	ListMonthsOutputSchema,
+	type ListMonthsOutput,
+	MonthDetailSchema,
+	type MonthDetail,
+	MonthSummarySchema,
+	type MonthSummary,
+	MonthCategorySchema,
+	type MonthCategory,
+} from "./monthOutputs.js";
 
 // ============================================================================
 // TRANSACTION MUTATION OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  CreateTransactionOutputSchema,
-  type CreateTransactionOutput,
-  CreateTransactionsOutputSchema,
-  type CreateTransactionsOutput,
-  UpdateTransactionOutputSchema,
-  type UpdateTransactionOutput,
-  UpdateTransactionsOutputSchema,
-  type UpdateTransactionsOutput,
-  DeleteTransactionOutputSchema,
-  type DeleteTransactionOutput,
-  CreateReceiptSplitTransactionOutputSchema,
-  type CreateReceiptSplitTransactionOutput,
-  CreateAccountOutputSchema,
-  type CreateAccountOutput,
-  UpdateCategoryOutputSchema,
-  type UpdateCategoryOutput,
-} from './transactionMutationOutputs.js';
+	CreateTransactionOutputSchema,
+	type CreateTransactionOutput,
+	CreateTransactionsOutputSchema,
+	type CreateTransactionsOutput,
+	UpdateTransactionOutputSchema,
+	type UpdateTransactionOutput,
+	UpdateTransactionsOutputSchema,
+	type UpdateTransactionsOutput,
+	DeleteTransactionOutputSchema,
+	type DeleteTransactionOutput,
+	CreateReceiptSplitTransactionOutputSchema,
+	type CreateReceiptSplitTransactionOutput,
+	CreateAccountOutputSchema,
+	type CreateAccountOutput,
+	UpdateCategoryOutputSchema,
+	type UpdateCategoryOutput,
+} from "./transactionMutationOutputs.js";
 
 // Nested schemas for transaction mutations
 export {
-  SubtransactionSchema,
-  type Subtransaction,
-  SubtransactionPreviewSchema,
-  type SubtransactionPreview,
-  TransactionWithBalanceSchema,
-  type TransactionWithBalance,
-  TransactionDryRunPreviewSchema,
-  type TransactionDryRunPreview,
-  ReceiptItemSchema,
-  type ReceiptItem,
-  ReceiptCategoryBreakdownSchema,
-  type ReceiptCategoryBreakdown,
-  ReceiptSummarySchema,
-  type ReceiptSummary,
-  BulkOperationSummarySchema,
-  type BulkOperationSummary,
-  BulkResultSchema,
-  type BulkResult,
-  DryRunPreviewItemSchema,
-  type DryRunPreviewItem,
-  DryRunWarningSchema,
-  type DryRunWarning,
-} from './transactionMutationOutputs.js';
+	SubtransactionSchema,
+	type Subtransaction,
+	SubtransactionPreviewSchema,
+	type SubtransactionPreview,
+	TransactionWithBalanceSchema,
+	type TransactionWithBalance,
+	TransactionDryRunPreviewSchema,
+	type TransactionDryRunPreview,
+	ReceiptItemSchema,
+	type ReceiptItem,
+	ReceiptCategoryBreakdownSchema,
+	type ReceiptCategoryBreakdown,
+	ReceiptSummarySchema,
+	type ReceiptSummary,
+	BulkOperationSummarySchema,
+	type BulkOperationSummary,
+	BulkResultSchema,
+	type BulkResult,
+	DryRunPreviewItemSchema,
+	type DryRunPreviewItem,
+	DryRunWarningSchema,
+	type DryRunWarning,
+} from "./transactionMutationOutputs.js";
 
 // ============================================================================
 // RECONCILIATION OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  ReconcileAccountOutputSchema,
-  type ReconcileAccountOutput,
-} from './reconciliationOutputs.js';
+	ReconcileAccountOutputSchema,
+	type ReconcileAccountOutput,
+} from "./reconciliationOutputs.js";
 
 // Nested schemas for reconciliation
 export {
-  MoneyValueSchema,
-  type MoneyValue,
-  BankTransactionSchema,
-  type BankTransaction,
-  YNABTransactionSimpleSchema,
-  type YNABTransactionSimple,
-  MatchCandidateSchema,
-  type MatchCandidate,
-  TransactionMatchSchema,
-  type TransactionMatch,
-  BalanceInfoSchema,
-  type BalanceInfo,
-  ReconciliationSummarySchema,
-  type ReconciliationSummary,
-  ReconciliationInsightSchema,
-  type ReconciliationInsight,
-  ActionableRecommendationSchema,
-  type ActionableRecommendation,
-  ExecutionResultSchema,
-  type ExecutionResult,
-  AuditMetadataSchema,
-  type AuditMetadata,
-} from './reconciliationOutputs.js';
+	MoneyValueSchema,
+	type MoneyValue,
+	BankTransactionSchema,
+	type BankTransaction,
+	YNABTransactionSimpleSchema,
+	type YNABTransactionSimple,
+	MatchCandidateSchema,
+	type MatchCandidate,
+	TransactionMatchSchema,
+	type TransactionMatch,
+	BalanceInfoSchema,
+	type BalanceInfo,
+	ReconciliationSummarySchema,
+	type ReconciliationSummary,
+	ReconciliationInsightSchema,
+	type ReconciliationInsight,
+	ActionableRecommendationSchema,
+	type ActionableRecommendation,
+	ExecutionResultSchema,
+	type ExecutionResult,
+	AuditMetadataSchema,
+	type AuditMetadata,
+} from "./reconciliationOutputs.js";
 
 // ============================================================================
 // COMPARISON AND EXPORT OUTPUT SCHEMAS
 // ============================================================================
 
 export {
-  CompareTransactionsOutputSchema,
-  type CompareTransactionsOutput,
-  ExportTransactionsOutputSchema,
-  type ExportTransactionsOutput,
-} from './comparisonOutputs.js';
+	CompareTransactionsOutputSchema,
+	type CompareTransactionsOutput,
+	ExportTransactionsOutputSchema,
+	type ExportTransactionsOutput,
+} from "./comparisonOutputs.js";
 
 /**
  * Nested schemas for comparison and export.
@@ -246,22 +246,22 @@ export {
  * ExportTransactionsOutputSchema) for stable contracts.
  */
 export {
-  /** @internal - Used during matching algorithm, not part of public output */
-  BankTransactionComparisonSchema,
-  type BankTransactionComparison,
-  /** @internal - Used during matching algorithm, not part of public output */
-  YNABTransactionComparisonSchema,
-  type YNABTransactionComparison,
-  /** @internal - Used during matching algorithm, not part of public output */
-  TransactionMatchComparisonSchema,
-  type TransactionMatchComparison,
-  // Public contracts below - part of stable tool output
-  ComparisonParametersSchema,
-  type ComparisonParameters,
-  DateRangeSchema,
-  type DateRange,
-  ExportInfoSchema,
-  type ExportInfo,
-  ExportedTransactionSchema,
-  type ExportedTransaction,
-} from './comparisonOutputs.js';
+	/** @internal - Used during matching algorithm, not part of public output */
+	BankTransactionComparisonSchema,
+	type BankTransactionComparison,
+	/** @internal - Used during matching algorithm, not part of public output */
+	YNABTransactionComparisonSchema,
+	type YNABTransactionComparison,
+	/** @internal - Used during matching algorithm, not part of public output */
+	TransactionMatchComparisonSchema,
+	type TransactionMatchComparison,
+	// Public contracts below - part of stable tool output
+	ComparisonParametersSchema,
+	type ComparisonParameters,
+	DateRangeSchema,
+	type DateRange,
+	ExportInfoSchema,
+	type ExportInfo,
+	ExportedTransactionSchema,
+	type ExportedTransaction,
+} from "./comparisonOutputs.js";

package/src/tools/schemas/outputs/monthOutputs.ts

@@ -79,8 +79,8 @@
  * ```
  */
 
-import { z } from 'zod/v4';
-import { CacheMetadataSchema } from '../shared/commonOutputs.js';
+import { z } from "zod/v4";
+import { CacheMetadataSchema } from "../shared/commonOutputs.js";
 
 /**
  * Schema for a category within month data.
@@ -89,65 +89,77 @@ import { CacheMetadataSchema } from '../shared/commonOutputs.js';
  * specific to month budget data.
  */
 export const MonthCategorySchema = z.object({
-  /** Unique identifier for the category */
-  id: z.string().describe('Category ID'),
+	/** Unique identifier for the category */
+	id: z.string().describe("Category ID"),
 
-  /** Category group ID this category belongs to */
-  category_group_id: z.string().describe('Category group ID'),
+	/** Category group ID this category belongs to */
+	category_group_id: z.string().describe("Category group ID"),
 
-  /** Category group name (optional) */
-  category_group_name: z.string().optional().describe('Category group name'),
+	/** Category group name (optional) */
+	category_group_name: z.string().optional().describe("Category group name"),
 
-  /** Human-readable category name */
-  name: z.string().describe('Category name'),
+	/** Human-readable category name */
+	name: z.string().describe("Category name"),
 
-  /** Whether category is hidden */
-  hidden: z.boolean().describe('Hidden flag'),
+	/** Whether category is hidden */
+	hidden: z.boolean().describe("Hidden flag"),
 
-  /** Original category group ID if moved (optional) */
-  original_category_group_id: z.string().optional().describe('Original category group ID'),
+	/** Original category group ID if moved (optional) */
+	original_category_group_id: z
+		.string()
+		.optional()
+		.describe("Original category group ID"),
 
-  /** Optional category note */
-  note: z.string().optional().describe('Category note'),
+	/** Optional category note */
+	note: z.string().optional().describe("Category note"),
 
-  /** Budgeted amount in dollars */
-  budgeted: z.number().describe('Budgeted amount in dollars'),
+	/** Budgeted amount in dollars */
+	budgeted: z.number().describe("Budgeted amount in dollars"),
 
-  /** Activity (spending) in dollars */
-  activity: z.number().describe('Activity in dollars'),
+	/** Activity (spending) in dollars */
+	activity: z.number().describe("Activity in dollars"),
 
-  /** Current balance in dollars */
-  balance: z.number().describe('Balance in dollars'),
+	/** Current balance in dollars */
+	balance: z.number().describe("Balance in dollars"),
 
-  /** Goal type (TB, TBD, MF, NEED, DEBT, optional) */
-  goal_type: z.string().optional().describe('Goal type'),
+	/** Goal type (TB, TBD, MF, NEED, DEBT, optional) */
+	goal_type: z.string().optional().describe("Goal type"),
 
-  /** Goal creation month (YYYY-MM-DD, optional) */
-  goal_creation_month: z.string().optional().describe('Goal creation month'),
+	/** Goal creation month (YYYY-MM-DD, optional) */
+	goal_creation_month: z.string().optional().describe("Goal creation month"),
 
-  /** Goal target amount in milliunits (optional) */
-  goal_target: z.number().optional().describe('Goal target in milliunits'),
+	/** Goal target amount in milliunits (optional) */
+	goal_target: z.number().optional().describe("Goal target in milliunits"),
 
-  /** Goal target month (YYYY-MM-DD, optional) */
-  goal_target_month: z.string().optional().describe('Goal target month'),
+	/** Goal target month (YYYY-MM-DD, optional) */
+	goal_target_month: z.string().optional().describe("Goal target month"),
 
-  /** Goal percentage complete (optional) */
-  goal_percentage_complete: z.number().optional().describe('Goal percentage complete'),
+	/** Goal percentage complete (optional) */
+	goal_percentage_complete: z
+		.number()
+		.optional()
+		.describe("Goal percentage complete"),
 
-  /** Goal months to budget (optional) */
-  goal_months_to_budget: z.number().optional().describe('Goal months to budget'),
+	/** Goal months to budget (optional) */
+	goal_months_to_budget: z
+		.number()
+		.optional()
+		.describe("Goal months to budget"),
 
-  /** Goal under funded amount (optional) */
-  goal_under_funded: z.number().optional().describe('Goal under funded amount'),
+	/** Goal under funded amount (optional) */
+	goal_under_funded: z.number().optional().describe("Goal under funded amount"),
 
-  /** Goal overall funded amount (optional) */
-  goal_overall_funded: z.number().optional().describe('Goal overall funded amount'),
+	/** Goal overall funded amount (optional) */
+	goal_overall_funded: z
+		.number()
+		.optional()
+		.describe("Goal overall funded amount"),
 
-  /** Goal overall left amount (optional) */
-  goal_overall_left: z.number().optional().describe('Goal overall left amount'),
+	/** Goal overall left amount (optional) */
+	goal_overall_left: z.number().optional().describe("Goal overall left amount"),
 
-  /** Whether category is deleted */
-  deleted: z.boolean().describe('Deleted flag'),
+	/** Whether category is deleted */
+	deleted: z.boolean().describe("Deleted flag"),
 });
 
 /**
@@ -156,32 +168,35 @@ export const MonthCategorySchema = z.object({
  * Used by get_month to return complete month details.
  */
 export const MonthDetailSchema = z.object({
-  /** Month identifier (YYYY-MM-DD format, first day of month) */
-  month: z.string().describe('Month identifier'),
+	/** Month identifier (YYYY-MM-DD format, first day of month) */
+	month: z.string().describe("Month identifier"),
 
-  /** Optional month note */
-  note: z.string().optional().describe('Month note'),
+	/** Optional month note */
+	note: z.string().optional().describe("Month note"),
 
-  /** Total income for the month in dollars */
-  income: z.number().describe('Income in dollars'),
+	/** Total income for the month in dollars */
+	income: z.number().describe("Income in dollars"),
 
-  /** Total budgeted for the month in dollars */
-  budgeted: z.number().describe('Budgeted amount in dollars'),
+	/** Total budgeted for the month in dollars */
+	budgeted: z.number().describe("Budgeted amount in dollars"),
 
-  /** Total activity (spending) for the month in dollars */
-  activity: z.number().describe('Activity in dollars'),
+	/** Total activity (spending) for the month in dollars */
+	activity: z.number().describe("Activity in dollars"),
 
-  /** Amount to be budgeted in dollars */
-  to_be_budgeted: z.number().describe('To be budgeted in dollars'),
+	/** Amount to be budgeted in dollars */
+	to_be_budgeted: z.number().describe("To be budgeted in dollars"),
 
-  /** Age of money in days (optional, can be null if insufficient history) */
-  age_of_money: z.number().nullish().describe('Age of money in days'),
+	/** Age of money in days (optional, can be null if insufficient history) */
+	age_of_money: z.number().nullish().describe("Age of money in days"),
 
-  /** Whether month is deleted */
-  deleted: z.boolean().describe('Deleted flag'),
+	/** Whether month is deleted */
+	deleted: z.boolean().describe("Deleted flag"),
 
-  /** Array of category data for this month (optional) */
-  categories: z.array(MonthCategorySchema).optional().describe('Categories for this month'),
+	/** Array of category data for this month (optional) */
+	categories: z
+		.array(MonthCategorySchema)
+		.optional()
+		.describe("Categories for this month"),
 });
 
 /**
@@ -190,29 +205,29 @@ export const MonthDetailSchema = z.object({
  * Used by list_months to return month summaries without category details.
  */
 export const MonthSummarySchema = z.object({
-  /** Month identifier (YYYY-MM-DD format, first day of month) */
-  month: z.string().describe('Month identifier'),
+	/** Month identifier (YYYY-MM-DD format, first day of month) */
+	month: z.string().describe("Month identifier"),
 
-  /** Optional month note */
-  note: z.string().optional().describe('Month note'),
+	/** Optional month note */
+	note: z.string().optional().describe("Month note"),
 
-  /** Total income for the month in dollars */
-  income: z.number().describe('Income in dollars'),
+	/** Total income for the month in dollars */
+	income: z.number().describe("Income in dollars"),
 
-  /** Total budgeted for the month in dollars */
-  budgeted: z.number().describe('Budgeted amount in dollars'),
+	/** Total budgeted for the month in dollars */
+	budgeted: z.number().describe("Budgeted amount in dollars"),
 
-  /** Total activity (spending) for the month in dollars */
-  activity: z.number().describe('Activity in dollars'),
+	/** Total activity (spending) for the month in dollars */
+	activity: z.number().describe("Activity in dollars"),
 
-  /** Amount to be budgeted in dollars */
-  to_be_budgeted: z.number().describe('To be budgeted in dollars'),
+	/** Amount to be budgeted in dollars */
+	to_be_budgeted: z.number().describe("To be budgeted in dollars"),
 
-  /** Age of money in days (optional, can be null if insufficient history) */
-  age_of_money: z.number().nullish().describe('Age of money in days'),
+	/** Age of money in days (optional, can be null if insufficient history) */
+	age_of_money: z.number().nullish().describe("Age of money in days"),
 
-  /** Whether month is deleted */
-  deleted: z.boolean().describe('Deleted flag'),
+	/** Whether month is deleted */
+	deleted: z.boolean().describe("Deleted flag"),
 });
 
 /**
@@ -221,8 +236,8 @@ export const MonthSummarySchema = z.object({
  * Returns detailed month data including categories with cache metadata.
  */
 export const GetMonthOutputSchema = CacheMetadataSchema.extend({
-  /** Detailed month object including categories */
-  month: MonthDetailSchema.describe('Month details'),
+	/** Detailed month object including categories */
+	month: MonthDetailSchema.describe("Month details"),
 });
 
 /**
@@ -231,8 +246,8 @@ export const GetMonthOutputSchema = CacheMetadataSchema.extend({
  * Returns summary of all months without category details.
  */
 export const ListMonthsOutputSchema = CacheMetadataSchema.extend({
-  /** Array of month summary objects */
-  months: z.array(MonthSummarySchema).describe('List of months'),
+	/** Array of month summary objects */
+	months: z.array(MonthSummarySchema).describe("List of months"),
 });
 
 // Export inferred TypeScript types