boostedtravel 0.2.4 → 0.2.5

package/README.md

@@ -1,6 +1,8 @@
 # BoostedTravel — Agent-Native Flight Search & Booking (Node.js)
 
-Search 400+ airlines at raw airline prices — **$20-50 cheaper** than Booking.com, Kayak, and other OTAs. Zero dependencies. Built for autonomous AI agents.
+Search 400+ airlines at raw airline prices — **$20-50 cheaper** than Booking.com, Kayak, and other OTAs. Zero dependencies. Built for autonomous AI agents — works with OpenClaw, Perplexity Computer, Claude, Cursor, Windsurf, and any MCP-compatible client.
+
+> 🎥 **[Watch the demo](https://github.com/Boosted-Chat/BoostedTravel#demo-boostedtravel-vs-default-agent-search)** — side-by-side comparison of default agent search vs BoostedTravel CLI.
 
 ## Install
 
@@ -72,10 +74,48 @@ boostedtravel book off_xxx -p '{"id":"pas_xxx","given_name":"John",...}' -e john
 - `offerSummary(offer)` — One-line string summary
 - `cheapestOffer(result)` — Get cheapest offer from search
 
+### `searchLocal(origin, destination, dateFrom, options?)`
+
+Search 75 airline connectors locally (no API key needed). Requires Python + `boostedtravel` installed.
+
+```typescript
+import { searchLocal } from 'boostedtravel';
+
+const result = await searchLocal('GDN', 'BCN', '2026-06-15');
+console.log(result.total_results);
+
+// Limit browser concurrency for constrained environments
+const result2 = await searchLocal('GDN', 'BCN', '2026-06-15', { maxBrowsers: 4 });
+```
+
+### `systemInfo()`
+
+Get system resource profile and recommended concurrency settings.
+
+```typescript
+import { systemInfo } from 'boostedtravel';
+
+const info = await systemInfo();
+console.log(info);
+// { platform: 'win32', cpu_cores: 16, ram_total_gb: 31.2, ram_available_gb: 14.7,
+//   tier: 'standard', recommended_max_browsers: 8, current_max_browsers: 8 }
+```
+
 ## Zero Dependencies
 
 Uses native `fetch` (Node 18+). No `axios`, no `node-fetch`, nothing. Safe for sandboxed environments.
 
+## Performance Tuning
+
+Local search auto-scales browser concurrency based on available RAM. Override with `maxBrowsers`:
+
+```typescript
+// Limit to 4 concurrent browsers
+await searchLocal('LHR', 'BCN', '2026-04-15', { maxBrowsers: 4 });
+```
+
+Or set the `BOOSTEDTRAVEL_MAX_BROWSERS` environment variable globally.
+
 ## License
 
 MIT

package/dist/{chunk-RJB7OAS2.mjs → chunk-UY6AN74O.mjs}

@@ -137,7 +137,8 @@ async function searchLocal(origin, destination, dateFrom, options = {}) {
     currency: options.currency ?? "EUR",
     limit: options.limit ?? 50,
     return_date: options.returnDate,
-    cabin_class: options.cabinClass
+    cabin_class: options.cabinClass,
+    ...options.maxBrowsers != null && { max_browsers: options.maxBrowsers }
   });
   return new Promise((resolve, reject) => {
     const pythonCmd = process.platform === "win32" ? "python" : "python3";
@@ -334,6 +335,42 @@ var BoostedTravel = class {
     }
   }
 };
+async function systemInfo() {
+  const { spawn } = await import("child_process");
+  return new Promise((resolve, reject) => {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    const child = spawn(pythonCmd, ["-m", "boostedtravel.local"], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => {
+      stdout += d.toString();
+    });
+    child.stderr.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("close", (code) => {
+      try {
+        const data = JSON.parse(stdout);
+        if (data.error) reject(new BoostedTravelError(data.error));
+        else resolve(data);
+      } catch {
+        reject(new BoostedTravelError(
+          `Python system-info failed (code ${code}): ${stdout || stderr}`
+        ));
+      }
+    });
+    child.on("error", (err) => {
+      reject(new BoostedTravelError(
+        `Cannot start Python: ${err.message}
+Install: pip install boostedtravel`
+      ));
+    });
+    child.stdin.write(JSON.stringify({ __system_info: true }));
+    child.stdin.end();
+  });
+}
 var index_default = BoostedTravel;
 
 export {
@@ -348,5 +385,6 @@ export {
   cheapestOffer,
   searchLocal,
   BoostedTravel,
+  systemInfo,
   index_default
 };

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   BoostedTravel,
   BoostedTravelError,
   offerSummary
-} from "./chunk-RJB7OAS2.mjs";
+} from "./chunk-UY6AN74O.mjs";
 
 // src/cli.ts
 function getFlag(args, flag, alias) {

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 /**
  * BoostedTravel — Agent-native flight search & booking SDK for Node.js/TypeScript.
  *
- * 53 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
+ * 75 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
  * Zero external JS dependencies. Uses native fetch (Node 18+).
  *
  * @example
@@ -112,6 +112,24 @@ interface SearchOptions {
     currency?: string;
     limit?: number;
     sort?: 'price' | 'duration';
+    /** Max concurrent browser instances (1-32). Omit for auto-detect based on system RAM. */
+    maxBrowsers?: number;
+}
+interface CheckoutProgress {
+    status: string;
+    step: string;
+    step_index: number;
+    airline: string;
+    source: string;
+    offer_id: string;
+    total_price: number;
+    currency: string;
+    booking_url: string;
+    screenshot_b64: string;
+    message: string;
+    can_complete_manually: boolean;
+    elapsed_seconds: number;
+    details: Record<string, unknown>;
 }
 interface BoostedTravelConfig {
     apiKey?: string;
@@ -170,7 +188,7 @@ declare function offerSummary(offer: FlightOffer): string;
 /** Get cheapest offer from search results */
 declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
 /**
- * Search flights using 53 local airline connectors — FREE, no API key needed.
+ * Search flights using 73 local airline connectors — FREE, no API key needed.
  *
  * Requires: pip install boostedtravel && playwright install chromium
  *
@@ -227,5 +245,10 @@ declare class BoostedTravel {
     private get;
     private request;
 }
+/**
+ * Get system resource profile and recommended concurrency settings.
+ * Calls the Python backend's system-info detection.
+ */
+declare function systemInfo(): Promise<Record<string, unknown>>;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, BoostedTravel as default, searchLocal as localSearch, offerSummary, searchLocal };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, BoostedTravel as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * BoostedTravel — Agent-native flight search & booking SDK for Node.js/TypeScript.
  *
- * 53 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
+ * 75 airline connectors run locally via Python + backend API for enterprise GDS/NDC sources.
  * Zero external JS dependencies. Uses native fetch (Node 18+).
  *
  * @example
@@ -112,6 +112,24 @@ interface SearchOptions {
     currency?: string;
     limit?: number;
     sort?: 'price' | 'duration';
+    /** Max concurrent browser instances (1-32). Omit for auto-detect based on system RAM. */
+    maxBrowsers?: number;
+}
+interface CheckoutProgress {
+    status: string;
+    step: string;
+    step_index: number;
+    airline: string;
+    source: string;
+    offer_id: string;
+    total_price: number;
+    currency: string;
+    booking_url: string;
+    screenshot_b64: string;
+    message: string;
+    can_complete_manually: boolean;
+    elapsed_seconds: number;
+    details: Record<string, unknown>;
 }
 interface BoostedTravelConfig {
     apiKey?: string;
@@ -170,7 +188,7 @@ declare function offerSummary(offer: FlightOffer): string;
 /** Get cheapest offer from search results */
 declare function cheapestOffer(result: FlightSearchResult): FlightOffer | null;
 /**
- * Search flights using 53 local airline connectors — FREE, no API key needed.
+ * Search flights using 73 local airline connectors — FREE, no API key needed.
  *
  * Requires: pip install boostedtravel && playwright install chromium
  *
@@ -227,5 +245,10 @@ declare class BoostedTravel {
     private get;
     private request;
 }
+/**
+ * Get system resource profile and recommended concurrency settings.
+ * Calls the Python backend's system-info detection.
+ */
+declare function systemInfo(): Promise<Record<string, unknown>>;
 
-export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, BoostedTravel as default, searchLocal as localSearch, offerSummary, searchLocal };
+export { AuthenticationError, type BookingResult, BoostedTravel, type BoostedTravelConfig, BoostedTravelError, type CheckoutProgress, ErrorCategory, type ErrorCategoryType, ErrorCode, type ErrorCodeType, type FlightOffer, type FlightRoute, type FlightSearchResult, type FlightSegment, OfferExpiredError, type Passenger, PaymentRequiredError, type SearchOptions, type UnlockResult, ValidationError, cheapestOffer, BoostedTravel as default, systemInfo as getSystemInfo, searchLocal as localSearch, offerSummary, searchLocal, systemInfo };

package/dist/index.js

@@ -40,9 +40,11 @@ __export(index_exports, {
   ValidationError: () => ValidationError,
   cheapestOffer: () => cheapestOffer,
   default: () => index_default,
+  getSystemInfo: () => systemInfo,
   localSearch: () => searchLocal,
   offerSummary: () => offerSummary,
-  searchLocal: () => searchLocal
+  searchLocal: () => searchLocal,
+  systemInfo: () => systemInfo
 });
 module.exports = __toCommonJS(index_exports);
 var ErrorCode = {
@@ -183,7 +185,8 @@ async function searchLocal(origin, destination, dateFrom, options = {}) {
     currency: options.currency ?? "EUR",
     limit: options.limit ?? 50,
     return_date: options.returnDate,
-    cabin_class: options.cabinClass
+    cabin_class: options.cabinClass,
+    ...options.maxBrowsers != null && { max_browsers: options.maxBrowsers }
   });
   return new Promise((resolve, reject) => {
     const pythonCmd = process.platform === "win32" ? "python" : "python3";
@@ -380,6 +383,42 @@ var BoostedTravel = class {
     }
   }
 };
+async function systemInfo() {
+  const { spawn } = await import("child_process");
+  return new Promise((resolve, reject) => {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    const child = spawn(pythonCmd, ["-m", "boostedtravel.local"], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => {
+      stdout += d.toString();
+    });
+    child.stderr.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("close", (code) => {
+      try {
+        const data = JSON.parse(stdout);
+        if (data.error) reject(new BoostedTravelError(data.error));
+        else resolve(data);
+      } catch {
+        reject(new BoostedTravelError(
+          `Python system-info failed (code ${code}): ${stdout || stderr}`
+        ));
+      }
+    });
+    child.on("error", (err) => {
+      reject(new BoostedTravelError(
+        `Cannot start Python: ${err.message}
+Install: pip install boostedtravel`
+      ));
+    });
+    child.stdin.write(JSON.stringify({ __system_info: true }));
+    child.stdin.end();
+  });
+}
 var index_default = BoostedTravel;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -392,7 +431,9 @@ var index_default = BoostedTravel;
   PaymentRequiredError,
   ValidationError,
   cheapestOffer,
+  getSystemInfo,
   localSearch,
   offerSummary,
-  searchLocal
+  searchLocal,
+  systemInfo
 });

package/dist/index.mjs

@@ -10,8 +10,9 @@ import {
   cheapestOffer,
   index_default,
   offerSummary,
-  searchLocal
-} from "./chunk-RJB7OAS2.mjs";
+  searchLocal,
+  systemInfo
+} from "./chunk-UY6AN74O.mjs";
 export {
   AuthenticationError,
   BoostedTravel,
@@ -23,7 +24,9 @@ export {
   ValidationError,
   cheapestOffer,
   index_default as default,
+  systemInfo as getSystemInfo,
   searchLocal as localSearch,
   offerSummary,
-  searchLocal
+  searchLocal,
+  systemInfo
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "boostedtravel",
-  "version": "0.2.4",
-  "description": "Agent-native flight search & booking. 53 airline connectors run locally + enterprise GDS/NDC APIs. Built for autonomous AI agents.",
+  "version": "0.2.5",
+  "description": "Agent-native flight search & booking. 75 airline connectors run locally + enterprise GDS/NDC APIs. Built for autonomous AI agents.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/boostedtravel/boostedtravel-js"
+    "url": "https://github.com/Boosted-Chat/BoostedTravel.git"
   },
   "homepage": "https://boostedchat.com",
   "devDependencies": {