@firela/api-types 0.0.0-canary.da5984a1 → 0.0.0-canary.ebb51de2

package/src/generated/types.gen.ts

@@ -316,6 +316,53 @@ export type RegionsMetadataResponseDto = {
   regions: Array<RegionInfoDto>;
 };
 
+export type CostSpecDto = {
+  /**
+   * Cost specification mode (mirrors engine CostSpec)
+   */
+  mode: 'per-unit' | 'total' | 'date' | 'label' | 'auto';
+  /**
+   * Per-unit cost (required when mode is "per-unit")
+   */
+  numberPerUnit?: string;
+  /**
+   * Total cost for all units (required when mode is "total")
+   */
+  totalNumber?: string;
+  /**
+   * Cost currency (required in all modes)
+   */
+  currency: string;
+  /**
+   * Lot acquisition date, ISO 8601 (required when mode is "date")
+   */
+  date?: string;
+  /**
+   * Lot label (required when mode is "label"; optional tag in buy modes)
+   */
+  label?: string;
+  /**
+   * Merge lots for AVERAGE booking (mode: auto)
+   */
+  merge?: boolean;
+};
+
+/**
+ * Cost specification mode (mirrors engine CostSpec)
+ */
+export type mode = 'per-unit' | 'total' | 'date' | 'label' | 'auto';
+
+export type AmountDto = {
+  /**
+   * Amount as decimal string (max 15 integer + 15 decimal digits)
+   */
+  number: string;
+  /**
+   * Currency/commodity code
+   */
+  currency: string;
+};
+
 export type CreatePostingDto = {
   /**
    * Account name in Beancount format (must start with uppercase, colon-separated)
@@ -335,6 +382,14 @@ export type CreatePostingDto = {
   meta?: {
     [key: string]: unknown;
   };
+  /**
+   * Cost basis (Beancount `{...}`). Maps to engine costSpec. Required for commodity holdings so they carry a monetary weight that can balance.
+   */
+  cost?: CostSpecDto;
+  /**
+   * Price annotation (Beancount `@...`). Maps to engine price. Used for valuation; cost takes priority for balance weight.
+   */
+  price?: AmountDto;
 };
 
 export type CreateTransactionDto = {
@@ -387,6 +442,25 @@ export type CreateTransactionDto = {
  */
 export type flag = '*' | '!';
 
+export type CostDetailDto = {
+  /**
+   * Per-unit cost basis (mirrors engine Cost.number)
+   */
+  number?: string;
+  /**
+   * Cost currency
+   */
+  currency?: string;
+  /**
+   * Lot acquisition date (ISO yyyy-mm-dd)
+   */
+  date?: string;
+  /**
+   * Lot label
+   */
+  label?: string;
+};
+
 export type PostingResponseDto = {
   /**
    * Account name
@@ -400,6 +474,10 @@ export type PostingResponseDto = {
    * Currency
    */
   currency?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
 };
 
 export type RecurringSuggestionDto = {
@@ -561,6 +639,55 @@ export type BatchTransactionResponseDto = {
   failed: Array<BatchTransactionErrorDto>;
 };
 
+export type CorrectTransactionDto = {
+  /**
+   * Transaction date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Transaction flag: * (cleared), ! (pending)
+   */
+  flag?: '*' | '!';
+  /**
+   * Payee name
+   */
+  payee?: string;
+  /**
+   * Transaction narration/description
+   */
+  narration: string;
+  /**
+   * Transaction tags (without # prefix)
+   */
+  tags?: Array<string>;
+  /**
+   * Transaction links (without ^ prefix)
+   */
+  links?: Array<string>;
+  /**
+   * Transaction postings (minimum 1, typically 2 for double-entry)
+   */
+  postings: Array<CreatePostingDto>;
+  /**
+   * Transaction-level metadata
+   */
+  meta?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.
+   */
+  idempotencyKey?: string;
+  /**
+   * Auto-create accounts if not found. When true, missing accounts will be automatically created. When false (default for API), missing accounts will cause a validation error. Set to true for quick entry scenarios where you want to create accounts on-the-fly.
+   */
+  autoCreateAccounts?: boolean;
+  /**
+   * Reason for correcting/superseding the original transaction
+   */
+  correctionReason?: string;
+};
+
 export type PostingDetailDto = {
   /**
    * Posting ID
@@ -571,9 +698,9 @@ export type PostingDetailDto = {
    */
   accountId: string;
   /**
-   * Account name
+   * Fully-qualified Beancount account path
    */
-  accountName: string;
+  account: string;
   /**
    * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
    */
@@ -594,6 +721,10 @@ export type PostingDetailDto = {
    * Cost date
    */
   costDate?: string;
+  /**
+   * Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.
+   */
+  cost?: CostDetailDto;
   /**
    * Price amount
    */
@@ -664,9 +795,9 @@ export type TransactionDetailDto = {
    */
   status: 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
   /**
-   * Source type (how the transaction was created)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
-  sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+  sourceType?: string;
   /**
    * Source platform (e.g., alipay, wechat)
    */
@@ -691,6 +822,14 @@ export type TransactionDetailDto = {
    * 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;
 };
 
 /**
@@ -709,11 +848,6 @@ export type flag2 =
  */
 export type status2 = 'ACTIVE' | 'VOIDED' | 'SUPERSEDED';
 
-/**
- * Source type (how the transaction was created)
- */
-export type sourceType = 'NLP' | 'CSV' | 'OCR' | 'API';
-
 export type TransactionListResponseDto = {
   /**
    * List of transactions
@@ -852,9 +986,9 @@ export type TransactionSummaryDto = {
    */
   accountName?: string;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
-  sourceType?: 'NLP' | 'CSV' | 'OCR' | 'API';
+  sourceType?: string;
   /**
    * Source platform (e.g., alipay, wechat)
    */
@@ -902,7 +1036,7 @@ export type ReviewSummaryDto = {
    */
   matchReasons: Array<string>;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
   sourceType: string;
   /**
@@ -1000,7 +1134,18 @@ export type DecisionOptionDto = {
   /**
    * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
    */
-  value: string;
+  value:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * i18n message key for display label (e.g., review.payee.accept.label)
    */
@@ -1015,6 +1160,22 @@ export type DecisionOptionDto = {
   recommended?: boolean;
 };
 
+/**
+ * The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)
+ */
+export type value =
+  | 'UPGRADE_REPLACE'
+  | 'LINK_KEEP_BOTH'
+  | 'IGNORE_NEW'
+  | 'CONFIRM_DIFFERENT'
+  | 'ACCEPT'
+  | 'REJECT'
+  | 'ACCEPT_AND_LEARN'
+  | 'CHOOSE_OTHER'
+  | 'CANCEL'
+  | 'FIX'
+  | 'IGNORE';
+
 export type ReviewDetailDto = {
   /**
    * Review item ID
@@ -1056,7 +1217,7 @@ export type ReviewDetailDto = {
    */
   matchReasons: Array<string>;
   /**
-   * Source type (NLP, CSV, OCR, API)
+   * Source type (free-form string from transaction metadata, e.g. import, api)
    */
   sourceType: string;
   /**
@@ -1109,9 +1270,20 @@ export type ReviewDetailDto = {
 
 export type ResolveReviewDto = {
   /**
-   * Decision action. Available actions vary by review type: DUPLICATE: UPGRADE_REPLACE, KEEP_EXISTING, KEEP_BOTH | PAYEE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN | ACCOUNT_VALIDATION: FIX, REJECT | RULE_MATCH: ACCEPT, REJECT, ACCEPT_AND_LEARN
+   * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
    */
-  action: string;
+  action:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * Additional data for the decision (e.g., selected account ID)
    */
@@ -1120,6 +1292,22 @@ export type ResolveReviewDto = {
   };
 };
 
+/**
+ * Decision action. Valid actions vary by review type — see DecisionOptionDto.value returned by the review detail endpoint.
+ */
+export type action =
+  | 'UPGRADE_REPLACE'
+  | 'LINK_KEEP_BOTH'
+  | 'IGNORE_NEW'
+  | 'CONFIRM_DIFFERENT'
+  | 'ACCEPT'
+  | 'REJECT'
+  | 'ACCEPT_AND_LEARN'
+  | 'CHOOSE_OTHER'
+  | 'CANCEL'
+  | 'FIX'
+  | 'IGNORE';
+
 export type ResolveResultDto = {
   /**
    * Whether resolution was successful
@@ -1176,7 +1364,18 @@ export type BatchResolveDto = {
   /**
    * Decision action to apply to all items
    */
-  action: string;
+  action:
+    | 'UPGRADE_REPLACE'
+    | 'LINK_KEEP_BOTH'
+    | 'IGNORE_NEW'
+    | 'CONFIRM_DIFFERENT'
+    | 'ACCEPT'
+    | 'REJECT'
+    | 'ACCEPT_AND_LEARN'
+    | 'CHOOSE_OTHER'
+    | 'CANCEL'
+    | 'FIX'
+    | 'IGNORE';
   /**
    * Additional data for the decision
    */
@@ -3258,33 +3457,6 @@ export type ProviderSyncDto = {
   transactions: unknown[];
 };
 
-export type ProviderSyncResponseDto = {
-  /**
-   * Number of transactions successfully imported
-   */
-  imported: number;
-  /**
-   * Number of transactions skipped (duplicates)
-   */
-  skipped: number;
-  /**
-   * Number of transactions pending review
-   */
-  pendingReview: number;
-  /**
-   * Number of transactions that failed to import
-   */
-  failed: number;
-  /**
-   * IDs of successfully imported transactions
-   */
-  importedTransactionIds?: Array<string>;
-  /**
-   * IDs of review items created for branched transactions
-   */
-  reviewItemIds?: Array<string>;
-};
-
 export type SupportedProvidersResponseDto = {
   /**
    * List of supported provider names
@@ -3294,6 +3466,8 @@ export type SupportedProvidersResponseDto = {
 
 export type ParserTelemetryReportDto = unknown;
 
+export type UncoveredFormatMissDto = unknown;
+
 export type ProcessNlpDto = {
   /**
    * Natural language text describing a transaction (Chinese)
@@ -3311,607 +3485,418 @@ export type ProcessNlpDto = {
   };
 };
 
-export type NlpTransactionInfoDto = {
+export type BalanceByCurrencyDto = {
   /**
-   * Transaction ID
+   * ISO 4217 currency code
    */
-  id: string;
+  currency: string;
   /**
-   * Transaction date (ISO format)
+   * Balance amount
    */
-  date: string;
+  balance: string;
+};
+
+export type NetWorthByCurrencyDto = {
   /**
-   * Transaction amount
+   * Net worth by currency
    */
-  amount: number;
+  netWorth: Array<BalanceByCurrencyDto>;
   /**
-   * Currency code
+   * Assets by currency
    */
-  currency: string;
+  assets: Array<BalanceByCurrencyDto>;
   /**
-   * Payee name
+   * Liabilities by currency
    */
-  payee?: string;
+  liabilities: Array<BalanceByCurrencyDto>;
+};
+
+export type ConvertedNetWorthDto = {
   /**
-   * Transaction narration
+   * Base currency for conversion
    */
-  narration?: string;
+  baseCurrency: string;
   /**
-   * Warning message for special transaction scenarios (e.g., cross-currency settlement)
+   * Converted net worth
    */
-  warning?: string;
-};
-
-export type NlpParsedDataDto = {
+  netWorth: string;
   /**
-   * Extracted amount
+   * Converted assets
    */
-  amount?: number;
+  assets: string;
   /**
-   * Currency code
+   * Converted liabilities
    */
-  currency?: string;
+  liabilities: string;
   /**
-   * Transaction date (ISO format)
+   * Exchange rates used for conversion
    */
-  date?: string;
+  exchangeRates: {
+    [key: string]: unknown;
+  };
+};
+
+export type ExchangeRateWarningDto = {
   /**
-   * Payee name
+   * Warning type
    */
-  payee?: string;
+  type: string;
   /**
-   * Transaction narration
+   * Currency without exchange rate
    */
-  narration?: string;
+  currency: string;
   /**
-   * Category
+   * Total amount affected
    */
-  category?: string;
+  totalAmount: string;
+};
+
+export type NetWorthResponseDto = {
+  /**
+   * Total net worth (assets - liabilities, converted to base currency)
+   */
+  netWorth: string;
   /**
-   * Income type (e.g., Salary, Bonus, Dividend, Interest)
+   * Total assets value (converted)
    */
-  incomeType?: string;
+  assets: string;
   /**
-   * Income source (e.g., company name)
+   * Total liabilities value (positive number, converted)
    */
-  incomeSource?: string;
+  liabilities: string;
   /**
-   * Security symbol code (e.g., 600519, AAPL)
+   * Monthly return (change from last month)
    */
-  symbol?: string;
+  monthlyReturn: string;
   /**
-   * Quantity of shares/units
+   * Monthly return percentage
    */
-  quantity?: number;
+  monthlyReturnPercentage: string;
   /**
-   * Unit price per share/unit
+   * Base currency code
    */
-  price?: number;
+  currency: string;
   /**
-   * Investment action
+   * Data as of date (ISO 8601)
    */
-  investmentAction?: 'buy' | 'sell';
+  asOf: string;
   /**
-   * Payment source: asset (default) or liability (credit card)
+   * Balances grouped by original currency
    */
-  paymentSource?: 'asset' | 'liability';
+  byCurrency?: NetWorthByCurrencyDto;
   /**
-   * Liability account hint (CreditCard/Huabei/Baitiao)
+   * Converted values in base currency (undefined if no exchange rates available)
    */
-  liabilityHint?: string;
+  converted?: ConvertedNetWorthDto;
   /**
-   * Warning message for special scenarios (e.g., cross-currency settlement)
+   * Exchange rate warnings
    */
-  warning?: string;
+  warnings?: Array<ExchangeRateWarningDto>;
 };
 
-/**
- * Investment action
- */
-export type investmentAction = 'buy' | 'sell';
-
-/**
- * Payment source: asset (default) or liability (credit card)
- */
-export type paymentSource = 'asset' | 'liability';
-
-export type NlpSourceTransactionDto = {
+export type AccountItemDto = {
   /**
-   * Transaction date (ISO format)
+   * Account ID
    */
-  date: string;
+  id: string;
   /**
-   * Amount as string
+   * Full account name
    */
-  amount: string;
+  name: string;
   /**
-   * Currency code
+   * Display name (last part of account path)
    */
-  currency: string;
+  displayName: string;
   /**
-   * Payee name
+   * Account balance
    */
-  payee?: string;
+  balance: string;
   /**
-   * Transaction narration
+   * Currency code
    */
-  narration: string;
+  currency: string;
 };
 
-export type NlpTargetTransactionDto = {
+export type PlatformGroupDto = {
   /**
-   * Existing transaction ID
+   * Platform ID
    */
-  id: string;
+  platformId: string;
   /**
-   * Transaction date (ISO format)
+   * Platform display name
    */
-  date: string;
+  platformName: string;
   /**
-   * Amount as string
+   * Accounts within this platform
    */
-  amount: string;
-  /**
-   * Currency code
-   */
-  currency: string;
-  /**
-   * Payee name
-   */
-  payee?: string;
+  accounts: Array<AccountItemDto>;
   /**
-   * Transaction narration
+   * Total balance across all accounts in platform
    */
-  narration: string;
+  totalBalance: string;
 };
 
-export type NlpSimilarityDto = {
-  /**
-   * Whether dates match
-   */
-  dateMatch: boolean;
-  /**
-   * Date difference in days
-   */
-  dateDiff: number;
-  /**
-   * Whether amounts match
-   */
-  amountMatch: boolean;
-  /**
-   * Amount difference as decimal string
-   */
-  amountDiff: string;
-  /**
-   * Whether payees match
-   */
-  payeeMatch: boolean;
+export type AccountsSummaryDto = {
   /**
-   * Payee similarity score (0-1)
+   * Total number of accounts
    */
-  payeeSimilarity: number;
+  totalAccounts: number;
   /**
-   * Account overlap score (0-1)
+   * Total number of platforms
    */
-  accountOverlap: number;
+  totalPlatforms: number;
 };
 
-export type NlpDuplicateConfirmationDataDto = {
-  /**
-   * Duplicate detection confidence score (0.5-0.89)
-   */
-  confidence: number;
-  /**
-   * Source transaction summary (the new transaction being entered)
-   */
-  sourceTransaction: NlpSourceTransactionDto;
-  /**
-   * Target transaction summary (existing potential duplicate)
-   */
-  targetTransaction: NlpTargetTransactionDto;
+export type AccountsResponseDto = {
   /**
-   * Detailed similarity information
+   * Account groups by platform
    */
-  similarity: NlpSimilarityDto;
+  groups: Array<PlatformGroupDto>;
   /**
-   * Human-readable reasons for duplicate detection
+   * Summary statistics
    */
-  reasons: Array<string>;
+  summary: AccountsSummaryDto;
 };
 
-export type NlpRuleConfirmationDataDto = {
+export type AccountItemWithAssetClassDto = {
   /**
-   * Rule match confidence score (0.5-0.74)
+   * Account ID
    */
-  confidence: number;
+  id: string;
   /**
-   * Matched rule information
+   * Full account name
    */
-  matchedRule: {
-    [key: string]: unknown;
-  };
+  name: string;
   /**
-   * Suggested accounts from the rule
+   * Display name (last part of account path)
    */
-  suggestedAccounts: {
-    [key: string]: unknown;
-  };
+  displayName: string;
   /**
-   * Alternative rules that also match
+   * Account balance
    */
-  alternatives: unknown[];
+  balance: string;
   /**
-   * Human-readable reasons for the match
+   * Currency code
    */
-  reasons: Array<string>;
-};
-
-export type NlpAccountConfirmationDataDto = {
+  currency: string;
   /**
-   * The invalid account name
+   * Asset class
    */
-  invalidAccount: string;
+  assetClass: string;
   /**
-   * Suggested replacement account
+   * Asset sub-class (Prisma-compatible)
    */
-  suggestedAccount: string;
+  assetSubClass?: string;
   /**
-   * Similar accounts for user selection
+   * Regional sub-class (region-specific, for display)
    */
-  similarAccounts: Array<string>;
+  regionalSubClass?: string;
   /**
-   * Error message explaining the issue
+   * Risk level
    */
-  errorMessage: string;
+  riskLevel?: string;
   /**
-   * Transaction context for reference
+   * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
    */
-  transactionContext: {
-    [key: string]: unknown;
-  };
+  source?: 'USER_META' | 'FIAT_CURRENCY' | 'OPENBB_MAPPING' | 'FALLBACK';
 };
 
-export type NlpSuggestedPayeeDto = {
+/**
+ * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
+ */
+export type source =
+  | 'USER_META'
+  | 'FIAT_CURRENCY'
+  | 'OPENBB_MAPPING'
+  | 'FALLBACK';
+
+export type AssetClassGroupDto = {
   /**
-   * Payee ID
+   * Asset class name
    */
-  id: string;
+  assetClass:
+    | 'LIQUIDITY'
+    | 'EQUITY'
+    | 'FIXED_INCOME'
+    | 'PRECIOUS_METALS'
+    | 'COMMODITY'
+    | 'INSURANCE'
+    | 'ALTERNATIVE_INVESTMENT'
+    | 'PERSONAL_ASSETS'
+    | 'LIABILITY'
+    | 'REAL_ESTATE'
+    | 'INDEX';
   /**
-   * Payee name
+   * Asset sub-class name
    */
-  name: string;
+  assetSubClass?: string;
   /**
-   * Payee category
+   * Accounts within this asset class
    */
-  category?: string;
+  accounts: Array<AccountItemWithAssetClassDto>;
   /**
-   * Source of the payee
+   * Balances grouped by currency
    */
-  source?: 'user' | 'global';
+  balanceByCurrency: Array<BalanceByCurrencyDto>;
   /**
-   * PayeeProfile ID (if matched from global)
+   * Converted balance in base currency
    */
-  payeeProfileId?: string;
+  convertedBalance?: string;
 };
 
 /**
- * Source of the payee
+ * Asset class name
  */
-export type source = 'user' | 'global';
-
-export type NlpAlternativePayeeDto = {
-  /**
-   * Payee ID
-   */
-  id: string;
-  /**
-   * Payee name
-   */
-  name: string;
-  /**
-   * Similarity score (0-1)
-   */
-  similarity: number;
-};
+export type assetClass =
+  | 'LIQUIDITY'
+  | 'EQUITY'
+  | 'FIXED_INCOME'
+  | 'PRECIOUS_METALS'
+  | 'COMMODITY'
+  | 'INSURANCE'
+  | 'ALTERNATIVE_INVESTMENT'
+  | 'PERSONAL_ASSETS'
+  | 'LIABILITY'
+  | 'REAL_ESTATE'
+  | 'INDEX';
 
-export type NlpPayeeConfirmationDataDto = {
-  /**
-   * Confidence score for the payee match (0-1)
-   */
-  confidence: number;
-  /**
-   * Original payee string from user input
-   */
-  originalPayee: string;
+export type AccountExchangeRateWarningDto = {
   /**
-   * Suggested payee to use (null when no similar payees found)
+   * Warning type
    */
-  suggestedPayee?: NlpSuggestedPayeeDto | null;
+  type: string;
   /**
-   * Similarity score between original and suggested (0-1)
+   * Currency without exchange rate
    */
-  similarity: number;
+  currency: string;
   /**
-   * Alternative payee options
+   * Affected account paths
    */
-  alternatives: Array<NlpAlternativePayeeDto>;
+  accounts: Array<string>;
   /**
-   * Human-readable reasons for the match
+   * Total amount in this currency
    */
-  reasons: Array<string>;
+  totalAmount: string;
 };
 
-export type RecurringMatchInfoDto = {
-  /**
-   * Expected transaction ID
-   */
-  expectedId: string;
-  /**
-   * Recurring rule ID
-   */
-  ruleId: string;
-  /**
-   * Rule name for display
-   */
-  ruleName: string;
-  /**
-   * Rule icon
-   */
-  ruleIcon?: string;
-  /**
-   * Expected date (YYYY-MM-DD)
-   */
-  expectedDate: string;
-  /**
-   * Expected amount
-   */
-  expectedAmount: number;
-  /**
-   * Match confidence score (0-1)
-   */
-  confidence: number;
+export type AssetClassSummaryDto = {
   /**
-   * Whether auto-matched (confidence >= 0.82)
+   * Total number of accounts
    */
-  isAutoMatched: boolean;
-};
-
-export type NlpSuggestedAccountDto = {
+  totalAccounts: number;
   /**
-   * Suggested account path
+   * Total number of asset classes
    */
-  account: string;
+  totalAssetClasses: number;
   /**
-   * Confidence score for this suggestion (0-1)
+   * Base currency for conversion
    */
-  confidence?: number;
-};
-
-export type NlpSuggestedAccountsDto = {
+  baseCurrency: string;
   /**
-   * Source account suggestion (where money comes from). For expense: asset/liability account. For income: income account.
+   * Exchange rate warnings
    */
-  source?: NlpSuggestedAccountDto;
+  warnings?: Array<AccountExchangeRateWarningDto>;
   /**
-   * Destination account suggestion (where money goes to). For expense: expense account. For income: asset/liability account.
+   * ADR-0105 §4 fallback provenance stats (holding level only). valueRatio is the grey-area share of total converted value; count is the number of source=FALLBACK holdings.
    */
-  destination?: NlpSuggestedAccountDto;
+  fallback?: {
+    [key: string]: unknown;
+  };
 };
 
-export type NlpDefaultAccountsDto = {
-  /**
-   * Default asset account
-   */
-  asset: string;
+export type AssetClassAccountsResponseDto = {
   /**
-   * Default expense account
+   * Account groups by asset class
    */
-  expense: string;
+  groups: Array<AssetClassGroupDto>;
   /**
-   * Default income account
+   * Summary statistics
    */
-  income: string;
+  summary: AssetClassSummaryDto;
   /**
-   * Default liability account
+   * ADR-0105 §6 holding-level grey-area bucket (source=FALLBACK holdings peeled out of groups). Present only for groupBy=holdingAssetClass when FALLBACK holdings exist.
    */
-  liability: string;
+  uncategorized?: AssetClassGroupDto;
 };
 
-export type NlpResponseDto = {
-  /**
-   * Response status
-   */
-  status: 'success' | 'pending' | 'error';
-  /**
-   * Action taken or requested
-   */
-  action:
-    | 'created'
-    | 'ask'
-    | 'confirm'
-    | 'confirm_duplicate'
-    | 'confirm_rule'
-    | 'confirm_account'
-    | 'confirm_payee'
-    | 'cancel';
-  /**
-   * Transaction intent detected by EntityRouter (v6.0: 5 core intents). Frontend uses this to render scenario-specific form fields.
-   */
-  intent?: 'expense' | 'asset' | 'income' | 'liability' | 'equity';
-  /**
-   * Asset sub-type (only present when intent is "asset"). Determines which asset-related form to render.
-   */
-  assetSubType?: 'transfer' | 'banking' | 'investment';
-  /**
-   * Liability sub-type (only present when intent is "liability"). borrow: borrowing money (Liabilities → Assets), repay: repaying debt (Assets → Liabilities).
-   */
-  liabilitySubType?: 'borrow' | 'repay';
-  /**
-   * Equity sub-type (only present when intent is "equity"). opening: account opening balance (Equity → Assets), adjustment: balance correction.
-   */
-  equitySubType?: 'opening' | 'adjustment';
-  /**
-   * Payment source for expense transactions (v6.1). Indicates whether payment comes from asset or liability account. Only present when intent is "expense".
-   */
-  paymentSource?: 'asset' | 'liability';
-  /**
-   * Liability account type hint for credit card/BNPL spending (v6.1). Only present when paymentSource is "liability". Values: CreditCard, Huabei, Baitiao
-   */
-  liabilityHint?: string;
-  /**
-   * Human-readable message (for ask or error actions). Deprecated: Use messageKey for i18n support.
-   * @deprecated
-   */
-  message?: string;
-  /**
-   * i18n message key for frontend translation. Use this instead of message for internationalization support.
-   */
-  messageKey?: string;
-  /**
-   * Parameters for message interpolation. Used with messageKey for dynamic values in translated messages.
-   */
-  messageParams?: {
-    [key: string]: unknown;
-  };
-  /**
-   * Session ID for multi-turn dialogue. Must be included in subsequent requests to continue the conversation.
-   */
-  sessionId?: string;
-  /**
-   * Which slot is waiting for user input
-   */
-  waitingFor?: string;
-  /**
-   * Created transaction info (for created action)
-   */
-  transaction?: NlpTransactionInfoDto;
-  /**
-   * Parsed data for confirmation (when action is "confirm"). Contains extracted fields that user should verify before transaction creation.
-   */
-  parsedData?: NlpParsedDataDto;
-  /**
-   * Duplicate detection data (when action is "confirm_duplicate"). Contains information about potential duplicate transaction for user confirmation.
-   */
-  duplicateData?: NlpDuplicateConfirmationDataDto;
-  /**
-   * Rule match data (when action is "confirm_rule"). Contains information about medium-confidence rule match for user confirmation.
-   */
-  ruleData?: NlpRuleConfirmationDataDto;
+export type HoldingAssetClassAccountSliceDto = {
   /**
-   * Account validation data (when action is "confirm_account"). Contains information about invalid account for user correction.
+   * Account ID
    */
-  accountData?: NlpAccountConfirmationDataDto;
+  accountId: string;
   /**
-   * Payee confirmation data (when action is "confirm_payee"). Contains information about medium/low confidence payee match for user confirmation.
+   * Full account path
    */
-  payeeData?: NlpPayeeConfirmationDataDto;
+  accountPath: string;
   /**
-   * Overall confidence score (0-1)
+   * Currency of the holding with the largest converted base value; undefined when no holding is convertible
    */
-  confidence?: number;
+  accountCurrency?: string;
   /**
-   * Confidence threshold for automatic creation (default: 0.75). When confidence < threshold, action will be "confirm" requiring user verification.
+   * Account's market value in base currency (Σ converted holdings; grey bucket included)
    */
-  confidenceThreshold?: number;
+  marketValueBase: string;
   /**
-   * Recurring transaction match info (when action is "created"). Contains match details when transaction matches a pending expected transaction.
+   * Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).
    */
-  recurringMatch?: RecurringMatchInfoDto;
+  shareOfTotalPct: number;
   /**
-   * Recurring rule creation suggestion (when action is "created"). Contains suggestion to create a recurring rule based on detected patterns. Only present when no existing rule matched and similar historical transactions were found.
+   * Per-account asset-class breakdown
    */
-  recurringSuggestion?: RecurringSuggestionDto;
+  groups: Array<AssetClassGroupDto>;
   /**
-   * Suggested accounts for this transaction. Contains recommended source and destination accounts based on the detected intent and rules.
+   * Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)
    */
-  suggestedAccounts?: NlpSuggestedAccountsDto;
+  uncategorized?: AssetClassGroupDto;
   /**
-   * Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.
+   * Every holding row for this account (account ID in each row’s `id` field)
    */
-  defaultAccounts?: NlpDefaultAccountsDto;
+  holdings: Array<AccountItemWithAssetClassDto>;
 };
 
-/**
- * Response status
- */
-export type status4 = 'success' | 'pending' | 'error';
-
-/**
- * Action taken or requested
- */
-export type action =
-  | 'created'
-  | 'ask'
-  | 'confirm'
-  | 'confirm_duplicate'
-  | 'confirm_rule'
-  | 'confirm_account'
-  | 'confirm_payee'
-  | 'cancel';
-
-/**
- * Transaction intent detected by EntityRouter (v6.0: 5 core intents). Frontend uses this to render scenario-specific form fields.
- */
-export type intent = 'expense' | 'asset' | 'income' | 'liability' | 'equity';
-
-/**
- * Asset sub-type (only present when intent is "asset"). Determines which asset-related form to render.
- */
-export type assetSubType = 'transfer' | 'banking' | 'investment';
-
-/**
- * Liability sub-type (only present when intent is "liability"). borrow: borrowing money (Liabilities → Assets), repay: repaying debt (Assets → Liabilities).
- */
-export type liabilitySubType = 'borrow' | 'repay';
-
-/**
- * Equity sub-type (only present when intent is "equity"). opening: account opening balance (Equity → Assets), adjustment: balance correction.
- */
-export type equitySubType = 'opening' | 'adjustment';
-
-export type BalanceByCurrencyDto = {
+export type HoldingAssetClassCrossAccountResponseDto = {
   /**
-   * ISO 4217 currency code
+   * Merged cross-account holding aggregation
    */
-  currency: string;
+  global: AssetClassAccountsResponseDto;
   /**
-   * Balance amount
+   * Per-account slices
    */
-  balance: string;
+  byAccount: Array<HoldingAssetClassAccountSliceDto>;
 };
 
-export type NetWorthByCurrencyDto = {
+export type CashFlowByCurrencyDto = {
   /**
-   * Net worth by currency
+   * Income by currency
    */
-  netWorth: Array<BalanceByCurrencyDto>;
+  income: Array<BalanceByCurrencyDto>;
   /**
-   * Assets by currency
+   * Expense by currency
    */
-  assets: Array<BalanceByCurrencyDto>;
+  expense: Array<BalanceByCurrencyDto>;
   /**
-   * Liabilities by currency
+   * Net savings by currency
    */
-  liabilities: Array<BalanceByCurrencyDto>;
+  netSavings: Array<BalanceByCurrencyDto>;
 };
 
-export type ConvertedNetWorthDto = {
+export type ConvertedCashFlowDto = {
   /**
    * Base currency for conversion
    */
   baseCurrency: string;
   /**
-   * Converted net worth
+   * Converted income
    */
-  netWorth: string;
+  income: string;
   /**
-   * Converted assets
+   * Converted expense
    */
-  assets: string;
+  expense: string;
   /**
-   * Converted liabilities
+   * Converted net savings
    */
-  liabilities: string;
+  netSavings: string;
   /**
    * Exchange rates used for conversion
    */
@@ -3920,343 +3905,340 @@ export type ConvertedNetWorthDto = {
   };
 };
 
-export type ExchangeRateWarningDto = {
-  /**
-   * Warning type
-   */
-  type: string;
-  /**
-   * Currency without exchange rate
-   */
-  currency: string;
-  /**
-   * Total amount affected
-   */
-  totalAmount: string;
-};
-
-export type NetWorthResponseDto = {
+export type CashFlowResponseDto = {
   /**
-   * Total net worth (assets - liabilities, converted to base currency)
+   * Period identifier (YYYY-MM)
    */
-  netWorth: string;
+  period: string;
   /**
-   * Total assets value (converted)
+   * Total income for the period (converted)
    */
-  assets: string;
+  income: string;
   /**
-   * Total liabilities value (positive number, converted)
+   * Total expenses for the period (converted)
    */
-  liabilities: string;
+  expense: string;
   /**
-   * Monthly return (change from last month)
+   * Net savings (income - expense, converted)
    */
-  monthlyReturn: string;
+  netSavings: string;
   /**
-   * Monthly return percentage
+   * Savings rate percentage (netSavings / income * 100)
    */
-  monthlyReturnPercentage: string;
+  savingsRate: string;
   /**
    * Base currency code
    */
   currency: string;
   /**
-   * Data as of date (ISO 8601)
-   */
-  asOf: string;
-  /**
-   * Balances grouped by original currency
+   * Cash flow grouped by original currency
    */
-  byCurrency?: NetWorthByCurrencyDto;
+  byCurrency?: CashFlowByCurrencyDto;
   /**
-   * Converted values in base currency (undefined if no exchange rates available)
+   * Converted values in base currency
    */
-  converted?: ConvertedNetWorthDto;
+  converted?: ConvertedCashFlowDto;
   /**
    * Exchange rate warnings
    */
   warnings?: Array<ExchangeRateWarningDto>;
 };
 
-export type AccountItemDto = {
+export type MonetaryDto = {
   /**
-   * Account ID
+   * Amount (Decimal string)
    */
-  id: string;
-  /**
-   * Full account name
-   */
-  name: string;
-  /**
-   * Display name (last part of account path)
-   */
-  displayName: string;
+  amount: string;
   /**
-   * Account balance
+   * ISO 4217 currency
    */
-  balance: string;
+  currency: string;
   /**
-   * Currency code
+   * Converted to user base currency (Decimal string)
    */
-  currency: string;
+  baseCcyEquivalent?: {
+    [key: string]: unknown;
+  } | null;
 };
 
-export type PlatformGroupDto = {
+export type CurrentPriceDto = {
   /**
-   * Platform ID
+   * Price amount (Decimal string)
    */
-  platformId: string;
+  amount: string;
   /**
-   * Platform display name
+   * Price currency (ISO 4217)
    */
-  platformName: string;
+  currency: string;
   /**
-   * Accounts within this platform
+   * Price date (ISO 8601)
    */
-  accounts: Array<AccountItemDto>;
+  date: string;
   /**
-   * Total balance across all accounts in platform
+   * Price source
    */
-  totalBalance: string;
+  source: 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
 };
 
-export type AccountsSummaryDto = {
-  /**
-   * Total number of accounts
-   */
-  totalAccounts: number;
-  /**
-   * Total number of platforms
-   */
-  totalPlatforms: number;
-};
+/**
+ * Price source
+ */
+export type source2 = 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
 
-export type AccountsResponseDto = {
+export type FxRateDto = {
+  from: string;
+  to: string;
   /**
-   * Account groups by platform
+   * FX rate (Decimal string)
    */
-  groups: Array<PlatformGroupDto>;
+  rate: string;
   /**
-   * Summary statistics
+   * Rate date (ISO 8601)
    */
-  summary: AccountsSummaryDto;
+  date: string;
 };
 
-export type AccountItemWithAssetClassDto = {
+export type HoldingPnlRowDto = {
   /**
-   * Account ID
+   * Account UUID
    */
-  id: string;
+  accountId: string;
   /**
-   * Full account name
+   * Full account path
    */
-  name: string;
+  accountPath: string;
   /**
-   * Display name (last part of account path)
+   * Account settlement currency (ISO 4217), from cost currency
    */
-  displayName: string;
+  accountCcy?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Account balance
+   * Broker type derived from Platform.type
    */
-  balance: string;
+  brokerType?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Currency code
+   * Commodity symbol
    */
-  currency: string;
+  symbol: string;
   /**
-   * Asset class
+   * Chart segment token (libs/common resolver)
    */
+  chartToken: 'equity' | 'fund' | 'bond' | 'cash' | 'other';
   assetClass: string;
+  assetSubClass?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Asset sub-class (Prisma-compatible)
+   * Net held units (Decimal string)
    */
-  assetSubClass?: string;
+  units: string;
   /**
-   * Regional sub-class (region-specific, for display)
+   * Average cost per unit; null when cost currency conflicts or no cost
    */
-  regionalSubClass?: string;
+  averageCostPerUnit?: MonetaryDto | null;
   /**
-   * Risk level
+   * Cost basis of held units
    */
-  riskLevel?: string;
-};
-
-export type AssetClassGroupDto = {
+  costBasis?: MonetaryDto | null;
   /**
-   * Asset class name
+   * Market value at asOf price
    */
-  assetClass:
-    | 'LIQUIDITY'
-    | 'EQUITY'
-    | 'FIXED_INCOME'
-    | 'PRECIOUS_METALS'
-    | 'COMMODITY'
-    | 'INSURANCE'
-    | 'ALTERNATIVE_INVESTMENT'
-    | 'PERSONAL_ASSETS'
-    | 'LIABILITY'
-    | 'REAL_ESTATE'
-    | 'INDEX';
+  marketValue?: MonetaryDto | null;
   /**
-   * Asset sub-class name
-   */
-  assetSubClass?: string;
-  /**
-   * Accounts within this asset class
+   * Price used for market value
    */
-  accounts: Array<AccountItemWithAssetClassDto>;
-  /**
-   * Balances grouped by currency
-   */
-  balanceByCurrency: Array<BalanceByCurrencyDto>;
-  /**
-   * Converted balance in base currency
-   */
-  convertedBalance?: string;
-};
-
-/**
- * Asset class name
- */
-export type assetClass =
-  | 'LIQUIDITY'
-  | 'EQUITY'
-  | 'FIXED_INCOME'
-  | 'PRECIOUS_METALS'
-  | 'COMMODITY'
-  | 'INSURANCE'
-  | 'ALTERNATIVE_INVESTMENT'
-  | 'PERSONAL_ASSETS'
-  | 'LIABILITY'
-  | 'REAL_ESTATE'
-  | 'INDEX';
-
-export type AccountExchangeRateWarningDto = {
+  currentPrice?: CurrentPriceDto | null;
   /**
-   * Warning type
+   * Unrealized P&L in base currency (Decimal string); null when any FX/price missing
    */
-  type: string;
+  unrealizedPnlBase?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Currency without exchange rate
+   * Unrealized P&L % (Decimal string)
    */
-  currency: string;
+  unrealizedPnlPct?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Affected account paths
+   * Historical FX rate applied to cost basis
    */
-  accounts: Array<string>;
+  costFxRate?: FxRateDto | null;
   /**
-   * Total amount in this currency
+   * FX rate applied to market value
    */
-  totalAmount: string;
-};
-
-export type AssetClassSummaryDto = {
+  marketFxRate?: FxRateDto | null;
   /**
-   * Total number of accounts
+   * Share of invested assets % (Decimal string); only for invested chartTokens
    */
-  totalAccounts: number;
+  pctOfInvestedAssets?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Total number of asset classes
+   * 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
    */
-  totalAssetClasses: number;
+  realizedPnl?: MonetaryDto | null;
+};
+
+/**
+ * Chart segment token (libs/common resolver)
+ */
+export type chartToken = 'equity' | 'fund' | 'bond' | 'cash' | 'other';
+
+export type HoldingPnlWarningDto = {
   /**
-   * Base currency for conversion
+   * Warning type
    */
+  type:
+    | 'MISSING_COST_FX_RATE'
+    | 'MISSING_MARKET_FX_RATE'
+    | 'MISSING_SALE_PRICE'
+    | 'MISSING_REALIZED_FX_RATE'
+    | 'OVERSOLD_LOTS'
+    | 'NO_PRICE'
+    | 'MIXED_COST_CURRENCY';
+  symbol?: {
+    [key: string]: unknown;
+  } | null;
+  accountId?: {
+    [key: string]: unknown;
+  } | null;
+  currency?: {
+    [key: string]: unknown;
+  } | null;
+};
+
+/**
+ * Warning type
+ */
+export type type4 =
+  | 'MISSING_COST_FX_RATE'
+  | 'MISSING_MARKET_FX_RATE'
+  | 'MISSING_SALE_PRICE'
+  | 'MISSING_REALIZED_FX_RATE'
+  | 'OVERSOLD_LOTS'
+  | 'NO_PRICE'
+  | 'MIXED_COST_CURRENCY';
+
+export type HoldingPnlResponseDto = {
+  asOfDate: string;
   baseCurrency: string;
   /**
-   * Exchange rate warnings
+   * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
    */
-  warnings?: Array<AccountExchangeRateWarningDto>;
+  method: 'average' | 'FIFO';
+  rows: Array<HoldingPnlRowDto>;
+  warnings: Array<HoldingPnlWarningDto>;
 };
 
-export type AssetClassAccountsResponseDto = {
+/**
+ * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
+ */
+export type method = 'average' | 'FIFO';
+
+export type CreateBeanPriceDto = {
   /**
-   * Account groups by asset class
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
-  groups: Array<AssetClassGroupDto>;
+  currency: string;
   /**
-   * Summary statistics
+   * Quote currency (pricing currency, e.g., CNY, EUR)
    */
-  summary: AssetClassSummaryDto;
-};
-
-export type CashFlowByCurrencyDto = {
+  quoteCurrency: string;
   /**
-   * Income by currency
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
    */
-  income: Array<BalanceByCurrencyDto>;
+  amount: number;
   /**
-   * Expense by currency
+   * Price date (ISO 8601 format)
    */
-  expense: Array<BalanceByCurrencyDto>;
+  date: string;
   /**
-   * Net savings by currency
+   * Metadata (validated by Zod schema, max field lengths enforced)
    */
-  netSavings: Array<BalanceByCurrencyDto>;
+  metadata?: {
+    [key: string]: unknown;
+  };
 };
 
-export type ConvertedCashFlowDto = {
+export type PriceResponseDto = {
   /**
-   * Base currency for conversion
+   * Unique identifier
    */
-  baseCurrency: string;
+  id: string;
   /**
-   * Converted income
+   * User ID (owner of the price)
    */
-  income: string;
+  userId: string;
   /**
-   * Converted expense
+   * Currency being priced (e.g., USD, AAPL, BTC)
    */
-  expense: string;
+  currency: string;
   /**
-   * Converted net savings
+   * Quote currency (pricing currency, e.g., USD, CNY)
    */
-  netSavings: string;
+  quoteCurrency: string;
   /**
-   * Exchange rates used for conversion
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
    */
-  exchangeRates: {
+  amount: number;
+  /**
+   * Price date (ISO 8601 format). Represents the date this price was valid.
+   */
+  date: string;
+  /**
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   */
+  meta: {
     [key: string]: unknown;
   };
-};
-
-export type CashFlowResponseDto = {
   /**
-   * Period identifier (YYYY-MM)
+   * Creation timestamp
    */
-  period: string;
+  createdAt: string;
   /**
-   * Total income for the period (converted)
+   * Last update timestamp
    */
-  income: string;
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
   /**
-   * Total expenses for the period (converted)
+   * List of prices
    */
-  expense: string;
+  items: Array<PriceResponseDto>;
   /**
-   * Net savings (income - expense, converted)
+   * Total number of prices
    */
-  netSavings: string;
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
   /**
-   * Savings rate percentage (netSavings / income * 100)
+   * Currency being priced
    */
-  savingsRate: string;
+  currency?: string;
   /**
-   * Base currency code
+   * Quote currency (pricing currency)
    */
-  currency: string;
+  quoteCurrency?: string;
   /**
-   * Cash flow grouped by original currency
+   * Price amount (MUST be >= 0 per Beancount spec)
    */
-  byCurrency?: CashFlowByCurrencyDto;
+  amount?: number;
   /**
-   * Converted values in base currency
+   * Price date (ISO 8601 format)
    */
-  converted?: ConvertedCashFlowDto;
+  date?: string;
   /**
-   * Exchange rate warnings
+   * Metadata
    */
-  warnings?: Array<ExchangeRateWarningDto>;
+  metadata?: {
+    [key: string]: unknown;
+  };
 };
 
 export type CurrencyBalanceDto = {
@@ -4375,7 +4357,7 @@ export type AccountControllerCreateData = {
   requestBody: CreateAccountDto;
 };
 
-export type AccountControllerCreateResponse = AccountResponseDto;
+export type AccountControllerCreateResponse = unknown;
 
 export type AccountControllerFindAllData = {
   /**
@@ -4424,9 +4406,6 @@ export type AccountControllerFindOneData = {
 export type AccountControllerFindOneResponse = AccountResponseDto;
 
 export type AccountControllerUpdateData = {
-  /**
-   * Account UUID
-   */
   id: string;
   /**
    * Region code for tenant context
@@ -4435,12 +4414,9 @@ export type AccountControllerUpdateData = {
   requestBody: UpdateAccountDto;
 };
 
-export type AccountControllerUpdateResponse = AccountResponseDto;
+export type AccountControllerUpdateResponse = unknown;
 
 export type AccountControllerDeleteData = {
-  /**
-   * Account UUID
-   */
   id: string;
   /**
    * Region code for tenant context
@@ -4448,12 +4424,9 @@ export type AccountControllerDeleteData = {
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type AccountControllerDeleteResponse = void;
+export type AccountControllerDeleteResponse = unknown;
 
 export type AccountControllerCloseData = {
-  /**
-   * Account UUID
-   */
   id: string;
   /**
    * Region code for tenant context
@@ -4462,12 +4435,9 @@ export type AccountControllerCloseData = {
   requestBody: CloseAccountDto;
 };
 
-export type AccountControllerCloseResponse = AccountResponseDto;
+export type AccountControllerCloseResponse = unknown;
 
 export type AccountControllerReopenData = {
-  /**
-   * Account UUID
-   */
   id: string;
   /**
    * Region code for tenant context
@@ -4476,7 +4446,7 @@ export type AccountControllerReopenData = {
   requestBody: ReopenAccountDto;
 };
 
-export type AccountControllerReopenResponse = AccountResponseDto;
+export type AccountControllerReopenResponse = unknown;
 
 export type AccountStandardsControllerGetTemplatesData = {
   /**
@@ -4581,6 +4551,20 @@ export type TransactionControllerCreateBatchData = {
 export type TransactionControllerCreateBatchResponse =
   BatchTransactionResponseDto;
 
+export type TransactionControllerCorrectData = {
+  /**
+   * Original transaction ID to correct
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CorrectTransactionDto;
+};
+
+export type TransactionControllerCorrectResponse = TransactionDetailDto;
+
 export type TransactionControllerSuggestTagsData = {
   /**
    * Max suggestions (1-100, default 10)
@@ -5544,25 +5528,13 @@ export type FileImportControllerIdentifyFileData = {
 export type FileImportControllerIdentifyFileResponse = IdentifyResultDto;
 
 export type FileImportControllerImportBeancountData = {
-  /**
-   * Beancount file to import
-   */
-  formData: FileImportDto;
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type FileImportControllerImportBeancountResponse = {
-  imported?: number;
-  skipped?: number;
-  failed?: number;
-  accountsCreated?: number;
-  errors?: Array<{
-    [key: string]: unknown;
-  }>;
-};
+export type FileImportControllerImportBeancountResponse = unknown;
 
 export type ImporterConfigControllerGetConfigData = {
   /**
@@ -5650,26 +5622,15 @@ export type PlatformControllerDeleteData = {
 export type PlatformControllerDeleteResponse = void;
 
 export type ProviderSyncControllerSyncData = {
+  providerName: string;
   /**
-   * Provider name
-   */
-  providerName:
-    | 'plaid'
-    | 'teller'
-    | 'truelayer'
-    | 'gocardless'
-    | 'simplefin'
-    | 'yodlee'
-    | 'beancount-direct'
-    | 'parsed-bill';
-  /**
-   * Region code
+   * Region code for tenant context
    */
-  region: unknown;
+  region: 'cn' | 'us' | 'de' | 'gb';
   requestBody: ProviderSyncDto;
 };
 
-export type ProviderSyncControllerSyncResponse = ProviderSyncResponseDto;
+export type ProviderSyncControllerSyncResponse = unknown;
 
 export type ProviderSyncControllerGetSupportedProvidersData = {
   /**
@@ -5678,115 +5639,262 @@ export type ProviderSyncControllerGetSupportedProvidersData = {
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type ProviderSyncControllerGetSupportedProvidersResponse =
-  SupportedProvidersResponseDto;
+export type ProviderSyncControllerGetSupportedProvidersResponse =
+  SupportedProvidersResponseDto;
+
+export type ProviderSyncControllerIsProviderSupportedData = {
+  /**
+   * Provider name to check
+   */
+  providerName: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type ProviderSyncControllerIsProviderSupportedResponse = unknown;
+
+export type TelemetryControllerReportTelemetryData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: ParserTelemetryReportDto;
+};
+
+export type TelemetryControllerReportTelemetryResponse = unknown;
+
+export type TelemetryControllerReportCoverageMissData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UncoveredFormatMissDto;
+};
+
+export type TelemetryControllerReportCoverageMissResponse = unknown;
+
+export type TelemetryControllerGetCoverageMetricsData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Top-N uncovered formats (default 10)
+   */
+  topN?: unknown;
+};
+
+export type TelemetryControllerGetCoverageMetricsResponse = unknown;
+
+export type NlpControllerProcessNaturalLanguageData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: ProcessNlpDto;
+};
+
+export type NlpControllerProcessNaturalLanguageResponse = unknown;
+
+export type NlpControllerClearSessionData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Specific session ID to clear (defaults to user session)
+   */
+  sessionId?: string;
+};
+
+export type NlpControllerClearSessionResponse = void;
+
+export type NlpControllerGetSessionData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Specific session ID to get (defaults to user session)
+   */
+  sessionId?: string;
+};
+
+export type NlpControllerGetSessionResponse = unknown;
+
+export type DashboardControllerGetNetWorthData = {
+  /**
+   * Date for balance calculation (ISO 8601 format)
+   */
+  date?: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type DashboardControllerGetNetWorthResponse = NetWorthResponseDto;
+
+export type DashboardControllerGetAccountsData = {
+  /**
+   * Scope to a single account (only valid with groupBy=holdingAssetClass, ADR-0105 §6)
+   */
+  accountId?: string;
+  /**
+   * Date for balance calculation (ISO 8601 format)
+   */
+  date?: string;
+  /**
+   * Grouping strategy
+   */
+  groupBy?:
+    | 'platform'
+    | 'assetClass'
+    | 'holdingAssetClass'
+    | 'holdingAssetClassByAccount';
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type DashboardControllerGetAccountsResponse =
+  | AccountsResponseDto
+  | AssetClassAccountsResponseDto
+  | HoldingAssetClassCrossAccountResponseDto;
 
-export type ProviderSyncControllerIsProviderSupportedData = {
+export type DashboardControllerGetCashFlowData = {
   /**
-   * Provider name to check
+   * Period in YYYY-MM format
    */
-  providerName: string;
+  period: string;
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type ProviderSyncControllerIsProviderSupportedResponse = unknown;
+export type DashboardControllerGetCashFlowResponse = CashFlowResponseDto;
 
-export type TelemetryControllerReportTelemetryData = {
+export type HoldingPnlControllerGetHoldingPnlData = {
+  /**
+   * Scope to a single account
+   */
+  accountId?: string;
+  /**
+   * As-of date (ISO 8601), defaults to today
+   */
+  asOf?: string;
+  /**
+   * Realized-P&L lot-matching method (default average). Does not affect the average-cost unrealized basis.
+   */
+  method?: 'FIFO' | 'average';
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
-  requestBody: ParserTelemetryReportDto;
 };
 
-export type TelemetryControllerReportTelemetryResponse = unknown;
+export type HoldingPnlControllerGetHoldingPnlResponse = HoldingPnlResponseDto;
 
-export type NlpControllerProcessNaturalLanguageData = {
+export type PriceControllerCreateData = {
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
-  /**
-   * Natural language transaction input with optional session ID
-   */
-  requestBody: ProcessNlpDto;
+  requestBody: CreateBeanPriceDto;
 };
 
-export type NlpControllerProcessNaturalLanguageResponse = NlpResponseDto;
+export type PriceControllerCreateResponse = PriceResponseDto;
 
-export type NlpControllerClearSessionData = {
+export type PriceControllerFindAllData = {
+  /**
+   * Filter by currency (e.g., BTC, AAPL, USD)
+   */
+  currency?: string;
+  /**
+   * Filter prices from this date (ISO 8601 format)
+   */
+  dateFrom?: string;
+  /**
+   * Filter prices to this date (ISO 8601 format)
+   */
+  dateTo?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Filter by quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency?: string;
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
   /**
-   * Specific session ID to clear (defaults to user session)
+   * Search term for currency or quoteCurrency (case-insensitive partial match)
    */
-  sessionId?: string;
+  search?: string;
 };
 
-export type NlpControllerClearSessionResponse = void;
+export type PriceControllerFindAllResponse = PriceListResponseDto;
 
-export type NlpControllerGetSessionData = {
+export type PriceControllerFindOneData = {
   /**
-   * Region code for tenant context
+   * Price ID
    */
-  region: 'cn' | 'us' | 'de' | 'gb';
+  id: string;
   /**
-   * Specific session ID to get (defaults to user session)
+   * Region code for tenant context
    */
-  sessionId?: string;
+  region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type NlpControllerGetSessionResponse = unknown;
+export type PriceControllerFindOneResponse = PriceResponseDto;
 
-export type DashboardControllerGetNetWorthData = {
+export type PriceControllerUpdateData = {
   /**
-   * Date for balance calculation (ISO 8601 format)
+   * Price ID
    */
-  date?: string;
+  id: string;
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanPriceDto;
 };
 
-export type DashboardControllerGetNetWorthResponse = NetWorthResponseDto;
+export type PriceControllerUpdateResponse = PriceResponseDto;
 
-export type DashboardControllerGetAccountsData = {
+export type PriceControllerDeleteData = {
   /**
-   * Date for balance calculation (ISO 8601 format)
-   */
-  date?: string;
-  /**
-   * Grouping strategy
+   * Price ID
    */
-  groupBy?: 'platform' | 'assetClass';
+  id: string;
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
 };
 
-export type DashboardControllerGetAccountsResponse =
-  | AccountsResponseDto
-  | AssetClassAccountsResponseDto;
+export type PriceControllerDeleteResponse = void;
 
-export type DashboardControllerGetCashFlowData = {
-  /**
-   * Period in YYYY-MM format
-   */
-  period: string;
+export type PriceControllerBulkCreateData = {
   /**
    * Region code for tenant context
    */
   region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: Array<string>;
 };
 
-export type DashboardControllerGetCashFlowResponse = CashFlowResponseDto;
+export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
 
 export type ReportingControllerGetPortfolioTrendsData = {
   /**
@@ -5882,14 +5990,7 @@ export type $OpenApiTs = {
     post: {
       req: AccountControllerCreateData;
       res: {
-        /**
-         * Account created successfully
-         */
-        201: AccountResponseDto;
-        /**
-         * Account already exists
-         */
-        409: unknown;
+        201: unknown;
       };
     };
     get: {
@@ -5919,31 +6020,13 @@ export type $OpenApiTs = {
     put: {
       req: AccountControllerUpdateData;
       res: {
-        /**
-         * Account updated successfully
-         */
-        200: AccountResponseDto;
-        /**
-         * Account not found
-         */
-        404: unknown;
+        200: unknown;
       };
     };
     delete: {
       req: AccountControllerDeleteData;
       res: {
-        /**
-         * Account deleted successfully
-         */
-        204: void;
-        /**
-         * Account not found
-         */
-        404: unknown;
-        /**
-         * Account has transactions and cannot be deleted
-         */
-        409: unknown;
+        200: unknown;
       };
     };
   };
@@ -5951,18 +6034,7 @@ export type $OpenApiTs = {
     post: {
       req: AccountControllerCloseData;
       res: {
-        /**
-         * Account closed successfully
-         */
-        200: AccountResponseDto;
-        /**
-         * Account is already closed
-         */
-        400: unknown;
-        /**
-         * Account not found
-         */
-        404: unknown;
+        201: unknown;
       };
     };
   };
@@ -5970,18 +6042,7 @@ export type $OpenApiTs = {
     post: {
       req: AccountControllerReopenData;
       res: {
-        /**
-         * Account reopened successfully
-         */
-        200: AccountResponseDto;
-        /**
-         * Account is not closed
-         */
-        400: unknown;
-        /**
-         * Account not found
-         */
-        404: unknown;
+        201: unknown;
       };
     };
   };
@@ -6081,6 +6142,29 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/transactions/{id}/correct': {
+    post: {
+      req: TransactionControllerCorrectData;
+      res: {
+        /**
+         * Corrected transaction created
+         */
+        201: TransactionDetailDto;
+        /**
+         * Original transaction not found
+         */
+        404: ApiProblemResponseDto;
+        /**
+         * Original no longer ACTIVE (concurrent modification)
+         */
+        409: ApiProblemResponseDto;
+        /**
+         * Pipeline validation failed (does not balance, invalid accounts)
+         */
+        422: ApiProblemResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/transactions/tags': {
     get: {
       req: TransactionControllerSuggestTagsData;
@@ -7294,22 +7378,7 @@ export type $OpenApiTs = {
     post: {
       req: FileImportControllerImportBeancountData;
       res: {
-        /**
-         * Beancount file imported successfully
-         */
-        200: {
-          imported?: number;
-          skipped?: number;
-          failed?: number;
-          accountsCreated?: number;
-          errors?: Array<{
-            [key: string]: unknown;
-          }>;
-        };
-        /**
-         * Bad request - invalid file or no file uploaded
-         */
-        400: ApiProblemResponseDto;
+        201: unknown;
       };
     };
   };
@@ -7440,22 +7509,7 @@ export type $OpenApiTs = {
     post: {
       req: ProviderSyncControllerSyncData;
       res: {
-        /**
-         * Sync completed successfully
-         */
-        200: ProviderSyncResponseDto;
-        /**
-         * Invalid request data
-         */
-        400: unknown;
-        /**
-         * Missing or invalid authentication
-         */
-        401: unknown;
-        /**
-         * Provider not supported
-         */
-        404: unknown;
+        201: unknown;
       };
     };
   };
@@ -7504,18 +7558,14 @@ export type $OpenApiTs = {
       };
     };
   };
-  '/api/v1/{region}/bean/nlp/process': {
+  '/api/v1/{region}/bean/import/parser-coverage-miss': {
     post: {
-      req: NlpControllerProcessNaturalLanguageData;
+      req: TelemetryControllerReportCoverageMissData;
       res: {
         /**
-         * NLP processing result - either created transaction or asking for more info
-         */
-        200: NlpResponseDto;
-        /**
-         * Invalid input
+         * Coverage miss report received
          */
-        400: unknown;
+        200: unknown;
         /**
          * Unauthorized
          */
@@ -7523,6 +7573,25 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/import/parser-coverage-metrics': {
+    get: {
+      req: TelemetryControllerGetCoverageMetricsData;
+      res: {
+        /**
+         * Coverage metrics
+         */
+        200: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/nlp/process': {
+    post: {
+      req: NlpControllerProcessNaturalLanguageData;
+      res: {
+        201: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/nlp/session': {
     delete: {
       req: NlpControllerClearSessionData;
@@ -7573,7 +7642,10 @@ export type $OpenApiTs = {
         /**
          * Accounts retrieved successfully. Response type depends on groupBy parameter.
          */
-        200: AccountsResponseDto | AssetClassAccountsResponseDto;
+        200:
+          | AccountsResponseDto
+          | AssetClassAccountsResponseDto
+          | HoldingAssetClassCrossAccountResponseDto;
         /**
          * User not authenticated
          */
@@ -7600,6 +7672,109 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/investment/holdings/pnl': {
+    get: {
+      req: HoldingPnlControllerGetHoldingPnlData;
+      res: {
+        /**
+         * Holding P&L retrieved successfully
+         */
+        200: HoldingPnlResponseDto;
+        /**
+         * Invalid asOf format/value/future date, invalid accountId format, or unsupported method
+         */
+        400: unknown;
+        /**
+         * User not authenticated
+         */
+        401: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices': {
+    post: {
+      req: PriceControllerCreateData;
+      res: {
+        /**
+         * Price created successfully
+         */
+        201: PriceResponseDto;
+        /**
+         * Currency or quoteCurrency commodity not found
+         */
+        404: unknown;
+        /**
+         * Price already exists for this currency pair and date
+         */
+        409: unknown;
+      };
+    };
+    get: {
+      req: PriceControllerFindAllData;
+      res: {
+        /**
+         * Prices retrieved successfully
+         */
+        200: PriceListResponseDto;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices/{id}': {
+    get: {
+      req: PriceControllerFindOneData;
+      res: {
+        /**
+         * Price retrieved successfully
+         */
+        200: PriceResponseDto;
+        /**
+         * Price not found
+         */
+        404: unknown;
+      };
+    };
+    put: {
+      req: PriceControllerUpdateData;
+      res: {
+        /**
+         * Price updated successfully
+         */
+        200: PriceResponseDto;
+        /**
+         * Price not found
+         */
+        404: unknown;
+        /**
+         * Updated price conflicts with existing price
+         */
+        409: unknown;
+      };
+    };
+    delete: {
+      req: PriceControllerDeleteData;
+      res: {
+        /**
+         * Price deleted successfully
+         */
+        204: void;
+        /**
+         * Price not found
+         */
+        404: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/prices/bulk': {
+    post: {
+      req: PriceControllerBulkCreateData;
+      res: {
+        /**
+         * Prices created successfully
+         */
+        201: Array<PriceResponseDto>;
+      };
+    };
+  };
   '/api/v1/{region}/reporting/portfolio/trends': {
     get: {
       req: ReportingControllerGetPortfolioTrendsData;