@elizaos/plugin-finances 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/payment-csv-import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/payment-csv-import.ts"],"sourcesContent":["import { normalizeMerchant } from \"./payment-recurrence.js\";\nimport type {\n  LifeOpsPaymentDirection,\n  LifeOpsPaymentTransaction,\n} from \"./payment-types.js\";\n\nconst DATE_COLUMN_HINTS = [\"date\", \"posted\", \"posted date\", \"transaction date\"];\n// Only single-amount formats match here. Separate Debit/Credit columns are\n// handled below via DEBIT_COLUMN_HINTS / CREDIT_COLUMN_HINTS so we don't\n// collapse them into a single amount column.\nconst AMOUNT_COLUMN_HINTS = [\"amount\", \"amount (usd)\", \"transaction amount\"];\nconst DEBIT_COLUMN_HINTS = [\"debit\", \"withdrawal\", \"amount debit\"];\nconst CREDIT_COLUMN_HINTS = [\"credit\", \"deposit\", \"amount credit\"];\nconst MERCHANT_COLUMN_HINTS = [\n  \"merchant\",\n  \"payee\",\n  \"name\",\n  \"description\",\n  \"memo\",\n  \"details\",\n];\nconst CATEGORY_COLUMN_HINTS = [\n  \"category\",\n  \"transaction category\",\n  \"plaid category\",\n];\n\n/**\n * Minimal RFC 4180 CSV parser. Handles quoted fields with embedded commas\n * and escaped double quotes. Returns rows as string arrays.\n */\nexport function parseCsv(text: string): string[][] {\n  const rows: string[][] = [];\n  let current: string[] = [];\n  let field = \"\";\n  let inQuotes = false;\n  let index = 0;\n  while (index < text.length) {\n    const char = text[index];\n    if (inQuotes) {\n      if (char === '\"') {\n        if (text[index + 1] === '\"') {\n          field += '\"';\n          index += 2;\n          continue;\n        }\n        inQuotes = false;\n        index += 1;\n        continue;\n      }\n      field += char;\n      index += 1;\n      continue;\n    }\n    if (char === '\"') {\n      inQuotes = true;\n      index += 1;\n      continue;\n    }\n    if (char === \",\") {\n      current.push(field);\n      field = \"\";\n      index += 1;\n      continue;\n    }\n    if (char === \"\\r\") {\n      // Ignore — the \\n branch below does the newline handling.\n      index += 1;\n      continue;\n    }\n    if (char === \"\\n\") {\n      current.push(field);\n      rows.push(current);\n      current = [];\n      field = \"\";\n      index += 1;\n      continue;\n    }\n    field += char;\n    index += 1;\n  }\n  if (field.length > 0 || current.length > 0) {\n    current.push(field);\n    rows.push(current);\n  }\n  return rows.filter((row) => row.some((value) => value.trim().length > 0));\n}\n\nfunction findColumn(\n  header: readonly string[],\n  hints: readonly string[],\n): number {\n  for (let index = 0; index < header.length; index += 1) {\n    const normalized = header[index].trim().toLowerCase();\n    if (hints.includes(normalized)) {\n      return index;\n    }\n  }\n  for (let index = 0; index < header.length; index += 1) {\n    const normalized = header[index].trim().toLowerCase();\n    for (const hint of hints) {\n      if (normalized.includes(hint)) {\n        return index;\n      }\n    }\n  }\n  return -1;\n}\n\nfunction parseAmount(\n  row: readonly string[],\n  amountIndex: number,\n  debitIndex: number,\n  creditIndex: number,\n): { amountUsd: number; direction: LifeOpsPaymentDirection } | null {\n  const readNumber = (raw: string | undefined): number | null => {\n    if (raw === undefined) {\n      return null;\n    }\n    const cleaned = raw.replace(/[$,]/g, \"\").trim();\n    if (!cleaned) {\n      return null;\n    }\n    // Handle \"(12.34)\" accounting negatives.\n    const negative = /^\\(.+\\)$/.test(cleaned);\n    const value = Number(cleaned.replace(/[()]/g, \"\"));\n    if (!Number.isFinite(value)) {\n      return null;\n    }\n    return negative ? -value : value;\n  };\n\n  if (amountIndex >= 0) {\n    const amount = readNumber(row[amountIndex]);\n    if (amount === null) {\n      return null;\n    }\n    return {\n      amountUsd: Math.abs(amount),\n      direction: amount < 0 ? \"debit\" : \"credit\",\n    };\n  }\n  if (debitIndex >= 0) {\n    const debit = readNumber(row[debitIndex]);\n    if (debit !== null && debit !== 0) {\n      return { amountUsd: Math.abs(debit), direction: \"debit\" };\n    }\n  }\n  if (creditIndex >= 0) {\n    const credit = readNumber(row[creditIndex]);\n    if (credit !== null && credit !== 0) {\n      return { amountUsd: Math.abs(credit), direction: \"credit\" };\n    }\n  }\n  return null;\n}\n\nfunction normalizeDate(raw: string): string | null {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return null;\n  }\n  // Try native parse first. Falls back to YYYY-MM-DD and MM/DD/YYYY.\n  const native = Date.parse(trimmed);\n  if (Number.isFinite(native)) {\n    return new Date(native).toISOString();\n  }\n  const isoMatch = trimmed.match(/^(\\d{4})-(\\d{2})-(\\d{2})/);\n  if (isoMatch) {\n    return new Date(\n      Date.UTC(\n        Number(isoMatch[1]),\n        Number(isoMatch[2]) - 1,\n        Number(isoMatch[3]),\n      ),\n    ).toISOString();\n  }\n  const usMatch = trimmed.match(/^(\\d{1,2})[/-](\\d{1,2})[/-](\\d{2,4})/);\n  if (usMatch) {\n    const month = Number(usMatch[1]);\n    const day = Number(usMatch[2]);\n    const rawYear = Number(usMatch[3]);\n    const year = rawYear < 100 ? 2000 + rawYear : rawYear;\n    return new Date(Date.UTC(year, month - 1, day)).toISOString();\n  }\n  return null;\n}\n\nexport interface ParsedCsvTransaction\n  extends Pick<\n    LifeOpsPaymentTransaction,\n    | \"postedAt\"\n    | \"amountUsd\"\n    | \"direction\"\n    | \"merchantRaw\"\n    | \"merchantNormalized\"\n    | \"description\"\n    | \"category\"\n    | \"currency\"\n    | \"externalId\"\n  > {\n  rowIndex: number;\n}\n\nexport interface ParseCsvOptions {\n  dateColumn?: string;\n  amountColumn?: string;\n  merchantColumn?: string;\n  descriptionColumn?: string;\n  categoryColumn?: string;\n}\n\nexport interface ParseCsvResult {\n  transactions: ParsedCsvTransaction[];\n  rowsRead: number;\n  errors: string[];\n}\n\nfunction resolveColumnIndex(\n  header: readonly string[],\n  hint: string | undefined,\n  fallbackHints: readonly string[],\n): number {\n  if (hint) {\n    const explicitIndex = header.findIndex(\n      (value) => value.trim().toLowerCase() === hint.trim().toLowerCase(),\n    );\n    if (explicitIndex >= 0) {\n      return explicitIndex;\n    }\n  }\n  return findColumn(header, fallbackHints);\n}\n\nexport function parseTransactionsCsv(\n  csvText: string,\n  options: ParseCsvOptions = {},\n): ParseCsvResult {\n  const rows = parseCsv(csvText);\n  if (rows.length < 2) {\n    return {\n      transactions: [],\n      rowsRead: Math.max(0, rows.length - 1),\n      errors: [\"CSV has no data rows.\"],\n    };\n  }\n  const header = rows[0].map((value) => value.trim());\n  const dateIndex = resolveColumnIndex(\n    header,\n    options.dateColumn,\n    DATE_COLUMN_HINTS,\n  );\n  const amountIndex = resolveColumnIndex(\n    header,\n    options.amountColumn,\n    AMOUNT_COLUMN_HINTS,\n  );\n  const debitIndex = findColumn(header, DEBIT_COLUMN_HINTS);\n  const creditIndex = findColumn(header, CREDIT_COLUMN_HINTS);\n  const merchantIndex = resolveColumnIndex(\n    header,\n    options.merchantColumn,\n    MERCHANT_COLUMN_HINTS,\n  );\n  const descriptionIndex = resolveColumnIndex(\n    header,\n    options.descriptionColumn,\n    [\"description\", \"memo\", \"details\"],\n  );\n  const categoryIndex = resolveColumnIndex(\n    header,\n    options.categoryColumn,\n    CATEGORY_COLUMN_HINTS,\n  );\n\n  const errors: string[] = [];\n  if (dateIndex < 0) {\n    errors.push(\"Could not find a date column in the CSV header.\");\n  }\n  if (amountIndex < 0 && debitIndex < 0 && creditIndex < 0) {\n    errors.push(\n      \"Could not find an amount/debit/credit column in the CSV header.\",\n    );\n  }\n  if (merchantIndex < 0) {\n    errors.push(\"Could not find a merchant / payee / description column.\");\n  }\n\n  const transactions: ParsedCsvTransaction[] = [];\n  if (dateIndex < 0 || merchantIndex < 0) {\n    return { transactions, rowsRead: rows.length - 1, errors };\n  }\n\n  for (let rowIndex = 1; rowIndex < rows.length; rowIndex += 1) {\n    const row = rows[rowIndex];\n    if (row.length === 0) {\n      continue;\n    }\n    const postedAt = normalizeDate(row[dateIndex] ?? \"\");\n    if (!postedAt) {\n      errors.push(\n        `Row ${rowIndex + 1}: unparseable date \"${row[dateIndex] ?? \"\"}\".`,\n      );\n      continue;\n    }\n    const amount = parseAmount(row, amountIndex, debitIndex, creditIndex);\n    if (!amount) {\n      errors.push(`Row ${rowIndex + 1}: unparseable amount.`);\n      continue;\n    }\n    const merchantRaw = (row[merchantIndex] ?? \"\").trim();\n    if (!merchantRaw) {\n      errors.push(`Row ${rowIndex + 1}: empty merchant.`);\n      continue;\n    }\n    const description =\n      descriptionIndex >= 0 ? (row[descriptionIndex] ?? \"\").trim() : \"\";\n    const category =\n      categoryIndex >= 0 ? (row[categoryIndex] ?? \"\").trim() : \"\";\n    transactions.push({\n      postedAt,\n      amountUsd: amount.amountUsd,\n      direction: amount.direction,\n      merchantRaw,\n      merchantNormalized: normalizeMerchant(merchantRaw),\n      description: description.length > 0 ? description : null,\n      category: category.length > 0 ? category : null,\n      currency: \"USD\",\n      externalId: null,\n      rowIndex,\n    });\n  }\n\n  return {\n    transactions,\n    rowsRead: rows.length - 1,\n    errors,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/payment-recurrence.d.ts

@@ -0,0 +1,14 @@
+import type { LifeOpsPaymentTransaction, LifeOpsRecurringCharge } from "./payment-types.js";
+/**
+ * Normalize a merchant string for grouping. Strips trailing location/ref
+ * suffixes, collapses whitespace, removes non-alpha noise, lowercases.
+ *
+ * Bank feeds commonly produce variants like:
+ *   - "NETFLIX.COM 866-579-7172 CA"
+ *   - "NETFLIX.COM   #8432"
+ *   - "Netflix Monthly 11.99"
+ * We want all three to collapse to "netflix".
+ */
+export declare function normalizeMerchant(raw: string): string;
+export declare function detectRecurringCharges(transactions: readonly LifeOpsPaymentTransaction[]): LifeOpsRecurringCharge[];
+//# sourceMappingURL=payment-recurrence.d.ts.map

package/dist/payment-recurrence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-recurrence.d.ts","sourceRoot":"","sources":["../src/payment-recurrence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAEzB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAW5B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBrD;AAwID,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,SAAS,yBAAyB,EAAE,GACjD,sBAAsB,EAAE,CAiF1B"}

package/dist/payment-recurrence.js

@@ -0,0 +1,190 @@
+const MIN_RECURRENCE_OCCURRENCES = 2;
+const MS_PER_DAY = 864e5;
+function normalizeMerchant(raw) {
+  const trimmed = raw.toLowerCase().replace(/\.(com|co|io|net|org|tv|app)\b/g, " ").replace(/\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g, " ").replace(/#\s*\d+/g, " ").replace(/\bpos\b/g, " ").replace(/\$?\d+(?:\.\d{2})?/g, " ").replace(/\b(ca|ny|tx|fl|wa|il|us|usa)\b/g, " ").replace(/[^a-z]+/g, " ").replace(/\s+/g, " ").trim();
+  return trimmed.split(" ").slice(0, 3).join(" ");
+}
+function humanizeMerchant(normalized) {
+  return normalized.split(" ").filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+function daysBetween(a, b) {
+  const aMs = Date.parse(a);
+  const bMs = Date.parse(b);
+  if (!Number.isFinite(aMs) || !Number.isFinite(bMs)) {
+    return Number.NaN;
+  }
+  return Math.abs(bMs - aMs) / MS_PER_DAY;
+}
+function mean(values) {
+  if (values.length === 0) {
+    return 0;
+  }
+  let total = 0;
+  for (const value of values) {
+    total += value;
+  }
+  return total / values.length;
+}
+function stddev(values, avg) {
+  if (values.length === 0) {
+    return 0;
+  }
+  let sum = 0;
+  for (const value of values) {
+    const diff = value - avg;
+    sum += diff * diff;
+  }
+  return Math.sqrt(sum / values.length);
+}
+function classifyCadence(avgIntervalDays) {
+  if (avgIntervalDays >= 5 && avgIntervalDays <= 9) return "weekly";
+  if (avgIntervalDays >= 12 && avgIntervalDays <= 16) return "biweekly";
+  if (avgIntervalDays >= 25 && avgIntervalDays <= 35) return "monthly";
+  if (avgIntervalDays >= 85 && avgIntervalDays <= 95) return "quarterly";
+  if (avgIntervalDays >= 350 && avgIntervalDays <= 380) return "annual";
+  return "irregular";
+}
+function cadenceMultiplier(cadence) {
+  switch (cadence) {
+    case "weekly":
+      return 52;
+    case "biweekly":
+      return 26;
+    case "monthly":
+      return 12;
+    case "quarterly":
+      return 4;
+    case "annual":
+      return 1;
+    case "irregular":
+      return 0;
+  }
+}
+function detectInterval(sortedPostedAts) {
+  if (sortedPostedAts.length < MIN_RECURRENCE_OCCURRENCES) {
+    return null;
+  }
+  const intervals = [];
+  for (let index = 1; index < sortedPostedAts.length; index += 1) {
+    const days = daysBetween(
+      sortedPostedAts[index - 1],
+      sortedPostedAts[index]
+    );
+    if (Number.isFinite(days)) {
+      intervals.push(days);
+    }
+  }
+  if (intervals.length === 0) {
+    return null;
+  }
+  const avg = mean(intervals);
+  const dev = stddev(intervals, avg);
+  const cadence = classifyCadence(avg);
+  return { cadence, avgIntervalDays: avg, stddevDays: dev };
+}
+function amountSimilarity(amounts) {
+  if (amounts.length === 0) {
+    return 0;
+  }
+  const avg = mean(amounts);
+  if (avg === 0) {
+    return 0;
+  }
+  const dev = stddev(amounts, avg);
+  const ratio = dev / Math.abs(avg);
+  return Math.max(0, Math.min(1, 1 - ratio));
+}
+function confidenceScore(args) {
+  const cadenceBoost = args.cadence === "irregular" ? 0.2 : 0.55;
+  const occurrenceBoost = Math.min(0.25, args.occurrenceCount * 0.04);
+  const intervalConsistency = args.avgIntervalDays > 0 ? Math.max(0, 1 - args.intervalStddev / args.avgIntervalDays) : 0;
+  const intervalBoost = intervalConsistency * 0.1;
+  const amountBoost = args.amountSimilarity * 0.1;
+  return Math.min(
+    0.99,
+    cadenceBoost + occurrenceBoost + intervalBoost + amountBoost
+  );
+}
+function addDaysIso(value, days) {
+  const ms = Date.parse(value);
+  if (!Number.isFinite(ms)) {
+    return value;
+  }
+  return new Date(ms + days * MS_PER_DAY).toISOString();
+}
+function detectRecurringCharges(transactions) {
+  const debits = transactions.filter(
+    (transaction) => transaction.direction === "debit"
+  );
+  const groups = /* @__PURE__ */ new Map();
+  for (const transaction of debits) {
+    const existing = groups.get(transaction.merchantNormalized);
+    if (existing) {
+      existing.push(transaction);
+    } else {
+      groups.set(transaction.merchantNormalized, [transaction]);
+    }
+  }
+  const charges = [];
+  for (const [merchant, group] of groups) {
+    if (!merchant || group.length < MIN_RECURRENCE_OCCURRENCES) {
+      continue;
+    }
+    const sorted = [...group].sort(
+      (a, b) => a.postedAt.localeCompare(b.postedAt)
+    );
+    const postedAts = sorted.map((transaction) => transaction.postedAt);
+    const interval = detectInterval(postedAts);
+    if (!interval) {
+      continue;
+    }
+    const amounts = sorted.map(
+      (transaction) => Math.abs(transaction.amountUsd)
+    );
+    const avgAmount = mean(amounts);
+    const lastAmount = amounts[amounts.length - 1] ?? 0;
+    const similarity = amountSimilarity(amounts);
+    if (interval.cadence === "irregular" && similarity < 0.7) {
+      continue;
+    }
+    const multiplier = cadenceMultiplier(interval.cadence);
+    const confidence = confidenceScore({
+      occurrenceCount: group.length,
+      cadence: interval.cadence,
+      intervalStddev: interval.stddevDays,
+      avgIntervalDays: interval.avgIntervalDays,
+      amountSimilarity: similarity
+    });
+    const latestSeenAt = postedAts[postedAts.length - 1];
+    const nextExpectedAt = interval.cadence === "irregular" ? null : addDaysIso(latestSeenAt, interval.avgIntervalDays);
+    const sourceIds = Array.from(
+      new Set(sorted.map((transaction) => transaction.sourceId))
+    );
+    const sampleTransactionIds = sorted.slice(-5).map((transaction) => transaction.id);
+    const category = sorted.find((transaction) => transaction.category)?.category ?? null;
+    const display = sorted[sorted.length - 1]?.merchantRaw?.trim() || humanizeMerchant(merchant);
+    charges.push({
+      merchantNormalized: merchant,
+      merchantDisplay: display,
+      cadence: interval.cadence,
+      averageAmountUsd: Number(avgAmount.toFixed(2)),
+      lastAmountUsd: Number(lastAmount.toFixed(2)),
+      annualizedCostUsd: Number((avgAmount * multiplier).toFixed(2)),
+      occurrenceCount: group.length,
+      firstSeenAt: postedAts[0],
+      latestSeenAt,
+      nextExpectedAt,
+      sourceIds,
+      sampleTransactionIds,
+      confidence,
+      category
+    });
+  }
+  charges.sort((a, b) => b.annualizedCostUsd - a.annualizedCostUsd);
+  return charges;
+}
+export {
+  detectRecurringCharges,
+  normalizeMerchant
+};
+//# sourceMappingURL=payment-recurrence.js.map

package/dist/payment-recurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/payment-recurrence.ts"],"sourcesContent":["import type {\n  LifeOpsPaymentTransaction,\n  LifeOpsRecurringCadence,\n  LifeOpsRecurringCharge,\n} from \"./payment-types.js\";\n\nconst MIN_RECURRENCE_OCCURRENCES = 2;\nconst MS_PER_DAY = 86_400_000;\n\ninterface IntervalMatch {\n  cadence: LifeOpsRecurringCadence;\n  avgIntervalDays: number;\n  stddevDays: number;\n}\n\n/**\n * Normalize a merchant string for grouping. Strips trailing location/ref\n * suffixes, collapses whitespace, removes non-alpha noise, lowercases.\n *\n * Bank feeds commonly produce variants like:\n *   - \"NETFLIX.COM 866-579-7172 CA\"\n *   - \"NETFLIX.COM   #8432\"\n *   - \"Netflix Monthly 11.99\"\n * We want all three to collapse to \"netflix\".\n */\nexport function normalizeMerchant(raw: string): string {\n  const trimmed = raw\n    .toLowerCase()\n    // Strip common URL TLDs: \".com\", \".co\", \".io\", \".net\", \".org\"\n    .replace(/\\.(com|co|io|net|org|tv|app)\\b/g, \" \")\n    // Drop phone numbers\n    .replace(/\\b\\d{3}[-.]?\\d{3}[-.]?\\d{4}\\b/g, \" \")\n    // Drop reference-style \"#12345\" or \"POS 12345\"\n    .replace(/#\\s*\\d+/g, \" \")\n    .replace(/\\bpos\\b/g, \" \")\n    // Drop dollar-ish amounts that sometimes leak into descriptions\n    .replace(/\\$?\\d+(?:\\.\\d{2})?/g, \" \")\n    // Drop state codes and common noise\n    .replace(/\\b(ca|ny|tx|fl|wa|il|us|usa)\\b/g, \" \")\n    // Collapse non-alpha to space\n    .replace(/[^a-z]+/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim();\n  // Keep first 3 tokens max — that's almost always the brand identity.\n  return trimmed.split(\" \").slice(0, 3).join(\" \");\n}\n\nfunction humanizeMerchant(normalized: string): string {\n  return normalized\n    .split(\" \")\n    .filter(Boolean)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\nfunction daysBetween(a: string, b: string): number {\n  const aMs = Date.parse(a);\n  const bMs = Date.parse(b);\n  if (!Number.isFinite(aMs) || !Number.isFinite(bMs)) {\n    return Number.NaN;\n  }\n  return Math.abs(bMs - aMs) / MS_PER_DAY;\n}\n\nfunction mean(values: readonly number[]): number {\n  if (values.length === 0) {\n    return 0;\n  }\n  let total = 0;\n  for (const value of values) {\n    total += value;\n  }\n  return total / values.length;\n}\n\nfunction stddev(values: readonly number[], avg: number): number {\n  if (values.length === 0) {\n    return 0;\n  }\n  let sum = 0;\n  for (const value of values) {\n    const diff = value - avg;\n    sum += diff * diff;\n  }\n  return Math.sqrt(sum / values.length);\n}\n\nfunction classifyCadence(avgIntervalDays: number): LifeOpsRecurringCadence {\n  if (avgIntervalDays >= 5 && avgIntervalDays <= 9) return \"weekly\";\n  if (avgIntervalDays >= 12 && avgIntervalDays <= 16) return \"biweekly\";\n  if (avgIntervalDays >= 25 && avgIntervalDays <= 35) return \"monthly\";\n  if (avgIntervalDays >= 85 && avgIntervalDays <= 95) return \"quarterly\";\n  if (avgIntervalDays >= 350 && avgIntervalDays <= 380) return \"annual\";\n  return \"irregular\";\n}\n\nfunction cadenceMultiplier(cadence: LifeOpsRecurringCadence): number {\n  switch (cadence) {\n    case \"weekly\":\n      return 52;\n    case \"biweekly\":\n      return 26;\n    case \"monthly\":\n      return 12;\n    case \"quarterly\":\n      return 4;\n    case \"annual\":\n      return 1;\n    case \"irregular\":\n      return 0;\n  }\n}\n\nfunction detectInterval(\n  sortedPostedAts: readonly string[],\n): IntervalMatch | null {\n  if (sortedPostedAts.length < MIN_RECURRENCE_OCCURRENCES) {\n    return null;\n  }\n  const intervals: number[] = [];\n  for (let index = 1; index < sortedPostedAts.length; index += 1) {\n    const days = daysBetween(\n      sortedPostedAts[index - 1],\n      sortedPostedAts[index],\n    );\n    if (Number.isFinite(days)) {\n      intervals.push(days);\n    }\n  }\n  if (intervals.length === 0) {\n    return null;\n  }\n  const avg = mean(intervals);\n  const dev = stddev(intervals, avg);\n  const cadence = classifyCadence(avg);\n  return { cadence, avgIntervalDays: avg, stddevDays: dev };\n}\n\nfunction amountSimilarity(amounts: readonly number[]): number {\n  if (amounts.length === 0) {\n    return 0;\n  }\n  const avg = mean(amounts);\n  if (avg === 0) {\n    return 0;\n  }\n  const dev = stddev(amounts, avg);\n  const ratio = dev / Math.abs(avg);\n  // Perfect similarity (0 dev) → 1. Ratio of 0.25 → ~0.5. Ratio ≥ 1 → 0.\n  return Math.max(0, Math.min(1, 1 - ratio));\n}\n\nfunction confidenceScore(args: {\n  occurrenceCount: number;\n  cadence: LifeOpsRecurringCadence;\n  intervalStddev: number;\n  avgIntervalDays: number;\n  amountSimilarity: number;\n}): number {\n  const cadenceBoost = args.cadence === \"irregular\" ? 0.2 : 0.55;\n  const occurrenceBoost = Math.min(0.25, args.occurrenceCount * 0.04);\n  const intervalConsistency =\n    args.avgIntervalDays > 0\n      ? Math.max(0, 1 - args.intervalStddev / args.avgIntervalDays)\n      : 0;\n  const intervalBoost = intervalConsistency * 0.1;\n  const amountBoost = args.amountSimilarity * 0.1;\n  return Math.min(\n    0.99,\n    cadenceBoost + occurrenceBoost + intervalBoost + amountBoost,\n  );\n}\n\nfunction addDaysIso(value: string, days: number): string {\n  const ms = Date.parse(value);\n  if (!Number.isFinite(ms)) {\n    return value;\n  }\n  return new Date(ms + days * MS_PER_DAY).toISOString();\n}\n\nexport function detectRecurringCharges(\n  transactions: readonly LifeOpsPaymentTransaction[],\n): LifeOpsRecurringCharge[] {\n  const debits = transactions.filter(\n    (transaction) => transaction.direction === \"debit\",\n  );\n  const groups = new Map<string, LifeOpsPaymentTransaction[]>();\n  for (const transaction of debits) {\n    const existing = groups.get(transaction.merchantNormalized);\n    if (existing) {\n      existing.push(transaction);\n    } else {\n      groups.set(transaction.merchantNormalized, [transaction]);\n    }\n  }\n\n  const charges: LifeOpsRecurringCharge[] = [];\n  for (const [merchant, group] of groups) {\n    if (!merchant || group.length < MIN_RECURRENCE_OCCURRENCES) {\n      continue;\n    }\n    const sorted = [...group].sort((a, b) =>\n      a.postedAt.localeCompare(b.postedAt),\n    );\n    const postedAts = sorted.map((transaction) => transaction.postedAt);\n    const interval = detectInterval(postedAts);\n    if (!interval) {\n      continue;\n    }\n    const amounts = sorted.map((transaction) =>\n      Math.abs(transaction.amountUsd),\n    );\n    const avgAmount = mean(amounts);\n    const lastAmount = amounts[amounts.length - 1] ?? 0;\n    const similarity = amountSimilarity(amounts);\n    if (interval.cadence === \"irregular\" && similarity < 0.7) {\n      // Skip non-recurring merchants that only happen to hit multiple times\n      // with different amounts (e.g. Amazon purchases).\n      continue;\n    }\n    const multiplier = cadenceMultiplier(interval.cadence);\n    const confidence = confidenceScore({\n      occurrenceCount: group.length,\n      cadence: interval.cadence,\n      intervalStddev: interval.stddevDays,\n      avgIntervalDays: interval.avgIntervalDays,\n      amountSimilarity: similarity,\n    });\n    const latestSeenAt = postedAts[postedAts.length - 1];\n    const nextExpectedAt =\n      interval.cadence === \"irregular\"\n        ? null\n        : addDaysIso(latestSeenAt, interval.avgIntervalDays);\n    const sourceIds = Array.from(\n      new Set(sorted.map((transaction) => transaction.sourceId)),\n    );\n    const sampleTransactionIds = sorted\n      .slice(-5)\n      .map((transaction) => transaction.id);\n    const category =\n      sorted.find((transaction) => transaction.category)?.category ?? null;\n    const display =\n      sorted[sorted.length - 1]?.merchantRaw?.trim() ||\n      humanizeMerchant(merchant);\n    charges.push({\n      merchantNormalized: merchant,\n      merchantDisplay: display,\n      cadence: interval.cadence,\n      averageAmountUsd: Number(avgAmount.toFixed(2)),\n      lastAmountUsd: Number(lastAmount.toFixed(2)),\n      annualizedCostUsd: Number((avgAmount * multiplier).toFixed(2)),\n      occurrenceCount: group.length,\n      firstSeenAt: postedAts[0],\n      latestSeenAt,\n      nextExpectedAt,\n      sourceIds,\n      sampleTransactionIds,\n      confidence,\n      category,\n    });\n  }\n  charges.sort((a, b) => b.annualizedCostUsd - a.annualizedCostUsd);\n  return charges;\n}\n"],"mappings":"AAMA,MAAM,6BAA6B;AACnC,MAAM,aAAa;AAkBZ,SAAS,kBAAkB,KAAqB;AACrD,QAAM,UAAU,IACb,YAAY,EAEZ,QAAQ,mCAAmC,GAAG,EAE9C,QAAQ,kCAAkC,GAAG,EAE7C,QAAQ,YAAY,GAAG,EACvB,QAAQ,YAAY,GAAG,EAEvB,QAAQ,uBAAuB,GAAG,EAElC,QAAQ,mCAAmC,GAAG,EAE9C,QAAQ,YAAY,GAAG,EACvB,QAAQ,QAAQ,GAAG,EACnB,KAAK;AAER,SAAO,QAAQ,MAAM,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG;AAChD;AAEA,SAAS,iBAAiB,YAA4B;AACpD,SAAO,WACJ,MAAM,GAAG,EACT,OAAO,OAAO,EACd,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,EAC1D,KAAK,GAAG;AACb;AAEA,SAAS,YAAY,GAAW,GAAmB;AACjD,QAAM,MAAM,KAAK,MAAM,CAAC;AACxB,QAAM,MAAM,KAAK,MAAM,CAAC;AACxB,MAAI,CAAC,OAAO,SAAS,GAAG,KAAK,CAAC,OAAO,SAAS,GAAG,GAAG;AAClD,WAAO,OAAO;AAAA,EAChB;AACA,SAAO,KAAK,IAAI,MAAM,GAAG,IAAI;AAC/B;AAEA,SAAS,KAAK,QAAmC;AAC/C,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ;AACZ,aAAW,SAAS,QAAQ;AAC1B,aAAS;AAAA,EACX;AACA,SAAO,QAAQ,OAAO;AACxB;AAEA,SAAS,OAAO,QAA2B,KAAqB;AAC9D,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO;AAAA,EACT;AACA,MAAI,MAAM;AACV,aAAW,SAAS,QAAQ;AAC1B,UAAM,OAAO,QAAQ;AACrB,WAAO,OAAO;AAAA,EAChB;AACA,SAAO,KAAK,KAAK,MAAM,OAAO,MAAM;AACtC;AAEA,SAAS,gBAAgB,iBAAkD;AACzE,MAAI,mBAAmB,KAAK,mBAAmB,EAAG,QAAO;AACzD,MAAI,mBAAmB,MAAM,mBAAmB,GAAI,QAAO;AAC3D,MAAI,mBAAmB,MAAM,mBAAmB,GAAI,QAAO;AAC3D,MAAI,mBAAmB,MAAM,mBAAmB,GAAI,QAAO;AAC3D,MAAI,mBAAmB,OAAO,mBAAmB,IAAK,QAAO;AAC7D,SAAO;AACT;AAEA,SAAS,kBAAkB,SAA0C;AACnE,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;AAEA,SAAS,eACP,iBACsB;AACtB,MAAI,gBAAgB,SAAS,4BAA4B;AACvD,WAAO;AAAA,EACT;AACA,QAAM,YAAsB,CAAC;AAC7B,WAAS,QAAQ,GAAG,QAAQ,gBAAgB,QAAQ,SAAS,GAAG;AAC9D,UAAM,OAAO;AAAA,MACX,gBAAgB,QAAQ,CAAC;AAAA,MACzB,gBAAgB,KAAK;AAAA,IACvB;AACA,QAAI,OAAO,SAAS,IAAI,GAAG;AACzB,gBAAU,KAAK,IAAI;AAAA,IACrB;AAAA,EACF;AACA,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,MAAM,KAAK,SAAS;AAC1B,QAAM,MAAM,OAAO,WAAW,GAAG;AACjC,QAAM,UAAU,gBAAgB,GAAG;AACnC,SAAO,EAAE,SAAS,iBAAiB,KAAK,YAAY,IAAI;AAC1D;AAEA,SAAS,iBAAiB,SAAoC;AAC5D,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AACA,QAAM,MAAM,KAAK,OAAO;AACxB,MAAI,QAAQ,GAAG;AACb,WAAO;AAAA,EACT;AACA,QAAM,MAAM,OAAO,SAAS,GAAG;AAC/B,QAAM,QAAQ,MAAM,KAAK,IAAI,GAAG;AAEhC,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,KAAK,CAAC;AAC3C;AAEA,SAAS,gBAAgB,MAMd;AACT,QAAM,eAAe,KAAK,YAAY,cAAc,MAAM;AAC1D,QAAM,kBAAkB,KAAK,IAAI,MAAM,KAAK,kBAAkB,IAAI;AAClE,QAAM,sBACJ,KAAK,kBAAkB,IACnB,KAAK,IAAI,GAAG,IAAI,KAAK,iBAAiB,KAAK,eAAe,IAC1D;AACN,QAAM,gBAAgB,sBAAsB;AAC5C,QAAM,cAAc,KAAK,mBAAmB;AAC5C,SAAO,KAAK;AAAA,IACV;AAAA,IACA,eAAe,kBAAkB,gBAAgB;AAAA,EACnD;AACF;AAEA,SAAS,WAAW,OAAe,MAAsB;AACvD,QAAM,KAAK,KAAK,MAAM,KAAK;AAC3B,MAAI,CAAC,OAAO,SAAS,EAAE,GAAG;AACxB,WAAO;AAAA,EACT;AACA,SAAO,IAAI,KAAK,KAAK,OAAO,UAAU,EAAE,YAAY;AACtD;AAEO,SAAS,uBACd,cAC0B;AAC1B,QAAM,SAAS,aAAa;AAAA,IAC1B,CAAC,gBAAgB,YAAY,cAAc;AAAA,EAC7C;AACA,QAAM,SAAS,oBAAI,IAAyC;AAC5D,aAAW,eAAe,QAAQ;AAChC,UAAM,WAAW,OAAO,IAAI,YAAY,kBAAkB;AAC1D,QAAI,UAAU;AACZ,eAAS,KAAK,WAAW;AAAA,IAC3B,OAAO;AACL,aAAO,IAAI,YAAY,oBAAoB,CAAC,WAAW,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,UAAoC,CAAC;AAC3C,aAAW,CAAC,UAAU,KAAK,KAAK,QAAQ;AACtC,QAAI,CAAC,YAAY,MAAM,SAAS,4BAA4B;AAC1D;AAAA,IACF;AACA,UAAM,SAAS,CAAC,GAAG,KAAK,EAAE;AAAA,MAAK,CAAC,GAAG,MACjC,EAAE,SAAS,cAAc,EAAE,QAAQ;AAAA,IACrC;AACA,UAAM,YAAY,OAAO,IAAI,CAAC,gBAAgB,YAAY,QAAQ;AAClE,UAAM,WAAW,eAAe,SAAS;AACzC,QAAI,CAAC,UAAU;AACb;AAAA,IACF;AACA,UAAM,UAAU,OAAO;AAAA,MAAI,CAAC,gBAC1B,KAAK,IAAI,YAAY,SAAS;AAAA,IAChC;AACA,UAAM,YAAY,KAAK,OAAO;AAC9B,UAAM,aAAa,QAAQ,QAAQ,SAAS,CAAC,KAAK;AAClD,UAAM,aAAa,iBAAiB,OAAO;AAC3C,QAAI,SAAS,YAAY,eAAe,aAAa,KAAK;AAGxD;AAAA,IACF;AACA,UAAM,aAAa,kBAAkB,SAAS,OAAO;AACrD,UAAM,aAAa,gBAAgB;AAAA,MACjC,iBAAiB,MAAM;AAAA,MACvB,SAAS,SAAS;AAAA,MAClB,gBAAgB,SAAS;AAAA,MACzB,iBAAiB,SAAS;AAAA,MAC1B,kBAAkB;AAAA,IACpB,CAAC;AACD,UAAM,eAAe,UAAU,UAAU,SAAS,CAAC;AACnD,UAAM,iBACJ,SAAS,YAAY,cACjB,OACA,WAAW,cAAc,SAAS,eAAe;AACvD,UAAM,YAAY,MAAM;AAAA,MACtB,IAAI,IAAI,OAAO,IAAI,CAAC,gBAAgB,YAAY,QAAQ,CAAC;AAAA,IAC3D;AACA,UAAM,uBAAuB,OAC1B,MAAM,EAAE,EACR,IAAI,CAAC,gBAAgB,YAAY,EAAE;AACtC,UAAM,WACJ,OAAO,KAAK,CAAC,gBAAgB,YAAY,QAAQ,GAAG,YAAY;AAClE,UAAM,UACJ,OAAO,OAAO,SAAS,CAAC,GAAG,aAAa,KAAK,KAC7C,iBAAiB,QAAQ;AAC3B,YAAQ,KAAK;AAAA,MACX,oBAAoB;AAAA,MACpB,iBAAiB;AAAA,MACjB,SAAS,SAAS;AAAA,MAClB,kBAAkB,OAAO,UAAU,QAAQ,CAAC,CAAC;AAAA,MAC7C,eAAe,OAAO,WAAW,QAAQ,CAAC,CAAC;AAAA,MAC3C,mBAAmB,QAAQ,YAAY,YAAY,QAAQ,CAAC,CAAC;AAAA,MAC7D,iBAAiB,MAAM;AAAA,MACvB,aAAa,UAAU,CAAC;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,UAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,oBAAoB,EAAE,iBAAiB;AAChE,SAAO;AACT;","names":[]}

package/dist/payment-types.d.ts

@@ -0,0 +1,158 @@
+export type LifeOpsPaymentSourceKind = "csv" | "plaid" | "manual" | "paypal" | "email";
+export type LifeOpsPaymentSourceStatus = "active" | "disconnected" | "needs_attention";
+export interface LifeOpsPaymentSource {
+    id: string;
+    agentId: string;
+    kind: LifeOpsPaymentSourceKind;
+    label: string;
+    institution: string | null;
+    accountMask: string | null;
+    status: LifeOpsPaymentSourceStatus;
+    lastSyncedAt: string | null;
+    transactionCount: number;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export type LifeOpsPaymentDirection = "debit" | "credit";
+export interface LifeOpsPaymentTransaction {
+    id: string;
+    agentId: string;
+    sourceId: string;
+    externalId: string | null;
+    postedAt: string;
+    amountUsd: number;
+    direction: LifeOpsPaymentDirection;
+    merchantRaw: string;
+    merchantNormalized: string;
+    description: string | null;
+    category: string | null;
+    currency: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export type LifeOpsRecurringCadence = "weekly" | "biweekly" | "monthly" | "quarterly" | "annual" | "irregular";
+export interface LifeOpsRecurringCharge {
+    merchantNormalized: string;
+    merchantDisplay: string;
+    cadence: LifeOpsRecurringCadence;
+    averageAmountUsd: number;
+    lastAmountUsd: number;
+    annualizedCostUsd: number;
+    occurrenceCount: number;
+    firstSeenAt: string;
+    latestSeenAt: string;
+    nextExpectedAt: string | null;
+    sourceIds: string[];
+    sampleTransactionIds: string[];
+    confidence: number;
+    category: string | null;
+}
+export interface LifeOpsSpendingCategoryBreakdown {
+    category: string;
+    totalUsd: number;
+    transactionCount: number;
+}
+export interface LifeOpsSpendingSummary {
+    windowDays: number;
+    fromDate: string;
+    toDate: string;
+    totalSpendUsd: number;
+    totalIncomeUsd: number;
+    netUsd: number;
+    transactionCount: number;
+    recurringSpendUsd: number;
+    topCategories: LifeOpsSpendingCategoryBreakdown[];
+    topMerchants: Array<{
+        merchantNormalized: string;
+        merchantDisplay: string;
+        totalUsd: number;
+        transactionCount: number;
+    }>;
+}
+export interface LifeOpsRecurringChargePlaybookHit {
+    merchantNormalized: string;
+    playbookKey: string;
+    serviceName: string;
+    managementUrl: string;
+    executorPreference: "user_browser" | "agent_browser" | "desktop_native";
+}
+/**
+ * A bill detected from email (or other source) and surfaced on the Money
+ * dashboard. Backed by a `life_payment_transactions` row whose
+ * `source.kind === "email"` and whose metadata carries bill-specific data.
+ */
+export type LifeOpsUpcomingBillStatus = "upcoming" | "overdue" | "needs_due_date";
+export interface LifeOpsUpcomingBill {
+    id: string;
+    merchant: string;
+    amountUsd: number;
+    currency: string;
+    dueDate: string | null;
+    status: LifeOpsUpcomingBillStatus;
+    postedAt: string;
+    sourceMessageId: string | null;
+    confidence: number;
+}
+export interface LifeOpsPaymentsDashboard {
+    sources: LifeOpsPaymentSource[];
+    recurring: LifeOpsRecurringCharge[];
+    /**
+     * For every recurring charge whose merchant matches a known cancellation
+     * playbook (Netflix, Spotify, NYT, etc.), this map carries the playbook
+     * descriptor. UI shows a deep-link "Cancel" button only when there is a hit.
+     */
+    recurringPlaybookHits: LifeOpsRecurringChargePlaybookHit[];
+    spending: LifeOpsSpendingSummary;
+    /**
+     * Bills extracted from email-classified messages. Includes upcoming bills,
+     * overdue bills, and bills that need a reviewed due date.
+     */
+    upcomingBills: LifeOpsUpcomingBill[];
+    gmailSubscriptionAuditId: string | null;
+    generatedAt: string;
+}
+export interface AddPaymentSourceRequest {
+    kind: LifeOpsPaymentSourceKind;
+    label: string;
+    institution?: string | null;
+    accountMask?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ImportTransactionsCsvRequest {
+    sourceId: string;
+    csvText: string;
+    /** Optional column hints; auto-detected when absent. */
+    dateColumn?: string;
+    amountColumn?: string;
+    merchantColumn?: string;
+    descriptionColumn?: string;
+    categoryColumn?: string;
+}
+export interface ImportTransactionsCsvResult {
+    sourceId: string;
+    rowsRead: number;
+    inserted: number;
+    skipped: number;
+    errors: string[];
+}
+export interface ListTransactionsRequest {
+    sourceId?: string | null;
+    sinceAt?: string | null;
+    untilAt?: string | null;
+    limit?: number | null;
+    merchantContains?: string | null;
+    onlyDebits?: boolean | null;
+}
+export interface SpendingSummaryRequest {
+    windowDays?: number | null;
+    sourceId?: string | null;
+}
+export type LifeOpsMoneyDashboard = LifeOpsPaymentsDashboard;
+export type LifeOpsMoneySource = LifeOpsPaymentSource;
+export type LifeOpsMoneySourceKind = LifeOpsPaymentSourceKind;
+export type LifeOpsMoneySourceStatus = LifeOpsPaymentSourceStatus;
+export type LifeOpsMoneyTransaction = LifeOpsPaymentTransaction;
+export type LifeOpsMoneyDirection = LifeOpsPaymentDirection;
+export type AddMoneySourceRequest = AddPaymentSourceRequest;
+//# sourceMappingURL=payment-types.d.ts.map

package/dist/payment-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-types.d.ts","sourceRoot":"","sources":["../src/payment-types.ts"],"names":[],"mappings":"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"}

package/dist/payment-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=payment-types.js.map

package/dist/payment-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/plugin.d.ts

@@ -0,0 +1,15 @@
+/**
+ * elizaOS runtime plugin for the Finances overlay app.
+ *
+ * Hosts the OWNER_FINANCES action (stub during migration) and the
+ * `/finances` view that renders the owner finance dashboard.
+ *
+ * The drizzle schema (`pgSchema("app_finances")`) is registered via the
+ * Plugin `schema` field so the elizaOS runtime handles migrations. Loading
+ * this plugin requires @elizaos/plugin-sql (declared as a peer dep and listed
+ * in `dependencies`).
+ */
+import type { Plugin } from "@elizaos/core";
+export declare const financesPlugin: Plugin;
+export default financesPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAM5C,eAAO,MAAM,cAAc,EAAE,MAuB5B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,31 @@
+import { financesDbSchema } from "./db/schema.js";
+import { FinancesMigrationService } from "./services/migration.js";
+const FINANCES_APP_NAME = "@elizaos/plugin-finances";
+const financesPlugin = {
+  name: FINANCES_APP_NAME,
+  description: "Owner finance overlay: dashboard, transactions, recurring charges, and the /finances view. Owns the FinancesService / FinancesRepository payments back-end (sources, CSV import, transactions, spending, recurring charges, email bills, Plaid / PayPal bridges). The OWNER_FINANCES umbrella action + the /api/lifeops/money/* routes are registered by @elizaos/plugin-personal-assistant, which delegates the payments back-end here. Backed by drizzle pgSchema('app_finances'); requires @elizaos/plugin-sql.",
+  dependencies: ["@elizaos/plugin-sql"],
+  services: [FinancesMigrationService],
+  schema: financesDbSchema,
+  views: [
+    {
+      id: "finances",
+      label: "Finances",
+      description: "Owner finance dashboard \u2014 balance, transactions, recurring charges",
+      icon: "Wallet",
+      path: "/finances",
+      modalities: ["gui", "xr", "tui"],
+      bundlePath: "dist/views/bundle.js",
+      componentExport: "FinancesView",
+      tags: ["finances", "owner", "money"],
+      visibleInManager: true,
+      desktopTabEnabled: true
+    }
+  ]
+};
+var plugin_default = financesPlugin;
+export {
+  plugin_default as default,
+  financesPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * elizaOS runtime plugin for the Finances overlay app.\n *\n * Hosts the OWNER_FINANCES action (stub during migration) and the\n * `/finances` view that renders the owner finance dashboard.\n *\n * The drizzle schema (`pgSchema(\"app_finances\")`) is registered via the\n * Plugin `schema` field so the elizaOS runtime handles migrations. Loading\n * this plugin requires @elizaos/plugin-sql (declared as a peer dep and listed\n * in `dependencies`).\n */\n\nimport type { Plugin } from \"@elizaos/core\";\nimport { financesDbSchema } from \"./db/schema.js\";\nimport { FinancesMigrationService } from \"./services/migration.js\";\n\nconst FINANCES_APP_NAME = \"@elizaos/plugin-finances\";\n\nexport const financesPlugin: Plugin = {\n  name: FINANCES_APP_NAME,\n  description:\n    \"Owner finance overlay: dashboard, transactions, recurring charges, and the /finances view. Owns the FinancesService / FinancesRepository payments back-end (sources, CSV import, transactions, spending, recurring charges, email bills, Plaid / PayPal bridges). The OWNER_FINANCES umbrella action + the /api/lifeops/money/* routes are registered by @elizaos/plugin-personal-assistant, which delegates the payments back-end here. Backed by drizzle pgSchema('app_finances'); requires @elizaos/plugin-sql.\",\n  dependencies: [\"@elizaos/plugin-sql\"],\n  services: [FinancesMigrationService],\n  schema: financesDbSchema,\n  views: [\n    {\n      id: \"finances\",\n      label: \"Finances\",\n      description:\n        \"Owner finance dashboard — balance, transactions, recurring charges\",\n      icon: \"Wallet\",\n      path: \"/finances\",\n      modalities: [\"gui\", \"xr\", \"tui\"],\n      bundlePath: \"dist/views/bundle.js\",\n      componentExport: \"FinancesView\",\n      tags: [\"finances\", \"owner\", \"money\"],\n      visibleInManager: true,\n      desktopTabEnabled: true,\n    },\n  ],\n};\n\nexport default financesPlugin;\n"],"mappings":"AAaA,SAAS,wBAAwB;AACjC,SAAS,gCAAgC;AAEzC,MAAM,oBAAoB;AAEnB,MAAM,iBAAyB;AAAA,EACpC,MAAM;AAAA,EACN,aACE;AAAA,EACF,cAAc,CAAC,qBAAqB;AAAA,EACpC,UAAU,CAAC,wBAAwB;AAAA,EACnC,QAAQ;AAAA,EACR,OAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,MAAM;AAAA,MACN,MAAM;AAAA,MACN,YAAY,CAAC,OAAO,MAAM,KAAK;AAAA,MAC/B,YAAY;AAAA,MACZ,iBAAiB;AAAA,MACjB,MAAM,CAAC,YAAY,SAAS,OAAO;AAAA,MACnC,kBAAkB;AAAA,MAClB,mBAAmB;AAAA,IACrB;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/register-terminal-view.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Register the finances view for terminal rendering.
+ *
+ * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal
+ * registry. This makes the finances `tui` modality render for real in the
+ * terminal (the unified {@link FinancesSpatialView}) rather than only navigating
+ * a GUI shell. A module-level snapshot lets a host push live dashboard data;
+ * absent a push it defaults to the loading state.
+ */
+import { type FinancesSnapshot } from "./components/finances/FinancesSpatialView.js";
+/** Update the snapshot the registered terminal view renders from. */
+export declare function setFinancesTerminalSnapshot(next: FinancesSnapshot): void;
+/** Register the finances terminal view; returns an unregister function. */
+export declare function registerFinancesTerminalView(): () => void;
+//# sourceMappingURL=register-terminal-view.d.ts.map

package/dist/register-terminal-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-terminal-view.d.ts","sourceRoot":"","sources":["../src/register-terminal-view.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,+CAA+C,CAAC;AAIvD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,4BAA4B,IAAI,MAAM,IAAI,CAIzD"}

package/dist/register-terminal-view.js

@@ -0,0 +1,21 @@
+import { registerSpatialTerminalView } from "@elizaos/ui/spatial/tui";
+import { createElement } from "react";
+import {
+  EMPTY_FINANCES_SNAPSHOT,
+  FinancesSpatialView
+} from "./components/finances/FinancesSpatialView.js";
+let current = EMPTY_FINANCES_SNAPSHOT;
+function setFinancesTerminalSnapshot(next) {
+  current = next;
+}
+function registerFinancesTerminalView() {
+  return registerSpatialTerminalView(
+    "finances",
+    () => createElement(FinancesSpatialView, { snapshot: current })
+  );
+}
+export {
+  registerFinancesTerminalView,
+  setFinancesTerminalSnapshot
+};
+//# sourceMappingURL=register-terminal-view.js.map

package/dist/register-terminal-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register-terminal-view.tsx"],"sourcesContent":["/**\n * Register the finances view for terminal rendering.\n *\n * The agent terminal mounts plugin views by id from the `@elizaos/tui` terminal\n * registry. This makes the finances `tui` modality render for real in the\n * terminal (the unified {@link FinancesSpatialView}) rather than only navigating\n * a GUI shell. A module-level snapshot lets a host push live dashboard data;\n * absent a push it defaults to the loading state.\n */\n\nimport { registerSpatialTerminalView } from \"@elizaos/ui/spatial/tui\";\nimport { createElement } from \"react\";\nimport {\n  EMPTY_FINANCES_SNAPSHOT,\n  type FinancesSnapshot,\n  FinancesSpatialView,\n} from \"./components/finances/FinancesSpatialView.js\";\n\nlet current: FinancesSnapshot = EMPTY_FINANCES_SNAPSHOT;\n\n/** Update the snapshot the registered terminal view renders from. */\nexport function setFinancesTerminalSnapshot(next: FinancesSnapshot): void {\n  current = next;\n}\n\n/** Register the finances terminal view; returns an unregister function. */\nexport function registerFinancesTerminalView(): () => void {\n  return registerSpatialTerminalView(\"finances\", () =>\n    createElement(FinancesSpatialView, { snapshot: current }),\n  );\n}\n"],"mappings":"AAUA,SAAS,mCAAmC;AAC5C,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EAEA;AAAA,OACK;AAEP,IAAI,UAA4B;AAGzB,SAAS,4BAA4B,MAA8B;AACxE,YAAU;AACZ;AAGO,SAAS,+BAA2C;AACzD,SAAO;AAAA,IAA4B;AAAA,IAAY,MAC7C,cAAc,qBAAqB,EAAE,UAAU,QAAQ,CAAC;AAAA,EAC1D;AACF;","names":[]}

package/dist/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Side-effect entry point — registers the Finances view for terminal rendering.
+ *
+ * In a terminal host (the Node agent, no DOM), register the finances view so it
+ * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine
+ * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave
+ * this a no-op (a DOM is present), so the same import is safe everywhere.
+ */
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/register.js

@@ -0,0 +1,5 @@
+if (typeof window === "undefined") {
+  void import("./register-terminal-view.js").then((m) => m.registerFinancesTerminalView()).catch(() => {
+  });
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts"],"sourcesContent":["/**\n * Side-effect entry point — registers the Finances view for terminal rendering.\n *\n * In a terminal host (the Node agent, no DOM), register the finances view so it\n * renders inline in the terminal. Lazy + DOM-guarded so the terminal engine\n * stays out of browser/mobile bundles. Web, iOS, desktop, and Android leave\n * this a no-op (a DOM is present), so the same import is safe everywhere.\n */\n\nif (typeof window === \"undefined\") {\n  void import(\"./register-terminal-view.js\")\n    .then((m) => m.registerFinancesTerminalView())\n    .catch(() => {\n      // Terminal rendering is best-effort; never block plugin load.\n    });\n}\n"],"mappings":"AASA,IAAI,OAAO,WAAW,aAAa;AACjC,OAAK,OAAO,6BAA6B,EACtC,KAAK,CAAC,MAAM,EAAE,6BAA6B,CAAC,EAC5C,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;","names":[]}

package/dist/services/browser-bridge-seam.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Browser-bridge runtime-service seam for the subscriptions back-end.
+ *
+ * Subscription cancellation drives the user's real Chrome / Safari through the
+ * Agent Browser Bridge companion: it lists connected companions, creates a
+ * browser session from a cancellation playbook, and polls that session's
+ * status. `@elizaos/plugin-browser` owns the contract for this — it exports the
+ * `BrowserBridgeRouteService` interface and the
+ * `BROWSER_BRIDGE_ROUTE_SERVICE_TYPE` ("lifeops_browser_plugin") service type;
+ * a host plugin (today, plugin-personal-assistant) registers the implementor
+ * that persists companions and sessions.
+ *
+ * This module resolves that runtime service by service-type and exposes only
+ * the narrow surface the subscriptions path needs. It carries no dependency on
+ * `@elizaos/plugin-personal-assistant`: the contract lives entirely in
+ * `@elizaos/plugin-browser`, the same way the BrowserService bridge target
+ * resolves it.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type BrowserBridgeCompanionStatus } from "@elizaos/plugin-browser";
+import type { CreateLifeOpsBrowserSessionRequest, LifeOpsBrowserSession } from "@elizaos/plugin-browser/lifeops-session-contracts";
+/**
+ * The browser-bridge surface the subscriptions back-end needs, bound to the
+ * registered `lifeops_browser_plugin` runtime service for the resolved owner.
+ */
+export interface SubscriptionsBrowserGateway {
+    /** Connected + pending Agent Browser Bridge companions for the owner. */
+    listBrowserCompanions(): Promise<BrowserBridgeCompanionStatus[]>;
+    /** Create a browser session that runs the cancellation playbook. */
+    createBrowserSession(request: CreateLifeOpsBrowserSessionRequest): Promise<LifeOpsBrowserSession>;
+    /** Fetch a browser session by id (used to reconcile cancellation status). */
+    getBrowserSession(sessionId: string): Promise<LifeOpsBrowserSession>;
+}
+/**
+ * Build the subscriptions browser gateway bound to a runtime + owner. The owner
+ * entity id is forwarded to the host service so companion + session scoping
+ * matches the owner the finances service resolved.
+ */
+export declare function createSubscriptionsBrowserGateway(runtime: IAgentRuntime, ownerEntityId: string | null): SubscriptionsBrowserGateway;
+//# sourceMappingURL=browser-bridge-seam.d.ts.map

package/dist/services/browser-bridge-seam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-bridge-seam.d.ts","sourceRoot":"","sources":["../../src/services/browser-bridge-seam.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAEL,KAAK,4BAA4B,EAElC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,kCAAkC,EAClC,qBAAqB,EACtB,MAAM,mDAAmD,CAAC;AAG3D;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,qBAAqB,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjE,oEAAoE;IACpE,oBAAoB,CAClB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,6EAA6E;IAC7E,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtE;AAeD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,2BAA2B,CAsB7B"}