@firela/api-types 0.0.0-canary.d9762ea3 → 0.0.0-canary.da82874e

package/src/generated/types.gen.ts

@@ -36,6 +36,10 @@ export type CreateAccountDto = {
    * Icon identifier (overrides template)
    */
   icon?: string;
+  /**
+   * User-set display name override (omit/null = keep the derived name)
+   */
+  displayName?: string | null;
   /**
    * Open directive metadata (NOT an opening-balance amount — use the opening-balance endpoint)
    */
@@ -148,7 +152,7 @@ export type AccountResponseDto = {
    */
   isCustom: boolean;
   /**
-   * Localized display name (ADR-0114, read-time projection)
+   * Display name with precedence: user-set name (#762) > ADR-0114 localized name > path leaf (read-time projection)
    */
   displayName?: string;
   /**
@@ -164,9 +168,7 @@ export type AccountResponseDto = {
   /**
    * Platform ID (null if unbound)
    */
-  platformId?: {
-    [key: string]: unknown;
-  };
+  platformId?: string;
   /**
    * Platform details (populated if platformId is set)
    */
@@ -327,15 +329,27 @@ export type AccountStandardResponseDto = {
    */
   type: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
   /**
-   * Short localized display name
+   * Short display name. Universal rows project to the request locale (Accept-Language); regional rows keep the authored native name — mixed-language by design (ADR-0131 class P vs class A).
    */
   name?: string;
   /**
-   * Account description (stable semantics only)
+   * Authored market-language alternative names delivered verbatim (not localized copy, not xlf-managed, not locale-projected). Flat string[] per ADR-0129 D1; ADR-0131 class A.
+   */
+  aliases?: Array<string>;
+  /**
+   * Locale-projected search synonyms (e.g. the zh bank-card / debit-card everyday terms for the checking account). Pure-locale projection — absent when the locale has no seeded synonyms; English fallback rides the authored aliases field. Search-only vocabulary, not the NLP routing corpus (#698, ADR-0131 fourth-class adjudication).
+   */
+  searchTerms?: Array<string>;
+  /**
+   * Product denomination as a 3-letter ISO 4217 code, authored market data delivered verbatim (not localized, not xlf-managed). ADR-0131 class A. Absent = single-currency not asserted — consumers fall back to their own region currency (#714).
+   */
+  currency?: string;
+  /**
+   * Account description (stable semantics only). Mixed-language contract: universal rows project to the request locale via the accountDesc xlf axis with an en fallback (ADR-0131 class P, ADR-0132; unseeded locales falling back to English are expected); regional rows deliver the authored market language (ADR-0131 class A, verbatim, never xlf-managed).
    */
   description: string;
   /**
-   * Account tags for categorization
+   * Account tags for categorization — structured metadata delivered verbatim (not localized, not xlf-managed). ADR-0131 class A.
    */
   tags: Array<string>;
   /**
@@ -429,11 +443,18 @@ export type TemplateMetadataResponseDto = {
 export type RegionConfigDto = {
   currency: string;
   dateFormat: string;
+  /**
+   * Region-qualified BCP-47 tag whose region subtag equals the region's own ISO 3166-1 code (e.g., ja-JP, zh-CN, zh-HK)
+   */
   locale: string;
 };
 
 export type RegionInfoDto = {
   code: string;
+  /**
+   * Whether the region is open (has a ready regional account template). Not-yet-open regions still return identity metadata and degrade to the universal-only catalog.
+   */
+  open: boolean;
   displayName: string;
   parent?: string;
   chain: Array<string>;
@@ -595,7 +616,7 @@ export type PostingResponseDto = {
    */
   account: string;
   /**
-   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned. Carries the raw Beancount sign (credit-normal accounts such as Income post negative — the accounting truth, ADR-0126); renderers must not infer economic semantics from this sign.
    */
   units?: string;
   /**
@@ -830,7 +851,7 @@ export type PostingDetailDto = {
    */
   account: string;
   /**
-   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned. Carries the raw Beancount sign (credit-normal accounts such as Income post negative — the accounting truth, ADR-0126); renderers must not infer economic semantics from this sign.
    */
   units?: string;
   /**
@@ -976,6 +997,101 @@ export type flag2 =
  */
 export type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
 
+export type TransactionListItemDto = {
+  /**
+   * Transaction ID
+   */
+  id: string;
+  /**
+   * Transaction date
+   */
+  date: string;
+  /**
+   * Transaction flag
+   */
+  flag?:
+    | 'CLEARED'
+    | 'PENDING'
+    | 'PADDING'
+    | 'SUMMARIZE'
+    | 'TRANSFER'
+    | 'CONVERSIONS';
+  /**
+   * Custom flag (if not using standard flags)
+   */
+  customFlag?: string;
+  /**
+   * Payee name
+   */
+  payee?: string;
+  /**
+   * Transaction narration
+   */
+  narration: string;
+  /**
+   * Transaction tags
+   */
+  tags: Array<string>;
+  /**
+   * Transaction links
+   */
+  links: Array<string>;
+  /**
+   * Transaction metadata
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Transaction status
+   */
+  status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
+  /**
+   * Source type (free-form string from transaction metadata, e.g. import, api)
+   */
+  sourceType?: string;
+  /**
+   * Source platform (e.g., alipay, wechat)
+   */
+  sourcePlatform?: string;
+  /**
+   * Transaction postings
+   */
+  postings: Array<PostingDetailDto>;
+  /**
+   * Created at timestamp
+   */
+  createdAt: string;
+  /**
+   * Voided at timestamp (if voided)
+   */
+  voidedAt?: string;
+  /**
+   * User ID who voided this transaction
+   */
+  voidedBy?: string;
+  /**
+   * Correction reason (if voided or superseded)
+   */
+  correctionReason?: string;
+  /**
+   * ID of the transaction that supersedes this one (set when status=SUPERSEDED)
+   */
+  supersededBy?: string;
+  /**
+   * ID of the transaction this one corrected/replaced (back-link on the replacement)
+   */
+  originalTxn?: string;
+  /**
+   * Row amount under the request viewpoint (ADR-0126). Category viewpoint (category + flow): per-leg sign-normalized sum over the category account set (Income-root legs negated, Expenses-root identity) — positive under normal booking but NOT clamped (explicit negative expense legs and net-flip refund months stay negative). No viewpoint (plain list / search, no accountId): wallet money-flow net = raw-sign sum over cost-less Assets/Liabilities legs (income positive, expenses negative, transfers net ~0); color cue is the wallet sign (net < 0 = wealth-decreasing). Status-orthogonal: audit views match too (ADR-0128 amount-as-matching-key). Omitted under the account viewpoint (incl. dual) and for rows with no wallet leg.
+   */
+  viewpointAmount?: string;
+  /**
+   * Currency of viewpointAmount. A row spanning multiple currencies takes the largest-magnitude currency group (known simplification, ADR-0126).
+   */
+  viewpointCurrency?: string;
+};
+
 export type BalanceByCurrencyDto = {
   /**
    * ISO 4217 currency code
@@ -1004,7 +1120,7 @@ export type ExchangeRateWarningDto = {
 
 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.
+   * Partial converted total in base currency (rated currencies only). Sign by viewpoint (ADR-0126): account viewpoint keeps the raw Beancount sign (income negative); category viewpoint is per-leg sign-normalized (Income legs negated, Expenses legs identity — positive under normal booking, not clamped). 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;
   /**
@@ -1021,11 +1137,32 @@ export type TransactionListSummaryDto = {
   warnings?: Array<ExchangeRateWarningDto>;
 };
 
+export type TransactionListViewpointDto = {
+  /**
+   * Viewpoint type (only category drill-down carries a viewpoint today)
+   */
+  type: 'category';
+  /**
+   * Flow root the category account set is restricted to
+   */
+  flow: 'income' | 'expense';
+};
+
+/**
+ * Viewpoint type (only category drill-down carries a viewpoint today)
+ */
+export type type2 = 'category';
+
+/**
+ * Flow root the category account set is restricted to
+ */
+export type flow = 'income' | 'expense';
+
 export type TransactionListResponseDto = {
   /**
    * List of transactions
    */
-  data: Array<TransactionDetailDto>;
+  data: Array<TransactionListItemDto>;
   /**
    * Total count of matching transactions
    */
@@ -1042,6 +1179,10 @@ export type TransactionListResponseDto = {
    * 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;
+  /**
+   * Viewpoint metadata (ADR-0126). Present only for a single category filter (category + flow, no accountId); dual-perspective requests are viewpoint-less (raw signs, no viewpointAmount).
+   */
+  viewpoint?: TransactionListViewpointDto;
 };
 
 export type TagSuggestionDto = {
@@ -1253,7 +1394,7 @@ export type ReviewSummaryDto = {
 /**
  * Review type
  */
-export type type2 =
+export type type3 =
   | 'DUPLICATE'
   | 'RULE_MATCH'
   | 'PAYEE_MATCH'
@@ -1701,7 +1842,7 @@ export type UpdatePayeeDto = {
    */
   customTags?: Array<string>;
   /**
-   * Metadata for extended information (location, notes, contact info, etc.). Will merge with existing metadata.
+   * Metadata for extended information (location, notes, contact info, etc.)
    */
   meta?: {
     [key: string]: unknown;
@@ -2094,481 +2235,449 @@ export type UpdateCommodityDto = {
   };
 };
 
-export type CreateBeanPriceDto = {
+export type CurrencyBalanceDto = {
   /**
-   * Currency being priced (e.g., USD, AAPL, BTC)
+   * ISO 4217 currency code
    */
   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.
+   * Balance amount
    */
-  amount: number;
+  balance: string;
+};
+
+export type TimeSeriesPointDto = {
   /**
-   * Price date (ISO 8601 format)
+   * Date in YYYY-MM-DD format
    */
   date: string;
   /**
-   * Metadata (validated by Zod schema, max field lengths enforced)
-   */
-  metadata?: {
-    [key: string]: unknown;
-  };
-};
-
-export type PriceResponseDto = {
-  /**
-   * Unique identifier
+   * Value at this date (in base currency)
    */
-  id: string;
+  value: string;
   /**
-   * User ID (owner of the price)
+   * Change from previous point
    */
-  userId: string;
+  change?: string;
   /**
-   * Currency being priced (e.g., USD, AAPL, BTC)
+   * Total assets at this date (in base currency)
    */
-  currency: string;
+  assets?: string;
   /**
-   * Quote currency (pricing currency, e.g., USD, CNY)
+   * Total liabilities at this date (in base currency)
    */
-  quoteCurrency: string;
+  liabilities?: string;
   /**
-   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
+   * Multi-currency breakdown for this point
    */
-  amount: number;
+  byCurrency?: Array<CurrencyBalanceDto>;
+};
+
+export type TrendSummaryDto = {
   /**
-   * Price date (ISO 8601 format). Represents the date this price was valid.
+   * Value at start of period
    */
-  date: string;
+  startValue: string;
   /**
-   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   * Value at end of period
    */
-  meta: {
-    [key: string]: unknown;
-  };
+  endValue: string;
   /**
-   * Creation timestamp
+   * Total change over period
    */
-  createdAt: string;
+  totalChange: string;
   /**
-   * Last update timestamp
+   * Total change percentage
    */
-  updatedAt: string;
+  totalChangePercentage: string;
 };
 
-export type PriceListResponseDto = {
+export type MultiCurrencyPointDto = {
   /**
-   * List of prices
+   * Date in YYYY-MM-DD format
    */
-  items: Array<PriceResponseDto>;
+  date: string;
   /**
-   * Total number of prices
+   * Balances by currency
    */
-  total: number;
+  byCurrency: Array<CurrencyBalanceDto>;
 };
 
-export type UpdateBeanPriceDto = {
+export type PortfolioTrendsResponseDto = {
   /**
-   * Currency being priced
+   * Time series data points
    */
-  currency?: string;
+  series: Array<TimeSeriesPointDto>;
   /**
-   * Quote currency (pricing currency)
+   * Period summary
    */
-  quoteCurrency?: string;
+  summary: TrendSummaryDto;
   /**
-   * Price amount (MUST be >= 0 per Beancount spec)
+   * Period requested
    */
-  amount?: number;
+  period: string;
   /**
-   * Price date (ISO 8601 format)
+   * Data granularity
    */
-  date?: string;
+  granularity: string;
   /**
-   * Metadata
+   * Base currency for converted values
    */
-  metadata?: {
-    [key: string]: unknown;
-  };
-};
-
-export type CreateRecurringRuleDto = {
+  currency: string;
   /**
-   * Rule name (unique per user)
+   * Multi-currency time series (each point has currency breakdown)
    */
-  name: string;
+  byCurrency?: Array<MultiCurrencyPointDto>;
   /**
-   * Icon emoji
+   * Exchange rate warnings
    */
-  icon?: string;
+  warnings?: Array<ExchangeRateWarningDto>;
+};
+
+export type CashFlowPointDto = {
   /**
-   * Recurring frequency
+   * Month key (YYYY-MM)
    */
-  frequency:
-    | 'WEEKLY'
-    | 'BIWEEKLY'
-    | 'MONTHLY'
-    | 'BIMONTHLY'
-    | 'QUARTERLY'
-    | 'YEARLY'
-    | 'CUSTOM';
+  month: string;
   /**
-   * Expected amount (positive number)
+   * Income in base currency (absolute, converted)
    */
-  expectedAmount: number;
+  income: string;
   /**
-   * Expected day of month (1-31)
+   * Expense in base currency (absolute, converted)
    */
-  expectedDay?: number;
+  expense: string;
   /**
-   * Custom interval in days (required for CUSTOM frequency)
+   * netSavings = income − expense (savings positive)
    */
-  customIntervalDays?: number;
+  netSavings: string;
+};
+
+export type CashFlowTrendSummaryDto = {
   /**
-   * Currency code
+   * Total income across the period
    */
-  currency: string;
+  totalIncome: string;
   /**
-   * Payee matching pattern (supports wildcards)
+   * Total expense across the period
    */
-  matchPayeePattern?: string;
+  totalExpense: string;
   /**
-   * Amount tolerance percentage (0-1)
+   * income − expense across the period
    */
-  matchAmountTolerance: number;
+  totalNetSavings: string;
   /**
-   * Default expense account for auto-create
+   * totalNetSavings divided by the window length (N months, incl. zero-filled)
    */
-  defaultExpenseAccount?: string;
+  averageMonthlyNetSavings: string;
+};
+
+export type CashFlowTrendsResponseDto = {
   /**
-   * Default payment account for auto-create
+   * Monthly cash-flow series (fixed N-month window, zero-filled)
    */
-  defaultPaymentAccount?: string;
+  series: Array<CashFlowPointDto>;
   /**
-   * Default payee for auto-create
+   * Period totals
    */
-  defaultPayee?: string;
+  summary: CashFlowTrendSummaryDto;
   /**
-   * Auto-create transaction when expected date arrives
+   * Period requested
    */
-  autoCreate: boolean;
+  period: string;
   /**
-   * Rule start date (ISO format)
+   * Data granularity (v1 returns month buckets)
    */
-  startDate?: string;
+  granularity: string;
   /**
-   * Rule end date (ISO format)
+   * Base currency for converted values
    */
-  endDate?: string;
+  currency: string;
+  /**
+   * Exchange rate warnings (e.g. missing rate for a currency)
+   */
+  warnings?: Array<ExchangeRateWarningDto>;
 };
 
-/**
- * Recurring frequency
- */
-export type frequency =
-  | 'WEEKLY'
-  | 'BIWEEKLY'
-  | 'MONTHLY'
-  | 'BIMONTHLY'
-  | 'QUARTERLY'
-  | 'YEARLY'
-  | 'CUSTOM';
+export type GenerateSnapshotBody = unknown;
 
-export type RecurringRuleResponseDto = {
-  /**
-   * Rule ID
-   */
-  id: string;
-  /**
-   * User ID
-   */
-  userId: string;
+export type GenerateSnapshotResponse = unknown;
+
+export type BackfillSnapshotsBody = unknown;
+
+export type BackfillSnapshotsResponse = unknown;
+
+export type CreateBeanPriceDto = {
   /**
-   * Rule name
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
-  name: string;
+  currency: string;
   /**
-   * Icon emoji
+   * Quote currency (pricing currency, e.g., CNY, EUR)
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency: string;
   /**
-   * Recurring frequency
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
    */
-  frequency: string;
+  amount: number;
   /**
-   * Expected amount
+   * Price date (ISO 8601 format)
    */
-  expectedAmount: number;
+  date: string;
   /**
-   * Expected day of month
+   * Metadata (validated by Zod schema, max field lengths enforced)
    */
-  expectedDay?: {
+  metadata?: {
     [key: string]: unknown;
   };
+};
+
+export type PriceResponseDto = {
   /**
-   * Custom interval in days
+   * Unique identifier
    */
-  customIntervalDays?: {
-    [key: string]: unknown;
-  };
+  id: string;
   /**
-   * Currency code
+   * User ID (owner of the price)
+   */
+  userId: string;
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
   currency: string;
   /**
-   * Payee matching pattern
+   * Quote currency (pricing currency, e.g., USD, CNY)
    */
-  matchPayeePattern?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency: string;
   /**
-   * Amount tolerance percentage
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
    */
-  matchAmountTolerance: number;
+  amount: number;
   /**
-   * Default expense account
+   * Price date (ISO 8601 format). Represents the date this price was valid.
    */
-  defaultExpenseAccount?: {
-    [key: string]: unknown;
-  };
+  date: string;
   /**
-   * Default payment account
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
    */
-  defaultPaymentAccount?: {
+  meta: {
     [key: string]: unknown;
   };
   /**
-   * Default payee
+   * Creation timestamp
    */
-  defaultPayee?: {
-    [key: string]: unknown;
-  };
+  createdAt: string;
   /**
-   * Whether rule is active
+   * Last update timestamp
    */
-  isActive: boolean;
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
   /**
-   * Rule start date (YYYY-MM-DD)
+   * List of prices
    */
-  startDate: string;
+  items: Array<PriceResponseDto>;
   /**
-   * Rule end date (YYYY-MM-DD)
+   * Total number of prices
    */
-  endDate?: {
-    [key: string]: unknown;
-  };
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
   /**
-   * Auto-create transaction on expected date
+   * Currency being priced
    */
-  autoCreate: boolean;
+  currency?: string;
   /**
-   * Last matched occurrence date (YYYY-MM-DD)
+   * Quote currency (pricing currency)
    */
-  lastOccurrence?: {
-    [key: string]: unknown;
-  };
+  quoteCurrency?: string;
   /**
-   * Total matched transactions count
+   * Price amount (MUST be >= 0 per Beancount spec)
    */
-  totalCount: number;
+  amount?: number;
   /**
-   * Created at timestamp
+   * Price date (ISO 8601 format)
    */
-  createdAt: string;
+  date?: string;
   /**
-   * Updated at timestamp
+   * Metadata
    */
-  updatedAt: string;
+  metadata?: {
+    [key: string]: unknown;
+  };
 };
 
-export type CreateRuleFromTransactionDto = {
-  /**
-   * Recurring frequency
-   */
-  frequency:
-    | 'WEEKLY'
-    | 'BIWEEKLY'
-    | 'MONTHLY'
-    | 'BIMONTHLY'
-    | 'QUARTERLY'
-    | 'YEARLY'
-    | 'CUSTOM';
-  /**
-   * Optional name override (default: transaction payee)
-   */
-  name?: string;
+export type DeleteOwnUserDto = {
   /**
-   * Optional icon emoji
+   * Access token for user verification
    */
-  icon?: string;
+  accessToken: string;
 };
 
-export type RecurringRuleWithStatsResponseDto = {
+export type UserSettingsResponseDto = {
   /**
-   * Rule ID
+   * Stored base currency choice (ISO 4217) for net-worth/report aggregation. null = user never chose; aggregates fall back to the region default at display time (#713).
    */
-  id: string;
+  baseCurrency: string | null;
+};
+
+export type UserResponseDto = {
   /**
    * User ID
    */
-  userId: string;
-  /**
-   * Rule name
-   */
-  name: string;
+  id: string;
   /**
-   * Icon emoji
+   * Assigned user role
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  role: string;
   /**
-   * Recurring frequency
+   * Permission strings
    */
-  frequency: string;
+  permissions: Array<string>;
   /**
-   * Expected amount
+   * User settings
    */
-  expectedAmount: number;
+  settings: UserSettingsResponseDto;
+};
+
+export type SignupDto = {
   /**
-   * Expected day of month
+   * Cloudflare Turnstile verification token (optional when Turnstile disabled)
    */
-  expectedDay?: {
-    [key: string]: unknown;
-  };
+  turnstileToken?: string;
+};
+
+export type SignupResponseDto = {
   /**
-   * Custom interval in days
+   * JWT auth token
    */
-  customIntervalDays?: {
-    [key: string]: unknown;
-  };
+  authToken: string;
   /**
-   * Currency code
+   * Auto-generated access token
    */
-  currency: string;
+  accessToken: string;
   /**
-   * Payee matching pattern
+   * Assigned user role
    */
-  matchPayeePattern?: {
-    [key: string]: unknown;
-  };
+  role: 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+};
+
+/**
+ * Assigned user role
+ */
+export type role = 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+
+export type UpdateUserSettingDto = {
   /**
-   * Amount tolerance percentage
+   * Security ID
    */
-  matchAmountTolerance: number;
+  secId?: number;
   /**
-   * Default expense account
+   * Annual interest rate
    */
-  defaultExpenseAccount?: {
-    [key: string]: unknown;
-  };
+  annualInterestRate?: number;
   /**
-   * Default payment account
-   */
-  defaultPaymentAccount?: {
-    [key: string]: unknown;
-  };
+   * Currency code
+   */
+  currency?: string;
   /**
-   * Default payee
+   * Base currency code
    */
-  defaultPayee?: {
-    [key: string]: unknown;
-  };
+  baseCurrency?: string;
   /**
-   * Whether rule is active
+   * Benchmark symbol
    */
-  isActive: boolean;
+  benchmark?: string;
   /**
-   * Rule start date (YYYY-MM-DD)
+   * Color scheme
    */
-  startDate: string;
+  colorScheme?: 'DARK' | 'LIGHT';
   /**
-   * Rule end date (YYYY-MM-DD)
+   * Date range filter
    */
-  endDate?: {
-    [key: string]: unknown;
-  };
+  dateRange?: string;
   /**
-   * Auto-create transaction on expected date
+   * Emergency fund amount
    */
-  autoCreate: boolean;
+  emergencyFund?: number;
   /**
-   * Last matched occurrence date (YYYY-MM-DD)
+   * Account filter IDs
    */
-  lastOccurrence?: {
-    [key: string]: unknown;
-  };
+  'filters.accounts'?: Array<string>;
   /**
-   * Total matched transactions count
+   * Asset class filters
    */
-  totalCount: number;
+  'filters.assetClasses'?: Array<string>;
   /**
-   * Created at timestamp
+   * Data source filter
    */
-  createdAt: string;
+  'filters.dataSource'?: string;
   /**
-   * Updated at timestamp
+   * Symbol filter
    */
-  updatedAt: string;
+  'filters.symbol'?: string;
   /**
-   * Number of pending expected transactions
+   * Tag filters
    */
-  pendingCount: number;
+  'filters.tags'?: Array<string>;
   /**
-   * Number of overdue expected transactions
+   * Enable experimental features
    */
-  overdueCount: number;
+  isExperimentalFeatures?: boolean;
   /**
-   * Next expected date (YYYY-MM-DD)
+   * Enable restricted view mode
    */
-  nextExpectedDate?: {
-    [key: string]: unknown;
-  };
+  isRestrictedView?: boolean;
   /**
-   * Total amount of all matched transactions
+   * Language code
    */
-  totalAmount: number;
+  language?: string;
   /**
-   * Average amount per transaction
+   * Locale code
    */
-  averageAmount: number;
+  locale?: string;
   /**
-   * Number of matched transactions
+   * Projected total amount
    */
-  transactionCount: number;
+  projectedTotalAmount?: number;
   /**
-   * First matched transaction date (YYYY-MM-DD)
+   * Retirement date in ISO 8601 format
    */
-  firstDate?: {
-    [key: string]: unknown;
-  };
+  retirementDate?: string;
   /**
-   * Last matched transaction date (YYYY-MM-DD)
+   * Savings rate percentage
    */
-  lastDate?: {
-    [key: string]: unknown;
-  };
+  savingsRate?: number;
   /**
-   * Amount variance (standard deviation squared)
+   * View mode
    */
-  variance: number;
+  viewMode?: 'DEFAULT' | 'ZEN';
+};
+
+/**
+ * Color scheme
+ */
+export type colorScheme = 'DARK' | 'LIGHT';
+
+/**
+ * View mode
+ */
+export type viewMode = 'DEFAULT' | 'ZEN';
+
+export type UpdatePropertyDto = {
   /**
-   * Number of upcoming expected transactions
+   * Property value
    */
-  upcomingCount: number;
+  value: string;
 };
 
-export type UpdateRecurringRuleDto = {
+export type CreateRecurringRuleDto = {
   /**
-   * Rule name
+   * Rule name (unique per user)
    */
-  name?: string;
+  name: string;
   /**
    * Icon emoji
    */
@@ -2576,7 +2685,7 @@ export type UpdateRecurringRuleDto = {
   /**
    * Recurring frequency
    */
-  frequency?:
+  frequency:
     | 'WEEKLY'
     | 'BIWEEKLY'
     | 'MONTHLY'
@@ -2585,15 +2694,15 @@ export type UpdateRecurringRuleDto = {
     | 'YEARLY'
     | 'CUSTOM';
   /**
-   * Expected amount
+   * Expected amount (positive number)
    */
-  expectedAmount?: number;
+  expectedAmount: number;
   /**
    * Expected day of month (1-31)
    */
   expectedDay?: number;
   /**
-   * Custom interval in days
+   * Custom interval in days (required for CUSTOM frequency)
    */
   customIntervalDays?: number;
   /**
@@ -2601,111 +2710,132 @@ export type UpdateRecurringRuleDto = {
    */
   currency?: string;
   /**
-   * Payee matching pattern
+   * Payee matching pattern (supports wildcards)
    */
   matchPayeePattern?: string;
   /**
    * Amount tolerance percentage (0-1)
    */
-  matchAmountTolerance?: number;
+  matchAmountTolerance: number;
   /**
-   * Default expense account
+   * Default expense account for auto-create
    */
   defaultExpenseAccount?: string;
   /**
-   * Default payment account
+   * Default payment account for auto-create
    */
   defaultPaymentAccount?: string;
   /**
-   * Default payee
+   * Default payee for auto-create
    */
   defaultPayee?: string;
   /**
-   * Auto-create transaction
+   * Auto-create transaction when expected date arrives
    */
-  autoCreate?: boolean;
+  autoCreate: boolean;
   /**
-   * Rule active status
+   * Rule start date (ISO format)
    */
-  isActive?: boolean;
+  startDate?: string;
   /**
    * Rule end date (ISO format)
    */
   endDate?: string;
 };
 
-export type ExpectedTransactionRuleDto = {
+/**
+ * Recurring frequency
+ */
+export type frequency =
+  | 'WEEKLY'
+  | 'BIWEEKLY'
+  | 'MONTHLY'
+  | 'BIMONTHLY'
+  | 'QUARTERLY'
+  | 'YEARLY'
+  | 'CUSTOM';
+
+export type RecurringRuleResponseDto = {
+  /**
+   * Rule ID
+   */
+  id: string;
+  /**
+   * User ID
+   */
+  userId: string;
   /**
    * Rule name
    */
   name: string;
   /**
-   * Rule icon
+   * Icon emoji
    */
-  icon?: {
-    [key: string]: unknown;
-  };
+  icon?: string;
   /**
-   * Rule frequency
+   * Recurring frequency
    */
   frequency: string;
+  /**
+   * Expected amount
+   */
+  expectedAmount: number;
+  /**
+   * Expected day of month
+   */
+  expectedDay?: number;
+  /**
+   * Custom interval in days
+   */
+  customIntervalDays?: number;
   /**
    * Currency code
    */
   currency: string;
-};
-
-export type ExpectedTransactionResponseDto = {
   /**
-   * Expected transaction ID
+   * Payee matching pattern
    */
-  id: string;
+  matchPayeePattern?: string;
   /**
-   * User ID
+   * Amount tolerance percentage
    */
-  userId: string;
+  matchAmountTolerance: number;
   /**
-   * Associated rule ID
+   * Default expense account
    */
-  ruleId: string;
+  defaultExpenseAccount?: string;
   /**
-   * Expected date (YYYY-MM-DD)
+   * Default payment account
    */
-  expectedDate: string;
+  defaultPaymentAccount?: string;
   /**
-   * Expected amount
+   * Default payee
    */
-  expectedAmount: number;
+  defaultPayee?: string;
   /**
-   * Status (PENDING, COMPLETED, SKIPPED)
+   * Whether rule is active
    */
-  status: string;
+  isActive: boolean;
   /**
-   * Matched transaction ID
+   * Rule start date (YYYY-MM-DD)
    */
-  matchedTransactionId?: {
-    [key: string]: unknown;
-  };
+  startDate: string;
   /**
-   * Match timestamp (ISO 8601)
+   * Rule end date (YYYY-MM-DD)
    */
-  matchedAt?: {
-    [key: string]: unknown;
-  };
+  endDate?: string;
   /**
-   * Match confidence score (0-1)
+   * Auto-create transaction on expected date
    */
-  matchConfidence?: {
-    [key: string]: unknown;
-  };
+  autoCreate: boolean;
   /**
-   * Whether this expected transaction is overdue
+   * Last matched occurrence date (YYYY-MM-DD)
    */
-  isOverdue: boolean;
+  lastOccurrence?: string;
   /**
-   * Rule information
+   * Total matched transactions count
    */
-  rule: ExpectedTransactionRuleDto;
+  totalCount: number;
   /**
    * Created at timestamp
    */
@@ -2716,461 +2846,420 @@ export type ExpectedTransactionResponseDto = {
   updatedAt: string;
 };
 
-export type ExpectedTransactionListResponseDto = {
-  items: Array<ExpectedTransactionResponseDto>;
-  /**
-   * Total count
-   */
-  total: number;
-};
-
-export type ConfirmMatchDto = {
-  /**
-   * Transaction ID to match with
-   */
-  transactionId: string;
-};
-
-export type EnterNowDto = {
-  /**
-   * Override expense account (uses rule default if not provided)
-   */
-  expenseAccount?: string;
-  /**
-   * Override payment account (uses rule default if not provided)
-   */
-  paymentAccount?: string;
+export type CreateRuleFromTransactionDto = {
   /**
-   * Override amount (uses expected amount if not provided)
+   * Recurring frequency
    */
-  amount?: number;
+  frequency:
+    | 'WEEKLY'
+    | 'BIWEEKLY'
+    | 'MONTHLY'
+    | 'BIMONTHLY'
+    | 'QUARTERLY'
+    | 'YEARLY'
+    | 'CUSTOM';
   /**
-   * Override payee (uses rule default if not provided)
+   * Optional name override (default: transaction payee)
    */
-  payee?: string;
+  name?: string;
   /**
-   * Optional narration
+   * Optional icon emoji
    */
-  narration?: string;
+  icon?: string;
 };
 
-export type ForecastItemDto = {
+export type RecurringRuleWithStatsResponseDto = {
+  /**
+   * Rule ID
+   */
+  id: string;
+  /**
+   * User ID
+   */
+  userId: string;
   /**
    * Rule name
    */
-  rule: string;
+  name: string;
   /**
-   * Rule ID
+   * Icon emoji
    */
-  ruleId: string;
+  icon?: string;
+  /**
+   * Recurring frequency
+   */
+  frequency: string;
   /**
    * Expected amount
    */
-  amount: number;
+  expectedAmount: number;
   /**
-   * Expected date (YYYY-MM-DD)
+   * Expected day of month
    */
-  date: string;
+  expectedDay?: number;
   /**
-   * Rule icon emoji
+   * Custom interval in days
    */
-  icon: string | null;
+  customIntervalDays?: number;
   /**
    * Currency code
    */
   currency: string;
-};
-
-export type MonthlyForecastDto = {
   /**
-   * Month (YYYY-MM)
+   * Payee matching pattern
    */
-  month: string;
+  matchPayeePattern?: string;
   /**
-   * Total expected outflow for the month
+   * Amount tolerance percentage
    */
-  expectedOutflow: number;
+  matchAmountTolerance: number;
   /**
-   * Number of expected transactions
+   * Default expense account
    */
-  itemCount: number;
+  defaultExpenseAccount?: string;
   /**
-   * Breakdown by currency
+   * Default payment account
    */
-  byCurrency: {
-    [key: string]: unknown;
-  };
+  defaultPaymentAccount?: string;
   /**
-   * Individual forecast items
+   * Default payee
    */
-  items: Array<ForecastItemDto>;
-};
-
-export type ForecastResponseDto = {
+  defaultPayee?: string;
   /**
-   * Monthly forecast data
+   * Whether rule is active
    */
-  forecast: Array<MonthlyForecastDto>;
+  isActive: boolean;
   /**
-   * Total expected outflow across all months
+   * Rule start date (YYYY-MM-DD)
    */
-  totalOutflow: number;
+  startDate: string;
   /**
-   * Total by currency across all months
+   * Rule end date (YYYY-MM-DD)
    */
-  totalByCurrency: {
-    [key: string]: unknown;
-  };
+  endDate?: string;
   /**
-   * Number of active recurring rules included
+   * Auto-create transaction on expected date
    */
-  rulesCount: number;
+  autoCreate: boolean;
   /**
-   * Forecast period start date
+   * Last matched occurrence date (YYYY-MM-DD)
    */
-  periodStart: string;
+  lastOccurrence?: string;
   /**
-   * Forecast period end date
+   * Total matched transactions count
    */
-  periodEnd: string;
-};
-
-export type CurrencyBalanceDto = {
+  totalCount: number;
   /**
-   * ISO 4217 currency code
+   * Created at timestamp
    */
-  currency: string;
+  createdAt: string;
   /**
-   * Balance amount
+   * Updated at timestamp
    */
-  balance: string;
-};
-
-export type TimeSeriesPointDto = {
+  updatedAt: string;
   /**
-   * Date in YYYY-MM-DD format
+   * Number of pending expected transactions
    */
-  date: string;
+  pendingCount: number;
   /**
-   * Value at this date (in base currency)
+   * Number of overdue expected transactions
    */
-  value: string;
+  overdueCount: number;
   /**
-   * Change from previous point
+   * Next expected date (YYYY-MM-DD)
    */
-  change?: {
-    [key: string]: unknown;
-  };
+  nextExpectedDate?: string;
   /**
-   * Total assets at this date (in base currency)
+   * Total amount of all matched transactions
    */
-  assets?: string;
+  totalAmount: number;
   /**
-   * Total liabilities at this date (in base currency)
+   * Average amount per transaction
    */
-  liabilities?: string;
+  averageAmount: number;
   /**
-   * Multi-currency breakdown for this point
+   * Number of matched transactions
    */
-  byCurrency?: Array<CurrencyBalanceDto>;
-};
-
-export type TrendSummaryDto = {
+  transactionCount: number;
   /**
-   * Value at start of period
+   * First matched transaction date (YYYY-MM-DD)
    */
-  startValue: string;
+  firstDate?: string;
   /**
-   * Value at end of period
+   * Last matched transaction date (YYYY-MM-DD)
    */
-  endValue: string;
+  lastDate?: string;
   /**
-   * Total change over period
+   * Amount variance (standard deviation squared)
    */
-  totalChange: string;
+  variance: number;
   /**
-   * Total change percentage
+   * Number of upcoming expected transactions
    */
-  totalChangePercentage: string;
+  upcomingCount: number;
 };
 
-export type MultiCurrencyPointDto = {
+export type UpdateRecurringRuleDto = {
   /**
-   * Date in YYYY-MM-DD format
+   * Rule name (unique per user)
    */
-  date: string;
+  name?: string;
   /**
-   * Balances by currency
+   * Icon emoji
    */
-  byCurrency: Array<CurrencyBalanceDto>;
-};
-
-export type PortfolioTrendsResponseDto = {
+  icon?: string;
   /**
-   * Time series data points
+   * Recurring frequency
    */
-  series: Array<TimeSeriesPointDto>;
+  frequency?:
+    | 'WEEKLY'
+    | 'BIWEEKLY'
+    | 'MONTHLY'
+    | 'BIMONTHLY'
+    | 'QUARTERLY'
+    | 'YEARLY'
+    | 'CUSTOM';
   /**
-   * Period summary
+   * Expected amount (positive number)
    */
-  summary: TrendSummaryDto;
+  expectedAmount?: number;
   /**
-   * Period requested
+   * Expected day of month (1-31)
    */
-  period: string;
+  expectedDay?: number;
   /**
-   * Data granularity
+   * Currency code
    */
-  granularity: string;
+  currency?: string;
   /**
-   * Base currency for converted values
+   * Payee matching pattern (supports wildcards)
    */
-  currency: string;
+  matchPayeePattern?: string;
   /**
-   * Multi-currency time series (each point has currency breakdown)
+   * Amount tolerance percentage (0-1)
    */
-  byCurrency?: Array<MultiCurrencyPointDto>;
+  matchAmountTolerance?: number;
   /**
-   * Exchange rate warnings
+   * Default expense account for auto-create
    */
-  warnings?: Array<ExchangeRateWarningDto>;
-};
-
-export type CashFlowPointDto = {
+  defaultExpenseAccount?: string;
   /**
-   * Month key (YYYY-MM)
+   * Default payment account for auto-create
    */
-  month: string;
+  defaultPaymentAccount?: string;
   /**
-   * Income in base currency (absolute, converted)
+   * Default payee for auto-create
    */
-  income: string;
+  defaultPayee?: string;
   /**
-   * Expense in base currency (absolute, converted)
+   * Auto-create transaction when expected date arrives
    */
-  expense: string;
+  autoCreate?: boolean;
   /**
-   * netSavings = income − expense (savings positive)
+   * Rule end date (ISO format)
    */
-  netSavings: string;
+  endDate?: string;
+  /**
+   * Custom interval in days
+   */
+  customIntervalDays?: number;
+  /**
+   * Rule active status
+   */
+  isActive?: boolean;
 };
 
-export type CashFlowTrendSummaryDto = {
+export type ExpectedTransactionRuleDto = {
   /**
-   * Total income across the period
+   * Rule name
    */
-  totalIncome: string;
+  name: string;
   /**
-   * Total expense across the period
+   * Rule icon
    */
-  totalExpense: string;
+  icon?: string;
   /**
-   * income − expense across the period
+   * Rule frequency
    */
-  totalNetSavings: string;
+  frequency: string;
   /**
-   * totalNetSavings divided by the window length (N months, incl. zero-filled)
+   * Currency code
    */
-  averageMonthlyNetSavings: string;
+  currency: string;
 };
 
-export type CashFlowTrendsResponseDto = {
+export type ExpectedTransactionResponseDto = {
   /**
-   * Monthly cash-flow series (fixed N-month window, zero-filled)
+   * Expected transaction ID
    */
-  series: Array<CashFlowPointDto>;
+  id: string;
   /**
-   * Period totals
+   * User ID
    */
-  summary: CashFlowTrendSummaryDto;
+  userId: string;
   /**
-   * Period requested
+   * Associated rule ID
    */
-  period: string;
+  ruleId: string;
   /**
-   * Data granularity (v1 returns month buckets)
+   * Expected date (YYYY-MM-DD)
+   */
+  expectedDate: string;
+  /**
+   * Expected amount
    */
-  granularity: string;
+  expectedAmount: number;
   /**
-   * Base currency for converted values
+   * Status (PENDING, COMPLETED, SKIPPED)
    */
-  currency: string;
+  status: string;
   /**
-   * Exchange rate warnings (e.g. missing rate for a currency)
+   * Matched transaction ID
    */
-  warnings?: Array<ExchangeRateWarningDto>;
-};
-
-export type GenerateSnapshotBody = unknown;
-
-export type GenerateSnapshotResponse = unknown;
-
-export type BackfillSnapshotsBody = unknown;
-
-export type BackfillSnapshotsResponse = unknown;
-
-export type DeleteOwnUserDto = {
+  matchedTransactionId?: string;
   /**
-   * Access token for user verification
+   * Match timestamp (ISO 8601)
    */
-  accessToken: string;
-};
-
-export type UserSettingsResponseDto = {
+  matchedAt?: string;
   /**
-   * Base currency (ISO 4217) for net-worth/report aggregation. Independent of region (ADR-0006).
+   * Match confidence score (0-1)
    */
-  baseCurrency: string | null;
-};
-
-export type UserResponseDto = {
+  matchConfidence?: number;
   /**
-   * User ID
+   * Whether this expected transaction is overdue
    */
-  id: string;
+  isOverdue: boolean;
   /**
-   * Assigned user role
+   * Rule information
    */
-  role: string;
+  rule: ExpectedTransactionRuleDto;
   /**
-   * Permission strings
+   * Created at timestamp
    */
-  permissions: Array<string>;
+  createdAt: string;
   /**
-   * User settings
+   * Updated at timestamp
    */
-  settings: UserSettingsResponseDto;
+  updatedAt: string;
 };
 
-export type SignupDto = {
+export type ExpectedTransactionListResponseDto = {
+  items: Array<ExpectedTransactionResponseDto>;
   /**
-   * Cloudflare Turnstile verification token (optional when Turnstile disabled)
+   * Total count
    */
-  turnstileToken?: string;
+  total: number;
 };
 
-export type SignupResponseDto = {
-  /**
-   * JWT auth token
-   */
-  authToken: string;
-  /**
-   * Auto-generated access token
-   */
-  accessToken: string;
+export type ConfirmMatchDto = {
   /**
-   * Assigned user role
+   * Transaction ID to match with
    */
-  role: 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
+  transactionId: string;
 };
 
-/**
- * Assigned user role
- */
-export type role = 'USER' | 'ADMIN' | 'DEMO' | 'INACTIVE' | 'PAID' | 'OPS';
-
-export type UpdateUserSettingDto = {
+export type EnterNowDto = {
   /**
-   * Security ID
+   * Override expense account (uses rule default if not provided)
    */
-  secId?: number;
+  expenseAccount?: string;
   /**
-   * Annual interest rate
+   * Override payment account (uses rule default if not provided)
    */
-  annualInterestRate?: number;
+  paymentAccount?: string;
   /**
-   * Currency code
+   * Override amount (uses expected amount if not provided)
    */
-  currency?: string;
+  amount?: number;
   /**
-   * Base currency code
+   * Override payee (uses rule default if not provided)
    */
-  baseCurrency?: string;
+  payee?: string;
   /**
-   * Benchmark symbol
+   * Optional narration
    */
-  benchmark?: string;
+  narration?: string;
+};
+
+export type ForecastItemDto = {
   /**
-   * Color scheme
+   * Rule name
    */
-  colorScheme?: 'DARK' | 'LIGHT';
+  rule: string;
   /**
-   * Date range filter
+   * Rule ID
    */
-  dateRange?: string;
+  ruleId: string;
   /**
-   * Emergency fund amount
+   * Expected amount
    */
-  emergencyFund?: number;
+  amount: number;
   /**
-   * Account filter IDs
+   * Expected date (YYYY-MM-DD)
    */
-  'filters.accounts'?: Array<string>;
+  date: string;
   /**
-   * Asset class filters
+   * Rule icon emoji
    */
-  'filters.assetClasses'?: Array<string>;
+  icon: string | null;
   /**
-   * Data source filter
+   * Currency code
    */
-  'filters.dataSource'?: string;
+  currency: string;
+};
+
+export type MonthlyForecastDto = {
   /**
-   * Symbol filter
+   * Month (YYYY-MM)
    */
-  'filters.symbol'?: string;
+  month: string;
   /**
-   * Tag filters
+   * Total expected outflow for the month
    */
-  'filters.tags'?: Array<string>;
+  expectedOutflow: number;
   /**
-   * Enable experimental features
+   * Number of expected transactions
    */
-  isExperimentalFeatures?: boolean;
+  itemCount: number;
   /**
-   * Enable restricted view mode
+   * Breakdown by currency
    */
-  isRestrictedView?: boolean;
+  byCurrency: {
+    [key: string]: unknown;
+  };
   /**
-   * Language code
+   * Individual forecast items
    */
-  language?: string;
+  items: Array<ForecastItemDto>;
+};
+
+export type ForecastResponseDto = {
   /**
-   * Locale code
+   * Monthly forecast data
    */
-  locale?: string;
+  forecast: Array<MonthlyForecastDto>;
   /**
-   * Projected total amount
+   * Total expected outflow across all months
    */
-  projectedTotalAmount?: number;
+  totalOutflow: number;
   /**
-   * Retirement date in ISO 8601 format
+   * Total by currency across all months
    */
-  retirementDate?: string;
+  totalByCurrency: {
+    [key: string]: unknown;
+  };
   /**
-   * Savings rate percentage
+   * Number of active recurring rules included
    */
-  savingsRate?: number;
+  rulesCount: number;
   /**
-   * View mode
+   * Forecast period start date
    */
-  viewMode?: 'DEFAULT' | 'ZEN';
-};
-
-/**
- * Color scheme
- */
-export type colorScheme = 'DARK' | 'LIGHT';
-
-/**
- * View mode
- */
-export type viewMode = 'DEFAULT' | 'ZEN';
-
-export type UpdatePropertyDto = {
+  periodStart: string;
   /**
-   * Property value
+   * Forecast period end date
    */
-  value: string;
+  periodEnd: string;
 };
 
 export type CreateTransactionRuleDto = {
@@ -3489,14 +3578,14 @@ export type UpdateTransactionRuleDto = {
    */
   amountMax?: number;
   priority?: number;
-  /**
-   * Enable or disable the rule
-   */
-  enabled?: boolean;
   additionalTags?: Array<unknown[]>;
   additionalMetadata?: {
     [key: string]: unknown;
   };
+  /**
+   * Enable or disable the rule
+   */
+  enabled?: boolean;
 };
 
 export type TestRuleDto = {
@@ -3686,6 +3775,10 @@ export type OnboardingAccountDto = {
    * Platform ID to bind the account to (references Platform.id); omit for unbound
    */
   platformId?: string;
+  /**
+   * User-set display name override (omit/null = keep the derived name)
+   */
+  displayName?: string | null;
 };
 
 export type OnboardingDto = {
@@ -4355,11 +4448,28 @@ export type ProcessNlpDto = {
    */
   selectedRuleId?: string;
   /**
-   * confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i], or a typed path). Applied directly when the session is confirming_account — no NL re-parse.
+   * confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i].path, or a typed path). Applied directly when the session is confirming_account — no NL re-parse.
    */
   selectedAccount?: string;
+  /**
+   * Viewpoint account hint: the beancount path the user drilled into (e.g. from an account drill-down). Tie-break only — never overrides accounts resolved from the text. Must be an owned, OPEN Assets:/Liabilities: account; unresolvable hints are silently ignored.
+   */
+  viewpointAccount?: string;
+  /**
+   * Viewpoint category hint: the ADR-0075 Group segment the user drilled into (e.g. 'Food'). Resolved to a concrete OPEN account in that group; tie-break only — never overrides a category resolved from the text.
+   */
+  viewpointCategory?: string;
+  /**
+   * Companion flow root for viewpointCategory ('income' | 'expense'), mirroring the ADR-0126 list-endpoint invariant. Derived from the session's routed intent (multi-turn) when absent; a first-turn flow-less category hint is dropped — send the flow explicitly.
+   */
+  viewpointFlow?: 'income' | 'expense';
 };
 
+/**
+ * Companion flow root for viewpointCategory ('income' | 'expense'), mirroring the ADR-0126 list-endpoint invariant. Derived from the session's routed intent (multi-turn) when absent; a first-turn flow-less category hint is dropped — send the flow explicitly.
+ */
+export type viewpointFlow = 'income' | 'expense';
+
 export type NlpTransactionInfoDto = {
   /**
    * Transaction ID
@@ -4585,6 +4695,17 @@ export type NlpRuleConfirmationDataDto = {
   reasons: Array<string>;
 };
 
+export type NlpAccountCandidateDto = {
+  /**
+   * Canonical beancount account path (echo back on selection)
+   */
+  path: string;
+  /**
+   * Localized display name (ADR-0114 read-time projection, user locale)
+   */
+  name: string;
+};
+
 export type NlpAccountConfirmationDataDto = {
   /**
    * The invalid account name
@@ -4595,9 +4716,9 @@ export type NlpAccountConfirmationDataDto = {
    */
   suggestedAccount?: string;
   /**
-   * Similar accounts for user selection
+   * Similar accounts for user selection (path + localized name, #680)
    */
-  similarAccounts: Array<string>;
+  similarAccounts: Array<NlpAccountCandidateDto>;
   /**
    * Error message explaining the issue
    */
@@ -4973,7 +5094,7 @@ export type PlatformListItemDto = {
 /**
  * Platform type
  */
-export type type3 =
+export type type4 =
   | 'BANK'
   | 'BROKERAGE'
   | 'CRYPTO_EXCHANGE'
@@ -5057,6 +5178,55 @@ export type PlatformMatchResponseDto = {
  */
 export type matchType2 = 'none' | 'exact' | 'prefix' | 'substring';
 
+export type PlatformStandardsPlatformDto = {
+  /**
+   * Global platform ID
+   */
+  id: string;
+  /**
+   * Platform name (e.g., "ICBC")
+   */
+  name: string;
+  /**
+   * Canonical identifier in ACCOUNT_RE format (e.g., "icbc")
+   */
+  canonical: string;
+  /**
+   * Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")
+   */
+  suggestedSegment: string;
+  /**
+   * Platform type
+   */
+  type:
+    | 'BANK'
+    | 'BROKERAGE'
+    | 'CRYPTO_EXCHANGE'
+    | 'PAYMENT'
+    | 'INVESTMENT'
+    | 'INSURANCE'
+    | 'OTHER';
+  /**
+   * Region-aware category (institution vocab, e.g. DigitalWallet/Bank) resolved against the final region. null = no region-aware suggestion; fall back to type.
+   */
+  category: string | null;
+};
+
+export type PlatformStandardsResponseDto = {
+  /**
+   * The selected platform (institution lock source)
+   */
+  platform: PlatformStandardsPlatformDto;
+  /**
+   * Resolved template region (ISO 3166-1 alpha-2, UPPERCASE): the platform's own countryCode when set, else the region query param. For regions without a regional template file the template list falls back to the universal-only catalog while region still echoes the code.
+   */
+  region: string;
+  /**
+   * Candidate account-standard templates of the resolved region (groupable by productCategory client-side)
+   */
+  templates: Array<AccountStandardResponseDto>;
+};
+
 export type CreatePlatformDto = {
   /**
    * Platform name
@@ -5226,7 +5396,7 @@ export type AccountItemDto = {
    */
   name: string;
   /**
-   * Display name (last part of account path)
+   * Display name: user-set name if provided (#762), else last part of account path
    */
   displayName: string;
   /**
@@ -5253,11 +5423,11 @@ export type PlatformGroupDto = {
    */
   platformName: string;
   /**
-   * Accounts within this platform
+   * Accounts within this platform (Assets and Liabilities rows, #696)
    */
   accounts: Array<AccountItemDto>;
   /**
-   * FX-converted total balance in base currency
+   * FX-converted total balance in base currency (nets Assets + Liabilities rows; can be negative)
    */
   totalBalance: string;
   /**
@@ -5269,7 +5439,7 @@ export type PlatformGroupDto = {
    */
   convertedBalance?: string;
   /**
-   * Share of the grand converted total (0-100); 0 when grand total is 0
+   * Share of the converted asset-side grand total (0-100); liability balances are excluded from the basis; 0 when grand total is 0 (#696)
    */
   sharePct: number;
 };
@@ -5295,7 +5465,7 @@ export type AccountExchangeRateWarningDto = {
 
 export type AccountsSummaryDto = {
   /**
-   * Total number of accounts
+   * Total number of accounts (balance sheet: Assets + Liabilities, #696)
    */
   totalAccounts: number;
   /**
@@ -5333,7 +5503,7 @@ export type AccountItemWithAssetClassDto = {
    */
   name: string;
   /**
-   * Display name (last part of account path)
+   * Display name: user-set name if provided (#762), else last part of account path
    */
   displayName: string;
   /**
@@ -5647,9 +5817,7 @@ export type MonetaryDto = {
   /**
    * Converted to user base currency (Decimal string)
    */
-  baseCcyEquivalent?: {
-    [key: string]: unknown;
-  } | null;
+  baseCcyEquivalent?: string | null;
 };
 
 export type CurrentPriceDto = {
@@ -5701,15 +5869,11 @@ export type HoldingPnlRowDto = {
   /**
    * Account settlement currency (ISO 4217), from cost currency
    */
-  accountCcy?: {
-    [key: string]: unknown;
-  } | null;
+  accountCcy?: string | null;
   /**
    * Broker type derived from Platform.type
    */
-  brokerType?: {
-    [key: string]: unknown;
-  } | null;
+  brokerType?: string | null;
   /**
    * Commodity symbol
    */
@@ -5719,9 +5883,7 @@ export type HoldingPnlRowDto = {
    */
   chartToken: 'equity' | 'fund' | 'bond' | 'cash' | 'other';
   assetClass: string;
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Net held units (Decimal string)
    */
@@ -5745,15 +5907,11 @@ export type HoldingPnlRowDto = {
   /**
    * Unrealized P&L in base currency (Decimal string); null when any FX/price missing
    */
-  unrealizedPnlBase?: {
-    [key: string]: unknown;
-  } | null;
+  unrealizedPnlBase?: string | null;
   /**
    * Unrealized P&L % (Decimal string)
    */
-  unrealizedPnlPct?: {
-    [key: string]: unknown;
-  } | null;
+  unrealizedPnlPct?: string | null;
   /**
    * Historical FX rate applied to cost basis
    */
@@ -5765,9 +5923,7 @@ export type HoldingPnlRowDto = {
   /**
    * Share of invested assets % (Decimal string); only for invested chartTokens
    */
-  pctOfInvestedAssets?: {
-    [key: string]: unknown;
-  } | null;
+  pctOfInvestedAssets?: string | 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
    */
@@ -5791,21 +5947,15 @@ export type HoldingPnlWarningDto = {
     | 'OVERSOLD_LOTS'
     | 'NO_PRICE'
     | 'MIXED_COST_CURRENCY';
-  symbol?: {
-    [key: string]: unknown;
-  } | null;
-  accountId?: {
-    [key: string]: unknown;
-  } | null;
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  symbol?: string | null;
+  accountId?: string | null;
+  currency?: string | null;
 };
 
 /**
  * Warning type
  */
-export type type4 =
+export type type5 =
   | 'MISSING_COST_FX_RATE'
   | 'MISSING_MARKET_FX_RATE'
   | 'MISSING_SALE_PRICE'
@@ -5844,132 +5994,205 @@ export type AnonymousLoginResponseDto = {
   authToken: string;
 };
 
+export type ParserContributionMetaDto = {
+  /**
+   * Institution slug (lowercase kebab-case)
+   */
+  institution: string;
+  region:
+    | 'cn'
+    | 'us'
+    | 'de'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'jp'
+    | 'sg'
+    | 'au'
+    | 'ca'
+    | 'other';
+  accountType: 'checking' | 'savings' | 'credit' | 'debit' | 'investment';
+  format: 'csv' | 'xlsx' | 'pdf' | 'ofx' | 'qif';
+  institutionDisplayName?: string;
+  encoding?: string;
+  /**
+   * CSV delimiter character: ",", ";", "\t" or "|"
+   */
+  delimiter?: string;
+  /**
+   * Header row count; the client omits the field when it is 1
+   */
+  headerRows?: number;
+  notes?: string;
+};
+
+export type region =
+  | 'cn'
+  | 'us'
+  | 'de'
+  | 'fr'
+  | 'gb'
+  | 'hk'
+  | 'jp'
+  | 'sg'
+  | 'au'
+  | 'ca'
+  | 'other';
+
+export type accountType =
+  | 'checking'
+  | 'savings'
+  | 'credit'
+  | 'debit'
+  | 'investment';
+
+export type format = 'csv' | 'xlsx' | 'pdf' | 'ofx' | 'qif';
+
+export type ParserContributionSamplesDto = {
+  /**
+   * Client-sanitized sample rows (key = column name, value = cell)
+   */
+  rows: Array<{
+    [key: string]: unknown;
+  }>;
+  rawHeaders?: Array<string>;
+};
+
+export type FieldHintDto = {
+  columnName: string;
+  /**
+   * Date format, e.g. yyyy-MM-dd HH:mm
+   */
+  format?: string;
+  signConvention?: 'negative-expense' | 'positive-expense' | 'separate-columns';
+  creditColumn?: string;
+  debitColumn?: string;
+};
+
+export type signConvention =
+  | 'negative-expense'
+  | 'positive-expense'
+  | 'separate-columns';
+
+export type ParserContributionFieldHintsDto = {
+  date: FieldHintDto;
+  amount: FieldHintDto;
+  description?: FieldHintDto;
+  balance?: FieldHintDto;
+  payee?: FieldHintDto;
+  reference?: FieldHintDto;
+  category?: FieldHintDto;
+};
+
+export type ExpectedTransactionDto = {
+  date: string;
+  amount: number;
+  description: string;
+  payee?: string;
+  category?: string;
+};
+
+export type ParserContributionExamplesDto = {
+  expectedTransactions: Array<ExpectedTransactionDto>;
+};
+
+export type ParserContributionRequestDto = {
+  meta: ParserContributionMetaDto;
+  samples: ParserContributionSamplesDto;
+  fieldHints: ParserContributionFieldHintsDto;
+  /**
+   * Omitted entirely by the client when empty
+   */
+  examples?: ParserContributionExamplesDto;
+};
+
+export type ParserContributionRelayResponseDto = {
+  issueUrl: string;
+  issueNumber: number;
+};
+
 export type SymbolSearchResultDto = {
   symbol: string;
-  name?: {
-    [key: string]: unknown;
-  } | null;
-  exchange?: {
-    [key: string]: unknown;
-  } | null;
+  name?: string | null;
+  exchange?: string | null;
   /**
    * OpenBB asset_type (e.g. stock, etf)
    */
-  assetType?: {
-    [key: string]: unknown;
-  } | null;
+  assetType?: string | null;
   /**
    * IGN asset class (region.types.ts ASSET_CLASSES)
    */
-  assetClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetClass?: string | null;
   /**
    * IGN asset sub-class (region.types.ts ASSET_SUB_CLASSES)
    */
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Trading currency (extra_data or inferred from exchange)
    */
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  currency?: string | null;
 };
 
 export type SymbolQuoteDto = {
   symbol?: string;
-  name?: {
-    [key: string]: unknown;
-  } | null;
-  exchange?: {
-    [key: string]: unknown;
-  } | null;
+  name?: string | null;
+  exchange?: string | null;
   /**
    * OpenBB asset_type
    */
-  assetType?: {
-    [key: string]: unknown;
-  } | null;
+  assetType?: string | null;
   /**
    * IGN asset class
    */
-  assetClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetClass?: string | null;
   /**
    * IGN asset sub-class
    */
-  assetSubClass?: {
-    [key: string]: unknown;
-  } | null;
+  assetSubClass?: string | null;
   /**
    * Trading currency (extra_data or inferred from exchange)
    */
-  currency?: {
-    [key: string]: unknown;
-  } | null;
+  currency?: string | null;
   /**
    * Latest price (Decimal string)
    */
-  price?: {
-    [key: string]: unknown;
-  } | null;
+  price?: string | null;
   /**
    * Date the price was observed (ISO yyyy-MM-dd)
    */
-  priceDate?: {
-    [key: string]: unknown;
-  } | null;
+  priceDate?: string | null;
   /**
    * Change vs previous close, in percentage points (1.7 == 1.7%). openbb stores change_percent as a normalized decimal; this exposes percentage points for frontend convenience.
    */
-  changePercent?: {
-    [key: string]: unknown;
-  } | null;
+  changePercent?: number | null;
   /**
    * Previous close (Decimal string)
    */
-  prevClose?: {
-    [key: string]: unknown;
-  } | null;
+  prevClose?: string | null;
   /**
    * Day open (Decimal string)
    */
-  open?: {
-    [key: string]: unknown;
-  } | null;
+  open?: string | null;
   /**
    * Day high (Decimal string)
    */
-  high?: {
-    [key: string]: unknown;
-  } | null;
+  high?: string | null;
   /**
    * Day low (Decimal string)
    */
-  low?: {
-    [key: string]: unknown;
-  } | null;
+  low?: string | null;
   /**
    * Day volume (Decimal string)
    */
-  volume?: {
-    [key: string]: unknown;
-  } | null;
+  volume?: string | null;
   /**
    * 52-week high (Decimal string)
    */
-  yearHigh?: {
-    [key: string]: unknown;
-  } | null;
+  yearHigh?: string | null;
   /**
    * 52-week low (Decimal string)
    */
-  yearLow?: {
-    [key: string]: unknown;
-  } | null;
+  yearLow?: string | null;
 };
 
 export type AccountControllerCreateData = {
@@ -6300,7 +6523,7 @@ export type AccountControllerAddOpeningBalanceResponse =
 
 export type AccountStandardsControllerGetTemplatesData = {
   /**
-   * Region code (cn, us, de)
+   * Region code (any ISO alpha-2; not-yet-open codes return the universal-only catalog)
    */
   region:
     | 'ad'
@@ -6310,26 +6533,192 @@ export type AccountStandardsControllerGetTemplatesData = {
     | 'al'
     | 'am'
     | 'ao'
+    | 'ar'
+    | 'at'
     | 'au'
+    | 'az'
+    | 'ba'
+    | 'bb'
+    | 'bd'
+    | 'be'
+    | 'bf'
+    | 'bg'
+    | 'bh'
+    | 'bi'
+    | 'bj'
+    | 'bn'
+    | 'bo'
     | 'br'
+    | 'bs'
+    | 'bt'
+    | 'bw'
+    | 'by'
+    | 'bz'
     | 'ca'
+    | 'cd'
+    | 'cf'
+    | 'cg'
+    | 'ch'
+    | 'ci'
+    | 'cl'
+    | 'cm'
     | 'cn'
+    | 'co'
+    | 'cr'
+    | 'cu'
+    | 'cv'
+    | 'cy'
+    | 'cz'
     | 'de'
+    | 'dj'
+    | 'dk'
+    | 'dm'
+    | 'do'
     | 'dz'
+    | 'ec'
+    | 'ee'
+    | 'eg'
+    | 'er'
     | 'es'
+    | 'et'
+    | 'fj'
+    | 'fm'
     | 'fr'
+    | 'ga'
     | 'gb'
+    | 'gd'
+    | 'ge'
+    | 'gh'
+    | 'gm'
+    | 'gn'
+    | 'gq'
+    | 'gr'
+    | 'gt'
+    | 'gw'
+    | 'gy'
     | 'hk'
+    | 'hn'
+    | 'hr'
+    | 'ht'
+    | 'hu'
+    | 'id'
+    | 'ie'
+    | 'il'
     | 'in'
+    | 'iq'
+    | 'ir'
+    | 'is'
     | 'it'
+    | 'jm'
+    | 'jo'
     | 'jp'
+    | 'ke'
+    | 'kg'
+    | 'kh'
+    | 'ki'
+    | 'km'
+    | 'kn'
     | 'kr'
+    | 'kw'
+    | 'kz'
+    | 'la'
+    | 'lb'
+    | 'lc'
+    | 'li'
+    | 'lk'
+    | 'lr'
+    | 'ls'
+    | 'lt'
+    | 'lu'
+    | 'lv'
+    | 'ly'
+    | 'ma'
+    | 'mc'
+    | 'md'
+    | 'me'
+    | 'mg'
+    | 'mh'
+    | 'mk'
+    | 'ml'
+    | 'mm'
+    | 'mn'
+    | 'mr'
+    | 'mt'
+    | 'mu'
+    | 'mv'
+    | 'mw'
+    | 'mx'
+    | 'mz'
+    | 'na'
+    | 'ne'
+    | 'ng'
+    | 'ni'
     | 'nl'
+    | 'no'
+    | 'np'
+    | 'nr'
+    | 'nz'
+    | 'om'
+    | 'pa'
+    | 'pe'
+    | 'pg'
+    | 'ph'
+    | 'pk'
+    | 'pl'
+    | 'ps'
+    | 'pt'
+    | 'pw'
+    | 'py'
+    | 'qa'
+    | 'ro'
+    | 'rs'
+    | 'ru'
+    | 'rw'
+    | 'sa'
+    | 'sb'
+    | 'sc'
+    | 'sd'
+    | 'se'
     | 'sg'
+    | 'sl'
+    | 'sm'
+    | 'sn'
+    | 'so'
+    | 'sr'
+    | 'st'
+    | 'sv'
+    | 'sy'
+    | 'sz'
+    | 'td'
+    | 'tg'
+    | 'th'
+    | 'tj'
+    | 'tl'
+    | 'tm'
+    | 'tn'
+    | 'to'
+    | 'tr'
+    | 'tt'
+    | 'tv'
     | 'tw'
-    | 'us';
-  /**
-   * Search term for path or description
+    | 'tz'
+    | 'ua'
+    | 'ug'
+    | 'us'
+    | 'uy'
+    | 'uz'
+    | 'va'
+    | 'vc'
+    | 've'
+    | 'vn'
+    | 'vu'
+    | 'ws'
+    | 'ye'
+    | 'za'
+    | 'zm'
+    | 'zw';
+  /**
+   * Search term for path, description, aliases, or localized display name
    */
   search?: string;
   /**
@@ -6347,7 +6736,7 @@ export type AccountStandardsControllerGetTemplateMetadataData = {
    */
   path: string;
   /**
-   * Region code for tenant context
+   * Region code for tenant context. Not-yet-open codes degrade to the universal-only catalog (#759)
    */
   region:
     | 'ad'
@@ -6357,24 +6746,190 @@ export type AccountStandardsControllerGetTemplateMetadataData = {
     | 'al'
     | 'am'
     | 'ao'
+    | 'ar'
+    | 'at'
     | 'au'
+    | 'az'
+    | 'ba'
+    | 'bb'
+    | 'bd'
+    | 'be'
+    | 'bf'
+    | 'bg'
+    | 'bh'
+    | 'bi'
+    | 'bj'
+    | 'bn'
+    | 'bo'
     | 'br'
+    | 'bs'
+    | 'bt'
+    | 'bw'
+    | 'by'
+    | 'bz'
     | 'ca'
+    | 'cd'
+    | 'cf'
+    | 'cg'
+    | 'ch'
+    | 'ci'
+    | 'cl'
+    | 'cm'
     | 'cn'
+    | 'co'
+    | 'cr'
+    | 'cu'
+    | 'cv'
+    | 'cy'
+    | 'cz'
     | 'de'
+    | 'dj'
+    | 'dk'
+    | 'dm'
+    | 'do'
     | 'dz'
+    | 'ec'
+    | 'ee'
+    | 'eg'
+    | 'er'
     | 'es'
+    | 'et'
+    | 'fj'
+    | 'fm'
     | 'fr'
+    | 'ga'
     | 'gb'
+    | 'gd'
+    | 'ge'
+    | 'gh'
+    | 'gm'
+    | 'gn'
+    | 'gq'
+    | 'gr'
+    | 'gt'
+    | 'gw'
+    | 'gy'
     | 'hk'
+    | 'hn'
+    | 'hr'
+    | 'ht'
+    | 'hu'
+    | 'id'
+    | 'ie'
+    | 'il'
     | 'in'
+    | 'iq'
+    | 'ir'
+    | 'is'
     | 'it'
+    | 'jm'
+    | 'jo'
     | 'jp'
+    | 'ke'
+    | 'kg'
+    | 'kh'
+    | 'ki'
+    | 'km'
+    | 'kn'
     | 'kr'
+    | 'kw'
+    | 'kz'
+    | 'la'
+    | 'lb'
+    | 'lc'
+    | 'li'
+    | 'lk'
+    | 'lr'
+    | 'ls'
+    | 'lt'
+    | 'lu'
+    | 'lv'
+    | 'ly'
+    | 'ma'
+    | 'mc'
+    | 'md'
+    | 'me'
+    | 'mg'
+    | 'mh'
+    | 'mk'
+    | 'ml'
+    | 'mm'
+    | 'mn'
+    | 'mr'
+    | 'mt'
+    | 'mu'
+    | 'mv'
+    | 'mw'
+    | 'mx'
+    | 'mz'
+    | 'na'
+    | 'ne'
+    | 'ng'
+    | 'ni'
     | 'nl'
+    | 'no'
+    | 'np'
+    | 'nr'
+    | 'nz'
+    | 'om'
+    | 'pa'
+    | 'pe'
+    | 'pg'
+    | 'ph'
+    | 'pk'
+    | 'pl'
+    | 'ps'
+    | 'pt'
+    | 'pw'
+    | 'py'
+    | 'qa'
+    | 'ro'
+    | 'rs'
+    | 'ru'
+    | 'rw'
+    | 'sa'
+    | 'sb'
+    | 'sc'
+    | 'sd'
+    | 'se'
     | 'sg'
+    | 'sl'
+    | 'sm'
+    | 'sn'
+    | 'so'
+    | 'sr'
+    | 'st'
+    | 'sv'
+    | 'sy'
+    | 'sz'
+    | 'td'
+    | 'tg'
+    | 'th'
+    | 'tj'
+    | 'tl'
+    | 'tm'
+    | 'tn'
+    | 'to'
+    | 'tr'
+    | 'tt'
+    | 'tv'
     | 'tw'
-    | 'us';
+    | 'tz'
+    | 'ua'
+    | 'ug'
+    | 'us'
+    | 'uy'
+    | 'uz'
+    | 'va'
+    | 'vc'
+    | 've'
+    | 'vn'
+    | 'vu'
+    | 'ws'
+    | 'ye'
+    | 'za'
+    | 'zm'
+    | 'zw';
 };
 
 export type AccountStandardsControllerGetTemplateMetadataResponse =
@@ -6382,7 +6937,7 @@ export type AccountStandardsControllerGetTemplateMetadataResponse =
 
 export type AccountStandardsControllerGetRegionsData = {
   /**
-   * Region code for tenant context
+   * Region code for tenant context. Not-yet-open codes degrade to the universal-only catalog (#759)
    */
   region:
     | 'ad'
@@ -6392,24 +6947,190 @@ export type AccountStandardsControllerGetRegionsData = {
     | 'al'
     | 'am'
     | 'ao'
+    | 'ar'
+    | 'at'
     | 'au'
+    | 'az'
+    | 'ba'
+    | 'bb'
+    | 'bd'
+    | 'be'
+    | 'bf'
+    | 'bg'
+    | 'bh'
+    | 'bi'
+    | 'bj'
+    | 'bn'
+    | 'bo'
     | 'br'
+    | 'bs'
+    | 'bt'
+    | 'bw'
+    | 'by'
+    | 'bz'
     | 'ca'
+    | 'cd'
+    | 'cf'
+    | 'cg'
+    | 'ch'
+    | 'ci'
+    | 'cl'
+    | 'cm'
     | 'cn'
+    | 'co'
+    | 'cr'
+    | 'cu'
+    | 'cv'
+    | 'cy'
+    | 'cz'
     | 'de'
+    | 'dj'
+    | 'dk'
+    | 'dm'
+    | 'do'
     | 'dz'
+    | 'ec'
+    | 'ee'
+    | 'eg'
+    | 'er'
     | 'es'
+    | 'et'
+    | 'fj'
+    | 'fm'
     | 'fr'
+    | 'ga'
     | 'gb'
+    | 'gd'
+    | 'ge'
+    | 'gh'
+    | 'gm'
+    | 'gn'
+    | 'gq'
+    | 'gr'
+    | 'gt'
+    | 'gw'
+    | 'gy'
     | 'hk'
+    | 'hn'
+    | 'hr'
+    | 'ht'
+    | 'hu'
+    | 'id'
+    | 'ie'
+    | 'il'
     | 'in'
+    | 'iq'
+    | 'ir'
+    | 'is'
     | 'it'
+    | 'jm'
+    | 'jo'
     | 'jp'
+    | 'ke'
+    | 'kg'
+    | 'kh'
+    | 'ki'
+    | 'km'
+    | 'kn'
     | 'kr'
+    | 'kw'
+    | 'kz'
+    | 'la'
+    | 'lb'
+    | 'lc'
+    | 'li'
+    | 'lk'
+    | 'lr'
+    | 'ls'
+    | 'lt'
+    | 'lu'
+    | 'lv'
+    | 'ly'
+    | 'ma'
+    | 'mc'
+    | 'md'
+    | 'me'
+    | 'mg'
+    | 'mh'
+    | 'mk'
+    | 'ml'
+    | 'mm'
+    | 'mn'
+    | 'mr'
+    | 'mt'
+    | 'mu'
+    | 'mv'
+    | 'mw'
+    | 'mx'
+    | 'mz'
+    | 'na'
+    | 'ne'
+    | 'ng'
+    | 'ni'
     | 'nl'
+    | 'no'
+    | 'np'
+    | 'nr'
+    | 'nz'
+    | 'om'
+    | 'pa'
+    | 'pe'
+    | 'pg'
+    | 'ph'
+    | 'pk'
+    | 'pl'
+    | 'ps'
+    | 'pt'
+    | 'pw'
+    | 'py'
+    | 'qa'
+    | 'ro'
+    | 'rs'
+    | 'ru'
+    | 'rw'
+    | 'sa'
+    | 'sb'
+    | 'sc'
+    | 'sd'
+    | 'se'
     | 'sg'
+    | 'sl'
+    | 'sm'
+    | 'sn'
+    | 'so'
+    | 'sr'
+    | 'st'
+    | 'sv'
+    | 'sy'
+    | 'sz'
+    | 'td'
+    | 'tg'
+    | 'th'
+    | 'tj'
+    | 'tl'
+    | 'tm'
+    | 'tn'
+    | 'to'
+    | 'tr'
+    | 'tt'
+    | 'tv'
     | 'tw'
-    | 'us';
+    | 'tz'
+    | 'ua'
+    | 'ug'
+    | 'us'
+    | 'uy'
+    | 'uz'
+    | 'va'
+    | 'vc'
+    | 've'
+    | 'vn'
+    | 'vu'
+    | 'ws'
+    | 'ye'
+    | 'za'
+    | 'zm'
+    | 'zw';
 };
 
 export type AccountStandardsControllerGetRegionsResponse =
@@ -6459,7 +7180,7 @@ export type TransactionControllerListData = {
    */
   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
+   * Filter by ADR-0075 functional category (Group segment); matches any posting to an account whose derived Group segment equals this value. Must be accompanied by flow (ADR-0126).
    */
   category?: string;
   /**
@@ -6470,6 +7191,10 @@ export type TransactionControllerListData = {
    * Filter by end date (inclusive), format: YYYY-MM-DD
    */
   dateTo?: string;
+  /**
+   * Required when category is present (400 otherwise) and vice versa (ADR-0126). Restricts the category account set to the flow root (income → Income:, expense → Expenses:) and drives the per-leg sign normalization of row viewpointAmount and the summary. OpenAPI cannot express conditional requiredness — the pairing is enforced at runtime.
+   */
+  flow?: 'income' | 'expense';
   /**
    * Number of items per page (1-100, default: 20)
    */
@@ -6512,9 +7237,9 @@ export type TransactionControllerListData = {
    */
   search?: string;
   /**
-   * Filter by transaction status
+   * Filter by transaction status: single value, comma-separated multi-value (e.g. VOIDED,SUPERSEDED), or ALL to include audit rows. Defaults to ACTIVE-only (ADR-0128; previously unfiltered — breaking change).
    */
-  status?: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
+  status?: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED' | 'ALL';
 };
 
 export type TransactionControllerListResponse = TransactionListResponseDto;
@@ -7271,8 +7996,7 @@ export type PayeeProfileAdminControllerUnverifyData = {
   id: string;
 };
 
-export type PayeeProfileAdminControllerUnverifyResponse =
-  PayeeProfileResponseDto;
+export type PayeeProfileAdminControllerUnverifyResponse = void;
 
 export type CommodityControllerCreateData = {
   /**
@@ -7536,7 +8260,168 @@ export type CommodityControllerBulkCreateData = {
     | 'us';
 };
 
-export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
+export type CommodityControllerBulkCreateResponse = Array<CommodityResponseDto>;
+
+export type ReportingControllerGetPortfolioTrendsData = {
+  /**
+   * Data granularity
+   */
+  granularity?: 'day' | 'week' | 'month';
+  /**
+   * Time period
+   */
+  period?: '1m' | '3m' | '6m' | '1y';
+  /**
+   * Region code for tenant context
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+};
+
+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:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+};
+
+export type ReportingControllerGetCashFlowTrendsResponse =
+  CashFlowTrendsResponseDto;
+
+export type ReportingControllerGenerateSnapshotData = {
+  /**
+   * Region code for tenant context
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  /**
+   * Optional date (defaults to today)
+   */
+  requestBody: GenerateSnapshotBody;
+};
+
+export type ReportingControllerGenerateSnapshotResponse =
+  GenerateSnapshotResponse;
+
+export type ReportingControllerBackfillSnapshotsData = {
+  /**
+   * Region code for tenant context
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  requestBody: BackfillSnapshotsBody;
+};
+
+export type ReportingControllerBackfillSnapshotsResponse =
+  BackfillSnapshotsResponse;
 
 export type PriceControllerCreateData = {
   /**
@@ -7785,6 +8670,93 @@ export type PriceControllerBulkCreateData = {
 
 export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
 
+export type UserControllerDeleteOwnUserData = {
+  requestBody: DeleteOwnUserDto;
+};
+
+export type UserControllerDeleteOwnUserResponse = void;
+
+export type UserControllerGetUserData = {
+  acceptLanguage: string;
+};
+
+export type UserControllerGetUserResponse = UserResponseDto;
+
+export type UserControllerSignupUserData = {
+  requestBody: SignupDto;
+};
+
+export type UserControllerSignupUserResponse = SignupResponseDto;
+
+export type UserControllerDeleteUserData = {
+  /**
+   * User ID to delete
+   */
+  id: string;
+};
+
+export type UserControllerDeleteUserResponse = void;
+
+export type UserControllerGetUserInfoData = {
+  /**
+   * User ID
+   */
+  id: string;
+};
+
+export type UserControllerGetUserInfoResponse = unknown;
+
+export type UserControllerUpdateUserSettingData = {
+  requestBody: UpdateUserSettingDto;
+};
+
+export type UserControllerUpdateUserSettingResponse = unknown;
+
+export type UserControllerGetAllUserSettingsByPageData = {
+  /**
+   * Page number
+   */
+  pageNo: number;
+  /**
+   * Page size
+   */
+  pageSize: number;
+};
+
+export type UserControllerGetAllUserSettingsByPageResponse = unknown;
+
+export type UserControllerGetAssetLiabilitySummaryResponse = unknown;
+
+export type PropertyControllerGetAllResponse = unknown;
+
+export type PropertyControllerGetByKeyData = {
+  /**
+   * Property key
+   */
+  key: string;
+};
+
+export type PropertyControllerGetByKeyResponse = unknown;
+
+export type PropertyControllerUpdateData = {
+  /**
+   * Property key
+   */
+  key: string;
+  requestBody: UpdatePropertyDto;
+};
+
+export type PropertyControllerUpdateResponse = unknown;
+
+export type PropertyControllerDeleteData = {
+  /**
+   * Property key
+   */
+  key: string;
+};
+
+export type PropertyControllerDeleteResponse = void;
+
 export type RecurringRuleControllerCreateData = {
   /**
    * Region code for tenant context
@@ -8261,8 +9233,7 @@ export type ExpectedTransactionControllerUndoSkipData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerUndoSkipResponse =
-  ExpectedTransactionResponseDto;
+export type ExpectedTransactionControllerUndoSkipResponse = void;
 
 export type ExpectedTransactionControllerConfirmMatchData = {
   /**
@@ -8339,7 +9310,7 @@ export type ExpectedTransactionControllerUnmatchData = {
     | 'us';
 };
 
-export type ExpectedTransactionControllerUnmatchResponse = unknown;
+export type ExpectedTransactionControllerUnmatchResponse = void;
 
 export type ExpectedTransactionControllerEnterNowData = {
   /**
@@ -8380,170 +9351,11 @@ export type ExpectedTransactionControllerEnterNowData = {
 
 export type ExpectedTransactionControllerEnterNowResponse = unknown;
 
-export type ForecastControllerGetForecastData = {
-  /**
-   * Number of months to forecast (1-12, default 3)
-   */
-  months?: number;
-  /**
-   * Region code for tenant context
-   */
-  region:
-    | 'ad'
-    | 'ae'
-    | 'af'
-    | 'ag'
-    | 'al'
-    | 'am'
-    | 'ao'
-    | 'au'
-    | 'br'
-    | 'ca'
-    | 'cn'
-    | 'de'
-    | 'dz'
-    | 'es'
-    | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-};
-
-export type ForecastControllerGetForecastResponse = ForecastResponseDto;
-
-export type ReportingControllerGetPortfolioTrendsData = {
-  /**
-   * Data granularity
-   */
-  granularity?: 'day' | 'week' | 'month';
-  /**
-   * Time period
-   */
-  period?: '1m' | '3m' | '6m' | '1y';
-  /**
-   * Region code for tenant context
-   */
-  region:
-    | 'ad'
-    | 'ae'
-    | 'af'
-    | 'ag'
-    | 'al'
-    | 'am'
-    | 'ao'
-    | 'au'
-    | 'br'
-    | 'ca'
-    | 'cn'
-    | 'de'
-    | 'dz'
-    | 'es'
-    | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-};
-
-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:
-    | 'ad'
-    | 'ae'
-    | 'af'
-    | 'ag'
-    | 'al'
-    | 'am'
-    | 'ao'
-    | 'au'
-    | 'br'
-    | 'ca'
-    | 'cn'
-    | 'de'
-    | 'dz'
-    | 'es'
-    | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-};
-
-export type ReportingControllerGetCashFlowTrendsResponse =
-  CashFlowTrendsResponseDto;
-
-export type ReportingControllerGenerateSnapshotData = {
-  /**
-   * Region code for tenant context
-   */
-  region:
-    | 'ad'
-    | 'ae'
-    | 'af'
-    | 'ag'
-    | 'al'
-    | 'am'
-    | 'ao'
-    | 'au'
-    | 'br'
-    | 'ca'
-    | 'cn'
-    | 'de'
-    | 'dz'
-    | 'es'
-    | 'fr'
-    | 'gb'
-    | 'hk'
-    | 'in'
-    | 'it'
-    | 'jp'
-    | 'kr'
-    | 'nl'
-    | 'sg'
-    | 'tw'
-    | 'us';
-  /**
-   * Optional date (defaults to today)
-   */
-  requestBody: GenerateSnapshotBody;
-};
-
-export type ReportingControllerGenerateSnapshotResponse =
-  GenerateSnapshotResponse;
-
-export type ReportingControllerBackfillSnapshotsData = {
+export type ForecastControllerGetForecastData = {
+  /**
+   * Number of months to forecast (1-12, default 3)
+   */
+  months?: number;
   /**
    * Region code for tenant context
    */
@@ -8573,98 +9385,9 @@ export type ReportingControllerBackfillSnapshotsData = {
     | 'sg'
     | 'tw'
     | 'us';
-  requestBody: BackfillSnapshotsBody;
-};
-
-export type ReportingControllerBackfillSnapshotsResponse =
-  BackfillSnapshotsResponse;
-
-export type UserControllerDeleteOwnUserData = {
-  requestBody: DeleteOwnUserDto;
-};
-
-export type UserControllerDeleteOwnUserResponse = void;
-
-export type UserControllerGetUserData = {
-  acceptLanguage: string;
-};
-
-export type UserControllerGetUserResponse = UserResponseDto;
-
-export type UserControllerSignupUserData = {
-  requestBody: SignupDto;
-};
-
-export type UserControllerSignupUserResponse = SignupResponseDto;
-
-export type UserControllerDeleteUserData = {
-  /**
-   * User ID to delete
-   */
-  id: string;
-};
-
-export type UserControllerDeleteUserResponse = void;
-
-export type UserControllerGetUserInfoData = {
-  /**
-   * User ID
-   */
-  id: string;
-};
-
-export type UserControllerGetUserInfoResponse = unknown;
-
-export type UserControllerUpdateUserSettingData = {
-  requestBody: UpdateUserSettingDto;
-};
-
-export type UserControllerUpdateUserSettingResponse = unknown;
-
-export type UserControllerGetAllUserSettingsByPageData = {
-  /**
-   * Page number
-   */
-  pageNo: number;
-  /**
-   * Page size
-   */
-  pageSize: number;
-};
-
-export type UserControllerGetAllUserSettingsByPageResponse = unknown;
-
-export type UserControllerGetAssetLiabilitySummaryResponse = unknown;
-
-export type PropertyControllerGetAllResponse = unknown;
-
-export type PropertyControllerGetByKeyData = {
-  /**
-   * Property key
-   */
-  key: string;
-};
-
-export type PropertyControllerGetByKeyResponse = unknown;
-
-export type PropertyControllerUpdateData = {
-  /**
-   * Property key
-   */
-  key: string;
-  requestBody: UpdatePropertyDto;
-};
-
-export type PropertyControllerUpdateResponse = unknown;
-
-export type PropertyControllerDeleteData = {
-  /**
-   * Property key
-   */
-  key: string;
 };
 
-export type PropertyControllerDeleteResponse = void;
+export type ForecastControllerGetForecastResponse = ForecastResponseDto;
 
 export type TransactionRuleControllerCreateData = {
   /**
@@ -9360,7 +10083,7 @@ export type EventControllerGetSliceResponse = unknown;
 
 export type OnboardingControllerBootstrapData = {
   /**
-   * Region code for tenant context
+   * Region code for tenant context. Not-yet-open codes are accepted: the universal catalog backs onboarding regardless of region (#759)
    */
   region:
     | 'ad'
@@ -9370,24 +10093,190 @@ export type OnboardingControllerBootstrapData = {
     | 'al'
     | 'am'
     | 'ao'
+    | 'ar'
+    | 'at'
     | 'au'
+    | 'az'
+    | 'ba'
+    | 'bb'
+    | 'bd'
+    | 'be'
+    | 'bf'
+    | 'bg'
+    | 'bh'
+    | 'bi'
+    | 'bj'
+    | 'bn'
+    | 'bo'
     | 'br'
+    | 'bs'
+    | 'bt'
+    | 'bw'
+    | 'by'
+    | 'bz'
     | 'ca'
+    | 'cd'
+    | 'cf'
+    | 'cg'
+    | 'ch'
+    | 'ci'
+    | 'cl'
+    | 'cm'
     | 'cn'
+    | 'co'
+    | 'cr'
+    | 'cu'
+    | 'cv'
+    | 'cy'
+    | 'cz'
     | 'de'
+    | 'dj'
+    | 'dk'
+    | 'dm'
+    | 'do'
     | 'dz'
+    | 'ec'
+    | 'ee'
+    | 'eg'
+    | 'er'
     | 'es'
+    | 'et'
+    | 'fj'
+    | 'fm'
     | 'fr'
+    | 'ga'
     | 'gb'
+    | 'gd'
+    | 'ge'
+    | 'gh'
+    | 'gm'
+    | 'gn'
+    | 'gq'
+    | 'gr'
+    | 'gt'
+    | 'gw'
+    | 'gy'
     | 'hk'
+    | 'hn'
+    | 'hr'
+    | 'ht'
+    | 'hu'
+    | 'id'
+    | 'ie'
+    | 'il'
     | 'in'
+    | 'iq'
+    | 'ir'
+    | 'is'
     | 'it'
+    | 'jm'
+    | 'jo'
     | 'jp'
+    | 'ke'
+    | 'kg'
+    | 'kh'
+    | 'ki'
+    | 'km'
+    | 'kn'
     | 'kr'
+    | 'kw'
+    | 'kz'
+    | 'la'
+    | 'lb'
+    | 'lc'
+    | 'li'
+    | 'lk'
+    | 'lr'
+    | 'ls'
+    | 'lt'
+    | 'lu'
+    | 'lv'
+    | 'ly'
+    | 'ma'
+    | 'mc'
+    | 'md'
+    | 'me'
+    | 'mg'
+    | 'mh'
+    | 'mk'
+    | 'ml'
+    | 'mm'
+    | 'mn'
+    | 'mr'
+    | 'mt'
+    | 'mu'
+    | 'mv'
+    | 'mw'
+    | 'mx'
+    | 'mz'
+    | 'na'
+    | 'ne'
+    | 'ng'
+    | 'ni'
     | 'nl'
+    | 'no'
+    | 'np'
+    | 'nr'
+    | 'nz'
+    | 'om'
+    | 'pa'
+    | 'pe'
+    | 'pg'
+    | 'ph'
+    | 'pk'
+    | 'pl'
+    | 'ps'
+    | 'pt'
+    | 'pw'
+    | 'py'
+    | 'qa'
+    | 'ro'
+    | 'rs'
+    | 'ru'
+    | 'rw'
+    | 'sa'
+    | 'sb'
+    | 'sc'
+    | 'sd'
+    | 'se'
     | 'sg'
+    | 'sl'
+    | 'sm'
+    | 'sn'
+    | 'so'
+    | 'sr'
+    | 'st'
+    | 'sv'
+    | 'sy'
+    | 'sz'
+    | 'td'
+    | 'tg'
+    | 'th'
+    | 'tj'
+    | 'tl'
+    | 'tm'
+    | 'tn'
+    | 'to'
+    | 'tr'
+    | 'tt'
+    | 'tv'
     | 'tw'
-    | 'us';
+    | 'tz'
+    | 'ua'
+    | 'ug'
+    | 'us'
+    | 'uy'
+    | 'uz'
+    | 'va'
+    | 'vc'
+    | 've'
+    | 'vn'
+    | 'vu'
+    | 'ws'
+    | 'ye'
+    | 'za'
+    | 'zm'
+    | 'zw';
   requestBody: OnboardingDto;
 };
 
@@ -9538,7 +10427,7 @@ export type ReconciliationControllerHistoryData = {
 export type ReconciliationControllerHistoryResponse =
   Array<ReconciliationRecordDto>;
 
-export type ExportControllerExportBeancountResponse = unknown;
+export type ExportControllerExportBeancountResponse = Blob | File;
 
 export type FileImportControllerImportFileData = {
   /**
@@ -10296,6 +11185,24 @@ export type PlatformControllerMatchPlatformsData = {
 
 export type PlatformControllerMatchPlatformsResponse = PlatformMatchResponseDto;
 
+export type PlatformControllerGetPlatformStandardsData = {
+  /**
+   * Platform ID (from a match result)
+   */
+  id: string;
+  /**
+   * Region code (ISO 3166-1 alpha-2, case-insensitive). Required for global platforms (countryCode null) — resolved as their template region; ignored when the platform has its own countryCode.
+   */
+  region?: string;
+  /**
+   * Filter templates by account type (path first segment)
+   */
+  type?: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
+};
+
+export type PlatformControllerGetPlatformStandardsResponse =
+  PlatformStandardsResponseDto;
+
 export type PlatformControllerUpdateData = {
   /**
    * Platform ID
@@ -10545,6 +11452,42 @@ export type AuthControllerAccessTokenLoginData = {
 
 export type AuthControllerAccessTokenLoginResponse = AnonymousLoginResponseDto;
 
+export type ParserContributionControllerCreateData = {
+  /**
+   * Region code for tenant context (routing only; the institution region rides in the payload meta)
+   */
+  region:
+    | 'ad'
+    | 'ae'
+    | 'af'
+    | 'ag'
+    | 'al'
+    | 'am'
+    | 'ao'
+    | 'au'
+    | 'br'
+    | 'ca'
+    | 'cn'
+    | 'de'
+    | 'dz'
+    | 'es'
+    | 'fr'
+    | 'gb'
+    | 'hk'
+    | 'in'
+    | 'it'
+    | 'jp'
+    | 'kr'
+    | 'nl'
+    | 'sg'
+    | 'tw'
+    | 'us';
+  requestBody: ParserContributionRequestDto;
+};
+
+export type ParserContributionControllerCreateResponse =
+  ParserContributionRelayResponseDto;
+
 export type CacheControllerFlushCacheResponse = unknown;
 
 export type ExchangeRateControllerGetExchangeRateData = {
@@ -11238,7 +12181,7 @@ export type $OpenApiTs = {
         /**
          * Payee profile unverified successfully
          */
-        200: PayeeProfileResponseDto;
+        204: void;
         /**
          * Admin access required
          */
@@ -11345,598 +12288,598 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/{region}/bean/prices': {
-    post: {
-      req: PriceControllerCreateData;
+  '/api/v1/{region}/reporting/portfolio/trends': {
+    get: {
+      req: ReportingControllerGetPortfolioTrendsData;
       res: {
         /**
-         * Price created successfully
-         */
-        201: PriceResponseDto;
-        /**
-         * Currency or quoteCurrency commodity not found
-         */
-        404: unknown;
-        /**
-         * Price already exists for this currency pair and date
+         * Trends retrieved successfully
          */
-        409: unknown;
-      };
-    };
-    get: {
-      req: PriceControllerFindAllData;
-      res: {
+        200: PortfolioTrendsResponseDto;
         /**
-         * Prices retrieved successfully
+         * User not authenticated
          */
-        200: PriceListResponseDto;
+        401: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/prices/{id}': {
+  '/api/v1/{region}/reporting/cash-flow/trends': {
     get: {
-      req: PriceControllerFindOneData;
-      res: {
-        /**
-         * Price retrieved successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
-         */
-        404: unknown;
-      };
-    };
-    put: {
-      req: PriceControllerUpdateData;
+      req: ReportingControllerGetCashFlowTrendsData;
       res: {
         /**
-         * Price updated successfully
-         */
-        200: PriceResponseDto;
-        /**
-         * Price not found
+         * Cash-flow trends retrieved successfully
          */
-        404: unknown;
+        200: CashFlowTrendsResponseDto;
         /**
-         * Updated price conflicts with existing price
+         * User not authenticated
          */
-        409: unknown;
+        401: unknown;
       };
     };
-    delete: {
-      req: PriceControllerDeleteData;
+  };
+  '/api/v1/{region}/reporting/snapshots/generate': {
+    post: {
+      req: ReportingControllerGenerateSnapshotData;
       res: {
         /**
-         * Price deleted successfully
+         * Snapshot generated successfully
          */
-        204: void;
+        200: GenerateSnapshotResponse;
         /**
-         * Price not found
+         * Invalid date format
          */
-        404: unknown;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/prices/bulk': {
-    post: {
-      req: PriceControllerBulkCreateData;
-      res: {
+        400: unknown;
         /**
-         * Prices created successfully
+         * User not authenticated
          */
-        201: Array<PriceResponseDto>;
+        401: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules': {
+  '/api/v1/{region}/reporting/snapshots/backfill': {
     post: {
-      req: RecurringRuleControllerCreateData;
+      req: ReportingControllerBackfillSnapshotsData;
       res: {
         /**
-         * Rule created successfully
+         * Backfill completed successfully
          */
-        201: RecurringRuleResponseDto;
+        200: BackfillSnapshotsResponse;
         /**
-         * Invalid input data (e.g., autoCreate without accounts)
+         * Invalid date format or range
          */
         400: unknown;
         /**
-         * Rule with same name already exists
+         * User not authenticated
          */
-        409: unknown;
-      };
-    };
-    get: {
-      req: RecurringRuleControllerFindAllData;
-      res: {
+        401: unknown;
         /**
-         * Rules retrieved successfully
+         * Backfill already in progress for this user
          */
-        200: Array<RecurringRuleResponseDto>;
+        409: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
+  '/api/v1/{region}/bean/prices': {
     post: {
-      req: RecurringRuleControllerCreateFromTransactionData;
+      req: PriceControllerCreateData;
       res: {
         /**
-         * Rule created successfully
+         * Price created successfully
+         */
+        201: PriceResponseDto;
+        /**
+         * Currency or quoteCurrency commodity not found
          */
-        201: RecurringRuleResponseDto;
+        404: unknown;
         /**
-         * Transaction not found
+         * Price already exists for this currency pair and date
          */
-        404: ApiProblemResponseDto;
+        409: unknown;
+      };
+    };
+    get: {
+      req: PriceControllerFindAllData;
+      res: {
         /**
-         * Rule with same name already exists or transaction already linked
+         * Prices retrieved successfully
          */
-        409: ApiProblemResponseDto;
+        200: PriceListResponseDto;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/{id}': {
+  '/api/v1/{region}/bean/prices/{id}': {
     get: {
-      req: RecurringRuleControllerFindOneData;
+      req: PriceControllerFindOneData;
       res: {
         /**
-         * Rule retrieved successfully
+         * Price retrieved successfully
          */
-        200: RecurringRuleResponseDto;
+        200: PriceResponseDto;
         /**
-         * Rule not found
+         * Price not found
          */
         404: unknown;
       };
     };
-    patch: {
-      req: RecurringRuleControllerUpdateData;
+    put: {
+      req: PriceControllerUpdateData;
       res: {
         /**
-         * Rule updated successfully
+         * Price updated successfully
          */
-        200: RecurringRuleResponseDto;
+        200: PriceResponseDto;
         /**
-         * Invalid input data
+         * Price not found
          */
-        400: unknown;
+        404: unknown;
         /**
-         * Rule not found
+         * Updated price conflicts with existing price
          */
-        404: unknown;
+        409: unknown;
       };
     };
     delete: {
-      req: RecurringRuleControllerDeleteData;
+      req: PriceControllerDeleteData;
       res: {
         /**
-         * Rule deleted successfully
+         * Price deleted successfully
          */
         204: void;
         /**
-         * Rule not found
+         * Price not found
          */
         404: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring-rules/{id}/stats': {
-    get: {
-      req: RecurringRuleControllerGetWithStatsData;
+  '/api/v1/{region}/bean/prices/bulk': {
+    post: {
+      req: PriceControllerBulkCreateData;
       res: {
         /**
-         * Rule with stats retrieved successfully
-         */
-        200: RecurringRuleWithStatsResponseDto;
-        /**
-         * Rule not found
+         * Prices created successfully
          */
-        404: unknown;
+        201: Array<PriceResponseDto>;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions': {
-    get: {
-      req: ExpectedTransactionControllerFindAllData;
+  '/api/v1/users': {
+    delete: {
+      req: UserControllerDeleteOwnUserData;
       res: {
         /**
-         * Expected transactions retrieved successfully
+         * User deleted successfully
          */
-        200: ExpectedTransactionListResponseDto;
-      };
-    };
-  };
-  '/api/v1/{region}/bean/expected-transactions/overdue': {
-    get: {
-      req: ExpectedTransactionControllerFindOverdueData;
-      res: {
+        204: void;
         /**
-         * Overdue transactions retrieved successfully
+         * Invalid access token
          */
-        200: ExpectedTransactionListResponseDto;
+        403: unknown;
       };
     };
-  };
-  '/api/v1/{region}/bean/expected-transactions/{id}': {
     get: {
-      req: ExpectedTransactionControllerFindOneData;
+      req: UserControllerGetUserData;
       res: {
         /**
-         * Expected transaction retrieved successfully
-         */
-        200: ExpectedTransactionResponseDto;
-        /**
-         * Expected transaction not found
+         * User retrieved successfully
          */
-        404: unknown;
+        200: UserResponseDto;
       };
     };
-  };
-  '/api/v1/{region}/bean/expected-transactions/{id}/skip': {
     post: {
-      req: ExpectedTransactionControllerSkipData;
+      req: UserControllerSignupUserData;
       res: {
         /**
-         * Expected transaction skipped successfully
+         * User created successfully
          */
-        200: ExpectedTransactionResponseDto;
+        201: SignupResponseDto;
         /**
-         * Cannot skip - not in PENDING status
+         * Invalid Turnstile token (when Turnstile is enabled)
          */
         400: unknown;
         /**
-         * Expected transaction not found
+         * User signup is disabled
          */
-        404: unknown;
+        403: unknown;
       };
     };
+  };
+  '/api/v1/users/{id}': {
     delete: {
-      req: ExpectedTransactionControllerUndoSkipData;
+      req: UserControllerDeleteUserData;
       res: {
         /**
-         * Skip undone successfully
-         */
-        200: ExpectedTransactionResponseDto;
-        /**
-         * Cannot undo - not in SKIPPED status
+         * User deleted successfully
          */
-        400: unknown;
+        204: void;
         /**
-         * Expected transaction not found
+         * Cannot delete own account or insufficient permissions
          */
-        404: unknown;
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions/{id}/match': {
-    post: {
-      req: ExpectedTransactionControllerConfirmMatchData;
+  '/api/v1/users/{id}/info': {
+    get: {
+      req: UserControllerGetUserInfoData;
       res: {
         /**
-         * Match confirmed successfully
+         * User info retrieved successfully
          */
         200: unknown;
         /**
-         * Cannot match - not in PENDING status
-         */
-        400: unknown;
-        /**
-         * Expected or actual transaction not found
-         */
-        404: unknown;
-        /**
-         * Actual transaction already matched to another rule
+         * Cannot access other user info without admin permission
          */
-        409: unknown;
+        403: unknown;
       };
     };
-    delete: {
-      req: ExpectedTransactionControllerUnmatchData;
+  };
+  '/api/v1/users/setting': {
+    put: {
+      req: UserControllerUpdateUserSettingData;
       res: {
         /**
-         * Match removed successfully
+         * Settings updated successfully
          */
         200: unknown;
         /**
-         * Cannot unmatch - not in COMPLETED status
-         */
-        400: unknown;
-        /**
-         * Expected transaction not found
+         * Insufficient permissions
          */
-        404: unknown;
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/expected-transactions/{id}/enter': {
-    post: {
-      req: ExpectedTransactionControllerEnterNowData;
+  '/api/v1/users/settings-by-page': {
+    get: {
+      req: UserControllerGetAllUserSettingsByPageData;
       res: {
         /**
-         * Transaction created successfully
-         */
-        201: unknown;
-        /**
-         * Cannot enter - not in PENDING status or missing accounts
-         */
-        400: unknown;
-        /**
-         * Expected transaction or accounts not found
+         * Settings list retrieved successfully
          */
-        404: unknown;
+        200: unknown;
       };
     };
   };
-  '/api/v1/{region}/bean/recurring/forecast': {
+  '/api/v1/users/asset-liability-summary': {
     get: {
-      req: ForecastControllerGetForecastData;
       res: {
         /**
-         * Forecast retrieved successfully
+         * Summary retrieved successfully
          */
-        200: ForecastResponseDto;
+        200: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/portfolio/trends': {
+  '/api/v1/admin/properties': {
     get: {
-      req: ReportingControllerGetPortfolioTrendsData;
       res: {
         /**
-         * Trends retrieved successfully
+         * Properties retrieved successfully
          */
-        200: PortfolioTrendsResponseDto;
+        200: unknown;
         /**
-         * User not authenticated
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/cash-flow/trends': {
+  '/api/v1/admin/properties/{key}': {
     get: {
-      req: ReportingControllerGetCashFlowTrendsData;
+      req: PropertyControllerGetByKeyData;
       res: {
         /**
-         * Cash-flow trends retrieved successfully
+         * Property retrieved successfully
          */
-        200: CashFlowTrendsResponseDto;
+        200: unknown;
         /**
-         * User not authenticated
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+        /**
+         * Property not found
+         */
+        404: unknown;
       };
     };
-  };
-  '/api/v1/{region}/reporting/snapshots/generate': {
-    post: {
-      req: ReportingControllerGenerateSnapshotData;
+    put: {
+      req: PropertyControllerUpdateData;
       res: {
         /**
-         * Snapshot generated successfully
+         * Property updated successfully
          */
-        200: GenerateSnapshotResponse;
+        200: unknown;
         /**
-         * Invalid date format
+         * Unauthorized
          */
-        400: unknown;
+        401: unknown;
         /**
-         * User not authenticated
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+      };
+    };
+    delete: {
+      req: PropertyControllerDeleteData;
+      res: {
+        /**
+         * Property deleted successfully
+         */
+        204: void;
+        /**
+         * Unauthorized
          */
         401: unknown;
+        /**
+         * Forbidden - insufficient permissions
+         */
+        403: unknown;
+        /**
+         * Property not found
+         */
+        404: unknown;
       };
     };
   };
-  '/api/v1/{region}/reporting/snapshots/backfill': {
+  '/api/v1/{region}/bean/recurring-rules': {
     post: {
-      req: ReportingControllerBackfillSnapshotsData;
+      req: RecurringRuleControllerCreateData;
       res: {
         /**
-         * Backfill completed successfully
+         * Rule created successfully
          */
-        200: BackfillSnapshotsResponse;
+        201: RecurringRuleResponseDto;
         /**
-         * Invalid date format or range
+         * Invalid input data (e.g., autoCreate without accounts)
          */
         400: unknown;
         /**
-         * User not authenticated
+         * Rule with same name already exists
          */
-        401: unknown;
+        409: unknown;
+      };
+    };
+    get: {
+      req: RecurringRuleControllerFindAllData;
+      res: {
         /**
-         * Backfill already in progress for this user
+         * Rules retrieved successfully
          */
-        409: unknown;
+        200: Array<RecurringRuleResponseDto>;
       };
     };
   };
-  '/api/v1/users': {
-    delete: {
-      req: UserControllerDeleteOwnUserData;
+  '/api/v1/{region}/bean/recurring-rules/from-transaction/{transactionId}': {
+    post: {
+      req: RecurringRuleControllerCreateFromTransactionData;
       res: {
         /**
-         * User deleted successfully
+         * Rule created successfully
          */
-        204: void;
+        201: RecurringRuleResponseDto;
         /**
-         * Invalid access token
+         * Transaction not found
          */
-        403: unknown;
+        404: ApiProblemResponseDto;
+        /**
+         * Rule with same name already exists or transaction already linked
+         */
+        409: ApiProblemResponseDto;
       };
     };
+  };
+  '/api/v1/{region}/bean/recurring-rules/{id}': {
     get: {
-      req: UserControllerGetUserData;
+      req: RecurringRuleControllerFindOneData;
       res: {
         /**
-         * User retrieved successfully
+         * Rule retrieved successfully
          */
-        200: UserResponseDto;
+        200: RecurringRuleResponseDto;
+        /**
+         * Rule not found
+         */
+        404: unknown;
       };
     };
-    post: {
-      req: UserControllerSignupUserData;
+    patch: {
+      req: RecurringRuleControllerUpdateData;
       res: {
         /**
-         * User created successfully
+         * Rule updated successfully
          */
-        201: SignupResponseDto;
+        200: RecurringRuleResponseDto;
         /**
-         * Invalid Turnstile token (when Turnstile is enabled)
+         * Invalid input data
          */
         400: unknown;
         /**
-         * User signup is disabled
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
-  };
-  '/api/v1/users/{id}': {
     delete: {
-      req: UserControllerDeleteUserData;
+      req: RecurringRuleControllerDeleteData;
       res: {
         /**
-         * User deleted successfully
+         * Rule deleted successfully
          */
         204: void;
         /**
-         * Cannot delete own account or insufficient permissions
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
   };
-  '/api/v1/users/{id}/info': {
+  '/api/v1/{region}/bean/recurring-rules/{id}/stats': {
     get: {
-      req: UserControllerGetUserInfoData;
+      req: RecurringRuleControllerGetWithStatsData;
       res: {
         /**
-         * User info retrieved successfully
+         * Rule with stats retrieved successfully
          */
-        200: unknown;
+        200: RecurringRuleWithStatsResponseDto;
         /**
-         * Cannot access other user info without admin permission
+         * Rule not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
   };
-  '/api/v1/users/setting': {
-    put: {
-      req: UserControllerUpdateUserSettingData;
+  '/api/v1/{region}/bean/expected-transactions': {
+    get: {
+      req: ExpectedTransactionControllerFindAllData;
       res: {
         /**
-         * Settings updated successfully
-         */
-        200: unknown;
-        /**
-         * Insufficient permissions
+         * Expected transactions retrieved successfully
          */
-        403: unknown;
+        200: ExpectedTransactionListResponseDto;
       };
     };
   };
-  '/api/v1/users/settings-by-page': {
+  '/api/v1/{region}/bean/expected-transactions/overdue': {
     get: {
-      req: UserControllerGetAllUserSettingsByPageData;
+      req: ExpectedTransactionControllerFindOverdueData;
       res: {
         /**
-         * Settings list retrieved successfully
+         * Overdue transactions retrieved successfully
          */
-        200: unknown;
+        200: ExpectedTransactionListResponseDto;
       };
     };
   };
-  '/api/v1/users/asset-liability-summary': {
+  '/api/v1/{region}/bean/expected-transactions/{id}': {
     get: {
+      req: ExpectedTransactionControllerFindOneData;
       res: {
         /**
-         * Summary retrieved successfully
+         * Expected transaction retrieved successfully
          */
-        200: unknown;
+        200: ExpectedTransactionResponseDto;
+        /**
+         * Expected transaction not found
+         */
+        404: unknown;
       };
     };
   };
-  '/api/v1/admin/properties': {
-    get: {
+  '/api/v1/{region}/bean/expected-transactions/{id}/skip': {
+    post: {
+      req: ExpectedTransactionControllerSkipData;
       res: {
         /**
-         * Properties retrieved successfully
+         * Expected transaction skipped successfully
          */
-        200: unknown;
+        200: ExpectedTransactionResponseDto;
         /**
-         * Unauthorized
+         * Cannot skip - not in PENDING status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected transaction not found
          */
-        403: unknown;
+        404: unknown;
       };
     };
-  };
-  '/api/v1/admin/properties/{key}': {
-    get: {
-      req: PropertyControllerGetByKeyData;
+    delete: {
+      req: ExpectedTransactionControllerUndoSkipData;
       res: {
         /**
-         * Property retrieved successfully
-         */
-        200: unknown;
-        /**
-         * Unauthorized
+         * Skip undone successfully
          */
-        401: unknown;
+        204: void;
         /**
-         * Forbidden - insufficient permissions
+         * Cannot undo - not in SKIPPED status
          */
-        403: unknown;
+        400: unknown;
         /**
-         * Property not found
+         * Expected transaction not found
          */
         404: unknown;
       };
     };
-    put: {
-      req: PropertyControllerUpdateData;
+  };
+  '/api/v1/{region}/bean/expected-transactions/{id}/match': {
+    post: {
+      req: ExpectedTransactionControllerConfirmMatchData;
       res: {
         /**
-         * Property updated successfully
+         * Match confirmed successfully
          */
         200: unknown;
         /**
-         * Unauthorized
+         * Cannot match - not in PENDING status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected or actual transaction not found
          */
-        403: unknown;
+        404: unknown;
+        /**
+         * Actual transaction already matched to another rule
+         */
+        409: unknown;
       };
     };
     delete: {
-      req: PropertyControllerDeleteData;
+      req: ExpectedTransactionControllerUnmatchData;
       res: {
         /**
-         * Property deleted successfully
+         * Match removed successfully
          */
         204: void;
         /**
-         * Unauthorized
+         * Cannot unmatch - not in COMPLETED status
          */
-        401: unknown;
+        400: unknown;
         /**
-         * Forbidden - insufficient permissions
+         * Expected transaction not found
          */
-        403: unknown;
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/expected-transactions/{id}/enter': {
+    post: {
+      req: ExpectedTransactionControllerEnterNowData;
+      res: {
         /**
-         * Property not found
+         * Transaction created successfully
+         */
+        201: unknown;
+        /**
+         * Cannot enter - not in PENDING status or missing accounts
+         */
+        400: unknown;
+        /**
+         * Expected transaction or accounts not found
          */
         404: unknown;
       };
     };
   };
+  '/api/v1/{region}/bean/recurring/forecast': {
+    get: {
+      req: ForecastControllerGetForecastData;
+      res: {
+        /**
+         * Forecast retrieved successfully
+         */
+        200: ForecastResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/transaction-rules': {
     post: {
       req: TransactionRuleControllerCreateData;
@@ -12334,7 +13277,10 @@ export type $OpenApiTs = {
   '/api/v1/{region}/bean/export/beancount': {
     get: {
       res: {
-        200: unknown;
+        /**
+         * ZIP archive (application/zip) streamed as an attachment
+         */
+        200: Blob | File;
       };
     };
   };
@@ -12715,6 +13661,17 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/bean/platforms/{id}/standards': {
+    get: {
+      req: PlatformControllerGetPlatformStandardsData;
+      res: {
+        /**
+         * Resolved region plus the merged account-standard catalog of that region (groupable by productCategory client-side)
+         */
+        200: PlatformStandardsResponseDto;
+      };
+    };
+  };
   '/api/v1/bean/platforms/{id}': {
     put: {
       req: PlatformControllerUpdateData;
@@ -12862,10 +13819,48 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/community/parser-contributions': {
+    post: {
+      req: ParserContributionControllerCreateData;
+      res: {
+        /**
+         * Issue created by the bot
+         */
+        201: ParserContributionRelayResponseDto;
+        /**
+         * Unauthorized
+         */
+        401: ApiProblemResponseDto;
+        /**
+         * Validation failed (institution slug, empty samples, row/cell size limits)
+         */
+        422: ApiProblemResponseDto;
+        /**
+         * Rate limited (5 submissions per user per hour)
+         */
+        429: ApiProblemResponseDto;
+        /**
+         * Relay not configured on this deployment — clients fall back to the clipboard flow
+         */
+        501: ApiProblemResponseDto;
+        /**
+         * GitHub bot failure (upstream), safe to retry
+         */
+        502: ApiProblemResponseDto;
+      };
+    };
+  };
   '/api/v1/cache/flush': {
     post: {
       res: {
-        201: unknown;
+        /**
+         * Cache flushed successfully
+         */
+        200: unknown;
+        /**
+         * Admin access required
+         */
+        403: ApiProblemResponseDto;
       };
     };
   };