@firela/api-types 0.0.0-canary.6feee68d → 0.0.0-canary.792fa5f1

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 = {
@@ -393,7 +448,7 @@ export type PostingResponseDto = {
    */
   account: string;
   /**
-   * Amount (may be null if interpolated)
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
    */
   units?: string;
   /**
@@ -561,6 +616,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,11 +675,11 @@ export type PostingDetailDto = {
    */
   accountId: string;
   /**
-   * Account name
+   * Fully-qualified Beancount account path
    */
-  accountName: string;
+  account: string;
   /**
-   * Amount (may be null if interpolated)
+   * Amount as decimal string. Typed optional but always present in responses: interpolation fills any MISSING posting before it is persisted or returned.
    */
   units?: string;
   /**
@@ -664,9 +768,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 +795,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 +821,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
@@ -733,6 +840,24 @@ export type TransactionListResponseDto = {
   offset: number;
 };
 
+export type TagSuggestionDto = {
+  /**
+   * Tag name
+   */
+  tag: string;
+  /**
+   * Usage count across ACTIVE transactions
+   */
+  count: number;
+};
+
+export type TagSuggestionsResponseDto = {
+  /**
+   * Tag suggestions sorted as requested
+   */
+  data: Array<TagSuggestionDto>;
+};
+
 export type UpdateTransactionDto = {
   /**
    * Transaction flag (CLEARED, PENDING, etc.)
@@ -834,9 +959,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)
    */
@@ -866,9 +991,9 @@ export type ReviewSummaryDto = {
    */
   confidence: number;
   /**
-   * Confidence level derived from score
+   * Confidence level derived from score. Null for error-type reviews (ACCOUNT_VALIDATION/PIPELINE_ERROR) which carry no confidence.
    */
-  confidenceLevel: 'HIGH' | 'MEDIUM' | 'LOW';
+  confidenceLevel: 'HIGH' | 'MEDIUM' | 'LOW' | null;
   /**
    * i18n message key for summary (e.g., review.summary.duplicate). Translate on frontend with summaryParams.
    */
@@ -884,7 +1009,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;
   /**
@@ -937,7 +1062,7 @@ export type type2 =
 export type status3 = 'PENDING' | 'RESOLVED' | 'EXPIRED' | 'CANCELLED';
 
 /**
- * Confidence level derived from score
+ * Confidence level derived from score. Null for error-type reviews (ACCOUNT_VALIDATION/PIPELINE_ERROR) which carry no confidence.
  */
 export type confidenceLevel = 'HIGH' | 'MEDIUM' | 'LOW';
 
@@ -982,7 +1107,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)
    */
@@ -997,6 +1133,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
@@ -1020,9 +1172,9 @@ export type ReviewDetailDto = {
    */
   confidence: number;
   /**
-   * Confidence level derived from score
+   * Confidence level derived from score. Null for error-type reviews (ACCOUNT_VALIDATION/PIPELINE_ERROR) which carry no confidence.
    */
-  confidenceLevel: 'HIGH' | 'MEDIUM' | 'LOW';
+  confidenceLevel: 'HIGH' | 'MEDIUM' | 'LOW' | null;
   /**
    * i18n message key for summary (e.g., review.summary.duplicate). Translate on frontend with summaryParams.
    */
@@ -1038,7 +1190,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;
   /**
@@ -1091,9 +1243,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)
    */
@@ -1102,6 +1265,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
@@ -1158,7 +1337,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
    */
@@ -3276,6 +3466,8 @@ export type SupportedProvidersResponseDto = {
 
 export type ParserTelemetryReportDto = unknown;
 
+export type UncoveredFormatMissDto = unknown;
+
 export type ProcessNlpDto = {
   /**
    * Natural language text describing a transaction (Chinese)
@@ -3821,7 +4013,7 @@ export type status4 = 'success' | 'pending' | 'error';
 /**
  * Action taken or requested
  */
-export type action =
+export type action2 =
   | 'created'
   | 'ask'
   | 'confirm'
@@ -4061,8 +4253,21 @@ export type AccountItemWithAssetClassDto = {
    * Risk level
    */
   riskLevel?: string;
+  /**
+   * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
+   */
+  source?: 'USER_META' | 'FIAT_CURRENCY' | 'OPENBB_MAPPING' | 'FALLBACK';
 };
 
+/**
+ * ADR-0105 classification provenance (holding level always; account level only on FALLBACK)
+ */
+export type source2 =
+  | 'USER_META'
+  | 'FIAT_CURRENCY'
+  | 'OPENBB_MAPPING'
+  | 'FALLBACK';
+
 export type AssetClassGroupDto = {
   /**
    * Asset class name
@@ -4149,6 +4354,12 @@ export type AssetClassSummaryDto = {
    * Exchange rate warnings
    */
   warnings?: Array<AccountExchangeRateWarningDto>;
+  /**
+   * ADR-0105 §4 fallback provenance stats (holding level only). valueRatio is the grey-area share of total converted value; count is the number of source=FALLBACK holdings.
+   */
+  fallback?: {
+    [key: string]: unknown;
+  };
 };
 
 export type AssetClassAccountsResponseDto = {
@@ -4160,6 +4371,56 @@ export type AssetClassAccountsResponseDto = {
    * Summary statistics
    */
   summary: AssetClassSummaryDto;
+  /**
+   * ADR-0105 §6 holding-level grey-area bucket (source=FALLBACK holdings peeled out of groups). Present only for groupBy=holdingAssetClass when FALLBACK holdings exist.
+   */
+  uncategorized?: AssetClassGroupDto;
+};
+
+export type HoldingAssetClassAccountSliceDto = {
+  /**
+   * Account ID
+   */
+  accountId: string;
+  /**
+   * Full account path
+   */
+  accountPath: string;
+  /**
+   * Currency of the holding with the largest converted base value; undefined when no holding is convertible
+   */
+  accountCurrency?: string;
+  /**
+   * Account's market value in base currency (Σ converted holdings; grey bucket included)
+   */
+  marketValueBase: string;
+  /**
+   * Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).
+   */
+  shareOfTotalPct: number;
+  /**
+   * Per-account asset-class breakdown
+   */
+  groups: Array<AssetClassGroupDto>;
+  /**
+   * Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)
+   */
+  uncategorized?: AssetClassGroupDto;
+  /**
+   * Every holding row for this account (account ID in each row’s `id` field)
+   */
+  holdings: Array<AccountItemWithAssetClassDto>;
+};
+
+export type HoldingAssetClassCrossAccountResponseDto = {
+  /**
+   * Merged cross-account holding aggregation
+   */
+  global: AssetClassAccountsResponseDto;
+  /**
+   * Per-account slices
+   */
+  byAccount: Array<HoldingAssetClassAccountSliceDto>;
 };
 
 export type CashFlowByCurrencyDto = {
@@ -4241,151 +4502,448 @@ export type CashFlowResponseDto = {
   warnings?: Array<ExchangeRateWarningDto>;
 };
 
-export type CurrencyBalanceDto = {
-  /**
-   * ISO 4217 currency code
-   */
-  currency: string;
-  /**
-   * Balance amount
-   */
-  balance: string;
-};
-
-export type TimeSeriesPointDto = {
+export type MonetaryDto = {
   /**
-   * Date in YYYY-MM-DD format
+   * Amount (Decimal string)
    */
-  date: string;
+  amount: string;
   /**
-   * Value at this date (in base currency)
+   * ISO 4217 currency
    */
-  value: string;
+  currency: string;
   /**
-   * Change from previous point
+   * Converted to user base currency (Decimal string)
    */
-  change?: {
+  baseCcyEquivalent?: {
     [key: string]: unknown;
-  };
-  /**
-   * Multi-currency breakdown for this point
-   */
-  byCurrency?: Array<CurrencyBalanceDto>;
+  } | null;
 };
 
-export type TrendSummaryDto = {
+export type CurrentPriceDto = {
   /**
-   * Value at start of period
+   * Price amount (Decimal string)
    */
-  startValue: string;
+  amount: string;
   /**
-   * Value at end of period
+   * Price currency (ISO 4217)
    */
-  endValue: string;
+  currency: string;
   /**
-   * Total change over period
+   * Price date (ISO 8601)
    */
-  totalChange: string;
+  date: string;
   /**
-   * Total change percentage
+   * Price source
    */
-  totalChangePercentage: string;
+  source: 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
 };
 
-export type MultiCurrencyPointDto = {
+/**
+ * Price source
+ */
+export type source3 = 'USER_OVERRIDE' | 'OPENBB_EQUITY' | 'OPENBB_CURRENCY';
+
+export type FxRateDto = {
+  from: string;
+  to: string;
   /**
-   * Date in YYYY-MM-DD format
+   * FX rate (Decimal string)
    */
-  date: string;
+  rate: string;
   /**
-   * Balances by currency
+   * Rate date (ISO 8601)
    */
-  byCurrency: Array<CurrencyBalanceDto>;
+  date: string;
 };
 
-export type PortfolioTrendsResponseDto = {
+export type HoldingPnlRowDto = {
   /**
-   * Time series data points
+   * Account UUID
    */
-  series: Array<TimeSeriesPointDto>;
+  accountId: string;
   /**
-   * Period summary
+   * Full account path
    */
-  summary: TrendSummaryDto;
+  accountPath: string;
   /**
-   * Period requested
+   * Account settlement currency (ISO 4217), from cost currency
    */
-  period: string;
+  accountCcy?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Data granularity
+   * Broker type derived from Platform.type
    */
-  granularity: string;
+  brokerType?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Base currency for converted values
+   * Commodity symbol
    */
-  currency: string;
+  symbol: string;
   /**
-   * Multi-currency time series (each point has currency breakdown)
+   * Chart segment token (libs/common resolver)
    */
-  byCurrency?: Array<MultiCurrencyPointDto>;
+  chartToken: 'equity' | 'fund' | 'bond' | 'cash' | 'other';
+  assetClass: string;
+  assetSubClass?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Exchange rate warnings
+   * Net held units (Decimal string)
    */
-  warnings?: Array<ExchangeRateWarningDto>;
-};
-
-export type GenerateSnapshotBody = unknown;
-
-export type GenerateSnapshotResponse = unknown;
-
-export type BackfillSnapshotsBody = unknown;
-
-export type BackfillSnapshotsResponse = unknown;
-
-export type AnonymousLoginDto = {
+  units: string;
   /**
-   * Access token for anonymous login
+   * Average cost per unit; null when cost currency conflicts or no cost
    */
-  accessToken: string;
-};
-
-export type AccountControllerCreateData = {
+  averageCostPerUnit?: MonetaryDto | null;
   /**
-   * Region code for tenant context
+   * Cost basis of held units
    */
-  region: 'cn' | 'us' | 'de' | 'gb';
-  requestBody: CreateAccountDto;
-};
-
-export type AccountControllerCreateResponse = AccountResponseDto;
-
-export type AccountControllerFindAllData = {
+  costBasis?: MonetaryDto | null;
   /**
-   * Filter by custom (user-created) accounts only
+   * Market value at asOf price
    */
-  isCustom?: boolean;
+  marketValue?: MonetaryDto | null;
   /**
-   * Maximum number of results
+   * Price used for market value
    */
-  limit?: number;
+  currentPrice?: CurrentPriceDto | null;
   /**
-   * Number of results to skip
+   * Unrealized P&L in base currency (Decimal string); null when any FX/price missing
    */
-  offset?: number;
+  unrealizedPnlBase?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Region code for tenant context
+   * Unrealized P&L % (Decimal string)
    */
-  region: 'cn' | 'us' | 'de' | 'gb';
+  unrealizedPnlPct?: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Search term for path or i18nKey
+   * Historical FX rate applied to cost basis
    */
-  search?: string;
+  costFxRate?: FxRateDto | null;
   /**
-   * Filter by status
+   * FX rate applied to market value
    */
-  status?: 'OPEN' | 'CLOSED' | 'SUSPENDED';
+  marketFxRate?: FxRateDto | null;
   /**
-   * Filter by account type
+   * Share of invested assets % (Decimal string); only for invested chartTokens
+   */
+  pctOfInvestedAssets?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Cumulative realized P&L on sold lots (asOf-date cutoff); null when the method has no applicable sells, a sell lacks a price, or any required FX rate is missing (never-mix). When a sell spans multiple currencies (cross-currency sale), amount and currency reflect the base currency; baseCcyEquivalent is always the authoritative dual-FX figure
+   */
+  realizedPnl?: MonetaryDto | null;
+};
+
+/**
+ * Chart segment token (libs/common resolver)
+ */
+export type chartToken = 'equity' | 'fund' | 'bond' | 'cash' | 'other';
+
+export type HoldingPnlWarningDto = {
+  /**
+   * Warning type
+   */
+  type:
+    | 'MISSING_COST_FX_RATE'
+    | 'MISSING_MARKET_FX_RATE'
+    | 'MISSING_SALE_PRICE'
+    | 'MISSING_REALIZED_FX_RATE'
+    | 'OVERSOLD_LOTS'
+    | 'NO_PRICE'
+    | 'MIXED_COST_CURRENCY';
+  symbol?: {
+    [key: string]: unknown;
+  } | null;
+  accountId?: {
+    [key: string]: unknown;
+  } | null;
+  currency?: {
+    [key: string]: unknown;
+  } | null;
+};
+
+/**
+ * Warning type
+ */
+export type type4 =
+  | 'MISSING_COST_FX_RATE'
+  | 'MISSING_MARKET_FX_RATE'
+  | 'MISSING_SALE_PRICE'
+  | 'MISSING_REALIZED_FX_RATE'
+  | 'OVERSOLD_LOTS'
+  | 'NO_PRICE'
+  | 'MIXED_COST_CURRENCY';
+
+export type HoldingPnlResponseDto = {
+  asOfDate: string;
+  baseCurrency: string;
+  /**
+   * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
+   */
+  method: 'average' | 'FIFO';
+  rows: Array<HoldingPnlRowDto>;
+  warnings: Array<HoldingPnlWarningDto>;
+};
+
+/**
+ * Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).
+ */
+export type method = 'average' | 'FIFO';
+
+export type CreateBeanPriceDto = {
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., CNY, EUR)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date: string;
+  /**
+   * Metadata (validated by Zod schema, max field lengths enforced)
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
+export type PriceResponseDto = {
+  /**
+   * Unique identifier
+   */
+  id: string;
+  /**
+   * User ID (owner of the price)
+   */
+  userId: string;
+  /**
+   * Currency being priced (e.g., USD, AAPL, BTC)
+   */
+  currency: string;
+  /**
+   * Quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency: string;
+  /**
+   * Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.
+   */
+  amount: number;
+  /**
+   * Price date (ISO 8601 format). Represents the date this price was valid.
+   */
+  date: string;
+  /**
+   * Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.
+   */
+  meta: {
+    [key: string]: unknown;
+  };
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+};
+
+export type PriceListResponseDto = {
+  /**
+   * List of prices
+   */
+  items: Array<PriceResponseDto>;
+  /**
+   * Total number of prices
+   */
+  total: number;
+};
+
+export type UpdateBeanPriceDto = {
+  /**
+   * Currency being priced
+   */
+  currency?: string;
+  /**
+   * Quote currency (pricing currency)
+   */
+  quoteCurrency?: string;
+  /**
+   * Price amount (MUST be >= 0 per Beancount spec)
+   */
+  amount?: number;
+  /**
+   * Price date (ISO 8601 format)
+   */
+  date?: string;
+  /**
+   * Metadata
+   */
+  metadata?: {
+    [key: string]: unknown;
+  };
+};
+
+export type CurrencyBalanceDto = {
+  /**
+   * ISO 4217 currency code
+   */
+  currency: string;
+  /**
+   * Balance amount
+   */
+  balance: string;
+};
+
+export type TimeSeriesPointDto = {
+  /**
+   * Date in YYYY-MM-DD format
+   */
+  date: string;
+  /**
+   * Value at this date (in base currency)
+   */
+  value: string;
+  /**
+   * Change from previous point
+   */
+  change?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Multi-currency breakdown for this point
+   */
+  byCurrency?: Array<CurrencyBalanceDto>;
+};
+
+export type TrendSummaryDto = {
+  /**
+   * Value at start of period
+   */
+  startValue: string;
+  /**
+   * Value at end of period
+   */
+  endValue: string;
+  /**
+   * Total change over period
+   */
+  totalChange: string;
+  /**
+   * Total change percentage
+   */
+  totalChangePercentage: string;
+};
+
+export type MultiCurrencyPointDto = {
+  /**
+   * Date in YYYY-MM-DD format
+   */
+  date: string;
+  /**
+   * Balances by currency
+   */
+  byCurrency: Array<CurrencyBalanceDto>;
+};
+
+export type PortfolioTrendsResponseDto = {
+  /**
+   * Time series data points
+   */
+  series: Array<TimeSeriesPointDto>;
+  /**
+   * Period summary
+   */
+  summary: TrendSummaryDto;
+  /**
+   * Period requested
+   */
+  period: string;
+  /**
+   * Data granularity
+   */
+  granularity: string;
+  /**
+   * Base currency for converted values
+   */
+  currency: string;
+  /**
+   * Multi-currency time series (each point has currency breakdown)
+   */
+  byCurrency?: Array<MultiCurrencyPointDto>;
+  /**
+   * Exchange rate warnings
+   */
+  warnings?: Array<ExchangeRateWarningDto>;
+};
+
+export type GenerateSnapshotBody = unknown;
+
+export type GenerateSnapshotResponse = unknown;
+
+export type BackfillSnapshotsBody = unknown;
+
+export type BackfillSnapshotsResponse = unknown;
+
+export type AnonymousLoginDto = {
+  /**
+   * Access token for anonymous login
+   */
+  accessToken: string;
+};
+
+export type AccountControllerCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateAccountDto;
+};
+
+export type AccountControllerCreateResponse = AccountResponseDto;
+
+export type AccountControllerFindAllData = {
+  /**
+   * Filter by custom (user-created) accounts only
+   */
+  isCustom?: boolean;
+  /**
+   * Maximum number of results
+   */
+  limit?: number;
+  /**
+   * Number of results to skip
+   */
+  offset?: number;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Search term for path or i18nKey
+   */
+  search?: string;
+  /**
+   * Filter by status
+   */
+  status?: 'OPEN' | 'CLOSED' | 'SUSPENDED';
+  /**
+   * Filter by account type
    */
   type?: 'Assets' | 'Liabilities' | 'Income' | 'Expenses' | 'Equity';
 };
@@ -4563,6 +5121,42 @@ 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)
+   */
+  limit?: number;
+  /**
+   * Prefix match, case-insensitive (max 50 chars)
+   */
+  q?: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * usage (default) or name
+   */
+  sort?: 'usage' | 'name';
+};
+
+export type TransactionControllerSuggestTagsResponse =
+  TagSuggestionsResponseDto;
+
 export type TransactionControllerGetDetailData = {
   /**
    * Transaction ID
@@ -5623,9 +6217,9 @@ export type ProviderSyncControllerSyncData = {
     | 'beancount-direct'
     | 'parsed-bill';
   /**
-   * Region code
+   * Region code for tenant context
    */
-  region: unknown;
+  region: 'cn' | 'us' | 'de' | 'gb';
   requestBody: ProviderSyncDto;
 };
 
@@ -5664,6 +6258,29 @@ export type TelemetryControllerReportTelemetryData = {
 
 export type TelemetryControllerReportTelemetryResponse = unknown;
 
+export type TelemetryControllerReportCoverageMissData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UncoveredFormatMissDto;
+};
+
+export type TelemetryControllerReportCoverageMissResponse = unknown;
+
+export type TelemetryControllerGetCoverageMetricsData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Top-N uncovered formats (default 10)
+   */
+  topN?: unknown;
+};
+
+export type TelemetryControllerGetCoverageMetricsResponse = unknown;
+
 export type NlpControllerProcessNaturalLanguageData = {
   /**
    * Region code for tenant context
@@ -5717,6 +6334,10 @@ export type DashboardControllerGetNetWorthData = {
 export type DashboardControllerGetNetWorthResponse = NetWorthResponseDto;
 
 export type DashboardControllerGetAccountsData = {
+  /**
+   * Scope to a single account (only valid with groupBy=holdingAssetClass, ADR-0105 §6)
+   */
+  accountId?: string;
   /**
    * Date for balance calculation (ISO 8601 format)
    */
@@ -5724,7 +6345,11 @@ export type DashboardControllerGetAccountsData = {
   /**
    * Grouping strategy
    */
-  groupBy?: 'platform' | 'assetClass';
+  groupBy?:
+    | 'platform'
+    | 'assetClass'
+    | 'holdingAssetClass'
+    | 'holdingAssetClassByAccount';
   /**
    * Region code for tenant context
    */
@@ -5733,7 +6358,8 @@ export type DashboardControllerGetAccountsData = {
 
 export type DashboardControllerGetAccountsResponse =
   | AccountsResponseDto
-  | AssetClassAccountsResponseDto;
+  | AssetClassAccountsResponseDto
+  | HoldingAssetClassCrossAccountResponseDto;
 
 export type DashboardControllerGetCashFlowData = {
   /**
@@ -5748,6 +6374,124 @@ export type DashboardControllerGetCashFlowData = {
 
 export type DashboardControllerGetCashFlowResponse = CashFlowResponseDto;
 
+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';
+};
+
+export type HoldingPnlControllerGetHoldingPnlResponse = HoldingPnlResponseDto;
+
+export type PriceControllerCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: CreateBeanPriceDto;
+};
+
+export type PriceControllerCreateResponse = PriceResponseDto;
+
+export type PriceControllerFindAllData = {
+  /**
+   * Filter by currency (e.g., BTC, AAPL, USD)
+   */
+  currency?: string;
+  /**
+   * Filter prices from this date (ISO 8601 format)
+   */
+  dateFrom?: string;
+  /**
+   * Filter prices to this date (ISO 8601 format)
+   */
+  dateTo?: string;
+  /**
+   * Number of items per page (default: 20, max: 100)
+   */
+  limit?: number;
+  /**
+   * Page number for pagination (default: 1)
+   */
+  page?: number;
+  /**
+   * Filter by quote currency (pricing currency, e.g., USD, CNY)
+   */
+  quoteCurrency?: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  /**
+   * Search term for currency or quoteCurrency (case-insensitive partial match)
+   */
+  search?: string;
+};
+
+export type PriceControllerFindAllResponse = PriceListResponseDto;
+
+export type PriceControllerFindOneData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerFindOneResponse = PriceResponseDto;
+
+export type PriceControllerUpdateData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: UpdateBeanPriceDto;
+};
+
+export type PriceControllerUpdateResponse = PriceResponseDto;
+
+export type PriceControllerDeleteData = {
+  /**
+   * Price ID
+   */
+  id: string;
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+};
+
+export type PriceControllerDeleteResponse = void;
+
+export type PriceControllerBulkCreateData = {
+  /**
+   * Region code for tenant context
+   */
+  region: 'cn' | 'us' | 'de' | 'gb';
+  requestBody: Array<string>;
+};
+
+export type PriceControllerBulkCreateResponse = Array<PriceResponseDto>;
+
 export type ReportingControllerGetPortfolioTrendsData = {
   /**
    * Data granularity
@@ -6041,6 +6785,48 @@ 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;
+      res: {
+        /**
+         * Tag suggestions
+         */
+        200: TagSuggestionsResponseDto;
+        /**
+         * Validation failed
+         */
+        400: ApiProblemResponseDto;
+        /**
+         * Authentication required
+         */
+        401: ApiProblemResponseDto;
+      };
+    };
+  };
   '/api/v1/{region}/bean/transactions/{id}': {
     get: {
       req: TransactionControllerGetDetailData;
@@ -7445,6 +8231,32 @@ export type $OpenApiTs = {
       };
     };
   };
+  '/api/v1/{region}/bean/import/parser-coverage-miss': {
+    post: {
+      req: TelemetryControllerReportCoverageMissData;
+      res: {
+        /**
+         * Coverage miss report received
+         */
+        200: unknown;
+        /**
+         * Unauthorized
+         */
+        401: unknown;
+      };
+    };
+  };
+  '/api/v1/{region}/bean/import/parser-coverage-metrics': {
+    get: {
+      req: TelemetryControllerGetCoverageMetricsData;
+      res: {
+        /**
+         * Coverage metrics
+         */
+        200: unknown;
+      };
+    };
+  };
   '/api/v1/{region}/bean/nlp/process': {
     post: {
       req: NlpControllerProcessNaturalLanguageData;
@@ -7514,7 +8326,10 @@ export type $OpenApiTs = {
         /**
          * Accounts retrieved successfully. Response type depends on groupBy parameter.
          */
-        200: AccountsResponseDto | AssetClassAccountsResponseDto;
+        200:
+          | AccountsResponseDto
+          | AssetClassAccountsResponseDto
+          | HoldingAssetClassCrossAccountResponseDto;
         /**
          * User not authenticated
          */
@@ -7541,6 +8356,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;