Use Dropbox API for Circa file discovery

.env.example

@@ -8,6 +8,8 @@ ODDS_API_BASE_URL=https://api.the-odds-api.com/v4
 ODDS_API_SPORT_KEY=baseball_mlb
 ODDS_API_REGIONS=us
 ODDS_API_MARKETS=batter_home_runs,batter_hits,batter_total_bases,batter_rbis,batter_runs_scored,batter_hits_runs_rbis,pitcher_strikeouts
+DROPBOX_ACCESS_TOKEN=
+CIRCA_DROPBOX_FOLDER_PATH=
 CIRCA_DROPBOX_URL=
 SCAN_REPORT_CHANNEL_ID=
 SCAN_ALERT_CHANNEL_ID=

README.md

@@ -131,7 +131,9 @@ Environment variables for scanner features:
 - `ODDS_API_SPORT_KEY`
 - `ODDS_API_REGIONS`
 - `ODDS_API_MARKETS`
-- `CIRCA_DROPBOX_URL`
+- `DROPBOX_ACCESS_TOKEN`
+- `CIRCA_DROPBOX_FOLDER_PATH`
+- `CIRCA_DROPBOX_URL` (deprecated fallback)
 - `SCAN_REPORT_CHANNEL_ID`
 - `SCAN_ALERT_CHANNEL_ID`
 - `SCAN_MORNING_TIME`

deploy/oracle/roibot.env.example

@@ -8,6 +8,8 @@ ODDS_API_BASE_URL=https://api.the-odds-api.com/v4
 ODDS_API_SPORT_KEY=baseball_mlb
 ODDS_API_REGIONS=us
 ODDS_API_MARKETS=batter_home_runs,batter_hits,batter_total_bases,batter_rbis,batter_runs_scored,batter_hits_runs_rbis,pitcher_strikeouts
+DROPBOX_ACCESS_TOKEN=
+CIRCA_DROPBOX_FOLDER_PATH=
 CIRCA_DROPBOX_URL=
 SCAN_REPORT_CHANNEL_ID=
 SCAN_ALERT_CHANNEL_ID=

package-lock.json

@@ -11,6 +11,7 @@
         "chart.js": "^4.5.0",
         "discord.js": "^14.25.1",
         "dotenv": "^17.2.3",
+        "dropbox": "^10.34.0",
         "pdfjs-dist": "^5.6.205",
         "pg": "^8.16.3",
         "skia-canvas": "^3.0.8",
@@ -470,6 +471,17 @@
         "undici-types": "~7.18.0"
       }
     },
+    "node_modules/@types/node-fetch": {
+      "version": "2.6.13",
+      "resolved": "https://registry.npmjs.org/@types/node-fetch/-/node-fetch-2.6.13.tgz",
+      "integrity": "sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/node": "*",
+        "form-data": "^4.0.4"
+      }
+    },
     "node_modules/@types/ws": {
       "version": "8.18.1",
       "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
@@ -498,6 +510,13 @@
         "node": ">= 14"
       }
     },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "license": "MIT",
+      "peer": true
+    },
     "node_modules/bmp-js": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/bmp-js/-/bmp-js-0.1.0.tgz",
@@ -527,7 +546,6 @@
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
       "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "es-errors": "^1.3.0",
@@ -566,6 +584,19 @@
         "pnpm": ">=8"
       }
     },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/commander": {
       "version": "2.20.3",
       "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
@@ -608,6 +639,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/detect-libc": {
       "version": "2.1.2",
       "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
@@ -672,11 +713,25 @@
         "url": "https://dotenvx.com"
       }
     },
+    "node_modules/dropbox": {
+      "version": "10.34.0",
+      "resolved": "https://registry.npmjs.org/dropbox/-/dropbox-10.34.0.tgz",
+      "integrity": "sha512-5jb5/XzU0fSnq36/hEpwT5/QIep7MgqKuxghEG44xCu7HruOAjPdOb3x0geXv5O/hd0nHpQpWO+r5MjYTpMvJg==",
+      "license": "MIT",
+      "dependencies": {
+        "node-fetch": "^2.6.1"
+      },
+      "engines": {
+        "node": ">=0.10.3"
+      },
+      "peerDependencies": {
+        "@types/node-fetch": "^2.5.7"
+      }
+    },
     "node_modules/dunder-proto": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
       "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "call-bind-apply-helpers": "^1.0.1",
@@ -691,7 +746,6 @@
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
       "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -701,7 +755,6 @@
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
       "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -711,7 +764,6 @@
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
       "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "es-errors": "^1.3.0"
@@ -720,6 +772,22 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
@@ -746,11 +814,27 @@
         }
       }
     },
+    "node_modules/form-data": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz",
+      "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/function-bind": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
       "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-      "dev": true,
       "license": "MIT",
       "funding": {
         "url": "https://github.com/sponsors/ljharb"
@@ -767,7 +851,6 @@
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
       "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "call-bind-apply-helpers": "^1.0.2",
@@ -792,7 +875,6 @@
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
       "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "dunder-proto": "^1.0.1",
@@ -806,7 +888,6 @@
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
       "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -832,7 +913,6 @@
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
       "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
@@ -841,11 +921,26 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/hasown": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
       "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "function-bind": "^1.1.2"
@@ -958,12 +1053,34 @@
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
       "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.4"
       }
     },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/moment": {
       "version": "2.30.1",
       "resolved": "https://registry.npmjs.org/moment/-/moment-2.30.1.tgz",

package.json

@@ -15,6 +15,7 @@
     "chart.js": "^4.5.0",
     "discord.js": "^14.25.1",
     "dotenv": "^17.2.3",
+    "dropbox": "^10.34.0",
     "pdfjs-dist": "^5.6.205",
     "pg": "^8.16.3",
     "skia-canvas": "^3.0.8",

src/config.js

@@ -14,6 +14,8 @@ export function getConfig() {
     .split(',')
     .map((value) => value.trim())
     .filter(Boolean);
+  const dropboxAccessToken = process.env.DROPBOX_ACCESS_TOKEN?.trim() || null;
+  const circaDropboxFolderPath = process.env.CIRCA_DROPBOX_FOLDER_PATH?.trim() || null;
   const circaDropboxUrl = process.env.CIRCA_DROPBOX_URL?.trim() || null;
   const scanReportChannelId = process.env.SCAN_REPORT_CHANNEL_ID?.trim() || null;
   const scanAlertChannelId = process.env.SCAN_ALERT_CHANNEL_ID?.trim() || null;
@@ -39,12 +41,19 @@ export function getConfig() {
     port,
     adminRoleName,
     scanner: {
-      enabled: Boolean(oddsApiKey && circaDropboxUrl && scanReportChannelId && scanAlertChannelId),
+      enabled: Boolean(
+        oddsApiKey
+        && scanReportChannelId
+        && scanAlertChannelId
+        && ((dropboxAccessToken && circaDropboxFolderPath) || circaDropboxUrl)
+      ),
       oddsApiKey,
       oddsApiBaseUrl,
       oddsApiSportKey,
       oddsApiRegions,
       oddsApiMarkets,
+      dropboxAccessToken,
+      circaDropboxFolderPath,
       circaDropboxUrl,
       scanReportChannelId,
       scanAlertChannelId,

src/embeds.js

@@ -402,6 +402,7 @@ export function buildScanStatusEmbed(status) {
       { name: 'Min Books / Threshold', value: `${status.minBooks} / ${(status.disagreementThreshold * 100).toFixed(2)}%`, inline: true },
       { name: 'Last Scan', value: status.lastScanAt ?? 'Never', inline: true },
       { name: 'Last Report', value: status.lastReportAt ?? 'Never', inline: true },
+      { name: 'Last Circa File', value: status.lastCircaFileName ?? 'None', inline: false },
       { name: 'Last Counts', value: `API: ${status.lastApiEntries ?? 0} | Circa: ${status.lastCircaEntries ?? 0} | Alerts: ${status.lastAlertCount ?? 0}`, inline: false },
       { name: 'Last Error', value: status.lastScanError ?? 'None', inline: false },
     );
@@ -462,13 +463,25 @@ export function buildCircaDiagnosticEmbed(result) {
   return new EmbedBuilder()
     .setColor(PALETTE.gold)
     .setTitle('Circa OCR Diagnostic')
-    .setDescription(`Parsed **${result.totalEntries}** Circa entries from the latest download.`)
+    .setDescription(`Parsed **${result.totalEntries}** Circa entries from **${result.fileName ?? 'the latest Circa file'}**.`)
     .addFields(
       { name: 'Parsed Preview', value: truncate(preview, 1000), inline: false },
       { name: 'OCR Text Sample', value: truncate(result.rawTextSample || 'No OCR text extracted.', 1000), inline: false },
     );
 }
 
+export function buildCircaFailureEmbed(details) {
+  return new EmbedBuilder()
+    .setColor(PALETTE.red)
+    .setTitle('Circa Ingestion Failed')
+    .setDescription('The market scanner could not parse the current Circa file, so no Circa-based alerts were posted for this run.')
+    .addFields(
+      { name: 'File', value: details.fileName ?? 'Unknown', inline: true },
+      { name: 'Reason', value: details.reason ?? 'Unknown error', inline: true },
+      { name: 'Source', value: details.source ?? 'Dropbox API', inline: true },
+    );
+}
+
 function escapeCsv(value) {
   const stringValue = String(value);
   if (stringValue.includes(',') || stringValue.includes('"') || stringValue.includes('\n')) {

src/index.js

@@ -34,6 +34,7 @@ import {
   buildCommandsEmbed,
   buildCircaDiagnosticEmbed,
   buildCircaAlertEmbed,
+  buildCircaFailureEmbed,
   buildDeleteBetEmbed,
   buildEditBetEmbed,
   buildErrorEmbed,
@@ -84,6 +85,7 @@ async function main() {
     embeds: {
       buildMarketTopEmbed,
       buildCircaAlertEmbed,
+      buildCircaFailureEmbed,
     },
     logger: console,
   });

src/market-scanner.js

@@ -1,4 +1,5 @@
 import { Canvas } from 'skia-canvas';
+import { Dropbox } from 'dropbox';
 import * as pdfjsLib from 'pdfjs-dist/legacy/build/pdf.mjs';
 import { createWorker } from 'tesseract.js';
 
@@ -374,6 +375,25 @@ export function analyzeMarkets(entries, config = {}) {
   };
 }
 
+export function matchesCircaMlbFilename(name) {
+  return /^MLB\s+Props\s*-\s*\d{4}-\d{1,2}-\d{1,2}\.pdf$/i.test(normalizeWhitespace(name));
+}
+
+export function selectLatestCircaFile(entries = []) {
+  const candidates = entries
+    .filter((entry) => entry['.tag'] === 'file')
+    .filter((entry) => /\.pdf$/i.test(entry.name))
+    .filter((entry) => matchesCircaMlbFilename(entry.name));
+
+  if (candidates.length === 0) {
+    return null;
+  }
+
+  return candidates.sort((left, right) =>
+    new Date(right.server_modified).getTime() - new Date(left.server_modified).getTime()
+  )[0];
+}
+
 async function fetchArrayBuffer(url) {
   const response = await fetch(url);
   if (!response.ok) {
@@ -390,6 +410,53 @@ async function fetchJson(url) {
   return response.json();
 }
 
+function getDropboxClient(config) {
+  if (!config.dropboxAccessToken) {
+    throw new Error('Missing DROPBOX_ACCESS_TOKEN for Circa Dropbox API access.');
+  }
+
+  return new Dropbox({
+    accessToken: config.dropboxAccessToken,
+    fetch,
+  });
+}
+
+async function downloadDropboxFile(config) {
+  const client = getDropboxClient(config);
+  const folderPath = config.circaDropboxFolderPath;
+  if (!folderPath) {
+    throw new Error('Missing CIRCA_DROPBOX_FOLDER_PATH for Circa Dropbox API access.');
+  }
+
+  const listResponse = await client.filesListFolder({
+    path: folderPath,
+  });
+  const selectedFile = selectLatestCircaFile(listResponse.result.entries ?? []);
+  if (!selectedFile) {
+    throw new Error(`No matching MLB Props PDF found in Dropbox folder ${folderPath}.`);
+  }
+
+  const downloadResponse = await client.filesDownload({
+    path: selectedFile.path_lower ?? selectedFile.path_display,
+  });
+
+  const binary = downloadResponse.result.fileBinary;
+  let buffer;
+  if (binary instanceof Blob) {
+    buffer = await binary.arrayBuffer();
+  } else if (binary?.buffer) {
+    buffer = binary.buffer.slice(binary.byteOffset, binary.byteOffset + binary.byteLength);
+  } else {
+    buffer = binary;
+  }
+
+  return {
+    fileName: selectedFile.name,
+    buffer,
+    source: 'Dropbox API',
+  };
+}
+
 async function extractPdfText(buffer) {
   const loadingTask = pdfjsLib.getDocument({ data: new Uint8Array(buffer), useWorkerFetch: false, isEvalSupported: false });
   const pdf = await loadingTask.promise;
@@ -432,9 +499,23 @@ async function recognizeTextFromImage(imageBuffer) {
 }
 
 export async function fetchCircaEntries(config) {
-  const buffer = await fetchArrayBuffer(config.circaDropboxUrl);
-  const text = await extractPdfText(buffer);
+  let sourceFile;
+  if (config.dropboxAccessToken && config.circaDropboxFolderPath) {
+    sourceFile = await downloadDropboxFile(config);
+  } else if (config.circaDropboxUrl) {
+    sourceFile = {
+      fileName: 'Circa shared-link file',
+      buffer: await fetchArrayBuffer(config.circaDropboxUrl),
+      source: 'Shared link',
+    };
+  } else {
+    throw new Error('No Circa source configured. Set Dropbox or shared-link Circa config.');
+  }
+
+  const text = await extractPdfText(sourceFile.buffer);
   return {
+    fileName: sourceFile.fileName,
+    source: sourceFile.source,
     text,
     entries: parseCircaOcrText(text),
   };
@@ -516,6 +597,7 @@ export class MarketScanner {
       lastCircaEntries: 0,
       lastApiEntries: 0,
       lastAlertCount: 0,
+      lastCircaFileName: null,
     };
   }
 
@@ -655,6 +737,7 @@ export class MarketScanner {
   async runCircaDiagnostic() {
     const result = await fetchCircaEntries(this.config);
     return {
+      fileName: result.fileName,
       rawTextSample: result.text.slice(0, 1000),
       parsedEntries: result.entries.slice(0, 10),
       totalEntries: result.entries.length,
@@ -683,13 +766,32 @@ export class MarketScanner {
       this.status.lastScanError = null;
       this.status.lastApiEntries = oddsEntries.length;
       this.status.lastCircaEntries = circaResult.entries.length;
+      this.status.lastCircaFileName = circaResult.fileName ?? null;
 
       return analysis;
     } catch (error) {
       this.status.lastScanError = error.message;
+      if (String(error.message ?? '').toLowerCase().includes('pdf') || String(error.message ?? '').toLowerCase().includes('ocr') || String(error.message ?? '').toLowerCase().includes('dropbox')) {
+        await this.sendCircaFailureAlert(error);
+      }
       throw error;
     } finally {
       this.running = false;
     }
   }
+
+  async sendCircaFailureAlert(error) {
+    const channel = await this.client.channels.fetch(this.config.scanAlertChannelId).catch(() => null);
+    if (!channel?.isTextBased()) {
+      return;
+    }
+
+    await channel.send({
+      embeds: [this.embeds.buildCircaFailureEmbed({
+        fileName: this.status.lastCircaFileName,
+        reason: error.message,
+        source: this.config.dropboxAccessToken ? 'Dropbox API' : 'Shared link',
+      })],
+    }).catch(() => null);
+  }
 }

test/market-scanner.test.js

@@ -5,8 +5,10 @@ import {
   analyzeMarkets,
   buildMarketKey,
   fetchOddsApiEntries,
+  matchesCircaMlbFilename,
   normalizeOddsApiEntries,
   parseCircaOcrText,
+  selectLatestCircaFile,
 } from '../src/market-scanner.js';
 
 test('converts american odds to implied probability', () => {
@@ -165,3 +167,32 @@ test('fetches odds api entries from event-level endpoints', async () => {
     global.fetch = originalFetch;
   }
 });
+
+test('matches expected circa mlb filenames', () => {
+  assert.equal(matchesCircaMlbFilename('MLB Props - 2026-4-3.pdf'), true);
+  assert.equal(matchesCircaMlbFilename('MLB Props - 2026-04-03.pdf'), true);
+  assert.equal(matchesCircaMlbFilename('NBA Props - 2026-4-3.pdf'), false);
+});
+
+test('selects newest matching circa mlb pdf', () => {
+  const selected = selectLatestCircaFile([
+    {
+      '.tag': 'file',
+      name: 'MLB Props - 2026-4-2.pdf',
+      server_modified: '2026-04-02T12:00:00Z',
+    },
+    {
+      '.tag': 'file',
+      name: 'MLB Props - 2026-4-3.pdf',
+      server_modified: '2026-04-03T12:00:00Z',
+    },
+    {
+      '.tag': 'file',
+      name: 'NBA Props - 2026-4-3.pdf',
+      server_modified: '2026-04-04T12:00:00Z',
+    },
+  ]);
+
+  assert.ok(selected);
+  assert.equal(selected.name, 'MLB Props - 2026-4-3.pdf');
+});