pplx-npx-search 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to pplx-cli will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-05-21
+
+### Added
+- **Configurable stream timeout.** `search`, `reason`, and `research` now accept `--timeout-ms <duration>`, with support for raw milliseconds plus `s` and `m` suffixes.
+
+### Changed
+- `pplx research` now defaults to a 10-minute stream timeout so Deep Research can finish instead of hitting the old 2-minute ceiling.
+- `pplx --version` now reads from `package.json`, keeping CLI output aligned with npm releases.
+
 ## [0.2.1] - 2026-05-18
 
 First public release worth telling people about. (v0.2.0 was unpublished before this release; do not use it.)
@@ -46,6 +55,7 @@ First public release worth telling people about. (v0.2.0 was unpublished before
 - SSE streaming for real-time answers
 - Optional Playwright and Chrome CDP transports
 
+[0.2.2]: https://github.com/thatsrajan/pplx-cli/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/thatsrajan/pplx-cli/compare/v0.1.1...v0.2.1
 [0.1.1]: https://github.com/thatsrajan/pplx-cli/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/thatsrajan/pplx-cli/releases/tag/v0.1.0

package/README.md

@@ -127,6 +127,8 @@ pplx search "query" | head -1
 pplx search "query" --json || echo "failed"
 ```
 
+Deep Research is slower than normal search. `pplx research` defaults to a 10-minute stream timeout; override it per run with `--timeout-ms 600000`, `--timeout-ms 120s`, or `--timeout-ms 10m`.
+
 Recommended agent invocation:
 
 ```bash
@@ -160,6 +162,7 @@ pplx search "research this topic" --json --raw --mode pro
 | `--chrome` | Use Chrome CDP bridge instead of HTTP |
 | `--playwright` | Use Playwright headless Chromium |
 | `--no-playwright` | Force HTTP transport even if config enables Playwright |
+| `--timeout-ms 120000\|120s\|10m` | Overall stream timeout |
 | `--curl` | Force curl-impersonate (auto-downloads if missing) |
 | `--allow-anonymous` | Allow anonymous Perplexity responses when cookies are expired |
 | `--incognito` | Do not save the query to Perplexity history |

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "pplx-npx-search",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "CLI for Perplexity AI with cookie-based auth. Headless, agent-friendly, no API key required.",
   "type": "module",
   "bin": {
-    "pplx": "./bin/pplx.js"
+    "pplx": "bin/pplx.js"
   },
   "scripts": {
     "start": "node bin/pplx.js",

package/src/cli.js

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 import { program } from 'commander';
 import chalk from 'chalk';
 import ora from 'ora';
@@ -10,6 +11,9 @@ import { formatSources } from './format.js';
 import { LABS_MODELS, MODEL_MAP } from './constants.js';
 import { setUseCurl } from './http.js';
 import { loadConfig } from './config.js';
+import { resolveTimeoutMs } from './timeout.js';
+
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 
 // --- Output state ---
 let rawMode = false;
@@ -84,7 +88,7 @@ async function extractAndValidateBrowser(browser, profile) {
 program
   .name('pplx')
   .description('CLI for Perplexity AI')
-  .version('0.1.1');
+  .version(pkg.version);
 
 program.option('--verbose', 'Enable verbose logging');
 program.option('--proxy <url>', 'Set proxy URL (sets HTTPS_PROXY env var)');
@@ -274,6 +278,13 @@ async function doSearch(query, opts) {
   }
 
   const mode = opts.mode || 'pro';
+  let timeoutMs;
+  try {
+    timeoutMs = resolveTimeoutMs({ ...opts, mode });
+  } catch (e) {
+    console.error(chalk.red(e.message));
+    process.exit(1);
+  }
   const sources = opts.sources ? opts.sources.split(',') : ['web'];
   const lang = opts.lang || 'en-US';
 
@@ -291,6 +302,7 @@ async function doSearch(query, opts) {
       chrome: opts.chrome,
       playwright: opts.playwright,
       curl: opts.curl,
+      timeoutMs,
     })) {
       lastData = data;
 
@@ -361,6 +373,7 @@ program
   .option('--chrome', 'Use Chrome CDP bridge instead of HTTP')
   .option('--playwright', 'Use Playwright headless Chromium instead of HTTP')
   .option('--no-playwright', 'Disable Playwright even if config enables it')
+  .option('--timeout-ms <duration>', 'Overall stream timeout: milliseconds by default, or use 120s / 10m')
   .option('--allow-anonymous', 'Allow anonymous Perplexity responses when cookies are expired')
   .action(async (queryArg, opts) => {
     if (opts.raw) { rawMode = true; chalk.level = 0; }
@@ -378,6 +391,7 @@ program
   .option('--chrome', 'Use Chrome CDP bridge')
   .option('--playwright', 'Use Playwright headless Chromium')
   .option('--no-playwright', 'Disable Playwright even if config enables it')
+  .option('--timeout-ms <duration>', 'Overall stream timeout: milliseconds by default, or use 120s / 10m')
   .option('--allow-anonymous', 'Allow anonymous Perplexity responses when cookies are expired')
   .action(async (queryArg, opts) => {
     const query = await resolveQuery(queryArg);
@@ -393,6 +407,7 @@ program
   .option('--chrome', 'Use Chrome CDP bridge')
   .option('--playwright', 'Use Playwright headless Chromium')
   .option('--no-playwright', 'Disable Playwright even if config enables it')
+  .option('--timeout-ms <duration>', 'Overall stream timeout: milliseconds by default, or use 120s / 10m')
   .option('--allow-anonymous', 'Allow anonymous Perplexity responses when cookies are expired')
   .action(async (queryArg, opts) => {
     const query = await resolveQuery(queryArg);

package/src/search.js

@@ -126,6 +126,7 @@ async function* searchWithChrome(query, cookies, opts) {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body,
+        timeout: opts.timeoutMs,
       }
     )) {
       parser.feed(chunk);
@@ -177,6 +178,7 @@ async function* searchWithPlaywright(query, cookies, opts) {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body,
+        timeout: opts.timeoutMs,
       }
     )) {
       parser.feed(chunk);
@@ -219,6 +221,7 @@ async function* searchWithHttp(query, cookies, opts) {
       'cookie': cookieHeader(sessionCookies),
     },
     body,
+    timeout: opts.timeoutMs,
   });
 
   if (!resp.ok) {

package/src/timeout.js

@@ -0,0 +1,40 @@
+export const DEFAULT_SEARCH_TIMEOUT_MS = 120000;
+export const DEFAULT_RESEARCH_TIMEOUT_MS = 600000;
+
+export function parseTimeoutMs(value, label = 'timeout') {
+  if (value == null || value === '') return null;
+
+  if (typeof value === 'number') {
+    if (Number.isFinite(value) && value > 0) return Math.trunc(value);
+    throw new Error(`${label} must be a positive number of milliseconds`);
+  }
+
+  const text = String(value).trim().toLowerCase();
+  const match = text.match(/^(\d+(?:\.\d+)?)(ms|s|m)?$/);
+  if (!match) {
+    throw new Error(`${label} must be a positive duration like 120000, 120s, or 10m`);
+  }
+
+  const amount = Number(match[1]);
+  const unit = match[2] ?? 'ms';
+  const multipliers = { ms: 1, s: 1000, m: 60000 };
+  const timeoutMs = amount * multipliers[unit];
+
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new Error(`${label} must be a positive duration`);
+  }
+
+  return Math.trunc(timeoutMs);
+}
+
+export function resolveTimeoutMs(opts = {}) {
+  const explicit = parseTimeoutMs(opts.timeoutMs, '--timeout-ms');
+  if (explicit != null) return explicit;
+
+  const configured = parseTimeoutMs(opts.timeout, 'config timeout');
+  if (configured != null) return configured;
+
+  return opts.mode === 'deep-research'
+    ? DEFAULT_RESEARCH_TIMEOUT_MS
+    : DEFAULT_SEARCH_TIMEOUT_MS;
+}