pplx-zero 1.1.0 → 1.1.1

package/README.md

@@ -195,7 +195,7 @@ pplx --input queries.json --format jsonl
 Supported file formats for analysis:
 
 **Documents (max 50MB):**
-- PDF, DOC, DOCX, TXT, RTF
+- PDF, DOC, DOCX, TXT, RTF, MD
 
 **Images (max 50MB):**
 - PNG, JPEG, WebP, HEIF, HEIC, GIF
@@ -236,7 +236,7 @@ console.log(result);
 
 | Option | Short | Type | Default | Description |
 |--------|-------|------|---------|-------------|
-| `--file` | `-f` | string | - | Attach document (PDF, DOC, DOCX, TXT, RTF) |
+| `--file` | `-f` | string | - | Attach document (PDF, DOC, DOCX, TXT, RTF, MD) |
 | `--image` | `-i` | string | - | Attach image (PNG, JPEG, WebP, HEIF, HEIC, GIF) |
 | `--format` | `-o` | string | json | Output format: json|jsonl |
 | `--model` | `-m` | string | sonar | AI model: sonar, sonar-pro, sonar-deep-research, sonar-reasoning |

package/dist/cli.js

@@ -31,7 +31,7 @@ var __export = (target, all) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "pplx-zero",
-    version: "1.0.1",
+    version: "1.1.0",
     description: "Fast Perplexity AI search CLI with multimodal support - minimal setup, maximal results",
     type: "module",
     main: "dist/index.js",
@@ -94,7 +94,7 @@ var require_package = __commonJS((exports, module) => {
     license: "MIT",
     repository: {
       type: "git",
-      url: "https://github.com/codewithkenzo/pplx-zero.git"
+      url: "git+https://github.com/codewithkenzo/pplx-zero.git"
     },
     files: [
       "dist",
@@ -6496,7 +6496,9 @@ var DOCUMENT_MIME_TYPES = {
   ".doc": "application/msword",
   ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
   ".txt": "text/plain",
-  ".rtf": "application/rtf"
+  ".rtf": "application/rtf",
+  ".md": "text/markdown",
+  ".markdown": "text/markdown"
 };
 var MAX_FILE_SIZE = 50 * 1024 * 1024;
 var MAX_ATTACHMENTS = 10;
@@ -6671,9 +6673,6 @@ class PerplexitySearchTool {
       } else if (validatedInput.args.attachments) {
         attachments = validatedInput.args.attachments;
       }
-      if (validatedInput.args.attachments) {
-        attachments = [...attachments, ...validatedInput.args.attachments];
-      }
       const timeoutMs = validatedInput.options?.timeoutMs || 30000;
       const controller = new AbortController;
       if (signal) {
@@ -6984,15 +6983,18 @@ var __dirname2 = dirname(__filename2);
 var { values: cliOptions, positionals: commandLineQueries } = parseArgs({
   args: process.argv.slice(2),
   options: {
-    input: { type: "string", short: "i" },
+    model: { type: "string", short: "m" },
+    file: { type: "string", short: "f" },
+    image: { type: "string", short: "i" },
+    format: { type: "string", short: "o", default: "json" },
+    version: { type: "boolean", short: "v" },
+    help: { type: "boolean", short: "h" },
+    "help-advanced": { type: "boolean" },
+    input: { type: "string", short: "I" },
     stdin: { type: "boolean", short: "s" },
     concurrency: { type: "string", short: "c" },
     timeout: { type: "string", short: "t" },
     workspace: { type: "string", short: "w" },
-    format: { type: "string", short: "f", default: "json" },
-    version: { type: "boolean", short: "v" },
-    help: { type: "boolean", short: "h" },
-    model: { type: "string", short: "m" },
     attach: { type: "string", multiple: true },
     "attach-image": { type: "string", multiple: true },
     async: { type: "boolean" },
@@ -7002,62 +7004,100 @@ var { values: cliOptions, positionals: commandLineQueries } = parseArgs({
 });
 if (cliOptions.help) {
   console.error(`
-PPLX-Zero - Minimal, fast Perplexity AI search CLI with multimodal support
+PPLX-Zero - Fast Perplexity AI search CLI with multimodal support
 
 USAGE:
   pplx [OPTIONS] [QUERY...]
 
-OPTIONS:
-  -i, --input <file>              Read batch requests from JSON file
-  -s, --stdin                     Read JSONL requests from stdin
-  -c, --concurrency <n>          Max concurrent requests (default: 5)
-  -t, --timeout <ms>              Request timeout in milliseconds (default: 30000)
-  -w, --workspace <path>          Workspace directory for sandboxing
-  -f, --format <format>           Output format: json|jsonl (default: json)
-  -m, --model <model>             AI model: sonar, sonar-pro, sonar-deep-research, sonar-reasoning (default: sonar)
-  --attach <file>                 Attach document files (PDF, DOC, DOCX, TXT, RTF) - can be used multiple times
-  --attach-image <file>           Attach image files (PNG, JPEG, WebP, HEIF, HEIC, GIF) - can be used multiple times
-  --async                         Process requests asynchronously
-  --webhook <url>                 Webhook URL for async notifications
-  -v, --version                   Show version
-  -h, --help                      Show this help
+BASIC OPTIONS:
+  -m, --model <model>       Choose AI model (sonar, sonar-pro, sonar-deep-research, sonar-reasoning)
+  -f, --file <file>         Attach document (PDF, DOC, DOCX, TXT, RTF)
+  -i, --image <file>        Attach image (PNG, JPEG, WebP, HEIF, HEIC, GIF)
+  -o, --format <format>     Output format (json, jsonl)
+
+  -v, --version             Show version
+  -h, --help                Show this help
 
 EXAMPLES:
-  # Basic query
+  # Simple search
   pplx "latest AI developments"
 
-  # Model selection
-  pplx --model sonar-pro "Detailed analysis"
-  pplx --model sonar-deep-research "Comprehensive research"
-  pplx --model sonar-reasoning "Complex problem solving"
+  # Choose model for detailed analysis
+  pplx --model sonar-pro "Explain quantum computing"
 
-  # Image analysis
-  pplx --attach-image screenshot.png --model sonar-pro "Analyze this interface"
+  # Analyze document
+  pplx --file report.pdf "Summarize this document"
 
-  # Document analysis
-  pplx --attach report.pdf --model sonar-deep-research "Summarize this document"
+  # Analyze image
+  pplx --image screenshot.png "What does this interface do?"
 
-  # Multimodal analysis
-  pplx --attach document.txt --attach-image chart.png --model sonar-reasoning "Analyze this data"
+  # Document + image analysis
+  pplx --file data.csv --image chart.png "Analyze this data"
 
-  # Async processing with webhook
-  pplx --async --webhook https://api.example.com/callback "Long research task"
+  # Different AI models
+  pplx --model sonar-reasoning "Solve this math problem"
+  pplx --model sonar-deep-research "History of artificial intelligence"
+
+# Advanced Usage (see --help-advanced):
+  pplx --help-advanced
+
+SUPPORTED FORMATS:
+  Documents: PDF, DOC, DOCX, TXT, RTF (max 50MB)
+  Images: PNG, JPEG, WebP, HEIF, HEIC, GIF (max 50MB)
 
-  # Batch from file
+Get your API key: https://www.perplexity.ai/account/api/keys
+Set environment variable: export PERPLEXITY_API_KEY="your-key"
+`);
+  process.exit(0);
+}
+if (cliOptions["help-advanced"]) {
+  console.error(`
+PPLX-Zero - Advanced Usage Options
+
+USAGE:
+  pplx [ADVANCED-OPTIONS] [QUERY...]
+
+ADVANCED OPTIONS:
+  -I, --input <file>         Read batch requests from JSON file
+  -s, --stdin                Read JSONL requests from stdin
+  -c, --concurrency <n>      Max concurrent requests (default: 5, max: 20)
+  -t, --timeout <ms>          Request timeout in milliseconds (default: 30000)
+  -w, --workspace <path>     Workspace directory for sandboxing
+  -o, --format <format>      Output format: json|jsonl (default: json)
+  -m, --model <model>         AI model (default: sonar)
+
+  --attach <file>             Attach document files (can be used multiple times)
+  --attach-image <file>       Attach image files (can be used multiple times)
+  --async                     Process requests asynchronously
+  --webhook <url>             Webhook URL for async notifications
+
+  -v, --version               Show version
+  -h, --help                  Show basic help
+
+ADVANCED EXAMPLES:
+  # Batch processing
   pplx --input queries.json
 
-  # Streaming from stdin
+  # Stream processing
   cat queries.jsonl | pplx --stdin
 
-  # JSONL output for streaming
-  pplx --format jsonl --input queries.json
+  # Custom concurrency and timeout
+  pplx --concurrency 10 --timeout 60000 "Multiple searches"
 
-  # High concurrency batch with attachments
-  pplx --concurrency 10 --timeout 60000 --input queries.json --attach appendix.pdf
+  # High performance batch
+  pplx --input queries.json --concurrency 15 --format jsonl
 
-SUPPORTED FORMATS:
-  Images: PNG, JPEG, WebP, HEIF, HEIC, GIF (max 50MB, 10 files)
-  Documents: PDF, DOC, DOCX, TXT, RTF (max 50MB, 10 files)
+  # Multiple attachments (advanced syntax)
+  pplx --attach doc1.pdf --attach doc2.txt --attach-image img1.png "Analyze all files"
+
+  # Async processing with webhook
+  pplx --async --webhook https://api.example.com/webhook "Long research task"
+
+  # Custom workspace
+  pplx --workspace /tmp/research "Custom workspace search"
+
+# Basic Usage (see --help):
+  pplx --help
 `);
   process.exit(0);
 }
@@ -7164,7 +7204,7 @@ async function main() {
         model: selectedModel,
         async: cliOptions.async,
         webhook: cliOptions.webhook,
-        hasAttachments: (cliOptions.attach?.length || 0) + (cliOptions["attach-image"]?.length || 0) > 0
+        hasAttachments: (cliOptions.file || cliOptions.image || (cliOptions.attach?.length || 0) + (cliOptions["attach-image"]?.length || 0)) > 0
       }
     });
     let batchSearchInput;
@@ -7178,6 +7218,18 @@ async function main() {
     } else if (commandLineQueries.length > 0) {
       const combinedQuery = commandLineQueries.join(" ");
       const attachmentInputs = [];
+      if (cliOptions.file) {
+        attachmentInputs.push({
+          path: cliOptions.file,
+          type: "document"
+        });
+      }
+      if (cliOptions.image) {
+        attachmentInputs.push({
+          path: cliOptions.image,
+          type: "image"
+        });
+      }
       if (cliOptions.attach && cliOptions.attach.length > 0) {
         for (const filePath of cliOptions.attach) {
           attachmentInputs.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pplx-zero",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Fast Perplexity AI search CLI with multimodal support - minimal setup, maximal results",
   "type": "module",
   "main": "dist/index.js",
@@ -71,4 +71,4 @@
     "LICENSE",
     "package.json"
   ]
-}
+}