@firela/api-types 0.0.0-canary.614ff760 → 0.0.0-canary.6a42fd0e

package/src/generated/types.gen.ts

@@ -316,6 +316,53 @@ export type RegionsMetadataResponseDto = {
   regions: Array<RegionInfoDto>;
 };
 
+export type CostSpecDto = {
+  /**
+   * Cost specification mode (mirrors engine CostSpec)
+   */
+  mode: 'per-unit' | 'total' | 'date' | 'label' | 'auto';
+  /**
+   * Per-unit cost (required when mode is "per-unit")
+   */
+  numberPerUnit?: string;
+  /**
+   * Total cost for all units (required when mode is "total")
+   */
+  totalNumber?: string;
+  /**
+   * Cost currency (required in all modes)
+   */
+  currency: string;
+  /**
+   * Lot acquisition date, ISO 8601 (required when mode is "date")
+   */
+  date?: string;
+  /**
+   * Lot label (required when mode is "label"; optional tag in buy modes)
+   */
+  label?: string;
+  /**
+   * Merge lots for AVERAGE booking (mode: auto)
+   */
+  merge?: boolean;
+};
+
+/**
+ * Cost specification mode (mirrors engine CostSpec)
+ */
+export type mode = 'per-unit' | 'total' | 'date' | 'label' | 'auto';
+
+export type AmountDto = {
+  /**
+   * Amount as decimal string (max 15 integer + 15 decimal digits)
+   */
+  number: string;
+  /**
+   * Currency/commodity code
+   */
+  currency: string;
+};
+
 export type CreatePostingDto = {
   /**
    * Account name in Beancount format (must start with uppercase, colon-separated)
@@ -335,6 +382,14 @@ export type CreatePostingDto = {
   meta?: {
     [key: string]: unknown;
   };
+  /**
+   * Cost basis (Beancount `{...}`). Maps to engine costSpec. Required for commodity holdings so they carry a monetary weight that can balance.
+   */
+  cost?: CostSpecDto;
+  /**
+   * Price annotation (Beancount `@...`). Maps to engine price. Used for valuation; cost takes priority for balance weight.
+   */
+  price?: AmountDto;
 };
 
 export type CreateTransactionDto = {
@@ -387,6 +442,25 @@ export type CreateTransactionDto = {
  */
 export type flag = '*' | '!';
 
+export type CostDetailDto = {
+  /**
+   * Per-unit cost basis (mirrors engine Cost.number)
+   */
+  number?: string;
+  /**
+   * Cost currency
+   */
+  currency?: string;
+  /**
+   * Lot acquisition date (ISO yyyy-mm-dd)
+   */
+  date?: string;
+  /**
+   * Lot label
+   */
+  label?: string;
+};
+
 export type PostingResponseDto = {
   /**
    * Account name
@@ -400,6 +474,10 @@ export type PostingResponseDto = {
    * Currency
    */
   currency?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
 };
 
 export type RecurringSuggestionDto = {
@@ -620,9 +698,9 @@ export type PostingDetailDto = {
    */
   accountId: string;
   /**
-   * Account name
+   * Fully-qualified Beancount account path
    */
-  accountName: string;
+  account: string;
   /**
    * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
    */
@@ -643,6 +721,10 @@ export type PostingDetailDto = {
    * Cost date
    */
   costDate?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
   /**
    * Price amount
    */
@@ -766,6 +848,51 @@ export type flag2 =
  */
 export type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
 
+export type BalanceByCurrencyDto = {
+  /**
+   * ISO 4217 currency code
+   */
+  currency: string;
+  /**
+   * Balance amount
+   */
+  balance: string;
+};
+
+export type ExchangeRateWarningDto = {
+  /**
+   * Warning type
+   */
+  type: string;
+  /**
+   * Currency without exchange rate
+   */
+  currency: string;
+  /**
+   * Total amount affected
+   */
+  totalAmount: string;
+};
+
+export type TransactionListSummaryDto = {
+  /**
+   * Partial converted total in base currency (rated currencies only, raw Beancount sign). When warnings is non-empty this excludes currencies missing an FX rate; may be "0.00" if ALL non-base currencies lack a rate. Converted at the dateTo (or current) available rate.
+   */
+  totalAmount: string;
+  /**
+   * Base currency (ISO 4217)
+   */
+  currency: string;
+  /**
+   * Raw (unconverted) balance per currency
+   */
+  balanceByCurrency: Array<BalanceByCurrencyDto>;
+  /**
+   * Currencies missing an FX rate (omitted when empty)
+   */
+  warnings?: Array<ExchangeRateWarningDto>;
+};
+
 export type TransactionListResponseDto = {
   /**
    * List of transactions
@@ -783,6 +910,10 @@ export type TransactionListResponseDto = {
    * Number of items skipped
    */
   offset: number;
+  /**
+   * Amount summary for the full filtered set (#514). Present only when the request has a single account OR category viewpoint; omitted for search-only / plain-list / dual-perspective requests.
+   */
+  summary?: TransactionListSummaryDto;
 };
 
 export type TagSuggestionDto = {
@@ -1242,17 +1373,17 @@ export type ResolveResultDto = {
     [key: string]: string;
   };
   /**
-   * Resolution ID for undo
+   * Resolution ID for undo. Absent when the resolver rejected the decision (review stayed PENDING).
    */
-  resolutionId: string;
+  resolutionId?: string;
   /**
    * Whether this decision can be undone
    */
-  canUndo: boolean;
+  canUndo?: boolean;
   /**
    * Deadline for undo (24h from resolution)
    */
-  undoDeadline: string;
+  undoDeadline?: string;
   /**
    * Rule ID if learning was triggered (ACCEPT_AND_LEARN actions). Use this to deep-link to the rule management page.
    */
@@ -1835,6 +1966,108 @@ export type UpdateCommodityDto = {
   };
 };
 
+export type CreateBeanPriceDto = {
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., CNY, EUR)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Metadata (validated by Zod schema, max field lengths enforced)
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
+export type PriceResponseDto = {
+  /**
+   * Unique identifier
+   */
+  id: string;
+  /**
+   * User ID (owner of the price)
+   */
+  userId: string;
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format). Represents the date this price was valid.
+   */
+  date: string;
+  /**
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   */
+  meta: {
+    [key: string]: unknown;
+  };
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
+  /**
+   * List of prices
+   */
+  items: Array<PriceResponseDto>;
+  /**
+   * Total number of prices
+   */
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
+  /**
+   * Currency being priced
+   */
+  currency?: string;
+  /**
+   * Quote currency (pricing currency)
+   */
+  quoteCurrency?: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec)
+   */
+  amount?: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date?: string;
+  /**
+   * Metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
 export type CreateRecurringRuleDto = {
   /**
    * Rule name (unique per user)
@@ -2947,103 +3180,317 @@ export type UpdatePropertyDto = {
   value: string;
 };
 
-export type FileImportDto = {
+export type CreateBeanEventDto = {
   /**
-   * Bill file to import (CSV, PDF, OFX, etc.)
+   * Life event date (ISO 8601)
    */
-  file: Blob | File;
-};
-
-export type ImportErrorDto = {
+  date: string;
   /**
-   * Index of failed transaction in the file
+   * Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer
    */
-  index: number;
+  type: string;
   /**
-   * Error message
+   * Life event description. Empty string is a VALID value (distinct from absence).
    */
-  error: string;
+  description: string;
+  /**
+   * Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
 };
 
-export type ReviewItemPreviewDto = {
+export type EventResponseDto = {
   /**
-   * Index in the import batch (for tracking)
+   * Unique identifier
    */
-  index: number;
+  id: string;
   /**
-   * Transaction date (ISO format)
+   * User ID (owner of the life event)
    */
-  date: string;
+  userId: string;
   /**
-   * Transaction amount (absolute value)
+   * Life event date (ISO 8601 format)
    */
-  amount?: number;
+  date: string;
   /**
-   * Currency code
+   * Life event type (user-defined, e.g., "employer", "location")
    */
-  currency?: string;
+  type: string;
   /**
-   * Transaction narration/description
+   * Life event description. May be an empty string (a valid value distinct from absence).
    */
-  narration: string;
+  description: string;
   /**
-   * Payee name
+   * Product-side metadata (free-form JSON)
    */
-  payee?: string;
+  meta: {
+    [key: string]: unknown;
+  };
   /**
-   * Inferred category from rule matching
+   * Creation timestamp
    */
-  category?: string;
+  createdAt: string;
   /**
-   * Confidence score for the match (0-1)
+   * Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.
    */
-  confidence?: number;
+  updatedAt: string;
+};
+
+export type EventListResponseDto = {
   /**
-   * Type of branch requiring review
+   * List of life events
    */
-  branchType?:
-    | 'DUPLICATE'
-    | 'PAYEE_MATCH'
-    | 'RULE_MATCH'
-    | 'ACCOUNT_VALIDATION'
-    | 'PIPELINE_ERROR';
+  items: Array<EventResponseDto>;
   /**
-   * Human-readable reasons for requiring review
+   * Total number of life events matching the query
    */
-  reasons?: Array<string>;
+  total: number;
 };
 
-/**
- * Type of branch requiring review
- */
-export type branchType =
-  | 'DUPLICATE'
-  | 'PAYEE_MATCH'
-  | 'RULE_MATCH'
-  | 'ACCOUNT_VALIDATION'
-  | 'PIPELINE_ERROR';
-
-export type ImportResultDto = {
+export type UpdateBeanEventDto = {
   /**
-   * Number of successfully imported transactions
+   * Life event date (ISO 8601)
    */
-  imported: number;
+  date?: string;
   /**
-   * Number of failed transactions
+   * Life event type (user-defined)
    */
-  failed: number;
+  type?: string;
   /**
-   * Number of skipped transactions (high confidence duplicates, auto-skipped)
+   * Life event description. Empty string is a VALID value (distinct from absence).
    */
-  skipped: number;
+  description?: string;
   /**
-   * Number of transactions pending review (medium confidence duplicates)
+   * Product-side metadata (free-form JSON)
    */
-  pendingReview: number;
+  meta?: {
+    [key: string]: unknown;
+  };
+};
+
+export type ActualBalanceDto = {
   /**
-   * Array of error details for failed transactions
+   * Actual balance amount as a decimal string (preserves precision for tolerance inference).
    */
-  errors: Array<ImportErrorDto>;
+  amount: string;
+  /**
+   * Currency code (ISO 4217 or commodity ticker).
+   */
+  ccy: string;
+};
+
+export type ComputeReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+};
+
+export type ReconciliationComputeResultDto = {
+  accountId: string;
+  asOfDate: string;
+  /**
+   * System-computed book balance (decimal string).
+   */
+  bookBalance: string;
+  /**
+   * User-entered actual balance (decimal string).
+   */
+  actualBalance: string;
+  currency: string;
+  /**
+   * Diff = book − actual (decimal string).
+   */
+  diff: string;
+  /**
+   * Applied tolerance (decimal string).
+   */
+  tolerance: string;
+  /**
+   * true when |diff| ≤ tolerance.
+   */
+  withinTolerance: boolean;
+  /**
+   * Suggested next action: assert when within tolerance, pad otherwise.
+   */
+  suggestedAction: 'assert' | 'pad';
+};
+
+/**
+ * Suggested next action: assert when within tolerance, pad otherwise.
+ */
+export type suggestedAction = 'assert' | 'pad';
+
+export type AssertReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+  /**
+   * Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).
+   */
+  tolerance?: string;
+};
+
+export type ReconciliationRecordDto = {
+  id: string;
+  accountId: string;
+  date: string;
+  /**
+   * Asserted (actual) amount.
+   */
+  amount: string;
+  currency: string;
+  tolerance?: string;
+  /**
+   * book − actual.
+   */
+  diffAmount?: string;
+  diffCurrency?: string;
+  createdAt: string;
+};
+
+export type PadReconciliationDto = {
+  /**
+   * BeanAccount id to reconcile.
+   */
+  accountId: string;
+  /**
+   * Assertion date (ISO 8601, e.g. "2026-07-24").
+   */
+  asOfDate: string;
+  /**
+   * Actual balance from the external statement.
+   */
+  actualBalance: ActualBalanceDto;
+  /**
+   * Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).
+   */
+  sourceAccount?: string;
+};
+
+export type PadResultDto = {
+  /**
+   * Created pad adjusting transaction id.
+   */
+  transactionId: string;
+};
+
+export type FileImportDto = {
+  /**
+   * Bill file to import (CSV, PDF, OFX, etc.)
+   */
+  file: Blob | File;
+};
+
+export type ImportErrorDto = {
+  /**
+   * Index of failed transaction in the file
+   */
+  index: number;
+  /**
+   * Error message
+   */
+  error: string;
+};
+
+export type ReviewItemPreviewDto = {
+  /**
+   * Index in the import batch (for tracking)
+   */
+  index: number;
+  /**
+   * Transaction date (ISO format)
+   */
+  date: string;
+  /**
+   * Transaction amount (absolute value)
+   */
+  amount?: number;
+  /**
+   * Currency code
+   */
+  currency?: string;
+  /**
+   * Transaction narration/description
+   */
+  narration: string;
+  /**
+   * Payee name
+   */
+  payee?: string;
+  /**
+   * Inferred category from rule matching
+   */
+  category?: string;
+  /**
+   * Confidence score for the match (0-1)
+   */
+  confidence?: number;
+  /**
+   * Type of branch requiring review
+   */
+  branchType?:
+    | 'DUPLICATE'
+    | 'PAYEE_MATCH'
+    | 'RULE_MATCH'
+    | 'ACCOUNT_VALIDATION'
+    | 'PIPELINE_ERROR';
+  /**
+   * Human-readable reasons for requiring review
+   */
+  reasons?: Array<string>;
+};
+
+/**
+ * Type of branch requiring review
+ */
+export type branchType =
+  | 'DUPLICATE'
+  | 'PAYEE_MATCH'
+  | 'RULE_MATCH'
+  | 'ACCOUNT_VALIDATION'
+  | 'PIPELINE_ERROR';
+
+export type ImportResultDto = {
+  /**
+   * Number of successfully imported transactions
+   */
+  imported: number;
+  /**
+   * Number of failed transactions
+   */
+  failed: number;
+  /**
+   * Number of skipped transactions (high confidence duplicates, auto-skipped)
+   */
+  skipped: number;
+  /**
+   * Number of transactions pending review (medium confidence duplicates)
+   */
+  pendingReview: number;
+  /**
+   * Array of error details for failed transactions
+   */
+  errors: Array<ImportErrorDto>;
   /**
    * Array of transactions pending review with preview data. Contains essential information for displaying in the import preview UI.
    */
@@ -3411,6 +3858,8 @@ export type SupportedProvidersResponseDto = {
 
 export type ParserTelemetryReportDto = unknown;
 
+export type UncoveredFormatMissDto = unknown;
+
 export type ProcessNlpDto = {
   /**
    * Natural language text describing a transaction (Chinese)
@@ -3986,17 +4435,6 @@ export type liabilitySubType = 'borrow' | 'repay';
  */
 export type equitySubType = 'opening' | 'adjustment';
 
-export type BalanceByCurrencyDto = {
-  /**
-   * ISO 4217 currency code
-   */
-  currency: string;
-  /**
-   * Balance amount
-   */
-  balance: string;
-};
-
 export type NetWorthByCurrencyDto = {
   /**
    * Net worth by currency
@@ -4037,21 +4475,6 @@ export type ConvertedNetWorthDto = {
   };
 };
 
-export type ExchangeRateWarningDto = {
-  /**
-   * Warning type
-   */
-  type: string;
-  /**
-   * Currency without exchange rate
-   */
-  currency: string;
-  /**
-   * Total amount affected
-   */
-  totalAmount: string;
-};
-
 export type NetWorthResponseDto = {
   /**
    * Total net worth (assets - liabilities, converted to base currency)
@@ -4116,6 +4539,10 @@ export type AccountItemDto = {
    * Currency code
    */
   currency: string;
+  /**
+   * FX-converted balance in base currency; omitted when not convertible
+   */
+  convertedBalance?: string;
 };
 
 export type PlatformGroupDto = {
@@ -4132,9 +4559,40 @@ export type PlatformGroupDto = {
    */
   accounts: Array<AccountItemDto>;
   /**
-   * Total balance across all accounts in platform
+   * FX-converted total balance in base currency
    */
   totalBalance: string;
+  /**
+   * Raw (unconverted) balances grouped by currency
+   */
+  balanceByCurrency: Array<BalanceByCurrencyDto>;
+  /**
+   * Converted balance in base currency (omitted when no currency is convertible)
+   */
+  convertedBalance?: string;
+  /**
+   * Share of the grand converted total (0-100); 0 when grand total is 0
+   */
+  sharePct: number;
+};
+
+export type AccountExchangeRateWarningDto = {
+  /**
+   * Warning type
+   */
+  type: string;
+  /**
+   * Currency without exchange rate
+   */
+  currency: string;
+  /**
+   * Affected account paths
+   */
+  accounts: Array<string>;
+  /**
+   * Total amount in this currency
+   */
+  totalAmount: string;
 };
 
 export type AccountsSummaryDto = {
@@ -4146,6 +4604,14 @@ export type AccountsSummaryDto = {
    * Total number of platforms
    */
   totalPlatforms: number;
+  /**
+   * Base currency for conversion
+   */
+  baseCurrency: string;
+  /**
+   * Per-account exchange rate warnings
+   */
+  warnings?: Array<AccountExchangeRateWarningDto>;
 };
 
 export type AccountsResponseDto = {
@@ -4180,6 +4646,10 @@ export type AccountItemWithAssetClassDto = {
    * Currency code
    */
   currency: string;
+  /**
+   * FX-converted balance in base currency; omitted when not convertible
+   */
+  convertedBalance?: string;
   /**
    * Asset class
    */
@@ -4196,8 +4666,21 @@ export type AccountItemWithAssetClassDto = {
    * Risk level
    */
   riskLevel?: string;
+  /**
+   * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
+   */
+  source?: 'USER_META' | 'FIAT_CURRENCY' | 'OPENBB_MAPPING' | 'FALLBACK';
 };
 
+/**
+ * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
+ */
+export type source2 =
+  | 'USER_META'
+  | 'FIAT_CURRENCY'
+  | 'OPENBB_MAPPING'
+  | 'FALLBACK';
+
 export type AssetClassGroupDto = {
   /**
    * Asset class name
@@ -4248,25 +4731,6 @@ export type assetClass =
   | 'REAL_ESTATE'
   | 'INDEX';
 
-export type AccountExchangeRateWarningDto = {
-  /**
-   * Warning type
-   */
-  type: string;
-  /**
-   * Currency without exchange rate
-   */
-  currency: string;
-  /**
-   * Affected account paths
-   */
-  accounts: Array<string>;
-  /**
-   * Total amount in this currency
-   */
-  totalAmount: string;
-};
-
 export type AssetClassSummaryDto = {
   /**
    * Total number of accounts
@@ -4284,6 +4748,12 @@ export type AssetClassSummaryDto = {
    * Exchange rate warnings
    */
   warnings?: Array<AccountExchangeRateWarningDto>;
+  /**
+   * ADR-0105 §4 fallback provenance stats (holding level only). valueRatio is the grey-area share of total converted value; count is the number of source=FALLBACK holdings.
+   */
+  fallback?: {
+    [key: string]: unknown;
+  };
 };
 
 export type AssetClassAccountsResponseDto = {
@@ -4295,6 +4765,56 @@ export type AssetClassAccountsResponseDto = {
    * Summary statistics
    */
   summary: AssetClassSummaryDto;
+  /**
+   * ADR-0105 §6 holding-level grey-area bucket (source=FALLBACK holdings peeled out of groups). Present only for groupBy=holdingAssetClass when FALLBACK holdings exist.
+   */
+  uncategorized?: AssetClassGroupDto;
+};
+
+export type HoldingAssetClassAccountSliceDto = {
+  /**
+   * Account ID
+   */
+  accountId: string;
+  /**
+   * Full account path
+   */
+  accountPath: string;
+  /**
+   * Currency of the holding with the largest converted base value; undefined when no holding is convertible
+   */
+  accountCurrency?: string;
+  /**
+   * Account's market value in base currency (Σ converted holdings; grey bucket included)
+   */
+  marketValueBase: string;
+  /**
+   * Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).
+   */
+  shareOfTotalPct: number;
+  /**
+   * Per-account asset-class breakdown
+   */
+  groups: Array<AssetClassGroupDto>;
+  /**
+   * Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)
+   */
+  uncategorized?: AssetClassGroupDto;
+  /**
+   * Every holding row for this account (account ID in each row’s `id` field)
+   */
+  holdings: Array<AccountItemWithAssetClassDto>;
+};
+
+export type HoldingAssetClassCrossAccountResponseDto = {
+  /**
+   * Merged cross-account holding aggregation
+   */
+  global: AssetClassAccountsResponseDto;
+  /**
+   * Per-account slices
+   */
+  byAccount: Array<HoldingAssetClassAccountSliceDto>;
 };
 
 export type CashFlowByCurrencyDto = {
@@ -4376,6 +4896,258 @@ export type CashFlowResponseDto = {
   warnings?: Array<ExchangeRateWarningDto>;
 };
 
+export type CategoryGroupDto = {
+  /**
+   * Functional category (account-path Group segment); regional and universal account paths merge under it
+   */
+  category: string;
+  /**
+   * Converted total for this category in base currency (expense amount when flow=expense, income amount when flow=income)
+   */
+  totalExpense: string;
+  /**
+   * Share of grand total (0-100); 0 when grand total is 0
+   */
+  sharePct: number;
+  /**
+   * Raw (unconverted) expense per currency
+   */
+  balanceByCurrency: Array<BalanceByCurrencyDto>;
+  /**
+   * Converted total in base currency (omitted when FX missing for all currencies in this category)
+   */
+  convertedBalance?: string;
+};
+
+export type ExpensesByCategorySummaryDto = {
+  /**
+   * Total across all categories, converted (convertible categories only); expense totals when flow=expense, income totals when flow=income
+   */
+  totalExpense: string;
+  /**
+   * Number of categories
+   */
+  categoryCount: number;
+};
+
+export type ExpensesByCategoryResponseDto = {
+  /**
+   * Period requested
+   */
+  period: string;
+  /**
+   * Base currency for converted values
+   */
+  baseCurrency: string;
+  /**
+   * Expense groups by functional category, sorted by converted total desc
+   */
+  groups: Array<CategoryGroupDto>;
+  /**
+   * Summary statistics
+   */
+  summary: ExpensesByCategorySummaryDto;
+  /**
+   * Exchange rate warnings (e.g. missing rate for a currency)
+   */
+  warnings?: Array<ExchangeRateWarningDto>;
+};
+
+export type MonetaryDto = {
+  /**
+   * Amount (Decimal string)
+   */
+  amount: string;
+  /**
+   * ISO 4217 currency
+   */
+  currency: string;
+  /**
+   * Converted to user base currency (Decimal string)
+   */
+  baseCcyEquivalent?: {
+    [key: string]: unknown;
+  } | null;
+};
+
+export type CurrentPriceDto = {
+  /**
+   * Price amount (Decimal string)
+   */
+  amount: string;
+  /**
+   * Price currency (ISO 4217)
+   */
+  currency: string;
+  /**
+   * Price date (ISO 8601)
+   */
+  date: string;
+  /**
+   * Price source
+   */
+  source: 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
+};
+
+/**
+ * Price source
+ */
+export type source3 = 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
+
+export type FxRateDto = {
+  from: string;
+  to: string;
+  /**
+   * FX rate (Decimal string)
+   */
+  rate: string;
+  /**
+   * Rate date (ISO 8601)
+   */
+  date: string;
+};
+
+export type HoldingPnlRowDto = {
+  /**
+   * Account UUID
+   */
+  accountId: string;
+  /**
+   * Full account path
+   */
+  accountPath: string;
+  /**
+   * Account settlement currency (ISO 4217), from cost currency
+   */
+  accountCcy?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Broker type derived from Platform.type
+   */
+  brokerType?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Commodity symbol
+   */
+  symbol: string;
+  /**
+   * Chart segment token (libs/common resolver)
+   */
+  chartToken: 'equity' | 'fund' | 'bond' | 'cash' | 'other';
+  assetClass: string;
+  assetSubClass?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Net held units (Decimal string)
+   */
+  units: string;
+  /**
+   * Average cost per unit; null when cost currency conflicts or no cost
+   */
+  averageCostPerUnit?: MonetaryDto | null;
+  /**
+   * Cost basis of held units
+   */
+  costBasis?: MonetaryDto | null;
+  /**
+   * Market value at asOf price
+   */
+  marketValue?: MonetaryDto | null;
+  /**
+   * Price used for market value
+   */
+  currentPrice?: CurrentPriceDto | null;
+  /**
+   * Unrealized P&L in base currency (Decimal string); null when any FX/price missing
+   */
+  unrealizedPnlBase?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Unrealized P&L % (Decimal string)
+   */
+  unrealizedPnlPct?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Historical FX rate applied to cost basis
+   */
+  costFxRate?: FxRateDto | null;
+  /**
+   * FX rate applied to market value
+   */
+  marketFxRate?: FxRateDto | null;
+  /**
+   * Share of invested assets % (Decimal string); only for invested chartTokens
+   */
+  pctOfInvestedAssets?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Cumulative realized P&L on sold lots (asOf-date cutoff); null when the method has no applicable sells, a sell lacks a price, or any required FX rate is missing (never-mix). When a sell spans multiple currencies (cross-currency sale), amount and currency reflect the base currency; baseCcyEquivalent is always the authoritative dual-FX figure
+   */
+  realizedPnl?: MonetaryDto | null;
+};
+
+/**
+ * Chart segment token (libs/common resolver)
+ */
+export type chartToken = 'equity' | 'fund' | 'bond' | 'cash' | 'other';
+
+export type HoldingPnlWarningDto = {
+  /**
+   * Warning type
+   */
+  type:
+    | 'MISSING_COST_FX_RATE'
+    | 'MISSING_MARKET_FX_RATE'
+    | 'MISSING_SALE_PRICE'
+    | 'MISSING_REALIZED_FX_RATE'
+    | 'OVERSOLD_LOTS'
+    | 'NO_PRICE'
+    | 'MIXED_COST_CURRENCY';
+  symbol?: {
+    [key: string]: unknown;
+  } | null;
+  accountId?: {
+    [key: string]: unknown;
+  } | null;
+  currency?: {
+    [key: string]: unknown;
+  } | null;
+};
+
+/**
+ * Warning type
+ */
+export type type4 =
+  | 'MISSING_COST_FX_RATE'
+  | 'MISSING_MARKET_FX_RATE'
+  | 'MISSING_SALE_PRICE'
+  | 'MISSING_REALIZED_FX_RATE'
+  | 'OVERSOLD_LOTS'
+  | 'NO_PRICE'
+  | 'MIXED_COST_CURRENCY';
+
+export type HoldingPnlResponseDto = {
+  asOfDate: string;
+  baseCurrency: string;
+  /**
+   * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
+   */
+  method: 'average' | 'FIFO';
+  rows: Array<HoldingPnlRowDto>;
+  warnings: Array<HoldingPnlWarningDto>;
+};
+
+/**
+ * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
+ */
+export type method = 'average' | 'FIFO';
+
 export type CurrencyBalanceDto = {
   /**
    * ISO 4217 currency code
@@ -4403,56 +5175,133 @@ export type TimeSeriesPointDto = {
     [key: string]: unknown;
   };
   /**
-   * Multi-currency breakdown for this point
+   * Total assets at this date (in base currency)
+   */
+  assets?: string;
+  /**
+   * Total liabilities at this date (in base currency)
+   */
+  liabilities?: string;
+  /**
+   * Multi-currency breakdown for this point
+   */
+  byCurrency?: Array<CurrencyBalanceDto>;
+};
+
+export type TrendSummaryDto = {
+  /**
+   * Value at start of period
+   */
+  startValue: string;
+  /**
+   * Value at end of period
+   */
+  endValue: string;
+  /**
+   * Total change over period
+   */
+  totalChange: string;
+  /**
+   * Total change percentage
+   */
+  totalChangePercentage: string;
+};
+
+export type MultiCurrencyPointDto = {
+  /**
+   * Date in YYYY-MM-DD format
+   */
+  date: string;
+  /**
+   * Balances by currency
+   */
+  byCurrency: Array<CurrencyBalanceDto>;
+};
+
+export type PortfolioTrendsResponseDto = {
+  /**
+   * Time series data points
+   */
+  series: Array<TimeSeriesPointDto>;
+  /**
+   * Period summary
+   */
+  summary: TrendSummaryDto;
+  /**
+   * Period requested
+   */
+  period: string;
+  /**
+   * Data granularity
+   */
+  granularity: string;
+  /**
+   * Base currency for converted values
+   */
+  currency: string;
+  /**
+   * Multi-currency time series (each point has currency breakdown)
+   */
+  byCurrency?: Array<MultiCurrencyPointDto>;
+  /**
+   * Exchange rate warnings
    */
-  byCurrency?: Array<CurrencyBalanceDto>;
+  warnings?: Array<ExchangeRateWarningDto>;
 };
 
-export type TrendSummaryDto = {
+export type CashFlowPointDto = {
   /**
-   * Value at start of period
+   * Month key (YYYY-MM)
    */
-  startValue: string;
+  month: string;
   /**
-   * Value at end of period
+   * Income in base currency (absolute, converted)
    */
-  endValue: string;
+  income: string;
   /**
-   * Total change over period
+   * Expense in base currency (absolute, converted)
    */
-  totalChange: string;
+  expense: string;
   /**
-   * Total change percentage
+   * netSavings = income − expense (savings positive)
    */
-  totalChangePercentage: string;
+  netSavings: string;
 };
 
-export type MultiCurrencyPointDto = {
+export type CashFlowTrendSummaryDto = {
   /**
-   * Date in YYYY-MM-DD format
+   * Total income across the period
    */
-  date: string;
+  totalIncome: string;
   /**
-   * Balances by currency
+   * Total expense across the period
    */
-  byCurrency: Array<CurrencyBalanceDto>;
+  totalExpense: string;
+  /**
+   * income − expense across the period
+   */
+  totalNetSavings: string;
+  /**
+   * totalNetSavings divided by the window length (N months, incl. zero-filled)
+   */
+  averageMonthlyNetSavings: string;
 };
 
-export type PortfolioTrendsResponseDto = {
+export type CashFlowTrendsResponseDto = {
   /**
-   * Time series data points
+   * Monthly cash-flow series (fixed N-month window, zero-filled)
    */
-  series: Array<TimeSeriesPointDto>;
+  series: Array<CashFlowPointDto>;
   /**
-   * Period summary
+   * Period totals
    */
-  summary: TrendSummaryDto;
+  summary: CashFlowTrendSummaryDto;
   /**
    * Period requested
    */
   period: string;
   /**
-   * Data granularity
+   * Data granularity (v1 returns month buckets)
    */
   granularity: string;
   /**
@@ -4460,11 +5309,7 @@ export type PortfolioTrendsResponseDto = {
    */
   currency: string;
   /**
-   * Multi-currency time series (each point has currency breakdown)
-   */
-  byCurrency?: Array<MultiCurrencyPointDto>;
-  /**
-   * Exchange rate warnings
+   * Exchange rate warnings (e.g. missing rate for a currency)
    */
   warnings?: Array<ExchangeRateWarningDto>;
 };
@@ -4655,6 +5500,10 @@ export type TransactionControllerListData = {
    * Filter by account ID (transactions with postings to this account)
    */
   accountId?: string;
+  /**
+   * Filter by ADR-0075 functional category (Group segment); matches any posting to an Expenses/Income account whose derived Group segment equals this value
+   */
+  category?: string;
   /**
    * Filter by start date (inclusive), format: YYYY-MM-DD
    */
@@ -5181,6 +6030,103 @@ export type CommodityControllerBulkCreateData = {
 
 export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
 
+export type PriceControllerCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateBeanPriceDto;
+};
+
+export type PriceControllerCreateResponse = PriceResponseDto;
+
+export type PriceControllerFindAllData = {
+  /**
+   * Filter by currency (e.g., BTC, AAPL, USD)
+   */
+  currency?: string;
+  /**
+   * Filter prices from this date (ISO 8601 format)
+   */
+  dateFrom?: string;
+  /**
+   * Filter prices to this date (ISO 8601 format)
+   */
+  dateTo?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Filter by quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency?: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Search term for currency or quoteCurrency (case-insensitive partial match)
+   */
+  search?: string;
+};
+
+export type PriceControllerFindAllResponse = PriceListResponseDto;
+
+export type PriceControllerFindOneData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerFindOneResponse = PriceResponseDto;
+
+export type PriceControllerUpdateData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanPriceDto;
+};
+
+export type PriceControllerUpdateResponse = PriceResponseDto;
+
+export type PriceControllerDeleteData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerDeleteResponse = void;
+
+export type PriceControllerBulkCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: Array<string>;
+};
+
+export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
+
 export type RecurringRuleControllerCreateData = {
   /**
    * Region code for tenant context
@@ -5646,6 +6592,149 @@ export type PropertyControllerDeleteData = {
 
 export type PropertyControllerDeleteResponse = void;
 
+export type EventControllerCreateData = {
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateBeanEventDto;
+};
+
+export type EventControllerCreateResponse = EventResponseDto;
+
+export type EventControllerFindAllData = {
+  /**
+   * Filter life events from this date (ISO 8601 format)
+   */
+  from?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Search term for description (case-insensitive partial match)
+   */
+  q?: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Filter life events to this date (ISO 8601 format)
+   */
+  to?: string;
+  /**
+   * Filter by life event type (exact match)
+   */
+  type?: string;
+};
+
+export type EventControllerFindAllResponse = EventListResponseDto;
+
+export type EventControllerFindOneData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type EventControllerFindOneResponse = EventResponseDto;
+
+export type EventControllerUpdateData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanEventDto;
+};
+
+export type EventControllerUpdateResponse = EventResponseDto;
+
+export type EventControllerDeleteData = {
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type EventControllerDeleteResponse = void;
+
+export type EventControllerGetSliceData = {
+  accountPattern: string;
+  granularity: string;
+  /**
+   * Life event ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context (decorative for life events)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type EventControllerGetSliceResponse = unknown;
+
+export type ReconciliationControllerComputeData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: ComputeReconciliationDto;
+};
+
+export type ReconciliationControllerComputeResponse =
+  ReconciliationComputeResultDto;
+
+export type ReconciliationControllerAssertData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: AssertReconciliationDto;
+};
+
+export type ReconciliationControllerAssertResponse = ReconciliationRecordDto;
+
+export type ReconciliationControllerPadData = {
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: PadReconciliationDto;
+};
+
+export type ReconciliationControllerPadResponse = PadResultDto;
+
+export type ReconciliationControllerHistoryData = {
+  /**
+   * BeanAccount id
+   */
+  accountId: string;
+  /**
+   * Region code for tenant context (decorative for reconciliation)
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ReconciliationControllerHistoryResponse =
+  Array<ReconciliationRecordDto>;
+
 export type ExportControllerExportBeancountResponse = unknown;
 
 export type FileImportControllerImportFileData = {
@@ -5794,9 +6883,9 @@ export type ProviderSyncControllerSyncData = {
     | 'beancount-direct'
     | 'parsed-bill';
   /**
-   * Region code
+   * Region code for tenant context
    */
-  region: unknown;
+  region: 'cn' | 'us' | 'de' | 'gb';
   requestBody: ProviderSyncDto;
 };
 
@@ -5835,6 +6924,29 @@ export type TelemetryControllerReportTelemetryData = {
 
 export type TelemetryControllerReportTelemetryResponse = unknown;
 
+export type TelemetryControllerReportCoverageMissData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UncoveredFormatMissDto;
+};
+
+export type TelemetryControllerReportCoverageMissResponse = unknown;
+
+export type TelemetryControllerGetCoverageMetricsData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Top-N uncovered formats (default 10)
+   */
+  topN?: unknown;
+};
+
+export type TelemetryControllerGetCoverageMetricsResponse = unknown;
+
 export type NlpControllerProcessNaturalLanguageData = {
   /**
    * Region code for tenant context
@@ -5888,6 +7000,10 @@ export type DashboardControllerGetNetWorthData = {
 export type DashboardControllerGetNetWorthResponse = NetWorthResponseDto;
 
 export type DashboardControllerGetAccountsData = {
+  /**
+   * Scope to a single account (only valid with groupBy=holdingAssetClass, ADR-0105 §6)
+   */
+  accountId?: string;
   /**
    * Date for balance calculation (ISO 8601 format)
    */
@@ -5895,29 +7011,77 @@ export type DashboardControllerGetAccountsData = {
   /**
    * Grouping strategy
    */
-  groupBy?: 'platform' | 'assetClass';
+  groupBy?:
+    | 'platform'
+    | 'assetClass'
+    | 'holdingAssetClass'
+    | 'holdingAssetClassByAccount';
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type DashboardControllerGetAccountsResponse =
+  | AccountsResponseDto
+  | AssetClassAccountsResponseDto
+  | HoldingAssetClassCrossAccountResponseDto;
+
+export type DashboardControllerGetCashFlowData = {
+  /**
+   * Period in YYYY-MM format
+   */
+  period: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type DashboardControllerGetCashFlowResponse = CashFlowResponseDto;
+
+export type DashboardControllerGetExpensesData = {
+  /**
+   * Account root to aggregate (expense → ^Expenses:, income → ^Income:)
+   */
+  flow?: 'expense' | 'income';
+  /**
+   * Grouping strategy
+   */
+  groupBy?: 'category';
+  /**
+   * Time window (1m = current calendar month)
+   */
+  period?: '1m' | '3m' | '6m' | '1y';
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type DashboardControllerGetAccountsResponse =
-  | AccountsResponseDto
-  | AssetClassAccountsResponseDto;
+export type DashboardControllerGetExpensesResponse =
+  ExpensesByCategoryResponseDto;
 
-export type DashboardControllerGetCashFlowData = {
+export type HoldingPnlControllerGetHoldingPnlData = {
   /**
-   * Period in YYYY-MM format
+   * Scope to a single account
    */
-  period: string;
+  accountId?: string;
+  /**
+   * As-of date (ISO 8601), defaults to today
+   */
+  asOf?: string;
+  /**
+   * Realized-P&L lot-matching method (default average). Does not affect the average-cost unrealized basis.
+   */
+  method?: 'FIFO' | 'average';
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type DashboardControllerGetCashFlowResponse = CashFlowResponseDto;
+export type HoldingPnlControllerGetHoldingPnlResponse = HoldingPnlResponseDto;
 
 export type ReportingControllerGetPortfolioTrendsData = {
   /**
@@ -5937,6 +7101,24 @@ export type ReportingControllerGetPortfolioTrendsData = {
 export type ReportingControllerGetPortfolioTrendsResponse =
   PortfolioTrendsResponseDto;
 
+export type ReportingControllerGetCashFlowTrendsData = {
+  /**
+   * Data granularity (accepted for API symmetry; v1 returns month buckets)
+   */
+  granularity?: 'day' | 'week' | 'month';
+  /**
+   * Time period
+   */
+  period?: '1m' | '3m' | '6m' | '1y';
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ReportingControllerGetCashFlowTrendsResponse =
+  CashFlowTrendsResponseDto;
+
 export type ReportingControllerGenerateSnapshotData = {
   /**
    * Region code for tenant context
@@ -6724,6 +7906,90 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/prices': {
+    post: {
+      req: PriceControllerCreateData;
+      res: {
+        /**
+         * Price created successfully
+         */
+        201: PriceResponseDto;
+        /**
+         * Currency or quoteCurrency commodity not found
+         */
+        404: unknown;
+        /**
+         * Price already exists for this currency pair and date
+         */
+        409: unknown;
+      };
+    };
+    get: {
+      req: PriceControllerFindAllData;
+      res: {
+        /**
+         * Prices retrieved successfully
+         */
+        200: PriceListResponseDto;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices/{id}': {
+    get: {
+      req: PriceControllerFindOneData;
+      res: {
+        /**
+         * Price retrieved successfully
+         */
+        200: PriceResponseDto;
+        /**
+         * Price not found
+         */
+        404: unknown;
+      };
+    };
+    put: {
+      req: PriceControllerUpdateData;
+      res: {
+        /**
+         * Price updated successfully
+         */
+        200: PriceResponseDto;
+        /**
+         * Price not found
+         */
+        404: unknown;
+        /**
+         * Updated price conflicts with existing price
+         */
+        409: unknown;
+      };
+    };
+    delete: {
+      req: PriceControllerDeleteData;
+      res: {
+        /**
+         * Price deleted successfully
+         */
+        204: void;
+        /**
+         * Price not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices/bulk': {
+    post: {
+      req: PriceControllerBulkCreateData;
+      res: {
+        /**
+         * Prices created successfully
+         */
+        201: Array<PriceResponseDto>;
+      };
+    };
+  };
   '/api/v1/{region}/bean/recurring-rules': {
     post: {
       req: RecurringRuleControllerCreateData;
@@ -7368,6 +8634,166 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/events': {
+    post: {
+      req: EventControllerCreateData;
+      res: {
+        /**
+         * Life event created successfully
+         */
+        201: EventResponseDto;
+        /**
+         * Life event already exists for this (userId, type, date) combination
+         */
+        409: unknown;
+      };
+    };
+    get: {
+      req: EventControllerFindAllData;
+      res: {
+        /**
+         * Life events retrieved successfully
+         */
+        200: EventListResponseDto;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/events/{id}': {
+    get: {
+      req: EventControllerFindOneData;
+      res: {
+        /**
+         * Life event retrieved successfully
+         */
+        200: EventResponseDto;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+      };
+    };
+    put: {
+      req: EventControllerUpdateData;
+      res: {
+        /**
+         * Life event updated successfully
+         */
+        200: EventResponseDto;
+        /**
+         * If-Match header is not a valid ISO 8601 date
+         */
+        400: unknown;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+        /**
+         * Updated event conflicts with an existing (userId, type, date) combination
+         */
+        409: unknown;
+        /**
+         * If-Match precondition failed (updatedAt mismatch)
+         */
+        412: unknown;
+      };
+    };
+    delete: {
+      req: EventControllerDeleteData;
+      res: {
+        /**
+         * Life event deleted successfully
+         */
+        204: void;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/events/{id}/slice': {
+    get: {
+      req: EventControllerGetSliceData;
+      res: {
+        /**
+         * Time-series sliced by the life event range
+         */
+        200: unknown;
+        /**
+         * accountPattern query param is empty
+         */
+        400: unknown;
+        /**
+         * Life event not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations': {
+    post: {
+      req: ReconciliationControllerComputeData;
+      res: {
+        /**
+         * Reconciliation preview
+         */
+        200: ReconciliationComputeResultDto;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations/assert': {
+    post: {
+      req: ReconciliationControllerAssertData;
+      res: {
+        /**
+         * Balance assertion recorded
+         */
+        201: ReconciliationRecordDto;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/reconciliations/pad': {
+    post: {
+      req: ReconciliationControllerPadData;
+      res: {
+        /**
+         * Pad adjusting entry generated
+         */
+        201: PadResultDto;
+        /**
+         * Book already within tolerance — no pad needed
+         */
+        400: unknown;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/accounts/{accountId}/reconciliations': {
+    get: {
+      req: ReconciliationControllerHistoryData;
+      res: {
+        /**
+         * Reconciliation history
+         */
+        200: Array<ReconciliationRecordDto>;
+        /**
+         * Account not found
+         */
+        404: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/export/beancount': {
     get: {
       res: {
@@ -7658,6 +9084,32 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/import/parser-coverage-miss': {
+    post: {
+      req: TelemetryControllerReportCoverageMissData;
+      res: {
+        /**
+         * Coverage miss report received
+         */
+        200: unknown;
+        /**
+         * Unauthorized
+         */
+        401: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/import/parser-coverage-metrics': {
+    get: {
+      req: TelemetryControllerGetCoverageMetricsData;
+      res: {
+        /**
+         * Coverage metrics
+         */
+        200: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/nlp/process': {
     post: {
       req: NlpControllerProcessNaturalLanguageData;
@@ -7727,7 +9179,10 @@ export type $OpenApiTs = {
         /**
          * Accounts retrieved successfully. Response type depends on groupBy parameter.
          */
-        200: AccountsResponseDto | AssetClassAccountsResponseDto;
+        200:
+          | AccountsResponseDto
+          | AssetClassAccountsResponseDto
+          | HoldingAssetClassCrossAccountResponseDto;
         /**
          * User not authenticated
          */
@@ -7754,6 +9209,44 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/dashboard/expenses': {
+    get: {
+      req: DashboardControllerGetExpensesData;
+      res: {
+        /**
+         * Expenses retrieved successfully
+         */
+        200: ExpensesByCategoryResponseDto;
+        /**
+         * Invalid groupBy or period
+         */
+        400: unknown;
+        /**
+         * User not authenticated
+         */
+        401: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/investment/holdings/pnl': {
+    get: {
+      req: HoldingPnlControllerGetHoldingPnlData;
+      res: {
+        /**
+         * Holding P&L retrieved successfully
+         */
+        200: HoldingPnlResponseDto;
+        /**
+         * Invalid asOf format/value/future date, invalid accountId format, or unsupported method
+         */
+        400: unknown;
+        /**
+         * User not authenticated
+         */
+        401: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/reporting/portfolio/trends': {
     get: {
       req: ReportingControllerGetPortfolioTrendsData;
@@ -7769,6 +9262,21 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/reporting/cash-flow/trends': {
+    get: {
+      req: ReportingControllerGetCashFlowTrendsData;
+      res: {
+        /**
+         * Cash-flow trends retrieved successfully
+         */
+        200: CashFlowTrendsResponseDto;
+        /**
+         * User not authenticated
+         */
+        401: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/reporting/snapshots/generate': {
     post: {
       req: ReportingControllerGenerateSnapshotData;