@firela/api-types 0.0.0-canary.8cbdced0 → 0.0.0-canary.9d0af796

package/src/generated/schemas.gen.ts

@@ -4312,6 +4312,144 @@ export const $UpdatePropertyDto = {
   required: ['value']
 } as const;
 
+export const $CreateBeanEventDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601)',
+      example: '2024-03-15'
+    },
+    type: {
+      type: 'string',
+      description:
+        'Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer',
+      example: 'employer'
+    },
+    description: {
+      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'
+      }
+    }
+  },
+  required: ['date', 'type', 'description']
+} as const;
+
+export const $EventResponseDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
+    },
+    userId: {
+      type: 'string',
+      description: 'User ID (owner of the life event)',
+      example: 'user-123'
+    },
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601 format)',
+      example: '2024-03-15',
+      format: 'date'
+    },
+    type: {
+      type: 'string',
+      description:
+        'Life event type (user-defined, e.g., "employer", "location")',
+      example: 'employer'
+    },
+    description: {
+      type: 'string',
+      description:
+        'Life event description. May be an empty string (a valid value distinct from absence).',
+      example: 'Acme Corp'
+    },
+    meta: {
+      type: 'object',
+      description: 'Product-side metadata (free-form JSON)',
+      example: {
+        note: 'Promotion'
+      }
+    },
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Creation timestamp',
+      example: '2024-03-15T10:00:00Z'
+    },
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description:
+        'Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.',
+      example: '2024-03-15T10:00:00Z'
+    }
+  },
+  required: [
+    'id',
+    'userId',
+    'date',
+    'type',
+    'description',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
+} as const;
+
+export const $EventListResponseDto = {
+  type: 'object',
+  properties: {
+    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: ['items', 'total']
+} as const;
+
+export const $UpdateBeanEventDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601)'
+    },
+    type: {
+      type: 'string',
+      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)'
+    }
+  }
+} as const;
+
 export const $FileImportDto = {
   type: 'object',
   properties: {
@@ -4888,91 +5026,907 @@ export const $ProviderSyncDto = {
       description: 'Provider sync configuration',
       allOf: [
         {
-          $ref: '#/components/schemas/ProviderSyncConfigDto'
+          $ref: '#/components/schemas/ProviderSyncConfigDto'
+        }
+      ]
+    },
+    transactions: {
+      type: 'array',
+      description: 'Raw transactions from provider',
+      example: [
+        {
+          transaction_id: 'txn-001',
+          amount: 50,
+          iso_currency_code: 'USD',
+          date: '2024-01-15',
+          merchant_name: 'Starbucks',
+          name: 'STARBUCKS STORE 12345',
+          pending: false,
+          account_id: 'acc-001'
+        }
+      ]
+    }
+  },
+  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: {
+    providers: {
+      description: 'List of supported provider names',
+      example: [
+        'plaid',
+        'teller',
+        'truelayer',
+        'gocardless',
+        'simplefin',
+        'yodlee',
+        'beancount-direct',
+        'parsed-bill'
+      ],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    }
+  },
+  required: ['providers']
+} as const;
+
+export const $ParserTelemetryReportDto = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $UncoveredFormatMissDto = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $ProcessNlpDto = {
+  type: 'object',
+  properties: {
+    message: {
+      type: 'string',
+      description: 'Natural language text describing a transaction (Chinese)',
+      example: 'yesterday Starbucks spent 35 yuan',
+      maxLength: 500
+    },
+    sessionId: {
+      type: 'string',
+      description:
+        'Session ID for multi-turn conversation (auto-generated if not provided)',
+      example: 'session_abc123'
+    },
+    parsedData: {
+      type: 'object',
+      description:
+        'Parsed data from previous NLP response for session recovery. Send back the parsedData received in confirm_payee/confirm responses.',
+      example: {
+        amount: 35,
+        currency: 'CNY',
+        payee: 'Starbucks'
+      }
+    }
+  },
+  required: ['message']
+} as const;
+
+export const $NlpTransactionInfoDto = {
+  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'
+    },
+    warning: {
+      type: 'string',
+      description:
+        'Warning message for special transaction scenarios (e.g., cross-currency settlement)',
+      example: '此交易使用USD账户结算。如需记录CNY支出，请创建货币转换交易。'
+    }
+  },
+  required: ['id', 'date', 'amount', 'currency']
+} as const;
+
+export const $NlpParsedDataDto = {
+  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)'
+    },
+    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'
+    },
+    warning: {
+      type: 'string',
+      description:
+        'Warning message for special scenarios (e.g., cross-currency settlement)',
+      example: '此交易使用USD账户结算。如需记录CNY支出，请创建货币转换交易。'
+    }
+  }
+} as const;
+
+export const $NlpSourceTransactionDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Transaction date (ISO format)'
+    },
+    amount: {
+      type: 'string',
+      description: 'Amount as string'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code'
+    },
+    payee: {
+      type: 'string',
+      description: 'Payee name'
+    },
+    narration: {
+      type: 'string',
+      description: 'Transaction narration'
+    }
+  },
+  required: ['date', 'amount', 'currency', 'narration']
+} as const;
+
+export const $NlpTargetTransactionDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Existing transaction ID'
+    },
+    date: {
+      type: 'string',
+      description: 'Transaction date (ISO format)'
+    },
+    amount: {
+      type: 'string',
+      description: 'Amount as string'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code'
+    },
+    payee: {
+      type: 'string',
+      description: 'Payee name'
+    },
+    narration: {
+      type: 'string',
+      description: 'Transaction narration'
+    }
+  },
+  required: ['id', 'date', 'amount', 'currency', 'narration']
+} as const;
+
+export const $NlpSimilarityDto = {
+  type: 'object',
+  properties: {
+    dateMatch: {
+      type: 'boolean',
+      description: 'Whether dates match'
+    },
+    dateDiff: {
+      type: 'number',
+      description: 'Date difference in days'
+    },
+    amountMatch: {
+      type: 'boolean',
+      description: 'Whether amounts match'
+    },
+    amountDiff: {
+      type: 'string',
+      description: 'Amount difference as decimal string'
+    },
+    payeeMatch: {
+      type: 'boolean',
+      description: 'Whether payees match'
+    },
+    payeeSimilarity: {
+      type: 'number',
+      description: 'Payee similarity score (0-1)'
+    },
+    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
+    },
+    sourceTransaction: {
+      description:
+        'Source transaction summary (the new transaction being entered)',
+      allOf: [
+        {
+          $ref: '#/components/schemas/NlpSourceTransactionDto'
+        }
+      ]
+    },
+    targetTransaction: {
+      description: 'Target transaction summary (existing potential duplicate)',
+      allOf: [
+        {
+          $ref: '#/components/schemas/NlpTargetTransactionDto'
+        }
+      ]
+    },
+    similarity: {
+      description: 'Detailed similarity information',
+      allOf: [
+        {
+          $ref: '#/components/schemas/NlpSimilarityDto'
+        }
+      ]
+    },
+    reasons: {
+      description: 'Human-readable reasons for duplicate detection',
+      example: ['日期匹配', '金额匹配', '商户相似'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    }
+  },
+  required: [
+    'confidence',
+    'sourceTransaction',
+    'targetTransaction',
+    'similarity',
+    'reasons'
+  ]
+} as const;
+
+export const $NlpRuleConfirmationDataDto = {
+  type: 'object',
+  properties: {
+    confidence: {
+      type: 'number',
+      description: 'Rule match confidence score (0.5-0.74)',
+      example: 0.65
+    },
+    matchedRule: {
+      type: 'object',
+      description: 'Matched rule information'
+    },
+    suggestedAccounts: {
+      type: 'object',
+      description: 'Suggested accounts from the rule'
+    },
+    alternatives: {
+      type: 'array',
+      description: 'Alternative rules that also match'
+    },
+    reasons: {
+      description: 'Human-readable reasons for the match',
+      example: [
+        'Moderate confidence (65%)',
+        'Some keywords matched (OR logic)'
+      ],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    }
+  },
+  required: [
+    'confidence',
+    'matchedRule',
+    'suggestedAccounts',
+    'alternatives',
+    'reasons'
+  ]
+} as const;
+
+export const $NlpAccountConfirmationDataDto = {
+  type: 'object',
+  properties: {
+    invalidAccount: {
+      type: 'string',
+      description: 'The invalid account name',
+      example: 'Expenses:Food:Coffee'
+    },
+    suggestedAccount: {
+      type: 'string',
+      description: 'Suggested replacement account',
+      example: 'Expenses:Food:Drinks'
+    },
+    similarAccounts: {
+      description: 'Similar accounts for user selection',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    errorMessage: {
+      type: 'string',
+      description: 'Error message explaining the issue',
+      example: 'No similar account found'
+    },
+    transactionContext: {
+      type: 'object',
+      description: 'Transaction context for reference'
+    }
+  },
+  required: [
+    'invalidAccount',
+    'suggestedAccount',
+    'similarAccounts',
+    'errorMessage',
+    'transactionContext'
+  ]
+} as const;
+
+export const $NlpSuggestedPayeeDto = {
+  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']
+    },
+    payeeProfileId: {
+      type: 'string',
+      description: 'PayeeProfile ID (if matched from global)',
+      example: 'profile-456'
+    }
+  },
+  required: ['id', 'name']
+} as const;
+
+export const $NlpAlternativePayeeDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Payee ID',
+      example: 'payee-alt-1'
+    },
+    name: {
+      type: 'string',
+      description: 'Payee name',
+      example: 'Starbucks Coffee'
+    },
+    similarity: {
+      type: 'number',
+      description: 'Similarity score (0-1)',
+      example: 0.75
+    }
+  },
+  required: ['id', 'name', 'similarity']
+} as const;
+
+export const $NlpPayeeConfirmationDataDto = {
+  type: 'object',
+  properties: {
+    confidence: {
+      type: 'number',
+      description: 'Confidence score for the payee match (0-1)',
+      example: 0.65
+    },
+    originalPayee: {
+      type: 'string',
+      description: 'Original payee string from user input',
+      example: '星巴'
+    },
+    suggestedPayee: {
+      description: 'Suggested payee to use (null when no similar payees found)',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/NlpSuggestedPayeeDto'
+        }
+      ]
+    },
+    similarity: {
+      type: 'number',
+      description: 'Similarity score between original and suggested (0-1)',
+      example: 0.85
+    },
+    alternatives: {
+      description: 'Alternative payee options',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/NlpAlternativePayeeDto'
+      }
+    },
+    reasons: {
+      description: 'Human-readable reasons for the match',
+      example: ['Moderate similarity (65%)', 'Fuzzy match on name'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    }
+  },
+  required: [
+    'confidence',
+    'originalPayee',
+    'similarity',
+    'alternatives',
+    'reasons'
+  ]
+} as const;
+
+export const $RecurringMatchInfoDto = {
+  type: 'object',
+  properties: {
+    expectedId: {
+      type: 'string',
+      description: 'Expected transaction ID'
+    },
+    ruleId: {
+      type: 'string',
+      description: 'Recurring rule ID'
+    },
+    ruleName: {
+      type: 'string',
+      description: 'Rule name for display'
+    },
+    ruleIcon: {
+      type: 'string',
+      description: 'Rule icon'
+    },
+    expectedDate: {
+      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)'
+    }
+  },
+  required: [
+    'expectedId',
+    'ruleId',
+    'ruleName',
+    'expectedDate',
+    'expectedAmount',
+    'confidence',
+    'isAutoMatched'
+  ]
+} as const;
+
+export const $NlpSuggestedAccountDto = {
+  type: 'object',
+  properties: {
+    account: {
+      type: 'string',
+      description: 'Suggested account path',
+      example: 'Assets:Bank:Checking'
+    },
+    confidence: {
+      type: 'number',
+      description: 'Confidence score for this suggestion (0-1)',
+      example: 0.9
+    }
+  },
+  required: ['account']
+} as const;
+
+export const $NlpSuggestedAccountsDto = {
+  type: 'object',
+  properties: {
+    source: {
+      description:
+        'Source account suggestion (where money comes from). For expense: asset/liability account. For income: income account.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/NlpSuggestedAccountDto'
         }
       ]
     },
-    transactions: {
-      type: 'array',
-      description: 'Raw transactions from provider',
-      example: [
+    destination: {
+      description:
+        'Destination account suggestion (where money goes to). For expense: expense account. For income: asset/liability account.',
+      allOf: [
         {
-          transaction_id: 'txn-001',
-          amount: 50,
-          iso_currency_code: 'USD',
-          date: '2024-01-15',
-          merchant_name: 'Starbucks',
-          name: 'STARBUCKS STORE 12345',
-          pending: false,
-          account_id: 'acc-001'
+          $ref: '#/components/schemas/NlpSuggestedAccountDto'
         }
       ]
     }
-  },
-  required: ['config', 'transactions']
+  }
 } as const;
 
-export const $SupportedProvidersResponseDto = {
+export const $NlpDefaultAccountsDto = {
   type: 'object',
   properties: {
-    providers: {
-      description: 'List of supported provider names',
-      example: [
-        'plaid',
-        'teller',
-        'truelayer',
-        'gocardless',
-        'simplefin',
-        'yodlee',
-        'beancount-direct',
-        'parsed-bill'
-      ],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+    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: ['providers']
-} as const;
-
-export const $ParserTelemetryReportDto = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $UncoveredFormatMissDto = {
-  type: 'object',
-  properties: {}
+  required: ['asset', 'expense', 'income', 'liability']
 } as const;
 
-export const $ProcessNlpDto = {
+export const $NlpResponseDto = {
   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: {
+      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'
+    },
+    liabilitySubType: {
+      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'
+    },
+    equitySubType: {
+      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'
+    },
+    paymentSource: {
+      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'
+    },
+    liabilityHint: {
+      type: 'string',
+      description:
+        'Liability account type hint for credit card/BNPL spending (v6.1). Only present when paymentSource is "liability". Values: CreditCard, Huabei, Baitiao',
+      example: 'CreditCard'
+    },
     message: {
       type: 'string',
-      description: 'Natural language text describing a transaction (Chinese)',
-      example: 'yesterday Starbucks spent 35 yuan',
-      maxLength: 500
+      description:
+        'Human-readable message (for ask or error actions). Deprecated: Use messageKey for i18n support.',
+      example: 'How much did you spend?',
+      deprecated: true
     },
-    sessionId: {
+    messageKey: {
       type: 'string',
       description:
-        'Session ID for multi-turn conversation (auto-generated if not provided)',
-      example: 'session_abc123'
+        'i18n message key for frontend translation. Use this instead of message for internationalization support.',
+      example: 'nlp.slot.prompt'
     },
-    parsedData: {
+    messageParams: {
       type: 'object',
       description:
-        'Parsed data from previous NLP response for session recovery. Send back the parsedData received in confirm_payee/confirm responses.',
+        'Parameters for message interpolation. Used with messageKey for dynamic values in translated messages.',
       example: {
-        amount: 35,
-        currency: 'CNY',
-        payee: 'Starbucks'
+        slot: 'amount',
+        name: 'Starbucks',
+        similarity: 85
       }
+    },
+    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: ['message']
+  required: ['status', 'action']
 } as const;
 
 export const $BalanceByCurrencyDto = {
@@ -6258,6 +7212,111 @@ export const $PortfolioTrendsResponseDto = {
   required: ['series', 'summary', 'period', 'granularity', 'currency']
 } as const;
 
+export const $CashFlowPointDto = {
+  type: 'object',
+  properties: {
+    month: {
+      type: 'string',
+      description: 'Month key (YYYY-MM)',
+      example: '2024-03'
+    },
+    income: {
+      type: 'string',
+      description: 'Income in base currency (absolute, converted)',
+      example: '10000.00'
+    },
+    expense: {
+      type: 'string',
+      description: 'Expense in base currency (absolute, converted)',
+      example: '5000.00'
+    },
+    netSavings: {
+      type: 'string',
+      description: 'netSavings = income − expense (savings positive)',
+      example: '5000.00'
+    }
+  },
+  required: ['month', 'income', 'expense', 'netSavings']
+} as const;
+
+export const $CashFlowTrendSummaryDto = {
+  type: 'object',
+  properties: {
+    totalIncome: {
+      type: 'string',
+      description: 'Total income across the period',
+      example: '60000.00'
+    },
+    totalExpense: {
+      type: 'string',
+      description: 'Total expense across the period',
+      example: '30000.00'
+    },
+    totalNetSavings: {
+      type: 'string',
+      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: [
+    'totalIncome',
+    'totalExpense',
+    'totalNetSavings',
+    'averageMonthlyNetSavings'
+  ]
+} as const;
+
+export const $CashFlowTrendsResponseDto = {
+  type: 'object',
+  properties: {
+    series: {
+      description:
+        'Monthly cash-flow series (fixed N-month window, zero-filled)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CashFlowPointDto'
+      }
+    },
+    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'
+      }
+    }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
+} as const;
+
 export const $GenerateSnapshotBody = {
   type: 'object',
   properties: {}