alterlab-mcp-server 1.7.0 → 1.9.0

package/dist/index.js

@@ -1,11 +1,46 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSandboxServer = createSandboxServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const client_js_1 = require("./client.js");
+const auth_js_1 = require("./auth.js");
 const config_js_1 = require("./config.js");
+const fs = __importStar(require("fs"));
 const scrape_js_1 = require("./tools/scrape.js");
 const extract_js_1 = require("./tools/extract.js");
 const screenshot_js_1 = require("./tools/screenshot.js");
@@ -17,18 +52,23 @@ const map_js_1 = require("./tools/map.js");
 const batch_js_1 = require("./tools/batch.js");
 const sessions_js_1 = require("./tools/sessions.js");
 const beta_features_js_1 = require("./tools/beta_features.js");
+const usage_js_1 = require("./tools/usage.js");
+const simple_batch_js_1 = require("./tools/simple_batch.js");
+const job_js_1 = require("./tools/job.js");
 function createServer(config) {
     const client = new client_js_1.AlterLabClient(config);
     const server = new mcp_js_1.McpServer({
         name: "alterlab",
-        version: "1.2.0",
+        version: "1.9.0",
     });
     // Register tools
     server.tool("alterlab_scrape", scrape_js_1.scrapeDescription, scrape_js_1.scrapeSchema.shape, (params) => (0, scrape_js_1.handleScrape)(client, params));
     server.tool("alterlab_extract", extract_js_1.extractDescription, extract_js_1.extractSchema.shape, (params) => (0, extract_js_1.handleExtract)(client, params));
     server.tool("alterlab_screenshot", screenshot_js_1.screenshotDescription, screenshot_js_1.screenshotSchema.shape, (params) => (0, screenshot_js_1.handleScreenshot)(client, params));
+    server.tool("alterlab_get_job", job_js_1.getJobDescription, job_js_1.getJobSchema.shape, (params) => (0, job_js_1.handleGetJob)(client, params));
     server.tool("alterlab_estimate_cost", estimate_js_1.estimateDescription, estimate_js_1.estimateSchema.shape, (params) => (0, estimate_js_1.handleEstimate)(client, params));
     server.tool("alterlab_check_balance", balance_js_1.balanceDescription, balance_js_1.balanceSchema.shape, () => (0, balance_js_1.handleBalance)(client));
+    server.tool("alterlab_get_usage", usage_js_1.usageDescription, usage_js_1.usageSchema.shape, () => (0, usage_js_1.handleUsage)(client));
     // Crawl tools
     server.tool("alterlab_crawl", crawl_js_1.crawlDescription, crawl_js_1.crawlSchema.shape, (params) => (0, crawl_js_1.handleCrawl)(client, params));
     server.tool("alterlab_crawl_status", crawl_js_1.crawlStatusDescription, crawl_js_1.crawlStatusSchema.shape, (params) => (0, crawl_js_1.handleCrawlStatus)(client, params));
@@ -38,6 +78,7 @@ function createServer(config) {
     // Map tool
     server.tool("alterlab_map", map_js_1.mapDescription, map_js_1.mapSchema.shape, (params) => (0, map_js_1.handleMap)(client, params));
     // Batch tools
+    server.tool("alterlab_batch_scrape", simple_batch_js_1.simpleBatchDescription, simple_batch_js_1.simpleBatchSchema.shape, (params) => (0, simple_batch_js_1.handleSimpleBatch)(client, params));
     server.tool("alterlab_batch", batch_js_1.batchDescription, batch_js_1.batchSchema.shape, (params) => (0, batch_js_1.handleBatch)(client, params));
     server.tool("alterlab_batch_status", batch_js_1.batchStatusDescription, batch_js_1.batchStatusSchema.shape, (params) => (0, batch_js_1.handleBatchStatus)(client, params));
     // Session management tools
@@ -65,7 +106,30 @@ function createSandboxServer() {
     });
 }
 async function main() {
-    const config = (0, config_js_1.loadConfig)();
+    const args = process.argv.slice(2);
+    // --setup: explicit re-authentication flag
+    // --auth oauth: OAuth-style alias (device flow IS the auth; "oauth" is treated as a sub-arg)
+    const isSetupMode = args.includes("--setup") ||
+        (args.includes("--auth") && args.includes("oauth"));
+    if (isSetupMode) {
+        // --setup / --auth oauth: force re-authentication by removing the saved config.
+        // This lets users re-authenticate (e.g., after key revocation) without manually
+        // deleting ~/.alterlab/config.json.
+        if (fs.existsSync(config_js_1.CONFIG_FILE_PATH)) {
+            try {
+                fs.unlinkSync(config_js_1.CONFIG_FILE_PATH);
+                process.stderr.write("\n  (Removed saved API key — starting fresh authentication)\n");
+            }
+            catch (err) {
+                process.stderr.write(`\n  Warning: Could not remove saved config: ${String(err)}\n`);
+            }
+        }
+        // Re-run ensureAuth which will trigger the interactive flow
+        await (0, auth_js_1.ensureAuth)();
+        process.stderr.write("\n  Setup complete. You can now add this server to your MCP client.\n\n");
+        process.exit(0);
+    }
+    const config = await (0, auth_js_1.ensureAuth)();
     const server = createServer(config);
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA2QA,kDAKC;AA9QD,oEAAoE;AACpE,wEAAiF;AACjF,2CAA6C;AAC7C,2CAAsD;AACtD,iDAI2B;AAC3B,mDAI4B;AAC5B,yDAI+B;AAC/B,qDAI6B;AAC7B,mDAI4B;AAC5B,+CAU0B;AAC1B,iDAI2B;AAC3B,2CAAsE;AACtE,+CAO0B;AAC1B,qDAsB6B;AAC7B,+DAakC;AAElC,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,MAAM,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,6BAAiB,EACjB,wBAAY,CAAC,KAAK,EAClB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,wBAAY,EAAC,MAAM,EAAE,MAAa,CAAC,CAChD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,+BAAkB,EAClB,0BAAa,CAAC,KAAK,EACnB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,0BAAa,EAAC,MAAM,EAAE,MAAa,CAAC,CACjD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,qCAAqB,EACrB,gCAAgB,CAAC,KAAK,EACtB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,gCAAgB,EAAC,MAAM,EAAE,MAAa,CAAC,CACpD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,iCAAmB,EACnB,4BAAc,CAAC,KAAK,EACpB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,4BAAc,EAAC,MAAM,EAAE,MAAa,CAAC,CAClD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,+BAAkB,EAClB,0BAAa,CAAC,KAAK,EACnB,GAAG,EAAE,CAAC,IAAA,0BAAa,EAAC,MAAM,CAAC,CAC5B,CAAC;IAEF,cAAc;IACd,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,2BAAgB,EAAE,sBAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAC5E,IAAA,sBAAW,EAAC,MAAM,EAAE,MAAa,CAAC,CACnC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,iCAAsB,EACtB,4BAAiB,CAAC,KAAK,EACvB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,4BAAiB,EAAC,MAAM,EAAE,MAAa,CAAC,CACrD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,iCAAsB,EACtB,4BAAiB,CAAC,KAAK,EACvB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,4BAAiB,EAAC,MAAM,EAAE,MAAa,CAAC,CACrD,CAAC;IAEF,cAAc;IACd,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,6BAAiB,EACjB,wBAAY,CAAC,KAAK,EAClB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,wBAAY,EAAC,MAAM,EAAE,MAAa,CAAC,CAChD,CAAC;IAEF,WAAW;IACX,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,uBAAc,EAAE,kBAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CACtE,IAAA,kBAAS,EAAC,MAAM,EAAE,MAAa,CAAC,CACjC,CAAC;IAEF,cAAc;IACd,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,2BAAgB,EAAE,sBAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAC5E,IAAA,sBAAW,EAAC,MAAM,EAAE,MAAa,CAAC,CACnC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,iCAAsB,EACtB,4BAAiB,CAAC,KAAK,EACvB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,4BAAiB,EAAC,MAAM,EAAE,MAAa,CAAC,CACrD,CAAC;IAEF,2BAA2B;IAC3B,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,qCAAuB,EACvB,gCAAkB,CAAC,KAAK,EACxB,GAAG,EAAE,CAAC,IAAA,gCAAkB,EAAC,MAAM,CAAC,CACjC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,sCAAwB,EACxB,iCAAmB,CAAC,KAAK,EACzB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,iCAAmB,EAAC,MAAM,EAAE,MAAa,CAAC,CACvD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,mCAAqB,EACrB,8BAAgB,CAAC,KAAK,EACtB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,8BAAgB,EAAC,MAAM,EAAE,MAAa,CAAC,CACpD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,sCAAwB,EACxB,iCAAmB,CAAC,KAAK,EACzB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,iCAAmB,EAAC,MAAM,EAAE,MAAa,CAAC,CACvD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,uCAAyB,EACzB,kCAAoB,CAAC,KAAK,EAC1B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,kCAAoB,EAAC,MAAM,EAAE,MAAa,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,wCAA0B,EAC1B,mCAAqB,CAAC,KAAK,EAC3B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,mCAAqB,EAAC,MAAM,EAAE,MAAa,CAAC,CACzD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,sCAAwB,EACxB,iCAAmB,CAAC,KAAK,EACzB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,iCAAmB,EAAC,MAAM,EAAE,MAAa,CAAC,CACvD,CAAC;IAEF,gCAAgC;IAChC,MAAM,CAAC,IAAI,CACT,6BAA6B,EAC7B,8CAA2B,EAC3B,yCAAsB,CAAC,KAAK,EAC5B,GAAG,EAAE,CAAC,IAAA,yCAAsB,EAAC,MAAM,CAAC,CACrC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gCAAgC,EAChC,gDAA6B,EAC7B,2CAAwB,CAAC,KAAK,EAC9B,GAAG,EAAE,CAAC,IAAA,2CAAwB,EAAC,MAAM,CAAC,CACvC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,8BAA8B,EAC9B,+CAA4B,EAC5B,0CAAuB,CAAC,KAAK,EAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,0CAAuB,EAAC,MAAM,EAAE,MAAa,CAAC,CAC3D,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,+BAA+B,EAC/B,gDAA6B,EAC7B,2CAAwB,CAAC,KAAK,EAC9B,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,2CAAwB,EAAC,MAAM,EAAE,MAAa,CAAC,CAC5D,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO,YAAY,CAAC;QAClB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,yBAAyB;KAClC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/balance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,aAAa,gDAAe,CAAC;AAE1C,eAAO,MAAM,kBAAkB,QAGmC,CAAC;AAEnE,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,aAAa,gDAAe,CAAC;AAE1C,eAAO,MAAM,kBAAkB,QAKmC,CAAC;AAEnE,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/tools/balance.js

@@ -6,8 +6,10 @@ const zod_1 = require("zod");
 const errors_js_1 = require("../errors.js");
 const format_js_1 = require("../format.js");
 exports.balanceSchema = zod_1.z.object({});
-exports.balanceDescription = "Check your AlterLab account balance and credit usage. " +
-    "Returns current balance, total deposited, and total spent. " +
+exports.balanceDescription = "Check your AlterLab account balance, status, and credit usage. " +
+    "Call this before expensive operations (batch scrapes, large crawls) to verify sufficient funds. " +
+    "Returns current balance in dollars, balance status (healthy/low/critical/exhausted), total deposited, and total spent. " +
+    "For a full spending breakdown by time window and top domains, use alterlab_get_usage instead. " +
     "No parameters required — uses your API key for identification.";
 async function handleBalance(client) {
     try {

package/dist/tools/balance.js.map

@@ -1 +1 @@
-{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":";;;AAaA,sCAcC;AA3BD,6BAAwB;AAGxB,4CAAgE;AAChE,4CAAqD;AAExC,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7B,QAAA,kBAAkB,GAC7B,wDAAwD;IACxD,6DAA6D;IAC7D,gEAAgE,CAAC;AAE5D,KAAK,UAAU,aAAa,CACjC,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAA,iCAAqB,EAAC,OAAO,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAA,6BAAiB,EAAC,KAAc,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAAkB,CAAC,MAAM,KAAK,QAAQ,CAC/C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":";;;AAeA,sCAcC;AA7BD,6BAAwB;AAGxB,4CAAgE;AAChE,4CAAqD;AAExC,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7B,QAAA,kBAAkB,GAC7B,iEAAiE;IACjE,kGAAkG;IAClG,yHAAyH;IACzH,gGAAgG;IAChG,gEAAgE,CAAC;AAE5D,KAAK,UAAU,aAAa,CACjC,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAA,iCAAqB,EAAC,OAAO,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAA,6BAAiB,EAAC,KAAc,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAAkB,CAAC,MAAM,KAAK,QAAQ,CAC/C,CAAC;AACJ,CAAC"}