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

package/src/generated/schemas.gen.ts

@@ -466,6 +466,66 @@ export const $RegionsMetadataResponseDto = {
   required: ['regions']
 } as const;
 
+export const $CostSpecDto = {
+  type: 'object',
+  properties: {
+    mode: {
+      type: 'string',
+      enum: ['per-unit', 'total', 'date', 'label', 'auto'],
+      description: 'Cost specification mode (mirrors engine CostSpec)'
+    },
+    numberPerUnit: {
+      type: 'string',
+      description: 'Per-unit cost (required when mode is "per-unit")',
+      example: '240'
+    },
+    totalNumber: {
+      type: 'string',
+      description: 'Total cost for all units (required when mode is "total")',
+      example: '12000'
+    },
+    currency: {
+      type: 'string',
+      description: 'Cost currency (required in all modes)',
+      example: 'USD'
+    },
+    date: {
+      type: 'string',
+      description:
+        'Lot acquisition date, ISO 8601 (required when mode is "date")',
+      example: '2024-01-15'
+    },
+    label: {
+      type: 'string',
+      description:
+        'Lot label (required when mode is "label"; optional tag in buy modes)'
+    },
+    merge: {
+      type: 'boolean',
+      description: 'Merge lots for AVERAGE booking (mode: auto)'
+    }
+  },
+  required: ['mode', 'currency']
+} as const;
+
+export const $AmountDto = {
+  type: 'object',
+  properties: {
+    number: {
+      type: 'string',
+      description:
+        'Amount as decimal string (max 15 integer + 15 decimal digits)',
+      example: '170.50'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency/commodity code',
+      example: 'USD'
+    }
+  },
+  required: ['number', 'currency']
+} as const;
+
 export const $CreatePostingDto = {
   type: 'object',
   properties: {
@@ -495,6 +555,33 @@ export const $CreatePostingDto = {
       example: {
         'tax-lot': 'Q1-2024'
       }
+    },
+    cost: {
+      description:
+        'Cost basis (Beancount `{...}`). Maps to engine costSpec. Required for commodity holdings so they carry a monetary weight that can balance.',
+      example: {
+        mode: 'per-unit',
+        numberPerUnit: '240',
+        currency: 'USD'
+      },
+      allOf: [
+        {
+          $ref: '#/components/schemas/CostSpecDto'
+        }
+      ]
+    },
+    price: {
+      description:
+        'Price annotation (Beancount `@...`). Maps to engine price. Used for valuation; cost takes priority for balance weight.',
+      example: {
+        number: '170',
+        currency: 'USD'
+      },
+      allOf: [
+        {
+          $ref: '#/components/schemas/AmountDto'
+        }
+      ]
     }
   },
   required: ['account']
@@ -573,6 +660,32 @@ export const $CreateTransactionDto = {
   required: ['date', 'narration', 'postings']
 } as const;
 
+export const $CostDetailDto = {
+  type: 'object',
+  properties: {
+    number: {
+      type: 'string',
+      description: 'Per-unit cost basis (mirrors engine Cost.number)',
+      example: '240'
+    },
+    currency: {
+      type: 'string',
+      description: 'Cost currency',
+      example: 'USD'
+    },
+    date: {
+      type: 'string',
+      description: 'Lot acquisition date (ISO yyyy-mm-dd)',
+      example: '2024-01-15'
+    },
+    label: {
+      type: 'string',
+      description: 'Lot label',
+      example: 'lot-2024-01'
+    }
+  }
+} as const;
+
 export const $PostingResponseDto = {
   type: 'object',
   properties: {
@@ -591,6 +704,15 @@ export const $PostingResponseDto = {
       type: 'string',
       description: 'Currency',
       example: 'USD'
+    },
+    cost: {
+      description:
+        'Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/CostDetailDto'
+        }
+      ]
     }
   },
   required: ['account']
@@ -841,6 +963,85 @@ export const $BatchTransactionResponseDto = {
   required: ['succeeded', 'failed']
 } as const;
 
+export const $CorrectTransactionDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Transaction date (ISO 8601 format)',
+      example: '2024-11-28'
+    },
+    flag: {
+      type: 'string',
+      description: 'Transaction flag: * (cleared), ! (pending)',
+      enum: ['*', '!'],
+      example: '*'
+    },
+    payee: {
+      type: 'string',
+      description: 'Payee name',
+      example: 'Whole Foods Market'
+    },
+    narration: {
+      type: 'string',
+      description: 'Transaction narration/description',
+      example: 'Grocery shopping'
+    },
+    tags: {
+      description: 'Transaction tags (without # prefix)',
+      example: ['vacation', 'personal'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    links: {
+      description: 'Transaction links (without ^ prefix)',
+      example: ['invoice-123'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    postings: {
+      description:
+        'Transaction postings (minimum 1, typically 2 for double-entry)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CreatePostingDto'
+      }
+    },
+    meta: {
+      type: 'object',
+      description: 'Transaction-level metadata',
+      example: {
+        invoice: '12345'
+      }
+    },
+    idempotencyKey: {
+      type: 'string',
+      description:
+        'Unique key for idempotent transaction creation. If provided, duplicate requests with the same key will return the existing transaction.',
+      example: 'import-2024-01-15-batch-001',
+      maxLength: 128
+    },
+    autoCreateAccounts: {
+      type: 'boolean',
+      description:
+        '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.',
+      default: true,
+      example: true
+    },
+    correctionReason: {
+      type: 'string',
+      description: 'Reason for correcting/superseding the original transaction',
+      example: 'Wrong amount — corrected from receipt',
+      maxLength: 500
+    }
+  },
+  required: ['date', 'narration', 'postings']
+} as const;
+
 export const $PostingDetailDto = {
   type: 'object',
   properties: {
@@ -854,9 +1055,9 @@ export const $PostingDetailDto = {
       description: 'Account ID',
       example: 'clh1234567890abcdef'
     },
-    accountName: {
+    account: {
       type: 'string',
-      description: 'Account name',
+      description: 'Fully-qualified Beancount account path',
       example: 'Assets:Bank:Checking'
     },
     units: {
@@ -885,6 +1086,15 @@ export const $PostingDetailDto = {
       description: 'Cost date',
       example: '2024-01-15'
     },
+    cost: {
+      description:
+        'Booking-resolved cost (mirrors engine Cost). Undefined when the posting has no cost basis.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/CostDetailDto'
+        }
+      ]
+    },
     priceAmount: {
       type: 'string',
       description: 'Price amount',
@@ -905,7 +1115,7 @@ export const $PostingDetailDto = {
       description: 'Posting metadata'
     }
   },
-  required: ['id', 'accountId', 'accountName']
+  required: ['id', 'accountId', 'account']
 } as const;
 
 export const $TransactionDetailDto = {
@@ -977,8 +1187,8 @@ export const $TransactionDetailDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (how the transaction was created)',
-      enum: ['NLP', 'CSV', 'OCR', 'API']
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1011,6 +1221,18 @@ export const $TransactionDetailDto = {
       type: 'string',
       description: 'Correction reason (if voided or superseded)',
       example: 'Duplicate entry'
+    },
+    supersededBy: {
+      type: 'string',
+      description:
+        'ID of the transaction that supersedes this one (set when status=SUPERSEDED)',
+      example: 'clh1234567890abcdef'
+    },
+    originalTxn: {
+      type: 'string',
+      description:
+        'ID of the transaction this one corrected/replaced (back-link on the replacement)',
+      example: 'clh1234567890abcdef'
     }
   },
   required: [
@@ -1235,8 +1457,8 @@ export const $TransactionSummaryDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)',
-      enum: ['NLP', 'CSV', 'OCR', 'API']
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1303,7 +1525,8 @@ export const $ReviewSummaryDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)'
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1413,7 +1636,20 @@ export const $DecisionOptionDto = {
   properties: {
     value: {
       type: 'string',
-      description: 'The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)'
+      description: 'The action value to submit (e.g., UPGRADE_REPLACE, ACCEPT)',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ]
     },
     labelKey: {
       type: 'string',
@@ -1488,7 +1724,8 @@ export const $ReviewDetailDto = {
     },
     sourceType: {
       type: 'string',
-      description: 'Source type (NLP, CSV, OCR, API)'
+      description:
+        'Source type (free-form string from transaction metadata, e.g. import, api)'
     },
     sourcePlatform: {
       type: 'string',
@@ -1568,7 +1805,20 @@ export const $ResolveReviewDto = {
     action: {
       type: 'string',
       description:
-        '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.',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ],
       example: 'ACCEPT'
     },
     data: {
@@ -1659,6 +1909,19 @@ export const $BatchResolveDto = {
     action: {
       type: 'string',
       description: 'Decision action to apply to all items',
+      enum: [
+        'UPGRADE_REPLACE',
+        'LINK_KEEP_BOTH',
+        'IGNORE_NEW',
+        'CONFIRM_DIFFERENT',
+        'ACCEPT',
+        'REJECT',
+        'ACCEPT_AND_LEARN',
+        'CHOOSE_OTHER',
+        'CANCEL',
+        'FIX',
+        'IGNORE'
+      ],
       example: 'ACCEPT'
     },
     data: {
@@ -4648,49 +4911,6 @@ export const $ProviderSyncDto = {
   required: ['config', 'transactions']
 } as const;
 
-export const $ProviderSyncResponseDto = {
-  type: 'object',
-  properties: {
-    imported: {
-      type: 'number',
-      description: 'Number of transactions successfully imported',
-      example: 10
-    },
-    skipped: {
-      type: 'number',
-      description: 'Number of transactions skipped (duplicates)',
-      example: 2
-    },
-    pendingReview: {
-      type: 'number',
-      description: 'Number of transactions pending review',
-      example: 3
-    },
-    failed: {
-      type: 'number',
-      description: 'Number of transactions that failed to import',
-      example: 0
-    },
-    importedTransactionIds: {
-      description: 'IDs of successfully imported transactions',
-      example: ['txn-001', 'txn-002'],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    },
-    reviewItemIds: {
-      description: 'IDs of review items created for branched transactions',
-      example: ['review-001', 'review-002'],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    }
-  },
-  required: ['imported', 'skipped', 'pendingReview', 'failed']
-} as const;
-
 export const $SupportedProvidersResponseDto = {
   type: 'object',
   properties: {
@@ -4720,6 +4940,11 @@ export const $ParserTelemetryReportDto = {
   properties: {}
 } as const;
 
+export const $UncoveredFormatMissDto = {
+  type: 'object',
+  properties: {}
+} as const;
+
 export const $ProcessNlpDto = {
   type: 'object',
   properties: {
@@ -4749,825 +4974,599 @@ export const $ProcessNlpDto = {
   required: ['message']
 } as const;
 
-export const $NlpTransactionInfoDto = {
+export const $BalanceByCurrencyDto = {
   type: 'object',
   properties: {
-    id: {
-      type: 'string',
-      description: 'Transaction ID'
-    },
-    date: {
-      type: 'string',
-      description: 'Transaction date (ISO format)'
-    },
-    amount: {
-      type: 'number',
-      description: 'Transaction amount'
-    },
     currency: {
       type: 'string',
-      description: 'Currency code'
-    },
-    payee: {
-      type: 'string',
-      description: 'Payee name'
-    },
-    narration: {
-      type: 'string',
-      description: 'Transaction narration'
+      description: 'ISO 4217 currency code',
+      example: 'CNY'
     },
-    warning: {
+    balance: {
       type: 'string',
-      description:
-        'Warning message for special transaction scenarios (e.g., cross-currency settlement)',
-      example: '此交易使用USD账户结算。如需记录CNY支出，请创建货币转换交易。'
+      description: 'Balance amount',
+      example: '50000.00'
     }
   },
-  required: ['id', 'date', 'amount', 'currency']
+  required: ['currency', 'balance']
 } as const;
 
-export const $NlpParsedDataDto = {
+export const $NetWorthByCurrencyDto = {
   type: 'object',
   properties: {
-    amount: {
-      type: 'number',
-      description: 'Extracted amount'
-    },
-    currency: {
-      type: 'string',
-      description: 'Currency code',
-      default: 'CNY'
-    },
-    date: {
-      type: 'string',
-      description: 'Transaction date (ISO format)'
+    netWorth: {
+      description: 'Net worth by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
     },
-    payee: {
-      type: 'string',
-      description: 'Payee name'
-    },
-    narration: {
-      type: 'string',
-      description: 'Transaction narration'
-    },
-    category: {
-      type: 'string',
-      description: 'Category'
-    },
-    incomeType: {
-      type: 'string',
-      description: 'Income type (e.g., Salary, Bonus, Dividend, Interest)',
-      example: 'Salary'
-    },
-    incomeSource: {
-      type: 'string',
-      description: 'Income source (e.g., company name)',
-      example: 'Anthropic Inc.'
-    },
-    symbol: {
-      type: 'string',
-      description: 'Security symbol code (e.g., 600519, AAPL)',
-      example: '600519'
-    },
-    quantity: {
-      type: 'number',
-      description: 'Quantity of shares/units',
-      example: 100
-    },
-    price: {
-      type: 'number',
-      description: 'Unit price per share/unit',
-      example: 1900
-    },
-    investmentAction: {
-      type: 'string',
-      description: 'Investment action',
-      enum: ['buy', 'sell'],
-      example: 'buy'
-    },
-    paymentSource: {
-      type: 'string',
-      description: 'Payment source: asset (default) or liability (credit card)',
-      enum: ['asset', 'liability'],
-      example: 'asset'
-    },
-    liabilityHint: {
-      type: 'string',
-      description: 'Liability account hint (CreditCard/Huabei/Baitiao)',
-      example: 'CreditCard'
+    assets: {
+      description: 'Assets by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
     },
-    warning: {
-      type: 'string',
-      description:
-        'Warning message for special scenarios (e.g., cross-currency settlement)',
-      example: '此交易使用USD账户结算。如需记录CNY支出，请创建货币转换交易。'
+    liabilities: {
+      description: 'Liabilities by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
     }
-  }
+  },
+  required: ['netWorth', 'assets', 'liabilities']
 } as const;
 
-export const $NlpSourceTransactionDto = {
+export const $ConvertedNetWorthDto = {
   type: 'object',
   properties: {
-    date: {
+    baseCurrency: {
       type: 'string',
-      description: 'Transaction date (ISO format)'
+      description: 'Base currency for conversion',
+      example: 'CNY'
     },
-    amount: {
+    netWorth: {
       type: 'string',
-      description: 'Amount as string'
+      description: 'Converted net worth',
+      example: '500000.00'
     },
-    currency: {
+    assets: {
       type: 'string',
-      description: 'Currency code'
+      description: 'Converted assets',
+      example: '600000.00'
     },
-    payee: {
+    liabilities: {
       type: 'string',
-      description: 'Payee name'
+      description: 'Converted liabilities',
+      example: '100000.00'
     },
-    narration: {
-      type: 'string',
-      description: 'Transaction narration'
+    exchangeRates: {
+      type: 'object',
+      description: 'Exchange rates used for conversion',
+      example: {
+        USD: '7.200000',
+        EUR: '7.800000'
+      }
     }
   },
-  required: ['date', 'amount', 'currency', 'narration']
+  required: [
+    'baseCurrency',
+    'netWorth',
+    'assets',
+    'liabilities',
+    'exchangeRates'
+  ]
 } as const;
 
-export const $NlpTargetTransactionDto = {
+export const $ExchangeRateWarningDto = {
   type: 'object',
   properties: {
-    id: {
-      type: 'string',
-      description: 'Existing transaction ID'
-    },
-    date: {
-      type: 'string',
-      description: 'Transaction date (ISO format)'
-    },
-    amount: {
+    type: {
       type: 'string',
-      description: 'Amount as string'
+      description: 'Warning type',
+      example: 'MISSING_EXCHANGE_RATE'
     },
     currency: {
       type: 'string',
-      description: 'Currency code'
-    },
-    payee: {
-      type: 'string',
-      description: 'Payee name'
+      description: 'Currency without exchange rate',
+      example: 'EUR'
     },
-    narration: {
+    totalAmount: {
       type: 'string',
-      description: 'Transaction narration'
+      description: 'Total amount affected',
+      example: '1000.00'
     }
   },
-  required: ['id', 'date', 'amount', 'currency', 'narration']
+  required: ['type', 'currency', 'totalAmount']
 } as const;
 
-export const $NlpSimilarityDto = {
+export const $NetWorthResponseDto = {
   type: 'object',
   properties: {
-    dateMatch: {
-      type: 'boolean',
-      description: 'Whether dates match'
-    },
-    dateDiff: {
-      type: 'number',
-      description: 'Date difference in days'
+    netWorth: {
+      type: 'string',
+      description:
+        'Total net worth (assets - liabilities, converted to base currency)',
+      example: '500000.00'
     },
-    amountMatch: {
-      type: 'boolean',
-      description: 'Whether amounts match'
+    assets: {
+      type: 'string',
+      description: 'Total assets value (converted)',
+      example: '600000.00'
     },
-    amountDiff: {
+    liabilities: {
       type: 'string',
-      description: 'Amount difference as decimal string'
+      description: 'Total liabilities value (positive number, converted)',
+      example: '100000.00'
     },
-    payeeMatch: {
-      type: 'boolean',
-      description: 'Whether payees match'
+    monthlyReturn: {
+      type: 'string',
+      description: 'Monthly return (change from last month)',
+      example: '15000.00'
     },
-    payeeSimilarity: {
-      type: 'number',
-      description: 'Payee similarity score (0-1)'
+    monthlyReturnPercentage: {
+      type: 'string',
+      description: 'Monthly return percentage',
+      example: '3.15'
     },
-    accountOverlap: {
-      type: 'number',
-      description: 'Account overlap score (0-1)'
-    }
-  },
-  required: [
-    'dateMatch',
-    'dateDiff',
-    'amountMatch',
-    'amountDiff',
-    'payeeMatch',
-    'payeeSimilarity',
-    'accountOverlap'
-  ]
-} as const;
-
-export const $NlpDuplicateConfirmationDataDto = {
-  type: 'object',
-  properties: {
-    confidence: {
-      type: 'number',
-      description: 'Duplicate detection confidence score (0.5-0.89)',
-      example: 0.85
+    currency: {
+      type: 'string',
+      description: 'Base currency code',
+      example: 'CNY'
     },
-    sourceTransaction: {
-      description:
-        'Source transaction summary (the new transaction being entered)',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpSourceTransactionDto'
-        }
-      ]
+    asOf: {
+      type: 'string',
+      description: 'Data as of date (ISO 8601)',
+      example: '2024-06-15T00:00:00.000Z'
     },
-    targetTransaction: {
-      description: 'Target transaction summary (existing potential duplicate)',
+    byCurrency: {
+      description: 'Balances grouped by original currency',
       allOf: [
         {
-          $ref: '#/components/schemas/NlpTargetTransactionDto'
+          $ref: '#/components/schemas/NetWorthByCurrencyDto'
         }
       ]
     },
-    similarity: {
-      description: 'Detailed similarity information',
+    converted: {
+      description:
+        'Converted values in base currency (undefined if no exchange rates available)',
       allOf: [
         {
-          $ref: '#/components/schemas/NlpSimilarityDto'
+          $ref: '#/components/schemas/ConvertedNetWorthDto'
         }
       ]
     },
-    reasons: {
-      description: 'Human-readable reasons for duplicate detection',
-      example: ['日期匹配', '金额匹配', '商户相似'],
+    warnings: {
+      description: 'Exchange rate warnings',
       type: 'array',
       items: {
-        type: 'string'
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
       }
     }
   },
   required: [
-    'confidence',
-    'sourceTransaction',
-    'targetTransaction',
-    'similarity',
-    'reasons'
+    'netWorth',
+    'assets',
+    'liabilities',
+    'monthlyReturn',
+    'monthlyReturnPercentage',
+    'currency',
+    'asOf'
   ]
 } as const;
 
-export const $NlpRuleConfirmationDataDto = {
+export const $AccountItemDto = {
   type: 'object',
   properties: {
-    confidence: {
-      type: 'number',
-      description: 'Rule match confidence score (0.5-0.74)',
-      example: 0.65
+    id: {
+      type: 'string',
+      description: 'Account ID'
     },
-    matchedRule: {
-      type: 'object',
-      description: 'Matched rule information'
+    name: {
+      type: 'string',
+      description: 'Full account name',
+      example: 'Assets:Bank:CMB:Savings'
     },
-    suggestedAccounts: {
-      type: 'object',
-      description: 'Suggested accounts from the rule'
+    displayName: {
+      type: 'string',
+      description: 'Display name (last part of account path)',
+      example: 'Savings'
     },
-    alternatives: {
-      type: 'array',
-      description: 'Alternative rules that also match'
+    balance: {
+      type: 'string',
+      description: 'Account balance',
+      example: '50000.00'
     },
-    reasons: {
-      description: 'Human-readable reasons for the match',
-      example: [
-        'Moderate confidence (65%)',
-        'Some keywords matched (OR logic)'
-      ],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
     }
   },
-  required: [
-    'confidence',
-    'matchedRule',
-    'suggestedAccounts',
-    'alternatives',
-    'reasons'
-  ]
+  required: ['id', 'name', 'displayName', 'balance', 'currency']
 } as const;
 
-export const $NlpAccountConfirmationDataDto = {
+export const $PlatformGroupDto = {
   type: 'object',
   properties: {
-    invalidAccount: {
+    platformId: {
       type: 'string',
-      description: 'The invalid account name',
-      example: 'Expenses:Food:Coffee'
+      description: 'Platform ID'
     },
-    suggestedAccount: {
+    platformName: {
       type: 'string',
-      description: 'Suggested replacement account',
-      example: 'Expenses:Food:Drinks'
+      description: 'Platform display name',
+      example: 'CMB Bank'
     },
-    similarAccounts: {
-      description: 'Similar accounts for user selection',
+    accounts: {
+      description: 'Accounts within this platform',
       type: 'array',
       items: {
-        type: 'string'
+        $ref: '#/components/schemas/AccountItemDto'
       }
     },
-    errorMessage: {
+    totalBalance: {
       type: 'string',
-      description: 'Error message explaining the issue',
-      example: 'No similar account found'
-    },
-    transactionContext: {
-      type: 'object',
-      description: 'Transaction context for reference'
+      description: 'Total balance across all accounts in platform',
+      example: '100000.00'
     }
   },
-  required: [
-    'invalidAccount',
-    'suggestedAccount',
-    'similarAccounts',
-    'errorMessage',
-    'transactionContext'
-  ]
+  required: ['platformId', 'platformName', 'accounts', 'totalBalance']
 } as const;
 
-export const $NlpSuggestedPayeeDto = {
+export const $AccountsSummaryDto = {
   type: 'object',
   properties: {
-    id: {
-      type: 'string',
-      description: 'Payee ID',
-      example: 'payee-123'
-    },
-    name: {
-      type: 'string',
-      description: 'Payee name',
-      example: 'Starbucks'
-    },
-    category: {
-      type: 'string',
-      description: 'Payee category',
-      example: 'food'
-    },
-    source: {
-      type: 'string',
-      description: 'Source of the payee',
-      enum: ['user', 'global']
+    totalAccounts: {
+      type: 'number',
+      description: 'Total number of accounts'
     },
-    payeeProfileId: {
-      type: 'string',
-      description: 'PayeeProfile ID (if matched from global)',
-      example: 'profile-456'
+    totalPlatforms: {
+      type: 'number',
+      description: 'Total number of platforms'
     }
   },
-  required: ['id', 'name']
+  required: ['totalAccounts', 'totalPlatforms']
 } as const;
 
-export const $NlpAlternativePayeeDto = {
+export const $AccountsResponseDto = {
   type: 'object',
   properties: {
-    id: {
-      type: 'string',
-      description: 'Payee ID',
-      example: 'payee-alt-1'
-    },
-    name: {
-      type: 'string',
-      description: 'Payee name',
-      example: 'Starbucks Coffee'
+    groups: {
+      description: 'Account groups by platform',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/PlatformGroupDto'
+      }
     },
-    similarity: {
-      type: 'number',
-      description: 'Similarity score (0-1)',
-      example: 0.75
+    summary: {
+      description: 'Summary statistics',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AccountsSummaryDto'
+        }
+      ]
     }
   },
-  required: ['id', 'name', 'similarity']
+  required: ['groups', 'summary']
 } as const;
 
-export const $NlpPayeeConfirmationDataDto = {
+export const $AccountItemWithAssetClassDto = {
   type: 'object',
   properties: {
-    confidence: {
-      type: 'number',
-      description: 'Confidence score for the payee match (0-1)',
-      example: 0.65
+    id: {
+      type: 'string',
+      description: 'Account ID'
     },
-    originalPayee: {
+    name: {
       type: 'string',
-      description: 'Original payee string from user input',
-      example: '星巴'
+      description: 'Full account name',
+      example: 'Assets:Bank:CMB:Savings'
     },
-    suggestedPayee: {
-      description: 'Suggested payee to use (null when no similar payees found)',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpSuggestedPayeeDto'
-        }
+    displayName: {
+      type: 'string',
+      description: 'Display name (last part of account path)',
+      example: 'Savings'
+    },
+    balance: {
+      type: 'string',
+      description: 'Account balance',
+      example: '50000.00'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
+    },
+    assetClass: {
+      type: 'string',
+      description: 'Asset class',
+      example: 'LIQUIDITY'
+    },
+    assetSubClass: {
+      type: 'string',
+      description: 'Asset sub-class (Prisma-compatible)',
+      example: 'RETIREMENT_ACCOUNT'
+    },
+    regionalSubClass: {
+      type: 'string',
+      description: 'Regional sub-class (region-specific, for display)',
+      example: 'FOUR_ZERO_ONE_K'
+    },
+    riskLevel: {
+      type: 'string',
+      description: 'Risk level',
+      example: 'LOW'
+    },
+    source: {
+      type: 'string',
+      description:
+        'ADR-0105 classification provenance (holding level always; account level only on FALLBACK)',
+      enum: ['USER_META', 'FIAT_CURRENCY', 'OPENBB_MAPPING', 'FALLBACK']
+    }
+  },
+  required: ['id', 'name', 'displayName', 'balance', 'currency', 'assetClass']
+} as const;
+
+export const $AssetClassGroupDto = {
+  type: 'object',
+  properties: {
+    assetClass: {
+      type: 'string',
+      description: 'Asset class name',
+      example: 'LIQUIDITY',
+      enum: [
+        'LIQUIDITY',
+        'EQUITY',
+        'FIXED_INCOME',
+        'PRECIOUS_METALS',
+        'COMMODITY',
+        'INSURANCE',
+        'ALTERNATIVE_INVESTMENT',
+        'PERSONAL_ASSETS',
+        'LIABILITY',
+        'REAL_ESTATE',
+        'INDEX'
       ]
     },
-    similarity: {
-      type: 'number',
-      description: 'Similarity score between original and suggested (0-1)',
-      example: 0.85
+    assetSubClass: {
+      type: 'string',
+      description: 'Asset sub-class name',
+      example: 'DEPOSIT'
     },
-    alternatives: {
-      description: 'Alternative payee options',
+    accounts: {
+      description: 'Accounts within this asset class',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/NlpAlternativePayeeDto'
+        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
       }
     },
-    reasons: {
-      description: 'Human-readable reasons for the match',
-      example: ['Moderate similarity (65%)', 'Fuzzy match on name'],
+    balanceByCurrency: {
+      description: 'Balances grouped by currency',
       type: 'array',
       items: {
-        type: 'string'
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
+    },
+    convertedBalance: {
+      type: 'string',
+      description: 'Converted balance in base currency',
+      example: '100000.00'
     }
   },
-  required: [
-    'confidence',
-    'originalPayee',
-    'similarity',
-    'alternatives',
-    'reasons'
-  ]
+  required: ['assetClass', 'accounts', 'balanceByCurrency']
 } as const;
 
-export const $RecurringMatchInfoDto = {
+export const $AccountExchangeRateWarningDto = {
   type: 'object',
   properties: {
-    expectedId: {
-      type: 'string',
-      description: 'Expected transaction ID'
-    },
-    ruleId: {
+    type: {
       type: 'string',
-      description: 'Recurring rule ID'
+      description: 'Warning type',
+      example: 'MISSING_EXCHANGE_RATE'
     },
-    ruleName: {
+    currency: {
       type: 'string',
-      description: 'Rule name for display'
+      description: 'Currency without exchange rate',
+      example: 'USD'
     },
-    ruleIcon: {
-      type: 'string',
-      description: 'Rule icon'
+    accounts: {
+      description: 'Affected account paths',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     },
-    expectedDate: {
+    totalAmount: {
       type: 'string',
-      description: 'Expected date (YYYY-MM-DD)',
-      example: '2026-01-05'
-    },
-    expectedAmount: {
-      type: 'number',
-      description: 'Expected amount',
-      example: 3000
-    },
-    confidence: {
-      type: 'number',
-      description: 'Match confidence score (0-1)',
-      example: 0.88
-    },
-    isAutoMatched: {
-      type: 'boolean',
-      description: 'Whether auto-matched (confidence >= 0.82)'
+      description: 'Total amount in this currency',
+      example: '5000.00'
     }
   },
-  required: [
-    'expectedId',
-    'ruleId',
-    'ruleName',
-    'expectedDate',
-    'expectedAmount',
-    'confidence',
-    'isAutoMatched'
-  ]
+  required: ['type', 'currency', 'accounts', 'totalAmount']
 } as const;
 
-export const $NlpSuggestedAccountDto = {
+export const $AssetClassSummaryDto = {
   type: 'object',
   properties: {
-    account: {
-      type: 'string',
-      description: 'Suggested account path',
-      example: 'Assets:Bank:Checking'
+    totalAccounts: {
+      type: 'number',
+      description: 'Total number of accounts'
     },
-    confidence: {
+    totalAssetClasses: {
       type: 'number',
-      description: 'Confidence score for this suggestion (0-1)',
-      example: 0.9
+      description: 'Total number of asset classes'
+    },
+    baseCurrency: {
+      type: 'string',
+      description: 'Base currency for conversion',
+      example: 'CNY'
+    },
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountExchangeRateWarningDto'
+      }
+    },
+    fallback: {
+      type: 'object',
+      description:
+        '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.'
     }
   },
-  required: ['account']
+  required: ['totalAccounts', 'totalAssetClasses', 'baseCurrency']
 } as const;
 
-export const $NlpSuggestedAccountsDto = {
+export const $AssetClassAccountsResponseDto = {
   type: 'object',
   properties: {
-    source: {
-      description:
-        'Source account suggestion (where money comes from). For expense: asset/liability account. For income: income account.',
+    groups: {
+      description: 'Account groups by asset class',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AssetClassGroupDto'
+      }
+    },
+    summary: {
+      description: 'Summary statistics',
       allOf: [
         {
-          $ref: '#/components/schemas/NlpSuggestedAccountDto'
+          $ref: '#/components/schemas/AssetClassSummaryDto'
         }
       ]
     },
-    destination: {
+    uncategorized: {
       description:
-        'Destination account suggestion (where money goes to). For expense: expense account. For income: asset/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.',
       allOf: [
         {
-          $ref: '#/components/schemas/NlpSuggestedAccountDto'
+          $ref: '#/components/schemas/AssetClassGroupDto'
         }
       ]
     }
-  }
-} as const;
-
-export const $NlpDefaultAccountsDto = {
-  type: 'object',
-  properties: {
-    asset: {
-      type: 'string',
-      description: 'Default asset account',
-      example: 'Assets:Bank:Checking'
-    },
-    expense: {
-      type: 'string',
-      description: 'Default expense account',
-      example: 'Expenses:Uncategorized'
-    },
-    income: {
-      type: 'string',
-      description: 'Default income account',
-      example: 'Income:Uncategorized'
-    },
-    liability: {
-      type: 'string',
-      description: 'Default liability account',
-      example: 'Liabilities:CreditCard'
-    }
   },
-  required: ['asset', 'expense', 'income', 'liability']
+  required: ['groups', 'summary']
 } as const;
 
-export const $NlpResponseDto = {
+export const $HoldingAssetClassAccountSliceDto = {
   type: 'object',
   properties: {
-    status: {
-      type: 'string',
-      description: 'Response status',
-      enum: ['success', 'pending', 'error']
-    },
-    action: {
-      type: 'string',
-      description: 'Action taken or requested',
-      enum: [
-        'created',
-        'ask',
-        'confirm',
-        'confirm_duplicate',
-        'confirm_rule',
-        'confirm_account',
-        'confirm_payee',
-        'cancel'
-      ]
-    },
-    intent: {
-      type: 'string',
-      description:
-        'Transaction intent detected by EntityRouter (v6.0: 5 core intents). Frontend uses this to render scenario-specific form fields.',
-      enum: ['expense', 'asset', 'income', 'liability', 'equity'],
-      example: 'expense'
-    },
-    assetSubType: {
+    accountId: {
       type: 'string',
-      description:
-        'Asset sub-type (only present when intent is "asset"). Determines which asset-related form to render.',
-      enum: ['transfer', 'banking', 'investment'],
-      example: 'investment'
+      description: 'Account ID'
     },
-    liabilitySubType: {
+    accountPath: {
       type: 'string',
-      description:
-        'Liability sub-type (only present when intent is "liability"). borrow: borrowing money (Liabilities → Assets), repay: repaying debt (Assets → Liabilities).',
-      enum: ['borrow', 'repay'],
-      example: 'borrow'
+      description: 'Full account path',
+      example: 'Assets:US:Investments:Brokerage'
     },
-    equitySubType: {
+    accountCurrency: {
       type: 'string',
       description:
-        'Equity sub-type (only present when intent is "equity"). opening: account opening balance (Equity → Assets), adjustment: balance correction.',
-      enum: ['opening', 'adjustment'],
-      example: 'opening'
+        'Currency of the holding with the largest converted base value; undefined when no holding is convertible',
+      example: 'USD'
     },
-    paymentSource: {
+    marketValueBase: {
       type: 'string',
       description:
-        'Payment source for expense transactions (v6.1). Indicates whether payment comes from asset or liability account. Only present when intent is "expense".',
-      enum: ['asset', 'liability'],
-      example: 'liability'
+        "Account's market value in base currency (Σ converted holdings; grey bucket included)",
+      example: '50000.00'
     },
-    liabilityHint: {
-      type: 'string',
+    shareOfTotalPct: {
+      type: 'number',
       description:
-        'Liability account type hint for credit card/BNPL spending (v6.1). Only present when paymentSource is "liability". Values: CreditCard, Huabei, Baitiao',
-      example: 'CreditCard'
+        'Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).',
+      example: 42.5
     },
-    message: {
-      type: 'string',
-      description:
-        'Human-readable message (for ask or error actions). Deprecated: Use messageKey for i18n support.',
-      example: 'How much did you spend?',
-      deprecated: true
+    groups: {
+      description: 'Per-account asset-class breakdown',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AssetClassGroupDto'
+      }
     },
-    messageKey: {
-      type: 'string',
+    uncategorized: {
       description:
-        'i18n message key for frontend translation. Use this instead of message for internationalization support.',
-      example: 'nlp.slot.prompt'
+        'Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AssetClassGroupDto'
+        }
+      ]
     },
-    messageParams: {
-      type: 'object',
+    holdings: {
       description:
-        'Parameters for message interpolation. Used with messageKey for dynamic values in translated messages.',
-      example: {
-        slot: 'amount',
-        name: 'Starbucks',
-        similarity: 85
+        'Every holding row for this account (account ID in each row’s `id` field)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
       }
-    },
-    sessionId: {
-      type: 'string',
-      description:
-        'Session ID for multi-turn dialogue. Must be included in subsequent requests to continue the conversation.',
-      example: 'session_abc123'
-    },
-    waitingFor: {
-      type: 'string',
-      description: 'Which slot is waiting for user input',
-      example: 'amount'
-    },
-    transaction: {
-      description: 'Created transaction info (for created action)',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpTransactionInfoDto'
-        }
-      ]
-    },
-    parsedData: {
-      description:
-        'Parsed data for confirmation (when action is "confirm"). Contains extracted fields that user should verify before transaction creation.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpParsedDataDto'
-        }
-      ]
-    },
-    duplicateData: {
-      description:
-        'Duplicate detection data (when action is "confirm_duplicate"). Contains information about potential duplicate transaction for user confirmation.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpDuplicateConfirmationDataDto'
-        }
-      ]
-    },
-    ruleData: {
-      description:
-        'Rule match data (when action is "confirm_rule"). Contains information about medium-confidence rule match for user confirmation.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpRuleConfirmationDataDto'
-        }
-      ]
-    },
-    accountData: {
-      description:
-        'Account validation data (when action is "confirm_account"). Contains information about invalid account for user correction.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpAccountConfirmationDataDto'
-        }
-      ]
-    },
-    payeeData: {
-      description:
-        'Payee confirmation data (when action is "confirm_payee"). Contains information about medium/low confidence payee match for user confirmation.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpPayeeConfirmationDataDto'
-        }
-      ]
-    },
-    confidence: {
-      type: 'number',
-      description: 'Overall confidence score (0-1)',
-      example: 0.85
-    },
-    confidenceThreshold: {
-      type: 'number',
-      description:
-        'Confidence threshold for automatic creation (default: 0.75). When confidence < threshold, action will be "confirm" requiring user verification.',
-      example: 0.75
-    },
-    recurringMatch: {
-      description:
-        'Recurring transaction match info (when action is "created"). Contains match details when transaction matches a pending expected transaction.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/RecurringMatchInfoDto'
-        }
-      ]
-    },
-    recurringSuggestion: {
-      description:
-        '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.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/RecurringSuggestionDto'
-        }
-      ]
-    },
-    suggestedAccounts: {
-      description:
-        'Suggested accounts for this transaction. Contains recommended source and destination accounts based on the detected intent and rules.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpSuggestedAccountsDto'
-        }
-      ]
-    },
-    defaultAccounts: {
-      description:
-        'Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpDefaultAccountsDto'
-        }
-      ]
     }
   },
-  required: ['status', 'action']
+  required: [
+    'accountId',
+    'accountPath',
+    'marketValueBase',
+    'shareOfTotalPct',
+    'groups',
+    'holdings'
+  ]
 } as const;
 
-export const $BalanceByCurrencyDto = {
+export const $HoldingAssetClassCrossAccountResponseDto = {
   type: 'object',
   properties: {
-    currency: {
-      type: 'string',
-      description: 'ISO 4217 currency code',
-      example: 'CNY'
+    global: {
+      description: 'Merged cross-account holding aggregation',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AssetClassAccountsResponseDto'
+        }
+      ]
     },
-    balance: {
-      type: 'string',
-      description: 'Balance amount',
-      example: '50000.00'
+    byAccount: {
+      description: 'Per-account slices',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/HoldingAssetClassAccountSliceDto'
+      }
     }
   },
-  required: ['currency', 'balance']
+  required: ['global', 'byAccount']
 } as const;
 
-export const $NetWorthByCurrencyDto = {
+export const $CashFlowByCurrencyDto = {
   type: 'object',
   properties: {
-    netWorth: {
-      description: 'Net worth by currency',
+    income: {
+      description: 'Income by currency',
       type: 'array',
       items: {
         $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    assets: {
-      description: 'Assets by currency',
+    expense: {
+      description: 'Expense by currency',
       type: 'array',
       items: {
         $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    liabilities: {
-      description: 'Liabilities by currency',
+    netSavings: {
+      description: 'Net savings by currency',
       type: 'array',
       items: {
         $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     }
   },
-  required: ['netWorth', 'assets', 'liabilities']
+  required: ['income', 'expense', 'netSavings']
 } as const;
 
-export const $ConvertedNetWorthDto = {
+export const $ConvertedCashFlowDto = {
   type: 'object',
   properties: {
     baseCurrency: {
@@ -5575,114 +5574,78 @@ export const $ConvertedNetWorthDto = {
       description: 'Base currency for conversion',
       example: 'CNY'
     },
-    netWorth: {
+    income: {
       type: 'string',
-      description: 'Converted net worth',
-      example: '500000.00'
+      description: 'Converted income',
+      example: '25000.00'
     },
-    assets: {
+    expense: {
       type: 'string',
-      description: 'Converted assets',
-      example: '600000.00'
+      description: 'Converted expense',
+      example: '18000.00'
     },
-    liabilities: {
+    netSavings: {
       type: 'string',
-      description: 'Converted liabilities',
-      example: '100000.00'
+      description: 'Converted net savings',
+      example: '7000.00'
     },
     exchangeRates: {
       type: 'object',
       description: 'Exchange rates used for conversion',
       example: {
-        USD: '7.200000',
-        EUR: '7.800000'
+        USD: '7.200000'
       }
     }
   },
-  required: [
-    'baseCurrency',
-    'netWorth',
-    'assets',
-    'liabilities',
-    'exchangeRates'
-  ]
-} as const;
-
-export const $ExchangeRateWarningDto = {
-  type: 'object',
-  properties: {
-    type: {
-      type: 'string',
-      description: 'Warning type',
-      example: 'MISSING_EXCHANGE_RATE'
-    },
-    currency: {
-      type: 'string',
-      description: 'Currency without exchange rate',
-      example: 'EUR'
-    },
-    totalAmount: {
-      type: 'string',
-      description: 'Total amount affected',
-      example: '1000.00'
-    }
-  },
-  required: ['type', 'currency', 'totalAmount']
+  required: ['baseCurrency', 'income', 'expense', 'netSavings', 'exchangeRates']
 } as const;
 
-export const $NetWorthResponseDto = {
+export const $CashFlowResponseDto = {
   type: 'object',
   properties: {
-    netWorth: {
+    period: {
       type: 'string',
-      description:
-        'Total net worth (assets - liabilities, converted to base currency)',
-      example: '500000.00'
+      description: 'Period identifier (YYYY-MM)',
+      example: '2024-06'
     },
-    assets: {
+    income: {
       type: 'string',
-      description: 'Total assets value (converted)',
-      example: '600000.00'
+      description: 'Total income for the period (converted)',
+      example: '25000.00'
     },
-    liabilities: {
+    expense: {
       type: 'string',
-      description: 'Total liabilities value (positive number, converted)',
-      example: '100000.00'
+      description: 'Total expenses for the period (converted)',
+      example: '18000.00'
     },
-    monthlyReturn: {
+    netSavings: {
       type: 'string',
-      description: 'Monthly return (change from last month)',
-      example: '15000.00'
+      description: 'Net savings (income - expense, converted)',
+      example: '7000.00'
     },
-    monthlyReturnPercentage: {
+    savingsRate: {
       type: 'string',
-      description: 'Monthly return percentage',
-      example: '3.15'
+      description: 'Savings rate percentage (netSavings / income * 100)',
+      example: '28.00'
     },
     currency: {
       type: 'string',
       description: 'Base currency code',
       example: 'CNY'
     },
-    asOf: {
-      type: 'string',
-      description: 'Data as of date (ISO 8601)',
-      example: '2024-06-15T00:00:00.000Z'
-    },
     byCurrency: {
-      description: 'Balances grouped by original currency',
+      description: 'Cash flow grouped by original currency',
       allOf: [
         {
-          $ref: '#/components/schemas/NetWorthByCurrencyDto'
+          $ref: '#/components/schemas/CashFlowByCurrencyDto'
         }
       ]
     },
     converted: {
-      description:
-        'Converted values in base currency (undefined if no exchange rates available)',
+      description: 'Converted values in base currency',
       allOf: [
         {
-          $ref: '#/components/schemas/ConvertedNetWorthDto'
+          $ref: '#/components/schemas/ConvertedCashFlowDto'
         }
       ]
     },
@@ -5695,417 +5658,459 @@ export const $NetWorthResponseDto = {
     }
   },
   required: [
-    'netWorth',
-    'assets',
-    'liabilities',
-    'monthlyReturn',
-    'monthlyReturnPercentage',
-    'currency',
-    'asOf'
+    'period',
+    'income',
+    'expense',
+    'netSavings',
+    'savingsRate',
+    'currency'
   ]
 } as const;
 
-export const $AccountItemDto = {
+export const $MonetaryDto = {
   type: 'object',
   properties: {
-    id: {
-      type: 'string',
-      description: 'Account ID'
-    },
-    name: {
-      type: 'string',
-      description: 'Full account name',
-      example: 'Assets:Bank:CMB:Savings'
-    },
-    displayName: {
-      type: 'string',
-      description: 'Display name (last part of account path)',
-      example: 'Savings'
-    },
-    balance: {
+    amount: {
       type: 'string',
-      description: 'Account balance',
-      example: '50000.00'
+      description: 'Amount (Decimal string)',
+      example: '3000'
     },
     currency: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
+      description: 'ISO 4217 currency',
+      example: 'USD'
+    },
+    baseCcyEquivalent: {
+      type: 'object',
+      description: 'Converted to user base currency (Decimal string)',
+      example: '21600',
+      nullable: true
     }
   },
-  required: ['id', 'name', 'displayName', 'balance', 'currency']
+  required: ['amount', 'currency']
 } as const;
 
-export const $PlatformGroupDto = {
+export const $CurrentPriceDto = {
   type: 'object',
   properties: {
-    platformId: {
+    amount: {
       type: 'string',
-      description: 'Platform ID'
+      description: 'Price amount (Decimal string)',
+      example: '250'
     },
-    platformName: {
+    currency: {
       type: 'string',
-      description: 'Platform display name',
-      example: 'CMB Bank'
+      description: 'Price currency (ISO 4217)',
+      example: 'USD'
     },
-    accounts: {
-      description: 'Accounts within this platform',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountItemDto'
-      }
+    date: {
+      type: 'string',
+      description: 'Price date (ISO 8601)',
+      example: '2024-06-01'
     },
-    totalBalance: {
+    source: {
       type: 'string',
-      description: 'Total balance across all accounts in platform',
-      example: '100000.00'
+      description: 'Price source',
+      example: 'USER_OVERRIDE',
+      enum: ['USER_OVERRIDE', 'OPENBB_EQUITY', 'OPENBB_CURRENCY']
     }
   },
-  required: ['platformId', 'platformName', 'accounts', 'totalBalance']
+  required: ['amount', 'currency', 'date', 'source']
 } as const;
 
-export const $AccountsSummaryDto = {
+export const $FxRateDto = {
   type: 'object',
   properties: {
-    totalAccounts: {
-      type: 'number',
-      description: 'Total number of accounts'
+    from: {
+      type: 'string',
+      example: 'USD'
     },
-    totalPlatforms: {
-      type: 'number',
-      description: 'Total number of platforms'
-    }
-  },
-  required: ['totalAccounts', 'totalPlatforms']
-} as const;
-
-export const $AccountsResponseDto = {
-  type: 'object',
-  properties: {
-    groups: {
-      description: 'Account groups by platform',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/PlatformGroupDto'
-      }
+    to: {
+      type: 'string',
+      example: 'CNY'
     },
-    summary: {
-      description: 'Summary statistics',
-      allOf: [
-        {
-          $ref: '#/components/schemas/AccountsSummaryDto'
-        }
-      ]
+    rate: {
+      type: 'string',
+      description: 'FX rate (Decimal string)',
+      example: '7.2'
+    },
+    date: {
+      type: 'string',
+      description: 'Rate date (ISO 8601)',
+      example: '2024-01-15'
     }
   },
-  required: ['groups', 'summary']
+  required: ['from', 'to', 'rate', 'date']
 } as const;
 
-export const $AccountItemWithAssetClassDto = {
+export const $HoldingPnlRowDto = {
   type: 'object',
   properties: {
-    id: {
+    accountId: {
       type: 'string',
-      description: 'Account ID'
+      description: 'Account UUID',
+      example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
     },
-    name: {
+    accountPath: {
       type: 'string',
-      description: 'Full account name',
-      example: 'Assets:Bank:CMB:Savings'
+      description: 'Full account path',
+      example: 'Assets:US:Broker:AAPL'
     },
-    displayName: {
-      type: 'string',
-      description: 'Display name (last part of account path)',
-      example: 'Savings'
+    accountCcy: {
+      type: 'object',
+      description: 'Account settlement currency (ISO 4217), from cost currency',
+      nullable: true,
+      example: 'USD'
     },
-    balance: {
+    brokerType: {
+      type: 'object',
+      description: 'Broker type derived from Platform.type',
+      nullable: true,
+      example: 'broker'
+    },
+    symbol: {
       type: 'string',
-      description: 'Account balance',
-      example: '50000.00'
+      description: 'Commodity symbol',
+      example: 'AAPL'
     },
-    currency: {
+    chartToken: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
+      description: 'Chart segment token (libs/common resolver)',
+      example: 'equity',
+      enum: ['equity', 'fund', 'bond', 'cash', 'other']
     },
     assetClass: {
       type: 'string',
-      description: 'Asset class',
-      example: 'LIQUIDITY'
+      example: 'EQUITY'
     },
     assetSubClass: {
-      type: 'string',
-      description: 'Asset sub-class (Prisma-compatible)',
-      example: 'RETIREMENT_ACCOUNT'
+      type: 'object',
+      nullable: true,
+      example: 'STOCK'
     },
-    regionalSubClass: {
+    units: {
       type: 'string',
-      description: 'Regional sub-class (region-specific, for display)',
-      example: 'FOUR_ZERO_ONE_K'
+      description: 'Net held units (Decimal string)',
+      example: '12'
     },
-    riskLevel: {
-      type: 'string',
-      description: 'Risk level',
-      example: 'LOW'
-    }
-  },
-  required: ['id', 'name', 'displayName', 'balance', 'currency', 'assetClass']
-} as const;
-
-export const $AssetClassGroupDto = {
-  type: 'object',
-  properties: {
-    assetClass: {
-      type: 'string',
-      description: 'Asset class name',
-      example: 'LIQUIDITY',
-      enum: [
-        'LIQUIDITY',
-        'EQUITY',
-        'FIXED_INCOME',
-        'PRECIOUS_METALS',
-        'COMMODITY',
-        'INSURANCE',
-        'ALTERNATIVE_INVESTMENT',
-        'PERSONAL_ASSETS',
-        'LIABILITY',
-        'REAL_ESTATE',
-        'INDEX'
+    averageCostPerUnit: {
+      description:
+        'Average cost per unit; null when cost currency conflicts or no cost',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
       ]
     },
-    assetSubClass: {
-      type: 'string',
-      description: 'Asset sub-class name',
-      example: 'DEPOSIT'
+    costBasis: {
+      description: 'Cost basis of held units',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     },
-    accounts: {
-      description: 'Accounts within this asset class',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
-      }
+    marketValue: {
+      description: 'Market value at asOf price',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     },
-    balanceByCurrency: {
-      description: 'Balances grouped by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
+    currentPrice: {
+      description: 'Price used for market value',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/CurrentPriceDto'
+        }
+      ]
     },
-    convertedBalance: {
-      type: 'string',
-      description: 'Converted balance in base currency',
-      example: '100000.00'
+    unrealizedPnlBase: {
+      type: 'object',
+      description:
+        'Unrealized P&L in base currency (Decimal string); null when any FX/price missing',
+      nullable: true,
+      example: '6000'
+    },
+    unrealizedPnlPct: {
+      type: 'object',
+      description: 'Unrealized P&L % (Decimal string)',
+      nullable: true,
+      example: '25'
+    },
+    costFxRate: {
+      description: 'Historical FX rate applied to cost basis',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
+    },
+    marketFxRate: {
+      description: 'FX rate applied to market value',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
+    },
+    pctOfInvestedAssets: {
+      type: 'object',
+      description:
+        'Share of invested assets % (Decimal string); only for invested chartTokens',
+      nullable: true,
+      example: '40'
+    },
+    realizedPnl: {
+      description:
+        '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',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     }
   },
-  required: ['assetClass', 'accounts', 'balanceByCurrency']
+  required: [
+    'accountId',
+    'accountPath',
+    'symbol',
+    'chartToken',
+    'assetClass',
+    'units'
+  ]
 } as const;
 
-export const $AccountExchangeRateWarningDto = {
+export const $HoldingPnlWarningDto = {
   type: 'object',
   properties: {
     type: {
       type: 'string',
       description: 'Warning type',
-      example: 'MISSING_EXCHANGE_RATE'
+      example: 'MISSING_COST_FX_RATE',
+      enum: [
+        'MISSING_COST_FX_RATE',
+        'MISSING_MARKET_FX_RATE',
+        'MISSING_SALE_PRICE',
+        'MISSING_REALIZED_FX_RATE',
+        'OVERSOLD_LOTS',
+        'NO_PRICE',
+        'MIXED_COST_CURRENCY'
+      ]
     },
-    currency: {
-      type: 'string',
-      description: 'Currency without exchange rate',
-      example: 'USD'
+    symbol: {
+      type: 'object',
+      nullable: true
     },
-    accounts: {
-      description: 'Affected account paths',
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+    accountId: {
+      type: 'object',
+      nullable: true
     },
-    totalAmount: {
-      type: 'string',
-      description: 'Total amount in this currency',
-      example: '5000.00'
+    currency: {
+      type: 'object',
+      nullable: true
     }
   },
-  required: ['type', 'currency', 'accounts', 'totalAmount']
+  required: ['type']
 } as const;
 
-export const $AssetClassSummaryDto = {
+export const $HoldingPnlResponseDto = {
   type: 'object',
   properties: {
-    totalAccounts: {
-      type: 'number',
-      description: 'Total number of accounts'
-    },
-    totalAssetClasses: {
-      type: 'number',
-      description: 'Total number of asset classes'
+    asOfDate: {
+      type: 'string',
+      example: '2026-07-08'
     },
     baseCurrency: {
       type: 'string',
-      description: 'Base currency for conversion',
       example: 'CNY'
     },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountExchangeRateWarningDto'
-      }
-    }
-  },
-  required: ['totalAccounts', 'totalAssetClasses', 'baseCurrency']
-} as const;
-
-export const $AssetClassAccountsResponseDto = {
-  type: 'object',
-  properties: {
-    groups: {
-      description: 'Account groups by asset class',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AssetClassGroupDto'
-      }
-    },
-    summary: {
-      description: 'Summary statistics',
-      allOf: [
-        {
-          $ref: '#/components/schemas/AssetClassSummaryDto'
-        }
-      ]
-    }
-  },
-  required: ['groups', 'summary']
-} as const;
-
-export const $CashFlowByCurrencyDto = {
-  type: 'object',
-  properties: {
-    income: {
-      description: 'Income by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
+    method: {
+      type: 'string',
+      description:
+        'Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).',
+      enum: ['average', 'FIFO'],
+      example: 'average'
     },
-    expense: {
-      description: 'Expense by currency',
+    rows: {
       type: 'array',
       items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
+        $ref: '#/components/schemas/HoldingPnlRowDto'
       }
     },
-    netSavings: {
-      description: 'Net savings by currency',
+    warnings: {
       type: 'array',
       items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
+        $ref: '#/components/schemas/HoldingPnlWarningDto'
       }
     }
   },
-  required: ['income', 'expense', 'netSavings']
+  required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
 } as const;
 
-export const $ConvertedCashFlowDto = {
+export const $CreateBeanPriceDto = {
   type: 'object',
   properties: {
-    baseCurrency: {
+    currency: {
       type: 'string',
-      description: 'Base currency for conversion',
-      example: 'CNY'
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'USD'
     },
-    income: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Converted income',
-      example: '25000.00'
+      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
+      example: 'CNY'
     },
-    expense: {
-      type: 'string',
-      description: 'Converted expense',
-      example: '18000.00'
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
+      example: 175.5,
+      minimum: 0
     },
-    netSavings: {
+    date: {
       type: 'string',
-      description: 'Converted net savings',
-      example: '7000.00'
+      description: 'Price date (ISO 8601 format)',
+      example: '2024-11-05'
     },
-    exchangeRates: {
+    metadata: {
       type: 'object',
-      description: 'Exchange rates used for conversion',
+      description:
+        'Metadata (validated by Zod schema, max field lengths enforced)',
       example: {
-        USD: '7.200000'
+        source: 'MANUAL',
+        note: 'Bank valuation report',
+        confidence: 0.95
       }
     }
   },
-  required: ['baseCurrency', 'income', 'expense', 'netSavings', 'exchangeRates']
+  required: ['currency', 'quoteCurrency', 'amount', 'date']
 } as const;
 
-export const $CashFlowResponseDto = {
+export const $PriceResponseDto = {
   type: 'object',
   properties: {
-    period: {
+    id: {
       type: 'string',
-      description: 'Period identifier (YYYY-MM)',
-      example: '2024-06'
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
     },
-    income: {
+    userId: {
       type: 'string',
-      description: 'Total income for the period (converted)',
-      example: '25000.00'
+      description: 'User ID (owner of the price)',
+      example: 'user-123'
     },
-    expense: {
+    currency: {
       type: 'string',
-      description: 'Total expenses for the period (converted)',
-      example: '18000.00'
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'BTC'
     },
-    netSavings: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Net savings (income - expense, converted)',
-      example: '7000.00'
+      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
+      example: 'USD'
     },
-    savingsRate: {
-      type: 'string',
-      description: 'Savings rate percentage (netSavings / income * 100)',
-      example: '28.00'
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
+      example: 50000
     },
-    currency: {
+    date: {
       type: 'string',
-      description: 'Base currency code',
-      example: 'CNY'
+      description:
+        'Price date (ISO 8601 format). Represents the date this price was valid.',
+      example: '2024-01-01',
+      format: 'date'
     },
-    byCurrency: {
-      description: 'Cash flow grouped by original currency',
-      allOf: [
-        {
-          $ref: '#/components/schemas/CashFlowByCurrencyDto'
-        }
-      ]
+    meta: {
+      type: 'object',
+      description:
+        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
+      example: {
+        source: 'MANUAL',
+        note: 'User-defined price',
+        confidence: 1
+      }
     },
-    converted: {
-      description: 'Converted values in base currency',
-      allOf: [
-        {
-          $ref: '#/components/schemas/ConvertedCashFlowDto'
-        }
-      ]
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Creation timestamp',
+      example: '2024-11-03T10:00:00Z'
     },
-    warnings: {
-      description: 'Exchange rate warnings',
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Last update timestamp',
+      example: '2024-11-03T10:00:00Z'
+    }
+  },
+  required: [
+    'id',
+    'userId',
+    'currency',
+    'quoteCurrency',
+    'amount',
+    'date',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
+} as const;
+
+export const $PriceListResponseDto = {
+  type: 'object',
+  properties: {
+    items: {
+      description: 'List of prices',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
+        $ref: '#/components/schemas/PriceResponseDto'
       }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of prices',
+      example: 42
     }
   },
-  required: [
-    'period',
-    'income',
-    'expense',
-    'netSavings',
-    'savingsRate',
-    'currency'
-  ]
+  required: ['items', 'total']
+} as const;
+
+export const $UpdateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency)'
+    },
+    amount: {
+      type: 'number',
+      description: 'Price amount (MUST be >= 0 per Beancount spec)',
+      minimum: 0
+    },
+    date: {
+      type: 'string',
+      description: 'Price date (ISO 8601 format)'
+    },
+    metadata: {
+      type: 'object',
+      description: 'Metadata'
+    }
+  }
 } as const;
 
 export const $CurrencyBalanceDto = {