chore: import upstream snapshot with attribution

apps/sim/tools/brex/update_expense.ts

@@ -0,0 +1,100 @@
+import type { BrexUpdateExpenseParams, BrexUpdateExpenseResponse } from '@/tools/brex/types'
+import { BREX_MONEY_PROPERTIES } from '@/tools/brex/types'
+import { BREX_API_BASE, buildBrexHeaders, parseBrexJson } from '@/tools/brex/utils'
+import type { ToolConfig } from '@/tools/types'
+
+export const brexUpdateExpenseTool: ToolConfig<BrexUpdateExpenseParams, BrexUpdateExpenseResponse> =
+  {
+    id: 'brex_update_expense',
+    name: 'Brex Update Expense',
+    description: 'Update the memo of a Brex card expense',
+    version: '1.0.0',
+
+    params: {
+      apiKey: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Brex user token (generated from Developer Settings in the Brex dashboard)',
+      },
+      expenseId: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'ID of the card expense to update',
+      },
+      memo: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'New memo for the expense',
+      },
+    },
+
+    request: {
+      url: (params) =>
+        `${BREX_API_BASE}/v1/expenses/card/${encodeURIComponent(params.expenseId.trim())}`,
+      method: 'PUT',
+      headers: (params) => buildBrexHeaders(params.apiKey),
+      body: (params) => ({ memo: params.memo }),
+    },
+
+    transformResponse: async (response) => {
+      const data = await parseBrexJson(response)
+      return {
+        success: true,
+        output: {
+          id: data.id ?? '',
+          memo: data.memo ?? null,
+          status: data.status ?? null,
+          paymentStatus: data.payment_status ?? null,
+          category: data.category ?? null,
+          merchantId: data.merchant_id ?? null,
+          budgetId: data.budget_id ?? null,
+          originalAmount: data.original_amount ?? null,
+          billingAmount: data.billing_amount ?? null,
+          purchasedAt: data.purchased_at ?? null,
+          updatedAt: data.updated_at ?? '',
+        },
+      }
+    },
+
+    outputs: {
+      id: { type: 'string', description: 'Unique expense ID' },
+      memo: { type: 'string', description: 'Updated memo on the expense', optional: true },
+      status: {
+        type: 'string',
+        description:
+          'Expense status (DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED)',
+        optional: true,
+      },
+      paymentStatus: {
+        type: 'string',
+        description:
+          'Payment status (NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED)',
+        optional: true,
+      },
+      category: {
+        type: 'string',
+        description:
+          'Expense category (e.g., RESTAURANTS, RECURRING_SOFTWARE_AND_SAAS, AIRLINE_EXPENSES)',
+        optional: true,
+      },
+      merchantId: { type: 'string', description: 'Merchant ID', optional: true },
+      budgetId: { type: 'string', description: 'Budget ID', optional: true },
+      originalAmount: {
+        type: 'json',
+        description: 'Original transaction amount',
+        optional: true,
+        properties: BREX_MONEY_PROPERTIES,
+      },
+      billingAmount: {
+        type: 'json',
+        description: 'Amount billed to the account',
+        optional: true,
+        properties: BREX_MONEY_PROPERTIES,
+      },
+      purchasedAt: { type: 'string', description: 'Purchase timestamp (ISO 8601)', optional: true },
+      updatedAt: { type: 'string', description: 'Last update timestamp (ISO 8601)' },
+    },
+  }