@firela/api-types 0.0.0-canary.2fbeefe9 → 0.0.0-canary.3d558482

package/src/generated/schemas.gen.ts

@@ -11,7 +11,7 @@ export const $CreateAccountDto = {
     openDate: {
       format: 'date-time',
       type: 'string',
-      description: 'Account open date',
+      description: 'Account open date (server defaults to today)',
       example: '2024-01-01'
     },
     currencies: {
@@ -51,9 +51,10 @@ export const $CreateAccountDto = {
       description: 'Icon identifier (overrides template)',
       example: 'bank-custom'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Additional metadata',
+      description:
+        'Open directive metadata (NOT an opening-balance amount — use the opening-balance endpoint)',
       example: {
         branch: 'Downtown',
         accountNumber: '1234'
@@ -65,7 +66,7 @@ export const $CreateAccountDto = {
       example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
     }
   },
-  required: ['path', 'openDate']
+  required: ['path']
 } as const;
 
 export const $AccountResponseDto = {
@@ -145,9 +146,9 @@ export const $AccountResponseDto = {
       description: 'Icon identifier',
       example: 'bank-icbc'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Account metadata',
+      description: 'Open directive metadata (ADR-0115 Decision 9)',
       example: {
         branch: 'Downtown'
       }
@@ -233,9 +234,10 @@ export const $UpdateAccountDto = {
       description: 'Icon identifier',
       example: 'bank-custom'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Additional metadata (merged with existing)',
+      description:
+        'Open directive metadata (merged with existing; NOT an opening-balance amount)',
       example: {
         branch: 'Uptown'
       }
@@ -282,6 +284,40 @@ export const $ReopenAccountDto = {
   }
 } as const;
 
+export const $CreateOpeningBalanceDto = {
+  type: 'object',
+  properties: {
+    amount: {
+      type: 'number',
+      description: 'Opening balance amount (non-negative)',
+      example: 1000
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
+    },
+    date: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Opening-balance date (defaults to now)',
+      example: '2024-01-01'
+    }
+  },
+  required: ['amount', 'currency']
+} as const;
+
+export const $OpeningBalanceResultDto = {
+  type: 'object',
+  properties: {
+    transactionId: {
+      type: 'string',
+      description: 'Created opening-balance transaction id.'
+    }
+  },
+  required: ['transactionId']
+} as const;
+
 export const $AccountStandardResponseDto = {
   type: 'object',
   properties: {
@@ -4388,6 +4424,27 @@ export const $SignupDto = {
   }
 } as const;
 
+export const $SignupResponseDto = {
+  type: 'object',
+  properties: {
+    authToken: {
+      type: 'string',
+      description: 'JWT auth token',
+      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+    },
+    accessToken: {
+      type: 'string',
+      description: 'Auto-generated access token'
+    },
+    role: {
+      type: 'string',
+      description: 'Assigned user role',
+      enum: ['USER', 'ADMIN', 'DEMO', 'INACTIVE', 'PAID', 'OPS']
+    }
+  },
+  required: ['authToken', 'accessToken', 'role']
+} as const;
+
 export const $UpdateUserSettingDto = {
   type: 'object',
   properties: {
@@ -4511,589 +4568,868 @@ export const $UpdatePropertyDto = {
   required: ['value']
 } as const;
 
-export const $CreateBeanEventDto = {
+export const $CurrencyBalanceDto = {
   type: 'object',
   properties: {
-    date: {
-      type: 'string',
-      description: 'Life event date (ISO 8601)',
-      example: '2024-03-15'
-    },
-    type: {
+    currency: {
       type: 'string',
-      description:
-        'Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer',
-      example: 'employer'
+      description: 'ISO 4217 currency code',
+      example: 'CNY'
     },
-    description: {
+    balance: {
       type: 'string',
-      description:
-        'Life event description. Empty string is a VALID value (distinct from absence).',
-      example: 'Acme Corp'
-    },
-    meta: {
-      type: 'object',
-      description:
-        'Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)',
-      example: {
-        note: 'Promotion'
-      }
+      description: 'Balance amount',
+      example: '500000.00'
     }
   },
-  required: ['date', 'type', 'description']
+  required: ['currency', 'balance']
 } as const;
 
-export const $EventResponseDto = {
+export const $TimeSeriesPointDto = {
   type: 'object',
   properties: {
-    id: {
+    date: {
       type: 'string',
-      description: 'Unique identifier',
-      example: 'uuid-123-456'
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
     },
-    userId: {
+    value: {
       type: 'string',
-      description: 'User ID (owner of the life event)',
-      example: 'user-123'
+      description: 'Value at this date (in base currency)',
+      example: '500000.00'
     },
-    date: {
-      type: 'string',
-      description: 'Life event date (ISO 8601 format)',
-      example: '2024-03-15',
-      format: 'date'
+    change: {
+      type: 'object',
+      description: 'Change from previous point',
+      example: '5000.00'
     },
-    type: {
+    assets: {
       type: 'string',
-      description:
-        'Life event type (user-defined, e.g., "employer", "location")',
-      example: 'employer'
+      description: 'Total assets at this date (in base currency)',
+      example: '494338.00'
     },
-    description: {
+    liabilities: {
       type: 'string',
-      description:
-        'Life event description. May be an empty string (a valid value distinct from absence).',
-      example: 'Acme Corp'
+      description: 'Total liabilities at this date (in base currency)',
+      example: '310098.00'
     },
-    meta: {
-      type: 'object',
-      description: 'Product-side metadata (free-form JSON)',
-      example: {
-        note: 'Promotion'
+    byCurrency: {
+      description: 'Multi-currency breakdown for this point',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CurrencyBalanceDto'
       }
+    }
+  },
+  required: ['date', 'value']
+} as const;
+
+export const $TrendSummaryDto = {
+  type: 'object',
+  properties: {
+    startValue: {
+      type: 'string',
+      description: 'Value at start of period',
+      example: '450000.00'
     },
-    createdAt: {
-      format: 'date-time',
+    endValue: {
       type: 'string',
-      description: 'Creation timestamp',
-      example: '2024-03-15T10:00:00Z'
+      description: 'Value at end of period',
+      example: '500000.00'
     },
-    updatedAt: {
-      format: 'date-time',
+    totalChange: {
       type: 'string',
-      description:
-        'Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.',
-      example: '2024-03-15T10:00:00Z'
+      description: 'Total change over period',
+      example: '50000.00'
+    },
+    totalChangePercentage: {
+      type: 'string',
+      description: 'Total change percentage',
+      example: '+11.11%'
     }
   },
-  required: [
-    'id',
-    'userId',
-    'date',
-    'type',
-    'description',
-    'meta',
-    'createdAt',
-    'updatedAt'
-  ]
+  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
 } as const;
 
-export const $EventListResponseDto = {
+export const $MultiCurrencyPointDto = {
   type: 'object',
   properties: {
-    items: {
-      description: 'List of life events',
+    date: {
+      type: 'string',
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
+    },
+    byCurrency: {
+      description: 'Balances by currency',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/EventResponseDto'
+        $ref: '#/components/schemas/CurrencyBalanceDto'
       }
-    },
-    total: {
-      type: 'number',
-      description: 'Total number of life events matching the query',
-      example: 42
     }
   },
-  required: ['items', 'total']
+  required: ['date', 'byCurrency']
 } as const;
 
-export const $UpdateBeanEventDto = {
+export const $PortfolioTrendsResponseDto = {
   type: 'object',
   properties: {
-    date: {
+    series: {
+      description: 'Time series data points',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/TimeSeriesPointDto'
+      }
+    },
+    summary: {
+      description: 'Period summary',
+      allOf: [
+        {
+          $ref: '#/components/schemas/TrendSummaryDto'
+        }
+      ]
+    },
+    period: {
       type: 'string',
-      description: 'Life event date (ISO 8601)'
+      description: 'Period requested',
+      example: '6m'
     },
-    type: {
+    granularity: {
       type: 'string',
-      description: 'Life event type (user-defined)'
+      description: 'Data granularity',
+      example: 'month'
     },
-    description: {
+    currency: {
       type: 'string',
+      description: 'Base currency for converted values',
+      example: 'CNY'
+    },
+    byCurrency: {
       description:
-        'Life event description. Empty string is a VALID value (distinct from absence).'
+        'Multi-currency time series (each point has currency breakdown)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/MultiCurrencyPointDto'
+      }
     },
-    meta: {
-      type: 'object',
-      description: 'Product-side metadata (free-form JSON)'
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
     }
-  }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
 } as const;
 
-export const $OnboardingAccountDto = {
+export const $CashFlowPointDto = {
   type: 'object',
   properties: {
-    path: {
+    month: {
       type: 'string',
-      description:
-        'Account path (Assets/Liabilities only; format validated by the account service)',
-      example: 'Assets:Checking'
+      description: 'Month key (YYYY-MM)',
+      example: '2024-03'
     },
-    currency: {
+    income: {
       type: 'string',
-      description: 'ISO 4217 currency code (3 letters)',
-      example: 'USD'
+      description: 'Income in base currency (absolute, converted)',
+      example: '10000.00'
     },
-    openingBalance: {
+    expense: {
       type: 'string',
-      description:
-        'Opening balance as a non-negative Decimal string (e.g. "1000.00")',
-      example: '1000.00'
+      description: 'Expense in base currency (absolute, converted)',
+      example: '5000.00'
     },
-    platformId: {
+    netSavings: {
       type: 'string',
-      description:
-        'Platform ID to bind the account to (references Platform.id); omit for unbound',
-      example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
+      description: 'netSavings = income − expense (savings positive)',
+      example: '5000.00'
     }
   },
-  required: ['path', 'currency']
+  required: ['month', 'income', 'expense', 'netSavings']
 } as const;
 
-export const $OnboardingDto = {
+export const $CashFlowTrendSummaryDto = {
   type: 'object',
   properties: {
-    accounts: {
-      description: 'Asset/Liability accounts to register with opening balances',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/OnboardingAccountDto'
-      }
+    totalIncome: {
+      type: 'string',
+      description: 'Total income across the period',
+      example: '60000.00'
     },
-    skipAssetRegistration: {
-      type: 'boolean',
-      description:
-        'Skip asset registration; only bootstrap the core account set',
-      default: false
-    }
-  }
-} as const;
-
-export const $ActualBalanceDto = {
-  type: 'object',
-  properties: {
-    amount: {
+    totalExpense: {
       type: 'string',
-      description:
-        'Actual balance amount as a decimal string (preserves precision for tolerance inference).',
-      example: '1234.56'
+      description: 'Total expense across the period',
+      example: '30000.00'
     },
-    ccy: {
+    totalNetSavings: {
       type: 'string',
-      description: 'Currency code (ISO 4217 or commodity ticker).',
-      example: 'CNY'
+      description: 'income − expense across the period',
+      example: '30000.00'
+    },
+    averageMonthlyNetSavings: {
+      type: 'string',
+      description:
+        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
+      example: '5000.00'
     }
   },
-  required: ['amount', 'ccy']
+  required: [
+    'totalIncome',
+    'totalExpense',
+    'totalNetSavings',
+    'averageMonthlyNetSavings'
+  ]
 } as const;
 
-export const $ComputeReconciliationDto = {
+export const $CashFlowTrendsResponseDto = {
   type: 'object',
   properties: {
-    accountId: {
-      type: 'string',
-      description: 'BeanAccount id to reconcile.'
-    },
-    asOfDate: {
-      type: 'string',
-      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
-      example: '2026-07-24'
+    series: {
+      description:
+        'Monthly cash-flow series (fixed N-month window, zero-filled)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CashFlowPointDto'
+      }
     },
-    actualBalance: {
-      description: 'Actual balance from the external statement.',
+    summary: {
+      description: 'Period totals',
       allOf: [
         {
-          $ref: '#/components/schemas/ActualBalanceDto'
+          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
         }
       ]
-    }
-  },
-  required: ['accountId', 'asOfDate', 'actualBalance']
-} as const;
-
-export const $ReconciliationComputeResultDto = {
-  type: 'object',
-  properties: {
-    accountId: {
-      type: 'string'
-    },
-    asOfDate: {
-      type: 'string'
     },
-    bookBalance: {
+    period: {
       type: 'string',
-      description: 'System-computed book balance (decimal string).'
+      description: 'Period requested',
+      example: '6m'
     },
-    actualBalance: {
+    granularity: {
       type: 'string',
-      description: 'User-entered actual balance (decimal string).'
+      description: 'Data granularity (v1 returns month buckets)',
+      example: 'month'
     },
     currency: {
-      type: 'string'
-    },
-    diff: {
-      type: 'string',
-      description: 'Diff = book − actual (decimal string).'
-    },
-    tolerance: {
       type: 'string',
-      description: 'Applied tolerance (decimal string).'
-    },
-    withinTolerance: {
-      type: 'boolean',
-      description: 'true when |diff| ≤ tolerance.'
+      description: 'Base currency for converted values',
+      example: 'CNY'
     },
-    suggestedAction: {
-      type: 'string',
-      enum: ['assert', 'pad'],
-      description:
-        'Suggested next action: assert when within tolerance, pad otherwise.'
+    warnings: {
+      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
     }
   },
-  required: [
-    'accountId',
-    'asOfDate',
-    'bookBalance',
-    'actualBalance',
-    'currency',
-    'diff',
-    'tolerance',
-    'withinTolerance',
-    'suggestedAction'
-  ]
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
 } as const;
 
-export const $AssertReconciliationDto = {
+export const $GenerateSnapshotBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $GenerateSnapshotResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $CreateBeanEventDto = {
   type: 'object',
   properties: {
-    accountId: {
+    date: {
       type: 'string',
-      description: 'BeanAccount id to reconcile.'
+      description: 'Life event date (ISO 8601)',
+      example: '2024-03-15'
     },
-    asOfDate: {
+    type: {
       type: 'string',
-      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
-      example: '2026-07-24'
-    },
-    actualBalance: {
-      description: 'Actual balance from the external statement.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/ActualBalanceDto'
-        }
-      ]
+      description:
+        'Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer',
+      example: 'employer'
     },
-    tolerance: {
+    description: {
       type: 'string',
       description:
-        'Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).',
-      example: '0.01'
+        'Life event description. Empty string is a VALID value (distinct from absence).',
+      example: 'Acme Corp'
+    },
+    meta: {
+      type: 'object',
+      description:
+        'Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)',
+      example: {
+        note: 'Promotion'
+      }
     }
   },
-  required: ['accountId', 'asOfDate', 'actualBalance']
+  required: ['date', 'type', 'description']
 } as const;
 
-export const $ReconciliationRecordDto = {
+export const $EventResponseDto = {
   type: 'object',
   properties: {
     id: {
-      type: 'string'
+      type: 'string',
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
     },
-    accountId: {
-      type: 'string'
+    userId: {
+      type: 'string',
+      description: 'User ID (owner of the life event)',
+      example: 'user-123'
     },
     date: {
-      type: 'string'
-    },
-    amount: {
       type: 'string',
-      description: 'Asserted (actual) amount.'
-    },
-    currency: {
-      type: 'string'
+      description: 'Life event date (ISO 8601 format)',
+      example: '2024-03-15',
+      format: 'date'
     },
-    tolerance: {
-      type: 'string'
+    type: {
+      type: 'string',
+      description:
+        'Life event type (user-defined, e.g., "employer", "location")',
+      example: 'employer'
     },
-    diffAmount: {
+    description: {
       type: 'string',
-      description: 'book − actual.'
+      description:
+        'Life event description. May be an empty string (a valid value distinct from absence).',
+      example: 'Acme Corp'
     },
-    diffCurrency: {
-      type: 'string'
+    meta: {
+      type: 'object',
+      description: 'Product-side metadata (free-form JSON)',
+      example: {
+        note: 'Promotion'
+      }
     },
     createdAt: {
-      type: 'string'
-    }
-  },
-  required: ['id', 'accountId', 'date', 'amount', 'currency', 'createdAt']
-} as const;
-
-export const $PadReconciliationDto = {
-  type: 'object',
-  properties: {
-    accountId: {
+      format: 'date-time',
       type: 'string',
-      description: 'BeanAccount id to reconcile.'
-    },
-    asOfDate: {
-      type: 'string',
-      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
-      example: '2026-07-24'
-    },
-    actualBalance: {
-      description: 'Actual balance from the external statement.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/ActualBalanceDto'
-        }
-      ]
+      description: 'Creation timestamp',
+      example: '2024-03-15T10:00:00Z'
     },
-    sourceAccount: {
+    updatedAt: {
+      format: 'date-time',
       type: 'string',
       description:
-        'Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).',
-      example: 'Equity:Opening-Balances',
-      default: 'Equity:Opening-Balances'
+        'Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.',
+      example: '2024-03-15T10:00:00Z'
     }
   },
-  required: ['accountId', 'asOfDate', 'actualBalance']
+  required: [
+    'id',
+    'userId',
+    'date',
+    'type',
+    'description',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
 } as const;
 
-export const $PadResultDto = {
+export const $EventListResponseDto = {
   type: 'object',
   properties: {
-    transactionId: {
-      type: 'string',
-      description: 'Created pad adjusting transaction id.'
+    items: {
+      description: 'List of life events',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/EventResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of life events matching the query',
+      example: 42
     }
   },
-  required: ['transactionId']
+  required: ['items', 'total']
 } as const;
 
-export const $FileImportDto = {
+export const $UpdateBeanEventDto = {
   type: 'object',
   properties: {
-    file: {
+    date: {
       type: 'string',
-      format: 'binary',
-      description: 'Bill file to import (CSV, PDF, OFX, etc.)',
-      example: 'alipay.csv'
-    }
-  },
-  required: ['file']
-} as const;
-
-export const $ImportErrorDto = {
-  type: 'object',
-  properties: {
-    index: {
-      type: 'number',
-      description: 'Index of failed transaction in the file',
-      example: 5
+      description: 'Life event date (ISO 8601)'
     },
-    error: {
+    type: {
       type: 'string',
-      description: 'Error message',
-      example: 'Transaction does not balance: -100 USD != 0'
+      description: 'Life event type (user-defined)'
+    },
+    description: {
+      type: 'string',
+      description:
+        'Life event description. Empty string is a VALID value (distinct from absence).'
+    },
+    meta: {
+      type: 'object',
+      description: 'Product-side metadata (free-form JSON)'
     }
-  },
-  required: ['index', 'error']
+  }
 } as const;
 
-export const $ReviewItemPreviewDto = {
+export const $OnboardingAccountDto = {
   type: 'object',
   properties: {
-    index: {
-      type: 'number',
-      description: 'Index in the import batch (for tracking)',
-      example: 0
-    },
-    date: {
+    path: {
       type: 'string',
-      description: 'Transaction date (ISO format)',
-      example: '2026-03-05'
-    },
-    amount: {
-      type: 'number',
-      description: 'Transaction amount (absolute value)',
-      example: 99
+      description:
+        'Account path (Assets/Liabilities only; format validated by the account service)',
+      example: 'Assets:Checking'
     },
     currency: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
-    },
-    narration: {
-      type: 'string',
-      description: 'Transaction narration/description',
-      example: 'Restaurant expense'
-    },
-    payee: {
-      type: 'string',
-      description: 'Payee name',
-      example: 'Restaurant ABC'
+      description: 'ISO 4217 currency code (3 letters)',
+      example: 'USD'
     },
-    category: {
+    openingBalance: {
       type: 'string',
-      description: 'Inferred category from rule matching',
-      example: 'food'
-    },
-    confidence: {
-      type: 'number',
-      description: 'Confidence score for the match (0-1)',
-      example: 0.85
+      description:
+        'Opening balance as a non-negative Decimal string (e.g. "1000.00")',
+      example: '1000.00'
     },
-    branchType: {
+    platformId: {
       type: 'string',
-      description: 'Type of branch requiring review',
-      enum: [
-        'DUPLICATE',
-        'PAYEE_MATCH',
-        'RULE_MATCH',
-        'ACCOUNT_VALIDATION',
-        'PIPELINE_ERROR'
-      ],
-      example: 'RULE_MATCH'
-    },
-    reasons: {
-      description: 'Human-readable reasons for requiring review',
-      example: ['Moderate confidence rule match', 'Multiple rules matched'],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+      description:
+        'Platform ID to bind the account to (references Platform.id); omit for unbound',
+      example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
     }
   },
-  required: ['index', 'date', 'narration']
+  required: ['path', 'currency']
 } as const;
 
-export const $ImportResultDto = {
+export const $OnboardingDto = {
   type: 'object',
   properties: {
-    imported: {
-      type: 'number',
-      description: 'Number of successfully imported transactions',
-      example: 45
-    },
-    failed: {
-      type: 'number',
-      description: 'Number of failed transactions',
-      example: 2
-    },
-    skipped: {
-      type: 'number',
-      description:
-        'Number of skipped transactions (high confidence duplicates, auto-skipped)',
-      example: 3
-    },
-    pendingReview: {
-      type: 'number',
-      description:
-        'Number of transactions pending review (medium confidence duplicates)',
-      example: 2
-    },
-    errors: {
-      description: 'Array of error details for failed transactions',
+    accounts: {
+      description: 'Asset/Liability accounts to register with opening balances',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/ImportErrorDto'
+        $ref: '#/components/schemas/OnboardingAccountDto'
       }
     },
-    reviewItems: {
+    skipAssetRegistration: {
+      type: 'boolean',
       description:
-        'Array of transactions pending review with preview data. Contains essential information for displaying in the import preview UI.',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ReviewItemPreviewDto'
-      }
-    },
-    transactions: {
-      type: 'object',
-      description: 'Array of imported transactions (optional, for debugging)'
+        'Skip asset registration; only bootstrap the core account set',
+      default: false
     }
-  },
-  required: ['imported', 'failed', 'skipped', 'pendingReview', 'errors']
+  }
 } as const;
 
-export const $IdentifyResultDto = {
+export const $ActualBalanceDto = {
   type: 'object',
   properties: {
-    identified: {
-      type: 'boolean',
-      description: 'Whether the file was successfully identified',
-      example: true
-    },
-    importerName: {
-      type: 'string',
-      description: 'Name of the importer that can handle this file',
-      example: 'AlipayImporter'
-    },
-    importerId: {
-      type: 'string',
-      description: 'Unique identifier of the importer',
-      example: 'alipay'
-    },
-    account: {
+    amount: {
       type: 'string',
-      description: 'Default account used by this importer',
-      example: 'Assets:CN:Alipay:Balance'
+      description:
+        'Actual balance amount as a decimal string (preserves precision for tolerance inference).',
+      example: '1234.56'
     },
-    message: {
+    ccy: {
       type: 'string',
-      description: 'Message when file cannot be identified',
-      example: 'No matching importer found'
+      description: 'Currency code (ISO 4217 or commodity ticker).',
+      example: 'CNY'
     }
   },
-  required: ['identified']
+  required: ['amount', 'ccy']
 } as const;
 
-export const $MapperDefaultsDto = {
+export const $ComputeReconciliationDto = {
   type: 'object',
   properties: {
-    sourceAccount: {
-      type: 'string',
-      description: 'Source account for transactions (Beancount format)',
-      example: 'Assets:CN:Alipay:Balance'
-    },
-    currency: {
+    accountId: {
       type: 'string',
-      description: 'Default currency (ISO 4217 code)',
-      example: 'CNY'
+      description: 'BeanAccount id to reconcile.'
     },
-    expenseAccount: {
+    asOfDate: {
       type: 'string',
-      description: 'Default expense account',
-      example: 'Expenses:Unknown'
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $ReconciliationComputeResultDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string'
+    },
+    asOfDate: {
+      type: 'string'
+    },
+    bookBalance: {
+      type: 'string',
+      description: 'System-computed book balance (decimal string).'
+    },
+    actualBalance: {
+      type: 'string',
+      description: 'User-entered actual balance (decimal string).'
+    },
+    currency: {
+      type: 'string'
+    },
+    diff: {
+      type: 'string',
+      description: 'Diff = book − actual (decimal string).'
+    },
+    tolerance: {
+      type: 'string',
+      description: 'Applied tolerance (decimal string).'
+    },
+    withinTolerance: {
+      type: 'boolean',
+      description: 'true when |diff| ≤ tolerance.'
+    },
+    suggestedAction: {
+      type: 'string',
+      enum: ['assert', 'pad'],
+      description:
+        'Suggested next action: assert when within tolerance, pad otherwise.'
+    }
+  },
+  required: [
+    'accountId',
+    'asOfDate',
+    'bookBalance',
+    'actualBalance',
+    'currency',
+    'diff',
+    'tolerance',
+    'withinTolerance',
+    'suggestedAction'
+  ]
+} as const;
+
+export const $AssertReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
+    },
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    },
+    tolerance: {
+      type: 'string',
+      description:
+        'Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).',
+      example: '0.01'
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $ReconciliationRecordDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string'
+    },
+    accountId: {
+      type: 'string'
+    },
+    date: {
+      type: 'string'
+    },
+    amount: {
+      type: 'string',
+      description: 'Asserted (actual) amount.'
+    },
+    currency: {
+      type: 'string'
+    },
+    tolerance: {
+      type: 'string'
+    },
+    diffAmount: {
+      type: 'string',
+      description: 'book − actual.'
+    },
+    diffCurrency: {
+      type: 'string'
+    },
+    createdAt: {
+      type: 'string'
+    }
+  },
+  required: ['id', 'accountId', 'date', 'amount', 'currency', 'createdAt']
+} as const;
+
+export const $PadReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
+    },
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    },
+    sourceAccount: {
+      type: 'string',
+      description:
+        'Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).',
+      example: 'Equity:Opening-Balances',
+      default: 'Equity:Opening-Balances'
+    }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
+} as const;
+
+export const $PadResultDto = {
+  type: 'object',
+  properties: {
+    transactionId: {
+      type: 'string',
+      description: 'Created pad adjusting transaction id.'
+    }
+  },
+  required: ['transactionId']
+} as const;
+
+export const $FileImportDto = {
+  type: 'object',
+  properties: {
+    file: {
+      type: 'string',
+      format: 'binary',
+      description: 'Bill file to import (CSV, PDF, OFX, etc.)',
+      example: 'alipay.csv'
+    }
+  },
+  required: ['file']
+} as const;
+
+export const $ImportErrorDto = {
+  type: 'object',
+  properties: {
+    index: {
+      type: 'number',
+      description: 'Index of failed transaction in the file',
+      example: 5
+    },
+    error: {
+      type: 'string',
+      description: 'Error message',
+      example: 'Transaction does not balance: -100 USD != 0'
+    }
+  },
+  required: ['index', 'error']
+} as const;
+
+export const $ReviewItemPreviewDto = {
+  type: 'object',
+  properties: {
+    index: {
+      type: 'number',
+      description: 'Index in the import batch (for tracking)',
+      example: 0
+    },
+    date: {
+      type: 'string',
+      description: 'Transaction date (ISO format)',
+      example: '2026-03-05'
+    },
+    amount: {
+      type: 'number',
+      description: 'Transaction amount (absolute value)',
+      example: 99
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
+    },
+    narration: {
+      type: 'string',
+      description: 'Transaction narration/description',
+      example: 'Restaurant expense'
+    },
+    payee: {
+      type: 'string',
+      description: 'Payee name',
+      example: 'Restaurant ABC'
+    },
+    category: {
+      type: 'string',
+      description: 'Inferred category from rule matching',
+      example: 'food'
+    },
+    confidence: {
+      type: 'number',
+      description: 'Confidence score for the match (0-1)',
+      example: 0.85
+    },
+    branchType: {
+      type: 'string',
+      description: 'Type of branch requiring review',
+      enum: [
+        'DUPLICATE',
+        'PAYEE_MATCH',
+        'RULE_MATCH',
+        'ACCOUNT_VALIDATION',
+        'PIPELINE_ERROR'
+      ],
+      example: 'RULE_MATCH'
+    },
+    reasons: {
+      description: 'Human-readable reasons for requiring review',
+      example: ['Moderate confidence rule match', 'Multiple rules matched'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    }
+  },
+  required: ['index', 'date', 'narration']
+} as const;
+
+export const $ImportResultDto = {
+  type: 'object',
+  properties: {
+    imported: {
+      type: 'number',
+      description: 'Number of successfully imported transactions',
+      example: 45
+    },
+    failed: {
+      type: 'number',
+      description: 'Number of failed transactions',
+      example: 2
+    },
+    skipped: {
+      type: 'number',
+      description:
+        'Number of skipped transactions (high confidence duplicates, auto-skipped)',
+      example: 3
+    },
+    pendingReview: {
+      type: 'number',
+      description:
+        'Number of transactions pending review (medium confidence duplicates)',
+      example: 2
+    },
+    errors: {
+      description: 'Array of error details for failed transactions',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ImportErrorDto'
+      }
+    },
+    reviewItems: {
+      description:
+        'Array of transactions pending review with preview data. Contains essential information for displaying in the import preview UI.',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ReviewItemPreviewDto'
+      }
+    },
+    transactions: {
+      type: 'object',
+      description: 'Array of imported transactions (optional, for debugging)'
+    }
+  },
+  required: ['imported', 'failed', 'skipped', 'pendingReview', 'errors']
+} as const;
+
+export const $IdentifyResultDto = {
+  type: 'object',
+  properties: {
+    identified: {
+      type: 'boolean',
+      description: 'Whether the file was successfully identified',
+      example: true
+    },
+    importerName: {
+      type: 'string',
+      description: 'Name of the importer that can handle this file',
+      example: 'AlipayImporter'
+    },
+    importerId: {
+      type: 'string',
+      description: 'Unique identifier of the importer',
+      example: 'alipay'
+    },
+    account: {
+      type: 'string',
+      description: 'Default account used by this importer',
+      example: 'Assets:CN:Alipay:Balance'
+    },
+    message: {
+      type: 'string',
+      description: 'Message when file cannot be identified',
+      example: 'No matching importer found'
+    }
+  },
+  required: ['identified']
+} as const;
+
+export const $MapperDefaultsDto = {
+  type: 'object',
+  properties: {
+    sourceAccount: {
+      type: 'string',
+      description: 'Source account for transactions (Beancount format)',
+      example: 'Assets:CN:Alipay:Balance'
+    },
+    currency: {
+      type: 'string',
+      description: 'Default currency (ISO 4217 code)',
+      example: 'CNY'
+    },
+    expenseAccount: {
+      type: 'string',
+      description: 'Default expense account',
+      example: 'Expenses:Unknown'
     },
     incomeAccount: {
       type: 'string',
@@ -6356,15 +6692,157 @@ export const $NlpResponseDto = {
     },
     defaultAccounts: {
       description:
-        'Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpDefaultAccountsDto'
-        }
-      ]
+        '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']
+} as const;
+
+export const $PlatformListItemDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Global platform ID'
+    },
+    name: {
+      type: 'string',
+      description: 'Platform name'
+    },
+    url: {
+      type: 'string',
+      description: 'Platform URL'
+    },
+    type: {
+      type: 'string',
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ]
+    },
+    canonical: {
+      type: 'string',
+      description: 'Canonical identifier in ACCOUNT_RE format (e.g., "icbc")'
+    },
+    suggestedSegment: {
+      type: 'string',
+      description:
+        'Suggested path segment — canonical with first char uppercased (ACC_COMP_NAME_RE)'
+    },
+    logoUrl: {
+      type: 'string',
+      description: 'Logo URL',
+      nullable: true
+    },
+    isBound: {
+      type: 'boolean',
+      description: 'Whether user has accounts using this platform'
+    }
+  },
+  required: [
+    'id',
+    'name',
+    'url',
+    'type',
+    'canonical',
+    'suggestedSegment',
+    'logoUrl',
+    'isBound'
+  ]
+} as const;
+
+export const $PlatformMatchResultDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Global platform ID'
+    },
+    name: {
+      type: 'string',
+      description: 'Platform name (e.g., "ICBC")'
+    },
+    canonical: {
+      type: 'string',
+      description: 'Canonical identifier in ACCOUNT_RE format (e.g., "icbc")'
+    },
+    type: {
+      type: 'string',
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ]
+    },
+    suggestedSegment: {
+      type: 'string',
+      description:
+        'Suggested path segment — canonical, already in ACCOUNT_RE format'
+    },
+    logoUrl: {
+      type: 'string',
+      description: 'Logo URL',
+      nullable: true
+    },
+    matchType: {
+      type: 'string',
+      description: "How this row matched: 'exact' > 'prefix' > 'substring'",
+      enum: ['exact', 'prefix', 'substring']
+    }
+  },
+  required: [
+    'id',
+    'name',
+    'canonical',
+    'type',
+    'suggestedSegment',
+    'logoUrl',
+    'matchType'
+  ]
+} as const;
+
+export const $PlatformMatchResponseDto = {
+  type: 'object',
+  properties: {
+    platforms: {
+      description: 'Ranked matches, best tier first (at most 10 rows)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/PlatformMatchResultDto'
+      }
+    },
+    matchType: {
+      type: 'string',
+      description:
+        "Overall match quality — top row's tier, or 'none' when no hits",
+      enum: ['none', 'exact', 'prefix', 'substring']
+    },
+    total: {
+      type: 'number',
+      description: 'Total matches before LIMIT (truncation transparency)'
+    },
+    hasMore: {
+      type: 'boolean',
+      description: 'true when total > platforms.length (more matches exist)'
     }
   },
-  required: ['status', 'action']
+  required: ['platforms', 'matchType', 'total', 'hasMore']
 } as const;
 
 export const $CreatePlatformDto = {
@@ -7409,435 +7887,156 @@ export const $HoldingPnlRowDto = {
       ]
     },
     costBasis: {
-      description: 'Cost basis of held units',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
-    },
-    marketValue: {
-      description: 'Market value at asOf price',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
-    },
-    currentPrice: {
-      description: 'Price used for market value',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/CurrentPriceDto'
-        }
-      ]
-    },
-    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: [
-    'accountId',
-    'accountPath',
-    'symbol',
-    'chartToken',
-    'assetClass',
-    'units'
-  ]
-} as const;
-
-export const $HoldingPnlWarningDto = {
-  type: 'object',
-  properties: {
-    type: {
-      type: 'string',
-      description: 'Warning type',
-      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'
-      ]
-    },
-    symbol: {
-      type: 'object',
-      nullable: true
-    },
-    accountId: {
-      type: 'object',
-      nullable: true
-    },
-    currency: {
-      type: 'object',
-      nullable: true
-    }
-  },
-  required: ['type']
-} as const;
-
-export const $HoldingPnlResponseDto = {
-  type: 'object',
-  properties: {
-    asOfDate: {
-      type: 'string',
-      example: '2026-07-08'
-    },
-    baseCurrency: {
-      type: 'string',
-      example: 'CNY'
-    },
-    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'
-    },
-    rows: {
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/HoldingPnlRowDto'
-      }
-    },
-    warnings: {
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/HoldingPnlWarningDto'
-      }
-    }
-  },
-  required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
-} as const;
-
-export const $CurrencyBalanceDto = {
-  type: 'object',
-  properties: {
-    currency: {
-      type: 'string',
-      description: 'ISO 4217 currency code',
-      example: 'CNY'
-    },
-    balance: {
-      type: 'string',
-      description: 'Balance amount',
-      example: '500000.00'
-    }
-  },
-  required: ['currency', 'balance']
-} as const;
-
-export const $TimeSeriesPointDto = {
-  type: 'object',
-  properties: {
-    date: {
-      type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
-    },
-    value: {
-      type: 'string',
-      description: 'Value at this date (in base currency)',
-      example: '500000.00'
-    },
-    change: {
-      type: 'object',
-      description: 'Change from previous point',
-      example: '5000.00'
-    },
-    assets: {
-      type: 'string',
-      description: 'Total assets at this date (in base currency)',
-      example: '494338.00'
-    },
-    liabilities: {
-      type: 'string',
-      description: 'Total liabilities at this date (in base currency)',
-      example: '310098.00'
-    },
-    byCurrency: {
-      description: 'Multi-currency breakdown for this point',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
-    }
-  },
-  required: ['date', 'value']
-} as const;
-
-export const $TrendSummaryDto = {
-  type: 'object',
-  properties: {
-    startValue: {
-      type: 'string',
-      description: 'Value at start of period',
-      example: '450000.00'
-    },
-    endValue: {
-      type: 'string',
-      description: 'Value at end of period',
-      example: '500000.00'
-    },
-    totalChange: {
-      type: 'string',
-      description: 'Total change over period',
-      example: '50000.00'
-    },
-    totalChangePercentage: {
-      type: 'string',
-      description: 'Total change percentage',
-      example: '+11.11%'
-    }
-  },
-  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
-} as const;
-
-export const $MultiCurrencyPointDto = {
-  type: 'object',
-  properties: {
-    date: {
-      type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
+      description: 'Cost basis of held units',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     },
-    byCurrency: {
-      description: 'Balances by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
-    }
-  },
-  required: ['date', 'byCurrency']
-} as const;
-
-export const $PortfolioTrendsResponseDto = {
-  type: 'object',
-  properties: {
-    series: {
-      description: 'Time series data points',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/TimeSeriesPointDto'
-      }
+    marketValue: {
+      description: 'Market value at asOf price',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     },
-    summary: {
-      description: 'Period summary',
+    currentPrice: {
+      description: 'Price used for market value',
+      nullable: true,
       allOf: [
         {
-          $ref: '#/components/schemas/TrendSummaryDto'
+          $ref: '#/components/schemas/CurrentPriceDto'
         }
       ]
     },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
+    unrealizedPnlBase: {
+      type: 'object',
+      description:
+        'Unrealized P&L in base currency (Decimal string); null when any FX/price missing',
+      nullable: true,
+      example: '6000'
     },
-    granularity: {
-      type: 'string',
-      description: 'Data granularity',
-      example: 'month'
+    unrealizedPnlPct: {
+      type: 'object',
+      description: 'Unrealized P&L % (Decimal string)',
+      nullable: true,
+      example: '25'
     },
-    currency: {
-      type: 'string',
-      description: 'Base currency for converted values',
-      example: 'CNY'
+    costFxRate: {
+      description: 'Historical FX rate applied to cost basis',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
     },
-    byCurrency: {
+    marketFxRate: {
+      description: 'FX rate applied to market value',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
+    },
+    pctOfInvestedAssets: {
+      type: 'object',
       description:
-        'Multi-currency time series (each point has currency breakdown)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/MultiCurrencyPointDto'
-      }
+        'Share of invested assets % (Decimal string); only for invested chartTokens',
+      nullable: true,
+      example: '40'
     },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
+    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: ['series', 'summary', 'period', 'granularity', 'currency']
+  required: [
+    'accountId',
+    'accountPath',
+    'symbol',
+    'chartToken',
+    'assetClass',
+    'units'
+  ]
 } as const;
 
-export const $CashFlowPointDto = {
+export const $HoldingPnlWarningDto = {
   type: 'object',
   properties: {
-    month: {
+    type: {
       type: 'string',
-      description: 'Month key (YYYY-MM)',
-      example: '2024-03'
+      description: 'Warning type',
+      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'
+      ]
     },
-    income: {
-      type: 'string',
-      description: 'Income in base currency (absolute, converted)',
-      example: '10000.00'
+    symbol: {
+      type: 'object',
+      nullable: true
     },
-    expense: {
-      type: 'string',
-      description: 'Expense in base currency (absolute, converted)',
-      example: '5000.00'
+    accountId: {
+      type: 'object',
+      nullable: true
     },
-    netSavings: {
-      type: 'string',
-      description: 'netSavings = income − expense (savings positive)',
-      example: '5000.00'
+    currency: {
+      type: 'object',
+      nullable: true
     }
   },
-  required: ['month', 'income', 'expense', 'netSavings']
+  required: ['type']
 } as const;
 
-export const $CashFlowTrendSummaryDto = {
+export const $HoldingPnlResponseDto = {
   type: 'object',
   properties: {
-    totalIncome: {
-      type: 'string',
-      description: 'Total income across the period',
-      example: '60000.00'
-    },
-    totalExpense: {
+    asOfDate: {
       type: 'string',
-      description: 'Total expense across the period',
-      example: '30000.00'
+      example: '2026-07-08'
     },
-    totalNetSavings: {
+    baseCurrency: {
       type: 'string',
-      description: 'income − expense across the period',
-      example: '30000.00'
+      example: 'CNY'
     },
-    averageMonthlyNetSavings: {
+    method: {
       type: 'string',
       description:
-        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
-      example: '5000.00'
-    }
-  },
-  required: [
-    'totalIncome',
-    'totalExpense',
-    'totalNetSavings',
-    'averageMonthlyNetSavings'
-  ]
-} as const;
-
-export const $CashFlowTrendsResponseDto = {
-  type: 'object',
-  properties: {
-    series: {
-      description:
-        'Monthly cash-flow series (fixed N-month window, zero-filled)',
+        'Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).',
+      enum: ['average', 'FIFO'],
+      example: 'average'
+    },
+    rows: {
       type: 'array',
       items: {
-        $ref: '#/components/schemas/CashFlowPointDto'
+        $ref: '#/components/schemas/HoldingPnlRowDto'
       }
     },
-    summary: {
-      description: 'Period totals',
-      allOf: [
-        {
-          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
-        }
-      ]
-    },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
-    },
-    granularity: {
-      type: 'string',
-      description: 'Data granularity (v1 returns month buckets)',
-      example: 'month'
-    },
-    currency: {
-      type: 'string',
-      description: 'Base currency for converted values',
-      example: 'CNY'
-    },
     warnings: {
-      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
+        $ref: '#/components/schemas/HoldingPnlWarningDto'
       }
     }
   },
-  required: ['series', 'summary', 'period', 'granularity', 'currency']
-} as const;
-
-export const $GenerateSnapshotBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $GenerateSnapshotResponse = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsResponse = {
-  type: 'object',
-  properties: {}
+  required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
 } as const;
 
 export const $AnonymousLoginDto = {
@@ -7850,3 +8049,15 @@ export const $AnonymousLoginDto = {
   },
   required: ['accessToken']
 } as const;
+
+export const $AnonymousLoginResponseDto = {
+  type: 'object',
+  properties: {
+    authToken: {
+      type: 'string',
+      description: 'JWT auth token',
+      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+    }
+  },
+  required: ['authToken']
+} as const;