travelmolt-sdk 1.3.0 → 1.4.0

package/dist/cli.cjs

@@ -1885,10 +1885,21 @@ function getPublicClient() {
     transport: (0, import_viem3.http)(rpcUrl)
   });
 }
+function getSerpApiKey() {
+  const key = flag("serpapi-key") ?? process.env.SERPAPI_API_KEY;
+  if (!key) {
+    console.error("Error: SerpAPI key required. Provide via flag or env var:");
+    console.error("  npx travelmolt-sdk@latest check-price 2 --serpapi-key YOUR_KEY");
+    console.error("  export SERPAPI_API_KEY=YOUR_KEY");
+    process.exit(1);
+  }
+  return key;
+}
 function getAgent() {
-  const pk = process.env.PRIVATE_KEY;
+  const pk = flag("private-key") ?? process.env.PRIVATE_KEY;
   if (!pk) {
-    console.error("Error: PRIVATE_KEY env var required. Set it before running:");
+    console.error("Error: Private key required. Provide via flag or env var:");
+    console.error("  npx travelmolt-sdk@latest <cmd> --private-key 0xYourKey");
     console.error("  export PRIVATE_KEY=0xYourHexPrivateKey");
     process.exit(1);
   }
@@ -1906,6 +1917,14 @@ function formatUsdc(raw) {
   const frac = raw % 1000000n;
   return `${whole}.${frac.toString().padStart(6, "0")} USDC`;
 }
+function formatDuration(secs) {
+  const abs = Math.abs(secs);
+  if (abs < 60) return `${abs}s`;
+  if (abs < 3600) return `${Math.floor(abs / 60)}m`;
+  const h = Math.floor(abs / 3600);
+  const m = Math.floor(abs % 3600 / 60);
+  return m > 0 ? `${h}h ${m}m` : `${h}h`;
+}
 function printJob(id, job) {
   const statusNames = ["Open", "Claimed", "Completed", "Cancelled"];
   let payload = {};
@@ -2125,18 +2144,136 @@ Use --force to bypass this check.`);
         console.log(`  Expected reports: ${expected}`);
         break;
       }
+      case "my-jobs": {
+        const addrFlag = flag("address");
+        let workerAddress;
+        if (addrFlag) {
+          workerAddress = addrFlag.toLowerCase();
+        } else {
+          const pk = flag("private-key") ?? process.env.PRIVATE_KEY;
+          if (!pk) {
+            console.error("Usage: travelmolt my-jobs --address 0x... (read-only)");
+            console.error("   or: travelmolt my-jobs (uses PRIVATE_KEY / --private-key)");
+            process.exit(1);
+          }
+          workerAddress = (0, import_accounts.privateKeyToAccount)(pk).address.toLowerCase();
+        }
+        const maxId = Number(flag("max") ?? "100");
+        const publicClient = getPublicClient();
+        const readAgent = new TravelMoltAgent({ publicClient, walletClient: null });
+        const ZERO = "0x0000000000000000000000000000000000000000";
+        const now = Math.floor(Date.now() / 1e3);
+        const myJobs = [];
+        let needsAction = false;
+        for (let id = 1; id <= maxId; id++) {
+          try {
+            const job = await readAgent.getMonitoringJob(BigInt(id));
+            if (job.poster === ZERO) continue;
+            if (job.status !== 1) continue;
+            if (job.worker.toLowerCase() !== workerAddress) continue;
+            let payload = {};
+            try {
+              payload = JSON.parse(job.moltbookPostId);
+            } catch {
+            }
+            const lastReport = Number(job.lastReportAt);
+            const interval = Number(job.checkIntervalSeconds);
+            const referenceTime = lastReport > 0 ? lastReport : Number(job.claimedAt);
+            const nextCheckAt = referenceTime + interval;
+            const missedIntervals = Math.max(0, Math.floor((now - referenceTime) / interval));
+            let status;
+            let nextInSecs = nextCheckAt - now;
+            if (missedIntervals >= 2) {
+              status = "AT_RISK";
+              needsAction = true;
+            } else if (now > nextCheckAt + interval) {
+              status = "OVERDUE";
+              needsAction = true;
+            } else if (now > nextCheckAt) {
+              status = "DUE_NOW";
+              needsAction = true;
+            } else if (nextCheckAt - now <= 300) {
+              status = "DUE_SOON";
+              needsAction = true;
+            } else {
+              status = "SAFE";
+            }
+            myJobs.push({
+              id,
+              hotel: payload.hotel ?? "(unknown)",
+              status,
+              reportCount: Number(job.reportCount),
+              nextInSecs,
+              intervalSecs: interval,
+              missedIntervals
+            });
+          } catch {
+            break;
+          }
+        }
+        if (myJobs.length === 0) {
+          console.log(`No claimed jobs found for ${workerAddress.slice(0, 10)}...`);
+          console.log(`
+Looking for work? Run: npx travelmolt-sdk@latest list-jobs`);
+          break;
+        }
+        if (hasFlag("json")) {
+          console.log(JSON.stringify({ worker: workerAddress, jobs: myJobs, needsAction, timestamp: now }));
+          if (needsAction) process.exit(2);
+          break;
+        }
+        console.log(`Jobs for ${workerAddress.slice(0, 10)}...
+`);
+        for (const job of myJobs) {
+          let statusTag;
+          let detail;
+          switch (job.status) {
+            case "AT_RISK":
+              statusTag = "!! AT RISK";
+              detail = `${job.missedIntervals} intervals missed \u2014 submit NOW or you will be reclaimed!`;
+              break;
+            case "OVERDUE":
+              statusTag = "!  OVERDUE";
+              detail = `overdue by ${formatDuration(Math.abs(job.nextInSecs))} \u2014 submit report now`;
+              break;
+            case "DUE_NOW":
+              statusTag = "!  DUE NOW";
+              detail = `report due \u2014 submit now`;
+              break;
+            case "DUE_SOON":
+              statusTag = "~  DUE SOON";
+              detail = `due in ${formatDuration(job.nextInSecs)}`;
+              break;
+            case "SAFE":
+              statusTag = "   OK";
+              detail = `next in ${formatDuration(job.nextInSecs)}`;
+              break;
+          }
+          console.log(`  [${statusTag}] Job #${job.id}: ${job.hotel}`);
+          console.log(`           ${detail} | ${job.reportCount} reports | interval ${formatDuration(job.intervalSecs)}`);
+          if (job.status !== "SAFE") {
+            console.log(`           -> npx travelmolt-sdk@latest check-price ${job.id}`);
+          }
+          console.log();
+        }
+        console.log(`${myJobs.length} job(s) total.`);
+        if (needsAction) {
+          console.log(`
+ACTION REQUIRED: ${myJobs.filter((j) => j.status !== "SAFE").length} job(s) need attention.`);
+          process.exit(2);
+        } else {
+          console.log(`
+All jobs on schedule.`);
+        }
+        break;
+      }
       case "check-price": {
         const id = args[1];
         if (!id) {
-          console.error("Usage: travelmolt check-price <id>\n\nRequires SERPAPI_API_KEY env var.");
-          process.exit(1);
-        }
-        const serpKey = process.env.SERPAPI_API_KEY;
-        if (!serpKey) {
-          console.error("Error: SERPAPI_API_KEY env var required.");
-          console.error("  export SERPAPI_API_KEY=your_key_here");
+          console.error("Usage: travelmolt check-price <id> [--serpapi-key KEY]");
           process.exit(1);
         }
+        const serpKey = getSerpApiKey();
         const publicClient = getPublicClient();
         const readAgent = new TravelMoltAgent({ publicClient, walletClient: null });
         const job = await readAgent.getMonitoringJob(BigInt(id));
@@ -2175,7 +2312,7 @@ Hotel:     ${payload.hotel}`);
           console.log(`Alert:     NO`);
           console.log(`
 Next step \u2014 submit report with price=0:`);
-          console.log(`  PRIVATE_KEY=0x... npx travelmolt-sdk@latest report ${id} --price 0`);
+          console.log(`  npx travelmolt-sdk@latest report ${id} --price 0 --private-key 0xYOUR_KEY`);
           break;
         }
         const priceNum = hotel.rate_per_night?.extracted_lowest ?? parseFloat((hotel.rate_per_night?.lowest ?? "0").replace(/[^0-9.]/g, ""));
@@ -2189,21 +2326,16 @@ Hotel:     ${hotel.name ?? payload.hotel}`);
         const alertFlag = alertTriggered ? " --alert" : "";
         console.log(`
 Next step \u2014 submit report:`);
-        console.log(`  PRIVATE_KEY=0x... npx travelmolt-sdk@latest report ${id} --price ${priceInCents}${alertFlag}`);
+        console.log(`  npx travelmolt-sdk@latest report ${id} --price ${priceInCents}${alertFlag} --private-key 0xYOUR_KEY`);
         break;
       }
       case "monitor": {
         const id = args[1];
         if (!id) {
-          console.error("Usage: travelmolt monitor <id>\n\nRequires PRIVATE_KEY and SERPAPI_API_KEY env vars.");
-          process.exit(1);
-        }
-        const serpKey = process.env.SERPAPI_API_KEY;
-        if (!serpKey) {
-          console.error("Error: SERPAPI_API_KEY env var required.");
-          console.error("  export SERPAPI_API_KEY=your_key_here");
+          console.error("Usage: travelmolt monitor <id> [--serpapi-key KEY] [--private-key KEY]");
           process.exit(1);
         }
+        const serpKey = getSerpApiKey();
         const monAgent = getAgent();
         await monAgent.init();
         const jobIdBig = BigInt(id);
@@ -2366,6 +2498,7 @@ Commands:
   claim <id>                     Claim a monitoring job (needs PRIVATE_KEY)
   unclaim <id>                   Unclaim a monitoring job (needs PRIVATE_KEY)
   report <id> --price <cents> [--alert] [--force]  Submit a monitoring report
+  my-jobs [--address 0x...]       Show your claimed jobs and what's due (exit code 2 if action needed)
   check-price <id>               Check hotel price via SerpAPI (needs SERPAPI_API_KEY)
   monitor <id>                   Long-running price check + report loop
   register --name "Name"         Register agent identity with display name
@@ -2373,6 +2506,10 @@ Commands:
   status <id>                    Job status + reports
   balance                        Show USDC + ETH balance (needs PRIVATE_KEY)
 
+Global flags (alternative to env vars):
+  --private-key <key>    Hex private key (alternative to PRIVATE_KEY env var)
+  --serpapi-key <key>    SerpAPI key (alternative to SERPAPI_API_KEY env var)
+
 Environment:
   PRIVATE_KEY      Hex private key (required for write operations)
   SERPAPI_API_KEY   SerpAPI key (required for check-price and monitor)